harivansh-afk/sandbox-agent
1
0
Fork 0
mirror of https://github.com/harivansh-afk/sandbox-agent.git synced 2026-04-21 21:04:04 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

acp spec (#155)

Browse source
This commit is contained in:
NathanFlurry 2026-02-11 14:47:41 +00:00
parent 70287ec471
commit e72eb9f611
No known key found for this signature in database
GPG key ID: 6A5F43A4F3241BCA
264 changed files with 18559 additions and 51021 deletions
Download patch file Download diff file Expand all files Collapse all files

41
research/acp/README.md Normal file
View file

@ -0,0 +1,41 @@
# ACP Migration Research
This folder captures the v2 migration plan from the current in-house protocol to ACP-first architecture.
## Files
- `research/acp/00-delete-first.md`: delete/comment-out-first inventory for the rewrite kickoff.
- `research/acp/acp-notes.md`: ACP protocol notes extracted from `~/misc/acp-docs`.
- `research/acp/acp-over-http-findings.md`: field research from ACP Zulip thread on real ACP-over-HTTP transport patterns and recommendations.
- `research/acp/spec.md`: proposed v2 protocol/transport spec (ACP over HTTP).
- `research/acp/v1-schema-to-acp-mapping.md`: exhaustive 1:1 mapping of all current v1 endpoints/events into ACP methods, notifications, responses, and `_meta` extensions.
- `research/acp/rfds-vs-extensions.md`: simple list of which gaps should be raised as ACP RFDs vs remain product-specific extensions.
- `research/acp/migration-steps.md`: concrete implementation phases and execution checklist.
- `research/acp/friction.md`: ongoing friction/issues log for ACP migration decisions and blockers.
## Source docs read
- `~/misc/acp-docs/docs/protocol/overview.mdx`
- `~/misc/acp-docs/docs/protocol/initialization.mdx`
- `~/misc/acp-docs/docs/protocol/session-setup.mdx`
- `~/misc/acp-docs/docs/protocol/prompt-turn.mdx`
- `~/misc/acp-docs/docs/protocol/tool-calls.mdx`
- `~/misc/acp-docs/docs/protocol/file-system.mdx`
- `~/misc/acp-docs/docs/protocol/terminals.mdx`
- `~/misc/acp-docs/docs/protocol/session-modes.mdx`
- `~/misc/acp-docs/docs/protocol/session-config-options.mdx`
- `~/misc/acp-docs/docs/protocol/extensibility.mdx`
- `~/misc/acp-docs/docs/protocol/transports.mdx`
- `~/misc/acp-docs/docs/protocol/schema.mdx`
- `~/misc/acp-docs/schema/meta.json`
- `~/misc/acp-docs/schema/schema.json`
- `~/misc/acp-docs/docs/get-started/agents.mdx`
- `~/misc/acp-docs/docs/get-started/registry.mdx`
## Important context
- ACP stable transport is stdio; streamable HTTP is still draft in ACP docs.
- v2 in this repo is intentionally breaking and ACP-native.
- v1 is removed in v2 and returns HTTP 410 on `/v1/*`.
- `/opencode/*` is disabled during ACP core phases and re-enabled in the dedicated bridge phase.
- Keep `research/acp/friction.md` current as issues/ambiguities are discovered.