@deepseek-ai/dsh-plan-mode 0.0.1-rc.2 → 0.0.1-rc.3

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: b4e890f6b11998879119657ee73eb24826c101e1
-README.zh.md: e89b75df184d2283452ab069a2d559650f15bfef
+README.md: 7171997406ea43487762d9947d07426df400c78a
+README.zh.md: 5c04cdabc293c9abda6bb5e77f596715ee137c6f

package/README.md

@@ -12,7 +12,7 @@ Logged, per-agent plan collaboration state with deployment-owned guidance, direc
 
 ## Model and human interactions
 
-While active, `plan:policy` renders the configured `section`. The plugin always registers `exit_plan_mode`, keeping tool schemas stable across the transition; its execute path accepts only active plan mode and leaves it only after an exact user approval through `ctx.userInteraction`.
+While active, `plan:policy` renders the configured `section`. The plugin always registers `exit_plan_mode`, keeping tool schemas stable across the transition; its execute path accepts only active plan mode and leaves it only after an exact user approval through `ctx.userQuestions`.
 
 The review question declares the `plan-review` presentation intent, naming `Approve` as the label that approves it, so a capable UI presents the plan as a decision instead of a generic question; the answer the tool reads is the same either way. A dismissed review — the user closing the request to speak instead — is reported to the model as such, telling it to stay in plan mode and wait for the message; every other review failure keeps the seam's own message.
 
@@ -83,7 +83,7 @@ The [`exit_plan_mode` schema](../../../docs/tool-catalog.md#deepseek-aidsh-plan-
 
 #### Token effect
 
-The stable schema is paid according to ToolRegistry mode, and each plan argument and review result remains in conversation history.
+The stable schema is paid according to ToolRuntime mode, and each plan argument and review result remains in conversation history.
 
 #### KV Cache effect
 

package/README.zh.md

@@ -8,13 +8,13 @@
 
 `plan/mode`（`{ active: boolean }`）是一个仅存在于日志中、每次以完整值替换的 `SessionEventMap` 成员。`foldPlanMode(events)` 返回最后记录的值，如果没有则返回 `false`，因此恢复、fork 和压缩（compaction）都能直接从会话日志恢复 plan 状态。UI 通过 `session/event` 观察已提交的切换。
 
-`ctx.planMode.set(agent, active)` 会在 agent 空闲时立即追加独立的 `plan/mode` 事件，因为下一个 prompt 之前不会运行轮内 pre-step。agent 运行时，该方法会保留待生效选择，直到下一个被接受的轮内 pre-step。返回值区分 `committed`、`queued`、表示反转的 `cancelled` 和 `noop`。`get(agent)` 返回 `{ active, pending? }`，将用于组装当前步骤的日志状态与用户的轮中选择分开。初始与续步 pre-step 都会应用待生效选择；同一步骤的请求恢复重试会复用已冻结的 assembly，并将该选择保留到下一个被接受的轮内 pre-step。当最后记录的请求头描述了另一状态时，用户选择的变更会贡献一条插件来源的 `user/message` 通知（两条追加路径皆然）。
+`ctx.planMode.set(agent, active)` 会在 agent 空闲时立即追加独立的 `plan/mode` 事件，因为下一个提示词之前不会运行轮内 pre-step。agent 运行时，该方法会保留待生效选择，直到下一个被接受的轮内 pre-step。返回值区分 `committed`、`queued`、表示反转的 `cancelled` 和 `noop`。`get(agent)` 返回 `{ active, pending? }`，将用于组装当前步骤的日志状态与用户的轮中选择分开。初始与续步 pre-step 都会应用待生效选择；同一步骤的请求恢复重试会复用已冻结的 assembly，并将该选择保留到下一个被接受的轮内 pre-step。当最后记录的请求头描述了另一状态时，用户选择的变更会贡献一条插件来源的 `user/message` 通知（两条提交路径皆然）。
 
 ## 模型与人类交互
 
-激活时，`plan:policy` 会渲染已配置的 `section`。插件始终注册 `exit_plan_mode`，使工具 schema 在转换期间保持稳定；其 execute 路径只接受已激活的 plan mode，且只有通过 `ctx.userInteraction` 获得用户明确批准后才退出。
+激活时，`plan:policy` 会渲染已配置的 `section`。插件始终注册 `exit_plan_mode`，使工具 schema 在转换期间保持稳定；其 execute 路径只接受已激活的 plan mode，且只有通过 `ctx.userQuestions` 获得用户明确批准后才退出。
 
-评审问题声明 `plan-review` 呈现意图，并指名 `Approve` 为表示批准的标签，因此有能力的 UI 会把计划呈现为一次决定而非通用问题；两种情况下该工具读到的回答完全相同。放弃审阅 —— 用户关掉请求改用说话 —— 会如实报告给模型，要求它留在 plan mode 中等待那条消息；其余每一种评审失败都保留 seam 自身的消息。
+评审问题声明 `plan-review` 呈现意图，并指名 `Approve` 为表示批准的标签，因此有能力的 UI 会把计划呈现为一次决定而非通用问题；两种情况下该工具读到的回答完全相同。放弃审阅——用户关闭请求，转而发言——会如实报告给模型，要求它留在 plan mode 中等待那条消息；其余每一种评审失败都保留 seam 自身的消息。
 
 组合 `ctx.commands` 时，该包会注册 `/plan [message]`，并将参数恰好为 `off` 的情况保留给直接退出。不带参数的 `/plan` 会启用 plan mode；任何其他非空参数都会先启用 plan mode，再通过 `agent.steer()` 提交，因此它会在 plan 引导下成为下一步骤的常规已记录用户消息。`/plan off` 会选择停用状态，不发送模型输入；它还可以在启用 plan mode 的待处理选择由轮内 pre-step 追加之前将其取消。
 
@@ -69,7 +69,7 @@ You are in plan mode. Explore and design before presenting the complete plan thr
 
 #### Token 影响
 
-可选消息的历史 token 成本与单独提交该文本相同；不带参数的 `/plan` 和 `/plan off` 不增加 token。退出已激活的 plan mode 时，如果记录了该转换，还会追加一条简短且会保留的切换通知。
+可选消息的历史 token 成本与单独提交该文本相同；不带参数的 `/plan` 和 `/plan off` 不增加 token。一次带有切换通知的已激活状态退出会追加一条简短且会保留的通知。
 
 #### KV Cache 影响
 
@@ -83,7 +83,7 @@ You are in plan mode. Explore and design before presenting the complete plan thr
 
 #### Token 影响
 
-稳定 schema 的成本取决于 ToolRegistry mode，每次传入的 plan 参数和评审结果都会保留在对话历史中。
+稳定 schema 的成本取决于 ToolRuntime mode，每次传入的 plan 参数和评审结果都会保留在对话历史中。
 
 #### KV Cache 影响
 

package/lib/index.js

@@ -2,7 +2,7 @@ import { Service } from "@deepseek-ai/cordis";
 import { z } from "zod";
 import { createUserMessage } from "@deepseek-ai/dsh-llm";
 import { defineTool } from "@deepseek-ai/dsh-tools";
-import { UserInteractionError } from "@deepseek-ai/dsh-user-interaction";
+import { UserQuestionError } from "@deepseek-ai/dsh-user-questions";
 //#region lib/types/index.js
 /**
 * Plan mode is logged per-agent collaboration state: while active, a
@@ -108,7 +108,7 @@ function planModeAtLastHeader(events) {
 * the `plan:policy` section, the `/plan` command, and the stable exit tool.
 * UIs observe committed flips through `session/event`; there is no live mirror.
 */
-var PlanModeService = class extends Service {
+var PlanModeController = class extends Service {
 	static inject = ["tools", "systemPrompt"];
 	/** Validated deployment-owned guidance. */
 	section;
@@ -250,8 +250,8 @@ var PlanModeService = class extends Service {
 				if (agent === void 0) throw new Error(`${EXIT_PLAN_MODE} requires a calling agent (no session to switch)`);
 				if (!foldPlanMode(agent.session.events)) throw new Error(`${EXIT_PLAN_MODE} is only available in plan mode`);
 				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("userInteraction");
-				if (interaction === void 0) throw new Error("no user-interaction channel is available to review the plan; ask the user to switch the session mode instead");
+				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,
@@ -273,7 +273,7 @@ var PlanModeService = class extends Service {
 					agent,
 					signal: exec.signal
 				}).catch((cause) => {
-					if (cause instanceof UserInteractionError && 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.");
+					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.");
 					throw cause;
 				});
 				if (disposed) throw new Error("the plan-mode service was reloaded while the plan was under review; present the plan again");
@@ -388,4 +388,4 @@ var PlanModeService = class extends Service {
 	}
 };
 //#endregion
-export { EXIT_PLAN_MODE, PlanModeService, PlanModeService as default, foldPlanMode, resolveConfig };
+export { EXIT_PLAN_MODE, PlanModeController, PlanModeController as default, foldPlanMode, resolveConfig };

package/lib/types/index.d.ts

@@ -40,7 +40,7 @@ declare module '@deepseek-ai/dsh-session/types' {
 }
 declare module '@deepseek-ai/cordis' {
     interface Context {
-        planMode: PlanModeService;
+        planMode: PlanModeController;
     }
 }
 /**
@@ -75,7 +75,7 @@ export declare function foldPlanMode(events: readonly SessionEvent[], end?: numb
  * the `plan:policy` section, the `/plan` command, and the stable exit tool.
  * UIs observe committed flips through `session/event`; there is no live mirror.
  */
-export declare class PlanModeService extends Service {
+export declare class PlanModeController extends Service {
     static inject: string[];
     /** Validated deployment-owned guidance. */
     private readonly section;
@@ -119,5 +119,5 @@ export declare class PlanModeService extends Service {
     /** Build a user-switch notice when the last logged header described the other mode. */
     private narration;
 }
-export default PlanModeService;
+export default PlanModeController;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/index.js

@@ -26,7 +26,7 @@ import { Service } from '@deepseek-ai/cordis';
 import { z as zod } from 'zod';
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
 import { defineTool } from '@deepseek-ai/dsh-tools';
-import { UserInteractionError } from '@deepseek-ai/dsh-user-interaction';
+import { UserQuestionError } from '@deepseek-ai/dsh-user-questions';
 /**
  * The model-facing exit tool's name. It stays registered while plan mode is
  * inactive so the request tool catalog is stable across transitions.
@@ -126,7 +126,7 @@ function planModeAtLastHeader(events) {
  * the `plan:policy` section, the `/plan` command, and the stable exit tool.
  * UIs observe committed flips through `session/event`; there is no live mirror.
  */
-export class PlanModeService extends Service {
+export class PlanModeController extends Service {
     static inject = ['tools', 'systemPrompt'];
     /** Validated deployment-owned guidance. */
     section;
@@ -268,9 +268,9 @@ export class PlanModeService 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('userInteraction');
+                const interaction = ctx.get('userQuestions');
                 if (interaction === undefined) {
-                    throw new Error('no user-interaction channel is available to review the plan; ask the user to switch the session mode instead');
+                    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: [{
@@ -295,7 +295,7 @@ export class PlanModeService extends Service {
                     // 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.
-                    if (cause instanceof UserInteractionError && cause.code === 'ASK_CANCELLED') {
+                    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.');
                     }
@@ -414,5 +414,5 @@ export class PlanModeService extends Service {
         });
     }
 }
-export default PlanModeService;
+export default PlanModeController;
 //# sourceMappingURL=index.js.map

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.0.1-rc.2",
+  "version": "0.0.1-rc.3",
   "publishConfig": {
     "access": "restricted"
   },
@@ -41,16 +41,16 @@
   ],
   "license": "BSD-3-Clause",
   "peerDependencies": {
-    "@deepseek-ai/dsh-commands": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-agent": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-session": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-agent": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-commands": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-system-prompt": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-tools": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-user-questions": "^0.0.1-rc.3",
     "@deepseek-ai/cordis": "^4.0.1-rc.1",
-    "@deepseek-ai/dsh-user-interaction": "^0.0.1-rc.2"
+    "@deepseek-ai/dsh-session-projection": "^0.0.1-rc.3"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-commands": {
@@ -61,17 +61,17 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-agent": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-agent-loop": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-code-runtime": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-commands": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-session": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.0.1-rc.2",
-    "@deepseek-ai/dsh-user-interaction": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-agent": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-agent-loop": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-code-runtime": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-commands": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-session-projection": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-system-prompt": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-tools": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-user-questions": "^0.0.1-rc.3",
     "@deepseek-ai/cordis": "^4.0.1-rc.1"
   }
 }