openvibers/openvibe.contracts Commits
Contracts 0.327.0: one Computer across Surf, Actor and the Dock (#335)
Changes
@@@ -1,5 +1,14 @@# Changelog++## 0.327.0 — 2026-11-07++++- One Computer across Surf, Actor and the Dock (plan 2026-11-07: "Surf, Computer and Actor are one experience"): `platform.task@1` gains optional `computer` (`session_id`, `machine`, `where`, `cost_hint`, `driving`) — the browser or desktop session a running task opened, wherever it runs. `session_id` is OpenVibe.Run's `ses_…`; it is null only when the desk runs directly on the person's own machine through OpenVibe.Bot, where there is no Run session. `where` is `yours`, `home` or `network`, and `machine` is the person's own word for it.++- `actor.task-event@2` and `agent.timeline-entry@1` carry the same `computer` object by `$ref`: the task's step in the Dock and the task record read the same fields, never a copy.++- `run.session@1` gains optional `task_id` (the Actor task that asked for the session, so the session points back at the task) and `curtain` (the privacy screen: while it is up the session's still answers the curtain picture, never the screen). `run.session-create-request@1` gains optional `task_id`.++- The `run.session.started` and `run.session.ended` event payloads carry the same optional `task_id` and `curtain`, so a session's own events stay valid with the new session shape.++- Capabilities name the routes: `run.session.read` gains `GET /api/v1/sessions/{id}/still`, `run.session.control` gains `POST /api/v1/sessions/{id}/curtain`, `actor.task.read` gains `GET /api/v1/tasks/{id}/still`, and `actor.task.create` gains `POST /api/v1/tasks/{id}/takeover` and `…/giveback`.++- Additive only: every new field is optional and nothing that exists today changes shape.++## 0.326.0 — 2026-11-07- Add `network.menu-feeds@1`: the cards a person chose to show in the OpenVibe menu's "Choose your feeds", in their order, following them across every site. `on` holds up to four `<site>:<cardId>` ids (lower-case letters, digits and dashes) and `updated_at` says when the choice last changed. OpenVibe.Network keeps it at `GET` and `PUT /api/v1/me/menu-feeds`; a person who has never chosen gets `{ on: null }` from the GET. An empty array is a cleared choice.@@@ -73,6 +73,9 @@"is_error": {"type": "boolean"},++ "computer": {++ "$ref": "../platform/task.v1.json#/$defs/computer"++ },"artifacts": {"type": "array","maxItems": 20,@@@ -128,6 +128,9 @@],"maxLength": 240},++ "computer": {++ "$ref": "../platform/task.v1.json#/$defs/computer"++ },"approval": {"type": ["object",@@@ -66,6 +66,12 @@},"idempotency_key": {"$ref": "../../run/session.v1.json#/properties/idempotency_key"++ },++ "task_id": {++ "$ref": "../../run/session.v1.json#/properties/task_id"++ },++ "curtain": {++ "$ref": "../../run/session.v1.json#/properties/curtain"}}}@@@ -59,6 +59,12 @@},"idempotency_key": {"$ref": "../../run/session.v1.json#/properties/idempotency_key"++ },++ "task_id": {++ "$ref": "../../run/session.v1.json#/properties/task_id"++ },++ "curtain": {++ "$ref": "../../run/session.v1.json#/properties/curtain"}}}@@@ -314,6 +314,9 @@"full"],"description": "The agent contact's own level, before the thread's level is raised above it."++ },++ "computer": {++ "$ref": "#/$defs/computer"}},"allOf": [@@@ -491,5 +494,61 @@"cancel": null,"progress": null}-- ]++ ],++ "$defs": {++ "computer": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "description": "The Computer a running task opened (plan 2026-11-07: Surf, Computer and Actor are one experience): a browser or desktop session, wherever it runs. It is the one id every surface reads — Surf's task card, the Dock's step and Actor's conversation — never a copy. Present while the task holds it; null once it ended. session_id is the session on the service that owns it (OpenVibe.Run's ses_…); when the desk runs directly on one of the person's own machines through OpenVibe.Bot there is no Run session and it is null. machine is the person's own word for where it runs (their computer's name, or 'a shared desk host'). where: yours (one of their own machines), home (a desk host someone offers at home) or network (an OpenVibe desk host). cost_hint is one plain phrase about what it costs.",++ "required": [++ "session_id",++ "machine",++ "where"++ ],++ "properties": {++ "session_id": {++ "anyOf": [++ {++ "type": "string",++ "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ {++ "type": "null"++ }++ ],++ "description": "OpenVibe.Run's session id (ses_…), or null when the desk runs directly on the person's machine through OpenVibe.Bot."++ },++ "machine": {++ "type": "string",++ "minLength": 1,++ "maxLength": 80,++ "description": "The person's word for it: their computer's name, or a desk host."++ },++ "where": {++ "enum": [++ "yours",++ "home",++ "network"++ ],++ "description": "yours: one of the person's own machines; home: a desk host someone offers at home; network: an OpenVibe desk host."++ },++ "cost_hint": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 120,++ "description": "One plain phrase, for example 'free on your computer' or 'about $0.01 a minute'."++ },++ "driving": {++ "type": "boolean",++ "default": false,++ "description": "True while the person drives this Computer (they took it over): the agent's input actions are refused, and Give it back hands it over again."++ }++ }++ }++ }}@@@ -38,6 +38,11 @@},"idempotency_key": {"$ref": "session.v1.json#/$defs/idempotency_key"++ },++ "task_id": {++ "type": "string",++ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The OpenVibe.Actor task that asks for this session (plan 2026-11-07: one id across Surf, Computer and Actor). It is carried back on run.session@1, so the session and the task point at each other."}},"examples": [@@@ -98,6 +98,23 @@"type": "null"}]++ },++ "task_id": {++ "anyOf": [++ {++ "type": "string",++ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ {++ "type": "null"++ }++ ],++ "description": "The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries."++ },++ "curtain": {++ "type": "boolean",++ "default": false,++ "description": "Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain."}},"allOf": [nnew file mode 100644@@@ -0,0 +1,28 @@++{++ "id": "tl_01JAB2C3D4E5F6G7H8J9K0MNPT",++ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",++ "mode": "browse",++ "product": "surf",++ "ref": "tsk_01JAB2C3D4E5F6G7H8J9K0MNPT",++ "title": "Surfing the web for you",++ "started_at": "2026-11-07T09:00:00.000Z",++ "ended_at": null,++ "status": "running",++ "placement": {++ "where": "a shared desk host",++ "why": "it browses for you, never with your accounts"++ },++ "cost_usd": null,++ "link": "https://openvibe.surf/web/t/tsk_01JAB2C3D4E5F6G7H8J9K0MNPT",++ "computer": {++ "session_id": "ses_01JD2C3D4E5F6G7H8J9K0MNPQS",++ "machine": "a shared desk host",++ "where": "network",++ "cost_hint": "an OpenVibe desk host, metered by the minute"++ },++ "reason": null,++ "transition": null,++ "approval": null,++ "audience": "private",++ "shared": false++}nnew file mode 100644@@@ -0,0 +1,15 @@++{++ "id": "tsk_01JAB2C3D4E5F6G7H8J9K0MNPT",++ "requester": { "type": "user", "id": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS" },++ "task": "Compare three hosting plans under $10 a month.",++ "mode": "balanced",++ "budget": { "per_task_usd": 1, "per_day_usd": 10 },++ "state": "running",++ "created_at": "2026-11-07T09:00:00.000Z",++ "computer": {++ "session_id": "ses_01JD2C3D4E5F6G7H8J9K0MNPQR",++ "machine": "a shared desk host",++ "where": "cloud",++ "cost_hint": null++ }++}nnew file mode 100644@@@ -0,0 +1,29 @@++{++ "id": "tsk_01JAB2C3D4E5F6G7H8J9K0MNPT",++ "requester": { "type": "user", "id": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS" },++ "task": "Compare three hosting plans under $10 a month and tell me which one to pick.",++ "mode": "balanced",++ "budget": { "per_task_usd": 1, "per_day_usd": 10 },++ "state": "running",++ "created_at": "2026-11-07T09:00:00.000Z",++ "computer": {++ "session_id": "ses_01JD2C3D4E5F6G7H8J9K0MNPQR",++ "machine": "a shared desk host",++ "where": "home",++ "cost_hint": "a shared desk host, metered by the minute"++ },++ "progress": {++ "stream_url": "https://openvibe.actor/api/v1/tasks/tsk_01JAB2C3D4E5F6G7H8J9K0MNPT/events",++ "last_seq": 7,++ "events": ["output", "state", "end"]++ },++ "explanation": [++ {++ "selected": "openvibe-runtime",++ "objective": "balanced",++ "reasons": ["a web task; it opens a browser desk of its own"],++ "candidates": [{ "id": "openvibe-runtime", "eligible": true, "estimated_cost_usd": 0.08 }],++ "decided_at": "2026-11-07T09:00:01.000Z"++ }++ ]++}nnew file mode 100644@@@ -0,0 +1,39 @@++{++ "id": "ses_01JD2C3D4E5F6G7H8J9K0MNPQS",++ "owner": {++ "type": "user",++ "id": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ"++ },++ "via": "service:actor",++ "kind": "browser",++ "state": "running",++ "size": {++ "width": 1280,++ "height": 800++ },++ "ttl_s": 3600,++ "idle_s": 900,++ "placement": {++ "machine": "dev_01J8Z4M2Q0R7T9YV3K6N8P1W2X",++ "desk": "desk-s0mnpqs",++ "trust": "first-party",++ "offer_id": null,++ "region": null,++ "reasons": [++ "an OpenVibe desk host with room"++ ]++ },++ "timings": {++ "created_at": "2026-11-07T09:00:00Z",++ "started_at": "2026-11-07T09:00:04Z",++ "last_used_at": "2026-11-07T09:05:00Z",++ "ended_at": null++ },++ "end": null,++ "usage": {++ "desk_seconds": 296++ },++ "idempotency_key": "actor:tsk_01JAB2C3D4E5F6G7H8J9K0MNPT",++ "task_id": "tsk_01JAB2C3D4E5F6G7H8J9K0MNPT",++ "curtain": false++}@@@ -75407,6 +75407,9 @@"full"],"description": "The agent contact's own level, before the thread's level is raised above it."++ },++ "computer": {++ "$ref": "#/$defs/computer"}},"allOf": [@@@ -75584,7 +75587,63 @@"cancel": null,"progress": null}-- ]++ ],++ "$defs": {++ "computer": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "description": "The Computer a running task opened (plan 2026-11-07: Surf, Computer and Actor are one experience): a browser or desktop session, wherever it runs. It is the one id every surface reads — Surf's task card, the Dock's step and Actor's conversation — never a copy. Present while the task holds it; null once it ended. session_id is the session on the service that owns it (OpenVibe.Run's ses_…); when the desk runs directly on one of the person's own machines through OpenVibe.Bot there is no Run session and it is null. machine is the person's own word for where it runs (their computer's name, or 'a shared desk host'). where: yours (one of their own machines), home (a desk host someone offers at home) or network (an OpenVibe desk host). cost_hint is one plain phrase about what it costs.",++ "required": [++ "session_id",++ "machine",++ "where"++ ],++ "properties": {++ "session_id": {++ "anyOf": [++ {++ "type": "string",++ "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ {++ "type": "null"++ }++ ],++ "description": "OpenVibe.Run's session id (ses_…), or null when the desk runs directly on the person's machine through OpenVibe.Bot."++ },++ "machine": {++ "type": "string",++ "minLength": 1,++ "maxLength": 80,++ "description": "The person's word for it: their computer's name, or a desk host."++ },++ "where": {++ "enum": [++ "yours",++ "home",++ "network"++ ],++ "description": "yours: one of the person's own machines; home: a desk host someone offers at home; network: an OpenVibe desk host."++ },++ "cost_hint": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 120,++ "description": "One plain phrase, for example 'free on your computer' or 'about $0.01 a minute'."++ },++ "driving": {++ "type": "boolean",++ "default": false,++ "description": "True while the person drives this Computer (they took it over): the agent's input actions are refused, and Give it back hands it over again."++ }++ }++ }++ }}},"events.delivery-policy": {@@@ -84482,6 +84541,9 @@"is_error": {"type": "boolean"},++ "computer": {++ "$ref": "../platform/task.v1.json#/$defs/computer"++ },"artifacts": {"type": "array","maxItems": 20,@@@ -92330,6 +92392,23 @@"type": "null"}]++ },++ "task_id": {++ "anyOf": [++ {++ "type": "string",++ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ {++ "type": "null"++ }++ ],++ "description": "The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries."++ },++ "curtain": {++ "type": "boolean",++ "default": false,++ "description": "Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain."}},"allOf": [@@@ -92653,6 +92732,11 @@},"idempotency_key": {"$ref": "session.v1.json#/$defs/idempotency_key"++ },++ "task_id": {++ "type": "string",++ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The OpenVibe.Actor task that asks for this session (plan 2026-11-07: one id across Surf, Computer and Actor). It is carried back on run.session@1, so the session and the task point at each other."}},"examples": [@@@ -92899,6 +92983,12 @@},"idempotency_key": {"$ref": "../../run/session.v1.json#/properties/idempotency_key"++ },++ "task_id": {++ "$ref": "../../run/session.v1.json#/properties/task_id"++ },++ "curtain": {++ "$ref": "../../run/session.v1.json#/properties/curtain"}}}@@@ -92975,6 +93065,12 @@},"idempotency_key": {"$ref": "../../run/session.v1.json#/properties/idempotency_key"++ },++ "task_id": {++ "$ref": "../../run/session.v1.json#/properties/task_id"++ },++ "curtain": {++ "$ref": "../../run/session.v1.json#/properties/curtain"}}}@@@ -108487,6 +108583,9 @@],"maxLength": 240},++ "computer": {++ "$ref": "../platform/task.v1.json#/$defs/computer"++ },"approval": {"type": ["object",@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Actor API",-- "version": "0.326.0",-- "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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"@@@ -2094,7 +2094,7 @@"post": {"operationId": "post_api_v1_tasks","summary": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget.",-- "description": "**actor.task.create** (public): Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",++ "description": "**actor.task.create** (public): Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. POST /api/v1/tasks/:id/takeover gives the person the Computer the task opened (the agent's input is refused while they drive) and POST /api/v1/tasks/:id/giveback hands it back; both are the task's own person's, built on the same hand-off the agent's hand_to_person tool uses. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.","tags": ["actor.task"],@@@ -2149,8 +2149,8 @@"/api/v1/tasks/{id}": {"get": {"operationId": "get_api_v1_tasks_id",-- "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (sta",-- "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the files and charts a tool made, the end), resumable with Last-Event-ID. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",++ "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of",++ "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the Computer, the files and charts a tool made, the end), resumable with Last-Event-ID. GET /api/v1/tasks/:id/still answers the Computer's newest frame as a small JPEG (at most once a second, the curtain picture while Curtain now is up), fetched from the session's own service as the person. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.","tags": ["actor.task"],@@@ -2205,8 +2205,8 @@"/api/v1/tasks/{id}/artifacts/{mediaId}": {"get": {"operationId": "get_api_v1_tasks_id_artifacts_mediaId",-- "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (sta",-- "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the files and charts a tool made, the end), resumable with Last-Event-ID. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",++ "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of",++ "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the Computer, the files and charts a tool made, the end), resumable with Last-Event-ID. GET /api/v1/tasks/:id/still answers the Computer's newest frame as a small JPEG (at most once a second, the curtain picture while Curtain now is up), fetched from the session's own service as the person. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.","tags": ["actor.task"],@@@ -2270,7 +2270,7 @@"post": {"operationId": "post_api_v1_tasks_id_cancel","summary": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget.",-- "description": "**actor.task.create** (public): Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",++ "description": "**actor.task.create** (public): Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. POST /api/v1/tasks/:id/takeover gives the person the Computer the task opened (the agent's input is refused while they drive) and POST /api/v1/tasks/:id/giveback hands it back; both are the task's own person's, built on the same hand-off the agent's hand_to_person tool uses. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.","tags": ["actor.task"],@@@ -2335,8 +2335,8 @@"/api/v1/tasks/{id}/events": {"get": {"operationId": "get_api_v1_tasks_id_events",-- "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (sta",-- "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the files and charts a tool made, the end), resumable with Last-Event-ID. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",++ "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of",++ "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the Computer, the files and charts a tool made, the end), resumable with Last-Event-ID. GET /api/v1/tasks/:id/still answers the Computer's newest frame as a small JPEG (at most once a second, the curtain picture while Curtain now is up), fetched from the session's own service as the person. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.","tags": ["actor.task"],@@@ -2388,6 +2388,194 @@}}},++ "/api/v1/tasks/{id}/giveback": {++ "post": {++ "operationId": "post_api_v1_tasks_id_giveback",++ "summary": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget.",++ "description": "**actor.task.create** (public): Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. POST /api/v1/tasks/:id/takeover gives the person the Computer the task opened (the agent's input is refused while they drive) and POST /api/v1/tasks/:id/giveback hands it back; both are the task's own person's, built on the same hand-off the agent's hand_to_person tool uses. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",++ "tags": [++ "actor.task"++ ],++ "x-openvibe-capabilities": [++ "actor.task.create"++ ],++ "x-openvibe-visibility": [++ "public"++ ],++ "x-openvibe-quota-class": "actor-task",++ "security": [++ {++ "openvibeToken": [++ "actor.task.create"++ ]++ }++ ],++ "requestBody": {++ "required": false,++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/actor.task-create-request.v1"++ }++ }++ }++ },++ "parameters": [++ {++ "name": "id",++ "in": "path",++ "required": true,++ "schema": {++ "type": "string"++ }++ }++ ],++ "responses": {++ "2XX": {++ "description": "Success",++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/platform.task.v1"++ }++ }++ }++ },++ "default": {++ "description": "An error (RFC 9457 problem details)",++ "content": {++ "application/problem+json": {++ "schema": {++ "$ref": "#/components/schemas/errors.problem.v1"++ }++ }++ }++ }++ }++ }++ },++ "/api/v1/tasks/{id}/still": {++ "get": {++ "operationId": "get_api_v1_tasks_id_still",++ "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of",++ "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the Computer, the files and charts a tool made, the end), resumable with Last-Event-ID. GET /api/v1/tasks/:id/still answers the Computer's newest frame as a small JPEG (at most once a second, the curtain picture while Curtain now is up), fetched from the session's own service as the person. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",++ "tags": [++ "actor.task"++ ],++ "x-openvibe-capabilities": [++ "actor.task.read"++ ],++ "x-openvibe-visibility": [++ "public"++ ],++ "x-openvibe-quota-class": "actor-read",++ "security": [++ {++ "openvibeToken": [++ "actor.task.read"++ ]++ }++ ],++ "parameters": [++ {++ "name": "id",++ "in": "path",++ "required": true,++ "schema": {++ "type": "string"++ }++ }++ ],++ "responses": {++ "2XX": {++ "description": "Success",++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/platform.task.v1"++ }++ }++ }++ },++ "default": {++ "description": "An error (RFC 9457 problem details)",++ "content": {++ "application/problem+json": {++ "schema": {++ "$ref": "#/components/schemas/errors.problem.v1"++ }++ }++ }++ }++ }++ }++ },++ "/api/v1/tasks/{id}/takeover": {++ "post": {++ "operationId": "post_api_v1_tasks_id_takeover",++ "summary": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget.",++ "description": "**actor.task.create** (public): Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. POST /api/v1/tasks/:id/takeover gives the person the Computer the task opened (the agent's input is refused while they drive) and POST /api/v1/tasks/:id/giveback hands it back; both are the task's own person's, built on the same hand-off the agent's hand_to_person tool uses. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",++ "tags": [++ "actor.task"++ ],++ "x-openvibe-capabilities": [++ "actor.task.create"++ ],++ "x-openvibe-visibility": [++ "public"++ ],++ "x-openvibe-quota-class": "actor-task",++ "security": [++ {++ "openvibeToken": [++ "actor.task.create"++ ]++ }++ ],++ "requestBody": {++ "required": false,++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/actor.task-create-request.v1"++ }++ }++ }++ },++ "parameters": [++ {++ "name": "id",++ "in": "path",++ "required": true,++ "schema": {++ "type": "string"++ }++ }++ ],++ "responses": {++ "2XX": {++ "description": "Success",++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/platform.task.v1"++ }++ }++ }++ },++ "default": {++ "description": "An error (RFC 9457 problem details)",++ "content": {++ "application/problem+json": {++ "schema": {++ "$ref": "#/components/schemas/errors.problem.v1"++ }++ }++ }++ }++ }++ }++ },"/internal/config": {"get": {"operationId": "get_internal_config",@@@ -4111,6 +4299,9 @@],"maxLength": 240},++ "computer": {++ "$ref": "#/components/schemas/platform.task.v1/$defs/computer"++ },"approval": {"type": ["object",@@@ -5662,6 +5853,9 @@"full"],"description": "The agent contact's own level, before the thread's level is raised above it."++ },++ "computer": {++ "$ref": "#/components/schemas/platform.task.v1/$defs/computer"}},"allOf": [@@@ -5839,7 +6033,63 @@"cancel": null,"progress": null}-- ]++ ],++ "$defs": {++ "computer": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "description": "The Computer a running task opened (plan 2026-11-07: Surf, Computer and Actor are one experience): a browser or desktop session, wherever it runs. It is the one id every surface reads — Surf's task card, the Dock's step and Actor's conversation — never a copy. Present while the task holds it; null once it ended. session_id is the session on the service that owns it (OpenVibe.Run's ses_…); when the desk runs directly on one of the person's own machines through OpenVibe.Bot there is no Run session and it is null. machine is the person's own word for where it runs (their computer's name, or 'a shared desk host'). where: yours (one of their own machines), home (a desk host someone offers at home) or network (an OpenVibe desk host). cost_hint is one plain phrase about what it costs.",++ "required": [++ "session_id",++ "machine",++ "where"++ ],++ "properties": {++ "session_id": {++ "anyOf": [++ {++ "type": "string",++ "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ {++ "type": "null"++ }++ ],++ "description": "OpenVibe.Run's session id (ses_…), or null when the desk runs directly on the person's machine through OpenVibe.Bot."++ },++ "machine": {++ "type": "string",++ "minLength": 1,++ "maxLength": 80,++ "description": "The person's word for it: their computer's name, or a desk host."++ },++ "where": {++ "enum": [++ "yours",++ "home",++ "network"++ ],++ "description": "yours: one of the person's own machines; home: a desk host someone offers at home; network: an OpenVibe desk host."++ },++ "cost_hint": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 120,++ "description": "One plain phrase, for example 'free on your computer' or 'about $0.01 a minute'."++ },++ "driving": {++ "type": "boolean",++ "default": false,++ "description": "True while the person drives this Computer (they took it over): the agent's input actions are refused, and Give it back hands it over again."++ }++ }++ }++ }}},"securitySchemes": {@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.AI API",-- "version": "0.326.0",-- "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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"@@@ -4141,6 +4141,23 @@"type": "null"}]++ },++ "task_id": {++ "anyOf": [++ {++ "type": "string",++ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ {++ "type": "null"++ }++ ],++ "description": "The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries."++ },++ "curtain": {++ "type": "boolean",++ "default": false,++ "description": "Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain."}},"allOf": [@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Chat API",-- "version": "0.326.0",-- "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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 Connect API",-- "version": "0.326.0",-- "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.Design API",-- "version": "0.326.0",-- "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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"@@@ -5,7 +5,7 @@"service": "actor","name": "OpenVibe.Actor","origin": "https://openvibe.actor",-- "operations": 46,++ "operations": 49,"capabilities": 14},{@@@ -208,7 +208,7 @@"service": "run","name": "OpenVibe.Run","origin": "https://openvibe.run",-- "operations": 12,++ "operations": 14,"capabilities": 9},{@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Inventory API",-- "version": "0.326.0",-- "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.Reviews API",-- "version": "0.326.0",-- "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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"@@@ -515,8 +515,8 @@"/api/v1/sessions": {"get": {"operationId": "get_api_v1_sessions",-- "summary": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1) and GET /api/v1/sessions/:id (run.session@1: state, where it runs, timings, desk-seconds).",-- "description": "**run.session.read** (public): Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1) and GET /api/v1/sessions/:id (run.session@1: state, where it runs, timings, desk-seconds). Never another person's.",++ "summary": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/session",++ "description": "**run.session.read** (public): Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/sessions/:id/still (the desk's newest frame as a small JPEG, at most once a second, or the curtain picture while Curtain now is up). Never another person's: anyone else gets 404, a signed-out visitor included.","tags": ["run.session"],@@@ -615,8 +615,8 @@"/api/v1/sessions/{id}": {"get": {"operationId": "get_api_v1_sessions_id",-- "summary": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1) and GET /api/v1/sessions/:id (run.session@1: state, where it runs, timings, desk-seconds).",-- "description": "**run.session.read** (public): Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1) and GET /api/v1/sessions/:id (run.session@1: state, where it runs, timings, desk-seconds). Never another person's.",++ "summary": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/session",++ "description": "**run.session.read** (public): Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/sessions/:id/still (the desk's newest frame as a small JPEG, at most once a second, or the curtain picture while Curtain now is up). Never another person's: anyone else gets 404, a signed-out visitor included.","tags": ["run.session"],@@@ -671,8 +671,74 @@"/api/v1/sessions/{id}/commands": {"post": {"operationId": "post_api_v1_sessions_id_commands",-- "summary": "Use and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-resul",-- "description": "**run.session.control** (public): Use and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.",++ "summary": "Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-cont",++ "description": "**run.session.control** (public): Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1), POST /api/v1/sessions/:id/curtain ({ up }: the privacy screen the still honors) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.",++ "tags": [++ "run.session"++ ],++ "x-openvibe-capabilities": [++ "run.session.control"++ ],++ "x-openvibe-visibility": [++ "public"++ ],++ "x-openvibe-quota-class": "run-write",++ "security": [++ {++ "openvibeToken": [++ "run.session.control"++ ]++ }++ ],++ "requestBody": {++ "required": false,++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/run.session-control-request.v1"++ }++ }++ }++ },++ "parameters": [++ {++ "name": "id",++ "in": "path",++ "required": true,++ "schema": {++ "type": "string"++ }++ }++ ],++ "responses": {++ "2XX": {++ "description": "Success",++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/run.session-control-result.v1"++ }++ }++ }++ },++ "default": {++ "description": "An error (RFC 9457 problem details)",++ "content": {++ "application/problem+json": {++ "schema": {++ "$ref": "#/components/schemas/errors.problem.v1"++ }++ }++ }++ }++ }++ }++ },++ "/api/v1/sessions/{id}/curtain": {++ "post": {++ "operationId": "post_api_v1_sessions_id_curtain",++ "summary": "Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-cont",++ "description": "**run.session.control** (public): Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1), POST /api/v1/sessions/:id/curtain ({ up }: the privacy screen the still honors) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.","tags": ["run.session"],@@@ -737,8 +803,8 @@"/api/v1/sessions/{id}/end": {"post": {"operationId": "post_api_v1_sessions_id_end",-- "summary": "Use and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-resul",-- "description": "**run.session.control** (public): Use and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.",++ "summary": "Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-cont",++ "description": "**run.session.control** (public): Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1), POST /api/v1/sessions/:id/curtain ({ up }: the privacy screen the still honors) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.","tags": ["run.session"],@@@ -799,6 +865,62 @@}}}++ },++ "/api/v1/sessions/{id}/still": {++ "get": {++ "operationId": "get_api_v1_sessions_id_still",++ "summary": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/session",++ "description": "**run.session.read** (public): Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/sessions/:id/still (the desk's newest frame as a small JPEG, at most once a second, or the curtain picture while Curtain now is up). Never another person's: anyone else gets 404, a signed-out visitor included.",++ "tags": [++ "run.session"++ ],++ "x-openvibe-capabilities": [++ "run.session.read"++ ],++ "x-openvibe-visibility": [++ "public"++ ],++ "x-openvibe-quota-class": "run-read",++ "security": [++ {++ "openvibeToken": [++ "run.session.read"++ ]++ }++ ],++ "parameters": [++ {++ "name": "id",++ "in": "path",++ "required": true,++ "schema": {++ "type": "string"++ }++ }++ ],++ "responses": {++ "2XX": {++ "description": "Success",++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/run.session.v1"++ }++ }++ }++ },++ "default": {++ "description": "An error (RFC 9457 problem details)",++ "content": {++ "application/problem+json": {++ "schema": {++ "$ref": "#/components/schemas/errors.problem.v1"++ }++ }++ }++ }++ }++ }}},"components": {@@@ -2170,6 +2292,11 @@},"idempotency_key": {"$ref": "#/components/schemas/run.session.v1/$defs/idempotency_key"++ },++ "task_id": {++ "type": "string",++ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The OpenVibe.Actor task that asks for this session (plan 2026-11-07: one id across Surf, Computer and Actor). It is carried back on run.session@1, so the session and the task point at each other."}},"examples": [@@@ -2284,6 +2411,23 @@"type": "null"}]++ },++ "task_id": {++ "anyOf": [++ {++ "type": "string",++ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ {++ "type": "null"++ }++ ],++ "description": "The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries."++ },++ "curtain": {++ "type": "boolean",++ "default": false,++ "description": "Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain."}},"allOf": [@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Search API",-- "version": "0.326.0",-- "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",-- "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",++ "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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"@@@ -211235,6 +211235,31 @@ export type Task = {* The agent contact's own level, before the thread's level is raised above it.*/agent_level?: "ask" | "auto-edits" | "approve-for-me" | "full";++ /**++ * The Computer a running task opened (plan 2026-11-07: Surf, Computer and Actor are one experience): a browser or desktop session, wherever it runs. It is the one id every surface reads — Surf's task card, the Dock's step and Actor's conversation — never a copy. Present while the task holds it; null once it ended. session_id is the session on the service that owns it (OpenVibe.Run's ses_…); when the desk runs directly on one of the person's own machines through OpenVibe.Bot there is no Run session and it is null. machine is the person's own word for where it runs (their computer's name, or 'a shared desk host'). where: yours (one of their own machines), home (a desk host someone offers at home) or network (an OpenVibe desk host). cost_hint is one plain phrase about what it costs.++ */++ computer?: {++ /**++ * OpenVibe.Run's session id (ses_…), or null when the desk runs directly on the person's machine through OpenVibe.Bot.++ */++ session_id: string | null;++ /**++ * The person's word for it: their computer's name, or a desk host.++ */++ machine: string;++ /**++ * yours: one of the person's own machines; home: a desk host someone offers at home; network: an OpenVibe desk host.++ */++ where: "yours" | "home" | "network";++ /**++ * One plain phrase, for example 'free on your computer' or 'about $0.01 a minute'.++ */++ cost_hint?: string | null;++ /**++ * True while the person drives this Computer (they took it over): the agent's input actions are refused, and Give it back hands it over again.++ */++ driving?: boolean;++ } | null;};/** [email protected] (owner: events) */@@@ -274038,6 +274063,14 @@ export type RunSession = {desk_seconds: number;};idempotency_key: string | null;++ /**++ * The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries.++ */++ task_id?: string | null;++ /**++ * Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain.++ */++ curtain?: boolean;};/** [email protected] (owner: run) */@@@ -274068,6 +274101,10 @@ export interface RunSessionCreateRequest {machine?: string;requirements?: WorkloadRequirements;idempotency_key?: string;++ /**++ * The OpenVibe.Actor task that asks for this session (plan 2026-11-07: one id across Surf, Computer and Actor). It is carried back on run.session@1, so the session and the task point at each other.++ */++ task_id?: string;}/** [email protected] (owner: run) */@@@ -274197,6 +274234,14 @@ export interface RunSessionStartedPayload {desk_seconds: number;};idempotency_key: string | null;++ /**++ * The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries.++ */++ task_id?: string | null;++ /**++ * Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain.++ */++ curtain?: boolean;}/** [email protected] (owner: run) */@@@ -274287,6 +274332,14 @@ export interface RunSessionEndedPayload {desk_seconds: number;};idempotency_key: string | null;++ /**++ * The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries.++ */++ task_id?: string | null;++ /**++ * Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain.++ */++ curtain?: boolean;}/** [email protected] (owner: bot) */@@@ -300806,6 +300859,31 @@ export interface AgentTimelineEntry {link?: string | null;reason?: string | null;transition?: string | null;++ /**++ * The Computer a running task opened (plan 2026-11-07: Surf, Computer and Actor are one experience): a browser or desktop session, wherever it runs. It is the one id every surface reads — Surf's task card, the Dock's step and Actor's conversation — never a copy. Present while the task holds it; null once it ended. session_id is the session on the service that owns it (OpenVibe.Run's ses_…); when the desk runs directly on one of the person's own machines through OpenVibe.Bot there is no Run session and it is null. machine is the person's own word for where it runs (their computer's name, or 'a shared desk host'). where: yours (one of their own machines), home (a desk host someone offers at home) or network (an OpenVibe desk host). cost_hint is one plain phrase about what it costs.++ */++ computer?: {++ /**++ * OpenVibe.Run's session id (ses_…), or null when the desk runs directly on the person's machine through OpenVibe.Bot.++ */++ session_id: string | null;++ /**++ * The person's word for it: their computer's name, or a desk host.++ */++ machine: string;++ /**++ * yours: one of the person's own machines; home: a desk host someone offers at home; network: an OpenVibe desk host.++ */++ where: "yours" | "home" | "network";++ /**++ * One plain phrase, for example 'free on your computer' or 'about $0.01 a minute'.++ */++ cost_hint?: string | null;++ /**++ * True while the person drives this Computer (they took it over): the agent's input actions are refused, and Give it back hands it over again.++ */++ driving?: boolean;++ } | null;/*** The approval this step waits on, and the mode that owns it. The person answers it in the mode.*/@@@ -5,7 +5,7 @@"status": "active","visibility": "public","sensitive": true,-- "description": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",++ "description": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. POST /api/v1/tasks/:id/takeover gives the person the Computer the task opened (the agent's input is refused while they drive) and POST /api/v1/tasks/:id/giveback hands it back; both are the task's own person's, built on the same hand-off the agent's hand_to_person tool uses. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.","inputSchema": "actor.task-create-request@1","outputSchema": "platform.task@1","permissions": [@@@ -19,6 +19,8 @@"events": [],"implementedBy": ["POST /api/v1/tasks",-- "POST /api/v1/tasks/:id/cancel"++ "POST /api/v1/tasks/:id/cancel",++ "POST /api/v1/tasks/:id/takeover",++ "POST /api/v1/tasks/:id/giveback"]}@@@ -4,7 +4,7 @@"owner": "actor","status": "active","visibility": "public",-- "description": "Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the files and charts a tool made, the end), resumable with Last-Event-ID. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",++ "description": "Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the Computer, the files and charts a tool made, the end), resumable with Last-Event-ID. GET /api/v1/tasks/:id/still answers the Computer's newest frame as a small JPEG (at most once a second, the curtain picture while Curtain now is up), fetched from the session's own service as the person. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.","inputSchema": "common.no-body@1","outputSchema": "platform.task@1","permissions": [@@@ -19,6 +19,7 @@"implementedBy": ["GET /api/v1/tasks/:id","GET /api/v1/tasks/:id/events",++ "GET /api/v1/tasks/:id/still","GET /api/v1/tasks/:id/artifacts/:mediaId"]}@@@ -4,7 +4,7 @@"owner": "run","status": "active","visibility": "public",-- "description": "Use and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.",++ "description": "Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1), POST /api/v1/sessions/:id/curtain ({ up }: the privacy screen the still honors) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.","inputSchema": "run.session-control-request@1","outputSchema": "run.session-control-result@1","permissions": [@@@ -19,6 +19,7 @@],"implementedBy": ["POST /api/v1/sessions/:id/commands",++ "POST /api/v1/sessions/:id/curtain","POST /api/v1/sessions/:id/end"]}@@@ -4,7 +4,7 @@"owner": "run","status": "active","visibility": "public",-- "description": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1) and GET /api/v1/sessions/:id (run.session@1: state, where it runs, timings, desk-seconds). Never another person's.",++ "description": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/sessions/:id/still (the desk's newest frame as a small JPEG, at most once a second, or the curtain picture while Curtain now is up). Never another person's: anyone else gets 404, a signed-out visitor included.","inputSchema": "common.no-body@1","outputSchema": "run.session@1","permissions": [@@@ -17,6 +17,7 @@"events": [],"implementedBy": ["GET /api/v1/sessions",-- "GET /api/v1/sessions/:id"++ "GET /api/v1/sessions/:id",++ "GET /api/v1/sessions/:id/still"]}@@@ -1,12 +1,12 @@{"name": "openvibe-contracts",-- "version": "0.315.0",++ "version": "0.327.0","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "openvibe-contracts",-- "version": "0.315.0",++ "version": "0.327.0","license": "AGPL-3.0-only","dependencies": {"ajv": "^8.17.1",@@@ -1,6 +1,6 @@{"name": "openvibe-contracts",-- "version": "0.326.0",++ "version": "0.327.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,14 @@
@@ -1,5 +1,14 @@
# Changelog
# Changelog
+## 0.327.0 — 2026-11-07
+
+- One Computer across Surf, Actor and the Dock (plan 2026-11-07: "Surf, Computer and Actor are one experience"): `platform.task@1` gains optional `computer` (`session_id`, `machine`, `where`, `cost_hint`, `driving`) — the browser or desktop session a running task opened, wherever it runs. `session_id` is OpenVibe.Run's `ses_…`; it is null only when the desk runs directly on the person's own machine through OpenVibe.Bot, where there is no Run session. `where` is `yours`, `home` or `network`, and `machine` is the person's own word for it.
+- `actor.task-event@2` and `agent.timeline-entry@1` carry the same `computer` object by `$ref`: the task's step in the Dock and the task record read the same fields, never a copy.
+- `run.session@1` gains optional `task_id` (the Actor task that asked for the session, so the session points back at the task) and `curtain` (the privacy screen: while it is up the session's still answers the curtain picture, never the screen). `run.session-create-request@1` gains optional `task_id`.
+- The `run.session.started` and `run.session.ended` event payloads carry the same optional `task_id` and `curtain`, so a session's own events stay valid with the new session shape.
+- Capabilities name the routes: `run.session.read` gains `GET /api/v1/sessions/{id}/still`, `run.session.control` gains `POST /api/v1/sessions/{id}/curtain`, `actor.task.read` gains `GET /api/v1/tasks/{id}/still`, and `actor.task.create` gains `POST /api/v1/tasks/{id}/takeover` and `…/giveback`.
+- Additive only: every new field is optional and nothing that exists today changes shape.
+
## 0.326.0 — 2026-11-07
## 0.326.0 — 2026-11-07
- Add `network.menu-feeds@1`: the cards a person chose to show in the OpenVibe menu's "Choose your feeds", in their order, following them across every site. `on` holds up to four `<site>:<cardId>` ids (lower-case letters, digits and dashes) and `updated_at` says when the choice last changed. OpenVibe.Network keeps it at `GET` and `PUT /api/v1/me/menu-feeds`; a person who has never chosen gets `{ on: null }` from the GET. An empty array is a cleared choice.
- Add `network.menu-feeds@1`: the cards a person chose to show in the OpenVibe menu's "Choose your feeds", in their order, following them across every site. `on` holds up to four `<site>:<cardId>` ids (lower-case letters, digits and dashes) and `updated_at` says when the choice last changed. OpenVibe.Network keeps it at `GET` and `PUT /api/v1/me/menu-feeds`; a person who has never chosen gets `{ on: null }` from the GET. An empty array is a cleared choice.
@@ -73,6 +73,9 @@
@@ -73,6 +73,9 @@
"is_error": {
"is_error": {
"type": "boolean"
"type": "boolean"
},
},
+ "computer": {
+ "$ref": "../platform/task.v1.json#/$defs/computer"
+ },
"artifacts": {
"artifacts": {
"type": "array",
"type": "array",
"maxItems": 20,
"maxItems": 20,
@@ -128,6 +128,9 @@
@@ -128,6 +128,9 @@
],
],
"maxLength": 240
"maxLength": 240
},
},
+ "computer": {
+ "$ref": "../platform/task.v1.json#/$defs/computer"
+ },
"approval": {
"approval": {
"type": [
"type": [
"object",
"object",
@@ -66,6 +66,12 @@
@@ -66,6 +66,12 @@
},
},
"idempotency_key": {
"idempotency_key": {
"$ref": "../../run/session.v1.json#/properties/idempotency_key"
"$ref": "../../run/session.v1.json#/properties/idempotency_key"
+ },
+ "task_id": {
+ "$ref": "../../run/session.v1.json#/properties/task_id"
+ },
+ "curtain": {
+ "$ref": "../../run/session.v1.json#/properties/curtain"
}
}
}
}
}
}
@@ -59,6 +59,12 @@
@@ -59,6 +59,12 @@
},
},
"idempotency_key": {
"idempotency_key": {
"$ref": "../../run/session.v1.json#/properties/idempotency_key"
"$ref": "../../run/session.v1.json#/properties/idempotency_key"
+ },
+ "task_id": {
+ "$ref": "../../run/session.v1.json#/properties/task_id"
+ },
+ "curtain": {
+ "$ref": "../../run/session.v1.json#/properties/curtain"
}
}
}
}
}
}
@@ -314,6 +314,9 @@
@@ -314,6 +314,9 @@
"full"
"full"
],
],
"description": "The agent contact's own level, before the thread's level is raised above it."
"description": "The agent contact's own level, before the thread's level is raised above it."
+ },
+ "computer": {
+ "$ref": "#/$defs/computer"
}
}
},
},
"allOf": [
"allOf": [
@@ -491,5 +494,61 @@
@@ -491,5 +494,61 @@
"cancel": null,
"cancel": null,
"progress": null
"progress": null
}
}
- ]
+ ],
+ "$defs": {
+ "computer": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "description": "The Computer a running task opened (plan 2026-11-07: Surf, Computer and Actor are one experience): a browser or desktop session, wherever it runs. It is the one id every surface reads — Surf's task card, the Dock's step and Actor's conversation — never a copy. Present while the task holds it; null once it ended. session_id is the session on the service that owns it (OpenVibe.Run's ses_…); when the desk runs directly on one of the person's own machines through OpenVibe.Bot there is no Run session and it is null. machine is the person's own word for where it runs (their computer's name, or 'a shared desk host'). where: yours (one of their own machines), home (a desk host someone offers at home) or network (an OpenVibe desk host). cost_hint is one plain phrase about what it costs.",
+ "required": [
+ "session_id",
+ "machine",
+ "where"
+ ],
+ "properties": {
+ "session_id": {
+ "anyOf": [
+ {
+ "type": "string",
+ "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "OpenVibe.Run's session id (ses_…), or null when the desk runs directly on the person's machine through OpenVibe.Bot."
+ },
+ "machine": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 80,
+ "description": "The person's word for it: their computer's name, or a desk host."
+ },
+ "where": {
+ "enum": [
+ "yours",
+ "home",
+ "network"
+ ],
+ "description": "yours: one of the person's own machines; home: a desk host someone offers at home; network: an OpenVibe desk host."
+ },
+ "cost_hint": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 120,
+ "description": "One plain phrase, for example 'free on your computer' or 'about $0.01 a minute'."
+ },
+ "driving": {
+ "type": "boolean",
+ "default": false,
+ "description": "True while the person drives this Computer (they took it over): the agent's input actions are refused, and Give it back hands it over again."
+ }
+ }
+ }
+ }
}
}
@@ -38,6 +38,11 @@
@@ -38,6 +38,11 @@
},
},
"idempotency_key": {
"idempotency_key": {
"$ref": "session.v1.json#/$defs/idempotency_key"
"$ref": "session.v1.json#/$defs/idempotency_key"
+ },
+ "task_id": {
+ "type": "string",
+ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The OpenVibe.Actor task that asks for this session (plan 2026-11-07: one id across Surf, Computer and Actor). It is carried back on run.session@1, so the session and the task point at each other."
}
}
},
},
"examples": [
"examples": [
@@ -98,6 +98,23 @@
@@ -98,6 +98,23 @@
"type": "null"
"type": "null"
}
}
]
]
+ },
+ "task_id": {
+ "anyOf": [
+ {
+ "type": "string",
+ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries."
+ },
+ "curtain": {
+ "type": "boolean",
+ "default": false,
+ "description": "Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain."
}
}
},
},
"allOf": [
"allOf": [
new file mode 100644
new file mode 100644
@@ -0,0 +1,28 @@
@@ -0,0 +1,28 @@
+{
+ "id": "tl_01JAB2C3D4E5F6G7H8J9K0MNPT",
+ "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
+ "mode": "browse",
+ "product": "surf",
+ "ref": "tsk_01JAB2C3D4E5F6G7H8J9K0MNPT",
+ "title": "Surfing the web for you",
+ "started_at": "2026-11-07T09:00:00.000Z",
+ "ended_at": null,
+ "status": "running",
+ "placement": {
+ "where": "a shared desk host",
+ "why": "it browses for you, never with your accounts"
+ },
+ "cost_usd": null,
+ "link": "https://openvibe.surf/web/t/tsk_01JAB2C3D4E5F6G7H8J9K0MNPT",
+ "computer": {
+ "session_id": "ses_01JD2C3D4E5F6G7H8J9K0MNPQS",
+ "machine": "a shared desk host",
+ "where": "network",
+ "cost_hint": "an OpenVibe desk host, metered by the minute"
+ },
+ "reason": null,
+ "transition": null,
+ "approval": null,
+ "audience": "private",
+ "shared": false
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,15 @@
@@ -0,0 +1,15 @@
+{
+ "id": "tsk_01JAB2C3D4E5F6G7H8J9K0MNPT",
+ "requester": { "type": "user", "id": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS" },
+ "task": "Compare three hosting plans under $10 a month.",
+ "mode": "balanced",
+ "budget": { "per_task_usd": 1, "per_day_usd": 10 },
+ "state": "running",
+ "created_at": "2026-11-07T09:00:00.000Z",
+ "computer": {
+ "session_id": "ses_01JD2C3D4E5F6G7H8J9K0MNPQR",
+ "machine": "a shared desk host",
+ "where": "cloud",
+ "cost_hint": null
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,29 @@
@@ -0,0 +1,29 @@
+{
+ "id": "tsk_01JAB2C3D4E5F6G7H8J9K0MNPT",
+ "requester": { "type": "user", "id": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS" },
+ "task": "Compare three hosting plans under $10 a month and tell me which one to pick.",
+ "mode": "balanced",
+ "budget": { "per_task_usd": 1, "per_day_usd": 10 },
+ "state": "running",
+ "created_at": "2026-11-07T09:00:00.000Z",
+ "computer": {
+ "session_id": "ses_01JD2C3D4E5F6G7H8J9K0MNPQR",
+ "machine": "a shared desk host",
+ "where": "home",
+ "cost_hint": "a shared desk host, metered by the minute"
+ },
+ "progress": {
+ "stream_url": "https://openvibe.actor/api/v1/tasks/tsk_01JAB2C3D4E5F6G7H8J9K0MNPT/events",
+ "last_seq": 7,
+ "events": ["output", "state", "end"]
+ },
+ "explanation": [
+ {
+ "selected": "openvibe-runtime",
+ "objective": "balanced",
+ "reasons": ["a web task; it opens a browser desk of its own"],
+ "candidates": [{ "id": "openvibe-runtime", "eligible": true, "estimated_cost_usd": 0.08 }],
+ "decided_at": "2026-11-07T09:00:01.000Z"
+ }
+ ]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,39 @@
@@ -0,0 +1,39 @@
+{
+ "id": "ses_01JD2C3D4E5F6G7H8J9K0MNPQS",
+ "owner": {
+ "type": "user",
+ "id": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ"
+ },
+ "via": "service:actor",
+ "kind": "browser",
+ "state": "running",
+ "size": {
+ "width": 1280,
+ "height": 800
+ },
+ "ttl_s": 3600,
+ "idle_s": 900,
+ "placement": {
+ "machine": "dev_01J8Z4M2Q0R7T9YV3K6N8P1W2X",
+ "desk": "desk-s0mnpqs",
+ "trust": "first-party",
+ "offer_id": null,
+ "region": null,
+ "reasons": [
+ "an OpenVibe desk host with room"
+ ]
+ },
+ "timings": {
+ "created_at": "2026-11-07T09:00:00Z",
+ "started_at": "2026-11-07T09:00:04Z",
+ "last_used_at": "2026-11-07T09:05:00Z",
+ "ended_at": null
+ },
+ "end": null,
+ "usage": {
+ "desk_seconds": 296
+ },
+ "idempotency_key": "actor:tsk_01JAB2C3D4E5F6G7H8J9K0MNPT",
+ "task_id": "tsk_01JAB2C3D4E5F6G7H8J9K0MNPT",
+ "curtain": false
+}
@@ -75407,6 +75407,9 @@
@@ -75407,6 +75407,9 @@
"full"
"full"
],
],
"description": "The agent contact's own level, before the thread's level is raised above it."
"description": "The agent contact's own level, before the thread's level is raised above it."
+ },
+ "computer": {
+ "$ref": "#/$defs/computer"
}
}
},
},
"allOf": [
"allOf": [
@@ -75584,7 +75587,63 @@
@@ -75584,7 +75587,63 @@
"cancel": null,
"cancel": null,
"progress": null
"progress": null
}
}
- ]
+ ],
+ "$defs": {
+ "computer": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "description": "The Computer a running task opened (plan 2026-11-07: Surf, Computer and Actor are one experience): a browser or desktop session, wherever it runs. It is the one id every surface reads — Surf's task card, the Dock's step and Actor's conversation — never a copy. Present while the task holds it; null once it ended. session_id is the session on the service that owns it (OpenVibe.Run's ses_…); when the desk runs directly on one of the person's own machines through OpenVibe.Bot there is no Run session and it is null. machine is the person's own word for where it runs (their computer's name, or 'a shared desk host'). where: yours (one of their own machines), home (a desk host someone offers at home) or network (an OpenVibe desk host). cost_hint is one plain phrase about what it costs.",
+ "required": [
+ "session_id",
+ "machine",
+ "where"
+ ],
+ "properties": {
+ "session_id": {
+ "anyOf": [
+ {
+ "type": "string",
+ "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "OpenVibe.Run's session id (ses_…), or null when the desk runs directly on the person's machine through OpenVibe.Bot."
+ },
+ "machine": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 80,
+ "description": "The person's word for it: their computer's name, or a desk host."
+ },
+ "where": {
+ "enum": [
+ "yours",
+ "home",
+ "network"
+ ],
+ "description": "yours: one of the person's own machines; home: a desk host someone offers at home; network: an OpenVibe desk host."
+ },
+ "cost_hint": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 120,
+ "description": "One plain phrase, for example 'free on your computer' or 'about $0.01 a minute'."
+ },
+ "driving": {
+ "type": "boolean",
+ "default": false,
+ "description": "True while the person drives this Computer (they took it over): the agent's input actions are refused, and Give it back hands it over again."
+ }
+ }
+ }
+ }
}
}
},
},
"events.delivery-policy": {
"events.delivery-policy": {
@@ -84482,6 +84541,9 @@
@@ -84482,6 +84541,9 @@
"is_error": {
"is_error": {
"type": "boolean"
"type": "boolean"
},
},
+ "computer": {
+ "$ref": "../platform/task.v1.json#/$defs/computer"
+ },
"artifacts": {
"artifacts": {
"type": "array",
"type": "array",
"maxItems": 20,
"maxItems": 20,
@@ -92330,6 +92392,23 @@
@@ -92330,6 +92392,23 @@
"type": "null"
"type": "null"
}
}
]
]
+ },
+ "task_id": {
+ "anyOf": [
+ {
+ "type": "string",
+ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries."
+ },
+ "curtain": {
+ "type": "boolean",
+ "default": false,
+ "description": "Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain."
}
}
},
},
"allOf": [
"allOf": [
@@ -92653,6 +92732,11 @@
@@ -92653,6 +92732,11 @@
},
},
"idempotency_key": {
"idempotency_key": {
"$ref": "session.v1.json#/$defs/idempotency_key"
"$ref": "session.v1.json#/$defs/idempotency_key"
+ },
+ "task_id": {
+ "type": "string",
+ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The OpenVibe.Actor task that asks for this session (plan 2026-11-07: one id across Surf, Computer and Actor). It is carried back on run.session@1, so the session and the task point at each other."
}
}
},
},
"examples": [
"examples": [
@@ -92899,6 +92983,12 @@
@@ -92899,6 +92983,12 @@
},
},
"idempotency_key": {
"idempotency_key": {
"$ref": "../../run/session.v1.json#/properties/idempotency_key"
"$ref": "../../run/session.v1.json#/properties/idempotency_key"
+ },
+ "task_id": {
+ "$ref": "../../run/session.v1.json#/properties/task_id"
+ },
+ "curtain": {
+ "$ref": "../../run/session.v1.json#/properties/curtain"
}
}
}
}
}
}
@@ -92975,6 +93065,12 @@
@@ -92975,6 +93065,12 @@
},
},
"idempotency_key": {
"idempotency_key": {
"$ref": "../../run/session.v1.json#/properties/idempotency_key"
"$ref": "../../run/session.v1.json#/properties/idempotency_key"
+ },
+ "task_id": {
+ "$ref": "../../run/session.v1.json#/properties/task_id"
+ },
+ "curtain": {
+ "$ref": "../../run/session.v1.json#/properties/curtain"
}
}
}
}
}
}
@@ -108487,6 +108583,9 @@
@@ -108487,6 +108583,9 @@
],
],
"maxLength": 240
"maxLength": 240
},
},
+ "computer": {
+ "$ref": "../platform/task.v1.json#/$defs/computer"
+ },
"approval": {
"approval": {
"type": [
"type": [
"object",
"object",
@@ -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.326.0",
- "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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"
@@ -2094,7 +2094,7 @@
@@ -2094,7 +2094,7 @@
"post": {
"post": {
"operationId": "post_api_v1_tasks",
"operationId": "post_api_v1_tasks",
"summary": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget.",
"summary": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget.",
- "description": "**actor.task.create** (public): Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",
+ "description": "**actor.task.create** (public): Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. POST /api/v1/tasks/:id/takeover gives the person the Computer the task opened (the agent's input is refused while they drive) and POST /api/v1/tasks/:id/giveback hands it back; both are the task's own person's, built on the same hand-off the agent's hand_to_person tool uses. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",
"tags": [
"tags": [
"actor.task"
"actor.task"
],
],
@@ -2149,8 +2149,8 @@
@@ -2149,8 +2149,8 @@
"/api/v1/tasks/{id}": {
"/api/v1/tasks/{id}": {
"get": {
"get": {
"operationId": "get_api_v1_tasks_id",
"operationId": "get_api_v1_tasks_id",
- "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (sta",
- "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the files and charts a tool made, the end), resumable with Last-Event-ID. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",
+ "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of",
+ "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the Computer, the files and charts a tool made, the end), resumable with Last-Event-ID. GET /api/v1/tasks/:id/still answers the Computer's newest frame as a small JPEG (at most once a second, the curtain picture while Curtain now is up), fetched from the session's own service as the person. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",
"tags": [
"tags": [
"actor.task"
"actor.task"
],
],
@@ -2205,8 +2205,8 @@
@@ -2205,8 +2205,8 @@
"/api/v1/tasks/{id}/artifacts/{mediaId}": {
"/api/v1/tasks/{id}/artifacts/{mediaId}": {
"get": {
"get": {
"operationId": "get_api_v1_tasks_id_artifacts_mediaId",
"operationId": "get_api_v1_tasks_id_artifacts_mediaId",
- "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (sta",
- "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the files and charts a tool made, the end), resumable with Last-Event-ID. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",
+ "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of",
+ "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the Computer, the files and charts a tool made, the end), resumable with Last-Event-ID. GET /api/v1/tasks/:id/still answers the Computer's newest frame as a small JPEG (at most once a second, the curtain picture while Curtain now is up), fetched from the session's own service as the person. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",
"tags": [
"tags": [
"actor.task"
"actor.task"
],
],
@@ -2270,7 +2270,7 @@
@@ -2270,7 +2270,7 @@
"post": {
"post": {
"operationId": "post_api_v1_tasks_id_cancel",
"operationId": "post_api_v1_tasks_id_cancel",
"summary": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget.",
"summary": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget.",
- "description": "**actor.task.create** (public): Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",
+ "description": "**actor.task.create** (public): Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. POST /api/v1/tasks/:id/takeover gives the person the Computer the task opened (the agent's input is refused while they drive) and POST /api/v1/tasks/:id/giveback hands it back; both are the task's own person's, built on the same hand-off the agent's hand_to_person tool uses. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",
"tags": [
"tags": [
"actor.task"
"actor.task"
],
],
@@ -2335,8 +2335,8 @@
@@ -2335,8 +2335,8 @@
"/api/v1/tasks/{id}/events": {
"/api/v1/tasks/{id}/events": {
"get": {
"get": {
"operationId": "get_api_v1_tasks_id_events",
"operationId": "get_api_v1_tasks_id_events",
- "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (sta",
- "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the files and charts a tool made, the end), resumable with Last-Event-ID. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",
+ "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of",
+ "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the Computer, the files and charts a tool made, the end), resumable with Last-Event-ID. GET /api/v1/tasks/:id/still answers the Computer's newest frame as a small JPEG (at most once a second, the curtain picture while Curtain now is up), fetched from the session's own service as the person. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",
"tags": [
"tags": [
"actor.task"
"actor.task"
],
],
@@ -2388,6 +2388,194 @@
@@ -2388,6 +2388,194 @@
}
}
}
}
},
},
+ "/api/v1/tasks/{id}/giveback": {
+ "post": {
+ "operationId": "post_api_v1_tasks_id_giveback",
+ "summary": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget.",
+ "description": "**actor.task.create** (public): Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. POST /api/v1/tasks/:id/takeover gives the person the Computer the task opened (the agent's input is refused while they drive) and POST /api/v1/tasks/:id/giveback hands it back; both are the task's own person's, built on the same hand-off the agent's hand_to_person tool uses. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",
+ "tags": [
+ "actor.task"
+ ],
+ "x-openvibe-capabilities": [
+ "actor.task.create"
+ ],
+ "x-openvibe-visibility": [
+ "public"
+ ],
+ "x-openvibe-quota-class": "actor-task",
+ "security": [
+ {
+ "openvibeToken": [
+ "actor.task.create"
+ ]
+ }
+ ],
+ "requestBody": {
+ "required": false,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/actor.task-create-request.v1"
+ }
+ }
+ }
+ },
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "2XX": {
+ "description": "Success",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/platform.task.v1"
+ }
+ }
+ }
+ },
+ "default": {
+ "description": "An error (RFC 9457 problem details)",
+ "content": {
+ "application/problem+json": {
+ "schema": {
+ "$ref": "#/components/schemas/errors.problem.v1"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/api/v1/tasks/{id}/still": {
+ "get": {
+ "operationId": "get_api_v1_tasks_id_still",
+ "summary": "Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of",
+ "description": "**actor.task.read** (public): Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the Computer, the files and charts a tool made, the end), resumable with Last-Event-ID. GET /api/v1/tasks/:id/still answers the Computer's newest frame as a small JPEG (at most once a second, the curtain picture while Curtain now is up), fetched from the session's own service as the person. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",
+ "tags": [
+ "actor.task"
+ ],
+ "x-openvibe-capabilities": [
+ "actor.task.read"
+ ],
+ "x-openvibe-visibility": [
+ "public"
+ ],
+ "x-openvibe-quota-class": "actor-read",
+ "security": [
+ {
+ "openvibeToken": [
+ "actor.task.read"
+ ]
+ }
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "2XX": {
+ "description": "Success",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/platform.task.v1"
+ }
+ }
+ }
+ },
+ "default": {
+ "description": "An error (RFC 9457 problem details)",
+ "content": {
+ "application/problem+json": {
+ "schema": {
+ "$ref": "#/components/schemas/errors.problem.v1"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/api/v1/tasks/{id}/takeover": {
+ "post": {
+ "operationId": "post_api_v1_tasks_id_takeover",
+ "summary": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget.",
+ "description": "**actor.task.create** (public): Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. POST /api/v1/tasks/:id/takeover gives the person the Computer the task opened (the agent's input is refused while they drive) and POST /api/v1/tasks/:id/giveback hands it back; both are the task's own person's, built on the same hand-off the agent's hand_to_person tool uses. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",
+ "tags": [
+ "actor.task"
+ ],
+ "x-openvibe-capabilities": [
+ "actor.task.create"
+ ],
+ "x-openvibe-visibility": [
+ "public"
+ ],
+ "x-openvibe-quota-class": "actor-task",
+ "security": [
+ {
+ "openvibeToken": [
+ "actor.task.create"
+ ]
+ }
+ ],
+ "requestBody": {
+ "required": false,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/actor.task-create-request.v1"
+ }
+ }
+ }
+ },
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "2XX": {
+ "description": "Success",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/platform.task.v1"
+ }
+ }
+ }
+ },
+ "default": {
+ "description": "An error (RFC 9457 problem details)",
+ "content": {
+ "application/problem+json": {
+ "schema": {
+ "$ref": "#/components/schemas/errors.problem.v1"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
"/internal/config": {
"/internal/config": {
"get": {
"get": {
"operationId": "get_internal_config",
"operationId": "get_internal_config",
@@ -4111,6 +4299,9 @@
@@ -4111,6 +4299,9 @@
],
],
"maxLength": 240
"maxLength": 240
},
},
+ "computer": {
+ "$ref": "#/components/schemas/platform.task.v1/$defs/computer"
+ },
"approval": {
"approval": {
"type": [
"type": [
"object",
"object",
@@ -5662,6 +5853,9 @@
@@ -5662,6 +5853,9 @@
"full"
"full"
],
],
"description": "The agent contact's own level, before the thread's level is raised above it."
"description": "The agent contact's own level, before the thread's level is raised above it."
+ },
+ "computer": {
+ "$ref": "#/components/schemas/platform.task.v1/$defs/computer"
}
}
},
},
"allOf": [
"allOf": [
@@ -5839,7 +6033,63 @@
@@ -5839,7 +6033,63 @@
"cancel": null,
"cancel": null,
"progress": null
"progress": null
}
}
- ]
+ ],
+ "$defs": {
+ "computer": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "description": "The Computer a running task opened (plan 2026-11-07: Surf, Computer and Actor are one experience): a browser or desktop session, wherever it runs. It is the one id every surface reads — Surf's task card, the Dock's step and Actor's conversation — never a copy. Present while the task holds it; null once it ended. session_id is the session on the service that owns it (OpenVibe.Run's ses_…); when the desk runs directly on one of the person's own machines through OpenVibe.Bot there is no Run session and it is null. machine is the person's own word for where it runs (their computer's name, or 'a shared desk host'). where: yours (one of their own machines), home (a desk host someone offers at home) or network (an OpenVibe desk host). cost_hint is one plain phrase about what it costs.",
+ "required": [
+ "session_id",
+ "machine",
+ "where"
+ ],
+ "properties": {
+ "session_id": {
+ "anyOf": [
+ {
+ "type": "string",
+ "pattern": "^ses_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "OpenVibe.Run's session id (ses_…), or null when the desk runs directly on the person's machine through OpenVibe.Bot."
+ },
+ "machine": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 80,
+ "description": "The person's word for it: their computer's name, or a desk host."
+ },
+ "where": {
+ "enum": [
+ "yours",
+ "home",
+ "network"
+ ],
+ "description": "yours: one of the person's own machines; home: a desk host someone offers at home; network: an OpenVibe desk host."
+ },
+ "cost_hint": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 120,
+ "description": "One plain phrase, for example 'free on your computer' or 'about $0.01 a minute'."
+ },
+ "driving": {
+ "type": "boolean",
+ "default": false,
+ "description": "True while the person drives this Computer (they took it over): the agent's input actions are refused, and Give it back hands it over again."
+ }
+ }
+ }
+ }
}
}
},
},
"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.AI API",
"title": "OpenVibe.AI API",
- "version": "0.326.0",
- "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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"
@@ -4141,6 +4141,23 @@
@@ -4141,6 +4141,23 @@
"type": "null"
"type": "null"
}
}
]
]
+ },
+ "task_id": {
+ "anyOf": [
+ {
+ "type": "string",
+ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries."
+ },
+ "curtain": {
+ "type": "boolean",
+ "default": false,
+ "description": "Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain."
}
}
},
},
"allOf": [
"allOf": [
@@ -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.326.0",
- "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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 Connect API",
"title": "OpenVibe Connect API",
- "version": "0.326.0",
- "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.Design API",
"title": "OpenVibe.Design API",
- "version": "0.326.0",
- "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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"
@@ -5,7 +5,7 @@
@@ -5,7 +5,7 @@
"service": "actor",
"service": "actor",
"name": "OpenVibe.Actor",
"name": "OpenVibe.Actor",
"origin": "https://openvibe.actor",
"origin": "https://openvibe.actor",
- "operations": 46,
+ "operations": 49,
"capabilities": 14
"capabilities": 14
},
},
{
{
@@ -208,7 +208,7 @@
@@ -208,7 +208,7 @@
"service": "run",
"service": "run",
"name": "OpenVibe.Run",
"name": "OpenVibe.Run",
"origin": "https://openvibe.run",
"origin": "https://openvibe.run",
- "operations": 12,
+ "operations": 14,
"capabilities": 9
"capabilities": 9
},
},
{
{
@@ -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.326.0",
- "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.Reviews API",
"title": "OpenVibe.Reviews API",
- "version": "0.326.0",
- "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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"
@@ -515,8 +515,8 @@
@@ -515,8 +515,8 @@
"/api/v1/sessions": {
"/api/v1/sessions": {
"get": {
"get": {
"operationId": "get_api_v1_sessions",
"operationId": "get_api_v1_sessions",
- "summary": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1) and GET /api/v1/sessions/:id (run.session@1: state, where it runs, timings, desk-seconds).",
- "description": "**run.session.read** (public): Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1) and GET /api/v1/sessions/:id (run.session@1: state, where it runs, timings, desk-seconds). Never another person's.",
+ "summary": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/session",
+ "description": "**run.session.read** (public): Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/sessions/:id/still (the desk's newest frame as a small JPEG, at most once a second, or the curtain picture while Curtain now is up). Never another person's: anyone else gets 404, a signed-out visitor included.",
"tags": [
"tags": [
"run.session"
"run.session"
],
],
@@ -615,8 +615,8 @@
@@ -615,8 +615,8 @@
"/api/v1/sessions/{id}": {
"/api/v1/sessions/{id}": {
"get": {
"get": {
"operationId": "get_api_v1_sessions_id",
"operationId": "get_api_v1_sessions_id",
- "summary": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1) and GET /api/v1/sessions/:id (run.session@1: state, where it runs, timings, desk-seconds).",
- "description": "**run.session.read** (public): Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1) and GET /api/v1/sessions/:id (run.session@1: state, where it runs, timings, desk-seconds). Never another person's.",
+ "summary": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/session",
+ "description": "**run.session.read** (public): Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/sessions/:id/still (the desk's newest frame as a small JPEG, at most once a second, or the curtain picture while Curtain now is up). Never another person's: anyone else gets 404, a signed-out visitor included.",
"tags": [
"tags": [
"run.session"
"run.session"
],
],
@@ -671,8 +671,74 @@
@@ -671,8 +671,74 @@
"/api/v1/sessions/{id}/commands": {
"/api/v1/sessions/{id}/commands": {
"post": {
"post": {
"operationId": "post_api_v1_sessions_id_commands",
"operationId": "post_api_v1_sessions_id_commands",
- "summary": "Use and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-resul",
- "description": "**run.session.control** (public): Use and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.",
+ "summary": "Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-cont",
+ "description": "**run.session.control** (public): Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1), POST /api/v1/sessions/:id/curtain ({ up }: the privacy screen the still honors) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.",
+ "tags": [
+ "run.session"
+ ],
+ "x-openvibe-capabilities": [
+ "run.session.control"
+ ],
+ "x-openvibe-visibility": [
+ "public"
+ ],
+ "x-openvibe-quota-class": "run-write",
+ "security": [
+ {
+ "openvibeToken": [
+ "run.session.control"
+ ]
+ }
+ ],
+ "requestBody": {
+ "required": false,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/run.session-control-request.v1"
+ }
+ }
+ }
+ },
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "2XX": {
+ "description": "Success",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/run.session-control-result.v1"
+ }
+ }
+ }
+ },
+ "default": {
+ "description": "An error (RFC 9457 problem details)",
+ "content": {
+ "application/problem+json": {
+ "schema": {
+ "$ref": "#/components/schemas/errors.problem.v1"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/api/v1/sessions/{id}/curtain": {
+ "post": {
+ "operationId": "post_api_v1_sessions_id_curtain",
+ "summary": "Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-cont",
+ "description": "**run.session.control** (public): Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1), POST /api/v1/sessions/:id/curtain ({ up }: the privacy screen the still honors) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.",
"tags": [
"tags": [
"run.session"
"run.session"
],
],
@@ -737,8 +803,8 @@
@@ -737,8 +803,8 @@
"/api/v1/sessions/{id}/end": {
"/api/v1/sessions/{id}/end": {
"post": {
"post": {
"operationId": "post_api_v1_sessions_id_end",
"operationId": "post_api_v1_sessions_id_end",
- "summary": "Use and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-resul",
- "description": "**run.session.control** (public): Use and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.",
+ "summary": "Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-cont",
+ "description": "**run.session.control** (public): Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1), POST /api/v1/sessions/:id/curtain ({ up }: the privacy screen the still honors) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.",
"tags": [
"tags": [
"run.session"
"run.session"
],
],
@@ -799,6 +865,62 @@
@@ -799,6 +865,62 @@
}
}
}
}
}
}
+ },
+ "/api/v1/sessions/{id}/still": {
+ "get": {
+ "operationId": "get_api_v1_sessions_id_still",
+ "summary": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/session",
+ "description": "**run.session.read** (public): Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/sessions/:id/still (the desk's newest frame as a small JPEG, at most once a second, or the curtain picture while Curtain now is up). Never another person's: anyone else gets 404, a signed-out visitor included.",
+ "tags": [
+ "run.session"
+ ],
+ "x-openvibe-capabilities": [
+ "run.session.read"
+ ],
+ "x-openvibe-visibility": [
+ "public"
+ ],
+ "x-openvibe-quota-class": "run-read",
+ "security": [
+ {
+ "openvibeToken": [
+ "run.session.read"
+ ]
+ }
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "2XX": {
+ "description": "Success",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/run.session.v1"
+ }
+ }
+ }
+ },
+ "default": {
+ "description": "An error (RFC 9457 problem details)",
+ "content": {
+ "application/problem+json": {
+ "schema": {
+ "$ref": "#/components/schemas/errors.problem.v1"
+ }
+ }
+ }
+ }
+ }
+ }
}
}
},
},
"components": {
"components": {
@@ -2170,6 +2292,11 @@
@@ -2170,6 +2292,11 @@
},
},
"idempotency_key": {
"idempotency_key": {
"$ref": "#/components/schemas/run.session.v1/$defs/idempotency_key"
"$ref": "#/components/schemas/run.session.v1/$defs/idempotency_key"
+ },
+ "task_id": {
+ "type": "string",
+ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The OpenVibe.Actor task that asks for this session (plan 2026-11-07: one id across Surf, Computer and Actor). It is carried back on run.session@1, so the session and the task point at each other."
}
}
},
},
"examples": [
"examples": [
@@ -2284,6 +2411,23 @@
@@ -2284,6 +2411,23 @@
"type": "null"
"type": "null"
}
}
]
]
+ },
+ "task_id": {
+ "anyOf": [
+ {
+ "type": "string",
+ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries."
+ },
+ "curtain": {
+ "type": "boolean",
+ "default": false,
+ "description": "Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain."
}
}
},
},
"allOf": [
"allOf": [
@@ -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.326.0",
- "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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.326.0",
- "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.326.0): each operation lists the capabilities it performs; a token for 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.327.0",
+ "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.327.0): each operation lists the capabilities it performs; a token for 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"
@@ -211235,6 +211235,31 @@ export type Task = {
@@ -211235,6 +211235,31 @@ export type Task = {
* The agent contact's own level, before the thread's level is raised above it.
* The agent contact's own level, before the thread's level is raised above it.
*/
*/
agent_level?: "ask" | "auto-edits" | "approve-for-me" | "full";
agent_level?: "ask" | "auto-edits" | "approve-for-me" | "full";
+ /**
+ * The Computer a running task opened (plan 2026-11-07: Surf, Computer and Actor are one experience): a browser or desktop session, wherever it runs. It is the one id every surface reads — Surf's task card, the Dock's step and Actor's conversation — never a copy. Present while the task holds it; null once it ended. session_id is the session on the service that owns it (OpenVibe.Run's ses_…); when the desk runs directly on one of the person's own machines through OpenVibe.Bot there is no Run session and it is null. machine is the person's own word for where it runs (their computer's name, or 'a shared desk host'). where: yours (one of their own machines), home (a desk host someone offers at home) or network (an OpenVibe desk host). cost_hint is one plain phrase about what it costs.
+ */
+ computer?: {
+ /**
+ * OpenVibe.Run's session id (ses_…), or null when the desk runs directly on the person's machine through OpenVibe.Bot.
+ */
+ session_id: string | null;
+ /**
+ * The person's word for it: their computer's name, or a desk host.
+ */
+ machine: string;
+ /**
+ * yours: one of the person's own machines; home: a desk host someone offers at home; network: an OpenVibe desk host.
+ */
+ where: "yours" | "home" | "network";
+ /**
+ * One plain phrase, for example 'free on your computer' or 'about $0.01 a minute'.
+ */
+ cost_hint?: string | null;
+ /**
+ * True while the person drives this Computer (they took it over): the agent's input actions are refused, and Give it back hands it over again.
+ */
+ driving?: boolean;
+ } | null;
};
};
/** [email protected] (owner: events) */
/** [email protected] (owner: events) */
@@ -274038,6 +274063,14 @@ export type RunSession = {
@@ -274038,6 +274063,14 @@ export type RunSession = {
desk_seconds: number;
desk_seconds: number;
};
};
idempotency_key: string | null;
idempotency_key: string | null;
+ /**
+ * The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries.
+ */
+ task_id?: string | null;
+ /**
+ * Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain.
+ */
+ curtain?: boolean;
};
};
/** [email protected] (owner: run) */
/** [email protected] (owner: run) */
@@ -274068,6 +274101,10 @@ export interface RunSessionCreateRequest {
@@ -274068,6 +274101,10 @@ export interface RunSessionCreateRequest {
machine?: string;
machine?: string;
requirements?: WorkloadRequirements;
requirements?: WorkloadRequirements;
idempotency_key?: string;
idempotency_key?: string;
+ /**
+ * The OpenVibe.Actor task that asks for this session (plan 2026-11-07: one id across Surf, Computer and Actor). It is carried back on run.session@1, so the session and the task point at each other.
+ */
+ task_id?: string;
}
}
/** [email protected] (owner: run) */
/** [email protected] (owner: run) */
@@ -274197,6 +274234,14 @@ export interface RunSessionStartedPayload {
@@ -274197,6 +274234,14 @@ export interface RunSessionStartedPayload {
desk_seconds: number;
desk_seconds: number;
};
};
idempotency_key: string | null;
idempotency_key: string | null;
+ /**
+ * The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries.
+ */
+ task_id?: string | null;
+ /**
+ * Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain.
+ */
+ curtain?: boolean;
}
}
/** [email protected] (owner: run) */
/** [email protected] (owner: run) */
@@ -274287,6 +274332,14 @@ export interface RunSessionEndedPayload {
@@ -274287,6 +274332,14 @@ export interface RunSessionEndedPayload {
desk_seconds: number;
desk_seconds: number;
};
};
idempotency_key: string | null;
idempotency_key: string | null;
+ /**
+ * The OpenVibe.Actor task that asked for this session (plan 2026-11-07: one id across Surf, Computer and Actor). Null when a person opened it themselves. The session is the Computer the task's record carries.
+ */
+ task_id?: string | null;
+ /**
+ * Curtain now (the privacy screen): while it is up the session's still answers the curtain picture, never the screen. The person raises and lifts it with POST /api/v1/sessions/{id}/curtain.
+ */
+ curtain?: boolean;
}
}
/** [email protected] (owner: bot) */
/** [email protected] (owner: bot) */
@@ -300806,6 +300859,31 @@ export interface AgentTimelineEntry {
@@ -300806,6 +300859,31 @@ export interface AgentTimelineEntry {
link?: string | null;
link?: string | null;
reason?: string | null;
reason?: string | null;
transition?: string | null;
transition?: string | null;
+ /**
+ * The Computer a running task opened (plan 2026-11-07: Surf, Computer and Actor are one experience): a browser or desktop session, wherever it runs. It is the one id every surface reads — Surf's task card, the Dock's step and Actor's conversation — never a copy. Present while the task holds it; null once it ended. session_id is the session on the service that owns it (OpenVibe.Run's ses_…); when the desk runs directly on one of the person's own machines through OpenVibe.Bot there is no Run session and it is null. machine is the person's own word for where it runs (their computer's name, or 'a shared desk host'). where: yours (one of their own machines), home (a desk host someone offers at home) or network (an OpenVibe desk host). cost_hint is one plain phrase about what it costs.
+ */
+ computer?: {
+ /**
+ * OpenVibe.Run's session id (ses_…), or null when the desk runs directly on the person's machine through OpenVibe.Bot.
+ */
+ session_id: string | null;
+ /**
+ * The person's word for it: their computer's name, or a desk host.
+ */
+ machine: string;
+ /**
+ * yours: one of the person's own machines; home: a desk host someone offers at home; network: an OpenVibe desk host.
+ */
+ where: "yours" | "home" | "network";
+ /**
+ * One plain phrase, for example 'free on your computer' or 'about $0.01 a minute'.
+ */
+ cost_hint?: string | null;
+ /**
+ * True while the person drives this Computer (they took it over): the agent's input actions are refused, and Give it back hands it over again.
+ */
+ driving?: boolean;
+ } | null;
/**
/**
* The approval this step waits on, and the mode that owns it. The person answers it in the mode.
* The approval this step waits on, and the mode that owns it. The person answers it in the mode.
*/
*/
@@ -5,7 +5,7 @@
@@ -5,7 +5,7 @@
"status": "active",
"status": "active",
"visibility": "public",
"visibility": "public",
"sensitive": true,
"sensitive": true,
- "description": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",
+ "description": "Give OpenVibe.Actor a task: POST /api/v1/tasks with the task in plain words, a mode (cheapest, balanced, best, fastest, private) and a budget. Actor picks the agent system for it with openvibe-sdk/placement, runs it, has a second model family check the result, and records the result, the cost to the cent and the explanation on the task (platform.task@1, answered 201 with state queued). POST /api/v1/tasks/:id/cancel stops a task that has not ended. POST /api/v1/tasks/:id/takeover gives the person the Computer the task opened (the agent's input is refused while they drive) and POST /api/v1/tasks/:id/giveback hands it back; both are the task's own person's, built on the same hand-off the agent's hand_to_person tool uses. A person's tasks are theirs; a token that names a project puts the task in that project. Each person has a daily free allowance; a task whose cheapest eligible agent would cost more than its budget fails with actor.budget.exceeded instead of running. A task may register webhooks: Actor POSTs actor.task-webhook@1 to each on the state changes it asked for, signed with a secret minted for the task and returned once, as webhook_secret, in the answer that created it.",
"inputSchema": "actor.task-create-request@1",
"inputSchema": "actor.task-create-request@1",
"outputSchema": "platform.task@1",
"outputSchema": "platform.task@1",
"permissions": [
"permissions": [
@@ -19,6 +19,8 @@
@@ -19,6 +19,8 @@
"events": [],
"events": [],
"implementedBy": [
"implementedBy": [
"POST /api/v1/tasks",
"POST /api/v1/tasks",
- "POST /api/v1/tasks/:id/cancel"
+ "POST /api/v1/tasks/:id/cancel",
+ "POST /api/v1/tasks/:id/takeover",
+ "POST /api/v1/tasks/:id/giveback"
]
]
}
}
@@ -4,7 +4,7 @@
@@ -4,7 +4,7 @@
"owner": "actor",
"owner": "actor",
"status": "active",
"status": "active",
"visibility": "public",
"visibility": "public",
- "description": "Read one of your tasks (platform.task@1: state, result, cost, explanation) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the files and charts a tool made, the end), resumable with Last-Event-ID. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",
+ "description": "Read one of your tasks (platform.task@1: state, result, cost, explanation, the Computer it opened) with GET /api/v1/tasks/:id, and watch it live with GET /api/v1/tasks/:id/events: text/event-stream of actor.task-event@2 (state changes, the agent's steps, the Computer, the files and charts a tool made, the end), resumable with Last-Event-ID. GET /api/v1/tasks/:id/still answers the Computer's newest frame as a small JPEG (at most once a second, the curtain picture while Curtain now is up), fetched from the session's own service as the person. A file or chart the task made is opened with GET /api/v1/tasks/:id/artifacts/:mediaId, which answers a redirect to a fresh signed OpenVibe.Media URL: the object is private to the task's requester. Only the task's requester (or its project's tokens) can read it.",
"inputSchema": "common.no-body@1",
"inputSchema": "common.no-body@1",
"outputSchema": "platform.task@1",
"outputSchema": "platform.task@1",
"permissions": [
"permissions": [
@@ -19,6 +19,7 @@
@@ -19,6 +19,7 @@
"implementedBy": [
"implementedBy": [
"GET /api/v1/tasks/:id",
"GET /api/v1/tasks/:id",
"GET /api/v1/tasks/:id/events",
"GET /api/v1/tasks/:id/events",
+ "GET /api/v1/tasks/:id/still",
"GET /api/v1/tasks/:id/artifacts/:mediaId"
"GET /api/v1/tasks/:id/artifacts/:mediaId"
]
]
}
}
@@ -4,7 +4,7 @@
@@ -4,7 +4,7 @@
"owner": "run",
"owner": "run",
"status": "active",
"status": "active",
"visibility": "public",
"visibility": "public",
- "description": "Use and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.",
+ "description": "Use, curtain and end your own browser session: POST /api/v1/sessions/:id/commands with run.session-control-request@1 (screen, input and browser on the session's desk only, answered by run.session-control-result@1), POST /api/v1/sessions/:id/curtain ({ up }: the privacy screen the still honors) and POST /api/v1/sessions/:id/end (run.session@1, ended). Nothing else on the machine it runs on is reachable.",
"inputSchema": "run.session-control-request@1",
"inputSchema": "run.session-control-request@1",
"outputSchema": "run.session-control-result@1",
"outputSchema": "run.session-control-result@1",
"permissions": [
"permissions": [
@@ -19,6 +19,7 @@
@@ -19,6 +19,7 @@
],
],
"implementedBy": [
"implementedBy": [
"POST /api/v1/sessions/:id/commands",
"POST /api/v1/sessions/:id/commands",
+ "POST /api/v1/sessions/:id/curtain",
"POST /api/v1/sessions/:id/end"
"POST /api/v1/sessions/:id/end"
]
]
}
}
@@ -4,7 +4,7 @@
@@ -4,7 +4,7 @@
"owner": "run",
"owner": "run",
"status": "active",
"status": "active",
"visibility": "public",
"visibility": "public",
- "description": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1) and GET /api/v1/sessions/:id (run.session@1: state, where it runs, timings, desk-seconds). Never another person's.",
+ "description": "Read your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task_id, timings, desk-seconds) and GET /api/v1/sessions/:id/still (the desk's newest frame as a small JPEG, at most once a second, or the curtain picture while Curtain now is up). Never another person's: anyone else gets 404, a signed-out visitor included.",
"inputSchema": "common.no-body@1",
"inputSchema": "common.no-body@1",
"outputSchema": "run.session@1",
"outputSchema": "run.session@1",
"permissions": [
"permissions": [
@@ -17,6 +17,7 @@
@@ -17,6 +17,7 @@
"events": [],
"events": [],
"implementedBy": [
"implementedBy": [
"GET /api/v1/sessions",
"GET /api/v1/sessions",
- "GET /api/v1/sessions/:id"
+ "GET /api/v1/sessions/:id",
+ "GET /api/v1/sessions/:id/still"
]
]
}
}
@@ -1,12 +1,12 @@
@@ -1,12 +1,12 @@
{
{
"name": "openvibe-contracts",
"name": "openvibe-contracts",
- "version": "0.315.0",
+ "version": "0.327.0",
"lockfileVersion": 3,
"lockfileVersion": 3,
"requires": true,
"requires": true,
"packages": {
"packages": {
"": {
"": {
"name": "openvibe-contracts",
"name": "openvibe-contracts",
- "version": "0.315.0",
+ "version": "0.327.0",
"license": "AGPL-3.0-only",
"license": "AGPL-3.0-only",
"dependencies": {
"dependencies": {
"ajv": "^8.17.1",
"ajv": "^8.17.1",
@@ -1,6 +1,6 @@
@@ -1,6 +1,6 @@
{
{
"name": "openvibe-contracts",
"name": "openvibe-contracts",
- "version": "0.326.0",
+ "version": "0.327.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",