AiCallReport ai.call-report@1
Generated at from
openvibe-contracts v0.443.0 and
openvibe-sdk v0.177.0.
- Version
- 1.0.0
- Owner
- ai
- Visibility
- internal
- Status
- active
- Compatibility
- backward
- Schema
https://openvibe.network/contracts/ai/call-report.v1.json
ai.call-report@1 (ai-metrics.md): up to 100 AI calls a product made without OpenVibe.AI (Actor’s own model calls, a Codes harness turn, a local model on a person’s machine through Bot, Vibe), sent to AI’s POST /api/v1/usage/calls with the capability ai.usage.report. Each call is ai.call.recorded@1’s shape; the price is optional (AI prices from its rate cards: the charged amount first, then the list price) and SYSTEM + RUN_ID or TURN_ID is the idempotency key (a call sent twice is recorded once). AI publishes each as ai.call.recorded@1.
Fields
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
calls | array of object | yes |
| |
calls[].subject | string | null | The person the call was made for, or null when the call was anonymous. |
| |
calls[].attribution | string | The site or app the call came from, as '<type>:<id>' (for example 'site:design'), empty when nothing is known. |
| |
calls[].surface | string | The product surface: 'design.generate', 'codes.turn', 'ai.generate'. Free text, so a new surface needs no new contract. |
| |
calls[].system | string | yes | What ran: 'ai', 'harness:claude-code', 'harness:codex', 'actor', 'node'. |
|
calls[].provider | string | null | yes |
| |
calls[].model | string | null | yes |
| |
calls[].effort | string | null | The reasoning effort the call asked for, when it asked for one. |
| |
calls[].paid_by | enum |
| ||
calls[].paid_by_detail | string | null | Which key or plan paid, for example 'anthropic ...a1b2' or 'claude-max'. Never a whole secret. |
| |
calls[].input | integer | The uncached input tokens. Cache reads and cache writes are counted on their own fields. |
| |
calls[].output | integer |
| ||
calls[].reasoning | integer |
| ||
calls[].cache_read | integer |
| ||
calls[].cache_write | integer |
| ||
calls[].cache_write_ttl | enum | How long the written cache entry lives, when the provider says. |
| |
calls[].images | integer |
| ||
calls[].audio_seconds | number |
| ||
calls[].video_seconds | number |
| ||
calls[].list_cost_usd | number | What the tokens cost at the human-typed list prices. Optional here: AI prices a call that brings no price from its own rate cards. |
| |
calls[].charged_usd | number | What the payer was actually charged. A person's own key is never charged here: 0. Optional here: AI prices a call that brings no price from its own rate cards. |
| |
calls[].fee_usd | number | The network's fee on top of the cost, when the OpenVibe key paid. Optional here: AI prices a call that brings no price from its own rate cards. |
| |
calls[].cache_saved_usd | number | What the cached tokens saved against the plain input price. Optional here: AI prices a call that brings no price from its own rate cards. |
| |
calls[].price_source | string | Where the prices came from: 'models' (a person's typed model row), 'pricing' (AI_PRICING_JSON), 'flat' (the flat rates), 'no cache price' (no cache price is typed, so the cache tokens are priced at the input price). Optional here: AI prices a call that brings no price from its own rate cards. |
| |
calls[].price_date | string | null | The day the price was checked, when it was. Optional here: AI prices a call that brings no price from its own rate cards. |
| |
calls[].latency_ms | integer | null |
| ||
calls[].ttft_ms | integer | null | Time to the first token, when the call streamed and it was measured. |
| |
calls[].attempts | integer |
| ||
calls[].outcome | enum | yes |
| |
calls[].run_id | string | null |
| ||
calls[].turn_id | string | null |
| ||
calls[].at | string | yes |
| |
calls[].operation | enum | Since 1.1.0: what kind of call it was. |
| |
calls[].streamed | boolean | null | Since 1.1.0: whether the answer came as a stream (TTFT is only measured on one). | ||
calls[].tps | number | null | Since 1.1.0: output tokens per second after the first token (decode speed); null when not streamed or too short to measure. |
| |
calls[].queue_ms | integer | null | Since 1.1.0: time waiting before the call was sent (a queue, a rate gate). |
| |
calls[].task | string | null | Since 1.1.0: the task kind the call served (a task name, a workflow key, chat.reply, code.turn). |
| |
calls[].task_id | string | null | Since 1.1.0: the task or run this call is one step of, so cost and time add up per task. |
| |
calls[].task_ms | integer | null | Since 1.1.0: on the last call of a task, the whole task’s wall time. |
| |
calls[].harness | string | null | Since 1.1.0: the harness that made the call (openvibe, dsh, codex, claude-code, gemini-cli, opencode …). |
| |
calls[].place | enum | Since 1.1.0: where the model ran: a provider’s API, the person’s own machine, a community machine, a signed-in plan, OpenVibe’s own hosts. |
| |
calls[].error_class | string | null | Since 1.1.0: on a failure, its class (rate_limited, timeout, context_length, refused, auth, server, network, invalid). |
| |
calls[].fallbacks | integer | null | Since 1.1.0: how many offers failed before the one that answered. |
| |
calls[].cache_hit | boolean | null | Since 1.1.0: true when the whole answer came from OpenVibe’s exact answer cache (no model ran). | ||
calls[].tool_calls | integer | null | Since 1.1.0: tool calls the model asked for in this call. |
| |
calls[].region | string | null | Since 1.1.0: the provider region or data centre, when known. |
|
Examples
From the contract's own test fixtures: valid ones validate, rejected ones must fail.
Valid: an-actor-turn-and-a-local-model
{
"calls": [
{
"system": "actor",
"turn_id": "tsk_01JD8C4QJ7Z3K9W2X5V6N1M0PA:3",
"provider": "deepseek",
"model": "deepseek-v4-flash",
"surface": "actor.task",
"paid_by": "openvibe_key",
"input": 12000,
"output": 800,
"reasoning": 0,
"cache_read": 9000,
"cache_write": 0,
"cache_write_ttl": null,
"images": 0,
"audio_seconds": 0,
"video_seconds": 0,
"latency_ms": 4100,
"ttft_ms": 610,
"attempts": 1,
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z",
"operation": "chat",
"streamed": true,
"tps": 88.4,
"task": "actor.task",
"task_id": "tsk_01JD8C4QJ7Z3K9W2X5V6N1M0PA",
"harness": "openvibe",
"place": "provider",
"tool_calls": 2
},
{
"system": "node",
"run_id": "cmd_01JD8C4QJ7Z3K9W2X5V6N1M0PB",
"provider": "ollama",
"model": "qwen2.5:3b",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z",
"operation": "chat",
"streamed": true,
"ttft_ms": 900,
"tps": 12.5,
"place": "machine",
"input": 300,
"output": 120
}
]
}Rejected: an-operation-nobody-has
{
"calls": [
{
"system": "actor",
"run_id": "r1",
"provider": "deepseek",
"model": "x",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z",
"operation": "telepathy"
}
]
}Rejected: no-run-or-turn
{
"calls": [
{
"system": "actor",
"provider": "deepseek",
"model": "x",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
}
]
}Rejected: too-many-calls
{
"calls": [
{
"system": "actor",
"run_id": "r0",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r1",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r2",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r3",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r4",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r5",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r6",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r7",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r8",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r9",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r10",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r11",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r12",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r13",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r14",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r15",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r16",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r17",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r18",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r19",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r20",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r21",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r22",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r23",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r24",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r25",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r26",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r27",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r28",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r29",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r30",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r31",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r32",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r33",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r34",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r35",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r36",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r37",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r38",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r39",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r40",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r41",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r42",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r43",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r44",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r45",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r46",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r47",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r48",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r49",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r50",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r51",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r52",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r53",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r54",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r55",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r56",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r57",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r58",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r59",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r60",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r61",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r62",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r63",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r64",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r65",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r66",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r67",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r68",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r69",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r70",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r71",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r72",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r73",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r74",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r75",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r76",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r77",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r78",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r79",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r80",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r81",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r82",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r83",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r84",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r85",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r86",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r87",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r88",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r89",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r90",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r91",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r92",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r93",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r94",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r95",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r96",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r97",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r98",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r99",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
},
{
"system": "actor",
"run_id": "r100",
"provider": "p",
"model": "m",
"outcome": "succeeded",
"at": "2026-11-12T23:30:00Z"
}
]
}Validate
const contracts = require('openvibe-contracts');
contracts.validate('ai.call-report@1', value); // { valid, errors: [{ path, message }] }