Economía de tokens

Cada nombre de tool, descripción y esquema es contexto que el modelo paga en cada turno de planificación. Cada campo de respuesta es contexto que paga en cada observación. MCP Fusion trata ambos como un presupuesto, con funciones que gastan deliberadamente y un profiler que encuentra las fugas.

Descripciones: TOON

.toonDescription() sustituye la descripción en prosa por una forma tabular delimitada por pipes, generada a partir del esquema de la acción:

billing actions|desc|required
get_invoice|Retrieve an invoice by ID|id
refund|Refund an invoice|id,amount_cents
list_invoices|List the tenant invoices|-

El agente lee una tabla usando aproximadamente la mitad de los tokens que la misma información en frases. Se genera a partir del esquema, así que no puede desviarse: cambia un campo obligatorio y cambia la tabla.

Respuestas: limit, select, grupos

Tres palancas, en orden de impacto:

.agentLimit(max) limita una colección y, cuando la trunca, inyecta un primer bloque correctivo:

📊 Summary: Dataset truncated. 50 shown, 4200 hidden. Use filters to narrow results.

El modelo recibe información sobre lo ocurrido y sobre qué hacer, en lugar de razonar en silencio sobre una lista parcial.

.enableSelect() añade un argumento _select cuyo enum es la unión de los campos del esquema raíz. El bloque de datos envía solo los campos solicitados, mientras los bloques de UI y las reglas siguen viendo el objeto completo. Un modelo de invoice amplio se convierte en una respuesta de cinco campos cuando la pregunta era pequeña.

Agrupación intercambia el tamaño del esquema por la cantidad de nombres: un namespace de doce acciones se convierte en una tool con un discriminador y el menú se reduce. Consulta Exposición de tools.

.toonSuccess(data) aplica la misma codificación tabular a una respuesta uniforme de colección y reduce las claves repetidas a una sola fila de encabezado.

Compactación FSM

Un conector vinculado a un estado puede enviar una compactDescription() mientras la máquina está en su estado inicial y revelar después la descripción completa. El menú que el agente lee al principio del flujo es más pequeño que el que lee donde viven las acciones de riesgo. Consulta Gating de estado FSM.

El profiler

El framework incluye un analizador estático porque la inflación de las respuestas es invisible hasta que llega la factura. profileResponse divide una respuesta en bloques de payload y overhead, calcula overheadRatio y clasifica el riesgo:

con avisos como COGNITIVE OVERLOAD, HIGH TOKEN DENSITY y OVERHEAD WARNING, con un techo predeterminado de overhead cercano al 30% de la respuesta. El mismo módulo clasifica el riesgo de inflación estático de una tool a partir de su esquema: una colección sin límite con más de diez campos es crítica, una colección sin límite por sí sola es alta y más de veinte campos es media. Esa clasificación se incluye en el lockfile de capacidades, por lo que una regresión de inflación hace fallar CI en vez de publicarse en silencio. Consulta Contratos.

Las estimaciones de tokens usan la heurística estándar de aproximadamente un token por cada 3,5 caracteres en texto con forma de JSON. Es suficientemente precisa para comparar variantes y nunca se presenta como un recuento del proveedor.

Orden de operaciones del presupuesto

1. Agrupa las acciones para que el menú sea pequeño
2. Activa _select para entidades amplias
3. Establece .agentLimit() en cada colección
4. Usa .toonDescription() y .toonSuccess() para formas uniformes
5. Compacta las descripciones en estados FSM que no necesitan toda la historia
6. Ejecuta el profiler en CI y trata una escalada de riesgo como una regresión

Siguientes pasos

• Formato wire: cuánto cuesta cada bloque
• Contratos: el lockfile que fija el presupuesto
• Exposición de tools: mecánica de agrupación