Pular para conteúdo

As páginas sem tradução abrem em inglês e são identificadas como inglês.

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.

Operações de conflicts

Os campos exatos que cada operação conflicts.* 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, é preenchida a org da instalação em todas as ops, exceto code.* e tracker.* (que mantêm a do seu plano), e em algumas ops também 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 nomeados em ignored_args.

conflicts.allowlist_list

Lista os pares (memory_key, memory_key) marcados como sabidamente sem conflito, para que o worker de conflitos pare de sinalizá-los.

POST /v1/conflicts.allowlist_list · MCP loom_conflicts_allowlist_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.
limit int 100 No máximo este número de pares, de 1 a 1000, os mais novos primeiro.
Campo de saída Tipo Significado
rows list[_AllowlistRow] Pares de chaves permitidos ativos (memory_key_a vem antes de memory_key_b), os mais novos primeiro.

conflicts.allowlist_remove

Revoga uma decisão de permissão; o par voltará a ser sinalizado em gravações futuras.

POST /v1/conflicts.allowlist_remove · MCP loom_conflicts_allowlist_remove · role admin · idempotente · auditada · 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.
memory_key_a str obrigatório Uma chave do par permitido; a ordem das duas chaves não importa.
memory_key_b str obrigatório A outra chave do par.
removed_by str '' Quem revogou; é anexado, junto com reason, ao motivo armazenado do par.
reason str '' Por quê; anexado ao motivo armazenado do par.
Campo de saída Tipo Significado
removed bool False quando nenhum par permitido ativo correspondeu.

conflicts.list

Lista os conflitos não resolvidos em que duas memórias se contradizem.

POST /v1/conflicts.list · MCP loom_conflicts_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.
limit int 50 No máximo este número de linhas, de 1 a 500, a versão mais nova primeiro.
before_version int \| None None Cursor keyset: passe a versão mais antiga da resposta anterior para paginar.
count_only bool False Um badge precisa do número, não das linhas.
fresh bool False Com count_only, conta agora em vez de ler o cache de um minuto; desativado por padrão.
keys_only bool False A visão Memories marca os cards que têm conflito e precisa apenas das chaves.
fields list[str] \| None None Os campos de saída que o chamador lê (uma lista de permissão resolvida contra o modelo da linha; um nome desconhecido gera 422); se não definido, todos os campos.
Campo de saída Tipo Significado
rows list[_ConflictRow] Memórias em conflito, a versão mais nova primeiro; vazio em uma chamada com count_only ou keys_only.
next_before_version int \| None Passe como before_version para a próxima página; null na última página.
total int \| None A contagem ativa de conflitos do namespace; definida em uma chamada com count_only.
keys list[str] \| None As chaves de memória em conflito do namespace; definidas em uma chamada com keys_only.

conflicts.propose_revision

Retorna sugestões não destrutivas de revise/contract/allow.

POST /v1/conflicts.propose_revision · MCP loom_conflicts_propose_revision · 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.
memory_id str obrigatório A memória em conflito sobre a qual aconselhar (um id válido para toda a org).
peer_id str \| None None Limita o conselho a este par de conflict_with; None considera todos os pares.
Campo de saída Tipo Significado
found bool False quando a memória, ou todas as linhas que ela nomeia, não está ativa em namespace.
memories list[_ConflictCandidateMemory] Primeiro o alvo (local_id 1), depois seus pares ativos, os mais novos primeiro.
suggestions list[_ConflictRevisionSuggestion] No máximo um conflicts.resolve sugerido, por id local: revise quando o alvo está fixado ou compartilha a chave de um par, contract quando um par está fixado, caso contrário allow.
note str Sempre informa que nada foi aplicado: esta operação apenas aconselha.

conflicts.resolve

Escolhe o vencedor de um conflito (manter A, manter B, manter ambos, mesclar).

POST /v1/conflicts.resolve · MCP loom_conflicts_resolve · role admin · idempotente · auditada · 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.
memory_id str obrigatório A memória em conflito sobre a qual é a decisão (um id válido para toda a org); ela deve estar em namespace.
decision Literal['revise', 'contract', 'allow'] obrigatório revise a mantém e marca os pares como removidos (tombstone); contract a marca como removida e reativa os pares; allow reativa todos e coloca cada par de chaves na lista de permissão.
peer_id str \| None None Opcional: restringe a resolução a um par específico (revise apenas contra esse).
reason str '' Por quê; anexado ao source_trace das linhas marcadas como removidas e armazenado nas linhas da lista de permissão (primeiros 512 caracteres).
resolved_by str '' Quem resolveu, registrado ao lado de reason (primeiros 128 caracteres); não é verificado contra o token.
Campo de saída Tipo Significado
resolved bool False quando a memória ou o par nomeado é desconhecido, ou a memória não está em namespace; nada foi gravado nesse caso.
decision Literal['revise', 'contract', 'allow'] A decisão, devolvida como recebida.
affected_memory_ids list[str] Todo id de memória que esta chamada marcou como removido ou reativou.
resolved_at datetime \| None Quando a resolução foi executada (UTC); null quando nada foi resolvido.
total int \| None A contagem de conflitos do namespace sob o escopo de leitura do chamador, contada após as gravações; null quando nada foi resolvido ou a contagem falhou.