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