@deepseek-ai/dsh-plan-mode 0.1.5-rc.2 → 0.1.6-alpha.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/plan/plan-mode/README.md
-README.md: 693273ab4bdfddebd6145046e8354a5a211c8b8b
-README.zh.md: 39a7a65c29d3f11dfb9e9f4dc696d59082c82240
+README.md: 642caf0c6db6470e93c7b0583d2bfe145ed99f29
+README.zh.md: 4165d5b925083d10c76312d00293fd0b0ac84ba0

package/README.md

@@ -105,6 +105,8 @@ When `ctx.sessionProjections` is composed, the package registers the `plan` unit
 | [`src/client.ts`](src/client.ts) | Client-namespace re-export of the types outlet |
 | [`src/invariant.ts`](src/invariant.ts) | Invariant companion: validates the `plan/mode` payload shape |
 
+The review intent carries the originating tool-call id, so the Web client can reopen the same submitted plan after the review closes. The complete Markdown remains in the existing native call or PTC dispatch log.
+
 </details>
 
 -----

package/README.zh.md

@@ -1,5 +1,5 @@
 ---
-description: "面向用户与维护者的计划模式说明：用于选择、配置或排查带部署引导、/plan 命令与经用户评审退出的逐 agent 规划功能。"
+description: "面向用户与维护者的计划模式说明：用于选择、配置或排查带部署引导、/plan 命令与经用户评审退出的逐 agent（智能体）规划功能。"
 kind: "package-reference"
 ---
 
@@ -33,7 +33,7 @@ kind: "package-reference"
 
 ### 最小配置
 
-唯一必需的配置是 agent 规划期间遵循的引导文本；添加任何其他内容都会在加载时失败。
+唯一必需的配置是 agent 规划期间遵循的引导文本；添加任何其他配置都会在加载时失败。
 
 ```yaml
 - name: '@deepseek-ai/dsh-plan-mode'
@@ -47,7 +47,7 @@ kind: "package-reference"
 |---|---|---|
 | `section` | 必填 | 计划模式激活时作为 `plan:policy` 提示词段落渲染的引导 |
 
-生成的[配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-plan-mode)是每个受支持字段及其 JSDoc 的穷尽式真源。
+生成的[配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-plan-mode)完整列出了所有受支持的字段及其 JSDoc。
 
 <a id="model-and-human-interactions"></a>
 ### 进入与离开计划模式
@@ -78,7 +78,7 @@ agent 完成计划后，会以 markdown 形式、从标题开头书写计划并
 
 ### 设计理念
 
-计划模式是产品包，而不是能力 seam：没有可替换的后端，因此状态、引导、命令与退出工具都集中在一处。持久姿态是单一仅记日志、整值替换的事件，绝不是实时镜像，因此恢复、fork 与压缩（compaction）都通过折叠日志复原它。引导是软性层——本包注册一个提示词段落和一个工具，通过文本而非过滤能力来约束。
+计划模式是产品包，而不是能力 seam：没有可替换的后端，因此状态、引导、命令与退出工具都集中在一处。持久化方案采用单一仅记日志、整值替换的事件，绝不使用实时镜像，因此恢复、fork 与压缩（compaction）都通过折叠日志复原它。引导是软性层——本包注册一个提示词段落和一个工具，通过文本而非过滤能力来约束。
 
 ### 持久状态与步骤边界追加
 
@@ -90,7 +90,7 @@ agent 完成计划后，会以 markdown 形式、从标题开头书写计划并
 
 ### 退出工具
 
-`exit_plan_mode` 在计划模式未激活时仍保持注册，因此进入或离开只改变提示词段落，绝不改变请求的工具目录。经批准的评审会记录一个静默的待生效退出，由下一个被接受的轮内 pre-step 追加，当前这批工具调用剩余部分仍保留计划引导。缺少用户交互通道，或评审等待期间服务重载，调用都会失败关闭，`/plan off` 仍是手动退路。
+`exit_plan_mode` 在计划模式未激活时仍保持注册，因此进入或离开只改变提示词段落，绝不改变请求的工具目录。经批准的评审会记录一个静默的待生效退出，由下一个被接受的轮内 pre-step 追加，当前这批工具调用剩余部分仍保留计划引导。缺少用户交互通道，或评审等待期间服务重载，调用都会以拒绝方式失败，`/plan off` 仍是手动退路。
 
 ### 会话投影单元
 
@@ -105,6 +105,8 @@ agent 完成计划后，会以 markdown 形式、从标题开头书写计划并
 | [`src/client.ts`](src/client.ts) | types 出口的客户端命名空间再导出 |
 | [`src/invariant.ts`](src/invariant.ts) | 不变式伴生插件：校验 `plan/mode` 载荷结构 |
 
+审批意图携带发起工具调用的标识，让 Web 客户端在审批关闭后重新打开同一份计划。完整 Markdown 保留在已有的原生调用或 PTC dispatch 日志中。
+
 </details>
 
 -----
@@ -149,15 +151,15 @@ You are in plan mode. Explore and design before presenting the complete plan thr
 
 #### 模型看到什么
 
-`/plan`、`/plan off` 及其终端结果留在模型历史之外。除恰好为 `off` 以外的非空后缀会在选择计划模式后，通过 `agent.steer()` 成为一条用户消息：已准入的图片块与文件块按选择顺序排列，之后是去除首尾空白的文本块。不带参数的 `/plan` 若带有已准入附件，会 steer 一条只含这些块的用户消息。计划模式已激活时选择 `/plan off`，只会在最后记录的请求头描述了计划模式的情况下追加标准的已记录用户切换通知；取消待生效条目不贡献通知，因为没有请求观测到它。
+`/plan`、`/plan off` 及其终端结果留在模型历史之外。除恰好为 `off` 以外的非空后缀会在选择计划模式后，通过 `agent.steer()` 成为一条用户消息：已准入的图片块与文件块按选择顺序排列，之后是去除首尾空白的文本块。不带参数的 `/plan` 若带有已准入附件，会通过 `agent.steer()` 提交一条只含这些块的用户消息。计划模式已激活时选择 `/plan off`，只会在最后记录的请求头描述了计划模式的情况下追加标准的已记录用户切换通知；取消待生效条目不贡献通知，因为没有请求观测到它。
 
 #### Token 影响
 
-可选消息的历史 token 成本与单独提交该内容相同。不带附件的 `/plan` 与 `/plan off` 不增加 token；带附件的 `/plan` 产生常规图片与文件句柄成本。一次带叙述的激活状态退出会追加一条简短且会保留的切换通知。
+可选消息的历史 token 成本与单独提交该内容相同。不带附件的 `/plan` 与 `/plan off` 不增加 token；带附件的 `/plan` 产生常规图片与文件句柄成本。一次带有通知的激活状态退出会追加一条简短且会保留的切换通知。
 
 #### KV Cache 影响
 
-用户块是仅追加的对话增长。进入或离开计划模式会改变更早的策略段落；带叙述的退出通知追加在可复用请求前缀之后。
+用户块是仅追加的对话增长。进入或离开计划模式会改变更早的策略段落；用于说明退出的通知会追加在可复用请求前缀之后。
 
 ### 退出工具 schema 与评审交互
 
@@ -167,7 +169,7 @@ You are in plan mode. Explore and design before presenting the complete plan thr
 
 #### Token 影响
 
-稳定 schema 的成本取决于 ToolRuntime mode，每次传入的 plan 参数与评审结果都会保留在对话历史中。
+稳定 schema 的成本取决于 ToolRuntime 模式，每次传入的 plan 参数与评审结果都会保留在对话历史中。
 
 #### KV Cache 影响
 

package/lib/index.js

@@ -1,4 +1,5 @@
 import { Service } from "@deepseek-ai/cordis";
+import { brandString } from "@deepseek-ai/dsh-brand";
 import { z } from "zod";
 import { createUserMessage } from "@deepseek-ai/dsh-llm";
 import { defineTool } from "@deepseek-ai/dsh-tools";
@@ -178,6 +179,7 @@ var PlanModeController = class extends Service {
 		ctx.sessionProjections.register(planProjectionDefinition);
 		ctx.inject(["commands"], (commandCtx) => {
 			commandCtx.commands.register({
+				definitionId: brandString("@deepseek-ai/dsh-plan-mode"),
 				name: "plan",
 				description: "Enter or leave plan mode",
 				input: {
@@ -271,7 +273,8 @@ var PlanModeController = class extends Service {
 						}],
 						intent: {
 							kind: "plan-review",
-							approve: APPROVE_LABEL
+							approve: APPROVE_LABEL,
+							callId: exec.callId
 						}
 					}],
 					agent,

package/lib/types/index.js

@@ -22,6 +22,7 @@
  * @module @deepseek-ai/dsh-plan-mode
  */
 import { Service } from '@deepseek-ai/cordis';
+import { brandString } from '@deepseek-ai/dsh-brand';
 import { z as zod } from 'zod';
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
 import { defineTool } from '@deepseek-ai/dsh-tools';
@@ -175,6 +176,7 @@ export class PlanModeController extends Service {
         // The command child activates only when a command registry is composed.
         ctx.inject(['commands'], (commandCtx) => {
             commandCtx.commands.register({
+                definitionId: brandString('@deepseek-ai/dsh-plan-mode'),
                 name: 'plan',
                 description: 'Enter or leave plan mode',
                 input: { hint: '[off|message]', attachments: true },
@@ -262,7 +264,7 @@ export class PlanModeController extends Service {
                             // Presentation only: a capable UI renders the plan as a review
                             // decision instead of a generic question, and answers with one of
                             // the labels above either way.
-                            intent: { kind: 'plan-review', approve: APPROVE_LABEL },
+                            intent: { kind: 'plan-review', approve: APPROVE_LABEL, callId: exec.callId },
                         }],
                     agent,
                     signal: exec.signal,

package/lib/types/invariant.js

@@ -21,6 +21,7 @@ function validateEvent(event, fail) {
 /** Install validation for loaded and newly appended plan-mode state. */
 const install = Object.assign((ctx, fail) => {
     const seed = (session) => {
+        // oxlint-disable-next-line typescript/no-deprecated -- Existing Session history read; migration deferred.
         for (const event of session.snapshotEvents())
             validateEvent(event, fail);
     };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-plan-mode",
   "description": "Logged per-agent plan mode with deployment guidance, a direct slash command, and a user-reviewed exit",
-  "version": "0.1.5-rc.2",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -41,16 +41,16 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-commands": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-user-questions": "^0.1.5-rc.2",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-commands": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-user-questions": "^0.1.6-alpha.2",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-tools": "^0.1.6-alpha.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-commands": {
@@ -58,20 +58,21 @@
     }
   },
   "dependencies": {
-    "zod": "^4.4.3"
+    "zod": "^4.4.3",
+    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-code-runtime": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-commands": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-user-questions": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.2",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-agent-loop": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-ptc-runtime": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-commands": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-tools": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-user-questions": "^0.1.6-alpha.2",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.2"
   }
 }