openvibers/openvibe.contracts Commits
Contracts 0.405.0: release train for eleven waiting PRs (#443)
Changes
@@@ -1,5 +1,23 @@# Changelog++## 0.405.0 — 2026-11-11++++This release train carries the contract work that was waiting on the owner's release. One line per carried pull request:++++- Add `live.layout@1`, the player layout a person keeps in their account: per stream slot and source, the place as fractions of the frame, mode `dock` or `float`, the tuck side, mute and the time, at most 60 places (#442).++- Add `chat.command-registration-request@1` and `chat.command-registration-result@1` with the active capability `chat.commands.register`, so a consented app or an Actor agent can register a plain response command for a server its person manages (#441).++- Catalog OpenVibe.Directory as a live service and site, replacing its parked product metadata, with its public origin, source refresh lifecycle and public-listings-only scope (#440).++- Add `actor.agent-sheet@1` and `codes.agent-sheet@1`: the owner-scoped agent sheet responses, with current work, daily activity, approvals, computer, schedules and memory where recorded (#439).++- Extend `community.feed-item@1`, `community.pulse-item@1` and `community.pulse-write-request@1` with activity kinds, followers-only visibility, scheduled starts, previews and links to every item in a folded burst; Community consumes Network profile updates (#438).++- Add `chat.person-memory-result@1` and `chat.person-memory-preferences-result@1`: the public and private parts of Chat's compacted day, week and month memory, and the erase and opt-out responses (#437).++- Add `preview_url` (and `preview_webm_url` on media) to `media.vod@1`, `media.clip@1` and the Live stream shapes: the 6 s muted hover preview beside a thumbnail (#436).++- Add `agent.ui-event@1` with the AG-UI 1.0 event union and OpenVibe `metadata.ov`, `agent.run@1` snapshots, and the `agent-run` chat embed (#434).++- Add `network.user-card@1` with viewer-aware actions, and `network.user-report@1`, `network.user-report-request@1` and `network.user-report-list-result@1` for a person's reports and the staff queue (#433).++- Add `community.feed-card@1` and `community.feed-answer@1`, with preview media support (#432).++- Add `composer.attachment@1`, `composer.prefs@1` and `composer.mention@1`, the shared composer's server-side shapes (#426).++++Valid and invalid fixtures cover every new shape, and the generated TypeScript, JSON Schema bundle and per-service OpenAPI files are regenerated at this version.++## 0.404.0 — 2026-11-11- Add owner-only Run compute configuration capability for Network admin proxy.@@@ -5,7 +5,7 @@**Docs:** https://openvibe.services · **For AI:** https://openvibe.services/llms.txt**Install and test:** `npm ci && npm test` (Node 20 or newer)--**Status:** alpha (first released in Wave 1; the release is package.json's `version`, tagged). At v0.403.0: 1221 schemas in `contracts/catalog.json`, 65 service manifests, 513 capability manifests, 13 namespace manifests and the staff capability map. Service repositories run `openvibe-contracts-check` and the pin-drift check in CI, and deployed services verify service and app tokens with `serviceAuth` in production. Consumers pin release tags (each repository's `STATUS.json` names its pin). `node scripts/docs-currency.js <root>` checks every checkout's README and `STATUS.json` against its code: the pins and versions they name, a library's consumer list, the deployed flag against the manifest, README links, and the paths and migrations they name. `node scripts/estate.js` generates `docs/ESTATE.md` and `manifests/repositories/` from the estate checkouts, and `--check` fails on drift (plan T1 step 3).++**Status:** alpha (first released in Wave 1; the release is package.json's `version`, tagged). At v0.405.0: 1238 schemas in `contracts/catalog.json`, 66 service manifests, 516 capability manifests, 14 namespace manifests and the staff capability map. Service repositories run `openvibe-contracts-check` and the pin-drift check in CI, and deployed services verify service and app tokens with `serviceAuth` in production. Consumers pin release tags (each repository's `STATUS.json` names its pin). `node scripts/docs-currency.js <root>` checks every checkout's README and `STATUS.json` against its code: the pins and versions they name, a library's consumer list, the deployed flag against the manifest, README links, and the paths and migrations they name. `node scripts/estate.js` generates `docs/ESTATE.md` and `manifests/repositories/` from the estate checkouts, and `--check` fails on drift (plan T1 step 3).**Plan:** OpenVibe Development Roadmap, Wave 1 (implementation plan rev 3, §3.1 and §18.11).**License:** AGPL-3.0 (same as every OpenVibe service).@@@ -19,7 +19,7 @@"798 JSON Schemas with valid and invalid fixtures (at v0.210.0)","45 service manifests with lifecycle declarations (39 alpha, 1 beta, 4 stable, 1 retired)","348 capability manifests (306 active, 27 planned, 15 retired) and the staff capability map",-- "13 user-module namespace manifests",++ "14 user-module namespace manifests","validate, ids, http (problem+json, trace and idempotency middleware), capabilities.check and serviceAuth","openvibe-contracts-check for service CI","generated TypeScript types, JSON Schema bundle and per-service OpenAPI 3.1",@@@ -49,7 +49,8 @@"bench.benchmark@1 and bench.run@1 with the capabilities bench.benchmark.write, bench.run.publish and bench.run.read: the benchmark registry and the results API (spec 2026-10-30, stage B1)","mail.agent_inbox.received@1, mail.agent-inbox-message@1, mail.agent-reply-request@1, mail.agent-reply-result@1 and mail.inbox-answering@1, with the capabilities mail.agent.read, mail.agent.reply and mail.agent.answering (track HO6): an agent answers the mail sent to its own OpenVibe.Mail address, reads it in full text on the owner's behalf, replies from its own address in the thread, and answers only when the person's switch for that address is on","actor.task-create-request@1 supports Actor conversation turns with optional tools, model and content tier; uncensored content is limited to tasks naming their intended person",-- "chat.embed@1 provides one address preview shape for every chat client; account-merge contracts are deprecated"++ "chat.embed@1 provides one address preview shape for every chat client; account-merge contracts are deprecated",++ "media.vod@1, media.clip@1 and the live stream shapes carry preview_url (and the media shapes preview_webm_url): the 6 s muted hover preview beside a thumbnail (plan 355)"],"updated": "2026-11-11"}nnew file mode 100644@@@ -0,0 +1,34 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/actor/agent-sheet.v1.json",++ "title": "ActorAgentSheet",++ "description": "actor.agent-sheet@1: one owner-scoped read of an Actor agent's current work, history, approvals, computer, schedules and memory. GET /api/v1/me/agents/:id?view=sheet; never cache this answer.",++ "type": "object",++ "additionalProperties": false,++ "required": ["agent", "now", "work", "asks", "asks_empty", "computer", "schedules", "memory", "activity"],++ "properties": {++ "agent": {++ "type": "object", "additionalProperties": true,++ "required": ["id", "name", "face", "state", "instructions", "voice"],++ "properties": {++ "id": {"type": "string", "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$"},++ "name": {"type": "string"},++ "face": {"type": ["string", "null"]},++ "state": {"enum": ["working", "idle", "paused"]},++ "instructions": {"type": "string"},++ "voice": {"type": ["string", "null"]}++ }++ },++ "now": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/work"}]},++ "work": {"type": "array", "items": {"$ref": "#/$defs/work"}},++ "asks": {"type": "array", "items": {"type": "object", "required": ["id", "state", "what"], "properties": {"id": {"type": "string"}, "state": {"type": "string"}, "what": {"type": "string"}, "why": {"type": ["string", "null"]}, "touch": {"type": ["string", "object", "null"]}}, "additionalProperties": true}},++ "asks_empty": {"type": ["string", "null"]},++ "computer": {"oneOf": [{"type": "null"}, {"type": "object", "properties": {"url": {"type": ["string", "null"]}, "open": {"type": ["string", "null"]}}, "additionalProperties": true}]},++ "schedules": {"type": "array", "items": {"type": "object", "properties": {"next_run_at": {"type": ["string", "null"]}, "last_run_at": {"type": ["string", "null"]}, "last_result": {"type": ["string", "null"]}}, "additionalProperties": true}},++ "memory": {"type": "array", "items": {"type": "object", "required": ["id", "text"], "properties": {"id": {"type": "string"}, "text": {"type": "string"}, "source": {"type": "string"}}, "additionalProperties": true}},++ "activity": {"type": "array", "items": {"type": "object", "additionalProperties": true}}++ },++ "$defs": {++ "work": {"type": "object", "required": ["id", "task", "state", "cost_usd"], "properties": {"id": {"type": "string"}, "task": {"type": "string"}, "state": {"type": "string"}, "cost_usd": {"type": "number", "minimum": 0}, "result": {}, "computer": {}}, "additionalProperties": true}++ }++}nnew file mode 100644@@@ -0,0 +1,170 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "type": "object",++ "additionalProperties": false,++ "$id": "https://openvibe.network/contracts/agent/run.v1.json",++ "title": "AgentRun",++ "description": "agent.run@1 snapshot of a run and its current plan, steps, sources, result, timestamps and cost.",++ "required": [++ "id",++ "product",++ "title",++ "status",++ "plan",++ "steps",++ "sources",++ "result",++ "started_at",++ "ended_at",++ "cost_usd"++ ],++ "properties": {++ "id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 160++ },++ "product": {++ "type": "string",++ "minLength": 1,++ "maxLength": 40++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 240++ },++ "status": {++ "enum": [++ "queued",++ "running",++ "waiting",++ "needs_you",++ "succeeded",++ "failed",++ "stopped",++ "cancelled"++ ]++ },++ "plan": {++ "type": "array",++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "title",++ "status"++ ],++ "properties": {++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 240++ },++ "status": {++ "enum": [++ "todo",++ "running",++ "waiting",++ "needs_you",++ "done",++ "failed",++ "stopped"++ ]++ }++ }++ }++ },++ "steps": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/step"++ }++ },++ "sources": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/source"++ }++ },++ "result": {++ "type": [++ "object",++ "null"++ ]++ },++ "started_at": {++ "type": "string",++ "format": "date-time"++ },++ "ended_at": {++ "type": [++ "string",++ "null"++ ],++ "format": "date-time"++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ }++ },++ "$defs": {++ "step": {++ "type": "object",++ "additionalProperties": true,++ "required": [++ "title",++ "status"++ ],++ "properties": {++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 240++ },++ "status": {++ "enum": [++ "todo",++ "running",++ "waiting",++ "needs_you",++ "done",++ "failed",++ "stopped"++ ]++ }++ }++ },++ "source": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "url",++ "title",++ "site"++ ],++ "properties": {++ "url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://",++ "maxLength": 2048++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 300++ },++ "site": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ }++ }++ }++ }++}nnew file mode 100644@@@ -0,0 +1,2492 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/agent/ui-event.v1.json",++ "title": "AgentUiEvent",++ "description": "agent.ui-event@1: AG-UI 1.0 event shape and event-family fields, with OpenVibe metadata.ov. AG-UI timestamps are Unix-millisecond integers; this contract requires one on every event. CUSTOM events use AG-UI name/value with ov.sources, ov.handoff, ov.approval or ov.result names.",++ "allOf": [++ {++ "$ref": "#/definitions/Event"++ },++ {++ "type": "object",++ "required": [++ "timestamp"++ ]++ }++ ],++ "definitions": {++ "EventType": {++ "type": "string",++ "description": "The discriminator carried by every event.",++ "enum": [++ "TEXT_MESSAGE_START",++ "TEXT_MESSAGE_CONTENT",++ "TEXT_MESSAGE_END",++ "TEXT_MESSAGE_CHUNK",++ "TOOL_CALL_START",++ "TOOL_CALL_ARGS",++ "TOOL_CALL_END",++ "TOOL_CALL_CHUNK",++ "TOOL_CALL_RESULT",++ "STATE_SNAPSHOT",++ "STATE_DELTA",++ "MESSAGES_SNAPSHOT",++ "ACTIVITY_SNAPSHOT",++ "ACTIVITY_DELTA",++ "RAW",++ "CUSTOM",++ "RUN_STARTED",++ "RUN_FINISHED",++ "RUN_ERROR",++ "STEP_STARTED",++ "STEP_FINISHED",++ "REASONING_START",++ "REASONING_MESSAGE_START",++ "REASONING_MESSAGE_CONTENT",++ "REASONING_MESSAGE_END",++ "REASONING_MESSAGE_CHUNK",++ "REASONING_END",++ "REASONING_ENCRYPTED_VALUE",++ "SUBAGENT_STARTED",++ "SUBAGENT_FINISHED",++ "SUBAGENT_ERROR"++ ]++ },++ "BaseEvent": {++ "type": "object",++ "description": "The fields every event carries, whatever its type. Composed into each event definition rather than repeated, so a change here reaches every event at once.",++ "properties": {++ "type": {++ "$ref": "#/definitions/EventType",++ "description": "Which event this is. Each event definition narrows this to a single value."++ },++ "timestamp": {++ "type": "integer",++ "minimum": -9007199254740991,++ "maximum": 9007199254740991,++ "description": "When the event was created. Bounded to the range JSON numbers survive a round trip in, so the value a consumer reads is the value the producer wrote. Deliberately not a float. The unit is not constrained here, because it never has been stated normatively; every SDK that sets it in practice uses milliseconds since the Unix epoch, and a producer choosing another unit will be misread by consumers even though it validates. Nothing in the protocol computes with this value."++ },++ "rawEvent": {++ "not": {++ "type": "null"++ },++ "description": "The provider-native event this one was translated from, carried verbatim for debugging and for consumers that need detail the protocol does not model. Any JSON value."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this event."++ }++ },++ "required": [++ "type"++ ]++ },++ "Attributable": {++ "type": "object",++ "description": "Composed into everything that can belong to a subagent's work: the events that describe content or progress, the message types, and each interrupt. Run-scoped events omit it \u2014 RUN_STARTED, RUN_FINISHED and RUN_ERROR describe the run itself and MESSAGES_SNAPSHOT is conversation-wide, so none of them can belong to one subagent. A tool call omits it too and inherits its containing message's attribution.",++ "properties": {++ "subagentRunId": {++ "$ref": "#/definitions/SubagentRunId",++ "description": "The subagent invocation this belongs to. Absent means the parent agent produced it directly."++ }++ }++ },++ "SubagentRunId": {++ "type": "string",++ "description": "An opaque handle for one subagent invocation, not a reusable name for a subagent definition: two invocations of the same subagent carry two different values. Named to mirror runId one level down, the way the subagent's name mirrors agentId."++ },++ "Metadata": {++ "type": "object",++ "description": "Extra information attached to an event, a message, a tool call, a tool, an interrupt or a resume entry. Open by key: any JSON value is allowed under a key, including null, because a null there is meaningful data. The object itself may be absent but is never null when present. The key ag-ui is reserved for the protocol's own use; reservation is by convention, since validating the shape of a key's value would contradict being open by key.",++ "additionalProperties": true,++ "properties": {++ "ov": {++ "type": "object",++ "additionalProperties": false,++ "properties": {++ "title": {++ "type": "string",++ "maxLength": 240++ },++ "kind": {++ "enum": [++ "search",++ "fetch",++ "read",++ "edit",++ "run",++ "browse",++ "ask",++ "think",++ "note",++ "agent",++ "plan"++ ]++ },++ "sources": {++ "type": "array",++ "items": {++ "$ref": "#/definitions/OvSource"++ }++ },++ "attachments": {++ "type": "array",++ "items": {++ "type": "object",++ "additionalProperties": true++ }++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ },++ "needs_you": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "id",++ "question",++ "actions"++ ],++ "properties": {++ "id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 160++ },++ "question": {++ "type": "string",++ "minLength": 1,++ "maxLength": 1000++ },++ "actions": {++ "type": "array",++ "items": {},++ "minItems": 1++ }++ }++ },++ "product": {++ "type": "string",++ "maxLength": 40++ },++ "ref": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 160++ }++ }++ }++ }++ },++ "State": {++ "description": "Agent state. Any JSON value: the protocol carries state without interpreting it, so an object, an array, a string and a number are all valid."++ },++ "TextMessageRole": {++ "type": "string",++ "description": "The roles a streamed text message may take. Excludes tool, which is carried by TOOL_CALL_RESULT rather than streamed as text.",++ "enum": [++ "developer",++ "system",++ "assistant",++ "user"++ ]++ },++ "TextMessageStartEvent": {++ "type": "object",++ "description": "Opens a streamed text message. The content arrives as TEXT_MESSAGE_CONTENT events and the message closes with TEXT_MESSAGE_END.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TEXT_MESSAGE_START"++ },++ "messageId": {++ "type": "string",++ "description": "Identifies the message this stream builds, and ties the later content and end events to it."++ },++ "role": {++ "$ref": "#/definitions/TextMessageRole",++ "default": "assistant",++ "description": "Who the message is from. An absent role means assistant; that meaning is normative and stated in the prose, because a validator treats a default as documentation rather than as behaviour."++ },++ "name": {++ "type": "string",++ "description": "An optional display name for the author, for providers that distinguish several participants in one role."++ }++ },++ "required": [++ "type",++ "messageId"++ ],++ "unevaluatedProperties": false++ },++ "TextMessageContentEvent": {++ "type": "object",++ "description": "Appends a fragment to a streamed text message.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TEXT_MESSAGE_CONTENT"++ },++ "messageId": {++ "type": "string",++ "description": "The message this fragment belongs to."++ },++ "delta": {++ "type": "string",++ "description": "The fragment to append. May be the empty string: providers emit empty deltas as keep-alives and while a tool call is being decided, and rejecting them would kill runs that are working correctly."++ }++ },++ "required": [++ "type",++ "messageId",++ "delta"++ ],++ "unevaluatedProperties": false++ },++ "TextMessageEndEvent": {++ "type": "object",++ "description": "Closes a streamed text message.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TEXT_MESSAGE_END"++ },++ "messageId": {++ "type": "string",++ "description": "The message being closed."++ }++ },++ "required": [++ "type",++ "messageId"++ ],++ "unevaluatedProperties": false++ },++ "TextMessageChunkEvent": {++ "type": "object",++ "description": "A shorthand that stands in for a start, content and end sequence, for producers that cannot know in advance where a message begins. Every field is optional because a continuation chunk omits what has not changed; which message a field-less chunk continues is a sequence question the prose specification answers.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TEXT_MESSAGE_CHUNK"++ },++ "messageId": {++ "type": "string",++ "description": "The message this chunk belongs to. Absent continues the message already open."++ },++ "role": {++ "$ref": "#/definitions/TextMessageRole",++ "description": "Who the message is from, on the chunk that opens it."++ },++ "delta": {++ "type": "string",++ "description": "The fragment to append. May be the empty string."++ },++ "name": {++ "type": "string",++ "description": "An optional display name for the author."++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "ToolCallStartEvent": {++ "type": "object",++ "description": "Opens a tool call. The arguments arrive as TOOL_CALL_ARGS events and the call closes with TOOL_CALL_END.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TOOL_CALL_START"++ },++ "toolCallId": {++ "type": "string",++ "description": "Identifies the call, and ties the later args, end and result events to it."++ },++ "toolCallName": {++ "type": "string",++ "description": "Which tool is being called."++ },++ "parentMessageId": {++ "type": "string",++ "description": "The assistant message that holds this call. Absent means the producer did not attribute it to one."++ }++ },++ "required": [++ "type",++ "toolCallId",++ "toolCallName"++ ],++ "unevaluatedProperties": false++ },++ "ToolCallArgsEvent": {++ "type": "object",++ "description": "Appends a fragment of a tool call's arguments.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TOOL_CALL_ARGS"++ },++ "toolCallId": {++ "type": "string",++ "description": "The call these arguments belong to."++ },++ "delta": {++ "type": "string",++ "description": "A fragment of the arguments, which concatenate into the call's argument text \u2014 conventionally a JSON document, though the protocol does not validate it (see FunctionCall.arguments). Deliberately a string rather than parsed JSON: a fragment is not itself a document. May be the empty string."++ }++ },++ "required": [++ "type",++ "toolCallId",++ "delta"++ ],++ "unevaluatedProperties": false++ },++ "ToolCallEndEvent": {++ "type": "object",++ "description": "Closes a tool call, meaning its arguments are complete.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TOOL_CALL_END"++ },++ "toolCallId": {++ "type": "string",++ "description": "The call being closed."++ }++ },++ "required": [++ "type",++ "toolCallId"++ ],++ "unevaluatedProperties": false++ },++ "ToolCallChunkEvent": {++ "type": "object",++ "description": "A shorthand that stands in for a tool call's start, args and end sequence. Every field is optional for the same reason as TEXT_MESSAGE_CHUNK.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TOOL_CALL_CHUNK"++ },++ "toolCallId": {++ "type": "string",++ "description": "The call this chunk belongs to. Absent continues the call already open."++ },++ "toolCallName": {++ "type": "string",++ "description": "Which tool is being called, on the chunk that opens it."++ },++ "parentMessageId": {++ "type": "string",++ "description": "The assistant message that holds this call."++ },++ "delta": {++ "type": "string",++ "description": "A fragment of the arguments. May be the empty string."++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "ToolCallResultEvent": {++ "type": "object",++ "description": "Carries what a tool returned. Mints a tool message rather than appending to an existing one, which is why it has its own messageId.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TOOL_CALL_RESULT"++ },++ "messageId": {++ "type": "string",++ "description": "The tool message this result becomes."++ },++ "toolCallId": {++ "type": "string",++ "description": "The call being answered."++ },++ "content": {++ "description": "What the tool returned: either plain text, or an ordered list of parts, exactly as on the tool message this event mints. A tool returning structured data serialises it into text; media travel as parts of their own.",++ "oneOf": [++ {++ "type": "string"++ },++ {++ "type": "array",++ "items": {++ "$ref": "#/definitions/ContentPart"++ }++ }++ ]++ },++ "role": {++ "const": "tool",++ "description": "Present only for symmetry with the message it mints; the value is fixed, so a producer may leave it out."++ }++ },++ "required": [++ "type",++ "messageId",++ "toolCallId",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "StateSnapshotEvent": {++ "type": "object",++ "description": "Replaces the agent state wholesale. Sent when a delta cannot express the change, or to resynchronise a consumer.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "STATE_SNAPSHOT"++ },++ "snapshot": {++ "$ref": "#/definitions/State",++ "description": "The complete new state."++ }++ },++ "required": [++ "type",++ "snapshot"++ ],++ "unevaluatedProperties": false++ },++ "StateDeltaEvent": {++ "type": "object",++ "description": "Changes the agent state incrementally.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "STATE_DELTA"++ },++ "delta": {++ "$ref": "#/definitions/JsonPatch",++ "description": "The change, as an RFC 6902 patch against the current state. Structural validity here does not mean the patch applies: a well-formed operation may point at a path that does not exist, which RFC 6902 leaves to the applier."++ }++ },++ "required": [++ "type",++ "delta"++ ],++ "unevaluatedProperties": false++ },++ "MessagesSnapshotEvent": {++ "type": "object",++ "description": "The complete set of messages the producer owns, in order. Conversation-wide rather than a plain overwrite: a consumer may keep messages of its own that no producer tracks, so exactly how a snapshot reconciles with those is behavioural and belongs in the prose. Being conversation-wide it cannot belong to a single subagent, so it carries no attribution; it does establish which subagent owns each message it contains, through the messages themselves.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "MESSAGES_SNAPSHOT"++ },++ "messages": {++ "type": "array",++ "description": "The messages the producer is declaring, in order.",++ "items": {++ "$ref": "#/definitions/Message"++ }++ }++ },++ "required": [++ "type",++ "messages"++ ],++ "unevaluatedProperties": false++ },++ "ActivitySnapshotEvent": {++ "type": "object",++ "description": "Reports structured progress that is not conversation content, such as a step a UI renders as its own widget.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "ACTIVITY_SNAPSHOT"++ },++ "messageId": {++ "type": "string",++ "description": "The activity message this describes."++ },++ "activityType": {++ "type": "string",++ "description": "What kind of activity this is. An open string: the set is the producer's, not the protocol's."++ },++ "content": {++ "type": "object",++ "description": "The activity's payload, open by key.",++ "additionalProperties": true++ },++ "replace": {++ "type": "boolean",++ "default": true,++ "description": "Whether this snapshot overwrites the activity's existing content. Absent means it does, and that meaning is normative; only an explicit false asks a consumer to leave what is already there. It does not ask for a merge \u2014 ACTIVITY_DELTA is how content is changed incrementally. What a consumer does with a non-overwriting snapshot is behavioural and belongs in the prose."++ }++ },++ "required": [++ "type",++ "messageId",++ "activityType",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "ActivityDeltaEvent": {++ "type": "object",++ "description": "Changes an activity message's content incrementally.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "ACTIVITY_DELTA"++ },++ "messageId": {++ "type": "string",++ "description": "The activity message being changed."++ },++ "activityType": {++ "type": "string",++ "description": "What kind of activity this is."++ },++ "patch": {++ "$ref": "#/definitions/JsonPatch",++ "description": "The change, as an RFC 6902 patch against the activity's content."++ }++ },++ "required": [++ "type",++ "messageId",++ "activityType",++ "patch"++ ],++ "unevaluatedProperties": false++ },++ "RawEvent": {++ "type": "object",++ "description": "Passes a provider-native event through untranslated, for consumers that need detail the protocol does not model.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "RAW"++ },++ "event": {++ "description": "The provider's own event. Any JSON value, and required: an event whose only purpose is to carry this would say nothing without it."++ },++ "source": {++ "type": "string",++ "description": "Which provider or framework the event came from."++ }++ },++ "required": [++ "type",++ "event"++ ],++ "unevaluatedProperties": false++ },++ "CustomEvent": {++ "type": "object",++ "description": "The protocol's extension point for an application's own events. Anything a consumer does with one is outside the protocol.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "CUSTOM"++ },++ "name": {++ "type": "string",++ "description": "What this custom event is. Required: without it a consumer cannot route the value.",++ "enum": [++ "ov.sources",++ "ov.handoff",++ "ov.approval",++ "ov.result"++ ]++ },++ "value": {++ "description": "The payload. Any JSON value, and required."++ }++ },++ "required": [++ "type",++ "name",++ "value"++ ],++ "unevaluatedProperties": false++ },++ "RunStartedEvent": {++ "type": "object",++ "description": "Opens a run. Run-scoped, so it carries no subagent attribution.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "RUN_STARTED"++ },++ "threadId": {++ "type": "string",++ "description": "The conversation this run belongs to."++ },++ "runId": {++ "type": "string",++ "description": "Identifies this run."++ },++ "protocolVersion": {++ "type": "string",++ "description": "The protocol version this producer speaks, such as \"1.0\" \u2014 the producer's own version, not an echo of the input's, which is what makes the pair a negotiation: each side declares itself and the consumer sees a downgrade the moment it happens. Absent means a producer from before the protocol carried a version."++ },++ "parentRunId": {++ "type": "string",++ "description": "The run that spawned this one, when an agent invokes another agent as a separate run rather than as a subagent within one."++ },++ "input": {++ "$ref": "#/definitions/RunAgentInput",++ "description": "The request this run was started from, echoed back so a consumer that did not make the request can still see what the agent was asked."++ }++ },++ "required": [++ "type",++ "threadId",++ "runId"++ ],++ "unevaluatedProperties": false++ },++ "RunFinishedEvent": {++ "type": "object",++ "description": "Closes a run that did not fail. Run-scoped, so it carries no subagent attribution.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "RUN_FINISHED"++ },++ "threadId": {++ "type": "string",++ "description": "The conversation this run belongs to."++ },++ "runId": {++ "type": "string",++ "description": "The run being closed."++ },++ "result": {++ "not": {++ "type": "null"++ },++ "description": "The run's return value, if it has one. Any JSON value."++ },++ "outcome": {++ "$ref": "#/definitions/RunFinishedOutcome",++ "description": "Why the run ended. Absent means success, so every producer written before outcomes existed is already conformant."++ },++ "usage": {++ "type": "array",++ "description": "Token usage for the run, one entry per provider and model, so a run that invoked several models keeps them separate. A consumer that only wants totals sums across the entries. The run is the accounting boundary: usage covers every model call made within the run, calls made by its subagents included; an agent invoked as a separate run under parentRunId reports its own usage on its own terminal event; and a run that resumes an interrupted one reports only the calls it made itself, not the interrupted run's.",++ "items": {++ "$ref": "#/definitions/TokenUsage"++ }++ }++ },++ "required": [++ "type",++ "threadId",++ "runId"++ ],++ "unevaluatedProperties": false++ },++ "RunErrorEvent": {++ "type": "object",++ "description": "Ends a run that failed. Run-scoped, so it carries no subagent attribution; a subagent that fails without ending the run reports SUBAGENT_ERROR instead.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "RUN_ERROR"++ },++ "message": {++ "type": "string",++ "description": "What went wrong, for a person to read."++ },++ "code": {++ "type": "string",++ "description": "A machine-readable error code. An open string: the protocol defines no vocabulary."++ },++ "usage": {++ "type": "array",++ "description": "Token usage accrued before the failure, for a run that completed one or more model calls before dying. Scoped as on RUN_FINISHED: the run's own calls, subagents included.",++ "items": {++ "$ref": "#/definitions/TokenUsage"++ }++ }++ },++ "required": [++ "type",++ "message"++ ],++ "unevaluatedProperties": false++ },++ "StepStartedEvent": {++ "type": "object",++ "description": "Opens a named step within a run, for producers whose frameworks have a step concept worth surfacing.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "STEP_STARTED"++ },++ "stepName": {++ "type": "string",++ "description": "The step's name. Identifies it: the matching STEP_FINISHED carries the same name."++ }++ },++ "required": [++ "type",++ "stepName"++ ],++ "unevaluatedProperties": false++ },++ "StepFinishedEvent": {++ "type": "object",++ "description": "Closes a named step.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "STEP_FINISHED"++ },++ "stepName": {++ "type": "string",++ "description": "The step being closed."++ }++ },++ "required": [++ "type",++ "stepName"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningStartEvent": {++ "type": "object",++ "description": "Opens a span of reasoning. A span may contain several reasoning messages.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_START"++ },++ "messageId": {++ "type": "string",++ "description": "The span being opened."++ }++ },++ "required": [++ "type",++ "messageId"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningMessageStartEvent": {++ "type": "object",++ "description": "Opens a streamed reasoning message.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_MESSAGE_START"++ },++ "messageId": {++ "type": "string",++ "description": "The reasoning message this stream builds."++ },++ "role": {++ "const": "reasoning",++ "description": "Fixed, and required rather than defaulted. The requirement is inherited from the SDKs rather than chosen."++ }++ },++ "required": [++ "type",++ "messageId",++ "role"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningMessageContentEvent": {++ "type": "object",++ "description": "Appends a fragment to a streamed reasoning message.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_MESSAGE_CONTENT"++ },++ "messageId": {++ "type": "string",++ "description": "The reasoning message this fragment belongs to."++ },++ "delta": {++ "type": "string",++ "description": "The fragment to append. May be the empty string."++ }++ },++ "required": [++ "type",++ "messageId",++ "delta"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningMessageEndEvent": {++ "type": "object",++ "description": "Closes a streamed reasoning message.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_MESSAGE_END"++ },++ "messageId": {++ "type": "string",++ "description": "The reasoning message being closed."++ }++ },++ "required": [++ "type",++ "messageId"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningMessageChunkEvent": {++ "type": "object",++ "description": "A shorthand that stands in for a reasoning message's start, content and end sequence.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_MESSAGE_CHUNK"++ },++ "messageId": {++ "type": "string",++ "description": "The reasoning message this chunk belongs to. Absent continues the one already open."++ },++ "delta": {++ "type": "string",++ "description": "The fragment to append. May be the empty string."++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningEndEvent": {++ "type": "object",++ "description": "Closes a span of reasoning.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_END"++ },++ "messageId": {++ "type": "string",++ "description": "The span being closed."++ }++ },++ "required": [++ "type",++ "messageId"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningEncryptedValueEvent": {++ "type": "object",++ "description": "Carries a provider's opaque, encrypted reasoning artefact, which a consumer stores and returns on a later turn without being able to read it.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_ENCRYPTED_VALUE"++ },++ "subtype": {++ "$ref": "#/definitions/ReasoningEncryptedValueSubtype",++ "description": "What kind of thing entityId names, which decides where the value is stored."++ },++ "entityId": {++ "type": "string",++ "description": "What the value belongs to: a message id or a tool call id, according to subtype."++ },++ "encryptedValue": {++ "type": "string",++ "description": "The provider's opaque artefact."++ }++ },++ "required": [++ "type",++ "subtype",++ "entityId",++ "encryptedValue"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningEncryptedValueSubtype": {++ "type": "string",++ "description": "Whether a REASONING_ENCRYPTED_VALUE belongs to a message or to a tool call.",++ "enum": [++ "tool-call",++ "message"++ ]++ },++ "SubagentStartedEvent": {++ "type": "object",++ "description": "Announces that a subagent invocation has begun. Everything the subagent produces afterwards is attributed by carrying its subagentRunId, so a consumer can group the work without replaying the stream. Composed from BaseEvent alone rather than Attributable, because here subagentRunId identifies the subagent rather than attributing the event to one; attribution to an enclosing subagent is parentSubagentRunId.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "SUBAGENT_STARTED"++ },++ "subagentRunId": {++ "$ref": "#/definitions/SubagentRunId",++ "description": "The invocation being announced."++ },++ "name": {++ "type": "string",++ "description": "The subagent's name, which is reusable across invocations, unlike subagentRunId."++ },++ "description": {++ "type": "string",++ "description": "What this subagent is for, for a consumer to display."++ },++ "parentSubagentRunId": {++ "$ref": "#/definitions/SubagentRunId",++ "description": "The subagent invocation that spawned this one, for nested delegation. Absent means the parent agent spawned it directly."++ },++ "parentToolCallId": {++ "type": "string",++ "description": "The tool call that spawned this subagent, for the pattern where agents are exposed to a model as tools. Lets a consumer tie the subagent to the call without reading rawEvent."++ },++ "parentMessageId": {++ "type": "string",++ "description": "The message that held the spawning tool call."++ }++ },++ "required": [++ "type",++ "subagentRunId",++ "name"++ ],++ "unevaluatedProperties": false++ },++ "SubagentFinishedEvent": {++ "type": "object",++ "description": "Ends a subagent invocation's segment of this run, either because the work completed or because it is suspended awaiting outside input.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "SUBAGENT_FINISHED"++ },++ "subagentRunId": {++ "$ref": "#/definitions/SubagentRunId",++ "description": "The invocation being closed."++ },++ "result": {++ "not": {++ "type": "null"++ },++ "description": "The subagent's return value, if it has one. Any JSON value, mirroring RUN_FINISHED.result."++ },++ "outcome": {++ "$ref": "#/definitions/SubagentFinishedOutcome",++ "description": "Why the segment ended. Absent means success. A suspended subagent is neither a success nor a failure, which is why saying so needs its own value rather than being inferred from a later interrupt."++ }++ },++ "required": [++ "type",++ "subagentRunId"++ ],++ "unevaluatedProperties": false++ },++ "SubagentErrorEvent": {++ "type": "object",++ "description": "Reports that a subagent invocation failed. The run may continue: a parent agent is free to handle a failed subagent, which is why this is not RUN_ERROR.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "SUBAGENT_ERROR"++ },++ "subagentRunId": {++ "$ref": "#/definitions/SubagentRunId",++ "description": "The invocation that failed."++ },++ "message": {++ "type": "string",++ "description": "What went wrong, for a person to read."++ },++ "code": {++ "type": "string",++ "description": "A machine-readable error code. An open string."++ }++ },++ "required": [++ "type",++ "subagentRunId",++ "message"++ ],++ "unevaluatedProperties": false++ },++ "RunFinishedOutcome": {++ "description": "Why a run ended.",++ "oneOf": [++ {++ "$ref": "#/definitions/RunFinishedSuccessOutcome"++ },++ {++ "$ref": "#/definitions/RunFinishedInterruptOutcome"++ },++ {++ "$ref": "#/definitions/RunFinishedCancelledOutcome"++ }++ ]++ },++ "RunFinishedSuccessOutcome": {++ "type": "object",++ "description": "The run completed. Equivalent to an absent outcome. Closed like every other object, which is also what keeps it from carrying the suspended sibling's interrupts \u2014 a success with an interrupt still pending would be a contradiction, not an extension. A completed run may still have left frontend tool calls for the application to answer; pendingToolCallIds names them.",++ "properties": {++ "type": {++ "const": "success",++ "description": "Discriminator."++ },++ "pendingToolCallIds": {++ "type": "array",++ "description": "The tool calls this run started and left unanswered \u2014 no TOOL_CALL_RESULT in the run \u2014 for the application to answer in the next input's messages, in the order they were made. Absent or empty means the producer named none, and a consumer derives the list from the stream; otherwise it is the list, and it agrees with the stream. On the success outcome rather than the event because a run that stopped on a frontend tool call is a completed run: whether the application continues the thread is its own decision, so the producer reports what it knows and no more.",++ "items": {++ "type": "string",++ "description": "A tool call id, as carried by TOOL_CALL_START."++ }++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "RunFinishedInterruptOutcome": {++ "type": "object",++ "description": "The run is paused, waiting for something outside it. Resuming means starting a new run whose resume entries answer these interrupts.",++ "properties": {++ "type": {++ "const": "interrupt",++ "description": "Discriminator."++ },++ "interrupts": {++ "type": "array",++ "description": "What the run is waiting for. At least one: an interrupt outcome with nothing to answer would leave a consumer with nothing to do.",++ "minItems": 1,++ "items": {++ "$ref": "#/definitions/Interrupt"++ }++ }++ },++ "required": [++ "type",++ "interrupts"++ ],++ "unevaluatedProperties": false++ },++ "RunFinishedCancelledOutcome": {++ "type": "object",++ "description": "The run was stopped before it completed, by whoever was running it, and did not fail. Neither success nor interrupt: nothing was produced as a result, and nothing is waited for, so the next run on the thread is an ordinary new run rather than a resume. Closed like its siblings: a cancelled run has no interrupts to carry. Named in the schema before 1.0 because an outcome a consumer does not recognise is stripped and read as success \u2014 a cancellation added later would reach every 1.0 consumer as a completed run.",++ "properties": {++ "type": {++ "const": "cancelled",++ "description": "Discriminator."++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "SubagentFinishedOutcome": {++ "description": "Why a subagent's segment of a run ended. Mirrors RunFinishedOutcome one level down.",++ "oneOf": [++ {++ "$ref": "#/definitions/SubagentFinishedSuccessOutcome"++ },++ {++ "$ref": "#/definitions/SubagentFinishedSuspendedOutcome"++ }++ ]++ },++ "SubagentFinishedSuccessOutcome": {++ "type": "object",++ "description": "The subagent completed its work. Equivalent to an absent outcome.",++ "properties": {++ "type": {++ "const": "success",++ "description": "Discriminator."++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "SubagentFinishedSuspendedOutcome": {++ "type": "object",++ "description": "The subagent is paused awaiting outside input. Terminal for this stream, not for the subagent: a later run may continue the same invocation once the interrupts are answered.",++ "properties": {++ "type": {++ "const": "suspended",++ "description": "Discriminator."++ },++ "interruptIds": {++ "type": "array",++ "description": "The run-level interrupts this subagent raised itself. May be empty or absent: a subagent suspended because a descendant interrupted owns no interrupt of its own.",++ "items": {++ "type": "string",++ "description": "An Interrupt.id."++ }++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "Interrupt": {++ "type": "object",++ "description": "Something a run needs from outside before it can continue, such as an approval or a missing value.",++ "allOf": [++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "id": {++ "type": "string",++ "description": "Identifies the interrupt. A resume entry answers it by this id."++ },++ "reason": {++ "type": "string",++ "description": "Why the run stopped. An open string rather than an enumeration: the protocol does not attempt to classify every reason an agent might need input."++ },++ "message": {++ "type": "string",++ "description": "A human-readable prompt for whoever answers."++ },++ "toolCallId": {++ "type": "string",++ "description": "The tool call this interrupt concerns, when it is a tool approval."++ },++ "responseSchema": {++ "type": "object",++ "description": "A JSON Schema describing the answer this interrupt expects, so a consumer can build a form for it. Carried opaquely: the protocol does not constrain or validate it. Restricted to an object because TypeScript and Python both declare it that way; .NET holds it as any JSON, and the ticket that commissioned this schema lists it among the arbitrary-JSON fields. Following the two that constrain it keeps the schema from accepting documents the reference client rejects, at the cost of rejecting the boolean schemas JSON Schema also permits \u2014 a bare true for \"any answer\". Recorded as a known divergence rather than settled.",++ "additionalProperties": true++ },++ "expiresAt": {++ "type": "string",++ "description": "When the interrupt stops being answerable. Deliberately unconstrained rather than a date-time format, because producers already disagree about the representation and tightening it here would reject streams that work today. The documented convention is ISO 8601, and a consumer comparing this value will parse it as a date, so a value that is not one leaves the interrupt looking permanently unexpired."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this interrupt."++ }++ },++ "required": [++ "id",++ "reason"++ ],++ "unevaluatedProperties": false++ },++ "ResumeEntry": {++ "type": "object",++ "description": "An answer to one interrupt, sent on the run that continues from it.",++ "properties": {++ "interruptId": {++ "type": "string",++ "description": "The interrupt being answered."++ },++ "status": {++ "type": "string",++ "description": "Whether the interrupt was answered or abandoned.",++ "enum": [++ "resolved",++ "cancelled"++ ]++ },++ "payload": {++ "not": {++ "type": "null"++ },++ "description": "The answer the agent asked for and will act on. Any JSON value."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Envelope information about the response, such as signatures or routing keys, as opposed to payload, which is the answer itself."++ }++ },++ "required": [++ "interruptId",++ "status"++ ],++ "unevaluatedProperties": false++ },++ "TokenUsage": {++ "type": "object",++ "description": "Token counts for one provider and model, in the protocol's own accounting: every count is either a total or a named part of one, so entries from different providers add up without double-counting. inputTokens and outputTokens are the totals; reasoningTokens, cachedInputTokens and cacheWriteInputTokens are parts of them, never additions to them; totalTokens is the two totals summed. Every field is a label or a number \u2014 nothing content-bearing or identifying, no prompts, completions, messages, or thread, run and user identifiers.",++ "properties": {++ "provider": {++ "type": "string",++ "description": "Which provider served the request."++ },++ "model": {++ "type": "string",++ "description": "Which model served the request."++ },++ "inputTokens": {++ "type": "integer",++ "minimum": 0,++ "maximum": 9007199254740991,++ "description": "Every prompt token the call was charged for: tokens read from a provider cache, tokens written to one, and audio or other non-text input all count here. cachedInputTokens and cacheWriteInputTokens break this number down and are never added to it \u2014 a provider that reports its cache counts beside a smaller input count has them added in by the producer before the entry leaves. Bounded like timestamp and for the same reason: a count above the JSON safe-integer range does not survive a round trip, so a consumer would silently read a different number than the producer wrote."++ },++ "outputTokens": {++ "type": "integer",++ "minimum": 0,++ "maximum": 9007199254740991,++ "description": "Every generated token, reasoning included where the provider distinguishes it. reasoningTokens breaks this number down and is never added to it \u2014 a provider that reports reasoning tokens beside a smaller completion count has them added in by the producer."++ },++ "totalTokens": {++ "type": "integer",++ "minimum": 0,++ "maximum": 9007199254740991,++ "description": "inputTokens plus outputTokens, under the accounting above. A producer MAY compute it rather than copy a provider's total, and copies a provider's total only when that total counts the same way, so a consumer can read this field as the sum of the other two."++ },++ "reasoningTokens": {++ "type": "integer",++ "minimum": 0,++ "maximum": 9007199254740991,++ "description": "Output tokens spent on reasoning, where the provider distinguishes them. Part of outputTokens, not in addition to it."++ },++ "cachedInputTokens": {++ "type": "integer",++ "minimum": 0,++ "maximum": 9007199254740991,++ "description": "Input tokens read from a provider cache. Part of inputTokens, not in addition to it, and disjoint from cacheWriteInputTokens."++ },++ "cacheWriteInputTokens": {++ "type": "integer",++ "minimum": 0,++ "maximum": 9007199254740991,++ "description": "Input tokens written to a provider cache on this call, where the provider distinguishes them. Part of inputTokens, not in addition to it, and disjoint from cachedInputTokens. Its own field because providers price a cache write differently from a cache read, so a consumer computing cost cannot do without it."++ }++ },++ "unevaluatedProperties": false++ },++ "Message": {++ "description": "Any message in a conversation. Discriminated by role.",++ "oneOf": [++ {++ "$ref": "#/definitions/DeveloperMessage"++ },++ {++ "$ref": "#/definitions/SystemMessage"++ },++ {++ "$ref": "#/definitions/AssistantMessage"++ },++ {++ "$ref": "#/definitions/UserMessage"++ },++ {++ "$ref": "#/definitions/ToolMessage"++ },++ {++ "$ref": "#/definitions/ActivityMessage"++ },++ {++ "$ref": "#/definitions/ReasoningMessage"++ }++ ]++ },++ "BaseMessage": {++ "type": "object",++ "description": "The fields shared by the developer, system, assistant and user messages. Deliberately excludes content, because a user message's content may be an array while the others are strings, and composition here intersects rather than overrides: a base that constrained content to a string would make an array content invalid. The tool, activity and reasoning messages do not compose this, because they carry no name.",++ "allOf": [++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "id": {++ "type": "string",++ "description": "Identifies the message within the conversation."++ },++ "role": {++ "type": "string",++ "description": "Who the message is from. Each message definition narrows this to a single value."++ },++ "name": {++ "type": "string",++ "description": "An optional display name for the author."++ },++ "encryptedValue": {++ "type": "string",++ "description": "A provider's opaque artefact belonging to this message, stored by a consumer and returned on a later turn."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this message."++ }++ },++ "required": [++ "id",++ "role"++ ]++ },++ "DeveloperMessage": {++ "type": "object",++ "description": "Instructions from the application developer.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseMessage"++ }++ ],++ "properties": {++ "role": {++ "const": "developer"++ },++ "content": {++ "type": "string",++ "description": "The instructions. Required: a developer message with nothing in it says nothing."++ }++ },++ "required": [++ "id",++ "role",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "SystemMessage": {++ "type": "object",++ "description": "Instructions from the system.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseMessage"++ }++ ],++ "properties": {++ "role": {++ "const": "system"++ },++ "content": {++ "type": "string",++ "description": "The instructions. Required."++ }++ },++ "required": [++ "id",++ "role",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "AssistantMessage": {++ "type": "object",++ "description": "A message from the agent. Content is optional because a turn may consist only of tool calls.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseMessage"++ }++ ],++ "properties": {++ "role": {++ "const": "assistant"++ },++ "content": {++ "type": "string",++ "description": "What the agent said, if it said anything."++ },++ "toolCalls": {++ "type": "array",++ "description": "The tool calls this turn made.",++ "items": {++ "$ref": "#/definitions/ToolCall"++ }++ }++ },++ "required": [++ "id",++ "role"++ ],++ "unevaluatedProperties": false++ },++ "UserMessage": {++ "type": "object",++ "description": "A message from the person using the application.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseMessage"++ }++ ],++ "properties": {++ "role": {++ "const": "user"++ },++ "content": {++ "description": "What the person sent: either plain text, or an ordered list of parts for a multimodal message.",++ "oneOf": [++ {++ "type": "string"++ },++ {++ "type": "array",++ "items": {++ "$ref": "#/definitions/ContentPart"++ }++ }++ ]++ }++ },++ "required": [++ "id",++ "role",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "ToolMessage": {++ "type": "object",++ "description": "What a tool returned, as a message in the conversation. Stands alone rather than composing BaseMessage, because it carries no name.",++ "allOf": [++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "id": {++ "type": "string",++ "description": "Identifies the message."++ },++ "role": {++ "const": "tool",++ "description": "Fixed. Declared here rather than inherited, because this message does not compose BaseMessage."++ },++ "content": {++ "description": "What the tool returned: either plain text, or an ordered list of parts. A tool returning structured data serialises it into text; media travel as parts of their own.",++ "oneOf": [++ {++ "type": "string"++ },++ {++ "type": "array",++ "items": {++ "$ref": "#/definitions/ContentPart"++ }++ }++ ]++ },++ "toolCallId": {++ "type": "string",++ "description": "The call this answers."++ },++ "error": {++ "type": "string",++ "description": "Why the tool failed, when it did. Present alongside content rather than instead of it, so a partial result survives a failure."++ },++ "encryptedValue": {++ "type": "string",++ "description": "A provider's opaque artefact belonging to this message."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this message."++ }++ },++ "required": [++ "id",++ "role",++ "content",++ "toolCallId"++ ],++ "unevaluatedProperties": false++ },++ "ActivityMessage": {++ "type": "object",++ "description": "Structured progress that is not conversation content, materialised as a message so it keeps its place in the sequence. Stands alone rather than composing BaseMessage, because its content is an object rather than a string.",++ "allOf": [++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "id": {++ "type": "string",++ "description": "Identifies the message."++ },++ "role": {++ "const": "activity",++ "description": "Fixed. Declared here rather than inherited, because this message does not compose BaseMessage."++ },++ "activityType": {++ "type": "string",++ "description": "What kind of activity this is. An open string: the set is the producer's."++ },++ "content": {++ "type": "object",++ "description": "The activity's payload, open by key.",++ "additionalProperties": true++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this message."++ }++ },++ "required": [++ "id",++ "role",++ "activityType",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningMessage": {++ "type": "object",++ "description": "A span of the agent's reasoning, materialised as a message. Stands alone rather than composing BaseMessage, because it carries no name.",++ "allOf": [++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "id": {++ "type": "string",++ "description": "Identifies the message."++ },++ "role": {++ "const": "reasoning",++ "description": "Fixed. Declared here rather than inherited, because this message does not compose BaseMessage."++ },++ "content": {++ "type": "string",++ "description": "The reasoning text."++ },++ "encryptedValue": {++ "type": "string",++ "description": "A provider's opaque reasoning artefact belonging to this message."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this message."++ }++ },++ "required": [++ "id",++ "role",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "ToolCall": {++ "type": "object",++ "description": "A call an assistant message made. Carries no subagent attribution of its own and inherits its containing message's, since several calls can share one parent.",++ "properties": {++ "id": {++ "type": "string",++ "description": "Identifies the call. The answering tool message carries this as its toolCallId."++ },++ "type": {++ "const": "function",++ "description": "The only kind of call the protocol models."++ },++ "function": {++ "$ref": "#/definitions/FunctionCall",++ "description": "What is being called, and with what."++ },++ "encryptedValue": {++ "type": "string",++ "description": "A provider's opaque artefact belonging to this call."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this call. Carried here rather than folded into the containing message, because several calls can share one parent and merging them would make the result depend on their order."++ }++ },++ "required": [++ "id",++ "type",++ "function"++ ],++ "unevaluatedProperties": false++ },++ "FunctionCall": {++ "type": "object",++ "description": "The name and arguments of a tool call.",++ "properties": {++ "name": {++ "type": "string",++ "description": "Which tool is being called."++ },++ "arguments": {++ "type": "string",++ "description": "The arguments as a JSON string, not as parsed JSON. Kept as written because a model can emit arguments that are not valid JSON, and losing them at the protocol boundary would hide the fault from the consumer that has to handle it."++ }++ },++ "required": [++ "name",++ "arguments"++ ],++ "unevaluatedProperties": false++ },++ "ContentPart": {++ "description": "One part of a message body: what a person sends in a user message, or what a tool returns in a tool message. Discriminated by type. Named by what the part is rather than by direction, because the same part travels into the model inside a user message and back out of the stream inside a tool result.",++ "oneOf": [++ {++ "$ref": "#/definitions/TextPart"++ },++ {++ "$ref": "#/definitions/ImagePart"++ },++ {++ "$ref": "#/definitions/AudioPart"++ },++ {++ "$ref": "#/definitions/VideoPart"++ },++ {++ "$ref": "#/definitions/DocumentPart"++ }++ ]++ },++ "TextPart": {++ "type": "object",++ "description": "A text part.",++ "properties": {++ "type": {++ "const": "text",++ "description": "Discriminator."++ },++ "id": {++ "type": "string",++ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved so that a streamed part can be matched to its entry in history once assistant messages carry parts too."++ },++ "text": {++ "type": "string",++ "description": "The text."++ },++ "metadata": {++ "not": {++ "type": "null"++ },++ "description": "Extra information about this part. Unconstrained, as on the media parts. This is where a text search hit carries its source and title, rather than the protocol modelling a search-result part of its own."++ }++ },++ "required": [++ "type",++ "text"++ ],++ "unevaluatedProperties": false++ },++ "ImagePart": {++ "type": "object",++ "description": "An image part.",++ "properties": {++ "type": {++ "const": "image",++ "description": "Discriminator."++ },++ "id": {++ "type": "string",++ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."++ },++ "source": {++ "$ref": "#/definitions/PartSource",++ "description": "Where the image comes from."++ },++ "metadata": {++ "not": {++ "type": "null"++ },++ "description": "Extra information about this part. Unconstrained rather than an object: inherited from the SDKs, which declare it unknown rather than a record; listed under known divergences in the README rather than resolved here."++ }++ },++ "required": [++ "type",++ "source"++ ],++ "unevaluatedProperties": false++ },++ "AudioPart": {++ "type": "object",++ "description": "An audio part.",++ "properties": {++ "type": {++ "const": "audio",++ "description": "Discriminator."++ },++ "id": {++ "type": "string",++ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."++ },++ "source": {++ "$ref": "#/definitions/PartSource",++ "description": "Where the audio comes from."++ },++ "metadata": {++ "not": {++ "type": "null"++ },++ "description": "Extra information about this part. Unconstrained, as on the other media parts."++ }++ },++ "required": [++ "type",++ "source"++ ],++ "unevaluatedProperties": false++ },++ "VideoPart": {++ "type": "object",++ "description": "A video part.",++ "properties": {++ "type": {++ "const": "video",++ "description": "Discriminator."++ },++ "id": {++ "type": "string",++ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."++ },++ "source": {++ "$ref": "#/definitions/PartSource",++ "description": "Where the video comes from."++ },++ "metadata": {++ "not": {++ "type": "null"++ },++ "description": "Extra information about this part. Unconstrained, as on the other media parts."++ }++ },++ "required": [++ "type",++ "source"++ ],++ "unevaluatedProperties": false++ },++ "DocumentPart": {++ "type": "object",++ "description": "A document part.",++ "properties": {++ "type": {++ "const": "document",++ "description": "Discriminator."++ },++ "id": {++ "type": "string",++ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."++ },++ "source": {++ "$ref": "#/definitions/PartSource",++ "description": "Where the document comes from."++ },++ "metadata": {++ "not": {++ "type": "null"++ },++ "description": "Extra information about this part. Unconstrained, as on the other media parts."++ }++ },++ "required": [++ "type",++ "source"++ ],++ "unevaluatedProperties": false++ },++ "PartSource": {++ "description": "Where a media part's bytes come from: carried inline, referenced by URL, or already at the provider under a handle it issued.",++ "oneOf": [++ {++ "$ref": "#/definitions/DataSource"++ },++ {++ "$ref": "#/definitions/UrlSource"++ },++ {++ "$ref": "#/definitions/FileSource"++ }++ ]++ },++ "DataSource": {++ "type": "object",++ "description": "Bytes carried inline.",++ "properties": {++ "type": {++ "const": "data",++ "description": "Discriminator."++ },++ "value": {++ "type": "string",++ "contentEncoding": "base64",++ "description": "The bytes, base64-encoded. contentEncoding is an annotation rather than a constraint in 2020-12, so a malformed string still validates here; rejecting one is the decoder's job."++ },++ "mimeType": {++ "type": "string",++ "description": "What the bytes are. Required here, unlike on a URL source, because nothing else can tell a consumer how to read them."++ }++ },++ "required": [++ "type",++ "value",++ "mimeType"++ ],++ "unevaluatedProperties": false++ },++ "UrlSource": {++ "type": "object",++ "description": "Bytes referenced by URL, fetched by whoever needs them.",++ "properties": {++ "type": {++ "const": "url",++ "description": "Discriminator."++ },++ "value": {++ "type": "string",++ "description": "The URL. Deliberately not constrained to a URI format, so a scheme a producer already uses is not rejected here."++ },++ "mimeType": {++ "type": "string",++ "description": "What the resource is, when the producer knows. Optional, because the response can say."++ }++ },++ "required": [++ "type",++ "value"++ ],++ "unevaluatedProperties": false++ },++ "FileSource": {++ "type": "object",++ "description": "Bytes already at the provider, named by a handle the provider issued: an OpenAI or Anthropic file id, a Gemini file URI, a storage URL only that provider can read. No bytes travel and nothing is fetched. Only the provider that minted the handle can resolve it; a peer that cannot drops the part as it drops any part it cannot use.",++ "properties": {++ "type": {++ "const": "file",++ "description": "Discriminator."++ },++ "value": {++ "type": "string",++ "description": "The handle, exactly as the provider issued it. Opaque: a consumer MUST NOT fetch it, parse it or read a scheme out of it."++ },++ "provider": {++ "type": "string",++ "description": "Who issued the handle, when the producer knows. Optional: an agent already knows which provider it talks to. When present, SHOULD be the lowercase vendor id (openai, anthropic, google) that TokenUsage.provider uses, so a peer can tell before sending whether a handle is one it can use."++ },++ "mimeType": {++ "type": "string",++ "description": "What the file is, when the producer knows. Optional, because the provider that holds the bytes knows."++ }++ },++ "required": [++ "type",++ "value"++ ],++ "unevaluatedProperties": false++ },++ "Context": {++ "type": "object",++ "description": "A named piece of ambient information given to the agent for the run, distinct from the conversation.",++ "properties": {++ "description": {++ "type": "string",++ "description": "What this context is, for the agent to interpret."++ },++ "value": {++ "type": "string",++ "description": "The context itself."++ }++ },++ "required": [++ "description",++ "value"++ ],++ "unevaluatedProperties": false++ },++ "Tool": {++ "type": "object",++ "description": "A tool the agent may call.",++ "properties": {++ "name": {++ "type": "string",++ "description": "The tool's name, as the agent will call it."++ },++ "description": {++ "type": "string",++ "description": "What the tool does, for the agent to decide when to use it."++ },++ "parameters": {++ "not": {++ "type": "null"++ },++ "description": "A JSON Schema describing the tool's arguments. Carried opaquely: the protocol does not constrain or validate it. Optional, because all three SDKs already treat it that way and a tool that takes no arguments has nothing to declare; an absent schema and an empty one mean the same thing to an agent."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information about the tool, for consumers that attach their own rendering or routing information to it."++ }++ },++ "required": [++ "name",++ "description"++ ],++ "unevaluatedProperties": false++ },++ "RunAgentInput": {++ "type": "object",++ "description": "A request to run an agent. Also echoed back as RUN_STARTED.input. Only threadId, runId and messages are required: those are the three the SDKs already agree on, and for tools and context an absent key and an empty array mean the same thing, so requiring them would catch nothing a producer could get wrong.",++ "properties": {++ "threadId": {++ "type": "string",++ "description": "The conversation this run belongs to."++ },++ "runId": {++ "type": "string",++ "description": "Identifies this run."++ },++ "protocolVersion": {++ "type": "string",++ "description": "The protocol version this consumer speaks, such as \"1.0\". Absent means the input was produced before the protocol carried a version \u2014 the versioning rules in the prose govern what each side does with that. Sent in-band rather than by the transport, so a recorded exchange stays self-describing."++ },++ "parentRunId": {++ "type": "string",++ "description": "The run that spawned this one."++ },++ "state": {++ "not": {++ "type": "null"++ },++ "$ref": "#/definitions/State",++ "description": "The state the run starts from."++ },++ "messages": {++ "type": "array",++ "description": "The conversation so far, in order.",++ "items": {++ "$ref": "#/definitions/Message"++ }++ },++ "tools": {++ "type": "array",++ "description": "The tools the agent may call. Absent means none.",++ "items": {++ "$ref": "#/definitions/Tool"++ }++ },++ "context": {++ "type": "array",++ "description": "Ambient information for the run. Absent means none.",++ "items": {++ "$ref": "#/definitions/Context"++ }++ },++ "forwardedProps": {++ "not": {++ "type": "null"++ },++ "description": "Application-specific values passed through to the agent untouched. Any JSON value."++ },++ "resume": {++ "type": "array",++ "description": "Answers to the interrupts that ended a previous run, when this run continues from one.",++ "items": {++ "$ref": "#/definitions/ResumeEntry"++ }++ }++ },++ "required": [++ "threadId",++ "runId",++ "messages"++ ],++ "unevaluatedProperties": false++ },++ "JsonPatch": {++ "type": "array",++ "description": "A JSON Patch document as defined by RFC 6902, referenced by STATE_DELTA.delta and ACTIVITY_DELTA.patch: an ordered sequence of operations applied to a target document. An empty array is a valid no-op patch. Whether the operations actually apply to the document they target is a runtime question RFC 6902 leaves to the applier; structural validity here says nothing about it.",++ "items": {++ "$ref": "#/definitions/JsonPatchOperation"++ }++ },++ "JsonPatchOperation": {++ "description": "A single RFC 6902 operation. Exactly one of the operation shapes must match, discriminated by op. Unlike the protocol's own objects, the operations are open: RFC 6902 section 4 requires members an operation does not define to be ignored rather than rejected, so a remove carrying a leftover value is a valid patch. Two of the RFC's rules are relations between values rather than shapes, so no static schema can express them and neither is checked here: a move whose from is a proper prefix of its path (section 4.4), and any operation whose pointer does not resolve in the target document. Both are the applier's to reject.",++ "oneOf": [++ {++ "$ref": "#/definitions/AddOperation"++ },++ {++ "$ref": "#/definitions/RemoveOperation"++ },++ {++ "$ref": "#/definitions/ReplaceOperation"++ },++ {++ "$ref": "#/definitions/MoveOperation"++ },++ {++ "$ref": "#/definitions/CopyOperation"++ },++ {++ "$ref": "#/definitions/TestOperation"++ }++ ]++ },++ "AddOperation": {++ "type": "object",++ "description": "Inserts value at path. RFC 6902 section 4.1.",++ "properties": {++ "op": {++ "const": "add",++ "description": "Discriminator for the add operation."++ },++ "path": {++ "$ref": "#/definitions/JsonPointer",++ "description": "Where to insert the value."++ },++ "value": {++ "description": "The value to insert. Any JSON value, including null, which is a legitimate thing to add."++ }++ },++ "required": [++ "op",++ "path",++ "value"++ ]++ },++ "RemoveOperation": {++ "type": "object",++ "description": "Removes the value at path. RFC 6902 section 4.2.",++ "properties": {++ "op": {++ "const": "remove",++ "description": "Discriminator for the remove operation."++ },++ "path": {++ "$ref": "#/definitions/JsonPointer",++ "description": "What to remove."++ }++ },++ "required": [++ "op",++ "path"++ ]++ },++ "ReplaceOperation": {++ "type": "object",++ "description": "Replaces the value at path. RFC 6902 section 4.3.",++ "properties": {++ "op": {++ "const": "replace",++ "description": "Discriminator for the replace operation."++ },++ "path": {++ "$ref": "#/definitions/JsonPointer",++ "description": "What to replace."++ },++ "value": {++ "description": "The replacement. Any JSON value, including null."++ }++ },++ "required": [++ "op",++ "path",++ "value"++ ]++ },++ "MoveOperation": {++ "type": "object",++ "description": "Moves the value at from to path. RFC 6902 section 4.4.",++ "properties": {++ "op": {++ "const": "move",++ "description": "Discriminator for the move operation."++ },++ "from": {++ "$ref": "#/definitions/JsonPointer",++ "description": "Where the value is moved from."++ },++ "path": {++ "$ref": "#/definitions/JsonPointer",++ "description": "Where the value is moved to."++ }++ },++ "required": [++ "op",++ "from",++ "path"++ ]++ },++ "CopyOperation": {++ "type": "object",++ "description": "Copies the value at from to path. RFC 6902 section 4.5.",++ "properties": {++ "op": {++ "const": "copy",++ "description": "Discriminator for the copy operation."++ },++ "from": {++ "$ref": "#/definitions/JsonPointer",++ "description": "Where the value is copied from."++ },++ "path": {++ "$ref": "#/definitions/JsonPointer",++ "description": "Where the value is copied to."++ }++ },++ "required": [++ "op",++ "from",++ "path"++ ]++ },++ "TestOperation": {++ "type": "object",++ "description": "Asserts that the value at path equals value. RFC 6902 section 4.6.",++ "properties": {++ "op": {++ "const": "test",++ "description": "Discriminator for the test operation."++ },++ "path": {++ "$ref": "#/definitions/JsonPointer",++ "description": "What to compare."++ },++ "value": {++ "description": "The value the target must equal. Any JSON value, including null."++ }++ },++ "required": [++ "op",++ "path",++ "value"++ ]++ },++ "JsonPointer": {++ "type": "string",++ "description": "A JSON Pointer as defined by RFC 6901. Either the empty string, meaning the whole document, or a sequence of slash-prefixed reference tokens in which a tilde is escaped as ~0 and a slash as ~1. A value with no leading slash, or a tilde followed by anything other than 0 or 1, is not a JSON Pointer.",++ "pattern": "^(/([^/~]|~[01])*)*$"++ },++ "OvSource": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "url",++ "title",++ "site"++ ],++ "properties": {++ "url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://",++ "maxLength": 2048++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 300++ },++ "site": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ }++ }++ },++ "Event": {++ "description": "Any AG-UI event. Every member is normative: there is no optional tier and no event a consumer may decline to implement. Discriminated by the type property.",++ "oneOf": [++ {++ "$ref": "#/definitions/TextMessageStartEvent"++ },++ {++ "$ref": "#/definitions/TextMessageContentEvent"++ },++ {++ "$ref": "#/definitions/TextMessageEndEvent"++ },++ {++ "$ref": "#/definitions/TextMessageChunkEvent"++ },++ {++ "$ref": "#/definitions/ToolCallStartEvent"++ },++ {++ "$ref": "#/definitions/ToolCallArgsEvent"++ },++ {++ "$ref": "#/definitions/ToolCallEndEvent"++ },++ {++ "$ref": "#/definitions/ToolCallChunkEvent"++ },++ {++ "$ref": "#/definitions/ToolCallResultEvent"++ },++ {++ "$ref": "#/definitions/StateSnapshotEvent"++ },++ {++ "$ref": "#/definitions/StateDeltaEvent"++ },++ {++ "$ref": "#/definitions/MessagesSnapshotEvent"++ },++ {++ "$ref": "#/definitions/ActivitySnapshotEvent"++ },++ {++ "$ref": "#/definitions/ActivityDeltaEvent"++ },++ {++ "$ref": "#/definitions/RawEvent"++ },++ {++ "$ref": "#/definitions/CustomEvent"++ },++ {++ "$ref": "#/definitions/RunStartedEvent"++ },++ {++ "$ref": "#/definitions/RunFinishedEvent"++ },++ {++ "$ref": "#/definitions/RunErrorEvent"++ },++ {++ "$ref": "#/definitions/StepStartedEvent"++ },++ {++ "$ref": "#/definitions/StepFinishedEvent"++ },++ {++ "$ref": "#/definitions/ReasoningStartEvent"++ },++ {++ "$ref": "#/definitions/ReasoningMessageStartEvent"++ },++ {++ "$ref": "#/definitions/ReasoningMessageContentEvent"++ },++ {++ "$ref": "#/definitions/ReasoningMessageEndEvent"++ },++ {++ "$ref": "#/definitions/ReasoningMessageChunkEvent"++ },++ {++ "$ref": "#/definitions/ReasoningEndEvent"++ },++ {++ "$ref": "#/definitions/ReasoningEncryptedValueEvent"++ },++ {++ "$ref": "#/definitions/SubagentStartedEvent"++ },++ {++ "$ref": "#/definitions/SubagentFinishedEvent"++ },++ {++ "$ref": "#/definitions/SubagentErrorEvent"++ }++ ]++ }++ }++}@@@ -5547,6 +5547,24 @@"compatibility": "backward","status": "active"},++ {++ "id": "chat.command-registration-request",++ "version": "1.0.0",++ "owner": "chat",++ "schema": "chat/command-registration-request.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "chat.command-registration-result",++ "version": "1.0.0",++ "owner": "chat",++ "schema": "chat/command-registration-result.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },{"id": "chat.send-request","version": "1.1.0",@@@ -5700,6 +5718,24 @@"compatibility": "backward","status": "active"},++ {++ "id": "chat.person-memory-result",++ "version": "1.0.0",++ "owner": "chat",++ "schema": "chat/person-memory-result.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "chat.person-memory-preferences-result",++ "version": "1.0.0",++ "owner": "chat",++ "schema": "chat/person-memory-preferences-result.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },{"id": "chat.embed","version": "1.0.0",@@@ -6170,6 +6206,24 @@"compatibility": "backward","status": "active"},++ {++ "id": "community.feed-card",++ "version": "1.0.0",++ "owner": "community",++ "schema": "community/feed-card.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "community.feed-answer",++ "version": "1.0.0",++ "owner": "community",++ "schema": "community/feed-answer.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },{"id": "community.pulse-read-result","version": "1.0.0",@@@ -11258,6 +11312,105 @@"visibility": "public","compatibility": "backward","status": "active"++ },++ {++ "id": "composer.attachment",++ "version": "1.0.0",++ "owner": "media",++ "schema": "composer/attachment.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "composer.prefs",++ "version": "1.0.0",++ "owner": "network",++ "schema": "composer/prefs.v1.json",++ "visibility": "first-party",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "composer.mention",++ "version": "1.0.0",++ "owner": "network",++ "schema": "composer/mention.v1.json",++ "visibility": "first-party",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "network.user-card",++ "version": "1.0.0",++ "owner": "network",++ "schema": "network/user-card.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "network.user-report",++ "version": "1.0.0",++ "owner": "network",++ "schema": "network/user-report.v1.json",++ "visibility": "first-party",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "network.user-report-list-result",++ "version": "1.0.0",++ "owner": "network",++ "schema": "network/user-report-list-result.v1.json",++ "visibility": "first-party",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "network.user-report-request",++ "version": "1.0.0",++ "owner": "network",++ "schema": "network/user-report-request.v1.json",++ "visibility": "first-party",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "agent.ui-event",++ "version": "1.0.0",++ "owner": "actor",++ "schema": "agent/ui-event.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "agent.run",++ "version": "1.0.0",++ "owner": "actor",++ "schema": "agent/run.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "actor.agent-sheet",++ "version": "1.0.0",++ "owner": "actor",++ "schema": "actor/agent-sheet.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"++ },++ {++ "id": "codes.agent-sheet",++ "version": "1.0.0",++ "owner": "codes",++ "schema": "codes/agent-sheet.v1.json",++ "visibility": "public",++ "compatibility": "backward",++ "status": "active"}]}nnew file mode 100644@@@ -0,0 +1,14 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/chat/command-registration-request.v1.json",++ "title": "Chat command registration request",++ "description": "chat.command-registration-request@1: an approved app or Actor agent registers a plain-response command in a server that the person named in its service token manages. The command cannot override a built-in. The template's {args} placeholder receives the invoking person's argument text; Chat posts the expanded result as that person after checking their current room rights.",++ "type": "object",++ "additionalProperties": false,++ "required": ["server", "command", "response_template"],++ "properties": {++ "server": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{1,31}$" },++ "command": { "$ref": "command.v1.json" },++ "response_template": { "type": "string", "minLength": 1, "maxLength": 2000 }++ }++}nnew file mode 100644@@@ -0,0 +1,12 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/chat/command-registration-result.v1.json",++ "title": "Chat command registration result",++ "description": "chat.command-registration-result@1: the command Chat stored for an approved app or Actor agent, with source and application_id derived from the verified service token.",++ "type": "object",++ "additionalProperties": false,++ "required": ["command"],++ "properties": {++ "command": { "$ref": "command.v1.json" }++ }++}@@@ -2,14 +2,34 @@"$schema": "https://json-schema.org/draft/2020-12/schema","$id": "https://openvibe.network/contracts/chat/embed.v1.json","title": "ChatEmbed",-- "description": "chat.embed@1: one address preview under a chat message, the same shape for every client (OpenVibe.Chat, Live's chat and the Dock). A message carries `embeds` in the order the addresses appeared in its text, at most three; it is empty while the background job is still reading, and the client draws each one as the same card. The fields are data, never markup: a client escapes them (title, description, site_name, by) before drawing them. url is the address the writer sent, https only. image is an OpenVibe.Media address or null: another site's picture is never hot-linked. width and height are the picture's stated size, or 0. kind names what was found: an ordinary page (`link`), a video (`video`), a picture (`image`), a Live channel (`live`), a Pics picture (`picture`), a Design item (`design`), a Community post (`post`), a Network profile (`profile`) or a Games world (`game`). OpenVibe's own kinds are resolved through that service's public API, never by reading its page, and carry by (the person or channel the thing belongs to) and, for Live, live (whether the channel is broadcasting now); both are absent on an ordinary link.",++ "description": "chat.embed@1: one address preview under a chat message, the same shape for every client (OpenVibe.Chat, Live's chat and the Dock). A message carries `embeds` in the order the addresses appeared in its text, at most three; it is empty while the background job is still reading, and the client draws each one as the same card. The fields are data, never markup: a client escapes them (title, description, site_name, by) before drawing them. url is the address the writer sent, https only. image is an OpenVibe.Media address or null: another site's picture is never hot-linked. width and height are the picture's stated size, or 0. kind names what was found: an ordinary page (`link`), a video (`video`), a picture (`image`), a Live channel (`live`), a Pics picture (`picture`), a Design item (`design`), a Community post (`post`), a Network profile (`profile`) or a Games world (`game`). OpenVibe's own kinds are resolved through that service's public API, never by reading its page, and carry by (the person or channel the thing belongs to) and, for Live, live (whether the channel is broadcasting now); both are absent on an ordinary link. An agent-run embed carries the live run and event addresses, title and status.","type": "object","additionalProperties": false,-- "required": ["kind", "url", "site_name", "title", "description", "image", "width", "height"],++ "required": [++ "kind",++ "url",++ "site_name",++ "title",++ "description",++ "image",++ "width",++ "height"++ ],"properties": {"kind": {"type": "string",-- "enum": ["link", "video", "image", "live", "picture", "design", "post", "profile", "game"],++ "enum": [++ "link",++ "video",++ "image",++ "live",++ "picture",++ "design",++ "post",++ "profile",++ "game",++ "agent-run"++ ],"description": "What the address turned out to be; a client may draw the same card for every value."},"url": {@@@ -27,8 +47,7 @@"title": {"type": "string","minLength": 1,-- "maxLength": 120,-- "description": "The page's or service's title, folded to plain text."++ "maxLength": 240},"description": {"type": "string",@@@ -36,7 +55,10 @@"description": "A short plain-text description, or an empty string when the source states none."},"image": {-- "type": ["string", "null"],++ "type": [++ "string",++ "null"++ ],"format": "uri","maxLength": 2048,"description": "The preview picture, only when it already lives on OpenVibe.Media; null when the source's picture would have to be hot-linked."@@@ -61,6 +83,51 @@"live": {"type": "boolean","description": "On a Live channel kind, whether it is broadcasting now. Absent on the other kinds."++ },++ "run_url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://",++ "maxLength": 2048++ },++ "events_url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://",++ "maxLength": 2048++ },++ "status": {++ "enum": [++ "queued",++ "running",++ "waiting",++ "needs_you",++ "succeeded",++ "failed",++ "stopped",++ "cancelled"++ ]++ }++ },++ "allOf": [++ {++ "if": {++ "properties": {++ "kind": {++ "const": "agent-run"++ }++ },++ "required": [++ "kind"++ ]++ },++ "then": {++ "required": [++ "run_url",++ "events_url",++ "status"++ ]++ }}-- }++ ]}nnew file mode 100644@@@ -0,0 +1,13 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/chat/person-memory-preferences-result.v1.json",++ "title": "ChatPersonMemoryPreferencesResult",++ "description": "chat.person-memory-preferences-result@1: the person's delete or opt-out result.",++ "type": "object",++ "additionalProperties": false,++ "required": ["opted_out"],++ "properties": {++ "opted_out": { "type": "boolean" },++ "deleted": { "type": "boolean" }++ }++}nnew file mode 100644@@@ -0,0 +1,46 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/chat/person-memory-result.v1.json",++ "title": "ChatPersonMemoryResult",++ "description": "chat.person-memory-result@1: compacted chat memory returned by GET /api/v1/people/{username}/memory. Private fields appear only for the person and the channel owner.",++ "type": "object",++ "additionalProperties": false,++ "required": ["username", "level", "channel", "entries", "opted_out", "enabled"],++ "properties": {++ "username": { "type": "string", "minLength": 1 },++ "level": { "enum": ["day", "week", "month"] },++ "channel": { "type": ["string", "null"] },++ "opted_out": { "type": "boolean" },++ "enabled": { "type": "boolean" },++ "entries": {++ "type": "array", "maxItems": 60,++ "items": {++ "type": "object", "additionalProperties": false,++ "required": ["level", "period_start", "channel_user_id", "summary", "topics", "highlights", "message_count"],++ "properties": {++ "level": { "enum": ["day", "week", "month"] },++ "period_start": { "type": "string", "format": "date" },++ "channel_user_id": { "type": "integer" },++ "summary": { "type": "string", "maxLength": 500 },++ "topics": { "type": "array", "maxItems": 5, "items": { "type": "string" } },++ "highlights": {++ "type": "array", "maxItems": 5,++ "items": {++ "type": "object", "additionalProperties": false,++ "required": ["detail", "stream_id", "at"],++ "properties": {++ "detail": { "type": "string", "maxLength": 180 },++ "stream_id": { "type": ["integer", "null"] },++ "at": { "type": ["string", "null"] }++ }++ }++ },++ "message_count": { "type": "integer", "minimum": 0 },++ "tone": { "type": "string", "maxLength": 120 },++ "catchphrases": { "type": "array", "maxItems": 5, "items": { "type": "string" } },++ "people": { "type": "array", "maxItems": 8, "items": { "type": "string" } }++ }++ }++ }++ }++}nnew file mode 100644@@@ -0,0 +1,24 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/codes/agent-sheet.v1.json",++ "title": "CodesAgentSheet",++ "description": "codes.agent-sheet@1: one owner's coding harness, its real attempts, outcomes and machine availability. Empty memory, schedule and computer sections mean Codes has no such per-harness records. GET /api/v1/me/agents/:id/sheet; never cache this answer.",++ "type": "object",++ "additionalProperties": false,++ "required": ["agent", "now", "work", "activity", "asks", "asks_empty", "computer", "schedules", "memory", "identity"],++ "properties": {++ "agent": {"type": "object", "required": ["id", "name", "face", "state", "kind", "availability"], "properties": {"id": {"type": "string"}, "name": {"type": "string"}, "face": {"type": "null"}, "state": {"type": "string"}, "kind": {"const": "coding harness"}, "availability": {"type": ["object", "null"]}}, "additionalProperties": false},++ "now": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/work"}]},++ "work": {"type": "array", "items": {"$ref": "#/$defs/work"}},++ "activity": {"type": "array", "items": {"type": "object", "required": ["day", "entries"], "properties": {"day": {"type": "string", "format": "date"}, "entries": {"type": "array", "items": {"type": "object"}}}, "additionalProperties": false}},++ "asks": {"type": "array", "maxItems": 0},++ "asks_empty": {"type": "string"},++ "computer": {"type": "null"},++ "schedules": {"type": "array", "maxItems": 0},++ "memory": {"type": "array", "maxItems": 0},++ "identity": {"type": "object", "required": ["provider", "capabilities"], "properties": {"provider": {"type": ["string", "null"]}, "capabilities": {"type": "object"}}, "additionalProperties": false}++ },++ "$defs": {++ "work": {"type": "object", "additionalProperties": false, "required": ["id", "task_id", "title", "what", "result", "state", "outcome", "cost_usd", "machine", "repo", "started_at", "finished_at", "url"], "properties": {"id": {"type": "string"}, "task_id": {"type": "string"}, "title": {"type": "string"}, "what": {"type": ["string", "null"]}, "result": {"type": ["string", "null"]}, "state": {"type": "string"}, "outcome": {"type": ["string", "null"]}, "cost_usd": {"type": ["number", "null"], "minimum": 0}, "machine": {"type": ["string", "null"]}, "repo": {"type": ["string", "null"]}, "started_at": {"type": "string"}, "finished_at": {"type": ["string", "null"]}, "url": {"type": "string"}}}++ }++}nnew file mode 100644@@@ -0,0 +1,13 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/community/feed-answer.v1.json",++ "title": "CommunityFeedAnswer",++ "description": "community.feed-answer@1: the response from GET /api/v1/feed.",++ "type": "object",++ "additionalProperties": false,++ "required": ["items", "next_cursor"],++ "properties": {++ "items": { "type": "array", "items": { "$ref": "feed-card.v1.json" } },++ "next_cursor": { "type": ["string", "null"] }++ }++}nnew file mode 100644@@@ -0,0 +1,24 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/community/feed-card.v1.json",++ "title": "CommunityFeedCard",++ "description": "community.feed-card@1: one public card returned by GET /api/v1/feed on OpenVibe.Community.",++ "type": "object",++ "additionalProperties": false,++ "required": ["id", "kind", "url", "title", "text", "at", "site", "site_name", "actor", "media", "counts"],++ "properties": {++ "id": { "type": "string", "minLength": 1, "maxLength": 500 },++ "kind": { "enum": ["live", "stream", "clip", "video", "pic", "post", "meme", "game", "update", "wiki", "quest", "chat", "event", "member"] },++ "url": { "type": "string", "pattern": "^https?://", "maxLength": 2000 },++ "title": { "type": "string", "maxLength": 300 },++ "text": { "type": "string", "maxLength": 280 },++ "at": { "type": ["string", "null"], "format": "date-time" },++ "site": { "type": "string", "maxLength": 40 },++ "site_name": { "type": "string", "maxLength": 40 },++ "actor": { "type": ["object", "null"], "required": ["name", "avatar"], "properties": { "name": { "type": ["string", "null"], "maxLength": 80 }, "avatar": { "type": ["string", "null"], "maxLength": 2000 } }, "additionalProperties": false },++ "media": { "type": ["object", "null"], "required": ["thumb", "ratio"], "properties": { "thumb": { "type": "string", "pattern": "^https://", "maxLength": 2000 }, "preview": { "type": ["string", "null"], "pattern": "^https://", "maxLength": 2000 }, "ratio": { "type": "number", "exclusiveMinimum": 0 }, "length": { "type": "number", "minimum": 0 } }, "additionalProperties": false },++ "counts": { "type": "object", "properties": { "views": { "type": "integer", "minimum": 0 }, "likes": { "type": "integer", "minimum": 0 }, "comments": { "type": "integer", "minimum": 0 } }, "additionalProperties": false },++ "live_now": { "type": "boolean" },++ "label": { "enum": ["Trending", "AI", "System"] }++ }++}@@@ -2,7 +2,7 @@"$schema": "https://json-schema.org/draft/2020-12/schema","$id": "https://openvibe.network/contracts/community/feed-item.v1.json","title": "CommunityFeedItem",-- "description": "community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). One stream over Pulse: a paste or a status is a post, a Live clip a clip, a Wiki page a wiki page, a Quest badge a quest, a busy Chat hour a chat, a Today event an event, and a day's new Network accounts a member. Text only (the client draws every field), https links only, and counts carry Community's own views, likes and comments where it knows them.",++ "description": "community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). Each card keeps its source and public visibility. Scheduled calendar cards appear only before their start time; bursts can carry a group of links. Counts carry Community's own views, likes and comments where it knows them.","type": "object","additionalProperties": false,"required": ["id", "kind", "url", "title", "text", "at", "site", "site_name", "actor", "media", "counts"],@@@ -14,7 +14,7 @@"description": "Stable within one response: p:<pulse item id> for a Pulse item, t:<site>:<url> for a trending card."},"kind": {-- "enum": ["live", "stream", "clip", "video", "pic", "post", "meme", "game", "update", "wiki", "quest", "chat", "event", "member"]++ "enum": ["live", "stream", "clip", "video", "pic", "post", "meme", "game", "update", "wiki", "quest", "chat", "event", "member", "avatar", "banner", "paste", "site", "space", "follow", "episode"]},"url": {"type": "string",@@@ -33,6 +33,12 @@"format": "date-time","description": "When it happened (Pulse provenance); null for a trending card."},++ "starts_at": {++ "type": "string",++ "format": "date-time",++ "description": "The start time of a Coming up calendar item; absent on other kinds."++ },++ "visibility": { "enum": ["followers"], "description": "Present only for an item returned to a follower or its author." },"site": {"type": "string","maxLength": 40,@@@ -55,6 +61,7 @@"required": ["thumb", "ratio"],"properties": {"thumb": { "type": "string", "pattern": "^https://", "maxLength": 2000 },++ "preview": { "type": "string", "pattern": "^https://", "maxLength": 2000 },"ratio": { "type": "number", "exclusiveMinimum": 0 },"length": { "type": "number", "minimum": 0, "description": "Seconds, when the card is a video." }},@@@ -74,6 +81,29 @@"type": "boolean","description": "Present on live and stream cards: true only while the channel is currently on air. A past broadcast has kind stream and live_now false."},++ "group": {++ "type": "object",++ "required": ["count", "items"],++ "properties": {++ "count": { "type": "integer", "minimum": 2 },++ "items": {++ "type": "array",++ "minItems": 2,++ "items": {++ "type": "object",++ "required": ["id", "url", "title", "media"],++ "properties": {++ "id": { "type": "string" },++ "url": { "type": "string", "pattern": "^https://" },++ "title": { "type": "string" },++ "media": { "type": ["object", "null"] }++ },++ "additionalProperties": false++ }++ }++ },++ "additionalProperties": false++ },"label": {"enum": ["Trending", "AI", "System"],"description": "Present only when the card needs one."@@@ -51,6 +51,9 @@"system"]},++ "visibility": { "enum": ["followers"], "description": "Present only for an item returned to an authorized follower or its author." },++ "starts_at": { "type": "string", "format": "date-time" },++ "actor_name": { "type": "string", "maxLength": 80 },"label": {"enum": ["AI", "System", null]},@@@ -2,7 +2,7 @@"$schema": "https://json-schema.org/draft/2020-12/schema","$id": "https://openvibe.network/contracts/community/pulse-write-request.v1.json","title": "CommunityPulseWriteRequest",-- "description": "community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities (ref.service must be that service: 403 pulse.foreign_ref otherwise), with a title (whitespace collapsed, 1 to 300 characters) and an absolute http(s) url (at most 2000 characters). origin defaults to X-OV-Origin (user, ai or system; X-OV-Origin: ai always wins); an origin user item names the person in X-OV-Subject. occurred_at is an ISO time, not in the future (default now). Only public activity enters Pulse: a visibility other than public is 400 pulse.not_public. The same ref again updates the item. Unknown fields are ignored. DELETE /api/v1/pulse/items/:service/:type/:id takes no body.",++ "description": "community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities, with a title and an absolute http(s) URL. Optional media carries an HTTPS thumbnail, preview video, aspect ratio and duration for Feed cards. Visibility is public by default; followers requires origin user and X-OV-Subject and is shown only to that person's followers. Private, unlisted and members items are refused. The same ref updates the item. DELETE /api/v1/pulse/items/:service/:type/:id retracts it.","anyOf": [{"type": "object",@@@ -44,8 +44,38 @@"visibility": {"enum": ["public",++ "followers",null]++ },++ "media": {++ "type": "object",++ "additionalProperties": false,++ "properties": {++ "thumb": {++ "type": "string",++ "pattern": "^https://",++ "maxLength": 2000++ },++ "preview": {++ "type": [++ "string",++ "null"++ ],++ "pattern": "^https://",++ "maxLength": 2000++ },++ "ratio": {++ "type": "number",++ "exclusiveMinimum": 0,++ "maximum": 20++ },++ "length": {++ "type": "number",++ "minimum": 0,++ "maximum": 86400++ }++ }}}},nnew file mode 100644@@@ -0,0 +1,60 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/composer/attachment.v1.json",++ "title": "ComposerAttachment",++ "description": "composer.attachment@1: one file a person attached to a message in the shared composer. Media stores it and answers this shape from POST /api/v1/attachments (multipart field `file`); a client keeps it until the message is sent, then names it in POST /api/v1/attachments/:id/keep. `kind` is sniffed from the bytes, never taken from the browser: image, video, audio, file or code. `thumb` is a small preview for images and video (absent for the rest), `w`/`h` the pixel size when the file is one Media can measure. An attachment nobody keeps expires after 24 hours; `expires_at` says when, and a keep extends it to the message's life.",++ "type": "object",++ "additionalProperties": false,++ "required": ["id", "kind", "name", "size", "mime", "url", "expires_at"],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The attachment id (att_ + ULID): what DELETE /api/v1/attachments/:id and POST /api/v1/attachments/:id/keep name."++ },++ "kind": {++ "enum": ["image", "video", "audio", "file", "code"],++ "description": "Decided by Media from the bytes, not the client's claim: image/video/audio when the signature matches, code for recognised source text, otherwise file. Executables are refused at upload."++ },++ "name": {++ "type": "string",++ "minLength": 1,++ "maxLength": 255,++ "description": "The file's original name, sanitised for display; never a path."++ },++ "size": {++ "type": "integer",++ "minimum": 1,++ "description": "Bytes stored."++ },++ "mime": {++ "type": "string",++ "description": "The content type Media serves the bytes as, from the sniffed kind and format."++ },++ "url": {++ "type": "string",++ "format": "uri",++ "description": "Absolute https URL the bytes are served at. It stays valid while the attachment exists; a kept attachment is the message's to serve."++ },++ "thumb": {++ "type": ["string", "null"],++ "format": "uri",++ "description": "Absolute URL of a preview image: an image's own small copy or a video's first frame. Null when Media could not make one (or the kind has none)."++ },++ "w": {++ "type": ["integer", "null"],++ "minimum": 1,++ "description": "Pixel width of an image, video or video preview; null when unknown."++ },++ "h": {++ "type": ["integer", "null"],++ "minimum": 1,++ "description": "Pixel height of an image, video or video preview; null when unknown."++ },++ "expires_at": {++ "type": "string",++ "format": "date-time",++ "description": "When an unkept attachment is deleted. The upload answers now + 24 hours; a keep moves it to the kept window."++ }++ }++}nnew file mode 100644@@@ -0,0 +1,43 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/composer/mention.v1.json",++ "title": "ComposerMention",++ "description": "composer.mention@1: one thing the composer's @ menu can insert, from GET /api/v1/mentions on OpenVibe.Network. kind person (a person the caller follows first, then a public person), repo (a repository on OpenVibe Git the caller can see), site (a first-party OpenVibe site) or file (a file of the message's own context). `id` is the stable id inside its kind, `label` what the menu shows, `handle` the @name when the kind has one, `avatar` the picture, and `url` where choosing it links.",++ "type": "object",++ "additionalProperties": false,++ "required": ["kind", "id", "label", "url"],++ "properties": {++ "kind": {++ "enum": ["person", "repo", "site", "file"],++ "description": "What is mentioned. The same person is a person; a repository on OpenVibe Git is a repo; a first-party OpenVibe site is a site; a file of the message's context (an attachment or a repository file) is a file."++ },++ "id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200,++ "description": "The stable id inside the kind: a usr_… subject for a person, owner/name for a repo, a site id for a site, a path or attachment id for a file."++ },++ "label": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200,++ "description": "What the menu shows (a display name, owner/name, the site's name, a file name)."++ },++ "handle": {++ "type": "string",++ "maxLength": 64,++ "pattern": "^[A-Za-z0-9_.-]+$",++ "description": "The @name when the kind has one: a person's username, a site's short name. Absent for a repo or a file."++ },++ "avatar": {++ "type": ["string", "null"],++ "format": "uri",++ "description": "Absolute URL of the picture to show beside the label. Null when the kind has none (a file, a site without a mark)."++ },++ "url": {++ "type": "string",++ "format": "uri",++ "description": "Absolute https URL where choosing the mention leads: the person's profile, the repository, the site's home or the file."++ }++ }++}nnew file mode 100644@@@ -0,0 +1,71 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/composer/prefs.v1.json",++ "title": "ComposerPrefs",++ "description": "composer.prefs@1: a person's composer settings, the same on every OpenVibe site because Network stores them (GET/PUT /api/v1/me/composer). `rev` is the stored revision: send the one you read back with your change, and a tab that read an older copy gets 409 with the current document instead of overwriting the other tab. `send_key` says whether Enter or Ctrl/Cmd+Enter sends. `tools` is the one order of the composer's tools and which are hidden; a tool id the client does not know is kept, so a site can add one without another site dropping the person's order. `snippets` are the person's saved inserts, triggered by typing a slash word.",++ "type": "object",++ "additionalProperties": false,++ "required": ["rev", "send_key", "tools", "density", "voice", "snippets"],++ "properties": {++ "rev": {++ "type": "integer",++ "minimum": 0,++ "description": "Revision of the stored document. A missing document is rev 0 with the defaults; every successful PUT answers rev + 1."++ },++ "send_key": {++ "enum": ["enter", "mod-enter"],++ "description": "enter: Enter sends and Shift+Enter breaks the line. mod-enter: Ctrl/Cmd+Enter sends and Enter breaks the line (the default on a phone keyboard is enter)."++ },++ "tools": {++ "type": "array",++ "maxItems": 100,++ "description": "Every tool in the order the person wants them, each marked hidden or not.",++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": ["id", "hidden"],++ "properties": {++ "id": { "type": "string", "minLength": 1, "maxLength": 40, "pattern": "^[a-z0-9][a-z0-9._-]*$" },++ "hidden": { "type": "boolean" }++ }++ }++ },++ "density": {++ "enum": ["comfy", "compact"],++ "description": "How much room the composer takes: comfy is the default on a computer, compact on a phone."++ },++ "voice": {++ "type": "boolean",++ "description": "Whether the composer offers dictation (where the device has it)."++ },++ "snippets": {++ "type": "array",++ "maxItems": 50,++ "description": "Saved inserts. Typing the trigger (a slash word such as /sig) in the composer offers the snippet.",++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": ["trigger", "label", "text"],++ "properties": {++ "trigger": {++ "type": "string",++ "pattern": "^/[a-z0-9][a-z0-9_-]{0,31}$",++ "description": "The slash word that offers the snippet, e.g. /sig. Lower-case letters, digits, _ and - only."++ },++ "label": {++ "type": "string",++ "minLength": 1,++ "maxLength": 80,++ "description": "What the menu shows."++ },++ "text": {++ "type": "string",++ "minLength": 1,++ "maxLength": 4000,++ "description": "What is inserted."++ }++ }++ }++ }++ }++}@@@ -158,6 +158,13 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."++ },"started_at": {"type": ["string",@@@ -92,6 +92,13 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."++ },"started_at": {"type": ["string",@@@ -206,6 +213,13 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."++ },"started_at": {"type": ["string",@@@ -116,6 +116,20 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "The hover preview of this item: about 6 s, muted, 320 px wide, MP4 H.264, stored beside its thumbnail and served at /t/<name>. Null until the preview.make job has made it (audio-only, private and too-short items never get one)."++ },++ "preview_webm_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "The same moment as preview_url, encoded as WebM (VP9, VP8 where the encoder has no VP9). Null while preview_url is."++ },"storage_provider": {"type": "string"},@@@ -103,6 +103,20 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "The hover preview of this item: about 6 s, muted, 320 px wide, MP4 H.264, stored beside its thumbnail and served at /t/<name>. Null until the preview.make job has made it (audio-only, private and too-short items never get one)."++ },++ "preview_webm_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "The same moment as preview_url, encoded as WebM (VP9, VP8 where the encoder has no VP9). Null while preview_url is."++ },"storage_provider": {"type": "string","description": "local, b2 or r2."nnew file mode 100644@@@ -0,0 +1,91 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/network/user-card.v1.json",++ "title": "NetworkUserCard",++ "description": "network.user-card@1 (ask 287): the one public user card read, GET /api/v1/people/:username/card on OpenVibe.Network. It is public and credential-free; a signed-in viewer may send their Network token (Authorization: Bearer …) and then also receives `actions` computed for that viewer, never cached. Without a viewer, or on the viewer's own card, `actions` carries Profile and Channel only. A missing, expired or revoked token reads as anonymous, never a 401. Hidden fields are absent, never zero, offline or a placeholder; no presence, page titles or visited URLs leave the read.",++ "type": "object",++ "required": ["username", "profile_url", "actions"],++ "additionalProperties": false,++ "properties": {++ "username": { "type": "string", "pattern": "^[A-Za-z0-9_]{3,24}$" },++ "display_name": { "type": "string", "minLength": 1, "maxLength": 200 },++ "avatar_url": { "type": "string", "format": "uri", "pattern": "^https://" },++ "profile_url": { "type": "string", "format": "uri", "pattern": "^https://" },++ "level": { "type": "integer", "minimum": 0 },++ "streak": { "type": "integer", "minimum": 0 },++ "badges_count": { "type": "integer", "minimum": 0 },++ "followers": { "type": "integer", "minimum": 0 },++ "live": {++ "type": "object",++ "required": ["now"],++ "additionalProperties": false,++ "properties": {++ "now": { "type": "boolean" },++ "site": { "const": "live" },++ "url": { "type": "string", "format": "uri", "pattern": "^https://" }++ }++ },++ "channel_url": { "type": "string", "format": "uri", "pattern": "^https://" },++ "active_sites": {++ "type": "array",++ "items": {++ "type": "object",++ "required": ["id", "name", "url"],++ "additionalProperties": false,++ "properties": {++ "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,39}$" },++ "name": { "type": "string", "minLength": 1, "maxLength": 80 },++ "url": { "type": "string", "format": "uri", "pattern": "^https://" }++ }++ }++ },++ "actions": {++ "type": "array",++ "description": "What the viewer can do, by what is possible for the pair. Order is the card's order. Each action either opens somewhere (`href`) or calls a Network route with the viewer's token (`method` + `path`, and `body` where the route needs one).",++ "items": { "$ref": "#/$defs/action" }++ }++ },++ "$defs": {++ "action": {++ "oneOf": [++ {++ "type": "object",++ "required": ["id", "label", "href"],++ "additionalProperties": false,++ "properties": {++ "id": { "$ref": "#/$defs/id" },++ "label": { "$ref": "#/$defs/label" },++ "href": { "type": "string", "format": "uri", "pattern": "^https://" },++ "state": { "$ref": "#/$defs/state" }++ }++ },++ {++ "type": "object",++ "required": ["id", "label", "method", "path"],++ "additionalProperties": false,++ "properties": {++ "id": { "$ref": "#/$defs/id" },++ "label": { "$ref": "#/$defs/label" },++ "method": { "enum": ["PUT", "POST", "DELETE", "PATCH"] },++ "path": { "type": "string", "pattern": "^/api/v1/" },++ "body": { "type": "object" },++ "state": { "$ref": "#/$defs/state" }++ }++ }++ ]++ },++ "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,39}$" },++ "label": { "type": "string", "minLength": 1, "maxLength": 40 },++ "state": {++ "type": "object",++ "additionalProperties": false,++ "properties": {++ "following": { "type": "boolean" },++ "friendship": { "enum": ["none", "pending", "requested", "friends"] },++ "muted": { "type": "boolean" },++ "blocked": { "type": "boolean" },++ "reported": { "type": "boolean" }++ }++ }++ }++}nnew file mode 100644@@@ -0,0 +1,12 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/network/user-report-list-result.v1.json",++ "title": "NetworkUserReportListResult",++ "description": "network.user-report-list-result@1 (ask 287): GET /api/v1/staff/user-reports on OpenVibe.Network, the staff queue for people holding staff.moderation.logs. Newest first, filtered by status (default open) and target subject, at most 200 rows (`limit`, default 50). A caller without the capability gets 403 user_reports.forbidden (problem+json).",++ "type": "object",++ "required": ["reports"],++ "additionalProperties": false,++ "properties": {++ "reports": { "type": "array", "maxItems": 200, "items": { "$ref": "user-report.v1.json" } }++ }++}nnew file mode 100644@@@ -0,0 +1,14 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/network/user-report-request.v1.json",++ "title": "NetworkUserReportRequest",++ "description": "network.user-report-request@1 (ask 287): POST /api/v1/me/reports on OpenVibe.Network, a signed-in person's report about another person. `target` is their username (any case) or usr_ subject; guests cannot be named, and nobody reports themselves. The same pair may have one open report: filing again while it is open answers the open one with 200 instead of creating a duplicate (201 when it creates one).",++ "type": "object",++ "required": ["target", "reason"],++ "additionalProperties": false,++ "properties": {++ "target": { "type": "string", "pattern": "^([A-Za-z0-9_]{3,24}|usr_[0-9A-HJKMNP-TV-Z]{26})$" },++ "reason": { "enum": ["spam", "harassment", "impersonation", "explicit", "scam", "other"] },++ "detail": { "type": "string", "maxLength": 2000 }++ }++}nnew file mode 100644@@@ -0,0 +1,19 @@++{++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/network/user-report.v1.json",++ "title": "NetworkUserReport",++ "description": "network.user-report@1 (ask 287): one report a person filed about another person on OpenVibe.Network. Reports never resolve themselves; staff holding staff.moderation.logs read the queue (GET /api/v1/staff/user-reports?status=open&target=usr_…&limit=), and a staff decision lives in the moderation audit log. `status` records whether staff have looked, not a verdict.",++ "type": "object",++ "required": ["id", "reporter", "target", "reason", "detail", "status", "created_at", "updated_at"],++ "additionalProperties": false,++ "properties": {++ "id": { "type": "integer", "minimum": 1 },++ "reporter": { "type": "string", "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$" },++ "target": { "type": "string", "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$" },++ "reason": { "enum": ["spam", "harassment", "impersonation", "explicit", "scam", "other"] },++ "detail": { "type": "string", "maxLength": 2000 },++ "status": { "enum": ["open", "reviewed", "dismissed"] },++ "created_at": { "type": "string", "format": "date-time" },++ "updated_at": { "type": "string", "format": "date-time" }++ }++}nnew file mode 100644@@@ -0,0 +1 @@++{"now": null, "work": [], "asks": [], "asks_empty": null, "computer": null, "schedules": [], "memory": [], "activity": []}nnew file mode 100644@@@ -0,0 +1,11 @@++{++ "agent": {"id": "agt_00000000000000000000000000", "name": "Helper", "face": null, "state": "idle", "instructions": "Help with alerts", "voice": null},++ "now": null,++ "work": [],++ "asks": [],++ "asks_empty": "Requests to approve or decline will appear here.",++ "computer": null,++ "schedules": [{"schedule": "off", "next_run_at": null, "last_run_at": null, "last_result": null}],++ "memory": [],++ "activity": []++}nnew file mode 100644@@@ -0,0 +1,13 @@++{++ "id": "run_1",++ "product": "codes",++ "title": "Review",++ "status": "unknown",++ "plan": [],++ "steps": [],++ "sources": [],++ "result": null,++ "started_at": "bad",++ "ended_at": null,++ "cost_usd": -1++}nnew file mode 100644@@@ -0,0 +1,18 @@++{++ "id": "run_1",++ "product": "codes",++ "title": "Review repositories",++ "status": "running",++ "plan": [++ {++ "title": "Read repositories",++ "status": "running"++ }++ ],++ "steps": [],++ "sources": [],++ "result": null,++ "started_at": "2026-11-11T00:00:00Z",++ "ended_at": null,++ "cost_usd": null++}nnew file mode 100644@@@ -0,0 +1,22 @@++{++ "type": "ACTIVITY_SNAPSHOT",++ "timestamp": 1794355200000,++ "activityType": "plan",++ "content": {++ "step": "read"++ },++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,19 @@++{++ "type": "CUSTOM",++ "timestamp": 1794355200000,++ "name": "ov.sources",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,4 @@++{++ "type": "NOT_AN_AGUI_EVENT",++ "timestamp": "not-an-epoch"++}nnew file mode 100644@@@ -0,0 +1,19 @@++{++ "type": "RAW",++ "timestamp": 1794355200000,++ "source": "codes",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,18 @@++{++ "type": "REASONING_START",++ "timestamp": 1794355200000,++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,19 @@++{++ "type": "RUN_STARTED",++ "timestamp": 1794355200000,++ "threadId": "thread_1",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,18 @@++{++ "type": "STATE_SNAPSHOT",++ "timestamp": 1794355200000,++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,18 @@++{++ "type": "STEP_STARTED",++ "timestamp": 1794355200000,++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,19 @@++{++ "type": "SUBAGENT_STARTED",++ "timestamp": 1794355200000,++ "subagentRunId": "sub_1",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,19 @@++{++ "type": "TEXT_MESSAGE_CONTENT",++ "timestamp": 1794355200000,++ "delta": "Reading source",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,19 @@++{++ "type": "TOOL_CALL_START",++ "timestamp": 1794355200000,++ "toolCallName": "read_file",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,23 @@++{++ "type": "ACTIVITY_SNAPSHOT",++ "timestamp": 1794355200000,++ "messageId": "activity_1",++ "activityType": "plan",++ "content": {++ "step": "read"++ },++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,26 @@++{++ "type": "CUSTOM",++ "timestamp": 1794355200000,++ "name": "ov.sources",++ "value": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ],++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,18 @@++{++ "type": "STEP_STARTED",++ "timestamp": 1794355200000,++ "metadata": {++ "ov": {++ "title": "Searching the web",++ "kind": "search",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ },++ "stepName": "Research"++}nnew file mode 100644@@@ -0,0 +1,22 @@++{++ "type": "RAW",++ "timestamp": 1794355200000,++ "event": {++ "provider": "native"++ },++ "source": "codes",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,19 @@++{++ "type": "REASONING_START",++ "timestamp": 1794355200000,++ "messageId": "reason_1",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,28 @@++{++ "type": "RUN_STARTED",++ "timestamp": 1794355200000,++ "threadId": "thread_1",++ "runId": "run_1",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ],++ "needs_you": {++ "id": "approval_1",++ "question": "May I publish the result?",++ "actions": [++ "approve",++ "decline"++ ]++ }++ }++ }++}nnew file mode 100644@@@ -0,0 +1,21 @@++{++ "type": "STATE_SNAPSHOT",++ "timestamp": 1794355200000,++ "snapshot": {++ "plan": []++ },++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,19 @@++{++ "type": "STEP_STARTED",++ "timestamp": 1794355200000,++ "stepName": "Read repositories",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,20 @@++{++ "type": "SUBAGENT_STARTED",++ "timestamp": 1794355200000,++ "subagentRunId": "sub_1",++ "name": "Research",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,20 @@++{++ "type": "TEXT_MESSAGE_CONTENT",++ "timestamp": 1794355200000,++ "messageId": "msg_1",++ "delta": "Reading source",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,20 @@++{++ "type": "TOOL_CALL_START",++ "timestamp": 1794355200000,++ "toolCallId": "call_1",++ "toolCallName": "read_file",++ "metadata": {++ "ov": {++ "title": "Researching the question",++ "kind": "read",++ "product": "codes",++ "sources": [++ {++ "url": "https://example.com",++ "title": "Example",++ "site": "example.com"++ }++ ]++ }++ }++}nnew file mode 100644@@@ -0,0 +1,4 @@++{++ "server": "command-tests",++ "command": { "name": "hello", "description": "Say hello", "options": [] }++}nnew file mode 100644@@@ -0,0 +1,5 @@++{++ "server": "command-tests",++ "command": { "name": "hello", "description": "Say hello", "options": [{ "name": "text", "description": "Who to greet", "type": "string", "required": false }] },++ "response_template": "Hello, {args}!"++}nnew file mode 100644@@@ -0,0 +1 @@++{}nnew file mode 100644@@@ -0,0 +1,3 @@++{++ "command": { "name": "hello", "description": "Say hello", "options": [], "source": "app", "application_id": "app:app_01J8Z3Q4R5S6T7V8W9X0Y1Z2A3" }++}nnew file mode 100644@@@ -0,0 +1,13 @@++{++ "kind": "agent-run",++ "url": "https://openvibe.codes/runs/run_1",++ "site_name": "OpenVibe.Codes",++ "title": "Review repositories",++ "description": "",++ "image": null,++ "width": 0,++ "height": 0,++ "run_url": "https://openvibe.codes/api/v1/runs/run_1",++ "events_url": "http://insecure.test/events",++ "status": "running"++}nnew file mode 100644@@@ -0,0 +1,13 @@++{++ "kind": "agent-run",++ "url": "https://openvibe.codes/runs/run_1",++ "site_name": "OpenVibe.Codes",++ "title": "Review repositories",++ "description": "",++ "image": null,++ "width": 0,++ "height": 0,++ "run_url": "https://openvibe.codes/api/v1/runs/run_1",++ "events_url": "https://openvibe.codes/api/v1/runs/run_1/events",++ "status": "running"++}nnew file mode 100644@@@ -0,0 +1 @@++{ "deleted": true }nnew file mode 100644@@@ -0,0 +1 @@++{ "opted_out": true, "deleted": true }nnew file mode 100644@@@ -0,0 +1,15 @@++{++ "username": "alice",++ "level": "day",++ "channel": "streamer",++ "enabled": true,++ "opted_out": false,++ "entries": [{++ "level": "day",++ "period_start": "2026-11-11",++ "channel_user_id": 42,++ "summary": "Alice discussed a game with chat.",++ "topics": [],++ "highlights": []++ }]++}nnew file mode 100644@@@ -0,0 +1,16 @@++{++ "username": "alice",++ "level": "day",++ "channel": "streamer",++ "enabled": true,++ "opted_out": false,++ "entries": [{++ "level": "day",++ "period_start": "2026-11-11",++ "channel_user_id": 42,++ "summary": "Alice discussed a game with chat.",++ "topics": ["game"],++ "highlights": [{ "detail": "A game win", "stream_id": 123, "at": "2026-11-11 04:00:00" }],++ "message_count": 25++ }]++}nnew file mode 100644@@@ -0,0 +1,12 @@++{++ "agent": {"id": "codex", "name": "Codex", "face": null, "state": "ready", "kind": "coding harness", "availability": null},++ "now": null,++ "work": [],++ "activity": [],++ "asks": [],++ "asks_empty": "Requests to approve coding work will appear here when this agent needs you.",++ "computer": null,++ "schedules": [],++ "memory": [{"text": "not a Codes record"}],++ "identity": {"provider": null, "capabilities": {}}++}nnew file mode 100644@@@ -0,0 +1,12 @@++{++ "agent": {"id": "codex", "name": "Codex", "face": null, "state": "ready", "kind": "coding harness", "availability": null},++ "now": null,++ "work": [],++ "activity": [],++ "asks": [],++ "asks_empty": "Requests to approve coding work will appear here when this agent needs you.",++ "computer": null,++ "schedules": [],++ "memory": [],++ "identity": {"provider": null, "capabilities": {}}++}nnew file mode 100644@@@ -0,0 +1 @@++{ "items": [] }nnew file mode 100644@@@ -0,0 +1,16 @@++{++ "items": [{++ "id": "p:42",++ "kind": "post",++ "url": "https://openvibe.community/p/42",++ "title": "A post",++ "text": "Hello",++ "at": null,++ "site": "community",++ "site_name": "Community",++ "actor": null,++ "media": null,++ "counts": {}++ }],++ "next_cursor": null++}nnew file mode 100644@@@ -0,0 +1,12 @@++{++ "id": "p:42",++ "kind": "clip",++ "url": "https://openvibe.live/clip/42",++ "text": "A short clip",++ "at": null,++ "site": "live",++ "site_name": "Live",++ "actor": null,++ "media": null,++ "counts": {}++}nnew file mode 100644@@@ -0,0 +1,14 @@++{++ "id": "p:42",++ "kind": "clip",++ "url": "https://openvibe.live/clip/42",++ "title": "A highlight",++ "text": "A short clip",++ "at": "2026-11-10T12:00:00.000Z",++ "site": "live",++ "site_name": "Live",++ "actor": { "name": "Ada", "avatar": null },++ "media": { "thumb": "https://openvibe.media/42.webp", "preview": "https://openvibe.media/42.mp4", "ratio": 1.7778, "length": 18 },++ "counts": { "views": 12, "likes": 3, "comments": 1 },++ "live_now": false++}nnew file mode 100644@@@ -0,0 +1 @@++{ "ref": { "service": "live", "type": "clip", "id": "med_01JAB2C3D4E5F6G7H8J9K0MNPQ" }, "title": "Bad clip media", "url": "https://openvibe.live/clip/1", "media": { "thumb": "http://openvibe.media/clip.webp", "ratio": 1.7 } }@@@ -1 +1 @@--{ "ref": { "service": "live", "type": "clip", "id": "med_01JAB2C3D4E5F6G7H8J9K0MNPQ" }, "title": "Alice clipped a clean 1v3", "url": "https://openvibe.live/clip/med_01JAB2C3D4E5F6G7H8J9K0MNPQ", "origin": "user", "occurred_at": "2026-09-25T18:00:00Z", "visibility": "public" }++{ "ref": { "service": "live", "type": "clip", "id": "med_01JAB2C3D4E5F6G7H8J9K0MNPQ" }, "title": "Alice clipped a clean 1v3", "url": "https://openvibe.live/clip/med_01JAB2C3D4E5F6G7H8J9K0MNPQ", "origin": "user", "occurred_at": "2026-09-25T18:00:00Z", "visibility": "public", "media": { "thumb": "https://openvibe.media/clip.webp", "preview": "https://openvibe.media/clip.mp4", "ratio": 1.7778, "length": 22 } }nnew file mode 100644@@@ -0,0 +1,9 @@++{++ "id": "att_1",++ "kind": "file",++ "name": "a.txt",++ "size": 1,++ "mime": "text/plain",++ "url": "https://openvibe.media/a/x/a.txt",++ "expires_at": "2026-11-11T12:00:00.000Z"++}nnew file mode 100644@@@ -0,0 +1,9 @@++{++ "id": "att_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "kind": "spreadsheet",++ "name": "book.xlsx",++ "size": 12,++ "mime": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",++ "url": "https://openvibe.media/a/x/book.xlsx",++ "expires_at": "2026-11-11T12:00:00.000Z"++}nnew file mode 100644@@@ -0,0 +1,8 @@++{++ "id": "att_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "kind": "image",++ "name": "screenshot.png",++ "size": 184320,++ "mime": "image/png",++ "expires_at": "2026-11-11T12:00:00.000Z"++}nnew file mode 100644@@@ -0,0 +1,9 @@++{++ "id": "att_01JAB2C3D4E5F6G7H8J9K0MNPS",++ "kind": "file",++ "name": "notes.txt",++ "size": 42,++ "mime": "text/plain",++ "url": "https://openvibe.media/a/01JAB2C3D4E5F6G7H8J9K0MNPS/notes.txt",++ "expires_at": "2026-11-11T12:00:00.000Z"++}nnew file mode 100644@@@ -0,0 +1,12 @@++{++ "id": "att_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "kind": "image",++ "name": "screenshot.png",++ "size": 184320,++ "mime": "image/png",++ "url": "https://openvibe.media/a/01JAB2C3D4E5F6G7H8J9K0MNPQ/screenshot.png",++ "thumb": "https://openvibe.media/a/01JAB2C3D4E5F6G7H8J9K0MNPQ/thumb.jpg",++ "w": 1280,++ "h": 720,++ "expires_at": "2026-11-11T12:00:00.000Z"++}nnew file mode 100644@@@ -0,0 +1,12 @@++{++ "id": "att_01JAB2C3D4E5F6G7H8J9K0MNPR",++ "kind": "video",++ "name": "clip.mp4",++ "size": 52428800,++ "mime": "video/mp4",++ "url": "https://openvibe.media/a/01JAB2C3D4E5F6G7H8J9K0MNPR/clip.mp4",++ "thumb": "https://openvibe.media/a/01JAB2C3D4E5F6G7H8J9K0MNPR/thumb.jpg",++ "w": 1920,++ "h": 1080,++ "expires_at": "2026-11-11T12:00:00.000Z"++}nnew file mode 100644@@@ -0,0 +1,6 @@++{++ "kind": "channel",++ "id": "openvibe",++ "label": "OpenVibe",++ "url": "https://openvibe.live/openvibe"++}nnew file mode 100644@@@ -0,0 +1,5 @@++{++ "kind": "site",++ "id": "live",++ "url": "https://openvibe.live"++}nnew file mode 100644@@@ -0,0 +1,8 @@++{++ "kind": "person",++ "id": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",++ "label": "Sam Rivera",++ "handle": "sam",++ "avatar": "https://openvibe.network/avatar/sam?s=64",++ "url": "https://openvibe.network/@sam"++}nnew file mode 100644@@@ -0,0 +1,6 @@++{++ "kind": "repo",++ "id": "openvibers/OpenVibe.Contracts",++ "label": "OpenVibers/OpenVibe.Contracts",++ "url": "https://git.openvibe.codes/OpenVibers/OpenVibe.Contracts"++}nnew file mode 100644@@@ -0,0 +1,10 @@++{++ "rev": 0,++ "send_key": "enter",++ "tools": [],++ "density": "comfy",++ "voice": false,++ "snippets": [++ { "trigger": "sig", "label": "Signature", "text": "— Sam" }++ ]++}nnew file mode 100644@@@ -0,0 +1,60 @@++{++ "rev": 0,++ "send_key": "enter",++ "tools": [],++ "density": "comfy",++ "voice": false,++ "snippets": [++ { "trigger": "/s1", "label": "s1", "text": "1" },++ { "trigger": "/s2", "label": "s2", "text": "2" },++ { "trigger": "/s3", "label": "s3", "text": "3" },++ { "trigger": "/s4", "label": "s4", "text": "4" },++ { "trigger": "/s5", "label": "s5", "text": "5" },++ { "trigger": "/s6", "label": "s6", "text": "6" },++ { "trigger": "/s7", "label": "s7", "text": "7" },++ { "trigger": "/s8", "label": "s8", "text": "8" },++ { "trigger": "/s9", "label": "s9", "text": "9" },++ { "trigger": "/s10", "label": "s10", "text": "10" },++ { "trigger": "/s11", "label": "s11", "text": "11" },++ { "trigger": "/s12", "label": "s12", "text": "12" },++ { "trigger": "/s13", "label": "s13", "text": "13" },++ { "trigger": "/s14", "label": "s14", "text": "14" },++ { "trigger": "/s15", "label": "s15", "text": "15" },++ { "trigger": "/s16", "label": "s16", "text": "16" },++ { "trigger": "/s17", "label": "s17", "text": "17" },++ { "trigger": "/s18", "label": "s18", "text": "18" },++ { "trigger": "/s19", "label": "s19", "text": "19" },++ { "trigger": "/s20", "label": "s20", "text": "20" },++ { "trigger": "/s21", "label": "s21", "text": "21" },++ { "trigger": "/s22", "label": "s22", "text": "22" },++ { "trigger": "/s23", "label": "s23", "text": "23" },++ { "trigger": "/s24", "label": "s24", "text": "24" },++ { "trigger": "/s25", "label": "s25", "text": "25" },++ { "trigger": "/s26", "label": "s26", "text": "26" },++ { "trigger": "/s27", "label": "s27", "text": "27" },++ { "trigger": "/s28", "label": "s28", "text": "28" },++ { "trigger": "/s29", "label": "s29", "text": "29" },++ { "trigger": "/s30", "label": "s30", "text": "30" },++ { "trigger": "/s31", "label": "s31", "text": "31" },++ { "trigger": "/s32", "label": "s32", "text": "32" },++ { "trigger": "/s33", "label": "s33", "text": "33" },++ { "trigger": "/s34", "label": "s34", "text": "34" },++ { "trigger": "/s35", "label": "s35", "text": "35" },++ { "trigger": "/s36", "label": "s36", "text": "36" },++ { "trigger": "/s37", "label": "s37", "text": "37" },++ { "trigger": "/s38", "label": "s38", "text": "38" },++ { "trigger": "/s39", "label": "s39", "text": "39" },++ { "trigger": "/s40", "label": "s40", "text": "40" },++ { "trigger": "/s41", "label": "s41", "text": "41" },++ { "trigger": "/s42", "label": "s42", "text": "42" },++ { "trigger": "/s43", "label": "s43", "text": "43" },++ { "trigger": "/s44", "label": "s44", "text": "44" },++ { "trigger": "/s45", "label": "s45", "text": "45" },++ { "trigger": "/s46", "label": "s46", "text": "46" },++ { "trigger": "/s47", "label": "s47", "text": "47" },++ { "trigger": "/s48", "label": "s48", "text": "48" },++ { "trigger": "/s49", "label": "s49", "text": "49" },++ { "trigger": "/s50", "label": "s50", "text": "50" },++ { "trigger": "/s51", "label": "s51", "text": "51" }++ ]++}nnew file mode 100644@@@ -0,0 +1,15 @@++{++ "rev": 0,++ "send_key": "mod-enter",++ "tools": [++ { "id": "attach", "hidden": false },++ { "id": "camera", "hidden": false },++ { "id": "voice", "hidden": false },++ { "id": "gif", "hidden": true }++ ],++ "density": "comfy",++ "voice": true,++ "snippets": [++ { "trigger": "/sig", "label": "My signature", "text": "— Sam" }++ ]++}nnew file mode 100644@@@ -0,0 +1,10 @@++{++ "rev": 7,++ "send_key": "enter",++ "tools": [],++ "density": "compact",++ "voice": false,++ "snippets": [++ { "trigger": "/long", "label": "Long text", "text": "x" }++ ]++}nnew file mode 100644@@@ -0,0 +1,5 @@++{++ "username": "Example",++ "profile_url": "https://openvibe.network/@Example",++ "actions": [{ "id": "message", "label": "Message", "state": {} }]++}nnew file mode 100644@@@ -0,0 +1,5 @@++{++ "username": "Example",++ "profile_url": "https://openvibe.network/@Example",++ "actions": [{ "id": "add-friend", "label": "Add friend", "method": "PUT", "path": "/api/v1/me/friends/Example", "state": { "friendship": "maybe" } }]++}nnew file mode 100644@@@ -0,0 +1,5 @@++{++ "username": "Example",++ "profile_url": "https://openvibe.network/@Example",++ "actions": [{ "id": "profile", "label": "Profile", "href": "http://openvibe.network/@Example" }]++}nnew file mode 100644@@@ -0,0 +1,17 @@++{++ "username": "Example",++ "display_name": "Example",++ "avatar_url": "https://openvibe.network/avatar/Example?s=160",++ "profile_url": "https://openvibe.network/@Example",++ "level": 4,++ "streak": 3,++ "badges_count": 2,++ "followers": 10,++ "live": { "now": true, "site": "live", "url": "https://openvibe.live/@Example" },++ "channel_url": "https://openvibe.live/@Example",++ "active_sites": [{ "id": "live", "name": "Live", "url": "https://openvibe.live" }],++ "actions": [++ { "id": "profile", "label": "Profile", "href": "https://openvibe.network/@Example" },++ { "id": "channel", "label": "Channel", "href": "https://openvibe.live/@Example" }++ ]++}nnew file mode 100644@@@ -0,0 +1,14 @@++{++ "username": "Example",++ "profile_url": "https://openvibe.network/@Example",++ "actions": [++ { "id": "profile", "label": "Profile", "href": "https://openvibe.network/@Example" },++ { "id": "message", "label": "Message", "href": "https://openvibe.chat/messages" },++ { "id": "follow", "label": "Follow", "method": "PUT", "path": "/api/v1/me/follows/channel/Example", "state": { "following": false } },++ { "id": "add-friend", "label": "Add friend", "method": "PUT", "path": "/api/v1/me/friends/Example", "state": { "friendship": "none" } },++ { "id": "tip", "label": "Tip", "href": "https://openvibe.tips/Example" },++ { "id": "mute", "label": "Mute", "method": "PUT", "path": "/api/v1/me/mutes/Example", "state": { "muted": false } },++ { "id": "block", "label": "Block", "method": "PUT", "path": "/api/v1/me/blocks/Example", "state": { "blocked": false } },++ { "id": "report", "label": "Report", "method": "POST", "path": "/api/v1/me/reports", "body": { "target": "Example", "reason": "other", "detail": "" }, "state": { "reported": false } }++ ]++}nnew file mode 100644@@@ -0,0 +1 @@++{ "reports": [{ "id": 1, "reporter": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1", "target": "not-a-subject", "reason": "spam", "detail": "", "status": "open", "created_at": "2026-11-11T03:30:00Z", "updated_at": "2026-11-11T03:30:00Z" }] }nnew file mode 100644@@@ -0,0 +1 @@++{ "reports": {} }nnew file mode 100644@@@ -0,0 +1 @@++{ "reports": [] }nnew file mode 100644@@@ -0,0 +1,14 @@++{++ "reports": [++ {++ "id": 12,++ "reporter": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1",++ "target": "usr_01JAB2C3D4E5F6G7H8J9K0MNT2",++ "reason": "spam",++ "detail": "",++ "status": "open",++ "created_at": "2026-11-11T03:30:00Z",++ "updated_at": "2026-11-11T03:30:00Z"++ }++ ]++}nnew file mode 100644@@@ -0,0 +1 @@++{ "target": "Example", "reason": "dislike" }nnew file mode 100644@@@ -0,0 +1 @@++{ "reason": "spam" }nnew file mode 100644@@@ -0,0 +1 @@++{ "target": "Example", "reason": "spam", "detail": "Sending the same link in every room." }nnew file mode 100644@@@ -0,0 +1 @@++{ "target": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1", "reason": "harassment" }nnew file mode 100644@@@ -0,0 +1,10 @@++{++ "id": 12,++ "reporter": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1",++ "target": "usr_01JAB2C3D4E5F6G7H8J9K0MNT2",++ "reason": "spam",++ "detail": "",++ "status": "banned",++ "created_at": "2026-11-11T03:30:00Z",++ "updated_at": "2026-11-11T03:30:00Z"++}nnew file mode 100644@@@ -0,0 +1,11 @@++{++ "id": 12,++ "reporter": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1",++ "target": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1",++ "reason": "spam",++ "detail": "",++ "status": "open",++ "created_at": "2026-11-11T03:30:00Z",++ "updated_at": "2026-11-11T03:30:00Z",++ "extra": true++}nnew file mode 100644@@@ -0,0 +1,10 @@++{++ "id": 12,++ "reporter": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1",++ "target": "usr_01JAB2C3D4E5F6G7H8J9K0MNT2",++ "reason": "spam",++ "detail": "Sending the same link in every room.",++ "status": "open",++ "created_at": "2026-11-11T03:30:00Z",++ "updated_at": "2026-11-11T03:30:00Z"++}@@@ -58980,6 +58980,20 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "The hover preview of this item: about 6 s, muted, 320 px wide, MP4 H.264, stored beside its thumbnail and served at /t/<name>. Null until the preview.make job has made it (audio-only, private and too-short items never get one)."++ },++ "preview_webm_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "The same moment as preview_url, encoded as WebM (VP9, VP8 where the encoder has no VP9). Null while preview_url is."++ },"storage_provider": {"type": "string","description": "local, b2 or r2."@@@ -59188,6 +59202,20 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "The hover preview of this item: about 6 s, muted, 320 px wide, MP4 H.264, stored beside its thumbnail and served at /t/<name>. Null until the preview.make job has made it (audio-only, private and too-short items never get one)."++ },++ "preview_webm_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "The same moment as preview_url, encoded as WebM (VP9, VP8 where the encoder has no VP9). Null while preview_url is."++ },"storage_provider": {"type": "string"},@@@ -60116,6 +60144,59 @@}}},++ "chat.command-registration-request": {++ "version": "1.0.0",++ "owner": "chat",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/chat/command-registration-request.v1.json",++ "title": "Chat command registration request",++ "description": "chat.command-registration-request@1: an approved app or Actor agent registers a plain-response command in a server that the person named in its service token manages. The command cannot override a built-in. The template's {args} placeholder receives the invoking person's argument text; Chat posts the expanded result as that person after checking their current room rights.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "server",++ "command",++ "response_template"++ ],++ "properties": {++ "server": {++ "type": "string",++ "pattern": "^[a-z0-9][a-z0-9-]{1,31}$"++ },++ "command": {++ "$ref": "command.v1.json"++ },++ "response_template": {++ "type": "string",++ "minLength": 1,++ "maxLength": 2000++ }++ }++ }++ },++ "chat.command-registration-result": {++ "version": "1.0.0",++ "owner": "chat",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/chat/command-registration-result.v1.json",++ "title": "Chat command registration result",++ "description": "chat.command-registration-result@1: the command Chat stored for an approved app or Actor agent, with source and application_id derived from the verified service token.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "command"++ ],++ "properties": {++ "command": {++ "$ref": "command.v1.json"++ }++ }++ }++ },"chat.send-request": {"version": "1.1.0","owner": "chat",@@@ -63577,6 +63658,173 @@}}},++ "chat.person-memory-result": {++ "version": "1.0.0",++ "owner": "chat",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/chat/person-memory-result.v1.json",++ "title": "ChatPersonMemoryResult",++ "description": "chat.person-memory-result@1: compacted chat memory returned by GET /api/v1/people/{username}/memory. Private fields appear only for the person and the channel owner.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "username",++ "level",++ "channel",++ "entries",++ "opted_out",++ "enabled"++ ],++ "properties": {++ "username": {++ "type": "string",++ "minLength": 1++ },++ "level": {++ "enum": [++ "day",++ "week",++ "month"++ ]++ },++ "channel": {++ "type": [++ "string",++ "null"++ ]++ },++ "opted_out": {++ "type": "boolean"++ },++ "enabled": {++ "type": "boolean"++ },++ "entries": {++ "type": "array",++ "maxItems": 60,++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "level",++ "period_start",++ "channel_user_id",++ "summary",++ "topics",++ "highlights",++ "message_count"++ ],++ "properties": {++ "level": {++ "enum": [++ "day",++ "week",++ "month"++ ]++ },++ "period_start": {++ "type": "string",++ "format": "date"++ },++ "channel_user_id": {++ "type": "integer"++ },++ "summary": {++ "type": "string",++ "maxLength": 500++ },++ "topics": {++ "type": "array",++ "maxItems": 5,++ "items": {++ "type": "string"++ }++ },++ "highlights": {++ "type": "array",++ "maxItems": 5,++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "detail",++ "stream_id",++ "at"++ ],++ "properties": {++ "detail": {++ "type": "string",++ "maxLength": 180++ },++ "stream_id": {++ "type": [++ "integer",++ "null"++ ]++ },++ "at": {++ "type": [++ "string",++ "null"++ ]++ }++ }++ }++ },++ "message_count": {++ "type": "integer",++ "minimum": 0++ },++ "tone": {++ "type": "string",++ "maxLength": 120++ },++ "catchphrases": {++ "type": "array",++ "maxItems": 5,++ "items": {++ "type": "string"++ }++ },++ "people": {++ "type": "array",++ "maxItems": 8,++ "items": {++ "type": "string"++ }++ }++ }++ }++ }++ }++ }++ },++ "chat.person-memory-preferences-result": {++ "version": "1.0.0",++ "owner": "chat",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/chat/person-memory-preferences-result.v1.json",++ "title": "ChatPersonMemoryPreferencesResult",++ "description": "chat.person-memory-preferences-result@1: the person's delete or opt-out result.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "opted_out"++ ],++ "properties": {++ "opted_out": {++ "type": "boolean"++ },++ "deleted": {++ "type": "boolean"++ }++ }++ }++ },"chat.embed": {"version": "1.0.0","owner": "chat",@@@ -63585,7 +63833,7 @@"$schema": "https://json-schema.org/draft/2020-12/schema","$id": "https://openvibe.network/contracts/chat/embed.v1.json","title": "ChatEmbed",-- "description": "chat.embed@1: one address preview under a chat message, the same shape for every client (OpenVibe.Chat, Live's chat and the Dock). A message carries `embeds` in the order the addresses appeared in its text, at most three; it is empty while the background job is still reading, and the client draws each one as the same card. The fields are data, never markup: a client escapes them (title, description, site_name, by) before drawing them. url is the address the writer sent, https only. image is an OpenVibe.Media address or null: another site's picture is never hot-linked. width and height are the picture's stated size, or 0. kind names what was found: an ordinary page (`link`), a video (`video`), a picture (`image`), a Live channel (`live`), a Pics picture (`picture`), a Design item (`design`), a Community post (`post`), a Network profile (`profile`) or a Games world (`game`). OpenVibe's own kinds are resolved through that service's public API, never by reading its page, and carry by (the person or channel the thing belongs to) and, for Live, live (whether the channel is broadcasting now); both are absent on an ordinary link.",++ "description": "chat.embed@1: one address preview under a chat message, the same shape for every client (OpenVibe.Chat, Live's chat and the Dock). A message carries `embeds` in the order the addresses appeared in its text, at most three; it is empty while the background job is still reading, and the client draws each one as the same card. The fields are data, never markup: a client escapes them (title, description, site_name, by) before drawing them. url is the address the writer sent, https only. image is an OpenVibe.Media address or null: another site's picture is never hot-linked. width and height are the picture's stated size, or 0. kind names what was found: an ordinary page (`link`), a video (`video`), a picture (`image`), a Live channel (`live`), a Pics picture (`picture`), a Design item (`design`), a Community post (`post`), a Network profile (`profile`) or a Games world (`game`). OpenVibe's own kinds are resolved through that service's public API, never by reading its page, and carry by (the person or channel the thing belongs to) and, for Live, live (whether the channel is broadcasting now); both are absent on an ordinary link. An agent-run embed carries the live run and event addresses, title and status.","type": "object","additionalProperties": false,"required": [@@@ -63610,7 +63858,8 @@"design","post","profile",-- "game"++ "game",++ "agent-run"],"description": "What the address turned out to be; a client may draw the same card for every value."},@@@ -63629,8 +63878,7 @@"title": {"type": "string","minLength": 1,-- "maxLength": 120,-- "description": "The page's or service's title, folded to plain text."++ "maxLength": 240},"description": {"type": "string",@@@ -63666,8 +63914,53 @@"live": {"type": "boolean","description": "On a Live channel kind, whether it is broadcasting now. Absent on the other kinds."++ },++ "run_url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://",++ "maxLength": 2048++ },++ "events_url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://",++ "maxLength": 2048++ },++ "status": {++ "enum": [++ "queued",++ "running",++ "waiting",++ "needs_you",++ "succeeded",++ "failed",++ "stopped",++ "cancelled"++ ]}-- }++ },++ "allOf": [++ {++ "if": {++ "properties": {++ "kind": {++ "const": "agent-run"++ }++ },++ "required": [++ "kind"++ ]++ },++ "then": {++ "required": [++ "run_url",++ "events_url",++ "status"++ ]++ }++ }++ ]}},"chat.first-chat-result": {@@@ -64966,6 +65259,13 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."++ },"started_at": {"type": ["string",@@@ -65960,6 +66260,13 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."++ },"started_at": {"type": ["string",@@@ -66074,6 +66381,13 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."++ },"started_at": {"type": ["string",@@@ -68251,7 +68565,7 @@"$schema": "https://json-schema.org/draft/2020-12/schema","$id": "https://openvibe.network/contracts/community/pulse-write-request.v1.json","title": "CommunityPulseWriteRequest",-- "description": "community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities (ref.service must be that service: 403 pulse.foreign_ref otherwise), with a title (whitespace collapsed, 1 to 300 characters) and an absolute http(s) url (at most 2000 characters). origin defaults to X-OV-Origin (user, ai or system; X-OV-Origin: ai always wins); an origin user item names the person in X-OV-Subject. occurred_at is an ISO time, not in the future (default now). Only public activity enters Pulse: a visibility other than public is 400 pulse.not_public. The same ref again updates the item. Unknown fields are ignored. DELETE /api/v1/pulse/items/:service/:type/:id takes no body.",++ "description": "community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities, with a title and an absolute http(s) URL. Optional media carries an HTTPS thumbnail, preview video, aspect ratio and duration for Feed cards. Visibility is public by default; followers requires origin user and X-OV-Subject and is shown only to that person's followers. Private, unlisted and members items are refused. The same ref updates the item. DELETE /api/v1/pulse/items/:service/:type/:id retracts it.","anyOf": [{"type": "object",@@@ -68293,8 +68607,38 @@"visibility": {"enum": ["public",++ "followers",null]++ },++ "media": {++ "type": "object",++ "additionalProperties": false,++ "properties": {++ "thumb": {++ "type": "string",++ "pattern": "^https://",++ "maxLength": 2000++ },++ "preview": {++ "type": [++ "string",++ "null"++ ],++ "pattern": "^https://",++ "maxLength": 2000++ },++ "ratio": {++ "type": "number",++ "exclusiveMinimum": 0,++ "maximum": 20++ },++ "length": {++ "type": "number",++ "minimum": 0,++ "maximum": 86400++ }++ }}}},@@@ -68936,6 +69280,20 @@"system"]},++ "visibility": {++ "enum": [++ "followers"++ ],++ "description": "Present only for an item returned to an authorized follower or its author."++ },++ "starts_at": {++ "type": "string",++ "format": "date-time"++ },++ "actor_name": {++ "type": "string",++ "maxLength": 80++ },"label": {"enum": ["AI",@@@ -69021,7 +69379,7 @@"$schema": "https://json-schema.org/draft/2020-12/schema","$id": "https://openvibe.network/contracts/community/feed-item.v1.json","title": "CommunityFeedItem",-- "description": "community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). One stream over Pulse: a paste or a status is a post, a Live clip a clip, a Wiki page a wiki page, a Quest badge a quest, a busy Chat hour a chat, a Today event an event, and a day's new Network accounts a member. Text only (the client draws every field), https links only, and counts carry Community's own views, likes and comments where it knows them.",++ "description": "community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). Each card keeps its source and public visibility. Scheduled calendar cards appear only before their start time; bursts can carry a group of links. Counts carry Community's own views, likes and comments where it knows them.","type": "object","additionalProperties": false,"required": [@@@ -69059,7 +69417,14 @@"quest","chat","event",-- "member"++ "member",++ "avatar",++ "banner",++ "paste",++ "site",++ "space",++ "follow",++ "episode"]},"url": {@@@ -69085,6 +69450,17 @@"format": "date-time","description": "When it happened (Pulse provenance); null for a trending card."},++ "starts_at": {++ "type": "string",++ "format": "date-time",++ "description": "The start time of a Coming up calendar item; absent on other kinds."++ },++ "visibility": {++ "enum": [++ "followers"++ ],++ "description": "Present only for an item returned to a follower or its author."++ },"site": {"type": "string","maxLength": 40,@@@ -69138,6 +69514,11 @@"pattern": "^https://","maxLength": 2000},++ "preview": {++ "type": "string",++ "pattern": "^https://",++ "maxLength": 2000++ },"ratio": {"type": "number","exclusiveMinimum": 0@@@ -69173,6 +69554,52 @@"type": "boolean","description": "Present on live and stream cards: true only while the channel is currently on air. A past broadcast has kind stream and live_now false."},++ "group": {++ "type": "object",++ "required": [++ "count",++ "items"++ ],++ "properties": {++ "count": {++ "type": "integer",++ "minimum": 2++ },++ "items": {++ "type": "array",++ "minItems": 2,++ "items": {++ "type": "object",++ "required": [++ "id",++ "url",++ "title",++ "media"++ ],++ "properties": {++ "id": {++ "type": "string"++ },++ "url": {++ "type": "string",++ "pattern": "^https://"++ },++ "title": {++ "type": "string"++ },++ "media": {++ "type": [++ "object",++ "null"++ ]++ }++ },++ "additionalProperties": false++ }++ }++ },++ "additionalProperties": false++ },"label": {"enum": ["Trending",@@@ -69184,6 +69611,205 @@}}},++ "community.feed-card": {++ "version": "1.0.0",++ "owner": "community",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/community/feed-card.v1.json",++ "title": "CommunityFeedCard",++ "description": "community.feed-card@1: one public card returned by GET /api/v1/feed on OpenVibe.Community.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "kind",++ "url",++ "title",++ "text",++ "at",++ "site",++ "site_name",++ "actor",++ "media",++ "counts"++ ],++ "properties": {++ "id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 500++ },++ "kind": {++ "enum": [++ "live",++ "stream",++ "clip",++ "video",++ "pic",++ "post",++ "meme",++ "game",++ "update",++ "wiki",++ "quest",++ "chat",++ "event",++ "member"++ ]++ },++ "url": {++ "type": "string",++ "pattern": "^https?://",++ "maxLength": 2000++ },++ "title": {++ "type": "string",++ "maxLength": 300++ },++ "text": {++ "type": "string",++ "maxLength": 280++ },++ "at": {++ "type": [++ "string",++ "null"++ ],++ "format": "date-time"++ },++ "site": {++ "type": "string",++ "maxLength": 40++ },++ "site_name": {++ "type": "string",++ "maxLength": 40++ },++ "actor": {++ "type": [++ "object",++ "null"++ ],++ "required": [++ "name",++ "avatar"++ ],++ "properties": {++ "name": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 80++ },++ "avatar": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 2000++ }++ },++ "additionalProperties": false++ },++ "media": {++ "type": [++ "object",++ "null"++ ],++ "required": [++ "thumb",++ "ratio"++ ],++ "properties": {++ "thumb": {++ "type": "string",++ "pattern": "^https://",++ "maxLength": 2000++ },++ "preview": {++ "type": [++ "string",++ "null"++ ],++ "pattern": "^https://",++ "maxLength": 2000++ },++ "ratio": {++ "type": "number",++ "exclusiveMinimum": 0++ },++ "length": {++ "type": "number",++ "minimum": 0++ }++ },++ "additionalProperties": false++ },++ "counts": {++ "type": "object",++ "properties": {++ "views": {++ "type": "integer",++ "minimum": 0++ },++ "likes": {++ "type": "integer",++ "minimum": 0++ },++ "comments": {++ "type": "integer",++ "minimum": 0++ }++ },++ "additionalProperties": false++ },++ "live_now": {++ "type": "boolean"++ },++ "label": {++ "enum": [++ "Trending",++ "AI",++ "System"++ ]++ }++ }++ }++ },++ "community.feed-answer": {++ "version": "1.0.0",++ "owner": "community",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/community/feed-answer.v1.json",++ "title": "CommunityFeedAnswer",++ "description": "community.feed-answer@1: the response from GET /api/v1/feed.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "items",++ "next_cursor"++ ],++ "properties": {++ "items": {++ "type": "array",++ "items": {++ "$ref": "feed-card.v1.json"++ }++ },++ "next_cursor": {++ "type": [++ "string",++ "null"++ ]++ }++ }++ }++ },"community.pulse-read-result": {"version": "1.0.0","owner": "community",@@@ -124594,6 +125220,3734 @@},"description": "NetworkLevelBoard: one earned platform level owned by Network; experience is never bought or spent."}++ },++ "composer.attachment": {++ "version": "1.0.0",++ "owner": "media",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/composer/attachment.v1.json",++ "title": "ComposerAttachment",++ "description": "composer.attachment@1: one file a person attached to a message in the shared composer. Media stores it and answers this shape from POST /api/v1/attachments (multipart field `file`); a client keeps it until the message is sent, then names it in POST /api/v1/attachments/:id/keep. `kind` is sniffed from the bytes, never taken from the browser: image, video, audio, file or code. `thumb` is a small preview for images and video (absent for the rest), `w`/`h` the pixel size when the file is one Media can measure. An attachment nobody keeps expires after 24 hours; `expires_at` says when, and a keep extends it to the message's life.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "kind",++ "name",++ "size",++ "mime",++ "url",++ "expires_at"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",++ "description": "The attachment id (att_ + ULID): what DELETE /api/v1/attachments/:id and POST /api/v1/attachments/:id/keep name."++ },++ "kind": {++ "enum": [++ "image",++ "video",++ "audio",++ "file",++ "code"++ ],++ "description": "Decided by Media from the bytes, not the client's claim: image/video/audio when the signature matches, code for recognised source text, otherwise file. Executables are refused at upload."++ },++ "name": {++ "type": "string",++ "minLength": 1,++ "maxLength": 255,++ "description": "The file's original name, sanitised for display; never a path."++ },++ "size": {++ "type": "integer",++ "minimum": 1,++ "description": "Bytes stored."++ },++ "mime": {++ "type": "string",++ "description": "The content type Media serves the bytes as, from the sniffed kind and format."++ },++ "url": {++ "type": "string",++ "format": "uri",++ "description": "Absolute https URL the bytes are served at. It stays valid while the attachment exists; a kept attachment is the message's to serve."++ },++ "thumb": {++ "type": [++ "string",++ "null"++ ],++ "format": "uri",++ "description": "Absolute URL of a preview image: an image's own small copy or a video's first frame. Null when Media could not make one (or the kind has none)."++ },++ "w": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 1,++ "description": "Pixel width of an image, video or video preview; null when unknown."++ },++ "h": {++ "type": [++ "integer",++ "null"++ ],++ "minimum": 1,++ "description": "Pixel height of an image, video or video preview; null when unknown."++ },++ "expires_at": {++ "type": "string",++ "format": "date-time",++ "description": "When an unkept attachment is deleted. The upload answers now + 24 hours; a keep moves it to the kept window."++ }++ }++ }++ },++ "composer.prefs": {++ "version": "1.0.0",++ "owner": "network",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/composer/prefs.v1.json",++ "title": "ComposerPrefs",++ "description": "composer.prefs@1: a person's composer settings, the same on every OpenVibe site because Network stores them (GET/PUT /api/v1/me/composer). `rev` is the stored revision: send the one you read back with your change, and a tab that read an older copy gets 409 with the current document instead of overwriting the other tab. `send_key` says whether Enter or Ctrl/Cmd+Enter sends. `tools` is the one order of the composer's tools and which are hidden; a tool id the client does not know is kept, so a site can add one without another site dropping the person's order. `snippets` are the person's saved inserts, triggered by typing a slash word.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "rev",++ "send_key",++ "tools",++ "density",++ "voice",++ "snippets"++ ],++ "properties": {++ "rev": {++ "type": "integer",++ "minimum": 0,++ "description": "Revision of the stored document. A missing document is rev 0 with the defaults; every successful PUT answers rev + 1."++ },++ "send_key": {++ "enum": [++ "enter",++ "mod-enter"++ ],++ "description": "enter: Enter sends and Shift+Enter breaks the line. mod-enter: Ctrl/Cmd+Enter sends and Enter breaks the line (the default on a phone keyboard is enter)."++ },++ "tools": {++ "type": "array",++ "maxItems": 100,++ "description": "Every tool in the order the person wants them, each marked hidden or not.",++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "hidden"++ ],++ "properties": {++ "id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 40,++ "pattern": "^[a-z0-9][a-z0-9._-]*$"++ },++ "hidden": {++ "type": "boolean"++ }++ }++ }++ },++ "density": {++ "enum": [++ "comfy",++ "compact"++ ],++ "description": "How much room the composer takes: comfy is the default on a computer, compact on a phone."++ },++ "voice": {++ "type": "boolean",++ "description": "Whether the composer offers dictation (where the device has it)."++ },++ "snippets": {++ "type": "array",++ "maxItems": 50,++ "description": "Saved inserts. Typing the trigger (a slash word such as /sig) in the composer offers the snippet.",++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "trigger",++ "label",++ "text"++ ],++ "properties": {++ "trigger": {++ "type": "string",++ "pattern": "^/[a-z0-9][a-z0-9_-]{0,31}$",++ "description": "The slash word that offers the snippet, e.g. /sig. Lower-case letters, digits, _ and - only."++ },++ "label": {++ "type": "string",++ "minLength": 1,++ "maxLength": 80,++ "description": "What the menu shows."++ },++ "text": {++ "type": "string",++ "minLength": 1,++ "maxLength": 4000,++ "description": "What is inserted."++ }++ }++ }++ }++ }++ }++ },++ "composer.mention": {++ "version": "1.0.0",++ "owner": "network",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/composer/mention.v1.json",++ "title": "ComposerMention",++ "description": "composer.mention@1: one thing the composer's @ menu can insert, from GET /api/v1/mentions on OpenVibe.Network. kind person (a person the caller follows first, then a public person), repo (a repository on OpenVibe Git the caller can see), site (a first-party OpenVibe site) or file (a file of the message's own context). `id` is the stable id inside its kind, `label` what the menu shows, `handle` the @name when the kind has one, `avatar` the picture, and `url` where choosing it links.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "kind",++ "id",++ "label",++ "url"++ ],++ "properties": {++ "kind": {++ "enum": [++ "person",++ "repo",++ "site",++ "file"++ ],++ "description": "What is mentioned. The same person is a person; a repository on OpenVibe Git is a repo; a first-party OpenVibe site is a site; a file of the message's context (an attachment or a repository file) is a file."++ },++ "id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200,++ "description": "The stable id inside the kind: a usr_… subject for a person, owner/name for a repo, a site id for a site, a path or attachment id for a file."++ },++ "label": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200,++ "description": "What the menu shows (a display name, owner/name, the site's name, a file name)."++ },++ "handle": {++ "type": "string",++ "maxLength": 64,++ "pattern": "^[A-Za-z0-9_.-]+$",++ "description": "The @name when the kind has one: a person's username, a site's short name. Absent for a repo or a file."++ },++ "avatar": {++ "type": [++ "string",++ "null"++ ],++ "format": "uri",++ "description": "Absolute URL of the picture to show beside the label. Null when the kind has none (a file, a site without a mark)."++ },++ "url": {++ "type": "string",++ "format": "uri",++ "description": "Absolute https URL where choosing the mention leads: the person's profile, the repository, the site's home or the file."++ }++ }++ }++ },++ "network.user-card": {++ "version": "1.0.0",++ "owner": "network",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/network/user-card.v1.json",++ "title": "NetworkUserCard",++ "description": "network.user-card@1 (ask 287): the one public user card read, GET /api/v1/people/:username/card on OpenVibe.Network. It is public and credential-free; a signed-in viewer may send their Network token (Authorization: Bearer …) and then also receives `actions` computed for that viewer, never cached. Without a viewer, or on the viewer's own card, `actions` carries Profile and Channel only. A missing, expired or revoked token reads as anonymous, never a 401. Hidden fields are absent, never zero, offline or a placeholder; no presence, page titles or visited URLs leave the read.",++ "type": "object",++ "required": [++ "username",++ "profile_url",++ "actions"++ ],++ "additionalProperties": false,++ "properties": {++ "username": {++ "type": "string",++ "pattern": "^[A-Za-z0-9_]{3,24}$"++ },++ "display_name": {++ "type": "string",++ "minLength": 1,++ "maxLength": 200++ },++ "avatar_url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://"++ },++ "profile_url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://"++ },++ "level": {++ "type": "integer",++ "minimum": 0++ },++ "streak": {++ "type": "integer",++ "minimum": 0++ },++ "badges_count": {++ "type": "integer",++ "minimum": 0++ },++ "followers": {++ "type": "integer",++ "minimum": 0++ },++ "live": {++ "type": "object",++ "required": [++ "now"++ ],++ "additionalProperties": false,++ "properties": {++ "now": {++ "type": "boolean"++ },++ "site": {++ "const": "live"++ },++ "url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://"++ }++ }++ },++ "channel_url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://"++ },++ "active_sites": {++ "type": "array",++ "items": {++ "type": "object",++ "required": [++ "id",++ "name",++ "url"++ ],++ "additionalProperties": false,++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^[a-z][a-z0-9-]{1,39}$"++ },++ "name": {++ "type": "string",++ "minLength": 1,++ "maxLength": 80++ },++ "url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://"++ }++ }++ }++ },++ "actions": {++ "type": "array",++ "description": "What the viewer can do, by what is possible for the pair. Order is the card's order. Each action either opens somewhere (`href`) or calls a Network route with the viewer's token (`method` + `path`, and `body` where the route needs one).",++ "items": {++ "$ref": "#/$defs/action"++ }++ }++ },++ "$defs": {++ "action": {++ "oneOf": [++ {++ "type": "object",++ "required": [++ "id",++ "label",++ "href"++ ],++ "additionalProperties": false,++ "properties": {++ "id": {++ "$ref": "#/$defs/id"++ },++ "label": {++ "$ref": "#/$defs/label"++ },++ "href": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://"++ },++ "state": {++ "$ref": "#/$defs/state"++ }++ }++ },++ {++ "type": "object",++ "required": [++ "id",++ "label",++ "method",++ "path"++ ],++ "additionalProperties": false,++ "properties": {++ "id": {++ "$ref": "#/$defs/id"++ },++ "label": {++ "$ref": "#/$defs/label"++ },++ "method": {++ "enum": [++ "PUT",++ "POST",++ "DELETE",++ "PATCH"++ ]++ },++ "path": {++ "type": "string",++ "pattern": "^/api/v1/"++ },++ "body": {++ "type": "object"++ },++ "state": {++ "$ref": "#/$defs/state"++ }++ }++ }++ ]++ },++ "id": {++ "type": "string",++ "pattern": "^[a-z][a-z0-9-]{1,39}$"++ },++ "label": {++ "type": "string",++ "minLength": 1,++ "maxLength": 40++ },++ "state": {++ "type": "object",++ "additionalProperties": false,++ "properties": {++ "following": {++ "type": "boolean"++ },++ "friendship": {++ "enum": [++ "none",++ "pending",++ "requested",++ "friends"++ ]++ },++ "muted": {++ "type": "boolean"++ },++ "blocked": {++ "type": "boolean"++ },++ "reported": {++ "type": "boolean"++ }++ }++ }++ }++ }++ },++ "network.user-report": {++ "version": "1.0.0",++ "owner": "network",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/network/user-report.v1.json",++ "title": "NetworkUserReport",++ "description": "network.user-report@1 (ask 287): one report a person filed about another person on OpenVibe.Network. Reports never resolve themselves; staff holding staff.moderation.logs read the queue (GET /api/v1/staff/user-reports?status=open&target=usr_…&limit=), and a staff decision lives in the moderation audit log. `status` records whether staff have looked, not a verdict.",++ "type": "object",++ "required": [++ "id",++ "reporter",++ "target",++ "reason",++ "detail",++ "status",++ "created_at",++ "updated_at"++ ],++ "additionalProperties": false,++ "properties": {++ "id": {++ "type": "integer",++ "minimum": 1++ },++ "reporter": {++ "type": "string",++ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ "target": {++ "type": "string",++ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ "reason": {++ "enum": [++ "spam",++ "harassment",++ "impersonation",++ "explicit",++ "scam",++ "other"++ ]++ },++ "detail": {++ "type": "string",++ "maxLength": 2000++ },++ "status": {++ "enum": [++ "open",++ "reviewed",++ "dismissed"++ ]++ },++ "created_at": {++ "type": "string",++ "format": "date-time"++ },++ "updated_at": {++ "type": "string",++ "format": "date-time"++ }++ }++ }++ },++ "network.user-report-list-result": {++ "version": "1.0.0",++ "owner": "network",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/network/user-report-list-result.v1.json",++ "title": "NetworkUserReportListResult",++ "description": "network.user-report-list-result@1 (ask 287): GET /api/v1/staff/user-reports on OpenVibe.Network, the staff queue for people holding staff.moderation.logs. Newest first, filtered by status (default open) and target subject, at most 200 rows (`limit`, default 50). A caller without the capability gets 403 user_reports.forbidden (problem+json).",++ "type": "object",++ "required": [++ "reports"++ ],++ "additionalProperties": false,++ "properties": {++ "reports": {++ "type": "array",++ "maxItems": 200,++ "items": {++ "$ref": "user-report.v1.json"++ }++ }++ }++ }++ },++ "network.user-report-request": {++ "version": "1.0.0",++ "owner": "network",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/network/user-report-request.v1.json",++ "title": "NetworkUserReportRequest",++ "description": "network.user-report-request@1 (ask 287): POST /api/v1/me/reports on OpenVibe.Network, a signed-in person's report about another person. `target` is their username (any case) or usr_ subject; guests cannot be named, and nobody reports themselves. The same pair may have one open report: filing again while it is open answers the open one with 200 instead of creating a duplicate (201 when it creates one).",++ "type": "object",++ "required": [++ "target",++ "reason"++ ],++ "additionalProperties": false,++ "properties": {++ "target": {++ "type": "string",++ "pattern": "^([A-Za-z0-9_]{3,24}|usr_[0-9A-HJKMNP-TV-Z]{26})$"++ },++ "reason": {++ "enum": [++ "spam",++ "harassment",++ "impersonation",++ "explicit",++ "scam",++ "other"++ ]++ },++ "detail": {++ "type": "string",++ "maxLength": 2000++ }++ }++ }++ },++ "agent.ui-event": {++ "version": "1.0.0",++ "owner": "actor",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/agent/ui-event.v1.json",++ "title": "AgentUiEvent",++ "description": "agent.ui-event@1: AG-UI 1.0 event shape and event-family fields, with OpenVibe metadata.ov. AG-UI timestamps are Unix-millisecond integers; this contract requires one on every event. CUSTOM events use AG-UI name/value with ov.sources, ov.handoff, ov.approval or ov.result names.",++ "allOf": [++ {++ "$ref": "#/definitions/Event"++ },++ {++ "type": "object",++ "required": [++ "timestamp"++ ]++ }++ ],++ "definitions": {++ "EventType": {++ "type": "string",++ "description": "The discriminator carried by every event.",++ "enum": [++ "TEXT_MESSAGE_START",++ "TEXT_MESSAGE_CONTENT",++ "TEXT_MESSAGE_END",++ "TEXT_MESSAGE_CHUNK",++ "TOOL_CALL_START",++ "TOOL_CALL_ARGS",++ "TOOL_CALL_END",++ "TOOL_CALL_CHUNK",++ "TOOL_CALL_RESULT",++ "STATE_SNAPSHOT",++ "STATE_DELTA",++ "MESSAGES_SNAPSHOT",++ "ACTIVITY_SNAPSHOT",++ "ACTIVITY_DELTA",++ "RAW",++ "CUSTOM",++ "RUN_STARTED",++ "RUN_FINISHED",++ "RUN_ERROR",++ "STEP_STARTED",++ "STEP_FINISHED",++ "REASONING_START",++ "REASONING_MESSAGE_START",++ "REASONING_MESSAGE_CONTENT",++ "REASONING_MESSAGE_END",++ "REASONING_MESSAGE_CHUNK",++ "REASONING_END",++ "REASONING_ENCRYPTED_VALUE",++ "SUBAGENT_STARTED",++ "SUBAGENT_FINISHED",++ "SUBAGENT_ERROR"++ ]++ },++ "BaseEvent": {++ "type": "object",++ "description": "The fields every event carries, whatever its type. Composed into each event definition rather than repeated, so a change here reaches every event at once.",++ "properties": {++ "type": {++ "$ref": "#/definitions/EventType",++ "description": "Which event this is. Each event definition narrows this to a single value."++ },++ "timestamp": {++ "type": "integer",++ "minimum": -9007199254740991,++ "maximum": 9007199254740991,++ "description": "When the event was created. Bounded to the range JSON numbers survive a round trip in, so the value a consumer reads is the value the producer wrote. Deliberately not a float. The unit is not constrained here, because it never has been stated normatively; every SDK that sets it in practice uses milliseconds since the Unix epoch, and a producer choosing another unit will be misread by consumers even though it validates. Nothing in the protocol computes with this value."++ },++ "rawEvent": {++ "not": {++ "type": "null"++ },++ "description": "The provider-native event this one was translated from, carried verbatim for debugging and for consumers that need detail the protocol does not model. Any JSON value."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this event."++ }++ },++ "required": [++ "type"++ ]++ },++ "Attributable": {++ "type": "object",++ "description": "Composed into everything that can belong to a subagent's work: the events that describe content or progress, the message types, and each interrupt. Run-scoped events omit it — RUN_STARTED, RUN_FINISHED and RUN_ERROR describe the run itself and MESSAGES_SNAPSHOT is conversation-wide, so none of them can belong to one subagent. A tool call omits it too and inherits its containing message's attribution.",++ "properties": {++ "subagentRunId": {++ "$ref": "#/definitions/SubagentRunId",++ "description": "The subagent invocation this belongs to. Absent means the parent agent produced it directly."++ }++ }++ },++ "SubagentRunId": {++ "type": "string",++ "description": "An opaque handle for one subagent invocation, not a reusable name for a subagent definition: two invocations of the same subagent carry two different values. Named to mirror runId one level down, the way the subagent's name mirrors agentId."++ },++ "Metadata": {++ "type": "object",++ "description": "Extra information attached to an event, a message, a tool call, a tool, an interrupt or a resume entry. Open by key: any JSON value is allowed under a key, including null, because a null there is meaningful data. The object itself may be absent but is never null when present. The key ag-ui is reserved for the protocol's own use; reservation is by convention, since validating the shape of a key's value would contradict being open by key.",++ "additionalProperties": true,++ "properties": {++ "ov": {++ "type": "object",++ "additionalProperties": false,++ "properties": {++ "title": {++ "type": "string",++ "maxLength": 240++ },++ "kind": {++ "enum": [++ "search",++ "fetch",++ "read",++ "edit",++ "run",++ "browse",++ "ask",++ "think",++ "note",++ "agent",++ "plan"++ ]++ },++ "sources": {++ "type": "array",++ "items": {++ "$ref": "#/definitions/OvSource"++ }++ },++ "attachments": {++ "type": "array",++ "items": {++ "type": "object",++ "additionalProperties": true++ }++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ },++ "needs_you": {++ "type": [++ "object",++ "null"++ ],++ "additionalProperties": false,++ "required": [++ "id",++ "question",++ "actions"++ ],++ "properties": {++ "id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 160++ },++ "question": {++ "type": "string",++ "minLength": 1,++ "maxLength": 1000++ },++ "actions": {++ "type": "array",++ "items": {},++ "minItems": 1++ }++ }++ },++ "product": {++ "type": "string",++ "maxLength": 40++ },++ "ref": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 160++ }++ }++ }++ }++ },++ "State": {++ "description": "Agent state. Any JSON value: the protocol carries state without interpreting it, so an object, an array, a string and a number are all valid."++ },++ "TextMessageRole": {++ "type": "string",++ "description": "The roles a streamed text message may take. Excludes tool, which is carried by TOOL_CALL_RESULT rather than streamed as text.",++ "enum": [++ "developer",++ "system",++ "assistant",++ "user"++ ]++ },++ "TextMessageStartEvent": {++ "type": "object",++ "description": "Opens a streamed text message. The content arrives as TEXT_MESSAGE_CONTENT events and the message closes with TEXT_MESSAGE_END.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TEXT_MESSAGE_START"++ },++ "messageId": {++ "type": "string",++ "description": "Identifies the message this stream builds, and ties the later content and end events to it."++ },++ "role": {++ "$ref": "#/definitions/TextMessageRole",++ "default": "assistant",++ "description": "Who the message is from. An absent role means assistant; that meaning is normative and stated in the prose, because a validator treats a default as documentation rather than as behaviour."++ },++ "name": {++ "type": "string",++ "description": "An optional display name for the author, for providers that distinguish several participants in one role."++ }++ },++ "required": [++ "type",++ "messageId"++ ],++ "unevaluatedProperties": false++ },++ "TextMessageContentEvent": {++ "type": "object",++ "description": "Appends a fragment to a streamed text message.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TEXT_MESSAGE_CONTENT"++ },++ "messageId": {++ "type": "string",++ "description": "The message this fragment belongs to."++ },++ "delta": {++ "type": "string",++ "description": "The fragment to append. May be the empty string: providers emit empty deltas as keep-alives and while a tool call is being decided, and rejecting them would kill runs that are working correctly."++ }++ },++ "required": [++ "type",++ "messageId",++ "delta"++ ],++ "unevaluatedProperties": false++ },++ "TextMessageEndEvent": {++ "type": "object",++ "description": "Closes a streamed text message.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TEXT_MESSAGE_END"++ },++ "messageId": {++ "type": "string",++ "description": "The message being closed."++ }++ },++ "required": [++ "type",++ "messageId"++ ],++ "unevaluatedProperties": false++ },++ "TextMessageChunkEvent": {++ "type": "object",++ "description": "A shorthand that stands in for a start, content and end sequence, for producers that cannot know in advance where a message begins. Every field is optional because a continuation chunk omits what has not changed; which message a field-less chunk continues is a sequence question the prose specification answers.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TEXT_MESSAGE_CHUNK"++ },++ "messageId": {++ "type": "string",++ "description": "The message this chunk belongs to. Absent continues the message already open."++ },++ "role": {++ "$ref": "#/definitions/TextMessageRole",++ "description": "Who the message is from, on the chunk that opens it."++ },++ "delta": {++ "type": "string",++ "description": "The fragment to append. May be the empty string."++ },++ "name": {++ "type": "string",++ "description": "An optional display name for the author."++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "ToolCallStartEvent": {++ "type": "object",++ "description": "Opens a tool call. The arguments arrive as TOOL_CALL_ARGS events and the call closes with TOOL_CALL_END.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TOOL_CALL_START"++ },++ "toolCallId": {++ "type": "string",++ "description": "Identifies the call, and ties the later args, end and result events to it."++ },++ "toolCallName": {++ "type": "string",++ "description": "Which tool is being called."++ },++ "parentMessageId": {++ "type": "string",++ "description": "The assistant message that holds this call. Absent means the producer did not attribute it to one."++ }++ },++ "required": [++ "type",++ "toolCallId",++ "toolCallName"++ ],++ "unevaluatedProperties": false++ },++ "ToolCallArgsEvent": {++ "type": "object",++ "description": "Appends a fragment of a tool call's arguments.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TOOL_CALL_ARGS"++ },++ "toolCallId": {++ "type": "string",++ "description": "The call these arguments belong to."++ },++ "delta": {++ "type": "string",++ "description": "A fragment of the arguments, which concatenate into the call's argument text — conventionally a JSON document, though the protocol does not validate it (see FunctionCall.arguments). Deliberately a string rather than parsed JSON: a fragment is not itself a document. May be the empty string."++ }++ },++ "required": [++ "type",++ "toolCallId",++ "delta"++ ],++ "unevaluatedProperties": false++ },++ "ToolCallEndEvent": {++ "type": "object",++ "description": "Closes a tool call, meaning its arguments are complete.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TOOL_CALL_END"++ },++ "toolCallId": {++ "type": "string",++ "description": "The call being closed."++ }++ },++ "required": [++ "type",++ "toolCallId"++ ],++ "unevaluatedProperties": false++ },++ "ToolCallChunkEvent": {++ "type": "object",++ "description": "A shorthand that stands in for a tool call's start, args and end sequence. Every field is optional for the same reason as TEXT_MESSAGE_CHUNK.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TOOL_CALL_CHUNK"++ },++ "toolCallId": {++ "type": "string",++ "description": "The call this chunk belongs to. Absent continues the call already open."++ },++ "toolCallName": {++ "type": "string",++ "description": "Which tool is being called, on the chunk that opens it."++ },++ "parentMessageId": {++ "type": "string",++ "description": "The assistant message that holds this call."++ },++ "delta": {++ "type": "string",++ "description": "A fragment of the arguments. May be the empty string."++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "ToolCallResultEvent": {++ "type": "object",++ "description": "Carries what a tool returned. Mints a tool message rather than appending to an existing one, which is why it has its own messageId.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "TOOL_CALL_RESULT"++ },++ "messageId": {++ "type": "string",++ "description": "The tool message this result becomes."++ },++ "toolCallId": {++ "type": "string",++ "description": "The call being answered."++ },++ "content": {++ "description": "What the tool returned: either plain text, or an ordered list of parts, exactly as on the tool message this event mints. A tool returning structured data serialises it into text; media travel as parts of their own.",++ "oneOf": [++ {++ "type": "string"++ },++ {++ "type": "array",++ "items": {++ "$ref": "#/definitions/ContentPart"++ }++ }++ ]++ },++ "role": {++ "const": "tool",++ "description": "Present only for symmetry with the message it mints; the value is fixed, so a producer may leave it out."++ }++ },++ "required": [++ "type",++ "messageId",++ "toolCallId",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "StateSnapshotEvent": {++ "type": "object",++ "description": "Replaces the agent state wholesale. Sent when a delta cannot express the change, or to resynchronise a consumer.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "STATE_SNAPSHOT"++ },++ "snapshot": {++ "$ref": "#/definitions/State",++ "description": "The complete new state."++ }++ },++ "required": [++ "type",++ "snapshot"++ ],++ "unevaluatedProperties": false++ },++ "StateDeltaEvent": {++ "type": "object",++ "description": "Changes the agent state incrementally.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "STATE_DELTA"++ },++ "delta": {++ "$ref": "#/definitions/JsonPatch",++ "description": "The change, as an RFC 6902 patch against the current state. Structural validity here does not mean the patch applies: a well-formed operation may point at a path that does not exist, which RFC 6902 leaves to the applier."++ }++ },++ "required": [++ "type",++ "delta"++ ],++ "unevaluatedProperties": false++ },++ "MessagesSnapshotEvent": {++ "type": "object",++ "description": "The complete set of messages the producer owns, in order. Conversation-wide rather than a plain overwrite: a consumer may keep messages of its own that no producer tracks, so exactly how a snapshot reconciles with those is behavioural and belongs in the prose. Being conversation-wide it cannot belong to a single subagent, so it carries no attribution; it does establish which subagent owns each message it contains, through the messages themselves.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "MESSAGES_SNAPSHOT"++ },++ "messages": {++ "type": "array",++ "description": "The messages the producer is declaring, in order.",++ "items": {++ "$ref": "#/definitions/Message"++ }++ }++ },++ "required": [++ "type",++ "messages"++ ],++ "unevaluatedProperties": false++ },++ "ActivitySnapshotEvent": {++ "type": "object",++ "description": "Reports structured progress that is not conversation content, such as a step a UI renders as its own widget.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "ACTIVITY_SNAPSHOT"++ },++ "messageId": {++ "type": "string",++ "description": "The activity message this describes."++ },++ "activityType": {++ "type": "string",++ "description": "What kind of activity this is. An open string: the set is the producer's, not the protocol's."++ },++ "content": {++ "type": "object",++ "description": "The activity's payload, open by key.",++ "additionalProperties": true++ },++ "replace": {++ "type": "boolean",++ "default": true,++ "description": "Whether this snapshot overwrites the activity's existing content. Absent means it does, and that meaning is normative; only an explicit false asks a consumer to leave what is already there. It does not ask for a merge — ACTIVITY_DELTA is how content is changed incrementally. What a consumer does with a non-overwriting snapshot is behavioural and belongs in the prose."++ }++ },++ "required": [++ "type",++ "messageId",++ "activityType",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "ActivityDeltaEvent": {++ "type": "object",++ "description": "Changes an activity message's content incrementally.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "ACTIVITY_DELTA"++ },++ "messageId": {++ "type": "string",++ "description": "The activity message being changed."++ },++ "activityType": {++ "type": "string",++ "description": "What kind of activity this is."++ },++ "patch": {++ "$ref": "#/definitions/JsonPatch",++ "description": "The change, as an RFC 6902 patch against the activity's content."++ }++ },++ "required": [++ "type",++ "messageId",++ "activityType",++ "patch"++ ],++ "unevaluatedProperties": false++ },++ "RawEvent": {++ "type": "object",++ "description": "Passes a provider-native event through untranslated, for consumers that need detail the protocol does not model.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "RAW"++ },++ "event": {++ "description": "The provider's own event. Any JSON value, and required: an event whose only purpose is to carry this would say nothing without it."++ },++ "source": {++ "type": "string",++ "description": "Which provider or framework the event came from."++ }++ },++ "required": [++ "type",++ "event"++ ],++ "unevaluatedProperties": false++ },++ "CustomEvent": {++ "type": "object",++ "description": "The protocol's extension point for an application's own events. Anything a consumer does with one is outside the protocol.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "CUSTOM"++ },++ "name": {++ "type": "string",++ "description": "What this custom event is. Required: without it a consumer cannot route the value.",++ "enum": [++ "ov.sources",++ "ov.handoff",++ "ov.approval",++ "ov.result"++ ]++ },++ "value": {++ "description": "The payload. Any JSON value, and required."++ }++ },++ "required": [++ "type",++ "name",++ "value"++ ],++ "unevaluatedProperties": false++ },++ "RunStartedEvent": {++ "type": "object",++ "description": "Opens a run. Run-scoped, so it carries no subagent attribution.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "RUN_STARTED"++ },++ "threadId": {++ "type": "string",++ "description": "The conversation this run belongs to."++ },++ "runId": {++ "type": "string",++ "description": "Identifies this run."++ },++ "protocolVersion": {++ "type": "string",++ "description": "The protocol version this producer speaks, such as \"1.0\" — the producer's own version, not an echo of the input's, which is what makes the pair a negotiation: each side declares itself and the consumer sees a downgrade the moment it happens. Absent means a producer from before the protocol carried a version."++ },++ "parentRunId": {++ "type": "string",++ "description": "The run that spawned this one, when an agent invokes another agent as a separate run rather than as a subagent within one."++ },++ "input": {++ "$ref": "#/definitions/RunAgentInput",++ "description": "The request this run was started from, echoed back so a consumer that did not make the request can still see what the agent was asked."++ }++ },++ "required": [++ "type",++ "threadId",++ "runId"++ ],++ "unevaluatedProperties": false++ },++ "RunFinishedEvent": {++ "type": "object",++ "description": "Closes a run that did not fail. Run-scoped, so it carries no subagent attribution.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "RUN_FINISHED"++ },++ "threadId": {++ "type": "string",++ "description": "The conversation this run belongs to."++ },++ "runId": {++ "type": "string",++ "description": "The run being closed."++ },++ "result": {++ "not": {++ "type": "null"++ },++ "description": "The run's return value, if it has one. Any JSON value."++ },++ "outcome": {++ "$ref": "#/definitions/RunFinishedOutcome",++ "description": "Why the run ended. Absent means success, so every producer written before outcomes existed is already conformant."++ },++ "usage": {++ "type": "array",++ "description": "Token usage for the run, one entry per provider and model, so a run that invoked several models keeps them separate. A consumer that only wants totals sums across the entries. The run is the accounting boundary: usage covers every model call made within the run, calls made by its subagents included; an agent invoked as a separate run under parentRunId reports its own usage on its own terminal event; and a run that resumes an interrupted one reports only the calls it made itself, not the interrupted run's.",++ "items": {++ "$ref": "#/definitions/TokenUsage"++ }++ }++ },++ "required": [++ "type",++ "threadId",++ "runId"++ ],++ "unevaluatedProperties": false++ },++ "RunErrorEvent": {++ "type": "object",++ "description": "Ends a run that failed. Run-scoped, so it carries no subagent attribution; a subagent that fails without ending the run reports SUBAGENT_ERROR instead.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "RUN_ERROR"++ },++ "message": {++ "type": "string",++ "description": "What went wrong, for a person to read."++ },++ "code": {++ "type": "string",++ "description": "A machine-readable error code. An open string: the protocol defines no vocabulary."++ },++ "usage": {++ "type": "array",++ "description": "Token usage accrued before the failure, for a run that completed one or more model calls before dying. Scoped as on RUN_FINISHED: the run's own calls, subagents included.",++ "items": {++ "$ref": "#/definitions/TokenUsage"++ }++ }++ },++ "required": [++ "type",++ "message"++ ],++ "unevaluatedProperties": false++ },++ "StepStartedEvent": {++ "type": "object",++ "description": "Opens a named step within a run, for producers whose frameworks have a step concept worth surfacing.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "STEP_STARTED"++ },++ "stepName": {++ "type": "string",++ "description": "The step's name. Identifies it: the matching STEP_FINISHED carries the same name."++ }++ },++ "required": [++ "type",++ "stepName"++ ],++ "unevaluatedProperties": false++ },++ "StepFinishedEvent": {++ "type": "object",++ "description": "Closes a named step.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "STEP_FINISHED"++ },++ "stepName": {++ "type": "string",++ "description": "The step being closed."++ }++ },++ "required": [++ "type",++ "stepName"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningStartEvent": {++ "type": "object",++ "description": "Opens a span of reasoning. A span may contain several reasoning messages.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_START"++ },++ "messageId": {++ "type": "string",++ "description": "The span being opened."++ }++ },++ "required": [++ "type",++ "messageId"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningMessageStartEvent": {++ "type": "object",++ "description": "Opens a streamed reasoning message.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_MESSAGE_START"++ },++ "messageId": {++ "type": "string",++ "description": "The reasoning message this stream builds."++ },++ "role": {++ "const": "reasoning",++ "description": "Fixed, and required rather than defaulted. The requirement is inherited from the SDKs rather than chosen."++ }++ },++ "required": [++ "type",++ "messageId",++ "role"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningMessageContentEvent": {++ "type": "object",++ "description": "Appends a fragment to a streamed reasoning message.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_MESSAGE_CONTENT"++ },++ "messageId": {++ "type": "string",++ "description": "The reasoning message this fragment belongs to."++ },++ "delta": {++ "type": "string",++ "description": "The fragment to append. May be the empty string."++ }++ },++ "required": [++ "type",++ "messageId",++ "delta"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningMessageEndEvent": {++ "type": "object",++ "description": "Closes a streamed reasoning message.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_MESSAGE_END"++ },++ "messageId": {++ "type": "string",++ "description": "The reasoning message being closed."++ }++ },++ "required": [++ "type",++ "messageId"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningMessageChunkEvent": {++ "type": "object",++ "description": "A shorthand that stands in for a reasoning message's start, content and end sequence.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_MESSAGE_CHUNK"++ },++ "messageId": {++ "type": "string",++ "description": "The reasoning message this chunk belongs to. Absent continues the one already open."++ },++ "delta": {++ "type": "string",++ "description": "The fragment to append. May be the empty string."++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningEndEvent": {++ "type": "object",++ "description": "Closes a span of reasoning.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_END"++ },++ "messageId": {++ "type": "string",++ "description": "The span being closed."++ }++ },++ "required": [++ "type",++ "messageId"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningEncryptedValueEvent": {++ "type": "object",++ "description": "Carries a provider's opaque, encrypted reasoning artefact, which a consumer stores and returns on a later turn without being able to read it.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ },++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "type": {++ "const": "REASONING_ENCRYPTED_VALUE"++ },++ "subtype": {++ "$ref": "#/definitions/ReasoningEncryptedValueSubtype",++ "description": "What kind of thing entityId names, which decides where the value is stored."++ },++ "entityId": {++ "type": "string",++ "description": "What the value belongs to: a message id or a tool call id, according to subtype."++ },++ "encryptedValue": {++ "type": "string",++ "description": "The provider's opaque artefact."++ }++ },++ "required": [++ "type",++ "subtype",++ "entityId",++ "encryptedValue"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningEncryptedValueSubtype": {++ "type": "string",++ "description": "Whether a REASONING_ENCRYPTED_VALUE belongs to a message or to a tool call.",++ "enum": [++ "tool-call",++ "message"++ ]++ },++ "SubagentStartedEvent": {++ "type": "object",++ "description": "Announces that a subagent invocation has begun. Everything the subagent produces afterwards is attributed by carrying its subagentRunId, so a consumer can group the work without replaying the stream. Composed from BaseEvent alone rather than Attributable, because here subagentRunId identifies the subagent rather than attributing the event to one; attribution to an enclosing subagent is parentSubagentRunId.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "SUBAGENT_STARTED"++ },++ "subagentRunId": {++ "$ref": "#/definitions/SubagentRunId",++ "description": "The invocation being announced."++ },++ "name": {++ "type": "string",++ "description": "The subagent's name, which is reusable across invocations, unlike subagentRunId."++ },++ "description": {++ "type": "string",++ "description": "What this subagent is for, for a consumer to display."++ },++ "parentSubagentRunId": {++ "$ref": "#/definitions/SubagentRunId",++ "description": "The subagent invocation that spawned this one, for nested delegation. Absent means the parent agent spawned it directly."++ },++ "parentToolCallId": {++ "type": "string",++ "description": "The tool call that spawned this subagent, for the pattern where agents are exposed to a model as tools. Lets a consumer tie the subagent to the call without reading rawEvent."++ },++ "parentMessageId": {++ "type": "string",++ "description": "The message that held the spawning tool call."++ }++ },++ "required": [++ "type",++ "subagentRunId",++ "name"++ ],++ "unevaluatedProperties": false++ },++ "SubagentFinishedEvent": {++ "type": "object",++ "description": "Ends a subagent invocation's segment of this run, either because the work completed or because it is suspended awaiting outside input.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "SUBAGENT_FINISHED"++ },++ "subagentRunId": {++ "$ref": "#/definitions/SubagentRunId",++ "description": "The invocation being closed."++ },++ "result": {++ "not": {++ "type": "null"++ },++ "description": "The subagent's return value, if it has one. Any JSON value, mirroring RUN_FINISHED.result."++ },++ "outcome": {++ "$ref": "#/definitions/SubagentFinishedOutcome",++ "description": "Why the segment ended. Absent means success. A suspended subagent is neither a success nor a failure, which is why saying so needs its own value rather than being inferred from a later interrupt."++ }++ },++ "required": [++ "type",++ "subagentRunId"++ ],++ "unevaluatedProperties": false++ },++ "SubagentErrorEvent": {++ "type": "object",++ "description": "Reports that a subagent invocation failed. The run may continue: a parent agent is free to handle a failed subagent, which is why this is not RUN_ERROR.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseEvent"++ }++ ],++ "properties": {++ "type": {++ "const": "SUBAGENT_ERROR"++ },++ "subagentRunId": {++ "$ref": "#/definitions/SubagentRunId",++ "description": "The invocation that failed."++ },++ "message": {++ "type": "string",++ "description": "What went wrong, for a person to read."++ },++ "code": {++ "type": "string",++ "description": "A machine-readable error code. An open string."++ }++ },++ "required": [++ "type",++ "subagentRunId",++ "message"++ ],++ "unevaluatedProperties": false++ },++ "RunFinishedOutcome": {++ "description": "Why a run ended.",++ "oneOf": [++ {++ "$ref": "#/definitions/RunFinishedSuccessOutcome"++ },++ {++ "$ref": "#/definitions/RunFinishedInterruptOutcome"++ },++ {++ "$ref": "#/definitions/RunFinishedCancelledOutcome"++ }++ ]++ },++ "RunFinishedSuccessOutcome": {++ "type": "object",++ "description": "The run completed. Equivalent to an absent outcome. Closed like every other object, which is also what keeps it from carrying the suspended sibling's interrupts — a success with an interrupt still pending would be a contradiction, not an extension. A completed run may still have left frontend tool calls for the application to answer; pendingToolCallIds names them.",++ "properties": {++ "type": {++ "const": "success",++ "description": "Discriminator."++ },++ "pendingToolCallIds": {++ "type": "array",++ "description": "The tool calls this run started and left unanswered — no TOOL_CALL_RESULT in the run — for the application to answer in the next input's messages, in the order they were made. Absent or empty means the producer named none, and a consumer derives the list from the stream; otherwise it is the list, and it agrees with the stream. On the success outcome rather than the event because a run that stopped on a frontend tool call is a completed run: whether the application continues the thread is its own decision, so the producer reports what it knows and no more.",++ "items": {++ "type": "string",++ "description": "A tool call id, as carried by TOOL_CALL_START."++ }++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "RunFinishedInterruptOutcome": {++ "type": "object",++ "description": "The run is paused, waiting for something outside it. Resuming means starting a new run whose resume entries answer these interrupts.",++ "properties": {++ "type": {++ "const": "interrupt",++ "description": "Discriminator."++ },++ "interrupts": {++ "type": "array",++ "description": "What the run is waiting for. At least one: an interrupt outcome with nothing to answer would leave a consumer with nothing to do.",++ "minItems": 1,++ "items": {++ "$ref": "#/definitions/Interrupt"++ }++ }++ },++ "required": [++ "type",++ "interrupts"++ ],++ "unevaluatedProperties": false++ },++ "RunFinishedCancelledOutcome": {++ "type": "object",++ "description": "The run was stopped before it completed, by whoever was running it, and did not fail. Neither success nor interrupt: nothing was produced as a result, and nothing is waited for, so the next run on the thread is an ordinary new run rather than a resume. Closed like its siblings: a cancelled run has no interrupts to carry. Named in the schema before 1.0 because an outcome a consumer does not recognise is stripped and read as success — a cancellation added later would reach every 1.0 consumer as a completed run.",++ "properties": {++ "type": {++ "const": "cancelled",++ "description": "Discriminator."++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "SubagentFinishedOutcome": {++ "description": "Why a subagent's segment of a run ended. Mirrors RunFinishedOutcome one level down.",++ "oneOf": [++ {++ "$ref": "#/definitions/SubagentFinishedSuccessOutcome"++ },++ {++ "$ref": "#/definitions/SubagentFinishedSuspendedOutcome"++ }++ ]++ },++ "SubagentFinishedSuccessOutcome": {++ "type": "object",++ "description": "The subagent completed its work. Equivalent to an absent outcome.",++ "properties": {++ "type": {++ "const": "success",++ "description": "Discriminator."++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "SubagentFinishedSuspendedOutcome": {++ "type": "object",++ "description": "The subagent is paused awaiting outside input. Terminal for this stream, not for the subagent: a later run may continue the same invocation once the interrupts are answered.",++ "properties": {++ "type": {++ "const": "suspended",++ "description": "Discriminator."++ },++ "interruptIds": {++ "type": "array",++ "description": "The run-level interrupts this subagent raised itself. May be empty or absent: a subagent suspended because a descendant interrupted owns no interrupt of its own.",++ "items": {++ "type": "string",++ "description": "An Interrupt.id."++ }++ }++ },++ "required": [++ "type"++ ],++ "unevaluatedProperties": false++ },++ "Interrupt": {++ "type": "object",++ "description": "Something a run needs from outside before it can continue, such as an approval or a missing value.",++ "allOf": [++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "id": {++ "type": "string",++ "description": "Identifies the interrupt. A resume entry answers it by this id."++ },++ "reason": {++ "type": "string",++ "description": "Why the run stopped. An open string rather than an enumeration: the protocol does not attempt to classify every reason an agent might need input."++ },++ "message": {++ "type": "string",++ "description": "A human-readable prompt for whoever answers."++ },++ "toolCallId": {++ "type": "string",++ "description": "The tool call this interrupt concerns, when it is a tool approval."++ },++ "responseSchema": {++ "type": "object",++ "description": "A JSON Schema describing the answer this interrupt expects, so a consumer can build a form for it. Carried opaquely: the protocol does not constrain or validate it. Restricted to an object because TypeScript and Python both declare it that way; .NET holds it as any JSON, and the ticket that commissioned this schema lists it among the arbitrary-JSON fields. Following the two that constrain it keeps the schema from accepting documents the reference client rejects, at the cost of rejecting the boolean schemas JSON Schema also permits — a bare true for \"any answer\". Recorded as a known divergence rather than settled.",++ "additionalProperties": true++ },++ "expiresAt": {++ "type": "string",++ "description": "When the interrupt stops being answerable. Deliberately unconstrained rather than a date-time format, because producers already disagree about the representation and tightening it here would reject streams that work today. The documented convention is ISO 8601, and a consumer comparing this value will parse it as a date, so a value that is not one leaves the interrupt looking permanently unexpired."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this interrupt."++ }++ },++ "required": [++ "id",++ "reason"++ ],++ "unevaluatedProperties": false++ },++ "ResumeEntry": {++ "type": "object",++ "description": "An answer to one interrupt, sent on the run that continues from it.",++ "properties": {++ "interruptId": {++ "type": "string",++ "description": "The interrupt being answered."++ },++ "status": {++ "type": "string",++ "description": "Whether the interrupt was answered or abandoned.",++ "enum": [++ "resolved",++ "cancelled"++ ]++ },++ "payload": {++ "not": {++ "type": "null"++ },++ "description": "The answer the agent asked for and will act on. Any JSON value."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Envelope information about the response, such as signatures or routing keys, as opposed to payload, which is the answer itself."++ }++ },++ "required": [++ "interruptId",++ "status"++ ],++ "unevaluatedProperties": false++ },++ "TokenUsage": {++ "type": "object",++ "description": "Token counts for one provider and model, in the protocol's own accounting: every count is either a total or a named part of one, so entries from different providers add up without double-counting. inputTokens and outputTokens are the totals; reasoningTokens, cachedInputTokens and cacheWriteInputTokens are parts of them, never additions to them; totalTokens is the two totals summed. Every field is a label or a number — nothing content-bearing or identifying, no prompts, completions, messages, or thread, run and user identifiers.",++ "properties": {++ "provider": {++ "type": "string",++ "description": "Which provider served the request."++ },++ "model": {++ "type": "string",++ "description": "Which model served the request."++ },++ "inputTokens": {++ "type": "integer",++ "minimum": 0,++ "maximum": 9007199254740991,++ "description": "Every prompt token the call was charged for: tokens read from a provider cache, tokens written to one, and audio or other non-text input all count here. cachedInputTokens and cacheWriteInputTokens break this number down and are never added to it — a provider that reports its cache counts beside a smaller input count has them added in by the producer before the entry leaves. Bounded like timestamp and for the same reason: a count above the JSON safe-integer range does not survive a round trip, so a consumer would silently read a different number than the producer wrote."++ },++ "outputTokens": {++ "type": "integer",++ "minimum": 0,++ "maximum": 9007199254740991,++ "description": "Every generated token, reasoning included where the provider distinguishes it. reasoningTokens breaks this number down and is never added to it — a provider that reports reasoning tokens beside a smaller completion count has them added in by the producer."++ },++ "totalTokens": {++ "type": "integer",++ "minimum": 0,++ "maximum": 9007199254740991,++ "description": "inputTokens plus outputTokens, under the accounting above. A producer MAY compute it rather than copy a provider's total, and copies a provider's total only when that total counts the same way, so a consumer can read this field as the sum of the other two."++ },++ "reasoningTokens": {++ "type": "integer",++ "minimum": 0,++ "maximum": 9007199254740991,++ "description": "Output tokens spent on reasoning, where the provider distinguishes them. Part of outputTokens, not in addition to it."++ },++ "cachedInputTokens": {++ "type": "integer",++ "minimum": 0,++ "maximum": 9007199254740991,++ "description": "Input tokens read from a provider cache. Part of inputTokens, not in addition to it, and disjoint from cacheWriteInputTokens."++ },++ "cacheWriteInputTokens": {++ "type": "integer",++ "minimum": 0,++ "maximum": 9007199254740991,++ "description": "Input tokens written to a provider cache on this call, where the provider distinguishes them. Part of inputTokens, not in addition to it, and disjoint from cachedInputTokens. Its own field because providers price a cache write differently from a cache read, so a consumer computing cost cannot do without it."++ }++ },++ "unevaluatedProperties": false++ },++ "Message": {++ "description": "Any message in a conversation. Discriminated by role.",++ "oneOf": [++ {++ "$ref": "#/definitions/DeveloperMessage"++ },++ {++ "$ref": "#/definitions/SystemMessage"++ },++ {++ "$ref": "#/definitions/AssistantMessage"++ },++ {++ "$ref": "#/definitions/UserMessage"++ },++ {++ "$ref": "#/definitions/ToolMessage"++ },++ {++ "$ref": "#/definitions/ActivityMessage"++ },++ {++ "$ref": "#/definitions/ReasoningMessage"++ }++ ]++ },++ "BaseMessage": {++ "type": "object",++ "description": "The fields shared by the developer, system, assistant and user messages. Deliberately excludes content, because a user message's content may be an array while the others are strings, and composition here intersects rather than overrides: a base that constrained content to a string would make an array content invalid. The tool, activity and reasoning messages do not compose this, because they carry no name.",++ "allOf": [++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "id": {++ "type": "string",++ "description": "Identifies the message within the conversation."++ },++ "role": {++ "type": "string",++ "description": "Who the message is from. Each message definition narrows this to a single value."++ },++ "name": {++ "type": "string",++ "description": "An optional display name for the author."++ },++ "encryptedValue": {++ "type": "string",++ "description": "A provider's opaque artefact belonging to this message, stored by a consumer and returned on a later turn."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this message."++ }++ },++ "required": [++ "id",++ "role"++ ]++ },++ "DeveloperMessage": {++ "type": "object",++ "description": "Instructions from the application developer.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseMessage"++ }++ ],++ "properties": {++ "role": {++ "const": "developer"++ },++ "content": {++ "type": "string",++ "description": "The instructions. Required: a developer message with nothing in it says nothing."++ }++ },++ "required": [++ "id",++ "role",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "SystemMessage": {++ "type": "object",++ "description": "Instructions from the system.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseMessage"++ }++ ],++ "properties": {++ "role": {++ "const": "system"++ },++ "content": {++ "type": "string",++ "description": "The instructions. Required."++ }++ },++ "required": [++ "id",++ "role",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "AssistantMessage": {++ "type": "object",++ "description": "A message from the agent. Content is optional because a turn may consist only of tool calls.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseMessage"++ }++ ],++ "properties": {++ "role": {++ "const": "assistant"++ },++ "content": {++ "type": "string",++ "description": "What the agent said, if it said anything."++ },++ "toolCalls": {++ "type": "array",++ "description": "The tool calls this turn made.",++ "items": {++ "$ref": "#/definitions/ToolCall"++ }++ }++ },++ "required": [++ "id",++ "role"++ ],++ "unevaluatedProperties": false++ },++ "UserMessage": {++ "type": "object",++ "description": "A message from the person using the application.",++ "allOf": [++ {++ "$ref": "#/definitions/BaseMessage"++ }++ ],++ "properties": {++ "role": {++ "const": "user"++ },++ "content": {++ "description": "What the person sent: either plain text, or an ordered list of parts for a multimodal message.",++ "oneOf": [++ {++ "type": "string"++ },++ {++ "type": "array",++ "items": {++ "$ref": "#/definitions/ContentPart"++ }++ }++ ]++ }++ },++ "required": [++ "id",++ "role",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "ToolMessage": {++ "type": "object",++ "description": "What a tool returned, as a message in the conversation. Stands alone rather than composing BaseMessage, because it carries no name.",++ "allOf": [++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "id": {++ "type": "string",++ "description": "Identifies the message."++ },++ "role": {++ "const": "tool",++ "description": "Fixed. Declared here rather than inherited, because this message does not compose BaseMessage."++ },++ "content": {++ "description": "What the tool returned: either plain text, or an ordered list of parts. A tool returning structured data serialises it into text; media travel as parts of their own.",++ "oneOf": [++ {++ "type": "string"++ },++ {++ "type": "array",++ "items": {++ "$ref": "#/definitions/ContentPart"++ }++ }++ ]++ },++ "toolCallId": {++ "type": "string",++ "description": "The call this answers."++ },++ "error": {++ "type": "string",++ "description": "Why the tool failed, when it did. Present alongside content rather than instead of it, so a partial result survives a failure."++ },++ "encryptedValue": {++ "type": "string",++ "description": "A provider's opaque artefact belonging to this message."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this message."++ }++ },++ "required": [++ "id",++ "role",++ "content",++ "toolCallId"++ ],++ "unevaluatedProperties": false++ },++ "ActivityMessage": {++ "type": "object",++ "description": "Structured progress that is not conversation content, materialised as a message so it keeps its place in the sequence. Stands alone rather than composing BaseMessage, because its content is an object rather than a string.",++ "allOf": [++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "id": {++ "type": "string",++ "description": "Identifies the message."++ },++ "role": {++ "const": "activity",++ "description": "Fixed. Declared here rather than inherited, because this message does not compose BaseMessage."++ },++ "activityType": {++ "type": "string",++ "description": "What kind of activity this is. An open string: the set is the producer's."++ },++ "content": {++ "type": "object",++ "description": "The activity's payload, open by key.",++ "additionalProperties": true++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this message."++ }++ },++ "required": [++ "id",++ "role",++ "activityType",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "ReasoningMessage": {++ "type": "object",++ "description": "A span of the agent's reasoning, materialised as a message. Stands alone rather than composing BaseMessage, because it carries no name.",++ "allOf": [++ {++ "$ref": "#/definitions/Attributable"++ }++ ],++ "properties": {++ "id": {++ "type": "string",++ "description": "Identifies the message."++ },++ "role": {++ "const": "reasoning",++ "description": "Fixed. Declared here rather than inherited, because this message does not compose BaseMessage."++ },++ "content": {++ "type": "string",++ "description": "The reasoning text."++ },++ "encryptedValue": {++ "type": "string",++ "description": "A provider's opaque reasoning artefact belonging to this message."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this message."++ }++ },++ "required": [++ "id",++ "role",++ "content"++ ],++ "unevaluatedProperties": false++ },++ "ToolCall": {++ "type": "object",++ "description": "A call an assistant message made. Carries no subagent attribution of its own and inherits its containing message's, since several calls can share one parent.",++ "properties": {++ "id": {++ "type": "string",++ "description": "Identifies the call. The answering tool message carries this as its toolCallId."++ },++ "type": {++ "const": "function",++ "description": "The only kind of call the protocol models."++ },++ "function": {++ "$ref": "#/definitions/FunctionCall",++ "description": "What is being called, and with what."++ },++ "encryptedValue": {++ "type": "string",++ "description": "A provider's opaque artefact belonging to this call."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information attached to this call. Carried here rather than folded into the containing message, because several calls can share one parent and merging them would make the result depend on their order."++ }++ },++ "required": [++ "id",++ "type",++ "function"++ ],++ "unevaluatedProperties": false++ },++ "FunctionCall": {++ "type": "object",++ "description": "The name and arguments of a tool call.",++ "properties": {++ "name": {++ "type": "string",++ "description": "Which tool is being called."++ },++ "arguments": {++ "type": "string",++ "description": "The arguments as a JSON string, not as parsed JSON. Kept as written because a model can emit arguments that are not valid JSON, and losing them at the protocol boundary would hide the fault from the consumer that has to handle it."++ }++ },++ "required": [++ "name",++ "arguments"++ ],++ "unevaluatedProperties": false++ },++ "ContentPart": {++ "description": "One part of a message body: what a person sends in a user message, or what a tool returns in a tool message. Discriminated by type. Named by what the part is rather than by direction, because the same part travels into the model inside a user message and back out of the stream inside a tool result.",++ "oneOf": [++ {++ "$ref": "#/definitions/TextPart"++ },++ {++ "$ref": "#/definitions/ImagePart"++ },++ {++ "$ref": "#/definitions/AudioPart"++ },++ {++ "$ref": "#/definitions/VideoPart"++ },++ {++ "$ref": "#/definitions/DocumentPart"++ }++ ]++ },++ "TextPart": {++ "type": "object",++ "description": "A text part.",++ "properties": {++ "type": {++ "const": "text",++ "description": "Discriminator."++ },++ "id": {++ "type": "string",++ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved so that a streamed part can be matched to its entry in history once assistant messages carry parts too."++ },++ "text": {++ "type": "string",++ "description": "The text."++ },++ "metadata": {++ "not": {++ "type": "null"++ },++ "description": "Extra information about this part. Unconstrained, as on the media parts. This is where a text search hit carries its source and title, rather than the protocol modelling a search-result part of its own."++ }++ },++ "required": [++ "type",++ "text"++ ],++ "unevaluatedProperties": false++ },++ "ImagePart": {++ "type": "object",++ "description": "An image part.",++ "properties": {++ "type": {++ "const": "image",++ "description": "Discriminator."++ },++ "id": {++ "type": "string",++ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."++ },++ "source": {++ "$ref": "#/definitions/PartSource",++ "description": "Where the image comes from."++ },++ "metadata": {++ "not": {++ "type": "null"++ },++ "description": "Extra information about this part. Unconstrained rather than an object: inherited from the SDKs, which declare it unknown rather than a record; listed under known divergences in the README rather than resolved here."++ }++ },++ "required": [++ "type",++ "source"++ ],++ "unevaluatedProperties": false++ },++ "AudioPart": {++ "type": "object",++ "description": "An audio part.",++ "properties": {++ "type": {++ "const": "audio",++ "description": "Discriminator."++ },++ "id": {++ "type": "string",++ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."++ },++ "source": {++ "$ref": "#/definitions/PartSource",++ "description": "Where the audio comes from."++ },++ "metadata": {++ "not": {++ "type": "null"++ },++ "description": "Extra information about this part. Unconstrained, as on the other media parts."++ }++ },++ "required": [++ "type",++ "source"++ ],++ "unevaluatedProperties": false++ },++ "VideoPart": {++ "type": "object",++ "description": "A video part.",++ "properties": {++ "type": {++ "const": "video",++ "description": "Discriminator."++ },++ "id": {++ "type": "string",++ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."++ },++ "source": {++ "$ref": "#/definitions/PartSource",++ "description": "Where the video comes from."++ },++ "metadata": {++ "not": {++ "type": "null"++ },++ "description": "Extra information about this part. Unconstrained, as on the other media parts."++ }++ },++ "required": [++ "type",++ "source"++ ],++ "unevaluatedProperties": false++ },++ "DocumentPart": {++ "type": "object",++ "description": "A document part.",++ "properties": {++ "type": {++ "const": "document",++ "description": "Discriminator."++ },++ "id": {++ "type": "string",++ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."++ },++ "source": {++ "$ref": "#/definitions/PartSource",++ "description": "Where the document comes from."++ },++ "metadata": {++ "not": {++ "type": "null"++ },++ "description": "Extra information about this part. Unconstrained, as on the other media parts."++ }++ },++ "required": [++ "type",++ "source"++ ],++ "unevaluatedProperties": false++ },++ "PartSource": {++ "description": "Where a media part's bytes come from: carried inline, referenced by URL, or already at the provider under a handle it issued.",++ "oneOf": [++ {++ "$ref": "#/definitions/DataSource"++ },++ {++ "$ref": "#/definitions/UrlSource"++ },++ {++ "$ref": "#/definitions/FileSource"++ }++ ]++ },++ "DataSource": {++ "type": "object",++ "description": "Bytes carried inline.",++ "properties": {++ "type": {++ "const": "data",++ "description": "Discriminator."++ },++ "value": {++ "type": "string",++ "contentEncoding": "base64",++ "description": "The bytes, base64-encoded. contentEncoding is an annotation rather than a constraint in 2020-12, so a malformed string still validates here; rejecting one is the decoder's job."++ },++ "mimeType": {++ "type": "string",++ "description": "What the bytes are. Required here, unlike on a URL source, because nothing else can tell a consumer how to read them."++ }++ },++ "required": [++ "type",++ "value",++ "mimeType"++ ],++ "unevaluatedProperties": false++ },++ "UrlSource": {++ "type": "object",++ "description": "Bytes referenced by URL, fetched by whoever needs them.",++ "properties": {++ "type": {++ "const": "url",++ "description": "Discriminator."++ },++ "value": {++ "type": "string",++ "description": "The URL. Deliberately not constrained to a URI format, so a scheme a producer already uses is not rejected here."++ },++ "mimeType": {++ "type": "string",++ "description": "What the resource is, when the producer knows. Optional, because the response can say."++ }++ },++ "required": [++ "type",++ "value"++ ],++ "unevaluatedProperties": false++ },++ "FileSource": {++ "type": "object",++ "description": "Bytes already at the provider, named by a handle the provider issued: an OpenAI or Anthropic file id, a Gemini file URI, a storage URL only that provider can read. No bytes travel and nothing is fetched. Only the provider that minted the handle can resolve it; a peer that cannot drops the part as it drops any part it cannot use.",++ "properties": {++ "type": {++ "const": "file",++ "description": "Discriminator."++ },++ "value": {++ "type": "string",++ "description": "The handle, exactly as the provider issued it. Opaque: a consumer MUST NOT fetch it, parse it or read a scheme out of it."++ },++ "provider": {++ "type": "string",++ "description": "Who issued the handle, when the producer knows. Optional: an agent already knows which provider it talks to. When present, SHOULD be the lowercase vendor id (openai, anthropic, google) that TokenUsage.provider uses, so a peer can tell before sending whether a handle is one it can use."++ },++ "mimeType": {++ "type": "string",++ "description": "What the file is, when the producer knows. Optional, because the provider that holds the bytes knows."++ }++ },++ "required": [++ "type",++ "value"++ ],++ "unevaluatedProperties": false++ },++ "Context": {++ "type": "object",++ "description": "A named piece of ambient information given to the agent for the run, distinct from the conversation.",++ "properties": {++ "description": {++ "type": "string",++ "description": "What this context is, for the agent to interpret."++ },++ "value": {++ "type": "string",++ "description": "The context itself."++ }++ },++ "required": [++ "description",++ "value"++ ],++ "unevaluatedProperties": false++ },++ "Tool": {++ "type": "object",++ "description": "A tool the agent may call.",++ "properties": {++ "name": {++ "type": "string",++ "description": "The tool's name, as the agent will call it."++ },++ "description": {++ "type": "string",++ "description": "What the tool does, for the agent to decide when to use it."++ },++ "parameters": {++ "not": {++ "type": "null"++ },++ "description": "A JSON Schema describing the tool's arguments. Carried opaquely: the protocol does not constrain or validate it. Optional, because all three SDKs already treat it that way and a tool that takes no arguments has nothing to declare; an absent schema and an empty one mean the same thing to an agent."++ },++ "metadata": {++ "$ref": "#/definitions/Metadata",++ "description": "Extra information about the tool, for consumers that attach their own rendering or routing information to it."++ }++ },++ "required": [++ "name",++ "description"++ ],++ "unevaluatedProperties": false++ },++ "RunAgentInput": {++ "type": "object",++ "description": "A request to run an agent. Also echoed back as RUN_STARTED.input. Only threadId, runId and messages are required: those are the three the SDKs already agree on, and for tools and context an absent key and an empty array mean the same thing, so requiring them would catch nothing a producer could get wrong.",++ "properties": {++ "threadId": {++ "type": "string",++ "description": "The conversation this run belongs to."++ },++ "runId": {++ "type": "string",++ "description": "Identifies this run."++ },++ "protocolVersion": {++ "type": "string",++ "description": "The protocol version this consumer speaks, such as \"1.0\". Absent means the input was produced before the protocol carried a version — the versioning rules in the prose govern what each side does with that. Sent in-band rather than by the transport, so a recorded exchange stays self-describing."++ },++ "parentRunId": {++ "type": "string",++ "description": "The run that spawned this one."++ },++ "state": {++ "not": {++ "type": "null"++ },++ "$ref": "#/definitions/State",++ "description": "The state the run starts from."++ },++ "messages": {++ "type": "array",++ "description": "The conversation so far, in order.",++ "items": {++ "$ref": "#/definitions/Message"++ }++ },++ "tools": {++ "type": "array",++ "description": "The tools the agent may call. Absent means none.",++ "items": {++ "$ref": "#/definitions/Tool"++ }++ },++ "context": {++ "type": "array",++ "description": "Ambient information for the run. Absent means none.",++ "items": {++ "$ref": "#/definitions/Context"++ }++ },++ "forwardedProps": {++ "not": {++ "type": "null"++ },++ "description": "Application-specific values passed through to the agent untouched. Any JSON value."++ },++ "resume": {++ "type": "array",++ "description": "Answers to the interrupts that ended a previous run, when this run continues from one.",++ "items": {++ "$ref": "#/definitions/ResumeEntry"++ }++ }++ },++ "required": [++ "threadId",++ "runId",++ "messages"++ ],++ "unevaluatedProperties": false++ },++ "JsonPatch": {++ "type": "array",++ "description": "A JSON Patch document as defined by RFC 6902, referenced by STATE_DELTA.delta and ACTIVITY_DELTA.patch: an ordered sequence of operations applied to a target document. An empty array is a valid no-op patch. Whether the operations actually apply to the document they target is a runtime question RFC 6902 leaves to the applier; structural validity here says nothing about it.",++ "items": {++ "$ref": "#/definitions/JsonPatchOperation"++ }++ },++ "JsonPatchOperation": {++ "description": "A single RFC 6902 operation. Exactly one of the operation shapes must match, discriminated by op. Unlike the protocol's own objects, the operations are open: RFC 6902 section 4 requires members an operation does not define to be ignored rather than rejected, so a remove carrying a leftover value is a valid patch. Two of the RFC's rules are relations between values rather than shapes, so no static schema can express them and neither is checked here: a move whose from is a proper prefix of its path (section 4.4), and any operation whose pointer does not resolve in the target document. Both are the applier's to reject.",++ "oneOf": [++ {++ "$ref": "#/definitions/AddOperation"++ },++ {++ "$ref": "#/definitions/RemoveOperation"++ },++ {++ "$ref": "#/definitions/ReplaceOperation"++ },++ {++ "$ref": "#/definitions/MoveOperation"++ },++ {++ "$ref": "#/definitions/CopyOperation"++ },++ {++ "$ref": "#/definitions/TestOperation"++ }++ ]++ },++ "AddOperation": {++ "type": "object",++ "description": "Inserts value at path. RFC 6902 section 4.1.",++ "properties": {++ "op": {++ "const": "add",++ "description": "Discriminator for the add operation."++ },++ "path": {++ "$ref": "#/definitions/JsonPointer",++ "description": "Where to insert the value."++ },++ "value": {++ "description": "The value to insert. Any JSON value, including null, which is a legitimate thing to add."++ }++ },++ "required": [++ "op",++ "path",++ "value"++ ]++ },++ "RemoveOperation": {++ "type": "object",++ "description": "Removes the value at path. RFC 6902 section 4.2.",++ "properties": {++ "op": {++ "const": "remove",++ "description": "Discriminator for the remove operation."++ },++ "path": {++ "$ref": "#/definitions/JsonPointer",++ "description": "What to remove."++ }++ },++ "required": [++ "op",++ "path"++ ]++ },++ "ReplaceOperation": {++ "type": "object",++ "description": "Replaces the value at path. RFC 6902 section 4.3.",++ "properties": {++ "op": {++ "const": "replace",++ "description": "Discriminator for the replace operation."++ },++ "path": {++ "$ref": "#/definitions/JsonPointer",++ "description": "What to replace."++ },++ "value": {++ "description": "The replacement. Any JSON value, including null."++ }++ },++ "required": [++ "op",++ "path",++ "value"++ ]++ },++ "MoveOperation": {++ "type": "object",++ "description": "Moves the value at from to path. RFC 6902 section 4.4.",++ "properties": {++ "op": {++ "const": "move",++ "description": "Discriminator for the move operation."++ },++ "from": {++ "$ref": "#/definitions/JsonPointer",++ "description": "Where the value is moved from."++ },++ "path": {++ "$ref": "#/definitions/JsonPointer",++ "description": "Where the value is moved to."++ }++ },++ "required": [++ "op",++ "from",++ "path"++ ]++ },++ "CopyOperation": {++ "type": "object",++ "description": "Copies the value at from to path. RFC 6902 section 4.5.",++ "properties": {++ "op": {++ "const": "copy",++ "description": "Discriminator for the copy operation."++ },++ "from": {++ "$ref": "#/definitions/JsonPointer",++ "description": "Where the value is copied from."++ },++ "path": {++ "$ref": "#/definitions/JsonPointer",++ "description": "Where the value is copied to."++ }++ },++ "required": [++ "op",++ "from",++ "path"++ ]++ },++ "TestOperation": {++ "type": "object",++ "description": "Asserts that the value at path equals value. RFC 6902 section 4.6.",++ "properties": {++ "op": {++ "const": "test",++ "description": "Discriminator for the test operation."++ },++ "path": {++ "$ref": "#/definitions/JsonPointer",++ "description": "What to compare."++ },++ "value": {++ "description": "The value the target must equal. Any JSON value, including null."++ }++ },++ "required": [++ "op",++ "path",++ "value"++ ]++ },++ "JsonPointer": {++ "type": "string",++ "description": "A JSON Pointer as defined by RFC 6901. Either the empty string, meaning the whole document, or a sequence of slash-prefixed reference tokens in which a tilde is escaped as ~0 and a slash as ~1. A value with no leading slash, or a tilde followed by anything other than 0 or 1, is not a JSON Pointer.",++ "pattern": "^(/([^/~]|~[01])*)*$"++ },++ "OvSource": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "url",++ "title",++ "site"++ ],++ "properties": {++ "url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://",++ "maxLength": 2048++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 300++ },++ "site": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ }++ }++ },++ "Event": {++ "description": "Any AG-UI event. Every member is normative: there is no optional tier and no event a consumer may decline to implement. Discriminated by the type property.",++ "oneOf": [++ {++ "$ref": "#/definitions/TextMessageStartEvent"++ },++ {++ "$ref": "#/definitions/TextMessageContentEvent"++ },++ {++ "$ref": "#/definitions/TextMessageEndEvent"++ },++ {++ "$ref": "#/definitions/TextMessageChunkEvent"++ },++ {++ "$ref": "#/definitions/ToolCallStartEvent"++ },++ {++ "$ref": "#/definitions/ToolCallArgsEvent"++ },++ {++ "$ref": "#/definitions/ToolCallEndEvent"++ },++ {++ "$ref": "#/definitions/ToolCallChunkEvent"++ },++ {++ "$ref": "#/definitions/ToolCallResultEvent"++ },++ {++ "$ref": "#/definitions/StateSnapshotEvent"++ },++ {++ "$ref": "#/definitions/StateDeltaEvent"++ },++ {++ "$ref": "#/definitions/MessagesSnapshotEvent"++ },++ {++ "$ref": "#/definitions/ActivitySnapshotEvent"++ },++ {++ "$ref": "#/definitions/ActivityDeltaEvent"++ },++ {++ "$ref": "#/definitions/RawEvent"++ },++ {++ "$ref": "#/definitions/CustomEvent"++ },++ {++ "$ref": "#/definitions/RunStartedEvent"++ },++ {++ "$ref": "#/definitions/RunFinishedEvent"++ },++ {++ "$ref": "#/definitions/RunErrorEvent"++ },++ {++ "$ref": "#/definitions/StepStartedEvent"++ },++ {++ "$ref": "#/definitions/StepFinishedEvent"++ },++ {++ "$ref": "#/definitions/ReasoningStartEvent"++ },++ {++ "$ref": "#/definitions/ReasoningMessageStartEvent"++ },++ {++ "$ref": "#/definitions/ReasoningMessageContentEvent"++ },++ {++ "$ref": "#/definitions/ReasoningMessageEndEvent"++ },++ {++ "$ref": "#/definitions/ReasoningMessageChunkEvent"++ },++ {++ "$ref": "#/definitions/ReasoningEndEvent"++ },++ {++ "$ref": "#/definitions/ReasoningEncryptedValueEvent"++ },++ {++ "$ref": "#/definitions/SubagentStartedEvent"++ },++ {++ "$ref": "#/definitions/SubagentFinishedEvent"++ },++ {++ "$ref": "#/definitions/SubagentErrorEvent"++ }++ ]++ }++ }++ }++ },++ "agent.run": {++ "version": "1.0.0",++ "owner": "actor",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "type": "object",++ "additionalProperties": false,++ "$id": "https://openvibe.network/contracts/agent/run.v1.json",++ "title": "AgentRun",++ "description": "agent.run@1 snapshot of a run and its current plan, steps, sources, result, timestamps and cost.",++ "required": [++ "id",++ "product",++ "title",++ "status",++ "plan",++ "steps",++ "sources",++ "result",++ "started_at",++ "ended_at",++ "cost_usd"++ ],++ "properties": {++ "id": {++ "type": "string",++ "minLength": 1,++ "maxLength": 160++ },++ "product": {++ "type": "string",++ "minLength": 1,++ "maxLength": 40++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 240++ },++ "status": {++ "enum": [++ "queued",++ "running",++ "waiting",++ "needs_you",++ "succeeded",++ "failed",++ "stopped",++ "cancelled"++ ]++ },++ "plan": {++ "type": "array",++ "items": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "title",++ "status"++ ],++ "properties": {++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 240++ },++ "status": {++ "enum": [++ "todo",++ "running",++ "waiting",++ "needs_you",++ "done",++ "failed",++ "stopped"++ ]++ }++ }++ }++ },++ "steps": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/step"++ }++ },++ "sources": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/source"++ }++ },++ "result": {++ "type": [++ "object",++ "null"++ ]++ },++ "started_at": {++ "type": "string",++ "format": "date-time"++ },++ "ended_at": {++ "type": [++ "string",++ "null"++ ],++ "format": "date-time"++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ }++ },++ "$defs": {++ "step": {++ "type": "object",++ "additionalProperties": true,++ "required": [++ "title",++ "status"++ ],++ "properties": {++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 240++ },++ "status": {++ "enum": [++ "todo",++ "running",++ "waiting",++ "needs_you",++ "done",++ "failed",++ "stopped"++ ]++ }++ }++ },++ "source": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "url",++ "title",++ "site"++ ],++ "properties": {++ "url": {++ "type": "string",++ "format": "uri",++ "pattern": "^https://",++ "maxLength": 2048++ },++ "title": {++ "type": "string",++ "minLength": 1,++ "maxLength": 300++ },++ "site": {++ "type": "string",++ "minLength": 1,++ "maxLength": 120++ }++ }++ }++ }++ }++ },++ "actor.agent-sheet": {++ "version": "1.0.0",++ "owner": "actor",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/actor/agent-sheet.v1.json",++ "title": "ActorAgentSheet",++ "description": "actor.agent-sheet@1: one owner-scoped read of an Actor agent's current work, history, approvals, computer, schedules and memory. GET /api/v1/me/agents/:id?view=sheet; never cache this answer.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "agent",++ "now",++ "work",++ "asks",++ "asks_empty",++ "computer",++ "schedules",++ "memory",++ "activity"++ ],++ "properties": {++ "agent": {++ "type": "object",++ "additionalProperties": true,++ "required": [++ "id",++ "name",++ "face",++ "state",++ "instructions",++ "voice"++ ],++ "properties": {++ "id": {++ "type": "string",++ "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$"++ },++ "name": {++ "type": "string"++ },++ "face": {++ "type": [++ "string",++ "null"++ ]++ },++ "state": {++ "enum": [++ "working",++ "idle",++ "paused"++ ]++ },++ "instructions": {++ "type": "string"++ },++ "voice": {++ "type": [++ "string",++ "null"++ ]++ }++ }++ },++ "now": {++ "oneOf": [++ {++ "type": "null"++ },++ {++ "$ref": "#/$defs/work"++ }++ ]++ },++ "work": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/work"++ }++ },++ "asks": {++ "type": "array",++ "items": {++ "type": "object",++ "required": [++ "id",++ "state",++ "what"++ ],++ "properties": {++ "id": {++ "type": "string"++ },++ "state": {++ "type": "string"++ },++ "what": {++ "type": "string"++ },++ "why": {++ "type": [++ "string",++ "null"++ ]++ },++ "touch": {++ "type": [++ "string",++ "object",++ "null"++ ]++ }++ },++ "additionalProperties": true++ }++ },++ "asks_empty": {++ "type": [++ "string",++ "null"++ ]++ },++ "computer": {++ "oneOf": [++ {++ "type": "null"++ },++ {++ "type": "object",++ "properties": {++ "url": {++ "type": [++ "string",++ "null"++ ]++ },++ "open": {++ "type": [++ "string",++ "null"++ ]++ }++ },++ "additionalProperties": true++ }++ ]++ },++ "schedules": {++ "type": "array",++ "items": {++ "type": "object",++ "properties": {++ "next_run_at": {++ "type": [++ "string",++ "null"++ ]++ },++ "last_run_at": {++ "type": [++ "string",++ "null"++ ]++ },++ "last_result": {++ "type": [++ "string",++ "null"++ ]++ }++ },++ "additionalProperties": true++ }++ },++ "memory": {++ "type": "array",++ "items": {++ "type": "object",++ "required": [++ "id",++ "text"++ ],++ "properties": {++ "id": {++ "type": "string"++ },++ "text": {++ "type": "string"++ },++ "source": {++ "type": "string"++ }++ },++ "additionalProperties": true++ }++ },++ "activity": {++ "type": "array",++ "items": {++ "type": "object",++ "additionalProperties": true++ }++ }++ },++ "$defs": {++ "work": {++ "type": "object",++ "required": [++ "id",++ "task",++ "state",++ "cost_usd"++ ],++ "properties": {++ "id": {++ "type": "string"++ },++ "task": {++ "type": "string"++ },++ "state": {++ "type": "string"++ },++ "cost_usd": {++ "type": "number",++ "minimum": 0++ },++ "result": {},++ "computer": {}++ },++ "additionalProperties": true++ }++ }++ }++ },++ "codes.agent-sheet": {++ "version": "1.0.0",++ "owner": "codes",++ "status": "active",++ "schema": {++ "$schema": "https://json-schema.org/draft/2020-12/schema",++ "$id": "https://openvibe.network/contracts/codes/agent-sheet.v1.json",++ "title": "CodesAgentSheet",++ "description": "codes.agent-sheet@1: one owner's coding harness, its real attempts, outcomes and machine availability. Empty memory, schedule and computer sections mean Codes has no such per-harness records. GET /api/v1/me/agents/:id/sheet; never cache this answer.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "agent",++ "now",++ "work",++ "activity",++ "asks",++ "asks_empty",++ "computer",++ "schedules",++ "memory",++ "identity"++ ],++ "properties": {++ "agent": {++ "type": "object",++ "required": [++ "id",++ "name",++ "face",++ "state",++ "kind",++ "availability"++ ],++ "properties": {++ "id": {++ "type": "string"++ },++ "name": {++ "type": "string"++ },++ "face": {++ "type": "null"++ },++ "state": {++ "type": "string"++ },++ "kind": {++ "const": "coding harness"++ },++ "availability": {++ "type": [++ "object",++ "null"++ ]++ }++ },++ "additionalProperties": false++ },++ "now": {++ "oneOf": [++ {++ "type": "null"++ },++ {++ "$ref": "#/$defs/work"++ }++ ]++ },++ "work": {++ "type": "array",++ "items": {++ "$ref": "#/$defs/work"++ }++ },++ "activity": {++ "type": "array",++ "items": {++ "type": "object",++ "required": [++ "day",++ "entries"++ ],++ "properties": {++ "day": {++ "type": "string",++ "format": "date"++ },++ "entries": {++ "type": "array",++ "items": {++ "type": "object"++ }++ }++ },++ "additionalProperties": false++ }++ },++ "asks": {++ "type": "array",++ "maxItems": 0++ },++ "asks_empty": {++ "type": "string"++ },++ "computer": {++ "type": "null"++ },++ "schedules": {++ "type": "array",++ "maxItems": 0++ },++ "memory": {++ "type": "array",++ "maxItems": 0++ },++ "identity": {++ "type": "object",++ "required": [++ "provider",++ "capabilities"++ ],++ "properties": {++ "provider": {++ "type": [++ "string",++ "null"++ ]++ },++ "capabilities": {++ "type": "object"++ }++ },++ "additionalProperties": false++ }++ },++ "$defs": {++ "work": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "id",++ "task_id",++ "title",++ "what",++ "result",++ "state",++ "outcome",++ "cost_usd",++ "machine",++ "repo",++ "started_at",++ "finished_at",++ "url"++ ],++ "properties": {++ "id": {++ "type": "string"++ },++ "task_id": {++ "type": "string"++ },++ "title": {++ "type": "string"++ },++ "what": {++ "type": [++ "string",++ "null"++ ]++ },++ "result": {++ "type": [++ "string",++ "null"++ ]++ },++ "state": {++ "type": "string"++ },++ "outcome": {++ "type": [++ "string",++ "null"++ ]++ },++ "cost_usd": {++ "type": [++ "number",++ "null"++ ],++ "minimum": 0++ },++ "machine": {++ "type": [++ "string",++ "null"++ ]++ },++ "repo": {++ "type": [++ "string",++ "null"++ ]++ },++ "started_at": {++ "type": "string"++ },++ "finished_at": {++ "type": [++ "string",++ "null"++ ]++ },++ "url": {++ "type": "string"++ }++ }++ }++ }++ }}}}@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Actor API",-- "version": "0.404.0",-- "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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"@@@ -72,6 +72,148 @@}}},++ "/api/chat/commands/registered": {++ "post": {++ "operationId": "post_api_chat_commands_registered",++ "summary": "Register a slash command in a Chat server where the person authorizing the app is an owner or admin.",++ "description": "**chat.commands.register** (public): Register a slash command in a Chat server where the person authorizing the app is an owner or admin. The Network service token names the approved app or agent in sub, names the person in on_behalf_of, and carries this granted capability. Chat stores the command under that app, refuses built-in names, and executes its plain response template by posting as the person who invoked it with that person's current room rights. This grant never lets an app post as someone else or perform moderation.",++ "tags": [++ "chat.commands"++ ],++ "x-openvibe-capabilities": [++ "chat.commands.register"++ ],++ "x-openvibe-visibility": [++ "public"++ ],++ "x-openvibe-quota-class": "chat-write",++ "security": [++ {++ "openvibeToken": [++ "chat.commands.register"++ ]++ }++ ],++ "requestBody": {++ "required": false,++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/chat.command-registration-request.v1"++ }++ }++ }++ },++ "responses": {++ "2XX": {++ "description": "Success",++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/chat.command-registration-result.v1"++ }++ }++ }++ },++ "default": {++ "description": "An error (RFC 9457 problem details)",++ "content": {++ "application/problem+json": {++ "schema": {++ "$ref": "#/components/schemas/errors.problem.v1"++ }++ }++ }++ }++ }++ }++ },++ "/api/chat/commands/registered/{name}": {++ "delete": {++ "operationId": "delete_api_chat_commands_registered_name",++ "summary": "Register a slash command in a Chat server where the person authorizing the app is an owner or admin.",++ "description": "**chat.commands.register** (public): Register a slash command in a Chat server where the person authorizing the app is an owner or admin. The Network service token names the approved app or agent in sub, names the person in on_behalf_of, and carries this granted capability. Chat stores the command under that app, refuses built-in names, and executes its plain response template by posting as the person who invoked it with that person's current room rights. This grant never lets an app post as someone else or perform moderation.",++ "tags": [++ "chat.commands"++ ],++ "x-openvibe-capabilities": [++ "chat.commands.register"++ ],++ "x-openvibe-visibility": [++ "public"++ ],++ "x-openvibe-quota-class": "chat-write",++ "security": [++ {++ "openvibeToken": [++ "chat.commands.register"++ ]++ }++ ],++ "x-openvibe-input": {++ "$ref": "#/components/schemas/chat.command-registration-request.v1"++ },++ "parameters": [++ {++ "name": "name",++ "in": "path",++ "required": true,++ "schema": {++ "type": "string"++ }++ },++ {++ "name": "server",++ "in": "query",++ "required": true,++ "schema": {++ "type": "string",++ "pattern": "^[a-z0-9][a-z0-9-]{1,31}$"++ }++ },++ {++ "name": "command",++ "in": "query",++ "required": true,++ "schema": {++ "$ref": "#/components/schemas/chat.command.v1"++ }++ },++ {++ "name": "response_template",++ "in": "query",++ "required": true,++ "schema": {++ "type": "string",++ "minLength": 1,++ "maxLength": 2000++ }++ }++ ],++ "responses": {++ "2XX": {++ "description": "Success",++ "content": {++ "application/json": {++ "schema": {++ "$ref": "#/components/schemas/chat.command-registration-result.v1"++ }++ }++ }++ },++ "default": {++ "description": "An error (RFC 9457 problem details)",++ "content": {++ "application/problem+json": {++ "schema": {++ "$ref": "#/components/schemas/errors.problem.v1"++ }++ }++ }++ }++ }++ }++ },"/api/chat/inboxes": {"get": {"operationId": "get_api_chat_inboxes",@@@ -6538,6 +6680,132 @@}}},++ "chat.command-registration-request.v1": {++ "title": "Chat command registration request",++ "description": "chat.command-registration-request@1: an approved app or Actor agent registers a plain-response command in a server that the person named in its service token manages. The command cannot override a built-in. The template's {args} placeholder receives the invoking person's argument text; Chat posts the expanded result as that person after checking their current room rights.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "server",++ "command",++ "response_template"++ ],++ "properties": {++ "server": {++ "type": "string",++ "pattern": "^[a-z0-9][a-z0-9-]{1,31}$"++ },++ "command": {++ "$ref": "#/components/schemas/chat.command.v1"++ },++ "response_template": {++ "type": "string",++ "minLength": 1,++ "maxLength": 2000++ }++ }++ },++ "chat.command-registration-result.v1": {++ "title": "Chat command registration result",++ "description": "chat.command-registration-result@1: the command Chat stored for an approved app or Actor agent, with source and application_id derived from the verified service token.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "command"++ ],++ "properties": {++ "command": {++ "$ref": "#/components/schemas/chat.command.v1"++ }++ }++ },++ "chat.command.v1": {++ "title": "Chat slash command",++ "description": "chat.command@1: one command the OpenVibe.Chat composer offers. A registered command's name (one to 32 lowercase letters, digits, underscores or dashes, starting with a letter), a plain-sentence description of at most 100 characters, and its typed options in order; source says who registered it (builtin, app or actor) and application_id names the app or actor for a registration. Chat serves the built-in list at GET /api/chat/commands (query q filters by name) and an option's choices at GET /api/chat/commands/autocomplete, both behind the default-off CHAT_SLASH_COMMANDS_ENABLED switch. An execution still runs through the socket's authenticated command pipeline with the sender's own rights, so moderating commands keep the moderation checks; an unknown command is answered with a plain sentence.",++ "type": "object",++ "additionalProperties": false,++ "required": [++ "name",++ "description",++ "options"++ ],++ "properties": {++ "name": {++ "type": "string",++ "pattern": "^[a-z][a-z0-9_-]{0,31}$"++ },++ "description": {++ "type": "string",++ "maxLength": 100++ },++ "options": {++ "type": "array",++ "maxItems": 25,++ "items": {++ "$ref": "#/components/schemas/chat.command.v1/$defs/option"++ }++ },++ "source": {++ "enum": [++ "builtin",++ "app",++ "actor"++ ]++ },++ "application_id": {++ "type": [++ "string",++ "null"++ ],++ "maxLength": 128++ }++ },++ "$defs": {++ "option": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "name",++ "description",++ "type",++ "required"++ ],++ "properties": {++ "name": {++ "type": "string",++ "pattern": "^[a-z][a-z0-9_-]{0,31}$"++ },++ "description": {++ "type": "string",++ "maxLength": 100++ },++ "type": {++ "enum": [++ "string",++ "integer",++ "boolean",++ "user",++ "channel"++ ]++ },++ "required": {++ "type": "boolean"++ },++ "choices": {++ "type": "array",++ "maxItems": 25,++ "items": {++ "type": "string",++ "maxLength": 100++ }++ },++ "autocomplete": {++ "type": "boolean"++ }++ }++ }++ }++ },"chat.dm-peers-result.v1": {"title": "ChatDmPeersResult","description": "chat.dm-peers-result@1: which of the candidate people share a conversation with one person on OpenVibe.Chat (POST /internal/chat/dm/peers, chat.dm.peers.read). It answers with subjects only; a candidate with no shared conversation is simply absent. Used by OpenVibe.Network's presence privacy rule.",@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Codes API",-- "version": "0.404.0",-- "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Community API",-- "version": "0.404.0",-- "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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"@@@ -5106,6 +5106,20 @@"system"]},++ "visibility": {++ "enum": [++ "followers"++ ],++ "description": "Present only for an item returned to an authorized follower or its author."++ },++ "starts_at": {++ "type": "string",++ "format": "date-time"++ },++ "actor_name": {++ "type": "string",++ "maxLength": 80++ },"label": {"enum": ["AI",@@@ -5217,7 +5231,7 @@},"community.pulse-write-request.v1": {"title": "CommunityPulseWriteRequest",-- "description": "community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities (ref.service must be that service: 403 pulse.foreign_ref otherwise), with a title (whitespace collapsed, 1 to 300 characters) and an absolute http(s) url (at most 2000 characters). origin defaults to X-OV-Origin (user, ai or system; X-OV-Origin: ai always wins); an origin user item names the person in X-OV-Subject. occurred_at is an ISO time, not in the future (default now). Only public activity enters Pulse: a visibility other than public is 400 pulse.not_public. The same ref again updates the item. Unknown fields are ignored. DELETE /api/v1/pulse/items/:service/:type/:id takes no body.",++ "description": "community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities, with a title and an absolute http(s) URL. Optional media carries an HTTPS thumbnail, preview video, aspect ratio and duration for Feed cards. Visibility is public by default; followers requires origin user and X-OV-Subject and is shown only to that person's followers. Private, unlisted and members items are refused. The same ref updates the item. DELETE /api/v1/pulse/items/:service/:type/:id retracts it.","anyOf": [{"type": "object",@@@ -5259,8 +5273,38 @@"visibility": {"enum": ["public",++ "followers",null]++ },++ "media": {++ "type": "object",++ "additionalProperties": false,++ "properties": {++ "thumb": {++ "type": "string",++ "pattern": "^https://",++ "maxLength": 2000++ },++ "preview": {++ "type": [++ "string",++ "null"++ ],++ "pattern": "^https://",++ "maxLength": 2000++ },++ "ratio": {++ "type": "number",++ "exclusiveMinimum": 0,++ "maximum": 20++ },++ "length": {++ "type": "number",++ "minimum": 0,++ "maximum": 86400++ }++ }}}},@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe Connect API",-- "version": "0.404.0",-- "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Design API",-- "version": "0.404.0",-- "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.Exchange API",-- "version": "0.404.0",-- "description": "Routes of OpenVibe.Exchange as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Exchange as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.Git API",-- "version": "0.404.0",-- "description": "Routes of OpenVibe.Git as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Git as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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"@@@ -47,8 +47,8 @@"service": "chat","name": "OpenVibe.Chat","origin": "https://openvibe.chat",-- "operations": 67,-- "capabilities": 26++ "operations": 69,++ "capabilities": 27},{"service": "codes",@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Inventory API",-- "version": "0.404.0",-- "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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"@@@ -4175,6 +4175,13 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."++ },"started_at": {"type": ["string",@@@ -4886,6 +4893,13 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."++ },"started_at": {"type": ["string",@@@ -5000,6 +5014,13 @@"null"]},++ "preview_url": {++ "type": [++ "string",++ "null"++ ],++ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."++ },"started_at": {"type": ["string",@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Mail API",-- "version": "0.404.0",-- "description": "Routes of OpenVibe.Mail as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Mail as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Report API",-- "version": "0.404.0",-- "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.","license": {"name": "MIT","identifier": "MIT"@@@ -3,8 +3,8 @@"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema","info": {"title": "OpenVibe.Today API",-- "version": "0.404.0",-- "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",-- "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",++ "version": "0.405.0",++ "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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"@@@ -209270,6 +209270,14 @@ export interface MediaVod {*/playback_url: string;thumbnail_url?: string | null;++ /**++ * The hover preview of this item: about 6 s, muted, 320 px wide, MP4 H.264, stored beside its thumbnail and served at /t/<name>. Null until the preview.make job has made it (audio-only, private and too-short items never get one).++ */++ preview_url?: string | null;++ /**++ * The same moment as preview_url, encoded as WebM (VP9, VP8 where the encoder has no VP9). Null while preview_url is.++ */++ preview_webm_url?: string | null;/*** local, b2 or r2.*/@@@ -209363,6 +209371,14 @@ export interface MediaClip {*/playback_url: string;thumbnail_url?: string | null;++ /**++ * The hover preview of this item: about 6 s, muted, 320 px wide, MP4 H.264, stored beside its thumbnail and served at /t/<name>. Null until the preview.make job has made it (audio-only, private and too-short items never get one).++ */++ preview_url?: string | null;++ /**++ * The same moment as preview_url, encoded as WebM (VP9, VP8 where the encoder has no VP9). Null while preview_url is.++ */++ preview_webm_url?: string | null;storage_provider?: string;/*** public: anyone. unlisted: reached only by its exact id, never listed, noindex. private: missing to everyone but its owner and staff.@@@ -209645,6 +209661,24 @@ export interface ChatSlashCommand {application_id?: string | null;}++/** [email protected] (owner: chat) */++/**++ * chat.command-registration-request@1: an approved app or Actor agent registers a plain-response command in a server that the person named in its service token manages. The command cannot override a built-in. The template's {args} placeholder receives the invoking person's argument text; Chat posts the expanded result as that person after checking their current room rights.++ */++export interface ChatCommandRegistrationRequest {++ server: string;++ command: ChatSlashCommand;++ response_template: string;++}++++/** [email protected] (owner: chat) */++/**++ * chat.command-registration-result@1: the command Chat stored for an approved app or Actor agent, with source and application_id derived from the verified service token.++ */++export interface ChatCommandRegistrationResult {++ command: ChatSlashCommand;++}++/** [email protected] (owner: chat) *//*** chat.send-request@1: what a sender hands OpenVibe.Chat to post a chat line (chat.message.send). From a browser, a frame on WS /ws/chat of type chat in the room the socket joined (the text is trimmed; empty or longer than 6000 characters is dropped, the channel's own max_message_length is enforced after that; a line starting with ! or / is a command, not a message). From Live's bridge, POST /internal/live/calls: a chat.live_bridge.write batch in which every op that sends a message (a chat or dm frame, db saveChatMessage, deployNotice) also needs chat.message.send; without it that op alone is refused. From a first-party service, POST /internal/chat/messages: one line (or one DM) that Chat stores, broadcasts to the room (with mirror, also to global chat and the streamer rooms), reads aloud (tts) and answers with the real id; applied once per (caller, key), the same key with another body gets 409.@@@ -212102,15 +212136,172 @@ export interface ChatRoomInsightResult {state: "ready" | "quiet" | "off";}++/** [email protected] (owner: chat) */++/**++ * chat.person-memory-result@1: compacted chat memory returned by GET /api/v1/people/{username}/memory. Private fields appear only for the person and the channel owner.++ */++export interface ChatPersonMemoryResult {++ username: string;++ level: "day" | "week" | "month";++ channel: string | null;++ opted_out: boolean;++ enabled: boolean;++ /**++ * @maxItems 60++ */++ entries: {++ level: "day" | "week" | "month";++ period_start: string;++ channel_user_id: number;++ summary: string;++ /**++ * @maxItems 5++ */++ topics:++ | []++ | [string]++ | [string, string]++ | [string, string, string]++ | [string, string, string, string]++ | [string, string, string, string, string];++ /**++ * @maxItems 5++ */++ highlights:++ | []++ | [++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ }++ ]++ | [++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ },++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ }++ ]++ | [++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ },++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ },++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ }++ ]++ | [++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ },++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ },++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ },++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ }++ ]++ | [++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ },++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ },++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ },++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ },++ {++ detail: string;++ stream_id: number | null;++ at: string | null;++ }++ ];++ message_count: number;++ tone?: string;++ /**++ * @maxItems 5++ */++ catchphrases?:++ | []++ | [string]++ | [string, string]++ | [string, string, string]++ | [string, string, string, string]++ | [string, string, string, string, string];++ /**++ * @maxItems 8++ */++ people?:++ | []++ | [string]++ | [string, string]++ | [string, string, string]++ | [string, string, string, string]++ | [string, string, string, string, string]++ | [string, string, string, string, string, string]++ | [string, string, string, string, string, string, string]++ | [string, string, string, string, string, string, string, string];++ }[];++}++++/** [email protected] (owner: chat) */++/**++ * chat.person-memory-preferences-result@1: the person's delete or opt-out result.++ */++export interface ChatPersonMemoryPreferencesResult {++ opted_out: boolean;++ deleted?: boolean;++}++/** [email protected] (owner: chat) *//**-- * chat.embed@1: one address preview under a chat message, the same shape for every client (OpenVibe.Chat, Live's chat and the Dock). A message carries `embeds` in the order the addresses appeared in its text, at most three; it is empty while the background job is still reading, and the client draws each one as the same card. The fields are data, never markup: a client escapes them (title, description, site_name, by) before drawing them. url is the address the writer sent, https only. image is an OpenVibe.Media address or null: another site's picture is never hot-linked. width and height are the picture's stated size, or 0. kind names what was found: an ordinary page (`link`), a video (`video`), a picture (`image`), a Live channel (`live`), a Pics picture (`picture`), a Design item (`design`), a Community post (`post`), a Network profile (`profile`) or a Games world (`game`). OpenVibe's own kinds are resolved through that service's public API, never by reading its page, and carry by (the person or channel the thing belongs to) and, for Live, live (whether the channel is broadcasting now); both are absent on an ordinary link.++ * chat.embed@1: one address preview under a chat message, the same shape for every client (OpenVibe.Chat, Live's chat and the Dock). A message carries `embeds` in the order the addresses appeared in its text, at most three; it is empty while the background job is still reading, and the client draws each one as the same card. The fields are data, never markup: a client escapes them (title, description, site_name, by) before drawing them. url is the address the writer sent, https only. image is an OpenVibe.Media address or null: another site's picture is never hot-linked. width and height are the picture's stated size, or 0. kind names what was found: an ordinary page (`link`), a video (`video`), a picture (`image`), a Live channel (`live`), a Pics picture (`picture`), a Design item (`design`), a Community post (`post`), a Network profile (`profile`) or a Games world (`game`). OpenVibe's own kinds are resolved through that service's public API, never by reading its page, and carry by (the person or channel the thing belongs to) and, for Live, live (whether the channel is broadcasting now); both are absent on an ordinary link. An agent-run embed carries the live run and event addresses, title and status.*/--export interface ChatEmbed {++export type ChatEmbed = {++ [k: string]: unknown | undefined;++} & {/*** What the address turned out to be; a client may draw the same card for every value.*/-- kind: "link" | "video" | "image" | "live" | "picture" | "design" | "post" | "profile" | "game";++ kind: "link" | "video" | "image" | "live" | "picture" | "design" | "post" | "profile" | "game" | "agent-run";/*** The https address the message carried, after the writer's trailing punctuation was dropped.*/@@@ -212119,9 +212310,6 @@ export interface ChatEmbed {* The site as it names itself (og:site_name, the provider's name, or the host).*/site_name: string;-- /**-- * The page's or service's title, folded to plain text.-- */title: string;/*** A short plain-text description, or an empty string when the source states none.@@@ -212147,7 +212335,10 @@ export interface ChatEmbed {* On a Live channel kind, whether it is broadcasting now. Absent on the other kinds.*/live?: boolean;--}++ run_url?: string;++ events_url?: string;++ status?: "queued" | "running" | "waiting" | "needs_you" | "succeeded" | "failed" | "stopped" | "cancelled";++};/** [email protected] (owner: chat) *//**@@@ -212633,6 +212824,10 @@ export type LiveChannelReadResult =viewer_count?: number | null;peak_viewers?: number | null;thumbnail_url?: string | null;++ /**++ * A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail.++ */++ preview_url?: string | null;started_at?: string | null;ended_at?: string | null;/**@@@ -212934,6 +213129,10 @@ export type LiveStreamReadResult =viewer_count?: number | null;peak_viewers?: number | null;thumbnail_url?: string | null;++ /**++ * A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail.++ */++ preview_url?: string | null;started_at?: string | null;ended_at?: string | null;/**@@@ -212964,6 +213163,10 @@ export type LiveStreamReadResult =viewer_count?: number | null;peak_viewers?: number | null;thumbnail_url?: string | null;++ /**++ * A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail.++ */++ preview_url?: string | null;started_at?: string | null;ended_at?: string | null;/**@@@ -213812,7 +214015,7 @@ export type CommunityPostWriteResult =/** [email protected] (owner: community) *//**-- * community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities (ref.service must be that service: 403 pulse.foreign_ref otherwise), with a title (whitespace collapsed, 1 to 300 characters) and an absolute http(s) url (at most 2000 characters). origin defaults to X-OV-Origin (user, ai or system; X-OV-Origin: ai always wins); an origin user item names the person in X-OV-Subject. occurred_at is an ISO time, not in the future (default now). Only public activity enters Pulse: a visibility other than public is 400 pulse.not_public. The same ref again updates the item. Unknown fields are ignored. DELETE /api/v1/pulse/items/:service/:type/:id takes no body.++ * community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities, with a title and an absolute http(s) URL. Optional media carries an HTTPS thumbnail, preview video, aspect ratio and duration for Feed cards. Visibility is public by default; followers requires origin user and X-OV-Subject and is shown only to that person's followers. Private, unlisted and members items are refused. The same ref updates the item. DELETE /api/v1/pulse/items/:service/:type/:id retracts it.*/export type CommunityPulseWriteRequest =| {@@@ -213824,7 +214027,13 @@ export type CommunityPulseWriteRequest =url: string;origin?: "user" | "ai" | "system" | null;occurred_at?: string | number | null;-- visibility?: "public" | null;++ visibility?: "public" | "followers" | null;++ media?: {++ thumb?: string;++ preview?: string | null;++ ratio?: number;++ length?: number;++ };}| NoBody;@@@ -213979,6 +214188,12 @@ export interface CommunityPulseItem {title: string;url: string;origin: "user" | "ai" | "system";++ /**++ * Present only for an item returned to an authorized follower or its author.++ */++ visibility?: "followers";++ starts_at?: string;++ actor_name?: string;label: "AI" | "System" | null;/*** A third-party contribution is shown as via <app>.@@@ -214006,7 +214221,7 @@ export interface CommunityPulseItem {/** [email protected] (owner: community) *//**-- * community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). One stream over Pulse: a paste or a status is a post, a Live clip a clip, a Wiki page a wiki page, a Quest badge a quest, a busy Chat hour a chat, a Today event an event, and a day's new Network accounts a member. Text only (the client draws every field), https links only, and counts carry Community's own views, likes and comments where it knows them.++ * community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). Each card keeps its source and public visibility. Scheduled calendar cards appear only before their start time; bursts can carry a group of links. Counts carry Community's own views, likes and comments where it knows them.*/export interface CommunityFeedItem {/**@@@ -214027,7 +214242,14 @@ export interface CommunityFeedItem {| "quest"| "chat"| "event"-- | "member";++ | "member"++ | "avatar"++ | "banner"++ | "paste"++ | "site"++ | "space"++ | "follow"++ | "episode";/*** Where the card opens; https unless the source itself answered an http URL.*/@@@ -214041,6 +214263,14 @@ export interface CommunityFeedItem {* When it happened (Pulse provenance); null for a trending card.*/at: string | null;++ /**++ * The start time of a Coming up calendar item; absent on other kinds.++ */++ starts_at?: string;++ /**++ * Present only for an item returned to a follower or its author.++ */++ visibility?: "followers";/*** The source service (live, media-hub, pics, games, blog, wiki, quest, chat, today, network, community…).*/@@@ -214058,6 +214288,7 @@ export interface CommunityFeedItem {*/media: {thumb: string;++ preview?: string;ratio: number;/*** Seconds, when the card is a video.@@@ -214076,12 +214307,93 @@ export interface CommunityFeedItem {* Present on live and stream cards: true only while the channel is currently on air. A past broadcast has kind stream and live_now false.*/live_now?: boolean;++ group?: {++ count: number;++ /**++ * @minItems 2++ */++ items: [++ {++ id: string;++ url: string;++ title: string;++ media: {} | null;++ },++ {++ id: string;++ url: string;++ title: string;++ media: {} | null;++ },++ ...{++ id: string;++ url: string;++ title: string;++ media: {} | null;++ }[]++ ];++ };/*** Present only when the card needs one.*/label?: "Trending" | "AI" | "System";}++/** [email protected] (owner: community) */++/**++ * community.feed-card@1: one public card returned by GET /api/v1/feed on OpenVibe.Community.++ */++export interface CommunityFeedCard {++ id: string;++ kind:++ | "live"++ | "stream"++ | "clip"++ | "video"++ | "pic"++ | "post"++ | "meme"++ | "game"++ | "update"++ | "wiki"++ | "quest"++ | "chat"++ | "event"++ | "member";++ url: string;++ title: string;++ text: string;++ at: string | null;++ site: string;++ site_name: string;++ actor: {++ name: string | null;++ avatar: string | null;++ } | null;++ media: {++ thumb: string;++ preview?: string | null;++ ratio: number;++ length?: number;++ } | null;++ counts: {++ views?: number;++ likes?: number;++ comments?: number;++ };++ live_now?: boolean;++ label?: "Trending" | "AI" | "System";++}++++/** [email protected] (owner: community) */++/**++ * community.feed-answer@1: the response from GET /api/v1/feed.++ */++export interface CommunityFeedAnswer {++ items: CommunityFeedCard[];++ next_cursor: string | null;++}++/** [email protected] (owner: community) *//*** community.pulse-read-result@1: answers of community.pulse.read on OpenVibe.Community (anyone). GET /api/v1/pulse?origin=user|ai|system&after=&limit= → { items, next_cursor } (newest first, at most 100; an unknown origin or a cursor this API did not issue is 400). GET /pulse is the same activity as an HTML page.@@@ -333288,3 +333600,1965 @@ export interface NetworkLevelBoard {];};}++++/** [email protected] (owner: media) */++/**++ * composer.attachment@1: one file a person attached to a message in the shared composer. Media stores it and answers this shape from POST /api/v1/attachments (multipart field `file`); a client keeps it until the message is sent, then names it in POST /api/v1/attachments/:id/keep. `kind` is sniffed from the bytes, never taken from the browser: image, video, audio, file or code. `thumb` is a small preview for images and video (absent for the rest), `w`/`h` the pixel size when the file is one Media can measure. An attachment nobody keeps expires after 24 hours; `expires_at` says when, and a keep extends it to the message's life.++ */++export interface ComposerAttachment {++ /**++ * The attachment id (att_ + ULID): what DELETE /api/v1/attachments/:id and POST /api/v1/attachments/:id/keep name.++ */++ id: string;++ /**++ * Decided by Media from the bytes, not the client's claim: image/video/audio when the signature matches, code for recognised source text, otherwise file. Executables are refused at upload.++ */++ kind: "image" | "video" | "audio" | "file" | "code";++ /**++ * The file's original name, sanitised for display; never a path.++ */++ name: string;++ /**++ * Bytes stored.++ */++ size: number;++ /**++ * The content type Media serves the bytes as, from the sniffed kind and format.++ */++ mime: string;++ /**++ * Absolute https URL the bytes are served at. It stays valid while the attachment exists; a kept attachment is the message's to serve.++ */++ url: string;++ /**++ * Absolute URL of a preview image: an image's own small copy or a video's first frame. Null when Media could not make one (or the kind has none).++ */++ thumb?: string | null;++ /**++ * Pixel width of an image, video or video preview; null when unknown.++ */++ w?: number | null;++ /**++ * Pixel height of an image, video or video preview; null when unknown.++ */++ h?: number | null;++ /**++ * When an unkept attachment is deleted. The upload answers now + 24 hours; a keep moves it to the kept window.++ */++ expires_at: string;++}++++/** [email protected] (owner: network) */++/**++ * composer.prefs@1: a person's composer settings, the same on every OpenVibe site because Network stores them (GET/PUT /api/v1/me/composer). `rev` is the stored revision: send the one you read back with your change, and a tab that read an older copy gets 409 with the current document instead of overwriting the other tab. `send_key` says whether Enter or Ctrl/Cmd+Enter sends. `tools` is the one order of the composer's tools and which are hidden; a tool id the client does not know is kept, so a site can add one without another site dropping the person's order. `snippets` are the person's saved inserts, triggered by typing a slash word.++ */++export interface ComposerPrefs {++ /**++ * Revision of the stored document. A missing document is rev 0 with the defaults; every successful PUT answers rev + 1.++ */++ rev: number;++ /**++ * enter: Enter sends and Shift+Enter breaks the line. mod-enter: Ctrl/Cmd+Enter sends and Enter breaks the line (the default on a phone keyboard is enter).++ */++ send_key: "enter" | "mod-enter";++ /**++ * Every tool in the order the person wants them, each marked hidden or not.++ *++ * @maxItems 100++ */++ tools: {++ id: string;++ hidden: boolean;++ }[];++ /**++ * How much room the composer takes: comfy is the default on a computer, compact on a phone.++ */++ density: "comfy" | "compact";++ /**++ * Whether the composer offers dictation (where the device has it).++ */++ voice: boolean;++ /**++ * Saved inserts. Typing the trigger (a slash word such as /sig) in the composer offers the snippet.++ *++ * @maxItems 50++ */++ snippets: {++ /**++ * The slash word that offers the snippet, e.g. /sig. Lower-case letters, digits, _ and - only.++ */++ trigger: string;++ /**++ * What the menu shows.++ */++ label: string;++ /**++ * What is inserted.++ */++ text: string;++ }[];++}++++/** [email protected] (owner: network) */++/**++ * composer.mention@1: one thing the composer's @ menu can insert, from GET /api/v1/mentions on OpenVibe.Network. kind person (a person the caller follows first, then a public person), repo (a repository on OpenVibe Git the caller can see), site (a first-party OpenVibe site) or file (a file of the message's own context). `id` is the stable id inside its kind, `label` what the menu shows, `handle` the @name when the kind has one, `avatar` the picture, and `url` where choosing it links.++ */++export interface ComposerMention {++ /**++ * What is mentioned. The same person is a person; a repository on OpenVibe Git is a repo; a first-party OpenVibe site is a site; a file of the message's context (an attachment or a repository file) is a file.++ */++ kind: "person" | "repo" | "site" | "file";++ /**++ * The stable id inside the kind: a usr_… subject for a person, owner/name for a repo, a site id for a site, a path or attachment id for a file.++ */++ id: string;++ /**++ * What the menu shows (a display name, owner/name, the site's name, a file name).++ */++ label: string;++ /**++ * The @name when the kind has one: a person's username, a site's short name. Absent for a repo or a file.++ */++ handle?: string;++ /**++ * Absolute URL of the picture to show beside the label. Null when the kind has none (a file, a site without a mark).++ */++ avatar?: string | null;++ /**++ * Absolute https URL where choosing the mention leads: the person's profile, the repository, the site's home or the file.++ */++ url: string;++}++++/** [email protected] (owner: network) */++/**++ * network.user-card@1 (ask 287): the one public user card read, GET /api/v1/people/:username/card on OpenVibe.Network. It is public and credential-free; a signed-in viewer may send their Network token (Authorization: Bearer …) and then also receives `actions` computed for that viewer, never cached. Without a viewer, or on the viewer's own card, `actions` carries Profile and Channel only. A missing, expired or revoked token reads as anonymous, never a 401. Hidden fields are absent, never zero, offline or a placeholder; no presence, page titles or visited URLs leave the read.++ */++export interface NetworkUserCard {++ username: string;++ display_name?: string;++ avatar_url?: string;++ profile_url: string;++ level?: number;++ streak?: number;++ badges_count?: number;++ followers?: number;++ live?: {++ now: boolean;++ site?: "live";++ url?: string;++ };++ channel_url?: string;++ active_sites?: {++ id: string;++ name: string;++ url: string;++ }[];++ /**++ * What the viewer can do, by what is possible for the pair. Order is the card's order. Each action either opens somewhere (`href`) or calls a Network route with the viewer's token (`method` + `path`, and `body` where the route needs one).++ */++ actions: (++ | {++ id: string;++ label: string;++ href: string;++ state?: {++ following?: boolean;++ friendship?: "none" | "pending" | "requested" | "friends";++ muted?: boolean;++ blocked?: boolean;++ reported?: boolean;++ };++ }++ | {++ id: string;++ label: string;++ method: "PUT" | "POST" | "DELETE" | "PATCH";++ path: string;++ body?: {};++ state?: {++ following?: boolean;++ friendship?: "none" | "pending" | "requested" | "friends";++ muted?: boolean;++ blocked?: boolean;++ reported?: boolean;++ };++ }++ )[];++}++++/** [email protected] (owner: network) */++/**++ * network.user-report@1 (ask 287): one report a person filed about another person on OpenVibe.Network. Reports never resolve themselves; staff holding staff.moderation.logs read the queue (GET /api/v1/staff/user-reports?status=open&target=usr_…&limit=), and a staff decision lives in the moderation audit log. `status` records whether staff have looked, not a verdict.++ */++export interface NetworkUserReport {++ id: number;++ reporter: string;++ target: string;++ reason: "spam" | "harassment" | "impersonation" | "explicit" | "scam" | "other";++ detail: string;++ status: "open" | "reviewed" | "dismissed";++ created_at: string;++ updated_at: string;++}++++/** [email protected] (owner: network) */++/**++ * network.user-report-list-result@1 (ask 287): GET /api/v1/staff/user-reports on OpenVibe.Network, the staff queue for people holding staff.moderation.logs. Newest first, filtered by status (default open) and target subject, at most 200 rows (`limit`, default 50). A caller without the capability gets 403 user_reports.forbidden (problem+json).++ */++export interface NetworkUserReportListResult {++ /**++ * @maxItems 200++ */++ reports: NetworkUserReport[];++}++++/** [email protected] (owner: network) */++/**++ * network.user-report-request@1 (ask 287): POST /api/v1/me/reports on OpenVibe.Network, a signed-in person's report about another person. `target` is their username (any case) or usr_ subject; guests cannot be named, and nobody reports themselves. The same pair may have one open report: filing again while it is open answers the open one with 200 instead of creating a duplicate (201 when it creates one).++ */++export interface NetworkUserReportRequest {++ target: string;++ reason: "spam" | "harassment" | "impersonation" | "explicit" | "scam" | "other";++ detail?: string;++}++++/** [email protected] (owner: actor) */++/**++ * agent.ui-event@1: AG-UI 1.0 event shape and event-family fields, with OpenVibe metadata.ov. AG-UI timestamps are Unix-millisecond integers; this contract requires one on every event. CUSTOM events use AG-UI name/value with ov.sources, ov.handoff, ov.approval or ov.result names.++ */++export type AgentUiEvent = Event & {};++/**++ * Any AG-UI event. Every member is normative: there is no optional tier and no event a consumer may decline to implement. Discriminated by the type property.++ */++export type Event =++ | TextMessageStartEvent++ | TextMessageContentEvent++ | TextMessageEndEvent++ | TextMessageChunkEvent++ | ToolCallStartEvent++ | ToolCallArgsEvent++ | ToolCallEndEvent++ | ToolCallChunkEvent++ | ToolCallResultEvent++ | StateSnapshotEvent++ | StateDeltaEvent++ | MessagesSnapshotEvent++ | ActivitySnapshotEvent++ | ActivityDeltaEvent++ | RawEvent++ | CustomEvent++ | RunStartedEvent++ | RunFinishedEvent++ | RunErrorEvent++ | StepStartedEvent++ | StepFinishedEvent++ | ReasoningStartEvent++ | ReasoningMessageStartEvent++ | ReasoningMessageContentEvent++ | ReasoningMessageEndEvent++ | ReasoningMessageChunkEvent++ | ReasoningEndEvent++ | ReasoningEncryptedValueEvent++ | SubagentStartedEvent++ | SubagentFinishedEvent++ | SubagentErrorEvent;++/**++ * Opens a streamed text message. The content arrives as TEXT_MESSAGE_CONTENT events and the message closes with TEXT_MESSAGE_END.++ */++export type TextMessageStartEvent = BaseEvent &++ Attributable & {++ type: "TEXT_MESSAGE_START";++ /**++ * Identifies the message this stream builds, and ties the later content and end events to it.++ */++ messageId: string;++ /**++ * Who the message is from. An absent role means assistant; that meaning is normative and stated in the prose, because a validator treats a default as documentation rather than as behaviour.++ */++ role?: "developer" | "system" | "assistant" | "user";++ /**++ * An optional display name for the author, for providers that distinguish several participants in one role.++ */++ name?: string;++ };++/**++ * Appends a fragment to a streamed text message.++ */++export type TextMessageContentEvent = BaseEvent &++ Attributable & {++ type: "TEXT_MESSAGE_CONTENT";++ /**++ * The message this fragment belongs to.++ */++ messageId: string;++ /**++ * The fragment to append. May be the empty string: providers emit empty deltas as keep-alives and while a tool call is being decided, and rejecting them would kill runs that are working correctly.++ */++ delta: string;++ };++/**++ * Closes a streamed text message.++ */++export type TextMessageEndEvent = BaseEvent &++ Attributable & {++ type: "TEXT_MESSAGE_END";++ /**++ * The message being closed.++ */++ messageId: string;++ };++/**++ * A shorthand that stands in for a start, content and end sequence, for producers that cannot know in advance where a message begins. Every field is optional because a continuation chunk omits what has not changed; which message a field-less chunk continues is a sequence question the prose specification answers.++ */++export type TextMessageChunkEvent = BaseEvent &++ Attributable & {++ type: "TEXT_MESSAGE_CHUNK";++ /**++ * The message this chunk belongs to. Absent continues the message already open.++ */++ messageId?: string;++ /**++ * Who the message is from, on the chunk that opens it.++ */++ role?: "developer" | "system" | "assistant" | "user";++ /**++ * The fragment to append. May be the empty string.++ */++ delta?: string;++ /**++ * An optional display name for the author.++ */++ name?: string;++ };++/**++ * Opens a tool call. The arguments arrive as TOOL_CALL_ARGS events and the call closes with TOOL_CALL_END.++ */++export type ToolCallStartEvent = BaseEvent &++ Attributable & {++ type: "TOOL_CALL_START";++ /**++ * Identifies the call, and ties the later args, end and result events to it.++ */++ toolCallId: string;++ /**++ * Which tool is being called.++ */++ toolCallName: string;++ /**++ * The assistant message that holds this call. Absent means the producer did not attribute it to one.++ */++ parentMessageId?: string;++ };++/**++ * Appends a fragment of a tool call's arguments.++ */++export type ToolCallArgsEvent = BaseEvent &++ Attributable & {++ type: "TOOL_CALL_ARGS";++ /**++ * The call these arguments belong to.++ */++ toolCallId: string;++ /**++ * A fragment of the arguments, which concatenate into the call's argument text — conventionally a JSON document, though the protocol does not validate it (see FunctionCall.arguments). Deliberately a string rather than parsed JSON: a fragment is not itself a document. May be the empty string.++ */++ delta: string;++ };++/**++ * Closes a tool call, meaning its arguments are complete.++ */++export type ToolCallEndEvent = BaseEvent &++ Attributable & {++ type: "TOOL_CALL_END";++ /**++ * The call being closed.++ */++ toolCallId: string;++ };++/**++ * A shorthand that stands in for a tool call's start, args and end sequence. Every field is optional for the same reason as TEXT_MESSAGE_CHUNK.++ */++export type ToolCallChunkEvent = BaseEvent &++ Attributable & {++ type: "TOOL_CALL_CHUNK";++ /**++ * The call this chunk belongs to. Absent continues the call already open.++ */++ toolCallId?: string;++ /**++ * Which tool is being called, on the chunk that opens it.++ */++ toolCallName?: string;++ /**++ * The assistant message that holds this call.++ */++ parentMessageId?: string;++ /**++ * A fragment of the arguments. May be the empty string.++ */++ delta?: string;++ };++/**++ * Carries what a tool returned. Mints a tool message rather than appending to an existing one, which is why it has its own messageId.++ */++export type ToolCallResultEvent = BaseEvent &++ Attributable & {++ type: "TOOL_CALL_RESULT";++ /**++ * The tool message this result becomes.++ */++ messageId: string;++ /**++ * The call being answered.++ */++ toolCallId: string;++ /**++ * What the tool returned: either plain text, or an ordered list of parts, exactly as on the tool message this event mints. A tool returning structured data serialises it into text; media travel as parts of their own.++ */++ content: string | ContentPart[];++ /**++ * Present only for symmetry with the message it mints; the value is fixed, so a producer may leave it out.++ */++ role?: "tool";++ };++/**++ * One part of a message body: what a person sends in a user message, or what a tool returns in a tool message. Discriminated by type. Named by what the part is rather than by direction, because the same part travels into the model inside a user message and back out of the stream inside a tool result.++ */++export type ContentPart = TextPart | ImagePart | AudioPart | VideoPart | DocumentPart;++/**++ * Replaces the agent state wholesale. Sent when a delta cannot express the change, or to resynchronise a consumer.++ */++export type StateSnapshotEvent = BaseEvent &++ Attributable & {++ type: "STATE_SNAPSHOT";++ /**++ * The complete new state.++ */++ snapshot: {++ [k: string]: unknown | undefined;++ };++ };++/**++ * Changes the agent state incrementally.++ */++export type StateDeltaEvent = BaseEvent &++ Attributable & {++ type: "STATE_DELTA";++ delta: JsonPatch;++ };++/**++ * A single RFC 6902 operation. Exactly one of the operation shapes must match, discriminated by op. Unlike the protocol's own objects, the operations are open: RFC 6902 section 4 requires members an operation does not define to be ignored rather than rejected, so a remove carrying a leftover value is a valid patch. Two of the RFC's rules are relations between values rather than shapes, so no static schema can express them and neither is checked here: a move whose from is a proper prefix of its path (section 4.4), and any operation whose pointer does not resolve in the target document. Both are the applier's to reject.++ */++export type JsonPatchOperation =++ AddOperation | RemoveOperation | ReplaceOperation | MoveOperation | CopyOperation | TestOperation;++/**++ * The change, as an RFC 6902 patch against the current state. Structural validity here does not mean the patch applies: a well-formed operation may point at a path that does not exist, which RFC 6902 leaves to the applier.++ */++export type JsonPatch = JsonPatchOperation[];++/**++ * The complete set of messages the producer owns, in order. Conversation-wide rather than a plain overwrite: a consumer may keep messages of its own that no producer tracks, so exactly how a snapshot reconciles with those is behavioural and belongs in the prose. Being conversation-wide it cannot belong to a single subagent, so it carries no attribution; it does establish which subagent owns each message it contains, through the messages themselves.++ */++export type MessagesSnapshotEvent = BaseEvent & {++ type: "MESSAGES_SNAPSHOT";++ /**++ * The messages the producer is declaring, in order.++ */++ messages: Message[];++};++/**++ * Any message in a conversation. Discriminated by role.++ */++export type Message =++ DeveloperMessage | SystemMessage | AssistantMessage | UserMessage | ToolMessage | ActivityMessage | ReasoningMessage;++/**++ * Instructions from the application developer.++ */++export type DeveloperMessage = BaseMessage & {++ role: "developer";++ /**++ * The instructions. Required: a developer message with nothing in it says nothing.++ */++ content: string;++};++/**++ * The fields shared by the developer, system, assistant and user messages. Deliberately excludes content, because a user message's content may be an array while the others are strings, and composition here intersects rather than overrides: a base that constrained content to a string would make an array content invalid. The tool, activity and reasoning messages do not compose this, because they carry no name.++ */++export type BaseMessage = Attributable & {++ /**++ * Identifies the message within the conversation.++ */++ id: string;++ /**++ * Who the message is from. Each message definition narrows this to a single value.++ */++ role: string;++ /**++ * An optional display name for the author.++ */++ name?: string;++ /**++ * A provider's opaque artefact belonging to this message, stored by a consumer and returned on a later turn.++ */++ encryptedValue?: string;++ metadata?: Metadata1;++};++/**++ * Instructions from the system.++ */++export type SystemMessage = BaseMessage & {++ role: "system";++ /**++ * The instructions. Required.++ */++ content: string;++};++/**++ * A message from the agent. Content is optional because a turn may consist only of tool calls.++ */++export type AssistantMessage = BaseMessage & {++ role: "assistant";++ /**++ * What the agent said, if it said anything.++ */++ content?: string;++ /**++ * The tool calls this turn made.++ */++ toolCalls?: ToolCall[];++};++/**++ * A message from the person using the application.++ */++export type UserMessage = BaseMessage & {++ role: "user";++ /**++ * What the person sent: either plain text, or an ordered list of parts for a multimodal message.++ */++ content: string | ContentPart[];++};++/**++ * What a tool returned, as a message in the conversation. Stands alone rather than composing BaseMessage, because it carries no name.++ */++export type ToolMessage = Attributable & {++ /**++ * Identifies the message.++ */++ id: string;++ /**++ * Fixed. Declared here rather than inherited, because this message does not compose BaseMessage.++ */++ role: "tool";++ /**++ * What the tool returned: either plain text, or an ordered list of parts. A tool returning structured data serialises it into text; media travel as parts of their own.++ */++ content: string | ContentPart[];++ /**++ * The call this answers.++ */++ toolCallId: string;++ /**++ * Why the tool failed, when it did. Present alongside content rather than instead of it, so a partial result survives a failure.++ */++ error?: string;++ /**++ * A provider's opaque artefact belonging to this message.++ */++ encryptedValue?: string;++ metadata?: Metadata3;++};++/**++ * Structured progress that is not conversation content, materialised as a message so it keeps its place in the sequence. Stands alone rather than composing BaseMessage, because its content is an object rather than a string.++ */++export type ActivityMessage = Attributable & {++ /**++ * Identifies the message.++ */++ id: string;++ /**++ * Fixed. Declared here rather than inherited, because this message does not compose BaseMessage.++ */++ role: "activity";++ /**++ * What kind of activity this is. An open string: the set is the producer's.++ */++ activityType: string;++ /**++ * The activity's payload, open by key.++ */++ content: {++ [k: string]: unknown | undefined;++ };++ metadata?: Metadata4;++};++/**++ * A span of the agent's reasoning, materialised as a message. Stands alone rather than composing BaseMessage, because it carries no name.++ */++export type ReasoningMessage = Attributable & {++ /**++ * Identifies the message.++ */++ id: string;++ /**++ * Fixed. Declared here rather than inherited, because this message does not compose BaseMessage.++ */++ role: "reasoning";++ /**++ * The reasoning text.++ */++ content: string;++ /**++ * A provider's opaque reasoning artefact belonging to this message.++ */++ encryptedValue?: string;++ metadata?: Metadata5;++};++/**++ * Reports structured progress that is not conversation content, such as a step a UI renders as its own widget.++ */++export type ActivitySnapshotEvent = BaseEvent &++ Attributable & {++ type: "ACTIVITY_SNAPSHOT";++ /**++ * The activity message this describes.++ */++ messageId: string;++ /**++ * What kind of activity this is. An open string: the set is the producer's, not the protocol's.++ */++ activityType: string;++ /**++ * The activity's payload, open by key.++ */++ content: {++ [k: string]: unknown | undefined;++ };++ /**++ * Whether this snapshot overwrites the activity's existing content. Absent means it does, and that meaning is normative; only an explicit false asks a consumer to leave what is already there. It does not ask for a merge — ACTIVITY_DELTA is how content is changed incrementally. What a consumer does with a non-overwriting snapshot is behavioural and belongs in the prose.++ */++ replace?: boolean;++ };++/**++ * Changes an activity message's content incrementally.++ */++export type ActivityDeltaEvent = BaseEvent &++ Attributable & {++ type: "ACTIVITY_DELTA";++ /**++ * The activity message being changed.++ */++ messageId: string;++ /**++ * What kind of activity this is.++ */++ activityType: string;++ patch: JsonPatch1;++ };++/**++ * The change, as an RFC 6902 patch against the activity's content.++ */++export type JsonPatch1 = JsonPatchOperation[];++/**++ * Passes a provider-native event through untranslated, for consumers that need detail the protocol does not model.++ */++export type RawEvent = BaseEvent &++ Attributable & {++ type: "RAW";++ /**++ * The provider's own event. Any JSON value, and required: an event whose only purpose is to carry this would say nothing without it.++ */++ event: {++ [k: string]: unknown | undefined;++ };++ /**++ * Which provider or framework the event came from.++ */++ source?: string;++ };++/**++ * The protocol's extension point for an application's own events. Anything a consumer does with one is outside the protocol.++ */++export type CustomEvent = BaseEvent &++ Attributable & {++ type: "CUSTOM";++ /**++ * What this custom event is. Required: without it a consumer cannot route the value.++ */++ name: "ov.sources" | "ov.handoff" | "ov.approval" | "ov.result";++ /**++ * The payload. Any JSON value, and required.++ */++ value: {++ [k: string]: unknown | undefined;++ };++ };++/**++ * Opens a run. Run-scoped, so it carries no subagent attribution.++ */++export type RunStartedEvent = BaseEvent & {++ type: "RUN_STARTED";++ /**++ * The conversation this run belongs to.++ */++ threadId: string;++ /**++ * Identifies this run.++ */++ runId: string;++ /**++ * The protocol version this producer speaks, such as "1.0" — the producer's own version, not an echo of the input's, which is what makes the pair a negotiation: each side declares itself and the consumer sees a downgrade the moment it happens. Absent means a producer from before the protocol carried a version.++ */++ protocolVersion?: string;++ /**++ * The run that spawned this one, when an agent invokes another agent as a separate run rather than as a subagent within one.++ */++ parentRunId?: string;++ input?: RunAgentInput;++};++/**++ * Closes a run that did not fail. Run-scoped, so it carries no subagent attribution.++ */++export type RunFinishedEvent = BaseEvent & {++ type: "RUN_FINISHED";++ /**++ * The conversation this run belongs to.++ */++ threadId: string;++ /**++ * The run being closed.++ */++ runId: string;++ /**++ * The run's return value, if it has one. Any JSON value.++ */++ result?: {++ [k: string]: unknown | undefined;++ };++ /**++ * Why the run ended. Absent means success, so every producer written before outcomes existed is already conformant.++ */++ outcome?: RunFinishedSuccessOutcome | RunFinishedInterruptOutcome | RunFinishedCancelledOutcome;++ /**++ * Token usage for the run, one entry per provider and model, so a run that invoked several models keeps them separate. A consumer that only wants totals sums across the entries. The run is the accounting boundary: usage covers every model call made within the run, calls made by its subagents included; an agent invoked as a separate run under parentRunId reports its own usage on its own terminal event; and a run that resumes an interrupted one reports only the calls it made itself, not the interrupted run's.++ */++ usage?: TokenUsage[];++};++/**++ * Something a run needs from outside before it can continue, such as an approval or a missing value.++ */++export type Interrupt = Attributable & {++ /**++ * Identifies the interrupt. A resume entry answers it by this id.++ */++ id: string;++ /**++ * Why the run stopped. An open string rather than an enumeration: the protocol does not attempt to classify every reason an agent might need input.++ */++ reason: string;++ /**++ * A human-readable prompt for whoever answers.++ */++ message?: string;++ /**++ * The tool call this interrupt concerns, when it is a tool approval.++ */++ toolCallId?: string;++ /**++ * A JSON Schema describing the answer this interrupt expects, so a consumer can build a form for it. Carried opaquely: the protocol does not constrain or validate it. Restricted to an object because TypeScript and Python both declare it that way; .NET holds it as any JSON, and the ticket that commissioned this schema lists it among the arbitrary-JSON fields. Following the two that constrain it keeps the schema from accepting documents the reference client rejects, at the cost of rejecting the boolean schemas JSON Schema also permits — a bare true for "any answer". Recorded as a known divergence rather than settled.++ */++ responseSchema?: {++ [k: string]: unknown | undefined;++ };++ /**++ * When the interrupt stops being answerable. Deliberately unconstrained rather than a date-time format, because producers already disagree about the representation and tightening it here would reject streams that work today. The documented convention is ISO 8601, and a consumer comparing this value will parse it as a date, so a value that is not one leaves the interrupt looking permanently unexpired.++ */++ expiresAt?: string;++ metadata?: Metadata8;++} & {++ /**++ * Identifies the interrupt. A resume entry answers it by this id.++ */++ id: string;++ /**++ * Why the run stopped. An open string rather than an enumeration: the protocol does not attempt to classify every reason an agent might need input.++ */++ reason: string;++ /**++ * A human-readable prompt for whoever answers.++ */++ message?: string;++ /**++ * The tool call this interrupt concerns, when it is a tool approval.++ */++ toolCallId?: string;++ /**++ * A JSON Schema describing the answer this interrupt expects, so a consumer can build a form for it. Carried opaquely: the protocol does not constrain or validate it. Restricted to an object because TypeScript and Python both declare it that way; .NET holds it as any JSON, and the ticket that commissioned this schema lists it among the arbitrary-JSON fields. Following the two that constrain it keeps the schema from accepting documents the reference client rejects, at the cost of rejecting the boolean schemas JSON Schema also permits — a bare true for "any answer". Recorded as a known divergence rather than settled.++ */++ responseSchema?: {++ [k: string]: unknown | undefined;++ };++ /**++ * When the interrupt stops being answerable. Deliberately unconstrained rather than a date-time format, because producers already disagree about the representation and tightening it here would reject streams that work today. The documented convention is ISO 8601, and a consumer comparing this value will parse it as a date, so a value that is not one leaves the interrupt looking permanently unexpired.++ */++ expiresAt?: string;++ metadata?: Metadata8;++};++/**++ * Ends a run that failed. Run-scoped, so it carries no subagent attribution; a subagent that fails without ending the run reports SUBAGENT_ERROR instead.++ */++export type RunErrorEvent = BaseEvent & {++ type: "RUN_ERROR";++ /**++ * What went wrong, for a person to read.++ */++ message: string;++ /**++ * A machine-readable error code. An open string: the protocol defines no vocabulary.++ */++ code?: string;++ /**++ * Token usage accrued before the failure, for a run that completed one or more model calls before dying. Scoped as on RUN_FINISHED: the run's own calls, subagents included.++ */++ usage?: TokenUsage[];++};++/**++ * Opens a named step within a run, for producers whose frameworks have a step concept worth surfacing.++ */++export type StepStartedEvent = BaseEvent &++ Attributable & {++ type: "STEP_STARTED";++ /**++ * The step's name. Identifies it: the matching STEP_FINISHED carries the same name.++ */++ stepName: string;++ };++/**++ * Closes a named step.++ */++export type StepFinishedEvent = BaseEvent &++ Attributable & {++ type: "STEP_FINISHED";++ /**++ * The step being closed.++ */++ stepName: string;++ };++/**++ * Opens a span of reasoning. A span may contain several reasoning messages.++ */++export type ReasoningStartEvent = BaseEvent &++ Attributable & {++ type: "REASONING_START";++ /**++ * The span being opened.++ */++ messageId: string;++ };++/**++ * Opens a streamed reasoning message.++ */++export type ReasoningMessageStartEvent = BaseEvent &++ Attributable & {++ type: "REASONING_MESSAGE_START";++ /**++ * The reasoning message this stream builds.++ */++ messageId: string;++ /**++ * Fixed, and required rather than defaulted. The requirement is inherited from the SDKs rather than chosen.++ */++ role: "reasoning";++ };++/**++ * Appends a fragment to a streamed reasoning message.++ */++export type ReasoningMessageContentEvent = BaseEvent &++ Attributable & {++ type: "REASONING_MESSAGE_CONTENT";++ /**++ * The reasoning message this fragment belongs to.++ */++ messageId: string;++ /**++ * The fragment to append. May be the empty string.++ */++ delta: string;++ };++/**++ * Closes a streamed reasoning message.++ */++export type ReasoningMessageEndEvent = BaseEvent &++ Attributable & {++ type: "REASONING_MESSAGE_END";++ /**++ * The reasoning message being closed.++ */++ messageId: string;++ };++/**++ * A shorthand that stands in for a reasoning message's start, content and end sequence.++ */++export type ReasoningMessageChunkEvent = BaseEvent &++ Attributable & {++ type: "REASONING_MESSAGE_CHUNK";++ /**++ * The reasoning message this chunk belongs to. Absent continues the one already open.++ */++ messageId?: string;++ /**++ * The fragment to append. May be the empty string.++ */++ delta?: string;++ };++/**++ * Closes a span of reasoning.++ */++export type ReasoningEndEvent = BaseEvent &++ Attributable & {++ type: "REASONING_END";++ /**++ * The span being closed.++ */++ messageId: string;++ };++/**++ * Carries a provider's opaque, encrypted reasoning artefact, which a consumer stores and returns on a later turn without being able to read it.++ */++export type ReasoningEncryptedValueEvent = BaseEvent &++ Attributable & {++ type: "REASONING_ENCRYPTED_VALUE";++ /**++ * What kind of thing entityId names, which decides where the value is stored.++ */++ subtype: "tool-call" | "message";++ /**++ * What the value belongs to: a message id or a tool call id, according to subtype.++ */++ entityId: string;++ /**++ * The provider's opaque artefact.++ */++ encryptedValue: string;++ };++/**++ * Announces that a subagent invocation has begun. Everything the subagent produces afterwards is attributed by carrying its subagentRunId, so a consumer can group the work without replaying the stream. Composed from BaseEvent alone rather than Attributable, because here subagentRunId identifies the subagent rather than attributing the event to one; attribution to an enclosing subagent is parentSubagentRunId.++ */++export type SubagentStartedEvent = BaseEvent & {++ type: "SUBAGENT_STARTED";++ /**++ * The invocation being announced.++ */++ subagentRunId: string;++ /**++ * The subagent's name, which is reusable across invocations, unlike subagentRunId.++ */++ name: string;++ /**++ * What this subagent is for, for a consumer to display.++ */++ description?: string;++ /**++ * The subagent invocation that spawned this one, for nested delegation. Absent means the parent agent spawned it directly.++ */++ parentSubagentRunId?: string;++ /**++ * The tool call that spawned this subagent, for the pattern where agents are exposed to a model as tools. Lets a consumer tie the subagent to the call without reading rawEvent.++ */++ parentToolCallId?: string;++ /**++ * The message that held the spawning tool call.++ */++ parentMessageId?: string;++};++/**++ * Ends a subagent invocation's segment of this run, either because the work completed or because it is suspended awaiting outside input.++ */++export type SubagentFinishedEvent = BaseEvent & {++ type: "SUBAGENT_FINISHED";++ /**++ * The invocation being closed.++ */++ subagentRunId: string;++ /**++ * The subagent's return value, if it has one. Any JSON value, mirroring RUN_FINISHED.result.++ */++ result?: {++ [k: string]: unknown | undefined;++ };++ /**++ * Why the segment ended. Absent means success. A suspended subagent is neither a success nor a failure, which is why saying so needs its own value rather than being inferred from a later interrupt.++ */++ outcome?: SubagentFinishedSuccessOutcome | SubagentFinishedSuspendedOutcome;++};++/**++ * Reports that a subagent invocation failed. The run may continue: a parent agent is free to handle a failed subagent, which is why this is not RUN_ERROR.++ */++export type SubagentErrorEvent = BaseEvent & {++ type: "SUBAGENT_ERROR";++ /**++ * The invocation that failed.++ */++ subagentRunId: string;++ /**++ * What went wrong, for a person to read.++ */++ message: string;++ /**++ * A machine-readable error code. An open string.++ */++ code?: string;++};++++/**++ * The fields every event carries, whatever its type. Composed into each event definition rather than repeated, so a change here reaches every event at once.++ */++export interface BaseEvent {++ /**++ * Which event this is. Each event definition narrows this to a single value.++ */++ type:++ | "TEXT_MESSAGE_START"++ | "TEXT_MESSAGE_CONTENT"++ | "TEXT_MESSAGE_END"++ | "TEXT_MESSAGE_CHUNK"++ | "TOOL_CALL_START"++ | "TOOL_CALL_ARGS"++ | "TOOL_CALL_END"++ | "TOOL_CALL_CHUNK"++ | "TOOL_CALL_RESULT"++ | "STATE_SNAPSHOT"++ | "STATE_DELTA"++ | "MESSAGES_SNAPSHOT"++ | "ACTIVITY_SNAPSHOT"++ | "ACTIVITY_DELTA"++ | "RAW"++ | "CUSTOM"++ | "RUN_STARTED"++ | "RUN_FINISHED"++ | "RUN_ERROR"++ | "STEP_STARTED"++ | "STEP_FINISHED"++ | "REASONING_START"++ | "REASONING_MESSAGE_START"++ | "REASONING_MESSAGE_CONTENT"++ | "REASONING_MESSAGE_END"++ | "REASONING_MESSAGE_CHUNK"++ | "REASONING_END"++ | "REASONING_ENCRYPTED_VALUE"++ | "SUBAGENT_STARTED"++ | "SUBAGENT_FINISHED"++ | "SUBAGENT_ERROR";++ /**++ * When the event was created. Bounded to the range JSON numbers survive a round trip in, so the value a consumer reads is the value the producer wrote. Deliberately not a float. The unit is not constrained here, because it never has been stated normatively; every SDK that sets it in practice uses milliseconds since the Unix epoch, and a producer choosing another unit will be misread by consumers even though it validates. Nothing in the protocol computes with this value.++ */++ timestamp?: number;++ /**++ * The provider-native event this one was translated from, carried verbatim for debugging and for consumers that need detail the protocol does not model. Any JSON value.++ */++ rawEvent?: {++ [k: string]: unknown | undefined;++ };++ metadata?: Metadata;++}++/**++ * Extra information attached to this event.++ */++export interface Metadata {++ ov?: {++ title?: string;++ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";++ sources?: OvSource[];++ attachments?: {++ [k: string]: unknown | undefined;++ }[];++ cost_usd?: number | null;++ needs_you?: {++ id: string;++ question: string;++ /**++ * @minItems 1++ */++ actions: [unknown, ...unknown[]];++ } | null;++ product?: string;++ ref?: string | null;++ };++ [k: string]: unknown | undefined;++}++export interface OvSource {++ url: string;++ title: string;++ site: string;++}++/**++ * Composed into everything that can belong to a subagent's work: the events that describe content or progress, the message types, and each interrupt. Run-scoped events omit it — RUN_STARTED, RUN_FINISHED and RUN_ERROR describe the run itself and MESSAGES_SNAPSHOT is conversation-wide, so none of them can belong to one subagent. A tool call omits it too and inherits its containing message's attribution.++ */++export interface Attributable {++ /**++ * The subagent invocation this belongs to. Absent means the parent agent produced it directly.++ */++ subagentRunId?: string;++}++/**++ * A text part.++ */++export interface TextPart {++ /**++ * Discriminator.++ */++ type: "text";++ /**++ * Identifies this part within its message. Optional, and nothing reads it yet: reserved so that a streamed part can be matched to its entry in history once assistant messages carry parts too.++ */++ id?: string;++ /**++ * The text.++ */++ text: string;++ /**++ * Extra information about this part. Unconstrained, as on the media parts. This is where a text search hit carries its source and title, rather than the protocol modelling a search-result part of its own.++ */++ metadata?: {++ [k: string]: unknown | undefined;++ };++}++/**++ * An image part.++ */++export interface ImagePart {++ /**++ * Discriminator.++ */++ type: "image";++ /**++ * Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part.++ */++ id?: string;++ /**++ * Where the image comes from.++ */++ source: DataSource | UrlSource | FileSource;++ /**++ * Extra information about this part. Unconstrained rather than an object: inherited from the SDKs, which declare it unknown rather than a record; listed under known divergences in the README rather than resolved here.++ */++ metadata?: {++ [k: string]: unknown | undefined;++ };++}++/**++ * Bytes carried inline.++ */++export interface DataSource {++ /**++ * Discriminator.++ */++ type: "data";++ /**++ * The bytes, base64-encoded. contentEncoding is an annotation rather than a constraint in 2020-12, so a malformed string still validates here; rejecting one is the decoder's job.++ */++ value: string;++ /**++ * What the bytes are. Required here, unlike on a URL source, because nothing else can tell a consumer how to read them.++ */++ mimeType: string;++}++/**++ * Bytes referenced by URL, fetched by whoever needs them.++ */++export interface UrlSource {++ /**++ * Discriminator.++ */++ type: "url";++ /**++ * The URL. Deliberately not constrained to a URI format, so a scheme a producer already uses is not rejected here.++ */++ value: string;++ /**++ * What the resource is, when the producer knows. Optional, because the response can say.++ */++ mimeType?: string;++}++/**++ * Bytes already at the provider, named by a handle the provider issued: an OpenAI or Anthropic file id, a Gemini file URI, a storage URL only that provider can read. No bytes travel and nothing is fetched. Only the provider that minted the handle can resolve it; a peer that cannot drops the part as it drops any part it cannot use.++ */++export interface FileSource {++ /**++ * Discriminator.++ */++ type: "file";++ /**++ * The handle, exactly as the provider issued it. Opaque: a consumer MUST NOT fetch it, parse it or read a scheme out of it.++ */++ value: string;++ /**++ * Who issued the handle, when the producer knows. Optional: an agent already knows which provider it talks to. When present, SHOULD be the lowercase vendor id (openai, anthropic, google) that TokenUsage.provider uses, so a peer can tell before sending whether a handle is one it can use.++ */++ provider?: string;++ /**++ * What the file is, when the producer knows. Optional, because the provider that holds the bytes knows.++ */++ mimeType?: string;++}++/**++ * An audio part.++ */++export interface AudioPart {++ /**++ * Discriminator.++ */++ type: "audio";++ /**++ * Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part.++ */++ id?: string;++ /**++ * Where the audio comes from.++ */++ source: DataSource | UrlSource | FileSource;++ /**++ * Extra information about this part. Unconstrained, as on the other media parts.++ */++ metadata?: {++ [k: string]: unknown | undefined;++ };++}++/**++ * A video part.++ */++export interface VideoPart {++ /**++ * Discriminator.++ */++ type: "video";++ /**++ * Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part.++ */++ id?: string;++ /**++ * Where the video comes from.++ */++ source: DataSource | UrlSource | FileSource;++ /**++ * Extra information about this part. Unconstrained, as on the other media parts.++ */++ metadata?: {++ [k: string]: unknown | undefined;++ };++}++/**++ * A document part.++ */++export interface DocumentPart {++ /**++ * Discriminator.++ */++ type: "document";++ /**++ * Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part.++ */++ id?: string;++ /**++ * Where the document comes from.++ */++ source: DataSource | UrlSource | FileSource;++ /**++ * Extra information about this part. Unconstrained, as on the other media parts.++ */++ metadata?: {++ [k: string]: unknown | undefined;++ };++}++/**++ * Inserts value at path. RFC 6902 section 4.1.++ */++export interface AddOperation {++ /**++ * Discriminator for the add operation.++ */++ op: "add";++ /**++ * Where to insert the value.++ */++ path: string;++ /**++ * The value to insert. Any JSON value, including null, which is a legitimate thing to add.++ */++ value: {++ [k: string]: unknown | undefined;++ };++}++/**++ * Removes the value at path. RFC 6902 section 4.2.++ */++export interface RemoveOperation {++ /**++ * Discriminator for the remove operation.++ */++ op: "remove";++ /**++ * What to remove.++ */++ path: string;++}++/**++ * Replaces the value at path. RFC 6902 section 4.3.++ */++export interface ReplaceOperation {++ /**++ * Discriminator for the replace operation.++ */++ op: "replace";++ /**++ * What to replace.++ */++ path: string;++ /**++ * The replacement. Any JSON value, including null.++ */++ value: {++ [k: string]: unknown | undefined;++ };++}++/**++ * Moves the value at from to path. RFC 6902 section 4.4.++ */++export interface MoveOperation {++ /**++ * Discriminator for the move operation.++ */++ op: "move";++ /**++ * Where the value is moved from.++ */++ from: string;++ /**++ * Where the value is moved to.++ */++ path: string;++}++/**++ * Copies the value at from to path. RFC 6902 section 4.5.++ */++export interface CopyOperation {++ /**++ * Discriminator for the copy operation.++ */++ op: "copy";++ /**++ * Where the value is copied from.++ */++ from: string;++ /**++ * Where the value is copied to.++ */++ path: string;++}++/**++ * Asserts that the value at path equals value. RFC 6902 section 4.6.++ */++export interface TestOperation {++ /**++ * Discriminator for the test operation.++ */++ op: "test";++ /**++ * What to compare.++ */++ path: string;++ /**++ * The value the target must equal. Any JSON value, including null.++ */++ value: {++ [k: string]: unknown | undefined;++ };++}++/**++ * Extra information attached to this message.++ */++export interface Metadata1 {++ ov?: {++ title?: string;++ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";++ sources?: OvSource[];++ attachments?: {++ [k: string]: unknown | undefined;++ }[];++ cost_usd?: number | null;++ needs_you?: {++ id: string;++ question: string;++ /**++ * @minItems 1++ */++ actions: [unknown, ...unknown[]];++ } | null;++ product?: string;++ ref?: string | null;++ };++ [k: string]: unknown | undefined;++}++/**++ * A call an assistant message made. Carries no subagent attribution of its own and inherits its containing message's, since several calls can share one parent.++ */++export interface ToolCall {++ /**++ * Identifies the call. The answering tool message carries this as its toolCallId.++ */++ id: string;++ /**++ * The only kind of call the protocol models.++ */++ type: "function";++ function: FunctionCall;++ /**++ * A provider's opaque artefact belonging to this call.++ */++ encryptedValue?: string;++ metadata?: Metadata2;++}++/**++ * What is being called, and with what.++ */++export interface FunctionCall {++ /**++ * Which tool is being called.++ */++ name: string;++ /**++ * The arguments as a JSON string, not as parsed JSON. Kept as written because a model can emit arguments that are not valid JSON, and losing them at the protocol boundary would hide the fault from the consumer that has to handle it.++ */++ arguments: string;++}++/**++ * Extra information attached to this call. Carried here rather than folded into the containing message, because several calls can share one parent and merging them would make the result depend on their order.++ */++export interface Metadata2 {++ ov?: {++ title?: string;++ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";++ sources?: OvSource[];++ attachments?: {++ [k: string]: unknown | undefined;++ }[];++ cost_usd?: number | null;++ needs_you?: {++ id: string;++ question: string;++ /**++ * @minItems 1++ */++ actions: [unknown, ...unknown[]];++ } | null;++ product?: string;++ ref?: string | null;++ };++ [k: string]: unknown | undefined;++}++/**++ * Extra information attached to this message.++ */++export interface Metadata3 {++ ov?: {++ title?: string;++ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";++ sources?: OvSource[];++ attachments?: {++ [k: string]: unknown | undefined;++ }[];++ cost_usd?: number | null;++ needs_you?: {++ id: string;++ question: string;++ /**++ * @minItems 1++ */++ actions: [unknown, ...unknown[]];++ } | null;++ product?: string;++ ref?: string | null;++ };++ [k: string]: unknown | undefined;++}++/**++ * Extra information attached to this message.++ */++export interface Metadata4 {++ ov?: {++ title?: string;++ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";++ sources?: OvSource[];++ attachments?: {++ [k: string]: unknown | undefined;++ }[];++ cost_usd?: number | null;++ needs_you?: {++ id: string;++ question: string;++ /**++ * @minItems 1++ */++ actions: [unknown, ...unknown[]];++ } | null;++ product?: string;++ ref?: string | null;++ };++ [k: string]: unknown | undefined;++}++/**++ * Extra information attached to this message.++ */++export interface Metadata5 {++ ov?: {++ title?: string;++ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";++ sources?: OvSource[];++ attachments?: {++ [k: string]: unknown | undefined;++ }[];++ cost_usd?: number | null;++ needs_you?: {++ id: string;++ question: string;++ /**++ * @minItems 1++ */++ actions: [unknown, ...unknown[]];++ } | null;++ product?: string;++ ref?: string | null;++ };++ [k: string]: unknown | undefined;++}++/**++ * The request this run was started from, echoed back so a consumer that did not make the request can still see what the agent was asked.++ */++export interface RunAgentInput {++ /**++ * The conversation this run belongs to.++ */++ threadId: string;++ /**++ * Identifies this run.++ */++ runId: string;++ /**++ * The protocol version this consumer speaks, such as "1.0". Absent means the input was produced before the protocol carried a version — the versioning rules in the prose govern what each side does with that. Sent in-band rather than by the transport, so a recorded exchange stays self-describing.++ */++ protocolVersion?: string;++ /**++ * The run that spawned this one.++ */++ parentRunId?: string;++ /**++ * The state the run starts from.++ */++ state?: {++ [k: string]: unknown | undefined;++ };++ /**++ * The conversation so far, in order.++ */++ messages: Message[];++ /**++ * The tools the agent may call. Absent means none.++ */++ tools?: Tool[];++ /**++ * Ambient information for the run. Absent means none.++ */++ context?: Context[];++ /**++ * Application-specific values passed through to the agent untouched. Any JSON value.++ */++ forwardedProps?: {++ [k: string]: unknown | undefined;++ };++ /**++ * Answers to the interrupts that ended a previous run, when this run continues from one.++ */++ resume?: ResumeEntry[];++}++/**++ * A tool the agent may call.++ */++export interface Tool {++ /**++ * The tool's name, as the agent will call it.++ */++ name: string;++ /**++ * What the tool does, for the agent to decide when to use it.++ */++ description: string;++ /**++ * A JSON Schema describing the tool's arguments. Carried opaquely: the protocol does not constrain or validate it. Optional, because all three SDKs already treat it that way and a tool that takes no arguments has nothing to declare; an absent schema and an empty one mean the same thing to an agent.++ */++ parameters?: {++ [k: string]: unknown | undefined;++ };++ metadata?: Metadata6;++}++/**++ * Extra information about the tool, for consumers that attach their own rendering or routing information to it.++ */++export interface Metadata6 {++ ov?: {++ title?: string;++ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";++ sources?: OvSource[];++ attachments?: {++ [k: string]: unknown | undefined;++ }[];++ cost_usd?: number | null;++ needs_you?: {++ id: string;++ question: string;++ /**++ * @minItems 1++ */++ actions: [unknown, ...unknown[]];++ } | null;++ product?: string;++ ref?: string | null;++ };++ [k: string]: unknown | undefined;++}++/**++ * A named piece of ambient information given to the agent for the run, distinct from the conversation.++ */++export interface Context {++ /**++ * What this context is, for the agent to interpret.++ */++ description: string;++ /**++ * The context itself.++ */++ value: string;++}++/**++ * An answer to one interrupt, sent on the run that continues from it.++ */++export interface ResumeEntry {++ /**++ * The interrupt being answered.++ */++ interruptId: string;++ /**++ * Whether the interrupt was answered or abandoned.++ */++ status: "resolved" | "cancelled";++ /**++ * The answer the agent asked for and will act on. Any JSON value.++ */++ payload?: {++ [k: string]: unknown | undefined;++ };++ metadata?: Metadata7;++}++/**++ * Envelope information about the response, such as signatures or routing keys, as opposed to payload, which is the answer itself.++ */++export interface Metadata7 {++ ov?: {++ title?: string;++ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";++ sources?: OvSource[];++ attachments?: {++ [k: string]: unknown | undefined;++ }[];++ cost_usd?: number | null;++ needs_you?: {++ id: string;++ question: string;++ /**++ * @minItems 1++ */++ actions: [unknown, ...unknown[]];++ } | null;++ product?: string;++ ref?: string | null;++ };++ [k: string]: unknown | undefined;++}++/**++ * The run completed. Equivalent to an absent outcome. Closed like every other object, which is also what keeps it from carrying the suspended sibling's interrupts — a success with an interrupt still pending would be a contradiction, not an extension. A completed run may still have left frontend tool calls for the application to answer; pendingToolCallIds names them.++ */++export interface RunFinishedSuccessOutcome {++ /**++ * Discriminator.++ */++ type: "success";++ /**++ * The tool calls this run started and left unanswered — no TOOL_CALL_RESULT in the run — for the application to answer in the next input's messages, in the order they were made. Absent or empty means the producer named none, and a consumer derives the list from the stream; otherwise it is the list, and it agrees with the stream. On the success outcome rather than the event because a run that stopped on a frontend tool call is a completed run: whether the application continues the thread is its own decision, so the producer reports what it knows and no more.++ */++ pendingToolCallIds?: string[];++}++/**++ * The run is paused, waiting for something outside it. Resuming means starting a new run whose resume entries answer these interrupts.++ */++export interface RunFinishedInterruptOutcome {++ /**++ * Discriminator.++ */++ type: "interrupt";++ /**++ * What the run is waiting for. At least one: an interrupt outcome with nothing to answer would leave a consumer with nothing to do.++ *++ * @minItems 1++ */++ interrupts: [Interrupt, ...Interrupt[]];++}++/**++ * Extra information attached to this interrupt.++ */++export interface Metadata8 {++ ov?: {++ title?: string;++ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";++ sources?: OvSource[];++ attachments?: {++ [k: string]: unknown | undefined;++ }[];++ cost_usd?: number | null;++ needs_you?: {++ id: string;++ question: string;++ /**++ * @minItems 1++ */++ actions: [unknown, ...unknown[]];++ } | null;++ product?: string;++ ref?: string | null;++ };++ [k: string]: unknown | undefined;++}++/**++ * The run was stopped before it completed, by whoever was running it, and did not fail. Neither success nor interrupt: nothing was produced as a result, and nothing is waited for, so the next run on the thread is an ordinary new run rather than a resume. Closed like its siblings: a cancelled run has no interrupts to carry. Named in the schema before 1.0 because an outcome a consumer does not recognise is stripped and read as success — a cancellation added later would reach every 1.0 consumer as a completed run.++ */++export interface RunFinishedCancelledOutcome {++ /**++ * Discriminator.++ */++ type: "cancelled";++}++/**++ * Token counts for one provider and model, in the protocol's own accounting: every count is either a total or a named part of one, so entries from different providers add up without double-counting. inputTokens and outputTokens are the totals; reasoningTokens, cachedInputTokens and cacheWriteInputTokens are parts of them, never additions to them; totalTokens is the two totals summed. Every field is a label or a number — nothing content-bearing or identifying, no prompts, completions, messages, or thread, run and user identifiers.++ */++export interface TokenUsage {++ /**++ * Which provider served the request.++ */++ provider?: string;++ /**++ * Which model served the request.++ */++ model?: string;++ /**++ * Every prompt token the call was charged for: tokens read from a provider cache, tokens written to one, and audio or other non-text input all count here. cachedInputTokens and cacheWriteInputTokens break this number down and are never added to it — a provider that reports its cache counts beside a smaller input count has them added in by the producer before the entry leaves. Bounded like timestamp and for the same reason: a count above the JSON safe-integer range does not survive a round trip, so a consumer would silently read a different number than the producer wrote.++ */++ inputTokens?: number;++ /**++ * Every generated token, reasoning included where the provider distinguishes it. reasoningTokens breaks this number down and is never added to it — a provider that reports reasoning tokens beside a smaller completion count has them added in by the producer.++ */++ outputTokens?: number;++ /**++ * inputTokens plus outputTokens, under the accounting above. A producer MAY compute it rather than copy a provider's total, and copies a provider's total only when that total counts the same way, so a consumer can read this field as the sum of the other two.++ */++ totalTokens?: number;++ /**++ * Output tokens spent on reasoning, where the provider distinguishes them. Part of outputTokens, not in addition to it.++ */++ reasoningTokens?: number;++ /**++ * Input tokens read from a provider cache. Part of inputTokens, not in addition to it, and disjoint from cacheWriteInputTokens.++ */++ cachedInputTokens?: number;++ /**++ * Input tokens written to a provider cache on this call, where the provider distinguishes them. Part of inputTokens, not in addition to it, and disjoint from cachedInputTokens. Its own field because providers price a cache write differently from a cache read, so a consumer computing cost cannot do without it.++ */++ cacheWriteInputTokens?: number;++}++/**++ * The subagent completed its work. Equivalent to an absent outcome.++ */++export interface SubagentFinishedSuccessOutcome {++ /**++ * Discriminator.++ */++ type: "success";++}++/**++ * The subagent is paused awaiting outside input. Terminal for this stream, not for the subagent: a later run may continue the same invocation once the interrupts are answered.++ */++export interface SubagentFinishedSuspendedOutcome {++ /**++ * Discriminator.++ */++ type: "suspended";++ /**++ * The run-level interrupts this subagent raised itself. May be empty or absent: a subagent suspended because a descendant interrupted owns no interrupt of its own.++ */++ interruptIds?: string[];++}++++/** [email protected] (owner: actor) */++/**++ * agent.run@1 snapshot of a run and its current plan, steps, sources, result, timestamps and cost.++ */++export interface AgentRun {++ id: string;++ product: string;++ title: string;++ status: "queued" | "running" | "waiting" | "needs_you" | "succeeded" | "failed" | "stopped" | "cancelled";++ plan: {++ title: string;++ status: "todo" | "running" | "waiting" | "needs_you" | "done" | "failed" | "stopped";++ }[];++ steps: {++ title: string;++ status: "todo" | "running" | "waiting" | "needs_you" | "done" | "failed" | "stopped";++ [k: string]: unknown | undefined;++ }[];++ sources: {++ url: string;++ title: string;++ site: string;++ }[];++ result: {} | null;++ started_at: string;++ ended_at: string | null;++ cost_usd: number | null;++}++++/** [email protected] (owner: actor) */++/**++ * actor.agent-sheet@1: one owner-scoped read of an Actor agent's current work, history, approvals, computer, schedules and memory. GET /api/v1/me/agents/:id?view=sheet; never cache this answer.++ */++export interface ActorAgentSheet {++ agent: {++ id: string;++ name: string;++ face: string | null;++ state: "working" | "idle" | "paused";++ instructions: string;++ voice: string | null;++ [k: string]: unknown | undefined;++ };++ now: null | {++ id: string;++ task: string;++ state: string;++ cost_usd: number;++ result?: unknown;++ computer?: unknown;++ [k: string]: unknown | undefined;++ };++ work: {++ id: string;++ task: string;++ state: string;++ cost_usd: number;++ result?: unknown;++ computer?: unknown;++ [k: string]: unknown | undefined;++ }[];++ asks: {++ id: string;++ state: string;++ what: string;++ why?: string | null;++ touch?: string | {} | null;++ [k: string]: unknown | undefined;++ }[];++ asks_empty: string | null;++ computer: null | {++ url?: string | null;++ open?: string | null;++ [k: string]: unknown | undefined;++ };++ schedules: {++ next_run_at?: string | null;++ last_run_at?: string | null;++ last_result?: string | null;++ [k: string]: unknown | undefined;++ }[];++ memory: {++ id: string;++ text: string;++ source?: string;++ [k: string]: unknown | undefined;++ }[];++ activity: {++ [k: string]: unknown | undefined;++ }[];++}++++/** [email protected] (owner: codes) */++/**++ * codes.agent-sheet@1: one owner's coding harness, its real attempts, outcomes and machine availability. Empty memory, schedule and computer sections mean Codes has no such per-harness records. GET /api/v1/me/agents/:id/sheet; never cache this answer.++ */++export interface CodesAgentSheet {++ agent: {++ id: string;++ name: string;++ face: null;++ state: string;++ kind: "coding harness";++ availability: {} | null;++ };++ now: null | {++ id: string;++ task_id: string;++ title: string;++ what: string | null;++ result: string | null;++ state: string;++ outcome: string | null;++ cost_usd: number | null;++ machine: string | null;++ repo: string | null;++ started_at: string;++ finished_at: string | null;++ url: string;++ };++ work: {++ id: string;++ task_id: string;++ title: string;++ what: string | null;++ result: string | null;++ state: string;++ outcome: string | null;++ cost_usd: number | null;++ machine: string | null;++ repo: string | null;++ started_at: string;++ finished_at: string | null;++ url: string;++ }[];++ activity: {++ day: string;++ entries: {}[];++ }[];++ /**++ * @maxItems 0++ */++ asks: [];++ asks_empty: string;++ computer: null;++ /**++ * @maxItems 0++ */++ schedules: [];++ /**++ * @maxItems 0++ */++ memory: [];++ identity: {++ provider: string | null;++ capabilities: {};++ };++}nnew file mode 100644@@@ -0,0 +1,16 @@++{++ "id": "chat.commands.register",++ "version": "1.0",++ "owner": "chat",++ "status": "active",++ "visibility": "public",++ "sensitive": true,++ "description": "Register a slash command in a Chat server where the person authorizing the app is an owner or admin. The Network service token names the approved app or agent in sub, names the person in on_behalf_of, and carries this granted capability. Chat stores the command under that app, refuses built-in names, and executes its plain response template by posting as the person who invoked it with that person's current room rights. This grant never lets an app post as someone else or perform moderation.",++ "permissions": ["chat:write"],++ "resourceConstraints": ["owner"],++ "quotaClass": "chat-write",++ "events": [],++ "implementedBy": ["POST /api/chat/commands/registered", "DELETE /api/chat/commands/registered/:name"],++ "inputSchema": "chat.command-registration-request@1",++ "outputSchema": "chat.command-registration-result@1"++}nnew file mode 100644@@@ -0,0 +1,82 @@++{++ "namespace": "live.layout",++ "owner": "live",++ "version": 1,++ "description": "Where this person put each picture-in-picture on OpenVibe.Live: per stream slot and source, the place, whether it is docked or floating, tucked to a side, muted, and when it last moved. Live keeps a browser copy too; this record follows the person to another device. Private.",++ "writers": [++ "owner",++ "user"++ ],++ "publicFields": [],++ "quotaBytes": 8192,++ "onOwnerRemoved": "retain-readonly",++ "schema": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "pip"++ ],++ "properties": {++ "pip": {++ "type": "object",++ "maxProperties": 60,++ "additionalProperties": false,++ "propertyNames": {++ "pattern": "^[0-9]{1,12}:[0-9]{1,12}$"++ },++ "patternProperties": {++ "^[0-9]{1,12}:[0-9]{1,12}$": {++ "type": "object",++ "additionalProperties": false,++ "required": [++ "x",++ "y",++ "w",++ "mode",++ "tuck",++ "muted",++ "at"++ ],++ "properties": {++ "x": {++ "type": "number",++ "minimum": 0,++ "maximum": 1++ },++ "y": {++ "type": "number",++ "minimum": 0,++ "maximum": 1++ },++ "w": {++ "type": "number",++ "minimum": 0,++ "maximum": 1++ },++ "mode": {++ "enum": [++ "dock",++ "float"++ ]++ },++ "tuck": {++ "enum": [++ "left",++ "right",++ null++ ]++ },++ "muted": {++ "type": "boolean"++ },++ "at": {++ "type": "integer",++ "minimum": 0++ }++ }++ }++ }++ }++ }++ }++}@@@ -5,11 +5,11 @@"icon": "fa-address-book","accent": "#84cc16","tagline": "Directories that keep themselves current",-- "description": "OpenVibe.Directory will be directories that keep themselves current: listings that update themselves instead of going stale. The product is not chartered yet; this address is parked and sends visitors to the network's front door.",++ "description": "Source-linked directories for OpenVibe sites and tools, AI models and providers, open-source projects, and local businesses from OpenStreetMap. Each entry shows when its sources were last checked.","legalProfile": "info",-- "launch": "A charter: which directory goes first, what keeps it current, and who answers for stale listings.",++ "launch": "Public directories, source refresh every six hours, entry pages, search, sitemap, JSON-LD, llms.txt.","keywords": "openvibe directory, business directory, self-updating listings, local directory","relationships": {-- "noRepo": true++ "service": "directory"}}@@@ -29,6 +29,7 @@"chat.analysis.read","chat.cache.invalidate","chat.config.manage",++ "chat.commands.register","chat.event.publish","chat.inbox.manage","chat.inbox.read",@@@ -44,6 +44,7 @@"network.account.deleted","network.account.export_requested","network.block.changed",++ "network.user.updated","network.user.token_valid_after"],"namespacesOwned": [nnew file mode 100644@@@ -0,0 +1,74 @@++{++ "version": "0.1.0",++ "status": "alpha",++ "lifecycle": {++ "liveness": {++ "endpoint": "/api/health",++ "means": "the process is up and answers HTTP; it checks nothing else"++ },++ "shutdown": {++ "signal": "SIGTERM",++ "deadlineSeconds": 10,++ "drains": [++ "HTTP server closed"++ ]++ },++ "startupRecovery": {++ "resumes": [++ {++ "kind": "state",++ "what": "Public sources are re-read at startup and every six hours; the in-memory last good snapshot is retained on transient source failure."++ }++ ]++ },++ "rollback": {++ "conditions": [++ "automatic: ovhost deploy puts the previous sha back and restarts again when the ready URL does not answer 2xx within ready.timeoutSeconds after the restart (exit 3)",++ "manual: ovhost rollback <service> --to <sha>"++ ],++ "window": "automatic only while ovhost waits for readiness after the restart; manual afterwards, as long as no blocker applies",++ "blockers": {++ "none": "No database, writes or migrations."++ }++ },++ "contracts": {++ "range": ">=0.405.0 <1.0.0"++ },++ "leases": {++ "none": "no claims: one process serves the site"++ }++ },++ "id": "directory",++ "name": "OpenVibe.Directory",++ "repository": "OpenVibers/OpenVibe.Directory",++ "domains": [++ "openvibe.directory"++ ],++ "publicOrigin": "https://openvibe.directory",++ "internalOrigin": "http://127.0.0.1:5281",++ "health": "/api/health",++ "ready": "/api/ready",++ "contractRanges": {++ "openvibe-contracts": ">=0.405.0 <1.0.0"++ },++ "exposure": {++ "state": "live",++ "publicSite": "service"++ },++ "capabilities": [],++ "eventsProduced": [],++ "eventsConsumed": [],++ "namespacesOwned": [++ "directory.*"++ ],++ "notes": "Public read service. Sources: Network frame, Tools catalog, Compare AI models, GitHub public repositories, and a bounded OpenStreetMap local-business pilot. People listings remain empty until an authenticated opt-in claim flow is available.",++ "site": {++ "name": "Directory",++ "icon": "directory",++ "tagline": "Directories that keep themselves current",++ "what": "Source-linked listings with a last checked date.",++ "legalProfile": "info",++ "position": 81,++ "neighbourhood": "make"++ }++}@@@ -1,12 +1,12 @@{"name": "openvibe-contracts",-- "version": "0.404.0",++ "version": "0.405.0","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "openvibe-contracts",-- "version": "0.404.0",++ "version": "0.405.0","license": "AGPL-3.0-only","dependencies": {"ajv": "^8.17.1",@@@ -1,6 +1,6 @@{"name": "openvibe-contracts",-- "version": "0.404.0",++ "version": "0.405.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",@@@ -85,8 +85,9 @@ function onlyOnce(ts, title, owned, emitted) {const schema = schemas.get(entry.schema);const bundleKey = majors.get(entry.id) > 1 ? `${entry.id}@${entry.version.split('.')[0]}` : entry.id;bundle.contracts[bundleKey] = { version: entry.version, owner: entry.owner, status: entry.status, schema };++ // AG-UI's event union references its local protocol definitions from its public types.const ts = await compile(inlineDefs(schema, file), schema.title, {-- bannerComment: '', cwd: path.dirname(file), declareExternallyReferenced: false,++ bannerComment: '', cwd: path.dirname(file), declareExternallyReferenced: schema.title === 'AgentUiEvent',additionalProperties: false, strictIndexSignatures: true, format: true,$refOptions: { resolve: { http: false } },});nnew file mode 100644@@@ -0,0 +1,21 @@++'use strict';++// Ask 354: validate AG-UI 1.0 event family fixtures and the OpenVibe metadata extension.++const assert = require('node:assert/strict');++const fs = require('node:fs');++const path = require('node:path');++const { execFileSync } = require('node:child_process');++const contracts = require('..');++const root = path.join(__dirname, '..', 'fixtures', 'agent.ui-event');++execFileSync(process.execPath, [path.join(__dirname, '..', 'scripts', 'generate.js'), '--check'], {++ cwd: path.join(__dirname, '..'), stdio: 'pipe',++});++for (const kind of ['valid', 'invalid']) {++ for (const file of fs.readdirSync(path.join(root, kind)).filter((name) => name.endsWith('.json'))) {++ const event = JSON.parse(fs.readFileSync(path.join(root, kind, file), 'utf8'));++ const result = contracts.validate('agent.ui-event@1', event);++ assert.equal(result.valid, kind === 'valid', `${kind}/${file}: ${JSON.stringify(result.errors || [])}`);++ }++}++const schema = contracts.schema('agent.ui-event@1');++assert.ok(schema.allOf.some((rule) => rule.required && rule.required.includes('timestamp')), 'every OpenVibe event has the AG-UI epoch timestamp');++console.log('agent.ui-event: valid and invalid fixtures pass across the eight AG-UI families');@@@ -832,6 +832,16 @@ await assert.rejects(failing.getToken(), /401: invalid_client/);ok(JSON.stringify(modules.publicView('live.profile', { followers: 3, stream_minutes_30d: 99 })) === '{"followers":3}', 'public view keeps only public fields');ok(modules.canWrite('chat.preferences', { type: 'user' }) && !modules.canWrite('live.profile', { type: 'user' }), 'user write follows writers');ok(modules.canWrite('live.profile', { type: 'service', id: 'live' }) && !modules.canWrite('live.profile', { type: 'service', id: 'tools' }), 'only the owning service writes');++++ // live.layout: where a person put each picture-in-picture, kept in their account (Live's /api/me/layout).++ const place = { x: 0.72, y: 0.7, w: 0.25, mode: 'dock', tuck: null, muted: true, at: 1760000000000 };++ const layout = (pip) => ({ pip });++ ok(modules.validateData('live.layout', layout({ '12:34': place })).valid, 'live.layout takes a place per slot and source');++ ok(modules.validateData('live.layout', layout({ '12:34': { ...place, mode: 'float', tuck: 'left' } })).valid, 'a floating, tucked place is valid');++ ok(!modules.validateData('live.layout', layout({ 'slot:source': place })).valid, 'a place key that is not <slot>:<source> is refused');++ ok(!modules.validateData('live.layout', layout({ '12:34': { ...place, x: 1.2 } })).valid, 'a place outside the frame is refused');++ ok(!modules.validateData('live.layout', layout({ '12:34': { ...place, extra: 1 } })).valid, 'an unknown field is refused');++ ok(!modules.validateData('live.layout', layout(Object.fromEntries(Array.from({ length: 61 }, (_, i) => [`1:${i}`, place])))).valid, 'more than 60 places is refused');}// ── openvibe-contracts-check (the CLI services run in CI) ─────────────────@@@ -1009,6 +1019,7 @@ sub(path.join(__dirname, 'resources.test.js'));sub(path.join(__dirname, 'actor-wait.test.js'));sub(path.join(__dirname, 'actor-ask.test.js'));sub(path.join(__dirname, 'batching-latency.test.js'));++sub(path.join(__dirname, 'agent-ui-event.test.js'));sub(path.join(__dirname, 'network-consent.test.js'));// The machines hub (plan L34): one catalogue of roles, declared by the products that own them.sub(path.join(__dirname, 'machines.test.js'));
@@ -1,5 +1,23 @@
@@ -1,5 +1,23 @@
# Changelog
# Changelog
+## 0.405.0 — 2026-11-11
+
+This release train carries the contract work that was waiting on the owner's release. One line per carried pull request:
+
+- Add `live.layout@1`, the player layout a person keeps in their account: per stream slot and source, the place as fractions of the frame, mode `dock` or `float`, the tuck side, mute and the time, at most 60 places (#442).
+- Add `chat.command-registration-request@1` and `chat.command-registration-result@1` with the active capability `chat.commands.register`, so a consented app or an Actor agent can register a plain response command for a server its person manages (#441).
+- Catalog OpenVibe.Directory as a live service and site, replacing its parked product metadata, with its public origin, source refresh lifecycle and public-listings-only scope (#440).
+- Add `actor.agent-sheet@1` and `codes.agent-sheet@1`: the owner-scoped agent sheet responses, with current work, daily activity, approvals, computer, schedules and memory where recorded (#439).
+- Extend `community.feed-item@1`, `community.pulse-item@1` and `community.pulse-write-request@1` with activity kinds, followers-only visibility, scheduled starts, previews and links to every item in a folded burst; Community consumes Network profile updates (#438).
+- Add `chat.person-memory-result@1` and `chat.person-memory-preferences-result@1`: the public and private parts of Chat's compacted day, week and month memory, and the erase and opt-out responses (#437).
+- Add `preview_url` (and `preview_webm_url` on media) to `media.vod@1`, `media.clip@1` and the Live stream shapes: the 6 s muted hover preview beside a thumbnail (#436).
+- Add `agent.ui-event@1` with the AG-UI 1.0 event union and OpenVibe `metadata.ov`, `agent.run@1` snapshots, and the `agent-run` chat embed (#434).
+- Add `network.user-card@1` with viewer-aware actions, and `network.user-report@1`, `network.user-report-request@1` and `network.user-report-list-result@1` for a person's reports and the staff queue (#433).
+- Add `community.feed-card@1` and `community.feed-answer@1`, with preview media support (#432).
+- Add `composer.attachment@1`, `composer.prefs@1` and `composer.mention@1`, the shared composer's server-side shapes (#426).
+
+Valid and invalid fixtures cover every new shape, and the generated TypeScript, JSON Schema bundle and per-service OpenAPI files are regenerated at this version.
+
## 0.404.0 — 2026-11-11
## 0.404.0 — 2026-11-11
- Add owner-only Run compute configuration capability for Network admin proxy.
- Add owner-only Run compute configuration capability for Network admin proxy.
@@ -5,7 +5,7 @@
@@ -5,7 +5,7 @@
**Docs:** https://openvibe.services · **For AI:** https://openvibe.services/llms.txt
**Docs:** https://openvibe.services · **For AI:** https://openvibe.services/llms.txt
**Install and test:** `npm ci && npm test` (Node 20 or newer)
**Install and test:** `npm ci && npm test` (Node 20 or newer)
-**Status:** alpha (first released in Wave 1; the release is package.json's `version`, tagged). At v0.403.0: 1221 schemas in `contracts/catalog.json`, 65 service manifests, 513 capability manifests, 13 namespace manifests and the staff capability map. Service repositories run `openvibe-contracts-check` and the pin-drift check in CI, and deployed services verify service and app tokens with `serviceAuth` in production. Consumers pin release tags (each repository's `STATUS.json` names its pin). `node scripts/docs-currency.js <root>` checks every checkout's README and `STATUS.json` against its code: the pins and versions they name, a library's consumer list, the deployed flag against the manifest, README links, and the paths and migrations they name. `node scripts/estate.js` generates `docs/ESTATE.md` and `manifests/repositories/` from the estate checkouts, and `--check` fails on drift (plan T1 step 3).
+**Status:** alpha (first released in Wave 1; the release is package.json's `version`, tagged). At v0.405.0: 1238 schemas in `contracts/catalog.json`, 66 service manifests, 516 capability manifests, 14 namespace manifests and the staff capability map. Service repositories run `openvibe-contracts-check` and the pin-drift check in CI, and deployed services verify service and app tokens with `serviceAuth` in production. Consumers pin release tags (each repository's `STATUS.json` names its pin). `node scripts/docs-currency.js <root>` checks every checkout's README and `STATUS.json` against its code: the pins and versions they name, a library's consumer list, the deployed flag against the manifest, README links, and the paths and migrations they name. `node scripts/estate.js` generates `docs/ESTATE.md` and `manifests/repositories/` from the estate checkouts, and `--check` fails on drift (plan T1 step 3).
**Plan:** OpenVibe Development Roadmap, Wave 1 (implementation plan rev 3, §3.1 and §18.11).
**Plan:** OpenVibe Development Roadmap, Wave 1 (implementation plan rev 3, §3.1 and §18.11).
**License:** AGPL-3.0 (same as every OpenVibe service).
**License:** AGPL-3.0 (same as every OpenVibe service).
@@ -19,7 +19,7 @@
@@ -19,7 +19,7 @@
"798 JSON Schemas with valid and invalid fixtures (at v0.210.0)",
"798 JSON Schemas with valid and invalid fixtures (at v0.210.0)",
"45 service manifests with lifecycle declarations (39 alpha, 1 beta, 4 stable, 1 retired)",
"45 service manifests with lifecycle declarations (39 alpha, 1 beta, 4 stable, 1 retired)",
"348 capability manifests (306 active, 27 planned, 15 retired) and the staff capability map",
"348 capability manifests (306 active, 27 planned, 15 retired) and the staff capability map",
- "13 user-module namespace manifests",
+ "14 user-module namespace manifests",
"validate, ids, http (problem+json, trace and idempotency middleware), capabilities.check and serviceAuth",
"validate, ids, http (problem+json, trace and idempotency middleware), capabilities.check and serviceAuth",
"openvibe-contracts-check for service CI",
"openvibe-contracts-check for service CI",
"generated TypeScript types, JSON Schema bundle and per-service OpenAPI 3.1",
"generated TypeScript types, JSON Schema bundle and per-service OpenAPI 3.1",
@@ -49,7 +49,8 @@
@@ -49,7 +49,8 @@
"bench.benchmark@1 and bench.run@1 with the capabilities bench.benchmark.write, bench.run.publish and bench.run.read: the benchmark registry and the results API (spec 2026-10-30, stage B1)",
"bench.benchmark@1 and bench.run@1 with the capabilities bench.benchmark.write, bench.run.publish and bench.run.read: the benchmark registry and the results API (spec 2026-10-30, stage B1)",
"mail.agent_inbox.received@1, mail.agent-inbox-message@1, mail.agent-reply-request@1, mail.agent-reply-result@1 and mail.inbox-answering@1, with the capabilities mail.agent.read, mail.agent.reply and mail.agent.answering (track HO6): an agent answers the mail sent to its own OpenVibe.Mail address, reads it in full text on the owner's behalf, replies from its own address in the thread, and answers only when the person's switch for that address is on",
"mail.agent_inbox.received@1, mail.agent-inbox-message@1, mail.agent-reply-request@1, mail.agent-reply-result@1 and mail.inbox-answering@1, with the capabilities mail.agent.read, mail.agent.reply and mail.agent.answering (track HO6): an agent answers the mail sent to its own OpenVibe.Mail address, reads it in full text on the owner's behalf, replies from its own address in the thread, and answers only when the person's switch for that address is on",
"actor.task-create-request@1 supports Actor conversation turns with optional tools, model and content tier; uncensored content is limited to tasks naming their intended person",
"actor.task-create-request@1 supports Actor conversation turns with optional tools, model and content tier; uncensored content is limited to tasks naming their intended person",
- "chat.embed@1 provides one address preview shape for every chat client; account-merge contracts are deprecated"
+ "chat.embed@1 provides one address preview shape for every chat client; account-merge contracts are deprecated",
+ "media.vod@1, media.clip@1 and the live stream shapes carry preview_url (and the media shapes preview_webm_url): the 6 s muted hover preview beside a thumbnail (plan 355)"
],
],
"updated": "2026-11-11"
"updated": "2026-11-11"
}
}
new file mode 100644
new file mode 100644
@@ -0,0 +1,34 @@
@@ -0,0 +1,34 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/actor/agent-sheet.v1.json",
+ "title": "ActorAgentSheet",
+ "description": "actor.agent-sheet@1: one owner-scoped read of an Actor agent's current work, history, approvals, computer, schedules and memory. GET /api/v1/me/agents/:id?view=sheet; never cache this answer.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["agent", "now", "work", "asks", "asks_empty", "computer", "schedules", "memory", "activity"],
+ "properties": {
+ "agent": {
+ "type": "object", "additionalProperties": true,
+ "required": ["id", "name", "face", "state", "instructions", "voice"],
+ "properties": {
+ "id": {"type": "string", "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$"},
+ "name": {"type": "string"},
+ "face": {"type": ["string", "null"]},
+ "state": {"enum": ["working", "idle", "paused"]},
+ "instructions": {"type": "string"},
+ "voice": {"type": ["string", "null"]}
+ }
+ },
+ "now": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/work"}]},
+ "work": {"type": "array", "items": {"$ref": "#/$defs/work"}},
+ "asks": {"type": "array", "items": {"type": "object", "required": ["id", "state", "what"], "properties": {"id": {"type": "string"}, "state": {"type": "string"}, "what": {"type": "string"}, "why": {"type": ["string", "null"]}, "touch": {"type": ["string", "object", "null"]}}, "additionalProperties": true}},
+ "asks_empty": {"type": ["string", "null"]},
+ "computer": {"oneOf": [{"type": "null"}, {"type": "object", "properties": {"url": {"type": ["string", "null"]}, "open": {"type": ["string", "null"]}}, "additionalProperties": true}]},
+ "schedules": {"type": "array", "items": {"type": "object", "properties": {"next_run_at": {"type": ["string", "null"]}, "last_run_at": {"type": ["string", "null"]}, "last_result": {"type": ["string", "null"]}}, "additionalProperties": true}},
+ "memory": {"type": "array", "items": {"type": "object", "required": ["id", "text"], "properties": {"id": {"type": "string"}, "text": {"type": "string"}, "source": {"type": "string"}}, "additionalProperties": true}},
+ "activity": {"type": "array", "items": {"type": "object", "additionalProperties": true}}
+ },
+ "$defs": {
+ "work": {"type": "object", "required": ["id", "task", "state", "cost_usd"], "properties": {"id": {"type": "string"}, "task": {"type": "string"}, "state": {"type": "string"}, "cost_usd": {"type": "number", "minimum": 0}, "result": {}, "computer": {}}, "additionalProperties": true}
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,170 @@
@@ -0,0 +1,170 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "type": "object",
+ "additionalProperties": false,
+ "$id": "https://openvibe.network/contracts/agent/run.v1.json",
+ "title": "AgentRun",
+ "description": "agent.run@1 snapshot of a run and its current plan, steps, sources, result, timestamps and cost.",
+ "required": [
+ "id",
+ "product",
+ "title",
+ "status",
+ "plan",
+ "steps",
+ "sources",
+ "result",
+ "started_at",
+ "ended_at",
+ "cost_usd"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 160
+ },
+ "product": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 40
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 240
+ },
+ "status": {
+ "enum": [
+ "queued",
+ "running",
+ "waiting",
+ "needs_you",
+ "succeeded",
+ "failed",
+ "stopped",
+ "cancelled"
+ ]
+ },
+ "plan": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "title",
+ "status"
+ ],
+ "properties": {
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 240
+ },
+ "status": {
+ "enum": [
+ "todo",
+ "running",
+ "waiting",
+ "needs_you",
+ "done",
+ "failed",
+ "stopped"
+ ]
+ }
+ }
+ }
+ },
+ "steps": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/step"
+ }
+ },
+ "sources": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/source"
+ }
+ },
+ "result": {
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "started_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "ended_at": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "date-time"
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ }
+ },
+ "$defs": {
+ "step": {
+ "type": "object",
+ "additionalProperties": true,
+ "required": [
+ "title",
+ "status"
+ ],
+ "properties": {
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 240
+ },
+ "status": {
+ "enum": [
+ "todo",
+ "running",
+ "waiting",
+ "needs_you",
+ "done",
+ "failed",
+ "stopped"
+ ]
+ }
+ }
+ },
+ "source": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "url",
+ "title",
+ "site"
+ ],
+ "properties": {
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://",
+ "maxLength": 2048
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 300
+ },
+ "site": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ }
+ }
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,2492 @@
@@ -0,0 +1,2492 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/agent/ui-event.v1.json",
+ "title": "AgentUiEvent",
+ "description": "agent.ui-event@1: AG-UI 1.0 event shape and event-family fields, with OpenVibe metadata.ov. AG-UI timestamps are Unix-millisecond integers; this contract requires one on every event. CUSTOM events use AG-UI name/value with ov.sources, ov.handoff, ov.approval or ov.result names.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/Event"
+ },
+ {
+ "type": "object",
+ "required": [
+ "timestamp"
+ ]
+ }
+ ],
+ "definitions": {
+ "EventType": {
+ "type": "string",
+ "description": "The discriminator carried by every event.",
+ "enum": [
+ "TEXT_MESSAGE_START",
+ "TEXT_MESSAGE_CONTENT",
+ "TEXT_MESSAGE_END",
+ "TEXT_MESSAGE_CHUNK",
+ "TOOL_CALL_START",
+ "TOOL_CALL_ARGS",
+ "TOOL_CALL_END",
+ "TOOL_CALL_CHUNK",
+ "TOOL_CALL_RESULT",
+ "STATE_SNAPSHOT",
+ "STATE_DELTA",
+ "MESSAGES_SNAPSHOT",
+ "ACTIVITY_SNAPSHOT",
+ "ACTIVITY_DELTA",
+ "RAW",
+ "CUSTOM",
+ "RUN_STARTED",
+ "RUN_FINISHED",
+ "RUN_ERROR",
+ "STEP_STARTED",
+ "STEP_FINISHED",
+ "REASONING_START",
+ "REASONING_MESSAGE_START",
+ "REASONING_MESSAGE_CONTENT",
+ "REASONING_MESSAGE_END",
+ "REASONING_MESSAGE_CHUNK",
+ "REASONING_END",
+ "REASONING_ENCRYPTED_VALUE",
+ "SUBAGENT_STARTED",
+ "SUBAGENT_FINISHED",
+ "SUBAGENT_ERROR"
+ ]
+ },
+ "BaseEvent": {
+ "type": "object",
+ "description": "The fields every event carries, whatever its type. Composed into each event definition rather than repeated, so a change here reaches every event at once.",
+ "properties": {
+ "type": {
+ "$ref": "#/definitions/EventType",
+ "description": "Which event this is. Each event definition narrows this to a single value."
+ },
+ "timestamp": {
+ "type": "integer",
+ "minimum": -9007199254740991,
+ "maximum": 9007199254740991,
+ "description": "When the event was created. Bounded to the range JSON numbers survive a round trip in, so the value a consumer reads is the value the producer wrote. Deliberately not a float. The unit is not constrained here, because it never has been stated normatively; every SDK that sets it in practice uses milliseconds since the Unix epoch, and a producer choosing another unit will be misread by consumers even though it validates. Nothing in the protocol computes with this value."
+ },
+ "rawEvent": {
+ "not": {
+ "type": "null"
+ },
+ "description": "The provider-native event this one was translated from, carried verbatim for debugging and for consumers that need detail the protocol does not model. Any JSON value."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this event."
+ }
+ },
+ "required": [
+ "type"
+ ]
+ },
+ "Attributable": {
+ "type": "object",
+ "description": "Composed into everything that can belong to a subagent's work: the events that describe content or progress, the message types, and each interrupt. Run-scoped events omit it \u2014 RUN_STARTED, RUN_FINISHED and RUN_ERROR describe the run itself and MESSAGES_SNAPSHOT is conversation-wide, so none of them can belong to one subagent. A tool call omits it too and inherits its containing message's attribution.",
+ "properties": {
+ "subagentRunId": {
+ "$ref": "#/definitions/SubagentRunId",
+ "description": "The subagent invocation this belongs to. Absent means the parent agent produced it directly."
+ }
+ }
+ },
+ "SubagentRunId": {
+ "type": "string",
+ "description": "An opaque handle for one subagent invocation, not a reusable name for a subagent definition: two invocations of the same subagent carry two different values. Named to mirror runId one level down, the way the subagent's name mirrors agentId."
+ },
+ "Metadata": {
+ "type": "object",
+ "description": "Extra information attached to an event, a message, a tool call, a tool, an interrupt or a resume entry. Open by key: any JSON value is allowed under a key, including null, because a null there is meaningful data. The object itself may be absent but is never null when present. The key ag-ui is reserved for the protocol's own use; reservation is by convention, since validating the shape of a key's value would contradict being open by key.",
+ "additionalProperties": true,
+ "properties": {
+ "ov": {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "title": {
+ "type": "string",
+ "maxLength": 240
+ },
+ "kind": {
+ "enum": [
+ "search",
+ "fetch",
+ "read",
+ "edit",
+ "run",
+ "browse",
+ "ask",
+ "think",
+ "note",
+ "agent",
+ "plan"
+ ]
+ },
+ "sources": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/OvSource"
+ }
+ },
+ "attachments": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "additionalProperties": true
+ }
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "needs_you": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "question",
+ "actions"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 160
+ },
+ "question": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 1000
+ },
+ "actions": {
+ "type": "array",
+ "items": {},
+ "minItems": 1
+ }
+ }
+ },
+ "product": {
+ "type": "string",
+ "maxLength": 40
+ },
+ "ref": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 160
+ }
+ }
+ }
+ }
+ },
+ "State": {
+ "description": "Agent state. Any JSON value: the protocol carries state without interpreting it, so an object, an array, a string and a number are all valid."
+ },
+ "TextMessageRole": {
+ "type": "string",
+ "description": "The roles a streamed text message may take. Excludes tool, which is carried by TOOL_CALL_RESULT rather than streamed as text.",
+ "enum": [
+ "developer",
+ "system",
+ "assistant",
+ "user"
+ ]
+ },
+ "TextMessageStartEvent": {
+ "type": "object",
+ "description": "Opens a streamed text message. The content arrives as TEXT_MESSAGE_CONTENT events and the message closes with TEXT_MESSAGE_END.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TEXT_MESSAGE_START"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "Identifies the message this stream builds, and ties the later content and end events to it."
+ },
+ "role": {
+ "$ref": "#/definitions/TextMessageRole",
+ "default": "assistant",
+ "description": "Who the message is from. An absent role means assistant; that meaning is normative and stated in the prose, because a validator treats a default as documentation rather than as behaviour."
+ },
+ "name": {
+ "type": "string",
+ "description": "An optional display name for the author, for providers that distinguish several participants in one role."
+ }
+ },
+ "required": [
+ "type",
+ "messageId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "TextMessageContentEvent": {
+ "type": "object",
+ "description": "Appends a fragment to a streamed text message.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TEXT_MESSAGE_CONTENT"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The message this fragment belongs to."
+ },
+ "delta": {
+ "type": "string",
+ "description": "The fragment to append. May be the empty string: providers emit empty deltas as keep-alives and while a tool call is being decided, and rejecting them would kill runs that are working correctly."
+ }
+ },
+ "required": [
+ "type",
+ "messageId",
+ "delta"
+ ],
+ "unevaluatedProperties": false
+ },
+ "TextMessageEndEvent": {
+ "type": "object",
+ "description": "Closes a streamed text message.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TEXT_MESSAGE_END"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The message being closed."
+ }
+ },
+ "required": [
+ "type",
+ "messageId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "TextMessageChunkEvent": {
+ "type": "object",
+ "description": "A shorthand that stands in for a start, content and end sequence, for producers that cannot know in advance where a message begins. Every field is optional because a continuation chunk omits what has not changed; which message a field-less chunk continues is a sequence question the prose specification answers.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TEXT_MESSAGE_CHUNK"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The message this chunk belongs to. Absent continues the message already open."
+ },
+ "role": {
+ "$ref": "#/definitions/TextMessageRole",
+ "description": "Who the message is from, on the chunk that opens it."
+ },
+ "delta": {
+ "type": "string",
+ "description": "The fragment to append. May be the empty string."
+ },
+ "name": {
+ "type": "string",
+ "description": "An optional display name for the author."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolCallStartEvent": {
+ "type": "object",
+ "description": "Opens a tool call. The arguments arrive as TOOL_CALL_ARGS events and the call closes with TOOL_CALL_END.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TOOL_CALL_START"
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "Identifies the call, and ties the later args, end and result events to it."
+ },
+ "toolCallName": {
+ "type": "string",
+ "description": "Which tool is being called."
+ },
+ "parentMessageId": {
+ "type": "string",
+ "description": "The assistant message that holds this call. Absent means the producer did not attribute it to one."
+ }
+ },
+ "required": [
+ "type",
+ "toolCallId",
+ "toolCallName"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolCallArgsEvent": {
+ "type": "object",
+ "description": "Appends a fragment of a tool call's arguments.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TOOL_CALL_ARGS"
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "The call these arguments belong to."
+ },
+ "delta": {
+ "type": "string",
+ "description": "A fragment of the arguments, which concatenate into the call's argument text \u2014 conventionally a JSON document, though the protocol does not validate it (see FunctionCall.arguments). Deliberately a string rather than parsed JSON: a fragment is not itself a document. May be the empty string."
+ }
+ },
+ "required": [
+ "type",
+ "toolCallId",
+ "delta"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolCallEndEvent": {
+ "type": "object",
+ "description": "Closes a tool call, meaning its arguments are complete.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TOOL_CALL_END"
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "The call being closed."
+ }
+ },
+ "required": [
+ "type",
+ "toolCallId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolCallChunkEvent": {
+ "type": "object",
+ "description": "A shorthand that stands in for a tool call's start, args and end sequence. Every field is optional for the same reason as TEXT_MESSAGE_CHUNK.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TOOL_CALL_CHUNK"
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "The call this chunk belongs to. Absent continues the call already open."
+ },
+ "toolCallName": {
+ "type": "string",
+ "description": "Which tool is being called, on the chunk that opens it."
+ },
+ "parentMessageId": {
+ "type": "string",
+ "description": "The assistant message that holds this call."
+ },
+ "delta": {
+ "type": "string",
+ "description": "A fragment of the arguments. May be the empty string."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolCallResultEvent": {
+ "type": "object",
+ "description": "Carries what a tool returned. Mints a tool message rather than appending to an existing one, which is why it has its own messageId.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TOOL_CALL_RESULT"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The tool message this result becomes."
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "The call being answered."
+ },
+ "content": {
+ "description": "What the tool returned: either plain text, or an ordered list of parts, exactly as on the tool message this event mints. A tool returning structured data serialises it into text; media travel as parts of their own.",
+ "oneOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/ContentPart"
+ }
+ }
+ ]
+ },
+ "role": {
+ "const": "tool",
+ "description": "Present only for symmetry with the message it mints; the value is fixed, so a producer may leave it out."
+ }
+ },
+ "required": [
+ "type",
+ "messageId",
+ "toolCallId",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "StateSnapshotEvent": {
+ "type": "object",
+ "description": "Replaces the agent state wholesale. Sent when a delta cannot express the change, or to resynchronise a consumer.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "STATE_SNAPSHOT"
+ },
+ "snapshot": {
+ "$ref": "#/definitions/State",
+ "description": "The complete new state."
+ }
+ },
+ "required": [
+ "type",
+ "snapshot"
+ ],
+ "unevaluatedProperties": false
+ },
+ "StateDeltaEvent": {
+ "type": "object",
+ "description": "Changes the agent state incrementally.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "STATE_DELTA"
+ },
+ "delta": {
+ "$ref": "#/definitions/JsonPatch",
+ "description": "The change, as an RFC 6902 patch against the current state. Structural validity here does not mean the patch applies: a well-formed operation may point at a path that does not exist, which RFC 6902 leaves to the applier."
+ }
+ },
+ "required": [
+ "type",
+ "delta"
+ ],
+ "unevaluatedProperties": false
+ },
+ "MessagesSnapshotEvent": {
+ "type": "object",
+ "description": "The complete set of messages the producer owns, in order. Conversation-wide rather than a plain overwrite: a consumer may keep messages of its own that no producer tracks, so exactly how a snapshot reconciles with those is behavioural and belongs in the prose. Being conversation-wide it cannot belong to a single subagent, so it carries no attribution; it does establish which subagent owns each message it contains, through the messages themselves.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "MESSAGES_SNAPSHOT"
+ },
+ "messages": {
+ "type": "array",
+ "description": "The messages the producer is declaring, in order.",
+ "items": {
+ "$ref": "#/definitions/Message"
+ }
+ }
+ },
+ "required": [
+ "type",
+ "messages"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ActivitySnapshotEvent": {
+ "type": "object",
+ "description": "Reports structured progress that is not conversation content, such as a step a UI renders as its own widget.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "ACTIVITY_SNAPSHOT"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The activity message this describes."
+ },
+ "activityType": {
+ "type": "string",
+ "description": "What kind of activity this is. An open string: the set is the producer's, not the protocol's."
+ },
+ "content": {
+ "type": "object",
+ "description": "The activity's payload, open by key.",
+ "additionalProperties": true
+ },
+ "replace": {
+ "type": "boolean",
+ "default": true,
+ "description": "Whether this snapshot overwrites the activity's existing content. Absent means it does, and that meaning is normative; only an explicit false asks a consumer to leave what is already there. It does not ask for a merge \u2014 ACTIVITY_DELTA is how content is changed incrementally. What a consumer does with a non-overwriting snapshot is behavioural and belongs in the prose."
+ }
+ },
+ "required": [
+ "type",
+ "messageId",
+ "activityType",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ActivityDeltaEvent": {
+ "type": "object",
+ "description": "Changes an activity message's content incrementally.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "ACTIVITY_DELTA"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The activity message being changed."
+ },
+ "activityType": {
+ "type": "string",
+ "description": "What kind of activity this is."
+ },
+ "patch": {
+ "$ref": "#/definitions/JsonPatch",
+ "description": "The change, as an RFC 6902 patch against the activity's content."
+ }
+ },
+ "required": [
+ "type",
+ "messageId",
+ "activityType",
+ "patch"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RawEvent": {
+ "type": "object",
+ "description": "Passes a provider-native event through untranslated, for consumers that need detail the protocol does not model.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "RAW"
+ },
+ "event": {
+ "description": "The provider's own event. Any JSON value, and required: an event whose only purpose is to carry this would say nothing without it."
+ },
+ "source": {
+ "type": "string",
+ "description": "Which provider or framework the event came from."
+ }
+ },
+ "required": [
+ "type",
+ "event"
+ ],
+ "unevaluatedProperties": false
+ },
+ "CustomEvent": {
+ "type": "object",
+ "description": "The protocol's extension point for an application's own events. Anything a consumer does with one is outside the protocol.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "CUSTOM"
+ },
+ "name": {
+ "type": "string",
+ "description": "What this custom event is. Required: without it a consumer cannot route the value.",
+ "enum": [
+ "ov.sources",
+ "ov.handoff",
+ "ov.approval",
+ "ov.result"
+ ]
+ },
+ "value": {
+ "description": "The payload. Any JSON value, and required."
+ }
+ },
+ "required": [
+ "type",
+ "name",
+ "value"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunStartedEvent": {
+ "type": "object",
+ "description": "Opens a run. Run-scoped, so it carries no subagent attribution.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "RUN_STARTED"
+ },
+ "threadId": {
+ "type": "string",
+ "description": "The conversation this run belongs to."
+ },
+ "runId": {
+ "type": "string",
+ "description": "Identifies this run."
+ },
+ "protocolVersion": {
+ "type": "string",
+ "description": "The protocol version this producer speaks, such as \"1.0\" \u2014 the producer's own version, not an echo of the input's, which is what makes the pair a negotiation: each side declares itself and the consumer sees a downgrade the moment it happens. Absent means a producer from before the protocol carried a version."
+ },
+ "parentRunId": {
+ "type": "string",
+ "description": "The run that spawned this one, when an agent invokes another agent as a separate run rather than as a subagent within one."
+ },
+ "input": {
+ "$ref": "#/definitions/RunAgentInput",
+ "description": "The request this run was started from, echoed back so a consumer that did not make the request can still see what the agent was asked."
+ }
+ },
+ "required": [
+ "type",
+ "threadId",
+ "runId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunFinishedEvent": {
+ "type": "object",
+ "description": "Closes a run that did not fail. Run-scoped, so it carries no subagent attribution.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "RUN_FINISHED"
+ },
+ "threadId": {
+ "type": "string",
+ "description": "The conversation this run belongs to."
+ },
+ "runId": {
+ "type": "string",
+ "description": "The run being closed."
+ },
+ "result": {
+ "not": {
+ "type": "null"
+ },
+ "description": "The run's return value, if it has one. Any JSON value."
+ },
+ "outcome": {
+ "$ref": "#/definitions/RunFinishedOutcome",
+ "description": "Why the run ended. Absent means success, so every producer written before outcomes existed is already conformant."
+ },
+ "usage": {
+ "type": "array",
+ "description": "Token usage for the run, one entry per provider and model, so a run that invoked several models keeps them separate. A consumer that only wants totals sums across the entries. The run is the accounting boundary: usage covers every model call made within the run, calls made by its subagents included; an agent invoked as a separate run under parentRunId reports its own usage on its own terminal event; and a run that resumes an interrupted one reports only the calls it made itself, not the interrupted run's.",
+ "items": {
+ "$ref": "#/definitions/TokenUsage"
+ }
+ }
+ },
+ "required": [
+ "type",
+ "threadId",
+ "runId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunErrorEvent": {
+ "type": "object",
+ "description": "Ends a run that failed. Run-scoped, so it carries no subagent attribution; a subagent that fails without ending the run reports SUBAGENT_ERROR instead.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "RUN_ERROR"
+ },
+ "message": {
+ "type": "string",
+ "description": "What went wrong, for a person to read."
+ },
+ "code": {
+ "type": "string",
+ "description": "A machine-readable error code. An open string: the protocol defines no vocabulary."
+ },
+ "usage": {
+ "type": "array",
+ "description": "Token usage accrued before the failure, for a run that completed one or more model calls before dying. Scoped as on RUN_FINISHED: the run's own calls, subagents included.",
+ "items": {
+ "$ref": "#/definitions/TokenUsage"
+ }
+ }
+ },
+ "required": [
+ "type",
+ "message"
+ ],
+ "unevaluatedProperties": false
+ },
+ "StepStartedEvent": {
+ "type": "object",
+ "description": "Opens a named step within a run, for producers whose frameworks have a step concept worth surfacing.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "STEP_STARTED"
+ },
+ "stepName": {
+ "type": "string",
+ "description": "The step's name. Identifies it: the matching STEP_FINISHED carries the same name."
+ }
+ },
+ "required": [
+ "type",
+ "stepName"
+ ],
+ "unevaluatedProperties": false
+ },
+ "StepFinishedEvent": {
+ "type": "object",
+ "description": "Closes a named step.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "STEP_FINISHED"
+ },
+ "stepName": {
+ "type": "string",
+ "description": "The step being closed."
+ }
+ },
+ "required": [
+ "type",
+ "stepName"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningStartEvent": {
+ "type": "object",
+ "description": "Opens a span of reasoning. A span may contain several reasoning messages.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_START"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The span being opened."
+ }
+ },
+ "required": [
+ "type",
+ "messageId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningMessageStartEvent": {
+ "type": "object",
+ "description": "Opens a streamed reasoning message.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_MESSAGE_START"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The reasoning message this stream builds."
+ },
+ "role": {
+ "const": "reasoning",
+ "description": "Fixed, and required rather than defaulted. The requirement is inherited from the SDKs rather than chosen."
+ }
+ },
+ "required": [
+ "type",
+ "messageId",
+ "role"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningMessageContentEvent": {
+ "type": "object",
+ "description": "Appends a fragment to a streamed reasoning message.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_MESSAGE_CONTENT"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The reasoning message this fragment belongs to."
+ },
+ "delta": {
+ "type": "string",
+ "description": "The fragment to append. May be the empty string."
+ }
+ },
+ "required": [
+ "type",
+ "messageId",
+ "delta"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningMessageEndEvent": {
+ "type": "object",
+ "description": "Closes a streamed reasoning message.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_MESSAGE_END"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The reasoning message being closed."
+ }
+ },
+ "required": [
+ "type",
+ "messageId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningMessageChunkEvent": {
+ "type": "object",
+ "description": "A shorthand that stands in for a reasoning message's start, content and end sequence.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_MESSAGE_CHUNK"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The reasoning message this chunk belongs to. Absent continues the one already open."
+ },
+ "delta": {
+ "type": "string",
+ "description": "The fragment to append. May be the empty string."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningEndEvent": {
+ "type": "object",
+ "description": "Closes a span of reasoning.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_END"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The span being closed."
+ }
+ },
+ "required": [
+ "type",
+ "messageId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningEncryptedValueEvent": {
+ "type": "object",
+ "description": "Carries a provider's opaque, encrypted reasoning artefact, which a consumer stores and returns on a later turn without being able to read it.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_ENCRYPTED_VALUE"
+ },
+ "subtype": {
+ "$ref": "#/definitions/ReasoningEncryptedValueSubtype",
+ "description": "What kind of thing entityId names, which decides where the value is stored."
+ },
+ "entityId": {
+ "type": "string",
+ "description": "What the value belongs to: a message id or a tool call id, according to subtype."
+ },
+ "encryptedValue": {
+ "type": "string",
+ "description": "The provider's opaque artefact."
+ }
+ },
+ "required": [
+ "type",
+ "subtype",
+ "entityId",
+ "encryptedValue"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningEncryptedValueSubtype": {
+ "type": "string",
+ "description": "Whether a REASONING_ENCRYPTED_VALUE belongs to a message or to a tool call.",
+ "enum": [
+ "tool-call",
+ "message"
+ ]
+ },
+ "SubagentStartedEvent": {
+ "type": "object",
+ "description": "Announces that a subagent invocation has begun. Everything the subagent produces afterwards is attributed by carrying its subagentRunId, so a consumer can group the work without replaying the stream. Composed from BaseEvent alone rather than Attributable, because here subagentRunId identifies the subagent rather than attributing the event to one; attribution to an enclosing subagent is parentSubagentRunId.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "SUBAGENT_STARTED"
+ },
+ "subagentRunId": {
+ "$ref": "#/definitions/SubagentRunId",
+ "description": "The invocation being announced."
+ },
+ "name": {
+ "type": "string",
+ "description": "The subagent's name, which is reusable across invocations, unlike subagentRunId."
+ },
+ "description": {
+ "type": "string",
+ "description": "What this subagent is for, for a consumer to display."
+ },
+ "parentSubagentRunId": {
+ "$ref": "#/definitions/SubagentRunId",
+ "description": "The subagent invocation that spawned this one, for nested delegation. Absent means the parent agent spawned it directly."
+ },
+ "parentToolCallId": {
+ "type": "string",
+ "description": "The tool call that spawned this subagent, for the pattern where agents are exposed to a model as tools. Lets a consumer tie the subagent to the call without reading rawEvent."
+ },
+ "parentMessageId": {
+ "type": "string",
+ "description": "The message that held the spawning tool call."
+ }
+ },
+ "required": [
+ "type",
+ "subagentRunId",
+ "name"
+ ],
+ "unevaluatedProperties": false
+ },
+ "SubagentFinishedEvent": {
+ "type": "object",
+ "description": "Ends a subagent invocation's segment of this run, either because the work completed or because it is suspended awaiting outside input.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "SUBAGENT_FINISHED"
+ },
+ "subagentRunId": {
+ "$ref": "#/definitions/SubagentRunId",
+ "description": "The invocation being closed."
+ },
+ "result": {
+ "not": {
+ "type": "null"
+ },
+ "description": "The subagent's return value, if it has one. Any JSON value, mirroring RUN_FINISHED.result."
+ },
+ "outcome": {
+ "$ref": "#/definitions/SubagentFinishedOutcome",
+ "description": "Why the segment ended. Absent means success. A suspended subagent is neither a success nor a failure, which is why saying so needs its own value rather than being inferred from a later interrupt."
+ }
+ },
+ "required": [
+ "type",
+ "subagentRunId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "SubagentErrorEvent": {
+ "type": "object",
+ "description": "Reports that a subagent invocation failed. The run may continue: a parent agent is free to handle a failed subagent, which is why this is not RUN_ERROR.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "SUBAGENT_ERROR"
+ },
+ "subagentRunId": {
+ "$ref": "#/definitions/SubagentRunId",
+ "description": "The invocation that failed."
+ },
+ "message": {
+ "type": "string",
+ "description": "What went wrong, for a person to read."
+ },
+ "code": {
+ "type": "string",
+ "description": "A machine-readable error code. An open string."
+ }
+ },
+ "required": [
+ "type",
+ "subagentRunId",
+ "message"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunFinishedOutcome": {
+ "description": "Why a run ended.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/RunFinishedSuccessOutcome"
+ },
+ {
+ "$ref": "#/definitions/RunFinishedInterruptOutcome"
+ },
+ {
+ "$ref": "#/definitions/RunFinishedCancelledOutcome"
+ }
+ ]
+ },
+ "RunFinishedSuccessOutcome": {
+ "type": "object",
+ "description": "The run completed. Equivalent to an absent outcome. Closed like every other object, which is also what keeps it from carrying the suspended sibling's interrupts \u2014 a success with an interrupt still pending would be a contradiction, not an extension. A completed run may still have left frontend tool calls for the application to answer; pendingToolCallIds names them.",
+ "properties": {
+ "type": {
+ "const": "success",
+ "description": "Discriminator."
+ },
+ "pendingToolCallIds": {
+ "type": "array",
+ "description": "The tool calls this run started and left unanswered \u2014 no TOOL_CALL_RESULT in the run \u2014 for the application to answer in the next input's messages, in the order they were made. Absent or empty means the producer named none, and a consumer derives the list from the stream; otherwise it is the list, and it agrees with the stream. On the success outcome rather than the event because a run that stopped on a frontend tool call is a completed run: whether the application continues the thread is its own decision, so the producer reports what it knows and no more.",
+ "items": {
+ "type": "string",
+ "description": "A tool call id, as carried by TOOL_CALL_START."
+ }
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunFinishedInterruptOutcome": {
+ "type": "object",
+ "description": "The run is paused, waiting for something outside it. Resuming means starting a new run whose resume entries answer these interrupts.",
+ "properties": {
+ "type": {
+ "const": "interrupt",
+ "description": "Discriminator."
+ },
+ "interrupts": {
+ "type": "array",
+ "description": "What the run is waiting for. At least one: an interrupt outcome with nothing to answer would leave a consumer with nothing to do.",
+ "minItems": 1,
+ "items": {
+ "$ref": "#/definitions/Interrupt"
+ }
+ }
+ },
+ "required": [
+ "type",
+ "interrupts"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunFinishedCancelledOutcome": {
+ "type": "object",
+ "description": "The run was stopped before it completed, by whoever was running it, and did not fail. Neither success nor interrupt: nothing was produced as a result, and nothing is waited for, so the next run on the thread is an ordinary new run rather than a resume. Closed like its siblings: a cancelled run has no interrupts to carry. Named in the schema before 1.0 because an outcome a consumer does not recognise is stripped and read as success \u2014 a cancellation added later would reach every 1.0 consumer as a completed run.",
+ "properties": {
+ "type": {
+ "const": "cancelled",
+ "description": "Discriminator."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "SubagentFinishedOutcome": {
+ "description": "Why a subagent's segment of a run ended. Mirrors RunFinishedOutcome one level down.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/SubagentFinishedSuccessOutcome"
+ },
+ {
+ "$ref": "#/definitions/SubagentFinishedSuspendedOutcome"
+ }
+ ]
+ },
+ "SubagentFinishedSuccessOutcome": {
+ "type": "object",
+ "description": "The subagent completed its work. Equivalent to an absent outcome.",
+ "properties": {
+ "type": {
+ "const": "success",
+ "description": "Discriminator."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "SubagentFinishedSuspendedOutcome": {
+ "type": "object",
+ "description": "The subagent is paused awaiting outside input. Terminal for this stream, not for the subagent: a later run may continue the same invocation once the interrupts are answered.",
+ "properties": {
+ "type": {
+ "const": "suspended",
+ "description": "Discriminator."
+ },
+ "interruptIds": {
+ "type": "array",
+ "description": "The run-level interrupts this subagent raised itself. May be empty or absent: a subagent suspended because a descendant interrupted owns no interrupt of its own.",
+ "items": {
+ "type": "string",
+ "description": "An Interrupt.id."
+ }
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "Interrupt": {
+ "type": "object",
+ "description": "Something a run needs from outside before it can continue, such as an approval or a missing value.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "Identifies the interrupt. A resume entry answers it by this id."
+ },
+ "reason": {
+ "type": "string",
+ "description": "Why the run stopped. An open string rather than an enumeration: the protocol does not attempt to classify every reason an agent might need input."
+ },
+ "message": {
+ "type": "string",
+ "description": "A human-readable prompt for whoever answers."
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "The tool call this interrupt concerns, when it is a tool approval."
+ },
+ "responseSchema": {
+ "type": "object",
+ "description": "A JSON Schema describing the answer this interrupt expects, so a consumer can build a form for it. Carried opaquely: the protocol does not constrain or validate it. Restricted to an object because TypeScript and Python both declare it that way; .NET holds it as any JSON, and the ticket that commissioned this schema lists it among the arbitrary-JSON fields. Following the two that constrain it keeps the schema from accepting documents the reference client rejects, at the cost of rejecting the boolean schemas JSON Schema also permits \u2014 a bare true for \"any answer\". Recorded as a known divergence rather than settled.",
+ "additionalProperties": true
+ },
+ "expiresAt": {
+ "type": "string",
+ "description": "When the interrupt stops being answerable. Deliberately unconstrained rather than a date-time format, because producers already disagree about the representation and tightening it here would reject streams that work today. The documented convention is ISO 8601, and a consumer comparing this value will parse it as a date, so a value that is not one leaves the interrupt looking permanently unexpired."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this interrupt."
+ }
+ },
+ "required": [
+ "id",
+ "reason"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ResumeEntry": {
+ "type": "object",
+ "description": "An answer to one interrupt, sent on the run that continues from it.",
+ "properties": {
+ "interruptId": {
+ "type": "string",
+ "description": "The interrupt being answered."
+ },
+ "status": {
+ "type": "string",
+ "description": "Whether the interrupt was answered or abandoned.",
+ "enum": [
+ "resolved",
+ "cancelled"
+ ]
+ },
+ "payload": {
+ "not": {
+ "type": "null"
+ },
+ "description": "The answer the agent asked for and will act on. Any JSON value."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Envelope information about the response, such as signatures or routing keys, as opposed to payload, which is the answer itself."
+ }
+ },
+ "required": [
+ "interruptId",
+ "status"
+ ],
+ "unevaluatedProperties": false
+ },
+ "TokenUsage": {
+ "type": "object",
+ "description": "Token counts for one provider and model, in the protocol's own accounting: every count is either a total or a named part of one, so entries from different providers add up without double-counting. inputTokens and outputTokens are the totals; reasoningTokens, cachedInputTokens and cacheWriteInputTokens are parts of them, never additions to them; totalTokens is the two totals summed. Every field is a label or a number \u2014 nothing content-bearing or identifying, no prompts, completions, messages, or thread, run and user identifiers.",
+ "properties": {
+ "provider": {
+ "type": "string",
+ "description": "Which provider served the request."
+ },
+ "model": {
+ "type": "string",
+ "description": "Which model served the request."
+ },
+ "inputTokens": {
+ "type": "integer",
+ "minimum": 0,
+ "maximum": 9007199254740991,
+ "description": "Every prompt token the call was charged for: tokens read from a provider cache, tokens written to one, and audio or other non-text input all count here. cachedInputTokens and cacheWriteInputTokens break this number down and are never added to it \u2014 a provider that reports its cache counts beside a smaller input count has them added in by the producer before the entry leaves. Bounded like timestamp and for the same reason: a count above the JSON safe-integer range does not survive a round trip, so a consumer would silently read a different number than the producer wrote."
+ },
+ "outputTokens": {
+ "type": "integer",
+ "minimum": 0,
+ "maximum": 9007199254740991,
+ "description": "Every generated token, reasoning included where the provider distinguishes it. reasoningTokens breaks this number down and is never added to it \u2014 a provider that reports reasoning tokens beside a smaller completion count has them added in by the producer."
+ },
+ "totalTokens": {
+ "type": "integer",
+ "minimum": 0,
+ "maximum": 9007199254740991,
+ "description": "inputTokens plus outputTokens, under the accounting above. A producer MAY compute it rather than copy a provider's total, and copies a provider's total only when that total counts the same way, so a consumer can read this field as the sum of the other two."
+ },
+ "reasoningTokens": {
+ "type": "integer",
+ "minimum": 0,
+ "maximum": 9007199254740991,
+ "description": "Output tokens spent on reasoning, where the provider distinguishes them. Part of outputTokens, not in addition to it."
+ },
+ "cachedInputTokens": {
+ "type": "integer",
+ "minimum": 0,
+ "maximum": 9007199254740991,
+ "description": "Input tokens read from a provider cache. Part of inputTokens, not in addition to it, and disjoint from cacheWriteInputTokens."
+ },
+ "cacheWriteInputTokens": {
+ "type": "integer",
+ "minimum": 0,
+ "maximum": 9007199254740991,
+ "description": "Input tokens written to a provider cache on this call, where the provider distinguishes them. Part of inputTokens, not in addition to it, and disjoint from cachedInputTokens. Its own field because providers price a cache write differently from a cache read, so a consumer computing cost cannot do without it."
+ }
+ },
+ "unevaluatedProperties": false
+ },
+ "Message": {
+ "description": "Any message in a conversation. Discriminated by role.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/DeveloperMessage"
+ },
+ {
+ "$ref": "#/definitions/SystemMessage"
+ },
+ {
+ "$ref": "#/definitions/AssistantMessage"
+ },
+ {
+ "$ref": "#/definitions/UserMessage"
+ },
+ {
+ "$ref": "#/definitions/ToolMessage"
+ },
+ {
+ "$ref": "#/definitions/ActivityMessage"
+ },
+ {
+ "$ref": "#/definitions/ReasoningMessage"
+ }
+ ]
+ },
+ "BaseMessage": {
+ "type": "object",
+ "description": "The fields shared by the developer, system, assistant and user messages. Deliberately excludes content, because a user message's content may be an array while the others are strings, and composition here intersects rather than overrides: a base that constrained content to a string would make an array content invalid. The tool, activity and reasoning messages do not compose this, because they carry no name.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "Identifies the message within the conversation."
+ },
+ "role": {
+ "type": "string",
+ "description": "Who the message is from. Each message definition narrows this to a single value."
+ },
+ "name": {
+ "type": "string",
+ "description": "An optional display name for the author."
+ },
+ "encryptedValue": {
+ "type": "string",
+ "description": "A provider's opaque artefact belonging to this message, stored by a consumer and returned on a later turn."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this message."
+ }
+ },
+ "required": [
+ "id",
+ "role"
+ ]
+ },
+ "DeveloperMessage": {
+ "type": "object",
+ "description": "Instructions from the application developer.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseMessage"
+ }
+ ],
+ "properties": {
+ "role": {
+ "const": "developer"
+ },
+ "content": {
+ "type": "string",
+ "description": "The instructions. Required: a developer message with nothing in it says nothing."
+ }
+ },
+ "required": [
+ "id",
+ "role",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "SystemMessage": {
+ "type": "object",
+ "description": "Instructions from the system.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseMessage"
+ }
+ ],
+ "properties": {
+ "role": {
+ "const": "system"
+ },
+ "content": {
+ "type": "string",
+ "description": "The instructions. Required."
+ }
+ },
+ "required": [
+ "id",
+ "role",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "AssistantMessage": {
+ "type": "object",
+ "description": "A message from the agent. Content is optional because a turn may consist only of tool calls.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseMessage"
+ }
+ ],
+ "properties": {
+ "role": {
+ "const": "assistant"
+ },
+ "content": {
+ "type": "string",
+ "description": "What the agent said, if it said anything."
+ },
+ "toolCalls": {
+ "type": "array",
+ "description": "The tool calls this turn made.",
+ "items": {
+ "$ref": "#/definitions/ToolCall"
+ }
+ }
+ },
+ "required": [
+ "id",
+ "role"
+ ],
+ "unevaluatedProperties": false
+ },
+ "UserMessage": {
+ "type": "object",
+ "description": "A message from the person using the application.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseMessage"
+ }
+ ],
+ "properties": {
+ "role": {
+ "const": "user"
+ },
+ "content": {
+ "description": "What the person sent: either plain text, or an ordered list of parts for a multimodal message.",
+ "oneOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/ContentPart"
+ }
+ }
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "role",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolMessage": {
+ "type": "object",
+ "description": "What a tool returned, as a message in the conversation. Stands alone rather than composing BaseMessage, because it carries no name.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "Identifies the message."
+ },
+ "role": {
+ "const": "tool",
+ "description": "Fixed. Declared here rather than inherited, because this message does not compose BaseMessage."
+ },
+ "content": {
+ "description": "What the tool returned: either plain text, or an ordered list of parts. A tool returning structured data serialises it into text; media travel as parts of their own.",
+ "oneOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/ContentPart"
+ }
+ }
+ ]
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "The call this answers."
+ },
+ "error": {
+ "type": "string",
+ "description": "Why the tool failed, when it did. Present alongside content rather than instead of it, so a partial result survives a failure."
+ },
+ "encryptedValue": {
+ "type": "string",
+ "description": "A provider's opaque artefact belonging to this message."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this message."
+ }
+ },
+ "required": [
+ "id",
+ "role",
+ "content",
+ "toolCallId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ActivityMessage": {
+ "type": "object",
+ "description": "Structured progress that is not conversation content, materialised as a message so it keeps its place in the sequence. Stands alone rather than composing BaseMessage, because its content is an object rather than a string.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "Identifies the message."
+ },
+ "role": {
+ "const": "activity",
+ "description": "Fixed. Declared here rather than inherited, because this message does not compose BaseMessage."
+ },
+ "activityType": {
+ "type": "string",
+ "description": "What kind of activity this is. An open string: the set is the producer's."
+ },
+ "content": {
+ "type": "object",
+ "description": "The activity's payload, open by key.",
+ "additionalProperties": true
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this message."
+ }
+ },
+ "required": [
+ "id",
+ "role",
+ "activityType",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningMessage": {
+ "type": "object",
+ "description": "A span of the agent's reasoning, materialised as a message. Stands alone rather than composing BaseMessage, because it carries no name.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "Identifies the message."
+ },
+ "role": {
+ "const": "reasoning",
+ "description": "Fixed. Declared here rather than inherited, because this message does not compose BaseMessage."
+ },
+ "content": {
+ "type": "string",
+ "description": "The reasoning text."
+ },
+ "encryptedValue": {
+ "type": "string",
+ "description": "A provider's opaque reasoning artefact belonging to this message."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this message."
+ }
+ },
+ "required": [
+ "id",
+ "role",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolCall": {
+ "type": "object",
+ "description": "A call an assistant message made. Carries no subagent attribution of its own and inherits its containing message's, since several calls can share one parent.",
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "Identifies the call. The answering tool message carries this as its toolCallId."
+ },
+ "type": {
+ "const": "function",
+ "description": "The only kind of call the protocol models."
+ },
+ "function": {
+ "$ref": "#/definitions/FunctionCall",
+ "description": "What is being called, and with what."
+ },
+ "encryptedValue": {
+ "type": "string",
+ "description": "A provider's opaque artefact belonging to this call."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this call. Carried here rather than folded into the containing message, because several calls can share one parent and merging them would make the result depend on their order."
+ }
+ },
+ "required": [
+ "id",
+ "type",
+ "function"
+ ],
+ "unevaluatedProperties": false
+ },
+ "FunctionCall": {
+ "type": "object",
+ "description": "The name and arguments of a tool call.",
+ "properties": {
+ "name": {
+ "type": "string",
+ "description": "Which tool is being called."
+ },
+ "arguments": {
+ "type": "string",
+ "description": "The arguments as a JSON string, not as parsed JSON. Kept as written because a model can emit arguments that are not valid JSON, and losing them at the protocol boundary would hide the fault from the consumer that has to handle it."
+ }
+ },
+ "required": [
+ "name",
+ "arguments"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ContentPart": {
+ "description": "One part of a message body: what a person sends in a user message, or what a tool returns in a tool message. Discriminated by type. Named by what the part is rather than by direction, because the same part travels into the model inside a user message and back out of the stream inside a tool result.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/TextPart"
+ },
+ {
+ "$ref": "#/definitions/ImagePart"
+ },
+ {
+ "$ref": "#/definitions/AudioPart"
+ },
+ {
+ "$ref": "#/definitions/VideoPart"
+ },
+ {
+ "$ref": "#/definitions/DocumentPart"
+ }
+ ]
+ },
+ "TextPart": {
+ "type": "object",
+ "description": "A text part.",
+ "properties": {
+ "type": {
+ "const": "text",
+ "description": "Discriminator."
+ },
+ "id": {
+ "type": "string",
+ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved so that a streamed part can be matched to its entry in history once assistant messages carry parts too."
+ },
+ "text": {
+ "type": "string",
+ "description": "The text."
+ },
+ "metadata": {
+ "not": {
+ "type": "null"
+ },
+ "description": "Extra information about this part. Unconstrained, as on the media parts. This is where a text search hit carries its source and title, rather than the protocol modelling a search-result part of its own."
+ }
+ },
+ "required": [
+ "type",
+ "text"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ImagePart": {
+ "type": "object",
+ "description": "An image part.",
+ "properties": {
+ "type": {
+ "const": "image",
+ "description": "Discriminator."
+ },
+ "id": {
+ "type": "string",
+ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."
+ },
+ "source": {
+ "$ref": "#/definitions/PartSource",
+ "description": "Where the image comes from."
+ },
+ "metadata": {
+ "not": {
+ "type": "null"
+ },
+ "description": "Extra information about this part. Unconstrained rather than an object: inherited from the SDKs, which declare it unknown rather than a record; listed under known divergences in the README rather than resolved here."
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "unevaluatedProperties": false
+ },
+ "AudioPart": {
+ "type": "object",
+ "description": "An audio part.",
+ "properties": {
+ "type": {
+ "const": "audio",
+ "description": "Discriminator."
+ },
+ "id": {
+ "type": "string",
+ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."
+ },
+ "source": {
+ "$ref": "#/definitions/PartSource",
+ "description": "Where the audio comes from."
+ },
+ "metadata": {
+ "not": {
+ "type": "null"
+ },
+ "description": "Extra information about this part. Unconstrained, as on the other media parts."
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "unevaluatedProperties": false
+ },
+ "VideoPart": {
+ "type": "object",
+ "description": "A video part.",
+ "properties": {
+ "type": {
+ "const": "video",
+ "description": "Discriminator."
+ },
+ "id": {
+ "type": "string",
+ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."
+ },
+ "source": {
+ "$ref": "#/definitions/PartSource",
+ "description": "Where the video comes from."
+ },
+ "metadata": {
+ "not": {
+ "type": "null"
+ },
+ "description": "Extra information about this part. Unconstrained, as on the other media parts."
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "unevaluatedProperties": false
+ },
+ "DocumentPart": {
+ "type": "object",
+ "description": "A document part.",
+ "properties": {
+ "type": {
+ "const": "document",
+ "description": "Discriminator."
+ },
+ "id": {
+ "type": "string",
+ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."
+ },
+ "source": {
+ "$ref": "#/definitions/PartSource",
+ "description": "Where the document comes from."
+ },
+ "metadata": {
+ "not": {
+ "type": "null"
+ },
+ "description": "Extra information about this part. Unconstrained, as on the other media parts."
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "unevaluatedProperties": false
+ },
+ "PartSource": {
+ "description": "Where a media part's bytes come from: carried inline, referenced by URL, or already at the provider under a handle it issued.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/DataSource"
+ },
+ {
+ "$ref": "#/definitions/UrlSource"
+ },
+ {
+ "$ref": "#/definitions/FileSource"
+ }
+ ]
+ },
+ "DataSource": {
+ "type": "object",
+ "description": "Bytes carried inline.",
+ "properties": {
+ "type": {
+ "const": "data",
+ "description": "Discriminator."
+ },
+ "value": {
+ "type": "string",
+ "contentEncoding": "base64",
+ "description": "The bytes, base64-encoded. contentEncoding is an annotation rather than a constraint in 2020-12, so a malformed string still validates here; rejecting one is the decoder's job."
+ },
+ "mimeType": {
+ "type": "string",
+ "description": "What the bytes are. Required here, unlike on a URL source, because nothing else can tell a consumer how to read them."
+ }
+ },
+ "required": [
+ "type",
+ "value",
+ "mimeType"
+ ],
+ "unevaluatedProperties": false
+ },
+ "UrlSource": {
+ "type": "object",
+ "description": "Bytes referenced by URL, fetched by whoever needs them.",
+ "properties": {
+ "type": {
+ "const": "url",
+ "description": "Discriminator."
+ },
+ "value": {
+ "type": "string",
+ "description": "The URL. Deliberately not constrained to a URI format, so a scheme a producer already uses is not rejected here."
+ },
+ "mimeType": {
+ "type": "string",
+ "description": "What the resource is, when the producer knows. Optional, because the response can say."
+ }
+ },
+ "required": [
+ "type",
+ "value"
+ ],
+ "unevaluatedProperties": false
+ },
+ "FileSource": {
+ "type": "object",
+ "description": "Bytes already at the provider, named by a handle the provider issued: an OpenAI or Anthropic file id, a Gemini file URI, a storage URL only that provider can read. No bytes travel and nothing is fetched. Only the provider that minted the handle can resolve it; a peer that cannot drops the part as it drops any part it cannot use.",
+ "properties": {
+ "type": {
+ "const": "file",
+ "description": "Discriminator."
+ },
+ "value": {
+ "type": "string",
+ "description": "The handle, exactly as the provider issued it. Opaque: a consumer MUST NOT fetch it, parse it or read a scheme out of it."
+ },
+ "provider": {
+ "type": "string",
+ "description": "Who issued the handle, when the producer knows. Optional: an agent already knows which provider it talks to. When present, SHOULD be the lowercase vendor id (openai, anthropic, google) that TokenUsage.provider uses, so a peer can tell before sending whether a handle is one it can use."
+ },
+ "mimeType": {
+ "type": "string",
+ "description": "What the file is, when the producer knows. Optional, because the provider that holds the bytes knows."
+ }
+ },
+ "required": [
+ "type",
+ "value"
+ ],
+ "unevaluatedProperties": false
+ },
+ "Context": {
+ "type": "object",
+ "description": "A named piece of ambient information given to the agent for the run, distinct from the conversation.",
+ "properties": {
+ "description": {
+ "type": "string",
+ "description": "What this context is, for the agent to interpret."
+ },
+ "value": {
+ "type": "string",
+ "description": "The context itself."
+ }
+ },
+ "required": [
+ "description",
+ "value"
+ ],
+ "unevaluatedProperties": false
+ },
+ "Tool": {
+ "type": "object",
+ "description": "A tool the agent may call.",
+ "properties": {
+ "name": {
+ "type": "string",
+ "description": "The tool's name, as the agent will call it."
+ },
+ "description": {
+ "type": "string",
+ "description": "What the tool does, for the agent to decide when to use it."
+ },
+ "parameters": {
+ "not": {
+ "type": "null"
+ },
+ "description": "A JSON Schema describing the tool's arguments. Carried opaquely: the protocol does not constrain or validate it. Optional, because all three SDKs already treat it that way and a tool that takes no arguments has nothing to declare; an absent schema and an empty one mean the same thing to an agent."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information about the tool, for consumers that attach their own rendering or routing information to it."
+ }
+ },
+ "required": [
+ "name",
+ "description"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunAgentInput": {
+ "type": "object",
+ "description": "A request to run an agent. Also echoed back as RUN_STARTED.input. Only threadId, runId and messages are required: those are the three the SDKs already agree on, and for tools and context an absent key and an empty array mean the same thing, so requiring them would catch nothing a producer could get wrong.",
+ "properties": {
+ "threadId": {
+ "type": "string",
+ "description": "The conversation this run belongs to."
+ },
+ "runId": {
+ "type": "string",
+ "description": "Identifies this run."
+ },
+ "protocolVersion": {
+ "type": "string",
+ "description": "The protocol version this consumer speaks, such as \"1.0\". Absent means the input was produced before the protocol carried a version \u2014 the versioning rules in the prose govern what each side does with that. Sent in-band rather than by the transport, so a recorded exchange stays self-describing."
+ },
+ "parentRunId": {
+ "type": "string",
+ "description": "The run that spawned this one."
+ },
+ "state": {
+ "not": {
+ "type": "null"
+ },
+ "$ref": "#/definitions/State",
+ "description": "The state the run starts from."
+ },
+ "messages": {
+ "type": "array",
+ "description": "The conversation so far, in order.",
+ "items": {
+ "$ref": "#/definitions/Message"
+ }
+ },
+ "tools": {
+ "type": "array",
+ "description": "The tools the agent may call. Absent means none.",
+ "items": {
+ "$ref": "#/definitions/Tool"
+ }
+ },
+ "context": {
+ "type": "array",
+ "description": "Ambient information for the run. Absent means none.",
+ "items": {
+ "$ref": "#/definitions/Context"
+ }
+ },
+ "forwardedProps": {
+ "not": {
+ "type": "null"
+ },
+ "description": "Application-specific values passed through to the agent untouched. Any JSON value."
+ },
+ "resume": {
+ "type": "array",
+ "description": "Answers to the interrupts that ended a previous run, when this run continues from one.",
+ "items": {
+ "$ref": "#/definitions/ResumeEntry"
+ }
+ }
+ },
+ "required": [
+ "threadId",
+ "runId",
+ "messages"
+ ],
+ "unevaluatedProperties": false
+ },
+ "JsonPatch": {
+ "type": "array",
+ "description": "A JSON Patch document as defined by RFC 6902, referenced by STATE_DELTA.delta and ACTIVITY_DELTA.patch: an ordered sequence of operations applied to a target document. An empty array is a valid no-op patch. Whether the operations actually apply to the document they target is a runtime question RFC 6902 leaves to the applier; structural validity here says nothing about it.",
+ "items": {
+ "$ref": "#/definitions/JsonPatchOperation"
+ }
+ },
+ "JsonPatchOperation": {
+ "description": "A single RFC 6902 operation. Exactly one of the operation shapes must match, discriminated by op. Unlike the protocol's own objects, the operations are open: RFC 6902 section 4 requires members an operation does not define to be ignored rather than rejected, so a remove carrying a leftover value is a valid patch. Two of the RFC's rules are relations between values rather than shapes, so no static schema can express them and neither is checked here: a move whose from is a proper prefix of its path (section 4.4), and any operation whose pointer does not resolve in the target document. Both are the applier's to reject.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/AddOperation"
+ },
+ {
+ "$ref": "#/definitions/RemoveOperation"
+ },
+ {
+ "$ref": "#/definitions/ReplaceOperation"
+ },
+ {
+ "$ref": "#/definitions/MoveOperation"
+ },
+ {
+ "$ref": "#/definitions/CopyOperation"
+ },
+ {
+ "$ref": "#/definitions/TestOperation"
+ }
+ ]
+ },
+ "AddOperation": {
+ "type": "object",
+ "description": "Inserts value at path. RFC 6902 section 4.1.",
+ "properties": {
+ "op": {
+ "const": "add",
+ "description": "Discriminator for the add operation."
+ },
+ "path": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "Where to insert the value."
+ },
+ "value": {
+ "description": "The value to insert. Any JSON value, including null, which is a legitimate thing to add."
+ }
+ },
+ "required": [
+ "op",
+ "path",
+ "value"
+ ]
+ },
+ "RemoveOperation": {
+ "type": "object",
+ "description": "Removes the value at path. RFC 6902 section 4.2.",
+ "properties": {
+ "op": {
+ "const": "remove",
+ "description": "Discriminator for the remove operation."
+ },
+ "path": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "What to remove."
+ }
+ },
+ "required": [
+ "op",
+ "path"
+ ]
+ },
+ "ReplaceOperation": {
+ "type": "object",
+ "description": "Replaces the value at path. RFC 6902 section 4.3.",
+ "properties": {
+ "op": {
+ "const": "replace",
+ "description": "Discriminator for the replace operation."
+ },
+ "path": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "What to replace."
+ },
+ "value": {
+ "description": "The replacement. Any JSON value, including null."
+ }
+ },
+ "required": [
+ "op",
+ "path",
+ "value"
+ ]
+ },
+ "MoveOperation": {
+ "type": "object",
+ "description": "Moves the value at from to path. RFC 6902 section 4.4.",
+ "properties": {
+ "op": {
+ "const": "move",
+ "description": "Discriminator for the move operation."
+ },
+ "from": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "Where the value is moved from."
+ },
+ "path": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "Where the value is moved to."
+ }
+ },
+ "required": [
+ "op",
+ "from",
+ "path"
+ ]
+ },
+ "CopyOperation": {
+ "type": "object",
+ "description": "Copies the value at from to path. RFC 6902 section 4.5.",
+ "properties": {
+ "op": {
+ "const": "copy",
+ "description": "Discriminator for the copy operation."
+ },
+ "from": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "Where the value is copied from."
+ },
+ "path": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "Where the value is copied to."
+ }
+ },
+ "required": [
+ "op",
+ "from",
+ "path"
+ ]
+ },
+ "TestOperation": {
+ "type": "object",
+ "description": "Asserts that the value at path equals value. RFC 6902 section 4.6.",
+ "properties": {
+ "op": {
+ "const": "test",
+ "description": "Discriminator for the test operation."
+ },
+ "path": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "What to compare."
+ },
+ "value": {
+ "description": "The value the target must equal. Any JSON value, including null."
+ }
+ },
+ "required": [
+ "op",
+ "path",
+ "value"
+ ]
+ },
+ "JsonPointer": {
+ "type": "string",
+ "description": "A JSON Pointer as defined by RFC 6901. Either the empty string, meaning the whole document, or a sequence of slash-prefixed reference tokens in which a tilde is escaped as ~0 and a slash as ~1. A value with no leading slash, or a tilde followed by anything other than 0 or 1, is not a JSON Pointer.",
+ "pattern": "^(/([^/~]|~[01])*)*$"
+ },
+ "OvSource": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "url",
+ "title",
+ "site"
+ ],
+ "properties": {
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://",
+ "maxLength": 2048
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 300
+ },
+ "site": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ }
+ }
+ },
+ "Event": {
+ "description": "Any AG-UI event. Every member is normative: there is no optional tier and no event a consumer may decline to implement. Discriminated by the type property.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/TextMessageStartEvent"
+ },
+ {
+ "$ref": "#/definitions/TextMessageContentEvent"
+ },
+ {
+ "$ref": "#/definitions/TextMessageEndEvent"
+ },
+ {
+ "$ref": "#/definitions/TextMessageChunkEvent"
+ },
+ {
+ "$ref": "#/definitions/ToolCallStartEvent"
+ },
+ {
+ "$ref": "#/definitions/ToolCallArgsEvent"
+ },
+ {
+ "$ref": "#/definitions/ToolCallEndEvent"
+ },
+ {
+ "$ref": "#/definitions/ToolCallChunkEvent"
+ },
+ {
+ "$ref": "#/definitions/ToolCallResultEvent"
+ },
+ {
+ "$ref": "#/definitions/StateSnapshotEvent"
+ },
+ {
+ "$ref": "#/definitions/StateDeltaEvent"
+ },
+ {
+ "$ref": "#/definitions/MessagesSnapshotEvent"
+ },
+ {
+ "$ref": "#/definitions/ActivitySnapshotEvent"
+ },
+ {
+ "$ref": "#/definitions/ActivityDeltaEvent"
+ },
+ {
+ "$ref": "#/definitions/RawEvent"
+ },
+ {
+ "$ref": "#/definitions/CustomEvent"
+ },
+ {
+ "$ref": "#/definitions/RunStartedEvent"
+ },
+ {
+ "$ref": "#/definitions/RunFinishedEvent"
+ },
+ {
+ "$ref": "#/definitions/RunErrorEvent"
+ },
+ {
+ "$ref": "#/definitions/StepStartedEvent"
+ },
+ {
+ "$ref": "#/definitions/StepFinishedEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningStartEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningMessageStartEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningMessageContentEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningMessageEndEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningMessageChunkEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningEndEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningEncryptedValueEvent"
+ },
+ {
+ "$ref": "#/definitions/SubagentStartedEvent"
+ },
+ {
+ "$ref": "#/definitions/SubagentFinishedEvent"
+ },
+ {
+ "$ref": "#/definitions/SubagentErrorEvent"
+ }
+ ]
+ }
+ }
+}
@@ -5547,6 +5547,24 @@
@@ -5547,6 +5547,24 @@
"compatibility": "backward",
"compatibility": "backward",
"status": "active"
"status": "active"
},
},
+ {
+ "id": "chat.command-registration-request",
+ "version": "1.0.0",
+ "owner": "chat",
+ "schema": "chat/command-registration-request.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "chat.command-registration-result",
+ "version": "1.0.0",
+ "owner": "chat",
+ "schema": "chat/command-registration-result.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
{
{
"id": "chat.send-request",
"id": "chat.send-request",
"version": "1.1.0",
"version": "1.1.0",
@@ -5700,6 +5718,24 @@
@@ -5700,6 +5718,24 @@
"compatibility": "backward",
"compatibility": "backward",
"status": "active"
"status": "active"
},
},
+ {
+ "id": "chat.person-memory-result",
+ "version": "1.0.0",
+ "owner": "chat",
+ "schema": "chat/person-memory-result.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "chat.person-memory-preferences-result",
+ "version": "1.0.0",
+ "owner": "chat",
+ "schema": "chat/person-memory-preferences-result.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
{
{
"id": "chat.embed",
"id": "chat.embed",
"version": "1.0.0",
"version": "1.0.0",
@@ -6170,6 +6206,24 @@
@@ -6170,6 +6206,24 @@
"compatibility": "backward",
"compatibility": "backward",
"status": "active"
"status": "active"
},
},
+ {
+ "id": "community.feed-card",
+ "version": "1.0.0",
+ "owner": "community",
+ "schema": "community/feed-card.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "community.feed-answer",
+ "version": "1.0.0",
+ "owner": "community",
+ "schema": "community/feed-answer.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
{
{
"id": "community.pulse-read-result",
"id": "community.pulse-read-result",
"version": "1.0.0",
"version": "1.0.0",
@@ -11258,6 +11312,105 @@
@@ -11258,6 +11312,105 @@
"visibility": "public",
"visibility": "public",
"compatibility": "backward",
"compatibility": "backward",
"status": "active"
"status": "active"
+ },
+ {
+ "id": "composer.attachment",
+ "version": "1.0.0",
+ "owner": "media",
+ "schema": "composer/attachment.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "composer.prefs",
+ "version": "1.0.0",
+ "owner": "network",
+ "schema": "composer/prefs.v1.json",
+ "visibility": "first-party",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "composer.mention",
+ "version": "1.0.0",
+ "owner": "network",
+ "schema": "composer/mention.v1.json",
+ "visibility": "first-party",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "network.user-card",
+ "version": "1.0.0",
+ "owner": "network",
+ "schema": "network/user-card.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "network.user-report",
+ "version": "1.0.0",
+ "owner": "network",
+ "schema": "network/user-report.v1.json",
+ "visibility": "first-party",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "network.user-report-list-result",
+ "version": "1.0.0",
+ "owner": "network",
+ "schema": "network/user-report-list-result.v1.json",
+ "visibility": "first-party",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "network.user-report-request",
+ "version": "1.0.0",
+ "owner": "network",
+ "schema": "network/user-report-request.v1.json",
+ "visibility": "first-party",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "agent.ui-event",
+ "version": "1.0.0",
+ "owner": "actor",
+ "schema": "agent/ui-event.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "agent.run",
+ "version": "1.0.0",
+ "owner": "actor",
+ "schema": "agent/run.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "actor.agent-sheet",
+ "version": "1.0.0",
+ "owner": "actor",
+ "schema": "actor/agent-sheet.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
+ },
+ {
+ "id": "codes.agent-sheet",
+ "version": "1.0.0",
+ "owner": "codes",
+ "schema": "codes/agent-sheet.v1.json",
+ "visibility": "public",
+ "compatibility": "backward",
+ "status": "active"
}
}
]
]
}
}
new file mode 100644
new file mode 100644
@@ -0,0 +1,14 @@
@@ -0,0 +1,14 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/chat/command-registration-request.v1.json",
+ "title": "Chat command registration request",
+ "description": "chat.command-registration-request@1: an approved app or Actor agent registers a plain-response command in a server that the person named in its service token manages. The command cannot override a built-in. The template's {args} placeholder receives the invoking person's argument text; Chat posts the expanded result as that person after checking their current room rights.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["server", "command", "response_template"],
+ "properties": {
+ "server": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{1,31}$" },
+ "command": { "$ref": "command.v1.json" },
+ "response_template": { "type": "string", "minLength": 1, "maxLength": 2000 }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,12 @@
@@ -0,0 +1,12 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/chat/command-registration-result.v1.json",
+ "title": "Chat command registration result",
+ "description": "chat.command-registration-result@1: the command Chat stored for an approved app or Actor agent, with source and application_id derived from the verified service token.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["command"],
+ "properties": {
+ "command": { "$ref": "command.v1.json" }
+ }
+}
@@ -2,14 +2,34 @@
@@ -2,14 +2,34 @@
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://openvibe.network/contracts/chat/embed.v1.json",
"$id": "https://openvibe.network/contracts/chat/embed.v1.json",
"title": "ChatEmbed",
"title": "ChatEmbed",
- "description": "chat.embed@1: one address preview under a chat message, the same shape for every client (OpenVibe.Chat, Live's chat and the Dock). A message carries `embeds` in the order the addresses appeared in its text, at most three; it is empty while the background job is still reading, and the client draws each one as the same card. The fields are data, never markup: a client escapes them (title, description, site_name, by) before drawing them. url is the address the writer sent, https only. image is an OpenVibe.Media address or null: another site's picture is never hot-linked. width and height are the picture's stated size, or 0. kind names what was found: an ordinary page (`link`), a video (`video`), a picture (`image`), a Live channel (`live`), a Pics picture (`picture`), a Design item (`design`), a Community post (`post`), a Network profile (`profile`) or a Games world (`game`). OpenVibe's own kinds are resolved through that service's public API, never by reading its page, and carry by (the person or channel the thing belongs to) and, for Live, live (whether the channel is broadcasting now); both are absent on an ordinary link.",
+ "description": "chat.embed@1: one address preview under a chat message, the same shape for every client (OpenVibe.Chat, Live's chat and the Dock). A message carries `embeds` in the order the addresses appeared in its text, at most three; it is empty while the background job is still reading, and the client draws each one as the same card. The fields are data, never markup: a client escapes them (title, description, site_name, by) before drawing them. url is the address the writer sent, https only. image is an OpenVibe.Media address or null: another site's picture is never hot-linked. width and height are the picture's stated size, or 0. kind names what was found: an ordinary page (`link`), a video (`video`), a picture (`image`), a Live channel (`live`), a Pics picture (`picture`), a Design item (`design`), a Community post (`post`), a Network profile (`profile`) or a Games world (`game`). OpenVibe's own kinds are resolved through that service's public API, never by reading its page, and carry by (the person or channel the thing belongs to) and, for Live, live (whether the channel is broadcasting now); both are absent on an ordinary link. An agent-run embed carries the live run and event addresses, title and status.",
"type": "object",
"type": "object",
"additionalProperties": false,
"additionalProperties": false,
- "required": ["kind", "url", "site_name", "title", "description", "image", "width", "height"],
+ "required": [
+ "kind",
+ "url",
+ "site_name",
+ "title",
+ "description",
+ "image",
+ "width",
+ "height"
+ ],
"properties": {
"properties": {
"kind": {
"kind": {
"type": "string",
"type": "string",
- "enum": ["link", "video", "image", "live", "picture", "design", "post", "profile", "game"],
+ "enum": [
+ "link",
+ "video",
+ "image",
+ "live",
+ "picture",
+ "design",
+ "post",
+ "profile",
+ "game",
+ "agent-run"
+ ],
"description": "What the address turned out to be; a client may draw the same card for every value."
"description": "What the address turned out to be; a client may draw the same card for every value."
},
},
"url": {
"url": {
@@ -27,8 +47,7 @@
@@ -27,8 +47,7 @@
"title": {
"title": {
"type": "string",
"type": "string",
"minLength": 1,
"minLength": 1,
- "maxLength": 120,
- "description": "The page's or service's title, folded to plain text."
+ "maxLength": 240
},
},
"description": {
"description": {
"type": "string",
"type": "string",
@@ -36,7 +55,10 @@
@@ -36,7 +55,10 @@
"description": "A short plain-text description, or an empty string when the source states none."
"description": "A short plain-text description, or an empty string when the source states none."
},
},
"image": {
"image": {
- "type": ["string", "null"],
+ "type": [
+ "string",
+ "null"
+ ],
"format": "uri",
"format": "uri",
"maxLength": 2048,
"maxLength": 2048,
"description": "The preview picture, only when it already lives on OpenVibe.Media; null when the source's picture would have to be hot-linked."
"description": "The preview picture, only when it already lives on OpenVibe.Media; null when the source's picture would have to be hot-linked."
@@ -61,6 +83,51 @@
@@ -61,6 +83,51 @@
"live": {
"live": {
"type": "boolean",
"type": "boolean",
"description": "On a Live channel kind, whether it is broadcasting now. Absent on the other kinds."
"description": "On a Live channel kind, whether it is broadcasting now. Absent on the other kinds."
+ },
+ "run_url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://",
+ "maxLength": 2048
+ },
+ "events_url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://",
+ "maxLength": 2048
+ },
+ "status": {
+ "enum": [
+ "queued",
+ "running",
+ "waiting",
+ "needs_you",
+ "succeeded",
+ "failed",
+ "stopped",
+ "cancelled"
+ ]
+ }
+ },
+ "allOf": [
+ {
+ "if": {
+ "properties": {
+ "kind": {
+ "const": "agent-run"
+ }
+ },
+ "required": [
+ "kind"
+ ]
+ },
+ "then": {
+ "required": [
+ "run_url",
+ "events_url",
+ "status"
+ ]
+ }
}
}
- }
+ ]
}
}
new file mode 100644
new file mode 100644
@@ -0,0 +1,13 @@
@@ -0,0 +1,13 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/chat/person-memory-preferences-result.v1.json",
+ "title": "ChatPersonMemoryPreferencesResult",
+ "description": "chat.person-memory-preferences-result@1: the person's delete or opt-out result.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["opted_out"],
+ "properties": {
+ "opted_out": { "type": "boolean" },
+ "deleted": { "type": "boolean" }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,46 @@
@@ -0,0 +1,46 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/chat/person-memory-result.v1.json",
+ "title": "ChatPersonMemoryResult",
+ "description": "chat.person-memory-result@1: compacted chat memory returned by GET /api/v1/people/{username}/memory. Private fields appear only for the person and the channel owner.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["username", "level", "channel", "entries", "opted_out", "enabled"],
+ "properties": {
+ "username": { "type": "string", "minLength": 1 },
+ "level": { "enum": ["day", "week", "month"] },
+ "channel": { "type": ["string", "null"] },
+ "opted_out": { "type": "boolean" },
+ "enabled": { "type": "boolean" },
+ "entries": {
+ "type": "array", "maxItems": 60,
+ "items": {
+ "type": "object", "additionalProperties": false,
+ "required": ["level", "period_start", "channel_user_id", "summary", "topics", "highlights", "message_count"],
+ "properties": {
+ "level": { "enum": ["day", "week", "month"] },
+ "period_start": { "type": "string", "format": "date" },
+ "channel_user_id": { "type": "integer" },
+ "summary": { "type": "string", "maxLength": 500 },
+ "topics": { "type": "array", "maxItems": 5, "items": { "type": "string" } },
+ "highlights": {
+ "type": "array", "maxItems": 5,
+ "items": {
+ "type": "object", "additionalProperties": false,
+ "required": ["detail", "stream_id", "at"],
+ "properties": {
+ "detail": { "type": "string", "maxLength": 180 },
+ "stream_id": { "type": ["integer", "null"] },
+ "at": { "type": ["string", "null"] }
+ }
+ }
+ },
+ "message_count": { "type": "integer", "minimum": 0 },
+ "tone": { "type": "string", "maxLength": 120 },
+ "catchphrases": { "type": "array", "maxItems": 5, "items": { "type": "string" } },
+ "people": { "type": "array", "maxItems": 8, "items": { "type": "string" } }
+ }
+ }
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,24 @@
@@ -0,0 +1,24 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/codes/agent-sheet.v1.json",
+ "title": "CodesAgentSheet",
+ "description": "codes.agent-sheet@1: one owner's coding harness, its real attempts, outcomes and machine availability. Empty memory, schedule and computer sections mean Codes has no such per-harness records. GET /api/v1/me/agents/:id/sheet; never cache this answer.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["agent", "now", "work", "activity", "asks", "asks_empty", "computer", "schedules", "memory", "identity"],
+ "properties": {
+ "agent": {"type": "object", "required": ["id", "name", "face", "state", "kind", "availability"], "properties": {"id": {"type": "string"}, "name": {"type": "string"}, "face": {"type": "null"}, "state": {"type": "string"}, "kind": {"const": "coding harness"}, "availability": {"type": ["object", "null"]}}, "additionalProperties": false},
+ "now": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/work"}]},
+ "work": {"type": "array", "items": {"$ref": "#/$defs/work"}},
+ "activity": {"type": "array", "items": {"type": "object", "required": ["day", "entries"], "properties": {"day": {"type": "string", "format": "date"}, "entries": {"type": "array", "items": {"type": "object"}}}, "additionalProperties": false}},
+ "asks": {"type": "array", "maxItems": 0},
+ "asks_empty": {"type": "string"},
+ "computer": {"type": "null"},
+ "schedules": {"type": "array", "maxItems": 0},
+ "memory": {"type": "array", "maxItems": 0},
+ "identity": {"type": "object", "required": ["provider", "capabilities"], "properties": {"provider": {"type": ["string", "null"]}, "capabilities": {"type": "object"}}, "additionalProperties": false}
+ },
+ "$defs": {
+ "work": {"type": "object", "additionalProperties": false, "required": ["id", "task_id", "title", "what", "result", "state", "outcome", "cost_usd", "machine", "repo", "started_at", "finished_at", "url"], "properties": {"id": {"type": "string"}, "task_id": {"type": "string"}, "title": {"type": "string"}, "what": {"type": ["string", "null"]}, "result": {"type": ["string", "null"]}, "state": {"type": "string"}, "outcome": {"type": ["string", "null"]}, "cost_usd": {"type": ["number", "null"], "minimum": 0}, "machine": {"type": ["string", "null"]}, "repo": {"type": ["string", "null"]}, "started_at": {"type": "string"}, "finished_at": {"type": ["string", "null"]}, "url": {"type": "string"}}}
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,13 @@
@@ -0,0 +1,13 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/community/feed-answer.v1.json",
+ "title": "CommunityFeedAnswer",
+ "description": "community.feed-answer@1: the response from GET /api/v1/feed.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["items", "next_cursor"],
+ "properties": {
+ "items": { "type": "array", "items": { "$ref": "feed-card.v1.json" } },
+ "next_cursor": { "type": ["string", "null"] }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,24 @@
@@ -0,0 +1,24 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/community/feed-card.v1.json",
+ "title": "CommunityFeedCard",
+ "description": "community.feed-card@1: one public card returned by GET /api/v1/feed on OpenVibe.Community.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["id", "kind", "url", "title", "text", "at", "site", "site_name", "actor", "media", "counts"],
+ "properties": {
+ "id": { "type": "string", "minLength": 1, "maxLength": 500 },
+ "kind": { "enum": ["live", "stream", "clip", "video", "pic", "post", "meme", "game", "update", "wiki", "quest", "chat", "event", "member"] },
+ "url": { "type": "string", "pattern": "^https?://", "maxLength": 2000 },
+ "title": { "type": "string", "maxLength": 300 },
+ "text": { "type": "string", "maxLength": 280 },
+ "at": { "type": ["string", "null"], "format": "date-time" },
+ "site": { "type": "string", "maxLength": 40 },
+ "site_name": { "type": "string", "maxLength": 40 },
+ "actor": { "type": ["object", "null"], "required": ["name", "avatar"], "properties": { "name": { "type": ["string", "null"], "maxLength": 80 }, "avatar": { "type": ["string", "null"], "maxLength": 2000 } }, "additionalProperties": false },
+ "media": { "type": ["object", "null"], "required": ["thumb", "ratio"], "properties": { "thumb": { "type": "string", "pattern": "^https://", "maxLength": 2000 }, "preview": { "type": ["string", "null"], "pattern": "^https://", "maxLength": 2000 }, "ratio": { "type": "number", "exclusiveMinimum": 0 }, "length": { "type": "number", "minimum": 0 } }, "additionalProperties": false },
+ "counts": { "type": "object", "properties": { "views": { "type": "integer", "minimum": 0 }, "likes": { "type": "integer", "minimum": 0 }, "comments": { "type": "integer", "minimum": 0 } }, "additionalProperties": false },
+ "live_now": { "type": "boolean" },
+ "label": { "enum": ["Trending", "AI", "System"] }
+ }
+}
@@ -2,7 +2,7 @@
@@ -2,7 +2,7 @@
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://openvibe.network/contracts/community/feed-item.v1.json",
"$id": "https://openvibe.network/contracts/community/feed-item.v1.json",
"title": "CommunityFeedItem",
"title": "CommunityFeedItem",
- "description": "community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). One stream over Pulse: a paste or a status is a post, a Live clip a clip, a Wiki page a wiki page, a Quest badge a quest, a busy Chat hour a chat, a Today event an event, and a day's new Network accounts a member. Text only (the client draws every field), https links only, and counts carry Community's own views, likes and comments where it knows them.",
+ "description": "community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). Each card keeps its source and public visibility. Scheduled calendar cards appear only before their start time; bursts can carry a group of links. Counts carry Community's own views, likes and comments where it knows them.",
"type": "object",
"type": "object",
"additionalProperties": false,
"additionalProperties": false,
"required": ["id", "kind", "url", "title", "text", "at", "site", "site_name", "actor", "media", "counts"],
"required": ["id", "kind", "url", "title", "text", "at", "site", "site_name", "actor", "media", "counts"],
@@ -14,7 +14,7 @@
@@ -14,7 +14,7 @@
"description": "Stable within one response: p:<pulse item id> for a Pulse item, t:<site>:<url> for a trending card."
"description": "Stable within one response: p:<pulse item id> for a Pulse item, t:<site>:<url> for a trending card."
},
},
"kind": {
"kind": {
- "enum": ["live", "stream", "clip", "video", "pic", "post", "meme", "game", "update", "wiki", "quest", "chat", "event", "member"]
+ "enum": ["live", "stream", "clip", "video", "pic", "post", "meme", "game", "update", "wiki", "quest", "chat", "event", "member", "avatar", "banner", "paste", "site", "space", "follow", "episode"]
},
},
"url": {
"url": {
"type": "string",
"type": "string",
@@ -33,6 +33,12 @@
@@ -33,6 +33,12 @@
"format": "date-time",
"format": "date-time",
"description": "When it happened (Pulse provenance); null for a trending card."
"description": "When it happened (Pulse provenance); null for a trending card."
},
},
+ "starts_at": {
+ "type": "string",
+ "format": "date-time",
+ "description": "The start time of a Coming up calendar item; absent on other kinds."
+ },
+ "visibility": { "enum": ["followers"], "description": "Present only for an item returned to a follower or its author." },
"site": {
"site": {
"type": "string",
"type": "string",
"maxLength": 40,
"maxLength": 40,
@@ -55,6 +61,7 @@
@@ -55,6 +61,7 @@
"required": ["thumb", "ratio"],
"required": ["thumb", "ratio"],
"properties": {
"properties": {
"thumb": { "type": "string", "pattern": "^https://", "maxLength": 2000 },
"thumb": { "type": "string", "pattern": "^https://", "maxLength": 2000 },
+ "preview": { "type": "string", "pattern": "^https://", "maxLength": 2000 },
"ratio": { "type": "number", "exclusiveMinimum": 0 },
"ratio": { "type": "number", "exclusiveMinimum": 0 },
"length": { "type": "number", "minimum": 0, "description": "Seconds, when the card is a video." }
"length": { "type": "number", "minimum": 0, "description": "Seconds, when the card is a video." }
},
},
@@ -74,6 +81,29 @@
@@ -74,6 +81,29 @@
"type": "boolean",
"type": "boolean",
"description": "Present on live and stream cards: true only while the channel is currently on air. A past broadcast has kind stream and live_now false."
"description": "Present on live and stream cards: true only while the channel is currently on air. A past broadcast has kind stream and live_now false."
},
},
+ "group": {
+ "type": "object",
+ "required": ["count", "items"],
+ "properties": {
+ "count": { "type": "integer", "minimum": 2 },
+ "items": {
+ "type": "array",
+ "minItems": 2,
+ "items": {
+ "type": "object",
+ "required": ["id", "url", "title", "media"],
+ "properties": {
+ "id": { "type": "string" },
+ "url": { "type": "string", "pattern": "^https://" },
+ "title": { "type": "string" },
+ "media": { "type": ["object", "null"] }
+ },
+ "additionalProperties": false
+ }
+ }
+ },
+ "additionalProperties": false
+ },
"label": {
"label": {
"enum": ["Trending", "AI", "System"],
"enum": ["Trending", "AI", "System"],
"description": "Present only when the card needs one."
"description": "Present only when the card needs one."
@@ -51,6 +51,9 @@
@@ -51,6 +51,9 @@
"system"
"system"
]
]
},
},
+ "visibility": { "enum": ["followers"], "description": "Present only for an item returned to an authorized follower or its author." },
+ "starts_at": { "type": "string", "format": "date-time" },
+ "actor_name": { "type": "string", "maxLength": 80 },
"label": {
"label": {
"enum": ["AI", "System", null]
"enum": ["AI", "System", null]
},
},
@@ -2,7 +2,7 @@
@@ -2,7 +2,7 @@
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://openvibe.network/contracts/community/pulse-write-request.v1.json",
"$id": "https://openvibe.network/contracts/community/pulse-write-request.v1.json",
"title": "CommunityPulseWriteRequest",
"title": "CommunityPulseWriteRequest",
- "description": "community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities (ref.service must be that service: 403 pulse.foreign_ref otherwise), with a title (whitespace collapsed, 1 to 300 characters) and an absolute http(s) url (at most 2000 characters). origin defaults to X-OV-Origin (user, ai or system; X-OV-Origin: ai always wins); an origin user item names the person in X-OV-Subject. occurred_at is an ISO time, not in the future (default now). Only public activity enters Pulse: a visibility other than public is 400 pulse.not_public. The same ref again updates the item. Unknown fields are ignored. DELETE /api/v1/pulse/items/:service/:type/:id takes no body.",
+ "description": "community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities, with a title and an absolute http(s) URL. Optional media carries an HTTPS thumbnail, preview video, aspect ratio and duration for Feed cards. Visibility is public by default; followers requires origin user and X-OV-Subject and is shown only to that person's followers. Private, unlisted and members items are refused. The same ref updates the item. DELETE /api/v1/pulse/items/:service/:type/:id retracts it.",
"anyOf": [
"anyOf": [
{
{
"type": "object",
"type": "object",
@@ -44,8 +44,38 @@
@@ -44,8 +44,38 @@
"visibility": {
"visibility": {
"enum": [
"enum": [
"public",
"public",
+ "followers",
null
null
]
]
+ },
+ "media": {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "thumb": {
+ "type": "string",
+ "pattern": "^https://",
+ "maxLength": 2000
+ },
+ "preview": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "pattern": "^https://",
+ "maxLength": 2000
+ },
+ "ratio": {
+ "type": "number",
+ "exclusiveMinimum": 0,
+ "maximum": 20
+ },
+ "length": {
+ "type": "number",
+ "minimum": 0,
+ "maximum": 86400
+ }
+ }
}
}
}
}
},
},
new file mode 100644
new file mode 100644
@@ -0,0 +1,60 @@
@@ -0,0 +1,60 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/composer/attachment.v1.json",
+ "title": "ComposerAttachment",
+ "description": "composer.attachment@1: one file a person attached to a message in the shared composer. Media stores it and answers this shape from POST /api/v1/attachments (multipart field `file`); a client keeps it until the message is sent, then names it in POST /api/v1/attachments/:id/keep. `kind` is sniffed from the bytes, never taken from the browser: image, video, audio, file or code. `thumb` is a small preview for images and video (absent for the rest), `w`/`h` the pixel size when the file is one Media can measure. An attachment nobody keeps expires after 24 hours; `expires_at` says when, and a keep extends it to the message's life.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["id", "kind", "name", "size", "mime", "url", "expires_at"],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The attachment id (att_ + ULID): what DELETE /api/v1/attachments/:id and POST /api/v1/attachments/:id/keep name."
+ },
+ "kind": {
+ "enum": ["image", "video", "audio", "file", "code"],
+ "description": "Decided by Media from the bytes, not the client's claim: image/video/audio when the signature matches, code for recognised source text, otherwise file. Executables are refused at upload."
+ },
+ "name": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 255,
+ "description": "The file's original name, sanitised for display; never a path."
+ },
+ "size": {
+ "type": "integer",
+ "minimum": 1,
+ "description": "Bytes stored."
+ },
+ "mime": {
+ "type": "string",
+ "description": "The content type Media serves the bytes as, from the sniffed kind and format."
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "description": "Absolute https URL the bytes are served at. It stays valid while the attachment exists; a kept attachment is the message's to serve."
+ },
+ "thumb": {
+ "type": ["string", "null"],
+ "format": "uri",
+ "description": "Absolute URL of a preview image: an image's own small copy or a video's first frame. Null when Media could not make one (or the kind has none)."
+ },
+ "w": {
+ "type": ["integer", "null"],
+ "minimum": 1,
+ "description": "Pixel width of an image, video or video preview; null when unknown."
+ },
+ "h": {
+ "type": ["integer", "null"],
+ "minimum": 1,
+ "description": "Pixel height of an image, video or video preview; null when unknown."
+ },
+ "expires_at": {
+ "type": "string",
+ "format": "date-time",
+ "description": "When an unkept attachment is deleted. The upload answers now + 24 hours; a keep moves it to the kept window."
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,43 @@
@@ -0,0 +1,43 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/composer/mention.v1.json",
+ "title": "ComposerMention",
+ "description": "composer.mention@1: one thing the composer's @ menu can insert, from GET /api/v1/mentions on OpenVibe.Network. kind person (a person the caller follows first, then a public person), repo (a repository on OpenVibe Git the caller can see), site (a first-party OpenVibe site) or file (a file of the message's own context). `id` is the stable id inside its kind, `label` what the menu shows, `handle` the @name when the kind has one, `avatar` the picture, and `url` where choosing it links.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["kind", "id", "label", "url"],
+ "properties": {
+ "kind": {
+ "enum": ["person", "repo", "site", "file"],
+ "description": "What is mentioned. The same person is a person; a repository on OpenVibe Git is a repo; a first-party OpenVibe site is a site; a file of the message's context (an attachment or a repository file) is a file."
+ },
+ "id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200,
+ "description": "The stable id inside the kind: a usr_… subject for a person, owner/name for a repo, a site id for a site, a path or attachment id for a file."
+ },
+ "label": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200,
+ "description": "What the menu shows (a display name, owner/name, the site's name, a file name)."
+ },
+ "handle": {
+ "type": "string",
+ "maxLength": 64,
+ "pattern": "^[A-Za-z0-9_.-]+$",
+ "description": "The @name when the kind has one: a person's username, a site's short name. Absent for a repo or a file."
+ },
+ "avatar": {
+ "type": ["string", "null"],
+ "format": "uri",
+ "description": "Absolute URL of the picture to show beside the label. Null when the kind has none (a file, a site without a mark)."
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "description": "Absolute https URL where choosing the mention leads: the person's profile, the repository, the site's home or the file."
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,71 @@
@@ -0,0 +1,71 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/composer/prefs.v1.json",
+ "title": "ComposerPrefs",
+ "description": "composer.prefs@1: a person's composer settings, the same on every OpenVibe site because Network stores them (GET/PUT /api/v1/me/composer). `rev` is the stored revision: send the one you read back with your change, and a tab that read an older copy gets 409 with the current document instead of overwriting the other tab. `send_key` says whether Enter or Ctrl/Cmd+Enter sends. `tools` is the one order of the composer's tools and which are hidden; a tool id the client does not know is kept, so a site can add one without another site dropping the person's order. `snippets` are the person's saved inserts, triggered by typing a slash word.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["rev", "send_key", "tools", "density", "voice", "snippets"],
+ "properties": {
+ "rev": {
+ "type": "integer",
+ "minimum": 0,
+ "description": "Revision of the stored document. A missing document is rev 0 with the defaults; every successful PUT answers rev + 1."
+ },
+ "send_key": {
+ "enum": ["enter", "mod-enter"],
+ "description": "enter: Enter sends and Shift+Enter breaks the line. mod-enter: Ctrl/Cmd+Enter sends and Enter breaks the line (the default on a phone keyboard is enter)."
+ },
+ "tools": {
+ "type": "array",
+ "maxItems": 100,
+ "description": "Every tool in the order the person wants them, each marked hidden or not.",
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["id", "hidden"],
+ "properties": {
+ "id": { "type": "string", "minLength": 1, "maxLength": 40, "pattern": "^[a-z0-9][a-z0-9._-]*$" },
+ "hidden": { "type": "boolean" }
+ }
+ }
+ },
+ "density": {
+ "enum": ["comfy", "compact"],
+ "description": "How much room the composer takes: comfy is the default on a computer, compact on a phone."
+ },
+ "voice": {
+ "type": "boolean",
+ "description": "Whether the composer offers dictation (where the device has it)."
+ },
+ "snippets": {
+ "type": "array",
+ "maxItems": 50,
+ "description": "Saved inserts. Typing the trigger (a slash word such as /sig) in the composer offers the snippet.",
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": ["trigger", "label", "text"],
+ "properties": {
+ "trigger": {
+ "type": "string",
+ "pattern": "^/[a-z0-9][a-z0-9_-]{0,31}$",
+ "description": "The slash word that offers the snippet, e.g. /sig. Lower-case letters, digits, _ and - only."
+ },
+ "label": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 80,
+ "description": "What the menu shows."
+ },
+ "text": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 4000,
+ "description": "What is inserted."
+ }
+ }
+ }
+ }
+ }
+}
@@ -158,6 +158,13 @@
@@ -158,6 +158,13 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."
+ },
"started_at": {
"started_at": {
"type": [
"type": [
"string",
"string",
@@ -92,6 +92,13 @@
@@ -92,6 +92,13 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."
+ },
"started_at": {
"started_at": {
"type": [
"type": [
"string",
"string",
@@ -206,6 +213,13 @@
@@ -206,6 +213,13 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."
+ },
"started_at": {
"started_at": {
"type": [
"type": [
"string",
"string",
@@ -116,6 +116,20 @@
@@ -116,6 +116,20 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "The hover preview of this item: about 6 s, muted, 320 px wide, MP4 H.264, stored beside its thumbnail and served at /t/<name>. Null until the preview.make job has made it (audio-only, private and too-short items never get one)."
+ },
+ "preview_webm_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "The same moment as preview_url, encoded as WebM (VP9, VP8 where the encoder has no VP9). Null while preview_url is."
+ },
"storage_provider": {
"storage_provider": {
"type": "string"
"type": "string"
},
},
@@ -103,6 +103,20 @@
@@ -103,6 +103,20 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "The hover preview of this item: about 6 s, muted, 320 px wide, MP4 H.264, stored beside its thumbnail and served at /t/<name>. Null until the preview.make job has made it (audio-only, private and too-short items never get one)."
+ },
+ "preview_webm_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "The same moment as preview_url, encoded as WebM (VP9, VP8 where the encoder has no VP9). Null while preview_url is."
+ },
"storage_provider": {
"storage_provider": {
"type": "string",
"type": "string",
"description": "local, b2 or r2."
"description": "local, b2 or r2."
new file mode 100644
new file mode 100644
@@ -0,0 +1,91 @@
@@ -0,0 +1,91 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/network/user-card.v1.json",
+ "title": "NetworkUserCard",
+ "description": "network.user-card@1 (ask 287): the one public user card read, GET /api/v1/people/:username/card on OpenVibe.Network. It is public and credential-free; a signed-in viewer may send their Network token (Authorization: Bearer …) and then also receives `actions` computed for that viewer, never cached. Without a viewer, or on the viewer's own card, `actions` carries Profile and Channel only. A missing, expired or revoked token reads as anonymous, never a 401. Hidden fields are absent, never zero, offline or a placeholder; no presence, page titles or visited URLs leave the read.",
+ "type": "object",
+ "required": ["username", "profile_url", "actions"],
+ "additionalProperties": false,
+ "properties": {
+ "username": { "type": "string", "pattern": "^[A-Za-z0-9_]{3,24}$" },
+ "display_name": { "type": "string", "minLength": 1, "maxLength": 200 },
+ "avatar_url": { "type": "string", "format": "uri", "pattern": "^https://" },
+ "profile_url": { "type": "string", "format": "uri", "pattern": "^https://" },
+ "level": { "type": "integer", "minimum": 0 },
+ "streak": { "type": "integer", "minimum": 0 },
+ "badges_count": { "type": "integer", "minimum": 0 },
+ "followers": { "type": "integer", "minimum": 0 },
+ "live": {
+ "type": "object",
+ "required": ["now"],
+ "additionalProperties": false,
+ "properties": {
+ "now": { "type": "boolean" },
+ "site": { "const": "live" },
+ "url": { "type": "string", "format": "uri", "pattern": "^https://" }
+ }
+ },
+ "channel_url": { "type": "string", "format": "uri", "pattern": "^https://" },
+ "active_sites": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": ["id", "name", "url"],
+ "additionalProperties": false,
+ "properties": {
+ "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,39}$" },
+ "name": { "type": "string", "minLength": 1, "maxLength": 80 },
+ "url": { "type": "string", "format": "uri", "pattern": "^https://" }
+ }
+ }
+ },
+ "actions": {
+ "type": "array",
+ "description": "What the viewer can do, by what is possible for the pair. Order is the card's order. Each action either opens somewhere (`href`) or calls a Network route with the viewer's token (`method` + `path`, and `body` where the route needs one).",
+ "items": { "$ref": "#/$defs/action" }
+ }
+ },
+ "$defs": {
+ "action": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": ["id", "label", "href"],
+ "additionalProperties": false,
+ "properties": {
+ "id": { "$ref": "#/$defs/id" },
+ "label": { "$ref": "#/$defs/label" },
+ "href": { "type": "string", "format": "uri", "pattern": "^https://" },
+ "state": { "$ref": "#/$defs/state" }
+ }
+ },
+ {
+ "type": "object",
+ "required": ["id", "label", "method", "path"],
+ "additionalProperties": false,
+ "properties": {
+ "id": { "$ref": "#/$defs/id" },
+ "label": { "$ref": "#/$defs/label" },
+ "method": { "enum": ["PUT", "POST", "DELETE", "PATCH"] },
+ "path": { "type": "string", "pattern": "^/api/v1/" },
+ "body": { "type": "object" },
+ "state": { "$ref": "#/$defs/state" }
+ }
+ }
+ ]
+ },
+ "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,39}$" },
+ "label": { "type": "string", "minLength": 1, "maxLength": 40 },
+ "state": {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "following": { "type": "boolean" },
+ "friendship": { "enum": ["none", "pending", "requested", "friends"] },
+ "muted": { "type": "boolean" },
+ "blocked": { "type": "boolean" },
+ "reported": { "type": "boolean" }
+ }
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,12 @@
@@ -0,0 +1,12 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/network/user-report-list-result.v1.json",
+ "title": "NetworkUserReportListResult",
+ "description": "network.user-report-list-result@1 (ask 287): GET /api/v1/staff/user-reports on OpenVibe.Network, the staff queue for people holding staff.moderation.logs. Newest first, filtered by status (default open) and target subject, at most 200 rows (`limit`, default 50). A caller without the capability gets 403 user_reports.forbidden (problem+json).",
+ "type": "object",
+ "required": ["reports"],
+ "additionalProperties": false,
+ "properties": {
+ "reports": { "type": "array", "maxItems": 200, "items": { "$ref": "user-report.v1.json" } }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,14 @@
@@ -0,0 +1,14 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/network/user-report-request.v1.json",
+ "title": "NetworkUserReportRequest",
+ "description": "network.user-report-request@1 (ask 287): POST /api/v1/me/reports on OpenVibe.Network, a signed-in person's report about another person. `target` is their username (any case) or usr_ subject; guests cannot be named, and nobody reports themselves. The same pair may have one open report: filing again while it is open answers the open one with 200 instead of creating a duplicate (201 when it creates one).",
+ "type": "object",
+ "required": ["target", "reason"],
+ "additionalProperties": false,
+ "properties": {
+ "target": { "type": "string", "pattern": "^([A-Za-z0-9_]{3,24}|usr_[0-9A-HJKMNP-TV-Z]{26})$" },
+ "reason": { "enum": ["spam", "harassment", "impersonation", "explicit", "scam", "other"] },
+ "detail": { "type": "string", "maxLength": 2000 }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,19 @@
@@ -0,0 +1,19 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/network/user-report.v1.json",
+ "title": "NetworkUserReport",
+ "description": "network.user-report@1 (ask 287): one report a person filed about another person on OpenVibe.Network. Reports never resolve themselves; staff holding staff.moderation.logs read the queue (GET /api/v1/staff/user-reports?status=open&target=usr_…&limit=), and a staff decision lives in the moderation audit log. `status` records whether staff have looked, not a verdict.",
+ "type": "object",
+ "required": ["id", "reporter", "target", "reason", "detail", "status", "created_at", "updated_at"],
+ "additionalProperties": false,
+ "properties": {
+ "id": { "type": "integer", "minimum": 1 },
+ "reporter": { "type": "string", "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$" },
+ "target": { "type": "string", "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$" },
+ "reason": { "enum": ["spam", "harassment", "impersonation", "explicit", "scam", "other"] },
+ "detail": { "type": "string", "maxLength": 2000 },
+ "status": { "enum": ["open", "reviewed", "dismissed"] },
+ "created_at": { "type": "string", "format": "date-time" },
+ "updated_at": { "type": "string", "format": "date-time" }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{"now": null, "work": [], "asks": [], "asks_empty": null, "computer": null, "schedules": [], "memory": [], "activity": []}
new file mode 100644
new file mode 100644
@@ -0,0 +1,11 @@
@@ -0,0 +1,11 @@
+{
+ "agent": {"id": "agt_00000000000000000000000000", "name": "Helper", "face": null, "state": "idle", "instructions": "Help with alerts", "voice": null},
+ "now": null,
+ "work": [],
+ "asks": [],
+ "asks_empty": "Requests to approve or decline will appear here.",
+ "computer": null,
+ "schedules": [{"schedule": "off", "next_run_at": null, "last_run_at": null, "last_result": null}],
+ "memory": [],
+ "activity": []
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,13 @@
@@ -0,0 +1,13 @@
+{
+ "id": "run_1",
+ "product": "codes",
+ "title": "Review",
+ "status": "unknown",
+ "plan": [],
+ "steps": [],
+ "sources": [],
+ "result": null,
+ "started_at": "bad",
+ "ended_at": null,
+ "cost_usd": -1
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,18 @@
@@ -0,0 +1,18 @@
+{
+ "id": "run_1",
+ "product": "codes",
+ "title": "Review repositories",
+ "status": "running",
+ "plan": [
+ {
+ "title": "Read repositories",
+ "status": "running"
+ }
+ ],
+ "steps": [],
+ "sources": [],
+ "result": null,
+ "started_at": "2026-11-11T00:00:00Z",
+ "ended_at": null,
+ "cost_usd": null
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,22 @@
@@ -0,0 +1,22 @@
+{
+ "type": "ACTIVITY_SNAPSHOT",
+ "timestamp": 1794355200000,
+ "activityType": "plan",
+ "content": {
+ "step": "read"
+ },
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,19 @@
@@ -0,0 +1,19 @@
+{
+ "type": "CUSTOM",
+ "timestamp": 1794355200000,
+ "name": "ov.sources",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,4 @@
@@ -0,0 +1,4 @@
+{
+ "type": "NOT_AN_AGUI_EVENT",
+ "timestamp": "not-an-epoch"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,19 @@
@@ -0,0 +1,19 @@
+{
+ "type": "RAW",
+ "timestamp": 1794355200000,
+ "source": "codes",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,18 @@
@@ -0,0 +1,18 @@
+{
+ "type": "REASONING_START",
+ "timestamp": 1794355200000,
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,19 @@
@@ -0,0 +1,19 @@
+{
+ "type": "RUN_STARTED",
+ "timestamp": 1794355200000,
+ "threadId": "thread_1",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,18 @@
@@ -0,0 +1,18 @@
+{
+ "type": "STATE_SNAPSHOT",
+ "timestamp": 1794355200000,
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,18 @@
@@ -0,0 +1,18 @@
+{
+ "type": "STEP_STARTED",
+ "timestamp": 1794355200000,
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,19 @@
@@ -0,0 +1,19 @@
+{
+ "type": "SUBAGENT_STARTED",
+ "timestamp": 1794355200000,
+ "subagentRunId": "sub_1",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,19 @@
@@ -0,0 +1,19 @@
+{
+ "type": "TEXT_MESSAGE_CONTENT",
+ "timestamp": 1794355200000,
+ "delta": "Reading source",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,19 @@
@@ -0,0 +1,19 @@
+{
+ "type": "TOOL_CALL_START",
+ "timestamp": 1794355200000,
+ "toolCallName": "read_file",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,23 @@
@@ -0,0 +1,23 @@
+{
+ "type": "ACTIVITY_SNAPSHOT",
+ "timestamp": 1794355200000,
+ "messageId": "activity_1",
+ "activityType": "plan",
+ "content": {
+ "step": "read"
+ },
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,26 @@
@@ -0,0 +1,26 @@
+{
+ "type": "CUSTOM",
+ "timestamp": 1794355200000,
+ "name": "ov.sources",
+ "value": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ],
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,18 @@
@@ -0,0 +1,18 @@
+{
+ "type": "STEP_STARTED",
+ "timestamp": 1794355200000,
+ "metadata": {
+ "ov": {
+ "title": "Searching the web",
+ "kind": "search",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ },
+ "stepName": "Research"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,22 @@
@@ -0,0 +1,22 @@
+{
+ "type": "RAW",
+ "timestamp": 1794355200000,
+ "event": {
+ "provider": "native"
+ },
+ "source": "codes",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,19 @@
@@ -0,0 +1,19 @@
+{
+ "type": "REASONING_START",
+ "timestamp": 1794355200000,
+ "messageId": "reason_1",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,28 @@
@@ -0,0 +1,28 @@
+{
+ "type": "RUN_STARTED",
+ "timestamp": 1794355200000,
+ "threadId": "thread_1",
+ "runId": "run_1",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ],
+ "needs_you": {
+ "id": "approval_1",
+ "question": "May I publish the result?",
+ "actions": [
+ "approve",
+ "decline"
+ ]
+ }
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,21 @@
@@ -0,0 +1,21 @@
+{
+ "type": "STATE_SNAPSHOT",
+ "timestamp": 1794355200000,
+ "snapshot": {
+ "plan": []
+ },
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,19 @@
@@ -0,0 +1,19 @@
+{
+ "type": "STEP_STARTED",
+ "timestamp": 1794355200000,
+ "stepName": "Read repositories",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,20 @@
@@ -0,0 +1,20 @@
+{
+ "type": "SUBAGENT_STARTED",
+ "timestamp": 1794355200000,
+ "subagentRunId": "sub_1",
+ "name": "Research",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,20 @@
@@ -0,0 +1,20 @@
+{
+ "type": "TEXT_MESSAGE_CONTENT",
+ "timestamp": 1794355200000,
+ "messageId": "msg_1",
+ "delta": "Reading source",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,20 @@
@@ -0,0 +1,20 @@
+{
+ "type": "TOOL_CALL_START",
+ "timestamp": 1794355200000,
+ "toolCallId": "call_1",
+ "toolCallName": "read_file",
+ "metadata": {
+ "ov": {
+ "title": "Researching the question",
+ "kind": "read",
+ "product": "codes",
+ "sources": [
+ {
+ "url": "https://example.com",
+ "title": "Example",
+ "site": "example.com"
+ }
+ ]
+ }
+ }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,4 @@
@@ -0,0 +1,4 @@
+{
+ "server": "command-tests",
+ "command": { "name": "hello", "description": "Say hello", "options": [] }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,5 @@
@@ -0,0 +1,5 @@
+{
+ "server": "command-tests",
+ "command": { "name": "hello", "description": "Say hello", "options": [{ "name": "text", "description": "Who to greet", "type": "string", "required": false }] },
+ "response_template": "Hello, {args}!"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{}
new file mode 100644
new file mode 100644
@@ -0,0 +1,3 @@
@@ -0,0 +1,3 @@
+{
+ "command": { "name": "hello", "description": "Say hello", "options": [], "source": "app", "application_id": "app:app_01J8Z3Q4R5S6T7V8W9X0Y1Z2A3" }
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,13 @@
@@ -0,0 +1,13 @@
+{
+ "kind": "agent-run",
+ "url": "https://openvibe.codes/runs/run_1",
+ "site_name": "OpenVibe.Codes",
+ "title": "Review repositories",
+ "description": "",
+ "image": null,
+ "width": 0,
+ "height": 0,
+ "run_url": "https://openvibe.codes/api/v1/runs/run_1",
+ "events_url": "http://insecure.test/events",
+ "status": "running"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,13 @@
@@ -0,0 +1,13 @@
+{
+ "kind": "agent-run",
+ "url": "https://openvibe.codes/runs/run_1",
+ "site_name": "OpenVibe.Codes",
+ "title": "Review repositories",
+ "description": "",
+ "image": null,
+ "width": 0,
+ "height": 0,
+ "run_url": "https://openvibe.codes/api/v1/runs/run_1",
+ "events_url": "https://openvibe.codes/api/v1/runs/run_1/events",
+ "status": "running"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{ "deleted": true }
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{ "opted_out": true, "deleted": true }
new file mode 100644
new file mode 100644
@@ -0,0 +1,15 @@
@@ -0,0 +1,15 @@
+{
+ "username": "alice",
+ "level": "day",
+ "channel": "streamer",
+ "enabled": true,
+ "opted_out": false,
+ "entries": [{
+ "level": "day",
+ "period_start": "2026-11-11",
+ "channel_user_id": 42,
+ "summary": "Alice discussed a game with chat.",
+ "topics": [],
+ "highlights": []
+ }]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,16 @@
@@ -0,0 +1,16 @@
+{
+ "username": "alice",
+ "level": "day",
+ "channel": "streamer",
+ "enabled": true,
+ "opted_out": false,
+ "entries": [{
+ "level": "day",
+ "period_start": "2026-11-11",
+ "channel_user_id": 42,
+ "summary": "Alice discussed a game with chat.",
+ "topics": ["game"],
+ "highlights": [{ "detail": "A game win", "stream_id": 123, "at": "2026-11-11 04:00:00" }],
+ "message_count": 25
+ }]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,12 @@
@@ -0,0 +1,12 @@
+{
+ "agent": {"id": "codex", "name": "Codex", "face": null, "state": "ready", "kind": "coding harness", "availability": null},
+ "now": null,
+ "work": [],
+ "activity": [],
+ "asks": [],
+ "asks_empty": "Requests to approve coding work will appear here when this agent needs you.",
+ "computer": null,
+ "schedules": [],
+ "memory": [{"text": "not a Codes record"}],
+ "identity": {"provider": null, "capabilities": {}}
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,12 @@
@@ -0,0 +1,12 @@
+{
+ "agent": {"id": "codex", "name": "Codex", "face": null, "state": "ready", "kind": "coding harness", "availability": null},
+ "now": null,
+ "work": [],
+ "activity": [],
+ "asks": [],
+ "asks_empty": "Requests to approve coding work will appear here when this agent needs you.",
+ "computer": null,
+ "schedules": [],
+ "memory": [],
+ "identity": {"provider": null, "capabilities": {}}
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{ "items": [] }
new file mode 100644
new file mode 100644
@@ -0,0 +1,16 @@
@@ -0,0 +1,16 @@
+{
+ "items": [{
+ "id": "p:42",
+ "kind": "post",
+ "url": "https://openvibe.community/p/42",
+ "title": "A post",
+ "text": "Hello",
+ "at": null,
+ "site": "community",
+ "site_name": "Community",
+ "actor": null,
+ "media": null,
+ "counts": {}
+ }],
+ "next_cursor": null
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,12 @@
@@ -0,0 +1,12 @@
+{
+ "id": "p:42",
+ "kind": "clip",
+ "url": "https://openvibe.live/clip/42",
+ "text": "A short clip",
+ "at": null,
+ "site": "live",
+ "site_name": "Live",
+ "actor": null,
+ "media": null,
+ "counts": {}
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,14 @@
@@ -0,0 +1,14 @@
+{
+ "id": "p:42",
+ "kind": "clip",
+ "url": "https://openvibe.live/clip/42",
+ "title": "A highlight",
+ "text": "A short clip",
+ "at": "2026-11-10T12:00:00.000Z",
+ "site": "live",
+ "site_name": "Live",
+ "actor": { "name": "Ada", "avatar": null },
+ "media": { "thumb": "https://openvibe.media/42.webp", "preview": "https://openvibe.media/42.mp4", "ratio": 1.7778, "length": 18 },
+ "counts": { "views": 12, "likes": 3, "comments": 1 },
+ "live_now": false
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{ "ref": { "service": "live", "type": "clip", "id": "med_01JAB2C3D4E5F6G7H8J9K0MNPQ" }, "title": "Bad clip media", "url": "https://openvibe.live/clip/1", "media": { "thumb": "http://openvibe.media/clip.webp", "ratio": 1.7 } }
@@ -1 +1 @@
@@ -1 +1 @@
-{ "ref": { "service": "live", "type": "clip", "id": "med_01JAB2C3D4E5F6G7H8J9K0MNPQ" }, "title": "Alice clipped a clean 1v3", "url": "https://openvibe.live/clip/med_01JAB2C3D4E5F6G7H8J9K0MNPQ", "origin": "user", "occurred_at": "2026-09-25T18:00:00Z", "visibility": "public" }
+{ "ref": { "service": "live", "type": "clip", "id": "med_01JAB2C3D4E5F6G7H8J9K0MNPQ" }, "title": "Alice clipped a clean 1v3", "url": "https://openvibe.live/clip/med_01JAB2C3D4E5F6G7H8J9K0MNPQ", "origin": "user", "occurred_at": "2026-09-25T18:00:00Z", "visibility": "public", "media": { "thumb": "https://openvibe.media/clip.webp", "preview": "https://openvibe.media/clip.mp4", "ratio": 1.7778, "length": 22 } }
new file mode 100644
new file mode 100644
@@ -0,0 +1,9 @@
@@ -0,0 +1,9 @@
+{
+ "id": "att_1",
+ "kind": "file",
+ "name": "a.txt",
+ "size": 1,
+ "mime": "text/plain",
+ "url": "https://openvibe.media/a/x/a.txt",
+ "expires_at": "2026-11-11T12:00:00.000Z"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,9 @@
@@ -0,0 +1,9 @@
+{
+ "id": "att_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "kind": "spreadsheet",
+ "name": "book.xlsx",
+ "size": 12,
+ "mime": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+ "url": "https://openvibe.media/a/x/book.xlsx",
+ "expires_at": "2026-11-11T12:00:00.000Z"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,8 @@
@@ -0,0 +1,8 @@
+{
+ "id": "att_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "kind": "image",
+ "name": "screenshot.png",
+ "size": 184320,
+ "mime": "image/png",
+ "expires_at": "2026-11-11T12:00:00.000Z"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,9 @@
@@ -0,0 +1,9 @@
+{
+ "id": "att_01JAB2C3D4E5F6G7H8J9K0MNPS",
+ "kind": "file",
+ "name": "notes.txt",
+ "size": 42,
+ "mime": "text/plain",
+ "url": "https://openvibe.media/a/01JAB2C3D4E5F6G7H8J9K0MNPS/notes.txt",
+ "expires_at": "2026-11-11T12:00:00.000Z"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,12 @@
@@ -0,0 +1,12 @@
+{
+ "id": "att_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "kind": "image",
+ "name": "screenshot.png",
+ "size": 184320,
+ "mime": "image/png",
+ "url": "https://openvibe.media/a/01JAB2C3D4E5F6G7H8J9K0MNPQ/screenshot.png",
+ "thumb": "https://openvibe.media/a/01JAB2C3D4E5F6G7H8J9K0MNPQ/thumb.jpg",
+ "w": 1280,
+ "h": 720,
+ "expires_at": "2026-11-11T12:00:00.000Z"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,12 @@
@@ -0,0 +1,12 @@
+{
+ "id": "att_01JAB2C3D4E5F6G7H8J9K0MNPR",
+ "kind": "video",
+ "name": "clip.mp4",
+ "size": 52428800,
+ "mime": "video/mp4",
+ "url": "https://openvibe.media/a/01JAB2C3D4E5F6G7H8J9K0MNPR/clip.mp4",
+ "thumb": "https://openvibe.media/a/01JAB2C3D4E5F6G7H8J9K0MNPR/thumb.jpg",
+ "w": 1920,
+ "h": 1080,
+ "expires_at": "2026-11-11T12:00:00.000Z"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,6 @@
@@ -0,0 +1,6 @@
+{
+ "kind": "channel",
+ "id": "openvibe",
+ "label": "OpenVibe",
+ "url": "https://openvibe.live/openvibe"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,5 @@
@@ -0,0 +1,5 @@
+{
+ "kind": "site",
+ "id": "live",
+ "url": "https://openvibe.live"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,8 @@
@@ -0,0 +1,8 @@
+{
+ "kind": "person",
+ "id": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
+ "label": "Sam Rivera",
+ "handle": "sam",
+ "avatar": "https://openvibe.network/avatar/sam?s=64",
+ "url": "https://openvibe.network/@sam"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,6 @@
@@ -0,0 +1,6 @@
+{
+ "kind": "repo",
+ "id": "openvibers/OpenVibe.Contracts",
+ "label": "OpenVibers/OpenVibe.Contracts",
+ "url": "https://git.openvibe.codes/OpenVibers/OpenVibe.Contracts"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,10 @@
@@ -0,0 +1,10 @@
+{
+ "rev": 0,
+ "send_key": "enter",
+ "tools": [],
+ "density": "comfy",
+ "voice": false,
+ "snippets": [
+ { "trigger": "sig", "label": "Signature", "text": "— Sam" }
+ ]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,60 @@
@@ -0,0 +1,60 @@
+{
+ "rev": 0,
+ "send_key": "enter",
+ "tools": [],
+ "density": "comfy",
+ "voice": false,
+ "snippets": [
+ { "trigger": "/s1", "label": "s1", "text": "1" },
+ { "trigger": "/s2", "label": "s2", "text": "2" },
+ { "trigger": "/s3", "label": "s3", "text": "3" },
+ { "trigger": "/s4", "label": "s4", "text": "4" },
+ { "trigger": "/s5", "label": "s5", "text": "5" },
+ { "trigger": "/s6", "label": "s6", "text": "6" },
+ { "trigger": "/s7", "label": "s7", "text": "7" },
+ { "trigger": "/s8", "label": "s8", "text": "8" },
+ { "trigger": "/s9", "label": "s9", "text": "9" },
+ { "trigger": "/s10", "label": "s10", "text": "10" },
+ { "trigger": "/s11", "label": "s11", "text": "11" },
+ { "trigger": "/s12", "label": "s12", "text": "12" },
+ { "trigger": "/s13", "label": "s13", "text": "13" },
+ { "trigger": "/s14", "label": "s14", "text": "14" },
+ { "trigger": "/s15", "label": "s15", "text": "15" },
+ { "trigger": "/s16", "label": "s16", "text": "16" },
+ { "trigger": "/s17", "label": "s17", "text": "17" },
+ { "trigger": "/s18", "label": "s18", "text": "18" },
+ { "trigger": "/s19", "label": "s19", "text": "19" },
+ { "trigger": "/s20", "label": "s20", "text": "20" },
+ { "trigger": "/s21", "label": "s21", "text": "21" },
+ { "trigger": "/s22", "label": "s22", "text": "22" },
+ { "trigger": "/s23", "label": "s23", "text": "23" },
+ { "trigger": "/s24", "label": "s24", "text": "24" },
+ { "trigger": "/s25", "label": "s25", "text": "25" },
+ { "trigger": "/s26", "label": "s26", "text": "26" },
+ { "trigger": "/s27", "label": "s27", "text": "27" },
+ { "trigger": "/s28", "label": "s28", "text": "28" },
+ { "trigger": "/s29", "label": "s29", "text": "29" },
+ { "trigger": "/s30", "label": "s30", "text": "30" },
+ { "trigger": "/s31", "label": "s31", "text": "31" },
+ { "trigger": "/s32", "label": "s32", "text": "32" },
+ { "trigger": "/s33", "label": "s33", "text": "33" },
+ { "trigger": "/s34", "label": "s34", "text": "34" },
+ { "trigger": "/s35", "label": "s35", "text": "35" },
+ { "trigger": "/s36", "label": "s36", "text": "36" },
+ { "trigger": "/s37", "label": "s37", "text": "37" },
+ { "trigger": "/s38", "label": "s38", "text": "38" },
+ { "trigger": "/s39", "label": "s39", "text": "39" },
+ { "trigger": "/s40", "label": "s40", "text": "40" },
+ { "trigger": "/s41", "label": "s41", "text": "41" },
+ { "trigger": "/s42", "label": "s42", "text": "42" },
+ { "trigger": "/s43", "label": "s43", "text": "43" },
+ { "trigger": "/s44", "label": "s44", "text": "44" },
+ { "trigger": "/s45", "label": "s45", "text": "45" },
+ { "trigger": "/s46", "label": "s46", "text": "46" },
+ { "trigger": "/s47", "label": "s47", "text": "47" },
+ { "trigger": "/s48", "label": "s48", "text": "48" },
+ { "trigger": "/s49", "label": "s49", "text": "49" },
+ { "trigger": "/s50", "label": "s50", "text": "50" },
+ { "trigger": "/s51", "label": "s51", "text": "51" }
+ ]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,15 @@
@@ -0,0 +1,15 @@
+{
+ "rev": 0,
+ "send_key": "mod-enter",
+ "tools": [
+ { "id": "attach", "hidden": false },
+ { "id": "camera", "hidden": false },
+ { "id": "voice", "hidden": false },
+ { "id": "gif", "hidden": true }
+ ],
+ "density": "comfy",
+ "voice": true,
+ "snippets": [
+ { "trigger": "/sig", "label": "My signature", "text": "— Sam" }
+ ]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,10 @@
@@ -0,0 +1,10 @@
+{
+ "rev": 7,
+ "send_key": "enter",
+ "tools": [],
+ "density": "compact",
+ "voice": false,
+ "snippets": [
+ { "trigger": "/long", "label": "Long text", "text": "x" }
+ ]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,5 @@
@@ -0,0 +1,5 @@
+{
+ "username": "Example",
+ "profile_url": "https://openvibe.network/@Example",
+ "actions": [{ "id": "message", "label": "Message", "state": {} }]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,5 @@
@@ -0,0 +1,5 @@
+{
+ "username": "Example",
+ "profile_url": "https://openvibe.network/@Example",
+ "actions": [{ "id": "add-friend", "label": "Add friend", "method": "PUT", "path": "/api/v1/me/friends/Example", "state": { "friendship": "maybe" } }]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,5 @@
@@ -0,0 +1,5 @@
+{
+ "username": "Example",
+ "profile_url": "https://openvibe.network/@Example",
+ "actions": [{ "id": "profile", "label": "Profile", "href": "http://openvibe.network/@Example" }]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,17 @@
@@ -0,0 +1,17 @@
+{
+ "username": "Example",
+ "display_name": "Example",
+ "avatar_url": "https://openvibe.network/avatar/Example?s=160",
+ "profile_url": "https://openvibe.network/@Example",
+ "level": 4,
+ "streak": 3,
+ "badges_count": 2,
+ "followers": 10,
+ "live": { "now": true, "site": "live", "url": "https://openvibe.live/@Example" },
+ "channel_url": "https://openvibe.live/@Example",
+ "active_sites": [{ "id": "live", "name": "Live", "url": "https://openvibe.live" }],
+ "actions": [
+ { "id": "profile", "label": "Profile", "href": "https://openvibe.network/@Example" },
+ { "id": "channel", "label": "Channel", "href": "https://openvibe.live/@Example" }
+ ]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,14 @@
@@ -0,0 +1,14 @@
+{
+ "username": "Example",
+ "profile_url": "https://openvibe.network/@Example",
+ "actions": [
+ { "id": "profile", "label": "Profile", "href": "https://openvibe.network/@Example" },
+ { "id": "message", "label": "Message", "href": "https://openvibe.chat/messages" },
+ { "id": "follow", "label": "Follow", "method": "PUT", "path": "/api/v1/me/follows/channel/Example", "state": { "following": false } },
+ { "id": "add-friend", "label": "Add friend", "method": "PUT", "path": "/api/v1/me/friends/Example", "state": { "friendship": "none" } },
+ { "id": "tip", "label": "Tip", "href": "https://openvibe.tips/Example" },
+ { "id": "mute", "label": "Mute", "method": "PUT", "path": "/api/v1/me/mutes/Example", "state": { "muted": false } },
+ { "id": "block", "label": "Block", "method": "PUT", "path": "/api/v1/me/blocks/Example", "state": { "blocked": false } },
+ { "id": "report", "label": "Report", "method": "POST", "path": "/api/v1/me/reports", "body": { "target": "Example", "reason": "other", "detail": "" }, "state": { "reported": false } }
+ ]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{ "reports": [{ "id": 1, "reporter": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1", "target": "not-a-subject", "reason": "spam", "detail": "", "status": "open", "created_at": "2026-11-11T03:30:00Z", "updated_at": "2026-11-11T03:30:00Z" }] }
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{ "reports": {} }
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{ "reports": [] }
new file mode 100644
new file mode 100644
@@ -0,0 +1,14 @@
@@ -0,0 +1,14 @@
+{
+ "reports": [
+ {
+ "id": 12,
+ "reporter": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1",
+ "target": "usr_01JAB2C3D4E5F6G7H8J9K0MNT2",
+ "reason": "spam",
+ "detail": "",
+ "status": "open",
+ "created_at": "2026-11-11T03:30:00Z",
+ "updated_at": "2026-11-11T03:30:00Z"
+ }
+ ]
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{ "target": "Example", "reason": "dislike" }
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{ "reason": "spam" }
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{ "target": "Example", "reason": "spam", "detail": "Sending the same link in every room." }
new file mode 100644
new file mode 100644
@@ -0,0 +1 @@
@@ -0,0 +1 @@
+{ "target": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1", "reason": "harassment" }
new file mode 100644
new file mode 100644
@@ -0,0 +1,10 @@
@@ -0,0 +1,10 @@
+{
+ "id": 12,
+ "reporter": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1",
+ "target": "usr_01JAB2C3D4E5F6G7H8J9K0MNT2",
+ "reason": "spam",
+ "detail": "",
+ "status": "banned",
+ "created_at": "2026-11-11T03:30:00Z",
+ "updated_at": "2026-11-11T03:30:00Z"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,11 @@
@@ -0,0 +1,11 @@
+{
+ "id": 12,
+ "reporter": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1",
+ "target": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1",
+ "reason": "spam",
+ "detail": "",
+ "status": "open",
+ "created_at": "2026-11-11T03:30:00Z",
+ "updated_at": "2026-11-11T03:30:00Z",
+ "extra": true
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,10 @@
@@ -0,0 +1,10 @@
+{
+ "id": 12,
+ "reporter": "usr_01JAB2C3D4E5F6G7H8J9K0MNV1",
+ "target": "usr_01JAB2C3D4E5F6G7H8J9K0MNT2",
+ "reason": "spam",
+ "detail": "Sending the same link in every room.",
+ "status": "open",
+ "created_at": "2026-11-11T03:30:00Z",
+ "updated_at": "2026-11-11T03:30:00Z"
+}
@@ -58980,6 +58980,20 @@
@@ -58980,6 +58980,20 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "The hover preview of this item: about 6 s, muted, 320 px wide, MP4 H.264, stored beside its thumbnail and served at /t/<name>. Null until the preview.make job has made it (audio-only, private and too-short items never get one)."
+ },
+ "preview_webm_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "The same moment as preview_url, encoded as WebM (VP9, VP8 where the encoder has no VP9). Null while preview_url is."
+ },
"storage_provider": {
"storage_provider": {
"type": "string",
"type": "string",
"description": "local, b2 or r2."
"description": "local, b2 or r2."
@@ -59188,6 +59202,20 @@
@@ -59188,6 +59202,20 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "The hover preview of this item: about 6 s, muted, 320 px wide, MP4 H.264, stored beside its thumbnail and served at /t/<name>. Null until the preview.make job has made it (audio-only, private and too-short items never get one)."
+ },
+ "preview_webm_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "The same moment as preview_url, encoded as WebM (VP9, VP8 where the encoder has no VP9). Null while preview_url is."
+ },
"storage_provider": {
"storage_provider": {
"type": "string"
"type": "string"
},
},
@@ -60116,6 +60144,59 @@
@@ -60116,6 +60144,59 @@
}
}
}
}
},
},
+ "chat.command-registration-request": {
+ "version": "1.0.0",
+ "owner": "chat",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/chat/command-registration-request.v1.json",
+ "title": "Chat command registration request",
+ "description": "chat.command-registration-request@1: an approved app or Actor agent registers a plain-response command in a server that the person named in its service token manages. The command cannot override a built-in. The template's {args} placeholder receives the invoking person's argument text; Chat posts the expanded result as that person after checking their current room rights.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "server",
+ "command",
+ "response_template"
+ ],
+ "properties": {
+ "server": {
+ "type": "string",
+ "pattern": "^[a-z0-9][a-z0-9-]{1,31}$"
+ },
+ "command": {
+ "$ref": "command.v1.json"
+ },
+ "response_template": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 2000
+ }
+ }
+ }
+ },
+ "chat.command-registration-result": {
+ "version": "1.0.0",
+ "owner": "chat",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/chat/command-registration-result.v1.json",
+ "title": "Chat command registration result",
+ "description": "chat.command-registration-result@1: the command Chat stored for an approved app or Actor agent, with source and application_id derived from the verified service token.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "command"
+ ],
+ "properties": {
+ "command": {
+ "$ref": "command.v1.json"
+ }
+ }
+ }
+ },
"chat.send-request": {
"chat.send-request": {
"version": "1.1.0",
"version": "1.1.0",
"owner": "chat",
"owner": "chat",
@@ -63577,6 +63658,173 @@
@@ -63577,6 +63658,173 @@
}
}
}
}
},
},
+ "chat.person-memory-result": {
+ "version": "1.0.0",
+ "owner": "chat",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/chat/person-memory-result.v1.json",
+ "title": "ChatPersonMemoryResult",
+ "description": "chat.person-memory-result@1: compacted chat memory returned by GET /api/v1/people/{username}/memory. Private fields appear only for the person and the channel owner.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "username",
+ "level",
+ "channel",
+ "entries",
+ "opted_out",
+ "enabled"
+ ],
+ "properties": {
+ "username": {
+ "type": "string",
+ "minLength": 1
+ },
+ "level": {
+ "enum": [
+ "day",
+ "week",
+ "month"
+ ]
+ },
+ "channel": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "opted_out": {
+ "type": "boolean"
+ },
+ "enabled": {
+ "type": "boolean"
+ },
+ "entries": {
+ "type": "array",
+ "maxItems": 60,
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "level",
+ "period_start",
+ "channel_user_id",
+ "summary",
+ "topics",
+ "highlights",
+ "message_count"
+ ],
+ "properties": {
+ "level": {
+ "enum": [
+ "day",
+ "week",
+ "month"
+ ]
+ },
+ "period_start": {
+ "type": "string",
+ "format": "date"
+ },
+ "channel_user_id": {
+ "type": "integer"
+ },
+ "summary": {
+ "type": "string",
+ "maxLength": 500
+ },
+ "topics": {
+ "type": "array",
+ "maxItems": 5,
+ "items": {
+ "type": "string"
+ }
+ },
+ "highlights": {
+ "type": "array",
+ "maxItems": 5,
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "detail",
+ "stream_id",
+ "at"
+ ],
+ "properties": {
+ "detail": {
+ "type": "string",
+ "maxLength": 180
+ },
+ "stream_id": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ }
+ }
+ },
+ "message_count": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "tone": {
+ "type": "string",
+ "maxLength": 120
+ },
+ "catchphrases": {
+ "type": "array",
+ "maxItems": 5,
+ "items": {
+ "type": "string"
+ }
+ },
+ "people": {
+ "type": "array",
+ "maxItems": 8,
+ "items": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "chat.person-memory-preferences-result": {
+ "version": "1.0.0",
+ "owner": "chat",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/chat/person-memory-preferences-result.v1.json",
+ "title": "ChatPersonMemoryPreferencesResult",
+ "description": "chat.person-memory-preferences-result@1: the person's delete or opt-out result.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "opted_out"
+ ],
+ "properties": {
+ "opted_out": {
+ "type": "boolean"
+ },
+ "deleted": {
+ "type": "boolean"
+ }
+ }
+ }
+ },
"chat.embed": {
"chat.embed": {
"version": "1.0.0",
"version": "1.0.0",
"owner": "chat",
"owner": "chat",
@@ -63585,7 +63833,7 @@
@@ -63585,7 +63833,7 @@
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://openvibe.network/contracts/chat/embed.v1.json",
"$id": "https://openvibe.network/contracts/chat/embed.v1.json",
"title": "ChatEmbed",
"title": "ChatEmbed",
- "description": "chat.embed@1: one address preview under a chat message, the same shape for every client (OpenVibe.Chat, Live's chat and the Dock). A message carries `embeds` in the order the addresses appeared in its text, at most three; it is empty while the background job is still reading, and the client draws each one as the same card. The fields are data, never markup: a client escapes them (title, description, site_name, by) before drawing them. url is the address the writer sent, https only. image is an OpenVibe.Media address or null: another site's picture is never hot-linked. width and height are the picture's stated size, or 0. kind names what was found: an ordinary page (`link`), a video (`video`), a picture (`image`), a Live channel (`live`), a Pics picture (`picture`), a Design item (`design`), a Community post (`post`), a Network profile (`profile`) or a Games world (`game`). OpenVibe's own kinds are resolved through that service's public API, never by reading its page, and carry by (the person or channel the thing belongs to) and, for Live, live (whether the channel is broadcasting now); both are absent on an ordinary link.",
+ "description": "chat.embed@1: one address preview under a chat message, the same shape for every client (OpenVibe.Chat, Live's chat and the Dock). A message carries `embeds` in the order the addresses appeared in its text, at most three; it is empty while the background job is still reading, and the client draws each one as the same card. The fields are data, never markup: a client escapes them (title, description, site_name, by) before drawing them. url is the address the writer sent, https only. image is an OpenVibe.Media address or null: another site's picture is never hot-linked. width and height are the picture's stated size, or 0. kind names what was found: an ordinary page (`link`), a video (`video`), a picture (`image`), a Live channel (`live`), a Pics picture (`picture`), a Design item (`design`), a Community post (`post`), a Network profile (`profile`) or a Games world (`game`). OpenVibe's own kinds are resolved through that service's public API, never by reading its page, and carry by (the person or channel the thing belongs to) and, for Live, live (whether the channel is broadcasting now); both are absent on an ordinary link. An agent-run embed carries the live run and event addresses, title and status.",
"type": "object",
"type": "object",
"additionalProperties": false,
"additionalProperties": false,
"required": [
"required": [
@@ -63610,7 +63858,8 @@
@@ -63610,7 +63858,8 @@
"design",
"design",
"post",
"post",
"profile",
"profile",
- "game"
+ "game",
+ "agent-run"
],
],
"description": "What the address turned out to be; a client may draw the same card for every value."
"description": "What the address turned out to be; a client may draw the same card for every value."
},
},
@@ -63629,8 +63878,7 @@
@@ -63629,8 +63878,7 @@
"title": {
"title": {
"type": "string",
"type": "string",
"minLength": 1,
"minLength": 1,
- "maxLength": 120,
- "description": "The page's or service's title, folded to plain text."
+ "maxLength": 240
},
},
"description": {
"description": {
"type": "string",
"type": "string",
@@ -63666,8 +63914,53 @@
@@ -63666,8 +63914,53 @@
"live": {
"live": {
"type": "boolean",
"type": "boolean",
"description": "On a Live channel kind, whether it is broadcasting now. Absent on the other kinds."
"description": "On a Live channel kind, whether it is broadcasting now. Absent on the other kinds."
+ },
+ "run_url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://",
+ "maxLength": 2048
+ },
+ "events_url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://",
+ "maxLength": 2048
+ },
+ "status": {
+ "enum": [
+ "queued",
+ "running",
+ "waiting",
+ "needs_you",
+ "succeeded",
+ "failed",
+ "stopped",
+ "cancelled"
+ ]
}
}
- }
+ },
+ "allOf": [
+ {
+ "if": {
+ "properties": {
+ "kind": {
+ "const": "agent-run"
+ }
+ },
+ "required": [
+ "kind"
+ ]
+ },
+ "then": {
+ "required": [
+ "run_url",
+ "events_url",
+ "status"
+ ]
+ }
+ }
+ ]
}
}
},
},
"chat.first-chat-result": {
"chat.first-chat-result": {
@@ -64966,6 +65259,13 @@
@@ -64966,6 +65259,13 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."
+ },
"started_at": {
"started_at": {
"type": [
"type": [
"string",
"string",
@@ -65960,6 +66260,13 @@
@@ -65960,6 +66260,13 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."
+ },
"started_at": {
"started_at": {
"type": [
"type": [
"string",
"string",
@@ -66074,6 +66381,13 @@
@@ -66074,6 +66381,13 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."
+ },
"started_at": {
"started_at": {
"type": [
"type": [
"string",
"string",
@@ -68251,7 +68565,7 @@
@@ -68251,7 +68565,7 @@
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://openvibe.network/contracts/community/pulse-write-request.v1.json",
"$id": "https://openvibe.network/contracts/community/pulse-write-request.v1.json",
"title": "CommunityPulseWriteRequest",
"title": "CommunityPulseWriteRequest",
- "description": "community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities (ref.service must be that service: 403 pulse.foreign_ref otherwise), with a title (whitespace collapsed, 1 to 300 characters) and an absolute http(s) url (at most 2000 characters). origin defaults to X-OV-Origin (user, ai or system; X-OV-Origin: ai always wins); an origin user item names the person in X-OV-Subject. occurred_at is an ISO time, not in the future (default now). Only public activity enters Pulse: a visibility other than public is 400 pulse.not_public. The same ref again updates the item. Unknown fields are ignored. DELETE /api/v1/pulse/items/:service/:type/:id takes no body.",
+ "description": "community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities, with a title and an absolute http(s) URL. Optional media carries an HTTPS thumbnail, preview video, aspect ratio and duration for Feed cards. Visibility is public by default; followers requires origin user and X-OV-Subject and is shown only to that person's followers. Private, unlisted and members items are refused. The same ref updates the item. DELETE /api/v1/pulse/items/:service/:type/:id retracts it.",
"anyOf": [
"anyOf": [
{
{
"type": "object",
"type": "object",
@@ -68293,8 +68607,38 @@
@@ -68293,8 +68607,38 @@
"visibility": {
"visibility": {
"enum": [
"enum": [
"public",
"public",
+ "followers",
null
null
]
]
+ },
+ "media": {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "thumb": {
+ "type": "string",
+ "pattern": "^https://",
+ "maxLength": 2000
+ },
+ "preview": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "pattern": "^https://",
+ "maxLength": 2000
+ },
+ "ratio": {
+ "type": "number",
+ "exclusiveMinimum": 0,
+ "maximum": 20
+ },
+ "length": {
+ "type": "number",
+ "minimum": 0,
+ "maximum": 86400
+ }
+ }
}
}
}
}
},
},
@@ -68936,6 +69280,20 @@
@@ -68936,6 +69280,20 @@
"system"
"system"
]
]
},
},
+ "visibility": {
+ "enum": [
+ "followers"
+ ],
+ "description": "Present only for an item returned to an authorized follower or its author."
+ },
+ "starts_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "actor_name": {
+ "type": "string",
+ "maxLength": 80
+ },
"label": {
"label": {
"enum": [
"enum": [
"AI",
"AI",
@@ -69021,7 +69379,7 @@
@@ -69021,7 +69379,7 @@
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://openvibe.network/contracts/community/feed-item.v1.json",
"$id": "https://openvibe.network/contracts/community/feed-item.v1.json",
"title": "CommunityFeedItem",
"title": "CommunityFeedItem",
- "description": "community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). One stream over Pulse: a paste or a status is a post, a Live clip a clip, a Wiki page a wiki page, a Quest badge a quest, a busy Chat hour a chat, a Today event an event, and a day's new Network accounts a member. Text only (the client draws every field), https links only, and counts carry Community's own views, likes and comments where it knows them.",
+ "description": "community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). Each card keeps its source and public visibility. Scheduled calendar cards appear only before their start time; bursts can carry a group of links. Counts carry Community's own views, likes and comments where it knows them.",
"type": "object",
"type": "object",
"additionalProperties": false,
"additionalProperties": false,
"required": [
"required": [
@@ -69059,7 +69417,14 @@
@@ -69059,7 +69417,14 @@
"quest",
"quest",
"chat",
"chat",
"event",
"event",
- "member"
+ "member",
+ "avatar",
+ "banner",
+ "paste",
+ "site",
+ "space",
+ "follow",
+ "episode"
]
]
},
},
"url": {
"url": {
@@ -69085,6 +69450,17 @@
@@ -69085,6 +69450,17 @@
"format": "date-time",
"format": "date-time",
"description": "When it happened (Pulse provenance); null for a trending card."
"description": "When it happened (Pulse provenance); null for a trending card."
},
},
+ "starts_at": {
+ "type": "string",
+ "format": "date-time",
+ "description": "The start time of a Coming up calendar item; absent on other kinds."
+ },
+ "visibility": {
+ "enum": [
+ "followers"
+ ],
+ "description": "Present only for an item returned to a follower or its author."
+ },
"site": {
"site": {
"type": "string",
"type": "string",
"maxLength": 40,
"maxLength": 40,
@@ -69138,6 +69514,11 @@
@@ -69138,6 +69514,11 @@
"pattern": "^https://",
"pattern": "^https://",
"maxLength": 2000
"maxLength": 2000
},
},
+ "preview": {
+ "type": "string",
+ "pattern": "^https://",
+ "maxLength": 2000
+ },
"ratio": {
"ratio": {
"type": "number",
"type": "number",
"exclusiveMinimum": 0
"exclusiveMinimum": 0
@@ -69173,6 +69554,52 @@
@@ -69173,6 +69554,52 @@
"type": "boolean",
"type": "boolean",
"description": "Present on live and stream cards: true only while the channel is currently on air. A past broadcast has kind stream and live_now false."
"description": "Present on live and stream cards: true only while the channel is currently on air. A past broadcast has kind stream and live_now false."
},
},
+ "group": {
+ "type": "object",
+ "required": [
+ "count",
+ "items"
+ ],
+ "properties": {
+ "count": {
+ "type": "integer",
+ "minimum": 2
+ },
+ "items": {
+ "type": "array",
+ "minItems": 2,
+ "items": {
+ "type": "object",
+ "required": [
+ "id",
+ "url",
+ "title",
+ "media"
+ ],
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string",
+ "pattern": "^https://"
+ },
+ "title": {
+ "type": "string"
+ },
+ "media": {
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "additionalProperties": false
+ }
+ }
+ },
+ "additionalProperties": false
+ },
"label": {
"label": {
"enum": [
"enum": [
"Trending",
"Trending",
@@ -69184,6 +69611,205 @@
@@ -69184,6 +69611,205 @@
}
}
}
}
},
},
+ "community.feed-card": {
+ "version": "1.0.0",
+ "owner": "community",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/community/feed-card.v1.json",
+ "title": "CommunityFeedCard",
+ "description": "community.feed-card@1: one public card returned by GET /api/v1/feed on OpenVibe.Community.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "kind",
+ "url",
+ "title",
+ "text",
+ "at",
+ "site",
+ "site_name",
+ "actor",
+ "media",
+ "counts"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 500
+ },
+ "kind": {
+ "enum": [
+ "live",
+ "stream",
+ "clip",
+ "video",
+ "pic",
+ "post",
+ "meme",
+ "game",
+ "update",
+ "wiki",
+ "quest",
+ "chat",
+ "event",
+ "member"
+ ]
+ },
+ "url": {
+ "type": "string",
+ "pattern": "^https?://",
+ "maxLength": 2000
+ },
+ "title": {
+ "type": "string",
+ "maxLength": 300
+ },
+ "text": {
+ "type": "string",
+ "maxLength": 280
+ },
+ "at": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "date-time"
+ },
+ "site": {
+ "type": "string",
+ "maxLength": 40
+ },
+ "site_name": {
+ "type": "string",
+ "maxLength": 40
+ },
+ "actor": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "required": [
+ "name",
+ "avatar"
+ ],
+ "properties": {
+ "name": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 80
+ },
+ "avatar": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 2000
+ }
+ },
+ "additionalProperties": false
+ },
+ "media": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "required": [
+ "thumb",
+ "ratio"
+ ],
+ "properties": {
+ "thumb": {
+ "type": "string",
+ "pattern": "^https://",
+ "maxLength": 2000
+ },
+ "preview": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "pattern": "^https://",
+ "maxLength": 2000
+ },
+ "ratio": {
+ "type": "number",
+ "exclusiveMinimum": 0
+ },
+ "length": {
+ "type": "number",
+ "minimum": 0
+ }
+ },
+ "additionalProperties": false
+ },
+ "counts": {
+ "type": "object",
+ "properties": {
+ "views": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "likes": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "comments": {
+ "type": "integer",
+ "minimum": 0
+ }
+ },
+ "additionalProperties": false
+ },
+ "live_now": {
+ "type": "boolean"
+ },
+ "label": {
+ "enum": [
+ "Trending",
+ "AI",
+ "System"
+ ]
+ }
+ }
+ }
+ },
+ "community.feed-answer": {
+ "version": "1.0.0",
+ "owner": "community",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/community/feed-answer.v1.json",
+ "title": "CommunityFeedAnswer",
+ "description": "community.feed-answer@1: the response from GET /api/v1/feed.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "items",
+ "next_cursor"
+ ],
+ "properties": {
+ "items": {
+ "type": "array",
+ "items": {
+ "$ref": "feed-card.v1.json"
+ }
+ },
+ "next_cursor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ }
+ }
+ },
"community.pulse-read-result": {
"community.pulse-read-result": {
"version": "1.0.0",
"version": "1.0.0",
"owner": "community",
"owner": "community",
@@ -124594,6 +125220,3734 @@
@@ -124594,6 +125220,3734 @@
},
},
"description": "NetworkLevelBoard: one earned platform level owned by Network; experience is never bought or spent."
"description": "NetworkLevelBoard: one earned platform level owned by Network; experience is never bought or spent."
}
}
+ },
+ "composer.attachment": {
+ "version": "1.0.0",
+ "owner": "media",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/composer/attachment.v1.json",
+ "title": "ComposerAttachment",
+ "description": "composer.attachment@1: one file a person attached to a message in the shared composer. Media stores it and answers this shape from POST /api/v1/attachments (multipart field `file`); a client keeps it until the message is sent, then names it in POST /api/v1/attachments/:id/keep. `kind` is sniffed from the bytes, never taken from the browser: image, video, audio, file or code. `thumb` is a small preview for images and video (absent for the rest), `w`/`h` the pixel size when the file is one Media can measure. An attachment nobody keeps expires after 24 hours; `expires_at` says when, and a keep extends it to the message's life.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "kind",
+ "name",
+ "size",
+ "mime",
+ "url",
+ "expires_at"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^att_[0-9A-HJKMNP-TV-Z]{26}$",
+ "description": "The attachment id (att_ + ULID): what DELETE /api/v1/attachments/:id and POST /api/v1/attachments/:id/keep name."
+ },
+ "kind": {
+ "enum": [
+ "image",
+ "video",
+ "audio",
+ "file",
+ "code"
+ ],
+ "description": "Decided by Media from the bytes, not the client's claim: image/video/audio when the signature matches, code for recognised source text, otherwise file. Executables are refused at upload."
+ },
+ "name": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 255,
+ "description": "The file's original name, sanitised for display; never a path."
+ },
+ "size": {
+ "type": "integer",
+ "minimum": 1,
+ "description": "Bytes stored."
+ },
+ "mime": {
+ "type": "string",
+ "description": "The content type Media serves the bytes as, from the sniffed kind and format."
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "description": "Absolute https URL the bytes are served at. It stays valid while the attachment exists; a kept attachment is the message's to serve."
+ },
+ "thumb": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "uri",
+ "description": "Absolute URL of a preview image: an image's own small copy or a video's first frame. Null when Media could not make one (or the kind has none)."
+ },
+ "w": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 1,
+ "description": "Pixel width of an image, video or video preview; null when unknown."
+ },
+ "h": {
+ "type": [
+ "integer",
+ "null"
+ ],
+ "minimum": 1,
+ "description": "Pixel height of an image, video or video preview; null when unknown."
+ },
+ "expires_at": {
+ "type": "string",
+ "format": "date-time",
+ "description": "When an unkept attachment is deleted. The upload answers now + 24 hours; a keep moves it to the kept window."
+ }
+ }
+ }
+ },
+ "composer.prefs": {
+ "version": "1.0.0",
+ "owner": "network",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/composer/prefs.v1.json",
+ "title": "ComposerPrefs",
+ "description": "composer.prefs@1: a person's composer settings, the same on every OpenVibe site because Network stores them (GET/PUT /api/v1/me/composer). `rev` is the stored revision: send the one you read back with your change, and a tab that read an older copy gets 409 with the current document instead of overwriting the other tab. `send_key` says whether Enter or Ctrl/Cmd+Enter sends. `tools` is the one order of the composer's tools and which are hidden; a tool id the client does not know is kept, so a site can add one without another site dropping the person's order. `snippets` are the person's saved inserts, triggered by typing a slash word.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "rev",
+ "send_key",
+ "tools",
+ "density",
+ "voice",
+ "snippets"
+ ],
+ "properties": {
+ "rev": {
+ "type": "integer",
+ "minimum": 0,
+ "description": "Revision of the stored document. A missing document is rev 0 with the defaults; every successful PUT answers rev + 1."
+ },
+ "send_key": {
+ "enum": [
+ "enter",
+ "mod-enter"
+ ],
+ "description": "enter: Enter sends and Shift+Enter breaks the line. mod-enter: Ctrl/Cmd+Enter sends and Enter breaks the line (the default on a phone keyboard is enter)."
+ },
+ "tools": {
+ "type": "array",
+ "maxItems": 100,
+ "description": "Every tool in the order the person wants them, each marked hidden or not.",
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "hidden"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 40,
+ "pattern": "^[a-z0-9][a-z0-9._-]*$"
+ },
+ "hidden": {
+ "type": "boolean"
+ }
+ }
+ }
+ },
+ "density": {
+ "enum": [
+ "comfy",
+ "compact"
+ ],
+ "description": "How much room the composer takes: comfy is the default on a computer, compact on a phone."
+ },
+ "voice": {
+ "type": "boolean",
+ "description": "Whether the composer offers dictation (where the device has it)."
+ },
+ "snippets": {
+ "type": "array",
+ "maxItems": 50,
+ "description": "Saved inserts. Typing the trigger (a slash word such as /sig) in the composer offers the snippet.",
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "trigger",
+ "label",
+ "text"
+ ],
+ "properties": {
+ "trigger": {
+ "type": "string",
+ "pattern": "^/[a-z0-9][a-z0-9_-]{0,31}$",
+ "description": "The slash word that offers the snippet, e.g. /sig. Lower-case letters, digits, _ and - only."
+ },
+ "label": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 80,
+ "description": "What the menu shows."
+ },
+ "text": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 4000,
+ "description": "What is inserted."
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "composer.mention": {
+ "version": "1.0.0",
+ "owner": "network",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/composer/mention.v1.json",
+ "title": "ComposerMention",
+ "description": "composer.mention@1: one thing the composer's @ menu can insert, from GET /api/v1/mentions on OpenVibe.Network. kind person (a person the caller follows first, then a public person), repo (a repository on OpenVibe Git the caller can see), site (a first-party OpenVibe site) or file (a file of the message's own context). `id` is the stable id inside its kind, `label` what the menu shows, `handle` the @name when the kind has one, `avatar` the picture, and `url` where choosing it links.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "kind",
+ "id",
+ "label",
+ "url"
+ ],
+ "properties": {
+ "kind": {
+ "enum": [
+ "person",
+ "repo",
+ "site",
+ "file"
+ ],
+ "description": "What is mentioned. The same person is a person; a repository on OpenVibe Git is a repo; a first-party OpenVibe site is a site; a file of the message's context (an attachment or a repository file) is a file."
+ },
+ "id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200,
+ "description": "The stable id inside the kind: a usr_… subject for a person, owner/name for a repo, a site id for a site, a path or attachment id for a file."
+ },
+ "label": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200,
+ "description": "What the menu shows (a display name, owner/name, the site's name, a file name)."
+ },
+ "handle": {
+ "type": "string",
+ "maxLength": 64,
+ "pattern": "^[A-Za-z0-9_.-]+$",
+ "description": "The @name when the kind has one: a person's username, a site's short name. Absent for a repo or a file."
+ },
+ "avatar": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "uri",
+ "description": "Absolute URL of the picture to show beside the label. Null when the kind has none (a file, a site without a mark)."
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "description": "Absolute https URL where choosing the mention leads: the person's profile, the repository, the site's home or the file."
+ }
+ }
+ }
+ },
+ "network.user-card": {
+ "version": "1.0.0",
+ "owner": "network",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/network/user-card.v1.json",
+ "title": "NetworkUserCard",
+ "description": "network.user-card@1 (ask 287): the one public user card read, GET /api/v1/people/:username/card on OpenVibe.Network. It is public and credential-free; a signed-in viewer may send their Network token (Authorization: Bearer …) and then also receives `actions` computed for that viewer, never cached. Without a viewer, or on the viewer's own card, `actions` carries Profile and Channel only. A missing, expired or revoked token reads as anonymous, never a 401. Hidden fields are absent, never zero, offline or a placeholder; no presence, page titles or visited URLs leave the read.",
+ "type": "object",
+ "required": [
+ "username",
+ "profile_url",
+ "actions"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "username": {
+ "type": "string",
+ "pattern": "^[A-Za-z0-9_]{3,24}$"
+ },
+ "display_name": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 200
+ },
+ "avatar_url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://"
+ },
+ "profile_url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://"
+ },
+ "level": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "streak": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "badges_count": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "followers": {
+ "type": "integer",
+ "minimum": 0
+ },
+ "live": {
+ "type": "object",
+ "required": [
+ "now"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "now": {
+ "type": "boolean"
+ },
+ "site": {
+ "const": "live"
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://"
+ }
+ }
+ },
+ "channel_url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://"
+ },
+ "active_sites": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "id",
+ "name",
+ "url"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^[a-z][a-z0-9-]{1,39}$"
+ },
+ "name": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 80
+ },
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://"
+ }
+ }
+ }
+ },
+ "actions": {
+ "type": "array",
+ "description": "What the viewer can do, by what is possible for the pair. Order is the card's order. Each action either opens somewhere (`href`) or calls a Network route with the viewer's token (`method` + `path`, and `body` where the route needs one).",
+ "items": {
+ "$ref": "#/$defs/action"
+ }
+ }
+ },
+ "$defs": {
+ "action": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "id",
+ "label",
+ "href"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "id": {
+ "$ref": "#/$defs/id"
+ },
+ "label": {
+ "$ref": "#/$defs/label"
+ },
+ "href": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://"
+ },
+ "state": {
+ "$ref": "#/$defs/state"
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "id",
+ "label",
+ "method",
+ "path"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "id": {
+ "$ref": "#/$defs/id"
+ },
+ "label": {
+ "$ref": "#/$defs/label"
+ },
+ "method": {
+ "enum": [
+ "PUT",
+ "POST",
+ "DELETE",
+ "PATCH"
+ ]
+ },
+ "path": {
+ "type": "string",
+ "pattern": "^/api/v1/"
+ },
+ "body": {
+ "type": "object"
+ },
+ "state": {
+ "$ref": "#/$defs/state"
+ }
+ }
+ }
+ ]
+ },
+ "id": {
+ "type": "string",
+ "pattern": "^[a-z][a-z0-9-]{1,39}$"
+ },
+ "label": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 40
+ },
+ "state": {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "following": {
+ "type": "boolean"
+ },
+ "friendship": {
+ "enum": [
+ "none",
+ "pending",
+ "requested",
+ "friends"
+ ]
+ },
+ "muted": {
+ "type": "boolean"
+ },
+ "blocked": {
+ "type": "boolean"
+ },
+ "reported": {
+ "type": "boolean"
+ }
+ }
+ }
+ }
+ }
+ },
+ "network.user-report": {
+ "version": "1.0.0",
+ "owner": "network",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/network/user-report.v1.json",
+ "title": "NetworkUserReport",
+ "description": "network.user-report@1 (ask 287): one report a person filed about another person on OpenVibe.Network. Reports never resolve themselves; staff holding staff.moderation.logs read the queue (GET /api/v1/staff/user-reports?status=open&target=usr_…&limit=), and a staff decision lives in the moderation audit log. `status` records whether staff have looked, not a verdict.",
+ "type": "object",
+ "required": [
+ "id",
+ "reporter",
+ "target",
+ "reason",
+ "detail",
+ "status",
+ "created_at",
+ "updated_at"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "id": {
+ "type": "integer",
+ "minimum": 1
+ },
+ "reporter": {
+ "type": "string",
+ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ "target": {
+ "type": "string",
+ "pattern": "^usr_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ "reason": {
+ "enum": [
+ "spam",
+ "harassment",
+ "impersonation",
+ "explicit",
+ "scam",
+ "other"
+ ]
+ },
+ "detail": {
+ "type": "string",
+ "maxLength": 2000
+ },
+ "status": {
+ "enum": [
+ "open",
+ "reviewed",
+ "dismissed"
+ ]
+ },
+ "created_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "updated_at": {
+ "type": "string",
+ "format": "date-time"
+ }
+ }
+ }
+ },
+ "network.user-report-list-result": {
+ "version": "1.0.0",
+ "owner": "network",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/network/user-report-list-result.v1.json",
+ "title": "NetworkUserReportListResult",
+ "description": "network.user-report-list-result@1 (ask 287): GET /api/v1/staff/user-reports on OpenVibe.Network, the staff queue for people holding staff.moderation.logs. Newest first, filtered by status (default open) and target subject, at most 200 rows (`limit`, default 50). A caller without the capability gets 403 user_reports.forbidden (problem+json).",
+ "type": "object",
+ "required": [
+ "reports"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "reports": {
+ "type": "array",
+ "maxItems": 200,
+ "items": {
+ "$ref": "user-report.v1.json"
+ }
+ }
+ }
+ }
+ },
+ "network.user-report-request": {
+ "version": "1.0.0",
+ "owner": "network",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/network/user-report-request.v1.json",
+ "title": "NetworkUserReportRequest",
+ "description": "network.user-report-request@1 (ask 287): POST /api/v1/me/reports on OpenVibe.Network, a signed-in person's report about another person. `target` is their username (any case) or usr_ subject; guests cannot be named, and nobody reports themselves. The same pair may have one open report: filing again while it is open answers the open one with 200 instead of creating a duplicate (201 when it creates one).",
+ "type": "object",
+ "required": [
+ "target",
+ "reason"
+ ],
+ "additionalProperties": false,
+ "properties": {
+ "target": {
+ "type": "string",
+ "pattern": "^([A-Za-z0-9_]{3,24}|usr_[0-9A-HJKMNP-TV-Z]{26})$"
+ },
+ "reason": {
+ "enum": [
+ "spam",
+ "harassment",
+ "impersonation",
+ "explicit",
+ "scam",
+ "other"
+ ]
+ },
+ "detail": {
+ "type": "string",
+ "maxLength": 2000
+ }
+ }
+ }
+ },
+ "agent.ui-event": {
+ "version": "1.0.0",
+ "owner": "actor",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/agent/ui-event.v1.json",
+ "title": "AgentUiEvent",
+ "description": "agent.ui-event@1: AG-UI 1.0 event shape and event-family fields, with OpenVibe metadata.ov. AG-UI timestamps are Unix-millisecond integers; this contract requires one on every event. CUSTOM events use AG-UI name/value with ov.sources, ov.handoff, ov.approval or ov.result names.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/Event"
+ },
+ {
+ "type": "object",
+ "required": [
+ "timestamp"
+ ]
+ }
+ ],
+ "definitions": {
+ "EventType": {
+ "type": "string",
+ "description": "The discriminator carried by every event.",
+ "enum": [
+ "TEXT_MESSAGE_START",
+ "TEXT_MESSAGE_CONTENT",
+ "TEXT_MESSAGE_END",
+ "TEXT_MESSAGE_CHUNK",
+ "TOOL_CALL_START",
+ "TOOL_CALL_ARGS",
+ "TOOL_CALL_END",
+ "TOOL_CALL_CHUNK",
+ "TOOL_CALL_RESULT",
+ "STATE_SNAPSHOT",
+ "STATE_DELTA",
+ "MESSAGES_SNAPSHOT",
+ "ACTIVITY_SNAPSHOT",
+ "ACTIVITY_DELTA",
+ "RAW",
+ "CUSTOM",
+ "RUN_STARTED",
+ "RUN_FINISHED",
+ "RUN_ERROR",
+ "STEP_STARTED",
+ "STEP_FINISHED",
+ "REASONING_START",
+ "REASONING_MESSAGE_START",
+ "REASONING_MESSAGE_CONTENT",
+ "REASONING_MESSAGE_END",
+ "REASONING_MESSAGE_CHUNK",
+ "REASONING_END",
+ "REASONING_ENCRYPTED_VALUE",
+ "SUBAGENT_STARTED",
+ "SUBAGENT_FINISHED",
+ "SUBAGENT_ERROR"
+ ]
+ },
+ "BaseEvent": {
+ "type": "object",
+ "description": "The fields every event carries, whatever its type. Composed into each event definition rather than repeated, so a change here reaches every event at once.",
+ "properties": {
+ "type": {
+ "$ref": "#/definitions/EventType",
+ "description": "Which event this is. Each event definition narrows this to a single value."
+ },
+ "timestamp": {
+ "type": "integer",
+ "minimum": -9007199254740991,
+ "maximum": 9007199254740991,
+ "description": "When the event was created. Bounded to the range JSON numbers survive a round trip in, so the value a consumer reads is the value the producer wrote. Deliberately not a float. The unit is not constrained here, because it never has been stated normatively; every SDK that sets it in practice uses milliseconds since the Unix epoch, and a producer choosing another unit will be misread by consumers even though it validates. Nothing in the protocol computes with this value."
+ },
+ "rawEvent": {
+ "not": {
+ "type": "null"
+ },
+ "description": "The provider-native event this one was translated from, carried verbatim for debugging and for consumers that need detail the protocol does not model. Any JSON value."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this event."
+ }
+ },
+ "required": [
+ "type"
+ ]
+ },
+ "Attributable": {
+ "type": "object",
+ "description": "Composed into everything that can belong to a subagent's work: the events that describe content or progress, the message types, and each interrupt. Run-scoped events omit it — RUN_STARTED, RUN_FINISHED and RUN_ERROR describe the run itself and MESSAGES_SNAPSHOT is conversation-wide, so none of them can belong to one subagent. A tool call omits it too and inherits its containing message's attribution.",
+ "properties": {
+ "subagentRunId": {
+ "$ref": "#/definitions/SubagentRunId",
+ "description": "The subagent invocation this belongs to. Absent means the parent agent produced it directly."
+ }
+ }
+ },
+ "SubagentRunId": {
+ "type": "string",
+ "description": "An opaque handle for one subagent invocation, not a reusable name for a subagent definition: two invocations of the same subagent carry two different values. Named to mirror runId one level down, the way the subagent's name mirrors agentId."
+ },
+ "Metadata": {
+ "type": "object",
+ "description": "Extra information attached to an event, a message, a tool call, a tool, an interrupt or a resume entry. Open by key: any JSON value is allowed under a key, including null, because a null there is meaningful data. The object itself may be absent but is never null when present. The key ag-ui is reserved for the protocol's own use; reservation is by convention, since validating the shape of a key's value would contradict being open by key.",
+ "additionalProperties": true,
+ "properties": {
+ "ov": {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "title": {
+ "type": "string",
+ "maxLength": 240
+ },
+ "kind": {
+ "enum": [
+ "search",
+ "fetch",
+ "read",
+ "edit",
+ "run",
+ "browse",
+ "ask",
+ "think",
+ "note",
+ "agent",
+ "plan"
+ ]
+ },
+ "sources": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/OvSource"
+ }
+ },
+ "attachments": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "additionalProperties": true
+ }
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "needs_you": {
+ "type": [
+ "object",
+ "null"
+ ],
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "question",
+ "actions"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 160
+ },
+ "question": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 1000
+ },
+ "actions": {
+ "type": "array",
+ "items": {},
+ "minItems": 1
+ }
+ }
+ },
+ "product": {
+ "type": "string",
+ "maxLength": 40
+ },
+ "ref": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 160
+ }
+ }
+ }
+ }
+ },
+ "State": {
+ "description": "Agent state. Any JSON value: the protocol carries state without interpreting it, so an object, an array, a string and a number are all valid."
+ },
+ "TextMessageRole": {
+ "type": "string",
+ "description": "The roles a streamed text message may take. Excludes tool, which is carried by TOOL_CALL_RESULT rather than streamed as text.",
+ "enum": [
+ "developer",
+ "system",
+ "assistant",
+ "user"
+ ]
+ },
+ "TextMessageStartEvent": {
+ "type": "object",
+ "description": "Opens a streamed text message. The content arrives as TEXT_MESSAGE_CONTENT events and the message closes with TEXT_MESSAGE_END.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TEXT_MESSAGE_START"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "Identifies the message this stream builds, and ties the later content and end events to it."
+ },
+ "role": {
+ "$ref": "#/definitions/TextMessageRole",
+ "default": "assistant",
+ "description": "Who the message is from. An absent role means assistant; that meaning is normative and stated in the prose, because a validator treats a default as documentation rather than as behaviour."
+ },
+ "name": {
+ "type": "string",
+ "description": "An optional display name for the author, for providers that distinguish several participants in one role."
+ }
+ },
+ "required": [
+ "type",
+ "messageId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "TextMessageContentEvent": {
+ "type": "object",
+ "description": "Appends a fragment to a streamed text message.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TEXT_MESSAGE_CONTENT"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The message this fragment belongs to."
+ },
+ "delta": {
+ "type": "string",
+ "description": "The fragment to append. May be the empty string: providers emit empty deltas as keep-alives and while a tool call is being decided, and rejecting them would kill runs that are working correctly."
+ }
+ },
+ "required": [
+ "type",
+ "messageId",
+ "delta"
+ ],
+ "unevaluatedProperties": false
+ },
+ "TextMessageEndEvent": {
+ "type": "object",
+ "description": "Closes a streamed text message.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TEXT_MESSAGE_END"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The message being closed."
+ }
+ },
+ "required": [
+ "type",
+ "messageId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "TextMessageChunkEvent": {
+ "type": "object",
+ "description": "A shorthand that stands in for a start, content and end sequence, for producers that cannot know in advance where a message begins. Every field is optional because a continuation chunk omits what has not changed; which message a field-less chunk continues is a sequence question the prose specification answers.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TEXT_MESSAGE_CHUNK"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The message this chunk belongs to. Absent continues the message already open."
+ },
+ "role": {
+ "$ref": "#/definitions/TextMessageRole",
+ "description": "Who the message is from, on the chunk that opens it."
+ },
+ "delta": {
+ "type": "string",
+ "description": "The fragment to append. May be the empty string."
+ },
+ "name": {
+ "type": "string",
+ "description": "An optional display name for the author."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolCallStartEvent": {
+ "type": "object",
+ "description": "Opens a tool call. The arguments arrive as TOOL_CALL_ARGS events and the call closes with TOOL_CALL_END.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TOOL_CALL_START"
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "Identifies the call, and ties the later args, end and result events to it."
+ },
+ "toolCallName": {
+ "type": "string",
+ "description": "Which tool is being called."
+ },
+ "parentMessageId": {
+ "type": "string",
+ "description": "The assistant message that holds this call. Absent means the producer did not attribute it to one."
+ }
+ },
+ "required": [
+ "type",
+ "toolCallId",
+ "toolCallName"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolCallArgsEvent": {
+ "type": "object",
+ "description": "Appends a fragment of a tool call's arguments.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TOOL_CALL_ARGS"
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "The call these arguments belong to."
+ },
+ "delta": {
+ "type": "string",
+ "description": "A fragment of the arguments, which concatenate into the call's argument text — conventionally a JSON document, though the protocol does not validate it (see FunctionCall.arguments). Deliberately a string rather than parsed JSON: a fragment is not itself a document. May be the empty string."
+ }
+ },
+ "required": [
+ "type",
+ "toolCallId",
+ "delta"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolCallEndEvent": {
+ "type": "object",
+ "description": "Closes a tool call, meaning its arguments are complete.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TOOL_CALL_END"
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "The call being closed."
+ }
+ },
+ "required": [
+ "type",
+ "toolCallId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolCallChunkEvent": {
+ "type": "object",
+ "description": "A shorthand that stands in for a tool call's start, args and end sequence. Every field is optional for the same reason as TEXT_MESSAGE_CHUNK.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TOOL_CALL_CHUNK"
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "The call this chunk belongs to. Absent continues the call already open."
+ },
+ "toolCallName": {
+ "type": "string",
+ "description": "Which tool is being called, on the chunk that opens it."
+ },
+ "parentMessageId": {
+ "type": "string",
+ "description": "The assistant message that holds this call."
+ },
+ "delta": {
+ "type": "string",
+ "description": "A fragment of the arguments. May be the empty string."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolCallResultEvent": {
+ "type": "object",
+ "description": "Carries what a tool returned. Mints a tool message rather than appending to an existing one, which is why it has its own messageId.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "TOOL_CALL_RESULT"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The tool message this result becomes."
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "The call being answered."
+ },
+ "content": {
+ "description": "What the tool returned: either plain text, or an ordered list of parts, exactly as on the tool message this event mints. A tool returning structured data serialises it into text; media travel as parts of their own.",
+ "oneOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/ContentPart"
+ }
+ }
+ ]
+ },
+ "role": {
+ "const": "tool",
+ "description": "Present only for symmetry with the message it mints; the value is fixed, so a producer may leave it out."
+ }
+ },
+ "required": [
+ "type",
+ "messageId",
+ "toolCallId",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "StateSnapshotEvent": {
+ "type": "object",
+ "description": "Replaces the agent state wholesale. Sent when a delta cannot express the change, or to resynchronise a consumer.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "STATE_SNAPSHOT"
+ },
+ "snapshot": {
+ "$ref": "#/definitions/State",
+ "description": "The complete new state."
+ }
+ },
+ "required": [
+ "type",
+ "snapshot"
+ ],
+ "unevaluatedProperties": false
+ },
+ "StateDeltaEvent": {
+ "type": "object",
+ "description": "Changes the agent state incrementally.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "STATE_DELTA"
+ },
+ "delta": {
+ "$ref": "#/definitions/JsonPatch",
+ "description": "The change, as an RFC 6902 patch against the current state. Structural validity here does not mean the patch applies: a well-formed operation may point at a path that does not exist, which RFC 6902 leaves to the applier."
+ }
+ },
+ "required": [
+ "type",
+ "delta"
+ ],
+ "unevaluatedProperties": false
+ },
+ "MessagesSnapshotEvent": {
+ "type": "object",
+ "description": "The complete set of messages the producer owns, in order. Conversation-wide rather than a plain overwrite: a consumer may keep messages of its own that no producer tracks, so exactly how a snapshot reconciles with those is behavioural and belongs in the prose. Being conversation-wide it cannot belong to a single subagent, so it carries no attribution; it does establish which subagent owns each message it contains, through the messages themselves.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "MESSAGES_SNAPSHOT"
+ },
+ "messages": {
+ "type": "array",
+ "description": "The messages the producer is declaring, in order.",
+ "items": {
+ "$ref": "#/definitions/Message"
+ }
+ }
+ },
+ "required": [
+ "type",
+ "messages"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ActivitySnapshotEvent": {
+ "type": "object",
+ "description": "Reports structured progress that is not conversation content, such as a step a UI renders as its own widget.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "ACTIVITY_SNAPSHOT"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The activity message this describes."
+ },
+ "activityType": {
+ "type": "string",
+ "description": "What kind of activity this is. An open string: the set is the producer's, not the protocol's."
+ },
+ "content": {
+ "type": "object",
+ "description": "The activity's payload, open by key.",
+ "additionalProperties": true
+ },
+ "replace": {
+ "type": "boolean",
+ "default": true,
+ "description": "Whether this snapshot overwrites the activity's existing content. Absent means it does, and that meaning is normative; only an explicit false asks a consumer to leave what is already there. It does not ask for a merge — ACTIVITY_DELTA is how content is changed incrementally. What a consumer does with a non-overwriting snapshot is behavioural and belongs in the prose."
+ }
+ },
+ "required": [
+ "type",
+ "messageId",
+ "activityType",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ActivityDeltaEvent": {
+ "type": "object",
+ "description": "Changes an activity message's content incrementally.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "ACTIVITY_DELTA"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The activity message being changed."
+ },
+ "activityType": {
+ "type": "string",
+ "description": "What kind of activity this is."
+ },
+ "patch": {
+ "$ref": "#/definitions/JsonPatch",
+ "description": "The change, as an RFC 6902 patch against the activity's content."
+ }
+ },
+ "required": [
+ "type",
+ "messageId",
+ "activityType",
+ "patch"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RawEvent": {
+ "type": "object",
+ "description": "Passes a provider-native event through untranslated, for consumers that need detail the protocol does not model.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "RAW"
+ },
+ "event": {
+ "description": "The provider's own event. Any JSON value, and required: an event whose only purpose is to carry this would say nothing without it."
+ },
+ "source": {
+ "type": "string",
+ "description": "Which provider or framework the event came from."
+ }
+ },
+ "required": [
+ "type",
+ "event"
+ ],
+ "unevaluatedProperties": false
+ },
+ "CustomEvent": {
+ "type": "object",
+ "description": "The protocol's extension point for an application's own events. Anything a consumer does with one is outside the protocol.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "CUSTOM"
+ },
+ "name": {
+ "type": "string",
+ "description": "What this custom event is. Required: without it a consumer cannot route the value.",
+ "enum": [
+ "ov.sources",
+ "ov.handoff",
+ "ov.approval",
+ "ov.result"
+ ]
+ },
+ "value": {
+ "description": "The payload. Any JSON value, and required."
+ }
+ },
+ "required": [
+ "type",
+ "name",
+ "value"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunStartedEvent": {
+ "type": "object",
+ "description": "Opens a run. Run-scoped, so it carries no subagent attribution.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "RUN_STARTED"
+ },
+ "threadId": {
+ "type": "string",
+ "description": "The conversation this run belongs to."
+ },
+ "runId": {
+ "type": "string",
+ "description": "Identifies this run."
+ },
+ "protocolVersion": {
+ "type": "string",
+ "description": "The protocol version this producer speaks, such as \"1.0\" — the producer's own version, not an echo of the input's, which is what makes the pair a negotiation: each side declares itself and the consumer sees a downgrade the moment it happens. Absent means a producer from before the protocol carried a version."
+ },
+ "parentRunId": {
+ "type": "string",
+ "description": "The run that spawned this one, when an agent invokes another agent as a separate run rather than as a subagent within one."
+ },
+ "input": {
+ "$ref": "#/definitions/RunAgentInput",
+ "description": "The request this run was started from, echoed back so a consumer that did not make the request can still see what the agent was asked."
+ }
+ },
+ "required": [
+ "type",
+ "threadId",
+ "runId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunFinishedEvent": {
+ "type": "object",
+ "description": "Closes a run that did not fail. Run-scoped, so it carries no subagent attribution.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "RUN_FINISHED"
+ },
+ "threadId": {
+ "type": "string",
+ "description": "The conversation this run belongs to."
+ },
+ "runId": {
+ "type": "string",
+ "description": "The run being closed."
+ },
+ "result": {
+ "not": {
+ "type": "null"
+ },
+ "description": "The run's return value, if it has one. Any JSON value."
+ },
+ "outcome": {
+ "$ref": "#/definitions/RunFinishedOutcome",
+ "description": "Why the run ended. Absent means success, so every producer written before outcomes existed is already conformant."
+ },
+ "usage": {
+ "type": "array",
+ "description": "Token usage for the run, one entry per provider and model, so a run that invoked several models keeps them separate. A consumer that only wants totals sums across the entries. The run is the accounting boundary: usage covers every model call made within the run, calls made by its subagents included; an agent invoked as a separate run under parentRunId reports its own usage on its own terminal event; and a run that resumes an interrupted one reports only the calls it made itself, not the interrupted run's.",
+ "items": {
+ "$ref": "#/definitions/TokenUsage"
+ }
+ }
+ },
+ "required": [
+ "type",
+ "threadId",
+ "runId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunErrorEvent": {
+ "type": "object",
+ "description": "Ends a run that failed. Run-scoped, so it carries no subagent attribution; a subagent that fails without ending the run reports SUBAGENT_ERROR instead.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "RUN_ERROR"
+ },
+ "message": {
+ "type": "string",
+ "description": "What went wrong, for a person to read."
+ },
+ "code": {
+ "type": "string",
+ "description": "A machine-readable error code. An open string: the protocol defines no vocabulary."
+ },
+ "usage": {
+ "type": "array",
+ "description": "Token usage accrued before the failure, for a run that completed one or more model calls before dying. Scoped as on RUN_FINISHED: the run's own calls, subagents included.",
+ "items": {
+ "$ref": "#/definitions/TokenUsage"
+ }
+ }
+ },
+ "required": [
+ "type",
+ "message"
+ ],
+ "unevaluatedProperties": false
+ },
+ "StepStartedEvent": {
+ "type": "object",
+ "description": "Opens a named step within a run, for producers whose frameworks have a step concept worth surfacing.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "STEP_STARTED"
+ },
+ "stepName": {
+ "type": "string",
+ "description": "The step's name. Identifies it: the matching STEP_FINISHED carries the same name."
+ }
+ },
+ "required": [
+ "type",
+ "stepName"
+ ],
+ "unevaluatedProperties": false
+ },
+ "StepFinishedEvent": {
+ "type": "object",
+ "description": "Closes a named step.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "STEP_FINISHED"
+ },
+ "stepName": {
+ "type": "string",
+ "description": "The step being closed."
+ }
+ },
+ "required": [
+ "type",
+ "stepName"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningStartEvent": {
+ "type": "object",
+ "description": "Opens a span of reasoning. A span may contain several reasoning messages.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_START"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The span being opened."
+ }
+ },
+ "required": [
+ "type",
+ "messageId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningMessageStartEvent": {
+ "type": "object",
+ "description": "Opens a streamed reasoning message.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_MESSAGE_START"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The reasoning message this stream builds."
+ },
+ "role": {
+ "const": "reasoning",
+ "description": "Fixed, and required rather than defaulted. The requirement is inherited from the SDKs rather than chosen."
+ }
+ },
+ "required": [
+ "type",
+ "messageId",
+ "role"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningMessageContentEvent": {
+ "type": "object",
+ "description": "Appends a fragment to a streamed reasoning message.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_MESSAGE_CONTENT"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The reasoning message this fragment belongs to."
+ },
+ "delta": {
+ "type": "string",
+ "description": "The fragment to append. May be the empty string."
+ }
+ },
+ "required": [
+ "type",
+ "messageId",
+ "delta"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningMessageEndEvent": {
+ "type": "object",
+ "description": "Closes a streamed reasoning message.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_MESSAGE_END"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The reasoning message being closed."
+ }
+ },
+ "required": [
+ "type",
+ "messageId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningMessageChunkEvent": {
+ "type": "object",
+ "description": "A shorthand that stands in for a reasoning message's start, content and end sequence.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_MESSAGE_CHUNK"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The reasoning message this chunk belongs to. Absent continues the one already open."
+ },
+ "delta": {
+ "type": "string",
+ "description": "The fragment to append. May be the empty string."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningEndEvent": {
+ "type": "object",
+ "description": "Closes a span of reasoning.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_END"
+ },
+ "messageId": {
+ "type": "string",
+ "description": "The span being closed."
+ }
+ },
+ "required": [
+ "type",
+ "messageId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningEncryptedValueEvent": {
+ "type": "object",
+ "description": "Carries a provider's opaque, encrypted reasoning artefact, which a consumer stores and returns on a later turn without being able to read it.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ },
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "REASONING_ENCRYPTED_VALUE"
+ },
+ "subtype": {
+ "$ref": "#/definitions/ReasoningEncryptedValueSubtype",
+ "description": "What kind of thing entityId names, which decides where the value is stored."
+ },
+ "entityId": {
+ "type": "string",
+ "description": "What the value belongs to: a message id or a tool call id, according to subtype."
+ },
+ "encryptedValue": {
+ "type": "string",
+ "description": "The provider's opaque artefact."
+ }
+ },
+ "required": [
+ "type",
+ "subtype",
+ "entityId",
+ "encryptedValue"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningEncryptedValueSubtype": {
+ "type": "string",
+ "description": "Whether a REASONING_ENCRYPTED_VALUE belongs to a message or to a tool call.",
+ "enum": [
+ "tool-call",
+ "message"
+ ]
+ },
+ "SubagentStartedEvent": {
+ "type": "object",
+ "description": "Announces that a subagent invocation has begun. Everything the subagent produces afterwards is attributed by carrying its subagentRunId, so a consumer can group the work without replaying the stream. Composed from BaseEvent alone rather than Attributable, because here subagentRunId identifies the subagent rather than attributing the event to one; attribution to an enclosing subagent is parentSubagentRunId.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "SUBAGENT_STARTED"
+ },
+ "subagentRunId": {
+ "$ref": "#/definitions/SubagentRunId",
+ "description": "The invocation being announced."
+ },
+ "name": {
+ "type": "string",
+ "description": "The subagent's name, which is reusable across invocations, unlike subagentRunId."
+ },
+ "description": {
+ "type": "string",
+ "description": "What this subagent is for, for a consumer to display."
+ },
+ "parentSubagentRunId": {
+ "$ref": "#/definitions/SubagentRunId",
+ "description": "The subagent invocation that spawned this one, for nested delegation. Absent means the parent agent spawned it directly."
+ },
+ "parentToolCallId": {
+ "type": "string",
+ "description": "The tool call that spawned this subagent, for the pattern where agents are exposed to a model as tools. Lets a consumer tie the subagent to the call without reading rawEvent."
+ },
+ "parentMessageId": {
+ "type": "string",
+ "description": "The message that held the spawning tool call."
+ }
+ },
+ "required": [
+ "type",
+ "subagentRunId",
+ "name"
+ ],
+ "unevaluatedProperties": false
+ },
+ "SubagentFinishedEvent": {
+ "type": "object",
+ "description": "Ends a subagent invocation's segment of this run, either because the work completed or because it is suspended awaiting outside input.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "SUBAGENT_FINISHED"
+ },
+ "subagentRunId": {
+ "$ref": "#/definitions/SubagentRunId",
+ "description": "The invocation being closed."
+ },
+ "result": {
+ "not": {
+ "type": "null"
+ },
+ "description": "The subagent's return value, if it has one. Any JSON value, mirroring RUN_FINISHED.result."
+ },
+ "outcome": {
+ "$ref": "#/definitions/SubagentFinishedOutcome",
+ "description": "Why the segment ended. Absent means success. A suspended subagent is neither a success nor a failure, which is why saying so needs its own value rather than being inferred from a later interrupt."
+ }
+ },
+ "required": [
+ "type",
+ "subagentRunId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "SubagentErrorEvent": {
+ "type": "object",
+ "description": "Reports that a subagent invocation failed. The run may continue: a parent agent is free to handle a failed subagent, which is why this is not RUN_ERROR.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseEvent"
+ }
+ ],
+ "properties": {
+ "type": {
+ "const": "SUBAGENT_ERROR"
+ },
+ "subagentRunId": {
+ "$ref": "#/definitions/SubagentRunId",
+ "description": "The invocation that failed."
+ },
+ "message": {
+ "type": "string",
+ "description": "What went wrong, for a person to read."
+ },
+ "code": {
+ "type": "string",
+ "description": "A machine-readable error code. An open string."
+ }
+ },
+ "required": [
+ "type",
+ "subagentRunId",
+ "message"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunFinishedOutcome": {
+ "description": "Why a run ended.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/RunFinishedSuccessOutcome"
+ },
+ {
+ "$ref": "#/definitions/RunFinishedInterruptOutcome"
+ },
+ {
+ "$ref": "#/definitions/RunFinishedCancelledOutcome"
+ }
+ ]
+ },
+ "RunFinishedSuccessOutcome": {
+ "type": "object",
+ "description": "The run completed. Equivalent to an absent outcome. Closed like every other object, which is also what keeps it from carrying the suspended sibling's interrupts — a success with an interrupt still pending would be a contradiction, not an extension. A completed run may still have left frontend tool calls for the application to answer; pendingToolCallIds names them.",
+ "properties": {
+ "type": {
+ "const": "success",
+ "description": "Discriminator."
+ },
+ "pendingToolCallIds": {
+ "type": "array",
+ "description": "The tool calls this run started and left unanswered — no TOOL_CALL_RESULT in the run — for the application to answer in the next input's messages, in the order they were made. Absent or empty means the producer named none, and a consumer derives the list from the stream; otherwise it is the list, and it agrees with the stream. On the success outcome rather than the event because a run that stopped on a frontend tool call is a completed run: whether the application continues the thread is its own decision, so the producer reports what it knows and no more.",
+ "items": {
+ "type": "string",
+ "description": "A tool call id, as carried by TOOL_CALL_START."
+ }
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunFinishedInterruptOutcome": {
+ "type": "object",
+ "description": "The run is paused, waiting for something outside it. Resuming means starting a new run whose resume entries answer these interrupts.",
+ "properties": {
+ "type": {
+ "const": "interrupt",
+ "description": "Discriminator."
+ },
+ "interrupts": {
+ "type": "array",
+ "description": "What the run is waiting for. At least one: an interrupt outcome with nothing to answer would leave a consumer with nothing to do.",
+ "minItems": 1,
+ "items": {
+ "$ref": "#/definitions/Interrupt"
+ }
+ }
+ },
+ "required": [
+ "type",
+ "interrupts"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunFinishedCancelledOutcome": {
+ "type": "object",
+ "description": "The run was stopped before it completed, by whoever was running it, and did not fail. Neither success nor interrupt: nothing was produced as a result, and nothing is waited for, so the next run on the thread is an ordinary new run rather than a resume. Closed like its siblings: a cancelled run has no interrupts to carry. Named in the schema before 1.0 because an outcome a consumer does not recognise is stripped and read as success — a cancellation added later would reach every 1.0 consumer as a completed run.",
+ "properties": {
+ "type": {
+ "const": "cancelled",
+ "description": "Discriminator."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "SubagentFinishedOutcome": {
+ "description": "Why a subagent's segment of a run ended. Mirrors RunFinishedOutcome one level down.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/SubagentFinishedSuccessOutcome"
+ },
+ {
+ "$ref": "#/definitions/SubagentFinishedSuspendedOutcome"
+ }
+ ]
+ },
+ "SubagentFinishedSuccessOutcome": {
+ "type": "object",
+ "description": "The subagent completed its work. Equivalent to an absent outcome.",
+ "properties": {
+ "type": {
+ "const": "success",
+ "description": "Discriminator."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "SubagentFinishedSuspendedOutcome": {
+ "type": "object",
+ "description": "The subagent is paused awaiting outside input. Terminal for this stream, not for the subagent: a later run may continue the same invocation once the interrupts are answered.",
+ "properties": {
+ "type": {
+ "const": "suspended",
+ "description": "Discriminator."
+ },
+ "interruptIds": {
+ "type": "array",
+ "description": "The run-level interrupts this subagent raised itself. May be empty or absent: a subagent suspended because a descendant interrupted owns no interrupt of its own.",
+ "items": {
+ "type": "string",
+ "description": "An Interrupt.id."
+ }
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "unevaluatedProperties": false
+ },
+ "Interrupt": {
+ "type": "object",
+ "description": "Something a run needs from outside before it can continue, such as an approval or a missing value.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "Identifies the interrupt. A resume entry answers it by this id."
+ },
+ "reason": {
+ "type": "string",
+ "description": "Why the run stopped. An open string rather than an enumeration: the protocol does not attempt to classify every reason an agent might need input."
+ },
+ "message": {
+ "type": "string",
+ "description": "A human-readable prompt for whoever answers."
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "The tool call this interrupt concerns, when it is a tool approval."
+ },
+ "responseSchema": {
+ "type": "object",
+ "description": "A JSON Schema describing the answer this interrupt expects, so a consumer can build a form for it. Carried opaquely: the protocol does not constrain or validate it. Restricted to an object because TypeScript and Python both declare it that way; .NET holds it as any JSON, and the ticket that commissioned this schema lists it among the arbitrary-JSON fields. Following the two that constrain it keeps the schema from accepting documents the reference client rejects, at the cost of rejecting the boolean schemas JSON Schema also permits — a bare true for \"any answer\". Recorded as a known divergence rather than settled.",
+ "additionalProperties": true
+ },
+ "expiresAt": {
+ "type": "string",
+ "description": "When the interrupt stops being answerable. Deliberately unconstrained rather than a date-time format, because producers already disagree about the representation and tightening it here would reject streams that work today. The documented convention is ISO 8601, and a consumer comparing this value will parse it as a date, so a value that is not one leaves the interrupt looking permanently unexpired."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this interrupt."
+ }
+ },
+ "required": [
+ "id",
+ "reason"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ResumeEntry": {
+ "type": "object",
+ "description": "An answer to one interrupt, sent on the run that continues from it.",
+ "properties": {
+ "interruptId": {
+ "type": "string",
+ "description": "The interrupt being answered."
+ },
+ "status": {
+ "type": "string",
+ "description": "Whether the interrupt was answered or abandoned.",
+ "enum": [
+ "resolved",
+ "cancelled"
+ ]
+ },
+ "payload": {
+ "not": {
+ "type": "null"
+ },
+ "description": "The answer the agent asked for and will act on. Any JSON value."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Envelope information about the response, such as signatures or routing keys, as opposed to payload, which is the answer itself."
+ }
+ },
+ "required": [
+ "interruptId",
+ "status"
+ ],
+ "unevaluatedProperties": false
+ },
+ "TokenUsage": {
+ "type": "object",
+ "description": "Token counts for one provider and model, in the protocol's own accounting: every count is either a total or a named part of one, so entries from different providers add up without double-counting. inputTokens and outputTokens are the totals; reasoningTokens, cachedInputTokens and cacheWriteInputTokens are parts of them, never additions to them; totalTokens is the two totals summed. Every field is a label or a number — nothing content-bearing or identifying, no prompts, completions, messages, or thread, run and user identifiers.",
+ "properties": {
+ "provider": {
+ "type": "string",
+ "description": "Which provider served the request."
+ },
+ "model": {
+ "type": "string",
+ "description": "Which model served the request."
+ },
+ "inputTokens": {
+ "type": "integer",
+ "minimum": 0,
+ "maximum": 9007199254740991,
+ "description": "Every prompt token the call was charged for: tokens read from a provider cache, tokens written to one, and audio or other non-text input all count here. cachedInputTokens and cacheWriteInputTokens break this number down and are never added to it — a provider that reports its cache counts beside a smaller input count has them added in by the producer before the entry leaves. Bounded like timestamp and for the same reason: a count above the JSON safe-integer range does not survive a round trip, so a consumer would silently read a different number than the producer wrote."
+ },
+ "outputTokens": {
+ "type": "integer",
+ "minimum": 0,
+ "maximum": 9007199254740991,
+ "description": "Every generated token, reasoning included where the provider distinguishes it. reasoningTokens breaks this number down and is never added to it — a provider that reports reasoning tokens beside a smaller completion count has them added in by the producer."
+ },
+ "totalTokens": {
+ "type": "integer",
+ "minimum": 0,
+ "maximum": 9007199254740991,
+ "description": "inputTokens plus outputTokens, under the accounting above. A producer MAY compute it rather than copy a provider's total, and copies a provider's total only when that total counts the same way, so a consumer can read this field as the sum of the other two."
+ },
+ "reasoningTokens": {
+ "type": "integer",
+ "minimum": 0,
+ "maximum": 9007199254740991,
+ "description": "Output tokens spent on reasoning, where the provider distinguishes them. Part of outputTokens, not in addition to it."
+ },
+ "cachedInputTokens": {
+ "type": "integer",
+ "minimum": 0,
+ "maximum": 9007199254740991,
+ "description": "Input tokens read from a provider cache. Part of inputTokens, not in addition to it, and disjoint from cacheWriteInputTokens."
+ },
+ "cacheWriteInputTokens": {
+ "type": "integer",
+ "minimum": 0,
+ "maximum": 9007199254740991,
+ "description": "Input tokens written to a provider cache on this call, where the provider distinguishes them. Part of inputTokens, not in addition to it, and disjoint from cachedInputTokens. Its own field because providers price a cache write differently from a cache read, so a consumer computing cost cannot do without it."
+ }
+ },
+ "unevaluatedProperties": false
+ },
+ "Message": {
+ "description": "Any message in a conversation. Discriminated by role.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/DeveloperMessage"
+ },
+ {
+ "$ref": "#/definitions/SystemMessage"
+ },
+ {
+ "$ref": "#/definitions/AssistantMessage"
+ },
+ {
+ "$ref": "#/definitions/UserMessage"
+ },
+ {
+ "$ref": "#/definitions/ToolMessage"
+ },
+ {
+ "$ref": "#/definitions/ActivityMessage"
+ },
+ {
+ "$ref": "#/definitions/ReasoningMessage"
+ }
+ ]
+ },
+ "BaseMessage": {
+ "type": "object",
+ "description": "The fields shared by the developer, system, assistant and user messages. Deliberately excludes content, because a user message's content may be an array while the others are strings, and composition here intersects rather than overrides: a base that constrained content to a string would make an array content invalid. The tool, activity and reasoning messages do not compose this, because they carry no name.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "Identifies the message within the conversation."
+ },
+ "role": {
+ "type": "string",
+ "description": "Who the message is from. Each message definition narrows this to a single value."
+ },
+ "name": {
+ "type": "string",
+ "description": "An optional display name for the author."
+ },
+ "encryptedValue": {
+ "type": "string",
+ "description": "A provider's opaque artefact belonging to this message, stored by a consumer and returned on a later turn."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this message."
+ }
+ },
+ "required": [
+ "id",
+ "role"
+ ]
+ },
+ "DeveloperMessage": {
+ "type": "object",
+ "description": "Instructions from the application developer.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseMessage"
+ }
+ ],
+ "properties": {
+ "role": {
+ "const": "developer"
+ },
+ "content": {
+ "type": "string",
+ "description": "The instructions. Required: a developer message with nothing in it says nothing."
+ }
+ },
+ "required": [
+ "id",
+ "role",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "SystemMessage": {
+ "type": "object",
+ "description": "Instructions from the system.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseMessage"
+ }
+ ],
+ "properties": {
+ "role": {
+ "const": "system"
+ },
+ "content": {
+ "type": "string",
+ "description": "The instructions. Required."
+ }
+ },
+ "required": [
+ "id",
+ "role",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "AssistantMessage": {
+ "type": "object",
+ "description": "A message from the agent. Content is optional because a turn may consist only of tool calls.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseMessage"
+ }
+ ],
+ "properties": {
+ "role": {
+ "const": "assistant"
+ },
+ "content": {
+ "type": "string",
+ "description": "What the agent said, if it said anything."
+ },
+ "toolCalls": {
+ "type": "array",
+ "description": "The tool calls this turn made.",
+ "items": {
+ "$ref": "#/definitions/ToolCall"
+ }
+ }
+ },
+ "required": [
+ "id",
+ "role"
+ ],
+ "unevaluatedProperties": false
+ },
+ "UserMessage": {
+ "type": "object",
+ "description": "A message from the person using the application.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/BaseMessage"
+ }
+ ],
+ "properties": {
+ "role": {
+ "const": "user"
+ },
+ "content": {
+ "description": "What the person sent: either plain text, or an ordered list of parts for a multimodal message.",
+ "oneOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/ContentPart"
+ }
+ }
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "role",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolMessage": {
+ "type": "object",
+ "description": "What a tool returned, as a message in the conversation. Stands alone rather than composing BaseMessage, because it carries no name.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "Identifies the message."
+ },
+ "role": {
+ "const": "tool",
+ "description": "Fixed. Declared here rather than inherited, because this message does not compose BaseMessage."
+ },
+ "content": {
+ "description": "What the tool returned: either plain text, or an ordered list of parts. A tool returning structured data serialises it into text; media travel as parts of their own.",
+ "oneOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/ContentPart"
+ }
+ }
+ ]
+ },
+ "toolCallId": {
+ "type": "string",
+ "description": "The call this answers."
+ },
+ "error": {
+ "type": "string",
+ "description": "Why the tool failed, when it did. Present alongside content rather than instead of it, so a partial result survives a failure."
+ },
+ "encryptedValue": {
+ "type": "string",
+ "description": "A provider's opaque artefact belonging to this message."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this message."
+ }
+ },
+ "required": [
+ "id",
+ "role",
+ "content",
+ "toolCallId"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ActivityMessage": {
+ "type": "object",
+ "description": "Structured progress that is not conversation content, materialised as a message so it keeps its place in the sequence. Stands alone rather than composing BaseMessage, because its content is an object rather than a string.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "Identifies the message."
+ },
+ "role": {
+ "const": "activity",
+ "description": "Fixed. Declared here rather than inherited, because this message does not compose BaseMessage."
+ },
+ "activityType": {
+ "type": "string",
+ "description": "What kind of activity this is. An open string: the set is the producer's."
+ },
+ "content": {
+ "type": "object",
+ "description": "The activity's payload, open by key.",
+ "additionalProperties": true
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this message."
+ }
+ },
+ "required": [
+ "id",
+ "role",
+ "activityType",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ReasoningMessage": {
+ "type": "object",
+ "description": "A span of the agent's reasoning, materialised as a message. Stands alone rather than composing BaseMessage, because it carries no name.",
+ "allOf": [
+ {
+ "$ref": "#/definitions/Attributable"
+ }
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "Identifies the message."
+ },
+ "role": {
+ "const": "reasoning",
+ "description": "Fixed. Declared here rather than inherited, because this message does not compose BaseMessage."
+ },
+ "content": {
+ "type": "string",
+ "description": "The reasoning text."
+ },
+ "encryptedValue": {
+ "type": "string",
+ "description": "A provider's opaque reasoning artefact belonging to this message."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this message."
+ }
+ },
+ "required": [
+ "id",
+ "role",
+ "content"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ToolCall": {
+ "type": "object",
+ "description": "A call an assistant message made. Carries no subagent attribution of its own and inherits its containing message's, since several calls can share one parent.",
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "Identifies the call. The answering tool message carries this as its toolCallId."
+ },
+ "type": {
+ "const": "function",
+ "description": "The only kind of call the protocol models."
+ },
+ "function": {
+ "$ref": "#/definitions/FunctionCall",
+ "description": "What is being called, and with what."
+ },
+ "encryptedValue": {
+ "type": "string",
+ "description": "A provider's opaque artefact belonging to this call."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information attached to this call. Carried here rather than folded into the containing message, because several calls can share one parent and merging them would make the result depend on their order."
+ }
+ },
+ "required": [
+ "id",
+ "type",
+ "function"
+ ],
+ "unevaluatedProperties": false
+ },
+ "FunctionCall": {
+ "type": "object",
+ "description": "The name and arguments of a tool call.",
+ "properties": {
+ "name": {
+ "type": "string",
+ "description": "Which tool is being called."
+ },
+ "arguments": {
+ "type": "string",
+ "description": "The arguments as a JSON string, not as parsed JSON. Kept as written because a model can emit arguments that are not valid JSON, and losing them at the protocol boundary would hide the fault from the consumer that has to handle it."
+ }
+ },
+ "required": [
+ "name",
+ "arguments"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ContentPart": {
+ "description": "One part of a message body: what a person sends in a user message, or what a tool returns in a tool message. Discriminated by type. Named by what the part is rather than by direction, because the same part travels into the model inside a user message and back out of the stream inside a tool result.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/TextPart"
+ },
+ {
+ "$ref": "#/definitions/ImagePart"
+ },
+ {
+ "$ref": "#/definitions/AudioPart"
+ },
+ {
+ "$ref": "#/definitions/VideoPart"
+ },
+ {
+ "$ref": "#/definitions/DocumentPart"
+ }
+ ]
+ },
+ "TextPart": {
+ "type": "object",
+ "description": "A text part.",
+ "properties": {
+ "type": {
+ "const": "text",
+ "description": "Discriminator."
+ },
+ "id": {
+ "type": "string",
+ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved so that a streamed part can be matched to its entry in history once assistant messages carry parts too."
+ },
+ "text": {
+ "type": "string",
+ "description": "The text."
+ },
+ "metadata": {
+ "not": {
+ "type": "null"
+ },
+ "description": "Extra information about this part. Unconstrained, as on the media parts. This is where a text search hit carries its source and title, rather than the protocol modelling a search-result part of its own."
+ }
+ },
+ "required": [
+ "type",
+ "text"
+ ],
+ "unevaluatedProperties": false
+ },
+ "ImagePart": {
+ "type": "object",
+ "description": "An image part.",
+ "properties": {
+ "type": {
+ "const": "image",
+ "description": "Discriminator."
+ },
+ "id": {
+ "type": "string",
+ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."
+ },
+ "source": {
+ "$ref": "#/definitions/PartSource",
+ "description": "Where the image comes from."
+ },
+ "metadata": {
+ "not": {
+ "type": "null"
+ },
+ "description": "Extra information about this part. Unconstrained rather than an object: inherited from the SDKs, which declare it unknown rather than a record; listed under known divergences in the README rather than resolved here."
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "unevaluatedProperties": false
+ },
+ "AudioPart": {
+ "type": "object",
+ "description": "An audio part.",
+ "properties": {
+ "type": {
+ "const": "audio",
+ "description": "Discriminator."
+ },
+ "id": {
+ "type": "string",
+ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."
+ },
+ "source": {
+ "$ref": "#/definitions/PartSource",
+ "description": "Where the audio comes from."
+ },
+ "metadata": {
+ "not": {
+ "type": "null"
+ },
+ "description": "Extra information about this part. Unconstrained, as on the other media parts."
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "unevaluatedProperties": false
+ },
+ "VideoPart": {
+ "type": "object",
+ "description": "A video part.",
+ "properties": {
+ "type": {
+ "const": "video",
+ "description": "Discriminator."
+ },
+ "id": {
+ "type": "string",
+ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."
+ },
+ "source": {
+ "$ref": "#/definitions/PartSource",
+ "description": "Where the video comes from."
+ },
+ "metadata": {
+ "not": {
+ "type": "null"
+ },
+ "description": "Extra information about this part. Unconstrained, as on the other media parts."
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "unevaluatedProperties": false
+ },
+ "DocumentPart": {
+ "type": "object",
+ "description": "A document part.",
+ "properties": {
+ "type": {
+ "const": "document",
+ "description": "Discriminator."
+ },
+ "id": {
+ "type": "string",
+ "description": "Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part."
+ },
+ "source": {
+ "$ref": "#/definitions/PartSource",
+ "description": "Where the document comes from."
+ },
+ "metadata": {
+ "not": {
+ "type": "null"
+ },
+ "description": "Extra information about this part. Unconstrained, as on the other media parts."
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "unevaluatedProperties": false
+ },
+ "PartSource": {
+ "description": "Where a media part's bytes come from: carried inline, referenced by URL, or already at the provider under a handle it issued.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/DataSource"
+ },
+ {
+ "$ref": "#/definitions/UrlSource"
+ },
+ {
+ "$ref": "#/definitions/FileSource"
+ }
+ ]
+ },
+ "DataSource": {
+ "type": "object",
+ "description": "Bytes carried inline.",
+ "properties": {
+ "type": {
+ "const": "data",
+ "description": "Discriminator."
+ },
+ "value": {
+ "type": "string",
+ "contentEncoding": "base64",
+ "description": "The bytes, base64-encoded. contentEncoding is an annotation rather than a constraint in 2020-12, so a malformed string still validates here; rejecting one is the decoder's job."
+ },
+ "mimeType": {
+ "type": "string",
+ "description": "What the bytes are. Required here, unlike on a URL source, because nothing else can tell a consumer how to read them."
+ }
+ },
+ "required": [
+ "type",
+ "value",
+ "mimeType"
+ ],
+ "unevaluatedProperties": false
+ },
+ "UrlSource": {
+ "type": "object",
+ "description": "Bytes referenced by URL, fetched by whoever needs them.",
+ "properties": {
+ "type": {
+ "const": "url",
+ "description": "Discriminator."
+ },
+ "value": {
+ "type": "string",
+ "description": "The URL. Deliberately not constrained to a URI format, so a scheme a producer already uses is not rejected here."
+ },
+ "mimeType": {
+ "type": "string",
+ "description": "What the resource is, when the producer knows. Optional, because the response can say."
+ }
+ },
+ "required": [
+ "type",
+ "value"
+ ],
+ "unevaluatedProperties": false
+ },
+ "FileSource": {
+ "type": "object",
+ "description": "Bytes already at the provider, named by a handle the provider issued: an OpenAI or Anthropic file id, a Gemini file URI, a storage URL only that provider can read. No bytes travel and nothing is fetched. Only the provider that minted the handle can resolve it; a peer that cannot drops the part as it drops any part it cannot use.",
+ "properties": {
+ "type": {
+ "const": "file",
+ "description": "Discriminator."
+ },
+ "value": {
+ "type": "string",
+ "description": "The handle, exactly as the provider issued it. Opaque: a consumer MUST NOT fetch it, parse it or read a scheme out of it."
+ },
+ "provider": {
+ "type": "string",
+ "description": "Who issued the handle, when the producer knows. Optional: an agent already knows which provider it talks to. When present, SHOULD be the lowercase vendor id (openai, anthropic, google) that TokenUsage.provider uses, so a peer can tell before sending whether a handle is one it can use."
+ },
+ "mimeType": {
+ "type": "string",
+ "description": "What the file is, when the producer knows. Optional, because the provider that holds the bytes knows."
+ }
+ },
+ "required": [
+ "type",
+ "value"
+ ],
+ "unevaluatedProperties": false
+ },
+ "Context": {
+ "type": "object",
+ "description": "A named piece of ambient information given to the agent for the run, distinct from the conversation.",
+ "properties": {
+ "description": {
+ "type": "string",
+ "description": "What this context is, for the agent to interpret."
+ },
+ "value": {
+ "type": "string",
+ "description": "The context itself."
+ }
+ },
+ "required": [
+ "description",
+ "value"
+ ],
+ "unevaluatedProperties": false
+ },
+ "Tool": {
+ "type": "object",
+ "description": "A tool the agent may call.",
+ "properties": {
+ "name": {
+ "type": "string",
+ "description": "The tool's name, as the agent will call it."
+ },
+ "description": {
+ "type": "string",
+ "description": "What the tool does, for the agent to decide when to use it."
+ },
+ "parameters": {
+ "not": {
+ "type": "null"
+ },
+ "description": "A JSON Schema describing the tool's arguments. Carried opaquely: the protocol does not constrain or validate it. Optional, because all three SDKs already treat it that way and a tool that takes no arguments has nothing to declare; an absent schema and an empty one mean the same thing to an agent."
+ },
+ "metadata": {
+ "$ref": "#/definitions/Metadata",
+ "description": "Extra information about the tool, for consumers that attach their own rendering or routing information to it."
+ }
+ },
+ "required": [
+ "name",
+ "description"
+ ],
+ "unevaluatedProperties": false
+ },
+ "RunAgentInput": {
+ "type": "object",
+ "description": "A request to run an agent. Also echoed back as RUN_STARTED.input. Only threadId, runId and messages are required: those are the three the SDKs already agree on, and for tools and context an absent key and an empty array mean the same thing, so requiring them would catch nothing a producer could get wrong.",
+ "properties": {
+ "threadId": {
+ "type": "string",
+ "description": "The conversation this run belongs to."
+ },
+ "runId": {
+ "type": "string",
+ "description": "Identifies this run."
+ },
+ "protocolVersion": {
+ "type": "string",
+ "description": "The protocol version this consumer speaks, such as \"1.0\". Absent means the input was produced before the protocol carried a version — the versioning rules in the prose govern what each side does with that. Sent in-band rather than by the transport, so a recorded exchange stays self-describing."
+ },
+ "parentRunId": {
+ "type": "string",
+ "description": "The run that spawned this one."
+ },
+ "state": {
+ "not": {
+ "type": "null"
+ },
+ "$ref": "#/definitions/State",
+ "description": "The state the run starts from."
+ },
+ "messages": {
+ "type": "array",
+ "description": "The conversation so far, in order.",
+ "items": {
+ "$ref": "#/definitions/Message"
+ }
+ },
+ "tools": {
+ "type": "array",
+ "description": "The tools the agent may call. Absent means none.",
+ "items": {
+ "$ref": "#/definitions/Tool"
+ }
+ },
+ "context": {
+ "type": "array",
+ "description": "Ambient information for the run. Absent means none.",
+ "items": {
+ "$ref": "#/definitions/Context"
+ }
+ },
+ "forwardedProps": {
+ "not": {
+ "type": "null"
+ },
+ "description": "Application-specific values passed through to the agent untouched. Any JSON value."
+ },
+ "resume": {
+ "type": "array",
+ "description": "Answers to the interrupts that ended a previous run, when this run continues from one.",
+ "items": {
+ "$ref": "#/definitions/ResumeEntry"
+ }
+ }
+ },
+ "required": [
+ "threadId",
+ "runId",
+ "messages"
+ ],
+ "unevaluatedProperties": false
+ },
+ "JsonPatch": {
+ "type": "array",
+ "description": "A JSON Patch document as defined by RFC 6902, referenced by STATE_DELTA.delta and ACTIVITY_DELTA.patch: an ordered sequence of operations applied to a target document. An empty array is a valid no-op patch. Whether the operations actually apply to the document they target is a runtime question RFC 6902 leaves to the applier; structural validity here says nothing about it.",
+ "items": {
+ "$ref": "#/definitions/JsonPatchOperation"
+ }
+ },
+ "JsonPatchOperation": {
+ "description": "A single RFC 6902 operation. Exactly one of the operation shapes must match, discriminated by op. Unlike the protocol's own objects, the operations are open: RFC 6902 section 4 requires members an operation does not define to be ignored rather than rejected, so a remove carrying a leftover value is a valid patch. Two of the RFC's rules are relations between values rather than shapes, so no static schema can express them and neither is checked here: a move whose from is a proper prefix of its path (section 4.4), and any operation whose pointer does not resolve in the target document. Both are the applier's to reject.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/AddOperation"
+ },
+ {
+ "$ref": "#/definitions/RemoveOperation"
+ },
+ {
+ "$ref": "#/definitions/ReplaceOperation"
+ },
+ {
+ "$ref": "#/definitions/MoveOperation"
+ },
+ {
+ "$ref": "#/definitions/CopyOperation"
+ },
+ {
+ "$ref": "#/definitions/TestOperation"
+ }
+ ]
+ },
+ "AddOperation": {
+ "type": "object",
+ "description": "Inserts value at path. RFC 6902 section 4.1.",
+ "properties": {
+ "op": {
+ "const": "add",
+ "description": "Discriminator for the add operation."
+ },
+ "path": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "Where to insert the value."
+ },
+ "value": {
+ "description": "The value to insert. Any JSON value, including null, which is a legitimate thing to add."
+ }
+ },
+ "required": [
+ "op",
+ "path",
+ "value"
+ ]
+ },
+ "RemoveOperation": {
+ "type": "object",
+ "description": "Removes the value at path. RFC 6902 section 4.2.",
+ "properties": {
+ "op": {
+ "const": "remove",
+ "description": "Discriminator for the remove operation."
+ },
+ "path": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "What to remove."
+ }
+ },
+ "required": [
+ "op",
+ "path"
+ ]
+ },
+ "ReplaceOperation": {
+ "type": "object",
+ "description": "Replaces the value at path. RFC 6902 section 4.3.",
+ "properties": {
+ "op": {
+ "const": "replace",
+ "description": "Discriminator for the replace operation."
+ },
+ "path": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "What to replace."
+ },
+ "value": {
+ "description": "The replacement. Any JSON value, including null."
+ }
+ },
+ "required": [
+ "op",
+ "path",
+ "value"
+ ]
+ },
+ "MoveOperation": {
+ "type": "object",
+ "description": "Moves the value at from to path. RFC 6902 section 4.4.",
+ "properties": {
+ "op": {
+ "const": "move",
+ "description": "Discriminator for the move operation."
+ },
+ "from": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "Where the value is moved from."
+ },
+ "path": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "Where the value is moved to."
+ }
+ },
+ "required": [
+ "op",
+ "from",
+ "path"
+ ]
+ },
+ "CopyOperation": {
+ "type": "object",
+ "description": "Copies the value at from to path. RFC 6902 section 4.5.",
+ "properties": {
+ "op": {
+ "const": "copy",
+ "description": "Discriminator for the copy operation."
+ },
+ "from": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "Where the value is copied from."
+ },
+ "path": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "Where the value is copied to."
+ }
+ },
+ "required": [
+ "op",
+ "from",
+ "path"
+ ]
+ },
+ "TestOperation": {
+ "type": "object",
+ "description": "Asserts that the value at path equals value. RFC 6902 section 4.6.",
+ "properties": {
+ "op": {
+ "const": "test",
+ "description": "Discriminator for the test operation."
+ },
+ "path": {
+ "$ref": "#/definitions/JsonPointer",
+ "description": "What to compare."
+ },
+ "value": {
+ "description": "The value the target must equal. Any JSON value, including null."
+ }
+ },
+ "required": [
+ "op",
+ "path",
+ "value"
+ ]
+ },
+ "JsonPointer": {
+ "type": "string",
+ "description": "A JSON Pointer as defined by RFC 6901. Either the empty string, meaning the whole document, or a sequence of slash-prefixed reference tokens in which a tilde is escaped as ~0 and a slash as ~1. A value with no leading slash, or a tilde followed by anything other than 0 or 1, is not a JSON Pointer.",
+ "pattern": "^(/([^/~]|~[01])*)*$"
+ },
+ "OvSource": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "url",
+ "title",
+ "site"
+ ],
+ "properties": {
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://",
+ "maxLength": 2048
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 300
+ },
+ "site": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ }
+ }
+ },
+ "Event": {
+ "description": "Any AG-UI event. Every member is normative: there is no optional tier and no event a consumer may decline to implement. Discriminated by the type property.",
+ "oneOf": [
+ {
+ "$ref": "#/definitions/TextMessageStartEvent"
+ },
+ {
+ "$ref": "#/definitions/TextMessageContentEvent"
+ },
+ {
+ "$ref": "#/definitions/TextMessageEndEvent"
+ },
+ {
+ "$ref": "#/definitions/TextMessageChunkEvent"
+ },
+ {
+ "$ref": "#/definitions/ToolCallStartEvent"
+ },
+ {
+ "$ref": "#/definitions/ToolCallArgsEvent"
+ },
+ {
+ "$ref": "#/definitions/ToolCallEndEvent"
+ },
+ {
+ "$ref": "#/definitions/ToolCallChunkEvent"
+ },
+ {
+ "$ref": "#/definitions/ToolCallResultEvent"
+ },
+ {
+ "$ref": "#/definitions/StateSnapshotEvent"
+ },
+ {
+ "$ref": "#/definitions/StateDeltaEvent"
+ },
+ {
+ "$ref": "#/definitions/MessagesSnapshotEvent"
+ },
+ {
+ "$ref": "#/definitions/ActivitySnapshotEvent"
+ },
+ {
+ "$ref": "#/definitions/ActivityDeltaEvent"
+ },
+ {
+ "$ref": "#/definitions/RawEvent"
+ },
+ {
+ "$ref": "#/definitions/CustomEvent"
+ },
+ {
+ "$ref": "#/definitions/RunStartedEvent"
+ },
+ {
+ "$ref": "#/definitions/RunFinishedEvent"
+ },
+ {
+ "$ref": "#/definitions/RunErrorEvent"
+ },
+ {
+ "$ref": "#/definitions/StepStartedEvent"
+ },
+ {
+ "$ref": "#/definitions/StepFinishedEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningStartEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningMessageStartEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningMessageContentEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningMessageEndEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningMessageChunkEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningEndEvent"
+ },
+ {
+ "$ref": "#/definitions/ReasoningEncryptedValueEvent"
+ },
+ {
+ "$ref": "#/definitions/SubagentStartedEvent"
+ },
+ {
+ "$ref": "#/definitions/SubagentFinishedEvent"
+ },
+ {
+ "$ref": "#/definitions/SubagentErrorEvent"
+ }
+ ]
+ }
+ }
+ }
+ },
+ "agent.run": {
+ "version": "1.0.0",
+ "owner": "actor",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "type": "object",
+ "additionalProperties": false,
+ "$id": "https://openvibe.network/contracts/agent/run.v1.json",
+ "title": "AgentRun",
+ "description": "agent.run@1 snapshot of a run and its current plan, steps, sources, result, timestamps and cost.",
+ "required": [
+ "id",
+ "product",
+ "title",
+ "status",
+ "plan",
+ "steps",
+ "sources",
+ "result",
+ "started_at",
+ "ended_at",
+ "cost_usd"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 160
+ },
+ "product": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 40
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 240
+ },
+ "status": {
+ "enum": [
+ "queued",
+ "running",
+ "waiting",
+ "needs_you",
+ "succeeded",
+ "failed",
+ "stopped",
+ "cancelled"
+ ]
+ },
+ "plan": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "title",
+ "status"
+ ],
+ "properties": {
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 240
+ },
+ "status": {
+ "enum": [
+ "todo",
+ "running",
+ "waiting",
+ "needs_you",
+ "done",
+ "failed",
+ "stopped"
+ ]
+ }
+ }
+ }
+ },
+ "steps": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/step"
+ }
+ },
+ "sources": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/source"
+ }
+ },
+ "result": {
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "started_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "ended_at": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "format": "date-time"
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ }
+ },
+ "$defs": {
+ "step": {
+ "type": "object",
+ "additionalProperties": true,
+ "required": [
+ "title",
+ "status"
+ ],
+ "properties": {
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 240
+ },
+ "status": {
+ "enum": [
+ "todo",
+ "running",
+ "waiting",
+ "needs_you",
+ "done",
+ "failed",
+ "stopped"
+ ]
+ }
+ }
+ },
+ "source": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "url",
+ "title",
+ "site"
+ ],
+ "properties": {
+ "url": {
+ "type": "string",
+ "format": "uri",
+ "pattern": "^https://",
+ "maxLength": 2048
+ },
+ "title": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 300
+ },
+ "site": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 120
+ }
+ }
+ }
+ }
+ }
+ },
+ "actor.agent-sheet": {
+ "version": "1.0.0",
+ "owner": "actor",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/actor/agent-sheet.v1.json",
+ "title": "ActorAgentSheet",
+ "description": "actor.agent-sheet@1: one owner-scoped read of an Actor agent's current work, history, approvals, computer, schedules and memory. GET /api/v1/me/agents/:id?view=sheet; never cache this answer.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "agent",
+ "now",
+ "work",
+ "asks",
+ "asks_empty",
+ "computer",
+ "schedules",
+ "memory",
+ "activity"
+ ],
+ "properties": {
+ "agent": {
+ "type": "object",
+ "additionalProperties": true,
+ "required": [
+ "id",
+ "name",
+ "face",
+ "state",
+ "instructions",
+ "voice"
+ ],
+ "properties": {
+ "id": {
+ "type": "string",
+ "pattern": "^agt_[0-9A-HJKMNP-TV-Z]{26}$"
+ },
+ "name": {
+ "type": "string"
+ },
+ "face": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "state": {
+ "enum": [
+ "working",
+ "idle",
+ "paused"
+ ]
+ },
+ "instructions": {
+ "type": "string"
+ },
+ "voice": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ }
+ },
+ "now": {
+ "oneOf": [
+ {
+ "type": "null"
+ },
+ {
+ "$ref": "#/$defs/work"
+ }
+ ]
+ },
+ "work": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/work"
+ }
+ },
+ "asks": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "id",
+ "state",
+ "what"
+ ],
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "state": {
+ "type": "string"
+ },
+ "what": {
+ "type": "string"
+ },
+ "why": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "touch": {
+ "type": [
+ "string",
+ "object",
+ "null"
+ ]
+ }
+ },
+ "additionalProperties": true
+ }
+ },
+ "asks_empty": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "computer": {
+ "oneOf": [
+ {
+ "type": "null"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "open": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "additionalProperties": true
+ }
+ ]
+ },
+ "schedules": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "next_run_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "last_run_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "last_result": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "additionalProperties": true
+ }
+ },
+ "memory": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "id",
+ "text"
+ ],
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "source": {
+ "type": "string"
+ }
+ },
+ "additionalProperties": true
+ }
+ },
+ "activity": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "additionalProperties": true
+ }
+ }
+ },
+ "$defs": {
+ "work": {
+ "type": "object",
+ "required": [
+ "id",
+ "task",
+ "state",
+ "cost_usd"
+ ],
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "task": {
+ "type": "string"
+ },
+ "state": {
+ "type": "string"
+ },
+ "cost_usd": {
+ "type": "number",
+ "minimum": 0
+ },
+ "result": {},
+ "computer": {}
+ },
+ "additionalProperties": true
+ }
+ }
+ }
+ },
+ "codes.agent-sheet": {
+ "version": "1.0.0",
+ "owner": "codes",
+ "status": "active",
+ "schema": {
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://openvibe.network/contracts/codes/agent-sheet.v1.json",
+ "title": "CodesAgentSheet",
+ "description": "codes.agent-sheet@1: one owner's coding harness, its real attempts, outcomes and machine availability. Empty memory, schedule and computer sections mean Codes has no such per-harness records. GET /api/v1/me/agents/:id/sheet; never cache this answer.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "agent",
+ "now",
+ "work",
+ "activity",
+ "asks",
+ "asks_empty",
+ "computer",
+ "schedules",
+ "memory",
+ "identity"
+ ],
+ "properties": {
+ "agent": {
+ "type": "object",
+ "required": [
+ "id",
+ "name",
+ "face",
+ "state",
+ "kind",
+ "availability"
+ ],
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "face": {
+ "type": "null"
+ },
+ "state": {
+ "type": "string"
+ },
+ "kind": {
+ "const": "coding harness"
+ },
+ "availability": {
+ "type": [
+ "object",
+ "null"
+ ]
+ }
+ },
+ "additionalProperties": false
+ },
+ "now": {
+ "oneOf": [
+ {
+ "type": "null"
+ },
+ {
+ "$ref": "#/$defs/work"
+ }
+ ]
+ },
+ "work": {
+ "type": "array",
+ "items": {
+ "$ref": "#/$defs/work"
+ }
+ },
+ "activity": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "required": [
+ "day",
+ "entries"
+ ],
+ "properties": {
+ "day": {
+ "type": "string",
+ "format": "date"
+ },
+ "entries": {
+ "type": "array",
+ "items": {
+ "type": "object"
+ }
+ }
+ },
+ "additionalProperties": false
+ }
+ },
+ "asks": {
+ "type": "array",
+ "maxItems": 0
+ },
+ "asks_empty": {
+ "type": "string"
+ },
+ "computer": {
+ "type": "null"
+ },
+ "schedules": {
+ "type": "array",
+ "maxItems": 0
+ },
+ "memory": {
+ "type": "array",
+ "maxItems": 0
+ },
+ "identity": {
+ "type": "object",
+ "required": [
+ "provider",
+ "capabilities"
+ ],
+ "properties": {
+ "provider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "capabilities": {
+ "type": "object"
+ }
+ },
+ "additionalProperties": false
+ }
+ },
+ "$defs": {
+ "work": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "id",
+ "task_id",
+ "title",
+ "what",
+ "result",
+ "state",
+ "outcome",
+ "cost_usd",
+ "machine",
+ "repo",
+ "started_at",
+ "finished_at",
+ "url"
+ ],
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "task_id": {
+ "type": "string"
+ },
+ "title": {
+ "type": "string"
+ },
+ "what": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "result": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "state": {
+ "type": "string"
+ },
+ "outcome": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "cost_usd": {
+ "type": [
+ "number",
+ "null"
+ ],
+ "minimum": 0
+ },
+ "machine": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "repo": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "started_at": {
+ "type": "string"
+ },
+ "finished_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "url": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
}
}
}
}
}
}
@@ -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.404.0",
- "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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"
@@ -72,6 +72,148 @@
@@ -72,6 +72,148 @@
}
}
}
}
},
},
+ "/api/chat/commands/registered": {
+ "post": {
+ "operationId": "post_api_chat_commands_registered",
+ "summary": "Register a slash command in a Chat server where the person authorizing the app is an owner or admin.",
+ "description": "**chat.commands.register** (public): Register a slash command in a Chat server where the person authorizing the app is an owner or admin. The Network service token names the approved app or agent in sub, names the person in on_behalf_of, and carries this granted capability. Chat stores the command under that app, refuses built-in names, and executes its plain response template by posting as the person who invoked it with that person's current room rights. This grant never lets an app post as someone else or perform moderation.",
+ "tags": [
+ "chat.commands"
+ ],
+ "x-openvibe-capabilities": [
+ "chat.commands.register"
+ ],
+ "x-openvibe-visibility": [
+ "public"
+ ],
+ "x-openvibe-quota-class": "chat-write",
+ "security": [
+ {
+ "openvibeToken": [
+ "chat.commands.register"
+ ]
+ }
+ ],
+ "requestBody": {
+ "required": false,
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/chat.command-registration-request.v1"
+ }
+ }
+ }
+ },
+ "responses": {
+ "2XX": {
+ "description": "Success",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/chat.command-registration-result.v1"
+ }
+ }
+ }
+ },
+ "default": {
+ "description": "An error (RFC 9457 problem details)",
+ "content": {
+ "application/problem+json": {
+ "schema": {
+ "$ref": "#/components/schemas/errors.problem.v1"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/api/chat/commands/registered/{name}": {
+ "delete": {
+ "operationId": "delete_api_chat_commands_registered_name",
+ "summary": "Register a slash command in a Chat server where the person authorizing the app is an owner or admin.",
+ "description": "**chat.commands.register** (public): Register a slash command in a Chat server where the person authorizing the app is an owner or admin. The Network service token names the approved app or agent in sub, names the person in on_behalf_of, and carries this granted capability. Chat stores the command under that app, refuses built-in names, and executes its plain response template by posting as the person who invoked it with that person's current room rights. This grant never lets an app post as someone else or perform moderation.",
+ "tags": [
+ "chat.commands"
+ ],
+ "x-openvibe-capabilities": [
+ "chat.commands.register"
+ ],
+ "x-openvibe-visibility": [
+ "public"
+ ],
+ "x-openvibe-quota-class": "chat-write",
+ "security": [
+ {
+ "openvibeToken": [
+ "chat.commands.register"
+ ]
+ }
+ ],
+ "x-openvibe-input": {
+ "$ref": "#/components/schemas/chat.command-registration-request.v1"
+ },
+ "parameters": [
+ {
+ "name": "name",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "server",
+ "in": "query",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "pattern": "^[a-z0-9][a-z0-9-]{1,31}$"
+ }
+ },
+ {
+ "name": "command",
+ "in": "query",
+ "required": true,
+ "schema": {
+ "$ref": "#/components/schemas/chat.command.v1"
+ }
+ },
+ {
+ "name": "response_template",
+ "in": "query",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 2000
+ }
+ }
+ ],
+ "responses": {
+ "2XX": {
+ "description": "Success",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/chat.command-registration-result.v1"
+ }
+ }
+ }
+ },
+ "default": {
+ "description": "An error (RFC 9457 problem details)",
+ "content": {
+ "application/problem+json": {
+ "schema": {
+ "$ref": "#/components/schemas/errors.problem.v1"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
"/api/chat/inboxes": {
"/api/chat/inboxes": {
"get": {
"get": {
"operationId": "get_api_chat_inboxes",
"operationId": "get_api_chat_inboxes",
@@ -6538,6 +6680,132 @@
@@ -6538,6 +6680,132 @@
}
}
}
}
},
},
+ "chat.command-registration-request.v1": {
+ "title": "Chat command registration request",
+ "description": "chat.command-registration-request@1: an approved app or Actor agent registers a plain-response command in a server that the person named in its service token manages. The command cannot override a built-in. The template's {args} placeholder receives the invoking person's argument text; Chat posts the expanded result as that person after checking their current room rights.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "server",
+ "command",
+ "response_template"
+ ],
+ "properties": {
+ "server": {
+ "type": "string",
+ "pattern": "^[a-z0-9][a-z0-9-]{1,31}$"
+ },
+ "command": {
+ "$ref": "#/components/schemas/chat.command.v1"
+ },
+ "response_template": {
+ "type": "string",
+ "minLength": 1,
+ "maxLength": 2000
+ }
+ }
+ },
+ "chat.command-registration-result.v1": {
+ "title": "Chat command registration result",
+ "description": "chat.command-registration-result@1: the command Chat stored for an approved app or Actor agent, with source and application_id derived from the verified service token.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "command"
+ ],
+ "properties": {
+ "command": {
+ "$ref": "#/components/schemas/chat.command.v1"
+ }
+ }
+ },
+ "chat.command.v1": {
+ "title": "Chat slash command",
+ "description": "chat.command@1: one command the OpenVibe.Chat composer offers. A registered command's name (one to 32 lowercase letters, digits, underscores or dashes, starting with a letter), a plain-sentence description of at most 100 characters, and its typed options in order; source says who registered it (builtin, app or actor) and application_id names the app or actor for a registration. Chat serves the built-in list at GET /api/chat/commands (query q filters by name) and an option's choices at GET /api/chat/commands/autocomplete, both behind the default-off CHAT_SLASH_COMMANDS_ENABLED switch. An execution still runs through the socket's authenticated command pipeline with the sender's own rights, so moderating commands keep the moderation checks; an unknown command is answered with a plain sentence.",
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "name",
+ "description",
+ "options"
+ ],
+ "properties": {
+ "name": {
+ "type": "string",
+ "pattern": "^[a-z][a-z0-9_-]{0,31}$"
+ },
+ "description": {
+ "type": "string",
+ "maxLength": 100
+ },
+ "options": {
+ "type": "array",
+ "maxItems": 25,
+ "items": {
+ "$ref": "#/components/schemas/chat.command.v1/$defs/option"
+ }
+ },
+ "source": {
+ "enum": [
+ "builtin",
+ "app",
+ "actor"
+ ]
+ },
+ "application_id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "maxLength": 128
+ }
+ },
+ "$defs": {
+ "option": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "name",
+ "description",
+ "type",
+ "required"
+ ],
+ "properties": {
+ "name": {
+ "type": "string",
+ "pattern": "^[a-z][a-z0-9_-]{0,31}$"
+ },
+ "description": {
+ "type": "string",
+ "maxLength": 100
+ },
+ "type": {
+ "enum": [
+ "string",
+ "integer",
+ "boolean",
+ "user",
+ "channel"
+ ]
+ },
+ "required": {
+ "type": "boolean"
+ },
+ "choices": {
+ "type": "array",
+ "maxItems": 25,
+ "items": {
+ "type": "string",
+ "maxLength": 100
+ }
+ },
+ "autocomplete": {
+ "type": "boolean"
+ }
+ }
+ }
+ }
+ },
"chat.dm-peers-result.v1": {
"chat.dm-peers-result.v1": {
"title": "ChatDmPeersResult",
"title": "ChatDmPeersResult",
"description": "chat.dm-peers-result@1: which of the candidate people share a conversation with one person on OpenVibe.Chat (POST /internal/chat/dm/peers, chat.dm.peers.read). It answers with subjects only; a candidate with no shared conversation is simply absent. Used by OpenVibe.Network's presence privacy rule.",
"description": "chat.dm-peers-result@1: which of the candidate people share a conversation with one person on OpenVibe.Chat (POST /internal/chat/dm/peers, chat.dm.peers.read). It answers with subjects only; a candidate with no shared conversation is simply absent. Used by OpenVibe.Network's presence privacy rule.",
@@ -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.404.0",
- "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Community API",
"title": "OpenVibe.Community API",
- "version": "0.404.0",
- "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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"
@@ -5106,6 +5106,20 @@
@@ -5106,6 +5106,20 @@
"system"
"system"
]
]
},
},
+ "visibility": {
+ "enum": [
+ "followers"
+ ],
+ "description": "Present only for an item returned to an authorized follower or its author."
+ },
+ "starts_at": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "actor_name": {
+ "type": "string",
+ "maxLength": 80
+ },
"label": {
"label": {
"enum": [
"enum": [
"AI",
"AI",
@@ -5217,7 +5231,7 @@
@@ -5217,7 +5231,7 @@
},
},
"community.pulse-write-request.v1": {
"community.pulse-write-request.v1": {
"title": "CommunityPulseWriteRequest",
"title": "CommunityPulseWriteRequest",
- "description": "community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities (ref.service must be that service: 403 pulse.foreign_ref otherwise), with a title (whitespace collapsed, 1 to 300 characters) and an absolute http(s) url (at most 2000 characters). origin defaults to X-OV-Origin (user, ai or system; X-OV-Origin: ai always wins); an origin user item names the person in X-OV-Subject. occurred_at is an ISO time, not in the future (default now). Only public activity enters Pulse: a visibility other than public is 400 pulse.not_public. The same ref again updates the item. Unknown fields are ignored. DELETE /api/v1/pulse/items/:service/:type/:id takes no body.",
+ "description": "community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities, with a title and an absolute http(s) URL. Optional media carries an HTTPS thumbnail, preview video, aspect ratio and duration for Feed cards. Visibility is public by default; followers requires origin user and X-OV-Subject and is shown only to that person's followers. Private, unlisted and members items are refused. The same ref updates the item. DELETE /api/v1/pulse/items/:service/:type/:id retracts it.",
"anyOf": [
"anyOf": [
{
{
"type": "object",
"type": "object",
@@ -5259,8 +5273,38 @@
@@ -5259,8 +5273,38 @@
"visibility": {
"visibility": {
"enum": [
"enum": [
"public",
"public",
+ "followers",
null
null
]
]
+ },
+ "media": {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "thumb": {
+ "type": "string",
+ "pattern": "^https://",
+ "maxLength": 2000
+ },
+ "preview": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "pattern": "^https://",
+ "maxLength": 2000
+ },
+ "ratio": {
+ "type": "number",
+ "exclusiveMinimum": 0,
+ "maximum": 20
+ },
+ "length": {
+ "type": "number",
+ "minimum": 0,
+ "maximum": 86400
+ }
+ }
}
}
}
}
},
},
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe Connect API",
"title": "OpenVibe Connect API",
- "version": "0.404.0",
- "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Design API",
"title": "OpenVibe.Design API",
- "version": "0.404.0",
- "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.Exchange API",
"title": "OpenVibe.Exchange API",
- "version": "0.404.0",
- "description": "Routes of OpenVibe.Exchange as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Exchange as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.Git API",
"title": "OpenVibe.Git API",
- "version": "0.404.0",
- "description": "Routes of OpenVibe.Git as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Git as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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"
@@ -47,8 +47,8 @@
@@ -47,8 +47,8 @@
"service": "chat",
"service": "chat",
"name": "OpenVibe.Chat",
"name": "OpenVibe.Chat",
"origin": "https://openvibe.chat",
"origin": "https://openvibe.chat",
- "operations": 67,
- "capabilities": 26
+ "operations": 69,
+ "capabilities": 27
},
},
{
{
"service": "codes",
"service": "codes",
@@ -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.404.0",
- "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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"
@@ -4175,6 +4175,13 @@
@@ -4175,6 +4175,13 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."
+ },
"started_at": {
"started_at": {
"type": [
"type": [
"string",
"string",
@@ -4886,6 +4893,13 @@
@@ -4886,6 +4893,13 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."
+ },
"started_at": {
"started_at": {
"type": [
"type": [
"string",
"string",
@@ -5000,6 +5014,13 @@
@@ -5000,6 +5014,13 @@
"null"
"null"
]
]
},
},
+ "preview_url": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "description": "A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail."
+ },
"started_at": {
"started_at": {
"type": [
"type": [
"string",
"string",
@@ -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.Mail API",
"title": "OpenVibe.Mail API",
- "version": "0.404.0",
- "description": "Routes of OpenVibe.Mail as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Mail as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Report API",
"title": "OpenVibe.Report API",
- "version": "0.404.0",
- "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
"license": {
"license": {
"name": "MIT",
"name": "MIT",
"identifier": "MIT"
"identifier": "MIT"
@@ -3,8 +3,8 @@
@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"info": {
"title": "OpenVibe.Today API",
"title": "OpenVibe.Today API",
- "version": "0.404.0",
- "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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.404.0",
- "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.404.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
+ "version": "0.405.0",
+ "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.405.0): each operation lists the capabilities it performs; a token for the 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"
@@ -209270,6 +209270,14 @@ export interface MediaVod {
@@ -209270,6 +209270,14 @@ export interface MediaVod {
*/
*/
playback_url: string;
playback_url: string;
thumbnail_url?: string | null;
thumbnail_url?: string | null;
+ /**
+ * The hover preview of this item: about 6 s, muted, 320 px wide, MP4 H.264, stored beside its thumbnail and served at /t/<name>. Null until the preview.make job has made it (audio-only, private and too-short items never get one).
+ */
+ preview_url?: string | null;
+ /**
+ * The same moment as preview_url, encoded as WebM (VP9, VP8 where the encoder has no VP9). Null while preview_url is.
+ */
+ preview_webm_url?: string | null;
/**
/**
* local, b2 or r2.
* local, b2 or r2.
*/
*/
@@ -209363,6 +209371,14 @@ export interface MediaClip {
@@ -209363,6 +209371,14 @@ export interface MediaClip {
*/
*/
playback_url: string;
playback_url: string;
thumbnail_url?: string | null;
thumbnail_url?: string | null;
+ /**
+ * The hover preview of this item: about 6 s, muted, 320 px wide, MP4 H.264, stored beside its thumbnail and served at /t/<name>. Null until the preview.make job has made it (audio-only, private and too-short items never get one).
+ */
+ preview_url?: string | null;
+ /**
+ * The same moment as preview_url, encoded as WebM (VP9, VP8 where the encoder has no VP9). Null while preview_url is.
+ */
+ preview_webm_url?: string | null;
storage_provider?: string;
storage_provider?: string;
/**
/**
* public: anyone. unlisted: reached only by its exact id, never listed, noindex. private: missing to everyone but its owner and staff.
* public: anyone. unlisted: reached only by its exact id, never listed, noindex. private: missing to everyone but its owner and staff.
@@ -209645,6 +209661,24 @@ export interface ChatSlashCommand {
@@ -209645,6 +209661,24 @@ export interface ChatSlashCommand {
application_id?: string | null;
application_id?: string | null;
}
}
+/** [email protected] (owner: chat) */
+/**
+ * chat.command-registration-request@1: an approved app or Actor agent registers a plain-response command in a server that the person named in its service token manages. The command cannot override a built-in. The template's {args} placeholder receives the invoking person's argument text; Chat posts the expanded result as that person after checking their current room rights.
+ */
+export interface ChatCommandRegistrationRequest {
+ server: string;
+ command: ChatSlashCommand;
+ response_template: string;
+}
+
+/** [email protected] (owner: chat) */
+/**
+ * chat.command-registration-result@1: the command Chat stored for an approved app or Actor agent, with source and application_id derived from the verified service token.
+ */
+export interface ChatCommandRegistrationResult {
+ command: ChatSlashCommand;
+}
+
/** [email protected] (owner: chat) */
/** [email protected] (owner: chat) */
/**
/**
* chat.send-request@1: what a sender hands OpenVibe.Chat to post a chat line (chat.message.send). From a browser, a frame on WS /ws/chat of type chat in the room the socket joined (the text is trimmed; empty or longer than 6000 characters is dropped, the channel's own max_message_length is enforced after that; a line starting with ! or / is a command, not a message). From Live's bridge, POST /internal/live/calls: a chat.live_bridge.write batch in which every op that sends a message (a chat or dm frame, db saveChatMessage, deployNotice) also needs chat.message.send; without it that op alone is refused. From a first-party service, POST /internal/chat/messages: one line (or one DM) that Chat stores, broadcasts to the room (with mirror, also to global chat and the streamer rooms), reads aloud (tts) and answers with the real id; applied once per (caller, key), the same key with another body gets 409.
* chat.send-request@1: what a sender hands OpenVibe.Chat to post a chat line (chat.message.send). From a browser, a frame on WS /ws/chat of type chat in the room the socket joined (the text is trimmed; empty or longer than 6000 characters is dropped, the channel's own max_message_length is enforced after that; a line starting with ! or / is a command, not a message). From Live's bridge, POST /internal/live/calls: a chat.live_bridge.write batch in which every op that sends a message (a chat or dm frame, db saveChatMessage, deployNotice) also needs chat.message.send; without it that op alone is refused. From a first-party service, POST /internal/chat/messages: one line (or one DM) that Chat stores, broadcasts to the room (with mirror, also to global chat and the streamer rooms), reads aloud (tts) and answers with the real id; applied once per (caller, key), the same key with another body gets 409.
@@ -212102,15 +212136,172 @@ export interface ChatRoomInsightResult {
@@ -212102,15 +212136,172 @@ export interface ChatRoomInsightResult {
state: "ready" | "quiet" | "off";
state: "ready" | "quiet" | "off";
}
}
+/** [email protected] (owner: chat) */
+/**
+ * chat.person-memory-result@1: compacted chat memory returned by GET /api/v1/people/{username}/memory. Private fields appear only for the person and the channel owner.
+ */
+export interface ChatPersonMemoryResult {
+ username: string;
+ level: "day" | "week" | "month";
+ channel: string | null;
+ opted_out: boolean;
+ enabled: boolean;
+ /**
+ * @maxItems 60
+ */
+ entries: {
+ level: "day" | "week" | "month";
+ period_start: string;
+ channel_user_id: number;
+ summary: string;
+ /**
+ * @maxItems 5
+ */
+ topics:
+ | []
+ | [string]
+ | [string, string]
+ | [string, string, string]
+ | [string, string, string, string]
+ | [string, string, string, string, string];
+ /**
+ * @maxItems 5
+ */
+ highlights:
+ | []
+ | [
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ }
+ ]
+ | [
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ },
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ }
+ ]
+ | [
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ },
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ },
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ }
+ ]
+ | [
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ },
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ },
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ },
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ }
+ ]
+ | [
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ },
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ },
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ },
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ },
+ {
+ detail: string;
+ stream_id: number | null;
+ at: string | null;
+ }
+ ];
+ message_count: number;
+ tone?: string;
+ /**
+ * @maxItems 5
+ */
+ catchphrases?:
+ | []
+ | [string]
+ | [string, string]
+ | [string, string, string]
+ | [string, string, string, string]
+ | [string, string, string, string, string];
+ /**
+ * @maxItems 8
+ */
+ people?:
+ | []
+ | [string]
+ | [string, string]
+ | [string, string, string]
+ | [string, string, string, string]
+ | [string, string, string, string, string]
+ | [string, string, string, string, string, string]
+ | [string, string, string, string, string, string, string]
+ | [string, string, string, string, string, string, string, string];
+ }[];
+}
+
+/** [email protected] (owner: chat) */
+/**
+ * chat.person-memory-preferences-result@1: the person's delete or opt-out result.
+ */
+export interface ChatPersonMemoryPreferencesResult {
+ opted_out: boolean;
+ deleted?: boolean;
+}
+
/** [email protected] (owner: chat) */
/** [email protected] (owner: chat) */
/**
/**
- * chat.embed@1: one address preview under a chat message, the same shape for every client (OpenVibe.Chat, Live's chat and the Dock). A message carries `embeds` in the order the addresses appeared in its text, at most three; it is empty while the background job is still reading, and the client draws each one as the same card. The fields are data, never markup: a client escapes them (title, description, site_name, by) before drawing them. url is the address the writer sent, https only. image is an OpenVibe.Media address or null: another site's picture is never hot-linked. width and height are the picture's stated size, or 0. kind names what was found: an ordinary page (`link`), a video (`video`), a picture (`image`), a Live channel (`live`), a Pics picture (`picture`), a Design item (`design`), a Community post (`post`), a Network profile (`profile`) or a Games world (`game`). OpenVibe's own kinds are resolved through that service's public API, never by reading its page, and carry by (the person or channel the thing belongs to) and, for Live, live (whether the channel is broadcasting now); both are absent on an ordinary link.
+ * chat.embed@1: one address preview under a chat message, the same shape for every client (OpenVibe.Chat, Live's chat and the Dock). A message carries `embeds` in the order the addresses appeared in its text, at most three; it is empty while the background job is still reading, and the client draws each one as the same card. The fields are data, never markup: a client escapes them (title, description, site_name, by) before drawing them. url is the address the writer sent, https only. image is an OpenVibe.Media address or null: another site's picture is never hot-linked. width and height are the picture's stated size, or 0. kind names what was found: an ordinary page (`link`), a video (`video`), a picture (`image`), a Live channel (`live`), a Pics picture (`picture`), a Design item (`design`), a Community post (`post`), a Network profile (`profile`) or a Games world (`game`). OpenVibe's own kinds are resolved through that service's public API, never by reading its page, and carry by (the person or channel the thing belongs to) and, for Live, live (whether the channel is broadcasting now); both are absent on an ordinary link. An agent-run embed carries the live run and event addresses, title and status.
*/
*/
-export interface ChatEmbed {
+export type ChatEmbed = {
+ [k: string]: unknown | undefined;
+} & {
/**
/**
* What the address turned out to be; a client may draw the same card for every value.
* What the address turned out to be; a client may draw the same card for every value.
*/
*/
- kind: "link" | "video" | "image" | "live" | "picture" | "design" | "post" | "profile" | "game";
+ kind: "link" | "video" | "image" | "live" | "picture" | "design" | "post" | "profile" | "game" | "agent-run";
/**
/**
* The https address the message carried, after the writer's trailing punctuation was dropped.
* The https address the message carried, after the writer's trailing punctuation was dropped.
*/
*/
@@ -212119,9 +212310,6 @@ export interface ChatEmbed {
@@ -212119,9 +212310,6 @@ export interface ChatEmbed {
* The site as it names itself (og:site_name, the provider's name, or the host).
* The site as it names itself (og:site_name, the provider's name, or the host).
*/
*/
site_name: string;
site_name: string;
- /**
- * The page's or service's title, folded to plain text.
- */
title: string;
title: string;
/**
/**
* A short plain-text description, or an empty string when the source states none.
* A short plain-text description, or an empty string when the source states none.
@@ -212147,7 +212335,10 @@ export interface ChatEmbed {
@@ -212147,7 +212335,10 @@ export interface ChatEmbed {
* On a Live channel kind, whether it is broadcasting now. Absent on the other kinds.
* On a Live channel kind, whether it is broadcasting now. Absent on the other kinds.
*/
*/
live?: boolean;
live?: boolean;
-}
+ run_url?: string;
+ events_url?: string;
+ status?: "queued" | "running" | "waiting" | "needs_you" | "succeeded" | "failed" | "stopped" | "cancelled";
+};
/** [email protected] (owner: chat) */
/** [email protected] (owner: chat) */
/**
/**
@@ -212633,6 +212824,10 @@ export type LiveChannelReadResult =
@@ -212633,6 +212824,10 @@ export type LiveChannelReadResult =
viewer_count?: number | null;
viewer_count?: number | null;
peak_viewers?: number | null;
peak_viewers?: number | null;
thumbnail_url?: string | null;
thumbnail_url?: string | null;
+ /**
+ * A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail.
+ */
+ preview_url?: string | null;
started_at?: string | null;
started_at?: string | null;
ended_at?: string | null;
ended_at?: string | null;
/**
/**
@@ -212934,6 +213129,10 @@ export type LiveStreamReadResult =
@@ -212934,6 +213129,10 @@ export type LiveStreamReadResult =
viewer_count?: number | null;
viewer_count?: number | null;
peak_viewers?: number | null;
peak_viewers?: number | null;
thumbnail_url?: string | null;
thumbnail_url?: string | null;
+ /**
+ * A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail.
+ */
+ preview_url?: string | null;
started_at?: string | null;
started_at?: string | null;
ended_at?: string | null;
ended_at?: string | null;
/**
/**
@@ -212964,6 +213163,10 @@ export type LiveStreamReadResult =
@@ -212964,6 +213163,10 @@ export type LiveStreamReadResult =
viewer_count?: number | null;
viewer_count?: number | null;
peak_viewers?: number | null;
peak_viewers?: number | null;
thumbnail_url?: string | null;
thumbnail_url?: string | null;
+ /**
+ * A cheap live preview of the stream, when Live has one: while it is being recorded, Media's DVR HLS playlist at the live edge (/v/<vod>/dvr.m3u8, full-resolution, no extra encode). Null when there is no active recording; the player keeps the thumbnail.
+ */
+ preview_url?: string | null;
started_at?: string | null;
started_at?: string | null;
ended_at?: string | null;
ended_at?: string | null;
/**
/**
@@ -213812,7 +214015,7 @@ export type CommunityPostWriteResult =
@@ -213812,7 +214015,7 @@ export type CommunityPostWriteResult =
/** [email protected] (owner: community) */
/** [email protected] (owner: community) */
/**
/**
- * community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities (ref.service must be that service: 403 pulse.foreign_ref otherwise), with a title (whitespace collapsed, 1 to 300 characters) and an absolute http(s) url (at most 2000 characters). origin defaults to X-OV-Origin (user, ai or system; X-OV-Origin: ai always wins); an origin user item names the person in X-OV-Subject. occurred_at is an ISO time, not in the future (default now). Only public activity enters Pulse: a visibility other than public is 400 pulse.not_public. The same ref again updates the item. Unknown fields are ignored. DELETE /api/v1/pulse/items/:service/:type/:id takes no body.
+ * community.pulse-write-request@1: the body of POST /api/v1/pulse/items on OpenVibe.Community (community.pulse.write; service tokens only): an item about one of the calling service's own entities, with a title and an absolute http(s) URL. Optional media carries an HTTPS thumbnail, preview video, aspect ratio and duration for Feed cards. Visibility is public by default; followers requires origin user and X-OV-Subject and is shown only to that person's followers. Private, unlisted and members items are refused. The same ref updates the item. DELETE /api/v1/pulse/items/:service/:type/:id retracts it.
*/
*/
export type CommunityPulseWriteRequest =
export type CommunityPulseWriteRequest =
| {
| {
@@ -213824,7 +214027,13 @@ export type CommunityPulseWriteRequest =
@@ -213824,7 +214027,13 @@ export type CommunityPulseWriteRequest =
url: string;
url: string;
origin?: "user" | "ai" | "system" | null;
origin?: "user" | "ai" | "system" | null;
occurred_at?: string | number | null;
occurred_at?: string | number | null;
- visibility?: "public" | null;
+ visibility?: "public" | "followers" | null;
+ media?: {
+ thumb?: string;
+ preview?: string | null;
+ ratio?: number;
+ length?: number;
+ };
}
}
| NoBody;
| NoBody;
@@ -213979,6 +214188,12 @@ export interface CommunityPulseItem {
@@ -213979,6 +214188,12 @@ export interface CommunityPulseItem {
title: string;
title: string;
url: string;
url: string;
origin: "user" | "ai" | "system";
origin: "user" | "ai" | "system";
+ /**
+ * Present only for an item returned to an authorized follower or its author.
+ */
+ visibility?: "followers";
+ starts_at?: string;
+ actor_name?: string;
label: "AI" | "System" | null;
label: "AI" | "System" | null;
/**
/**
* A third-party contribution is shown as via <app>.
* A third-party contribution is shown as via <app>.
@@ -214006,7 +214221,7 @@ export interface CommunityPulseItem {
@@ -214006,7 +214221,7 @@ export interface CommunityPulseItem {
/** [email protected] (owner: community) */
/** [email protected] (owner: community) */
/**
/**
- * community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). One stream over Pulse: a paste or a status is a post, a Live clip a clip, a Wiki page a wiki page, a Quest badge a quest, a busy Chat hour a chat, a Today event an event, and a day's new Network accounts a member. Text only (the client draws every field), https links only, and counts carry Community's own views, likes and comments where it knows them.
+ * community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). Each card keeps its source and public visibility. Scheduled calendar cards appear only before their start time; bursts can carry a group of links. Counts carry Community's own views, likes and comments where it knows them.
*/
*/
export interface CommunityFeedItem {
export interface CommunityFeedItem {
/**
/**
@@ -214027,7 +214242,14 @@ export interface CommunityFeedItem {
@@ -214027,7 +214242,14 @@ export interface CommunityFeedItem {
| "quest"
| "quest"
| "chat"
| "chat"
| "event"
| "event"
- | "member";
+ | "member"
+ | "avatar"
+ | "banner"
+ | "paste"
+ | "site"
+ | "space"
+ | "follow"
+ | "episode";
/**
/**
* Where the card opens; https unless the source itself answered an http URL.
* Where the card opens; https unless the source itself answered an http URL.
*/
*/
@@ -214041,6 +214263,14 @@ export interface CommunityFeedItem {
@@ -214041,6 +214263,14 @@ export interface CommunityFeedItem {
* When it happened (Pulse provenance); null for a trending card.
* When it happened (Pulse provenance); null for a trending card.
*/
*/
at: string | null;
at: string | null;
+ /**
+ * The start time of a Coming up calendar item; absent on other kinds.
+ */
+ starts_at?: string;
+ /**
+ * Present only for an item returned to a follower or its author.
+ */
+ visibility?: "followers";
/**
/**
* The source service (live, media-hub, pics, games, blog, wiki, quest, chat, today, network, community…).
* The source service (live, media-hub, pics, games, blog, wiki, quest, chat, today, network, community…).
*/
*/
@@ -214058,6 +214288,7 @@ export interface CommunityFeedItem {
@@ -214058,6 +214288,7 @@ export interface CommunityFeedItem {
*/
*/
media: {
media: {
thumb: string;
thumb: string;
+ preview?: string;
ratio: number;
ratio: number;
/**
/**
* Seconds, when the card is a video.
* Seconds, when the card is a video.
@@ -214076,12 +214307,93 @@ export interface CommunityFeedItem {
@@ -214076,12 +214307,93 @@ export interface CommunityFeedItem {
* Present on live and stream cards: true only while the channel is currently on air. A past broadcast has kind stream and live_now false.
* Present on live and stream cards: true only while the channel is currently on air. A past broadcast has kind stream and live_now false.
*/
*/
live_now?: boolean;
live_now?: boolean;
+ group?: {
+ count: number;
+ /**
+ * @minItems 2
+ */
+ items: [
+ {
+ id: string;
+ url: string;
+ title: string;
+ media: {} | null;
+ },
+ {
+ id: string;
+ url: string;
+ title: string;
+ media: {} | null;
+ },
+ ...{
+ id: string;
+ url: string;
+ title: string;
+ media: {} | null;
+ }[]
+ ];
+ };
/**
/**
* Present only when the card needs one.
* Present only when the card needs one.
*/
*/
label?: "Trending" | "AI" | "System";
label?: "Trending" | "AI" | "System";
}
}
+/** [email protected] (owner: community) */
+/**
+ * community.feed-card@1: one public card returned by GET /api/v1/feed on OpenVibe.Community.
+ */
+export interface CommunityFeedCard {
+ id: string;
+ kind:
+ | "live"
+ | "stream"
+ | "clip"
+ | "video"
+ | "pic"
+ | "post"
+ | "meme"
+ | "game"
+ | "update"
+ | "wiki"
+ | "quest"
+ | "chat"
+ | "event"
+ | "member";
+ url: string;
+ title: string;
+ text: string;
+ at: string | null;
+ site: string;
+ site_name: string;
+ actor: {
+ name: string | null;
+ avatar: string | null;
+ } | null;
+ media: {
+ thumb: string;
+ preview?: string | null;
+ ratio: number;
+ length?: number;
+ } | null;
+ counts: {
+ views?: number;
+ likes?: number;
+ comments?: number;
+ };
+ live_now?: boolean;
+ label?: "Trending" | "AI" | "System";
+}
+
+/** [email protected] (owner: community) */
+/**
+ * community.feed-answer@1: the response from GET /api/v1/feed.
+ */
+export interface CommunityFeedAnswer {
+ items: CommunityFeedCard[];
+ next_cursor: string | null;
+}
+
/** [email protected] (owner: community) */
/** [email protected] (owner: community) */
/**
/**
* community.pulse-read-result@1: answers of community.pulse.read on OpenVibe.Community (anyone). GET /api/v1/pulse?origin=user|ai|system&after=&limit= → { items, next_cursor } (newest first, at most 100; an unknown origin or a cursor this API did not issue is 400). GET /pulse is the same activity as an HTML page.
* community.pulse-read-result@1: answers of community.pulse.read on OpenVibe.Community (anyone). GET /api/v1/pulse?origin=user|ai|system&after=&limit= → { items, next_cursor } (newest first, at most 100; an unknown origin or a cursor this API did not issue is 400). GET /pulse is the same activity as an HTML page.
@@ -333288,3 +333600,1965 @@ export interface NetworkLevelBoard {
@@ -333288,3 +333600,1965 @@ export interface NetworkLevelBoard {
];
];
};
};
}
}
+
+/** [email protected] (owner: media) */
+/**
+ * composer.attachment@1: one file a person attached to a message in the shared composer. Media stores it and answers this shape from POST /api/v1/attachments (multipart field `file`); a client keeps it until the message is sent, then names it in POST /api/v1/attachments/:id/keep. `kind` is sniffed from the bytes, never taken from the browser: image, video, audio, file or code. `thumb` is a small preview for images and video (absent for the rest), `w`/`h` the pixel size when the file is one Media can measure. An attachment nobody keeps expires after 24 hours; `expires_at` says when, and a keep extends it to the message's life.
+ */
+export interface ComposerAttachment {
+ /**
+ * The attachment id (att_ + ULID): what DELETE /api/v1/attachments/:id and POST /api/v1/attachments/:id/keep name.
+ */
+ id: string;
+ /**
+ * Decided by Media from the bytes, not the client's claim: image/video/audio when the signature matches, code for recognised source text, otherwise file. Executables are refused at upload.
+ */
+ kind: "image" | "video" | "audio" | "file" | "code";
+ /**
+ * The file's original name, sanitised for display; never a path.
+ */
+ name: string;
+ /**
+ * Bytes stored.
+ */
+ size: number;
+ /**
+ * The content type Media serves the bytes as, from the sniffed kind and format.
+ */
+ mime: string;
+ /**
+ * Absolute https URL the bytes are served at. It stays valid while the attachment exists; a kept attachment is the message's to serve.
+ */
+ url: string;
+ /**
+ * Absolute URL of a preview image: an image's own small copy or a video's first frame. Null when Media could not make one (or the kind has none).
+ */
+ thumb?: string | null;
+ /**
+ * Pixel width of an image, video or video preview; null when unknown.
+ */
+ w?: number | null;
+ /**
+ * Pixel height of an image, video or video preview; null when unknown.
+ */
+ h?: number | null;
+ /**
+ * When an unkept attachment is deleted. The upload answers now + 24 hours; a keep moves it to the kept window.
+ */
+ expires_at: string;
+}
+
+/** [email protected] (owner: network) */
+/**
+ * composer.prefs@1: a person's composer settings, the same on every OpenVibe site because Network stores them (GET/PUT /api/v1/me/composer). `rev` is the stored revision: send the one you read back with your change, and a tab that read an older copy gets 409 with the current document instead of overwriting the other tab. `send_key` says whether Enter or Ctrl/Cmd+Enter sends. `tools` is the one order of the composer's tools and which are hidden; a tool id the client does not know is kept, so a site can add one without another site dropping the person's order. `snippets` are the person's saved inserts, triggered by typing a slash word.
+ */
+export interface ComposerPrefs {
+ /**
+ * Revision of the stored document. A missing document is rev 0 with the defaults; every successful PUT answers rev + 1.
+ */
+ rev: number;
+ /**
+ * enter: Enter sends and Shift+Enter breaks the line. mod-enter: Ctrl/Cmd+Enter sends and Enter breaks the line (the default on a phone keyboard is enter).
+ */
+ send_key: "enter" | "mod-enter";
+ /**
+ * Every tool in the order the person wants them, each marked hidden or not.
+ *
+ * @maxItems 100
+ */
+ tools: {
+ id: string;
+ hidden: boolean;
+ }[];
+ /**
+ * How much room the composer takes: comfy is the default on a computer, compact on a phone.
+ */
+ density: "comfy" | "compact";
+ /**
+ * Whether the composer offers dictation (where the device has it).
+ */
+ voice: boolean;
+ /**
+ * Saved inserts. Typing the trigger (a slash word such as /sig) in the composer offers the snippet.
+ *
+ * @maxItems 50
+ */
+ snippets: {
+ /**
+ * The slash word that offers the snippet, e.g. /sig. Lower-case letters, digits, _ and - only.
+ */
+ trigger: string;
+ /**
+ * What the menu shows.
+ */
+ label: string;
+ /**
+ * What is inserted.
+ */
+ text: string;
+ }[];
+}
+
+/** [email protected] (owner: network) */
+/**
+ * composer.mention@1: one thing the composer's @ menu can insert, from GET /api/v1/mentions on OpenVibe.Network. kind person (a person the caller follows first, then a public person), repo (a repository on OpenVibe Git the caller can see), site (a first-party OpenVibe site) or file (a file of the message's own context). `id` is the stable id inside its kind, `label` what the menu shows, `handle` the @name when the kind has one, `avatar` the picture, and `url` where choosing it links.
+ */
+export interface ComposerMention {
+ /**
+ * What is mentioned. The same person is a person; a repository on OpenVibe Git is a repo; a first-party OpenVibe site is a site; a file of the message's context (an attachment or a repository file) is a file.
+ */
+ kind: "person" | "repo" | "site" | "file";
+ /**
+ * The stable id inside the kind: a usr_… subject for a person, owner/name for a repo, a site id for a site, a path or attachment id for a file.
+ */
+ id: string;
+ /**
+ * What the menu shows (a display name, owner/name, the site's name, a file name).
+ */
+ label: string;
+ /**
+ * The @name when the kind has one: a person's username, a site's short name. Absent for a repo or a file.
+ */
+ handle?: string;
+ /**
+ * Absolute URL of the picture to show beside the label. Null when the kind has none (a file, a site without a mark).
+ */
+ avatar?: string | null;
+ /**
+ * Absolute https URL where choosing the mention leads: the person's profile, the repository, the site's home or the file.
+ */
+ url: string;
+}
+
+/** [email protected] (owner: network) */
+/**
+ * network.user-card@1 (ask 287): the one public user card read, GET /api/v1/people/:username/card on OpenVibe.Network. It is public and credential-free; a signed-in viewer may send their Network token (Authorization: Bearer …) and then also receives `actions` computed for that viewer, never cached. Without a viewer, or on the viewer's own card, `actions` carries Profile and Channel only. A missing, expired or revoked token reads as anonymous, never a 401. Hidden fields are absent, never zero, offline or a placeholder; no presence, page titles or visited URLs leave the read.
+ */
+export interface NetworkUserCard {
+ username: string;
+ display_name?: string;
+ avatar_url?: string;
+ profile_url: string;
+ level?: number;
+ streak?: number;
+ badges_count?: number;
+ followers?: number;
+ live?: {
+ now: boolean;
+ site?: "live";
+ url?: string;
+ };
+ channel_url?: string;
+ active_sites?: {
+ id: string;
+ name: string;
+ url: string;
+ }[];
+ /**
+ * What the viewer can do, by what is possible for the pair. Order is the card's order. Each action either opens somewhere (`href`) or calls a Network route with the viewer's token (`method` + `path`, and `body` where the route needs one).
+ */
+ actions: (
+ | {
+ id: string;
+ label: string;
+ href: string;
+ state?: {
+ following?: boolean;
+ friendship?: "none" | "pending" | "requested" | "friends";
+ muted?: boolean;
+ blocked?: boolean;
+ reported?: boolean;
+ };
+ }
+ | {
+ id: string;
+ label: string;
+ method: "PUT" | "POST" | "DELETE" | "PATCH";
+ path: string;
+ body?: {};
+ state?: {
+ following?: boolean;
+ friendship?: "none" | "pending" | "requested" | "friends";
+ muted?: boolean;
+ blocked?: boolean;
+ reported?: boolean;
+ };
+ }
+ )[];
+}
+
+/** [email protected] (owner: network) */
+/**
+ * network.user-report@1 (ask 287): one report a person filed about another person on OpenVibe.Network. Reports never resolve themselves; staff holding staff.moderation.logs read the queue (GET /api/v1/staff/user-reports?status=open&target=usr_…&limit=), and a staff decision lives in the moderation audit log. `status` records whether staff have looked, not a verdict.
+ */
+export interface NetworkUserReport {
+ id: number;
+ reporter: string;
+ target: string;
+ reason: "spam" | "harassment" | "impersonation" | "explicit" | "scam" | "other";
+ detail: string;
+ status: "open" | "reviewed" | "dismissed";
+ created_at: string;
+ updated_at: string;
+}
+
+/** [email protected] (owner: network) */
+/**
+ * network.user-report-list-result@1 (ask 287): GET /api/v1/staff/user-reports on OpenVibe.Network, the staff queue for people holding staff.moderation.logs. Newest first, filtered by status (default open) and target subject, at most 200 rows (`limit`, default 50). A caller without the capability gets 403 user_reports.forbidden (problem+json).
+ */
+export interface NetworkUserReportListResult {
+ /**
+ * @maxItems 200
+ */
+ reports: NetworkUserReport[];
+}
+
+/** [email protected] (owner: network) */
+/**
+ * network.user-report-request@1 (ask 287): POST /api/v1/me/reports on OpenVibe.Network, a signed-in person's report about another person. `target` is their username (any case) or usr_ subject; guests cannot be named, and nobody reports themselves. The same pair may have one open report: filing again while it is open answers the open one with 200 instead of creating a duplicate (201 when it creates one).
+ */
+export interface NetworkUserReportRequest {
+ target: string;
+ reason: "spam" | "harassment" | "impersonation" | "explicit" | "scam" | "other";
+ detail?: string;
+}
+
+/** [email protected] (owner: actor) */
+/**
+ * agent.ui-event@1: AG-UI 1.0 event shape and event-family fields, with OpenVibe metadata.ov. AG-UI timestamps are Unix-millisecond integers; this contract requires one on every event. CUSTOM events use AG-UI name/value with ov.sources, ov.handoff, ov.approval or ov.result names.
+ */
+export type AgentUiEvent = Event & {};
+/**
+ * Any AG-UI event. Every member is normative: there is no optional tier and no event a consumer may decline to implement. Discriminated by the type property.
+ */
+export type Event =
+ | TextMessageStartEvent
+ | TextMessageContentEvent
+ | TextMessageEndEvent
+ | TextMessageChunkEvent
+ | ToolCallStartEvent
+ | ToolCallArgsEvent
+ | ToolCallEndEvent
+ | ToolCallChunkEvent
+ | ToolCallResultEvent
+ | StateSnapshotEvent
+ | StateDeltaEvent
+ | MessagesSnapshotEvent
+ | ActivitySnapshotEvent
+ | ActivityDeltaEvent
+ | RawEvent
+ | CustomEvent
+ | RunStartedEvent
+ | RunFinishedEvent
+ | RunErrorEvent
+ | StepStartedEvent
+ | StepFinishedEvent
+ | ReasoningStartEvent
+ | ReasoningMessageStartEvent
+ | ReasoningMessageContentEvent
+ | ReasoningMessageEndEvent
+ | ReasoningMessageChunkEvent
+ | ReasoningEndEvent
+ | ReasoningEncryptedValueEvent
+ | SubagentStartedEvent
+ | SubagentFinishedEvent
+ | SubagentErrorEvent;
+/**
+ * Opens a streamed text message. The content arrives as TEXT_MESSAGE_CONTENT events and the message closes with TEXT_MESSAGE_END.
+ */
+export type TextMessageStartEvent = BaseEvent &
+ Attributable & {
+ type: "TEXT_MESSAGE_START";
+ /**
+ * Identifies the message this stream builds, and ties the later content and end events to it.
+ */
+ messageId: string;
+ /**
+ * Who the message is from. An absent role means assistant; that meaning is normative and stated in the prose, because a validator treats a default as documentation rather than as behaviour.
+ */
+ role?: "developer" | "system" | "assistant" | "user";
+ /**
+ * An optional display name for the author, for providers that distinguish several participants in one role.
+ */
+ name?: string;
+ };
+/**
+ * Appends a fragment to a streamed text message.
+ */
+export type TextMessageContentEvent = BaseEvent &
+ Attributable & {
+ type: "TEXT_MESSAGE_CONTENT";
+ /**
+ * The message this fragment belongs to.
+ */
+ messageId: string;
+ /**
+ * The fragment to append. May be the empty string: providers emit empty deltas as keep-alives and while a tool call is being decided, and rejecting them would kill runs that are working correctly.
+ */
+ delta: string;
+ };
+/**
+ * Closes a streamed text message.
+ */
+export type TextMessageEndEvent = BaseEvent &
+ Attributable & {
+ type: "TEXT_MESSAGE_END";
+ /**
+ * The message being closed.
+ */
+ messageId: string;
+ };
+/**
+ * A shorthand that stands in for a start, content and end sequence, for producers that cannot know in advance where a message begins. Every field is optional because a continuation chunk omits what has not changed; which message a field-less chunk continues is a sequence question the prose specification answers.
+ */
+export type TextMessageChunkEvent = BaseEvent &
+ Attributable & {
+ type: "TEXT_MESSAGE_CHUNK";
+ /**
+ * The message this chunk belongs to. Absent continues the message already open.
+ */
+ messageId?: string;
+ /**
+ * Who the message is from, on the chunk that opens it.
+ */
+ role?: "developer" | "system" | "assistant" | "user";
+ /**
+ * The fragment to append. May be the empty string.
+ */
+ delta?: string;
+ /**
+ * An optional display name for the author.
+ */
+ name?: string;
+ };
+/**
+ * Opens a tool call. The arguments arrive as TOOL_CALL_ARGS events and the call closes with TOOL_CALL_END.
+ */
+export type ToolCallStartEvent = BaseEvent &
+ Attributable & {
+ type: "TOOL_CALL_START";
+ /**
+ * Identifies the call, and ties the later args, end and result events to it.
+ */
+ toolCallId: string;
+ /**
+ * Which tool is being called.
+ */
+ toolCallName: string;
+ /**
+ * The assistant message that holds this call. Absent means the producer did not attribute it to one.
+ */
+ parentMessageId?: string;
+ };
+/**
+ * Appends a fragment of a tool call's arguments.
+ */
+export type ToolCallArgsEvent = BaseEvent &
+ Attributable & {
+ type: "TOOL_CALL_ARGS";
+ /**
+ * The call these arguments belong to.
+ */
+ toolCallId: string;
+ /**
+ * A fragment of the arguments, which concatenate into the call's argument text — conventionally a JSON document, though the protocol does not validate it (see FunctionCall.arguments). Deliberately a string rather than parsed JSON: a fragment is not itself a document. May be the empty string.
+ */
+ delta: string;
+ };
+/**
+ * Closes a tool call, meaning its arguments are complete.
+ */
+export type ToolCallEndEvent = BaseEvent &
+ Attributable & {
+ type: "TOOL_CALL_END";
+ /**
+ * The call being closed.
+ */
+ toolCallId: string;
+ };
+/**
+ * A shorthand that stands in for a tool call's start, args and end sequence. Every field is optional for the same reason as TEXT_MESSAGE_CHUNK.
+ */
+export type ToolCallChunkEvent = BaseEvent &
+ Attributable & {
+ type: "TOOL_CALL_CHUNK";
+ /**
+ * The call this chunk belongs to. Absent continues the call already open.
+ */
+ toolCallId?: string;
+ /**
+ * Which tool is being called, on the chunk that opens it.
+ */
+ toolCallName?: string;
+ /**
+ * The assistant message that holds this call.
+ */
+ parentMessageId?: string;
+ /**
+ * A fragment of the arguments. May be the empty string.
+ */
+ delta?: string;
+ };
+/**
+ * Carries what a tool returned. Mints a tool message rather than appending to an existing one, which is why it has its own messageId.
+ */
+export type ToolCallResultEvent = BaseEvent &
+ Attributable & {
+ type: "TOOL_CALL_RESULT";
+ /**
+ * The tool message this result becomes.
+ */
+ messageId: string;
+ /**
+ * The call being answered.
+ */
+ toolCallId: string;
+ /**
+ * What the tool returned: either plain text, or an ordered list of parts, exactly as on the tool message this event mints. A tool returning structured data serialises it into text; media travel as parts of their own.
+ */
+ content: string | ContentPart[];
+ /**
+ * Present only for symmetry with the message it mints; the value is fixed, so a producer may leave it out.
+ */
+ role?: "tool";
+ };
+/**
+ * One part of a message body: what a person sends in a user message, or what a tool returns in a tool message. Discriminated by type. Named by what the part is rather than by direction, because the same part travels into the model inside a user message and back out of the stream inside a tool result.
+ */
+export type ContentPart = TextPart | ImagePart | AudioPart | VideoPart | DocumentPart;
+/**
+ * Replaces the agent state wholesale. Sent when a delta cannot express the change, or to resynchronise a consumer.
+ */
+export type StateSnapshotEvent = BaseEvent &
+ Attributable & {
+ type: "STATE_SNAPSHOT";
+ /**
+ * The complete new state.
+ */
+ snapshot: {
+ [k: string]: unknown | undefined;
+ };
+ };
+/**
+ * Changes the agent state incrementally.
+ */
+export type StateDeltaEvent = BaseEvent &
+ Attributable & {
+ type: "STATE_DELTA";
+ delta: JsonPatch;
+ };
+/**
+ * A single RFC 6902 operation. Exactly one of the operation shapes must match, discriminated by op. Unlike the protocol's own objects, the operations are open: RFC 6902 section 4 requires members an operation does not define to be ignored rather than rejected, so a remove carrying a leftover value is a valid patch. Two of the RFC's rules are relations between values rather than shapes, so no static schema can express them and neither is checked here: a move whose from is a proper prefix of its path (section 4.4), and any operation whose pointer does not resolve in the target document. Both are the applier's to reject.
+ */
+export type JsonPatchOperation =
+ AddOperation | RemoveOperation | ReplaceOperation | MoveOperation | CopyOperation | TestOperation;
+/**
+ * The change, as an RFC 6902 patch against the current state. Structural validity here does not mean the patch applies: a well-formed operation may point at a path that does not exist, which RFC 6902 leaves to the applier.
+ */
+export type JsonPatch = JsonPatchOperation[];
+/**
+ * The complete set of messages the producer owns, in order. Conversation-wide rather than a plain overwrite: a consumer may keep messages of its own that no producer tracks, so exactly how a snapshot reconciles with those is behavioural and belongs in the prose. Being conversation-wide it cannot belong to a single subagent, so it carries no attribution; it does establish which subagent owns each message it contains, through the messages themselves.
+ */
+export type MessagesSnapshotEvent = BaseEvent & {
+ type: "MESSAGES_SNAPSHOT";
+ /**
+ * The messages the producer is declaring, in order.
+ */
+ messages: Message[];
+};
+/**
+ * Any message in a conversation. Discriminated by role.
+ */
+export type Message =
+ DeveloperMessage | SystemMessage | AssistantMessage | UserMessage | ToolMessage | ActivityMessage | ReasoningMessage;
+/**
+ * Instructions from the application developer.
+ */
+export type DeveloperMessage = BaseMessage & {
+ role: "developer";
+ /**
+ * The instructions. Required: a developer message with nothing in it says nothing.
+ */
+ content: string;
+};
+/**
+ * The fields shared by the developer, system, assistant and user messages. Deliberately excludes content, because a user message's content may be an array while the others are strings, and composition here intersects rather than overrides: a base that constrained content to a string would make an array content invalid. The tool, activity and reasoning messages do not compose this, because they carry no name.
+ */
+export type BaseMessage = Attributable & {
+ /**
+ * Identifies the message within the conversation.
+ */
+ id: string;
+ /**
+ * Who the message is from. Each message definition narrows this to a single value.
+ */
+ role: string;
+ /**
+ * An optional display name for the author.
+ */
+ name?: string;
+ /**
+ * A provider's opaque artefact belonging to this message, stored by a consumer and returned on a later turn.
+ */
+ encryptedValue?: string;
+ metadata?: Metadata1;
+};
+/**
+ * Instructions from the system.
+ */
+export type SystemMessage = BaseMessage & {
+ role: "system";
+ /**
+ * The instructions. Required.
+ */
+ content: string;
+};
+/**
+ * A message from the agent. Content is optional because a turn may consist only of tool calls.
+ */
+export type AssistantMessage = BaseMessage & {
+ role: "assistant";
+ /**
+ * What the agent said, if it said anything.
+ */
+ content?: string;
+ /**
+ * The tool calls this turn made.
+ */
+ toolCalls?: ToolCall[];
+};
+/**
+ * A message from the person using the application.
+ */
+export type UserMessage = BaseMessage & {
+ role: "user";
+ /**
+ * What the person sent: either plain text, or an ordered list of parts for a multimodal message.
+ */
+ content: string | ContentPart[];
+};
+/**
+ * What a tool returned, as a message in the conversation. Stands alone rather than composing BaseMessage, because it carries no name.
+ */
+export type ToolMessage = Attributable & {
+ /**
+ * Identifies the message.
+ */
+ id: string;
+ /**
+ * Fixed. Declared here rather than inherited, because this message does not compose BaseMessage.
+ */
+ role: "tool";
+ /**
+ * What the tool returned: either plain text, or an ordered list of parts. A tool returning structured data serialises it into text; media travel as parts of their own.
+ */
+ content: string | ContentPart[];
+ /**
+ * The call this answers.
+ */
+ toolCallId: string;
+ /**
+ * Why the tool failed, when it did. Present alongside content rather than instead of it, so a partial result survives a failure.
+ */
+ error?: string;
+ /**
+ * A provider's opaque artefact belonging to this message.
+ */
+ encryptedValue?: string;
+ metadata?: Metadata3;
+};
+/**
+ * Structured progress that is not conversation content, materialised as a message so it keeps its place in the sequence. Stands alone rather than composing BaseMessage, because its content is an object rather than a string.
+ */
+export type ActivityMessage = Attributable & {
+ /**
+ * Identifies the message.
+ */
+ id: string;
+ /**
+ * Fixed. Declared here rather than inherited, because this message does not compose BaseMessage.
+ */
+ role: "activity";
+ /**
+ * What kind of activity this is. An open string: the set is the producer's.
+ */
+ activityType: string;
+ /**
+ * The activity's payload, open by key.
+ */
+ content: {
+ [k: string]: unknown | undefined;
+ };
+ metadata?: Metadata4;
+};
+/**
+ * A span of the agent's reasoning, materialised as a message. Stands alone rather than composing BaseMessage, because it carries no name.
+ */
+export type ReasoningMessage = Attributable & {
+ /**
+ * Identifies the message.
+ */
+ id: string;
+ /**
+ * Fixed. Declared here rather than inherited, because this message does not compose BaseMessage.
+ */
+ role: "reasoning";
+ /**
+ * The reasoning text.
+ */
+ content: string;
+ /**
+ * A provider's opaque reasoning artefact belonging to this message.
+ */
+ encryptedValue?: string;
+ metadata?: Metadata5;
+};
+/**
+ * Reports structured progress that is not conversation content, such as a step a UI renders as its own widget.
+ */
+export type ActivitySnapshotEvent = BaseEvent &
+ Attributable & {
+ type: "ACTIVITY_SNAPSHOT";
+ /**
+ * The activity message this describes.
+ */
+ messageId: string;
+ /**
+ * What kind of activity this is. An open string: the set is the producer's, not the protocol's.
+ */
+ activityType: string;
+ /**
+ * The activity's payload, open by key.
+ */
+ content: {
+ [k: string]: unknown | undefined;
+ };
+ /**
+ * Whether this snapshot overwrites the activity's existing content. Absent means it does, and that meaning is normative; only an explicit false asks a consumer to leave what is already there. It does not ask for a merge — ACTIVITY_DELTA is how content is changed incrementally. What a consumer does with a non-overwriting snapshot is behavioural and belongs in the prose.
+ */
+ replace?: boolean;
+ };
+/**
+ * Changes an activity message's content incrementally.
+ */
+export type ActivityDeltaEvent = BaseEvent &
+ Attributable & {
+ type: "ACTIVITY_DELTA";
+ /**
+ * The activity message being changed.
+ */
+ messageId: string;
+ /**
+ * What kind of activity this is.
+ */
+ activityType: string;
+ patch: JsonPatch1;
+ };
+/**
+ * The change, as an RFC 6902 patch against the activity's content.
+ */
+export type JsonPatch1 = JsonPatchOperation[];
+/**
+ * Passes a provider-native event through untranslated, for consumers that need detail the protocol does not model.
+ */
+export type RawEvent = BaseEvent &
+ Attributable & {
+ type: "RAW";
+ /**
+ * The provider's own event. Any JSON value, and required: an event whose only purpose is to carry this would say nothing without it.
+ */
+ event: {
+ [k: string]: unknown | undefined;
+ };
+ /**
+ * Which provider or framework the event came from.
+ */
+ source?: string;
+ };
+/**
+ * The protocol's extension point for an application's own events. Anything a consumer does with one is outside the protocol.
+ */
+export type CustomEvent = BaseEvent &
+ Attributable & {
+ type: "CUSTOM";
+ /**
+ * What this custom event is. Required: without it a consumer cannot route the value.
+ */
+ name: "ov.sources" | "ov.handoff" | "ov.approval" | "ov.result";
+ /**
+ * The payload. Any JSON value, and required.
+ */
+ value: {
+ [k: string]: unknown | undefined;
+ };
+ };
+/**
+ * Opens a run. Run-scoped, so it carries no subagent attribution.
+ */
+export type RunStartedEvent = BaseEvent & {
+ type: "RUN_STARTED";
+ /**
+ * The conversation this run belongs to.
+ */
+ threadId: string;
+ /**
+ * Identifies this run.
+ */
+ runId: string;
+ /**
+ * The protocol version this producer speaks, such as "1.0" — the producer's own version, not an echo of the input's, which is what makes the pair a negotiation: each side declares itself and the consumer sees a downgrade the moment it happens. Absent means a producer from before the protocol carried a version.
+ */
+ protocolVersion?: string;
+ /**
+ * The run that spawned this one, when an agent invokes another agent as a separate run rather than as a subagent within one.
+ */
+ parentRunId?: string;
+ input?: RunAgentInput;
+};
+/**
+ * Closes a run that did not fail. Run-scoped, so it carries no subagent attribution.
+ */
+export type RunFinishedEvent = BaseEvent & {
+ type: "RUN_FINISHED";
+ /**
+ * The conversation this run belongs to.
+ */
+ threadId: string;
+ /**
+ * The run being closed.
+ */
+ runId: string;
+ /**
+ * The run's return value, if it has one. Any JSON value.
+ */
+ result?: {
+ [k: string]: unknown | undefined;
+ };
+ /**
+ * Why the run ended. Absent means success, so every producer written before outcomes existed is already conformant.
+ */
+ outcome?: RunFinishedSuccessOutcome | RunFinishedInterruptOutcome | RunFinishedCancelledOutcome;
+ /**
+ * Token usage for the run, one entry per provider and model, so a run that invoked several models keeps them separate. A consumer that only wants totals sums across the entries. The run is the accounting boundary: usage covers every model call made within the run, calls made by its subagents included; an agent invoked as a separate run under parentRunId reports its own usage on its own terminal event; and a run that resumes an interrupted one reports only the calls it made itself, not the interrupted run's.
+ */
+ usage?: TokenUsage[];
+};
+/**
+ * Something a run needs from outside before it can continue, such as an approval or a missing value.
+ */
+export type Interrupt = Attributable & {
+ /**
+ * Identifies the interrupt. A resume entry answers it by this id.
+ */
+ id: string;
+ /**
+ * Why the run stopped. An open string rather than an enumeration: the protocol does not attempt to classify every reason an agent might need input.
+ */
+ reason: string;
+ /**
+ * A human-readable prompt for whoever answers.
+ */
+ message?: string;
+ /**
+ * The tool call this interrupt concerns, when it is a tool approval.
+ */
+ toolCallId?: string;
+ /**
+ * A JSON Schema describing the answer this interrupt expects, so a consumer can build a form for it. Carried opaquely: the protocol does not constrain or validate it. Restricted to an object because TypeScript and Python both declare it that way; .NET holds it as any JSON, and the ticket that commissioned this schema lists it among the arbitrary-JSON fields. Following the two that constrain it keeps the schema from accepting documents the reference client rejects, at the cost of rejecting the boolean schemas JSON Schema also permits — a bare true for "any answer". Recorded as a known divergence rather than settled.
+ */
+ responseSchema?: {
+ [k: string]: unknown | undefined;
+ };
+ /**
+ * When the interrupt stops being answerable. Deliberately unconstrained rather than a date-time format, because producers already disagree about the representation and tightening it here would reject streams that work today. The documented convention is ISO 8601, and a consumer comparing this value will parse it as a date, so a value that is not one leaves the interrupt looking permanently unexpired.
+ */
+ expiresAt?: string;
+ metadata?: Metadata8;
+} & {
+ /**
+ * Identifies the interrupt. A resume entry answers it by this id.
+ */
+ id: string;
+ /**
+ * Why the run stopped. An open string rather than an enumeration: the protocol does not attempt to classify every reason an agent might need input.
+ */
+ reason: string;
+ /**
+ * A human-readable prompt for whoever answers.
+ */
+ message?: string;
+ /**
+ * The tool call this interrupt concerns, when it is a tool approval.
+ */
+ toolCallId?: string;
+ /**
+ * A JSON Schema describing the answer this interrupt expects, so a consumer can build a form for it. Carried opaquely: the protocol does not constrain or validate it. Restricted to an object because TypeScript and Python both declare it that way; .NET holds it as any JSON, and the ticket that commissioned this schema lists it among the arbitrary-JSON fields. Following the two that constrain it keeps the schema from accepting documents the reference client rejects, at the cost of rejecting the boolean schemas JSON Schema also permits — a bare true for "any answer". Recorded as a known divergence rather than settled.
+ */
+ responseSchema?: {
+ [k: string]: unknown | undefined;
+ };
+ /**
+ * When the interrupt stops being answerable. Deliberately unconstrained rather than a date-time format, because producers already disagree about the representation and tightening it here would reject streams that work today. The documented convention is ISO 8601, and a consumer comparing this value will parse it as a date, so a value that is not one leaves the interrupt looking permanently unexpired.
+ */
+ expiresAt?: string;
+ metadata?: Metadata8;
+};
+/**
+ * Ends a run that failed. Run-scoped, so it carries no subagent attribution; a subagent that fails without ending the run reports SUBAGENT_ERROR instead.
+ */
+export type RunErrorEvent = BaseEvent & {
+ type: "RUN_ERROR";
+ /**
+ * What went wrong, for a person to read.
+ */
+ message: string;
+ /**
+ * A machine-readable error code. An open string: the protocol defines no vocabulary.
+ */
+ code?: string;
+ /**
+ * Token usage accrued before the failure, for a run that completed one or more model calls before dying. Scoped as on RUN_FINISHED: the run's own calls, subagents included.
+ */
+ usage?: TokenUsage[];
+};
+/**
+ * Opens a named step within a run, for producers whose frameworks have a step concept worth surfacing.
+ */
+export type StepStartedEvent = BaseEvent &
+ Attributable & {
+ type: "STEP_STARTED";
+ /**
+ * The step's name. Identifies it: the matching STEP_FINISHED carries the same name.
+ */
+ stepName: string;
+ };
+/**
+ * Closes a named step.
+ */
+export type StepFinishedEvent = BaseEvent &
+ Attributable & {
+ type: "STEP_FINISHED";
+ /**
+ * The step being closed.
+ */
+ stepName: string;
+ };
+/**
+ * Opens a span of reasoning. A span may contain several reasoning messages.
+ */
+export type ReasoningStartEvent = BaseEvent &
+ Attributable & {
+ type: "REASONING_START";
+ /**
+ * The span being opened.
+ */
+ messageId: string;
+ };
+/**
+ * Opens a streamed reasoning message.
+ */
+export type ReasoningMessageStartEvent = BaseEvent &
+ Attributable & {
+ type: "REASONING_MESSAGE_START";
+ /**
+ * The reasoning message this stream builds.
+ */
+ messageId: string;
+ /**
+ * Fixed, and required rather than defaulted. The requirement is inherited from the SDKs rather than chosen.
+ */
+ role: "reasoning";
+ };
+/**
+ * Appends a fragment to a streamed reasoning message.
+ */
+export type ReasoningMessageContentEvent = BaseEvent &
+ Attributable & {
+ type: "REASONING_MESSAGE_CONTENT";
+ /**
+ * The reasoning message this fragment belongs to.
+ */
+ messageId: string;
+ /**
+ * The fragment to append. May be the empty string.
+ */
+ delta: string;
+ };
+/**
+ * Closes a streamed reasoning message.
+ */
+export type ReasoningMessageEndEvent = BaseEvent &
+ Attributable & {
+ type: "REASONING_MESSAGE_END";
+ /**
+ * The reasoning message being closed.
+ */
+ messageId: string;
+ };
+/**
+ * A shorthand that stands in for a reasoning message's start, content and end sequence.
+ */
+export type ReasoningMessageChunkEvent = BaseEvent &
+ Attributable & {
+ type: "REASONING_MESSAGE_CHUNK";
+ /**
+ * The reasoning message this chunk belongs to. Absent continues the one already open.
+ */
+ messageId?: string;
+ /**
+ * The fragment to append. May be the empty string.
+ */
+ delta?: string;
+ };
+/**
+ * Closes a span of reasoning.
+ */
+export type ReasoningEndEvent = BaseEvent &
+ Attributable & {
+ type: "REASONING_END";
+ /**
+ * The span being closed.
+ */
+ messageId: string;
+ };
+/**
+ * Carries a provider's opaque, encrypted reasoning artefact, which a consumer stores and returns on a later turn without being able to read it.
+ */
+export type ReasoningEncryptedValueEvent = BaseEvent &
+ Attributable & {
+ type: "REASONING_ENCRYPTED_VALUE";
+ /**
+ * What kind of thing entityId names, which decides where the value is stored.
+ */
+ subtype: "tool-call" | "message";
+ /**
+ * What the value belongs to: a message id or a tool call id, according to subtype.
+ */
+ entityId: string;
+ /**
+ * The provider's opaque artefact.
+ */
+ encryptedValue: string;
+ };
+/**
+ * Announces that a subagent invocation has begun. Everything the subagent produces afterwards is attributed by carrying its subagentRunId, so a consumer can group the work without replaying the stream. Composed from BaseEvent alone rather than Attributable, because here subagentRunId identifies the subagent rather than attributing the event to one; attribution to an enclosing subagent is parentSubagentRunId.
+ */
+export type SubagentStartedEvent = BaseEvent & {
+ type: "SUBAGENT_STARTED";
+ /**
+ * The invocation being announced.
+ */
+ subagentRunId: string;
+ /**
+ * The subagent's name, which is reusable across invocations, unlike subagentRunId.
+ */
+ name: string;
+ /**
+ * What this subagent is for, for a consumer to display.
+ */
+ description?: string;
+ /**
+ * The subagent invocation that spawned this one, for nested delegation. Absent means the parent agent spawned it directly.
+ */
+ parentSubagentRunId?: string;
+ /**
+ * The tool call that spawned this subagent, for the pattern where agents are exposed to a model as tools. Lets a consumer tie the subagent to the call without reading rawEvent.
+ */
+ parentToolCallId?: string;
+ /**
+ * The message that held the spawning tool call.
+ */
+ parentMessageId?: string;
+};
+/**
+ * Ends a subagent invocation's segment of this run, either because the work completed or because it is suspended awaiting outside input.
+ */
+export type SubagentFinishedEvent = BaseEvent & {
+ type: "SUBAGENT_FINISHED";
+ /**
+ * The invocation being closed.
+ */
+ subagentRunId: string;
+ /**
+ * The subagent's return value, if it has one. Any JSON value, mirroring RUN_FINISHED.result.
+ */
+ result?: {
+ [k: string]: unknown | undefined;
+ };
+ /**
+ * Why the segment ended. Absent means success. A suspended subagent is neither a success nor a failure, which is why saying so needs its own value rather than being inferred from a later interrupt.
+ */
+ outcome?: SubagentFinishedSuccessOutcome | SubagentFinishedSuspendedOutcome;
+};
+/**
+ * Reports that a subagent invocation failed. The run may continue: a parent agent is free to handle a failed subagent, which is why this is not RUN_ERROR.
+ */
+export type SubagentErrorEvent = BaseEvent & {
+ type: "SUBAGENT_ERROR";
+ /**
+ * The invocation that failed.
+ */
+ subagentRunId: string;
+ /**
+ * What went wrong, for a person to read.
+ */
+ message: string;
+ /**
+ * A machine-readable error code. An open string.
+ */
+ code?: string;
+};
+
+/**
+ * The fields every event carries, whatever its type. Composed into each event definition rather than repeated, so a change here reaches every event at once.
+ */
+export interface BaseEvent {
+ /**
+ * Which event this is. Each event definition narrows this to a single value.
+ */
+ type:
+ | "TEXT_MESSAGE_START"
+ | "TEXT_MESSAGE_CONTENT"
+ | "TEXT_MESSAGE_END"
+ | "TEXT_MESSAGE_CHUNK"
+ | "TOOL_CALL_START"
+ | "TOOL_CALL_ARGS"
+ | "TOOL_CALL_END"
+ | "TOOL_CALL_CHUNK"
+ | "TOOL_CALL_RESULT"
+ | "STATE_SNAPSHOT"
+ | "STATE_DELTA"
+ | "MESSAGES_SNAPSHOT"
+ | "ACTIVITY_SNAPSHOT"
+ | "ACTIVITY_DELTA"
+ | "RAW"
+ | "CUSTOM"
+ | "RUN_STARTED"
+ | "RUN_FINISHED"
+ | "RUN_ERROR"
+ | "STEP_STARTED"
+ | "STEP_FINISHED"
+ | "REASONING_START"
+ | "REASONING_MESSAGE_START"
+ | "REASONING_MESSAGE_CONTENT"
+ | "REASONING_MESSAGE_END"
+ | "REASONING_MESSAGE_CHUNK"
+ | "REASONING_END"
+ | "REASONING_ENCRYPTED_VALUE"
+ | "SUBAGENT_STARTED"
+ | "SUBAGENT_FINISHED"
+ | "SUBAGENT_ERROR";
+ /**
+ * When the event was created. Bounded to the range JSON numbers survive a round trip in, so the value a consumer reads is the value the producer wrote. Deliberately not a float. The unit is not constrained here, because it never has been stated normatively; every SDK that sets it in practice uses milliseconds since the Unix epoch, and a producer choosing another unit will be misread by consumers even though it validates. Nothing in the protocol computes with this value.
+ */
+ timestamp?: number;
+ /**
+ * The provider-native event this one was translated from, carried verbatim for debugging and for consumers that need detail the protocol does not model. Any JSON value.
+ */
+ rawEvent?: {
+ [k: string]: unknown | undefined;
+ };
+ metadata?: Metadata;
+}
+/**
+ * Extra information attached to this event.
+ */
+export interface Metadata {
+ ov?: {
+ title?: string;
+ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";
+ sources?: OvSource[];
+ attachments?: {
+ [k: string]: unknown | undefined;
+ }[];
+ cost_usd?: number | null;
+ needs_you?: {
+ id: string;
+ question: string;
+ /**
+ * @minItems 1
+ */
+ actions: [unknown, ...unknown[]];
+ } | null;
+ product?: string;
+ ref?: string | null;
+ };
+ [k: string]: unknown | undefined;
+}
+export interface OvSource {
+ url: string;
+ title: string;
+ site: string;
+}
+/**
+ * Composed into everything that can belong to a subagent's work: the events that describe content or progress, the message types, and each interrupt. Run-scoped events omit it — RUN_STARTED, RUN_FINISHED and RUN_ERROR describe the run itself and MESSAGES_SNAPSHOT is conversation-wide, so none of them can belong to one subagent. A tool call omits it too and inherits its containing message's attribution.
+ */
+export interface Attributable {
+ /**
+ * The subagent invocation this belongs to. Absent means the parent agent produced it directly.
+ */
+ subagentRunId?: string;
+}
+/**
+ * A text part.
+ */
+export interface TextPart {
+ /**
+ * Discriminator.
+ */
+ type: "text";
+ /**
+ * Identifies this part within its message. Optional, and nothing reads it yet: reserved so that a streamed part can be matched to its entry in history once assistant messages carry parts too.
+ */
+ id?: string;
+ /**
+ * The text.
+ */
+ text: string;
+ /**
+ * Extra information about this part. Unconstrained, as on the media parts. This is where a text search hit carries its source and title, rather than the protocol modelling a search-result part of its own.
+ */
+ metadata?: {
+ [k: string]: unknown | undefined;
+ };
+}
+/**
+ * An image part.
+ */
+export interface ImagePart {
+ /**
+ * Discriminator.
+ */
+ type: "image";
+ /**
+ * Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part.
+ */
+ id?: string;
+ /**
+ * Where the image comes from.
+ */
+ source: DataSource | UrlSource | FileSource;
+ /**
+ * Extra information about this part. Unconstrained rather than an object: inherited from the SDKs, which declare it unknown rather than a record; listed under known divergences in the README rather than resolved here.
+ */
+ metadata?: {
+ [k: string]: unknown | undefined;
+ };
+}
+/**
+ * Bytes carried inline.
+ */
+export interface DataSource {
+ /**
+ * Discriminator.
+ */
+ type: "data";
+ /**
+ * The bytes, base64-encoded. contentEncoding is an annotation rather than a constraint in 2020-12, so a malformed string still validates here; rejecting one is the decoder's job.
+ */
+ value: string;
+ /**
+ * What the bytes are. Required here, unlike on a URL source, because nothing else can tell a consumer how to read them.
+ */
+ mimeType: string;
+}
+/**
+ * Bytes referenced by URL, fetched by whoever needs them.
+ */
+export interface UrlSource {
+ /**
+ * Discriminator.
+ */
+ type: "url";
+ /**
+ * The URL. Deliberately not constrained to a URI format, so a scheme a producer already uses is not rejected here.
+ */
+ value: string;
+ /**
+ * What the resource is, when the producer knows. Optional, because the response can say.
+ */
+ mimeType?: string;
+}
+/**
+ * Bytes already at the provider, named by a handle the provider issued: an OpenAI or Anthropic file id, a Gemini file URI, a storage URL only that provider can read. No bytes travel and nothing is fetched. Only the provider that minted the handle can resolve it; a peer that cannot drops the part as it drops any part it cannot use.
+ */
+export interface FileSource {
+ /**
+ * Discriminator.
+ */
+ type: "file";
+ /**
+ * The handle, exactly as the provider issued it. Opaque: a consumer MUST NOT fetch it, parse it or read a scheme out of it.
+ */
+ value: string;
+ /**
+ * Who issued the handle, when the producer knows. Optional: an agent already knows which provider it talks to. When present, SHOULD be the lowercase vendor id (openai, anthropic, google) that TokenUsage.provider uses, so a peer can tell before sending whether a handle is one it can use.
+ */
+ provider?: string;
+ /**
+ * What the file is, when the producer knows. Optional, because the provider that holds the bytes knows.
+ */
+ mimeType?: string;
+}
+/**
+ * An audio part.
+ */
+export interface AudioPart {
+ /**
+ * Discriminator.
+ */
+ type: "audio";
+ /**
+ * Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part.
+ */
+ id?: string;
+ /**
+ * Where the audio comes from.
+ */
+ source: DataSource | UrlSource | FileSource;
+ /**
+ * Extra information about this part. Unconstrained, as on the other media parts.
+ */
+ metadata?: {
+ [k: string]: unknown | undefined;
+ };
+}
+/**
+ * A video part.
+ */
+export interface VideoPart {
+ /**
+ * Discriminator.
+ */
+ type: "video";
+ /**
+ * Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part.
+ */
+ id?: string;
+ /**
+ * Where the video comes from.
+ */
+ source: DataSource | UrlSource | FileSource;
+ /**
+ * Extra information about this part. Unconstrained, as on the other media parts.
+ */
+ metadata?: {
+ [k: string]: unknown | undefined;
+ };
+}
+/**
+ * A document part.
+ */
+export interface DocumentPart {
+ /**
+ * Discriminator.
+ */
+ type: "document";
+ /**
+ * Identifies this part within its message. Optional, and nothing reads it yet: reserved as on the text part.
+ */
+ id?: string;
+ /**
+ * Where the document comes from.
+ */
+ source: DataSource | UrlSource | FileSource;
+ /**
+ * Extra information about this part. Unconstrained, as on the other media parts.
+ */
+ metadata?: {
+ [k: string]: unknown | undefined;
+ };
+}
+/**
+ * Inserts value at path. RFC 6902 section 4.1.
+ */
+export interface AddOperation {
+ /**
+ * Discriminator for the add operation.
+ */
+ op: "add";
+ /**
+ * Where to insert the value.
+ */
+ path: string;
+ /**
+ * The value to insert. Any JSON value, including null, which is a legitimate thing to add.
+ */
+ value: {
+ [k: string]: unknown | undefined;
+ };
+}
+/**
+ * Removes the value at path. RFC 6902 section 4.2.
+ */
+export interface RemoveOperation {
+ /**
+ * Discriminator for the remove operation.
+ */
+ op: "remove";
+ /**
+ * What to remove.
+ */
+ path: string;
+}
+/**
+ * Replaces the value at path. RFC 6902 section 4.3.
+ */
+export interface ReplaceOperation {
+ /**
+ * Discriminator for the replace operation.
+ */
+ op: "replace";
+ /**
+ * What to replace.
+ */
+ path: string;
+ /**
+ * The replacement. Any JSON value, including null.
+ */
+ value: {
+ [k: string]: unknown | undefined;
+ };
+}
+/**
+ * Moves the value at from to path. RFC 6902 section 4.4.
+ */
+export interface MoveOperation {
+ /**
+ * Discriminator for the move operation.
+ */
+ op: "move";
+ /**
+ * Where the value is moved from.
+ */
+ from: string;
+ /**
+ * Where the value is moved to.
+ */
+ path: string;
+}
+/**
+ * Copies the value at from to path. RFC 6902 section 4.5.
+ */
+export interface CopyOperation {
+ /**
+ * Discriminator for the copy operation.
+ */
+ op: "copy";
+ /**
+ * Where the value is copied from.
+ */
+ from: string;
+ /**
+ * Where the value is copied to.
+ */
+ path: string;
+}
+/**
+ * Asserts that the value at path equals value. RFC 6902 section 4.6.
+ */
+export interface TestOperation {
+ /**
+ * Discriminator for the test operation.
+ */
+ op: "test";
+ /**
+ * What to compare.
+ */
+ path: string;
+ /**
+ * The value the target must equal. Any JSON value, including null.
+ */
+ value: {
+ [k: string]: unknown | undefined;
+ };
+}
+/**
+ * Extra information attached to this message.
+ */
+export interface Metadata1 {
+ ov?: {
+ title?: string;
+ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";
+ sources?: OvSource[];
+ attachments?: {
+ [k: string]: unknown | undefined;
+ }[];
+ cost_usd?: number | null;
+ needs_you?: {
+ id: string;
+ question: string;
+ /**
+ * @minItems 1
+ */
+ actions: [unknown, ...unknown[]];
+ } | null;
+ product?: string;
+ ref?: string | null;
+ };
+ [k: string]: unknown | undefined;
+}
+/**
+ * A call an assistant message made. Carries no subagent attribution of its own and inherits its containing message's, since several calls can share one parent.
+ */
+export interface ToolCall {
+ /**
+ * Identifies the call. The answering tool message carries this as its toolCallId.
+ */
+ id: string;
+ /**
+ * The only kind of call the protocol models.
+ */
+ type: "function";
+ function: FunctionCall;
+ /**
+ * A provider's opaque artefact belonging to this call.
+ */
+ encryptedValue?: string;
+ metadata?: Metadata2;
+}
+/**
+ * What is being called, and with what.
+ */
+export interface FunctionCall {
+ /**
+ * Which tool is being called.
+ */
+ name: string;
+ /**
+ * The arguments as a JSON string, not as parsed JSON. Kept as written because a model can emit arguments that are not valid JSON, and losing them at the protocol boundary would hide the fault from the consumer that has to handle it.
+ */
+ arguments: string;
+}
+/**
+ * Extra information attached to this call. Carried here rather than folded into the containing message, because several calls can share one parent and merging them would make the result depend on their order.
+ */
+export interface Metadata2 {
+ ov?: {
+ title?: string;
+ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";
+ sources?: OvSource[];
+ attachments?: {
+ [k: string]: unknown | undefined;
+ }[];
+ cost_usd?: number | null;
+ needs_you?: {
+ id: string;
+ question: string;
+ /**
+ * @minItems 1
+ */
+ actions: [unknown, ...unknown[]];
+ } | null;
+ product?: string;
+ ref?: string | null;
+ };
+ [k: string]: unknown | undefined;
+}
+/**
+ * Extra information attached to this message.
+ */
+export interface Metadata3 {
+ ov?: {
+ title?: string;
+ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";
+ sources?: OvSource[];
+ attachments?: {
+ [k: string]: unknown | undefined;
+ }[];
+ cost_usd?: number | null;
+ needs_you?: {
+ id: string;
+ question: string;
+ /**
+ * @minItems 1
+ */
+ actions: [unknown, ...unknown[]];
+ } | null;
+ product?: string;
+ ref?: string | null;
+ };
+ [k: string]: unknown | undefined;
+}
+/**
+ * Extra information attached to this message.
+ */
+export interface Metadata4 {
+ ov?: {
+ title?: string;
+ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";
+ sources?: OvSource[];
+ attachments?: {
+ [k: string]: unknown | undefined;
+ }[];
+ cost_usd?: number | null;
+ needs_you?: {
+ id: string;
+ question: string;
+ /**
+ * @minItems 1
+ */
+ actions: [unknown, ...unknown[]];
+ } | null;
+ product?: string;
+ ref?: string | null;
+ };
+ [k: string]: unknown | undefined;
+}
+/**
+ * Extra information attached to this message.
+ */
+export interface Metadata5 {
+ ov?: {
+ title?: string;
+ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";
+ sources?: OvSource[];
+ attachments?: {
+ [k: string]: unknown | undefined;
+ }[];
+ cost_usd?: number | null;
+ needs_you?: {
+ id: string;
+ question: string;
+ /**
+ * @minItems 1
+ */
+ actions: [unknown, ...unknown[]];
+ } | null;
+ product?: string;
+ ref?: string | null;
+ };
+ [k: string]: unknown | undefined;
+}
+/**
+ * The request this run was started from, echoed back so a consumer that did not make the request can still see what the agent was asked.
+ */
+export interface RunAgentInput {
+ /**
+ * The conversation this run belongs to.
+ */
+ threadId: string;
+ /**
+ * Identifies this run.
+ */
+ runId: string;
+ /**
+ * The protocol version this consumer speaks, such as "1.0". Absent means the input was produced before the protocol carried a version — the versioning rules in the prose govern what each side does with that. Sent in-band rather than by the transport, so a recorded exchange stays self-describing.
+ */
+ protocolVersion?: string;
+ /**
+ * The run that spawned this one.
+ */
+ parentRunId?: string;
+ /**
+ * The state the run starts from.
+ */
+ state?: {
+ [k: string]: unknown | undefined;
+ };
+ /**
+ * The conversation so far, in order.
+ */
+ messages: Message[];
+ /**
+ * The tools the agent may call. Absent means none.
+ */
+ tools?: Tool[];
+ /**
+ * Ambient information for the run. Absent means none.
+ */
+ context?: Context[];
+ /**
+ * Application-specific values passed through to the agent untouched. Any JSON value.
+ */
+ forwardedProps?: {
+ [k: string]: unknown | undefined;
+ };
+ /**
+ * Answers to the interrupts that ended a previous run, when this run continues from one.
+ */
+ resume?: ResumeEntry[];
+}
+/**
+ * A tool the agent may call.
+ */
+export interface Tool {
+ /**
+ * The tool's name, as the agent will call it.
+ */
+ name: string;
+ /**
+ * What the tool does, for the agent to decide when to use it.
+ */
+ description: string;
+ /**
+ * A JSON Schema describing the tool's arguments. Carried opaquely: the protocol does not constrain or validate it. Optional, because all three SDKs already treat it that way and a tool that takes no arguments has nothing to declare; an absent schema and an empty one mean the same thing to an agent.
+ */
+ parameters?: {
+ [k: string]: unknown | undefined;
+ };
+ metadata?: Metadata6;
+}
+/**
+ * Extra information about the tool, for consumers that attach their own rendering or routing information to it.
+ */
+export interface Metadata6 {
+ ov?: {
+ title?: string;
+ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";
+ sources?: OvSource[];
+ attachments?: {
+ [k: string]: unknown | undefined;
+ }[];
+ cost_usd?: number | null;
+ needs_you?: {
+ id: string;
+ question: string;
+ /**
+ * @minItems 1
+ */
+ actions: [unknown, ...unknown[]];
+ } | null;
+ product?: string;
+ ref?: string | null;
+ };
+ [k: string]: unknown | undefined;
+}
+/**
+ * A named piece of ambient information given to the agent for the run, distinct from the conversation.
+ */
+export interface Context {
+ /**
+ * What this context is, for the agent to interpret.
+ */
+ description: string;
+ /**
+ * The context itself.
+ */
+ value: string;
+}
+/**
+ * An answer to one interrupt, sent on the run that continues from it.
+ */
+export interface ResumeEntry {
+ /**
+ * The interrupt being answered.
+ */
+ interruptId: string;
+ /**
+ * Whether the interrupt was answered or abandoned.
+ */
+ status: "resolved" | "cancelled";
+ /**
+ * The answer the agent asked for and will act on. Any JSON value.
+ */
+ payload?: {
+ [k: string]: unknown | undefined;
+ };
+ metadata?: Metadata7;
+}
+/**
+ * Envelope information about the response, such as signatures or routing keys, as opposed to payload, which is the answer itself.
+ */
+export interface Metadata7 {
+ ov?: {
+ title?: string;
+ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";
+ sources?: OvSource[];
+ attachments?: {
+ [k: string]: unknown | undefined;
+ }[];
+ cost_usd?: number | null;
+ needs_you?: {
+ id: string;
+ question: string;
+ /**
+ * @minItems 1
+ */
+ actions: [unknown, ...unknown[]];
+ } | null;
+ product?: string;
+ ref?: string | null;
+ };
+ [k: string]: unknown | undefined;
+}
+/**
+ * The run completed. Equivalent to an absent outcome. Closed like every other object, which is also what keeps it from carrying the suspended sibling's interrupts — a success with an interrupt still pending would be a contradiction, not an extension. A completed run may still have left frontend tool calls for the application to answer; pendingToolCallIds names them.
+ */
+export interface RunFinishedSuccessOutcome {
+ /**
+ * Discriminator.
+ */
+ type: "success";
+ /**
+ * The tool calls this run started and left unanswered — no TOOL_CALL_RESULT in the run — for the application to answer in the next input's messages, in the order they were made. Absent or empty means the producer named none, and a consumer derives the list from the stream; otherwise it is the list, and it agrees with the stream. On the success outcome rather than the event because a run that stopped on a frontend tool call is a completed run: whether the application continues the thread is its own decision, so the producer reports what it knows and no more.
+ */
+ pendingToolCallIds?: string[];
+}
+/**
+ * The run is paused, waiting for something outside it. Resuming means starting a new run whose resume entries answer these interrupts.
+ */
+export interface RunFinishedInterruptOutcome {
+ /**
+ * Discriminator.
+ */
+ type: "interrupt";
+ /**
+ * What the run is waiting for. At least one: an interrupt outcome with nothing to answer would leave a consumer with nothing to do.
+ *
+ * @minItems 1
+ */
+ interrupts: [Interrupt, ...Interrupt[]];
+}
+/**
+ * Extra information attached to this interrupt.
+ */
+export interface Metadata8 {
+ ov?: {
+ title?: string;
+ kind?: "search" | "fetch" | "read" | "edit" | "run" | "browse" | "ask" | "think" | "note" | "agent" | "plan";
+ sources?: OvSource[];
+ attachments?: {
+ [k: string]: unknown | undefined;
+ }[];
+ cost_usd?: number | null;
+ needs_you?: {
+ id: string;
+ question: string;
+ /**
+ * @minItems 1
+ */
+ actions: [unknown, ...unknown[]];
+ } | null;
+ product?: string;
+ ref?: string | null;
+ };
+ [k: string]: unknown | undefined;
+}
+/**
+ * The run was stopped before it completed, by whoever was running it, and did not fail. Neither success nor interrupt: nothing was produced as a result, and nothing is waited for, so the next run on the thread is an ordinary new run rather than a resume. Closed like its siblings: a cancelled run has no interrupts to carry. Named in the schema before 1.0 because an outcome a consumer does not recognise is stripped and read as success — a cancellation added later would reach every 1.0 consumer as a completed run.
+ */
+export interface RunFinishedCancelledOutcome {
+ /**
+ * Discriminator.
+ */
+ type: "cancelled";
+}
+/**
+ * Token counts for one provider and model, in the protocol's own accounting: every count is either a total or a named part of one, so entries from different providers add up without double-counting. inputTokens and outputTokens are the totals; reasoningTokens, cachedInputTokens and cacheWriteInputTokens are parts of them, never additions to them; totalTokens is the two totals summed. Every field is a label or a number — nothing content-bearing or identifying, no prompts, completions, messages, or thread, run and user identifiers.
+ */
+export interface TokenUsage {
+ /**
+ * Which provider served the request.
+ */
+ provider?: string;
+ /**
+ * Which model served the request.
+ */
+ model?: string;
+ /**
+ * Every prompt token the call was charged for: tokens read from a provider cache, tokens written to one, and audio or other non-text input all count here. cachedInputTokens and cacheWriteInputTokens break this number down and are never added to it — a provider that reports its cache counts beside a smaller input count has them added in by the producer before the entry leaves. Bounded like timestamp and for the same reason: a count above the JSON safe-integer range does not survive a round trip, so a consumer would silently read a different number than the producer wrote.
+ */
+ inputTokens?: number;
+ /**
+ * Every generated token, reasoning included where the provider distinguishes it. reasoningTokens breaks this number down and is never added to it — a provider that reports reasoning tokens beside a smaller completion count has them added in by the producer.
+ */
+ outputTokens?: number;
+ /**
+ * inputTokens plus outputTokens, under the accounting above. A producer MAY compute it rather than copy a provider's total, and copies a provider's total only when that total counts the same way, so a consumer can read this field as the sum of the other two.
+ */
+ totalTokens?: number;
+ /**
+ * Output tokens spent on reasoning, where the provider distinguishes them. Part of outputTokens, not in addition to it.
+ */
+ reasoningTokens?: number;
+ /**
+ * Input tokens read from a provider cache. Part of inputTokens, not in addition to it, and disjoint from cacheWriteInputTokens.
+ */
+ cachedInputTokens?: number;
+ /**
+ * Input tokens written to a provider cache on this call, where the provider distinguishes them. Part of inputTokens, not in addition to it, and disjoint from cachedInputTokens. Its own field because providers price a cache write differently from a cache read, so a consumer computing cost cannot do without it.
+ */
+ cacheWriteInputTokens?: number;
+}
+/**
+ * The subagent completed its work. Equivalent to an absent outcome.
+ */
+export interface SubagentFinishedSuccessOutcome {
+ /**
+ * Discriminator.
+ */
+ type: "success";
+}
+/**
+ * The subagent is paused awaiting outside input. Terminal for this stream, not for the subagent: a later run may continue the same invocation once the interrupts are answered.
+ */
+export interface SubagentFinishedSuspendedOutcome {
+ /**
+ * Discriminator.
+ */
+ type: "suspended";
+ /**
+ * The run-level interrupts this subagent raised itself. May be empty or absent: a subagent suspended because a descendant interrupted owns no interrupt of its own.
+ */
+ interruptIds?: string[];
+}
+
+/** [email protected] (owner: actor) */
+/**
+ * agent.run@1 snapshot of a run and its current plan, steps, sources, result, timestamps and cost.
+ */
+export interface AgentRun {
+ id: string;
+ product: string;
+ title: string;
+ status: "queued" | "running" | "waiting" | "needs_you" | "succeeded" | "failed" | "stopped" | "cancelled";
+ plan: {
+ title: string;
+ status: "todo" | "running" | "waiting" | "needs_you" | "done" | "failed" | "stopped";
+ }[];
+ steps: {
+ title: string;
+ status: "todo" | "running" | "waiting" | "needs_you" | "done" | "failed" | "stopped";
+ [k: string]: unknown | undefined;
+ }[];
+ sources: {
+ url: string;
+ title: string;
+ site: string;
+ }[];
+ result: {} | null;
+ started_at: string;
+ ended_at: string | null;
+ cost_usd: number | null;
+}
+
+/** [email protected] (owner: actor) */
+/**
+ * actor.agent-sheet@1: one owner-scoped read of an Actor agent's current work, history, approvals, computer, schedules and memory. GET /api/v1/me/agents/:id?view=sheet; never cache this answer.
+ */
+export interface ActorAgentSheet {
+ agent: {
+ id: string;
+ name: string;
+ face: string | null;
+ state: "working" | "idle" | "paused";
+ instructions: string;
+ voice: string | null;
+ [k: string]: unknown | undefined;
+ };
+ now: null | {
+ id: string;
+ task: string;
+ state: string;
+ cost_usd: number;
+ result?: unknown;
+ computer?: unknown;
+ [k: string]: unknown | undefined;
+ };
+ work: {
+ id: string;
+ task: string;
+ state: string;
+ cost_usd: number;
+ result?: unknown;
+ computer?: unknown;
+ [k: string]: unknown | undefined;
+ }[];
+ asks: {
+ id: string;
+ state: string;
+ what: string;
+ why?: string | null;
+ touch?: string | {} | null;
+ [k: string]: unknown | undefined;
+ }[];
+ asks_empty: string | null;
+ computer: null | {
+ url?: string | null;
+ open?: string | null;
+ [k: string]: unknown | undefined;
+ };
+ schedules: {
+ next_run_at?: string | null;
+ last_run_at?: string | null;
+ last_result?: string | null;
+ [k: string]: unknown | undefined;
+ }[];
+ memory: {
+ id: string;
+ text: string;
+ source?: string;
+ [k: string]: unknown | undefined;
+ }[];
+ activity: {
+ [k: string]: unknown | undefined;
+ }[];
+}
+
+/** [email protected] (owner: codes) */
+/**
+ * codes.agent-sheet@1: one owner's coding harness, its real attempts, outcomes and machine availability. Empty memory, schedule and computer sections mean Codes has no such per-harness records. GET /api/v1/me/agents/:id/sheet; never cache this answer.
+ */
+export interface CodesAgentSheet {
+ agent: {
+ id: string;
+ name: string;
+ face: null;
+ state: string;
+ kind: "coding harness";
+ availability: {} | null;
+ };
+ now: null | {
+ id: string;
+ task_id: string;
+ title: string;
+ what: string | null;
+ result: string | null;
+ state: string;
+ outcome: string | null;
+ cost_usd: number | null;
+ machine: string | null;
+ repo: string | null;
+ started_at: string;
+ finished_at: string | null;
+ url: string;
+ };
+ work: {
+ id: string;
+ task_id: string;
+ title: string;
+ what: string | null;
+ result: string | null;
+ state: string;
+ outcome: string | null;
+ cost_usd: number | null;
+ machine: string | null;
+ repo: string | null;
+ started_at: string;
+ finished_at: string | null;
+ url: string;
+ }[];
+ activity: {
+ day: string;
+ entries: {}[];
+ }[];
+ /**
+ * @maxItems 0
+ */
+ asks: [];
+ asks_empty: string;
+ computer: null;
+ /**
+ * @maxItems 0
+ */
+ schedules: [];
+ /**
+ * @maxItems 0
+ */
+ memory: [];
+ identity: {
+ provider: string | null;
+ capabilities: {};
+ };
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,16 @@
@@ -0,0 +1,16 @@
+{
+ "id": "chat.commands.register",
+ "version": "1.0",
+ "owner": "chat",
+ "status": "active",
+ "visibility": "public",
+ "sensitive": true,
+ "description": "Register a slash command in a Chat server where the person authorizing the app is an owner or admin. The Network service token names the approved app or agent in sub, names the person in on_behalf_of, and carries this granted capability. Chat stores the command under that app, refuses built-in names, and executes its plain response template by posting as the person who invoked it with that person's current room rights. This grant never lets an app post as someone else or perform moderation.",
+ "permissions": ["chat:write"],
+ "resourceConstraints": ["owner"],
+ "quotaClass": "chat-write",
+ "events": [],
+ "implementedBy": ["POST /api/chat/commands/registered", "DELETE /api/chat/commands/registered/:name"],
+ "inputSchema": "chat.command-registration-request@1",
+ "outputSchema": "chat.command-registration-result@1"
+}
new file mode 100644
new file mode 100644
@@ -0,0 +1,82 @@
@@ -0,0 +1,82 @@
+{
+ "namespace": "live.layout",
+ "owner": "live",
+ "version": 1,
+ "description": "Where this person put each picture-in-picture on OpenVibe.Live: per stream slot and source, the place, whether it is docked or floating, tucked to a side, muted, and when it last moved. Live keeps a browser copy too; this record follows the person to another device. Private.",
+ "writers": [
+ "owner",
+ "user"
+ ],
+ "publicFields": [],
+ "quotaBytes": 8192,
+ "onOwnerRemoved": "retain-readonly",
+ "schema": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "pip"
+ ],
+ "properties": {
+ "pip": {
+ "type": "object",
+ "maxProperties": 60,
+ "additionalProperties": false,
+ "propertyNames": {
+ "pattern": "^[0-9]{1,12}:[0-9]{1,12}$"
+ },
+ "patternProperties": {
+ "^[0-9]{1,12}:[0-9]{1,12}$": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "x",
+ "y",
+ "w",
+ "mode",
+ "tuck",
+ "muted",
+ "at"
+ ],
+ "properties": {
+ "x": {
+ "type": "number",
+ "minimum": 0,
+ "maximum": 1
+ },
+ "y": {
+ "type": "number",
+ "minimum": 0,
+ "maximum": 1
+ },
+ "w": {
+ "type": "number",
+ "minimum": 0,
+ "maximum": 1
+ },
+ "mode": {
+ "enum": [
+ "dock",
+ "float"
+ ]
+ },
+ "tuck": {
+ "enum": [
+ "left",
+ "right",
+ null
+ ]
+ },
+ "muted": {
+ "type": "boolean"
+ },
+ "at": {
+ "type": "integer",
+ "minimum": 0
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+}
@@ -5,11 +5,11 @@
@@ -5,11 +5,11 @@
"icon": "fa-address-book",
"icon": "fa-address-book",
"accent": "#84cc16",
"accent": "#84cc16",
"tagline": "Directories that keep themselves current",
"tagline": "Directories that keep themselves current",
- "description": "OpenVibe.Directory will be directories that keep themselves current: listings that update themselves instead of going stale. The product is not chartered yet; this address is parked and sends visitors to the network's front door.",
+ "description": "Source-linked directories for OpenVibe sites and tools, AI models and providers, open-source projects, and local businesses from OpenStreetMap. Each entry shows when its sources were last checked.",
"legalProfile": "info",
"legalProfile": "info",
- "launch": "A charter: which directory goes first, what keeps it current, and who answers for stale listings.",
+ "launch": "Public directories, source refresh every six hours, entry pages, search, sitemap, JSON-LD, llms.txt.",
"keywords": "openvibe directory, business directory, self-updating listings, local directory",
"keywords": "openvibe directory, business directory, self-updating listings, local directory",
"relationships": {
"relationships": {
- "noRepo": true
+ "service": "directory"
}
}
}
}
@@ -29,6 +29,7 @@
@@ -29,6 +29,7 @@
"chat.analysis.read",
"chat.analysis.read",
"chat.cache.invalidate",
"chat.cache.invalidate",
"chat.config.manage",
"chat.config.manage",
+ "chat.commands.register",
"chat.event.publish",
"chat.event.publish",
"chat.inbox.manage",
"chat.inbox.manage",
"chat.inbox.read",
"chat.inbox.read",
@@ -44,6 +44,7 @@
@@ -44,6 +44,7 @@
"network.account.deleted",
"network.account.deleted",
"network.account.export_requested",
"network.account.export_requested",
"network.block.changed",
"network.block.changed",
+ "network.user.updated",
"network.user.token_valid_after"
"network.user.token_valid_after"
],
],
"namespacesOwned": [
"namespacesOwned": [
new file mode 100644
new file mode 100644
@@ -0,0 +1,74 @@
@@ -0,0 +1,74 @@
+{
+ "version": "0.1.0",
+ "status": "alpha",
+ "lifecycle": {
+ "liveness": {
+ "endpoint": "/api/health",
+ "means": "the process is up and answers HTTP; it checks nothing else"
+ },
+ "shutdown": {
+ "signal": "SIGTERM",
+ "deadlineSeconds": 10,
+ "drains": [
+ "HTTP server closed"
+ ]
+ },
+ "startupRecovery": {
+ "resumes": [
+ {
+ "kind": "state",
+ "what": "Public sources are re-read at startup and every six hours; the in-memory last good snapshot is retained on transient source failure."
+ }
+ ]
+ },
+ "rollback": {
+ "conditions": [
+ "automatic: ovhost deploy puts the previous sha back and restarts again when the ready URL does not answer 2xx within ready.timeoutSeconds after the restart (exit 3)",
+ "manual: ovhost rollback <service> --to <sha>"
+ ],
+ "window": "automatic only while ovhost waits for readiness after the restart; manual afterwards, as long as no blocker applies",
+ "blockers": {
+ "none": "No database, writes or migrations."
+ }
+ },
+ "contracts": {
+ "range": ">=0.405.0 <1.0.0"
+ },
+ "leases": {
+ "none": "no claims: one process serves the site"
+ }
+ },
+ "id": "directory",
+ "name": "OpenVibe.Directory",
+ "repository": "OpenVibers/OpenVibe.Directory",
+ "domains": [
+ "openvibe.directory"
+ ],
+ "publicOrigin": "https://openvibe.directory",
+ "internalOrigin": "http://127.0.0.1:5281",
+ "health": "/api/health",
+ "ready": "/api/ready",
+ "contractRanges": {
+ "openvibe-contracts": ">=0.405.0 <1.0.0"
+ },
+ "exposure": {
+ "state": "live",
+ "publicSite": "service"
+ },
+ "capabilities": [],
+ "eventsProduced": [],
+ "eventsConsumed": [],
+ "namespacesOwned": [
+ "directory.*"
+ ],
+ "notes": "Public read service. Sources: Network frame, Tools catalog, Compare AI models, GitHub public repositories, and a bounded OpenStreetMap local-business pilot. People listings remain empty until an authenticated opt-in claim flow is available.",
+ "site": {
+ "name": "Directory",
+ "icon": "directory",
+ "tagline": "Directories that keep themselves current",
+ "what": "Source-linked listings with a last checked date.",
+ "legalProfile": "info",
+ "position": 81,
+ "neighbourhood": "make"
+ }
+}
@@ -1,12 +1,12 @@
@@ -1,12 +1,12 @@
{
{
"name": "openvibe-contracts",
"name": "openvibe-contracts",
- "version": "0.404.0",
+ "version": "0.405.0",
"lockfileVersion": 3,
"lockfileVersion": 3,
"requires": true,
"requires": true,
"packages": {
"packages": {
"": {
"": {
"name": "openvibe-contracts",
"name": "openvibe-contracts",
- "version": "0.404.0",
+ "version": "0.405.0",
"license": "AGPL-3.0-only",
"license": "AGPL-3.0-only",
"dependencies": {
"dependencies": {
"ajv": "^8.17.1",
"ajv": "^8.17.1",
@@ -1,6 +1,6 @@
@@ -1,6 +1,6 @@
{
{
"name": "openvibe-contracts",
"name": "openvibe-contracts",
- "version": "0.404.0",
+ "version": "0.405.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",
@@ -85,8 +85,9 @@ function onlyOnce(ts, title, owned, emitted) {
@@ -85,8 +85,9 @@ function onlyOnce(ts, title, owned, emitted) {
const schema = schemas.get(entry.schema);
const schema = schemas.get(entry.schema);
const bundleKey = majors.get(entry.id) > 1 ? `${entry.id}@${entry.version.split('.')[0]}` : entry.id;
const bundleKey = majors.get(entry.id) > 1 ? `${entry.id}@${entry.version.split('.')[0]}` : entry.id;
bundle.contracts[bundleKey] = { version: entry.version, owner: entry.owner, status: entry.status, schema };
bundle.contracts[bundleKey] = { version: entry.version, owner: entry.owner, status: entry.status, schema };
+ // AG-UI's event union references its local protocol definitions from its public types.
const ts = await compile(inlineDefs(schema, file), schema.title, {
const ts = await compile(inlineDefs(schema, file), schema.title, {
- bannerComment: '', cwd: path.dirname(file), declareExternallyReferenced: false,
+ bannerComment: '', cwd: path.dirname(file), declareExternallyReferenced: schema.title === 'AgentUiEvent',
additionalProperties: false, strictIndexSignatures: true, format: true,
additionalProperties: false, strictIndexSignatures: true, format: true,
$refOptions: { resolve: { http: false } },
$refOptions: { resolve: { http: false } },
});
});
new file mode 100644
new file mode 100644
@@ -0,0 +1,21 @@
@@ -0,0 +1,21 @@
+'use strict';
+// Ask 354: validate AG-UI 1.0 event family fixtures and the OpenVibe metadata extension.
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const { execFileSync } = require('node:child_process');
+const contracts = require('..');
+const root = path.join(__dirname, '..', 'fixtures', 'agent.ui-event');
+execFileSync(process.execPath, [path.join(__dirname, '..', 'scripts', 'generate.js'), '--check'], {
+ cwd: path.join(__dirname, '..'), stdio: 'pipe',
+});
+for (const kind of ['valid', 'invalid']) {
+ for (const file of fs.readdirSync(path.join(root, kind)).filter((name) => name.endsWith('.json'))) {
+ const event = JSON.parse(fs.readFileSync(path.join(root, kind, file), 'utf8'));
+ const result = contracts.validate('agent.ui-event@1', event);
+ assert.equal(result.valid, kind === 'valid', `${kind}/${file}: ${JSON.stringify(result.errors || [])}`);
+ }
+}
+const schema = contracts.schema('agent.ui-event@1');
+assert.ok(schema.allOf.some((rule) => rule.required && rule.required.includes('timestamp')), 'every OpenVibe event has the AG-UI epoch timestamp');
+console.log('agent.ui-event: valid and invalid fixtures pass across the eight AG-UI families');
@@ -832,6 +832,16 @@ await assert.rejects(failing.getToken(), /401: invalid_client/);
@@ -832,6 +832,16 @@ await assert.rejects(failing.getToken(), /401: invalid_client/);
ok(JSON.stringify(modules.publicView('live.profile', { followers: 3, stream_minutes_30d: 99 })) === '{"followers":3}', 'public view keeps only public fields');
ok(JSON.stringify(modules.publicView('live.profile', { followers: 3, stream_minutes_30d: 99 })) === '{"followers":3}', 'public view keeps only public fields');
ok(modules.canWrite('chat.preferences', { type: 'user' }) && !modules.canWrite('live.profile', { type: 'user' }), 'user write follows writers');
ok(modules.canWrite('chat.preferences', { type: 'user' }) && !modules.canWrite('live.profile', { type: 'user' }), 'user write follows writers');
ok(modules.canWrite('live.profile', { type: 'service', id: 'live' }) && !modules.canWrite('live.profile', { type: 'service', id: 'tools' }), 'only the owning service writes');
ok(modules.canWrite('live.profile', { type: 'service', id: 'live' }) && !modules.canWrite('live.profile', { type: 'service', id: 'tools' }), 'only the owning service writes');
+
+ // live.layout: where a person put each picture-in-picture, kept in their account (Live's /api/me/layout).
+ const place = { x: 0.72, y: 0.7, w: 0.25, mode: 'dock', tuck: null, muted: true, at: 1760000000000 };
+ const layout = (pip) => ({ pip });
+ ok(modules.validateData('live.layout', layout({ '12:34': place })).valid, 'live.layout takes a place per slot and source');
+ ok(modules.validateData('live.layout', layout({ '12:34': { ...place, mode: 'float', tuck: 'left' } })).valid, 'a floating, tucked place is valid');
+ ok(!modules.validateData('live.layout', layout({ 'slot:source': place })).valid, 'a place key that is not <slot>:<source> is refused');
+ ok(!modules.validateData('live.layout', layout({ '12:34': { ...place, x: 1.2 } })).valid, 'a place outside the frame is refused');
+ ok(!modules.validateData('live.layout', layout({ '12:34': { ...place, extra: 1 } })).valid, 'an unknown field is refused');
+ ok(!modules.validateData('live.layout', layout(Object.fromEntries(Array.from({ length: 61 }, (_, i) => [`1:${i}`, place])))).valid, 'more than 60 places is refused');
}
}
// ── openvibe-contracts-check (the CLI services run in CI) ─────────────────
// ── openvibe-contracts-check (the CLI services run in CI) ─────────────────
@@ -1009,6 +1019,7 @@ sub(path.join(__dirname, 'resources.test.js'));
@@ -1009,6 +1019,7 @@ sub(path.join(__dirname, 'resources.test.js'));
sub(path.join(__dirname, 'actor-wait.test.js'));
sub(path.join(__dirname, 'actor-wait.test.js'));
sub(path.join(__dirname, 'actor-ask.test.js'));
sub(path.join(__dirname, 'actor-ask.test.js'));
sub(path.join(__dirname, 'batching-latency.test.js'));
sub(path.join(__dirname, 'batching-latency.test.js'));
+sub(path.join(__dirname, 'agent-ui-event.test.js'));
sub(path.join(__dirname, 'network-consent.test.js'));
sub(path.join(__dirname, 'network-consent.test.js'));
// The machines hub (plan L34): one catalogue of roles, declared by the products that own them.
// The machines hub (plan L34): one catalogue of roles, declared by the products that own them.
sub(path.join(__dirname, 'machines.test.js'));
sub(path.join(__dirname, 'machines.test.js'));