dsh-s2s

dsh-s2s — DeepSeek Harness 的 Session-to-Session 同宿主会话互联

一个 cordis 插件,让同一台宿主上的多个 DSH session 互相对话——按会话名(标题)点名即可,并支持拉起已结束(静止)的 session。

实现思路受 a2a 启发,但并非其 fork:a2a 是跨主机 mesh(hub + WebSocket + presence);而 s2s 是同宿主单进程路径,因此不继承其 hub/网络层,只借鉴了它的注入习语(空闲→followup、忙碌→inject)。s2s 用一个进程内 broker 直接投递,零 TCP 端口、零 WS、零重连。原 a2a 版实现归档在本仓库历史与 legacy-a2a 分支,作参照。(跨进程/跨机 mesh 请直接用 a2a;非 DSH 标准 A2A agent 需网关类插件。)

使用手册见 USAGE.md;场景与最佳实践见 docs/BEST_PRACTICES.md;设计证据稿见 docs/SOLUTION.md(v0.2 历史基线)。

---

它是什么 / 不是什么

功能一览

• 进程内投递:S2sBroker.deliver(sessionId, {from,text}) → ctx.agents.get(...) → agent.followup(空闲)/inject(忙碌)。零网络、零序列化。
• name 主寻址:s2s_resume(name: "开发", ...) / s2s_message(name: "产品", ...);标题取自宿主的零 I/O 投影缓存(本插件不另存标题缓存),因此改名在下一个标题检查点后生效,而非同一瞬间;同名→ambiguous(用 session_id 消歧),查无→not-found+候选。
• 拉起静止会话:入信箱 → autoResume=allow 时 AgentRegistry.resume 拉起 → 投递;拉起的会话保留 live-idle(不自动归眠)。
• 6 个模型工具:s2s_peers(本项目 live)/ s2s_sessions(本项目 标题+三态;all=true 全量)/ s2s_message(发/唤醒)/ s2s_resume(显式唤醒)/ s2s_history(进程作用域历史)/ s2s_schedule(会话内定时注入)。
• 持久信箱:~/.dsh/s2s/mailboxes/<sessionId>/*.json,原子写、时序命名、损坏自愈。
• 按需加载:lifecycle/budget 配置块缺席即不挂载;broker/discovery/tools 恒挂(核心)。

详细用法见 USAGE.md。

挂载

装新插件必须用 - insert: 形式,且 name 指向可解析的 ESM 入口(不能是目录):

- insert:
    - id: dsh-s2s
      name: ./dsh-s2s/lib/index.js
      config:
        lifecycle:
          autoResume: allow       # s2s_resume 用 name 点名即拉起投递
        budget:
          maxHops: 6
          ratePerMinute: 10

零端口:无需配 hub/server(那已是跨机 a2a 的事)。

路线图

• ✅ 进程内重构(R1):去掉 hub/WS 网络层,S2sBroker 进程内直投;零端口。
• ✅ name 主寻址(R2):按会话标题点名,现读不缓存;同名/查无显式处理。
• ✅ 静态会话拉起(R2):AgentRegistry.resume 拉起 + 信箱 + drain + 防双开。
• ✅ 预算(R3 部分):发送侧 hop/限速。
• ✅ 会话内定时唤醒(R4):s2s_schedule(每 N / 定点拉起,到点 idle 才注入 / busy 推后 / dormant 交 s2s)。设计见 docs/SCHEDULE.md。
• 🔲 待做:s2s-etiquette skill(何时找谁、礼节与汇报规范)。
• 🔲 待做:历史/信箱持久化强度调优;真实 GUI 端到端体验。
• 🔲 可选项:与外部标准 A2A agent 互通(需独立网关,本包不做)。

开发

pnpm install
pnpm run typecheck     # 0 错
pnpm run test          # 24/24
pnpm run build         # 产出 lib/index.js (~28kB)

License

MIT。