Saltar a contenido

Las páginas sin traducir se abren en inglés y se indican como inglés.

Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.

Operaciones de inbox

Los campos exactos que recibe y devuelve cada operación inbox.*.

Cada op es POST /v1/<op> sobre HTTP y la herramienta MCP loom_<op>. Los campos de identidad (org, namespace, agent, user_id, session_id) se completan a partir del token y de la sesión MCP cuando el transporte puede hacerlo; en una llamada HTTP sin token en un servidor de un solo usuario, se completa con la org de la instalación en todas las ops salvo code.* y tracker.* (que conservan la de su plano), y en algunas ops también su espacio de nombres y su agente; consulta identidades y espacios de nombres. El índice de operaciones explica el rol, el tipo y el listado all de MCP. Los campos de entrada desconocidos se atienden y se nombran en ignored_args.

inbox.list

Buzones que el llamador puede ver: los que pertenecen a namespace (el espacio de nombres autorizado) y, con mine_everywhere, todos los buzones de la organización en los que el llamador puede publicar: uno cuyo espacio de nombres propietario el llamador…

POST /v1/inbox.list · MCP loom_inbox_list · rol viewer · lectura · no figura en el toolset all de MCP

Campo de entrada Tipo Valor por defecto Significado
org str obligatorio El tenant (primer elemento de la tupla de identidad).
namespace str obligatorio El espacio de nombres que la op lee o escribe.
agent str '-' El agente que escribe o lee; '-' o '*' significa cualquier agente donde la op lo permita.
mine_everywhere bool False Lista también todos los buzones de la organización en los que el llamador puede publicar (escritura en su espacio de nombres propietario, o figurar como publicador); si es falso, lista solo los buzones que pertenecen a namespace.
limit int 200 Se leen como máximo estas filas de buzones, de 1 a 500 (con mine_everywhere, antes del filtro de visibilidad).
Campo de salida Tipo Significado
inboxes list[InboxPayload] Los buzones visibles, ordenados por nombre.

inbox.policy_list

Lista las políticas de confianza de un inbox.

POST /v1/inbox.policy_list · MCP loom_inbox_policy_list · rol viewer · lectura · no aparece en el toolset all de MCP

Campo de entrada Tipo Valor por defecto Significado
org str obligatorio El tenant (primer elemento de la tupla de identidad).
namespace str obligatorio El espacio de nombres que la op lee o escribe.
agent str '-' El agente que escribe o lee; '-' o '*' significa cualquier agente cuando la op lo permite.
inbox str obligatorio El inbox cuyas reglas se listan; si el llamador no puede leerlo, la respuesta es 404.
Campo de salida Tipo Significado
policies list[PolicyPayload] Todas las reglas vigentes del inbox, ordenadas por remitente y luego por tipo.

inbox.policy_set

Establece el modo de confianza que el propietario de un inbox eligió para un poster y un tipo de tarea (Loom lo almacena, nunca lo cambia).

POST /v1/inbox.policy_set · MCP loom_inbox_policy_set · rol admin · idempotente · auditado · no aparece en el conjunto de herramientas MCP all

Campo de entrada Tipo Valor por defecto Significado
org str obligatorio El tenant (primer elemento de la tupla de identidad).
namespace str obligatorio El espacio de nombres que la op lee o escribe.
agent str '-' El agente que escribe o lee; '-' o '*' significa cualquier agente cuando la op lo permite.
inbox str obligatorio El inbox al que pertenece la regla; quien llama debe ser admin de su espacio de nombres propietario.
poster str obligatorio A quién cubre la regla: un sujeto, una etiqueta de agente, o * para todos los posters.
kind str '*' El tipo de tarea que cubre la regla; * cubre todos los tipos.
mode Literal['deny', 'review', 'auto'] obligatorio deny rechaza el envío (403), review lo deja en triage, auto lo deja en todo.
require_evidence list[str] (calculado) Campos del brief que deben estar presentes (una comprobación de forma al crear), p. ej. ["inputs.finding_id"].
remove bool False True elimina la regla (poster, kind) en lugar de establecerla.
Campo de salida Tipo Significado
policy PolicyPayload \| None La regla tal como se almacenó; null cuando remove la eliminó.
removed bool True cuando la regla se eliminó.

inbox.principals

Las identidades que loom ya conoce en la organización: la fuente del selector de remitentes.

POST /v1/inbox.principals · MCP loom_inbox_principals · rol admin · idempotente · no aparece en el conjunto de herramientas MCP all

Campo de entrada Tipo Valor por defecto Significado
org str obligatorio El tenant (primer elemento de la tupla de identidad).
namespace str obligatorio El espacio de nombres que la operación lee o escribe.
agent str '-' El agente que escribe o lee; '-' o '*' significa cualquier agente cuando la operación lo permite.
inbox str obligatorio La inbox cuyos remitentes se marcan como listed; un nombre no registrado o ilegible se resuelve contra namespace sin ningún remitente listado.
query str '' Subcadena sin distinción entre mayúsculas y minúsculas que se compara con el subject y la etiqueta; "" devuelve a todos.
limit int 200 Como máximo esta cantidad de principals, de 1 a 500; truncated indica que coincidieron más.
Campo de salida Tipo Significado
principals list[Principal] Primero las personas, luego las cuentas de servicio y después las demás, cada grupo ordenado por etiqueta.
truncated bool Verdadero cuando coincidieron más principals que limit.

inbox.register

namespace es el espacio de nombres propietario (quien llama debe ser su administrador).

POST /v1/inbox.register · MCP loom_inbox_register · rol admin · idempotente · auditado · no aparece en el conjunto de herramientas all de MCP

Campo de entrada Tipo Valor por defecto Significado
org str obligatorio El tenant (primer elemento de la tupla de identidad).
namespace str obligatorio El espacio de nombres que la op lee o escribe.
agent str '-' El agente que escribe o lee; '-' o '*' significa cualquier agente donde la op lo permita.
inbox str obligatorio El nombre del inbox, único en la org; registrar un nombre existente edita su configuración.
owner_agent str obligatorio El agente que trabaja el inbox: un pull o claim que no indica agent reclama como este.
description str '' Texto libre que se muestra con el inbox; Loom no lo interpreta.
posters list[str] (calculado) Sujetos autorizados a publicar además de quienes tienen permiso de escritura en el espacio de nombres propietario; una etiqueta de agente aquí solo admite a quien llama sin token.
accept_disclosure list[Literal['confidential', 'internal', 'public_ok']] (calculado) Los niveles de disclosure que puede tener una tarea para llegar aquí; un create o reassign con cualquier otro nivel se rechaza (422).
default_lease_seconds int 1800 Segundos que un claim o heartbeat mantiene el lease cuando la llamada no indica lease_seconds.
max_attempts int 3 Leases vencidos que puede alcanzar una tarea; después, el sweeper la bloquea a la espera de una persona en lugar de devolverla a todo.
max_defers int 5 Aplazamientos que puede tener una tarea; el siguiente task.defer la bloquea a la espera de una persona.
triage_escalate_after_seconds int 14400 Segundos que una tarea puede esperar en triage antes de que el sweeper registre en ella un evento triage_escalated.
webhook_url str '' Dónde se envían por POST los avisos de activación firmados (tipos de evento e ids de tarea, nunca el texto de la tarea): una URL http(s) en un host público (se comprueba de nuevo en cada entrega); "" no envía ninguno.
webhook_secret_ref str '' Nombre de la variable de entorno que contiene el secreto de firma del webhook (nunca se almacena): LOOM_WEBHOOK_SECRET_<ORG>__<NAME>, donde ORG es el id de la org con a-z en mayúsculas, los dígitos conservados y cualquier otro byte como _ y dos dígitos hexadecimales (acme-corp →…
if_match_version int \| None None La version del inbox en la que se basó esta edición; si la versión actual es distinta, responde 409.
Campo de salida Tipo Significado
inbox InboxPayload El inbox tal como quedó escrito.
created bool True cuando esta llamada registró un inbox nuevo; false para una edición de configuración.