> Source: https://clickhouse.github.io/loom/es/reference/operations/conflicts/ (Markdown: https://clickhouse.github.io/loom/es/reference/operations/conflicts.md)

<!-- i18n: source=docs/reference/operations/conflicts.md blob=25d369595f64dda74c9f2e7964c2658047ae2f9f model=claude-sonnet-5-5 -->
> Esta página es una traducción automática de la [página en inglés](https://clickhouse.github.io/loom/reference/operations/conflicts/), que prevalece.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/conflicts/), which is authoritative.

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

# Operaciones de `conflicts`

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

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

Cada op es `POST /v1/<op>` por 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 la org de la instalación en todas las ops excepto `code.*` y `tracker.*` (que conservan la de su plano), y en [algunas ops](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) también su espacio de nombres y su agente; consulta [identidades y espacios de nombres](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md). El [índice de operaciones](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica el rol, el tipo y el listado `all` de MCP. Los campos de entrada desconocidos se atienden y se nombran en `ignored_args`.

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

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

## `conflicts.allowlist_list`

Lista los pares (memory_key, memory_key) marcados como no conflictivos conocidos para que el worker de conflictos deje de señalarlos.

`POST /v1/conflicts.allowlist_list` · MCP `loom_conflicts_allowlist_list` · rol `viewer` · lectura · 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. |
| `limit` | `int` | `100` | Como máximo esta cantidad de pares, de 1 a 1000, los más recientes primero. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `rows` | `list[_AllowlistRow]` | Pares de claves permitidos vigentes (`memory_key_a` se ordena antes que `memory_key_b`), los más recientes primero. |

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

## `conflicts.allowlist_remove`

Revoca una decisión de permitir; el par volverá a señalarse en escrituras futuras.

`POST /v1/conflicts.allowlist_remove` · MCP `loom_conflicts_allowlist_remove` · rol `admin` · idempotente · auditada · 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. |
| `memory_key_a` | `str` | obligatorio | Una clave del par permitido; el orden de las dos claves no importa. |
| `memory_key_b` | `str` | obligatorio | La otra clave del par. |
| `removed_by` | `str` | `''` | Quién lo revocó; se añade junto con `reason` al motivo almacenado del par. |
| `reason` | `str` | `''` | Por qué; se añade al motivo almacenado del par. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `removed` | `bool` | False cuando ningún par permitido vigente coincidió. |

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

## `conflicts.list`

Lista los conflictos sin resolver en los que dos memorias se contradicen.

`POST /v1/conflicts.list` · MCP `loom_conflicts_list` · rol `viewer` · lectura · 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. |
| `limit` | `int` | `50` | Como máximo esta cantidad de filas, de 1 a 500, la versión más reciente primero. |
| `before_version` | `int \| None` | `None` | Cursor keyset: pasa la versión más antigua de la respuesta anterior para paginar. |
| `count_only` | `bool` | `False` | Un indicador necesita el número, no las filas. |
| `fresh` | `bool` | `False` | Con count_only, cuenta en el momento en lugar de leer la caché de un minuto; desactivado por defecto. |
| `keys_only` | `bool` | `False` | La vista Memories marca las tarjetas que tienen un conflicto y solo necesita las claves. |
| `fields` | `list[str] \| None` | `None` | Los campos de salida que lee quien llama (una lista blanca resuelta contra el modelo de fila; un nombre desconocido da un 422); sin definir, todos los campos. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `rows` | `list[_ConflictRow]` | Memorias en conflicto, la versión más reciente primero; vacío en una llamada `count_only` o `keys_only`. |
| `next_before_version` | `int \| None` | Pásalo como `before_version` para la página siguiente; null en la última página. |
| `total` | `int \| None` | El número vigente de conflictos del espacio de nombres; se define en una llamada count_only. |
| `keys` | `list[str] \| None` | Las claves de memoria en conflicto del espacio de nombres; se define en una llamada keys_only. |

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

## `conflicts.propose_revision`

Devuelve sugerencias no destructivas de revise/contract/allow.

`POST /v1/conflicts.propose_revision` · MCP `loom_conflicts_propose_revision` · rol `viewer` · lectura · 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. |
| `memory_id` | `str` | obligatorio | La memoria en conflicto sobre la que aconsejar (un id válido en toda la org). |
| `peer_id` | `str \| None` | `None` | Limita el consejo a este par de su `conflict_with`; None considera todos los pares. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `found` | `bool` | False cuando la memoria, o todas las filas que nombra, no están vigentes en `namespace`. |
| `memories` | `list[_ConflictCandidateMemory]` | Primero el objetivo (`local_id` 1), luego sus pares vigentes, los más recientes primero. |
| `suggestions` | `list[_ConflictRevisionSuggestion]` | Como máximo un `conflicts.resolve` sugerido, por id local: revise cuando el objetivo está fijado o comparte clave con un par, contract cuando un par está fijado, y en otro caso allow. |
| `note` | `str` | Siempre indica que no se aplicó nada: esta operación solo aconseja. |

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

## `conflicts.resolve`

Elige al ganador de un conflicto (conservar A, conservar B, conservar ambos, fusionar).

`POST /v1/conflicts.resolve` · MCP `loom_conflicts_resolve` · rol `admin` · idempotente · auditada · 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. |
| `memory_id` | `str` | obligatorio | La memoria en conflicto sobre la que trata la decisión (un id válido en toda la org); debe estar en `namespace`. |
| `decision` | `Literal['revise', 'contract', 'allow']` | obligatorio | `revise` la conserva y marca como eliminados a los pares; `contract` la marca como eliminada y reactiva a los pares; `allow` reactiva todas y añade a la lista de permitidos cada par de claves. |
| `peer_id` | `str \| None` | `None` | Opcional: limita la resolución a un par concreto (revise solo contra ese). |
| `reason` | `str` | `''` | Por qué; se añade al `source_trace` de las filas marcadas como eliminadas y se almacena en las filas de la lista de permitidos (primeros 512 caracteres). |
| `resolved_by` | `str` | `''` | Quién la resolvió, registrado junto a `reason` (primeros 128 caracteres); no se comprueba contra el token. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `resolved` | `bool` | False cuando la memoria o el par indicado son desconocidos, o la memoria no está en `namespace`; en ese caso no se escribió nada. |
| `decision` | `Literal['revise', 'contract', 'allow']` | La decisión, devuelta tal cual. |
| `affected_memory_ids` | `list[str]` | Todos los ids de memoria que esta llamada marcó como eliminados o reactivó. |
| `resolved_at` | `datetime \| None` | Cuándo se ejecutó la resolución (UTC); null cuando no se resolvió nada. |
| `total` | `int \| None` | El número de conflictos del espacio de nombres dentro del alcance de lectura de quien llama, contado después de las escrituras; null cuando no se resolvió nada o el conteo falló. |

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