@deepseek-ai/dsh-client-ui-plan 0.0.1-rc.1

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, DeepSeek
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# 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/client/ui-plan/README.md
+README.md: fcc4fbab4fbe1a8cc27119366b21ef55c669ba30
+README.zh.md: f512d40568058ef061c6f262eadb20acda78cb64

package/README.md

@@ -0,0 +1,25 @@
+# @deepseek-ai/dsh-client-ui-plan
+
+English | [中文](README.zh.md)
+
+Plan-mode status chip, a pure browser surface plugin. The browser half occupies the conversation-declared `conversation.input.plan` single seat (to the right of the access-mode control); the node half is an empty apply (the roster row). Plan behavior itself — the `/plan` command, the boundary-or-idle-committed `plan/mode` state, the `plan` projection unit, and the policy section — is owned by [`@deepseek-ai/dsh-plan-mode`](../../plan/plan-mode/README.md), composed independently on the host roster.
+
+Plan mode is entered through the `/plan` command path: users can choose Plan from the composer's `+` Command menu or type `/plan`, while this package renders no inactive plan control. While the host-computed `plan` projection's effective target is plan mode (`pending ? !active : active` — a folded host value, not client optimism, so an arriving frame corrects the chip either way), the seat renders the warn-colored "Plan ×" status button, which executes `/plan off` through `command.execute`; otherwise the seat stays empty — a host without plan-mode (or a Draft with no session) shows nothing. While plan mode is the effective target, the composer textarea's placeholder switches to the plan-task hint — "describe your task to generate plan", localized through ui-conversation's `conversation` locale namespace (the `placeholder.plan` / `hint.plan` keys) and shared verbatim with the claimed `/plan` command hint (rendered by the composer from the same projection; owner-supplied placeholders win).
+
+The chip carries the accessible description "Plan mode on, press to turn off". Admission failures (`matched: false`, business errors, transport faults) surface as an inline error and the chip stays until the projection confirms the exit.
+
+The model exits plan mode through the stable `exit_plan_mode` tool; its plan review uses the composed Web question channel.
+
+## Model Experience
+
+Indirectly, through the `/plan off` command line the chip dispatches: `@deepseek-ai/dsh-plan-mode` owns the model-visible policy section, the exit-tool schema, and the logged state that line drives, while this package only renders the projection and sends what a user could equally type.
+
+#### KV Cache effect
+
+Entering or leaving plan mode changes the active `plan:policy` system-prompt section and therefore the request prefix; the chip itself adds no prompt content.
+
+## Known Limitations and Deferred Work
+
+- **Plan mode is guidance, not an execution sandbox** — deployments that require enforced read-only planning must compose the independent sandbox and approval policies.
+- **The chip belongs to the default composer** — a pending whole-composer interaction such as plan review temporarily replaces the InputBar and its chip.
+- **No inactive plan control** — entry uses the shared Command source; a session with the capability but inactive mode shows no plan affordance in the tool row.

package/README.zh.md

@@ -0,0 +1,25 @@
+# @deepseek-ai/dsh-client-ui-plan
+
+[English](README.md) | 中文
+
+Plan mode 状态徽章，纯浏览器 surface 插件。浏览器侧占用会话声明的 `conversation.input.plan` 单实例 seat（位于 access 模式控件右侧）；node 侧是空 apply（roster 行）。plan 行为本身——`/plan` 命令、边界或空闲即时提交的 `plan/mode` 状态、`plan` 投影单元与 policy 段——归 [`@deepseek-ai/dsh-plan-mode`](../../plan/plan-mode/README.md) 所有，由 host roster 独立组合。
+
+plan mode 经 `/plan` 命令路径进入：用户可以从 composer 的 `+` Command 菜单选择 Plan，也可以输入 `/plan`，而本包不渲染未激活态 plan 控件。当 host 计算的 `plan` 投影有效目标为 plan mode 时（`pending ? !active : active`——折叠的 host 值而非客户端乐观态，帧到达即自动纠正），座位渲染 warn 色的 "Plan ×" 状态按钮，该按钮经 `command.execute` 执行 `/plan off`；否则座位保持为空——未组合 plan-mode 的 host（或尚无会话的 Draft）不显示任何内容。plan mode 为有效目标期间，composer 文本框的 placeholder 切换为 plan 任务提示——"describe your task to generate plan"（中文「描述你的任务以生成计划」），经 ui-conversation 的 `conversation` locale 命名空间（`placeholder.plan` / `hint.plan` 键）本地化，并与已认领 `/plan` 命令的提示逐字共用同一份文案（由 composer 从同一投影渲染；owner 提供的 placeholder 优先）。
+
+chip 携带无障碍描述 "Plan mode on, press to turn off"。准入失败（`matched: false`、业务错误、传输故障）以内联错误呈现，chip 保持显示直至投影确认退出。
+
+模型通过稳定的 `exit_plan_mode` 工具退出 plan mode；其 plan 评审走已组合的 Web question 通道。
+
+## 模型体验
+
+间接地，通过 chip 派发的 `/plan off` 命令行：`@deepseek-ai/dsh-plan-mode` 拥有该命令行驱动的模型可见 policy 段、退出工具 schema 与已记录状态，本包只渲染投影并发送用户同样可以手敲的内容。
+
+#### KV Cache 影响
+
+进入或离开 plan mode 会改变活跃的 `plan:policy` 系统提示词段，因此改变请求前缀；chip 本身不添加任何提示词内容。
+
+## 已知局限与延后工作
+
+- **Plan mode 是引导而非执行沙箱**：需要强制只读规划的部署必须组合独立的沙箱与审批策略。
+- **chip 属于默认编辑器**：待处理的整编辑器交互（如 plan 评审）会临时取代 InputBar 及其 chip。
+- **无未激活态 plan 控件**——入口使用共享 Command source；有能力但 mode 未激活的会话在工具行不显示 plan 入口。

package/lib/client.js

@@ -0,0 +1,138 @@
+window.__ModuleLoader__.load({
+	id: "@deepseek-ai/dsh-client-ui-plan",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react_jsx_runtime = require("react/jsx-runtime");
+		let react = require("react");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-plan/src/client/PlanModeControl.module.css.mjs
+		const css = ".rS3zOq_wrap{align-items:center;gap:6px;display:inline-flex}.rS3zOq_chip{background:var(--dsw-alias-state-warn-tertiary);min-width:34px;color:var(--dsw-alias-state-warn-label);cursor:pointer;border:none;border-radius:999px;align-items:center;gap:4px;padding:2px 8px;font-size:13px;font-weight:500;line-height:20px;display:inline-flex}.rS3zOq_chip:hover:not(:disabled){color:var(--dsw-alias-state-warn-primary)}.rS3zOq_chip:focus-visible{outline:2px solid var(--dsw-alias-state-warn-label);outline-offset:2px}.rS3zOq_chip:disabled{opacity:.6;cursor:default}.rS3zOq_close{color:currentColor;align-items:center;display:inline-flex}.rS3zOq_error{color:var(--dsw-alias-state-error-primary);font-size:12px;line-height:18px}";
+		const tagId = "@deepseek-ai/dsh-client-ui-plan/PlanModeControl.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-plan";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var PlanModeControl_module_css_default = {
+			"chip": "rS3zOq_chip",
+			"wrap": "rS3zOq_wrap",
+			"close": "rS3zOq_close",
+			"error": "rS3zOq_error"
+		};
+		//#endregion
+		//#region lib/types/client/PlanModeControl.js
+		/**
+		* Plan-mode status over the host-computed `plan` projection. The chip renders
+		* only while the effective target is plan mode (`pending ? !active : active`
+		* — a folded host value, not client optimism) and executes /plan off.
+		*/
+		function PlanChip({ useProjection, locked, exitPlanMode, t }) {
+			const plan = useProjection("plan");
+			const [leaving, setLeaving] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)(null);
+			const aliveRef = (0, react.useRef)(true);
+			(0, react.useEffect)(() => {
+				aliveRef.current = true;
+				return () => {
+					aliveRef.current = false;
+				};
+			}, []);
+			if (plan === void 0) return null;
+			if (!(plan.pending ? !plan.active : plan.active)) return null;
+			const off = () => {
+				setLeaving(true);
+				setError(null);
+				exitPlanMode().then((failure) => {
+					if (!aliveRef.current) return;
+					setLeaving(false);
+					setError(failure);
+				}, (reason) => {
+					if (!aliveRef.current) return;
+					setLeaving(false);
+					setError(reason instanceof Error ? reason.message : String(reason));
+				});
+			};
+			return (0, react_jsx_runtime.jsxs)("span", {
+				className: PlanModeControl_module_css_default.wrap,
+				children: [(0, react_jsx_runtime.jsxs)("button", {
+					type: "button",
+					className: PlanModeControl_module_css_default.chip,
+					"aria-label": t("chip.on.aria"),
+					title: t("chip.on.title"),
+					disabled: locked || leaving,
+					onClick: off,
+					children: ["Plan", (0, react_jsx_runtime.jsx)("span", {
+						className: PlanModeControl_module_css_default.close,
+						"aria-hidden": true,
+						children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseFill14, { size: 12 })
+					})]
+				}), error !== null && (0, react_jsx_runtime.jsx)("span", {
+					className: PlanModeControl_module_css_default.error,
+					role: "status",
+					title: error,
+					children: "failed to exit plan mode"
+				})]
+			});
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** `plan` namespace dictionaries (the composer plan chip's copy). */
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"chip.on.aria": "plan mode 已开启，按下关闭",
+			"chip.on.title": "plan mode 已开启 — 点击关闭（/plan off）",
+			"chip.off.aria": "plan mode 已关闭，按下开启",
+			"chip.off.title": "plan mode 已关闭 — 点击开启（/plan）"
+		};
+		/** English dictionary, checked complete against the zh key set. */
+		const en = {
+			"chip.on.aria": "Plan mode on, press to turn off",
+			"chip.on.title": "Plan mode on — click to turn off (/plan off)",
+			"chip.off.aria": "Plan mode off, press to turn on",
+			"chip.off.title": "Plan mode off — click to turn on (/plan)"
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Dictionary namespace owned by this plugin. */
+		const NS = "plan";
+		/** Required services: the seat's slot registry, transport, and locale registry. */
+		const inject = [
+			"slots",
+			"connection",
+			"locale"
+		];
+		/**
+		* Client plugin body: register the plan chip over the command channel.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-plan: dictionaries");
+			ctx.slots.inject("conversation.input.plan", () => ctx.slots.register({
+				name: "conversation.input.plan",
+				locale: NS,
+				inject: (sessionId) => ({ exitPlanMode: async () => {
+					const { result } = await ctx.get("connection").api.commands.execute({
+						sessionId,
+						line: "/plan off"
+					});
+					if (!result.ok) return `${result.error.message} (${result.error.code})`;
+					if (!result.value.matched) return "unknown command: /plan off";
+					return null;
+				} })
+			}, PlanChip));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,13 @@
+//#region lib/types/index.js
+/**
+* Plan control plugin, node half. Pure UI plugin: the empty apply exists so
+* the plugin appears in the host cordis.yml / Loader; the browser half ships
+* via exports["./client"], discovered through the package.json dsh.client
+* declaration. Plan behavior itself (the /plan command, the plan projection
+* unit, the policy section) is owned by `@deepseek-ai/dsh-plan-mode`,
+* composed independently on the host roster.
+*/
+/** Host plugin body — no host-side behavior for this surface plugin. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,24 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-plan`.
+* @module @deepseek-ai/dsh-client-ui-plan/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-client-ui-plan";
+/** Cordis companion plugin name. */
+const name = "client-ui-plan-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: plan state and boundary ownership are
+* audited by dsh-plan-mode, while the control is a slot effect whose
+* declaration, registration, and teardown are exercised by this package.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns The installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/client/PlanModeControl.d.ts

@@ -0,0 +1,11 @@
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PlanChipInjected } from './index.ts';
+/** Full plan-seat component props: runtime share (standard kit + locked owner prop) & injected share & the locale seat. */
+export type PlanChipProps = PropsRuntime<'conversation.input.plan'> & InjectFace<PlanChipInjected> & PropsLocale<'plan'>;
+/**
+ * Plan-mode status over the host-computed `plan` projection. The chip renders
+ * only while the effective target is plan mode (`pending ? !active : active`
+ * — a folded host value, not client optimism) and executes /plan off.
+ */
+export declare function PlanChip({ useProjection, locked, exitPlanMode, t }: PlanChipProps): import("react").JSX.Element | null;
+//# sourceMappingURL=PlanModeControl.d.ts.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,25 @@
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type PlanKey } from './locales.ts';
+export type { PlanKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The composer plan chip's copy. */
+        plan: PlanKey;
+    }
+}
+/** Injected business face of the composer plan seat. */
+export interface PlanChipInjected {
+    /**
+     * Leave plan mode by executing /plan off.
+     * @returns null on admitted execution; a user-visible failure line otherwise.
+     */
+    exitPlanMode: () => Promise<string | null>;
+}
+/** Required services: the seat's slot registry, transport, and locale registry. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the plan chip over the command channel.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,18 @@
+/** `plan` namespace dictionaries (the composer plan chip's copy). */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'chip.on.aria': string;
+    'chip.on.title': string;
+    'chip.off.aria': string;
+    'chip.off.title': string;
+};
+/** The plan namespace key union. */
+export type PlanKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'chip.on.aria': string;
+    'chip.on.title': string;
+    'chip.off.aria': string;
+    'chip.off.title': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Plan control plugin, node half. Pure UI plugin: the empty apply exists so
+ * the plugin appears in the host cordis.yml / Loader; the browser half ships
+ * via exports["./client"], discovered through the package.json dsh.client
+ * declaration. Plan behavior itself (the /plan command, the plan projection
+ * unit, the policy section) is owned by `@deepseek-ai/dsh-plan-mode`,
+ * composed independently on the host roster.
+ */
+/** Host plugin body — no host-side behavior for this surface plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-plan`.
+ * @module @deepseek-ai/dsh-client-ui-plan/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-plan-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns The installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@deepseek-ai/dsh-client-ui-plan",
+  "description": "Plan-mode composer control: the conversation.input.plan seat over the plan projection and the /plan command channel",
+  "version": "0.0.1-rc.1",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-plan"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "BSD-3-Clause",
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-plan-mode": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-plan-mode": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}