Operações de `inbox`
Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.
Os campos exatos que cada operação inbox.* recebe e retorna.
Toda op é POST /v1/<op> via HTTP e a ferramenta MCP loom_<op>. Os campos de identidade (org, namespace, agent, user_id, session_id) são preenchidos a partir do token e da sessão MCP quando o transporte consegue; em uma chamada HTTP sem token em um servidor de usuário único, usa-se a org da instalação em todas as ops, exceto code.* e tracker.* (que mantêm a org do seu plano), e, em algumas ops, o namespace e o agente; veja identidades e namespaces. O índice de operações explica role, kind e a listagem all do MCP. Campos de entrada desconhecidos são atendidos e listados em ignored_args.
inbox.list
Inboxes que o chamador pode ver: aquelas pertencentes a namespace (o namespace autorizado) e, com mine_everywhere, todas as inboxes da organização nas quais o chamador pode postar: uma cujo namespace proprietário o chamador…
POST /v1/inbox.list · MCP loom_inbox_list · role viewer · leitura · não listada no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace que a op lê ou grava. |
agent |
str |
'-' |
O agente que grava ou lê; '-' ou '*' significa qualquer agente quando a op permite. |
mine_everywhere |
bool |
False |
Lista também todas as inboxes da organização nas quais o chamador pode postar (gravação no namespace proprietário, ou listado como poster); com false, lista apenas as inboxes pertencentes a namespace. |
limit |
int |
200 |
No máximo este número de linhas de inbox é lido, de 1 a 500 (com mine_everywhere, antes do filtro de visibilidade). |
| Campo de saída | Tipo | Significado |
|---|---|---|
inboxes |
list[InboxPayload] |
As inboxes visíveis, ordenadas por nome. |
inbox.policy_list
Lista as políticas de confiança de uma inbox.
POST /v1/inbox.policy_list · MCP loom_inbox_policy_list · papel viewer · leitura · não listado no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace que a op lê ou grava. |
agent |
str |
'-' |
O agente que grava ou lê; '-' ou '*' significa qualquer agente, onde a op permite. |
inbox |
str |
obrigatório | A inbox cujas regras serão listadas; se o chamador não puder lê-la, a resposta é 404. |
| Campo de saída | Tipo | Significado |
|---|---|---|
policies |
list[PolicyPayload] |
Todas as regras ativas da inbox, ordenadas por poster e depois por kind. |
inbox.policy_set
Define o modo de confiança que o dono de uma inbox escolheu para um autor de postagens e um tipo de tarefa (o Loom armazena o valor, nunca o altera).
POST /v1/inbox.policy_set · MCP loom_inbox_policy_set · role admin · idempotente · auditado · não listado no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace que a op lê ou grava. |
agent |
str |
'-' |
O agente que grava ou lê; '-' ou '*' significa qualquer agente, onde a op permitir. |
inbox |
str |
obrigatório | A inbox à qual a regra pertence; quem chama deve ser admin do namespace dono dela. |
poster |
str |
obrigatório | Quem a regra cobre: um subject, um rótulo de agente ou * para todos os autores de postagens. |
kind |
str |
'*' |
O tipo de tarefa que a regra cobre; * cobre todos os tipos. |
mode |
Literal['deny', 'review', 'auto'] |
obrigatório | deny recusa a postagem (403), review a coloca em triage, auto a coloca em todo. |
require_evidence |
list[str] |
(calculado) | Campos do brief que devem estar presentes (uma verificação de formato na criação), por exemplo [“inputs.finding_id”]. |
remove |
bool |
False |
True exclui a regra (poster, kind) em vez de defini-la. |
| Campo de saída | Tipo | Significado |
|---|---|---|
policy |
PolicyPayload | None |
A regra como armazenada; null quando remove a excluiu. |
removed |
bool |
True quando a regra foi excluída. |
inbox.principals
As identidades que o loom já conhece na organização — a fonte do seletor de remetentes.
POST /v1/inbox.principals · MCP loom_inbox_principals · papel admin · idempotente · não listado no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace que a op lê ou grava. |
agent |
str |
'-' |
O agente que grava ou lê; '-' ou '*' significa qualquer agente quando a op permite. |
inbox |
str |
obrigatório | A inbox cujos remetentes são marcados como listed; um nome não registrado ou ilegível é respondido em relação a namespace, sem ninguém listado. |
query |
str |
'' |
Substring sem distinção entre maiúsculas e minúsculas, comparada com o subject e o label; “” retorna todos. |
limit |
int |
200 |
No máximo esta quantidade de principals, de 1 a 500; truncated indica que houve mais correspondências. |
| Campo de saída | Tipo | Significado |
|---|---|---|
principals |
list[Principal] |
Primeiro pessoas, depois contas de serviço, depois os demais, cada grupo ordenado por label. |
truncated |
bool |
True quando mais principals corresponderam do que limit. |
inbox.register
namespace é o namespace proprietário (quem chama precisa ser o administrador dele).
POST /v1/inbox.register · MCP loom_inbox_register · papel admin · idempotente · auditado · não listado no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace que a op lê ou grava. |
agent |
str |
'-' |
O agente que grava ou lê; '-' ou '*' significa qualquer agente onde a op permitir. |
inbox |
str |
obrigatório | O nome da inbox, único na org; registrar um nome existente edita suas configurações. |
owner_agent |
str |
obrigatório | O agente que trabalha a inbox: um pull ou claim sem agent faz o claim como ele. |
description |
str |
'' |
Texto livre exibido com a inbox; o Loom não o interpreta. |
posters |
list[str] |
(calculado) | Subjects autorizados a postar, além dos writers do namespace proprietário; um rótulo de agente aqui admite apenas quem chama sem token. |
accept_disclosure |
list[Literal['confidential', 'internal', 'public_ok']] |
(calculado) | Os níveis de disclosure que uma tarefa pode ter para chegar aqui; um create ou reassign com qualquer outro nível é recusado (422). |
default_lease_seconds |
int |
1800 |
Segundos que um claim ou heartbeat mantém o lease quando a chamada não informa lease_seconds. |
max_attempts |
int |
3 |
Leases expirados que uma tarefa pode atingir; depois disso o sweeper a bloqueia em um humano em vez de devolvê-la a todo. |
max_defers |
int |
5 |
Defers que uma tarefa pode receber; o próximo task.defer a bloqueia em um humano. |
triage_escalate_after_seconds |
int |
14400 |
Segundos que uma tarefa pode esperar em triage antes de o sweeper registrar nela um evento triage_escalated. |
webhook_url |
str |
'' |
Para onde são enviados por POST avisos de despertar assinados (tipos de evento e ids de tarefa, nunca o texto da tarefa): uma URL http(s) em um host público (verificada de novo a cada entrega); “” não envia nenhum. |
webhook_secret_ref |
str |
'' |
Nome da variável de ambiente que guarda o segredo de assinatura do webhook (nunca armazenado): LOOM_WEBHOOK_SECRET_<ORG>__<NAME>, ORG é o id da org com a-z em maiúsculas, dígitos mantidos e qualquer outro byte como _ e dois dígitos hex (acme-corp →… |
if_match_version |
int | None |
None |
A version da inbox em que esta edição se baseou; uma versão atual diferente responde 409. |
| Campo de saída | Tipo | Significado |
|---|---|---|
inbox |
InboxPayload |
A inbox como gravada. |
created |
bool |
True quando esta chamada registrou uma inbox nova; false para uma edição de configurações. |