@prettier-ai/dsh-client-ui-tool 0.1.2-alpha.2 → 0.1.2-alpha.3

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/ui-tool/README.md
-README.md: 773a93801ebc214e2d5c94d52864f5c5dd887100
-README.zh.md: 88df08d7b5b7d5d3978d90fd4df4cbbb2efeb1fa
+README.md: 895274748d8ee5b7bece16e5b76836966cc52663
+README.zh.md: f4cf11cabdb94f45c9b11e7f7538ad5042a791e6

package/README.md

@@ -61,7 +61,7 @@ The package realizes one dispatch rule: atomic Tool views are keyed by wire Tool
 
 ### Details and cards
 
-The package fills `conversation.details.tool` with `ToolDetails`. Row and Details renderers share one pure card model for each terminal, read, diff, search, and web card. These models validate raw call arguments, result content, failure state, persisted metadata, Code Dispatch `parentCallId`, and Session path facts. Unsupported or malformed inputs use flattened Tool result text. Card-specific limits and fallback rules remain in the owning [terminal](../../../.agents/notes/implemented/feature/2026-07-28-web-terminal-card.md), [diff](../../../.agents/notes/implemented/feature/2026-07-30-web-diff-card.md), [read](../../../.agents/notes/implemented/feature/2026-07-30-web-read-card-frontend.md), [search](../../../.agents/notes/implemented/feature/2026-07-30-web-search-card.md), [web](../../../.agents/notes/implemented/feature/2026-07-30-web-result-card-frontend.md), and [question](../../../.agents/notes/implemented/feature/2026-07-29-ask-question-web-presentation.md) notes.
+The package fills `conversation.details.tool` with `ToolDetails`. Row and Details renderers share one pure card model for each terminal, read, diff, search, and web card. These models validate raw call arguments, result content, failure state, persisted metadata, Code Dispatch `parentCallId`, and Session path facts. Generic rows retain the original `argsRaw` reference and format their input body only while it is expanded; structured cards skip generic-body formatting. Unsupported or malformed inputs use flattened Tool result text. Card-specific limits and fallback rules remain in the owning [terminal](../../../.agents/notes/implemented/feature/2026-07-28-web-terminal-card.md), [diff](../../../.agents/notes/implemented/feature/2026-07-30-web-diff-card.md), [read](../../../.agents/notes/implemented/feature/2026-07-30-web-read-card-frontend.md), [search](../../../.agents/notes/implemented/feature/2026-07-30-web-search-card.md), [web](../../../.agents/notes/implemented/feature/2026-07-30-web-result-card-frontend.md), and [question](../../../.agents/notes/implemented/feature/2026-07-29-ask-question-web-presentation.md) notes.
 
 </details>
 

package/README.zh.md

@@ -61,7 +61,7 @@ owner 载荷为 `ToolCallOwnerProps`：`callId`、`toolName`、冻结的 `block`
 
 ### 详情与卡片
 
-本包通过 `ToolDetails` 填充 `conversation.details.tool`。行 renderer 与 Details renderer 分别为 terminal、read、diff、search 和 web 卡片复用同一个纯 card model。这些 model 校验原始调用参数、结果内容、失败状态、持久 metadata、Code Dispatch `parentCallId` 与 Session 路径事实。不受支持或格式错误的输入使用压平的工具结果文本。各类卡片的上限与 fallback 规则仍由对应的 [terminal](../../../.agents/notes/implemented/feature/2026-07-28-web-terminal-card.zh.md)、[diff](../../../.agents/notes/implemented/feature/2026-07-30-web-diff-card.zh.md)、[read](../../../.agents/notes/implemented/feature/2026-07-30-web-read-card-frontend.zh.md)、[search](../../../.agents/notes/implemented/feature/2026-07-30-web-search-card.zh.md)、[web](../../../.agents/notes/implemented/feature/2026-07-30-web-result-card-frontend.zh.md) 与 [question](../../../.agents/notes/implemented/feature/2026-07-29-ask-question-web-presentation.zh.md) 笔记负责。
+本包通过 `ToolDetails` 填充 `conversation.details.tool`。行 renderer 与 Details renderer 分别为 terminal、read、diff、search 和 web 卡片复用同一个纯 card model。这些 model 校验原始调用参数、结果内容、失败状态、持久 metadata、Code Dispatch `parentCallId` 与 Session 路径事实。Generic row 保留原始 `argsRaw` 引用，只在展开期间格式化 input body；结构化卡片跳过 generic body 格式化。不受支持或格式错误的输入使用压平的工具结果文本。各类卡片的上限与 fallback 规则仍由对应的 [terminal](../../../.agents/notes/implemented/feature/2026-07-28-web-terminal-card.zh.md)、[diff](../../../.agents/notes/implemented/feature/2026-07-30-web-diff-card.zh.md)、[read](../../../.agents/notes/implemented/feature/2026-07-30-web-read-card-frontend.zh.md)、[search](../../../.agents/notes/implemented/feature/2026-07-30-web-search-card.zh.md)、[web](../../../.agents/notes/implemented/feature/2026-07-30-web-result-card-frontend.zh.md) 与 [question](../../../.agents/notes/implemented/feature/2026-07-29-ask-question-web-presentation.zh.md) 笔记负责。
 
 </details>
 

package/lib/client.js

@@ -186,7 +186,13 @@ window.__ModuleLoader__.load({
 			const picked = pickString(parsed, FILE_PATH_KEYS);
 			return picked === void 0 ? void 0 : firstLine(picked);
 		}
-		function deriveBody(variant, argsRaw) {
+		/**
+		* Format one argument payload when its generic input body becomes visible.
+		* @param variant - row presentation selected for the Tool name.
+		* @param argsRaw - original argument JSON or incomplete raw text.
+		* @returns display body, or null for empty input.
+		*/
+		function formatToolBody(variant, argsRaw) {
 			if (argsRaw === "") return null;
 			const parsed = parseArgs(argsRaw);
 			if (parsed === void 0) return argsRaw;
@@ -214,12 +220,13 @@ window.__ModuleLoader__.load({
 			const summary = variant === "others" && toolName !== "" && toolTitleKey === void 0 ? `${toolName} · ${base}` : base;
 			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],
 				summary,
 				filePath: deriveFilePath(variant, argsRaw),
-				body: deriveBody(variant, argsRaw),
+				bodyRaw,
 				output,
 				errorSummary,
 				state
@@ -1095,7 +1102,7 @@ window.__ModuleLoader__.load({
 				default: return null;
 			}
 		}
-		function ToolRow({ t, variant, toolName, icon, title, summary, summarySuffix, body, output, askQuestion, errorSummary, terminal, diff, read, search, web, state, filePath, onOpenFile, inspect }) {
+		function ToolRow({ t, variant, toolName, icon, title, summary, summarySuffix, bodyRaw, output, askQuestion, errorSummary, terminal, diff, read, search, web, state, filePath, onOpenFile, inspect }) {
 			const [expanded, setExpanded] = (0, react.useState)(false);
 			const terminalLabels = (0, react.useMemo)(() => terminalBlockLabels(t), [t]);
 			const diffLabels = (0, react.useMemo)(() => diffBlockLabels(t), [t]);
@@ -1109,8 +1116,15 @@ window.__ModuleLoader__.load({
 			const webBody = web ?? null;
 			const askQuestionBody = askQuestion ?? null;
 			const outputText = output ?? null;
-			const expandable = body !== null || outputText !== null || (askQuestionBody ?? terminalBody ?? diffBody ?? readBody ?? searchBody ?? webBody) !== null;
+			const card = askQuestionBody ?? terminalBody ?? diffBody ?? readBody ?? searchBody ?? webBody;
+			const expandable = bodyRaw != null || outputText !== null || card !== null;
 			const open = expanded && expandable;
+			const bodyText = (0, react.useMemo)(() => open && card === null && bodyRaw != null ? formatToolBody(variant, bodyRaw) : null, [
+				bodyRaw,
+				card,
+				open,
+				variant
+			]);
 			const status = stateStatus$1(state, t);
 			const failureLine = state === "error" ? errorSummary ?? null : null;
 			const summaryText = failureLine ?? terminalBody?.description ?? summary;
@@ -1131,7 +1145,7 @@ window.__ModuleLoader__.load({
 			const fileLinkKeyDown = (event) => {
 				if (event.key === "Enter" || event.key === " ") event.stopPropagation();
 			};
-			const cardBody = variant === "code" ? null : body;
+			const cardBody = variant === "code" ? null : bodyText;
 			return (0, react_jsx_runtime.jsxs)("div", {
 				className: ToolRow_module_css_default.root,
 				"data-variant": variant,
@@ -1201,10 +1215,10 @@ window.__ModuleLoader__.load({
 							...webBody,
 							labels: webLabels,
 							className: ToolRow_module_css_default.webBody
-						}) : (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [variant === "code" && body !== null && (0, react_jsx_runtime.jsx)("div", {
+						}) : (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [variant === "code" && bodyText !== null && (0, react_jsx_runtime.jsx)("div", {
 							className: ToolRow_module_css_default.bodyScroll,
 							children: (0, react_jsx_runtime.jsx)(_prettier_ai_dsh_client_ui_primitives.CodeBlock, {
-								code: body,
+								code: bodyText,
 								lang: "typescript",
 								copyLabel: t("copy"),
 								copiedLabel: t("copied"),
@@ -1277,7 +1291,7 @@ window.__ModuleLoader__.load({
 				icon: VARIANT_ICONS[model.variant],
 				title: t(model.titleKey),
 				summary: model.summary,
-				body: singleFile ? null : model.body,
+				bodyRaw: singleFile ? null : model.bodyRaw,
 				output: model.output,
 				errorSummary: model.errorSummary,
 				terminal,
@@ -1622,7 +1636,7 @@ window.__ModuleLoader__.load({
 				icon: (0, react_jsx_runtime.jsx)(_prettier_ai_dsh_client_ui_primitives.IconQuestionOutline14, {}),
 				title: t("ask.rowTitle"),
 				summary,
-				body: transcript === null ? model.body : null,
+				bodyRaw: transcript === null ? model.bodyRaw : null,
 				output: transcript === null ? model.output : null,
 				askQuestion: transcript,
 				state,
@@ -1700,9 +1714,15 @@ window.__ModuleLoader__.load({
 			const state = model.state === "ok" && terminalModel !== null && terminalFailed(terminalModel) ? "error" : model.state;
 			const status = stateStatus(state, t);
 			const [expanded, setExpanded] = (0, react.useState)(false);
-			const genericBody = terminal === null && (model.state === "error" || isSettledPersistentShellCall(block)) && (model.body !== null || model.output !== null);
+			const genericBody = terminal === null && (model.state === "error" || isSettledPersistentShellCall(block)) && (model.bodyRaw !== null || model.output !== null);
 			const expandable = terminal !== null || genericBody;
 			const open = expanded && expandable;
+			const body = (0, react.useMemo)(() => open && genericBody && model.bodyRaw !== null ? formatToolBody(model.variant, model.bodyRaw) : null, [
+				genericBody,
+				model.bodyRaw,
+				model.variant,
+				open
+			]);
 			const failureLine = model.state === "error" ? model.errorSummary : null;
 			const toggleExpand = () => {
 				setExpanded((v) => !v);
@@ -1761,17 +1781,17 @@ window.__ModuleLoader__.load({
 					}) : (0, react_jsx_runtime.jsxs)("div", {
 						className: bash_sample_module_css_default.ioCard,
 						children: [
-							model.body !== null && (0, react_jsx_runtime.jsxs)("div", {
+							body !== null && (0, react_jsx_runtime.jsxs)("div", {
 								className: bash_sample_module_css_default.ioSection,
 								children: [(0, react_jsx_runtime.jsx)("span", {
 									className: bash_sample_module_css_default.ioLabel,
 									children: t("row.input")
 								}), (0, react_jsx_runtime.jsx)("span", {
 									className: bash_sample_module_css_default.ioText,
-									children: model.body
+									children: body
 								})]
 							}),
-							model.body !== null && model.output !== null && (0, react_jsx_runtime.jsx)("span", {
+							body !== null && model.output !== null && (0, react_jsx_runtime.jsx)("span", {
 								className: bash_sample_module_css_default.ioDivider,
 								"aria-hidden": true
 							}),
@@ -1823,7 +1843,6 @@ window.__ModuleLoader__.load({
 				icon: (0, react_jsx_runtime.jsx)(_prettier_ai_dsh_client_ui_primitives.IconEditOutline16, { size: 14 }),
 				title: t(model.titleKey),
 				summary: model.summary,
-				body: null,
 				output: model.output,
 				errorSummary: model.errorSummary,
 				diff,
@@ -1867,7 +1886,6 @@ window.__ModuleLoader__.load({
 				icon: (0, react_jsx_runtime.jsx)(_prettier_ai_dsh_client_ui_primitives.IconBrowseOutline16, { size: 14 }),
 				title: t(model.titleKey),
 				summary: model.summary,
-				body: null,
 				output: model.output,
 				errorSummary: model.errorSummary,
 				read,
@@ -1906,7 +1924,6 @@ window.__ModuleLoader__.load({
 				icon: (0, react_jsx_runtime.jsx)(_prettier_ai_dsh_client_ui_primitives.IconSearchOutline16, { size: 14 }),
 				title: t(toolName === "grep" ? SEARCH_TITLE_KEYS.grep : toolName === "glob" ? SEARCH_TITLE_KEYS.glob : model.titleKey),
 				summary: model.summary,
-				body: null,
 				output: model.output,
 				errorSummary: model.errorSummary,
 				search,
@@ -2009,7 +2026,7 @@ window.__ModuleLoader__.load({
 				title: t("todo.rowTitle"),
 				summary: summary.text,
 				summarySuffix: summary.extra > 0 ? `+${summary.extra}` : null,
-				body: model.body,
+				bodyRaw: model.bodyRaw,
 				output: model.output,
 				errorSummary: model.errorSummary,
 				state: model.state,
@@ -2046,7 +2063,6 @@ window.__ModuleLoader__.load({
 				icon,
 				title: t(toolName === "web_search" ? WEB_TITLE_KEYS.web_search : toolName === "web_fetch" ? WEB_TITLE_KEYS.web_fetch : model.titleKey),
 				summary: model.summary,
-				body: null,
 				output: model.output,
 				errorSummary: model.errorSummary,
 				web,

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

@@ -5,7 +5,7 @@ import { type ReadCardModel } from '../models/read-card-model.ts';
 import { type SearchCardModel } from '../models/search-card-model.ts';
 import { type TerminalCardModel } from '../models/terminal-card-model.ts';
 import type { AskQuestionCardModel } from '../models/ask-question-card-model.ts';
-import type { ToolRowState, ToolRowVariant } from '../models/tool-call-model.ts';
+import { type ToolRowState, type ToolRowVariant } from '../models/tool-call-model.ts';
 import type { WebCardModelProps } from '../models/web-card-model.ts';
 export interface ToolRowProps {
     t: TranslateNS<'conversation'>;
@@ -23,8 +23,8 @@ export interface ToolRowProps {
      * error row, whose collapsed summary is the failure line instead.
      */
     summarySuffix?: string | null | undefined;
-    /** Expanded-body input text; null = no input section. */
-    body: string | null;
+    /** Original argument JSON formatted only while the row is expanded. */
+    bodyRaw?: string | null | undefined;
     /** Flattened result text for the expanded Output section; null/absent = no output section. */
     output?: string | null | undefined;
     /** Ask-user transcript card; card fields are mutually exclusive and replace text sections. */
@@ -51,5 +51,5 @@ export interface ToolRowProps {
      */
     inspect?: (() => void) | undefined;
 }
-export declare function ToolRow({ t, variant, toolName, icon, title, summary, summarySuffix, body, output, askQuestion, errorSummary, terminal, diff, read, search, web, state, filePath, onOpenFile, inspect, }: ToolRowProps): import("react").JSX.Element;
+export declare function ToolRow({ t, variant, toolName, icon, title, summary, summarySuffix, bodyRaw, output, askQuestion, errorSummary, terminal, diff, read, search, web, state, filePath, onOpenFile, inspect, }: ToolRowProps): import("react").JSX.Element;
 //# sourceMappingURL=ToolRow.d.ts.map

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

@@ -1,9 +1,9 @@
 /**
  * Pure row-model derivation for tool summary rows: variant classification,
- * one-line summary, expanded-body text, and flattened result output from the
- * frozen call slice. Input material comes from the call ARGUMENTS; output and
- * error material from the settled result node. A supported terminal call gets
- * its expanded body from `terminalCardModel` instead.
+ * one-line summary, expansion-time body input, and flattened result output
+ * from the frozen call slice. Input material comes from the call ARGUMENTS;
+ * output and error material from the settled result node. A supported terminal
+ * call gets its expanded body from `terminalCardModel` instead.
  */
 import type { ToolCallBlock, ToolResultNode } from '@prettier-ai/dsh-client-ui-chat/client';
 import type { LocaleKeysOf } from '@prettier-ai/dsh-client-ui-slots';
@@ -40,8 +40,8 @@ export interface ToolRowModel {
      * relative values against the session cwd before opening.
      */
     filePath: string | undefined;
-    /** Expanded-body input text (pretty args); null = no input section. */
-    body: string | null;
+    /** Original argument JSON retained for expansion-time body formatting. */
+    bodyRaw: string | null;
     /** Flattened result text ({@link resultText}); null while running or when the result carries no text. */
     output: string | null;
     /** First line of the result text on an error row; null for every other state. */
@@ -63,6 +63,13 @@ export declare function resultText(node: ToolResultNode): string;
  * @returns the path relative to the workspace root, or unchanged when it is not rooted there.
  */
 export declare function relativizeToCwd(text: string, cwd: string | undefined): string;
+/**
+ * Format one argument payload when its generic input body becomes visible.
+ * @param variant - row presentation selected for the Tool name.
+ * @param argsRaw - original argument JSON or incomplete raw text.
+ * @returns display body, or null for empty input.
+ */
+export declare function formatToolBody(variant: ToolRowVariant, argsRaw: string): string | null;
 /**
  * Derive the full row model from a frozen call slice.
  * @param toolName - wire tool name (dispatch-supplied; survives windowless results).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@prettier-ai/dsh-client-ui-tool",
   "description": "Client Tool call-tree renderer and keyed per-tool presentation slot",
-  "version": "0.1.2-alpha.2",
+  "version": "0.1.2-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -53,19 +53,19 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "@prettier-ai/cordis": "^4.0.2",
-    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.2",
-    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.2",
-    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.2",
-    "@prettier-ai/dsh-client-test-runtime": "^0.1.2-alpha.2",
-    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.2",
-    "@prettier-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2",
-    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.2",
-    "@prettier-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
-    "@prettier-ai/dsh-client-ui-chat": "^0.1.2-alpha.2",
-    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.2",
-    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.2",
-    "@prettier-ai/dsh-api-workspace-controller": "^0.1.2-alpha.2",
-    "@prettier-ai/dsh-util-workspace-path": "^0.1.2-alpha.2"
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-test-runtime": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-primitives": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-api-workspace-controller": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-util-workspace-path": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-chat": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-slots": "^0.1.2-alpha.3"
   },
   "files": [
     "lib/index.js",