---
title: "Operações de `conflicts`"
---

<!-- i18n: source=docs/reference/operations/conflicts.md blob=25d369595f64dda74c9f2e7964c2658047ae2f9f model=claude-sonnet-5-5 -->
> Esta página é uma tradução automática da [página em inglês](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/conflicts.md), que prevalece.
> Machine-translated from the [English page](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/conflicts.md), which is authoritative.

<a id="conflicts-operations"></a>

Os campos exatos que cada operação `conflicts.*` recebe e retorna.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

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](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) também o namespace e o agente; veja [identidades e namespaces](/docs/pt-BR/concepts/identities-and-namespaces). O [índice de operações](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica role, kind e a listagem `all` do MCP. Campos de entrada desconhecidos são atendidos e nomeados em `ignored_args`.

<!-- prettier-ignore-start -->

<a id="conflictsallowlist_list"></a>

## `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. |

<a id="conflictsallowlist_remove"></a>

## `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. |

<a id="conflictslist"></a>

## `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. |

<a id="conflictspropose_revision"></a>

## `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. |

<a id="conflictsresolve"></a>

## `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. |

<!-- prettier-ignore-end -->
