Tesserae v0.20.1 — sesiones largas, completamente capturadas

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Français · Deutsch

<!-- translations:end -->

Lanzado 2026-07-14 · PyPI · GitHub release · pip install --upgrade tesserae==0.20.1

Una versión de corrección de errores para cualquiera con sesiones de agente largas — que, si Tesserae está haciendo su trabajo, es todos.

El bug de truncamiento de 300 turnos

La importación de sesión (_claude_turns / _codex_turns) dejó de capturar silenciosamente después de 300 turnos por sesión. Todo lo que vino después — el extractor LLM fragmentado, hallazgos de sesión, decisiones, el gráfico tipificado — solo vio los primeros 300 turnos de una sesión larga. Los conocimientos, decisiones y TODOs de la última parte de una sesión de maratón nunca se extrajeron, y nada advertía sobre ello.

El límite predataba la canalización de extracción fragmentada y fue hecho obsoleto por ella: el extractor lee el historial en ventanas de max_turns_per_chunk con límites de texto por turno, por lo que el tamaño del aviso de cada llamada LLM está limitado independientemente de la duración total de la sesión. El truncamiento en el momento de la captura solo descartaba conocimiento.

La solución

El valor por defecto del importador ahora es un tope de archivo desbocado (100,000 turnos) en lugar de un punto de truncamiento, coincidiendo con cada sitio de llamada explícita (resumen de actividad, chunks de sesión, servicio en vivo). El historial completo de conversación fluye hacia el almacén de chunks y el extractor; el contexto LLM por llamada se mantiene limitado por la capa de fragmentación, donde esa preocupación pertenece.

Las compilaciones incrementales siguen siendo económicas: los cachés de chunks están alineados con el índice, por lo que los chunks previamente extraídos de las sesiones existentes permanecen como aciertos de caché — solo los turnos recién visibles se extraen en tu próxima compilación. Espera que esa primera recompilación después de actualizar a 0.20.1 haga más llamadas LLM de lo usual en proyectos con sesiones largas; ese es el trabajo atrasado del historial previamente invisible siendo extraído una vez.

Sin cambios de API o esquema. pip install --upgrade tesserae==0.20.1 (o npm i -g @jokerized/tesserae@0.20.1) y recompila.