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 session

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

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 usa el org de la instalación en todas las ops excepto code.* y tracker.* (que conservan el 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.

session.brief_delete

Elimina un resumen de sesión por su brief_key cuando el usuario pide que se olvide.

POST /v1/session.brief_delete · MCP loom_session_brief_delete · rol writer · idempotente · auditada · no aparece en el conjunto de herramientas MCP all

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.
agent str obligatorio El agente que escribe o lee; '-' o '*' significa cualquier agente cuando la op lo permite.
user_id str '-' El usuario final al que pertenece la fila; '-' si no hay ninguno.
session_id str '-' La sesión o conversación a la que pertenece la fila; '-' si no hay ninguna.
run_id str '-' La ejecución del agente (ámbito de la tarea) a la que pertenece la llamada; '-' si no hay ninguna.
brief_key str obligatorio El resumen que se va a eliminar, tal como lo muestra session.brief_list.
Campo de salida Tipo Significado
deleted bool False cuando ningún resumen activo tiene esta clave (desconocida o ya eliminada).
brief_key str Eco del brief_key de entrada.
revision int La revisión en la que estaba el resumen cuando se eliminó; 0 cuando no se eliminó nada.

session.brief_get

Carga un resumen (brief): por brief_key; si no se indica, el resumen más reciente que escribió una sesión dada (from_session); si tampoco, el más reciente de project.

POST /v1/session.brief_get · MCP loom_session_brief_get · rol viewer · lectura · no figura en el toolset 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.
agent str obligatorio El agente que escribe o lee; '-' o '*' significa cualquier agente donde la op lo permita.
user_id str '-' El usuario final al que pertenece la fila; '-' si no hay ninguno.
session_id str '-' La sesión o conversación a la que pertenece la fila; '-' si no hay ninguna.
run_id str '-' La ejecución del agente (ámbito de tarea) a la que pertenece la llamada; '-' si no hay ninguna.
brief_key str '' El resumen que se carga; tiene prioridad sobre from_session y project.
from_session str '' Carga el resumen más reciente al que contribuyó este id de sesión.
project str '' Carga el resumen más reciente de este proyecto (se usa cuando brief_key y from_session están vacíos).
revision int 0 0 = la revisión actual; N = esa revisión del historial.
include_sections bool False Devuelve también las sections estructuradas; con False solo se devuelve rendered.
full bool False Añade, tal cual, el resumen propio del cliente de su última compactación debajo del brief (hasta ~15k caracteres más).
Campo de salida Tipo Significado
found bool False cuando ningún resumen coincidió, el resumen está eliminado o la revisión no está en su historial.
brief_key str Clave del resumen que coincidió.
revision int La revisión devuelta (la actual, salvo que se pidiera revision).
rendered str El resumen como texto, con el resumen de compactación del cliente añadido cuando full está activo.
sections BriefSections \| None El resumen estructurado; None salvo que se indicara include_sections.
project str Proyecto almacenado en el resumen.
branch str Rama almacenada en el resumen.
head_sha str Commit en el que estaba el checkout cuando se guardó esta revisión.
author str Quién escribió la revisión: llm, deterministic o model (el agente que llama).
trigger str Qué motivó el guardado de la revisión (precompact, session_end, stop, manual o model).
actor str El principal que guardó la revisión (human:<subject> / process:<subject>): un escritor de todo el espacio de nombres puede guardar en el resumen ~<user>~ propio de un usuario.
source_sessions list[str] Ids de sesión que contribuyeron al resumen, de la más antigua a la más reciente (las últimas 20).
updated_at datetime \| None Cuándo se guardó la revisión devuelta.
age_seconds int Segundos transcurridos desde updated_at.
revisions int Cuántas revisiones contiene el historial del resumen.
events_total int Eventos condensados en el resumen a lo largo de toda su vida.
source_chars int Caracteres de texto de eventos condensados en el resumen a lo largo de toda su vida.
brief_chars int Longitud de rendered tal como se almacena, en caracteres.
deleted bool True cuando el escritor eliminó el resumen; en ese caso no se sirve nada más.

session.brief_list

Lista los resúmenes de sesión de este espacio de nombres, los más recientes primero: clave, revisión, antigüedad, agente y objetivo, una línea por cada uno.

POST /v1/session.brief_list · MCP loom_session_brief_list · rol viewer · lectura · no figura en el conjunto de herramientas MCP all

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.
agent str obligatorio El agente que escribe o lee; '-' o '*' significa cualquier agente donde la op lo permita.
user_id str '-' El usuario final al que pertenece la fila; '-' si ninguno.
session_id str '-' La sesión o conversación a la que pertenece la fila; '-' si ninguna.
run_id str '-' La ejecución del agente (ámbito de la tarea) a la que pertenece la llamada; '-' si ninguna.
project str '' Solo los resúmenes de este proyecto; vacío = todos los proyectos.
mine_only bool False True = solo los resúmenes del agente que llama; por defecto, los de todos los agentes.
from_session str '' Solo los resúmenes a los que contribuyó este id de sesión; vacío = sin filtro de sesión.
limit int 10 Como máximo este número de resúmenes (1-50).
Campo de salida Tipo Significado
briefs list[SessionBriefSummary] Resúmenes activos, los guardados más recientemente primero; vacío cuando el espacio de nombres no contiene ninguno.
rendered str Una línea por resumen, lista para mostrar.

session.brief_save

Revisa (o inicia) un resumen.

POST /v1/session.brief_save · MCP loom_session_brief_save · rol writer · idempotente · auditado · no figura en el conjunto de herramientas all de MCP

Campo de entrada Tipo Valor por defecto Significado
org str obligatorio El inquilino (primer elemento de la tupla de identidad).
namespace str obligatorio El espacio de nombres que la operación lee o escribe.
agent str obligatorio El agente que escribe o lee; '-' o '*' significa cualquier agente donde la operación lo permita.
user_id str '-' El usuario final al que pertenece la fila; '-' si no hay ninguno.
session_id str '-' La sesión o conversación a la que pertenece la fila; '-' si no hay ninguna.
run_id str '-' La ejecución del agente (ámbito de tarea) a la que pertenece la llamada; '-' si no hay ninguna.
brief_key str '' La dirección del resumen en el espacio de nombres.
project str '' Proyecto al que pertenece el trabajo; junto con branch forma la clave automática.
repo str '' Repositorio en el que se trabaja, almacenado en el resumen; si está vacío se conserva el valor almacenado.
branch str '' Rama en la que se trabaja; junto con project forma la clave automática.
head_sha str '' Commit en el que estaba el checkout al guardar; si está vacío se conserva el valor almacenado.
trigger Literal['precompact', 'session_end', 'stop', 'manual', 'model'] 'manual' Qué motivó el guardado: manual y model siempre guardan; los automáticos precompact, session_end y stop no almacenan nada mientras la grabación del espacio de nombres esté desactivada.
events list[BriefEvent] (calculado) Lo ocurrido desde el último guardado (como máximo 4000 eventos), condensado en la revisión.
sections BriefSections \| None None Un resumen que el agente que llama escribió a partir de su propio contexto: las secciones rellenadas reemplazan a las almacenadas (las decisiones y los callejones sin salida se añaden).
event_cursor str '' Posición opaca del cliente en la que terminan los eventos (un índice de línea de la transcripción).
if_revision int \| None None Comparar y establecer: rechaza (409) a menos que la revisión almacenada sea esta.
use_llm bool \| None None Fuerza el constructor determinista (False) o el modelo (True); None = la configuración del despliegue.
Campo de salida Tipo Significado
brief_key str La clave bajo la que se guardó el resumen (la clave automática resuelta cuando no se indicó ninguna).
revision int La revisión del resumen tras esta llamada (la almacenada si no hubo cambios; 0 cuando no hay ninguna vigente).
changed bool True cuando se escribió una nueva revisión; False cuando reason indica por qué no.
author str "llm" (revisado por el modelo), "deterministic" (no hay modelo configurado, o falló; nunca bajo la política de extracción de un operador), "model" (el agente que llama escribió las secciones).
reason str Por qué no se escribió nada: nothing-to-save, recording_off, already-saved o not-revised (hay una política de extracción de un operador en vigor y no hay modelo que revise el resumen); vacío cuando changed.
rendered str El resumen como texto, listo para mostrar; el almacenado cuando no hubo cambios.
stats SessionBriefStats Recuentos de este guardado: eventos, ventanas, tamaños, tokens y el modelo utilizado.