3598358293fb64314ea0e5b6a59a7b3a4802b1c3
- (channel, chat_id) -> {agent, acp_session_id} binding table
- prompt(): auto-create binding, per-chat turn serialization, image blocks
- switch(): /switch semantics; --continue migrates hub-side text ONLY
(tool state does not migrate, documented)
- update relay: ACP session/update -> delta/thinking/tool_start/tool_end/
plan/final events via per-binding event sink
- cwd whitelist per agent (fnmatch, ~ expanded, realpath)
- idle reaper: expire bindings after idle_ttl_s, close unbound processes;
max_sessions cap with LRU eviction
- sqlite persistence (bindings + session_records) — DB is fact source,
config.json only bootstrap
- process death: client+binding dropped, SessionError surfaced
- tests: 39 passed (mock ACP agent subprocess)
agenthub
IM/NATS ↔ 本地 ACP 桥:让总线上的编排方(Octop / botflow / 任意 worker) 能够发现并驱动运行在本地机器上的 ACP 编码 agent (Claude Code、Codex、Gemini CLI、OpenCode …),并收回结构化事件流。
IM 用户 ── Octop ── NATS bus ── agenthub ── stdio JSON-RPC (ACP) ── coding agent
定位
- ACP agent 侧代理(client 角色):agenthub 作为 ACP client 拉起/管理 本地 agent 子进程,把 NATS 请求翻译成 ACP 会话。
- 总线侧服务:对外表现为 NATS 上的一个可发现服务(类似 A2A 的 Agent Card 思路,但传输是 NATS)。
详细设计见 docs/DESIGN.md。
仓库结构
agenthub/
├── docs/DESIGN.md # 设计方案(总)
├── docs/ACP_PRIMER.md # ACP 协议速查(方法/生命周期/坑)
├── src/acp_bridge/
│ ├── __init__.py
│ ├── config.py # 配置加载
│ ├── agent_registry.py # 本地 agent 进程池(拉起/复用/回收)
│ ├── acp_client.py # ACP JSON-RPC over stdio 客户端(frame 层)
│ ├── session.py # 会话状态机:nats 请求 <-> acp session 映射
│ ├── events.py # ACP session/update -> NATS 事件主题 映射
│ └── nats_service.py # NATS 订阅/发布、服务发现广播
├── tests/
└── pyproject.toml
快速开始(规划中)
uv sync
uv run agenthub --config config.json
状态
设计阶段 → M0 骨架实现中。
Description
IM/NATS to local ACP bridge: expose coding agents on the NATS bus
777 KiB
0 Stars
3 Watchers
0 Forks
Languages
Python
98.6%
Shell
1.4%