@deepseek-ai/dsh-client-ui-tool 0.1.7-alpha.2 → 0.1.7-rc.1

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/client/ui-tool/README.md
-README.md: 622dbd89c93f8a21bece72f2267613a4fa81b4d6
-README.zh.md: c3fec14cb7a5d2e2448743204b59dcac73380849
+README.md: b4a529fbcb1ed33976d71baf043e625fcca4c89c
+README.zh.md: 406dc884f3529af79d675e6fbe1586e7485c3780

package/README.md

@@ -29,6 +29,8 @@ Tool calls appear in the conversation as cards: a root call tree with its nested
 
 Shared Tool rows and Bash rows retain error and warning colors for failed and stopped summaries, including on hover. Hover darkens only summaries without those states.
 
+Before dispatch, a named model call appears as one non-expandable row with its tool-owned icon and title. A generic row shows `Tool call · <tool name>`. Preparation exposes no complete arguments, file link, result, or parameter-dependent interaction. Write/edit show `Preparing content NKB` in the summary; N is `Math.ceil(raw.length / 1024)`, an integer estimate of the raw argument string length, not the file's byte size. `tool/call` enables the existing call presentation; completing an argument block alone does not start execution.
+
 ### Registering a business tool view
 
 An owning business package registers its wire Tool name into `tool.call.toolview`:
@@ -41,10 +43,12 @@ ctx.slots.inject('tool.call.toolview', () =>
   }, BusinessToolRow))
 ```
 
-The owner payload is `ToolCallOwnerProps`: `callId`, `toolName`, the frozen `block`, optional `cwd` and `home`, the session-authorized `loadImage` loader (for a view whose result carries durable images), and plain `openFile`/`inspect` callbacks. A PTC dispatch block retains its event's `parentCallId`; a root Session call has no such field, so descendants route through the same keyed dispatch — a registered view such as `read_image` renders its card there, and unregistered descendants keep the generic flattened form. Path summaries relativize to the Session cwd first, then replace a leftover POSIX Host home with `~`; `filePath` and Host open keep the authored filesystem path. The registration receives the normal Session slot runtime share but no React node or Runtime service.
+The owner payload is `ToolCallOwnerProps`: `callId`, `toolName`, the `phase` discriminant and its frozen stage-specific `block`, optional `cwd` and `home`, the session-authorized `loadImage` loader (for a view whose result carries durable images), and plain `openFile`/`inspect` callbacks. A PTC dispatch block retains its event's `parentCallId`; a root Session call has no such field, so descendants route through the same keyed dispatch — a registered view such as `read_image` renders its card there, and unregistered descendants keep the generic flattened form. Path summaries relativize to the Session cwd first, then replace a leftover POSIX Host home with `~`; `filePath` and Host open keep the authored filesystem path. The registration receives the normal Session slot runtime share but no React node or Runtime service.
 
 ### Built-in views
 
+Every registered view receives the explicit `preparing`, `start`, and `result` props declared in [the Tool slot types](src/client/contract/slots.ts). Shared rows use the same `ToolRow` in all stages. Their row model selects the title and combines any generic tool-name prefix with the available argument summary independently of lifecycle state. Tool-owned titles omit the English name. The shared argument parser returns no call during preparation and does not parse partial JSON. Write/edit use separate preparing and dispatched components, so only the preparing component invokes `useToolCallArgumentsPartial`; start and result share the dispatched component. Custom renderers such as Bash, Skill, and Cordis handle preparation separately; their argument-dependent components accept `StartedToolCallViewProps`.
+
 This package owns the generic fallback and the built-in shell/pwsh, read, read_image, write/edit, running `str_replace_editor` `create`/`str_replace`, grep/glob, web, todo, question, and PTC dispatch presentations. Structured cards derive directly from first-party raw event fields; Host `presentCall` and `presentResult` values never enter the Client. Running and settled foreground standard `bash`/`pwsh` and `terminal_send` calls use terminal cards at the root and in PTC dispatch children, subject to the same argument, result, and error checks. Persistent `bash`/`pwsh` calls use terminal cards only while running. Shell output ending in a recognized spill-policy notice uses expandable generic output in shell rows and generic output in Details; a displaced or omitted exit marker cannot establish success. Settled persistent-shell results stay generic because reset and partial-output diagnostics do not always describe one process exit status; root persistent results are expandable, while background acknowledgements remain collapsed. A native or PTC dispatch failure carrying `AUTO_REVIEW_DENIED` shows the Auto review verdict in its collapsed row and one normalized not-executed reason when expanded; a missing or whitespace-only reason uses localized fallback text. A successful question row pairs call questions with result answers by their stable ids and shows readable question/answer lines when expanded. A cancelled or interrupted row shows its verdict and original questions without inventing answers. Unsupported, malformed, or ambiguous inputs fall back to flattened Tool input/result text. `ui-skill` demonstrates a business-owned registration for `skill`.
 
 -----
@@ -59,10 +63,13 @@ The package realizes one dispatch rule: atomic Tool views are keyed by wire Tool
 
 ### Rendering contract
 
-`ToolCallTree` receives one root `ToolCallBlock` that already contains recursive `subCalls`, the session `cwd`, and the owner's callbacks for opening files and inspecting calls. It recursively walks the standard call blocks and sends the root and children at every depth through the same atomic dispatch path, without subscribing to a separate parent-to-children map. Each root and child wrapper preserves the `data-chat-anchor-key="call:<id>"` and `data-chat-call-id` DOM contract used for paging and selection.
+`ToolCallTree` receives one Tool node, Session `cwd`, and navigation callbacks. Each branch receives a stable block and memoizes its explicit phase props, so changing one subcall leaves unchanged sibling branches unrendered. It dispatches each tool by name through `tool.call.toolview`. Dispatched roots retain their recursive `subCalls`; preparation has no children. Each root and child wrapper preserves the `data-chat-anchor-key="call:<id>"` and `data-chat-call-id` DOM contract used for paging and selection. The Tool node keeps the same callId across all three stages.
 
 Tool owner props forward Chat's stable `useDisclosure` Hook through root and nested calls. Rows invoke it where they own their expanded bodies; intermediate renderers do not subscribe. Each invocation has independent open state that resets when the enclosing Turn collapses, without replacing React identity. Presentation-mode switches preserve it.
 
+
+The slot-injected `useToolCallArgumentsPartial` Hook lazily subscribes to the owning Step's `assistant-step` source and selects this callId's raw argument prefix. Missing sources or calls return an empty string. Other calls in the same Step may trigger a snapshot check, but an unchanged selected string does not refresh the consumer. Tools that do not invoke the Hook add no subscription; dispatched calls have no argument-prefix source.
+
 ### Cards
 
 
@@ -98,7 +105,7 @@ These pages cover the conversation host, the view slots, and the card models.
 <a id="model-experience"></a>
 ## Model Experience
 
-None, as the package is a browser-side tool presentation layer that renders logged calls without changing model context.
+None, as the package renders streamed tool identities and logged calls without changing model context.
 
 #### KV Cache effect
 

package/README.zh.md

@@ -29,6 +29,8 @@ kind: "package-reference"
 
 共享工具行和 Bash 行的失败、停止摘要在悬停时仍保留错误色和警告色；只有不处于这两种状态的摘要会在悬停时加深。
 
+派发前，模型已给出名称的调用显示为不可展开的一行，使用工具自己的图标与标题。通用行显示为`工具调用 · <工具名>`。准备阶段不提供完整参数、文件链接、结果或依赖参数的交互。write/edit 的摘要显示「正在准备内容 NKB」；N 为 `Math.ceil(raw.length / 1024)`，是原始参数字符串长度的整数近似值，不是文件字节数。`tool/call` 才启用既有调用展示；参数块结束本身不代表开始执行。
+
 ### 注册业务工具视图
 
 拥有该视图的业务包将其 wire 工具名称注册进 `tool.call.toolview`：
@@ -41,10 +43,12 @@ ctx.slots.inject('tool.call.toolview', () =>
   }, BusinessToolRow))
 ```
 
-owner 载荷为 `ToolCallOwnerProps`：`callId`、`toolName`、冻结的 `block`、可选 `cwd` 与 `home`、会话授权的 `loadImage` loader（供结果携带持久图像的视图使用），以及普通的 `openFile`/`inspect` 回调。PTC dispatch 块保留事件的 `parentCallId`；根会话调用没有该字段，因此后代调用都走同一条按 key 分发路径：已注册视图的调用（如 `read_image`）也会在嵌套处渲染对应卡片，未注册的后代调用则保持通用压平形式。路径摘要先相对会话 cwd 缩短，再把剩余的 POSIX Host home 写成 `~`；`filePath` 与 Host 打开仍使用作者给出的文件系统路径。注册项会收到常规的会话 slot 运行时共享数据，但不会收到 React 节点或运行时服务。
+owner 载荷为 `ToolCallOwnerProps`：`callId`、`toolName`、`phase` 判别字段及对应阶段的冻结 `block`、可选 `cwd` 与 `home`、会话授权的 `loadImage` loader（供结果携带持久图像的视图使用），以及普通的 `openFile`/`inspect` 回调。PTC dispatch 块保留事件的 `parentCallId`；根会话调用没有该字段，因此后代调用都走同一条按 key 分发路径：已注册视图的调用（如 `read_image`）也会在嵌套处渲染对应卡片，未注册的后代调用则保持通用压平形式。路径摘要先相对会话 cwd 缩短，再把剩余的 POSIX Host home 写成 `~`；`filePath` 与 Host 打开仍使用作者给出的文件系统路径。注册项会收到常规的会话 slot 运行时共享数据，但不会收到 React 节点或运行时服务。
 
 ### 内置视图
 
+每个注册视图都接收[工具 slot 类型](src/client/contract/slots.ts)声明的显式 `preparing`、`start` 和 `result` props。通用行在三个阶段使用同一个 `ToolRow`。行模型统一选择标题，并组合通用工具名前缀与已有参数摘要，不按生命周期阶段改变前缀；专用标题不附带英文名。准备阶段的共享参数解析入口直接返回无调用，不解析部分 JSON。write/edit 将准备态和派发后阶段拆成两个组件，只有准备态组件调用 `useToolCallArgumentsPartial`，start 与 result 共用派发后组件。Bash、Skill、Cordis 等自定义 renderer 分别处理准备态，其依赖参数的组件接收 `StartedToolCallViewProps`。
+
 本包拥有 generic fallback，以及 shell/pwsh、read、read_image、write/edit、运行中的 `str_replace_editor` `create`／`str_replace`、grep/glob、web、todo、question 与 PTC dispatch 的内置展示。结构化卡片直接从第一方原始 event 字段派生；Host `presentCall` 与 `presentResult` 值不会进入 Client。运行中与已完成的前台标准 `bash`/`pwsh` 和 `terminal_send` 调用，无论位于根还是 PTC dispatch 子调用中，都在通过相同的参数、结果和错误检查后使用 terminal 卡片。持久 `bash`/`pwsh` 调用仅在运行中使用 terminal 卡片。以已识别的 spill 策略提示结尾的 shell 输出，在 shell 行中使用可展开的 generic 输出，在 Details 中使用 generic 输出；位置被改变或被省略的退出标记无法证明成功。已完成的持久 shell 结果保持 generic 展示，因为 reset 与部分输出诊断不一定描述单个进程的退出状态；根调用的持久 shell 结果可展开，后台启动回执则保持折叠。带有 `AUTO_REVIEW_DENIED` 的原生或 PTC dispatch 失败会在折叠行显示 Auto review 裁决，展开时显示一行归一化后的“未执行”原因；原因缺失或只有空白时使用本地化 fallback 文案。成功的问题行按稳定 id 配对调用中的问题与结果中的回答，展开后显示可读的问答行。已取消或已中断的问题行显示其裁决与原始问题，不虚构回答。不受支持、格式错误或含糊的输入回退为压平的工具输入／结果文本。`ui-skill` 展示了业务包自行拥有的 `skill` 注册项。
 
 -----
@@ -59,10 +63,13 @@ owner 载荷为 `ToolCallOwnerProps`：`callId`、`toolName`、冻结的 `block`
 
 ### 渲染约定
 
-`ToolCallTree` 接收一个已经包含递归 `subCalls` 的 root `ToolCallBlock`、会话 `cwd`，以及属主用于打开文件和检查调用的回调。它递归遍历标准调用块，让 root 与任意深度的 child 经过同一条原子分发路径，不订阅独立的 parent-to-children map。每个 root 和 child 包装层都保留 `data-chat-anchor-key="call:<id>"` 与 `data-chat-call-id` DOM 约定，供分页和 selection 使用。
+`ToolCallTree` 接收一个 Tool 节点、会话 `cwd` 和导航回调。每个分支接收稳定的 block，并缓存显式阶段 props，因此一个子调用变化不会重渲染未变化的兄弟分支。它通过 `tool.call.toolview` 按工具名分发。已派发的根调用保留递归 `subCalls`，准备阶段没有子调用。每个根调用和子调用包装层都保留 `data-chat-anchor-key="call:<id>"` 与 `data-chat-call-id` DOM 约定，供分页和选择使用。Tool 节点在三个阶段保持同一个 callId。
 
 Tool 所有者属性将 Chat 注入的稳定 `useDisclosure` 钩子传给根调用及嵌套调用。工具行在拥有展开正文的位置调用它，中间 renderer 不订阅。每次调用拥有独立展开状态，外层轮次收起时重置该状态，不替换 React 身份；展示模式切换保留该状态。
 
+
+slot 注入的 `useToolCallArgumentsPartial` 钩子按需订阅所属 Step 的 `assistant-step` 来源，并选取当前 callId 的原始参数前缀。来源或调用不存在时返回空字符串。同一步骤中的其他调用可能触发快照检查，但选中的字符串未变时不会刷新使用方。不调用钩子的工具不新增订阅，已派发的调用不再提供参数前缀来源。
+
 ### 卡片
 
 
@@ -98,7 +105,7 @@ terminal model 使用浏览器安全入口 `@deepseek-ai/dsh-spill-policy/notice
 <a id="model-experience"></a>
 ## 模型体验
 
-无。该包是浏览器端工具展示层，只渲染已记录的工具调用，不改变模型上下文。
+无。该包渲染流式工具身份与已记录调用，不改变模型上下文。
 
 #### KV Cache 影响
 

package/lib/client.js

@@ -106,7 +106,45 @@ window.__ModuleLoader__.load({
 			cordis_stop: "tool.title.stopCordis",
 			cordis_undefine: "tool.title.removeCordis",
 			pwsh: "tool.title.pwsh",
-			read_image: "tool.title.readImage"
+			read_image: "tool.title.readImage",
+			todo_write: "todo.rowTitle",
+			ask_user_question: "ask.rowTitle",
+			create_goal: "tool.title.createGoal",
+			get_goal: "tool.title.getGoal",
+			update_goal: "tool.title.updateGoal",
+			schedule_create: "tool.title.createSchedule",
+			schedule_list: "tool.title.listSchedules",
+			schedule_delete: "tool.title.deleteSchedule",
+			cordis_inspect_list: "tool.title.inspectProviders",
+			cordis_inspect_query: "tool.title.queryRuntime",
+			cordis_inspect_self: "tool.title.inspectPlugins",
+			workflow: "tool.title.workflow",
+			ralph: "tool.title.ralph",
+			session_event_read: "tool.title.readEvent",
+			session_event_search: "tool.title.searchEvents",
+			session_event_trace: "tool.title.traceEvent",
+			session_search: "tool.title.searchSessions",
+			session_trace: "tool.title.traceSession",
+			list_subagent_models: "tool.title.listModels",
+			subagent: "tool.title.subagent",
+			list_agents: "tool.title.listAgents",
+			send_message: "tool.title.sendMessage",
+			interrupt_agent: "tool.title.interruptAgent",
+			job_list: "tool.title.listJobs",
+			job_output: "tool.title.readJob",
+			job_kill: "tool.title.killJob",
+			terminal_open: "tool.title.openTerminal",
+			terminal_read: "tool.title.readTerminal",
+			terminal_list: "tool.title.listTerminals",
+			terminal_signal: "tool.title.signalTerminal",
+			terminal_close: "tool.title.closeTerminal",
+			lsp: "tool.title.lsp",
+			spawn_teammate: "tool.title.spawnTeammate",
+			team_task_create: "tool.title.createTeamTask",
+			team_task_get: "tool.title.getTeamTask",
+			team_task_update: "tool.title.updateTeamTask",
+			team_task_list: "tool.title.listTeamTasks",
+			wait_agent: "tool.title.waitAgent"
 		};
 		/**
 		* Classify a tool name into its row variant.
@@ -116,6 +154,14 @@ window.__ModuleLoader__.load({
 		function classifyTool(toolName) {
 			return TOOL_VARIANTS[toolName] ?? "others";
 		}
+		/**
+		* Select a tool-owned or generic title without reading arguments.
+		* @param toolName - wire tool name.
+		* @returns the localized title key.
+		*/
+		function toolTitleKey(toolName) {
+			return TOOL_TITLE_KEYS[toolName] ?? VARIANT_TITLE_KEYS[classifyTool(toolName)];
+		}
 		function deriveAutoReviewDenial(block) {
 			if (!("kind" in block) || !block.isError) return null;
 			const error = block.error;
@@ -218,27 +264,27 @@ window.__ModuleLoader__.load({
 		/**
 		* Derive the full row model from a frozen call slice.
 		* @param toolName - wire tool name (dispatch-supplied; survives windowless results).
-		* @param block - RunningToolCall or ToolResultNode off the snapshot caches.
+		* @param block - preparing call, dispatched call, or result from the snapshot.
 		* @param cwd - session workspace root; workspace-rooted path summaries display relative to it.
 		* @param home - host account home; a leftover POSIX home path displays as `~`.
 		* @returns the row model.
 		*/
 		function toolRowModel(toolName, block, cwd, home) {
 			const variant = classifyTool(toolName);
+			const titleKey = toolTitleKey(toolName);
 			const done = "kind" in block;
-			const argsRaw = (done ? block.call?.argsRaw : block.argsRaw) ?? "";
-			const state = !done ? "running" : block.error?.code === "interrupted" ? "stopped" : block.isError ? "error" : "ok";
-			const base = argsRaw === "" ? block.callId : abbreviateHomePath(relativizeToCwd(deriveSummary(variant, argsRaw), cwd), home);
-			const toolTitleKey = TOOL_TITLE_KEYS[toolName];
-			const summary = variant === "others" && toolName !== "" && toolTitleKey === void 0 ? `${toolName} · ${base}` : base;
+			const argsRaw = done ? block.call?.argsRaw ?? "" : block.phase === "start" ? block.argsRaw : null;
+			const state = !done ? block.phase === "preparing" ? "preparing" : "running" : block.error?.code === "interrupted" ? "stopped" : block.isError ? "error" : "ok";
+			const base = argsRaw === null ? "" : argsRaw === "" ? block.callId : abbreviateHomePath(relativizeToCwd(deriveSummary(variant, argsRaw), cwd), home);
+			const summary = [titleKey === "tool.title.generic" ? toolName : "", base].filter(Boolean).join(" · ");
 			const output = done ? resultText(block) || null : null;
 			const errorSummary = state === "error" && output !== null ? firstLine(output) : null;
 			const bodyRaw = argsRaw === "" ? null : argsRaw;
 			return {
 				variant,
-				titleKey: toolTitleKey ?? VARIANT_TITLE_KEYS[variant],
+				titleKey,
 				summary,
-				filePath: deriveFilePath(variant, argsRaw),
+				filePath: argsRaw === null ? void 0 : deriveFilePath(variant, argsRaw),
 				bodyRaw,
 				output,
 				errorSummary,
@@ -251,10 +297,11 @@ window.__ModuleLoader__.load({
 		const parsedCalls = /* @__PURE__ */ new WeakMap();
 		/**
 		* Parse the call head paired with one immutable Tool block.
-		* @param block - running or settled Tool block.
-		* @returns the Tool name and object arguments, or null when the call head or valid JSON object is unavailable.
+		* @param block - preparing, dispatched, or settled Tool block.
+		* @returns the Tool name and object arguments, or null during preparation or when valid arguments are unavailable.
 		*/
 		function parsedToolCall(block) {
+			if (!("kind" in block) && block.phase === "preparing") return null;
 			const cached = parsedCalls.get(block);
 			if (cached !== void 0 || parsedCalls.has(block)) return cached ?? null;
 			const call = "kind" in block ? block.call : block;
@@ -1415,6 +1462,7 @@ window.__ModuleLoader__.load({
 		/** Visually hidden run-state label for color-only running and settlement cues. */
 		function stateStatus$1(state, t) {
 			switch (state) {
+				case "preparing": return t("row.preparing");
 				case "running": return t("row.running");
 				case "error": return t("row.failed");
 				case "stopped": return t("row.stopped");
@@ -1423,6 +1471,7 @@ window.__ModuleLoader__.load({
 		}
 		/**
 		* Render one localized tool summary and lazily mounted result card.
+		* Preparation retains the icon, title, and optional tool-name summary without disclosure.
 		* @param props - tool state, summary, output, and navigation callbacks.
 		* @returns the tool disclosure.
 		*/
@@ -1444,7 +1493,7 @@ window.__ModuleLoader__.load({
 			const inputRaw = bodyRaw ?? null;
 			const outputText = output ?? null;
 			const card = askQuestionBody ?? terminalBody ?? diffBody ?? readBody ?? imageBody ?? searchBody ?? webBody ?? detailsBody;
-			const expandable = inputRaw !== null || outputText !== null || card !== null;
+			const expandable = state !== "preparing" && (inputRaw !== null || outputText !== null || card !== null);
 			const open = expanded && expandable;
 			const bodyText = (0, react.useMemo)(() => open && card === null && inputRaw !== null ? formatToolBody(variant, inputRaw) : null, [
 				card,
@@ -1453,7 +1502,7 @@ window.__ModuleLoader__.load({
 				variant
 			]);
 			const status = stateStatus$1(state, t);
-			const running = state === "running";
+			const running = state === "running" || state === "preparing";
 			const normalSummary = terminalBody?.description ?? (open ? detailsBody?.expandedSummary ?? summary : summary);
 			const summaryText = (state === "error" ? errorSummary ?? normalSummary : null) ?? normalSummary;
 			const diffStat = (0, react.useMemo)(() => {
@@ -1672,6 +1721,7 @@ window.__ModuleLoader__.load({
 			code: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCodeOutlineRegular, { size: 14 }),
 			others: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSparkleRegular, { size: 14 })
 		};
+		/** @param props - current tool stage and locale. @returns its preparation or dispatched card. */
 		function GenericToolCard({ toolName, block, cwd, home, openFile, inspect, useDisclosure, t }) {
 			const model = toolRowModel(toolName, block, cwd, home);
 			const autoReview = model.autoReviewDenial === null ? null : localizeAutoReviewDenial(model.autoReviewDenial, t);
@@ -1722,16 +1772,38 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region lib/types/client/tool/ToolCallTree.js
 		/** Root/subcall Tool composition with one keyed atomic dispatch path. */
-		/** Resolve a Tool call's wire name from either lifecycle form. */
-		function callName(node) {
-			return "kind" in node ? node.call?.name ?? "" : node.name;
+		function toolCallPhase(block) {
+			if ("kind" in block) return {
+				phase: "result",
+				block
+			};
+			return block.phase === "preparing" ? {
+				phase: "preparing",
+				block
+			} : {
+				phase: "start",
+				block
+			};
+		}
+		/** Resolve a Tool call's wire name from its current stage. */
+		function callName(call) {
+			return call.phase === "result" ? call.block.call?.name ?? "" : call.block.name;
 		}
 		/** One atomic call dispatched through the Tool-owned keyed slot. */
-		const ToolCall = (0, react.memo)(function ToolCall({ renderSlot, callId, toolName, block, openFile, cwd, home, inspectCall, loadImage, useDisclosure, t, children }) {
+		const ToolCall = (0, react.memo)(function ToolCall({ renderSlot, callId, toolName, call, assistant, openFile, cwd, home, inspectCall, loadImage, useDisclosure, t, children }) {
+			const preparing = call.phase === "preparing";
+			const hookContext = (0, react.useMemo)(() => ({
+				callId,
+				assistant: preparing ? assistant : void 0
+			}), [
+				assistant,
+				callId,
+				preparing
+			]);
 			const owner = (0, react.useMemo)(() => ({
 				callId,
 				toolName,
-				block,
+				...call,
 				openFile,
 				cwd,
 				home,
@@ -1743,7 +1815,7 @@ window.__ModuleLoader__.load({
 			}), [
 				callId,
 				toolName,
-				block,
+				call,
 				openFile,
 				cwd,
 				home,
@@ -1751,7 +1823,7 @@ window.__ModuleLoader__.load({
 				inspectCall,
 				useDisclosure
 			]);
-			const autoReviewDenied = (0, react.useMemo)(() => toolRowModel(toolName, block).autoReviewDenial !== null, [toolName, block]);
+			const autoReviewDenied = (0, react.useMemo)(() => call.phase === "result" && toolRowModel(toolName, call.block).autoReviewDenial !== null, [toolName, call]);
 			return (0, react_jsx_runtime.jsxs)("div", {
 				className: ToolCallTree_module_css_default.callRow,
 				"data-chat-anchor-key": `call:${callId}`,
@@ -1761,6 +1833,7 @@ window.__ModuleLoader__.load({
 					t
 				}) : renderSlot("tool.call.toolview", owner, {
 					entryKey: toolName,
+					hookContext,
 					fallback: (0, react_jsx_runtime.jsx)(GenericToolCard, {
 						...owner,
 						t
@@ -1768,12 +1841,14 @@ window.__ModuleLoader__.load({
 				}), children]
 			});
 		});
-		const ToolCallBranch = (0, react.memo)(function ToolCallBranch({ renderSlot, block, cwd, home, openFile, inspectCall, loadImage, useDisclosure, t }) {
+		const ToolCallBranch = (0, react.memo)(function ToolCallBranch({ renderSlot, block, assistant, cwd, home, openFile, inspectCall, loadImage, useDisclosure, t }) {
+			const call = (0, react.useMemo)(() => toolCallPhase(block), [block]);
 			return (0, react_jsx_runtime.jsx)(ToolCall, {
 				renderSlot,
-				callId: block.callId,
-				toolName: callName(block),
-				block,
+				callId: call.block.callId,
+				toolName: callName(call),
+				call,
+				assistant,
 				openFile,
 				cwd,
 				home,
@@ -1781,12 +1856,13 @@ window.__ModuleLoader__.load({
 				useDisclosure,
 				loadImage,
 				t,
-				children: block.subCalls.length > 0 ? (0, react_jsx_runtime.jsx)("div", {
+				children: call.phase !== "preparing" && call.block.subCalls.length > 0 ? (0, react_jsx_runtime.jsx)("div", {
 					className: ToolCallTree_module_css_default.subCalls,
 					"data-subcalls": true,
-					children: block.subCalls.map((child) => (0, react_jsx_runtime.jsx)(ToolCallBranch, {
+					children: call.block.subCalls.map((child) => (0, react_jsx_runtime.jsx)(ToolCallBranch, {
 						renderSlot,
 						block: child,
+						assistant,
 						cwd,
 						home,
 						openFile,
@@ -1806,10 +1882,11 @@ window.__ModuleLoader__.load({
 		*/
 		function ToolCallTree({ renderSlot, node, cwd, openFile, inspectCall, loadImage, useDisclosure, useHostInfo, t }) {
 			const home = useHostInfo((info) => info.home);
-			const block = node.data.root;
+			const assistant = node.location.kind === "step" ? node.location.step.data.source("assistant-step") : void 0;
 			return (0, react_jsx_runtime.jsx)(ToolCallBranch, {
 				renderSlot,
-				block,
+				block: node.data.root,
+				assistant,
 				cwd,
 				home,
 				openFile,
@@ -1820,6 +1897,27 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region lib/types/client/tool/tool-call-arguments-partial.js
+		/** Call-local argument subscription bound by the atomic Tool slot. */
+		const subscribeEmpty = () => () => {};
+		/**
+		* Bind one call without subscribing until its component invokes the Hook.
+		* @param _standard - framework-provided scope props.
+		* @param context - the preparing call's Step source and identity.
+		* @returns a Hook that reads only this call's raw argument prefix.
+		*/
+		const bindToolCallArgumentsPartial = (_standard, context) => {
+			const { assistant, callId } = context;
+			const subscribe = assistant === void 0 ? subscribeEmpty : (listener) => assistant.subscribe(listener);
+			const getSnapshot = () => {
+				const block = assistant?.getSnapshot()?.blocks.find((candidate) => candidate.kind === "tool-call" && candidate.callId === callId);
+				return block?.kind === "tool-call" ? block.argsRaw : "";
+			};
+			return function useToolCallArgumentsPartial() {
+				return (0, react.useSyncExternalStore)(subscribe, getSnapshot);
+			};
+		};
+		//#endregion
 		//#region lib/types/client/locale.js
 		/** Locale namespace supplied by the conversation owner to Tool renderers. */
 		const CONVERSATION_NS = "conversation";
@@ -1917,7 +2015,7 @@ window.__ModuleLoader__.load({
 		function AskQuestionRow({ toolName, block, inspect, useDisclosure, t }) {
 			const model = toolRowModel(toolName, block);
 			const code = "kind" in block ? block.error?.code : void 0;
-			const argsRaw = ("kind" in block ? block.call?.argsRaw : block.argsRaw) ?? "";
+			const argsRaw = model.bodyRaw ?? "";
 			let summary = model.summary;
 			let state = model.state;
 			let transcript = null;
@@ -1958,7 +2056,7 @@ window.__ModuleLoader__.load({
 				variant: model.variant,
 				toolName,
 				icon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconQuestionOutlineRegular, {}),
-				title: t("ask.rowTitle"),
+				title: t(model.titleKey),
 				summary,
 				bodyRaw: transcript === null ? model.bodyRaw : null,
 				output: transcript === null ? model.output : null,
@@ -1980,6 +2078,25 @@ window.__ModuleLoader__.load({
 			}
 		};
 		//#endregion
+		//#region lib/types/client/tool/components/PreparingToolRow.js
+		/**
+		* Render a non-expandable tool prefix with an optional preparation summary.
+		* @param props - tool prefix and locale.
+		* @returns the preparation row.
+		*/
+		function PreparingToolRow({ toolName, useDisclosure, icon, title, summary = "", t }) {
+			return (0, react_jsx_runtime.jsx)(ToolRow, {
+				useDisclosure,
+				t,
+				variant: classifyTool(toolName),
+				toolName,
+				icon,
+				title,
+				summary,
+				state: "preparing"
+			});
+		}
+		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-tool/src/client/tool/toolviews/bash-sample.module.css.mjs
 		const css = ".CY-8Ka_card{flex-direction:column;display:flex}.CY-8Ka_terminal{--dsl-terminal-font:var(--dsw-font-markdown-code-block-small);--dsl-terminal-line-height:18px;--dsl-terminal-output-max-height:224px;border:.5px solid var(--dsw-alias-border-l1);margin:4px 0 4px 4px}.CY-8Ka_ioCard{border:.5px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-markdown-code-block);font:var(--dsw-font-markdown-code-block-small);border-radius:12px;flex-direction:column;margin:4px 0 4px 4px;display:flex}.CY-8Ka_ioSection{grid-template-columns:max-content 1fr;align-items:baseline;column-gap:14px;max-height:150px;padding:12px 16px;display:grid;overflow-y:auto}.CY-8Ka_ioSection::-webkit-scrollbar-thumb{background-clip:padding-box;border:2px solid #0000;border-radius:6px}.CY-8Ka_ioSection::-webkit-scrollbar-track{margin:6px 0}.CY-8Ka_ioLabel{color:var(--dsw-alias-label-caption);align-self:start;position:sticky;top:0}.CY-8Ka_ioDivider{background:var(--dsw-alias-border-l2);flex:none;height:.5px}.CY-8Ka_ioText{white-space:pre-wrap;word-break:break-word;min-width:0;color:var(--dsw-alias-label-secondary)}.CY-8Ka_ioText[data-error]{color:var(--dsw-alias-state-error-primary)}.CY-8Ka_root[data-expandable]{cursor:pointer}.CY-8Ka_root{height:calc(24px + var(--dsh-content-font-delta,0px));align-items:center;min-width:0;display:flex}.CY-8Ka_leading{width:calc(16px + var(--dsh-content-font-delta,0px));height:calc(16px + var(--dsh-content-font-delta,0px));color:var(--dsw-alias-label-tertiary);flex:none;justify-content:center;align-items:center;margin-right:6px;display:inline-flex;position:relative}.CY-8Ka_leading svg:not([data-state]){width:calc(14px + var(--dsh-content-font-delta,0px));height:calc(14px + var(--dsh-content-font-delta,0px))}.CY-8Ka_chevron{color:var(--dsw-alias-label-secondary)}.CY-8Ka_iconIdle{opacity:1;transition:opacity .1s;display:inline-flex}.CY-8Ka_chevronHover{opacity:0;margin:auto;transition:opacity .1s;position:absolute;inset:0}.CY-8Ka_root:hover .CY-8Ka_iconIdle{opacity:0}.CY-8Ka_root:hover .CY-8Ka_chevronHover{opacity:1}.CY-8Ka_title{font-size:var(--dsh-content-font-size-secondary,13px);line-height:calc(24px + var(--dsh-content-font-delta,0px));color:var(--dsw-alias-label-secondary);flex:none;transition:color .1s}.CY-8Ka_sep{background:var(--dsw-alias-label-caption);border-radius:1px;flex:none;width:2px;height:2px;margin:0 8px}.CY-8Ka_summary{text-overflow:ellipsis;white-space:nowrap;min-width:0;font-size:var(--dsh-content-font-size-secondary,13px);line-height:calc(24px + var(--dsh-content-font-delta,0px));color:var(--dsw-alias-label-tertiary);flex:auto;transition:color .1s;overflow:hidden}.CY-8Ka_root:hover .CY-8Ka_title,.CY-8Ka_root:hover .CY-8Ka_summary:not(.CY-8Ka_errorSummary):not(.CY-8Ka_stoppedSummary){color:var(--dsw-alias-label-primary)}.CY-8Ka_errorSummary{color:var(--dsw-alias-state-error-primary)}.CY-8Ka_stoppedSummary{color:var(--dsw-alias-state-warn-label)}.CY-8Ka_bodyWrap{flex-direction:column;display:flex}.CY-8Ka_inspectButton{border:.5px solid var(--dsw-alias-border-l4);corner-shape:round;background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-secondary);cursor:pointer;opacity:0;border-radius:999px;align-self:flex-start;align-items:center;gap:4px;margin:4px 0 2px 4px;padding:2px 8px;font-size:11px;line-height:16px;transition:opacity .1s;display:inline-flex}.CY-8Ka_card:hover .CY-8Ka_inspectButton,.CY-8Ka_inspectButton:focus-visible{opacity:1}.CY-8Ka_inspectButton:hover{background:var(--dsw-alias-interactive-bg-hover-solid);color:var(--dsw-alias-label-primary)}.CY-8Ka_visuallyHidden{clip:rect(0 0 0 0);white-space:nowrap;width:1px;height:1px;position:absolute;overflow:hidden}";
 		const tagId = "@deepseek-ai/dsh-client-ui-tool/bash-sample.module.css";
@@ -2029,7 +2146,15 @@ window.__ModuleLoader__.load({
 		* @param props - tool call, Session sources, locale, and inspection callback.
 		* @returns the Bash output row.
 		*/
-		const BashRow = (0, react.memo)(function BashRow({ toolName, block, sessionId, useSessions, inspect, useDisclosure, t }) {
+		const BashRow = (0, react.memo)(function BashRow(props) {
+			if (props.phase === "preparing") return (0, react_jsx_runtime.jsx)(PreparingToolRow, {
+				...props,
+				icon: BASH_ICON,
+				title: props.t(toolTitleKey(props.toolName))
+			});
+			return (0, react_jsx_runtime.jsx)(StartedBashRow, { ...props });
+		});
+		const StartedBashRow = (0, react.memo)(function StartedBashRow({ toolName, block, sessionId, useSessions, inspect, useDisclosure, t }) {
 			const model = (0, react.useMemo)(() => toolRowModel(toolName, block), [toolName, block]);
 			const cwd = useSessions((list) => list.byId[sessionId]?.cwd);
 			const terminalModel = (0, react.useMemo)(() => terminalCardModel(block, cwd), [block, cwd]);
@@ -2157,10 +2282,25 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region lib/types/client/tool/toolviews/file-mutation-row.js
+		const FILE_MUTATION_ICON = (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutlineRegular, { size: 14 });
 		/**
 		* Lets users expand an applied file diff and open the reported path.
 		*/
-		function FileMutationRow({ toolName, block, cwd, home, openFile, inspect, useDisclosure, t }) {
+		function FileMutationRow(props) {
+			return props.phase === "preparing" ? (0, react_jsx_runtime.jsx)(PreparingFileMutationRow, { ...props }) : (0, react_jsx_runtime.jsx)(StartedFileMutationRow, { ...props });
+		}
+		function PreparingFileMutationRow({ toolName, useDisclosure, useToolCallArgumentsPartial, t }) {
+			const raw = useToolCallArgumentsPartial();
+			return (0, react_jsx_runtime.jsx)(PreparingToolRow, {
+				toolName,
+				useDisclosure,
+				icon: FILE_MUTATION_ICON,
+				title: t(toolTitleKey(toolName)),
+				t,
+				summary: t("tool.preparing.content", { kilobytes: Math.ceil(raw.length / 1024) })
+			});
+		}
+		function StartedFileMutationRow({ toolName, block, cwd, home, openFile, inspect, useDisclosure, t }) {
 			const model = toolRowModel(toolName, block, cwd, home);
 			const diff = diffCardModel(block);
 			return (0, react_jsx_runtime.jsx)(ToolRow, {
@@ -2168,7 +2308,7 @@ window.__ModuleLoader__.load({
 				t,
 				variant: model.variant,
 				toolName,
-				icon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutlineRegular, { size: 14 }),
+				icon: FILE_MUTATION_ICON,
 				title: t(model.titleKey),
 				summary: model.summary,
 				output: model.output,
@@ -3506,51 +3646,22 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region lib/types/client/tool/toolviews/details-row.js
 		/** Keyed recorded-result rows sharing the compact detail body. */
-		const TITLE_KEYS = {
-			create_goal: "tool.title.createGoal",
-			get_goal: "tool.title.getGoal",
-			update_goal: "tool.title.updateGoal",
-			schedule_create: "tool.title.createSchedule",
-			schedule_list: "tool.title.listSchedules",
-			schedule_delete: "tool.title.deleteSchedule",
-			cordis_inspect_list: "tool.title.inspectProviders",
-			cordis_inspect_query: "tool.title.queryRuntime",
-			cordis_inspect_self: "tool.title.inspectPlugins",
-			workflow: "tool.title.workflow",
-			ralph: "tool.title.ralph",
-			session_event_read: "tool.title.readEvent",
-			session_event_search: "tool.title.searchEvents",
-			session_event_trace: "tool.title.traceEvent",
-			session_search: "tool.title.searchSessions",
-			session_trace: "tool.title.traceSession",
-			list_subagent_models: "tool.title.listModels",
-			subagent: "tool.title.subagent",
-			list_agents: "tool.title.listAgents",
-			send_message: "tool.title.sendMessage",
-			interrupt_agent: "tool.title.interruptAgent",
-			job_list: "tool.title.listJobs",
-			job_output: "tool.title.readJob",
-			job_kill: "tool.title.killJob",
-			terminal_open: "tool.title.openTerminal",
-			terminal_read: "tool.title.readTerminal",
-			terminal_list: "tool.title.listTerminals",
-			terminal_signal: "tool.title.signalTerminal",
-			terminal_close: "tool.title.closeTerminal",
-			lsp: "tool.title.lsp",
-			spawn_teammate: "tool.title.spawnTeammate",
-			team_task_create: "tool.title.createTeamTask",
-			team_task_get: "tool.title.getTeamTask",
-			team_task_update: "tool.title.updateTeamTask",
-			team_task_list: "tool.title.listTeamTasks",
-			wait_agent: "tool.title.waitAgent"
-		};
 		const LSP_TITLE_KEYS = {
 			goToDefinition: "tool.title.findDefinition",
 			findReferences: "tool.title.findReferences",
 			goToImplementation: "tool.title.findImplementation",
 			hover: "tool.title.hoverSymbol"
 		};
+		/** Teammate-coordination tools presented with the two-person team icon. */
+		const TEAMMATE_TOOLS = new Set([
+			"spawn_teammate",
+			"list_agents",
+			"send_message",
+			"interrupt_agent",
+			"wait_agent"
+		]);
 		function detailIcon(toolName) {
+			if (TEAMMATE_TOOLS.has(toolName)) return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconUsersOutlineRegular, { size: 14 });
 			if (toolName.startsWith("schedule_")) return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconClockOutlineRegular, { size: 14 });
 			if (toolName.endsWith("_goal")) return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconGoalOutlineRegular, { size: 14 });
 			if (toolName.startsWith("cordis_")) return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCordisPluginOutlineRegular, {});
@@ -3574,7 +3685,7 @@ window.__ModuleLoader__.load({
 				locale
 			]);
 			const operation = toolName === "lsp" ? parsedToolCall(block)?.args.operation : void 0;
-			const titleKey = typeof operation === "string" && Object.hasOwn(LSP_TITLE_KEYS, operation) ? LSP_TITLE_KEYS[operation] : Object.hasOwn(TITLE_KEYS, toolName) ? TITLE_KEYS[toolName] : model.titleKey;
+			const titleKey = typeof operation === "string" && Object.hasOwn(LSP_TITLE_KEYS, operation) ? LSP_TITLE_KEYS[operation] : model.titleKey;
 			return (0, react_jsx_runtime.jsx)(ToolRow, {
 				useDisclosure,
 				t,
@@ -3981,6 +4092,7 @@ window.__ModuleLoader__.load({
 			return typeof value === "object" && value !== null;
 		}
 		function summarize(argsRaw, t) {
+			if (argsRaw === null) return null;
 			let parsed;
 			try {
 				parsed = JSON.parse(argsRaw);
@@ -4011,7 +4123,7 @@ window.__ModuleLoader__.load({
 				t
 			]);
 			const model = toolRowModel(toolName, block);
-			const summary = summarize(("kind" in block ? block.call?.argsRaw : block.argsRaw) ?? "", t) ?? {
+			const summary = summarize(model.bodyRaw, t) ?? {
 				text: model.summary,
 				extra: 0
 			};
@@ -4021,7 +4133,7 @@ window.__ModuleLoader__.load({
 				variant: model.variant,
 				toolName,
 				icon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChecklistOutlineRegular, {}),
-				title: t("todo.rowTitle"),
+				title: t(model.titleKey),
 				summary: summary.text,
 				summarySuffix: [diff?.summary, summary.extra > 0 ? `+${summary.extra}` : null].filter((part) => part !== null && part !== void 0).join(" · ") || null,
 				bodyRaw: model.bodyRaw,
@@ -4111,7 +4223,8 @@ window.__ModuleLoader__.load({
 				locale: CONVERSATION_NS,
 				children: { "tool.call.toolview": {
 					kind: "keyed",
-					scope: "session"
+					scope: "session",
+					inject: { hooks: { toolCallArgumentsPartial: bindToolCallArgumentsPartial } }
 				} },
 				inject: toolInject
 			}, ToolCallTree));

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

@@ -1,7 +1,7 @@
 /** Tool UI slot declarations and their composed component props. */
-import type { HostObservable, InjectFace, PropsLocale, PropsRenderSlots, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { HostObservable, InjectFace, PropsLocale, PropsRenderSlots, PropsRuntime, SlotHookFactory } from '@deepseek-ai/dsh-client-ui-slots';
 import type { RemoteHostFacts } from '@deepseek-ai/dsh-api-remotes/client';
-import type { OpenFileOptions, ToolCallBlock, UseDisclosure } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { AssistantChatData, OpenFileOptions, PreparingToolCall, StartedToolCall, ToolResultNode, UseDisclosure } from '@deepseek-ai/dsh-client-ui-chat/client';
 import type { MessageImageLoader, MessageImageSource } from '@deepseek-ai/dsh-client-ui-conversation/client';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface SlotMap {
@@ -12,12 +12,15 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
          *
          * Registering an occupied key replaces its view; unclaimed keys use the
          * generic row. The owner supplies the call identity and frozen running
-         * or settled node through ToolCallOwnerProps.
+         * or settled node through explicit phase props. Preparing blocks have no dispatched
+         * arguments; useToolCallArgumentsPartial optionally subscribes to their raw prefix.
          */
         'tool.call.toolview': {
             kind: 'keyed';
             scope: 'session';
             owner: ToolCallOwnerProps;
+            hookContext: ToolCallHookContext;
+            inject: ToolCallInjected;
         };
         /**
          * Durable images of a settled image-bearing Tool call, rendered through
@@ -39,6 +42,20 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
         };
     }
 }
+/** Subscribe to this preparing call's raw argument prefix; other phases return an empty string. */
+export type UseToolCallArgumentsPartial = () => string;
+/** Call-local sources supplied by the Tool tree to the slot's Hook binding. */
+export interface ToolCallHookContext {
+    readonly callId: string;
+    /** This call's Step source, present only while preparing. */
+    readonly assistant: HostObservable<Readonly<AssistantChatData> | undefined> | undefined;
+}
+/** Framework-bound subscriptions available to atomic Tool views on demand. */
+export interface ToolCallInjected {
+    hooks: {
+        toolCallArgumentsPartial: SlotHookFactory<'tool.call.toolview', UseToolCallArgumentsPartial>;
+    };
+}
 /** Owner currency of the Tool image gallery slot: references plus the loader. */
 export interface ToolImagesOwnerProps {
     /** Durable references or submission-echo previews in result order. */
@@ -49,37 +66,43 @@ export interface ToolImagesOwnerProps {
     align: 'start' | 'end';
 }
 /** Standard owner currency supplied to every atomic Tool view. */
-export interface ToolCallOwnerProps {
-    /** Stable injected Hook; each invocation owns its open state and subscribes to enclosing-Turn resets. */
+export interface ToolCallCommonProps {
+    /** Stable Hook; each invocation owns its open state and subscribes to enclosing-Turn resets. */
     useDisclosure: UseDisclosure;
-    /** Tool call identity, stable across running and settled forms. */
+    /** Call identity, stable across all stages. */
     callId: string;
     /** Wire Tool name and keyed dispatch value. */
     toolName: string;
-    /** Frozen running call or settled result node. */
-    block: ToolCallBlock;
     /** Session workspace root for relative summaries. */
     cwd?: string | undefined;
     /** Host account home; POSIX home-rooted summaries display as `~`. */
     home?: string | undefined;
-    /**
-     * Open a Tool argument path. A view that knows which line the call was about
-     * passes it, and the opened surface lands there.
-     */
+    /** Open an argument path at its optional requested line. */
     openFile: (path: string, options?: OpenFileOptions) => void;
-    /**
-     * Session-authorized image loader for the `tool.call.images` slot, supplied
-     * by the chat node that owns this call. A composed chat node always
-     * supplies it (`ChatNodeOwnerProps.loadImage` is required), so the tool
-     * layer never imports an attachment implementation nor handles URL
-     * authorization.
-     */
+    /** Chat-supplied, session-authorized loader for durable images; Tool views do not manage attachment URLs. */
     loadImage: MessageImageLoader;
     /** Inspect this call in the trajectory view when available. */
     inspect?: (() => void) | undefined;
 }
+/** Stage-specific tool data; only start/result expose the dispatched call material. */
+export type ToolCallPhaseProps = {
+    readonly phase: 'preparing';
+    readonly block: PreparingToolCall;
+} | {
+    readonly phase: 'start';
+    readonly block: StartedToolCall;
+} | {
+    readonly phase: 'result';
+    readonly block: ToolResultNode;
+};
+/** Common owner callbacks and the data admitted at the current tool stage. */
+export type ToolCallOwnerProps = ToolCallCommonProps & ToolCallPhaseProps;
 /** Full props of a registered atomic Tool view. */
 export type ToolCallViewProps = PropsRuntime<'tool.call.toolview'>;
+/** Existing argument/result business components exclude the preparation stage. */
+export type StartedToolCallViewProps = Exclude<ToolCallViewProps, {
+    readonly phase: 'preparing';
+}>;
 /** Injected Host description for POSIX home-path display. */
 export type ToolHostInfoInjected = {
     hooks: {
@@ -92,6 +115,6 @@ export type ToolHostInfoInjected = {
         hostInfo: HostObservable<RemoteHostFacts>;
     };
 };
-/** Full props of the Tool call-tree renderer registered as a `tool-call` Chat Node. */
+/** Full props of the Tool call-tree renderer registered as a tool-call Chat Node. */
 export type ToolTreeProps = PropsRuntime<'conversation.chat.node', 'tool-call'> & PropsRenderSlots<'tool.call.toolview'> & PropsLocale<'conversation'> & InjectFace<ToolHostInfoInjected>;
 //# sourceMappingURL=slots.d.ts.map

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

@@ -1,4 +1,4 @@
 /** Browser Tool plugin: whole-call composition and keyed atomic Tool views. */
 export { apply, inject } from './apply.ts';
-export type { ToolCallOwnerProps, ToolCallViewProps, ToolHostInfoInjected, ToolTreeProps, } from './contract/slots.ts';
+export type { StartedToolCallViewProps, ToolCallCommonProps, ToolCallOwnerProps, ToolCallPhaseProps, ToolCallViewProps, ToolCallHookContext, ToolCallInjected, ToolHostInfoInjected, ToolTreeProps, UseToolCallArgumentsPartial, } from './contract/slots.ts';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/client/tool/components/PreparingToolRow.d.ts

@@ -0,0 +1,19 @@
+/** Tool-owned non-expandable chrome without dispatched argument material. */
+import type { ReactNode } from 'react';
+import type { ToolCallViewProps } from '../../contract/slots.ts';
+import { type ToolRowProps } from './ToolRow.tsx';
+/** Inputs contain a tool-owned icon/title and no expandable body. */
+type PreparingToolRowProps = Pick<ToolCallViewProps, 'toolName' | 'useDisclosure'> & {
+    readonly icon: ReactNode;
+    readonly title: string;
+    readonly summary?: string;
+    readonly t: ToolRowProps['t'];
+};
+/**
+ * Render a non-expandable tool prefix with an optional preparation summary.
+ * @param props - tool prefix and locale.
+ * @returns the preparation row.
+ */
+export declare function PreparingToolRow({ toolName, useDisclosure, icon, title, summary, t }: PreparingToolRowProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=PreparingToolRow.d.ts.map

package/lib/types/client/tool/components/ToolRow.d.ts

@@ -78,6 +78,7 @@ export interface ToolRowProps {
 }
 /**
  * Render one localized tool summary and lazily mounted result card.
+ * Preparation retains the icon, title, and optional tool-name summary without disclosure.
  * @param props - tool state, summary, output, and navigation callbacks.
  * @returns the tool disclosure.
  */

package/lib/types/client/tool/models/raw-tool-call.d.ts

@@ -1,5 +1,6 @@
 /** Shared narrowing for raw Tool call and result fields consumed by card models. */
-import type { ToolCallBlock, ToolResultNode } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { ToolResultNode } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { ToolCallBlock } from './tool-call-model.ts';
 /** A parsed, in-window Tool call whose arguments are a JSON object. */
 export interface ParsedToolCall {
     name: string;
@@ -7,8 +8,8 @@ export interface ParsedToolCall {
 }
 /**
  * Parse the call head paired with one immutable Tool block.
- * @param block - running or settled Tool block.
- * @returns the Tool name and object arguments, or null when the call head or valid JSON object is unavailable.
+ * @param block - preparing, dispatched, or settled Tool block.
+ * @returns the Tool name and object arguments, or null during preparation or when valid arguments are unavailable.
  */
 export declare function parsedToolCall(block: ToolCallBlock): ParsedToolCall | null;
 /**

package/lib/types/client/tool/models/todo-diff-model.d.ts

@@ -1,5 +1,5 @@
 /** Todo changes relative to the preceding recorded write. */
-import type { ToolCallBlock } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { ToolCallBlock } from './tool-call-model.ts';
 import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolDetailsModel } from '../components/ToolDetails.tsx';
 import type { TodoBaseline } from './todo-history.ts';

package/lib/types/client/tool/models/tool-call-model.d.ts

@@ -11,13 +11,13 @@ export type { ToolCallBlock } from '@deepseek-ai/dsh-client-ui-chat/client';
 /** Tool-call row variants selected by the generic atomic renderer. */
 export type ToolRowVariant = 'search' | 'read' | 'bash' | 'write' | 'edit' | 'code' | 'others';
 /** Row lifecycle state used by summary styling and accessible status text. */
-export type ToolRowState = 'running' | 'ok' | 'error' | 'stopped';
+export type ToolRowState = 'preparing' | 'running' | 'ok' | 'error' | 'stopped';
 /** Locale-neutral structured fact consumed only by the user-facing Tool row. */
 export interface AutoReviewDenial {
     /** Raw persisted reviewer reason; display normalization happens at render time. */
     reason: string | null;
 }
-type ToolTitleKey = Extract<LocaleKeysOf<'conversation'>, `tool.title.${string}`>;
+type ToolTitleKey = Extract<LocaleKeysOf<'conversation'>, `tool.title.${string}` | 'ask.rowTitle' | 'todo.rowTitle'>;
 /** Locale key per generic row variant. */
 export declare const VARIANT_TITLE_KEYS: {
     readonly search: "tool.title.search";
@@ -34,10 +34,17 @@ export declare const VARIANT_TITLE_KEYS: {
  * @returns matching variant, others when unknown.
  */
 export declare function classifyTool(toolName: string): ToolRowVariant;
+/**
+ * Select a tool-owned or generic title without reading arguments.
+ * @param toolName - wire tool name.
+ * @returns the localized title key.
+ */
+export declare function toolTitleKey(toolName: string): ToolTitleKey;
 /** Everything ToolRow needs, derived once from the frozen slice. */
 export interface ToolRowModel {
     variant: ToolRowVariant;
     titleKey: ToolTitleKey;
+    /** Generic rows retain the wire tool name; available arguments append their summary. */
     summary: string;
     /**
      * Filesystem path from args (`path` / `file_path`) when the row is a file
@@ -73,7 +80,7 @@ export declare function formatToolBody(variant: ToolRowVariant, argsRaw: string)
 /**
  * Derive the full row model from a frozen call slice.
  * @param toolName - wire tool name (dispatch-supplied; survives windowless results).
- * @param block - RunningToolCall or ToolResultNode off the snapshot caches.
+ * @param block - preparing call, dispatched call, or result from the snapshot.
  * @param cwd - session workspace root; workspace-rooted path summaries display relative to it.
  * @param home - host account home; a leftover POSIX home path displays as `~`.
  * @returns the row model.

package/lib/types/client/tool/tool-call-arguments-partial.d.ts

@@ -0,0 +1,9 @@
+import type { ToolCallInjected } from '../contract/slots.ts';
+/**
+ * Bind one call without subscribing until its component invokes the Hook.
+ * @param _standard - framework-provided scope props.
+ * @param context - the preparing call's Step source and identity.
+ * @returns a Hook that reads only this call's raw argument prefix.
+ */
+export declare const bindToolCallArgumentsPartial: ToolCallInjected['hooks']['toolCallArgumentsPartial'];
+//# sourceMappingURL=tool-call-arguments-partial.d.ts.map

package/lib/types/client/tool/toolviews/GenericToolCard.d.ts

@@ -1,7 +1,8 @@
 import type { ToolCallOwnerProps, ToolTreeProps } from '../../contract/slots.ts';
 /** Card props: the owner payload plus the render site's locale seat (plain prop). */
-export interface GenericToolCardProps extends ToolCallOwnerProps {
+export type GenericToolCardProps = ToolCallOwnerProps & {
     t: ToolTreeProps['t'];
-}
+};
+/** @param props - current tool stage and locale. @returns its preparation or dispatched card. */
 export declare function GenericToolCard({ toolName, block, cwd, home, openFile, inspect, useDisclosure, t }: GenericToolCardProps): import("react").JSX.Element;
 //# sourceMappingURL=GenericToolCard.d.ts.map

package/lib/types/client/tool/toolviews/bash-sample.d.ts

@@ -7,7 +7,7 @@ type BashRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
  * @param props - tool call, Session sources, locale, and inspection callback.
  * @returns the Bash output row.
  */
-export declare const BashRow: import("react").MemoExoticComponent<({ toolName, block, sessionId, useSessions, inspect, useDisclosure, t }: BashRowProps) => import("react").JSX.Element>;
+export declare const BashRow: import("react").MemoExoticComponent<(props: BashRowProps) => import("react").JSX.Element>;
 /** Registers the standalone Bash conversation-row sample. */
 export declare const bashToolviewSample: {
     name: string;

package/lib/types/client/tool/toolviews/details-row.d.ts

@@ -1,16 +1,18 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolCallViewProps } from '../../contract/slots.ts';
+type DetailsRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
 /**
  * Present recorded entities, receipts, and report fields in the existing expandable row.
  * @param props - Tool call, row actions, and locale supplied by the keyed slot.
  * @returns A Tool row with structured details or generic input/output.
  */
-export declare function DetailsRow({ toolName, block, cwd, home, openFile, inspect, useDisclosure, t }: ToolCallViewProps & PropsLocale<'conversation'>): import("react").JSX.Element;
+export declare function DetailsRow({ toolName, block, cwd, home, openFile, inspect, useDisclosure, t }: DetailsRowProps): import("react").JSX.Element;
 /** Register recorded-result details through the standard atomic Tool slot. */
 export declare const detailsToolview: {
     name: string;
     inject: string[];
     apply(ctx: Context): void;
 };
+export {};
 //# sourceMappingURL=details-row.d.ts.map

package/lib/types/client/tool/toolviews/file-mutation-row.d.ts

@@ -5,7 +5,7 @@ type FileMutationRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
 /**
  * Lets users expand an applied file diff and open the reported path.
  */
-export declare function FileMutationRow({ toolName, block, cwd, home, openFile, inspect, useDisclosure, t }: FileMutationRowProps): import("react").JSX.Element;
+export declare function FileMutationRow(props: FileMutationRowProps): import("react").JSX.Element;
 /** Registers the edit and write conversation rows. */
 export declare const fileMutationToolview: {
     name: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-tool",
   "description": "Client Tool call-tree renderer and keyed per-tool presentation slot",
-  "version": "0.1.7-alpha.2",
+  "version": "0.1.7-rc.1",
   "publishConfig": {
     "access": "public"
   },
@@ -46,32 +46,32 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "clsx": "^2.0.0",
-    "@deepseek-ai/dsh-spill-policy": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-agent": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-tools": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-tool-jobs": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-tool-session-query": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-tool-terminal": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-spill-policy": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-tool-terminal": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-spill": "0.1.7-rc.1",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-spill": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-chat": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-ptc-runtime": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-token-meter": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-attachment": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-connection": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-api-workspace-controller": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-tool-jobs": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-tool-session-query": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-attachment": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-ptc-runtime": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-chat": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-token-meter": "0.1.7-rc.1"
   },
   "files": [
     "lib/index.js",