Saltar a contenido

Las páginas sin traducir se abren en inglés y se indican como inglés.

Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.

Operaciones de conflicts

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

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 también su espacio de nombres y su agente; consulta identidades y espacios de nombres. El índice de operaciones explica el rol, el tipo y el listado all de MCP. Los campos de entrada desconocidos se atienden y se nombran en ignored_args.

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.

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ó.

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.

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.

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ó.