会话管理补全：生命周期控制 + 会话信箱（两个 RFC，求反馈与投票）/ Completing session management: lifecycle controls + session mailbox (two RFCs, feedback and votes welcome)

[qslowprofile]

---

大家好。我想提出两个互补的 RFC，合起来把"会话"补全为可管理、可寻址的一等对象，希望听到团队与社区的反馈。

RFC1 会话生命周期控制

• 现状：packages/host/apiproxy/src/api/rpc-map.ts 没有 session.resume；packages/host/apiproxy/src/api/workspace.ts:102 的归档是单向的，注释已预留 "a future unarchive restores its position"；SessionPersistence 缝没有任何删除入口。
• 提议：session.resume RPC + workspace.unarchiveSession + 基于 SessionPersistence 缝的两步删除（先归档、仅归档态可删、删除需客户端确认）。
• 对应 Ideas 区已有的归档 / 恢复、永久删除、关闭自动恢复等诉求：#1991、#2613、#2642、#3075、#3554。
• 社区已经有插件在自建这套能力（#2076），侧面说明这个缺口适合由内核承接。

RFC2 会话信箱

• 现状：子代理 send_message 仅限深度 1 的父子链路；Agent Teams 信箱为实验特性且仅限同根会话树。
• 提议：一个独立的、按 dsh-session: URI 寻址的持久消息投递缝，静默 / 唤醒两种投递，事件写入目标会话日志，发送者署名并按不可信内容加框。agent-teams Agent Note 已否决在子代理缝上加 peer id，本提案尊重该结论，完全不触碰既有子代理缝。

两者构成一条"会话管理补全弧"：RFC1 让会话生命周期闭环（可恢复、可取消归档、可删除），RFC2 让任何会话可被寻址通信。两者共享 dsh-session: 寻址与持久化基础。

我们理解并尊重项目现阶段不接受外部 PR 的政策，因此这里不提交代码。按仓库惯例，我们准备了两组可直接落地的 Agent Note 三件套（非官方社区草案，proposed/feature：.md / .zh.md / .i18n.yaml），团队认为方向可行的话可直接取用、改写或拆分：

• RFC1 Note 三件套：https://gist.github.com/qslowprofile/ebd922d8c670bb0e9bff7c6a1dc6d1f4
• RFC2 Note 三件套：https://gist.github.com/qslowprofile/ffdf65520bcdcd181c8b2dc571cd066c

如果你也需要这些能力，请为本帖点赞或留言补充你的使用场景。按 CONTRIBUTING 的说法，投票是团队分配资源时的重要信号。

最后说明署名一事：两份设计文本与三件套按仓库许可（MIT）自由使用，若团队采纳，希望能以 commit author 或 Co-authored-by 的方式保留署名，这是我们想以社区成员身份长期参与的一点心愿。

---

Hi all, I would like to propose two complementary RFCs that together complete sessions as manageable, addressable first-class objects. Feedback and votes welcome.

RFC1 Session lifecycle controls

• Today: no session.resume RPC in packages/host/apiproxy/src/api/rpc-map.ts; archiving is one-way, and the comment at packages/host/apiproxy/src/api/workspace.ts:102 already anticipates unarchive ("a future unarchive restores its position"); there is no delete anywhere in the SessionPersistence seam.
• Proposal: a session.resume RPC, workspace.unarchiveSession, and two-step deletion (archive first, delete only from the archived state, with client confirmation) extending the SessionPersistence seam. This matches existing Ideas asking for archive/restore, permanent deletion, and disabling auto-recovery: #1991, #2613, #2642, #3075, #3554.
• The community is already building this capability as plugins (#2076), which suggests the gap belongs in the core.

RFC2 Session mailbox

• Today: subagent send_message is depth-1 parent/child only; the Agent Teams mailbox is experimental and same-root only.
• Proposal: a separate durable, session-addressed delivery seam, quiet/wakeup delivery, events recorded in the target session's log, sender attribution with untrusted framing, addressing via the existing dsh-session: URI. The agent-teams Agent Note rejects peer ids on the subagent seam; this proposal honors that by leaving the subagent seam untouched.

Together they form a session-management completion arc: RFC1 closes the lifecycle loop, RFC2 makes sessions addressable.

We understand and respect that external PRs are not accepted at this stage, so no code is attached. Following repo conventions, we prepared two ready-to-land Agent Note triplets (unofficial community drafts; proposed/feature: .md / .zh.md / .i18n.yaml), feel free to take, rewrite, or split them:

• RFC1 Note triplet: https://gist.github.com/qslowprofile/ebd922d8c670bb0e9bff7c6a1dc6d1f4
• RFC2 Note triplet: https://gist.github.com/qslowprofile/ffdf65520bcdcd181c8b2dc571cd066c

If these capabilities would help you, please upvote or comment with your scenario. Per CONTRIBUTING, upvotes are considered when the team allocates resources.

One note on attribution: both design documents and triplets are free to use under the repository license (MIT). If the team adopts them, we would appreciate authorship being preserved via commit author or Co-authored-by.

[qslowprofile]

更新：两个 RFC 现在都有可安装的插件实现了（unofficial）

为了验证提案的可行性，我们把两份 RFC 做成了一个树外插件套件（MIT，非官方）：dsh-session-nexus https://github.com/qslowprofile/dsh-session-nexus

• lifecycle 子插件（RFC1 伴生）：/resume（按 id 显式挂载冷会话，不发消息）、/unarchive（best-effort）、/rm-session（默认关闭的降级两步删除）。
• mailbox 子插件（RFC2 伴生）：/send-to、/notify、/address 命令 + session_send_message 模型工具——寻址支持 id / dsh-session: URI / composer @ mention / 引号标题；wakeup（成为目标下一 turn、冷会话自动 resume，正文以干净气泡呈现、署名与不可信提示走独立 context 行）与 quiet（不唤醒的模型上下文）两种投递；发送者署名、自寄拒绝、逐对速率熔断。

安装（web profile 为例）：

dsh plugin --profile web add dsh-session-nexus

（已发布到 npm：https://www.npmjs.com/package/dsh-session-nexus ；也可用 github:qslowprofile/dsh-session-nexus 从源码安装。）

实现过程恰好验证了 RFC 里"必须上游做"的部分——插件在公开缝上能把 UX 跑通，但撞到了四堵只有官方能拆的墙：

1. 注册表缓存：unarchive 能写进 workspace storage domain、host/archived-sessions-changed 帧也会推送，但 WorkspaceRegistry 的私有内存 state 无法从外部失效——下一次任意 workspace 写入会静默回滚。这正是归档 Agent Note 预留的 "one inverse RPC" 需要落地的原因。
2. RPC 面是编译期闭集：RpcMethodMap/UNARY_ROUTES 无注册 API，插件加不了 session.resume 这样的一等 RPC，只能借道 slash command。
3. 冷会话无法静默排队：不物化目标会话，插件没有公开的写日志路径——queued → delivered 的持久邮箱事件（fork/replay 可见）只能由上游的 mailbox seam 提供。
4. 转发消息的呈现两难：插件来源的 user/message 被渲染为折叠 context 行（几乎不可见），要获得完整气泡只能用 user 来源——但那会被当作人类提问计入活跃度/标题生成。一等的 mailbox 消息类型才能兼顾可见性与可审计的署名。

如果这两个方向团队认为可行，Agent Note 三元组（前帖的 gist）与插件代码都可以直接取用、改写或拆分；若采纳，希望能以 git commit --author 或 Co-authored-by 保留署名。也欢迎大家试用插件并在这里反馈使用场景。