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
View JSON Schema on GitHub

JSON Schema

hud-ai-trace-events-response-schema.json Raw ↑
{
  "$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.
All 92 tools →

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.