Referencia del comando `/tree`

/tree abre el navegador interactivo del Árbol de Sesión. Le permite saltar a cualquier entrada en el archivo de sesión actual y continuar desde ese punto.

Se trata de un movimiento de hoja dentro del archivo, no una exportación a nueva sesión.

Qué hace /tree

• Construye un árbol a partir de las entradas de la sesión actual (SessionManager.getTree())
• Abre TreeSelectorComponent con navegación por teclado, filtros y búsqueda
• Al seleccionar, llama a AgentSession.navigateTree(targetId, { summarize, customInstructions })
• Reconstruye el chat visible desde la nueva ruta de hoja
• Opcionalmente prerellena el texto del editor al seleccionar un mensaje de usuario/personalizado

Implementación principal:

• src/modes/controllers/input-controller.ts (/tree, vinculación de atajos de teclado, comportamiento de doble escape)
• src/modes/controllers/selector-controller.ts (lanzamiento de la interfaz del árbol + flujo de solicitud de resumen)
• src/modes/components/tree-selector.ts (navegación, filtros, búsqueda, etiquetas, renderizado)
• src/session/agent-session.ts (navigateTree cambio de hoja + resumen opcional)
• src/session/session-manager.ts (getTree, branch, branchWithSummary, resetLeaf, persistencia de etiquetas)

Cómo abrirlo

Cualquiera de las siguientes opciones abre el mismo selector:

• /tree
• acción de atajo de teclado configurada tree
• doble escape con el editor vacío cuando doubleEscapeAction = "tree" (por defecto)
• /branch cuando doubleEscapeAction = "tree" (redirige al selector de árbol en lugar del selector de ramas solo de usuario)

Modelo de interfaz del árbol

El árbol se renderiza a partir de los punteros de padre de las entradas de sesión (id / parentId).

• Los hijos se ordenan por marca de tiempo ascendente (los más antiguos primero, los más recientes abajo)
• La rama activa (ruta desde la raíz hasta la hoja actual) se marca con una viñeta
• Las etiquetas (si están presentes) se muestran como [etiqueta] antes del texto del nodo
• Si existen múltiples raíces (cadenas de padres huérfanas/rotas), se muestran bajo una raíz virtual de ramificación

Ejemplo de vista de árbol (ruta activa marcada con •):

├─ user: "Start task"
│  └─ assistant: "Plan"
│     ├─ • user: "Try approach A"
│     │  └─ • assistant: "A result"
│     │     └─ • [milestone] user: "Continue A"
│     └─ user: "Try approach B"
│        └─ assistant: "B result"

El selector se recentra alrededor de la selección actual y muestra hasta:

• max(5, floor(terminalHeight / 2)) filas

Atajos de teclado dentro del selector de árbol

• Up / Down: mover selección (cíclico)
• Left / Right: página arriba / página abajo
• Enter: seleccionar nodo
• Esc: limpiar búsqueda si está activa; de lo contrario cerrar selector
• Ctrl+C: cerrar selector
• Type: añadir a la consulta de búsqueda
• Backspace: eliminar carácter de búsqueda
• Shift+L: editar/limpiar etiqueta en la entrada seleccionada
• Ctrl+O: ciclar filtro hacia adelante
• Shift+Ctrl+O: ciclar filtro hacia atrás
• Alt+D/T/U/L/A: saltar directamente a un modo de filtro específico

Semántica de filtros y búsqueda

Modos de filtro (TreeList):

1. default
2. no-tools
3. user-only
4. labeled-only
5. all

default

Muestra la mayoría de los nodos conversacionales, pero oculta los tipos de entrada de gestión interna:

• label
• custom
• model_change
• thinking_level_change

no-tools

Igual que default, además oculta los mensajes toolResult.

user-only

Solo entradas de tipo message donde el rol es user.

labeled-only

Solo entradas que actualmente resuelven a una etiqueta.

all

Todo en el árbol de sesión, incluyendo entradas de gestión interna/personalizadas.

Comportamiento de nodos de asistente solo con herramientas

Los mensajes del asistente que contienen solo llamadas a herramientas (sin texto) están ocultos por defecto en todas las vistas filtradas a menos que:

• el mensaje sea de error/abortado (stopReason no sea stop/toolUse), o
• sea la hoja actual (siempre se mantiene visible)

Comportamiento de búsqueda

• La consulta se tokeniza por espacios
• La coincidencia no distingue mayúsculas de minúsculas
• Todos los tokens deben coincidir (semántica AND)
• El texto buscable incluye etiqueta, rol y contenido específico del tipo (texto del mensaje, texto de resumen de rama, tipo personalizado, fragmentos de comandos de herramientas, etc.)

Resultados de la selección (importante)

navigateTree calcula el nuevo comportamiento de hoja a partir del tipo de entrada seleccionada:

Seleccionar un mensaje de user

• La nueva hoja se convierte en el parentId de la entrada seleccionada
• Si el padre es null (mensaje de usuario raíz), la hoja se reinicia a la raíz (resetLeaf())
• El texto del mensaje seleccionado se copia al editor para editar/reenviar

Seleccionar un custom_message

• Misma regla de hoja que los mensajes de usuario (parentId)
• El contenido de texto se extrae y se copia al editor

Seleccionar un nodo que no es de usuario (asistente/herramienta/resumen/compactación/gestión interna personalizada/etc.)

• La nueva hoja se convierte en el id del nodo seleccionado
• El editor no se prerellena

Seleccionar la hoja actual

• Sin operación; el selector se cierra con “Already at this point”

Decisión de selección (simplificada):

selected node
   │
   ├─ is current leaf? ── yes ──> close selector (no-op)
   │
   ├─ is user/custom_message? ── yes ──> leaf := parentId (or resetLeaf for root)
   │                                     + prefill editor text
   │
   └─ otherwise ──> leaf := selected node id
                    + no editor prefill

Flujo de resumen al cambiar

La solicitud de resumen se controla mediante branchSummary.enabled (por defecto: false).

Cuando está habilitado, después de seleccionar un nodo la interfaz pregunta:

• No summary
• Summarize
• Summarize with custom prompt

Detalles del flujo:

• Escape en la solicitud de resumen reabre el selector de árbol
• La cancelación de la solicitud personalizada retorna al bucle de elección de resumen
• Durante la generación del resumen, la interfaz muestra un indicador de carga y vincula Esc a abortBranchSummary()
• Si el resumen se aborta, el selector de árbol se reabre y no se aplica ningún movimiento

Internos de navigateTree:

• Recopila las entradas de la rama abandonada desde la hoja antigua hasta el ancestro común
• Emite session_before_tree (las extensiones pueden cancelar o inyectar resumen)
• Usa el resumidor por defecto solo si se solicita y es necesario
• Aplica el movimiento con:
  • branchWithSummary(...) cuando existe resumen
  • branch(newLeafId) para movimiento no raíz sin resumen
  • resetLeaf() para movimiento a la raíz sin resumen
• Reemplaza la conversación del agente con el contexto de sesión reconstruido
• Emite session_tree

Nota: si el usuario solicita un resumen pero no hay nada que resumir, la navegación procede sin crear una entrada de resumen.

Etiquetas

Las ediciones de etiquetas en la interfaz del árbol llaman a appendLabelChange(targetId, label).

• Una etiqueta no vacía establece/actualiza la etiqueta resuelta
• Una etiqueta vacía la elimina
• Las etiquetas se almacenan como entradas label de solo adición
• Los nodos del árbol muestran el estado de etiqueta resuelto, no el historial sin procesar de entradas de etiqueta

/tree vs operaciones adyacentes

Operación	Alcance	Resultado
/tree	Archivo de sesión actual	Mueve la hoja al punto seleccionado (mismo archivo)
/branch	Generalmente archivo de sesión actual -> nuevo archivo de sesión	Por defecto ramifica desde el mensaje de usuario seleccionado a un nuevo archivo de sesión; si doubleEscapeAction = "tree", /branch abre la interfaz de navegación de árbol en su lugar
/fork	Toda la sesión actual	Duplica la sesión en un nuevo archivo de sesión persistido
/resume	Lista de sesiones	Cambia a otro archivo de sesión

Distinción clave: /tree es una herramienta de navegación/reposicionamiento dentro de un archivo de sesión. /branch, /fork y /resume cambian el contexto del archivo de sesión.

Flujos de trabajo del operador

Re-ejecutar desde una solicitud de usuario anterior sin perder la rama actual

1. /tree
2. buscar/seleccionar mensaje de usuario anterior
3. elegir No summary (o resumir si es necesario)
4. editar el texto prerrellenado en el editor
5. enviar

Efecto: una nueva rama crece desde el punto seleccionado dentro del mismo archivo de sesión.

Abandonar la rama actual con una referencia de contexto

1. habilitar branchSummary.enabled
2. /tree y seleccionar el nodo destino
3. elegir Summarize (o solicitud personalizada)

Efecto: se añade una entrada branch_summary en la posición destino antes de continuar.

Investigar entradas de gestión interna ocultas

1. /tree
2. presionar Alt+A (all)
3. buscar model, thinking, custom, o etiquetas

Efecto: inspeccionar la línea de tiempo interna completa, no solo los nodos conversacionales.

Marcar puntos de pivote para saltos posteriores

1. /tree
2. moverse a la entrada
3. Shift+L y establecer etiqueta
4. posteriormente usar Alt+L (labeled-only) para saltar rápidamente

Efecto: navegación rápida entre puntos de referencia duraderos de ramas.