From 8c90cb36df7338ef635e1ed1c46ada9cef56d6ed Mon Sep 17 00:00:00 2001 From: Nathan Flurry Date: Thu, 29 Jan 2026 09:00:04 -0800 Subject: [PATCH] docs: clarify session event coverage page --- README.md | 29 +---------------------------- docs/agent-compatibility.mdx | 15 +++++++++------ 2 files changed, 10 insertions(+), 34 deletions(-) diff --git a/README.md b/README.md index c36e2ef..38d0a18 100644 --- a/README.md +++ b/README.md @@ -17,34 +17,7 @@ [Documentation](https://sandboxagent.dev/docs) — [Discord](https://rivet.dev/discord) -## Universal Schema Support - -Which agent features are normalized into the universal event schema. All agents have full native capabilities; this shows what's exposed via the API. - -| Feature | Claude | Codex | OpenCode | Amp | -|--------------------|:------:|:-----:|:------------:|:------------:| -| Stability | Stable | Stable| Experimental | Experimental | -| Text Messages | ✓ | ✓ | ✓ | ✓ | -| Tool Calls | ✓ | ✓ | ✓ | ✓ | -| Tool Results | ✓ | ✓ | ✓ | ✓ | -| Questions (HITL) | ✓ | | ✓ | | -| Permissions (HITL) | ✓ | ✓ | ✓ | - | -| Images | - | ✓ | ✓ | - | -| File Attachments | - | ✓ | ✓ | - | -| Session Lifecycle | - | ✓ | ✓ | - | -| Error Events | - | ✓ | ✓ | ✓ | -| Reasoning/Thinking | - | ✓ | | | -| Command Execution | - | ✓ | | | -| File Changes | - | ✓ | | | -| MCP Tools | - | ✓ | | | -| Streaming Deltas | ✓ | ✓ | ✓ | - | - -Agents: [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) · [Codex](https://github.com/openai/codex) · [OpenCode](https://github.com/opencode-ai/opencode) · [Amp](https://ampcode.com) - -- ✓ = Supported in universal schema -- \- = Schema support in progress - -Want support for another agent? [Open an issue](https://github.com/rivet-dev/sandbox-agent/issues/new) to request it. +Want support for another agent or sandbox provider? [Open an issue](https://github.com/rivet-dev/sandbox-agent/issues/new) to request it. ## Architecture diff --git a/docs/agent-compatibility.mdx b/docs/agent-compatibility.mdx index 47ab7a8..13222a4 100644 --- a/docs/agent-compatibility.mdx +++ b/docs/agent-compatibility.mdx @@ -1,12 +1,14 @@ --- -title: "Universal Schema Support" -description: "Which agent features are exposed through the universal API." +title: "Session Event Coverage" +description: "What appears in your session transcript for each agent." icon: "table" --- -The universal API normalizes different coding agents into a consistent interface. All agents have full native capabilities; this page shows what's exposed via the sandbox-agent API. +Each coding agent outputs events in its own native format. The sandbox-agent converts these into a [universal event schema](/docs/universal-schema), giving you a consistent session transcript regardless of which agent you use. -## Feature Matrix +This page shows which agent capabilities appear in the universal event stream. All agents retain their full native capabilities—this only reflects what's normalized into the universal schema. + +## Coverage Matrix | Feature | Claude | Codex | OpenCode | Amp | |--------------------|:------:|:-----:|:------------:|:------------:| @@ -28,8 +30,9 @@ The universal API normalizes different coding agents into a consistent interface Agents: [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) · [Codex](https://github.com/openai/codex) · [OpenCode](https://github.com/opencode-ai/opencode) · [Amp](https://ampcode.com) -- ✓ = Supported in universal schema -- \- = Schema support in progress +- ✓ = Appears in session events +- \- = Agent supports natively, schema conversion coming soon +- (blank) = Not supported by agent ## Feature Descriptions