openvibers/openvibe.contracts Commits
One AI meter across the network: the event and Report's routes (L40/L41) (#267)
Changes
@@@ -1 +1,2 @@node_modules/++node_modules@@@ -1,5 +1,28 @@# Changelog++## 0.260.0 — 2026-10-31++++- **One AI meter across the network** (plan L40): every AI call on the network leaves one usage record, whoever made it.++ - **`ai.call.recorded@1`** (`contracts/events/payloads/ai.call.recorded.v1.json`): one call, and who and where it++ happened (`subject`, `attribution`, `surface`), what ran (`system`, `provider`, `model`, `effort`), who paid++ (`paid_by`: `own_key`, `openvibe_key`, `plan`, `own_machine`, `free_tier`, `network_allowance`, `org_key`, with++ `paid_by_detail`), the tokens (`input` uncached, `output`, `reasoning`, `cache_read`, `cache_write` with++ `cache_write_ttl` `5m` or `1h`, `images`, `audio_seconds`, `video_seconds`), the money in USD (`list_cost_usd`,++ `charged_usd`, `fee_usd`, `cache_saved_usd`, with `price_source` and `price_date`), how it went (`latency_ms`,++ `ttft_ms`, `attempts`, `outcome`) and the ids (`run_id` or `turn_id`, `at`).++ - **No prompt and no answer text, ever.** The payload has no field for either, and the schema closes the object.++ - **The meter belongs to OpenVibe.Report** (plan L40 and L41): OpenVibe.AI writes the records, Report keeps the ledger++ and rolls it up.++ - **`report.ai-usage-open-result@1`**: the public AI totals (tokens, the cache share, the own-key share, the spend by++ week). No person, no site and no key in it.++ - **`report.ai-usage-result@1`**: the same meter in groups (day, site, model, system, paid_by) for a service token with++ the new **`report.ai_usage.read`** capability. A group that fewer than ten people share reads 'fewer than 10'++ instead of counting them.++ - **`report.ai-usage-me-result@1`**: the AI usage of one person (GET /api/v1/me/ai/usage), for the person and nobody++ else. The route answers 501 until Report has sign-in; the shape is fixed here first.++ - Phase 1 is OpenVibe.AI's own runs; Codes, Actor and the rest feed the same event later. Report rolls the++ records up, and a record taken twice is stored once (idempotent by `system` and `run_id` or `turn_id`).++## 0.259.0 — 2026-10-31- **`network.notification-push-request@1` addresses a person by subject as well as by user id (F1, familiar faces).**@@@ -46,6 +69,7 @@session on AI's own site behind a same-origin check, reaches them. A service token is refused, and so is any tokencarrying `on_behalf_of`, whatever capabilities it holds (the AI #204/#205 rule).++## 0.256.0 — 2026-10-31- **`ai.looks` is retired** (`network.consent@1`). The owner removed the rule that AI text never describes people@@@ -1380,6 +1380,16 @@"status": "active","adr": "ADR-015"},++ {++ "id": "ai.call.recorded",++ "version": "1.0.0",++ "owner": "ai",++ "schema": "events/payloads/ai.call.recorded.v1.json",++ "visibility": "first-party",++ "compatibility": "backward",++ "status": "active",++ "adr": "ADR-033"++ },{"id": "ai.run.queued","version": "1.0.0",@@@ -8310,6 +8320,33 @@"compatibility": "backward","status": "active"},++ {++ "id": "report.ai-usage-open-result",++ "version": "1.0.0",++ "owner": "report",++ "schema": "report/ai-usage-open-result.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "report.ai-usage-result",++ "version": "1.0.0",++ "owner": "report",++ "schema": "report/ai-usage-result.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "report.ai-usage-me-result",++ "version": "1.0.0",++ "owner": "report",++ "schema": "report/ai-usage-me-result.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },{"id": "bench.benchmark","version": "1.0.0",nnew file mode 100644@@@ -0,0 +1,100 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/events/payloads/ai.call.recorded.v1.json",++ "title": "AiCallRecordedPayload",++ "description": "ai.call.recorded v1 (plan L40, one AI meter across the network). One AI call, wherever it happened: OpenVibe.AI's own runs, a harness turn in Codes, an Actor task, Vibe, a local model on a person's own machine. who and where: subject (the person, or null when the call is anonymous), attribution (the site or app the call came from, free text such as 'site:design'), surface (the product surface, free text such as 'design.generate' or 'codes.turn'). what ran: system (ai, harness:claude-code, harness:codex, actor, node), provider, model, effort. who paid: paid_by (own_key, openvibe_key, plan, own_machine, free_tier, network_allowance, org_key) and paid_by_detail (for example 'anthropic ...a1b2' for a person's own key, or 'claude-max' for a plan). tokens: input (the UNCACHED input tokens), output, reasoning, cache_read, cache_write (with cache_write_ttl 5m or 1h), images, audio_seconds, video_seconds. money, in USD: list_cost_usd (what the tokens cost at the human-typed list prices), charged_usd (what the payer was actually charged), fee_usd (the network's fee on top), cache_saved_usd (what the cache saved against the plain input price). price_source says where the prices came from ('models', 'pricing', 'flat', or 'no cache price' when no cache price is typed and the cache tokens are priced at the input price), price_date the day the price was checked. how it went: latency_ms, ttft_ms, attempts, outcome. ids: run_id or turn_id, and at. The record carries NO prompt and NO answer text, ever. A ledger (OpenVibe.AI) rolls the records up; a record consumed twice is stored once (idempotent by system and run_id or turn_id). Envelope: subject { type: run, id: <run_id> } or { type: user, id: <subject> }, visibility internal, priority low, actor service:ai.",++ "type": "object",++ "required": [++ "system",++ "surface",++ "paid_by",++ "input",++ "output",++ "reasoning",++ "cache_read",++ "cache_write",++ "cache_write_ttl",++ "images",++ "audio_seconds",++ "video_seconds",++ "list_cost_usd",++ "charged_usd",++ "fee_usd",++ "cache_saved_usd",++ "price_source",++ "price_date",++ "latency_ms",++ "ttft_ms",++ "attempts",++ "outcome",++ "at"++ ],++ "additionalProperties": false,++ "properties": {++ "subject": {++ "type": ["string", "null"],++ "maxLength": 128,++ "description": "The person the call was made for, or null when the call was anonymous."++ },++ "attribution": {++ "type": "string",++ "maxLength": 200,++ "description": "The site or app the call came from, as '<type>:<id>' (for example 'site:design'), empty when nothing is known."++ },++ "surface": {++ "type": "string",++ "maxLength": 200,++ "description": "The product surface: 'design.generate', 'codes.turn', 'ai.generate'. Free text, so a new surface needs no new contract."++ },++ "system": {++ "type": "string",++ "maxLength": 100,++ "description": "What ran: 'ai', 'harness:claude-code', 'harness:codex', 'actor', 'node'."++ },++ "provider": { "type": ["string", "null"], "maxLength": 128 },++ "model": { "type": ["string", "null"], "maxLength": 200 },++ "effort": { "type": ["string", "null"], "maxLength": 64, "description": "The reasoning effort the call asked for, when it asked for one." },++ "paid_by": {++ "type": "string",++ "enum": ["own_key", "openvibe_key", "plan", "own_machine", "free_tier", "network_allowance", "org_key"]++ },++ "paid_by_detail": {++ "type": ["string", "null"],++ "maxLength": 200,++ "description": "Which key or plan paid, for example 'anthropic ...a1b2' or 'claude-max'. Never a whole secret."++ },++ "input": { "type": "integer", "minimum": 0, "description": "The uncached input tokens. Cache reads and cache writes are counted on their own fields." },++ "output": { "type": "integer", "minimum": 0 },++ "reasoning": { "type": "integer", "minimum": 0 },++ "cache_read": { "type": "integer", "minimum": 0 },++ "cache_write": { "type": "integer", "minimum": 0 },++ "cache_write_ttl": {++ "type": ["string", "null"],++ "enum": ["5m", "1h", null],++ "description": "How long the written cache entry lives, when the provider says."++ },++ "images": { "type": "integer", "minimum": 0 },++ "audio_seconds": { "type": "number", "minimum": 0 },++ "video_seconds": { "type": "number", "minimum": 0 },++ "list_cost_usd": { "type": "number", "minimum": 0, "description": "What the tokens cost at the human-typed list prices." },++ "charged_usd": { "type": "number", "minimum": 0, "description": "What the payer was actually charged. A person's own key is never charged here: 0." },++ "fee_usd": { "type": "number", "minimum": 0, "description": "The network's fee on top of the cost, when the OpenVibe key paid." },++ "cache_saved_usd": { "type": "number", "minimum": 0, "description": "What the cached tokens saved against the plain input price." },++ "price_source": {++ "type": "string",++ "maxLength": 64,++ "description": "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)."++ },++ "price_date": { "type": ["string", "null"], "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "description": "The day the price was checked, when it was." },++ "latency_ms": { "type": ["integer", "null"], "minimum": 0 },++ "ttft_ms": { "type": ["integer", "null"], "minimum": 0, "description": "Time to the first token, when the call streamed and it was measured." },++ "attempts": { "type": "integer", "minimum": 0 },++ "outcome": {++ "type": "string",++ "enum": ["succeeded", "failed", "cancelled", "cached"]++ },++ "run_id": { "type": ["string", "null"], "maxLength": 100 },++ "turn_id": { "type": ["string", "null"], "maxLength": 100 },++ "at": { "type": "string", "format": "date-time" }++ }++}nnew file mode 100644@@@ -0,0 +1,35 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/report/ai-usage-me-result.v1.json",++ "title": "ReportAiUsageMeResult",++ "description": "report.ai-usage-me-result@1: the AI usage of one person (plan L40/L41). GET /api/v1/me/ai/usage answers for the person themselves and nobody else: their rows, grouped by day, site, model, system or paid_by. The route answers 501 until Report has sign-in: the shape is fixed here first, so the route does not have to change when it opens.",++ "type": "object",++ "required": ["group", "usage", "totals"],++ "additionalProperties": false,++ "properties": {++ "group": { "type": "string", "enum": ["day", "site", "model", "system", "paid_by"] },++ "usage": {++ "type": "array",++ "items": {++ "type": "object",++ "required": ["group", "key", "calls", "input", "output", "reasoning", "cache_read", "cache_write", "list_cost_usd", "charged_usd", "fee_usd", "cache_saved_usd"],++ "additionalProperties": false,++ "properties": {++ "group": { "type": "string", "enum": ["day", "site", "model", "system", "paid_by"] },++ "key": { "type": "string", "maxLength": 200 },++ "calls": { "type": "integer", "minimum": 0 },++ "input": { "type": "integer", "minimum": 0 },++ "output": { "type": "integer", "minimum": 0 },++ "reasoning": { "type": "integer", "minimum": 0 },++ "cache_read": { "type": "integer", "minimum": 0 },++ "cache_write": { "type": "integer", "minimum": 0 },++ "list_cost_usd": { "type": "number", "minimum": 0 },++ "charged_usd": { "type": "number", "minimum": 0 },++ "fee_usd": { "type": "number", "minimum": 0 },++ "cache_saved_usd": { "type": "number", "minimum": 0 }++ }++ }++ },++ "totals": { "type": "object" }++ }++}nnew file mode 100644@@@ -0,0 +1,45 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/report/ai-usage-open-result.v1.json",++ "title": "ReportAiUsageOpenResult",++ "description": "report.ai-usage-open-result@1: the open AI meter (plan L40/L41). What the whole network spends on AI, in public: the tokens, the share of them that came from a provider cache, the share that the own keys of people paid, and the spend by week. No person, no site and no key is in it: the rows are summed before they are answered.",++ "type": "object",++ "required": ["calls", "tokens", "cache_share", "cache_saved_usd", "own_key_share", "own_key_calls", "list_cost_usd", "charged_usd", "fee_usd", "spend_by_week"],++ "additionalProperties": false,++ "properties": {++ "calls": { "type": "integer", "minimum": 0, "description": "The AI calls behind these numbers." },++ "tokens": {++ "type": "object",++ "required": ["input", "output", "cache_read", "cache_write"],++ "additionalProperties": false,++ "properties": {++ "input": { "type": "integer", "minimum": 0, "description": "The uncached input tokens." },++ "output": { "type": "integer", "minimum": 0 },++ "cache_read": { "type": "integer", "minimum": 0 },++ "cache_write": { "type": "integer", "minimum": 0 }++ }++ },++ "cache_share": { "type": "number", "minimum": 0, "maximum": 1, "description": "The share of the prompt tokens that came from a provider cache." },++ "cache_saved_usd": { "type": "number", "minimum": 0 },++ "own_key_share": { "type": "number", "minimum": 0, "maximum": 1, "description": "The share of the tokens that the own keys of people paid." },++ "own_key_calls": { "type": "integer", "minimum": 0 },++ "list_cost_usd": { "type": "number", "minimum": 0 },++ "charged_usd": { "type": "number", "minimum": 0 },++ "fee_usd": { "type": "number", "minimum": 0 },++ "spend_by_week": {++ "type": "array",++ "items": {++ "type": "object",++ "required": ["week", "calls", "list_cost_usd", "charged_usd", "cache_saved_usd"],++ "additionalProperties": false,++ "properties": {++ "week": { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "description": "The Monday of the week." },++ "calls": { "type": "integer", "minimum": 0 },++ "list_cost_usd": { "type": "number", "minimum": 0 },++ "charged_usd": { "type": "number", "minimum": 0 },++ "cache_saved_usd": { "type": "number", "minimum": 0 }++ }++ }++ }++ }++}nnew file mode 100644@@@ -0,0 +1,63 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/report/ai-usage-result.v1.json",++ "title": "ReportAiUsageResult",++ "description": "report.ai-usage-result@1: the AI meter in groups (plan L40/L41). GET /api/v1/ai/usage needs a service token with report.ai_usage.read; the rows are grouped by day, site, model, system or paid_by. A group that fewer than ten people share reads fewer than 10 instead of counting them.",++ "type": "object",++ "required": ["group", "usage", "totals"],++ "additionalProperties": false,++ "properties": {++ "group": { "type": "string", "enum": ["day", "site", "model", "system", "paid_by"] },++ "usage": {++ "type": "array",++ "items": {++ "type": "object",++ "required": ["group", "key", "calls", "people", "input", "output", "reasoning", "cache_read", "cache_write", "list_cost_usd", "charged_usd", "fee_usd", "cache_saved_usd"],++ "additionalProperties": false,++ "properties": {++ "group": { "type": "string", "enum": ["day", "site", "model", "system", "paid_by"] },++ "key": { "type": "string", "maxLength": 200, "description": "The name of the group: the day, the site, the model, the system or the payer." },++ "calls": { "type": "integer", "minimum": 0 },++ "people": {++ "oneOf": [++ { "type": "integer", "minimum": 10, "description": "How many people the group holds, when there are ten or more." },++ { "const": "fewer than 10", "description": "Fewer than ten people: the count is not given." }++ ]++ },++ "input": { "type": "integer", "minimum": 0 },++ "output": { "type": "integer", "minimum": 0 },++ "reasoning": { "type": "integer", "minimum": 0 },++ "cache_read": { "type": "integer", "minimum": 0 },++ "cache_write": { "type": "integer", "minimum": 0 },++ "images": { "type": "integer", "minimum": 0 },++ "audio_seconds": { "type": "number", "minimum": 0 },++ "video_seconds": { "type": "number", "minimum": 0 },++ "list_cost_usd": { "type": "number", "minimum": 0 },++ "charged_usd": { "type": "number", "minimum": 0 },++ "fee_usd": { "type": "number", "minimum": 0 },++ "cache_saved_usd": { "type": "number", "minimum": 0 }++ }++ }++ },++ "totals": {++ "type": "object",++ "required": ["calls", "input", "output", "reasoning", "cache_read", "cache_write", "list_cost_usd", "charged_usd", "fee_usd", "cache_saved_usd"],++ "additionalProperties": false,++ "properties": {++ "calls": { "type": "integer", "minimum": 0 },++ "input": { "type": "integer", "minimum": 0 },++ "output": { "type": "integer", "minimum": 0 },++ "reasoning": { "type": "integer", "minimum": 0 },++ "cache_read": { "type": "integer", "minimum": 0 },++ "cache_write": { "type": "integer", "minimum": 0 },++ "images": { "type": "integer", "minimum": 0 },++ "audio_seconds": { "type": "number", "minimum": 0 },++ "video_seconds": { "type": "number", "minimum": 0 },++ "list_cost_usd": { "type": "number", "minimum": 0 },++ "charged_usd": { "type": "number", "minimum": 0 },++ "fee_usd": { "type": "number", "minimum": 0 },++ "cache_saved_usd": { "type": "number", "minimum": 0 }++ }++ }++ }++}nnew file mode 100644@@@ -0,0 +1,34 @@++{++ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "attribution": "site:design",++ "surface": "design.generate",++ "system": "ai",++ "provider": "anthropic",++ "model": "claude-sonnet-4-5",++ "effort": "high",++ "paid_by": "own_key",++ "paid_by_detail": "anthropic ...a1b2",++ "input": 1200,++ "output": 300,++ "reasoning": 0,++ "cache_read": 8000,++ "cache_write": 1500,++ "cache_write_ttl": "5m",++ "images": 0,++ "audio_seconds": 0,++ "video_seconds": 0,++ "list_cost_usd": 0.012345,++ "charged_usd": 0,++ "fee_usd": 0,++ "cache_saved_usd": 0.00321,++ "price_source": "models",++ "price_date": "2026-10-31",++ "latency_ms": 4200,++ "ttft_ms": 640,++ "attempts": 1,++ "outcome": "succeeded",++ "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "turn_id": null,++ "at": "2026-10-31T18:00:00.000Z",++ "output_text": "the answer the model gave"++}nnew file mode 100644@@@ -0,0 +1,33 @@++{++ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "attribution": "site:design",++ "surface": "design.generate",++ "system": "ai",++ "provider": "anthropic",++ "model": "claude-sonnet-4-5",++ "effort": "high",++ "paid_by": "own_key",++ "paid_by_detail": "anthropic ...a1b2",++ "input": 1200,++ "output": 300,++ "reasoning": 0,++ "cache_read": 8000,++ "cache_write": 1500,++ "cache_write_ttl": "10m",++ "images": 0,++ "audio_seconds": 0,++ "video_seconds": 0,++ "list_cost_usd": 0.012345,++ "charged_usd": 0,++ "fee_usd": 0,++ "cache_saved_usd": 0.00321,++ "price_source": "models",++ "price_date": "2026-10-31",++ "latency_ms": 4200,++ "ttft_ms": 640,++ "attempts": 1,++ "outcome": "succeeded",++ "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "turn_id": null,++ "at": "2026-10-31T18:00:00.000Z"++}nnew file mode 100644@@@ -0,0 +1,33 @@++{++ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "attribution": "site:design",++ "surface": "design.generate",++ "system": "ai",++ "provider": "anthropic",++ "model": "claude-sonnet-4-5",++ "effort": "high",++ "paid_by": "someone_else",++ "paid_by_detail": "anthropic ...a1b2",++ "input": 1200,++ "output": 300,++ "reasoning": 0,++ "cache_read": 8000,++ "cache_write": 1500,++ "cache_write_ttl": "5m",++ "images": 0,++ "audio_seconds": 0,++ "video_seconds": 0,++ "list_cost_usd": 0.012345,++ "charged_usd": 0,++ "fee_usd": 0,++ "cache_saved_usd": 0.00321,++ "price_source": "models",++ "price_date": "2026-10-31",++ "latency_ms": 4200,++ "ttft_ms": 640,++ "attempts": 1,++ "outcome": "succeeded",++ "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "turn_id": null,++ "at": "2026-10-31T18:00:00.000Z"++}nnew file mode 100644@@@ -0,0 +1,33 @@++{++ "subject": null,++ "attribution": "",++ "surface": "ai.complete",++ "system": "harness:claude-code",++ "provider": "openai",++ "model": "gpt-5",++ "effort": null,++ "paid_by": "openvibe_key",++ "paid_by_detail": "openvibe:gpt-5",++ "input": 200,++ "output": 80,++ "reasoning": 40,++ "cache_read": 800,++ "cache_write": 0,++ "cache_write_ttl": null,++ "images": 0,++ "audio_seconds": 0,++ "video_seconds": 0,++ "list_cost_usd": 0.0021,++ "charged_usd": 0.0021,++ "fee_usd": 0.000105,++ "cache_saved_usd": 0,++ "price_source": "no cache price",++ "price_date": null,++ "latency_ms": 1800,++ "ttft_ms": null,++ "attempts": 2,++ "outcome": "succeeded",++ "run_id": null,++ "turn_id": "tn_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "at": "2026-10-31T18:05:00.000Z"++}nnew file mode 100644@@@ -0,0 +1,33 @@++{++ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "attribution": "site:design",++ "surface": "design.generate",++ "system": "ai",++ "provider": "anthropic",++ "model": "claude-sonnet-4-5",++ "effort": "high",++ "paid_by": "own_key",++ "paid_by_detail": "anthropic ...a1b2",++ "input": 1200,++ "output": 300,++ "reasoning": 0,++ "cache_read": 8000,++ "cache_write": 1500,++ "cache_write_ttl": "5m",++ "images": 0,++ "audio_seconds": 0,++ "video_seconds": 0,++ "list_cost_usd": 0.012345,++ "charged_usd": 0,++ "fee_usd": 0,++ "cache_saved_usd": 0.00321,++ "price_source": "models",++ "price_date": "2026-10-31",++ "latency_ms": 4200,++ "ttft_ms": 640,++ "attempts": 1,++ "outcome": "succeeded",++ "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "turn_id": null,++ "at": "2026-10-31T18:00:00.000Z"++}nnew file mode 100644@@@ -0,0 +1,6 @@++{++ "group": "day",++ "usage": [],++ "totals": { "calls": 0 },++ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ"++}nnew file mode 100644@@@ -0,0 +1,11 @@++{++ "group": "day",++ "usage": [++ {++ "group": "day", "key": "2026-10-31", "calls": 2,++ "input": 200, "output": 80, "reasoning": 0, "cache_read": 800, "cache_write": 0,++ "list_cost_usd": 0.0021, "charged_usd": 0, "fee_usd": 0, "cache_saved_usd": 0++ }++ ],++ "totals": { "calls": 2, "input": 200, "output": 80 }++}nnew file mode 100644@@@ -0,0 +1,13 @@++{++ "calls": 120,++ "tokens": { "input": 1000, "output": 200, "cache_read": 800, "cache_write": 150 },++ "cache_share": 0.41,++ "cache_saved_usd": 0.12,++ "own_key_share": 0.25,++ "own_key_calls": 30,++ "list_cost_usd": 1.23,++ "charged_usd": 0.9,++ "fee_usd": 0.02,++ "spend_by_week": [],++ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ"++}nnew file mode 100644@@@ -0,0 +1,14 @@++{++ "calls": 120,++ "tokens": { "input": 1000, "output": 200, "cache_read": 800, "cache_write": 150 },++ "cache_share": 0.41,++ "cache_saved_usd": 0.12,++ "own_key_share": 0.25,++ "own_key_calls": 30,++ "list_cost_usd": 1.23,++ "charged_usd": 0.9,++ "fee_usd": 0.02,++ "spend_by_week": [++ { "week": "2026-10-27", "calls": 30, "list_cost_usd": 0.4, "charged_usd": 0.3, "cache_saved_usd": 0.05 }++ ]++}nnew file mode 100644@@@ -0,0 +1,14 @@++{++ "group": "site",++ "usage": [++ {++ "group": "site", "key": "site:design", "calls": 3, "people": 3,++ "input": 10, "output": 5, "reasoning": 0, "cache_read": 0, "cache_write": 0,++ "list_cost_usd": 0.01, "charged_usd": 0.01, "fee_usd": 0, "cache_saved_usd": 0++ }++ ],++ "totals": {++ "calls": 3, "input": 10, "output": 5, "reasoning": 0, "cache_read": 0, "cache_write": 0,++ "list_cost_usd": 0.01, "charged_usd": 0.01, "fee_usd": 0, "cache_saved_usd": 0++ }++}nnew file mode 100644@@@ -0,0 +1,14 @@++{++ "group": "day",++ "usage": [++ {++ "group": "day", "key": "2026-10-31", "calls": 12, "people": 14,++ "input": 100, "output": 50, "reasoning": 0, "cache_read": 800, "cache_write": 0,++ "list_cost_usd": 0.1, "charged_usd": 0.1, "fee_usd": 0, "cache_saved_usd": 0.02++ }++ ],++ "totals": {++ "calls": 12, "input": 100, "output": 50, "reasoning": 0, "cache_read": 800, "cache_write": 0,++ "list_cost_usd": 0.1, "charged_usd": 0.1, "fee_usd": 0, "cache_saved_usd": 0.02++ }++}nnew file mode 100644@@@ -0,0 +1,14 @@++{++ "group": "site",++ "usage": [++ {++ "group": "site", "key": "site:design", "calls": 3, "people": "fewer than 10",++ "input": 10, "output": 5, "reasoning": 0, "cache_read": 0, "cache_write": 0,++ "list_cost_usd": 0.01, "charged_usd": 0.01, "fee_usd": 0, "cache_saved_usd": 0++ }++ ],++ "totals": {++ "calls": 3, "input": 10, "output": 5, "reasoning": 0, "cache_read": 0, "cache_write": 0,++ "list_cost_usd": 0.01, "charged_usd": 0.01, "fee_usd": 0, "cache_saved_usd": 0++ }++}@@@ -15000,6 +15000,235 @@}}},++ "ai.call.recorded": {++ "version": "1.0.0",++ "owner": "ai",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/events/payloads/ai.call.recorded.v1.json",++ "title": "AiCallRecordedPayload",++ "description": "ai.call.recorded v1 (plan L40, one AI meter across the network). One AI call, wherever it happened: OpenVibe.AI's own runs, a harness turn in Codes, an Actor task, Vibe, a local model on a person's own machine. who and where: subject (the person, or null when the call is anonymous), attribution (the site or app the call came from, free text such as 'site:design'), surface (the product surface, free text such as 'design.generate' or 'codes.turn'). what ran: system (ai, harness:claude-code, harness:codex, actor, node), provider, model, effort. who paid: paid_by (own_key, openvibe_key, plan, own_machine, free_tier, network_allowance, org_key) and paid_by_detail (for example 'anthropic ...a1b2' for a person's own key, or 'claude-max' for a plan). tokens: input (the UNCACHED input tokens), output, reasoning, cache_read, cache_write (with cache_write_ttl 5m or 1h), images, audio_seconds, video_seconds. money, in USD: list_cost_usd (what the tokens cost at the human-typed list prices), charged_usd (what the payer was actually charged), fee_usd (the network's fee on top), cache_saved_usd (what the cache saved against the plain input price). price_source says where the prices came from ('models', 'pricing', 'flat', or 'no cache price' when no cache price is typed and the cache tokens are priced at the input price), price_date the day the price was checked. how it went: latency_ms, ttft_ms, attempts, outcome. ids: run_id or turn_id, and at. The record carries NO prompt and NO answer text, ever. A ledger (OpenVibe.AI) rolls the records up; a record consumed twice is stored once (idempotent by system and run_id or turn_id). Envelope: subject { type: run, id: <run_id> } or { type: user, id: <subject> }, visibility internal, priority low, actor service:ai.",++ "type": "object",++ "required": [++ "system",++ "surface",++ "paid_by",++ "input",++ "output",++ "reasoning",++ "cache_read",++ "cache_write",++ "cache_write_ttl",++ "images",++ "audio_seconds",++ "video_seconds",++ "list_cost_usd",++ "charged_usd",++ "fee_usd",++ "cache_saved_usd",++ "price_source",++ "price_date",++ "latency_ms",++ "ttft_ms",++ "attempts",++ "outcome",++ "at"++ ],++ "additionalProperties": false,++ "properties": {++ "subject": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 128,++ "description": "The person the call was made for, or null when the call was anonymous."++ },++ "attribution": {++ "type": "string",++ "maxLength": 200,++ "description": "The site or app the call came from, as '<type>:<id>' (for example 'site:design'), empty when nothing is known."++ },++ "surface": {++ "type": "string",++ "maxLength": 200,++ "description": "The product surface: 'design.generate', 'codes.turn', 'ai.generate'. Free text, so a new surface needs no new contract."++ },++ "system": {++ "type": "string",++ "maxLength": 100,++ "description": "What ran: 'ai', 'harness:claude-code', 'harness:codex', 'actor', 'node'."++ },++ "provider": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 128++ },++ "model": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 200++ },++ "effort": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 64,++ "description": "The reasoning effort the call asked for, when it asked for one."++ },++ "paid_by": {++ "type": "string",++ "enum": [++ "own_key",++ "openvibe_key",++ "plan",++ "own_machine",++ "free_tier",++ "network_allowance",++ "org_key"++ ]++ },++ "paid_by_detail": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 200,++ "description": "Which key or plan paid, for example 'anthropic ...a1b2' or 'claude-max'. Never a whole secret."++ },++ "input": {++ "type": "integer",++ "minimum": 0,++ "description": "The uncached input tokens. Cache reads and cache writes are counted on their own fields."++ },++ "output": {++ "type": "integer",++ "minimum": 0++ },++ "reasoning": {++ "type": "integer",++ "minimum": 0++ },++ "cache_read": {++ "type": "integer",++ "minimum": 0++ },++ "cache_write": {++ "type": "integer",++ "minimum": 0++ },++ "cache_write_ttl": {++ "type": [++ "string",++ "null"++ ],++ "enum": [++ "5m",++ "1h",++ null++ ],++ "description": "How long the written cache entry lives, when the provider says."++ },++ "images": {++ "type": "integer",++ "minimum": 0++ },++ "audio_seconds": {++ "type": "number",++ "minimum": 0++ },++ "video_seconds": {++ "type": "number",++ "minimum": 0++ },++ "list_cost_usd": {++ "type": "number",++ "minimum": 0,++ "description": "What the tokens cost at the human-typed list prices."++ },++ "charged_usd": {++ "type": "number",++ "minimum": 0,++ "description": "What the payer was actually charged. A person's own key is never charged here: 0."++ },++ "fee_usd": {++ "type": "number",++ "minimum": 0,++ "description": "The network's fee on top of the cost, when the OpenVibe key paid."++ },++ "cache_saved_usd": {++ "type": "number",++ "minimum": 0,++ "description": "What the cached tokens saved against the plain input price."++ },++ "price_source": {++ "type": "string",++ "maxLength": 64,++ "description": "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)."++ },++ "price_date": {++ "type": [++ "string",++ "null"++ ],++ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",++ "description": "The day the price was checked, when it was."++ },++ "latency_ms": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ },++ "ttft_ms": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0,++ "description": "Time to the first token, when the call streamed and it was measured."++ },++ "attempts": {++ "type": "integer",++ "minimum": 0++ },++ "outcome": {++ "type": "string",++ "enum": [++ "succeeded",++ "failed",++ "cancelled",++ "cached"++ ]++ },++ "run_id": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 100++ },++ "turn_id": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 100++ },++ "at": {++ "type": "string",++ "format": "date-time"++ }++ }++ }++ },"ai.run.queued": {"version": "1.0.0","owner": "ai",@@@ -92933,6 +93162,450 @@]}},++ "report.ai-usage-open-result": {++ "version": "1.0.0",++ "owner": "report",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/report/ai-usage-open-result.v1.json",++ "title": "ReportAiUsageOpenResult",++ "description": "report.ai-usage-open-result@1: the open AI meter (plan L40/L41). What the whole network spends on AI, in public: the tokens, the share of them that came from a provider cache, the share that the own keys of people paid, and the spend by week. No person, no site and no key is in it: the rows are summed before they are answered.",++ "type": "object",++ "required": [++ "calls",++ "tokens",++ "cache_share",++ "cache_saved_usd",++ "own_key_share",++ "own_key_calls",++ "list_cost_usd",++ "charged_usd",++ "fee_usd",++ "spend_by_week"++ ],++ "additionalProperties": false,++ "properties": {++ "calls": {++ "type": "integer",++ "minimum": 0,++ "description": "The AI calls behind these numbers."++ },++ "tokens": {++ "type": "object",++ "required": [++ "input",++ "output",++ "cache_read",++ "cache_write"++ ],++ "additionalProperties": false,++ "properties": {++ "input": {++ "type": "integer",++ "minimum": 0,++ "description": "The uncached input tokens."++ },++ "output": {++ "type": "integer",++ "minimum": 0++ },++ "cache_read": {++ "type": "integer",++ "minimum": 0++ },++ "cache_write": {++ "type": "integer",++ "minimum": 0++ }++ }++ },++ "cache_share": {++ "type": "number",++ "minimum": 0,++ "maximum": 1,++ "description": "The share of the prompt tokens that came from a provider cache."++ },++ "cache_saved_usd": {++ "type": "number",++ "minimum": 0++ },++ "own_key_share": {++ "type": "number",++ "minimum": 0,++ "maximum": 1,++ "description": "The share of the tokens that the own keys of people paid."++ },++ "own_key_calls": {++ "type": "integer",++ "minimum": 0++ },++ "list_cost_usd": {++ "type": "number",++ "minimum": 0++ },++ "charged_usd": {++ "type": "number",++ "minimum": 0++ },++ "fee_usd": {++ "type": "number",++ "minimum": 0++ },++ "spend_by_week": {++ "type": "array",++ "items": {++ "type": "object",++ "required": [++ "week",++ "calls",++ "list_cost_usd",++ "charged_usd",++ "cache_saved_usd"++ ],++ "additionalProperties": false,++ "properties": {++ "week": {++ "type": "string",++ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",++ "description": "The Monday of the week."++ },++ "calls": {++ "type": "integer",++ "minimum": 0++ },++ "list_cost_usd": {++ "type": "number",++ "minimum": 0++ },++ "charged_usd": {++ "type": "number",++ "minimum": 0++ },++ "cache_saved_usd": {++ "type": "number",++ "minimum": 0++ }++ }++ }++ }++ }++ }++ },++ "report.ai-usage-result": {++ "version": "1.0.0",++ "owner": "report",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/report/ai-usage-result.v1.json",++ "title": "ReportAiUsageResult",++ "description": "report.ai-usage-result@1: the AI meter in groups (plan L40/L41). GET /api/v1/ai/usage needs a service token with report.ai_usage.read; the rows are grouped by day, site, model, system or paid_by. A group that fewer than ten people share reads fewer than 10 instead of counting them.",++ "type": "object",++ "required": [++ "group",++ "usage",++ "totals"++ ],++ "additionalProperties": false,++ "properties": {++ "group": {++ "type": "string",++ "enum": [++ "day",++ "site",++ "model",++ "system",++ "paid_by"++ ]++ },++ "usage": {++ "type": "array",++ "items": {++ "type": "object",++ "required": [++ "group",++ "key",++ "calls",++ "people",++ "input",++ "output",++ "reasoning",++ "cache_read",++ "cache_write",++ "list_cost_usd",++ "charged_usd",++ "fee_usd",++ "cache_saved_usd"++ ],++ "additionalProperties": false,++ "properties": {++ "group": {++ "type": "string",++ "enum": [++ "day",++ "site",++ "model",++ "system",++ "paid_by"++ ]++ },++ "key": {++ "type": "string",++ "maxLength": 200,++ "description": "The name of the group: the day, the site, the model, the system or the payer."++ },++ "calls": {++ "type": "integer",++ "minimum": 0++ },++ "people": {++ "oneOf": [++ {++ "type": "integer",++ "minimum": 10,++ "description": "How many people the group holds, when there are ten or more."++ },++ {++ "const": "fewer than 10",++ "description": "Fewer than ten people: the count is not given."++ }++ ]++ },++ "input": {++ "type": "integer",++ "minimum": 0++ },++ "output": {++ "type": "integer",++ "minimum": 0++ },++ "reasoning": {++ "type": "integer",++ "minimum": 0++ },++ "cache_read": {++ "type": "integer",++ "minimum": 0++ },++ "cache_write": {++ "type": "integer",++ "minimum": 0++ },++ "images": {++ "type": "integer",++ "minimum": 0++ },++ "audio_seconds": {++ "type": "number",++ "minimum": 0++ },++ "video_seconds": {++ "type": "number",++ "minimum": 0++ },++ "list_cost_usd": {++ "type": "number",++ "minimum": 0++ },++ "charged_usd": {++ "type": "number",++ "minimum": 0++ },++ "fee_usd": {++ "type": "number",++ "minimum": 0++ },++ "cache_saved_usd": {++ "type": "number",++ "minimum": 0++ }++ }++ }++ },++ "totals": {++ "type": "object",++ "required": [++ "calls",++ "input",++ "output",++ "reasoning",++ "cache_read",++ "cache_write",++ "list_cost_usd",++ "charged_usd",++ "fee_usd",++ "cache_saved_usd"++ ],++ "additionalProperties": false,++ "properties": {++ "calls": {++ "type": "integer",++ "minimum": 0++ },++ "input": {++ "type": "integer",++ "minimum": 0++ },++ "output": {++ "type": "integer",++ "minimum": 0++ },++ "reasoning": {++ "type": "integer",++ "minimum": 0++ },++ "cache_read": {++ "type": "integer",++ "minimum": 0++ },++ "cache_write": {++ "type": "integer",++ "minimum": 0++ },++ "images": {++ "type": "integer",++ "minimum": 0++ },++ "audio_seconds": {++ "type": "number",++ "minimum": 0++ },++ "video_seconds": {++ "type": "number",++ "minimum": 0++ },++ "list_cost_usd": {++ "type": "number",++ "minimum": 0++ },++ "charged_usd": {++ "type": "number",++ "minimum": 0++ },++ "fee_usd": {++ "type": "number",++ "minimum": 0++ },++ "cache_saved_usd": {++ "type": "number",++ "minimum": 0++ }++ }++ }++ }++ }++ },++ "report.ai-usage-me-result": {++ "version": "1.0.0",++ "owner": "report",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/report/ai-usage-me-result.v1.json",++ "title": "ReportAiUsageMeResult",++ "description": "report.ai-usage-me-result@1: the AI usage of one person (plan L40/L41). GET /api/v1/me/ai/usage answers for the person themselves and nobody else: their rows, grouped by day, site, model, system or paid_by. The route answers 501 until Report has sign-in: the shape is fixed here first, so the route does not have to change when it opens.",++ "type": "object",++ "required": [++ "group",++ "usage",++ "totals"++ ],++ "additionalProperties": false,++ "properties": {++ "group": {++ "type": "string",++ "enum": [++ "day",++ "site",++ "model",++ "system",++ "paid_by"++ ]++ },++ "usage": {++ "type": "array",++ "items": {++ "type": "object",++ "required": [++ "group",++ "key",++ "calls",++ "input",++ "output",++ "reasoning",++ "cache_read",++ "cache_write",++ "list_cost_usd",++ "charged_usd",++ "fee_usd",++ "cache_saved_usd"++ ],++ "additionalProperties": false,++ "properties": {++ "group": {++ "type": "string",++ "enum": [++ "day",++ "site",++ "model",++ "system",++ "paid_by"++ ]++ },++ "key": {++ "type": "string",++ "maxLength": 200++ },++ "calls": {++ "type": "integer",++ "minimum": 0++ },++ "input": {++ "type": "integer",++ "minimum": 0++ },++ "output": {++ "type": "integer",++ "minimum": 0++ },++ "reasoning": {++ "type": "integer",++ "minimum": 0++ },++ "cache_read": {++ "type": "integer",++ "minimum": 0++ },++ "cache_write": {++ "type": "integer",++ "minimum": 0++ },++ "list_cost_usd": {++ "type": "number",++ "minimum": 0++ },++ "charged_usd": {++ "type": "number",++ "minimum": 0++ },++ "fee_usd": {++ "type": "number",++ "minimum": 0++ },++ "cache_saved_usd": {++ "type": "number",++ "minimum": 0++ }++ }++ }++ },++ "totals": {++ "type": "object"++ }++ }++ }++ },"bench.benchmark": {"version": "1.0.0","owner": "bench",@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Actor API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.AI API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Bench API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Billing API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Blog API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Bot API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Chat API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Codes API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Community API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Coupons API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Deals API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Domains API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Events API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Food API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Games API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Host API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -176,6 +176,13 @@"operations": 3,"capabilities": 1},++ {++ "service": "report",++ "name": "OpenVibe.Report",++ "origin": "https://openvibe.report",++ "operations": 1,++ "capabilities": 1++ },{"service": "reviews","name": "OpenVibe.Reviews",@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Inventory API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Live API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.MediaHub API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Media API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Network API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.News API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenRestream API",-- "version": "0.259.0",-- "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Play API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Quest API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"nnew file mode 100644@@@ -0,0 +1,341 @@++{++ "openapi": "3.1.0",++ "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",++ "info": {++ "title": "OpenVibe.Report API",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "license": {++ "name": "MIT",++ "identifier": "MIT"++ }++ },++ "servers": [++ {++ "url": "https://openvibe.report"++ }++ ],++ "paths": {++ "/api/v1/ai/usage": {++ "get": {++ "operationId": "get_api_v1_ai_usage",++ "summary": "Read the AI meter across the network: the usage records and their roll-ups, in groups (day, site, model, system, paid_by).",++ "description": "**report.ai_usage.read** (internal): Read the AI meter across the network: the usage records and their roll-ups, in groups (day, site, model, system, paid_by). The public totals (GET /api/v1/ai/usage/open) need no token at all.",++ "tags": [++ "report.ai_usage"++ ],++ "x-openvibe-capabilities": [++ "report.ai_usage.read"++ ],++ "x-openvibe-visibility": [++ "internal"++ ],++ "x-openvibe-quota-class": "report-read",++ "security": [++ {++ "openvibeToken": [++ "report.ai_usage.read"++ ]++ }++ ],++ "responses": {++ "2XX": {++ "description": "Success",++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/report.ai-usage-result.v1"++ }++ }++ }++ },++ "default": {++ "description": "An error (RFC 9457 problem details)",++ "content": {++ "application/problem+json": {++ "schema": {++ "$ref": "#/components/schemas/errors.problem.v1"++ }++ }++ }++ }++ }++ }++ }++ },++ "components": {++ "schemas": {++ "errors.problem.v1": {++ "title": "Problem",++ "description": "RFC 9457 problem details (application/problem+json) with a stable OpenVibe error code and trace identifiers. The legacy 'error' string is allowed during migration so existing clients keep working.",++ "type": "object",++ "required": [++ "type",++ "title",++ "status",++ "code"++ ],++ "additionalProperties": true,++ "properties": {++ "type": {++ "type": "string",++ "format": "uri-reference"++ },++ "title": {++ "type": "string",++ "minLength": 1++ },++ "status": {++ "type": "integer",++ "minimum": 400,++ "maximum": 599++ },++ "detail": {++ "type": "string"++ },++ "instance": {++ "type": "string",++ "format": "uri-reference"++ },++ "code": {++ "type": "string",++ "pattern": "^[a-z][a-z0-9_]*(\\.[a-z0-9_]+)*$"++ },++ "request_id": {++ "type": "string"++ },++ "trace_id": {++ "type": "string",++ "pattern": "^[0-9a-f]{32}$"++ },++ "errors": {++ "type": "array",++ "items": {++ "type": "object",++ "required": [++ "message"++ ],++ "properties": {++ "path": {++ "type": "string"++ },++ "message": {++ "type": "string"++ }++ }++ }++ },++ "error": {++ "type": "string",++ "description": "Deprecated compatibility field: same text as title/detail for clients that read {error}."++ }++ }++ },++ "report.ai-usage-result.v1": {++ "title": "ReportAiUsageResult",++ "description": "report.ai-usage-result@1: the AI meter in groups (plan L40/L41). GET /api/v1/ai/usage needs a service token with report.ai_usage.read; the rows are grouped by day, site, model, system or paid_by. A group that fewer than ten people share reads fewer than 10 instead of counting them.",++ "type": "object",++ "required": [++ "group",++ "usage",++ "totals"++ ],++ "additionalProperties": false,++ "properties": {++ "group": {++ "type": "string",++ "enum": [++ "day",++ "site",++ "model",++ "system",++ "paid_by"++ ]++ },++ "usage": {++ "type": "array",++ "items": {++ "type": "object",++ "required": [++ "group",++ "key",++ "calls",++ "people",++ "input",++ "output",++ "reasoning",++ "cache_read",++ "cache_write",++ "list_cost_usd",++ "charged_usd",++ "fee_usd",++ "cache_saved_usd"++ ],++ "additionalProperties": false,++ "properties": {++ "group": {++ "type": "string",++ "enum": [++ "day",++ "site",++ "model",++ "system",++ "paid_by"++ ]++ },++ "key": {++ "type": "string",++ "maxLength": 200,++ "description": "The name of the group: the day, the site, the model, the system or the payer."++ },++ "calls": {++ "type": "integer",++ "minimum": 0++ },++ "people": {++ "oneOf": [++ {++ "type": "integer",++ "minimum": 10,++ "description": "How many people the group holds, when there are ten or more."++ },++ {++ "const": "fewer than 10",++ "description": "Fewer than ten people: the count is not given."++ }++ ]++ },++ "input": {++ "type": "integer",++ "minimum": 0++ },++ "output": {++ "type": "integer",++ "minimum": 0++ },++ "reasoning": {++ "type": "integer",++ "minimum": 0++ },++ "cache_read": {++ "type": "integer",++ "minimum": 0++ },++ "cache_write": {++ "type": "integer",++ "minimum": 0++ },++ "images": {++ "type": "integer",++ "minimum": 0++ },++ "audio_seconds": {++ "type": "number",++ "minimum": 0++ },++ "video_seconds": {++ "type": "number",++ "minimum": 0++ },++ "list_cost_usd": {++ "type": "number",++ "minimum": 0++ },++ "charged_usd": {++ "type": "number",++ "minimum": 0++ },++ "fee_usd": {++ "type": "number",++ "minimum": 0++ },++ "cache_saved_usd": {++ "type": "number",++ "minimum": 0++ }++ }++ }++ },++ "totals": {++ "type": "object",++ "required": [++ "calls",++ "input",++ "output",++ "reasoning",++ "cache_read",++ "cache_write",++ "list_cost_usd",++ "charged_usd",++ "fee_usd",++ "cache_saved_usd"++ ],++ "additionalProperties": false,++ "properties": {++ "calls": {++ "type": "integer",++ "minimum": 0++ },++ "input": {++ "type": "integer",++ "minimum": 0++ },++ "output": {++ "type": "integer",++ "minimum": 0++ },++ "reasoning": {++ "type": "integer",++ "minimum": 0++ },++ "cache_read": {++ "type": "integer",++ "minimum": 0++ },++ "cache_write": {++ "type": "integer",++ "minimum": 0++ },++ "images": {++ "type": "integer",++ "minimum": 0++ },++ "audio_seconds": {++ "type": "number",++ "minimum": 0++ },++ "video_seconds": {++ "type": "number",++ "minimum": 0++ },++ "list_cost_usd": {++ "type": "number",++ "minimum": 0++ },++ "charged_usd": {++ "type": "number",++ "minimum": 0++ },++ "fee_usd": {++ "type": "number",++ "minimum": 0++ },++ "cache_saved_usd": {++ "type": "number",++ "minimum": 0++ }++ }++ }++ }++ }++ },++ "securitySchemes": {++ "openvibeToken": {++ "type": "http",++ "scheme": "bearer",++ "bearerFormat": "JWT",++ "description": "An OpenVibe Network token for this service: a person's token, an app token (client credentials, audience of the service) or a first-party service token. Its `cap` claim must include the capability the operation names."++ }++ }++ }++}@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Reviews API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Run API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Search API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Services API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Sources API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Space API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Tips API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Tools API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Trade API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.VIP API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Vision API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Watch API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Wiki API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Work API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Zone API",-- "version": "0.259.0",-- "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.260.0",++ "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -152300,6 +152300,89 @@ export interface AiRun {finished_at: string | null;}++/** [email protected] (owner: ai) */++/**++ * ai.call.recorded v1 (plan L40, one AI meter across the network). One AI call, wherever it happened: OpenVibe.AI's own runs, a harness turn in Codes, an Actor task, Vibe, a local model on a person's own machine. who and where: subject (the person, or null when the call is anonymous), attribution (the site or app the call came from, free text such as 'site:design'), surface (the product surface, free text such as 'design.generate' or 'codes.turn'). what ran: system (ai, harness:claude-code, harness:codex, actor, node), provider, model, effort. who paid: paid_by (own_key, openvibe_key, plan, own_machine, free_tier, network_allowance, org_key) and paid_by_detail (for example 'anthropic ...a1b2' for a person's own key, or 'claude-max' for a plan). tokens: input (the UNCACHED input tokens), output, reasoning, cache_read, cache_write (with cache_write_ttl 5m or 1h), images, audio_seconds, video_seconds. money, in USD: list_cost_usd (what the tokens cost at the human-typed list prices), charged_usd (what the payer was actually charged), fee_usd (the network's fee on top), cache_saved_usd (what the cache saved against the plain input price). price_source says where the prices came from ('models', 'pricing', 'flat', or 'no cache price' when no cache price is typed and the cache tokens are priced at the input price), price_date the day the price was checked. how it went: latency_ms, ttft_ms, attempts, outcome. ids: run_id or turn_id, and at. The record carries NO prompt and NO answer text, ever. A ledger (OpenVibe.AI) rolls the records up; a record consumed twice is stored once (idempotent by system and run_id or turn_id). Envelope: subject { type: run, id: <run_id> } or { type: user, id: <subject> }, visibility internal, priority low, actor service:ai.++ */++export interface AiCallRecordedPayload {++ /**++ * The person the call was made for, or null when the call was anonymous.++ */++ subject?: string | null;++ /**++ * The site or app the call came from, as '<type>:<id>' (for example 'site:design'), empty when nothing is known.++ */++ attribution?: string;++ /**++ * The product surface: 'design.generate', 'codes.turn', 'ai.generate'. Free text, so a new surface needs no new contract.++ */++ surface: string;++ /**++ * What ran: 'ai', 'harness:claude-code', 'harness:codex', 'actor', 'node'.++ */++ system: string;++ provider?: string | null;++ model?: string | null;++ /**++ * The reasoning effort the call asked for, when it asked for one.++ */++ effort?: string | null;++ paid_by: "own_key" | "openvibe_key" | "plan" | "own_machine" | "free_tier" | "network_allowance" | "org_key";++ /**++ * Which key or plan paid, for example 'anthropic ...a1b2' or 'claude-max'. Never a whole secret.++ */++ paid_by_detail?: string | null;++ /**++ * The uncached input tokens. Cache reads and cache writes are counted on their own fields.++ */++ input: number;++ output: number;++ reasoning: number;++ cache_read: number;++ cache_write: number;++ /**++ * How long the written cache entry lives, when the provider says.++ */++ cache_write_ttl: "5m" | "1h" | null;++ images: number;++ audio_seconds: number;++ video_seconds: number;++ /**++ * What the tokens cost at the human-typed list prices.++ */++ list_cost_usd: number;++ /**++ * What the payer was actually charged. A person's own key is never charged here: 0.++ */++ charged_usd: number;++ /**++ * The network's fee on top of the cost, when the OpenVibe key paid.++ */++ fee_usd: number;++ /**++ * What the cached tokens saved against the plain input price.++ */++ cache_saved_usd: number;++ /**++ * 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).++ */++ price_source: string;++ /**++ * The day the price was checked, when it was.++ */++ price_date: string | null;++ latency_ms: number | null;++ /**++ * Time to the first token, when the call streamed and it was measured.++ */++ ttft_ms: number | null;++ attempts: number;++ outcome: "succeeded" | "failed" | "cancelled" | "cached";++ run_id?: string | null;++ turn_id?: string | null;++ at: string;++}++/** [email protected] (owner: ai) *//*** ai.run.queued v1 (OpenVibe.AI server/runs.js create). PLANNED: AI does not publish run events yet (its manifest notes list ai.run.queued|succeeded|failed|cached once the Events client is wired in); this is the shape it is to send. A run was stored queued (it then runs inline within ?wait or on the worker). Not published for a cache hit (ai.run.cached) or a create refused by quota or a full queue. A projection of ai.run@1 without input or output (ADR-015: request metadata, never raw prompts). requester is the token principal that created the run (service, app or mod). Envelope: subject { type: run, id: <run_id> }, visibility internal, priority low, actor service:ai.@@@ -276743,6 +276826,116 @@ export type ReportMetric = {[k: string]: unknown | undefined;};++/** [email protected] (owner: report) */++/**++ * report.ai-usage-open-result@1: the open AI meter (plan L40/L41). What the whole network spends on AI, in public: the tokens, the share of them that came from a provider cache, the share that the own keys of people paid, and the spend by week. No person, no site and no key is in it: the rows are summed before they are answered.++ */++export interface ReportAiUsageOpenResult {++ /**++ * The AI calls behind these numbers.++ */++ calls: number;++ tokens: {++ /**++ * The uncached input tokens.++ */++ input: number;++ output: number;++ cache_read: number;++ cache_write: number;++ };++ /**++ * The share of the prompt tokens that came from a provider cache.++ */++ cache_share: number;++ cache_saved_usd: number;++ /**++ * The share of the tokens that the own keys of people paid.++ */++ own_key_share: number;++ own_key_calls: number;++ list_cost_usd: number;++ charged_usd: number;++ fee_usd: number;++ spend_by_week: {++ /**++ * The Monday of the week.++ */++ week: string;++ calls: number;++ list_cost_usd: number;++ charged_usd: number;++ cache_saved_usd: number;++ }[];++}++++/** [email protected] (owner: report) */++/**++ * report.ai-usage-result@1: the AI meter in groups (plan L40/L41). GET /api/v1/ai/usage needs a service token with report.ai_usage.read; the rows are grouped by day, site, model, system or paid_by. A group that fewer than ten people share reads fewer than 10 instead of counting them.++ */++export interface ReportAiUsageResult {++ group: "day" | "site" | "model" | "system" | "paid_by";++ usage: {++ group: "day" | "site" | "model" | "system" | "paid_by";++ /**++ * The name of the group: the day, the site, the model, the system or the payer.++ */++ key: string;++ calls: number;++ people: number | "fewer than 10";++ input: number;++ output: number;++ reasoning: number;++ cache_read: number;++ cache_write: number;++ images?: number;++ audio_seconds?: number;++ video_seconds?: number;++ list_cost_usd: number;++ charged_usd: number;++ fee_usd: number;++ cache_saved_usd: number;++ }[];++ totals: {++ calls: number;++ input: number;++ output: number;++ reasoning: number;++ cache_read: number;++ cache_write: number;++ images?: number;++ audio_seconds?: number;++ video_seconds?: number;++ list_cost_usd: number;++ charged_usd: number;++ fee_usd: number;++ cache_saved_usd: number;++ };++}++++/** [email protected] (owner: report) */++/**++ * report.ai-usage-me-result@1: the AI usage of one person (plan L40/L41). GET /api/v1/me/ai/usage answers for the person themselves and nobody else: their rows, grouped by day, site, model, system or paid_by. The route answers 501 until Report has sign-in: the shape is fixed here first, so the route does not have to change when it opens.++ */++export interface ReportAiUsageMeResult {++ group: "day" | "site" | "model" | "system" | "paid_by";++ usage: {++ group: "day" | "site" | "model" | "system" | "paid_by";++ key: string;++ calls: number;++ input: number;++ output: number;++ reasoning: number;++ cache_read: number;++ cache_write: number;++ list_cost_usd: number;++ charged_usd: number;++ fee_usd: number;++ cache_saved_usd: number;++ }[];++ totals: {};++}++/** [email protected] (owner: bench) *//*** bench.benchmark@1: a versioned, forkable benchmark on OpenVibe.Bench (spec 2026-10-30, stage B1). It holds the tasks, the judges, how they combine into one score, the limits a run may not pass, the default model and harness matrix, and the visibility of the set. A version is immutable once a run names it; a fork records its parent. Holdout tasks are hidden from everyone but the executor.nnew file mode 100644@@@ -0,0 +1,21 @@++{++ "id": "report.ai_usage.read",++ "version": "1.0",++ "owner": "report",++ "status": "active",++ "visibility": "internal",++ "description": "Read the AI meter across the network: the usage records and their roll-ups, in groups (day, site, model, system, paid_by). The public totals (GET /api/v1/ai/usage/open) need no token at all.",++ "permissions": [++ "report:read"++ ],++ "resourceConstraints": [++ "none"++ ],++ "quotaClass": "report-read",++ "events": [],++ "implementedBy": [++ "GET /api/v1/ai/usage"++ ],++ "inputSchema": "common.no-body@1",++ "outputSchema": "report.ai-usage-result@1"++}@@@ -35,6 +35,7 @@"ai.me.manage"],"eventsProduced": [++ "ai.call.recorded","ai.run.queued","ai.run.succeeded","ai.run.failed",@@@ -15,9 +15,13 @@"state": "live","publicSite": "service"},-- "capabilities": [],++ "capabilities": [++ "report.ai_usage.read"++ ],"eventsProduced": [],-- "eventsConsumed": [],++ "eventsConsumed": [++ "ai.call.recorded"++ ],"namespacesOwned": ["report.*"],@@@ -1,12 +1,12 @@{"name": "openvibe-contracts",-- "version": "0.259.0",++ "version": "0.260.0","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "openvibe-contracts",-- "version": "0.259.0",++ "version": "0.260.0","license": "AGPL-3.0-only","dependencies": {"ajv": "^8.17.1",@@@ -1,6 +1,6 @@{"name": "openvibe-contracts",-- "version": "0.259.0",++ "version": "0.260.0","description": "Machine-readable contracts for the OpenVibe network: schemas, manifests, ids, error envelope, capability checks.","main": "index.js","types": "generated/typescript/index.d.ts",
@@ -1 +1,2 @@
@@ -1 +1,2 @@
node_modules/
node_modules/
+node_modules
@@ -1,5 +1,28 @@
@@ -1,5 +1,28 @@
# Changelog
# Changelog
+## 0.260.0 — 2026-10-31
+
+- **One AI meter across the network** (plan L40): every AI call on the network leaves one usage record, whoever made it.
+ - **`ai.call.recorded@1`** (`contracts/events/payloads/ai.call.recorded.v1.json`): one call, and who and where it
+ happened (`subject`, `attribution`, `surface`), what ran (`system`, `provider`, `model`, `effort`), who paid
+ (`paid_by`: `own_key`, `openvibe_key`, `plan`, `own_machine`, `free_tier`, `network_allowance`, `org_key`, with
+ `paid_by_detail`), the tokens (`input` uncached, `output`, `reasoning`, `cache_read`, `cache_write` with
+ `cache_write_ttl` `5m` or `1h`, `images`, `audio_seconds`, `video_seconds`), the money in USD (`list_cost_usd`,
+ `charged_usd`, `fee_usd`, `cache_saved_usd`, with `price_source` and `price_date`), how it went (`latency_ms`,
+ `ttft_ms`, `attempts`, `outcome`) and the ids (`run_id` or `turn_id`, `at`).
+ - **No prompt and no answer text, ever.** The payload has no field for either, and the schema closes the object.
+ - **The meter belongs to OpenVibe.Report** (plan L40 and L41): OpenVibe.AI writes the records, Report keeps the ledger
+ and rolls it up.
+ - **`report.ai-usage-open-result@1`**: the public AI totals (tokens, the cache share, the own-key share, the spend by
+ week). No person, no site and no key in it.
+ - **`report.ai-usage-result@1`**: the same meter in groups (day, site, model, system, paid_by) for a service token with
+ the new **`report.ai_usage.read`** capability. A group that fewer than ten people share reads 'fewer than 10'
+ instead of counting them.
+ - **`report.ai-usage-me-result@1`**: the AI usage of one person (GET /api/v1/me/ai/usage), for the person and nobody
+ else. The route answers 501 until Report has sign-in; the shape is fixed here first.
+ - Phase 1 is OpenVibe.AI's own runs; Codes, Actor and the rest feed the same event later. Report rolls the
+ records up, and a record taken twice is stored once (idempotent by `system` and `run_id` or `turn_id`).
+
## 0.259.0 — 2026-10-31
## 0.259.0 — 2026-10-31
- **`network.notification-push-request@1` addresses a person by subject as well as by user id (F1, familiar faces).**
- **`network.notification-push-request@1` addresses a person by subject as well as by user id (F1, familiar faces).**
@@ -46,6 +69,7 @@
@@ -46,6 +69,7 @@
session on AI's own site behind a same-origin check, reaches them. A service token is refused, and so is any token
session on AI's own site behind a same-origin check, reaches them. A service token is refused, and so is any token
carrying `on_behalf_of`, whatever capabilities it holds (the AI #204/#205 rule).
carrying `on_behalf_of`, whatever capabilities it holds (the AI #204/#205 rule).
+
## 0.256.0 — 2026-10-31
## 0.256.0 — 2026-10-31
- **`ai.looks` is retired** (`network.consent@1`). The owner removed the rule that AI text never describes people
- **`ai.looks` is retired** (`network.consent@1`). The owner removed the rule that AI text never describes people
@@ -1380,6 +1380,16 @@
@@ -1380,6 +1380,16 @@
"status": "active",
"status": "active",
"adr": "ADR-015"
"adr": "ADR-015"
},
},
+ {
+ "id": "ai.call.recorded",
+ "version": "1.0.0",
+ "owner": "ai",
+ "schema": "events/payloads/ai.call.recorded.v1.json",
+ "visibility": "first-party",
+ "compatibility": "backward",
+ "status": "active",
+ "adr": "ADR-033"
+ },
{
{
"id": "ai.run.queued",
"id": "ai.run.queued",
"version": "1.0.0",
"version": "1.0.0",
@@ -8310,6 +8320,33 @@
@@ -8310,6 +8320,33 @@
"compatibility": "backward",
"compatibility": "backward",
"status": "active"
"status": "active"
},
},
+ {
+ "id": "report.ai-usage-open-result",
+ "version": "1.0.0",
+ "owner": "report",
+ "schema": "report/ai-usage-open-result.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "report.ai-usage-result",
+ "version": "1.0.0",
+ "owner": "report",
+ "schema": "report/ai-usage-result.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "report.ai-usage-me-result",
+ "version": "1.0.0",
+ "owner": "report",
+ "schema": "report/ai-usage-me-result.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
{
{
"id": "bench.benchmark",
"id": "bench.benchmark",
"version": "1.0.0",
"version": "1.0.0",
new file mode 100644
new file mode 100644
@@ -0,0 +1,100 @@
@@ -0,0 +1,100 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/events/payloads/ai.call.recorded.v1.json",
+ "title": "AiCallRecordedPayload",
+ "description": "ai.call.recorded v1 (plan L40, one AI meter across the network). One AI call, wherever it happened: OpenVibe.AI's own runs, a harness turn in Codes, an Actor task, Vibe, a local model on a person's own machine. who and where: subject (the person, or null when the call is anonymous), attribution (the site or app the call came from, free text such as 'site:design'), surface (the product surface, free text such as 'design.generate' or 'codes.turn'). what ran: system (ai, harness:claude-code, harness:codex, actor, node), provider, model, effort. who paid: paid_by (own_key, openvibe_key, plan, own_machine, free_tier, network_allowance, org_key) and paid_by_detail (for example 'anthropic ...a1b2' for a person's own key, or 'claude-max' for a plan). tokens: input (the UNCACHED input tokens), output, reasoning, cache_read, cache_write (with cache_write_ttl 5m or 1h), images, audio_seconds, video_seconds. money, in USD: list_cost_usd (what the tokens cost at the human-typed list prices), charged_usd (what the payer was actually charged), fee_usd (the network's fee on top), cache_saved_usd (what the cache saved against the plain input price). price_source says where the prices came from ('models', 'pricing', 'flat', or 'no cache price' when no cache price is typed and the cache tokens are priced at the input price), price_date the day the price was checked. how it went: latency_ms, ttft_ms, attempts, outcome. ids: run_id or turn_id, and at. The record carries NO prompt and NO answer text, ever. A ledger (OpenVibe.AI) rolls the records up; a record consumed twice is stored once (idempotent by system and run_id or turn_id). Envelope: subject { type: run, id: <run_id> } or { type: user, id: <subject> }, visibility internal, priority low, actor service:ai.",
+ "type": "object",
+ "required": [
+ "system",
+ "surface",
+ "paid_by",
+ "input",
+ "output",
+ "reasoning",
+ "cache_read",
+ "cache_write",
+ "cache_write_ttl",
+ "images",
+ "audio_seconds",
+ "video_seconds",
+ "list_cost_usd",
+ "charged_usd",
+ "fee_usd",
+ "cache_saved_usd",
+ "price_source",
+ "price_date",
+ "latency_ms",
+ "ttft_ms",
+ "attempts",
+ "outcome",
+ "at"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "subject": {
+ "type": ["string", "null"],
+ "maxLength": 128,
+ "description": "The person the call was made for, or null when the call was anonymous."
+ },
+ "attribution": {
+ "type": "string",
+ "maxLength": 200,
+ "description": "The site or app the call came from, as '<type>:<id>' (for example 'site:design'), empty when nothing is known."
+ },
+ "surface": {
+ "type": "string",
+ "maxLength": 200,
+ "description": "The product surface: 'design.generate', 'codes.turn', 'ai.generate'. Free text, so a new surface needs no new contract."
+ },
+ "system": {
+ "type": "string",
+ "maxLength": 100,
+ "description": "What ran: 'ai', 'harness:claude-code', 'harness:codex', 'actor', 'node'."
+ },
+ "provider": { "type": ["string", "null"], "maxLength": 128 },
+ "model": { "type": ["string", "null"], "maxLength": 200 },
+ "effort": { "type": ["string", "null"], "maxLength": 64, "description": "The reasoning effort the call asked for, when it asked for one." },
+ "paid_by": {
+ "type": "string",
+ "enum": ["own_key", "openvibe_key", "plan", "own_machine", "free_tier", "network_allowance", "org_key"]
+ },
+ "paid_by_detail": {
+ "type": ["string", "null"],
+ "maxLength": 200,
+ "description": "Which key or plan paid, for example 'anthropic ...a1b2' or 'claude-max'. Never a whole secret."
+ },
+ "input": { "type": "integer", "minimum": 0, "description": "The uncached input tokens. Cache reads and cache writes are counted on their own fields." },
+ "output": { "type": "integer", "minimum": 0 },
+ "reasoning": { "type": "integer", "minimum": 0 },
+ "cache_read": { "type": "integer", "minimum": 0 },
+ "cache_write": { "type": "integer", "minimum": 0 },
+ "cache_write_ttl": {
+ "type": ["string", "null"],
+ "enum": ["5m", "1h", null],
+ "description": "How long the written cache entry lives, when the provider says."
+ },
+ "images": { "type": "integer", "minimum": 0 },
+ "audio_seconds": { "type": "number", "minimum": 0 },
+ "video_seconds": { "type": "number", "minimum": 0 },
+ "list_cost_usd": { "type": "number", "minimum": 0, "description": "What the tokens cost at the human-typed list prices." },
+ "charged_usd": { "type": "number", "minimum": 0, "description": "What the payer was actually charged. A person's own key is never charged here: 0." },
+ "fee_usd": { "type": "number", "minimum": 0, "description": "The network's fee on top of the cost, when the OpenVibe key paid." },
+ "cache_saved_usd": { "type": "number", "minimum": 0, "description": "What the cached tokens saved against the plain input price." },
+ "price_source": {
+ "type": "string",
+ "maxLength": 64,
+ "description": "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)."
+ },
+ "price_date": { "type": ["string", "null"], "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "description": "The day the price was checked, when it was." },
+ "latency_ms": { "type": ["integer", "null"], "minimum": 0 },
+ "ttft_ms": { "type": ["integer", "null"], "minimum": 0, "description": "Time to the first token, when the call streamed and it was measured." },
+ "attempts": { "type": "integer", "minimum": 0 },
+ "outcome": {
+ "type": "string",
+ "enum": ["succeeded", "failed", "cancelled", "cached"]
+ },
+ "run_id": { "type": ["string", "null"], "maxLength": 100 },
+ "turn_id": { "type": ["string", "null"], "maxLength": 100 },
+ "at": { "type": "string", "format": "date-time" }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,35 @@
@@ -0,0 +1,35 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/report/ai-usage-me-result.v1.json",
+ "title": "ReportAiUsageMeResult",
+ "description": "report.ai-usage-me-result@1: the AI usage of one person (plan L40/L41). GET /api/v1/me/ai/usage answers for the person themselves and nobody else: their rows, grouped by day, site, model, system or paid_by. The route answers 501 until Report has sign-in: the shape is fixed here first, so the route does not have to change when it opens.",
+ "type": "object",
+ "required": ["group", "usage", "totals"],
+ "additionalProperties": false,
+ "properties": {
+ "group": { "type": "string", "enum": ["day", "site", "model", "system", "paid_by"] },
+ "usage": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": ["group", "key", "calls", "input", "output", "reasoning", "cache_read", "cache_write", "list_cost_usd", "charged_usd", "fee_usd", "cache_saved_usd"],
+ "additionalProperties": false,
+ "properties": {
+ "group": { "type": "string", "enum": ["day", "site", "model", "system", "paid_by"] },
+ "key": { "type": "string", "maxLength": 200 },
+ "calls": { "type": "integer", "minimum": 0 },
+ "input": { "type": "integer", "minimum": 0 },
+ "output": { "type": "integer", "minimum": 0 },
+ "reasoning": { "type": "integer", "minimum": 0 },
+ "cache_read": { "type": "integer", "minimum": 0 },
+ "cache_write": { "type": "integer", "minimum": 0 },
+ "list_cost_usd": { "type": "number", "minimum": 0 },
+ "charged_usd": { "type": "number", "minimum": 0 },
+ "fee_usd": { "type": "number", "minimum": 0 },
+ "cache_saved_usd": { "type": "number", "minimum": 0 }
+ }
+ }
+ },
+ "totals": { "type": "object" }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,45 @@
@@ -0,0 +1,45 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/report/ai-usage-open-result.v1.json",
+ "title": "ReportAiUsageOpenResult",
+ "description": "report.ai-usage-open-result@1: the open AI meter (plan L40/L41). What the whole network spends on AI, in public: the tokens, the share of them that came from a provider cache, the share that the own keys of people paid, and the spend by week. No person, no site and no key is in it: the rows are summed before they are answered.",
+ "type": "object",
+ "required": ["calls", "tokens", "cache_share", "cache_saved_usd", "own_key_share", "own_key_calls", "list_cost_usd", "charged_usd", "fee_usd", "spend_by_week"],
+ "additionalProperties": false,
+ "properties": {
+ "calls": { "type": "integer", "minimum": 0, "description": "The AI calls behind these numbers." },
+ "tokens": {
+ "type": "object",
+ "required": ["input", "output", "cache_read", "cache_write"],
+ "additionalProperties": false,
+ "properties": {
+ "input": { "type": "integer", "minimum": 0, "description": "The uncached input tokens." },
+ "output": { "type": "integer", "minimum": 0 },
+ "cache_read": { "type": "integer", "minimum": 0 },
+ "cache_write": { "type": "integer", "minimum": 0 }
+ }
+ },
+ "cache_share": { "type": "number", "minimum": 0, "maximum": 1, "description": "The share of the prompt tokens that came from a provider cache." },
+ "cache_saved_usd": { "type": "number", "minimum": 0 },
+ "own_key_share": { "type": "number", "minimum": 0, "maximum": 1, "description": "The share of the tokens that the own keys of people paid." },
+ "own_key_calls": { "type": "integer", "minimum": 0 },
+ "list_cost_usd": { "type": "number", "minimum": 0 },
+ "charged_usd": { "type": "number", "minimum": 0 },
+ "fee_usd": { "type": "number", "minimum": 0 },
+ "spend_by_week": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": ["week", "calls", "list_cost_usd", "charged_usd", "cache_saved_usd"],
+ "additionalProperties": false,
+ "properties": {
+ "week": { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "description": "The Monday of the week." },
+ "calls": { "type": "integer", "minimum": 0 },
+ "list_cost_usd": { "type": "number", "minimum": 0 },
+ "charged_usd": { "type": "number", "minimum": 0 },
+ "cache_saved_usd": { "type": "number", "minimum": 0 }
+ }
+ }
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,63 @@
@@ -0,0 +1,63 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/report/ai-usage-result.v1.json",
+ "title": "ReportAiUsageResult",
+ "description": "report.ai-usage-result@1: the AI meter in groups (plan L40/L41). GET /api/v1/ai/usage needs a service token with report.ai_usage.read; the rows are grouped by day, site, model, system or paid_by. A group that fewer than ten people share reads fewer than 10 instead of counting them.",
+ "type": "object",
+ "required": ["group", "usage", "totals"],
+ "additionalProperties": false,
+ "properties": {
+ "group": { "type": "string", "enum": ["day", "site", "model", "system", "paid_by"] },
+ "usage": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": ["group", "key", "calls", "people", "input", "output", "reasoning", "cache_read", "cache_write", "list_cost_usd", "charged_usd", "fee_usd", "cache_saved_usd"],
+ "additionalProperties": false,
+ "properties": {
+ "group": { "type": "string", "enum": ["day", "site", "model", "system", "paid_by"] },
+ "key": { "type": "string", "maxLength": 200, "description": "The name of the group: the day, the site, the model, the system or the payer." },
+ "calls": { "type": "integer", "minimum": 0 },
+ "people": {
+ "oneOf": [
+ { "type": "integer", "minimum": 10, "description": "How many people the group holds, when there are ten or more." },
+ { "const": "fewer than 10", "description": "Fewer than ten people: the count is not given." }
+ ]
+ },
+ "input": { "type": "integer", "minimum": 0 },
+ "output": { "type": "integer", "minimum": 0 },
+ "reasoning": { "type": "integer", "minimum": 0 },
+ "cache_read": { "type": "integer", "minimum": 0 },
+ "cache_write": { "type": "integer", "minimum": 0 },
+ "images": { "type": "integer", "minimum": 0 },
+ "audio_seconds": { "type": "number", "minimum": 0 },
+ "video_seconds": { "type": "number", "minimum": 0 },
+ "list_cost_usd": { "type": "number", "minimum": 0 },
+ "charged_usd": { "type": "number", "minimum": 0 },
+ "fee_usd": { "type": "number", "minimum": 0 },
+ "cache_saved_usd": { "type": "number", "minimum": 0 }
+ }
+ }
+ },
+ "totals": {
+ "type": "object",
+ "required": ["calls", "input", "output", "reasoning", "cache_read", "cache_write", "list_cost_usd", "charged_usd", "fee_usd", "cache_saved_usd"],
+ "additionalProperties": false,
+ "properties": {
+ "calls": { "type": "integer", "minimum": 0 },
+ "input": { "type": "integer", "minimum": 0 },
+ "output": { "type": "integer", "minimum": 0 },
+ "reasoning": { "type": "integer", "minimum": 0 },
+ "cache_read": { "type": "integer", "minimum": 0 },
+ "cache_write": { "type": "integer", "minimum": 0 },
+ "images": { "type": "integer", "minimum": 0 },
+ "audio_seconds": { "type": "number", "minimum": 0 },
+ "video_seconds": { "type": "number", "minimum": 0 },
+ "list_cost_usd": { "type": "number", "minimum": 0 },
+ "charged_usd": { "type": "number", "minimum": 0 },
+ "fee_usd": { "type": "number", "minimum": 0 },
+ "cache_saved_usd": { "type": "number", "minimum": 0 }
+ }
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,34 @@
@@ -0,0 +1,34 @@
+{
+ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "attribution": "site:design",
+ "surface": "design.generate",
+ "system": "ai",
+ "provider": "anthropic",
+ "model": "claude-sonnet-4-5",
+ "effort": "high",
+ "paid_by": "own_key",
+ "paid_by_detail": "anthropic ...a1b2",
+ "input": 1200,
+ "output": 300,
+ "reasoning": 0,
+ "cache_read": 8000,
+ "cache_write": 1500,
+ "cache_write_ttl": "5m",
+ "images": 0,
+ "audio_seconds": 0,
+ "video_seconds": 0,
+ "list_cost_usd": 0.012345,
+ "charged_usd": 0,
+ "fee_usd": 0,
+ "cache_saved_usd": 0.00321,
+ "price_source": "models",
+ "price_date": "2026-10-31",
+ "latency_ms": 4200,
+ "ttft_ms": 640,
+ "attempts": 1,
+ "outcome": "succeeded",
+ "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "turn_id": null,
+ "at": "2026-10-31T18:00:00.000Z",
+ "output_text": "the answer the model gave"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,33 @@
@@ -0,0 +1,33 @@
+{
+ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "attribution": "site:design",
+ "surface": "design.generate",
+ "system": "ai",
+ "provider": "anthropic",
+ "model": "claude-sonnet-4-5",
+ "effort": "high",
+ "paid_by": "own_key",
+ "paid_by_detail": "anthropic ...a1b2",
+ "input": 1200,
+ "output": 300,
+ "reasoning": 0,
+ "cache_read": 8000,
+ "cache_write": 1500,
+ "cache_write_ttl": "10m",
+ "images": 0,
+ "audio_seconds": 0,
+ "video_seconds": 0,
+ "list_cost_usd": 0.012345,
+ "charged_usd": 0,
+ "fee_usd": 0,
+ "cache_saved_usd": 0.00321,
+ "price_source": "models",
+ "price_date": "2026-10-31",
+ "latency_ms": 4200,
+ "ttft_ms": 640,
+ "attempts": 1,
+ "outcome": "succeeded",
+ "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "turn_id": null,
+ "at": "2026-10-31T18:00:00.000Z"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,33 @@
@@ -0,0 +1,33 @@
+{
+ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "attribution": "site:design",
+ "surface": "design.generate",
+ "system": "ai",
+ "provider": "anthropic",
+ "model": "claude-sonnet-4-5",
+ "effort": "high",
+ "paid_by": "someone_else",
+ "paid_by_detail": "anthropic ...a1b2",
+ "input": 1200,
+ "output": 300,
+ "reasoning": 0,
+ "cache_read": 8000,
+ "cache_write": 1500,
+ "cache_write_ttl": "5m",
+ "images": 0,
+ "audio_seconds": 0,
+ "video_seconds": 0,
+ "list_cost_usd": 0.012345,
+ "charged_usd": 0,
+ "fee_usd": 0,
+ "cache_saved_usd": 0.00321,
+ "price_source": "models",
+ "price_date": "2026-10-31",
+ "latency_ms": 4200,
+ "ttft_ms": 640,
+ "attempts": 1,
+ "outcome": "succeeded",
+ "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "turn_id": null,
+ "at": "2026-10-31T18:00:00.000Z"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,33 @@
@@ -0,0 +1,33 @@
+{
+ "subject": null,
+ "attribution": "",
+ "surface": "ai.complete",
+ "system": "harness:claude-code",
+ "provider": "openai",
+ "model": "gpt-5",
+ "effort": null,
+ "paid_by": "openvibe_key",
+ "paid_by_detail": "openvibe:gpt-5",
+ "input": 200,
+ "output": 80,
+ "reasoning": 40,
+ "cache_read": 800,
+ "cache_write": 0,
+ "cache_write_ttl": null,
+ "images": 0,
+ "audio_seconds": 0,
+ "video_seconds": 0,
+ "list_cost_usd": 0.0021,
+ "charged_usd": 0.0021,
+ "fee_usd": 0.000105,
+ "cache_saved_usd": 0,
+ "price_source": "no cache price",
+ "price_date": null,
+ "latency_ms": 1800,
+ "ttft_ms": null,
+ "attempts": 2,
+ "outcome": "succeeded",
+ "run_id": null,
+ "turn_id": "tn_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "at": "2026-10-31T18:05:00.000Z"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,33 @@
@@ -0,0 +1,33 @@
+{
+ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "attribution": "site:design",
+ "surface": "design.generate",
+ "system": "ai",
+ "provider": "anthropic",
+ "model": "claude-sonnet-4-5",
+ "effort": "high",
+ "paid_by": "own_key",
+ "paid_by_detail": "anthropic ...a1b2",
+ "input": 1200,
+ "output": 300,
+ "reasoning": 0,
+ "cache_read": 8000,
+ "cache_write": 1500,
+ "cache_write_ttl": "5m",
+ "images": 0,
+ "audio_seconds": 0,
+ "video_seconds": 0,
+ "list_cost_usd": 0.012345,
+ "charged_usd": 0,
+ "fee_usd": 0,
+ "cache_saved_usd": 0.00321,
+ "price_source": "models",
+ "price_date": "2026-10-31",
+ "latency_ms": 4200,
+ "ttft_ms": 640,
+ "attempts": 1,
+ "outcome": "succeeded",
+ "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "turn_id": null,
+ "at": "2026-10-31T18:00:00.000Z"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,6 @@
@@ -0,0 +1,6 @@
+{
+ "group": "day",
+ "usage": [],
+ "totals": { "calls": 0 },
+ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,11 @@
@@ -0,0 +1,11 @@
+{
+ "group": "day",
+ "usage": [
+ {
+ "group": "day", "key": "2026-10-31", "calls": 2,
+ "input": 200, "output": 80, "reasoning": 0, "cache_read": 800, "cache_write": 0,
+ "list_cost_usd": 0.0021, "charged_usd": 0, "fee_usd": 0, "cache_saved_usd": 0
+ }
+ ],
+ "totals": { "calls": 2, "input": 200, "output": 80 }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,13 @@
@@ -0,0 +1,13 @@
+{
+ "calls": 120,
+ "tokens": { "input": 1000, "output": 200, "cache_read": 800, "cache_write": 150 },
+ "cache_share": 0.41,
+ "cache_saved_usd": 0.12,
+ "own_key_share": 0.25,
+ "own_key_calls": 30,
+ "list_cost_usd": 1.23,
+ "charged_usd": 0.9,
+ "fee_usd": 0.02,
+ "spend_by_week": [],
+ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,14 @@
@@ -0,0 +1,14 @@
+{
+ "calls": 120,
+ "tokens": { "input": 1000, "output": 200, "cache_read": 800, "cache_write": 150 },
+ "cache_share": 0.41,
+ "cache_saved_usd": 0.12,
+ "own_key_share": 0.25,
+ "own_key_calls": 30,
+ "list_cost_usd": 1.23,
+ "charged_usd": 0.9,
+ "fee_usd": 0.02,
+ "spend_by_week": [
+ { "week": "2026-10-27", "calls": 30, "list_cost_usd": 0.4, "charged_usd": 0.3, "cache_saved_usd": 0.05 }
+ ]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,14 @@
@@ -0,0 +1,14 @@
+{
+ "group": "site",
+ "usage": [
+ {
+ "group": "site", "key": "site:design", "calls": 3, "people": 3,
+ "input": 10, "output": 5, "reasoning": 0, "cache_read": 0, "cache_write": 0,
+ "list_cost_usd": 0.01, "charged_usd": 0.01, "fee_usd": 0, "cache_saved_usd": 0
+ }
+ ],
+ "totals": {
+ "calls": 3, "input": 10, "output": 5, "reasoning": 0, "cache_read": 0, "cache_write": 0,
+ "list_cost_usd": 0.01, "charged_usd": 0.01, "fee_usd": 0, "cache_saved_usd": 0
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,14 @@
@@ -0,0 +1,14 @@
+{
+ "group": "day",
+ "usage": [
+ {
+ "group": "day", "key": "2026-10-31", "calls": 12, "people": 14,
+ "input": 100, "output": 50, "reasoning": 0, "cache_read": 800, "cache_write": 0,
+ "list_cost_usd": 0.1, "charged_usd": 0.1, "fee_usd": 0, "cache_saved_usd": 0.02
+ }
+ ],
+ "totals": {
+ "calls": 12, "input": 100, "output": 50, "reasoning": 0, "cache_read": 800, "cache_write": 0,
+ "list_cost_usd": 0.1, "charged_usd": 0.1, "fee_usd": 0, "cache_saved_usd": 0.02
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,14 @@
@@ -0,0 +1,14 @@
+{
+ "group": "site",
+ "usage": [
+ {
+ "group": "site", "key": "site:design", "calls": 3, "people": "fewer than 10",
+ "input": 10, "output": 5, "reasoning": 0, "cache_read": 0, "cache_write": 0,
+ "list_cost_usd": 0.01, "charged_usd": 0.01, "fee_usd": 0, "cache_saved_usd": 0
+ }
+ ],
+ "totals": {
+ "calls": 3, "input": 10, "output": 5, "reasoning": 0, "cache_read": 0, "cache_write": 0,
+ "list_cost_usd": 0.01, "charged_usd": 0.01, "fee_usd": 0, "cache_saved_usd": 0
+ }
+}
@@ -15000,6 +15000,235 @@
@@ -15000,6 +15000,235 @@
}
}
}
}
},
},
+ "ai.call.recorded": {
+ "version": "1.0.0",
+ "owner": "ai",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/events/payloads/ai.call.recorded.v1.json",
+ "title": "AiCallRecordedPayload",
+ "description": "ai.call.recorded v1 (plan L40, one AI meter across the network). One AI call, wherever it happened: OpenVibe.AI's own runs, a harness turn in Codes, an Actor task, Vibe, a local model on a person's own machine. who and where: subject (the person, or null when the call is anonymous), attribution (the site or app the call came from, free text such as 'site:design'), surface (the product surface, free text such as 'design.generate' or 'codes.turn'). what ran: system (ai, harness:claude-code, harness:codex, actor, node), provider, model, effort. who paid: paid_by (own_key, openvibe_key, plan, own_machine, free_tier, network_allowance, org_key) and paid_by_detail (for example 'anthropic ...a1b2' for a person's own key, or 'claude-max' for a plan). tokens: input (the UNCACHED input tokens), output, reasoning, cache_read, cache_write (with cache_write_ttl 5m or 1h), images, audio_seconds, video_seconds. money, in USD: list_cost_usd (what the tokens cost at the human-typed list prices), charged_usd (what the payer was actually charged), fee_usd (the network's fee on top), cache_saved_usd (what the cache saved against the plain input price). price_source says where the prices came from ('models', 'pricing', 'flat', or 'no cache price' when no cache price is typed and the cache tokens are priced at the input price), price_date the day the price was checked. how it went: latency_ms, ttft_ms, attempts, outcome. ids: run_id or turn_id, and at. The record carries NO prompt and NO answer text, ever. A ledger (OpenVibe.AI) rolls the records up; a record consumed twice is stored once (idempotent by system and run_id or turn_id). Envelope: subject { type: run, id: <run_id> } or { type: user, id: <subject> }, visibility internal, priority low, actor service:ai.",
+ "type": "object",
+ "required": [
+ "system",
+ "surface",
+ "paid_by",
+ "input",
+ "output",
+ "reasoning",
+ "cache_read",
+ "cache_write",
+ "cache_write_ttl",
+ "images",
+ "audio_seconds",
+ "video_seconds",
+ "list_cost_usd",
+ "charged_usd",
+ "fee_usd",
+ "cache_saved_usd",
+ "price_source",
+ "price_date",
+ "latency_ms",
+ "ttft_ms",
+ "attempts",
+ "outcome",
+ "at"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "subject": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 128,
+ "description": "The person the call was made for, or null when the call was anonymous."
+ },
+ "attribution": {
+ "type": "string",
+ "maxLength": 200,
+ "description": "The site or app the call came from, as '<type>:<id>' (for example 'site:design'), empty when nothing is known."
+ },
+ "surface": {
+ "type": "string",
+ "maxLength": 200,
+ "description": "The product surface: 'design.generate', 'codes.turn', 'ai.generate'. Free text, so a new surface needs no new contract."
+ },
+ "system": {
+ "type": "string",
+ "maxLength": 100,
+ "description": "What ran: 'ai', 'harness:claude-code', 'harness:codex', 'actor', 'node'."
+ },
+ "provider": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 128
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 200
+ },
+ "effort": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 64,
+ "description": "The reasoning effort the call asked for, when it asked for one."
+ },
+ "paid_by": {
+ "type": "string",
+ "enum": [
+ "own_key",
+ "openvibe_key",
+ "plan",
+ "own_machine",
+ "free_tier",
+ "network_allowance",
+ "org_key"
+ ]
+ },
+ "paid_by_detail": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 200,
+ "description": "Which key or plan paid, for example 'anthropic ...a1b2' or 'claude-max'. Never a whole secret."
+ },
+ "input": {
+ "type": "integer",
+ "minimum": 0,
+ "description": "The uncached input tokens. Cache reads and cache writes are counted on their own fields."
+ },
+ "output": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "reasoning": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_read": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_write": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_write_ttl": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "5m",
+ "1h",
+ null
+ ],
+ "description": "How long the written cache entry lives, when the provider says."
+ },
+ "images": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "audio_seconds": {
+ "type": "number",
+ "minimum": 0
+ },
+ "video_seconds": {
+ "type": "number",
+ "minimum": 0
+ },
+ "list_cost_usd": {
+ "type": "number",
+ "minimum": 0,
+ "description": "What the tokens cost at the human-typed list prices."
+ },
+ "charged_usd": {
+ "type": "number",
+ "minimum": 0,
+ "description": "What the payer was actually charged. A person's own key is never charged here: 0."
+ },
+ "fee_usd": {
+ "type": "number",
+ "minimum": 0,
+ "description": "The network's fee on top of the cost, when the OpenVibe key paid."
+ },
+ "cache_saved_usd": {
+ "type": "number",
+ "minimum": 0,
+ "description": "What the cached tokens saved against the plain input price."
+ },
+ "price_source": {
+ "type": "string",
+ "maxLength": 64,
+ "description": "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)."
+ },
+ "price_date": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
+ "description": "The day the price was checked, when it was."
+ },
+ "latency_ms": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "ttft_ms": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0,
+ "description": "Time to the first token, when the call streamed and it was measured."
+ },
+ "attempts": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "outcome": {
+ "type": "string",
+ "enum": [
+ "succeeded",
+ "failed",
+ "cancelled",
+ "cached"
+ ]
+ },
+ "run_id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 100
+ },
+ "turn_id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 100
+ },
+ "at": {
+ "type": "string",
+ "format": "date-time"
+ }
+ }
+ }
+ },
"ai.run.queued": {
"ai.run.queued": {
"version": "1.0.0",
"version": "1.0.0",
"owner": "ai",
"owner": "ai",
@@ -92933,6 +93162,450 @@
@@ -92933,6 +93162,450 @@
]
]
}
}
},
},
+ "report.ai-usage-open-result": {
+ "version": "1.0.0",
+ "owner": "report",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/report/ai-usage-open-result.v1.json",
+ "title": "ReportAiUsageOpenResult",
+ "description": "report.ai-usage-open-result@1: the open AI meter (plan L40/L41). What the whole network spends on AI, in public: the tokens, the share of them that came from a provider cache, the share that the own keys of people paid, and the spend by week. No person, no site and no key is in it: the rows are summed before they are answered.",
+ "type": "object",
+ "required": [
+ "calls",
+ "tokens",
+ "cache_share",
+ "cache_saved_usd",
+ "own_key_share",
+ "own_key_calls",
+ "list_cost_usd",
+ "charged_usd",
+ "fee_usd",
+ "spend_by_week"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "calls": {
+ "type": "integer",
+ "minimum": 0,
+ "description": "The AI calls behind these numbers."
+ },
+ "tokens": {
+ "type": "object",
+ "required": [
+ "input",
+ "output",
+ "cache_read",
+ "cache_write"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "input": {
+ "type": "integer",
+ "minimum": 0,
+ "description": "The uncached input tokens."
+ },
+ "output": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_read": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_write": {
+ "type": "integer",
+ "minimum": 0
+ }
+ }
+ },
+ "cache_share": {
+ "type": "number",
+ "minimum": 0,
+ "maximum": 1,
+ "description": "The share of the prompt tokens that came from a provider cache."
+ },
+ "cache_saved_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "own_key_share": {
+ "type": "number",
+ "minimum": 0,
+ "maximum": 1,
+ "description": "The share of the tokens that the own keys of people paid."
+ },
+ "own_key_calls": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "list_cost_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "charged_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "fee_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "spend_by_week": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "week",
+ "calls",
+ "list_cost_usd",
+ "charged_usd",
+ "cache_saved_usd"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "week": {
+ "type": "string",
+ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
+ "description": "The Monday of the week."
+ },
+ "calls": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "list_cost_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "charged_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "cache_saved_usd": {
+ "type": "number",
+ "minimum": 0
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "report.ai-usage-result": {
+ "version": "1.0.0",
+ "owner": "report",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/report/ai-usage-result.v1.json",
+ "title": "ReportAiUsageResult",
+ "description": "report.ai-usage-result@1: the AI meter in groups (plan L40/L41). GET /api/v1/ai/usage needs a service token with report.ai_usage.read; the rows are grouped by day, site, model, system or paid_by. A group that fewer than ten people share reads fewer than 10 instead of counting them.",
+ "type": "object",
+ "required": [
+ "group",
+ "usage",
+ "totals"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "type": "string",
+ "enum": [
+ "day",
+ "site",
+ "model",
+ "system",
+ "paid_by"
+ ]
+ },
+ "usage": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "group",
+ "key",
+ "calls",
+ "people",
+ "input",
+ "output",
+ "reasoning",
+ "cache_read",
+ "cache_write",
+ "list_cost_usd",
+ "charged_usd",
+ "fee_usd",
+ "cache_saved_usd"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "type": "string",
+ "enum": [
+ "day",
+ "site",
+ "model",
+ "system",
+ "paid_by"
+ ]
+ },
+ "key": {
+ "type": "string",
+ "maxLength": 200,
+ "description": "The name of the group: the day, the site, the model, the system or the payer."
+ },
+ "calls": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "people": {
+ "oneOf": [
+ {
+ "type": "integer",
+ "minimum": 10,
+ "description": "How many people the group holds, when there are ten or more."
+ },
+ {
+ "const": "fewer than 10",
+ "description": "Fewer than ten people: the count is not given."
+ }
+ ]
+ },
+ "input": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "output": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "reasoning": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_read": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_write": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "images": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "audio_seconds": {
+ "type": "number",
+ "minimum": 0
+ },
+ "video_seconds": {
+ "type": "number",
+ "minimum": 0
+ },
+ "list_cost_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "charged_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "fee_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "cache_saved_usd": {
+ "type": "number",
+ "minimum": 0
+ }
+ }
+ }
+ },
+ "totals": {
+ "type": "object",
+ "required": [
+ "calls",
+ "input",
+ "output",
+ "reasoning",
+ "cache_read",
+ "cache_write",
+ "list_cost_usd",
+ "charged_usd",
+ "fee_usd",
+ "cache_saved_usd"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "calls": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "input": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "output": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "reasoning": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_read": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_write": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "images": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "audio_seconds": {
+ "type": "number",
+ "minimum": 0
+ },
+ "video_seconds": {
+ "type": "number",
+ "minimum": 0
+ },
+ "list_cost_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "charged_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "fee_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "cache_saved_usd": {
+ "type": "number",
+ "minimum": 0
+ }
+ }
+ }
+ }
+ }
+ },
+ "report.ai-usage-me-result": {
+ "version": "1.0.0",
+ "owner": "report",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/report/ai-usage-me-result.v1.json",
+ "title": "ReportAiUsageMeResult",
+ "description": "report.ai-usage-me-result@1: the AI usage of one person (plan L40/L41). GET /api/v1/me/ai/usage answers for the person themselves and nobody else: their rows, grouped by day, site, model, system or paid_by. The route answers 501 until Report has sign-in: the shape is fixed here first, so the route does not have to change when it opens.",
+ "type": "object",
+ "required": [
+ "group",
+ "usage",
+ "totals"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "type": "string",
+ "enum": [
+ "day",
+ "site",
+ "model",
+ "system",
+ "paid_by"
+ ]
+ },
+ "usage": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "group",
+ "key",
+ "calls",
+ "input",
+ "output",
+ "reasoning",
+ "cache_read",
+ "cache_write",
+ "list_cost_usd",
+ "charged_usd",
+ "fee_usd",
+ "cache_saved_usd"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "type": "string",
+ "enum": [
+ "day",
+ "site",
+ "model",
+ "system",
+ "paid_by"
+ ]
+ },
+ "key": {
+ "type": "string",
+ "maxLength": 200
+ },
+ "calls": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "input": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "output": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "reasoning": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_read": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_write": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "list_cost_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "charged_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "fee_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "cache_saved_usd": {
+ "type": "number",
+ "minimum": 0
+ }
+ }
+ }
+ },
+ "totals": {
+ "type": "object"
+ }
+ }
+ }
+ },
"bench.benchmark": {
"bench.benchmark": {
"version": "1.0.0",
"version": "1.0.0",
"owner": "bench",
"owner": "bench",
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Actor API",
"title": "OpenVibe.Actor API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.AI API",
"title": "OpenVibe.AI API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Bench API",
"title": "OpenVibe.Bench API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Billing API",
"title": "OpenVibe.Billing API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Blog API",
"title": "OpenVibe.Blog API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Bot API",
"title": "OpenVibe.Bot API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Chat API",
"title": "OpenVibe.Chat API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Codes API",
"title": "OpenVibe.Codes API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Community API",
"title": "OpenVibe.Community API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Coupons API",
"title": "OpenVibe.Coupons API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Deals API",
"title": "OpenVibe.Deals API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Domains API",
"title": "OpenVibe.Domains API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Events API",
"title": "OpenVibe.Events API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Food API",
"title": "OpenVibe.Food API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Games API",
"title": "OpenVibe.Games API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Host API",
"title": "OpenVibe.Host API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -176,6 +176,13 @@
@@ -176,6 +176,13 @@
"operations": 3,
"operations": 3,
"capabilities": 1
"capabilities": 1
},
},
+ {
+ "service": "report",
+ "name": "OpenVibe.Report",
+ "origin": "https://openvibe.report",
+ "operations": 1,
+ "capabilities": 1
+ },
{
{
"service": "reviews",
"service": "reviews",
"name": "OpenVibe.Reviews",
"name": "OpenVibe.Reviews",
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Inventory API",
"title": "OpenVibe.Inventory API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Live API",
"title": "OpenVibe.Live API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.MediaHub API",
"title": "OpenVibe.MediaHub API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Media API",
"title": "OpenVibe.Media API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Network API",
"title": "OpenVibe.Network API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.News API",
"title": "OpenVibe.News API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenRestream API",
"title": "OpenRestream API",
- "version": "0.259.0",
- "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Play API",
"title": "OpenVibe.Play API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Quest API",
"title": "OpenVibe.Quest API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
new file mode 100644
new file mode 100644
@@ -0,0 +1,341 @@
@@ -0,0 +1,341 @@
+{
+ "openapi": "3.1.0",
+ "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+ "info": {
+ "title": "OpenVibe.Report API",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "license": {
+ "name": "MIT",
+ "identifier": "MIT"
+ }
+ },
+ "servers": [
+ {
+ "url": "https://openvibe.report"
+ }
+ ],
+ "paths": {
+ "/api/v1/ai/usage": {
+ "get": {
+ "operationId": "get_api_v1_ai_usage",
+ "summary": "Read the AI meter across the network: the usage records and their roll-ups, in groups (day, site, model, system, paid_by).",
+ "description": "**report.ai_usage.read** (internal): Read the AI meter across the network: the usage records and their roll-ups, in groups (day, site, model, system, paid_by). The public totals (GET /api/v1/ai/usage/open) need no token at all.",
+ "tags": [
+ "report.ai_usage"
+ ],
+ "x-openvibe-capabilities": [
+ "report.ai_usage.read"
+ ],
+ "x-openvibe-visibility": [
+ "internal"
+ ],
+ "x-openvibe-quota-class": "report-read",
+ "security": [
+ {
+ "openvibeToken": [
+ "report.ai_usage.read"
+ ]
+ }
+ ],
+ "responses": {
+ "2XX": {
+ "description": "Success",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/report.ai-usage-result.v1"
+ }
+ }
+ }
+ },
+ "default": {
+ "description": "An error (RFC 9457 problem details)",
+ "content": {
+ "application/problem+json": {
+ "schema": {
+ "$ref": "#/components/schemas/errors.problem.v1"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "errors.problem.v1": {
+ "title": "Problem",
+ "description": "RFC 9457 problem details (application/problem+json) with a stable OpenVibe error code and trace identifiers. The legacy 'error' string is allowed during migration so existing clients keep working.",
+ "type": "object",
+ "required": [
+ "type",
+ "title",
+ "status",
+ "code"
+ ],
+ "additionalProperties": true,
+ "properties": {
+ "type": {
+ "type": "string",
+ "format": "uri-reference"
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1
+ },
+ "status": {
+ "type": "integer",
+ "minimum": 400,
+ "maximum": 599
+ },
+ "detail": {
+ "type": "string"
+ },
+ "instance": {
+ "type": "string",
+ "format": "uri-reference"
+ },
+ "code": {
+ "type": "string",
+ "pattern": "^[a-z][a-z0-9_]*(\\.[a-z0-9_]+)*$"
+ },
+ "request_id": {
+ "type": "string"
+ },
+ "trace_id": {
+ "type": "string",
+ "pattern": "^[0-9a-f]{32}$"
+ },
+ "errors": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "message"
+ ],
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "error": {
+ "type": "string",
+ "description": "Deprecated compatibility field: same text as title/detail for clients that read {error}."
+ }
+ }
+ },
+ "report.ai-usage-result.v1": {
+ "title": "ReportAiUsageResult",
+ "description": "report.ai-usage-result@1: the AI meter in groups (plan L40/L41). GET /api/v1/ai/usage needs a service token with report.ai_usage.read; the rows are grouped by day, site, model, system or paid_by. A group that fewer than ten people share reads fewer than 10 instead of counting them.",
+ "type": "object",
+ "required": [
+ "group",
+ "usage",
+ "totals"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "type": "string",
+ "enum": [
+ "day",
+ "site",
+ "model",
+ "system",
+ "paid_by"
+ ]
+ },
+ "usage": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "group",
+ "key",
+ "calls",
+ "people",
+ "input",
+ "output",
+ "reasoning",
+ "cache_read",
+ "cache_write",
+ "list_cost_usd",
+ "charged_usd",
+ "fee_usd",
+ "cache_saved_usd"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "group": {
+ "type": "string",
+ "enum": [
+ "day",
+ "site",
+ "model",
+ "system",
+ "paid_by"
+ ]
+ },
+ "key": {
+ "type": "string",
+ "maxLength": 200,
+ "description": "The name of the group: the day, the site, the model, the system or the payer."
+ },
+ "calls": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "people": {
+ "oneOf": [
+ {
+ "type": "integer",
+ "minimum": 10,
+ "description": "How many people the group holds, when there are ten or more."
+ },
+ {
+ "const": "fewer than 10",
+ "description": "Fewer than ten people: the count is not given."
+ }
+ ]
+ },
+ "input": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "output": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "reasoning": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_read": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_write": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "images": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "audio_seconds": {
+ "type": "number",
+ "minimum": 0
+ },
+ "video_seconds": {
+ "type": "number",
+ "minimum": 0
+ },
+ "list_cost_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "charged_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "fee_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "cache_saved_usd": {
+ "type": "number",
+ "minimum": 0
+ }
+ }
+ }
+ },
+ "totals": {
+ "type": "object",
+ "required": [
+ "calls",
+ "input",
+ "output",
+ "reasoning",
+ "cache_read",
+ "cache_write",
+ "list_cost_usd",
+ "charged_usd",
+ "fee_usd",
+ "cache_saved_usd"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "calls": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "input": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "output": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "reasoning": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_read": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "cache_write": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "images": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "audio_seconds": {
+ "type": "number",
+ "minimum": 0
+ },
+ "video_seconds": {
+ "type": "number",
+ "minimum": 0
+ },
+ "list_cost_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "charged_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "fee_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "cache_saved_usd": {
+ "type": "number",
+ "minimum": 0
+ }
+ }
+ }
+ }
+ }
+ },
+ "securitySchemes": {
+ "openvibeToken": {
+ "type": "http",
+ "scheme": "bearer",
+ "bearerFormat": "JWT",
+ "description": "An OpenVibe Network token for this service: a person's token, an app token (client credentials, audience of the service) or a first-party service token. Its `cap` claim must include the capability the operation names."
+ }
+ }
+ }
+}
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Reviews API",
"title": "OpenVibe.Reviews API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Run API",
"title": "OpenVibe.Run API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Search API",
"title": "OpenVibe.Search API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Services API",
"title": "OpenVibe.Services API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Sources API",
"title": "OpenVibe.Sources API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Space API",
"title": "OpenVibe.Space API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Tips API",
"title": "OpenVibe.Tips API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Tools API",
"title": "OpenVibe.Tools API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Trade API",
"title": "OpenVibe.Trade API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.VIP API",
"title": "OpenVibe.VIP API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Vision API",
"title": "OpenVibe.Vision API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Watch API",
"title": "OpenVibe.Watch API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Wiki API",
"title": "OpenVibe.Wiki API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Work API",
"title": "OpenVibe.Work API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Zone API",
"title": "OpenVibe.Zone API",
- "version": "0.259.0",
- "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.259.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.260.0",
+ "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.260.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -152300,6 +152300,89 @@ export interface AiRun {
@@ -152300,6 +152300,89 @@ export interface AiRun {
finished_at: string | null;
finished_at: string | null;
}
}
+/** [email protected] (owner: ai) */
+/**
+ * ai.call.recorded v1 (plan L40, one AI meter across the network). One AI call, wherever it happened: OpenVibe.AI's own runs, a harness turn in Codes, an Actor task, Vibe, a local model on a person's own machine. who and where: subject (the person, or null when the call is anonymous), attribution (the site or app the call came from, free text such as 'site:design'), surface (the product surface, free text such as 'design.generate' or 'codes.turn'). what ran: system (ai, harness:claude-code, harness:codex, actor, node), provider, model, effort. who paid: paid_by (own_key, openvibe_key, plan, own_machine, free_tier, network_allowance, org_key) and paid_by_detail (for example 'anthropic ...a1b2' for a person's own key, or 'claude-max' for a plan). tokens: input (the UNCACHED input tokens), output, reasoning, cache_read, cache_write (with cache_write_ttl 5m or 1h), images, audio_seconds, video_seconds. money, in USD: list_cost_usd (what the tokens cost at the human-typed list prices), charged_usd (what the payer was actually charged), fee_usd (the network's fee on top), cache_saved_usd (what the cache saved against the plain input price). price_source says where the prices came from ('models', 'pricing', 'flat', or 'no cache price' when no cache price is typed and the cache tokens are priced at the input price), price_date the day the price was checked. how it went: latency_ms, ttft_ms, attempts, outcome. ids: run_id or turn_id, and at. The record carries NO prompt and NO answer text, ever. A ledger (OpenVibe.AI) rolls the records up; a record consumed twice is stored once (idempotent by system and run_id or turn_id). Envelope: subject { type: run, id: <run_id> } or { type: user, id: <subject> }, visibility internal, priority low, actor service:ai.
+ */
+export interface AiCallRecordedPayload {
+ /**
+ * The person the call was made for, or null when the call was anonymous.
+ */
+ subject?: string | null;
+ /**
+ * The site or app the call came from, as '<type>:<id>' (for example 'site:design'), empty when nothing is known.
+ */
+ attribution?: string;
+ /**
+ * The product surface: 'design.generate', 'codes.turn', 'ai.generate'. Free text, so a new surface needs no new contract.
+ */
+ surface: string;
+ /**
+ * What ran: 'ai', 'harness:claude-code', 'harness:codex', 'actor', 'node'.
+ */
+ system: string;
+ provider?: string | null;
+ model?: string | null;
+ /**
+ * The reasoning effort the call asked for, when it asked for one.
+ */
+ effort?: string | null;
+ paid_by: "own_key" | "openvibe_key" | "plan" | "own_machine" | "free_tier" | "network_allowance" | "org_key";
+ /**
+ * Which key or plan paid, for example 'anthropic ...a1b2' or 'claude-max'. Never a whole secret.
+ */
+ paid_by_detail?: string | null;
+ /**
+ * The uncached input tokens. Cache reads and cache writes are counted on their own fields.
+ */
+ input: number;
+ output: number;
+ reasoning: number;
+ cache_read: number;
+ cache_write: number;
+ /**
+ * How long the written cache entry lives, when the provider says.
+ */
+ cache_write_ttl: "5m" | "1h" | null;
+ images: number;
+ audio_seconds: number;
+ video_seconds: number;
+ /**
+ * What the tokens cost at the human-typed list prices.
+ */
+ list_cost_usd: number;
+ /**
+ * What the payer was actually charged. A person's own key is never charged here: 0.
+ */
+ charged_usd: number;
+ /**
+ * The network's fee on top of the cost, when the OpenVibe key paid.
+ */
+ fee_usd: number;
+ /**
+ * What the cached tokens saved against the plain input price.
+ */
+ cache_saved_usd: number;
+ /**
+ * 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).
+ */
+ price_source: string;
+ /**
+ * The day the price was checked, when it was.
+ */
+ price_date: string | null;
+ latency_ms: number | null;
+ /**
+ * Time to the first token, when the call streamed and it was measured.
+ */
+ ttft_ms: number | null;
+ attempts: number;
+ outcome: "succeeded" | "failed" | "cancelled" | "cached";
+ run_id?: string | null;
+ turn_id?: string | null;
+ at: string;
+}
+
/** [email protected] (owner: ai) */
/** [email protected] (owner: ai) */
/**
/**
* ai.run.queued v1 (OpenVibe.AI server/runs.js create). PLANNED: AI does not publish run events yet (its manifest notes list ai.run.queued|succeeded|failed|cached once the Events client is wired in); this is the shape it is to send. A run was stored queued (it then runs inline within ?wait or on the worker). Not published for a cache hit (ai.run.cached) or a create refused by quota or a full queue. A projection of ai.run@1 without input or output (ADR-015: request metadata, never raw prompts). requester is the token principal that created the run (service, app or mod). Envelope: subject { type: run, id: <run_id> }, visibility internal, priority low, actor service:ai.
* ai.run.queued v1 (OpenVibe.AI server/runs.js create). PLANNED: AI does not publish run events yet (its manifest notes list ai.run.queued|succeeded|failed|cached once the Events client is wired in); this is the shape it is to send. A run was stored queued (it then runs inline within ?wait or on the worker). Not published for a cache hit (ai.run.cached) or a create refused by quota or a full queue. A projection of ai.run@1 without input or output (ADR-015: request metadata, never raw prompts). requester is the token principal that created the run (service, app or mod). Envelope: subject { type: run, id: <run_id> }, visibility internal, priority low, actor service:ai.
@@ -276743,6 +276826,116 @@ export type ReportMetric = {
@@ -276743,6 +276826,116 @@ export type ReportMetric = {
[k: string]: unknown | undefined;
[k: string]: unknown | undefined;
};
};
+/** [email protected] (owner: report) */
+/**
+ * report.ai-usage-open-result@1: the open AI meter (plan L40/L41). What the whole network spends on AI, in public: the tokens, the share of them that came from a provider cache, the share that the own keys of people paid, and the spend by week. No person, no site and no key is in it: the rows are summed before they are answered.
+ */
+export interface ReportAiUsageOpenResult {
+ /**
+ * The AI calls behind these numbers.
+ */
+ calls: number;
+ tokens: {
+ /**
+ * The uncached input tokens.
+ */
+ input: number;
+ output: number;
+ cache_read: number;
+ cache_write: number;
+ };
+ /**
+ * The share of the prompt tokens that came from a provider cache.
+ */
+ cache_share: number;
+ cache_saved_usd: number;
+ /**
+ * The share of the tokens that the own keys of people paid.
+ */
+ own_key_share: number;
+ own_key_calls: number;
+ list_cost_usd: number;
+ charged_usd: number;
+ fee_usd: number;
+ spend_by_week: {
+ /**
+ * The Monday of the week.
+ */
+ week: string;
+ calls: number;
+ list_cost_usd: number;
+ charged_usd: number;
+ cache_saved_usd: number;
+ }[];
+}
+
+/** [email protected] (owner: report) */
+/**
+ * report.ai-usage-result@1: the AI meter in groups (plan L40/L41). GET /api/v1/ai/usage needs a service token with report.ai_usage.read; the rows are grouped by day, site, model, system or paid_by. A group that fewer than ten people share reads fewer than 10 instead of counting them.
+ */
+export interface ReportAiUsageResult {
+ group: "day" | "site" | "model" | "system" | "paid_by";
+ usage: {
+ group: "day" | "site" | "model" | "system" | "paid_by";
+ /**
+ * The name of the group: the day, the site, the model, the system or the payer.
+ */
+ key: string;
+ calls: number;
+ people: number | "fewer than 10";
+ input: number;
+ output: number;
+ reasoning: number;
+ cache_read: number;
+ cache_write: number;
+ images?: number;
+ audio_seconds?: number;
+ video_seconds?: number;
+ list_cost_usd: number;
+ charged_usd: number;
+ fee_usd: number;
+ cache_saved_usd: number;
+ }[];
+ totals: {
+ calls: number;
+ input: number;
+ output: number;
+ reasoning: number;
+ cache_read: number;
+ cache_write: number;
+ images?: number;
+ audio_seconds?: number;
+ video_seconds?: number;
+ list_cost_usd: number;
+ charged_usd: number;
+ fee_usd: number;
+ cache_saved_usd: number;
+ };
+}
+
+/** [email protected] (owner: report) */
+/**
+ * report.ai-usage-me-result@1: the AI usage of one person (plan L40/L41). GET /api/v1/me/ai/usage answers for the person themselves and nobody else: their rows, grouped by day, site, model, system or paid_by. The route answers 501 until Report has sign-in: the shape is fixed here first, so the route does not have to change when it opens.
+ */
+export interface ReportAiUsageMeResult {
+ group: "day" | "site" | "model" | "system" | "paid_by";
+ usage: {
+ group: "day" | "site" | "model" | "system" | "paid_by";
+ key: string;
+ calls: number;
+ input: number;
+ output: number;
+ reasoning: number;
+ cache_read: number;
+ cache_write: number;
+ list_cost_usd: number;
+ charged_usd: number;
+ fee_usd: number;
+ cache_saved_usd: number;
+ }[];
+ totals: {};
+}
+
/** [email protected] (owner: bench) */
/** [email protected] (owner: bench) */
/**
/**
* bench.benchmark@1: a versioned, forkable benchmark on OpenVibe.Bench (spec 2026-10-30, stage B1). It holds the tasks, the judges, how they combine into one score, the limits a run may not pass, the default model and harness matrix, and the visibility of the set. A version is immutable once a run names it; a fork records its parent. Holdout tasks are hidden from everyone but the executor.
* bench.benchmark@1: a versioned, forkable benchmark on OpenVibe.Bench (spec 2026-10-30, stage B1). It holds the tasks, the judges, how they combine into one score, the limits a run may not pass, the default model and harness matrix, and the visibility of the set. A version is immutable once a run names it; a fork records its parent. Holdout tasks are hidden from everyone but the executor.
new file mode 100644
new file mode 100644
@@ -0,0 +1,21 @@
@@ -0,0 +1,21 @@
+{
+ "id": "report.ai_usage.read",
+ "version": "1.0",
+ "owner": "report",
+ "status": "active",
+ "visibility": "internal",
+ "description": "Read the AI meter across the network: the usage records and their roll-ups, in groups (day, site, model, system, paid_by). The public totals (GET /api/v1/ai/usage/open) need no token at all.",
+ "permissions": [
+ "report:read"
+ ],
+ "resourceConstraints": [
+ "none"
+ ],
+ "quotaClass": "report-read",
+ "events": [],
+ "implementedBy": [
+ "GET /api/v1/ai/usage"
+ ],
+ "inputSchema": "common.no-body@1",
+ "outputSchema": "report.ai-usage-result@1"
+}
@@ -35,6 +35,7 @@
@@ -35,6 +35,7 @@
"ai.me.manage"
"ai.me.manage"
],
],
"eventsProduced": [
"eventsProduced": [
+ "ai.call.recorded",
"ai.run.queued",
"ai.run.queued",
"ai.run.succeeded",
"ai.run.succeeded",
"ai.run.failed",
"ai.run.failed",
@@ -15,9 +15,13 @@
@@ -15,9 +15,13 @@
"state": "live",
"state": "live",
"publicSite": "service"
"publicSite": "service"
},
},
- "capabilities": [],
+ "capabilities": [
+ "report.ai_usage.read"
+ ],
"eventsProduced": [],
"eventsProduced": [],
- "eventsConsumed": [],
+ "eventsConsumed": [
+ "ai.call.recorded"
+ ],
"namespacesOwned": [
"namespacesOwned": [
"report.*"
"report.*"
],
],
@@ -1,12 +1,12 @@
@@ -1,12 +1,12 @@
{
{
"name": "openvibe-contracts",
"name": "openvibe-contracts",
- "version": "0.259.0",
+ "version": "0.260.0",
"lockfileVersion": 3,
"lockfileVersion": 3,
"requires": true,
"requires": true,
"packages": {
"packages": {
"": {
"": {
"name": "openvibe-contracts",
"name": "openvibe-contracts",
- "version": "0.259.0",
+ "version": "0.260.0",
"license": "AGPL-3.0-only",
"license": "AGPL-3.0-only",
"dependencies": {
"dependencies": {
"ajv": "^8.17.1",
"ajv": "^8.17.1",
@@ -1,6 +1,6 @@
@@ -1,6 +1,6 @@
{
{
"name": "openvibe-contracts",
"name": "openvibe-contracts",
- "version": "0.259.0",
+ "version": "0.260.0",
"description": "Machine-readable contracts for the OpenVibe network: schemas, manifests, ids, error envelope, capability checks.",
"description": "Machine-readable contracts for the OpenVibe network: schemas, manifests, ids, error envelope, capability checks.",
"main": "index.js",
"main": "index.js",
"types": "generated/typescript/index.d.ts",
"types": "generated/typescript/index.d.ts",