tessera

TESSERA (Temporal Evolving State Synthesis with Explicit Relations and Atomic Memories) es una capa de memoria y evidencia centrada en texto para agentes de IA. Se publica como tessera-agent-memory, mientras que la importación de Python y la CLI permanecen como tessera; requiere Python 3.9+ y tiene licencia MIT. La versión actual es 0.0.1. El proyecto se define como infraestructura de memoria en lugar de un agente de razonamiento final. El Markdown y las fuentes textuales mantienen la autoridad; los índices, grafos, cachés y registros de evidencia son derivados y reconstruibles. La recuperación devuelve evidencia estructurada en lugar de una respuesta generada, y el README establece que la relevancia no se trata como verdad, confianza o autoridad, que las fuentes no se reescriben silenciosamente durante la indexación y que no se requiere un LLM generativo para la ruta de recuperación básica. Interfaces y uso - CLI: tessera init, write, index, query, además de config show/list/doctor/unregister. La inicialización no interactiva requiere una política --sources explícita, y los cambios materiales en una configuración existente deben inspeccionarse primero con --dry-run y luego permitirse con --update-existing. - API de Python: TesseraEngine(storage_dir=...).build_index() y retrieve_context(query, top_n=...), devolviendo campos como id, score con score_explain, relevant_evidence, cuerpo completo de la memoria, ruta de la fuente, identidad estable del documento-fuente, hashes de versión de la fuente, span de evidencia e IDs de memoria relacionados. - MCP: un extra opcional tessera[mcp] añade el transporte MCP (SDK v1.30+, Python 3.10+, certificado en 3.12), con tessera-mcp --project /absolute/project; un extra opcional tessera[llm] añade un puente HTTP LLM. Modelo de memoria y almacenamiento - Se preservan exactamente tres cajones semánticos: facts, preferences e insights. - La identidad está separada de la ubicación del archivo y la versión del contenido, por lo que mover un documento no crea automáticamente una nueva memoria o identidad de fuente. - La configuración es un esquema v2 legible por humanos: store.path es el destino de la memoria generada, sources.roots es una lista de permitidos explícita para lectura/indexación, e index.path es el estado derivado desechable dentro del proyecto. Un registro global de usuario puede recordar almacenes nombrados sin copiar ni fusionar su memoria. - El orden de resolución del almacenamiento es: ruta explícita, TESSERA_STORAGE_DIR, el obsoletó LAO_MEM_DIR, la configuración del proyecto más cercana y, finalmente, una entrada global nombrada; las operaciones de la CLI fallan con un error accionable si no se selecciona ninguna. - Markdown es el único formato escribible canónico; los formatos no compatibles y la ingesta de JSON arbitrario se rechazan antes de cualquier mutación de almacenamiento, registro, grafo, índice o Evidence Ledger. - Las escrituras siguen un contrato determinista: validación de ruta, detección, transformación opcional, admisión y persistencia. El contenido seguro se acepta sin cambios; las entradas vacías y las instrucciones hostiles conocidas se rechazan; los ejemplos citados y las entradas que solo contienen etiquetas sospechosas pasan a revisión sin efectos secundarios de persistencia. - Un archivo .tessera-ignore opcional soporta un subconjunto documentado de sintaxis de ignorado (comentarios, *, ?, **, sufijo de directorio, re-inclusión ordenada !); las exclusiones obligatorias como .git, el índice derivado y los artefactos de credenciales no pueden re-incluirse. Evaluación y estado Un libro mayor compacto y no sensible versiona un perfil de recuperación determinista LongMemEval V1 dev-50, registrando métricas de recuperación agregadas, entradas congeladas, configuración, procedencia del commit, costo y hashes sin comprometer el conjunto de datos ni los mapeos de verdad fundamental. Cada pull request declara la aplicabilidad del benchmark; se ejecutan comprobaciones de informes offline por PR y el perfil de 50 consultas congeladas se valida contra el SHA base del PR. El README señala que estas puntuaciones miden la recuperación de evidencia, no la corrección de la respuesta final. TESSERA se describe como una Fundación en evolución. Lo disponible hoy incluye metadatos canónicos y clasificación de documentos, identidad estable de memoria y fuente, recuperación local explicable, evidencia relevante consciente de la consulta, el Evidence Ledger y procedencia, análisis/navegación de relaciones, superficies de Python/CLI/MCP y CI determinista con evaluación de cordura. Los elementos que aún se están probando incluyen la indexación incremental e idempotente, una ingesta y segmentación de texto más amplia, una línea base de LongMemEval, expansión de grafos consciente de la consulta, estado temporal, arbitraje de evidencia conflictiva y recuperación adaptativa. La documentación cubre arquitectura, conceptos, ejemplos de consultas, el contrato de salida de recuperación, una hoja de ruta, referencias de investigación y una política de cambios; el repositorio es mantenido actualmente por Luigi Ferronatto.