Skip to content

docs(rfd): Move Rust SDK RFD to Preview #1187

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
benbrandt merged 1 commit into from
May 12, 2026
Merged

docs(rfd): Move Rust SDK RFD to Preview #1187

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions docs/docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,6 @@
"rfds/mcp-over-acp",
"rfds/session-usage",
"rfds/auth-methods",
"rfds/rust-sdk-v1",
"rfds/logout-method",
"rfds/session-delete",
"rfds/diff-delete",
Expand All @@ -144,7 +143,7 @@
},
{
"group": "Preview",
"pages": []
"pages": ["rfds/rust-sdk-v1"]
},
{
"group": "Completed",
Expand Down
16 changes: 9 additions & 7 deletions docs/rfds/rust-sdk-v1.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -865,20 +865,21 @@ The new SDK is organized into several crates with clear responsibilities:

### Current status

A working implementation exists in the [symposium-dev/symposium-acp](https://github.com/symposium-dev/symposium-acp) repository and is published on crates.io. It powers:
The implementation has been upstreamed to [agentclientprotocol/rust-sdk](https://github.com/agentclientprotocol/rust-sdk) for preview. The original [`sacp`](https://github.com/symposium-dev/symposium-acp) crates remain published on crates.io and power:

- The conductor (proxy chain orchestration)
- patchwork-rs (programmatic agent orchestration)
- Symposium (Rust development environment)

### Migration path

The transition involves importing the `sacp` implementation into this repository:
The transition involves upstreaming the `sacp` implementation to the `agentclientprotocol/rust-sdk` repository and stabilizing it after preview:

1. **Import `sacp` crates** into this repository with the new `agent-client-protocol-*` naming
2. **Release `agent-client-protocol` v1.0** with the new builder-based API
3. **Deprecate `sacp` crates** on crates.io, pointing users to the `agent-client-protocol` family
4. **Provide migration guidance** for users of the current v0.x SDK
1. **Import `sacp` crates** to `agentclientprotocol/rust-sdk` with the new `agent-client-protocol-*` naming
2. **Preview the upstreamed SDK** to collect feedback on the new builder-based API
3. **Release `agent-client-protocol` v1.0** when this RFD is marked Completed
4. **Deprecate `sacp` crates** on crates.io, pointing users to the `agent-client-protocol` family
5. **Provide migration guidance** for users of the current v0.x SDK

Most users will find the migration straightforward - the builder pattern is more ergonomic than the trait-based approach, so the new code is often simpler than the old.

Expand Down Expand Up @@ -910,10 +911,11 @@ This is a potential future enhancement - enum derives could dispatch to differen

### What changes are needed before stabilizing?

We are in the process of changing how response messages work to simplify the implementation of the conductor. Before stabilizing we should do a thorough review of the methods and look for candidates that can be removed or simplified.
Now that the implementation has been upstreamed, preview feedback should focus on API polish, method review, and identifying any candidates that can be removed or simplified before the 1.0 release.

The conductor is feature complete but the support for MCP-over-ACP needs a few minor improvements (in particular, it should detect when the agent only supports stdio bridging and not attempt to use HTTP, which it currently does not).

## Revision history

- 2026-05-12: Moved to Preview after the initial crate import was upstreamed to agentclientprotocol/rust-sdk.
- Initial draft based on working implementation in symposium-acp repository.
7 changes: 7 additions & 0 deletions docs/rfds/updates.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,13 @@ rss: true

This page tracks lifecycle changes for ACP Requests for Dialog. For broader ACP announcements, see [Updates](/updates).

<Update label="May 12, 2026" tags={["Preview"]}>
## Rust SDK based on SACP RFD moves to Preview stage

The RFD for basing the Rust SDK on SACP has been moved to Preview stage now that the initial crate import has been upstreamed to [agentclientprotocol/rust-sdk](https://github.com/agentclientprotocol/rust-sdk). Please review the [RFD](/rfds/rust-sdk-v1) for more information on the current proposal and provide feedback before the SDK is stabilized as 1.0.

</Update>

<Update label="May 7, 2026" tags={["Draft"]}>
## model_config Category RFD moves to Draft

Expand Down