openvibers/openvibe.contracts Commits
codes.task@2 — a coding task's attempts and outcome (#250)
Changes
@@@ -4,6 +4,31 @@ All notable changes to `openvibe-contracts`. Releases are git tags (`vX.Y.Z`) thfrom `https://codeload.github.com/OpenVibers/OpenVibe.Contracts/tar.gz/refs/tags/<tag>`. Before v0.30.0,the notes were in the tag and commit messages (`git tag -n1`).++## 0.243.0 — 2026-10-30++++- The release cut from `main` for codes.task@2 (#250): a coding task's attempts and outcome, one id with two majors.++ It carries 0.241.0 (the AI credential v2 release) as well. `v0.242.0` and `v0.242.1` were tagged from the PR++ branch before it merged; pin `v0.243.0` instead (OpenVibe.Codes moves to it).++++## 0.242.1 — 2026-10-30++++- The generated OpenAPI files carry the release's own version again: `v0.242.0` shipped them with 0.240.0's,++ because the version was raised after they were written. Nothing else changed; `v0.242.1` is the release to pin.++- This release is rebased on `0.241.0` (the AI credential v2 release, merged while it was being written), so the++ branch carries that work too; the published `v0.242.1` tarball, which OpenVibe.Codes pins, is the cut from++ before the rebase and holds the codes.task@2 work alone. The next tag cut from `main` carries both.++++## 0.242.0 — 2026-10-30++++- **`codes.task@2`** (OpenVibe.Codes): a coding task's timeline. It is `codes.task@1` with the same fields, plus two++ added ones: `attempts` (every try of the task, in order: the agent, the machine, the session, the state it ended++ in, why, what it cost) and `outcome` (what the attempts added up to: done, unfinished with what is left, or++ stopped). `GET /api/v1/tasks/:id` answers it — the task's own fields stay at the top level, exactly as++ `codes.task@1` had them, and the two new fields are added to them. `codes.task@1` stays as it is.++- **One contract id may hold more than one major** now: the catalog lists a v1 and a v2 file for the same id, the++ bare id resolves to the newest major, and `id@N` names that major, so a v1 caller keeps resolving while a v2++ caller names it exactly. (`ai.credential@2` is the first to use it.)++## 0.241.0 — 2026-10-30- **AI: one credential per provider** (Codes C3; research `research-2026-10-30/codes-c3-connections.md` items 1 and 2).@@@ -2385,7 +2410,6 @@ as `worker:` capabilities in `platform.resource-offer@1`. The names are reserved`task:edit`, `task:review`, `task:browse`, `task:run`, `task:test`, `task:plan`, `harness:mcp`, `harness:resume`,`harness:host-access`, `harness:long-autonomy`. New valid fixture `harness-task-routing`. Additive.--**Run jobs and their metering** (plan T14 lane G, follow-up 1 of the Node gap audit):- New `platform.runtime-class@1`: the classes `function`, `code`, `browser`, `linux`, `desktop` and `gpu`, namesonly; `function` is the first one implemented.@@@ -7387,6 +7387,15 @@"compatibility": "backward","status": "active"},++ {++ "id": "codes.task",++ "version": "2.0.0",++ "owner": "codes",++ "schema": "codes/task.v2.json",++ "visibility": "first-party",++ "compatibility": "backward",++ "status": "active"++ },{"id": "play.title-definition","version": "1.0.0",nnew file mode 100644@@@ -0,0 +1,388 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/codes/task.v2.json",++ "title": "CodesTask",++ "description": "codes.task@2: a coding task on OpenVibe.Codes, as GET /api/v1/tasks/:id answers it (capability codes.task.read) and POST /api/v1/tasks creates it. It is codes.task@1 with two added fields: ATTEMPTS, the task's timeline (each try of the task, with the state it ended in and why), and OUTCOME, what the task's attempts added up to (done, unfinished with what is left, or stopped). STATE follows the OpenVibe.Run job that carries it: queued (waiting for one of the person's machines), placed, running, then succeeded, failed, cancelled or expired (no machine of theirs took it in time). URL is the task's page on openvibe.codes, where its owner follows it live. RESULT is present once it has ended: OK says whether the agents finished, SUMMARY what they said, FILES and PATCH the change (the patch at most 256 KiB, PATCH_TRUNCATED when cut), PUSH where it went when asked, COST_USD the model use on the person's own keys, DURATION_MS the time on their machine. ERROR says why a task that never ran ended (Run refused it, or the job failed before a result).",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "state",++ "repo",++ "url",++ "created_at",++ "updated_at"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The Codes task id (tsk_ + ULID)."++ },++ "state": {++ "enum": [++ "queued",++ "placed",++ "running",++ "succeeded",++ "failed",++ "cancelled",++ "expired"++ ]++ },++ "repo": {++ "type": "string",++ "maxLength": 300++ },++ "ref": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 200++ },++ "agent": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 41++ },++ "url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://"++ },++ "created_at": {++ "type": "string",++ "format": "date-time"++ },++ "updated_at": {++ "type": "string",++ "format": "date-time"++ },++ "error": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 1000++ },++ "result": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "ok"++ ],++ "properties": {++ "ok": {++ "type": "boolean"++ },++ "agents": {++ "type": "array",++ "maxItems": 20,++ "items": {++ "type": "string",++ "maxLength": 41++ }++ },++ "summary": {++ "type": "string",++ "maxLength": 4000++ },++ "files": {++ "type": "array",++ "maxItems": 2000,++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "path"++ ],++ "properties": {++ "path": {++ "type": "string",++ "minLength": 1,++ "maxLength": 500++ },++ "added": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ },++ "removed": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ }++ }++ }++ },++ "patch": {++ "type": "string",++ "maxLength": 262144++ },++ "patch_truncated": {++ "type": "boolean"++ },++ "push": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "pushed"++ ],++ "properties": {++ "pushed": {++ "type": "boolean"++ },++ "branch": {++ "type": "string",++ "maxLength": 200++ },++ "branch_url": {++ "type": "string",++ "format": "uri"++ },++ "pull_request": {++ "type": "string",++ "format": "uri"++ },++ "pull_request_error": {++ "type": "string",++ "maxLength": 500++ },++ "reason": {++ "type": "string",++ "maxLength": 500++ }++ }++ },++ "cost_usd": {++ "type": "number",++ "minimum": 0++ },++ "duration_ms": {++ "type": "integer",++ "minimum": 0++ },++ "error": {++ "type": "string",++ "maxLength": 1000++ }++ }++ },++ "actor_ref": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "properties": {++ "task_id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 256++ },++ "step_id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 256++ }++ },++ "description": "The OpenVibe.Actor task and step that started this coding task, when it came from Actor."++ },++ "attempts": {++ "type": "array",++ "maxItems": 50,++ "description": "The task's timeline: every try of it, in order. The first is the task itself; the others are what the agents did after it (the same conversation carried on, another agent taking over, a last turn before a limit).",++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "n",++ "state"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The attempt id (att_ + ULID)."++ },++ "n": {++ "type": "integer",++ "minimum": 1,++ "description": "The attempt's number, 1 for the first try."++ },++ "agent": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 41++ },++ "model": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 100++ },++ "machine": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 100,++ "description": "The node that ran the attempt, or sandbox when it ran in a sandbox."++ },++ "job_id": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 64++ },++ "session": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 200,++ "description": "The harness session, so a following attempt can carry on in the same conversation."++ },++ "state": {++ "enum": [++ "queued",++ "running",++ "done",++ "failed",++ "stopped",++ "budget-stopped",++ "interrupted"++ ]++ },++ "reason": {++ "type": [++ "string",++ "null"++ ],++ "enum": [++ "limit",++ "auth",++ "capacity",++ "refused",++ "error",++ "budget",++ "stopped",++ "hung",++ "context",++ null++ ]++ },++ "why": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 1000,++ "description": "One plain sentence: why this attempt happened, or how it ended."++ },++ "kind": {++ "enum": [++ "first",++ "continue",++ "switch",++ "wrap-up",++ "restart",++ "manual"++ ]++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ },++ "tokens": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ },++ "steps": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ },++ "started_at": {++ "type": [++ "string",++ "null"++ ],++ "format": "date-time"++ },++ "finished_at": {++ "type": [++ "string",++ "null"++ ],++ "format": "date-time"++ },++ "created_at": {++ "type": "string",++ "format": "date-time"++ },++ "end_why": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 500,++ "description": "How the attempt ended, in plain words."++ }++ }++ }++ },++ "outcome": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "description": "What the task's attempts added up to: done, unfinished (with what is left), or stopped. Null while the task still runs.",++ "required": [++ "state"++ ],++ "properties": {++ "state": {++ "type": [++ "string",++ "null"++ ],++ "enum": [++ "done",++ "unfinished",++ "stopped",++ null++ ]++ },++ "note": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 1000++ }++ }++ }++ }++}nnew file mode 100644@@@ -0,0 +1,15 @@++{++ "id": "tsk_01M4XEV0JT93CAYTXVD6V0QW1E",++ "state": "succeeded",++ "repo": "https://github.com/octocat/Hello-World",++ "url": "https://openvibe.codes/run/tasks/tsk_01M4XEV0JT93CAYTXVD6V0QW1E",++ "created_at": "2026-10-29T15:00:00.000Z",++ "updated_at": "2026-10-29T15:04:12.000Z",++ "attempts": [++ {++ "id": "att_01M4XEV0JT93CAYTXVD6V0QW1F",++ "n": 1,++ "state": "gave-up"++ }++ ]++}nnew file mode 100644@@@ -0,0 +1,56 @@++{++ "id": "tsk_01M4XEV0JT93CAYTXVD6V0QW1E",++ "state": "succeeded",++ "repo": "https://github.com/octocat/Hello-World",++ "ref": null,++ "agent": "claude-code",++ "url": "https://openvibe.codes/run/tasks/tsk_01M4XEV0JT93CAYTXVD6V0QW1E",++ "created_at": "2026-10-29T15:00:00.000Z",++ "updated_at": "2026-10-29T15:04:12.000Z",++ "attempts": [++ {++ "id": "att_01M4XEV0JT93CAYTXVD6V0QW1F",++ "n": 1,++ "agent": "claude-code",++ "model": "claude-sonnet-4",++ "machine": "node-01",++ "job_id": "job_01M4XEV0JT93CAYTXVD6V0QW1G",++ "session": "sess-42",++ "state": "failed",++ "reason": "limit",++ "why": "the first try, with claude-code",++ "kind": "first",++ "cost_usd": 0.12,++ "tokens": 45000,++ "steps": 18,++ "started_at": "2026-10-29T15:00:02.000Z",++ "finished_at": "2026-10-29T15:02:40.000Z",++ "created_at": "2026-10-29T15:00:01.000Z",++ "end_why": "the usage limit was reached"++ },++ {++ "id": "att_01M4XEV0JT93CAYTXVD6V0QW1H",++ "n": 2,++ "agent": "codex",++ "model": "gpt-5-codex",++ "machine": "node-01",++ "job_id": "job_01M4XEV0JT93CAYTXVD6V0QW1J",++ "session": null,++ "state": "done",++ "reason": null,++ "why": "took over: the usage limit was reached",++ "kind": "switch",++ "cost_usd": 0.31,++ "tokens": 61000,++ "steps": 22,++ "started_at": "2026-10-29T15:02:41.000Z",++ "finished_at": "2026-10-29T15:04:10.000Z",++ "created_at": "2026-10-29T15:02:41.000Z",++ "end_why": null++ }++ ],++ "outcome": {++ "state": "done",++ "note": null++ }++}@@@ -83421,7 +83421,7 @@}}},-- "codes.task": {++ "codes.task@1": {"version": "1.1.0","owner": "codes","status": "active",@@@ -83625,6 +83625,399 @@}}},++ "codes.task@2": {++ "version": "2.0.0",++ "owner": "codes",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/codes/task.v2.json",++ "title": "CodesTask",++ "description": "codes.task@2: a coding task on OpenVibe.Codes, as GET /api/v1/tasks/:id answers it (capability codes.task.read) and POST /api/v1/tasks creates it. It is codes.task@1 with two added fields: ATTEMPTS, the task's timeline (each try of the task, with the state it ended in and why), and OUTCOME, what the task's attempts added up to (done, unfinished with what is left, or stopped). STATE follows the OpenVibe.Run job that carries it: queued (waiting for one of the person's machines), placed, running, then succeeded, failed, cancelled or expired (no machine of theirs took it in time). URL is the task's page on openvibe.codes, where its owner follows it live. RESULT is present once it has ended: OK says whether the agents finished, SUMMARY what they said, FILES and PATCH the change (the patch at most 256 KiB, PATCH_TRUNCATED when cut), PUSH where it went when asked, COST_USD the model use on the person's own keys, DURATION_MS the time on their machine. ERROR says why a task that never ran ended (Run refused it, or the job failed before a result).",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "state",++ "repo",++ "url",++ "created_at",++ "updated_at"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The Codes task id (tsk_ + ULID)."++ },++ "state": {++ "enum": [++ "queued",++ "placed",++ "running",++ "succeeded",++ "failed",++ "cancelled",++ "expired"++ ]++ },++ "repo": {++ "type": "string",++ "maxLength": 300++ },++ "ref": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 200++ },++ "agent": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 41++ },++ "url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://"++ },++ "created_at": {++ "type": "string",++ "format": "date-time"++ },++ "updated_at": {++ "type": "string",++ "format": "date-time"++ },++ "error": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 1000++ },++ "result": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "ok"++ ],++ "properties": {++ "ok": {++ "type": "boolean"++ },++ "agents": {++ "type": "array",++ "maxItems": 20,++ "items": {++ "type": "string",++ "maxLength": 41++ }++ },++ "summary": {++ "type": "string",++ "maxLength": 4000++ },++ "files": {++ "type": "array",++ "maxItems": 2000,++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "path"++ ],++ "properties": {++ "path": {++ "type": "string",++ "minLength": 1,++ "maxLength": 500++ },++ "added": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ },++ "removed": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ }++ }++ }++ },++ "patch": {++ "type": "string",++ "maxLength": 262144++ },++ "patch_truncated": {++ "type": "boolean"++ },++ "push": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "pushed"++ ],++ "properties": {++ "pushed": {++ "type": "boolean"++ },++ "branch": {++ "type": "string",++ "maxLength": 200++ },++ "branch_url": {++ "type": "string",++ "format": "uri"++ },++ "pull_request": {++ "type": "string",++ "format": "uri"++ },++ "pull_request_error": {++ "type": "string",++ "maxLength": 500++ },++ "reason": {++ "type": "string",++ "maxLength": 500++ }++ }++ },++ "cost_usd": {++ "type": "number",++ "minimum": 0++ },++ "duration_ms": {++ "type": "integer",++ "minimum": 0++ },++ "error": {++ "type": "string",++ "maxLength": 1000++ }++ }++ },++ "actor_ref": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "properties": {++ "task_id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 256++ },++ "step_id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 256++ }++ },++ "description": "The OpenVibe.Actor task and step that started this coding task, when it came from Actor."++ },++ "attempts": {++ "type": "array",++ "maxItems": 50,++ "description": "The task's timeline: every try of it, in order. The first is the task itself; the others are what the agents did after it (the same conversation carried on, another agent taking over, a last turn before a limit).",++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "n",++ "state"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The attempt id (att_ + ULID)."++ },++ "n": {++ "type": "integer",++ "minimum": 1,++ "description": "The attempt's number, 1 for the first try."++ },++ "agent": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 41++ },++ "model": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 100++ },++ "machine": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 100,++ "description": "The node that ran the attempt, or sandbox when it ran in a sandbox."++ },++ "job_id": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 64++ },++ "session": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 200,++ "description": "The harness session, so a following attempt can carry on in the same conversation."++ },++ "state": {++ "enum": [++ "queued",++ "running",++ "done",++ "failed",++ "stopped",++ "budget-stopped",++ "interrupted"++ ]++ },++ "reason": {++ "type": [++ "string",++ "null"++ ],++ "enum": [++ "limit",++ "auth",++ "capacity",++ "refused",++ "error",++ "budget",++ "stopped",++ "hung",++ "context",++ null++ ]++ },++ "why": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 1000,++ "description": "One plain sentence: why this attempt happened, or how it ended."++ },++ "kind": {++ "enum": [++ "first",++ "continue",++ "switch",++ "wrap-up",++ "restart",++ "manual"++ ]++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ },++ "tokens": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ },++ "steps": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ },++ "started_at": {++ "type": [++ "string",++ "null"++ ],++ "format": "date-time"++ },++ "finished_at": {++ "type": [++ "string",++ "null"++ ],++ "format": "date-time"++ },++ "created_at": {++ "type": "string",++ "format": "date-time"++ },++ "end_why": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 500,++ "description": "How the attempt ended, in plain words."++ }++ }++ }++ },++ "outcome": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "description": "What the task's attempts added up to: done, unfinished (with what is left), or stopped. Null while the task still runs.",++ "required": [++ "state"++ ],++ "properties": {++ "state": {++ "type": [++ "string",++ "null"++ ],++ "enum": [++ "done",++ "unfinished",++ "stopped",++ null++ ]++ },++ "note": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 1000++ }++ }++ }++ }++ }++ },"play.title-definition": {"version": "1.0.0","owner": "play",@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Actor API",-- "version": "0.241.0",-- "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.AI API",-- "version": "0.241.0",-- "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Chat API",-- "version": "0.241.0",-- "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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"@@@ -122,7 +122,7 @@"get": {"operationId": "get_api_v1_tasks_id","summary": "Read a coding task started through codes.task.start: GET /api/v1/tasks/:id on OpenVibe.Codes, as the service that started it, naming the same person in X-OV-Subject.",-- "description": "**codes.task.read** (first-party): Read a coding task started through codes.task.start: GET /api/v1/tasks/:id on OpenVibe.Codes, as the service that started it, naming the same person in X-OV-Subject. Another service's task, or another person's, is 404.",++ "description": "**codes.task.read** (first-party): Read a coding task started through codes.task.start: GET /api/v1/tasks/:id on OpenVibe.Codes, as the service that started it, naming the same person in X-OV-Subject. Another service's task, or another person's, is 404. The answer is codes.task@2: the task itself (as codes.task@1, with the same fields at the top level) and, added to it, the task's attempts (its timeline) and its outcome.","tags": ["codes.task"],@@@ -156,7 +156,7 @@"content": {"application/json": {"schema": {-- "$ref": "#/components/schemas/codes.task.v1"++ "$ref": "#/components/schemas/codes.task.v2"}}}@@@ -511,6 +511,392 @@}}},++ "codes.task.v2": {++ "title": "CodesTask",++ "description": "codes.task@2: a coding task on OpenVibe.Codes, as GET /api/v1/tasks/:id answers it (capability codes.task.read) and POST /api/v1/tasks creates it. It is codes.task@1 with two added fields: ATTEMPTS, the task's timeline (each try of the task, with the state it ended in and why), and OUTCOME, what the task's attempts added up to (done, unfinished with what is left, or stopped). STATE follows the OpenVibe.Run job that carries it: queued (waiting for one of the person's machines), placed, running, then succeeded, failed, cancelled or expired (no machine of theirs took it in time). URL is the task's page on openvibe.codes, where its owner follows it live. RESULT is present once it has ended: OK says whether the agents finished, SUMMARY what they said, FILES and PATCH the change (the patch at most 256 KiB, PATCH_TRUNCATED when cut), PUSH where it went when asked, COST_USD the model use on the person's own keys, DURATION_MS the time on their machine. ERROR says why a task that never ran ended (Run refused it, or the job failed before a result).",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "state",++ "repo",++ "url",++ "created_at",++ "updated_at"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The Codes task id (tsk_ + ULID)."++ },++ "state": {++ "enum": [++ "queued",++ "placed",++ "running",++ "succeeded",++ "failed",++ "cancelled",++ "expired"++ ]++ },++ "repo": {++ "type": "string",++ "maxLength": 300++ },++ "ref": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 200++ },++ "agent": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 41++ },++ "url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://"++ },++ "created_at": {++ "type": "string",++ "format": "date-time"++ },++ "updated_at": {++ "type": "string",++ "format": "date-time"++ },++ "error": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 1000++ },++ "result": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "ok"++ ],++ "properties": {++ "ok": {++ "type": "boolean"++ },++ "agents": {++ "type": "array",++ "maxItems": 20,++ "items": {++ "type": "string",++ "maxLength": 41++ }++ },++ "summary": {++ "type": "string",++ "maxLength": 4000++ },++ "files": {++ "type": "array",++ "maxItems": 2000,++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "path"++ ],++ "properties": {++ "path": {++ "type": "string",++ "minLength": 1,++ "maxLength": 500++ },++ "added": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ },++ "removed": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ }++ }++ }++ },++ "patch": {++ "type": "string",++ "maxLength": 262144++ },++ "patch_truncated": {++ "type": "boolean"++ },++ "push": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "pushed"++ ],++ "properties": {++ "pushed": {++ "type": "boolean"++ },++ "branch": {++ "type": "string",++ "maxLength": 200++ },++ "branch_url": {++ "type": "string",++ "format": "uri"++ },++ "pull_request": {++ "type": "string",++ "format": "uri"++ },++ "pull_request_error": {++ "type": "string",++ "maxLength": 500++ },++ "reason": {++ "type": "string",++ "maxLength": 500++ }++ }++ },++ "cost_usd": {++ "type": "number",++ "minimum": 0++ },++ "duration_ms": {++ "type": "integer",++ "minimum": 0++ },++ "error": {++ "type": "string",++ "maxLength": 1000++ }++ }++ },++ "actor_ref": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "properties": {++ "task_id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 256++ },++ "step_id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 256++ }++ },++ "description": "The OpenVibe.Actor task and step that started this coding task, when it came from Actor."++ },++ "attempts": {++ "type": "array",++ "maxItems": 50,++ "description": "The task's timeline: every try of it, in order. The first is the task itself; the others are what the agents did after it (the same conversation carried on, another agent taking over, a last turn before a limit).",++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "n",++ "state"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The attempt id (att_ + ULID)."++ },++ "n": {++ "type": "integer",++ "minimum": 1,++ "description": "The attempt's number, 1 for the first try."++ },++ "agent": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 41++ },++ "model": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 100++ },++ "machine": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 100,++ "description": "The node that ran the attempt, or sandbox when it ran in a sandbox."++ },++ "job_id": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 64++ },++ "session": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 200,++ "description": "The harness session, so a following attempt can carry on in the same conversation."++ },++ "state": {++ "enum": [++ "queued",++ "running",++ "done",++ "failed",++ "stopped",++ "budget-stopped",++ "interrupted"++ ]++ },++ "reason": {++ "type": [++ "string",++ "null"++ ],++ "enum": [++ "limit",++ "auth",++ "capacity",++ "refused",++ "error",++ "budget",++ "stopped",++ "hung",++ "context",++ null++ ]++ },++ "why": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 1000,++ "description": "One plain sentence: why this attempt happened, or how it ended."++ },++ "kind": {++ "enum": [++ "first",++ "continue",++ "switch",++ "wrap-up",++ "restart",++ "manual"++ ]++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ },++ "tokens": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ },++ "steps": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 0++ },++ "started_at": {++ "type": [++ "string",++ "null"++ ],++ "format": "date-time"++ },++ "finished_at": {++ "type": [++ "string",++ "null"++ ],++ "format": "date-time"++ },++ "created_at": {++ "type": "string",++ "format": "date-time"++ },++ "end_why": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 500,++ "description": "How the attempt ended, in plain words."++ }++ }++ }++ },++ "outcome": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "description": "What the task's attempts added up to: done, unfinished (with what is left), or stopped. Null while the task still runs.",++ "required": [++ "state"++ ],++ "properties": {++ "state": {++ "type": [++ "string",++ "null"++ ],++ "enum": [++ "done",++ "unfinished",++ "stopped",++ null++ ]++ },++ "note": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 1000++ }++ }++ }++ }++ },"common.action-item.v1": {"title": "ActionItem","description": "One piece of a person's agent work in the Action Center (plan 2026-10-28 §3.10): an agent task, a coding task, an AI run, or an approval waiting on them. Each authority answers its own items in this shape (common.action-list-result@1); OpenVibe.Network merges them into buckets (network.me-actions-result@1). Text is plain (no markup); a cost is what the person was charged in USD, null when unknown or free; href is a page on the authority's own public site.",@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Community API",-- "version": "0.241.0",-- "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.Inventory API",-- "version": "0.241.0",-- "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Search API",-- "version": "0.241.0",-- "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",-- "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",++ "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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"@@@ -211516,6 +211516,8 @@ export interface CodesTask {} | null;}++/** [email protected] (owner: codes) */++/** [email protected] (owner: play) *//*** A title as its own principal registers it (play.title.manage, PUT /api/v1/titles/:title). Achievements and boards are listed in display order; one left out is retired, never deleted. A board's kind never changes.@@@ -4,9 +4,9 @@"owner": "codes","status": "active","visibility": "first-party",-- "description": "Read a coding task started through codes.task.start: GET /api/v1/tasks/:id on OpenVibe.Codes, as the service that started it, naming the same person in X-OV-Subject. Another service's task, or another person's, is 404.",++ "description": "Read a coding task started through codes.task.start: GET /api/v1/tasks/:id on OpenVibe.Codes, as the service that started it, naming the same person in X-OV-Subject. Another service's task, or another person's, is 404. The answer is codes.task@2: the task itself (as codes.task@1, with the same fields at the top level) and, added to it, the task's attempts (its timeline) and its outcome.","inputSchema": "common.no-body@1",-- "outputSchema": "codes.task@1",++ "outputSchema": "codes.task@2","permissions": ["codes:tasks:read"],@@@ -1,6 +1,6 @@{"name": "openvibe-contracts",-- "version": "0.241.0",++ "version": "0.243.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",
@@ -4,6 +4,31 @@ All notable changes to `openvibe-contracts`. Releases are git tags (`vX.Y.Z`) th
@@ -4,6 +4,31 @@ All notable changes to `openvibe-contracts`. Releases are git tags (`vX.Y.Z`) th
from `https://codeload.github.com/OpenVibers/OpenVibe.Contracts/tar.gz/refs/tags/<tag>`. Before v0.30.0,
from `https://codeload.github.com/OpenVibers/OpenVibe.Contracts/tar.gz/refs/tags/<tag>`. Before v0.30.0,
the notes were in the tag and commit messages (`git tag -n1`).
the notes were in the tag and commit messages (`git tag -n1`).
+## 0.243.0 — 2026-10-30
+
+- The release cut from `main` for codes.task@2 (#250): a coding task's attempts and outcome, one id with two majors.
+ It carries 0.241.0 (the AI credential v2 release) as well. `v0.242.0` and `v0.242.1` were tagged from the PR
+ branch before it merged; pin `v0.243.0` instead (OpenVibe.Codes moves to it).
+
+## 0.242.1 — 2026-10-30
+
+- The generated OpenAPI files carry the release's own version again: `v0.242.0` shipped them with 0.240.0's,
+ because the version was raised after they were written. Nothing else changed; `v0.242.1` is the release to pin.
+- This release is rebased on `0.241.0` (the AI credential v2 release, merged while it was being written), so the
+ branch carries that work too; the published `v0.242.1` tarball, which OpenVibe.Codes pins, is the cut from
+ before the rebase and holds the codes.task@2 work alone. The next tag cut from `main` carries both.
+
+## 0.242.0 — 2026-10-30
+
+- **`codes.task@2`** (OpenVibe.Codes): a coding task's timeline. It is `codes.task@1` with the same fields, plus two
+ added ones: `attempts` (every try of the task, in order: the agent, the machine, the session, the state it ended
+ in, why, what it cost) and `outcome` (what the attempts added up to: done, unfinished with what is left, or
+ stopped). `GET /api/v1/tasks/:id` answers it — the task's own fields stay at the top level, exactly as
+ `codes.task@1` had them, and the two new fields are added to them. `codes.task@1` stays as it is.
+- **One contract id may hold more than one major** now: the catalog lists a v1 and a v2 file for the same id, the
+ bare id resolves to the newest major, and `id@N` names that major, so a v1 caller keeps resolving while a v2
+ caller names it exactly. (`ai.credential@2` is the first to use it.)
+
## 0.241.0 — 2026-10-30
## 0.241.0 — 2026-10-30
- **AI: one credential per provider** (Codes C3; research `research-2026-10-30/codes-c3-connections.md` items 1 and 2).
- **AI: one credential per provider** (Codes C3; research `research-2026-10-30/codes-c3-connections.md` items 1 and 2).
@@ -2385,7 +2410,6 @@ as `worker:` capabilities in `platform.resource-offer@1`. The names are reserved
@@ -2385,7 +2410,6 @@ as `worker:` capabilities in `platform.resource-offer@1`. The names are reserved
`task:edit`, `task:review`, `task:browse`, `task:run`, `task:test`, `task:plan`, `harness:mcp`, `harness:resume`,
`task:edit`, `task:review`, `task:browse`, `task:run`, `task:test`, `task:plan`, `harness:mcp`, `harness:resume`,
`harness:host-access`, `harness:long-autonomy`. New valid fixture `harness-task-routing`. Additive.
`harness:host-access`, `harness:long-autonomy`. New valid fixture `harness-task-routing`. Additive.
-
**Run jobs and their metering** (plan T14 lane G, follow-up 1 of the Node gap audit):
**Run jobs and their metering** (plan T14 lane G, follow-up 1 of the Node gap audit):
- New `platform.runtime-class@1`: the classes `function`, `code`, `browser`, `linux`, `desktop` and `gpu`, names
- New `platform.runtime-class@1`: the classes `function`, `code`, `browser`, `linux`, `desktop` and `gpu`, names
only; `function` is the first one implemented.
only; `function` is the first one implemented.
@@ -7387,6 +7387,15 @@
@@ -7387,6 +7387,15 @@
"compatibility": "backward",
"compatibility": "backward",
"status": "active"
"status": "active"
},
},
+ {
+ "id": "codes.task",
+ "version": "2.0.0",
+ "owner": "codes",
+ "schema": "codes/task.v2.json",
+ "visibility": "first-party",
+ "compatibility": "backward",
+ "status": "active"
+ },
{
{
"id": "play.title-definition",
"id": "play.title-definition",
"version": "1.0.0",
"version": "1.0.0",
new file mode 100644
new file mode 100644
@@ -0,0 +1,388 @@
@@ -0,0 +1,388 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/codes/task.v2.json",
+ "title": "CodesTask",
+ "description": "codes.task@2: a coding task on OpenVibe.Codes, as GET /api/v1/tasks/:id answers it (capability codes.task.read) and POST /api/v1/tasks creates it. It is codes.task@1 with two added fields: ATTEMPTS, the task's timeline (each try of the task, with the state it ended in and why), and OUTCOME, what the task's attempts added up to (done, unfinished with what is left, or stopped). STATE follows the OpenVibe.Run job that carries it: queued (waiting for one of the person's machines), placed, running, then succeeded, failed, cancelled or expired (no machine of theirs took it in time). URL is the task's page on openvibe.codes, where its owner follows it live. RESULT is present once it has ended: OK says whether the agents finished, SUMMARY what they said, FILES and PATCH the change (the patch at most 256 KiB, PATCH_TRUNCATED when cut), PUSH where it went when asked, COST_USD the model use on the person's own keys, DURATION_MS the time on their machine. ERROR says why a task that never ran ended (Run refused it, or the job failed before a result).",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "state",
+ "repo",
+ "url",
+ "created_at",
+ "updated_at"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The Codes task id (tsk_ + ULID)."
+ },
+ "state": {
+ "enum": [
+ "queued",
+ "placed",
+ "running",
+ "succeeded",
+ "failed",
+ "cancelled",
+ "expired"
+ ]
+ },
+ "repo": {
+ "type": "string",
+ "maxLength": 300
+ },
+ "ref": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 200
+ },
+ "agent": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 41
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://"
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "updated_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "error": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 1000
+ },
+ "result": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "ok"
+ ],
+ "properties": {
+ "ok": {
+ "type": "boolean"
+ },
+ "agents": {
+ "type": "array",
+ "maxItems": 20,
+ "items": {
+ "type": "string",
+ "maxLength": 41
+ }
+ },
+ "summary": {
+ "type": "string",
+ "maxLength": 4000
+ },
+ "files": {
+ "type": "array",
+ "maxItems": 2000,
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "path"
+ ],
+ "properties": {
+ "path": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 500
+ },
+ "added": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "removed": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ }
+ }
+ }
+ },
+ "patch": {
+ "type": "string",
+ "maxLength": 262144
+ },
+ "patch_truncated": {
+ "type": "boolean"
+ },
+ "push": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "pushed"
+ ],
+ "properties": {
+ "pushed": {
+ "type": "boolean"
+ },
+ "branch": {
+ "type": "string",
+ "maxLength": 200
+ },
+ "branch_url": {
+ "type": "string",
+ "format": "uri"
+ },
+ "pull_request": {
+ "type": "string",
+ "format": "uri"
+ },
+ "pull_request_error": {
+ "type": "string",
+ "maxLength": 500
+ },
+ "reason": {
+ "type": "string",
+ "maxLength": 500
+ }
+ }
+ },
+ "cost_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "duration_ms": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "error": {
+ "type": "string",
+ "maxLength": 1000
+ }
+ }
+ },
+ "actor_ref": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "task_id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 256
+ },
+ "step_id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 256
+ }
+ },
+ "description": "The OpenVibe.Actor task and step that started this coding task, when it came from Actor."
+ },
+ "attempts": {
+ "type": "array",
+ "maxItems": 50,
+ "description": "The task's timeline: every try of it, in order. The first is the task itself; the others are what the agents did after it (the same conversation carried on, another agent taking over, a last turn before a limit).",
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "n",
+ "state"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The attempt id (att_ + ULID)."
+ },
+ "n": {
+ "type": "integer",
+ "minimum": 1,
+ "description": "The attempt's number, 1 for the first try."
+ },
+ "agent": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 41
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 100
+ },
+ "machine": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 100,
+ "description": "The node that ran the attempt, or sandbox when it ran in a sandbox."
+ },
+ "job_id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 64
+ },
+ "session": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 200,
+ "description": "The harness session, so a following attempt can carry on in the same conversation."
+ },
+ "state": {
+ "enum": [
+ "queued",
+ "running",
+ "done",
+ "failed",
+ "stopped",
+ "budget-stopped",
+ "interrupted"
+ ]
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "limit",
+ "auth",
+ "capacity",
+ "refused",
+ "error",
+ "budget",
+ "stopped",
+ "hung",
+ "context",
+ null
+ ]
+ },
+ "why": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 1000,
+ "description": "One plain sentence: why this attempt happened, or how it ended."
+ },
+ "kind": {
+ "enum": [
+ "first",
+ "continue",
+ "switch",
+ "wrap-up",
+ "restart",
+ "manual"
+ ]
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "tokens": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "steps": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "started_at": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "date-time"
+ },
+ "finished_at": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "date-time"
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "end_why": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 500,
+ "description": "How the attempt ended, in plain words."
+ }
+ }
+ }
+ },
+ "outcome": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "description": "What the task's attempts added up to: done, unfinished (with what is left), or stopped. Null while the task still runs.",
+ "required": [
+ "state"
+ ],
+ "properties": {
+ "state": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "done",
+ "unfinished",
+ "stopped",
+ null
+ ]
+ },
+ "note": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 1000
+ }
+ }
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,15 @@
@@ -0,0 +1,15 @@
+{
+ "id": "tsk_01M4XEV0JT93CAYTXVD6V0QW1E",
+ "state": "succeeded",
+ "repo": "https://github.com/octocat/Hello-World",
+ "url": "https://openvibe.codes/run/tasks/tsk_01M4XEV0JT93CAYTXVD6V0QW1E",
+ "created_at": "2026-10-29T15:00:00.000Z",
+ "updated_at": "2026-10-29T15:04:12.000Z",
+ "attempts": [
+ {
+ "id": "att_01M4XEV0JT93CAYTXVD6V0QW1F",
+ "n": 1,
+ "state": "gave-up"
+ }
+ ]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,56 @@
@@ -0,0 +1,56 @@
+{
+ "id": "tsk_01M4XEV0JT93CAYTXVD6V0QW1E",
+ "state": "succeeded",
+ "repo": "https://github.com/octocat/Hello-World",
+ "ref": null,
+ "agent": "claude-code",
+ "url": "https://openvibe.codes/run/tasks/tsk_01M4XEV0JT93CAYTXVD6V0QW1E",
+ "created_at": "2026-10-29T15:00:00.000Z",
+ "updated_at": "2026-10-29T15:04:12.000Z",
+ "attempts": [
+ {
+ "id": "att_01M4XEV0JT93CAYTXVD6V0QW1F",
+ "n": 1,
+ "agent": "claude-code",
+ "model": "claude-sonnet-4",
+ "machine": "node-01",
+ "job_id": "job_01M4XEV0JT93CAYTXVD6V0QW1G",
+ "session": "sess-42",
+ "state": "failed",
+ "reason": "limit",
+ "why": "the first try, with claude-code",
+ "kind": "first",
+ "cost_usd": 0.12,
+ "tokens": 45000,
+ "steps": 18,
+ "started_at": "2026-10-29T15:00:02.000Z",
+ "finished_at": "2026-10-29T15:02:40.000Z",
+ "created_at": "2026-10-29T15:00:01.000Z",
+ "end_why": "the usage limit was reached"
+ },
+ {
+ "id": "att_01M4XEV0JT93CAYTXVD6V0QW1H",
+ "n": 2,
+ "agent": "codex",
+ "model": "gpt-5-codex",
+ "machine": "node-01",
+ "job_id": "job_01M4XEV0JT93CAYTXVD6V0QW1J",
+ "session": null,
+ "state": "done",
+ "reason": null,
+ "why": "took over: the usage limit was reached",
+ "kind": "switch",
+ "cost_usd": 0.31,
+ "tokens": 61000,
+ "steps": 22,
+ "started_at": "2026-10-29T15:02:41.000Z",
+ "finished_at": "2026-10-29T15:04:10.000Z",
+ "created_at": "2026-10-29T15:02:41.000Z",
+ "end_why": null
+ }
+ ],
+ "outcome": {
+ "state": "done",
+ "note": null
+ }
+}
@@ -83421,7 +83421,7 @@
@@ -83421,7 +83421,7 @@
}
}
}
}
},
},
- "codes.task": {
+ "codes.task@1": {
"version": "1.1.0",
"version": "1.1.0",
"owner": "codes",
"owner": "codes",
"status": "active",
"status": "active",
@@ -83625,6 +83625,399 @@
@@ -83625,6 +83625,399 @@
}
}
}
}
},
},
+ "codes.task@2": {
+ "version": "2.0.0",
+ "owner": "codes",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/codes/task.v2.json",
+ "title": "CodesTask",
+ "description": "codes.task@2: a coding task on OpenVibe.Codes, as GET /api/v1/tasks/:id answers it (capability codes.task.read) and POST /api/v1/tasks creates it. It is codes.task@1 with two added fields: ATTEMPTS, the task's timeline (each try of the task, with the state it ended in and why), and OUTCOME, what the task's attempts added up to (done, unfinished with what is left, or stopped). STATE follows the OpenVibe.Run job that carries it: queued (waiting for one of the person's machines), placed, running, then succeeded, failed, cancelled or expired (no machine of theirs took it in time). URL is the task's page on openvibe.codes, where its owner follows it live. RESULT is present once it has ended: OK says whether the agents finished, SUMMARY what they said, FILES and PATCH the change (the patch at most 256 KiB, PATCH_TRUNCATED when cut), PUSH where it went when asked, COST_USD the model use on the person's own keys, DURATION_MS the time on their machine. ERROR says why a task that never ran ended (Run refused it, or the job failed before a result).",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "state",
+ "repo",
+ "url",
+ "created_at",
+ "updated_at"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The Codes task id (tsk_ + ULID)."
+ },
+ "state": {
+ "enum": [
+ "queued",
+ "placed",
+ "running",
+ "succeeded",
+ "failed",
+ "cancelled",
+ "expired"
+ ]
+ },
+ "repo": {
+ "type": "string",
+ "maxLength": 300
+ },
+ "ref": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 200
+ },
+ "agent": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 41
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://"
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "updated_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "error": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 1000
+ },
+ "result": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "ok"
+ ],
+ "properties": {
+ "ok": {
+ "type": "boolean"
+ },
+ "agents": {
+ "type": "array",
+ "maxItems": 20,
+ "items": {
+ "type": "string",
+ "maxLength": 41
+ }
+ },
+ "summary": {
+ "type": "string",
+ "maxLength": 4000
+ },
+ "files": {
+ "type": "array",
+ "maxItems": 2000,
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "path"
+ ],
+ "properties": {
+ "path": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 500
+ },
+ "added": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "removed": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ }
+ }
+ }
+ },
+ "patch": {
+ "type": "string",
+ "maxLength": 262144
+ },
+ "patch_truncated": {
+ "type": "boolean"
+ },
+ "push": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "pushed"
+ ],
+ "properties": {
+ "pushed": {
+ "type": "boolean"
+ },
+ "branch": {
+ "type": "string",
+ "maxLength": 200
+ },
+ "branch_url": {
+ "type": "string",
+ "format": "uri"
+ },
+ "pull_request": {
+ "type": "string",
+ "format": "uri"
+ },
+ "pull_request_error": {
+ "type": "string",
+ "maxLength": 500
+ },
+ "reason": {
+ "type": "string",
+ "maxLength": 500
+ }
+ }
+ },
+ "cost_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "duration_ms": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "error": {
+ "type": "string",
+ "maxLength": 1000
+ }
+ }
+ },
+ "actor_ref": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "task_id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 256
+ },
+ "step_id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 256
+ }
+ },
+ "description": "The OpenVibe.Actor task and step that started this coding task, when it came from Actor."
+ },
+ "attempts": {
+ "type": "array",
+ "maxItems": 50,
+ "description": "The task's timeline: every try of it, in order. The first is the task itself; the others are what the agents did after it (the same conversation carried on, another agent taking over, a last turn before a limit).",
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "n",
+ "state"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The attempt id (att_ + ULID)."
+ },
+ "n": {
+ "type": "integer",
+ "minimum": 1,
+ "description": "The attempt's number, 1 for the first try."
+ },
+ "agent": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 41
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 100
+ },
+ "machine": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 100,
+ "description": "The node that ran the attempt, or sandbox when it ran in a sandbox."
+ },
+ "job_id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 64
+ },
+ "session": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 200,
+ "description": "The harness session, so a following attempt can carry on in the same conversation."
+ },
+ "state": {
+ "enum": [
+ "queued",
+ "running",
+ "done",
+ "failed",
+ "stopped",
+ "budget-stopped",
+ "interrupted"
+ ]
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "limit",
+ "auth",
+ "capacity",
+ "refused",
+ "error",
+ "budget",
+ "stopped",
+ "hung",
+ "context",
+ null
+ ]
+ },
+ "why": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 1000,
+ "description": "One plain sentence: why this attempt happened, or how it ended."
+ },
+ "kind": {
+ "enum": [
+ "first",
+ "continue",
+ "switch",
+ "wrap-up",
+ "restart",
+ "manual"
+ ]
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "tokens": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "steps": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "started_at": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "date-time"
+ },
+ "finished_at": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "date-time"
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "end_why": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 500,
+ "description": "How the attempt ended, in plain words."
+ }
+ }
+ }
+ },
+ "outcome": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "description": "What the task's attempts added up to: done, unfinished (with what is left), or stopped. Null while the task still runs.",
+ "required": [
+ "state"
+ ],
+ "properties": {
+ "state": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "done",
+ "unfinished",
+ "stopped",
+ null
+ ]
+ },
+ "note": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 1000
+ }
+ }
+ }
+ }
+ }
+ },
"play.title-definition": {
"play.title-definition": {
"version": "1.0.0",
"version": "1.0.0",
"owner": "play",
"owner": "play",
@@ -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.241.0",
- "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.AI API",
"title": "OpenVibe.AI API",
- "version": "0.241.0",
- "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Chat API",
"title": "OpenVibe.Chat API",
- "version": "0.241.0",
- "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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"
@@ -122,7 +122,7 @@
@@ -122,7 +122,7 @@
"get": {
"get": {
"operationId": "get_api_v1_tasks_id",
"operationId": "get_api_v1_tasks_id",
"summary": "Read a coding task started through codes.task.start: GET /api/v1/tasks/:id on OpenVibe.Codes, as the service that started it, naming the same person in X-OV-Subject.",
"summary": "Read a coding task started through codes.task.start: GET /api/v1/tasks/:id on OpenVibe.Codes, as the service that started it, naming the same person in X-OV-Subject.",
- "description": "**codes.task.read** (first-party): Read a coding task started through codes.task.start: GET /api/v1/tasks/:id on OpenVibe.Codes, as the service that started it, naming the same person in X-OV-Subject. Another service's task, or another person's, is 404.",
+ "description": "**codes.task.read** (first-party): Read a coding task started through codes.task.start: GET /api/v1/tasks/:id on OpenVibe.Codes, as the service that started it, naming the same person in X-OV-Subject. Another service's task, or another person's, is 404. The answer is codes.task@2: the task itself (as codes.task@1, with the same fields at the top level) and, added to it, the task's attempts (its timeline) and its outcome.",
"tags": [
"tags": [
"codes.task"
"codes.task"
],
],
@@ -156,7 +156,7 @@
@@ -156,7 +156,7 @@
"content": {
"content": {
"application/json": {
"application/json": {
"schema": {
"schema": {
- "$ref": "#/components/schemas/codes.task.v1"
+ "$ref": "#/components/schemas/codes.task.v2"
}
}
}
}
}
}
@@ -511,6 +511,392 @@
@@ -511,6 +511,392 @@
}
}
}
}
},
},
+ "codes.task.v2": {
+ "title": "CodesTask",
+ "description": "codes.task@2: a coding task on OpenVibe.Codes, as GET /api/v1/tasks/:id answers it (capability codes.task.read) and POST /api/v1/tasks creates it. It is codes.task@1 with two added fields: ATTEMPTS, the task's timeline (each try of the task, with the state it ended in and why), and OUTCOME, what the task's attempts added up to (done, unfinished with what is left, or stopped). STATE follows the OpenVibe.Run job that carries it: queued (waiting for one of the person's machines), placed, running, then succeeded, failed, cancelled or expired (no machine of theirs took it in time). URL is the task's page on openvibe.codes, where its owner follows it live. RESULT is present once it has ended: OK says whether the agents finished, SUMMARY what they said, FILES and PATCH the change (the patch at most 256 KiB, PATCH_TRUNCATED when cut), PUSH where it went when asked, COST_USD the model use on the person's own keys, DURATION_MS the time on their machine. ERROR says why a task that never ran ended (Run refused it, or the job failed before a result).",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "state",
+ "repo",
+ "url",
+ "created_at",
+ "updated_at"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^tsk_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The Codes task id (tsk_ + ULID)."
+ },
+ "state": {
+ "enum": [
+ "queued",
+ "placed",
+ "running",
+ "succeeded",
+ "failed",
+ "cancelled",
+ "expired"
+ ]
+ },
+ "repo": {
+ "type": "string",
+ "maxLength": 300
+ },
+ "ref": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 200
+ },
+ "agent": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 41
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://"
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "updated_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "error": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 1000
+ },
+ "result": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "ok"
+ ],
+ "properties": {
+ "ok": {
+ "type": "boolean"
+ },
+ "agents": {
+ "type": "array",
+ "maxItems": 20,
+ "items": {
+ "type": "string",
+ "maxLength": 41
+ }
+ },
+ "summary": {
+ "type": "string",
+ "maxLength": 4000
+ },
+ "files": {
+ "type": "array",
+ "maxItems": 2000,
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "path"
+ ],
+ "properties": {
+ "path": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 500
+ },
+ "added": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "removed": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ }
+ }
+ }
+ },
+ "patch": {
+ "type": "string",
+ "maxLength": 262144
+ },
+ "patch_truncated": {
+ "type": "boolean"
+ },
+ "push": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "pushed"
+ ],
+ "properties": {
+ "pushed": {
+ "type": "boolean"
+ },
+ "branch": {
+ "type": "string",
+ "maxLength": 200
+ },
+ "branch_url": {
+ "type": "string",
+ "format": "uri"
+ },
+ "pull_request": {
+ "type": "string",
+ "format": "uri"
+ },
+ "pull_request_error": {
+ "type": "string",
+ "maxLength": 500
+ },
+ "reason": {
+ "type": "string",
+ "maxLength": 500
+ }
+ }
+ },
+ "cost_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "duration_ms": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "error": {
+ "type": "string",
+ "maxLength": 1000
+ }
+ }
+ },
+ "actor_ref": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "task_id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 256
+ },
+ "step_id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 256
+ }
+ },
+ "description": "The OpenVibe.Actor task and step that started this coding task, when it came from Actor."
+ },
+ "attempts": {
+ "type": "array",
+ "maxItems": 50,
+ "description": "The task's timeline: every try of it, in order. The first is the task itself; the others are what the agents did after it (the same conversation carried on, another agent taking over, a last turn before a limit).",
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "n",
+ "state"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The attempt id (att_ + ULID)."
+ },
+ "n": {
+ "type": "integer",
+ "minimum": 1,
+ "description": "The attempt's number, 1 for the first try."
+ },
+ "agent": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 41
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 100
+ },
+ "machine": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 100,
+ "description": "The node that ran the attempt, or sandbox when it ran in a sandbox."
+ },
+ "job_id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 64
+ },
+ "session": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 200,
+ "description": "The harness session, so a following attempt can carry on in the same conversation."
+ },
+ "state": {
+ "enum": [
+ "queued",
+ "running",
+ "done",
+ "failed",
+ "stopped",
+ "budget-stopped",
+ "interrupted"
+ ]
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "limit",
+ "auth",
+ "capacity",
+ "refused",
+ "error",
+ "budget",
+ "stopped",
+ "hung",
+ "context",
+ null
+ ]
+ },
+ "why": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 1000,
+ "description": "One plain sentence: why this attempt happened, or how it ended."
+ },
+ "kind": {
+ "enum": [
+ "first",
+ "continue",
+ "switch",
+ "wrap-up",
+ "restart",
+ "manual"
+ ]
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "tokens": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "steps": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "started_at": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "date-time"
+ },
+ "finished_at": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "date-time"
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "end_why": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 500,
+ "description": "How the attempt ended, in plain words."
+ }
+ }
+ }
+ },
+ "outcome": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "description": "What the task's attempts added up to: done, unfinished (with what is left), or stopped. Null while the task still runs.",
+ "required": [
+ "state"
+ ],
+ "properties": {
+ "state": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "enum": [
+ "done",
+ "unfinished",
+ "stopped",
+ null
+ ]
+ },
+ "note": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 1000
+ }
+ }
+ }
+ }
+ },
"common.action-item.v1": {
"common.action-item.v1": {
"title": "ActionItem",
"title": "ActionItem",
"description": "One piece of a person's agent work in the Action Center (plan 2026-10-28 §3.10): an agent task, a coding task, an AI run, or an approval waiting on them. Each authority answers its own items in this shape (common.action-list-result@1); OpenVibe.Network merges them into buckets (network.me-actions-result@1). Text is plain (no markup); a cost is what the person was charged in USD, null when unknown or free; href is a page on the authority's own public site.",
"description": "One piece of a person's agent work in the Action Center (plan 2026-10-28 §3.10): an agent task, a coding task, an AI run, or an approval waiting on them. Each authority answers its own items in this shape (common.action-list-result@1); OpenVibe.Network merges them into buckets (network.me-actions-result@1). Text is plain (no markup); a cost is what the person was charged in USD, null when unknown or free; href is a page on the authority's own public site.",
@@ -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.241.0",
- "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.Inventory API",
"title": "OpenVibe.Inventory API",
- "version": "0.241.0",
- "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Search API",
"title": "OpenVibe.Search API",
- "version": "0.241.0",
- "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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.241.0",
- "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.241.0): each operation lists the capabilities it performs; a token for 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.243.0",
+ "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.243.0): each operation lists the capabilities it performs; a token for 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"
@@ -211516,6 +211516,8 @@ export interface CodesTask {
@@ -211516,6 +211516,8 @@ export interface CodesTask {
} | null;
} | null;
}
}
+/** [email protected] (owner: codes) */
+
/** [email protected] (owner: play) */
/** [email protected] (owner: play) */
/**
/**
* A title as its own principal registers it (play.title.manage, PUT /api/v1/titles/:title). Achievements and boards are listed in display order; one left out is retired, never deleted. A board's kind never changes.
* A title as its own principal registers it (play.title.manage, PUT /api/v1/titles/:title). Achievements and boards are listed in display order; one left out is retired, never deleted. A board's kind never changes.
@@ -4,9 +4,9 @@
@@ -4,9 +4,9 @@
"owner": "codes",
"owner": "codes",
"status": "active",
"status": "active",
"visibility": "first-party",
"visibility": "first-party",
- "description": "Read a coding task started through codes.task.start: GET /api/v1/tasks/:id on OpenVibe.Codes, as the service that started it, naming the same person in X-OV-Subject. Another service's task, or another person's, is 404.",
+ "description": "Read a coding task started through codes.task.start: GET /api/v1/tasks/:id on OpenVibe.Codes, as the service that started it, naming the same person in X-OV-Subject. Another service's task, or another person's, is 404. The answer is codes.task@2: the task itself (as codes.task@1, with the same fields at the top level) and, added to it, the task's attempts (its timeline) and its outcome.",
"inputSchema": "common.no-body@1",
"inputSchema": "common.no-body@1",
- "outputSchema": "codes.task@1",
+ "outputSchema": "codes.task@2",
"permissions": [
"permissions": [
"codes:tasks:read"
"codes:tasks:read"
],
],
@@ -1,6 +1,6 @@
@@ -1,6 +1,6 @@
{
{
"name": "openvibe-contracts",
"name": "openvibe-contracts",
- "version": "0.241.0",
+ "version": "0.243.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",