@deepseek-ai/dsh-plan-mode 0.2.1-alpha.2 → 0.2.1-alpha.4

package/README.i18n.yaml

@@ -27,8 +27,8 @@
   en: 2d300cdb883352ec
   zh: 5a81be005b3716d3
 /deepseek-ai-dsh-plan-mode/use-this-package/the-reviewed-exit:
-  en: ffc56477380b9411
-  zh: 17cac060f2252d78
+  en: dbf12997d2359e81
+  zh: 120a91554d2154f4
 /deepseek-ai-dsh-plan-mode/use-this-package/observing-plan-state:
   en: b44e92bc38406015
   zh: ed56190bee5d71a4
@@ -90,8 +90,8 @@
   en: 9622e96bdc01276d
   zh: 53801e68a49f3d1d
 /deepseek-ai-dsh-plan-mode/model-experience/exit-tool-schema-and-review-exchange/what-the-model-sees:
-  en: 3768d0189f9f13af
-  zh: 2168a9b24551b7c6
+  en: 16c57e8e64ad5a85
+  zh: d81932553025c875
 /deepseek-ai-dsh-plan-mode/model-experience/exit-tool-schema-and-review-exchange/token-effect:
   en: d1b1418f20ee119d
   zh: c2b89ea3cae57175

package/README.md

@@ -60,7 +60,7 @@ You can attach images and generic files to a `/plan` message, and they are inclu
 
 When the agent has a finished plan, it calls `exit_plan_mode` with the plan written as markdown and starting with a heading. You review that exact plan and choose `Approve` to leave plan mode, or `Keep planning` to send the agent back with feedback.
 
-Choosing `Keep planning` (optionally with free-text feedback) sends the agent back to revise the plan; closing the review to type a message instead tells the agent to wait for your next message. If no interactive review is available, `exit_plan_mode` cannot run and you can still leave plan mode with `/plan off`.
+Choosing `Keep planning` (optionally with free-text feedback) sends the agent back to revise the plan; closing the review to type a message instead ends the agent's turn, and your next message starts the next request. If no interactive review is available, `exit_plan_mode` cannot run and you can still leave plan mode with `/plan off`.
 
 ### Observing plan state
 
@@ -164,7 +164,7 @@ The user block is append-only conversation growth. Entering or leaving plan mode
 
 #### What the model sees
 
-The [`exit_plan_mode` schema](../../../docs/tool-catalog.md#deepseek-aidsh-plan-mode) remains available in both states; execution outside plan mode fails, while an approved in-mode review returns the canonical `{ approved: true }` value and renders the existing confirmation text. Rejection remains a failed call carrying review feedback, and a dismissed review a failed call naming the user's takeover.
+The [`exit_plan_mode` schema](../../../docs/tool-catalog.md#deepseek-aidsh-plan-mode) remains available in both states; execution outside plan mode fails, while an approved in-mode review returns the canonical `{ approved: true }` value and renders the existing confirmation text. Rejection remains a failed call carrying review feedback. A dismissed review returns `{ approved: false }`, renders a note that the user will reply, and concludes the turn without another model request.
 
 #### Token effect
 

package/README.zh.md

@@ -60,7 +60,7 @@ kind: "package-reference"
 
 agent 完成计划后，会以 markdown 形式、从标题开头书写计划并调用 `exit_plan_mode`。你评审该计划的原文，选择 `Approve` 离开计划模式，或选择 `Keep planning` 带反馈把 agent 送回去。
 
-选择 `Keep planning`（可附自由文本反馈）会让 agent 回去修订计划；关闭评审改为发言，则告知 agent 等待你的下一条消息。若没有可用的交互评审，`exit_plan_mode` 无法运行，你仍可用 `/plan off` 离开计划模式。
+选择 `Keep planning`（可附自由文本反馈）会让 agent 回去修订计划；关闭评审改为发言，则结束 agent 当前轮次，你的下一条消息开始下一次请求。若没有可用的交互评审，`exit_plan_mode` 无法运行，你仍可用 `/plan off` 离开计划模式。
 
 ### 观察计划状态
 
@@ -164,7 +164,7 @@ You are in plan mode. Explore and design before presenting the complete plan thr
 
 #### 模型看到什么
 
-[`exit_plan_mode` schema](../../../docs/tool-catalog.zh.md#deepseek-aidsh-plan-mode) 在两种状态下均可用；在计划模式之外执行会失败，而计划模式内经批准的评审返回规范的 `{ approved: true }` 值，并渲染既有的确认文本。拒绝仍是携带评审反馈的失败调用，放弃评审则是一次指明用户接手的失败调用。
+[`exit_plan_mode` schema](../../../docs/tool-catalog.zh.md#deepseek-aidsh-plan-mode) 在两种状态下均可用；在计划模式之外执行会失败，而计划模式内经批准的评审返回规范的 `{ approved: true }` 值，并渲染既有的确认文本。拒绝仍是携带评审反馈的失败调用。放弃评审返回 `{ approved: false }`，渲染一条说明用户将自行回复的文本，并结束当前轮次，不再发起模型请求。
 
 #### Token 影响
 

package/lib/index.js

@@ -241,13 +241,12 @@ var PlanModeController = class extends Service {
 					additionalProperties: false,
 					properties: { approved: {
 						type: "boolean",
-						const: true,
 						required: true
 					} }
 				},
-				render: () => [{
+				render: (_args, { approved }) => [{
 					type: "text",
-					text: "Plan approved — plan mode exited; carry out the plan starting with your next step."
+					text: approved ? "Plan approved — plan mode exited; carry out the plan starting with your next step." : "The user dismissed the plan review to reply in their own words; plan mode remains active."
 				}]
 			},
 			execute: async (args, exec) => {
@@ -257,31 +256,37 @@ var PlanModeController = class extends Service {
 				if (!/^#\s+\S/.test(args.plan.trim())) throw new Error(`${EXIT_PLAN_MODE} requires a non-empty markdown plan starting with a # heading`);
 				const interaction = ctx.get("userQuestions");
 				if (interaction === void 0) throw new Error("no user-questions channel is available to review the plan; ask the user to switch the session mode instead");
-				const answer = await interaction.ask({
-					questions: [{
-						id: REVIEW_ID,
-						header: "Plan review",
-						question: "Approve this plan and leave plan mode?",
-						detail: args.plan,
-						options: [{
-							label: APPROVE_LABEL,
-							description: "Leave plan mode; the plan is carried out from the next step."
-						}, {
-							label: KEEP_PLANNING_LABEL,
-							description: "Stay in plan mode; feedback goes back to the model."
+				let answer;
+				try {
+					answer = await interaction.ask({
+						questions: [{
+							id: REVIEW_ID,
+							header: "Plan review",
+							question: "Approve this plan and leave plan mode?",
+							detail: args.plan,
+							options: [{
+								label: APPROVE_LABEL,
+								description: "Leave plan mode; the plan is carried out from the next step."
+							}, {
+								label: KEEP_PLANNING_LABEL,
+								description: "Stay in plan mode; feedback goes back to the model."
+							}],
+							intent: {
+								kind: "plan-review",
+								approve: APPROVE_LABEL,
+								callId: exec.callId
+							}
 						}],
-						intent: {
-							kind: "plan-review",
-							approve: APPROVE_LABEL,
-							callId: exec.callId
-						}
-					}],
-					agent,
-					signal: exec.signal
-				}).catch((cause) => {
-					if (cause instanceof UserQuestionError && cause.code === "ASK_CANCELLED") throw new Error("The user dismissed the plan review to speak instead; stay in plan mode, stop here, and wait for their message.");
+						agent,
+						signal: exec.signal
+					});
+				} catch (cause) {
+					if (cause instanceof UserQuestionError && cause.code === "ASK_CANCELLED") {
+						exec.concludeTurn();
+						return { approved: false };
+					}
 					throw cause;
-				});
+				}
 				if (disposed) throw new Error("the plan-mode service was reloaded while the plan was under review; present the plan again");
 				const reviewItems = answer.answers.filter((entry) => entry.id === REVIEW_ID);
 				const item = reviewItems.length === 1 ? reviewItems[0] : void 0;

package/lib/types/index.js

@@ -230,10 +230,15 @@ export class PlanModeController extends Service {
                     type: 'object',
                     additionalProperties: false,
                     properties: {
-                        approved: { type: 'boolean', const: true, required: true },
+                        approved: { type: 'boolean', required: true },
                     },
                 },
-                render: () => [{ type: 'text', text: 'Plan approved — plan mode exited; carry out the plan starting with your next step.' }],
+                render: (_args, { approved }) => [{
+                        type: 'text',
+                        text: approved
+                            ? 'Plan approved — plan mode exited; carry out the plan starting with your next step.'
+                            : 'The user dismissed the plan review to reply in their own words; plan mode remains active.',
+                    }],
             },
             execute: async (args, exec) => {
                 const agent = exec.agent;
@@ -249,35 +254,38 @@ export class PlanModeController extends Service {
                 if (interaction === undefined) {
                     throw new Error('no user-questions channel is available to review the plan; ask the user to switch the session mode instead');
                 }
-                const answer = await interaction.ask({
-                    questions: [{
-                            id: REVIEW_ID,
-                            header: 'Plan review',
-                            question: 'Approve this plan and leave plan mode?',
-                            detail: args.plan,
-                            options: [
-                                { label: APPROVE_LABEL, description: 'Leave plan mode; the plan is carried out from the next step.' },
-                                { label: KEEP_PLANNING_LABEL, description: 'Stay in plan mode; feedback goes back to the model.' },
-                            ],
-                            // 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, callId: exec.callId },
-                        }],
-                    agent,
-                    signal: exec.signal,
-                }).catch((cause) => {
+                let answer;
+                try {
+                    answer = await interaction.ask({
+                        questions: [{
+                                id: REVIEW_ID,
+                                header: 'Plan review',
+                                question: 'Approve this plan and leave plan mode?',
+                                detail: args.plan,
+                                options: [
+                                    { label: APPROVE_LABEL, description: 'Leave plan mode; the plan is carried out from the next step.' },
+                                    { label: KEEP_PLANNING_LABEL, description: 'Stay in plan mode; feedback goes back to the model.' },
+                                ],
+                                // 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, callId: exec.callId },
+                            }],
+                        agent,
+                        signal: exec.signal,
+                    });
+                }
+                catch (cause) {
                     // A dismissed review is not a failed one: the user took the turn back
-                    // to say something the two options do not cover. Say so, because the
-                    // generic channel message names ask_user_question, which the model
-                    // never called. An abort (turn cancel, provider teardown) keeps its
-                    // own message — there is no user to wait for.
+                    // to say something the two options do not cover, so the turn ends
+                    // here instead of spending a model request on waiting. An abort (turn
+                    // cancel, provider teardown) keeps its own failure.
                     if (cause instanceof UserQuestionError && cause.code === 'ASK_CANCELLED') {
-                        throw new Error('The user dismissed the plan review to speak instead; '
-                            + 'stay in plan mode, stop here, and wait for their message.');
+                        exec.concludeTurn();
+                        return { approved: false };
                     }
                     throw cause;
-                });
+                }
                 // A review may outlive this plugin fiber. Without its pre-step listener,
                 // an approved selection could never be appended, so fail and keep planning.
                 if (disposed) {

package/locale/en.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "title": "plan-mode"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "计划模式",
+    "description": "让 AI 先制定计划，并在用户审阅后切换到执行。"
+  }
+}

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.2.1-alpha.2",
+  "version": "0.2.1-alpha.4",
   "publishConfig": {
     "access": "public"
   },
@@ -27,24 +27,26 @@
       "default": "./lib/types/client.js"
     },
     "./src/*": "./src/*",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "files": [
+    "locale/*.json",
     "lib/index.js",
     "lib/types/**/*.js",
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-commands": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-user-questions": "0.2.1-alpha.2",
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-commands": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-user-questions": "0.2.1-alpha.4",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-commands": {
@@ -52,21 +54,21 @@
     }
   },
   "dependencies": {
-    "@deepseek-ai/dsh-brand": "0.2.1-alpha.2",
-    "zod": "^4.4.3"
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.4",
+    "zod": "4.4.3"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-ptc-runtime": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-commands": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-user-questions": "0.2.1-alpha.2",
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.2"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-ptc-runtime": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-commands": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-user-questions": "0.2.1-alpha.4",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.4"
   }
 }