sandbox-agent/examples/CLAUDE.md

Examples Instructions

Docker Isolation

• Docker examples must behave like standalone sandboxes.
• Do not bind mount host files or host directories into Docker example containers.
• If an example needs tools, skills, or MCP servers, install them inside the container during setup.

Testing Examples (ACP v1)

Examples should be validated against v1 endpoints:

1. Start the example: SANDBOX_AGENT_DEV=1 pnpm start
2. Pick a server id, for example example-smoke.
3. Create ACP transport by POSTing initialize to /v1/acp/example-smoke?agent=mock (or another installed agent).
4. Open SSE stream: GET /v1/acp/example-smoke.
5. Send session/new then session/prompt via POST /v1/acp/example-smoke.
6. Close connection via DELETE /v1/acp/example-smoke.

v1 reminder:

• /v1/* is removed and returns 410 Gone.