AgentsRunUpdatedPayload agents.run.updated@1

Generated at from openvibe-contracts v0.419.0 and openvibe-sdk v0.161.0.

Version
1.0.0
Owner
actor
Visibility
first-party
Status
active
Compatibility
backward
Decision
ADR-044
Schema
https://openvibe.network/contracts/events/payloads/agents.run.updated.v1.json

agents.run.updated v1 (agent-engine.md, 2026-11-12). A run changed in a way a list shows: it started, its status, title, doing, waiting or preview changed, or it ended. The payload is the run's agents.run@1 snapshot, whole. OpenVibe.Events carries it with the run's owner as the subject, the product that stores it as the source and visibility subject, so the person's run list anywhere stays current without polling. A step is agents.step.appended; this event is not sent for every step, only when the snapshot a list draws changed (at most about once a second per run).

Fields

This schema has no named fields.

Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

Valid: a-chat-waiting
{
  "id": "c_8f3k2m",
  "ref": "chat:c_8f3k2m",
  "kind": "chat",
  "title": "Keyboard Scout",
  "owner": {
    "type": "user",
    "id": "usr_01K9R2V6M8Q4T0B7C3D5E9F2GH"
  },
  "agent": {
    "id": "vibe",
    "name": "Keyboard Scout",
    "product": "chat",
    "glyph": "search",
    "hue": 212,
    "harness": "openvibe"
  },
  "status": "waiting",
  "waiting": {
    "for": "message",
    "since": "2026-11-12T10:02:00Z"
  },
  "preview": {
    "text": "Three picks under $90, with sources.",
    "from": "agent",
    "at": "2026-11-12T10:02:00Z"
  },
  "model": {
    "id": "openvibe/auto",
    "source": "openvibe",
    "name": "Auto"
  },
  "where": {
    "kind": "openvibe"
  },
  "context": {
    "site": "deals",
    "url": "https://openvibe.deals/",
    "title": "Deals"
  },
  "url": "https://openvibe.chat/vibe/c_8f3k2m",
  "counts": {
    "steps": 6,
    "unread": 1
  },
  "visibility": "private",
  "created_at": "2026-11-12T10:00:00Z",
  "updated_at": "2026-11-12T10:02:00Z"
}
Rejected: no-status
{
  "id": "c_8f3k2m",
  "ref": "chat:c_8f3k2m",
  "kind": "chat",
  "title": "Keyboard Scout",
  "owner": {
    "type": "user",
    "id": "usr_01K9R2V6M8Q4T0B7C3D5E9F2GH"
  },
  "agent": {
    "id": "vibe",
    "name": "Keyboard Scout",
    "product": "chat",
    "glyph": "search",
    "hue": 212,
    "harness": "openvibe"
  },
  "waiting": {
    "for": "message",
    "since": "2026-11-12T10:02:00Z"
  },
  "preview": {
    "text": "Three picks under $90, with sources.",
    "from": "agent",
    "at": "2026-11-12T10:02:00Z"
  },
  "model": {
    "id": "openvibe/auto",
    "source": "openvibe",
    "name": "Auto"
  },
  "where": {
    "kind": "openvibe"
  },
  "context": {
    "site": "deals",
    "url": "https://openvibe.deals/",
    "title": "Deals"
  },
  "url": "https://openvibe.chat/vibe/c_8f3k2m",
  "counts": {
    "steps": 6,
    "unread": 1
  },
  "visibility": "private",
  "created_at": "2026-11-12T10:00:00Z",
  "updated_at": "2026-11-12T10:02:00Z"
}

Validate

const contracts = require('openvibe-contracts');
contracts.validate('agents.run.updated@1', value);   // { valid, errors: [{ path, message }] }