Skip to main content

Schema explorer

Use this utility page when you need the raw JSON schema files or want to regenerate the Markdown that lands in the docs. It keeps the interactive experience separate from the JSON Schemas & Contracts docso contributors can tell which route they are hitting.

Regenerate the Markdown bundle

Run the docs helper to sync the Markdown copies that power the reference site:

pnpm -C docs run generate:schemas

Schema sources

  • api/schemas/run_spec.json – Run spec
  • api/schemas/run_event.json – Run event
  • api/schemas/capability_token.json – Capability token
  • api/schemas/agent_run.json – Agent run
  • api/schemas/artifact.json – Artifact
  • api/schemas/step.json – Step snapshot

Prefer prose or compatibility notes? Head back to the JSON Schemas & Contracts doc. When the live explorer ships, this route will host it without clashing with the doc permalink.