Waxell · Schema

Waxell Run

A single agent execution run captured by the Waxell Observe control plane.

AI Agent GovernanceObservabilityPolicy EnforcementLLM TelemetryCost ManagementMCPAgent Runtime

Properties

Name	Type	Description
run_id	string	Stable identifier issued when the run is started.
agent_name	string	Name passed to @waxell.observe(agent_name=...).
status	string	Current lifecycle state of the run.
session_id	string
user_id	string
started_at	string
completed_at	string
total_tokens	integer
total_cost_usd	number
metadata	object

View JSON Schema on GitHub

JSON Schema

{
  "$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
}