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 blacklist

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

Cada op es POST /v1/<op> sobre HTTP y la herramienta MCP loom_<op>. Los campos de identidad (org, namespace, agent, user_id, session_id) se rellenan 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 rellena la org de la instalación en todas las ops salvo 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.

blacklist.add

Rechaza las escrituras futuras de memoria cuyo valor coincida con un patrón.

POST /v1/blacklist.add · MCP loom_blacklist_add · rol writer · idempotente · auditada

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.
pattern str obligatorio El texto que se rechaza, comparado con distinción de mayúsculas y minúsculas con un valor almacenado: como subcadena, o como regex de como máximo 256 caracteres.
pattern_type Literal['substring', 'regex'] 'substring' substring (texto plano) o regex (RE2, en las escrituras y en el barrido; acotada al añadir).
scope Literal['namespace', 'org', 'global'] 'namespace' Alcance: namespace (solo este), org (todos los espacios de nombres; requiere admin de la org) o global (todos los tenants; requiere admin de la plataforma).
reason str '' Por qué existe el patrón; se almacena y se lista.
created_by str '' Autor registrado solo cuando la llamada no tiene un principal autenticado que estampar.
sweep bool False Marca también con tombstone las filas vivas que el patrón ya coincide: dentro de esta org, y dentro del espacio de nombres si el patrón es de ese alcance.
Campo de salida Tipo Significado
pattern_id str El id del nuevo patrón, para blacklist.sweep y blacklist.remove.
created_at datetime Cuándo se almacenó el patrón (UTC).
swept int Filas que el barrido marcó con tombstone; 0 sin sweep.
swept_truncated bool True cuando coincidieron más filas de las que toma un barrido; llama a blacklist.sweep.
sweep_error str "" cuando el barrido terminó; si no, el motivo (el patrón queda almacenado en ambos casos): <code>: <message> (vuelve a ejecutar con blacklist.sweep), el motivo de RE2 cuando una regex no puede ejecutarse (no se ejecutó ninguna consulta), o el tipo de error con el que falló la consulta de coincidencia.

blacklist.list

Lista los patrones que impiden almacenar memoria.

POST /v1/blacklist.list · MCP loom_blacklist_list · rol viewer · lectura · no aparece en el listado 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.
scope Literal['namespace', 'org', 'global'] \| None None scope=None devuelve todos los patrones que se aplican a esta (org, namespace), lo que incluye también los patrones de alcance superior (de toda la org, globales): el conjunto de reglas efectivo, no solo los fijados literalmente a este alcance.
limit int 100 Como máximo esta cantidad de patrones, de 1 a 1000, los más recientes primero.
Campo de salida Tipo Significado
rows list[_BlacklistRow] Los patrones vivos que coinciden con el filtro de alcance, los más recientes primero.

blacklist.remove

Elimina un patrón de blacklist añadido previamente.

POST /v1/blacklist.remove · MCP loom_blacklist_remove · rol admin · idempotente · auditada · no aparece en el listado all de MCP

Campo de entrada Tipo Valor por defecto Significado
org str obligatorio El tenant (primer elemento de la tupla de identidad).
pattern_id str obligatorio El patrón que se marca con tombstone; un patrón de espacio de nombres fuera del alcance del llamante responde removed=false.
removed_by str '' Se registra solo en el marcador de versión de la caché de blacklist, no en la fila del patrón.
reason str '' Se acepta pero no se almacena.
Campo de salida Tipo Significado
removed bool False cuando ningún patrón vivo con ese id es visible para el llamante.
removed_at datetime \| None Cuándo se marcó el patrón con tombstone (UTC); null cuando no se eliminó nada.

blacklist.sweep

Marca con tombstone las filas vivas que coinciden con un patrón existente.

POST /v1/blacklist.sweep · MCP loom_blacklist_sweep · rol writer · idempotente · auditada · no aparece en el listado 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.
pattern_id str obligatorio El patrón vivo con el que se barre; un id desconocido o fuera del alcance del llamante responde 404.
Campo de salida Tipo Significado
pattern_id str El patrón con el que se barrió, devuelto tal cual.
matched int Filas vivas que el patrón coincidió en esta llamada: como máximo 5,000 en ClickHouse, más, con la autoridad Postgres, las cabezas aparcadas que esta llamada marcó con tombstone.
tombstoned int Filas que esta llamada marcó con tombstone.
truncated bool True cuando coincidieron más filas de las que toma una llamada; vuelve a llamar.
error str "" cuando el barrido terminó; si no, <code>: <message> una vez que puede haber filas aplicadas (vuelve a llamar), el motivo de RE2 cuando una regex no puede ejecutarse (no se ejecutó ninguna consulta), o el tipo de error con el que falló la consulta de coincidencia; un fallo anterior a eso es el de la llamada.