dsh-next-actions 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# 版本记录
+
+## 0.1.1 — 2026-11-11
+
+修复 DSH 升级后引导提示丢失：`AgentRegistry.roots()` 在 DSH 0.2.1-rc.3 起被移除，
+原来的根 agent 判定抛错后被静默忽略，常驻提示语因此从未注册，模型只看到单独的工具描述。
+
+- 改用会话 header 的 `origin: 'subagent'` 区分普通会话与子代理；子代理仍不注册工具与提示。
+- 静默降级改为可诊断：引导安装失败、既有 agent 列表不可读、会话 header 无法判定都写 Host 日志；
+  Host logger 缺失时回退 `console.warn`。
+- 引导语明确说明工程/代码工作同样适用：卡片在回答下方，不把回答变成 UI 回答。
+- 工具描述自述触发时机，即使提示语丢失也能说明用途。
+- 客户端光标插入被拒绝或抛错时回退为追加，并写 `console.warn` 说明降级。
+- 测试改用当前 `AgentRegistry.list()` 接口，并覆盖子代理排除、各静默降级的告警。
+
+## 0.1.0 — 2026-11-11
+
+首个公开发布。
+
+- 回复下方显示 1–3 条下一步建议：一两句上下文，加至多 3 个建议按钮；推荐项置顶、带 ✦ 与品牌色描边。
+- 点击只填入：草稿为空或仍是未改动的填入文字时整段替换；草稿里有内容时在光标处插入空行 + 指令，保留 `@` 引用，⌘Z 可撤销；永不自动发送。
+- 「已使用」从会话日志推断：下一条用户消息里有整行原样发送 → ✓，改后发送 → 铅笔；判定按选项各自进行。
+- 危险建议带 ⚠，同样只填入；风险来自模型字段或命令形状模式。
+- 卡片随会话保存，刷新与回放后仍在；工具过程组里一行记录。
+- 兼容 PTC（`run_code`）会话；子代理不注册工具；`enabled: false` 时不注册工具与提示词，零常驻 token。

package/DESIGN.md

@@ -0,0 +1,75 @@
+# 设计：下一步建议
+
+## 要解决的问题
+
+一轮工作结束后，用户常常要自己想清楚下一句该说什么，再把它打出来。模型此时最了解刚发生了什么，
+所以由它在收尾时顺手给出几步，用户点一下就能把完整指令放进输入框，改完自己发送。
+
+整个产品服务一条路径：**看一眼 → 点一下 → 在输入框里改**。新增任何机制前，先确认它服务这条路径。
+
+## 理念
+
+1. **回答的下一句，而不是新模块。** 卡片紧跟回答，先用一两句话承接刚才的结果，再给出动作；
+   建议不会凭空出现，也不进入回答正文。
+2. **交给人，不替人做。** 点击只填入，永不发送；输入框里已有的内容永不覆盖；危险操作同样只填入。
+   用户永远在发送前有最后一次修改的机会。
+3. **会话日志是唯一事实。** 卡片来自工具调用的记录，"已使用"来自用户真正发出的下一条消息；
+   插件不另存状态，刷新、回放、换设备看到的都一样。"使用"指做了这一步，而不是按了这个按钮。
+4. **安静，可以忽略。** 最多三条；状态不占文字，每个按钮至多一个前置图标，辅以描边和字色的轻微变化，
+   不加徽标、文字标签或弹层。不需要时继续对话即可，不弹窗、不设置、不打扰。
+   没有真实后续工作的回合不出卡片。
+5. **长在 DSH 上。** 外观沿用官方动作卡与过程行，只用主题 token；用户不应看出这是另一套界面。
+6. **少即是多。** 能由已有事实推出来的就不存，能由用户自己完成的就不做；
+   每一处代码都要能回答它服务哪条理念。
+
+## 体验
+
+**浅色主题**
+
+![浅色主题的下一步建议卡片示意：一行上下文，加推荐、已使用、需确认三个按钮](assets/card-preview.svg)
+
+**深色主题**
+
+![深色主题的下一步建议卡片示意：同一张卡片在深色主题下的颜色](assets/card-preview-dark.svg)
+
+示意图采用各主题的 token 值；实际外观随 DSH 明暗主题变化。
+
+- **上下文**：卡片第一行是 1–2 句话，说明刚才做了什么、为什么是这几步。
+- **建议**：最多 3 条，按模型给出的顺序排列；悬停显示完整指令（原生提示），不改变布局。
+- **推荐**：模型至多标 1 条，固定排第一；按钮描边带品牌蓝，前置 ✦。
+- **危险**：模型标记或命令形状的风险模式命中时前置 ⚠，可访问名带「需确认」。
+- **已使用**：这是从用户发出的文本推断出来的，不是点击记录；手动输入相近的内容也会被标记。
+  判定依据是这张卡片之后、第一个由用户消息开启的回合里的第一条消息：中间没有用户消息的回合（注入上下文、唤醒）跳过，
+  但如果那一轮自己出了卡片，这条消息就归新卡片；第一条消息没有文字（例如只回复图片）时不做判定，也不向后借。
+  对每个选项各自判定：
+  - 消息中有连续的整行与该指令一致（忽略空白）→ ✓。点击填入时指令总是成行出现，所以藏在一句话里的短词或「不要 + 指令」不算原样发送。
+  - 某一行或某一段按原顺序保留了指令的大部分字符，并且没有被大量新内容稀释（基于最长公共子序列的 Dice 相似度 ≥ 0.6）→ 铅笔，表示「改后发送」。
+    否定句同样算改后发送；去掉空白后不足 4 个字的指令只认原样发送。
+  - 其他情况不标。
+
+  已使用的按钮文字转为二级色。每个按钮只放一个前置图标：✓ 或铅笔 > ⚠ > ✦；所有状态都写进可访问名。
+- **点击 = 填入**：草稿为空，或仍是卡片刚填入且未改动的文字 → 整段替换；草稿里有用户自己的内容 →
+  在光标处插入「空行 + 指令」，作为一次编辑器编辑，保留 `@` 引用，⌘Z 可撤销。
+- **随会话保存**：每一轮的卡片都在，历史卡片仍可点击填入；只有回合刚结束时出现的卡片做展开动画。
+- **过程行**：工具过程组里一行「下一步建议 · 正在生成 / 已生成 · N / 未显示」。
+
+不做：自动发送、确认弹层、设置页、单轮忽略按钮、额外的模型请求。全局关闭用 Host 配置
+`enabled: false`，此时不注册工具与提示词，零 token。
+
+## 机制
+
+| 部分 | 文件 | 职责 |
+| --- | --- | --- |
+| Host | `index.js` | 为根 agent 注册 `suggest_next_actions` 与一段常驻提示；子代理不注册（按会话 header 的 `origin` 区分）；安装与判定失败写日志；`enabled:false` 时什么都不注册 |
+| 规范化 | `lib/normalize.js` | 参数 → `{ shown, context, suggestions[≤3] }`：折叠空白、截断、按指令去重、推荐至多一条且置顶；危险标记来自模型字段或命令形状模式。结果作为 `tool/result.meta` 写入会话日志 |
+| Client | `client.js`（手写单文件，含 CSS） | 两个 Conversation Definition：`next-actions` 把本工具结果上的 meta（native 与 PTC `run_code` 两条通路）发布为该轮卡片；`next-actions-sent` 把用户在该轮发出的第一条 `user/message` 发布为 `sent` 文本。`conversation.chat.turnTail` 渲染卡片；`tool.call.toolview` 渲染过程行 |
+
+会话日志只追加，压缩不删除原 `tool/result`，所以客户端直接读 meta，不重算参数，也不需要构建步骤；
+压缩产生的替换副本一律忽略，避免同一张卡片发布两次。第 N 轮的卡片通过 `useChat` 的 `timeline.turnOrder` / `timeline.turns` 读第 N+1 轮的 `sent` 文本来判定
+"已使用"。
+
+事件归到哪一轮由引擎决定。同一个 Definition 服务页面里所有会话的 assembler，翻页加载旧历史（`prepend`）时还会对更早的事件重跑 `match`，
+所以 `match` 只看当前事件、不持有状态：卡片按调用 id（PTC 按根调用 id）、消息按消息 id 建 Context，
+轮次在 `start` 里从引擎解析好的 `match.location` 读取。引擎规定每轮的同一个 Location key 只能有一个 owner，
+因此同一轮里第一个产出卡片的调用拥有卡片，第一条用户消息拥有 `sent`；后来者通过 `reader.previous` 看到前驱已占用就不再发布。外部插件不能 require Harness Client 包，所以卡片样式按官方动作卡重写，类名用 `dshna-` 前缀；
+刚结束的回合用 CSS `grid-template-rows` 展开卡片，避免回答被一帧顶起，`prefers-reduced-motion` 下不做动画。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LitiaEeloo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,38 @@
+dsh-next-actions
+=================
+
+Third-party notices for portions adapted from other works.
+
+
+DeepSeek Harness official action card
+-------------------------------------
+
+The suggestion card and process row follow the DeepSeek Harness official
+action card. Portions of client.js — the card and process-row CSS, and the
+markup structure they style — are adapted from that work, with renamed
+`dshna-` class names and DSH theme-token references.
+
+  Copyright (c) 2026 DeepSeek
+  Licensed under the MIT License, reproduced below.
+
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,79 @@
-# Temporary Holding Version
+# dsh-next-actions
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> Suggested next actions under DeepSeek Harness replies — clicking one fills the input, never sends.
+> DSH Web/Desktop 插件：在回复下方显示 1–3 条「下一步建议」，点击只填入输入框。
+
+**状态：v0.1.1（npm 包：[dsh-next-actions](https://www.npmjs.com/package/dsh-next-actions)）。** 设计与理念见 [`DESIGN.md`](DESIGN.md)，版本记录见 [`CHANGELOG.md`](CHANGELOG.md)。
+
+## 安装
+
+要求 DSH 0.2.2-rc.1 或更高版本；Host 需要支持 Web Client（Desktop 与 Web 均可）。
+
+```sh
+dsh plugin --profile desktop add dsh-next-actions
+```
+
+也可以让 agent 用 `plugin_manager` 的 `install_bundle` 安装同名 bundle，或在 Web 侧栏的 Plugins 页面里选中它。装好后重启 DSH。
+
+本地开发时用 `link:` 安装本目录：
+
+```sh
+dsh plugin --profile desktop add link:/path/to/dsh-next-actions
+```
+
+## 功能
+
+- 一两句上下文 + 最多 3 个建议按钮；卡片随会话保存，刷新与回放后仍在。
+- 推荐项置顶并带 ✦ 与品牌色描边；下一条消息里有整行与某条建议一致 → 实勾，改后发送 → 铅笔（从会话日志里的文本推断，手动输入相近内容也会被标记）。
+- 空草稿直接填入；已有草稿时在光标处插入（保留 `@` 引用，⌘Z 撤销）；永不自动发送。
+- 危险建议带 ⚠ 标记，同样只填入。
+- 工具过程组里一行记录；子代理不注册工具；Host 配置 `enabled: false` 时零常驻 token。
+- 兼容 PTC（`run_code`）会话。
+
+## 结构
+
+```text
+index.js            Host：工具 + 根 agent 常驻提示 + enabled 门控
+lib/normalize.js    参数规范化，结果写入 tool/result.meta
+client.js           Client（手写单文件）：Definition、卡片、过程行与 CSS
+cordis.patch.yml    插件行 patch
+test/               node --test
+assets/promo/       宣传短片：源文件、封面与渲染脚本（成片不入库，不随 npm 发布）
+```
+
+## 开发
+
+```sh
+node --test         # 测试
+npm pack --dry-run  # 打包检查
+```
+
+安装/卸载用 `plugin_manager` 的 `install_bundle` / `remove_bundle`；验证使用假 `DSH_HOME`。
+Host 改动需重启 DSH，Client 改动需刷新页面。
+
+## 发布
+
+改 `package.json` 版本与 `CHANGELOG.md` 后：
+
+```sh
+node --test
+npm pack --dry-run
+git tag -a v<version> -m "v<version>"
+git push origin main --tags
+npm publish --access public
+npm view dsh-next-actions version   # 确认 latest 指向新版本
+```
+
+发布后用假 `DSH_HOME` 从 registry 装一次；本机 `link:` 安装不需要切换。
+
+关闭功能：在 profile 的 `cordis.patch.yml` 写
+
+```yaml
+- id: dsh-next-actions
+  name: 'dsh-next-actions'
+  config: { enabled: false }
+```
+
+## 许可
+
+MIT（见 [LICENSE](LICENSE)）。卡片外观参照 MIT 许可的 DSH 官方动作卡，归属说明见 [NOTICE](NOTICE)。非 DeepSeek 官方插件。

package/assets/card-preview-dark.svg

@@ -0,0 +1,46 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="720" height="196" viewBox="0 0 720 196" role="img" aria-label="深色主题下的下一步建议卡片示意：一行上下文和三个按钮，分别带推荐、已使用、需确认标记">
+  <style>
+    text { font-family: system-ui, -apple-system, "PingFang SC", "Noto Sans CJK SC", "Helvetica Neue", sans-serif; }
+    .muted { fill: #adb2b8; font-size: 12px; }
+    .reply { fill: #cfd3d6; font-size: 13px; }
+    .context { fill: #cfd3d6; font-size: 13px; }
+    .label { fill: #f9fafb; font-size: 13px; }
+    .label-used { fill: #cfd3d6; font-size: 13px; }
+  </style>
+  <rect x="0.5" y="0.5" width="719" height="195" rx="14" fill="#17181a" stroke="#ffffff0f" stroke-width="0.75"/>
+  <text class="reply" x="28" y="38">助手回答……</text>
+  <text class="muted" x="28" y="64">▸  下一步建议 · 已生成 · 3</text>
+  <rect x="28" y="76" width="664" height="96" rx="12" fill="#232324" stroke="#ffffff1f" stroke-width="0.75"/>
+  <g transform="translate(48 92) scale(0.4444)">
+    <g transform="translate(-1.5 0.5)">
+      <rect x="5" y="7.6" width="21" height="5.4" rx="2.7" fill="#5E9DF5"/>
+      <rect x="5" y="15.3" width="16" height="5.4" rx="2.7" fill="#7AAEFF"/>
+      <rect x="5" y="23" width="11" height="5.4" rx="2.7" fill="#9CC3FF"/>
+      <path d="M29.6 6.6C29.88 8.65 31.25 10.02 33.3 10.3C31.25 10.58 29.88 11.95 29.6 14C29.32 11.95 27.95 10.58 25.9 10.3C27.95 10.02 29.32 8.65 29.6 6.6Z" fill="#41E1AC"/>
+    </g>
+  </g>
+  <text class="context" x="70" y="104">修复已完成，改动集中在 src/api；目前只跑了类型检查。</text>
+  <g>
+    <rect x="48" y="118" width="118" height="32" rx="6" fill="#232324" stroke="#7aaaff" stroke-opacity="0.6" stroke-width="0.75"/>
+    <g transform="translate(60 128) scale(0.75)">
+      <path d="M8 2.5C8.4 5.6 10.4 7.6 13.5 8 10.4 8.4 8.4 10.4 8 13.5 7.6 10.4 5.6 8.4 2.5 8 5.6 7.6 7.6 5.6 8 2.5Z" fill="#7aaaff"/>
+    </g>
+    <text class="label" x="76" y="139">跑一下测试</text>
+  </g>
+  <g>
+    <rect x="174" y="118" width="118" height="32" rx="6" fill="#232324" stroke="#ffffff29" stroke-width="0.75"/>
+    <g transform="translate(186 128) scale(0.75)">
+      <path d="M3.5 8.5 6.5 11.5 12.5 4.5" fill="none" stroke="#6dd795" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"/>
+    </g>
+    <text class="label-used" x="202" y="139">补回归用例</text>
+  </g>
+  <g>
+    <rect x="300" y="118" width="118" height="32" rx="6" fill="#232324" stroke="#ffffff29" stroke-width="0.75"/>
+    <g transform="translate(312 128) scale(0.75)">
+      <path d="M8 1.8 14.6 13.2H1.4L8 1.8Z" fill="none" stroke="#e7ae73" stroke-width="1.2" stroke-linejoin="round"/>
+      <path d="M8 6v3.4" stroke="#e7ae73" stroke-width="1.2" stroke-linecap="round"/>
+      <circle cx="8" cy="11.4" r="0.7" fill="#e7ae73"/>
+    </g>
+    <text class="label" x="328" y="139">推送到远端</text>
+  </g>
+</svg>

package/assets/card-preview.svg

@@ -0,0 +1,46 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="720" height="196" viewBox="0 0 720 196" role="img" aria-label="下一步建议卡片示意：一行上下文和三个按钮，分别带推荐、已使用、需确认标记">
+  <style>
+    text { font-family: system-ui, -apple-system, "PingFang SC", "Noto Sans CJK SC", "Helvetica Neue", sans-serif; }
+    .muted { fill: #8f959e; font-size: 12px; }
+    .reply { fill: #5f6673; font-size: 13px; }
+    .context { fill: #5f6673; font-size: 13px; }
+    .label { fill: #1f2329; font-size: 13px; }
+    .label-used { fill: #5f6673; font-size: 13px; }
+  </style>
+  <rect x="0.5" y="0.5" width="719" height="195" rx="14" fill="#f6f7f9" stroke="#e4e6ea" stroke-width="0.75"/>
+  <text class="reply" x="28" y="38">助手回答……</text>
+  <text class="muted" x="28" y="64">▸  下一步建议 · 已生成 · 3</text>
+  <rect x="28" y="76" width="664" height="96" rx="12" fill="#ffffff" stroke="#e0e2e6" stroke-width="0.75"/>
+  <g transform="translate(48 92) scale(0.4444)">
+    <g transform="translate(-1.5 0.5)">
+      <rect x="5" y="7.6" width="21" height="5.4" rx="2.7" fill="#5E9DF5"/>
+      <rect x="5" y="15.3" width="16" height="5.4" rx="2.7" fill="#7AAEFF"/>
+      <rect x="5" y="23" width="11" height="5.4" rx="2.7" fill="#9CC3FF"/>
+      <path d="M29.6 6.6C29.88 8.65 31.25 10.02 33.3 10.3C31.25 10.58 29.88 11.95 29.6 14C29.32 11.95 27.95 10.58 25.9 10.3C27.95 10.02 29.32 8.65 29.6 6.6Z" fill="#41E1AC"/>
+    </g>
+  </g>
+  <text class="context" x="70" y="104">修复已完成，改动集中在 src/api；目前只跑了类型检查。</text>
+  <g>
+    <rect x="48" y="118" width="118" height="32" rx="6" fill="#ffffff" stroke="#7fa7ff" stroke-width="0.75"/>
+    <g transform="translate(60 128) scale(0.75)">
+      <path d="M8 2.5C8.4 5.6 10.4 7.6 13.5 8 10.4 8.4 8.4 10.4 8 13.5 7.6 10.4 5.6 8.4 2.5 8 5.6 7.6 7.6 5.6 8 2.5Z" fill="#3370ff"/>
+    </g>
+    <text class="label" x="76" y="139">跑一下测试</text>
+  </g>
+  <g>
+    <rect x="174" y="118" width="118" height="32" rx="6" fill="#ffffff" stroke="#d9dbe0" stroke-width="0.75"/>
+    <g transform="translate(186 128) scale(0.75)">
+      <path d="M3.5 8.5 6.5 11.5 12.5 4.5" fill="none" stroke="#2ea121" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"/>
+    </g>
+    <text class="label-used" x="202" y="139">补回归用例</text>
+  </g>
+  <g>
+    <rect x="300" y="118" width="118" height="32" rx="6" fill="#ffffff" stroke="#d9dbe0" stroke-width="0.75"/>
+    <g transform="translate(312 128) scale(0.75)">
+      <path d="M8 1.8 14.6 13.2H1.4L8 1.8Z" fill="none" stroke="#ff8800" stroke-width="1.2" stroke-linejoin="round"/>
+      <path d="M8 6v3.4" stroke="#ff8800" stroke-width="1.2" stroke-linecap="round"/>
+      <circle cx="8" cy="11.4" r="0.7" fill="#ff8800"/>
+    </g>
+    <text class="label" x="328" y="139">推送到远端</text>
+  </g>
+</svg>

package/client.js

@@ -0,0 +1,524 @@
+/**
+ * Browser half of dsh-next-actions.
+ *
+ * - Two Conversation Definitions publish turn data. `next-actions` holds the
+ *   card from this tool's `tool/result.meta` (native) or `tool/ptc-dispatch`
+ *   meta (PTC `run_code`); `next-actions-sent` holds the text of the turn's
+ *   first human `user/message`. `match()` reads only the current event; the
+ *   turn always comes from the Engine-resolved `match.location`, because one
+ *   Definition serves every session's assembler and `prepend` re-matches
+ *   older pages.
+ * - A `conversation.chat.turnTail` entry renders the card under every turn
+ *   that produced one; clicking a suggestion fills the composer and never
+ *   sends. A chip whose prompt the next user message sent as-is gets a check;
+ *   one sent with edits gets a pencil. Both come from the session log.
+ * - A `tool.call.toolview` entry renders the one-line process row.
+ *
+ * External plugins must not require Harness Client packages, so the markup and
+ * CSS follow the official action card with renamed `dshna-` classes and theme
+ * tokens only. DSH serves this file as one classic script; it is hand-written
+ * source, not a build output.
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-next-actions',
+  factory(require) {
+    const React = require('react')
+    const h = React.createElement
+
+    // Card and process-row CSS: values follow the official action card and
+    // propose_action row; only theme tokens are referenced.
+    const STYLES = `
+.dshna-reveal {
+  display: grid;
+  grid-template-rows: 1fr;
+  margin: 16px 0;
+}
+.dshna-reveal > * { min-height: 0; }
+.dshna-reveal[data-fresh] { animation: dshna-reveal .22s cubic-bezier(.4, 0, .2, 1) both; }
+@keyframes dshna-reveal { from { grid-template-rows: 0fr; opacity: 0; } }
+@media (prefers-reduced-motion: reduce) { .dshna-reveal[data-fresh] { animation: none; } }
+.dshna-card {
+  overflow: hidden;
+  padding: 14px 20px 16px;
+  border: .5px solid var(--dsw-alias-border-l2);
+  border-radius: var(--dsw-radius-lg);
+  background: var(--dsw-alias-bg-layer-1);
+  color: var(--dsw-alias-label-primary);
+  font-family: var(--dsw-font-family);
+}
+.dshna-context {
+  margin: 0;
+  color: var(--dsw-alias-label-secondary);
+  font-size: 13px;
+  line-height: 1.6;
+  overflow-wrap: anywhere;
+}
+.dshna-mark { display: inline-block; vertical-align: -3px; margin-right: 6px; }
+.dshna-chips { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 12px; }
+.dshna-chip {
+  box-sizing: border-box;
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  max-width: 100%;
+  height: 32px;
+  padding: 0 12px;
+  border: .5px solid var(--dsw-alias-border-l3);
+  border-radius: var(--dsw-radius-sm);
+  background: transparent;
+  color: var(--dsw-alias-label-primary);
+  font: inherit;
+  font-size: 13px;
+  line-height: 20px;
+  cursor: pointer;
+}
+.dshna-chip:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover); }
+.dshna-chip:active:not(:disabled) { background: var(--dsw-alias-interactive-bg-active); }
+.dshna-chip:disabled { cursor: not-allowed; opacity: .4; }
+.dshna-chip:focus-visible {
+  outline: var(--dsw-focus-ring-width, 2px) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary));
+  outline-offset: 2px;
+}
+.dshna-chip-label { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    /* Recommended: tinted border + spark. Used (next message): check or pencil in success color; quieter label. */
+.dshna-chip[data-recommended] { border-color: color-mix(in srgb, var(--dsw-alias-state-business-primary) 60%, transparent); }
+.dshna-spark { flex: none; color: var(--dsw-alias-state-business-primary); }
+.dshna-chip[data-used] { color: var(--dsw-alias-label-secondary); }
+.dshna-used { flex: none; color: color-mix(in srgb, var(--dsw-alias-state-success-primary) 65%, var(--dsw-alias-label-primary)); }
+.dshna-warn { flex: none; color: color-mix(in srgb, var(--dsw-alias-state-warn-label) 65%, var(--dsw-alias-label-primary)); }
+.dshna-row {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  min-width: 0;
+  height: calc(24px + var(--dsh-content-font-delta, 0px));
+  color: var(--dsw-alias-label-tertiary);
+}
+.dshna-row > svg { flex: none; }
+.dshna-row-title { flex: none; font-size: var(--dsh-content-font-size-secondary, 13px); }
+.dshna-row-summary { min-width: 0; margin-left: 2px; font-size: 12px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+`
+
+    const PKG = 'dsh-next-actions'
+    const NS = 'nextActions'
+    const TOOL_NAME = 'suggest_next_actions'
+    const KEY = 'next-actions'
+    const SENT_KEY = 'next-actions-sent'
+
+    const EN = Object.freeze({
+      'card.title': 'Suggested next actions',
+      'chip.recommended': 'Recommended',
+      'chip.danger': 'Needs confirmation',
+      'chip.sent': 'Sent',
+      'chip.edited': 'Sent with edits',
+      'chip.aria': '{label}: {prompt}',
+      'chip.ariaMarked': '{label} ({marks}): {prompt}',
+      'chip.markSeparator': ', ',
+      'row.title': 'Next actions',
+      'row.running': 'Writing',
+      'row.ok': 'Shown',
+      'row.error': 'Not shown',
+    })
+    const ZH = Object.freeze({
+      'card.title': '下一步建议',
+      'chip.recommended': '推荐',
+      'chip.danger': '需确认',
+      'chip.sent': '已发送',
+      'chip.edited': '改后发送',
+      'chip.aria': '{label}：{prompt}',
+      'chip.ariaMarked': '{label}（{marks}）：{prompt}',
+      'chip.markSeparator': '，',
+      'row.title': '下一步建议',
+      'row.running': '正在生成',
+      'row.ok': '已生成',
+      'row.error': '未显示',
+    })
+
+    // -----------------------------------------------------------------------
+    // Data: fold this tool's events into turn data
+    // -----------------------------------------------------------------------
+
+    /**
+     * The card model is the Host-normalized `meta` on the original tool result.
+     * Compaction retains the original event; replacement copies are ignored.
+     * Older metas may carry up to six suggestions.
+     */
+    function modelOf(meta) {
+      if (meta?.shown !== true || typeof meta.context !== 'string' || !Array.isArray(meta.suggestions)) return null
+      const suggestions = meta.suggestions
+        .filter((suggestion) => typeof suggestion?.label === 'string' && typeof suggestion.prompt === 'string')
+        .slice(0, 3)
+      return suggestions.length === 0 ? null : { context: meta.context, suggestions }
+    }
+
+    const isTurn = (turn) => Number.isSafeInteger(turn) && turn >= 0
+    const isId = (value) => (typeof value === 'string' && value !== '') || Number.isSafeInteger(value)
+
+    /**
+     * Turn of a Match as the Engine resolved it for this session's window. Only
+     * the Engine knows which session and position an event has, so `match()`
+     * never guesses a turn from earlier events.
+     */
+    function turnOf(match) {
+      const location = match.location
+      const turn = location?.kind === 'turn' || location?.kind === 'step' ? location.turn?.turn : undefined
+      return isTurn(turn) ? turn : isTurn(match.event?.data?.turn) ? match.event.data.turn : null
+    }
+
+    /**
+     * A turn's Location key has one owner. Contexts of one kind form a chain by
+     * start order; `taken` says an earlier Context of the same turn already
+     * owns the key. The Engine replays a Context when its predecessor changes.
+     */
+    function takenBefore(reader, kind, turn, owns) {
+      const previous = reader.previous(kind)?.state
+      return previous !== undefined && previous.turn === turn && (previous.taken || owns(previous))
+    }
+
+    /** Plain text of a message's content blocks. */
+    function textOf(content) {
+      if (typeof content === 'string') return content
+      if (!Array.isArray(content)) return ''
+      return content.map((block) => (block?.type === 'text' && typeof block.text === 'string' ? block.text : '')).join('')
+    }
+
+    /**
+     * Card: one Context per call, keyed like the official tool Definition.
+     * Native calls by `callId`; PTC (`run_code`) dispatches by their root call.
+     * The first call of a turn that produced a card owns the turn's card.
+     */
+    const hasCard = (state) => state.model !== null
+    const cardDefinition = {
+      kind: KEY,
+      match(event) {
+        const data = event.data
+        switch (event.type) {
+          case 'tool/call':
+            return data.name === TOOL_NAME && isId(data.callId) ? { id: String(data.callId), role: 'start' } : null
+          case 'tool/result': {
+            // Replacement copies of a result must not re-publish the card.
+            const callId = data.message?.source?.callId ?? data.message?.toolCallId
+            return event.surfaceOp === 'append' && isId(callId) ? { id: String(callId), role: 'update' } : null
+          }
+          case 'tool/ptc-dispatch-start':
+          case 'tool/ptc-dispatch':
+            return data.name === TOOL_NAME && isId(data.rootCallId)
+              ? { id: `ptc:${data.rootCallId}`, role: event.type === 'tool/ptc-dispatch-start' ? 'start' : 'update' }
+              : null
+          default:
+            return null
+        }
+      },
+      start(_context, match, reader) {
+        const turn = turnOf(match)
+        const state = { turn, model: null, taken: turn !== null && takenBefore(reader, KEY, turn, hasCard) }
+        return cardDefinition.update({ state }, match)
+      },
+      update({ state }, { event }) {
+        const data = event.data
+        let model = null
+        if (event.type === 'tool/result' && event.surfaceOp === 'append') {
+          if (data.message === undefined || data.message.isError === true) return state
+          model = modelOf(data.meta)
+        } else if (event.type === 'tool/ptc-dispatch' && data.isError !== true) {
+          model = modelOf(data.meta)
+        }
+        return model === null ? state : { ...state, model }
+      },
+      buildLocationData({ state }, scope, previous) {
+        if (scope !== 'turn' || state === undefined || state.turn === null || state.model === null || state.taken) return null
+        if (previous?.key === KEY && previous.turn === state.turn && previous.value.model === state.model) return previous
+        return { kind: 'turn', turn: state.turn, key: KEY, value: { model: state.model } }
+      },
+    }
+
+    /**
+     * Sent text: one Context per human message. The first message of a turn owns
+     * the turn's `sent`, text or not: a textless reply publishes an empty value
+     * so the card before it is not judged by a later message.
+     */
+    const hasSent = () => true
+    const sentDefinition = {
+      kind: SENT_KEY,
+      match(event) {
+        const data = event.data
+        return event.type === 'user/message' && event.surfaceOp === 'append' && data.source?.kind === 'user' && isId(data.id)
+          ? { id: String(data.id), role: 'start' }
+          : null
+      },
+      start(_context, match, reader) {
+        const turn = turnOf(match)
+        return { turn, text: textOf(match.event.data.content), taken: turn !== null && takenBefore(reader, SENT_KEY, turn, hasSent) }
+      },
+      update({ state }) {
+        return state
+      },
+      buildLocationData({ state }, scope, previous) {
+        if (scope !== 'turn' || state === undefined || state.turn === null || state.taken) return null
+        if (previous?.key === SENT_KEY && previous.turn === state.turn && previous.value.text === state.text) return previous
+        return { kind: 'turn', turn: state.turn, key: SENT_KEY, value: { text: state.text } }
+      },
+    }
+
+    // -----------------------------------------------------------------------
+    // Card
+    // -----------------------------------------------------------------------
+
+    /** Empty drafts and drafts the card wrote itself are replaced; anything else gets the action added. */
+    function fillMode(draft, owned) {
+      return draft.trim() === '' || draft === owned ? 'replace' : 'insert'
+    }
+
+    let sharedCtx = null
+
+    function fill(actions, draft, owned, prompt, sessionId) {
+      let next = prompt
+      if (fillMode(draft, owned) === 'insert') {
+        next = null
+        try {
+          // One editor edit at the caret: keeps @ references, undoable with ⌘Z.
+          if (actions.insertText(`\n\n${prompt}`, actions.captureInsertion()) !== true) {
+            console.warn('[dsh-next-actions] insertText declined; appending the action instead')
+            next = `${draft.trimEnd()}\n\n${prompt}`
+          }
+        } catch (error) {
+          console.warn('[dsh-next-actions] insert at caret failed; appending the action instead', error)
+          next = `${draft.trimEnd()}\n\n${prompt}`
+        }
+      }
+      if (next !== null) actions.setDraft(next)
+      try {
+        sharedCtx?.get?.('conversation')?.input?.shell?.(sessionId)?.focus?.()
+      } catch {
+        // Focus is a convenience; the draft is already filled.
+      }
+      return next === prompt ? prompt : null
+    }
+
+    function Mark() {
+      return h('svg', { width: 16, height: 16, viewBox: '0 0 36 36', fill: 'none', className: 'dshna-mark', 'aria-hidden': 'true' },
+        h('g', { transform: 'translate(-1.5 0.5)' },
+          h('rect', { x: 5, y: 7.6, width: 21, height: 5.4, rx: 2.7, fill: '#5E9DF5' }),
+          h('rect', { x: 5, y: 15.3, width: 16, height: 5.4, rx: 2.7, fill: '#7AAEFF' }),
+          h('rect', { x: 5, y: 23, width: 11, height: 5.4, rx: 2.7, fill: '#9CC3FF' }),
+          h('path', { d: 'M29.6 6.6C29.88 8.65 31.25 10.02 33.3 10.3C31.25 10.58 29.88 11.95 29.6 14C29.32 11.95 27.95 10.58 25.9 10.3C27.95 10.02 29.32 8.65 29.6 6.6Z', fill: '#41E1AC' })))
+    }
+
+    function WarnIcon() {
+      return h('svg', { width: 12, height: 12, viewBox: '0 0 16 16', fill: 'none', className: 'dshna-warn', 'aria-hidden': 'true' },
+        h('path', { d: 'M8 1.8 14.6 13.2H1.4L8 1.8Z', stroke: 'currentColor', strokeWidth: 1.2, strokeLinejoin: 'round' }),
+        h('path', { d: 'M8 6v3.4', stroke: 'currentColor', strokeWidth: 1.2, strokeLinecap: 'round' }),
+        h('circle', { cx: 8, cy: 11.4, r: 0.7, fill: 'currentColor' }))
+    }
+
+    function SparkIcon() {
+      return h('svg', { width: 12, height: 12, viewBox: '0 0 16 16', className: 'dshna-spark', 'aria-hidden': 'true' },
+        h('path', { d: 'M8 2.5C8.4 5.6 10.4 7.6 13.5 8 10.4 8.4 8.4 10.4 8 13.5 7.6 10.4 5.6 8.4 2.5 8 5.6 7.6 7.6 5.6 8 2.5Z', fill: 'currentColor' }))
+    }
+
+    /** "Sent as-is". */
+    function CheckIcon() {
+      return h('svg', { width: 12, height: 12, viewBox: '0 0 16 16', fill: 'none', className: 'dshna-used', 'aria-hidden': 'true' },
+        h('path', { d: 'M3.5 8.5 6.5 11.5 12.5 4.5', stroke: 'currentColor', strokeWidth: 1.6, strokeLinecap: 'round', strokeLinejoin: 'round' }))
+    }
+
+    /** "Sent with edits". */
+    function EditedIcon() {
+      return h('svg', { width: 12, height: 12, viewBox: '0 0 16 16', fill: 'none', className: 'dshna-used', 'aria-hidden': 'true' },
+        h('path', { d: 'M10.5 3 13 5.5 6 12.5 3 13l.5-3L10.5 3Z', stroke: 'currentColor', strokeWidth: 1.5, strokeLinecap: 'round', strokeLinejoin: 'round' }))
+    }
+
+    // -----------------------------------------------------------------------
+    // Usage: which suggestions the next human message used
+    //
+    // An inference from the sent text, not a click record: typing similar text
+    // by hand is marked too. Clicking fills the prompt as whole lines (the
+    // empty draft replaced, or "\n\n" + prompt inserted), so "sent as-is"
+    // means whole lines equal to the prompt.
+    // -----------------------------------------------------------------------
+
+    /** Prompts shorter than this (whitespace removed) only count when sent as-is. */
+    const EDITED_MIN_LENGTH = 4
+    /** Order-aware similarity (Dice over the longest common subsequence) that counts as "sent with edits". */
+    const EDITED_SIMILARITY = 0.6
+
+    const squash = (value) => value.replace(/\s+/g, '').toLowerCase()
+
+    /** Characters of `left` kept in order in `right`. */
+    function commonLength(left, right) {
+      let row = new Array(right.length + 1).fill(0)
+      for (const character of left) {
+        const next = [0]
+        for (let index = 0; index < right.length; index += 1) {
+          next.push(character === right[index] ? row[index] + 1 : Math.max(row[index + 1], next[index]))
+        }
+        row = next
+      }
+      return row[right.length]
+    }
+
+    function similarity(target, text) {
+      // Dice cannot reach the threshold when lengths differ too much; skip the quadratic work.
+      if ((2 * Math.min(target.length, text.length)) / (target.length + text.length) < EDITED_SIMILARITY) return 0
+      return (2 * commonLength(target, text)) / (target.length + text.length)
+    }
+
+    /**
+     * 'full' when whole consecutive lines of the sent text equal the prompt;
+     * 'partial' when one line or paragraph keeps most of the prompt in order.
+     */
+    function usageOf(prompt, sent) {
+      const target = Array.from(squash(prompt))
+      if (target.length === 0) return null
+      const lines = sent.split('\n').map(squash).filter((line) => line !== '')
+      const joined = target.join('')
+      for (let first = 0; first < lines.length; first += 1) {
+        let run = ''
+        for (let last = first; last < lines.length && run.length < joined.length; last += 1) {
+          run += lines[last]
+          if (run === joined) return 'full'
+        }
+      }
+      if (target.length < EDITED_MIN_LENGTH) return null
+      const paragraphs = sent.split(/\n\s*\n/).map(squash).filter((paragraph) => paragraph !== '')
+      for (const candidate of new Set([...lines, ...paragraphs])) {
+        if (similarity(target, Array.from(candidate)) >= EDITED_SIMILARITY) return 'partial'
+      }
+      return null
+    }
+
+    /**
+     * Text the user answered the card of `turn` with: the first message of the
+     * next turn opened by a human. Turns without a human message (injected
+     * context, wake-ups) are skipped, and a later turn showing its own card
+     * claims the next message instead. A human turn whose message has no text
+     * (an image-only reply) ends the search, so no later message is borrowed.
+     */
+    function nextSent(snapshot, turn) {
+      const order = snapshot?.timeline?.turnOrder
+      const index = Array.isArray(order) ? order.indexOf(turn) : -1
+      if (index < 0) return ''
+      for (const later of order.slice(index + 1)) {
+        const data = snapshot.timeline.turns?.get(later)?.data
+        const sent = data?.get(SENT_KEY)
+        if (sent !== undefined) return typeof sent.text === 'string' ? sent.text : ''
+        if (data?.get(KEY)?.model) return ''
+      }
+      return ''
+    }
+
+    /** Only a card mounted right after its turn ends animates in; history mounts instantly. */
+    function isFresh(turn) {
+      const time = turn?.end?.time
+      const value = typeof time === 'number' ? time : Date.parse(time)
+      return Number.isFinite(value) && Date.now() - value < 5000
+    }
+
+    function NextActionsCard({ turn, inputActions, useInput, useChat, useSession, sessionId, t }) {
+      const ownedRef = React.useRef(null)
+      const draft = useInput?.((state) => state?.draft ?? '') ?? ''
+      const sent = useChat?.((snapshot) => nextSent(snapshot, turn?.turn)) ?? ''
+      const subagent = useSession?.((state) => state?.subagent ?? null)
+
+      const model = turn?.end === undefined ? undefined : turn.data?.get(KEY)?.model
+      const closing = turn?.data?.get('turn-tail')?.closing
+      const suggestions = closing && !subagent ? model?.suggestions : undefined
+      const usages = React.useMemo(
+        () => suggestions?.map(({ prompt }) => usageOf(prompt, sent)),
+        [suggestions, sent],
+      )
+      if (!suggestions) return null
+
+      const canWrite = typeof inputActions?.setDraft === 'function'
+      const chip = (suggestion, index) => {
+        const usage = usages[index]
+        const marks = [
+          suggestion.recommended && t('chip.recommended'),
+          suggestion.danger && t('chip.danger'),
+          usage === 'full' && t('chip.sent'),
+          usage === 'partial' && t('chip.edited'),
+        ].filter(Boolean)
+        // One leading icon: what the user did outranks what the model said.
+        const icon = usage !== null
+          ? h(usage === 'full' ? CheckIcon : EditedIcon)
+          : suggestion.danger ? h(WarnIcon) : suggestion.recommended ? h(SparkIcon) : null
+        return h('button', {
+          key: index,
+          type: 'button',
+          className: 'dshna-chip',
+          'data-recommended': suggestion.recommended ? '' : undefined,
+          'data-used': usage ?? undefined,
+          disabled: !canWrite,
+          title: suggestion.prompt,
+          'aria-label': marks.length > 0
+            ? t('chip.ariaMarked', { label: suggestion.label, marks: marks.join(t('chip.markSeparator')), prompt: suggestion.prompt })
+            : t('chip.aria', { label: suggestion.label, prompt: suggestion.prompt }),
+          onClick: () => {
+            ownedRef.current = fill(inputActions, draft, ownedRef.current, suggestion.prompt, sessionId)
+          },
+        },
+        icon,
+        h('span', { className: 'dshna-chip-label' }, suggestion.label))
+      }
+
+      return h('div', { className: 'dshna-reveal', 'data-fresh': isFresh(turn) ? '' : undefined },
+        h('section', { className: 'dshna-card', 'aria-label': t('card.title') },
+          h('p', { className: 'dshna-context' }, h(Mark), model.context),
+          h('div', { className: 'dshna-chips' }, suggestions.map(chip))))
+    }
+
+    // -----------------------------------------------------------------------
+    // Process row (one line in the tool group, like the official propose_action row)
+    // -----------------------------------------------------------------------
+
+    function rowState(phase, block) {
+      if (phase === 'preparing' || phase === 'start') return 'running'
+      if (block?.isError === true || block?.error !== undefined) return 'error'
+      return block?.meta?.shown === false ? 'error' : 'ok'
+    }
+
+    function ProcessRow({ phase, block, t }) {
+      const state = rowState(phase, block)
+      const count = state === 'ok' && Array.isArray(block?.meta?.suggestions) ? block.meta.suggestions.length : 0
+      return h('div', { className: 'dshna-row', 'data-tool': TOOL_NAME, 'data-state': state, title: block?.meta?.note },
+        h('svg', { width: 14, height: 14, viewBox: '0 0 16 16', fill: 'none', stroke: 'currentColor', strokeWidth: 1, 'aria-hidden': 'true' },
+          h('rect', { x: 2.25, y: 2.25, width: 4, height: 4, rx: 1 }),
+          h('rect', { x: 2.25, y: 9.75, width: 4, height: 4, rx: 1 }),
+          h('rect', { x: 9.75, y: 9.75, width: 4, height: 4, rx: 1 }),
+          h('path', { d: 'M11.75 1.75v5M9.25 4.25h5' })),
+        h('span', { className: 'dshna-row-title' }, t('row.title')),
+        h('span', { className: 'dshna-row-summary' }, count > 0 ? `${t(`row.${state}`)} · ${count}` : t(`row.${state}`)))
+    }
+
+    // -----------------------------------------------------------------------
+    // Plugin entry
+    // -----------------------------------------------------------------------
+
+    function apply(ctx) {
+      sharedCtx = ctx
+      ctx.effect(() => ctx.locale.register(NS, { en: EN, zh: ZH }), 'dsh-next-actions: locale')
+      ctx.effect(() => {
+        const element = document.createElement('style')
+        element.dataset.plugin = PKG
+        element.textContent = STYLES
+        document.head.appendChild(element)
+        return () => element.remove()
+      }, 'dsh-next-actions: styles')
+      ctx.effect(() => ctx.uiConversation.events.register(cardDefinition), 'dsh-next-actions: card definition')
+      ctx.effect(() => ctx.uiConversation.events.register(sentDefinition), 'dsh-next-actions: sent definition')
+      ctx.slots.inject('conversation.chat.turnTail', () => ctx.slots.register({
+        name: 'conversation.chat.turnTail', id: PKG, order: -10, locale: NS,
+      }, NextActionsCard))
+      ctx.slots.inject('tool.call.toolview', () => ctx.slots.register({
+        name: 'tool.call.toolview', key: TOOL_NAME, locale: NS,
+      }, ProcessRow))
+    }
+
+    return {
+      // `uiConversation` is injected so the definition registers on a cold boot.
+      inject: ['slots', 'locale', 'uiConversation'],
+      apply,
+      __test: { cardDefinition, sentDefinition, modelOf, fillMode, fill, rowState, usageOf, nextSent },
+    }
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# Activates the package: the Host `apply` registers the tool; the Client half is
+# discovered through package.json `dsh.client`. `enabled: false` registers nothing.
+- insert:
+    - id: dsh-next-actions
+      name: 'dsh-next-actions'
+      config:
+        enabled: true

package/icon.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="36" height="36" viewBox="0 0 36 36" fill="none">
+  <defs>
+    <linearGradient id="next-actions-fill" x1="5" y1="8" x2="26" y2="20" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#67C7FE"/>
+      <stop offset="1" stop-color="#3F77D8"/>
+    </linearGradient>
+  </defs>
+  <g transform="translate(-1.5 0.5)">
+    <rect x="5" y="7.6" width="21" height="5.4" rx="2.7" fill="url(#next-actions-fill)"/>
+    <rect x="5" y="15.3" width="16" height="5.4" rx="2.7" fill="#7AAEFF"/>
+    <rect x="5" y="23" width="11" height="5.4" rx="2.7" fill="#9CC3FF"/>
+    <path d="M29.6 6.6C29.88 8.65 31.25 10.02 33.3 10.3C31.25 10.58 29.88 11.95 29.6 14C29.32 11.95 27.95 10.58 25.9 10.3C27.95 10.02 29.32 8.65 29.6 6.6Z" fill="#41E1AC"/>
+  </g>
+</svg>

package/index.js

@@ -0,0 +1,180 @@
+/**
+ * Host half of `dsh-next-actions`.
+ *
+ * Registers the `suggest_next_actions` tool for root agents plus one standing
+ * prompt section that tells the model when to call it. Zero imports: the
+ * package is installed with `link:` and cannot resolve `@deepseek-ai/*`.
+ * Row config `enabled: false` registers nothing, so the feature costs no tokens.
+ */
+
+import { buildMeta, LIMITS } from './lib/normalize.js'
+
+export const name = 'dsh-next-actions'
+export const inject = ['tools', 'systemPrompt', 'agents']
+
+const TOOL_NAME = 'suggest_next_actions'
+
+const GUIDANCE = [
+  'Before your final answer, call suggest_next_actions once when this turn leaves real follow-up work:',
+  'a task finished or advanced, tools ran, files changed, review or approval is due,',
+  'or you were about to end with a list of next actions.',
+  'Use it for code and engineering work too; the card sits under the reply and the reply keeps its normal plain-text format.',
+  'Put those actions only in the card; the reply gets at most one lead-in sentence and never numbers or bullets them.',
+  'Skip greetings, acknowledgements, pure knowledge answers, repeated cards, and turns that already asked a structured question.',
+].join(' ')
+
+const PROMPT_SECTION = 'tool:suggest-next-actions'
+
+const TOOL = {
+  name: TOOL_NAME,
+  description: [
+    'Show 1–3 clickable next actions as a card under your reply; clicking one fills the message input, never sends.',
+    'Call it once before the final answer when this turn leaves real follow-up work.',
+    "Write the actions in the user's language and never repeat them in your prose.",
+  ].join(' '),
+  parameters: {
+    type: 'object',
+    additionalProperties: false,
+    required: ['context', 'suggestions'],
+    properties: {
+      context: {
+        type: 'string',
+        description: 'One or two sentences (≤240 chars): what was just done and why these actions follow. Never restate the answer.',
+      },
+      suggestions: {
+        type: 'array',
+        description: '1–3 distinct next actions, most useful first.',
+        items: {
+          type: 'object',
+          additionalProperties: false,
+          required: ['label', 'prompt'],
+          properties: {
+            label: { type: 'string', description: `Short imperative button text, ≤${LIMITS.label} chars, no ending punctuation.` },
+            prompt: { type: 'string', description: "Message the user could send as-is (≤500 chars), citing this turn's files, commands or decisions." },
+            recommended: { type: 'boolean', description: 'At most one: your pick when one action is clearly best.' },
+            danger: { type: 'boolean', description: 'True only for destructive, irreversible, paid or permission-changing actions, e.g. 删除/清空/重置/发布/部署/回滚/付费/授权/卸载.' },
+          },
+        },
+      },
+    },
+  },
+  output: {
+    schema: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['shown', 'count'],
+      properties: { shown: { type: 'boolean' }, count: { type: 'integer' } },
+    },
+    render: (_args, value) => [{
+      type: 'text',
+      text: value?.shown
+        ? `Next actions shown below your answer (${value.count}). Now write the final answer: do not list them, keep at most one lead-in sentence, and do not call this tool again this turn.`
+        : 'No card shown. Answer normally; do not mention this tool.',
+    }],
+    // Persisted as tool/result.meta; the browser renders the card from it.
+    presentationMeta: (args) => buildMeta(args),
+  },
+  execute(args) {
+    const meta = buildMeta(args)
+    return { shown: meta.shown, count: meta.shown ? meta.suggestions.length : 0 }
+  },
+}
+
+/** Only a literal `enabled: false` turns the feature off. */
+export function normalizeConfig(raw) {
+  return { enabled: !(raw !== null && typeof raw === 'object' && raw.enabled === false) }
+}
+
+/**
+ * Ordinary session agents only. Delegated agents carry the durable
+ * `origin: 'subagent'` header; `AgentRegistry.roots()` no longer exists since
+ * DSH 0.2.1-rc.3, so the header is the supported discriminator. Fail open so a
+ * Harness change never silently hides the tool, and report the drift once.
+ */
+function isRoot(agent, onUnreadable) {
+  if (agent === undefined || agent === null) return true
+  try {
+    return agent.session.header.origin !== 'subagent'
+  } catch (error) {
+    onUnreadable?.(error)
+    return true
+  }
+}
+
+export function apply(ctx, config) {
+  if (!normalizeConfig(config).enabled) return
+
+  /** Host log, with a console fallback so a missing logger cannot hide the report. */
+  const warn = (message) => {
+    const line = `dsh-next-actions: ${message}`
+    try {
+      if (typeof ctx.logger?.warn === 'function') {
+        ctx.logger.warn(line)
+        return
+      }
+    } catch {
+      // Fall through: the warning must not depend on a working logger.
+    }
+    console.warn(line)
+  }
+
+  /** Report a header-shape change once; `when` runs on every tool resolution. */
+  let headerFailureReported = false
+  const isRootAgent = (agent) => isRoot(agent, (error) => {
+    if (headerFailureReported) return
+    headerFailureReported = true
+    warn(`agent session header unreadable; treating the agent as a root: ${String(error)}`)
+  })
+
+  ctx.effect(
+    () => ctx.tools.register(TOOL, { when: ({ agent }) => isRootAgent(agent) }),
+    'dsh-next-actions: tool',
+  )
+
+  /** agent → disposer of its prompt section. */
+  const installed = new Map()
+  const install = (agent) => {
+    if (installed.has(agent) || !isRootAgent(agent)) return
+    try {
+      const prompt = agent.ctx.systemPrompt
+      const base = prompt.getSectionOrder?.('TOOL_REPORT')
+      installed.set(agent, agent.ctx.effect(() => prompt.section({
+        name: PROMPT_SECTION,
+        order: typeof base === 'number' ? base + 50 : 2950,
+        text: GUIDANCE,
+      }), 'dsh-next-actions: guidance'))
+    } catch (error) {
+      // The tool still works without the guidance; surface the degradation
+      // instead of silently losing the standing instruction.
+      warn(`guidance not installed: ${String(error)}`)
+    }
+  }
+
+  ctx.effect(() => {
+    const offCreated = ctx.on('agent/created', ({ agent }) => install(agent))
+    const offDisposed = ctx.on('agent/disposed', ({ agent }) => installed.delete(agent))
+    try {
+      for (const agent of ctx.agents.list()) install(agent)
+    } catch (error) {
+      // Agents created later still arrive through agent/created, but agents
+      // that were already live at apply time keep missing the guidance.
+      warn(`could not install guidance on existing agents: ${String(error)}`)
+    }
+    return () => {
+      offCreated()
+      offDisposed()
+      for (const dispose of installed.values()) {
+        try {
+          dispose()
+        } catch {
+          // The agent may already be gone.
+        }
+      }
+      installed.clear()
+    }
+  }, 'dsh-next-actions: guidance')
+}
+
+/** Test seams. */
+export const __definition = TOOL
+export const __guidance = { section: PROMPT_SECTION, text: GUIDANCE }

package/lib/normalize.js

@@ -0,0 +1,56 @@
+/**
+ * Normalize `suggest_next_actions` arguments into the card model.
+ *
+ * Host only: the result is persisted as `tool/result.meta`, which the browser
+ * half renders as-is. Import-free and side-effect-free.
+ */
+
+export const LIMITS = Object.freeze({ suggestions: 3, context: 240, label: 24, prompt: 500 })
+
+/**
+ * Command-shaped risk patterns: a hit marks a suggestion as needing confirmation.
+ * Clicking still only fills the input, so the mark never blocks the user.
+ */
+export const RISK = /\brm\s+-rf\b|\bforce[- ]?push\b|--force\b|\bdrop\s+(table|database)\b|\btruncate\s+table\b|\bsudo\b|\bformat\s+(disk|drive|volume)\b/i
+
+const text = (value) => (typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '')
+
+function clip(value, max) {
+  const characters = Array.from(value)
+  return characters.length <= max ? value : `${characters.slice(0, max - 1).join('')}…`
+}
+
+/**
+ * @param {unknown} args - tool arguments as parsed by the Host.
+ * @returns {{ shown: true, context: string, suggestions: { label: string, prompt: string, danger?: true }[] } | { shown: false, note: string }}
+ */
+export function buildMeta(args) {
+  if (args === null || typeof args !== 'object' || Array.isArray(args)) return { shown: false, note: 'invalid-arguments' }
+
+  const context = clip(text(args.context), LIMITS.context)
+  if (context === '') return { shown: false, note: 'missing-context' }
+
+  const seen = new Set()
+  const entries = []
+  let recommended = null
+  for (const item of Array.isArray(args.suggestions) ? args.suggestions : []) {
+    if (item === null || typeof item !== 'object') continue
+    const prompt = clip(text(item.prompt) || text(item.label), LIMITS.prompt)
+    const key = prompt.toLowerCase()
+    if (prompt === '' || seen.has(key)) continue
+    seen.add(key)
+    const label = clip(text(item.label) || prompt, LIMITS.label)
+    const entry = { label, prompt }
+    if (item.danger === true || RISK.test(`${label}\n${prompt}`)) entry.danger = true
+    // At most one recommendation; it always leads the card.
+    if (item.recommended === true && recommended === null) {
+      entry.recommended = true
+      recommended = entry
+    } else {
+      entries.push(entry)
+    }
+  }
+  const suggestions = recommended === null ? entries : [recommended, ...entries]
+  if (suggestions.length === 0) return { shown: false, note: 'no-usable-suggestions' }
+  return { shown: true, context, suggestions: suggestions.slice(0, LIMITS.suggestions) }
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Suggested next actions",
+    "description": "Shows 1–3 clickable next actions under replies, with one or two sentences of context. Clicking one fills the input; nothing is sent automatically."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "下一步建议",
+    "description": "在回复下方显示一两句上下文和 1–3 条可点击的下一步建议；点击只会填入输入框，不会自动发送。"
+  }
+}

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "dsh-next-actions",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "license": "MIT",
+  "description": "Shows 1–3 clickable next actions under replies; clicking one fills the input draft, never sends.",
+  "icon": "./icon.svg",
+  "author": "LighghtEeloo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LighghtEeloo/dsh-next-actions.git"
+  },
+  "homepage": "https://github.com/LighghtEeloo/dsh-next-actions#readme",
+  "bugs": {
+    "url": "https://github.com/LighghtEeloo/dsh-next-actions/issues"
+  },
+  "type": "module",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "next-actions",
+    "suggestions"
+  ],
+  "engines": {
+    "dsh": ">=0.2.2-rc.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "lib/normalize.js",
+    "locale/*.json",
+    "icon.svg",
+    "DESIGN.md",
+    "assets/*.svg",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-chat",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-tool"
+      ]
+    }
+  },
+  "scripts": {
+    "test": "node --test"
+  }
+}