> Source: https://clickhouse.github.io/loom/es/reference/operations/session/ (Markdown: https://clickhouse.github.io/loom/es/reference/operations/session.md)

<!-- i18n: source=docs/reference/operations/session.md blob=ef3c231b70d1fcd6e901f42238a70972ed7ee390 model=claude-sonnet-5-5 -->
> Esta página es una traducción automática de la [página en inglés](https://clickhouse.github.io/loom/reference/operations/session/), que prevalece.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/session/), which is authoritative.

<a id="session-operations"></a>

# Operaciones de `session`

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

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

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](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) también su espacio de nombres y su agente; consulta [identidades y espacios de nombres](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md). El [índice de operaciones](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica el rol, el tipo y el listado `all` de MCP. Los campos de entrada desconocidos se atienden y se nombran en `ignored_args`.

<!-- prettier-ignore-start -->

<a id="sessionbrief_delete"></a>

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

<a id="sessionbrief_get"></a>

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

<a id="sessionbrief_list"></a>

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

<a id="sessionbrief_save"></a>

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

<!-- prettier-ignore-end -->
