Skip to content

Execution telemetry will be recorded once a provider exposes it honestly

**Planned.** Per task: input, output and cached tokens, the model and effort actually used, elapsed time and tool-call count — recorded into the ledger next to what it already holds. Only from providers that expose these numbers; nothing estimated is ever labelled as measured.

planned Specified and not implemented. Named so the omission is visible.

Nothing measures token spend today. Any estimated_ field is labelled and excluded from enforcement.

What it means

Planned. Per task: input, output and cached tokens, the model and effort actually used, elapsed time and tool-call count — recorded into the ledger next to what it already holds. Only from providers that expose these numbers; nothing estimated is ever labelled as measured.

How it works

Nothing is implemented. The ledger already records per task the session count, handovers, workers, verification command with exit code and duration, and outcome; the provider-side numbers are the missing half. Any estimated_ field, when it appears, is excluded from enforcement and from comparisons.

How to see it

jq -c 'select(.event=="task.finished") | {task_id, outcome, verify}' .ai/local/state/ledger.jsonl

What it does not cover

Everything about tokens and cost, today. The economics document states what can be measured now from the ledger alone and what needs this.

Why it exists

The team the tool was distilled from built a competent cost profiler for its product's own model calls while having zero telemetry on its coding workers; its routing documents carried "35 % better" figures with no benchmark behind them. This page is the commitment not to repeat that.

Detail rendered from docs/claims/telemetry.md.

Provenance

defined in
read it on this site · docs/DESIGN.md
implemented in
nothing yet
proved by
no test — which is why this is not marked guaranteed
claim id
telemetry

Where this claim is used

What would make this guaranteed

0.3 Execution telemetry, only from providers that expose it honestly BLOCKED Blocked by runtime-adapters, so this claim cannot move yet. Shipping the milestone does not promote the claim: it reaches guaranteed when an implementation, a behavioural test and a blocking CI job exist for it.

The moments this answers