- Cuando un agente de programación responde preguntas estructurales como "¿cómo funciona esto?", normalmente repite decenas de veces grep → abrir archivo → rastrear imports, quemando tokens
- @ttsc/graph le pasa al agente vía MCP el grafo de código que el compilador de TypeScript ya interpretó (qué llama a qué / de qué depende), para que responda directamente desde el grafo en lugar de hurgar en archivos
- Dos puntos clave del diseño
- Devuelve solo el índice: nunca entrega el cuerpo del código fuente; solo nombres, aristas, firmas y spans file:line → el tamaño de la respuesta no depende del tamaño del repo y los tokens no se disparan
- Chain-of-Thought obligatorio: la entrada de una única herramienta es un esquema de tipos, así que el agente solo puede hacer la solicitud después de llenar question → draft → review. typia compila el esquema + validador y rechaza en el límite de llamada el intento de "saltarse el razonamiento"
- Resultado: alrededor de 10 veces menos tokens en preguntas abiertas, con calidad de respuesta equivalente (8 repos × 4 modelos, mediana conservadora)
- Por qué el compilador: los parsers heurísticos como tree-sitter no pueden resolver alias de paths de tsconfig, referencias cruzadas en monorepos, symlinks ni cadenas de re-export. Solo el compilador, que ya terminó la resolución real de módulos, es preciso → confiable → el agente se detiene con confianza
- Frente a precursores: codegraph / codebase-memory-mcp / serena también propusieron antes la misma idea, pero en preguntas abiertas no reducen tokens o incluso usan más que el baseline (benchmark del autor; con zod, las tres herramientas +22~27%)
- Limitaciones: solo TypeScript (profundidad en vez de amplitud), requiere TypeScript v7 (runtime en Go, actualmente RC). Instalación en 4 líneas
Aún no hay comentarios.