HUD · Schema
TraceEventsResponse
CompanyArtificial IntelligenceReinforcement LearningAI EvaluationAI AgentsBenchmarksMachine LearningTraining Data
Properties
| Name | Type | Description |
|---|---|---|
| events | array | |
| latest_seq | integer | |
| next_seq | integer | |
| has_more | boolean | |
| status | string | |
| reward | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/hud-ai/json-schema/hud-ai-trace-events-response-schema.json",
"title": "TraceEventsResponse",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/hud-ai-qa-agents-api-openapi.yml#/components/schemas/TraceEventsResponse",
"properties": {
"events": {
"items": {
"oneOf": [
{
"$ref": "#/$defs/UserMessageEvent"
},
{
"$ref": "#/$defs/AgentMessageEvent"
},
{
"$ref": "#/$defs/ToolCallEvent"
},
{
"$ref": "#/$defs/ScenarioEvent"
},
{
"$ref": "#/$defs/SubagentEvent"
},
{
"$ref": "#/$defs/ObservationEvent"
},
{
"$ref": "#/$defs/InferenceEvent"
},
{
"$ref": "#/$defs/VideoSegmentEvent"
},
{
"$ref": "#/$defs/FileSnapshotEvent"
},
{
"$ref": "#/$defs/FileSetupEvent"
},
{
"$ref": "#/$defs/FileChangeEvent"
},
{
"$ref": "#/$defs/FileCaptureEvent"
},
{
"$ref": "#/$defs/RawEvent"
}
]
},
"type": "array",
"title": "Events"
},
"latest_seq": {
"type": "integer",
"title": "Latest Seq"
},
"next_seq": {
"type": "integer",
"title": "Next Seq"
},
"has_more": {
"type": "boolean",
"title": "Has More"
},
"status": {
"type": "string",
"title": "Status"
},
"reward": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Reward"
}
},
"type": "object",
"required": [
"events",
"latest_seq",
"next_seq",
"has_more",
"status"
],
"$defs": {
"AgentMessageEvent": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"started_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Started At"
},
"ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ended At"
},
"seq": {
"type": "integer",
"title": "Seq",
"default": 0
},
"kind": {
"type": "string",
"const": "agent_message",
"title": "Kind"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Text"
},
"reasoning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reasoning"
},
"tool_calls": {
"items": {
"$ref": "#/$defs/AgentToolCall"
},
"type": "array",
"title": "Tool Calls",
"default": []
},
"finish_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Finish Reason"
},
"refusal": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Refusal"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"id",
"kind"
],
"title": "AgentMessageEvent"
},
"AgentToolCall": {
"properties": {
"tool_call_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Tool Call Id"
},
"name": {
"type": "string",
"title": "Name"
},
"arguments": {
"additionalProperties": true,
"type": "object",
"title": "Arguments",
"default": {}
},
"subagent_event_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Subagent Event Id"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"name"
],
"title": "AgentToolCall",
"description": "A tool invocation embedded inside an assistant message.\n\nDistinct from ``ToolCallEvent``: this is the *intent* the agent surfaced\nin its response, before the MCP call actually happened. The matching\n``ToolCallEvent`` carries the result."
},
"CapturedFile": {
"properties": {
"path": {
"type": "string",
"title": "Path"
},
"status": {
"type": "string",
"enum": [
"added",
"modified"
],
"title": "Status"
},
"size": {
"type": "integer",
"title": "Size"
},
"content_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Content Hash"
},
"content_type": {
"type": "string",
"title": "Content Type",
"default": "application/octet-stream"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
},
"download_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Download Url"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"path",
"status",
"size"
],
"title": "CapturedFile",
"description": "One changed workspace file preserved as a downloadable telemetry artifact."
},
"FileCaptureEvent": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"started_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Started At"
},
"ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ended At"
},
"seq": {
"type": "integer",
"title": "Seq",
"default": 0
},
"kind": {
"type": "string",
"const": "file_capture",
"title": "Kind"
},
"files_scanned": {
"type": "integer",
"title": "Files Scanned",
"default": 0
},
"files_changed": {
"type": "integer",
"title": "Files Changed",
"default": 0
},
"files_eligible": {
"type": "integer",
"title": "Files Eligible",
"default": 0
},
"files_captured": {
"type": "integer",
"title": "Files Captured",
"default": 0
},
"files_skipped": {
"type": "integer",
"title": "Files Skipped",
"default": 0
},
"truncated": {
"type": "boolean",
"title": "Truncated",
"default": false
},
"files": {
"items": {
"$ref": "#/$defs/CapturedFile"
},
"type": "array",
"title": "Files",
"default": []
}
},
"additionalProperties": false,
"type": "object",
"required": [
"id",
"kind"
],
"title": "FileCaptureEvent",
"description": "Final changed-file artifacts captured from ``filetracking.capture``."
},
"FileChangeEvent": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"started_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Started At"
},
"ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ended At"
},
"seq": {
"type": "integer",
"title": "Seq",
"default": 0
},
"kind": {
"type": "string",
"const": "file_change",
"title": "Kind"
},
"files_scanned": {
"type": "integer",
"title": "Files Scanned",
"default": 0
},
"files_changed": {
"type": "integer",
"title": "Files Changed",
"default": 0
},
"truncated": {
"type": "boolean",
"title": "Truncated",
"default": false
},
"patches": {
"items": {
"$ref": "#/$defs/FilePatch"
},
"type": "array",
"title": "Patches",
"default": []
}
},
"additionalProperties": false,
"type": "object",
"required": [
"id",
"kind"
],
"title": "FileChangeEvent",
"description": "A workspace diff captured between steps.\n\nProjected from ``filetracking.diff`` under ``hud.filetracking.v1``: the\nfiles that changed since the previous scan.\n\nInterleaves with tool/agent events by ``seq``/time; correlate to the step\ntimeline by ``started_at``. ``truncated`` marks a big diff capped over the\nper-scan budget (e.g. an ``npm install`` / ``git checkout``)."
},
"FileManifestEntry": {
"properties": {
"path": {
"type": "string",
"title": "Path"
},
"size": {
"type": "integer",
"title": "Size",
"default": 0
},
"content_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Content Hash"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"path"
],
"title": "FileManifestEntry",
"description": "One file in a workspace snapshot manifest: path + size + content hash.\n\nThe manifest carries identity, not content. The viewer derives unchanged\ncontent from immutable build source and applies setup changes separately."
},
"FilePatch": {
"properties": {
"path": {
"type": "string",
"title": "Path"
},
"status": {
"type": "string",
"enum": [
"added",
"modified",
"deleted"
],
"title": "Status"
},
"patch": {
"type": "string",
"title": "Patch",
"default": ""
},
"size_before": {
"type": "integer",
"title": "Size Before",
"default": 0
},
"size_after": {
"type": "integer",
"title": "Size After",
"default": 0
},
"content_hash_before": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Content Hash Before"
},
"content_hash_after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Content Hash After"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"path",
"status"
],
"title": "FilePatch",
"description": "A unified-diff patch for one file in a workspace change.\n\nByte-identical to the legacy ``tool_call.result_data.file_diff`` patch shape\nso the frontend's existing diff parsing/reconstruction ports unchanged.\n``patch`` may be a placeholder string for over-cap files when ``truncated``."
},
"FileSetupEvent": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"started_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Started At"
},
"ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ended At"
},
"seq": {
"type": "integer",
"title": "Seq",
"default": 0
},
"kind": {
"type": "string",
"const": "file_setup",
"title": "Kind"
},
"files_scanned": {
"type": "integer",
"title": "Files Scanned",
"default": 0
},
"files_changed": {
"type": "integer",
"title": "Files Changed",
"default": 0
},
"truncated": {
"type": "boolean",
"title": "Truncated",
"default": false
},
"patches": {
"items": {
"$ref": "#/$defs/FilePatch"
},
"type": "array",
"title": "Patches",
"default": []
}
},
"additionalProperties": false,
"type": "object",
"required": [
"id",
"kind"
],
"title": "FileSetupEvent",
"description": "Workspace changes made by scenario setup before the agent starts."
},
"FileSnapshotEvent": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"started_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Started At"
},
"ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ended At"
},
"seq": {
"type": "integer",
"title": "Seq",
"default": 0
},
"kind": {
"type": "string",
"const": "file_snapshot",
"title": "Kind"
},
"files_scanned": {
"type": "integer",
"title": "Files Scanned",
"default": 0
},
"truncated": {
"type": "boolean",
"title": "Truncated",
"default": false
},
"files": {
"items": {
"$ref": "#/$defs/FileManifestEntry"
},
"type": "array",
"title": "Files",
"default": []
}
},
"additionalProperties": false,
"type": "object",
"required": [
"id",
"kind"
],
"title": "FileSnapshotEvent",
"description": "A post-setup workspace manifest of paths + hashes captured before the agent starts.\n\nEmitted as ``filetracking.snapshot`` under ``hud.filetracking.v1``.\n\nBuild source plus :class:`FileSetupEvent` patches derive this state; applying\nsubsequent :class:`FileChangeEvent` patches reconstructs the agent timeline."
},
"InferenceEvent": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"started_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Started At"
},
"ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ended At"
},
"seq": {
"type": "integer",
"title": "Seq",
"default": 0
},
"kind": {
"type": "string",
"const": "robot_inference",
"title": "Kind"
},
"tick": {
"type": "integer",
"title": "Tick",
"default": 0
},
"chunk": {
"items": {
"items": {
"type": "number"
},
"type": "array"
},
"type": "array",
"title": "Chunk",
"default": []
},
"chunk_length": {
"type": "integer",
"title": "Chunk Length",
"default": 1
},
"names": {
"items": {
"type": "string"
},
"type": "array",
"title": "Names",
"default": []
}
},
"additionalProperties": false,
"type": "object",
"required": [
"id",
"kind"
],
"title": "InferenceEvent",
"description": "One robot inference (``step.inference`` under ``hud.robot.step.v1``).\n\nCarries the ``[T, A]`` action chunk the policy produced at a re-infer\n``tick``.\n\nEmitted only on re-infer ticks (a chunk boundary), so it marks the\ndecision points the viewer renders on its episode slider. ``tick`` matches\nthe paired :class:`ObservationEvent`."
},
"ObservationEvent": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"started_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Started At"
},
"ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ended At"
},
"seq": {
"type": "integer",
"title": "Seq",
"default": 0
},
"kind": {
"type": "string",
"const": "robot_observation",
"title": "Kind"
},
"tick": {
"type": "integer",
"title": "Tick",
"default": 0
},
"state": {
"additionalProperties": {
"$ref": "#/$defs/StateFeature"
},
"type": "object",
"title": "State",
"default": {}
}
},
"additionalProperties": false,
"type": "object",
"required": [
"id",
"kind"
],
"title": "ObservationEvent",
"description": "One robot observation tick (``step.observation`` under ``hud.robot.step.v1``):\n\nthe numeric state the policy saw at ``tick`` (camera frames travel as\n``VideoSegmentEvent`` streams).\n\n``state`` maps each env-contract feature group -> its :class:`StateFeature`\n(per-dim names + values). Pairs with the :class:`InferenceEvent` at the\nsame ``tick``."
},
"RawEvent": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"started_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Started At"
},
"ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ended At"
},
"seq": {
"type": "integer",
"title": "Seq",
"default": 0
},
"kind": {
"type": "string",
"const": "raw",
"title": "Kind"
},
"category": {
"type": "string",
"title": "Category"
},
"name": {
"type": "string",
"title": "Name"
},
"attributes": {
"additionalProperties": true,
"type": "object",
"title": "Attributes",
"default": {}
}
},
"additionalProperties": false,
"type": "object",
"required": [
"id",
"kind",
"category",
"name"
],
"title": "RawEvent",
"description": "Fallback for spans we don't know how to project.\n\nCovers new SDK categories and custom user @instrument calls. Kept so the\nviewer can still display *something* without dropping data."
},
"ScenarioEvent": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"started_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Started At"
},
"ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ended At"
},
"seq": {
"type": "integer",
"title": "Seq",
"default": 0
},
"kind": {
"type": "string",
"enum": [
"scenario_setup",
"scenario_evaluate"
],
"title": "Kind"
},
"name": {
"type": "string",
"title": "Name"
},
"arguments": {
"additionalProperties": true,
"type": "object",
"title": "Arguments",
"default": {}
},
"result": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Result"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"id",
"kind",
"name"
],
"title": "ScenarioEvent",
"description": "A task-lifecycle RPC (``tasks.start`` / ``tasks.grade``).\n\nProjected from the ``task``-sourced step the SDK harness records around the\nrun. Kept under the legacy ``scenario_*`` kinds the viewer consumes."
},
"StateFeature": {
"properties": {
"names": {
"items": {
"type": "string"
},
"type": "array",
"title": "Names",
"default": []
},
"values": {
"items": {
"type": "number"
},
"type": "array",
"title": "Values",
"default": []
}
},
"additionalProperties": false,
"type": "object",
"title": "StateFeature",
"description": "One observation feature group: per-dimension labels + values."
},
"SubagentEvent": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"started_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Started At"
},
"ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ended At"
},
"seq": {
"type": "integer",
"title": "Seq",
"default": 0
},
"kind": {
"type": "string",
"const": "subagent",
"title": "Kind"
},
"agent_name": {
"type": "string",
"title": "Agent Name"
},
"arguments": {
"additionalProperties": true,
"type": "object",
"title": "Arguments",
"default": {}
},
"result": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Result"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"id",
"kind",
"agent_name"
],
"title": "SubagentEvent",
"description": "A nested-agent invocation (one ``AgentTool.__call__``)."
},
"ToolCallEvent": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"started_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Started At"
},
"ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ended At"
},
"seq": {
"type": "integer",
"title": "Seq",
"default": 0
},
"kind": {
"type": "string",
"const": "tool_call",
"title": "Kind"
},
"method": {
"type": "string",
"title": "Method"
},
"tool_call_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Tool Call Id"
},
"tool_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Tool Name"
},
"arguments": {
"additionalProperties": true,
"type": "object",
"title": "Arguments",
"default": {}
},
"result_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Result Text"
},
"result_data": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Result Data"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error"
},
"is_screenshot": {
"type": "boolean",
"title": "Is Screenshot",
"default": false
},
"screenshot_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Screenshot Url"
},
"screenshot_urls": {
"items": {
"type": "string"
},
"type": "array",
"title": "Screenshot Urls",
"default": []
}
},
"additionalProperties": false,
"type": "object",
"required": [
"id",
"kind",
"method"
],
"title": "ToolCallEvent",
"description": "A single MCP tool call with its result merged in.\n\nMirrors what FastMCP returns: ``result_data`` preserves\n``structuredContent`` when present; otherwise text content is unwrapped\ninto ``result_text`` so renderers don't have to dig."
},
"UserMessageEvent": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parent Id"
},
"started_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Started At"
},
"ended_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ended At"
},
"seq": {
"type": "integer",
"title": "Seq",
"default": 0
},
"kind": {
"type": "string",
"const": "user_message",
"title": "Kind"
},
"text": {
"type": "string",
"title":
# --- truncated at 32 KB (34 KB total) ---
# Full source: https://artifacts.apis.io/hud-ai/json-schema/hud-ai-trace-events-response-schema.json
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/hud-ai-trace-events-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.