Skip to content

Commit bc3045a

Browse files
Contribute "Symposium ACP" crates (#12)
* Convert to workspace structure with agent-client-protocol crate in src/ Moves the existing ACP crate into src/agent-client-protocol/ to prepare for adding SACP crates to the workspace. * Add SACP crates and documentation Brings in the Symposium ACP (SACP) crates from symposium-acp repository: - sacp: Core SACP protocol types and traits - sacp-tokio: Tokio-based runtime utilities - sacp-proxy: Framework for building SACP proxy components - sacp-conductor: Orchestration for SACP proxy chains Examples: - sacp-tee: Sample proxy that logs to a file - elizacp: Eliza chatbot implementation - yopo: Additional tooling Utility crates: - sacp-test: Testing utilities and helpers Also includes the mdbook documentation that describes the SACP architecture and how to build agents and proxies. * Cleanup for CI * Clippy --------- Co-authored-by: Ben Brandt <benjamin.j.brandt@gmail.com>
1 parent 1019c67 commit bc3045a

File tree

120 files changed

+21365
-115
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

120 files changed

+21365
-115
lines changed

.claude/settings.local.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
{
2+
"permissions": {
3+
"allow": [
4+
"mcp__plugin_historian_log__log",
5+
"mcp__plugin_historian_sidechat__receive_message"
6+
],
7+
"deny": [],
8+
"ask": []
9+
}
10+
}

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
11
target
22
.DS_Store
3+
book
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# ACP Rust SDK Merge - Session Complete
2+
3+
## What We Accomplished
4+
5+
Successfully merged the symposium-acp crates into the acp-rust-sdk repository and restructured the documentation.
6+
7+
### Repository Restructuring
8+
9+
**Workspace Conversion**: Converted the repository from a single-crate structure to a workspace with all crates living in `src/`:
10+
- `src/agent-client-protocol/` - Legacy ACP SDK
11+
- `src/sacp/` - Core SACP protocol
12+
- `src/sacp-tokio/` - Tokio runtime utilities
13+
- `src/sacp-proxy/` - Proxy building framework
14+
- `src/sacp-conductor/` - Proxy chain orchestrator
15+
- `src/sacp-test/` - Testing utilities
16+
- `src/sacp-tee/` - Example debugging proxy
17+
- `src/elizacp/` - Example ELIZA agent
18+
- `src/yopo/` - Example minimal client
19+
20+
### Documentation Restructuring
21+
22+
**Simplified mdbook structure** focusing on concepts rather than implementation details:
23+
24+
1. **Introduction** - Explains legacy SDK vs experimental SACP crates
25+
2. **Architecture Overview** - Clients/agents, proxies, conductor concepts
26+
3. **Protocol Reference** - SACP protocol extensions
27+
4. **Crate Reference** - What each crate does, when to use it, with examples
28+
29+
**Removed chapters**: Building guides, RFD, component architecture, transport details (these belong in docs.rs)
30+
31+
**Example documentation**: Added detailed descriptions of sacp-tee, elizacp, and yopo as reference implementations
32+
33+
### Key Changes
34+
35+
- Added `book/` to `.gitignore` (generated content)
36+
- All crates use workspace dependencies
37+
- Documentation redirects to docs.rs for implementation details
38+
- Clean separation: mdbook = concepts, docs.rs = API details
39+
40+
## Repository State
41+
42+
Clean git status on main branch, pushed to nikomatsakis/main. All 9 workspace crates build successfully. Documentation builds with mdbook.
43+
44+
## Future Work
45+
46+
- Fill in Legacy SDK documentation TODOs
47+
- Publish SACP crates to crates.io when ready
48+
- Add more examples as the ecosystem grows

.sparkle-space/working-memory.json

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
{
2+
"current_focus": "Successfully merged symposium-acp crates into acp-rust-sdk repository",
3+
"achievements": [
4+
"Converted acp-rust-sdk to workspace structure with crates in src/",
5+
"Merged all SACP crates from symposium-acp (sacp, sacp-tokio, sacp-proxy, sacp-conductor, sacp-test, elizacp, yopo)",
6+
"Added sacp-tee example proxy from symposium",
7+
"Restructured mdbook documentation to focus on concepts over implementation",
8+
"Removed outdated chapters and consolidated to: Introduction, Architecture, Protocol, Crate Reference",
9+
"Added Examples section documenting sacp-tee, elizacp, and yopo",
10+
"Added book/ directory to .gitignore",
11+
"All changes committed and pushed to nikomatsakis/main"
12+
],
13+
"repository_state": {
14+
"structure": "Workspace with 9 member crates in src/",
15+
"documentation": "Focused mdbook in md/ with 4 main chapters",
16+
"examples": "sacp-tee (proxy), elizacp (agent), yopo (client)"
17+
},
18+
"next_steps": [
19+
"Consider publishing sacp crates to crates.io when ready",
20+
"Fill in TODOs in legacy SDK documentation",
21+
"Add more examples as needed"
22+
]
23+
}

0 commit comments

Comments
 (0)