Estimación de tokens
Recuentos heurísticos de tokens y tarifación para vistas de coste previas al run.
Estimación de tokens
La implementación vive en application/internal/cost/token_counter.go y estimator.go. El estimador permite mostrar órdenes de magnitud de tokens y coste antes de invocar agentes — útil para confrontar los presupuestos y registrar con qué trabajo implicaba grosso modo un plan, sin pretender ser la API de facturación de un proveedor alojado.
Cómo funciona
El flujo es determinista : medir caracteres por ficheros o trozos de texto, clasificar cada porción por extensión en tipo de contenido (code, markdown, json, default), dividir por los valores token_estimation.*_chars_per_token configurados y redondear hacia arriba.
token_estimation:
default_chars_per_token: 4.0
code_chars_per_token: 3.2
markdown_chars_per_token: 4.2
json_chars_per_token: 3.6Visualización del coste
Los tokens estimados se multiplican por las tarifas pricing.models.<model-id> para obtener un EUR aproximado — o cualquier moneda declarada por budgets.default_currency. Esa multiplicación es matemática YAML transparente de su lado, no una tabla oculta en el binario.
Comandos
agentflow estimate billing-v2 --task task-003
agentflow work "develop billing-v2" --estimate-only
agentflow cost billing-v2Tests golden
La forma del estimador está fijada con tests golden en application/internal/cost/. Actualice goldens solo con UPDATE_GOLDEN=1 cuando altere conscientemente los algoritmos — si no podría enmascarar regresiones en dimensionado de prompts o cómputo de costes.