{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/waxell/main/json-schema/waxell-run-schema.json",
  "title": "Waxell Run",
  "description": "A single agent execution run captured by the Waxell Observe control plane.",
  "type": "object",
  "required": ["run_id", "agent_name", "status"],
  "properties": {
    "run_id": {
      "type": "string",
      "format": "uuid",
      "description": "Stable identifier issued when the run is started."
    },
    "agent_name": {
      "type": "string",
      "description": "Name passed to @waxell.observe(agent_name=...)."
    },
    "status": {
      "type": "string",
      "enum": ["pending", "running", "paused", "completed", "failed"],
      "description": "Current lifecycle state of the run."
    },
    "session_id": { "type": "string" },
    "user_id": { "type": "string" },
    "started_at": { "type": "string", "format": "date-time" },
    "completed_at": { "type": "string", "format": "date-time" },
    "total_tokens": { "type": "integer", "minimum": 0 },
    "total_cost_usd": { "type": "number", "minimum": 0 },
    "metadata": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "additionalProperties": false
}