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