Operações de `conflicts`
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 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. |