@deepseek-ai/dsh-client-ui-user-questions 0.0.1-rc.3

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-user-questions/README.md
+README.md: ba4b23150a7f3a2536db97df99410cb92238210e
+README.zh.md: 96c81800ef85514c565defecc779da7d2e6523b7

package/README.md

@@ -0,0 +1,26 @@
+# @deepseek-ai/dsh-client-ui-user-questions
+
+English | [中文](README.zh.md)
+
+Web question feature plugin: its browser half registers the `question` entry in the conversation-owned `conversation.composer` keyed slot. Its host half is empty on purpose — mounting `dsh-tool-ask-user` there put the tool in the registry's GLOBAL layer, which merges into every agent regardless of the preset that composed it, so a two-tool benchmark preset really presented three. Rendering a question is a host UI capability; having the tool is an agent capability, so the `tool-ask-user` row belongs to the presets that want it (and to the TUI composition, which has no presets).
+
+The component renders one question at a time with progress navigation, single- and multi-select choices, recommendation badges derived from label suffixes, and custom answers. A multi-select draft keeps its selected labels while the user opens or edits the custom answer, so its submitted item may carry both `selected` and `custom`; a single-select custom answer remains exclusive. Question detail reuses the assistant-output `MarkdownText` primitive, including its GFM rendering and untrusted-content policy. The capped card keeps its title, navigation, and submission actions fixed while long detail and choices share an internal scroll region. Single-select choices advance immediately, and Enter submits once every question is answered or skipped; Enter during IME composition confirms the input candidate without advancing. It submits one structured answer batch for the whole request: “Skip this question” retains other drafts and emits the existing blank `{ selected: [] }` shape for that item, while close rejects the whole wait as `ASK_CANCELLED`.
+
+A request whose single question declares a presentation intent renders as that intent's own surface instead. `plan-review` — set by `dsh-plan-mode` on the `exit_plan_mode` review — takes the waiting-approval card shape: a `Plan review` strip, the plan as the scrolling markdown body, the question text as the card's accessible name, and one decision row of `Chat about it` / `Refuse` / `Approve`. Approve and Refuse answer with the asker's own option labels (the intent names which label approves, so the verdict never rides option order) and keep the asker's descriptions as tooltips; `Chat about it` rejects the wait as `ASK_CANCELLED`, returning the composer so the user can say what they want instead. The card claims a request only when it can send every answer that request allows: one question, the intent declared, the plan present as `detail`, the named approve label offered, and a binary single choice (at most one option besides approve, not multi-select). Anything else — no intent, a batch of several questions, a missing plan, an approve label naming no option, a third option, a multi-select decision — stays on the generic flow, which can express it. An intent changes the layout, never which answers are reachable.
+
+Selection state is local to a component keyed by the request rpcId. A replay with the same id preserves a still-mounted draft, while `question/resolved` from the host removes the composer. The host remains authoritative: successful HTTP delivery does not remove pending state locally.
+
+Composer chrome copy (pager, buttons, placeholders, validation feedback) is bilingual: the plugin registers zh/en dictionaries under the `question` namespace of `dsh-client-locale` and hands the entry its bound translator plus the locale snapshot source through the inject face, so a locale switch re-renders a mounted composer. Question and option text arrives from the model and renders verbatim; carrier failure messages also display untranslated.
+
+## Model Experience
+
+Indirectly, through `dsh-tool-ask-user`; that package owns the model-visible tool schema and structured result.
+
+#### KV Cache effect
+
+No direct invalidation; `dsh-tool-ask-user` owns the model-visible tool call and result.
+
+## Known Limitations and Deferred Work
+
+- **Unsubmitted drafts are not durable** — reconnect resync or a full page reload restores the host-owned pending request with the same rpcId, but a composer unmount resets local option and custom-text drafts.
+- **One request owns the composer at a time** — later pending requests remain in the session snapshot and become visible after the earlier request resolves.

package/README.zh.md

@@ -0,0 +1,26 @@
+# @deepseek-ai/dsh-client-ui-user-questions
+
+[English](README.md) | 中文
+
+Web 提问功能插件：其浏览器侧把 `question` 条目注册到会话拥有的 `conversation.composer` 键控 slot 中。其主机侧刻意为空——在那里挂载 `dsh-tool-ask-user` 会把工具放进注册表的**全局层**，而全局层会并入每一个 agent（智能体），无论它由哪个 preset 组装，于是一个「两工具」的 benchmark preset 实际会呈现三个。渲染提问是宿主的 UI 能力，拥有该工具则是 agent 的能力，因此 `tool-ask-user` 行属于需要它的各个 preset（以及没有 preset 的 TUI 组装）。
+
+组件每次渲染一个问题，提供进度导航、单选和多选选项、由标签后缀派生的推荐徽标，以及自定义答案。用户打开或编辑自定义答案时，多选题草稿会保留已选中的标签，因此提交项可以同时携带 `selected` 与 `custom`；单选题的自定义答案仍保持互斥。问题详情复用助手输出的 `MarkdownText` 原语，包括其 GFM 渲染与不受信任内容策略。限高卡片保持标题、导航与提交动作固定，超长的详情与选项共享内部滚动区。选择单选选项后会立即前进；所有问题均已回答或跳过后，Enter 会提交；IME 组合输入期间按 Enter 只会确认输入候选，不会前进。组件为整个请求提交一批结构化答案：「跳过此问题」会保留其他草稿，并为该项发出既有的空 `{ selected: [] }` 形状；关闭则以 `ASK_CANCELLED` 拒绝整个等待。
+
+若某个请求的唯一问题声明了呈现意图，则改为渲染该意图自己的界面。`plan-review`——由 `dsh-plan-mode` 在 `exit_plan_mode` 审阅上设置——采用等待审批卡片的形状：一条 `Plan review` 条带、计划作为可滚动的 markdown 主体、问题文本作为卡片的无障碍名称，以及一行 `Chat about it` / `Refuse` / `Approve` 的决定操作。Approve 与 Refuse 用提问方自己的选项标签回答（意图指名哪个标签表示批准，因此裁决绝不依赖选项顺序），并把提问方的描述保留为 tooltip；`Chat about it` 以 `ASK_CANCELLED` 拒绝该等待，让编辑器归位，用户可以直接说出他想说的话。卡片只在能够发出该请求允许的每一个答案时才接管：只有一个问题、声明了意图、计划以 `detail` 存在、提供了被指名的批准标签，且是二元单选（除批准外最多一个选项，且非多选）。其他任何情形——没有意图、一批含多个问题、缺少计划、批准标签未命中任何选项、出现第三个选项、多选决定——都留在能够表达它的通用流程上。意图改变的只是布局，从不改变可达的答案。
+
+选择状态只存在于以请求 rpcId 为 key 的组件本地。使用相同 id 回放时，只要组件仍挂载，就会保留草稿；主机发出的 `question/resolved` 则会移除编辑器。主机仍具有最终决定权：HTTP 交付成功不会在本地移除待处理状态。
+
+编辑器外框文案（翻页器、按钮、占位符、校验提示）是双语的：插件在 `dsh-client-locale` 的 `question` 命名空间下注册 zh/en 词典，并通过 inject face 把绑定的翻译函数和 locale 快照源交给该条目，因此切换语言会重新渲染已挂载的编辑器。问题与选项文本来自模型并原样渲染；载体失败消息也不经翻译直接显示。
+
+## 模型体验
+
+通过 `dsh-tool-ask-user` 间接影响；该包拥有模型可见的工具 schema 和结构化结果。
+
+#### KV Cache 影响
+
+不会直接失效；模型可见的工具调用与结果由 `dsh-tool-ask-user` 拥有。
+
+## 已知限制与暂缓事项
+
+- **未提交的草稿不持久**：重新连接再同步或完整刷新页面时，会恢复主机拥有且 rpcId 相同的待处理请求，但编辑器卸载会重置本地选项和自定义文本草稿。
+- **每次只有一个请求拥有编辑器**：后续待处理请求仍留在会话快照中，并在较早请求落定后显示。

package/lib/client.js

@@ -0,0 +1,679 @@
+window.__ModuleLoader__.load({
+	id: "@deepseek-ai/dsh-client-ui-user-questions",
+	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 ../../../node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
+		function r(e) {
+			var t, f, n = "";
+			if ("string" == typeof e || "number" == typeof e) n += e;
+			else if ("object" == typeof e) if (Array.isArray(e)) {
+				var o = e.length;
+				for (t = 0; t < o; t++) e[t] && (f = r(e[t])) && (n && (n += " "), n += f);
+			} else for (f in e) e[f] && (n && (n += " "), n += f);
+			return n;
+		}
+		function clsx() {
+			for (var e, t, f = 0, n = "", o = arguments.length; f < o; f++) (e = arguments[f]) && (t = r(e)) && (n && (n += " "), n += t);
+			return n;
+		}
+		//#endregion
+		//#region lib/types/client/contract/slots.js
+		/**
+		* Narrow a request to a renderable plan review, or return undefined to leave it
+		* to the generic question flow.
+		*
+		* The card is one decision over one plan, and it claims a request only when it
+		* can send every answer that request allows — an intent changes the layout,
+		* never which answers are reachable. So the batch must be a single question
+		* that declares the intent, carries the plan as its detail, offers the approve
+		* label the intent names, and is a binary single choice: at most one option
+		* besides approve, and not multi-select. A third option or a multi-select batch
+		* has answers two buttons cannot express, so the generic flow keeps it — as it
+		* keeps any request whose intent the asker's own service would have rejected,
+		* because the client sits downstream of a wire boundary and every request must
+		* stay answerable.
+		*
+		* @param questions - the request's whole question batch.
+		* @returns The narrowed review, or undefined when the generic flow owns it.
+		*/
+		function planReviewOf(questions) {
+			if (questions.length !== 1) return void 0;
+			const question = questions[0];
+			const intent = question.intent;
+			if (intent?.kind !== "plan-review" || question.detail === void 0) return void 0;
+			if (question.multiSelect === true) return void 0;
+			const options = question.options ?? [];
+			if (options.length > 2) return void 0;
+			const approve = options.find((option) => option.label === intent.approve);
+			if (approve === void 0) return void 0;
+			const decline = options.find((option) => option.label !== intent.approve);
+			return {
+				id: question.id,
+				question: question.question,
+				plan: question.detail,
+				approve,
+				...decline === void 0 ? {} : { decline }
+			};
+		}
+		/**
+		* Question domain face over the carrier: render identity and questions
+		* transparently forwarded; answer/cancel own the wire encoding (the success
+		* fields and the cancelled error) and turn a rejected carrier receipt into a
+		* thrown error. Components mint one per carrier via useMemo (never inside a
+		* select — a per-dispatch mint would churn identity and break memoization).
+		*/
+		var PendingQuestion = class {
+			wait;
+			/**
+			* @param wait - the runtime carrier for one pending question request.
+			*/
+			constructor(wait) {
+				this.wait = wait;
+			}
+			/** Opaque render identity (React key / draft remount axis), forwarded from the carrier. */
+			get key() {
+				return this.wait.key;
+			}
+			/** The request's question list, forwarded from the carrier payload. */
+			get questions() {
+				return this.wait.payload.questions;
+			}
+			/**
+			* Deliver the whole answer batch; a rejected carrier receipt throws.
+			* @param answer - complete structured answer batch.
+			*/
+			async answer(answer) {
+				const receipt = await this.wait.respond({
+					ok: true,
+					value: {
+						sessionId: this.wait.sessionId,
+						answer
+					}
+				});
+				if (!receipt.accepted) throw new Error(`question response rejected: ${receipt.reason}`);
+			}
+			/** Reject the whole wait (the host resolves the tool call as cancelled); a rejected receipt throws. */
+			async cancel() {
+				const receipt = await this.wait.respond({
+					ok: false,
+					error: {
+						code: "cancelled",
+						message: "the user closed this question request",
+						details: {}
+					}
+				});
+				if (!receipt.accepted) throw new Error(`question cancellation rejected: ${receipt.reason}`);
+			}
+		};
+		//#endregion
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-user-questions/src/client/PlanReviewPanel.module.css.mjs
+		const css$1 = ".LVzXQa_frame{padding:6px calc(var(--dsh-composer-side-clearance) + 16px) 10px;justify-content:center;display:flex}.LVzXQa_card{width:100%;max-width:var(--dsh-chat-content-width);border:1px solid var(--dsw-alias-state-warn-secondary);background:var(--dsw-specific-input-major);max-height:min(60vh,520px);box-shadow:var(--dsw-shadow-lv2);color:var(--dsw-alias-label-primary);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border-radius:20px;flex-direction:column;display:flex;overflow:hidden}.LVzXQa_card,.LVzXQa_card *{box-sizing:border-box}.LVzXQa_strip{background:var(--dsw-alias-state-warn-tertiary);color:var(--dsw-alias-state-warn-primary);flex-shrink:0;align-items:center;gap:8px;padding:10px 16px;font-size:13px;line-height:18px;display:flex}.LVzXQa_dot{background:var(--dsw-alias-state-warn-primary);border-radius:50%;width:8px;height:8px}.LVzXQa_body{overscroll-behavior:contain;flex:auto;min-height:0;padding:12px 16px 4px;font-size:14px;line-height:22px;overflow-y:auto}.LVzXQa_footer{flex-shrink:0;justify-content:space-between;align-items:center;gap:12px;padding:8px 16px 12px;display:flex}.LVzXQa_feedback{min-height:16px;color:var(--dsw-alias-state-error-primary);font-size:11px;line-height:16px}.LVzXQa_actions{flex-shrink:0;align-items:center;gap:8px;display:flex}.LVzXQa_discuss{color:var(--dsw-alias-label-secondary);gap:6px}.LVzXQa_discuss:hover:not(:disabled){color:var(--dsw-alias-label-primary)}@media (width<=720px){.LVzXQa_card{border-radius:16px}.LVzXQa_body{padding:10px 12px 4px}.LVzXQa_footer{align-items:flex-end;padding:8px 12px 10px}}";
+		const tagId$1 = "@deepseek-ai/dsh-client-ui-user-questions/PlanReviewPanel.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-user-questions";
+			tag.dataset.pluginCss = tagId$1;
+			tag.textContent = css$1;
+			document.head.appendChild(tag);
+		}
+		var PlanReviewPanel_module_css_default = {
+			"card": "LVzXQa_card",
+			"body": "LVzXQa_body",
+			"actions": "LVzXQa_actions",
+			"dot": "LVzXQa_dot",
+			"frame": "LVzXQa_frame",
+			"feedback": "LVzXQa_feedback",
+			"strip": "LVzXQa_strip",
+			"footer": "LVzXQa_footer",
+			"discuss": "LVzXQa_discuss"
+		};
+		//#endregion
+		//#region lib/types/client/PlanReviewPanel.js
+		/**
+		* Optional-prop spread for a decision button's tooltip: `title` is optional on
+		* the DOM props, and exactOptionalPropertyTypes rejects an explicit undefined.
+		*
+		* @param description - the asker's option description, when it carries one.
+		* @returns The `title` prop to spread, or nothing.
+		*/
+		function tooltip(description) {
+			return description === void 0 ? {} : { title: description };
+		}
+		/**
+		* Render a plan review as a decision card.
+		*
+		* @param props - the question domain face, the narrowed plan review, and `t`.
+		* @returns The plan-review takeover for this request.
+		*/
+		function PlanReviewPanel({ pending, review, t }) {
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)(null);
+			const settle = (send) => {
+				setBusy(true);
+				setError(null);
+				send().catch((cause) => {
+					setBusy(false);
+					setError(cause instanceof Error ? cause.message : String(cause));
+				});
+			};
+			const decide = (label) => {
+				settle(() => pending.answer({ answers: [{
+					id: review.id,
+					selected: [label]
+				}] }));
+			};
+			const decline = review.decline;
+			return (0, react_jsx_runtime.jsx)("div", {
+				className: PlanReviewPanel_module_css_default.frame,
+				"data-plan-review-key": pending.key,
+				children: (0, react_jsx_runtime.jsxs)("section", {
+					className: PlanReviewPanel_module_css_default.card,
+					"aria-label": review.question,
+					children: [
+						(0, react_jsx_runtime.jsxs)("div", {
+							className: PlanReviewPanel_module_css_default.strip,
+							children: [(0, react_jsx_runtime.jsx)("span", { className: PlanReviewPanel_module_css_default.dot }), t("plan.header")]
+						}),
+						(0, react_jsx_runtime.jsx)("div", {
+							className: PlanReviewPanel_module_css_default.body,
+							"data-plan-review-scroll": true,
+							children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.MarkdownText, { text: review.plan })
+						}),
+						(0, react_jsx_runtime.jsxs)("div", {
+							className: PlanReviewPanel_module_css_default.footer,
+							children: [(0, react_jsx_runtime.jsx)("div", {
+								className: PlanReviewPanel_module_css_default.feedback,
+								role: "status",
+								children: error
+							}), (0, react_jsx_runtime.jsxs)("div", {
+								className: PlanReviewPanel_module_css_default.actions,
+								children: [
+									(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+										variant: "ghost",
+										className: PlanReviewPanel_module_css_default.discuss,
+										icon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutline16, { size: 14 }),
+										disabled: busy,
+										onClick: () => {
+											settle(() => pending.cancel());
+										},
+										children: t("plan.discuss")
+									}),
+									decline !== void 0 && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+										variant: "outline",
+										...tooltip(decline.description),
+										disabled: busy,
+										onClick: () => {
+											decide(decline.label);
+										},
+										children: t("plan.decline")
+									}),
+									(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+										variant: "primary",
+										...tooltip(review.approve.description),
+										disabled: busy,
+										onClick: () => {
+											decide(review.approve.label);
+										},
+										children: t("plan.approve")
+									})
+								]
+							})]
+						})
+					]
+				})
+			});
+		}
+		//#endregion
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-user-questions/src/client/QuestionComposer.module.css.mjs
+		const css = ".Mbwy4a_frame{padding:6px calc(var(--dsh-composer-side-clearance) + 16px) 10px;justify-content:center;display:flex}.Mbwy4a_card{width:100%;max-width:var(--dsh-chat-content-width);border:1px solid var(--dsw-alias-border-l2-darkmode-thin);background:var(--dsw-specific-input-major);max-height:min(60vh,520px);box-shadow:var(--dsw-shadow-lv2);color:var(--dsw-alias-label-primary);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border-radius:20px;flex-direction:column;padding:0 0 10px;display:flex;overflow:hidden}.Mbwy4a_card,.Mbwy4a_card *{box-sizing:border-box}.Mbwy4a_header{flex-shrink:0;justify-content:space-between;align-items:flex-start;gap:16px;padding:20px 16px 0 24px;display:flex}.Mbwy4a_headingBlock{min-width:0}.Mbwy4a_eyebrow{color:var(--dsw-alias-label-tertiary);margin-bottom:5px;font-size:11px;line-height:16px}.Mbwy4a_title{margin:0;font-size:16px;font-weight:500;line-height:22px}.Mbwy4a_detail{margin:0 2px 8px}.Mbwy4a_footerActions{flex-shrink:0;align-items:center;gap:12px;display:flex}.Mbwy4a_pager{flex-shrink:0;align-items:center;gap:6px;display:flex}.Mbwy4a_progress{color:var(--dsw-alias-label-secondary);white-space:nowrap;word-spacing:-2px;padding:0 4px;font-size:14px;font-weight:500;line-height:24px}.Mbwy4a_iconButton{width:24px;height:24px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;border-radius:999px;place-items:center;padding:0;display:grid}.Mbwy4a_iconButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}.Mbwy4a_iconButton:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}.Mbwy4a_body{overscroll-behavior:contain;flex-direction:column;flex:auto;min-height:0;display:flex;overflow-y:auto}.Mbwy4a_options{flex-direction:column;gap:1px;margin:8px 0 0;padding:4px 12px;display:flex}.Mbwy4a_option{width:100%;min-height:40px;color:inherit;text-align:left;cursor:pointer;background:0 0;border:1px solid #0000;border-radius:12px;flex-shrink:0;align-items:flex-start;gap:8px;padding:8px 12px 8px 8px;transition:background-color .12s,border-color .12s;display:flex}.Mbwy4a_option:hover:not(:disabled),.Mbwy4a_optionSelected{background:var(--dsw-alias-interactive-bg-hover)}.Mbwy4a_optionSelected{border-color:var(--dsw-alias-border-l2)}.Mbwy4a_option:disabled{cursor:default}.Mbwy4a_number{background:var(--dsw-alias-bg-overlay);width:20px;height:20px;color:var(--dsw-alias-label-secondary);border-radius:6px;flex:0 0 20px;place-items:center;margin-top:2px;font-size:12px;font-weight:500;line-height:18px;display:grid}.Mbwy4a_checkbox{flex:0 0 20px;place-items:center;width:20px;height:20px;margin-top:2px;display:grid}.Mbwy4a_checkbox:before{content:\"\";border:1px solid var(--dsw-alias-border-l4);border-radius:4px;grid-area:1/1;width:14px;height:14px;transition:background-color .12s,border-color .12s}.Mbwy4a_checkbox>svg{grid-area:1/1}.Mbwy4a_checkboxChecked{color:var(--dsw-alias-label-primary-foreground)}.Mbwy4a_checkboxChecked:before{border-color:var(--dsw-alias-label-primary);background:var(--dsw-alias-label-primary)}.Mbwy4a_optionCopy{flex:1;min-width:0}.Mbwy4a_optionLine{flex-wrap:wrap;align-items:baseline;gap:2px 6px;display:flex}.Mbwy4a_optionLabel{font-size:14px;font-weight:500;line-height:24px}.Mbwy4a_badge{background:var(--dsw-specific-sidebar-nav-item-active-accent);color:var(--dsw-alias-button-info-fill);border-radius:6px;padding:0 4px;font-size:11px;font-weight:600;line-height:18px}.Mbwy4a_description{color:var(--dsw-alias-label-tertiary);font-size:14px;font-weight:400;line-height:24px}.Mbwy4a_customRow{border:1px solid #0000;border-radius:12px;flex-shrink:0;align-items:flex-start;gap:8px;width:100%;min-height:40px;padding:8px 12px 8px 8px;transition:background-color .12s,border-color .12s;display:flex}.Mbwy4a_customRow:hover,.Mbwy4a_customRow:focus-within,.Mbwy4a_customRowActive{background:var(--dsw-alias-interactive-bg-hover)}.Mbwy4a_customRow:focus-within,.Mbwy4a_customRowActive{border-color:var(--dsw-alias-border-l2)}.Mbwy4a_customInput{min-width:0;color:var(--dsw-alias-label-primary);caret-color:var(--dsw-alias-state-business-primary);font:inherit;background:0 0;border:none;outline:none;flex:1;padding:0;font-size:14px;line-height:24px}.Mbwy4a_customInput::placeholder{color:var(--dsw-alias-label-caption)}.Mbwy4a_customTextarea{resize:none;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-module-platform);min-height:64px;max-height:140px;color:var(--dsw-alias-label-primary);caret-color:var(--dsw-alias-state-business-primary);font:inherit;border-radius:10px;outline:none;flex-shrink:0;margin:0 12px;padding:8px 12px;font-size:14px;line-height:24px;display:block}.Mbwy4a_customTextarea:focus{border-color:var(--dsw-alias-state-business-primary)}.Mbwy4a_customTextarea::placeholder{color:var(--dsw-alias-label-caption)}.Mbwy4a_footer{flex-shrink:0;justify-content:space-between;align-items:center;gap:12px;margin-top:12px;padding:0 10px 0 18px;display:flex}.Mbwy4a_feedback{min-height:16px;color:var(--dsw-alias-state-error-primary);text-align:right;flex:1;font-size:11px;line-height:16px}@media (width<=720px){.Mbwy4a_card{border-radius:16px}.Mbwy4a_header{padding:10px 12px 0 18px}.Mbwy4a_options{padding:4px 8px}.Mbwy4a_title{font-size:15px;line-height:21px}.Mbwy4a_option,.Mbwy4a_customRow{padding:8px 6px}.Mbwy4a_footer{align-items:flex-end;padding:0 10px}.Mbwy4a_footerActions{flex-shrink:0}}@media (prefers-reduced-motion:reduce){.Mbwy4a_option,.Mbwy4a_customRow{transition:none}}";
+		const tagId = "@deepseek-ai/dsh-client-ui-user-questions/QuestionComposer.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-user-questions";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var QuestionComposer_module_css_default = {
+			"body": "Mbwy4a_body",
+			"pager": "Mbwy4a_pager",
+			"optionLine": "Mbwy4a_optionLine",
+			"feedback": "Mbwy4a_feedback",
+			"customRowActive": "Mbwy4a_customRowActive",
+			"footer": "Mbwy4a_footer",
+			"customRow": "Mbwy4a_customRow",
+			"header": "Mbwy4a_header",
+			"progress": "Mbwy4a_progress",
+			"description": "Mbwy4a_description",
+			"customTextarea": "Mbwy4a_customTextarea",
+			"footerActions": "Mbwy4a_footerActions",
+			"eyebrow": "Mbwy4a_eyebrow",
+			"card": "Mbwy4a_card",
+			"headingBlock": "Mbwy4a_headingBlock",
+			"title": "Mbwy4a_title",
+			"frame": "Mbwy4a_frame",
+			"iconButton": "Mbwy4a_iconButton",
+			"optionLabel": "Mbwy4a_optionLabel",
+			"number": "Mbwy4a_number",
+			"optionCopy": "Mbwy4a_optionCopy",
+			"customInput": "Mbwy4a_customInput",
+			"options": "Mbwy4a_options",
+			"badge": "Mbwy4a_badge",
+			"checkbox": "Mbwy4a_checkbox",
+			"optionSelected": "Mbwy4a_optionSelected",
+			"detail": "Mbwy4a_detail",
+			"option": "Mbwy4a_option",
+			"checkboxChecked": "Mbwy4a_checkboxChecked"
+		};
+		//#endregion
+		//#region lib/types/client/QuestionComposer.js
+		/**
+		* Split the conventional recommendation suffix without changing the answer value.
+		* @param label - Original option label returned if selected.
+		* @returns Display label plus recommendation state.
+		*/
+		function parseRecommendedLabel(label) {
+			const suffix = /\s*(?:\((?:recommended|推荐)\)|（(?:recommended|推荐)）)\s*$/i;
+			return suffix.test(label) ? {
+				label: label.replace(suffix, ""),
+				recommended: true
+			} : {
+				label,
+				recommended: false
+			};
+		}
+		/** Return whether a text-field key event belongs to an active IME composition. */
+		function isComposing(event) {
+			return event.nativeEvent.isComposing || event.nativeEvent.keyCode === 229;
+		}
+		/**
+		* Composer takeover boundary; the carrier key keys local drafts, so a
+		* same-request replay (same key, new carrier object) preserves them.
+		*
+		* One takeover, two shapes: a request that declares a presentation intent this
+		* package renders takes that shape (a plan review is one decision over one
+		* plan, not a question set), and every other request takes the generic flow.
+		* The routing lives here, at the one entry that owns the composer seat, so
+		* neither shape can claim a request the other is already rendering.
+		*
+		* @param props - the selector-matched pending question carrier plus the framework standard kit.
+		* @returns The question flow, or the intent's own surface, for this request.
+		*/
+		function QuestionComposer(props) {
+			const question = (0, react.useMemo)(() => new PendingQuestion(props.matched), [props.matched]);
+			const review = (0, react.useMemo)(() => planReviewOf(question.questions), [question]);
+			return review === void 0 ? (0, react_jsx_runtime.jsx)(QuestionFlow, {
+				pending: question,
+				t: props.t
+			}, question.key) : (0, react_jsx_runtime.jsx)(PlanReviewPanel, {
+				pending: question,
+				review,
+				t: props.t
+			}, question.key);
+		}
+		function QuestionFlow({ pending, t }) {
+			const questions = pending.questions;
+			const [index, setIndex] = (0, react.useState)(0);
+			const [drafts, setDrafts] = (0, react.useState)(() => questions.map(() => ({
+				selected: [],
+				custom: "",
+				skipped: false
+			})));
+			const [busy, setBusy] = (0, react.useState)(null);
+			const [error, setError] = (0, react.useState)(null);
+			const question = questions[index];
+			const draft = drafts[index];
+			const hasOptions = (question.options?.length ?? 0) > 0;
+			const cancelFlow = () => {
+				setBusy("cancel");
+				setError(null);
+				pending.cancel().catch((cause) => {
+					setBusy(null);
+					setError({ text: cause instanceof Error ? cause.message : String(cause) });
+				});
+			};
+			const updateDraft = (update) => {
+				setDrafts((current) => current.map((item, itemIndex) => itemIndex === index ? update(item) : item));
+				setError(null);
+			};
+			const choose = (label) => {
+				updateDraft((current) => {
+					if (question.multiSelect === true) {
+						const selected = current.selected.includes(label) ? current.selected.filter((item) => item !== label) : [...current.selected, label];
+						return {
+							...current,
+							selected,
+							skipped: false
+						};
+					}
+					return {
+						selected: [label],
+						custom: "",
+						skipped: false
+					};
+				});
+				if (question.multiSelect !== true && index < questions.length - 1) setIndex((current) => current + 1);
+			};
+			const answered = (item) => item.selected.length > 0 || item.custom.trim() !== "";
+			const completed = (item) => answered(item) || item.skipped;
+			const submitDrafts = (values) => {
+				const missing = values.findIndex((item) => !completed(item));
+				if (missing >= 0) {
+					setIndex(missing);
+					setError({ key: "error.incomplete" });
+					return;
+				}
+				const answer = { answers: questions.map((item, itemIndex) => {
+					const value = values[itemIndex];
+					if (value.skipped) return {
+						id: item.id,
+						selected: []
+					};
+					const custom = value.custom.trim();
+					return {
+						id: item.id,
+						selected: custom === "" || item.multiSelect === true ? value.selected : [],
+						...custom === "" ? {} : { custom }
+					};
+				}) };
+				setBusy("answer");
+				setError(null);
+				pending.answer(answer).catch((cause) => {
+					setBusy(null);
+					setError({ text: cause instanceof Error ? cause.message : String(cause) });
+				});
+			};
+			const continueFlow = () => {
+				if (!answered(draft)) {
+					setError({ key: "error.unanswered" });
+					return;
+				}
+				if (index < questions.length - 1) {
+					setIndex((current) => current + 1);
+					setError(null);
+					return;
+				}
+				submitDrafts(drafts);
+			};
+			const draftCustom = (event) => {
+				const value = event.target.value;
+				updateDraft((current) => ({
+					...current,
+					selected: question.multiSelect === true ? current.selected : [],
+					custom: value,
+					skipped: false
+				}));
+			};
+			const continueFromCustom = (event) => {
+				if (event.key !== "Enter" || event.shiftKey || isComposing(event)) return;
+				event.preventDefault();
+				continueFlow();
+			};
+			const skipQuestion = () => {
+				const nextDrafts = drafts.map((item, itemIndex) => itemIndex === index ? {
+					selected: [],
+					custom: "",
+					skipped: true
+				} : item);
+				setDrafts(nextDrafts);
+				setError(null);
+				if (index < questions.length - 1) {
+					setIndex((current) => current + 1);
+					return;
+				}
+				submitDrafts(nextDrafts);
+			};
+			return (0, react_jsx_runtime.jsx)("div", {
+				className: QuestionComposer_module_css_default.frame,
+				"data-question-key": pending.key,
+				children: (0, react_jsx_runtime.jsxs)("section", {
+					className: QuestionComposer_module_css_default.card,
+					"aria-labelledby": `question-${pending.key}-${String(index)}`,
+					children: [
+						(0, react_jsx_runtime.jsxs)("header", {
+							className: QuestionComposer_module_css_default.header,
+							children: [(0, react_jsx_runtime.jsxs)("div", {
+								className: QuestionComposer_module_css_default.headingBlock,
+								children: [question.header !== void 0 && (0, react_jsx_runtime.jsx)("div", {
+									className: QuestionComposer_module_css_default.eyebrow,
+									children: question.header
+								}), (0, react_jsx_runtime.jsx)("h2", {
+									className: QuestionComposer_module_css_default.title,
+									id: `question-${pending.key}-${String(index)}`,
+									children: question.question
+								})]
+							}), (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: QuestionComposer_module_css_default.iconButton,
+								"aria-label": t("nav.cancel"),
+								title: t("nav.cancel"),
+								disabled: busy !== null,
+								onClick: cancelFlow,
+								children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseOutline16, {})
+							})]
+						}),
+						(0, react_jsx_runtime.jsxs)("div", {
+							className: QuestionComposer_module_css_default.body,
+							"data-question-scroll": true,
+							children: [question.detail !== void 0 && (0, react_jsx_runtime.jsx)("div", {
+								className: QuestionComposer_module_css_default.detail,
+								children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.MarkdownText, { text: question.detail })
+							}), (0, react_jsx_runtime.jsxs)("div", {
+								className: QuestionComposer_module_css_default.options,
+								role: question.multiSelect === true ? "group" : "radiogroup",
+								children: [(question.options ?? []).map((option, optionIndex) => {
+									const selected = draft.selected.includes(option.label);
+									const display = parseRecommendedLabel(option.label);
+									return (0, react_jsx_runtime.jsxs)("button", {
+										type: "button",
+										className: clsx(QuestionComposer_module_css_default.option, selected && question.multiSelect !== true && QuestionComposer_module_css_default.optionSelected),
+										role: question.multiSelect === true ? "checkbox" : "radio",
+										"aria-checked": selected,
+										"aria-label": display.label,
+										disabled: busy !== null,
+										onClick: () => {
+											choose(option.label);
+										},
+										onKeyDown: (event) => {
+											if (event.key !== "Enter" || !drafts.every(completed)) return;
+											event.preventDefault();
+											submitDrafts(drafts);
+										},
+										children: [question.multiSelect === true ? (0, react_jsx_runtime.jsx)("span", {
+											className: clsx(QuestionComposer_module_css_default.checkbox, selected && QuestionComposer_module_css_default.checkboxChecked),
+											"aria-hidden": "true",
+											children: selected && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCheckOutline14, { size: 12 })
+										}) : (0, react_jsx_runtime.jsx)("span", {
+											className: QuestionComposer_module_css_default.number,
+											children: optionIndex + 1
+										}), (0, react_jsx_runtime.jsx)("span", {
+											className: QuestionComposer_module_css_default.optionCopy,
+											children: (0, react_jsx_runtime.jsxs)("span", {
+												className: QuestionComposer_module_css_default.optionLine,
+												children: [
+													(0, react_jsx_runtime.jsx)("span", {
+														className: QuestionComposer_module_css_default.optionLabel,
+														children: display.label
+													}),
+													display.recommended && (0, react_jsx_runtime.jsx)("span", {
+														className: QuestionComposer_module_css_default.badge,
+														children: t("option.recommended")
+													}),
+													option.description !== void 0 && (0, react_jsx_runtime.jsx)("span", {
+														className: QuestionComposer_module_css_default.description,
+														children: option.description
+													})
+												]
+											})
+										})]
+									}, `${option.label}-${String(optionIndex)}`);
+								}), hasOptions ? (0, react_jsx_runtime.jsxs)("div", {
+									className: clsx(QuestionComposer_module_css_default.customRow, draft.custom !== "" && QuestionComposer_module_css_default.customRowActive),
+									children: [question.multiSelect === true ? (0, react_jsx_runtime.jsx)("span", {
+										className: clsx(QuestionComposer_module_css_default.checkbox, draft.custom !== "" && QuestionComposer_module_css_default.checkboxChecked),
+										"aria-hidden": "true",
+										children: draft.custom !== "" && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCheckOutline14, { size: 12 })
+									}) : (0, react_jsx_runtime.jsx)("span", {
+										className: QuestionComposer_module_css_default.number,
+										"aria-hidden": "true",
+										children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutline16, { size: 12 })
+									}), (0, react_jsx_runtime.jsx)("input", {
+										type: "text",
+										className: QuestionComposer_module_css_default.customInput,
+										value: draft.custom,
+										disabled: busy !== null,
+										placeholder: t("custom.placeholder"),
+										onChange: draftCustom,
+										onKeyDown: continueFromCustom
+									})]
+								}) : (0, react_jsx_runtime.jsx)("textarea", {
+									autoFocus: true,
+									className: QuestionComposer_module_css_default.customTextarea,
+									value: draft.custom,
+									disabled: busy !== null,
+									rows: 2,
+									placeholder: t("custom.placeholder"),
+									onChange: draftCustom,
+									onKeyDown: continueFromCustom
+								})]
+							})]
+						}),
+						(0, react_jsx_runtime.jsxs)("footer", {
+							className: QuestionComposer_module_css_default.footer,
+							children: [
+								(0, react_jsx_runtime.jsxs)("div", {
+									className: QuestionComposer_module_css_default.pager,
+									children: [
+										(0, react_jsx_runtime.jsx)("button", {
+											type: "button",
+											className: QuestionComposer_module_css_default.iconButton,
+											"aria-label": t("nav.prev"),
+											disabled: index === 0 || busy !== null,
+											onClick: () => {
+												setIndex(index - 1);
+												setError(null);
+											},
+											children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronLeftOutline14, {})
+										}),
+										(0, react_jsx_runtime.jsxs)("span", {
+											className: QuestionComposer_module_css_default.progress,
+											children: [
+												index + 1,
+												" / ",
+												questions.length
+											]
+										}),
+										(0, react_jsx_runtime.jsx)("button", {
+											type: "button",
+											className: QuestionComposer_module_css_default.iconButton,
+											"aria-label": t("nav.next"),
+											disabled: index === questions.length - 1 || busy !== null,
+											onClick: () => {
+												setIndex(index + 1);
+												setError(null);
+											},
+											children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronRightOutline14, {})
+										})
+									]
+								}),
+								(0, react_jsx_runtime.jsx)("div", {
+									className: QuestionComposer_module_css_default.feedback,
+									role: "status",
+									children: error === null ? null : "key" in error ? t(error.key) : error.text
+								}),
+								(0, react_jsx_runtime.jsxs)("div", {
+									className: QuestionComposer_module_css_default.footerActions,
+									children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+										variant: "outline",
+										disabled: busy !== null,
+										onClick: skipQuestion,
+										children: t("action.skip")
+									}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+										variant: "primary",
+										disabled: busy !== null || !answered(draft),
+										onClick: continueFlow,
+										children: busy === "answer" ? t("submitting") : index === questions.length - 1 ? t("submit") : t("action.next")
+									})]
+								})
+							]
+						})
+					]
+				})
+			});
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** `question` namespace dictionaries. */
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"error.incomplete": "请先完成这道问题。",
+			"error.unanswered": "请选择一个选项或填写自定义答案。",
+			"nav.prev": "上一题",
+			"nav.next": "下一题",
+			"nav.cancel": "放弃整组问题",
+			"option.recommended": "推荐",
+			"custom.placeholder": "输入你的答案",
+			"action.skip": "跳过本题",
+			"action.next": "下一题",
+			"plan.header": "计划待审",
+			"plan.approve": "确认执行",
+			"plan.decline": "拒绝",
+			"plan.discuss": "去聊天里说"
+		};
+		/** English dictionary, checked complete against the zh key set. */
+		const en = {
+			"error.incomplete": "Please complete this question first.",
+			"error.unanswered": "Please select an option or enter a custom answer.",
+			"nav.prev": "Previous question",
+			"nav.next": "Next question",
+			"nav.cancel": "Dismiss all questions",
+			"option.recommended": "Recommended",
+			"custom.placeholder": "Type your answer",
+			"action.skip": "Skip this question",
+			"action.next": "Next",
+			"plan.header": "Plan review",
+			"plan.approve": "Approve",
+			"plan.decline": "Refuse",
+			"plan.discuss": "Chat about it"
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Dictionary namespace owned by this plugin. */
+		const NS = "question";
+		/** Required services: the slot registry and the question composer's copy. */
+		const inject = ["slots", "locale"];
+		/** Chain routing: claim the composer while a question wait is pending (pure — owner props only). */
+		function selectQuestion({ interactions }) {
+			return interactions.find((i) => i.kind === "question") ?? null;
+		}
+		/**
+		* Client plugin body: register the `question` dictionaries and the question
+		* composer into the composer chain. Zero business face — data and verbs live
+		* on the matched carrier; t rides the standard locale seat.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-user-questions: dictionaries");
+			ctx.slots.inject("conversation.composer", () => ctx.slots.register({
+				name: "conversation.composer",
+				select: selectQuestion,
+				locale: NS
+			}, QuestionComposer));
+		}
+		//#endregion
+		exports.PendingQuestion = PendingQuestion;
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,16 @@
+//#region lib/types/index.js
+/**
+* Web question plugin, node half.
+*
+* Deliberately empty. Mounting `ask_user_question` here put it in the tools
+* registry's GLOBAL layer, so every agent saw it no matter which preset
+* composed it — a two-tool benchmark preset actually presented three, and a
+* locally authored `bash-only` preset presented two. Rendering a question is
+* a host UI capability; having the tool is an agent capability, and only a
+* preset decides that. The `tool-ask-user` row belongs in the presets that
+* want it (and in the TUI composition, which has no presets).
+*/
+/** Host plugin body — the model-facing tool is composed per preset, not here. */
+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-user-questions`.
+* @module @deepseek-ai/dsh-client-ui-user-questions/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-client-ui-user-questions";
+/** Cordis companion plugin name. */
+const name = "client-ui-user-questions-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: tool and slot registrations are effects
+* owned and observed by their respective registries; the host pending table is
+* exercised through the public wire protocol.
+*/
+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/PlanReviewPanel.d.ts

@@ -0,0 +1,14 @@
+import type { PendingQuestion, PlanReview, QuestionComposerProps } from './contract/slots.ts';
+/** The panel's own props: the question domain face, the narrowed review, and the locale seat. */
+export type PlanReviewPanelProps = {
+    pending: PendingQuestion;
+    review: PlanReview;
+} & Pick<QuestionComposerProps, 't'>;
+/**
+ * Render a plan review as a decision card.
+ *
+ * @param props - the question domain face, the narrowed plan review, and `t`.
+ * @returns The plan-review takeover for this request.
+ */
+export declare function PlanReviewPanel({ pending, review, t }: PlanReviewPanelProps): import("react").JSX.Element;
+//# sourceMappingURL=PlanReviewPanel.d.ts.map

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

@@ -0,0 +1,25 @@
+import { type QuestionComposerProps } from './contract/slots.ts';
+/**
+ * Split the conventional recommendation suffix without changing the answer value.
+ * @param label - Original option label returned if selected.
+ * @returns Display label plus recommendation state.
+ */
+export declare function parseRecommendedLabel(label: string): {
+    label: string;
+    recommended: boolean;
+};
+/**
+ * Composer takeover boundary; the carrier key keys local drafts, so a
+ * same-request replay (same key, new carrier object) preserves them.
+ *
+ * One takeover, two shapes: a request that declares a presentation intent this
+ * package renders takes that shape (a plan review is one decision over one
+ * plan, not a question set), and every other request takes the generic flow.
+ * The routing lives here, at the one entry that owns the composer seat, so
+ * neither shape can claim a request the other is already rendering.
+ *
+ * @param props - the selector-matched pending question carrier plus the framework standard kit.
+ * @returns The question flow, or the intent's own surface, for this request.
+ */
+export declare function QuestionComposer(props: QuestionComposerProps): import("react").JSX.Element;
+//# sourceMappingURL=QuestionComposer.d.ts.map

package/lib/types/client/contract/slots.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Question-composer slot contract: the registrant-side props composition for
+ * the conversation-owned `conversation.composer` slot, plus the question
+ * domain face over the runtime's carrier object. The carrier (PendingWait)
+ * owns envelope transport only; the question protocol — answer value shape,
+ * cancelled error encoding, receipt checks — lives HERE, with the package
+ * that consumes it.
+ */
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PendingWait } from '@deepseek-ai/dsh-client-runtime/client';
+import type { QuestionResponsePayload } from '@deepseek-ai/dsh-api-remotes/client';
+/** The pending question carrier the owner dispatches into the composer slot. */
+export type QuestionWait = PendingWait<'question'>;
+/** One structured answer batch covering every question of the request. */
+export type QuestionAnswer = QuestionResponsePayload['answer'];
+/** One question of the request, as the carrier payload carries it. */
+type QuestionItem = QuestionWait['payload']['questions'][number];
+/** One option the asker offered on a question. */
+type QuestionOption = NonNullable<QuestionItem['options']>[number];
+/**
+ * A request narrowed to the `plan-review` presentation intent: everything the
+ * decision card renders and answers with, so the panel never re-reads the
+ * request shape. `approve` and `decline` are the asker's own options — an
+ * answer must carry one of those labels verbatim — and `plan` is the markdown
+ * body under review.
+ */
+export interface PlanReview {
+    /** The reviewed question's id, echoed in the answer. */
+    id: string;
+    /** The question text, kept as the card's accessible name. */
+    question: string;
+    /** The plan markdown under review. */
+    plan: string;
+    /** The option that approves the plan. */
+    approve: QuestionOption;
+    /** The option that declines it; absent when the asker offered no other option. */
+    decline?: QuestionOption;
+}
+/**
+ * Narrow a request to a renderable plan review, or return undefined to leave it
+ * to the generic question flow.
+ *
+ * The card is one decision over one plan, and it claims a request only when it
+ * can send every answer that request allows — an intent changes the layout,
+ * never which answers are reachable. So the batch must be a single question
+ * that declares the intent, carries the plan as its detail, offers the approve
+ * label the intent names, and is a binary single choice: at most one option
+ * besides approve, and not multi-select. A third option or a multi-select batch
+ * has answers two buttons cannot express, so the generic flow keeps it — as it
+ * keeps any request whose intent the asker's own service would have rejected,
+ * because the client sits downstream of a wire boundary and every request must
+ * stay answerable.
+ *
+ * @param questions - the request's whole question batch.
+ * @returns The narrowed review, or undefined when the generic flow owns it.
+ */
+export declare function planReviewOf(questions: readonly QuestionItem[]): PlanReview | undefined;
+/**
+ * Question domain face over the carrier: render identity and questions
+ * transparently forwarded; answer/cancel own the wire encoding (the success
+ * fields and the cancelled error) and turn a rejected carrier receipt into a
+ * thrown error. Components mint one per carrier via useMemo (never inside a
+ * select — a per-dispatch mint would churn identity and break memoization).
+ */
+export declare class PendingQuestion {
+    private readonly wait;
+    /**
+     * @param wait - the runtime carrier for one pending question request.
+     */
+    constructor(wait: QuestionWait);
+    /** Opaque render identity (React key / draft remount axis), forwarded from the carrier. */
+    get key(): string;
+    /** The request's question list, forwarded from the carrier payload. */
+    get questions(): QuestionWait['payload']['questions'];
+    /**
+     * Deliver the whole answer batch; a rejected carrier receipt throws.
+     * @param answer - complete structured answer batch.
+     */
+    answer(answer: QuestionAnswer): Promise<void>;
+    /** Reject the whole wait (the host resolves the tool call as cancelled); a rejected receipt throws. */
+    cancel(): Promise<void>;
+}
+/**
+ * Full component props: the framework runtime share (chain currency +
+ * session/global standard kit) plus the chain `matched` share — the entry's
+ * selector result, already narrowed to the question carrier — plus the
+ * standard locale seat; the carrier plus the domain face above carry the
+ * whole behavior surface.
+ */
+export type QuestionComposerProps = PropsRuntime<'conversation.composer'> & {
+    matched: QuestionWait;
+} & PropsLocale<'question'>;
+export {};
+//# sourceMappingURL=slots.d.ts.map

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

@@ -0,0 +1,35 @@
+/**
+ * Web question plugin, browser half: QuestionComposer registered as a
+ * selector-routed entry of the conversation-declared composer chain, plus the
+ * `question` dictionaries. The selector narrows the owner's currency to the
+ * question carrier (matched prop), and the whole behavior surface rides the
+ * carrier (domain encoding in contract/slots.ts PendingQuestion); copy rides
+ * the standard locale seat. Export discipline: packages/client/AGENTS.md.
+ *
+ * One entry, two shapes: the composer renders a request that declares a
+ * presentation intent as that intent's own surface (`plan-review` → the plan
+ * decision card) and every other request as the generic question flow. A
+ * separate chain entry per shape would race the same carrier, so the shape
+ * choice lives inside this entry — see QuestionComposer.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type QuestionKey } from './locales.ts';
+export { PendingQuestion } from './contract/slots.ts';
+export type { PlanReview, QuestionAnswer, QuestionComposerProps, QuestionWait, } from './contract/slots.ts';
+export type { QuestionKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The question composer's copy. */
+        question: QuestionKey;
+    }
+}
+/** Required services: the slot registry and the question composer's copy. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the `question` dictionaries and the question
+ * composer into the composer chain. Zero business face — data and verbs live
+ * on the matched carrier; t rides the standard locale seat.
+ * @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,36 @@
+/** `question` namespace dictionaries. */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'error.incomplete': string;
+    'error.unanswered': string;
+    'nav.prev': string;
+    'nav.next': string;
+    'nav.cancel': string;
+    'option.recommended': string;
+    'custom.placeholder': string;
+    'action.skip': string;
+    'action.next': string;
+    'plan.header': string;
+    'plan.approve': string;
+    'plan.decline': string;
+    'plan.discuss': string;
+};
+/** The question namespace key union. */
+export type QuestionKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'error.incomplete': string;
+    'error.unanswered': string;
+    'nav.prev': string;
+    'nav.next': string;
+    'nav.cancel': string;
+    'option.recommended': string;
+    'custom.placeholder': string;
+    'action.skip': string;
+    'action.next': string;
+    'plan.header': string;
+    'plan.approve': string;
+    'plan.decline': string;
+    'plan.discuss': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Web question plugin, node half.
+ *
+ * Deliberately empty. Mounting `ask_user_question` here put it in the tools
+ * registry's GLOBAL layer, so every agent saw it no matter which preset
+ * composed it — a two-tool benchmark preset actually presented three, and a
+ * locally authored `bash-only` preset presented two. Rendering a question is
+ * a host UI capability; having the tool is an agent capability, and only a
+ * preset decides that. The `tool-ask-user` row belongs in the presets that
+ * want it (and in the TUI composition, which has no presets).
+ */
+/** Host plugin body — the model-facing tool is composed per preset, not here. */
+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-user-questions`.
+ * @module @deepseek-ai/dsh-client-ui-user-questions/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-user-questions-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,78 @@
+{
+  "name": "@deepseek-ai/dsh-client-ui-user-questions",
+  "description": "Web ask_user_question feature: host tool mount plus composer-takeover question UI",
+  "version": "0.0.1-rc.3",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-user-questions"
+  },
+  "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-locale",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "BSD-3-Clause",
+  "dependencies": {
+    "clsx": "^2.0.0",
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.3"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-agent": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-api-remotes": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-system-prompt": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-user-questions": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-tools": "^0.0.1-rc.3"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}