openvibers/openvibe.contracts Commits
Agent Streams S3: report.session@1, its write request and the report.session.write capability (0.300.0) (#310)
Changes
@@@ -1,5 +1,12 @@# Changelog++## 0.300.0 — 2026-11-06++++- Add `report.session@1`: the report of one agent session, whatever ran it — a Codes task, an Actor task, a desk session or a session on a person's own machine (the Agent Streams plan, S3). It carries the id (`rps_<ULID>`), the owner (`usr_…`), the source (`codes`, `actor`, `desk` or `node`), the task (title ≤ 200 characters, the task's ref and its link back), the start and end, the worked seconds, the outcome (`done`, `stopped` or `failed`, with `stopped_because` in plain words when it did not finish), the summary (≤ 600 characters), the timeline (the steps, the same shape as `live.agent-stream-step@1`), the outputs (`pr`, `file`, `page`, `deploy`, `clip` or `vod`), the proof (the tests, the screenshots' media ids and the review's verdict), the cost and the models, up to five highlights, the agent stream it streamed on and the visibility (`private`, `unlisted` or `public`). The raw transcript, secrets and code are never in a report: the source service keeps the transcript for the owner, the house redactor runs over every text field before anything is stored, and a pull request is a link (its content shows only when the repository is public).++- Add `report.session-write-request@1` and `report.session-write-result@1`: the body of `POST /internal/session-reports` on OpenVibe.Report and what it answers. The route is idempotent per (source, task ref): the same session's task always answers the same report. The report's id is Report's own; the body never carries one. The write request's `stream_only` says a stream-only report (Live's, when no tool finished the session).++- Add the capability `report.session.write` (first-party) and name it in Report's service manifest. The caller is a first-party service — Codes, Actor or Live — with a service token that holds it for the audience `openvibe.report`.++- Valid and invalid fixtures cover the report, the write request and the write result, so a missing owner, an id that is not `rps_…`, an outcome outside the list or a URL that is not a Report page fails the run.++## 0.299.0 — 2026-11-06- Add `live.agent-stream-step@1`: one step of the work an agent is doing on an agent stream (the Agent Streams plan, S2). It carries `at` (when the step began), `title` (at most 120 characters), `status` (`started`, `passed`, `failed` or `skipped`), the optional `detail` (at most 500 characters), the optional `tests` (`passed` and `failed`) and the optional `cost_usd`. The step is plain text: the house text filters have already run over it before Live stores it.@@@ -9474,6 +9474,33 @@"visibility": "first-party","compatibility": "backward","status": "active"++ },++ {++ "id": "report.session",++ "version": "1.0.0",++ "owner": "report",++ "schema": "report/session.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "report.session-write-request",++ "version": "1.0.0",++ "owner": "report",++ "schema": "report/session-write-request.v1.json",++ "visibility": "first-party",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "report.session-write-result",++ "version": "1.0.0",++ "owner": "report",++ "schema": "report/session-write-result.v1.json",++ "visibility": "first-party",++ "compatibility": "backward",++ "status": "active"}]}nnew file mode 100644@@@ -0,0 +1,334 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/report/session-write-request.v1.json",++ "title": "ReportSessionWriteRequest",++ "description": "report.session-write-request@1 (the Agent Streams plan, S3): the body of POST /internal/session-reports on OpenVibe.Report (capability report.session.write). The caller is a first-party service - Codes, Actor or Live - holding that capability for the audience openvibe.report; the body names the person the session was theirs. The route is idempotent per (SOURCE, TASK.REF): a repeat of the same session's task answers the report already stored, with created false. The report's id is Report's own (rps_<ULID>); the body never carries one. Every text field passes the house redactor before anything is stored, so no secret and no raw transcript is ever stored.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "owner",++ "source",++ "task",++ "started_at",++ "ended_at",++ "worked_seconds",++ "outcome",++ "summary"++ ],++ "properties": {++ "owner": {++ "type": "string",++ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The person the session was theirs."++ },++ "source": {++ "enum": [++ "codes",++ "actor",++ "desk",++ "node"++ ]++ },++ "task": {++ "$ref": "#/$defs/task"++ },++ "started_at": {++ "type": "string",++ "format": "date-time"++ },++ "ended_at": {++ "type": "string",++ "format": "date-time"++ },++ "worked_seconds": {++ "type": "integer",++ "minimum": 0++ },++ "outcome": {++ "enum": [++ "done",++ "stopped",++ "failed"++ ]++ },++ "stopped_because": {++ "type": "string",++ "minLength": 1,++ "maxLength": 300++ },++ "summary": {++ "type": "string",++ "minLength": 1,++ "maxLength": 600++ },++ "timeline": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/step"++ }++ },++ "outputs": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/output"++ }++ },++ "proof": {++ "$ref": "#/$defs/proof"++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ },++ "models": {++ "type": "array",++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ }++ },++ "highlights": {++ "type": "array",++ "maxItems": 5,++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ }++ },++ "stream": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "ags_id"++ ],++ "properties": {++ "ags_id": {++ "type": "string",++ "pattern": "^ags_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ "vod_id": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 120++ }++ }++ },++ "visibility": {++ "enum": [++ "private",++ "unlisted",++ "public"++ ],++ "description": "Who may see it. Absent means private."++ },++ "stream_only": {++ "type": "boolean",++ "description": "Live's stream-only report: the session is the stream itself and no tool will finish it. Absent or false means a normal session report."++ }++ },++ "$defs": {++ "task": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "title",++ "ref"++ ],++ "properties": {++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "ref": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "url": {++ "type": [++ "string",++ "null"++ ],++ "format": "uri"++ }++ }++ },++ "step": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "at",++ "title",++ "status"++ ],++ "properties": {++ "at": {++ "type": "string",++ "format": "date-time"++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ },++ "status": {++ "enum": [++ "started",++ "passed",++ "failed",++ "skipped"++ ]++ },++ "detail": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 500++ },++ "tests": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "passed",++ "failed"++ ],++ "properties": {++ "passed": {++ "type": "integer",++ "minimum": 0++ },++ "failed": {++ "type": "integer",++ "minimum": 0++ }++ }++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ }++ }++ },++ "output": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "kind",++ "title"++ ],++ "properties": {++ "kind": {++ "enum": [++ "pr",++ "file",++ "page",++ "deploy",++ "clip",++ "vod"++ ]++ },++ "url": {++ "type": [++ "string",++ "null"++ ],++ "format": "uri"++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "state": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 60++ }++ }++ },++ "proof": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "tests",++ "screenshots",++ "review"++ ],++ "properties": {++ "tests": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "passed",++ "failed"++ ],++ "properties": {++ "passed": {++ "type": "integer",++ "minimum": 0++ },++ "failed": {++ "type": "integer",++ "minimum": 0++ }++ }++ },++ "screenshots": {++ "type": "array",++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ }++ },++ "review": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "verdict"++ ],++ "properties": {++ "verdict": {++ "type": "string",++ "minLength": 1,++ "maxLength": 40++ },++ "notes": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 2000++ }++ }++ }++ }++ }++ }++}nnew file mode 100644@@@ -0,0 +1,28 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/report/session-write-result.v1.json",++ "title": "ReportSessionWriteResult",++ "description": "report.session-write-result@1: what POST /internal/session-reports on OpenVibe.Report answers. ID is the report's id, URL its page (openvibe.report/s/<id>) and CREATED says whether this call stored the report or found the one it had already stored (the route is idempotent per source and task ref).",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "url",++ "created"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^rps_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ "url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://openvibe\\.report/s/"++ },++ "created": {++ "type": "boolean",++ "description": "True when this call stored the report, false when it was already there."++ }++ }++}nnew file mode 100644@@@ -0,0 +1,363 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/report/session.v1.json",++ "title": "ReportSession",++ "description": "report.session@1 (the Agent Streams plan, S3): the report of one agent session, whatever ran it - a Codes task, an Actor task, a desk session or a session on a person's own machine. OWNER is the person it belongs to, SOURCE where the work ran and TASK the task it is about, with a link back to it. TIMELINE holds the steps as they happened (the same shape as live.agent-stream-step@1). OUTPUTS are what came out (a pull request, files, pages, a deploy, a clip, the VOD). PROOF is Codes' finished-task proof: the tests, the screenshots and the review. COST_USD and MODELS say what it cost and which models ran. HIGHLIGHTS are up to five one-line moments. STREAM is the agent stream it streamed on, when it did. VISIBILITY is who may see it: private (the default), unlisted (anyone with the link) or public. NEVER IN A REPORT: the raw transcript (the source service keeps it for the owner, privately), secrets (the house redactor runs over every text field before anything is stored) and code or diffs (a link to the pull request is fine; its content shows only when the repository is public).",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "owner",++ "source",++ "task",++ "started_at",++ "ended_at",++ "worked_seconds",++ "outcome",++ "summary",++ "timeline",++ "outputs",++ "proof",++ "cost_usd",++ "models",++ "highlights",++ "stream",++ "visibility"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^rps_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The report's id (ULID, Crockford base32)."++ },++ "owner": {++ "type": "string",++ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The person the session was theirs."++ },++ "source": {++ "enum": [++ "codes",++ "actor",++ "desk",++ "node"++ ],++ "description": "Where the session ran."++ },++ "task": {++ "$ref": "#/$defs/task"++ },++ "started_at": {++ "type": "string",++ "format": "date-time"++ },++ "ended_at": {++ "type": "string",++ "format": "date-time"++ },++ "worked_seconds": {++ "type": "integer",++ "minimum": 0,++ "description": "How long the agent worked (the page's 'worked 42 min')."++ },++ "outcome": {++ "enum": [++ "done",++ "stopped",++ "failed"++ ],++ "description": "How the session ended. A session that did not finish says why in stopped_because."++ },++ "stopped_because": {++ "type": "string",++ "minLength": 1,++ "maxLength": 300,++ "description": "Why it stopped, in plain words. Present when the outcome is not done."++ },++ "summary": {++ "type": "string",++ "minLength": 1,++ "maxLength": 600,++ "description": "What was asked and what happened, in plain words."++ },++ "timeline": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/step"++ },++ "description": "The steps, in the order they happened."++ },++ "outputs": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/output"++ }++ },++ "proof": {++ "$ref": "#/$defs/proof"++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0,++ "description": "What the session cost, in dollars."++ },++ "models": {++ "type": "array",++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ },++ "description": "Which models ran."++ },++ "highlights": {++ "type": "array",++ "maxItems": 5,++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "description": "Up to five one-line moments."++ },++ "stream": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "ags_id"++ ],++ "properties": {++ "ags_id": {++ "type": "string",++ "pattern": "^ags_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ "vod_id": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 120++ }++ },++ "description": "The agent stream the session streamed on, when it did."++ },++ "visibility": {++ "enum": [++ "private",++ "unlisted",++ "public"++ ]++ }++ },++ "$defs": {++ "task": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "title",++ "ref"++ ],++ "properties": {++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200,++ "description": "What the task was, in the person's own words."++ },++ "ref": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200,++ "description": "The task's id in its source."++ },++ "url": {++ "type": [++ "string",++ "null"++ ],++ "format": "uri",++ "description": "The task's page, when it has one."++ }++ }++ },++ "step": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "at",++ "title",++ "status"++ ],++ "properties": {++ "at": {++ "type": "string",++ "format": "date-time",++ "description": "When the step began."++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ },++ "status": {++ "enum": [++ "started",++ "passed",++ "failed",++ "skipped"++ ],++ "description": "The same statuses as live.agent-stream-step@1."++ },++ "detail": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 500++ },++ "tests": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "passed",++ "failed"++ ],++ "properties": {++ "passed": {++ "type": "integer",++ "minimum": 0++ },++ "failed": {++ "type": "integer",++ "minimum": 0++ }++ }++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ }++ }++ },++ "output": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "kind",++ "title"++ ],++ "properties": {++ "kind": {++ "enum": [++ "pr",++ "file",++ "page",++ "deploy",++ "clip",++ "vod"++ ],++ "description": "What came out."++ },++ "url": {++ "type": [++ "string",++ "null"++ ],++ "format": "uri"++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "state": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 60,++ "description": "A pull request's state ('open', 'merged'), when the source knows it."++ }++ }++ },++ "proof": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "tests",++ "screenshots",++ "review"++ ],++ "properties": {++ "tests": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "passed",++ "failed"++ ],++ "properties": {++ "passed": {++ "type": "integer",++ "minimum": 0++ },++ "failed": {++ "type": "integer",++ "minimum": 0++ }++ },++ "description": "The finished-task tests (Codes' proof)."++ },++ "screenshots": {++ "type": "array",++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "description": "The screenshots' media ids."++ },++ "review": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "verdict"++ ],++ "properties": {++ "verdict": {++ "type": "string",++ "minLength": 1,++ "maxLength": 40++ },++ "notes": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 2000++ }++ },++ "description": "The second opinion, in one line, with its notes folded."++ }++ }++ }++ }++}nnew file mode 100644@@@ -0,0 +1,9 @@++{++ "source": "codes",++ "task": { "title": "Ship the checkout page", "ref": "tsk_1" },++ "started_at": "2026-11-06T18:00:00.000Z",++ "ended_at": "2026-11-06T18:42:00.000Z",++ "worked_seconds": 2520,++ "outcome": "done",++ "summary": "Asked for a checkout page."++}nnew file mode 100644@@@ -0,0 +1,29 @@++{++ "owner": "usr_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "source": "codes",++ "task": {++ "title": "Ship the checkout page",++ "ref": "tsk_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "url": "https://openvibe.codes/t/tsk_01JAN2C3D4E5F6G7H8J9K0MNPS"++ },++ "started_at": "2026-11-06T18:00:00.000Z",++ "ended_at": "2026-11-06T18:42:00.000Z",++ "worked_seconds": 2520,++ "outcome": "done",++ "summary": "Asked for a checkout page; the agent built it, ran the tests and opened a pull request.",++ "timeline": [++ { "at": "2026-11-06T18:20:00.000Z", "title": "Run the checkout tests", "status": "passed", "tests": { "passed": 12, "failed": 0 } }++ ],++ "outputs": [++ { "kind": "pr", "url": "https://forgejo.example/openvibe/site/pulls/7", "title": "Checkout page", "state": "open" }++ ],++ "proof": {++ "tests": { "passed": 12, "failed": 0 },++ "screenshots": ["med_01JAN2C3D4E5F6G7H8J9K0MNPS"],++ "review": { "verdict": "Looks good", "notes": null }++ },++ "cost_usd": 0.31,++ "models": ["claude-sonnet-4"],++ "highlights": ["Found the coupon bug on the first read"],++ "visibility": "private"++}nnew file mode 100644@@@ -0,0 +1,5 @@++{++ "id": "rps_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "url": "https://openvibe.example/s/rps_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "created": true++}nnew file mode 100644@@@ -0,0 +1,5 @@++{++ "id": "rps_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "url": "https://openvibe.report/s/rps_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "created": true++}nnew file mode 100644@@@ -0,0 +1,19 @@++{++ "id": "session_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "owner": "usr_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "source": "codes",++ "task": { "title": "Ship the checkout page", "ref": "tsk_1" },++ "started_at": "2026-11-06T18:00:00.000Z",++ "ended_at": "2026-11-06T18:42:00.000Z",++ "worked_seconds": 2520,++ "outcome": "done",++ "summary": "Asked for a checkout page.",++ "timeline": [],++ "outputs": [],++ "proof": { "tests": { "passed": 1, "failed": 0 }, "screenshots": [], "review": null },++ "cost_usd": 0.31,++ "models": [],++ "highlights": [],++ "stream": null,++ "visibility": "unlisted"++}nnew file mode 100644@@@ -0,0 +1,19 @@++{++ "id": "rps_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "owner": "usr_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "source": "codes",++ "task": { "title": "Ship the checkout page", "ref": "tsk_1" },++ "started_at": "2026-11-06T18:00:00.000Z",++ "ended_at": "2026-11-06T18:42:00.000Z",++ "worked_seconds": 2520,++ "outcome": "finished",++ "summary": "Asked for a checkout page.",++ "timeline": [],++ "outputs": [],++ "proof": { "tests": { "passed": 1, "failed": 0 }, "screenshots": [], "review": null },++ "cost_usd": 0.31,++ "models": [],++ "highlights": [],++ "stream": null,++ "visibility": "unlisted"++}nnew file mode 100644@@@ -0,0 +1,37 @@++{++ "id": "rps_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "owner": "usr_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "source": "codes",++ "task": {++ "title": "Ship the checkout page",++ "ref": "tsk_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "url": "https://openvibe.codes/t/tsk_01JAN2C3D4E5F6G7H8J9K0MNPS"++ },++ "started_at": "2026-11-06T18:00:00.000Z",++ "ended_at": "2026-11-06T18:42:00.000Z",++ "worked_seconds": 2520,++ "outcome": "done",++ "summary": "Asked for a checkout page; the agent built it, ran the tests and opened a pull request.",++ "timeline": [++ { "at": "2026-11-06T18:01:00.000Z", "title": "Read the checkout code", "status": "passed" },++ { "at": "2026-11-06T18:20:00.000Z", "title": "Run the checkout tests", "status": "passed", "tests": { "passed": 12, "failed": 0 } }++ ],++ "outputs": [++ { "kind": "pr", "url": "https://forgejo.example/openvibe/site/pulls/7", "title": "Checkout page", "state": "open" }++ ],++ "proof": {++ "tests": { "passed": 12, "failed": 0 },++ "screenshots": ["med_01JAN2C3D4E5F6G7H8J9K0MNPS"],++ "review": { "verdict": "Looks good", "notes": "The mobile layout needs a wider gutter." }++ },++ "cost_usd": 0.31,++ "models": ["claude-sonnet-4"],++ "highlights": [++ "Found the coupon bug on the first read"++ ],++ "stream": {++ "ags_id": "ags_01JAN2C3D4E5F6G7H8J9K0MNPS",++ "vod_id": "vod_01JAN2C3D4E5F6G7H8J9K0MNPS"++ },++ "visibility": "unlisted"++}@@@ -103909,6 +103909,746 @@}}}++ },++ "report.session": {++ "version": "1.0.0",++ "owner": "report",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/report/session.v1.json",++ "title": "ReportSession",++ "description": "report.session@1 (the Agent Streams plan, S3): the report of one agent session, whatever ran it - a Codes task, an Actor task, a desk session or a session on a person's own machine. OWNER is the person it belongs to, SOURCE where the work ran and TASK the task it is about, with a link back to it. TIMELINE holds the steps as they happened (the same shape as live.agent-stream-step@1). OUTPUTS are what came out (a pull request, files, pages, a deploy, a clip, the VOD). PROOF is Codes' finished-task proof: the tests, the screenshots and the review. COST_USD and MODELS say what it cost and which models ran. HIGHLIGHTS are up to five one-line moments. STREAM is the agent stream it streamed on, when it did. VISIBILITY is who may see it: private (the default), unlisted (anyone with the link) or public. NEVER IN A REPORT: the raw transcript (the source service keeps it for the owner, privately), secrets (the house redactor runs over every text field before anything is stored) and code or diffs (a link to the pull request is fine; its content shows only when the repository is public).",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "owner",++ "source",++ "task",++ "started_at",++ "ended_at",++ "worked_seconds",++ "outcome",++ "summary",++ "timeline",++ "outputs",++ "proof",++ "cost_usd",++ "models",++ "highlights",++ "stream",++ "visibility"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^rps_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The report's id (ULID, Crockford base32)."++ },++ "owner": {++ "type": "string",++ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The person the session was theirs."++ },++ "source": {++ "enum": [++ "codes",++ "actor",++ "desk",++ "node"++ ],++ "description": "Where the session ran."++ },++ "task": {++ "$ref": "#/$defs/task"++ },++ "started_at": {++ "type": "string",++ "format": "date-time"++ },++ "ended_at": {++ "type": "string",++ "format": "date-time"++ },++ "worked_seconds": {++ "type": "integer",++ "minimum": 0,++ "description": "How long the agent worked (the page's 'worked 42 min')."++ },++ "outcome": {++ "enum": [++ "done",++ "stopped",++ "failed"++ ],++ "description": "How the session ended. A session that did not finish says why in stopped_because."++ },++ "stopped_because": {++ "type": "string",++ "minLength": 1,++ "maxLength": 300,++ "description": "Why it stopped, in plain words. Present when the outcome is not done."++ },++ "summary": {++ "type": "string",++ "minLength": 1,++ "maxLength": 600,++ "description": "What was asked and what happened, in plain words."++ },++ "timeline": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/step"++ },++ "description": "The steps, in the order they happened."++ },++ "outputs": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/output"++ }++ },++ "proof": {++ "$ref": "#/$defs/proof"++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0,++ "description": "What the session cost, in dollars."++ },++ "models": {++ "type": "array",++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ },++ "description": "Which models ran."++ },++ "highlights": {++ "type": "array",++ "maxItems": 5,++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "description": "Up to five one-line moments."++ },++ "stream": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "ags_id"++ ],++ "properties": {++ "ags_id": {++ "type": "string",++ "pattern": "^ags_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ "vod_id": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 120++ }++ },++ "description": "The agent stream the session streamed on, when it did."++ },++ "visibility": {++ "enum": [++ "private",++ "unlisted",++ "public"++ ]++ }++ },++ "$defs": {++ "task": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "title",++ "ref"++ ],++ "properties": {++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200,++ "description": "What the task was, in the person's own words."++ },++ "ref": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200,++ "description": "The task's id in its source."++ },++ "url": {++ "type": [++ "string",++ "null"++ ],++ "format": "uri",++ "description": "The task's page, when it has one."++ }++ }++ },++ "step": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "at",++ "title",++ "status"++ ],++ "properties": {++ "at": {++ "type": "string",++ "format": "date-time",++ "description": "When the step began."++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ },++ "status": {++ "enum": [++ "started",++ "passed",++ "failed",++ "skipped"++ ],++ "description": "The same statuses as live.agent-stream-step@1."++ },++ "detail": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 500++ },++ "tests": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "passed",++ "failed"++ ],++ "properties": {++ "passed": {++ "type": "integer",++ "minimum": 0++ },++ "failed": {++ "type": "integer",++ "minimum": 0++ }++ }++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ }++ }++ },++ "output": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "kind",++ "title"++ ],++ "properties": {++ "kind": {++ "enum": [++ "pr",++ "file",++ "page",++ "deploy",++ "clip",++ "vod"++ ],++ "description": "What came out."++ },++ "url": {++ "type": [++ "string",++ "null"++ ],++ "format": "uri"++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "state": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 60,++ "description": "A pull request's state ('open', 'merged'), when the source knows it."++ }++ }++ },++ "proof": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "tests",++ "screenshots",++ "review"++ ],++ "properties": {++ "tests": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "passed",++ "failed"++ ],++ "properties": {++ "passed": {++ "type": "integer",++ "minimum": 0++ },++ "failed": {++ "type": "integer",++ "minimum": 0++ }++ },++ "description": "The finished-task tests (Codes' proof)."++ },++ "screenshots": {++ "type": "array",++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "description": "The screenshots' media ids."++ },++ "review": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "verdict"++ ],++ "properties": {++ "verdict": {++ "type": "string",++ "minLength": 1,++ "maxLength": 40++ },++ "notes": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 2000++ }++ },++ "description": "The second opinion, in one line, with its notes folded."++ }++ }++ }++ }++ }++ },++ "report.session-write-request": {++ "version": "1.0.0",++ "owner": "report",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/report/session-write-request.v1.json",++ "title": "ReportSessionWriteRequest",++ "description": "report.session-write-request@1 (the Agent Streams plan, S3): the body of POST /internal/session-reports on OpenVibe.Report (capability report.session.write). The caller is a first-party service - Codes, Actor or Live - holding that capability for the audience openvibe.report; the body names the person the session was theirs. The route is idempotent per (SOURCE, TASK.REF): a repeat of the same session's task answers the report already stored, with created false. The report's id is Report's own (rps_<ULID>); the body never carries one. Every text field passes the house redactor before anything is stored, so no secret and no raw transcript is ever stored.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "owner",++ "source",++ "task",++ "started_at",++ "ended_at",++ "worked_seconds",++ "outcome",++ "summary"++ ],++ "properties": {++ "owner": {++ "type": "string",++ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The person the session was theirs."++ },++ "source": {++ "enum": [++ "codes",++ "actor",++ "desk",++ "node"++ ]++ },++ "task": {++ "$ref": "#/$defs/task"++ },++ "started_at": {++ "type": "string",++ "format": "date-time"++ },++ "ended_at": {++ "type": "string",++ "format": "date-time"++ },++ "worked_seconds": {++ "type": "integer",++ "minimum": 0++ },++ "outcome": {++ "enum": [++ "done",++ "stopped",++ "failed"++ ]++ },++ "stopped_because": {++ "type": "string",++ "minLength": 1,++ "maxLength": 300++ },++ "summary": {++ "type": "string",++ "minLength": 1,++ "maxLength": 600++ },++ "timeline": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/step"++ }++ },++ "outputs": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/output"++ }++ },++ "proof": {++ "$ref": "#/$defs/proof"++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ },++ "models": {++ "type": "array",++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ }++ },++ "highlights": {++ "type": "array",++ "maxItems": 5,++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ }++ },++ "stream": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "ags_id"++ ],++ "properties": {++ "ags_id": {++ "type": "string",++ "pattern": "^ags_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ "vod_id": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 120++ }++ }++ },++ "visibility": {++ "enum": [++ "private",++ "unlisted",++ "public"++ ],++ "description": "Who may see it. Absent means private."++ },++ "stream_only": {++ "type": "boolean",++ "description": "Live's stream-only report: the session is the stream itself and no tool will finish it. Absent or false means a normal session report."++ }++ },++ "$defs": {++ "task": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "title",++ "ref"++ ],++ "properties": {++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "ref": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "url": {++ "type": [++ "string",++ "null"++ ],++ "format": "uri"++ }++ }++ },++ "step": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "at",++ "title",++ "status"++ ],++ "properties": {++ "at": {++ "type": "string",++ "format": "date-time"++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ },++ "status": {++ "enum": [++ "started",++ "passed",++ "failed",++ "skipped"++ ]++ },++ "detail": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 500++ },++ "tests": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "passed",++ "failed"++ ],++ "properties": {++ "passed": {++ "type": "integer",++ "minimum": 0++ },++ "failed": {++ "type": "integer",++ "minimum": 0++ }++ }++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ }++ }++ },++ "output": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "kind",++ "title"++ ],++ "properties": {++ "kind": {++ "enum": [++ "pr",++ "file",++ "page",++ "deploy",++ "clip",++ "vod"++ ]++ },++ "url": {++ "type": [++ "string",++ "null"++ ],++ "format": "uri"++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "state": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 60++ }++ }++ },++ "proof": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "tests",++ "screenshots",++ "review"++ ],++ "properties": {++ "tests": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "passed",++ "failed"++ ],++ "properties": {++ "passed": {++ "type": "integer",++ "minimum": 0++ },++ "failed": {++ "type": "integer",++ "minimum": 0++ }++ }++ },++ "screenshots": {++ "type": "array",++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ }++ },++ "review": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "verdict"++ ],++ "properties": {++ "verdict": {++ "type": "string",++ "minLength": 1,++ "maxLength": 40++ },++ "notes": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 2000++ }++ }++ }++ }++ }++ }++ }++ },++ "report.session-write-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/session-write-result.v1.json",++ "title": "ReportSessionWriteResult",++ "description": "report.session-write-result@1: what POST /internal/session-reports on OpenVibe.Report answers. ID is the report's id, URL its page (openvibe.report/s/<id>) and CREATED says whether this call stored the report or found the one it had already stored (the route is idempotent per source and task ref).",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "url",++ "created"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^rps_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ "url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://openvibe\\.report/s/"++ },++ "created": {++ "type": "boolean",++ "description": "True when this call stored the report, false when it was already there."++ }++ }++ }}}}@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Actor API",-- "version": "0.299.0",-- "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.300.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"@@@ -180,8 +180,8 @@"service": "report","name": "OpenVibe.Report","origin": "https://openvibe.report",-- "operations": 6,-- "capabilities": 2++ "operations": 7,++ "capabilities": 3},{"service": "reviews",@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Inventory API",-- "version": "0.299.0",-- "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.Report API",-- "version": "0.299.0",-- "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.300.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"@@@ -542,6 +542,62 @@}}}++ },++ "/internal/session-reports": {++ "post": {++ "operationId": "post_internal_session_reports",++ "summary": "Write one agent session's report on OpenVibe.Report (the Agent Streams plan, S3).",++ "description": "**report.session.write** (first-party): Write one agent session's report on OpenVibe.Report (the Agent Streams plan, S3). POST /internal/session-reports stores the report of a Codes task, an Actor task, a desk session or a session on a person's own machine, and answers the report's page. The route is idempotent per (source, task ref): the same session's task always answers the same report. The caller is a first-party service - Codes, Actor or Live - with a service token that holds this capability for the audience openvibe.report; Network grants it to exactly those principals. The body names the person the session was theirs, and a service may only write a report for the person it acts for. Every text field passes the house redactor before anything is stored: the raw transcript and secrets never reach the report.",++ "tags": [++ "report.session"++ ],++ "x-openvibe-capabilities": [++ "report.session.write"++ ],++ "x-openvibe-visibility": [++ "first-party"++ ],++ "x-openvibe-quota-class": "standard",++ "security": [++ {++ "openvibeToken": [++ "report.session.write"++ ]++ }++ ],++ "requestBody": {++ "required": false,++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/report.session-write-request.v1"++ }++ }++ }++ },++ "responses": {++ "2XX": {++ "description": "Success",++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/report.session-write-result.v1"++ }++ }++ }++ },++ "default": {++ "description": "An error (RFC 9457 problem details)",++ "content": {++ "application/problem+json": {++ "schema": {++ "$ref": "#/components/schemas/errors.problem.v1"++ }++ }++ }++ }++ }++ }}},"components": {@@@ -1352,6 +1408,364 @@}}}++ },++ "report.session-write-request.v1": {++ "title": "ReportSessionWriteRequest",++ "description": "report.session-write-request@1 (the Agent Streams plan, S3): the body of POST /internal/session-reports on OpenVibe.Report (capability report.session.write). The caller is a first-party service - Codes, Actor or Live - holding that capability for the audience openvibe.report; the body names the person the session was theirs. The route is idempotent per (SOURCE, TASK.REF): a repeat of the same session's task answers the report already stored, with created false. The report's id is Report's own (rps_<ULID>); the body never carries one. Every text field passes the house redactor before anything is stored, so no secret and no raw transcript is ever stored.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "owner",++ "source",++ "task",++ "started_at",++ "ended_at",++ "worked_seconds",++ "outcome",++ "summary"++ ],++ "properties": {++ "owner": {++ "type": "string",++ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The person the session was theirs."++ },++ "source": {++ "enum": [++ "codes",++ "actor",++ "desk",++ "node"++ ]++ },++ "task": {++ "$ref": "#/components/schemas/report.session-write-request.v1/$defs/task"++ },++ "started_at": {++ "type": "string",++ "format": "date-time"++ },++ "ended_at": {++ "type": "string",++ "format": "date-time"++ },++ "worked_seconds": {++ "type": "integer",++ "minimum": 0++ },++ "outcome": {++ "enum": [++ "done",++ "stopped",++ "failed"++ ]++ },++ "stopped_because": {++ "type": "string",++ "minLength": 1,++ "maxLength": 300++ },++ "summary": {++ "type": "string",++ "minLength": 1,++ "maxLength": 600++ },++ "timeline": {++ "type": "array",++ "items": {++ "$ref": "#/components/schemas/report.session-write-request.v1/$defs/step"++ }++ },++ "outputs": {++ "type": "array",++ "items": {++ "$ref": "#/components/schemas/report.session-write-request.v1/$defs/output"++ }++ },++ "proof": {++ "$ref": "#/components/schemas/report.session-write-request.v1/$defs/proof"++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ },++ "models": {++ "type": "array",++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ }++ },++ "highlights": {++ "type": "array",++ "maxItems": 5,++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ }++ },++ "stream": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "ags_id"++ ],++ "properties": {++ "ags_id": {++ "type": "string",++ "pattern": "^ags_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ "vod_id": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 120++ }++ }++ },++ "visibility": {++ "enum": [++ "private",++ "unlisted",++ "public"++ ],++ "description": "Who may see it. Absent means private."++ },++ "stream_only": {++ "type": "boolean",++ "description": "Live's stream-only report: the session is the stream itself and no tool will finish it. Absent or false means a normal session report."++ }++ },++ "$defs": {++ "task": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "title",++ "ref"++ ],++ "properties": {++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "ref": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "url": {++ "type": [++ "string",++ "null"++ ],++ "format": "uri"++ }++ }++ },++ "step": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "at",++ "title",++ "status"++ ],++ "properties": {++ "at": {++ "type": "string",++ "format": "date-time"++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ },++ "status": {++ "enum": [++ "started",++ "passed",++ "failed",++ "skipped"++ ]++ },++ "detail": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 500++ },++ "tests": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "passed",++ "failed"++ ],++ "properties": {++ "passed": {++ "type": "integer",++ "minimum": 0++ },++ "failed": {++ "type": "integer",++ "minimum": 0++ }++ }++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ }++ }++ },++ "output": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "kind",++ "title"++ ],++ "properties": {++ "kind": {++ "enum": [++ "pr",++ "file",++ "page",++ "deploy",++ "clip",++ "vod"++ ]++ },++ "url": {++ "type": [++ "string",++ "null"++ ],++ "format": "uri"++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "state": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 60++ }++ }++ },++ "proof": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "tests",++ "screenshots",++ "review"++ ],++ "properties": {++ "tests": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "passed",++ "failed"++ ],++ "properties": {++ "passed": {++ "type": "integer",++ "minimum": 0++ },++ "failed": {++ "type": "integer",++ "minimum": 0++ }++ }++ },++ "screenshots": {++ "type": "array",++ "items": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ }++ },++ "review": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "verdict"++ ],++ "properties": {++ "verdict": {++ "type": "string",++ "minLength": 1,++ "maxLength": 40++ },++ "notes": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 2000++ }++ }++ }++ }++ }++ }++ },++ "report.session-write-result.v1": {++ "title": "ReportSessionWriteResult",++ "description": "report.session-write-result@1: what POST /internal/session-reports on OpenVibe.Report answers. ID is the report's id, URL its page (openvibe.report/s/<id>) and CREATED says whether this call stored the report or found the one it had already stored (the route is idempotent per source and task ref).",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "url",++ "created"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^rps_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ "url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://openvibe\\.report/s/"++ },++ "created": {++ "type": "boolean",++ "description": "True when this call stored the report, false when it was already there."++ }++ }}},"securitySchemes": {@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Reviews API",-- "version": "0.299.0",-- "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.Today API",-- "version": "0.299.0",-- "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",-- "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",++ "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.300.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"@@@ -292454,3 +292454,222 @@ export interface LiveAgentStreamChangedPayload {};at: string;}++++/** [email protected] (owner: report) */++/**++ * report.session@1 (the Agent Streams plan, S3): the report of one agent session, whatever ran it - a Codes task, an Actor task, a desk session or a session on a person's own machine. OWNER is the person it belongs to, SOURCE where the work ran and TASK the task it is about, with a link back to it. TIMELINE holds the steps as they happened (the same shape as live.agent-stream-step@1). OUTPUTS are what came out (a pull request, files, pages, a deploy, a clip, the VOD). PROOF is Codes' finished-task proof: the tests, the screenshots and the review. COST_USD and MODELS say what it cost and which models ran. HIGHLIGHTS are up to five one-line moments. STREAM is the agent stream it streamed on, when it did. VISIBILITY is who may see it: private (the default), unlisted (anyone with the link) or public. NEVER IN A REPORT: the raw transcript (the source service keeps it for the owner, privately), secrets (the house redactor runs over every text field before anything is stored) and code or diffs (a link to the pull request is fine; its content shows only when the repository is public).++ */++export interface ReportSession {++ /**++ * The report's id (ULID, Crockford base32).++ */++ id: string;++ /**++ * The person the session was theirs.++ */++ owner: string;++ /**++ * Where the session ran.++ */++ source: "codes" | "actor" | "desk" | "node";++ task: {++ /**++ * What the task was, in the person's own words.++ */++ title: string;++ /**++ * The task's id in its source.++ */++ ref: string;++ /**++ * The task's page, when it has one.++ */++ url?: string | null;++ };++ started_at: string;++ ended_at: string;++ /**++ * How long the agent worked (the page's 'worked 42 min').++ */++ worked_seconds: number;++ /**++ * How the session ended. A session that did not finish says why in stopped_because.++ */++ outcome: "done" | "stopped" | "failed";++ /**++ * Why it stopped, in plain words. Present when the outcome is not done.++ */++ stopped_because?: string;++ /**++ * What was asked and what happened, in plain words.++ */++ summary: string;++ /**++ * The steps, in the order they happened.++ */++ timeline: {++ /**++ * When the step began.++ */++ at: string;++ title: string;++ /**++ * The same statuses as live.agent-stream-step@1.++ */++ status: "started" | "passed" | "failed" | "skipped";++ detail?: string | null;++ tests?: {++ passed: number;++ failed: number;++ } | null;++ cost_usd?: number | null;++ }[];++ outputs: {++ /**++ * What came out.++ */++ kind: "pr" | "file" | "page" | "deploy" | "clip" | "vod";++ url?: string | null;++ title: string;++ /**++ * A pull request's state ('open', 'merged'), when the source knows it.++ */++ state?: string | null;++ }[];++ proof: {++ /**++ * The finished-task tests (Codes' proof).++ */++ tests: {++ passed: number;++ failed: number;++ } | null;++ /**++ * The screenshots' media ids.++ */++ screenshots: string[];++ /**++ * The second opinion, in one line, with its notes folded.++ */++ review: {++ verdict: string;++ notes?: string | null;++ } | null;++ };++ /**++ * What the session cost, in dollars.++ */++ cost_usd: number | null;++ /**++ * Which models ran.++ */++ models: string[];++ /**++ * Up to five one-line moments.++ *++ * @maxItems 5++ */++ highlights:++ | []++ | [string]++ | [string, string]++ | [string, string, string]++ | [string, string, string, string]++ | [string, string, string, string, string];++ /**++ * The agent stream the session streamed on, when it did.++ */++ stream: {++ ags_id: string;++ vod_id?: string | null;++ } | null;++ visibility: "private" | "unlisted" | "public";++}++++/** [email protected] (owner: report) */++/**++ * report.session-write-request@1 (the Agent Streams plan, S3): the body of POST /internal/session-reports on OpenVibe.Report (capability report.session.write). The caller is a first-party service - Codes, Actor or Live - holding that capability for the audience openvibe.report; the body names the person the session was theirs. The route is idempotent per (SOURCE, TASK.REF): a repeat of the same session's task answers the report already stored, with created false. The report's id is Report's own (rps_<ULID>); the body never carries one. Every text field passes the house redactor before anything is stored, so no secret and no raw transcript is ever stored.++ */++export interface ReportSessionWriteRequest {++ /**++ * The person the session was theirs.++ */++ owner: string;++ source: "codes" | "actor" | "desk" | "node";++ task: {++ title: string;++ ref: string;++ url?: string | null;++ };++ started_at: string;++ ended_at: string;++ worked_seconds: number;++ outcome: "done" | "stopped" | "failed";++ stopped_because?: string;++ summary: string;++ timeline?: {++ at: string;++ title: string;++ status: "started" | "passed" | "failed" | "skipped";++ detail?: string | null;++ tests?: {++ passed: number;++ failed: number;++ } | null;++ cost_usd?: number | null;++ }[];++ outputs?: {++ kind: "pr" | "file" | "page" | "deploy" | "clip" | "vod";++ url?: string | null;++ title: string;++ state?: string | null;++ }[];++ proof?: {++ tests: {++ passed: number;++ failed: number;++ } | null;++ screenshots: string[];++ review: {++ verdict: string;++ notes?: string | null;++ } | null;++ };++ cost_usd?: number | null;++ models?: string[];++ /**++ * @maxItems 5++ */++ highlights?:++ | []++ | [string]++ | [string, string]++ | [string, string, string]++ | [string, string, string, string]++ | [string, string, string, string, string];++ stream?: {++ ags_id: string;++ vod_id?: string | null;++ } | null;++ /**++ * Who may see it. Absent means private.++ */++ visibility?: "private" | "unlisted" | "public";++ /**++ * Live's stream-only report: the session is the stream itself and no tool will finish it. Absent or false means a normal session report.++ */++ stream_only?: boolean;++}++++/** [email protected] (owner: report) */++/**++ * report.session-write-result@1: what POST /internal/session-reports on OpenVibe.Report answers. ID is the report's id, URL its page (openvibe.report/s/<id>) and CREATED says whether this call stored the report or found the one it had already stored (the route is idempotent per source and task ref).++ */++export interface ReportSessionWriteResult {++ id: string;++ url: string;++ /**++ * True when this call stored the report, false when it was already there.++ */++ created: boolean;++}nnew file mode 100644@@@ -0,0 +1,22 @@++{++ "id": "report.session.write",++ "version": "1.0",++ "owner": "report",++ "status": "active",++ "visibility": "first-party",++ "description": "Write one agent session's report on OpenVibe.Report (the Agent Streams plan, S3). POST /internal/session-reports stores the report of a Codes task, an Actor task, a desk session or a session on a person's own machine, and answers the report's page. The route is idempotent per (source, task ref): the same session's task always answers the same report. The caller is a first-party service - Codes, Actor or Live - with a service token that holds this capability for the audience openvibe.report; Network grants it to exactly those principals. The body names the person the session was theirs, and a service may only write a report for the person it acts for. Every text field passes the house redactor before anything is stored: the raw transcript and secrets never reach the report.",++ "inputSchema": "report.session-write-request@1",++ "outputSchema": "report.session-write-result@1",++ "permissions": [++ "report:write"++ ],++ "resourceConstraints": [++ "owner"++ ],++ "quotaClass": "standard",++ "events": [],++ "implementedBy": [++ "POST /internal/session-reports"++ ],++ "sensitive": true++}@@@ -17,7 +17,8 @@},"capabilities": ["report.ai_usage.read",-- "report.config.manage"++ "report.config.manage",++ "report.session.write"],"eventsProduced": ["report.index_document.deleted",@@@ -1,6 +1,6 @@{"name": "openvibe-contracts",-- "version": "0.299.0",++ "version": "0.300.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,5 +1,12 @@
@@ -1,5 +1,12 @@
# Changelog
# Changelog
+## 0.300.0 — 2026-11-06
+
+- Add `report.session@1`: the report of one agent session, whatever ran it — a Codes task, an Actor task, a desk session or a session on a person's own machine (the Agent Streams plan, S3). It carries the id (`rps_<ULID>`), the owner (`usr_…`), the source (`codes`, `actor`, `desk` or `node`), the task (title ≤ 200 characters, the task's ref and its link back), the start and end, the worked seconds, the outcome (`done`, `stopped` or `failed`, with `stopped_because` in plain words when it did not finish), the summary (≤ 600 characters), the timeline (the steps, the same shape as `live.agent-stream-step@1`), the outputs (`pr`, `file`, `page`, `deploy`, `clip` or `vod`), the proof (the tests, the screenshots' media ids and the review's verdict), the cost and the models, up to five highlights, the agent stream it streamed on and the visibility (`private`, `unlisted` or `public`). The raw transcript, secrets and code are never in a report: the source service keeps the transcript for the owner, the house redactor runs over every text field before anything is stored, and a pull request is a link (its content shows only when the repository is public).
+- Add `report.session-write-request@1` and `report.session-write-result@1`: the body of `POST /internal/session-reports` on OpenVibe.Report and what it answers. The route is idempotent per (source, task ref): the same session's task always answers the same report. The report's id is Report's own; the body never carries one. The write request's `stream_only` says a stream-only report (Live's, when no tool finished the session).
+- Add the capability `report.session.write` (first-party) and name it in Report's service manifest. The caller is a first-party service — Codes, Actor or Live — with a service token that holds it for the audience `openvibe.report`.
+- Valid and invalid fixtures cover the report, the write request and the write result, so a missing owner, an id that is not `rps_…`, an outcome outside the list or a URL that is not a Report page fails the run.
+
## 0.299.0 — 2026-11-06
## 0.299.0 — 2026-11-06
- Add `live.agent-stream-step@1`: one step of the work an agent is doing on an agent stream (the Agent Streams plan, S2). It carries `at` (when the step began), `title` (at most 120 characters), `status` (`started`, `passed`, `failed` or `skipped`), the optional `detail` (at most 500 characters), the optional `tests` (`passed` and `failed`) and the optional `cost_usd`. The step is plain text: the house text filters have already run over it before Live stores it.
- Add `live.agent-stream-step@1`: one step of the work an agent is doing on an agent stream (the Agent Streams plan, S2). It carries `at` (when the step began), `title` (at most 120 characters), `status` (`started`, `passed`, `failed` or `skipped`), the optional `detail` (at most 500 characters), the optional `tests` (`passed` and `failed`) and the optional `cost_usd`. The step is plain text: the house text filters have already run over it before Live stores it.
@@ -9474,6 +9474,33 @@
@@ -9474,6 +9474,33 @@
"visibility": "first-party",
"visibility": "first-party",
"compatibility": "backward",
"compatibility": "backward",
"status": "active"
"status": "active"
+ },
+ {
+ "id": "report.session",
+ "version": "1.0.0",
+ "owner": "report",
+ "schema": "report/session.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "report.session-write-request",
+ "version": "1.0.0",
+ "owner": "report",
+ "schema": "report/session-write-request.v1.json",
+ "visibility": "first-party",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "report.session-write-result",
+ "version": "1.0.0",
+ "owner": "report",
+ "schema": "report/session-write-result.v1.json",
+ "visibility": "first-party",
+ "compatibility": "backward",
+ "status": "active"
}
}
]
]
}
}
new file mode 100644
new file mode 100644
@@ -0,0 +1,334 @@
@@ -0,0 +1,334 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/report/session-write-request.v1.json",
+ "title": "ReportSessionWriteRequest",
+ "description": "report.session-write-request@1 (the Agent Streams plan, S3): the body of POST /internal/session-reports on OpenVibe.Report (capability report.session.write). The caller is a first-party service - Codes, Actor or Live - holding that capability for the audience openvibe.report; the body names the person the session was theirs. The route is idempotent per (SOURCE, TASK.REF): a repeat of the same session's task answers the report already stored, with created false. The report's id is Report's own (rps_<ULID>); the body never carries one. Every text field passes the house redactor before anything is stored, so no secret and no raw transcript is ever stored.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "owner",
+ "source",
+ "task",
+ "started_at",
+ "ended_at",
+ "worked_seconds",
+ "outcome",
+ "summary"
+ ],
+ "properties": {
+ "owner": {
+ "type": "string",
+ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The person the session was theirs."
+ },
+ "source": {
+ "enum": [
+ "codes",
+ "actor",
+ "desk",
+ "node"
+ ]
+ },
+ "task": {
+ "$ref": "#/$defs/task"
+ },
+ "started_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "ended_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "worked_seconds": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "outcome": {
+ "enum": [
+ "done",
+ "stopped",
+ "failed"
+ ]
+ },
+ "stopped_because": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 300
+ },
+ "summary": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 600
+ },
+ "timeline": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/step"
+ }
+ },
+ "outputs": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/output"
+ }
+ },
+ "proof": {
+ "$ref": "#/$defs/proof"
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "models": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ }
+ },
+ "highlights": {
+ "type": "array",
+ "maxItems": 5,
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ }
+ },
+ "stream": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "ags_id"
+ ],
+ "properties": {
+ "ags_id": {
+ "type": "string",
+ "pattern": "^ags_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ "vod_id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 120
+ }
+ }
+ },
+ "visibility": {
+ "enum": [
+ "private",
+ "unlisted",
+ "public"
+ ],
+ "description": "Who may see it. Absent means private."
+ },
+ "stream_only": {
+ "type": "boolean",
+ "description": "Live's stream-only report: the session is the stream itself and no tool will finish it. Absent or false means a normal session report."
+ }
+ },
+ "$defs": {
+ "task": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "title",
+ "ref"
+ ],
+ "properties": {
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "ref": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "uri"
+ }
+ }
+ },
+ "step": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "at",
+ "title",
+ "status"
+ ],
+ "properties": {
+ "at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ },
+ "status": {
+ "enum": [
+ "started",
+ "passed",
+ "failed",
+ "skipped"
+ ]
+ },
+ "detail": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 500
+ },
+ "tests": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "passed",
+ "failed"
+ ],
+ "properties": {
+ "passed": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "failed": {
+ "type": "integer",
+ "minimum": 0
+ }
+ }
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ }
+ }
+ },
+ "output": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "kind",
+ "title"
+ ],
+ "properties": {
+ "kind": {
+ "enum": [
+ "pr",
+ "file",
+ "page",
+ "deploy",
+ "clip",
+ "vod"
+ ]
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "uri"
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "state": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 60
+ }
+ }
+ },
+ "proof": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "tests",
+ "screenshots",
+ "review"
+ ],
+ "properties": {
+ "tests": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "passed",
+ "failed"
+ ],
+ "properties": {
+ "passed": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "failed": {
+ "type": "integer",
+ "minimum": 0
+ }
+ }
+ },
+ "screenshots": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ }
+ },
+ "review": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "verdict"
+ ],
+ "properties": {
+ "verdict": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 40
+ },
+ "notes": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 2000
+ }
+ }
+ }
+ }
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,28 @@
@@ -0,0 +1,28 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/report/session-write-result.v1.json",
+ "title": "ReportSessionWriteResult",
+ "description": "report.session-write-result@1: what POST /internal/session-reports on OpenVibe.Report answers. ID is the report's id, URL its page (openvibe.report/s/<id>) and CREATED says whether this call stored the report or found the one it had already stored (the route is idempotent per source and task ref).",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "url",
+ "created"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^rps_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://openvibe\\.report/s/"
+ },
+ "created": {
+ "type": "boolean",
+ "description": "True when this call stored the report, false when it was already there."
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,363 @@
@@ -0,0 +1,363 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/report/session.v1.json",
+ "title": "ReportSession",
+ "description": "report.session@1 (the Agent Streams plan, S3): the report of one agent session, whatever ran it - a Codes task, an Actor task, a desk session or a session on a person's own machine. OWNER is the person it belongs to, SOURCE where the work ran and TASK the task it is about, with a link back to it. TIMELINE holds the steps as they happened (the same shape as live.agent-stream-step@1). OUTPUTS are what came out (a pull request, files, pages, a deploy, a clip, the VOD). PROOF is Codes' finished-task proof: the tests, the screenshots and the review. COST_USD and MODELS say what it cost and which models ran. HIGHLIGHTS are up to five one-line moments. STREAM is the agent stream it streamed on, when it did. VISIBILITY is who may see it: private (the default), unlisted (anyone with the link) or public. NEVER IN A REPORT: the raw transcript (the source service keeps it for the owner, privately), secrets (the house redactor runs over every text field before anything is stored) and code or diffs (a link to the pull request is fine; its content shows only when the repository is public).",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "owner",
+ "source",
+ "task",
+ "started_at",
+ "ended_at",
+ "worked_seconds",
+ "outcome",
+ "summary",
+ "timeline",
+ "outputs",
+ "proof",
+ "cost_usd",
+ "models",
+ "highlights",
+ "stream",
+ "visibility"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^rps_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The report's id (ULID, Crockford base32)."
+ },
+ "owner": {
+ "type": "string",
+ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The person the session was theirs."
+ },
+ "source": {
+ "enum": [
+ "codes",
+ "actor",
+ "desk",
+ "node"
+ ],
+ "description": "Where the session ran."
+ },
+ "task": {
+ "$ref": "#/$defs/task"
+ },
+ "started_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "ended_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "worked_seconds": {
+ "type": "integer",
+ "minimum": 0,
+ "description": "How long the agent worked (the page's 'worked 42 min')."
+ },
+ "outcome": {
+ "enum": [
+ "done",
+ "stopped",
+ "failed"
+ ],
+ "description": "How the session ended. A session that did not finish says why in stopped_because."
+ },
+ "stopped_because": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 300,
+ "description": "Why it stopped, in plain words. Present when the outcome is not done."
+ },
+ "summary": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 600,
+ "description": "What was asked and what happened, in plain words."
+ },
+ "timeline": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/step"
+ },
+ "description": "The steps, in the order they happened."
+ },
+ "outputs": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/output"
+ }
+ },
+ "proof": {
+ "$ref": "#/$defs/proof"
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0,
+ "description": "What the session cost, in dollars."
+ },
+ "models": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ },
+ "description": "Which models ran."
+ },
+ "highlights": {
+ "type": "array",
+ "maxItems": 5,
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "description": "Up to five one-line moments."
+ },
+ "stream": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "ags_id"
+ ],
+ "properties": {
+ "ags_id": {
+ "type": "string",
+ "pattern": "^ags_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ "vod_id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 120
+ }
+ },
+ "description": "The agent stream the session streamed on, when it did."
+ },
+ "visibility": {
+ "enum": [
+ "private",
+ "unlisted",
+ "public"
+ ]
+ }
+ },
+ "$defs": {
+ "task": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "title",
+ "ref"
+ ],
+ "properties": {
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200,
+ "description": "What the task was, in the person's own words."
+ },
+ "ref": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200,
+ "description": "The task's id in its source."
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "uri",
+ "description": "The task's page, when it has one."
+ }
+ }
+ },
+ "step": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "at",
+ "title",
+ "status"
+ ],
+ "properties": {
+ "at": {
+ "type": "string",
+ "format": "date-time",
+ "description": "When the step began."
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ },
+ "status": {
+ "enum": [
+ "started",
+ "passed",
+ "failed",
+ "skipped"
+ ],
+ "description": "The same statuses as live.agent-stream-step@1."
+ },
+ "detail": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 500
+ },
+ "tests": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "passed",
+ "failed"
+ ],
+ "properties": {
+ "passed": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "failed": {
+ "type": "integer",
+ "minimum": 0
+ }
+ }
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ }
+ }
+ },
+ "output": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "kind",
+ "title"
+ ],
+ "properties": {
+ "kind": {
+ "enum": [
+ "pr",
+ "file",
+ "page",
+ "deploy",
+ "clip",
+ "vod"
+ ],
+ "description": "What came out."
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "uri"
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "state": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 60,
+ "description": "A pull request's state ('open', 'merged'), when the source knows it."
+ }
+ }
+ },
+ "proof": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "tests",
+ "screenshots",
+ "review"
+ ],
+ "properties": {
+ "tests": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "passed",
+ "failed"
+ ],
+ "properties": {
+ "passed": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "failed": {
+ "type": "integer",
+ "minimum": 0
+ }
+ },
+ "description": "The finished-task tests (Codes' proof)."
+ },
+ "screenshots": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "description": "The screenshots' media ids."
+ },
+ "review": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "verdict"
+ ],
+ "properties": {
+ "verdict": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 40
+ },
+ "notes": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 2000
+ }
+ },
+ "description": "The second opinion, in one line, with its notes folded."
+ }
+ }
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,9 @@
@@ -0,0 +1,9 @@
+{
+ "source": "codes",
+ "task": { "title": "Ship the checkout page", "ref": "tsk_1" },
+ "started_at": "2026-11-06T18:00:00.000Z",
+ "ended_at": "2026-11-06T18:42:00.000Z",
+ "worked_seconds": 2520,
+ "outcome": "done",
+ "summary": "Asked for a checkout page."
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,29 @@
@@ -0,0 +1,29 @@
+{
+ "owner": "usr_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "source": "codes",
+ "task": {
+ "title": "Ship the checkout page",
+ "ref": "tsk_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "url": "https://openvibe.codes/t/tsk_01JAN2C3D4E5F6G7H8J9K0MNPS"
+ },
+ "started_at": "2026-11-06T18:00:00.000Z",
+ "ended_at": "2026-11-06T18:42:00.000Z",
+ "worked_seconds": 2520,
+ "outcome": "done",
+ "summary": "Asked for a checkout page; the agent built it, ran the tests and opened a pull request.",
+ "timeline": [
+ { "at": "2026-11-06T18:20:00.000Z", "title": "Run the checkout tests", "status": "passed", "tests": { "passed": 12, "failed": 0 } }
+ ],
+ "outputs": [
+ { "kind": "pr", "url": "https://forgejo.example/openvibe/site/pulls/7", "title": "Checkout page", "state": "open" }
+ ],
+ "proof": {
+ "tests": { "passed": 12, "failed": 0 },
+ "screenshots": ["med_01JAN2C3D4E5F6G7H8J9K0MNPS"],
+ "review": { "verdict": "Looks good", "notes": null }
+ },
+ "cost_usd": 0.31,
+ "models": ["claude-sonnet-4"],
+ "highlights": ["Found the coupon bug on the first read"],
+ "visibility": "private"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,5 @@
@@ -0,0 +1,5 @@
+{
+ "id": "rps_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "url": "https://openvibe.example/s/rps_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "created": true
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,5 @@
@@ -0,0 +1,5 @@
+{
+ "id": "rps_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "url": "https://openvibe.report/s/rps_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "created": true
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,19 @@
@@ -0,0 +1,19 @@
+{
+ "id": "session_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "owner": "usr_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "source": "codes",
+ "task": { "title": "Ship the checkout page", "ref": "tsk_1" },
+ "started_at": "2026-11-06T18:00:00.000Z",
+ "ended_at": "2026-11-06T18:42:00.000Z",
+ "worked_seconds": 2520,
+ "outcome": "done",
+ "summary": "Asked for a checkout page.",
+ "timeline": [],
+ "outputs": [],
+ "proof": { "tests": { "passed": 1, "failed": 0 }, "screenshots": [], "review": null },
+ "cost_usd": 0.31,
+ "models": [],
+ "highlights": [],
+ "stream": null,
+ "visibility": "unlisted"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,19 @@
@@ -0,0 +1,19 @@
+{
+ "id": "rps_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "owner": "usr_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "source": "codes",
+ "task": { "title": "Ship the checkout page", "ref": "tsk_1" },
+ "started_at": "2026-11-06T18:00:00.000Z",
+ "ended_at": "2026-11-06T18:42:00.000Z",
+ "worked_seconds": 2520,
+ "outcome": "finished",
+ "summary": "Asked for a checkout page.",
+ "timeline": [],
+ "outputs": [],
+ "proof": { "tests": { "passed": 1, "failed": 0 }, "screenshots": [], "review": null },
+ "cost_usd": 0.31,
+ "models": [],
+ "highlights": [],
+ "stream": null,
+ "visibility": "unlisted"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,37 @@
@@ -0,0 +1,37 @@
+{
+ "id": "rps_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "owner": "usr_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "source": "codes",
+ "task": {
+ "title": "Ship the checkout page",
+ "ref": "tsk_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "url": "https://openvibe.codes/t/tsk_01JAN2C3D4E5F6G7H8J9K0MNPS"
+ },
+ "started_at": "2026-11-06T18:00:00.000Z",
+ "ended_at": "2026-11-06T18:42:00.000Z",
+ "worked_seconds": 2520,
+ "outcome": "done",
+ "summary": "Asked for a checkout page; the agent built it, ran the tests and opened a pull request.",
+ "timeline": [
+ { "at": "2026-11-06T18:01:00.000Z", "title": "Read the checkout code", "status": "passed" },
+ { "at": "2026-11-06T18:20:00.000Z", "title": "Run the checkout tests", "status": "passed", "tests": { "passed": 12, "failed": 0 } }
+ ],
+ "outputs": [
+ { "kind": "pr", "url": "https://forgejo.example/openvibe/site/pulls/7", "title": "Checkout page", "state": "open" }
+ ],
+ "proof": {
+ "tests": { "passed": 12, "failed": 0 },
+ "screenshots": ["med_01JAN2C3D4E5F6G7H8J9K0MNPS"],
+ "review": { "verdict": "Looks good", "notes": "The mobile layout needs a wider gutter." }
+ },
+ "cost_usd": 0.31,
+ "models": ["claude-sonnet-4"],
+ "highlights": [
+ "Found the coupon bug on the first read"
+ ],
+ "stream": {
+ "ags_id": "ags_01JAN2C3D4E5F6G7H8J9K0MNPS",
+ "vod_id": "vod_01JAN2C3D4E5F6G7H8J9K0MNPS"
+ },
+ "visibility": "unlisted"
+}
@@ -103909,6 +103909,746 @@
@@ -103909,6 +103909,746 @@
}
}
}
}
}
}
+ },
+ "report.session": {
+ "version": "1.0.0",
+ "owner": "report",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/report/session.v1.json",
+ "title": "ReportSession",
+ "description": "report.session@1 (the Agent Streams plan, S3): the report of one agent session, whatever ran it - a Codes task, an Actor task, a desk session or a session on a person's own machine. OWNER is the person it belongs to, SOURCE where the work ran and TASK the task it is about, with a link back to it. TIMELINE holds the steps as they happened (the same shape as live.agent-stream-step@1). OUTPUTS are what came out (a pull request, files, pages, a deploy, a clip, the VOD). PROOF is Codes' finished-task proof: the tests, the screenshots and the review. COST_USD and MODELS say what it cost and which models ran. HIGHLIGHTS are up to five one-line moments. STREAM is the agent stream it streamed on, when it did. VISIBILITY is who may see it: private (the default), unlisted (anyone with the link) or public. NEVER IN A REPORT: the raw transcript (the source service keeps it for the owner, privately), secrets (the house redactor runs over every text field before anything is stored) and code or diffs (a link to the pull request is fine; its content shows only when the repository is public).",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "owner",
+ "source",
+ "task",
+ "started_at",
+ "ended_at",
+ "worked_seconds",
+ "outcome",
+ "summary",
+ "timeline",
+ "outputs",
+ "proof",
+ "cost_usd",
+ "models",
+ "highlights",
+ "stream",
+ "visibility"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^rps_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The report's id (ULID, Crockford base32)."
+ },
+ "owner": {
+ "type": "string",
+ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The person the session was theirs."
+ },
+ "source": {
+ "enum": [
+ "codes",
+ "actor",
+ "desk",
+ "node"
+ ],
+ "description": "Where the session ran."
+ },
+ "task": {
+ "$ref": "#/$defs/task"
+ },
+ "started_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "ended_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "worked_seconds": {
+ "type": "integer",
+ "minimum": 0,
+ "description": "How long the agent worked (the page's 'worked 42 min')."
+ },
+ "outcome": {
+ "enum": [
+ "done",
+ "stopped",
+ "failed"
+ ],
+ "description": "How the session ended. A session that did not finish says why in stopped_because."
+ },
+ "stopped_because": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 300,
+ "description": "Why it stopped, in plain words. Present when the outcome is not done."
+ },
+ "summary": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 600,
+ "description": "What was asked and what happened, in plain words."
+ },
+ "timeline": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/step"
+ },
+ "description": "The steps, in the order they happened."
+ },
+ "outputs": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/output"
+ }
+ },
+ "proof": {
+ "$ref": "#/$defs/proof"
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0,
+ "description": "What the session cost, in dollars."
+ },
+ "models": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ },
+ "description": "Which models ran."
+ },
+ "highlights": {
+ "type": "array",
+ "maxItems": 5,
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "description": "Up to five one-line moments."
+ },
+ "stream": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "ags_id"
+ ],
+ "properties": {
+ "ags_id": {
+ "type": "string",
+ "pattern": "^ags_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ "vod_id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 120
+ }
+ },
+ "description": "The agent stream the session streamed on, when it did."
+ },
+ "visibility": {
+ "enum": [
+ "private",
+ "unlisted",
+ "public"
+ ]
+ }
+ },
+ "$defs": {
+ "task": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "title",
+ "ref"
+ ],
+ "properties": {
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200,
+ "description": "What the task was, in the person's own words."
+ },
+ "ref": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200,
+ "description": "The task's id in its source."
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "uri",
+ "description": "The task's page, when it has one."
+ }
+ }
+ },
+ "step": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "at",
+ "title",
+ "status"
+ ],
+ "properties": {
+ "at": {
+ "type": "string",
+ "format": "date-time",
+ "description": "When the step began."
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ },
+ "status": {
+ "enum": [
+ "started",
+ "passed",
+ "failed",
+ "skipped"
+ ],
+ "description": "The same statuses as live.agent-stream-step@1."
+ },
+ "detail": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 500
+ },
+ "tests": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "passed",
+ "failed"
+ ],
+ "properties": {
+ "passed": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "failed": {
+ "type": "integer",
+ "minimum": 0
+ }
+ }
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ }
+ }
+ },
+ "output": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "kind",
+ "title"
+ ],
+ "properties": {
+ "kind": {
+ "enum": [
+ "pr",
+ "file",
+ "page",
+ "deploy",
+ "clip",
+ "vod"
+ ],
+ "description": "What came out."
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "uri"
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "state": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 60,
+ "description": "A pull request's state ('open', 'merged'), when the source knows it."
+ }
+ }
+ },
+ "proof": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "tests",
+ "screenshots",
+ "review"
+ ],
+ "properties": {
+ "tests": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "passed",
+ "failed"
+ ],
+ "properties": {
+ "passed": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "failed": {
+ "type": "integer",
+ "minimum": 0
+ }
+ },
+ "description": "The finished-task tests (Codes' proof)."
+ },
+ "screenshots": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "description": "The screenshots' media ids."
+ },
+ "review": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "verdict"
+ ],
+ "properties": {
+ "verdict": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 40
+ },
+ "notes": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 2000
+ }
+ },
+ "description": "The second opinion, in one line, with its notes folded."
+ }
+ }
+ }
+ }
+ }
+ },
+ "report.session-write-request": {
+ "version": "1.0.0",
+ "owner": "report",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/report/session-write-request.v1.json",
+ "title": "ReportSessionWriteRequest",
+ "description": "report.session-write-request@1 (the Agent Streams plan, S3): the body of POST /internal/session-reports on OpenVibe.Report (capability report.session.write). The caller is a first-party service - Codes, Actor or Live - holding that capability for the audience openvibe.report; the body names the person the session was theirs. The route is idempotent per (SOURCE, TASK.REF): a repeat of the same session's task answers the report already stored, with created false. The report's id is Report's own (rps_<ULID>); the body never carries one. Every text field passes the house redactor before anything is stored, so no secret and no raw transcript is ever stored.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "owner",
+ "source",
+ "task",
+ "started_at",
+ "ended_at",
+ "worked_seconds",
+ "outcome",
+ "summary"
+ ],
+ "properties": {
+ "owner": {
+ "type": "string",
+ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The person the session was theirs."
+ },
+ "source": {
+ "enum": [
+ "codes",
+ "actor",
+ "desk",
+ "node"
+ ]
+ },
+ "task": {
+ "$ref": "#/$defs/task"
+ },
+ "started_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "ended_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "worked_seconds": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "outcome": {
+ "enum": [
+ "done",
+ "stopped",
+ "failed"
+ ]
+ },
+ "stopped_because": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 300
+ },
+ "summary": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 600
+ },
+ "timeline": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/step"
+ }
+ },
+ "outputs": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/output"
+ }
+ },
+ "proof": {
+ "$ref": "#/$defs/proof"
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "models": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ }
+ },
+ "highlights": {
+ "type": "array",
+ "maxItems": 5,
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ }
+ },
+ "stream": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "ags_id"
+ ],
+ "properties": {
+ "ags_id": {
+ "type": "string",
+ "pattern": "^ags_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ "vod_id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 120
+ }
+ }
+ },
+ "visibility": {
+ "enum": [
+ "private",
+ "unlisted",
+ "public"
+ ],
+ "description": "Who may see it. Absent means private."
+ },
+ "stream_only": {
+ "type": "boolean",
+ "description": "Live's stream-only report: the session is the stream itself and no tool will finish it. Absent or false means a normal session report."
+ }
+ },
+ "$defs": {
+ "task": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "title",
+ "ref"
+ ],
+ "properties": {
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "ref": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "uri"
+ }
+ }
+ },
+ "step": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "at",
+ "title",
+ "status"
+ ],
+ "properties": {
+ "at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ },
+ "status": {
+ "enum": [
+ "started",
+ "passed",
+ "failed",
+ "skipped"
+ ]
+ },
+ "detail": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 500
+ },
+ "tests": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "passed",
+ "failed"
+ ],
+ "properties": {
+ "passed": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "failed": {
+ "type": "integer",
+ "minimum": 0
+ }
+ }
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ }
+ }
+ },
+ "output": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "kind",
+ "title"
+ ],
+ "properties": {
+ "kind": {
+ "enum": [
+ "pr",
+ "file",
+ "page",
+ "deploy",
+ "clip",
+ "vod"
+ ]
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "uri"
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "state": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 60
+ }
+ }
+ },
+ "proof": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "tests",
+ "screenshots",
+ "review"
+ ],
+ "properties": {
+ "tests": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "passed",
+ "failed"
+ ],
+ "properties": {
+ "passed": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "failed": {
+ "type": "integer",
+ "minimum": 0
+ }
+ }
+ },
+ "screenshots": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ }
+ },
+ "review": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "verdict"
+ ],
+ "properties": {
+ "verdict": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 40
+ },
+ "notes": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 2000
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "report.session-write-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/session-write-result.v1.json",
+ "title": "ReportSessionWriteResult",
+ "description": "report.session-write-result@1: what POST /internal/session-reports on OpenVibe.Report answers. ID is the report's id, URL its page (openvibe.report/s/<id>) and CREATED says whether this call stored the report or found the one it had already stored (the route is idempotent per source and task ref).",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "url",
+ "created"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^rps_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://openvibe\\.report/s/"
+ },
+ "created": {
+ "type": "boolean",
+ "description": "True when this call stored the report, false when it was already there."
+ }
+ }
+ }
}
}
}
}
}
}
@@ -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.299.0",
- "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.300.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"
@@ -180,8 +180,8 @@
@@ -180,8 +180,8 @@
"service": "report",
"service": "report",
"name": "OpenVibe.Report",
"name": "OpenVibe.Report",
"origin": "https://openvibe.report",
"origin": "https://openvibe.report",
- "operations": 6,
- "capabilities": 2
+ "operations": 7,
+ "capabilities": 3
},
},
{
{
"service": "reviews",
"service": "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.299.0",
- "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.Report API",
"title": "OpenVibe.Report API",
- "version": "0.299.0",
- "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.300.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"
@@ -542,6 +542,62 @@
@@ -542,6 +542,62 @@
}
}
}
}
}
}
+ },
+ "/internal/session-reports": {
+ "post": {
+ "operationId": "post_internal_session_reports",
+ "summary": "Write one agent session's report on OpenVibe.Report (the Agent Streams plan, S3).",
+ "description": "**report.session.write** (first-party): Write one agent session's report on OpenVibe.Report (the Agent Streams plan, S3). POST /internal/session-reports stores the report of a Codes task, an Actor task, a desk session or a session on a person's own machine, and answers the report's page. The route is idempotent per (source, task ref): the same session's task always answers the same report. The caller is a first-party service - Codes, Actor or Live - with a service token that holds this capability for the audience openvibe.report; Network grants it to exactly those principals. The body names the person the session was theirs, and a service may only write a report for the person it acts for. Every text field passes the house redactor before anything is stored: the raw transcript and secrets never reach the report.",
+ "tags": [
+ "report.session"
+ ],
+ "x-openvibe-capabilities": [
+ "report.session.write"
+ ],
+ "x-openvibe-visibility": [
+ "first-party"
+ ],
+ "x-openvibe-quota-class": "standard",
+ "security": [
+ {
+ "openvibeToken": [
+ "report.session.write"
+ ]
+ }
+ ],
+ "requestBody": {
+ "required": false,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/report.session-write-request.v1"
+ }
+ }
+ }
+ },
+ "responses": {
+ "2XX": {
+ "description": "Success",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/report.session-write-result.v1"
+ }
+ }
+ }
+ },
+ "default": {
+ "description": "An error (RFC 9457 problem details)",
+ "content": {
+ "application/problem+json": {
+ "schema": {
+ "$ref": "#/components/schemas/errors.problem.v1"
+ }
+ }
+ }
+ }
+ }
+ }
}
}
},
},
"components": {
"components": {
@@ -1352,6 +1408,364 @@
@@ -1352,6 +1408,364 @@
}
}
}
}
}
}
+ },
+ "report.session-write-request.v1": {
+ "title": "ReportSessionWriteRequest",
+ "description": "report.session-write-request@1 (the Agent Streams plan, S3): the body of POST /internal/session-reports on OpenVibe.Report (capability report.session.write). The caller is a first-party service - Codes, Actor or Live - holding that capability for the audience openvibe.report; the body names the person the session was theirs. The route is idempotent per (SOURCE, TASK.REF): a repeat of the same session's task answers the report already stored, with created false. The report's id is Report's own (rps_<ULID>); the body never carries one. Every text field passes the house redactor before anything is stored, so no secret and no raw transcript is ever stored.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "owner",
+ "source",
+ "task",
+ "started_at",
+ "ended_at",
+ "worked_seconds",
+ "outcome",
+ "summary"
+ ],
+ "properties": {
+ "owner": {
+ "type": "string",
+ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The person the session was theirs."
+ },
+ "source": {
+ "enum": [
+ "codes",
+ "actor",
+ "desk",
+ "node"
+ ]
+ },
+ "task": {
+ "$ref": "#/components/schemas/report.session-write-request.v1/$defs/task"
+ },
+ "started_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "ended_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "worked_seconds": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "outcome": {
+ "enum": [
+ "done",
+ "stopped",
+ "failed"
+ ]
+ },
+ "stopped_because": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 300
+ },
+ "summary": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 600
+ },
+ "timeline": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/report.session-write-request.v1/$defs/step"
+ }
+ },
+ "outputs": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/report.session-write-request.v1/$defs/output"
+ }
+ },
+ "proof": {
+ "$ref": "#/components/schemas/report.session-write-request.v1/$defs/proof"
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "models": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ }
+ },
+ "highlights": {
+ "type": "array",
+ "maxItems": 5,
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ }
+ },
+ "stream": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "ags_id"
+ ],
+ "properties": {
+ "ags_id": {
+ "type": "string",
+ "pattern": "^ags_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ "vod_id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 120
+ }
+ }
+ },
+ "visibility": {
+ "enum": [
+ "private",
+ "unlisted",
+ "public"
+ ],
+ "description": "Who may see it. Absent means private."
+ },
+ "stream_only": {
+ "type": "boolean",
+ "description": "Live's stream-only report: the session is the stream itself and no tool will finish it. Absent or false means a normal session report."
+ }
+ },
+ "$defs": {
+ "task": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "title",
+ "ref"
+ ],
+ "properties": {
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "ref": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "uri"
+ }
+ }
+ },
+ "step": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "at",
+ "title",
+ "status"
+ ],
+ "properties": {
+ "at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ },
+ "status": {
+ "enum": [
+ "started",
+ "passed",
+ "failed",
+ "skipped"
+ ]
+ },
+ "detail": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 500
+ },
+ "tests": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "passed",
+ "failed"
+ ],
+ "properties": {
+ "passed": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "failed": {
+ "type": "integer",
+ "minimum": 0
+ }
+ }
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ }
+ }
+ },
+ "output": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "kind",
+ "title"
+ ],
+ "properties": {
+ "kind": {
+ "enum": [
+ "pr",
+ "file",
+ "page",
+ "deploy",
+ "clip",
+ "vod"
+ ]
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "uri"
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "state": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 60
+ }
+ }
+ },
+ "proof": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "tests",
+ "screenshots",
+ "review"
+ ],
+ "properties": {
+ "tests": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "passed",
+ "failed"
+ ],
+ "properties": {
+ "passed": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "failed": {
+ "type": "integer",
+ "minimum": 0
+ }
+ }
+ },
+ "screenshots": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ }
+ },
+ "review": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "verdict"
+ ],
+ "properties": {
+ "verdict": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 40
+ },
+ "notes": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 2000
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "report.session-write-result.v1": {
+ "title": "ReportSessionWriteResult",
+ "description": "report.session-write-result@1: what POST /internal/session-reports on OpenVibe.Report answers. ID is the report's id, URL its page (openvibe.report/s/<id>) and CREATED says whether this call stored the report or found the one it had already stored (the route is idempotent per source and task ref).",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "url",
+ "created"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^rps_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://openvibe\\.report/s/"
+ },
+ "created": {
+ "type": "boolean",
+ "description": "True when this call stored the report, false when it was already there."
+ }
+ }
}
}
},
},
"securitySchemes": {
"securitySchemes": {
@@ -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.299.0",
- "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.Today API",
"title": "OpenVibe.Today API",
- "version": "0.299.0",
- "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.300.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.299.0",
- "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.299.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.300.0",
+ "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.300.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"
@@ -292454,3 +292454,222 @@ export interface LiveAgentStreamChangedPayload {
@@ -292454,3 +292454,222 @@ export interface LiveAgentStreamChangedPayload {
};
};
at: string;
at: string;
}
}
+
+/** [email protected] (owner: report) */
+/**
+ * report.session@1 (the Agent Streams plan, S3): the report of one agent session, whatever ran it - a Codes task, an Actor task, a desk session or a session on a person's own machine. OWNER is the person it belongs to, SOURCE where the work ran and TASK the task it is about, with a link back to it. TIMELINE holds the steps as they happened (the same shape as live.agent-stream-step@1). OUTPUTS are what came out (a pull request, files, pages, a deploy, a clip, the VOD). PROOF is Codes' finished-task proof: the tests, the screenshots and the review. COST_USD and MODELS say what it cost and which models ran. HIGHLIGHTS are up to five one-line moments. STREAM is the agent stream it streamed on, when it did. VISIBILITY is who may see it: private (the default), unlisted (anyone with the link) or public. NEVER IN A REPORT: the raw transcript (the source service keeps it for the owner, privately), secrets (the house redactor runs over every text field before anything is stored) and code or diffs (a link to the pull request is fine; its content shows only when the repository is public).
+ */
+export interface ReportSession {
+ /**
+ * The report's id (ULID, Crockford base32).
+ */
+ id: string;
+ /**
+ * The person the session was theirs.
+ */
+ owner: string;
+ /**
+ * Where the session ran.
+ */
+ source: "codes" | "actor" | "desk" | "node";
+ task: {
+ /**
+ * What the task was, in the person's own words.
+ */
+ title: string;
+ /**
+ * The task's id in its source.
+ */
+ ref: string;
+ /**
+ * The task's page, when it has one.
+ */
+ url?: string | null;
+ };
+ started_at: string;
+ ended_at: string;
+ /**
+ * How long the agent worked (the page's 'worked 42 min').
+ */
+ worked_seconds: number;
+ /**
+ * How the session ended. A session that did not finish says why in stopped_because.
+ */
+ outcome: "done" | "stopped" | "failed";
+ /**
+ * Why it stopped, in plain words. Present when the outcome is not done.
+ */
+ stopped_because?: string;
+ /**
+ * What was asked and what happened, in plain words.
+ */
+ summary: string;
+ /**
+ * The steps, in the order they happened.
+ */
+ timeline: {
+ /**
+ * When the step began.
+ */
+ at: string;
+ title: string;
+ /**
+ * The same statuses as live.agent-stream-step@1.
+ */
+ status: "started" | "passed" | "failed" | "skipped";
+ detail?: string | null;
+ tests?: {
+ passed: number;
+ failed: number;
+ } | null;
+ cost_usd?: number | null;
+ }[];
+ outputs: {
+ /**
+ * What came out.
+ */
+ kind: "pr" | "file" | "page" | "deploy" | "clip" | "vod";
+ url?: string | null;
+ title: string;
+ /**
+ * A pull request's state ('open', 'merged'), when the source knows it.
+ */
+ state?: string | null;
+ }[];
+ proof: {
+ /**
+ * The finished-task tests (Codes' proof).
+ */
+ tests: {
+ passed: number;
+ failed: number;
+ } | null;
+ /**
+ * The screenshots' media ids.
+ */
+ screenshots: string[];
+ /**
+ * The second opinion, in one line, with its notes folded.
+ */
+ review: {
+ verdict: string;
+ notes?: string | null;
+ } | null;
+ };
+ /**
+ * What the session cost, in dollars.
+ */
+ cost_usd: number | null;
+ /**
+ * Which models ran.
+ */
+ models: string[];
+ /**
+ * Up to five one-line moments.
+ *
+ * @maxItems 5
+ */
+ highlights:
+ | []
+ | [string]
+ | [string, string]
+ | [string, string, string]
+ | [string, string, string, string]
+ | [string, string, string, string, string];
+ /**
+ * The agent stream the session streamed on, when it did.
+ */
+ stream: {
+ ags_id: string;
+ vod_id?: string | null;
+ } | null;
+ visibility: "private" | "unlisted" | "public";
+}
+
+/** [email protected] (owner: report) */
+/**
+ * report.session-write-request@1 (the Agent Streams plan, S3): the body of POST /internal/session-reports on OpenVibe.Report (capability report.session.write). The caller is a first-party service - Codes, Actor or Live - holding that capability for the audience openvibe.report; the body names the person the session was theirs. The route is idempotent per (SOURCE, TASK.REF): a repeat of the same session's task answers the report already stored, with created false. The report's id is Report's own (rps_<ULID>); the body never carries one. Every text field passes the house redactor before anything is stored, so no secret and no raw transcript is ever stored.
+ */
+export interface ReportSessionWriteRequest {
+ /**
+ * The person the session was theirs.
+ */
+ owner: string;
+ source: "codes" | "actor" | "desk" | "node";
+ task: {
+ title: string;
+ ref: string;
+ url?: string | null;
+ };
+ started_at: string;
+ ended_at: string;
+ worked_seconds: number;
+ outcome: "done" | "stopped" | "failed";
+ stopped_because?: string;
+ summary: string;
+ timeline?: {
+ at: string;
+ title: string;
+ status: "started" | "passed" | "failed" | "skipped";
+ detail?: string | null;
+ tests?: {
+ passed: number;
+ failed: number;
+ } | null;
+ cost_usd?: number | null;
+ }[];
+ outputs?: {
+ kind: "pr" | "file" | "page" | "deploy" | "clip" | "vod";
+ url?: string | null;
+ title: string;
+ state?: string | null;
+ }[];
+ proof?: {
+ tests: {
+ passed: number;
+ failed: number;
+ } | null;
+ screenshots: string[];
+ review: {
+ verdict: string;
+ notes?: string | null;
+ } | null;
+ };
+ cost_usd?: number | null;
+ models?: string[];
+ /**
+ * @maxItems 5
+ */
+ highlights?:
+ | []
+ | [string]
+ | [string, string]
+ | [string, string, string]
+ | [string, string, string, string]
+ | [string, string, string, string, string];
+ stream?: {
+ ags_id: string;
+ vod_id?: string | null;
+ } | null;
+ /**
+ * Who may see it. Absent means private.
+ */
+ visibility?: "private" | "unlisted" | "public";
+ /**
+ * Live's stream-only report: the session is the stream itself and no tool will finish it. Absent or false means a normal session report.
+ */
+ stream_only?: boolean;
+}
+
+/** [email protected] (owner: report) */
+/**
+ * report.session-write-result@1: what POST /internal/session-reports on OpenVibe.Report answers. ID is the report's id, URL its page (openvibe.report/s/<id>) and CREATED says whether this call stored the report or found the one it had already stored (the route is idempotent per source and task ref).
+ */
+export interface ReportSessionWriteResult {
+ id: string;
+ url: string;
+ /**
+ * True when this call stored the report, false when it was already there.
+ */
+ created: boolean;
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,22 @@
@@ -0,0 +1,22 @@
+{
+ "id": "report.session.write",
+ "version": "1.0",
+ "owner": "report",
+ "status": "active",
+ "visibility": "first-party",
+ "description": "Write one agent session's report on OpenVibe.Report (the Agent Streams plan, S3). POST /internal/session-reports stores the report of a Codes task, an Actor task, a desk session or a session on a person's own machine, and answers the report's page. The route is idempotent per (source, task ref): the same session's task always answers the same report. The caller is a first-party service - Codes, Actor or Live - with a service token that holds this capability for the audience openvibe.report; Network grants it to exactly those principals. The body names the person the session was theirs, and a service may only write a report for the person it acts for. Every text field passes the house redactor before anything is stored: the raw transcript and secrets never reach the report.",
+ "inputSchema": "report.session-write-request@1",
+ "outputSchema": "report.session-write-result@1",
+ "permissions": [
+ "report:write"
+ ],
+ "resourceConstraints": [
+ "owner"
+ ],
+ "quotaClass": "standard",
+ "events": [],
+ "implementedBy": [
+ "POST /internal/session-reports"
+ ],
+ "sensitive": true
+}
@@ -17,7 +17,8 @@
@@ -17,7 +17,8 @@
},
},
"capabilities": [
"capabilities": [
"report.ai_usage.read",
"report.ai_usage.read",
- "report.config.manage"
+ "report.config.manage",
+ "report.session.write"
],
],
"eventsProduced": [
"eventsProduced": [
"report.index_document.deleted",
"report.index_document.deleted",
@@ -1,6 +1,6 @@
@@ -1,6 +1,6 @@
{
{
"name": "openvibe-contracts",
"name": "openvibe-contracts",
- "version": "0.299.0",
+ "version": "0.300.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",