CodesAgentSheet codes.agent-sheet@1

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

Version
1.0.0
Owner
codes
Visibility
public
Status
active
Compatibility
backward
Schema
https://openvibe.network/contracts/codes/agent-sheet.v1.json

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.

Fields

FieldTypeRequiredDescriptionConstraints
agentobjectyes
  • no other fields
agent.idstringyes
agent.namestringyes
agent.facenullyes
agent.statestringyes
agent.kindconstyes
  • = "coding harness"
agent.availabilityobject | nullyes
nowone ofyes
workhttps://openvibe.network/contracts/codes/agent-sheet.v1.json#/$defs/workyes
activityarray of objectyes
  • items: no other fields
activity[].daystringyes
  • format date
activity[].entriesarray of objectyes
asksarrayyes
  • maxItems 0
asks_emptystringyes
computernullyes
schedulesarrayyes
  • maxItems 0
memoryarrayyes
  • maxItems 0
identityobjectyes
  • no other fields
identity.providerstring | nullyes
identity.capabilitiesobjectyes

Examples

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

Valid: idle
{
  "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": {}
  }
}
Rejected: pretend-memory
{
  "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": {}
  }
}

Validate

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