@deepseek-ai/dsh-client-ui-tool 0.1.0-rc.7 → 0.1.0-rc.8

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: 6e2bef2f5ad4b136510c3acbb8f8b8e83c4c9212
-README.zh.md: 169417747541db9e02cb552b175ca7c100420aeb
+README.md: b87236309c9bafe3e35d3d5977d56bd62a24de31
+README.zh.md: 3bae0b3f4cb3ad695371ec7a66fb531a935a4d2f

package/README.md

@@ -28,7 +28,7 @@ ctx.slots.inject('tool.call.toolview', () =>
   }, BusinessToolRow))
 ```
 
-The owner payload is `ToolCallOwnerProps`: `callId`, `toolName`, the frozen `block`, optional `cwd`, and plain `openFile`/`inspect` callbacks. The registration receives the normal session slot runtime share. It does not receive React nodes, Runtime services, or root/subcall knowledge.
+The owner payload is `ToolCallOwnerProps`: `callId`, `toolName`, the frozen `block`, optional `cwd` and `home`, and plain `openFile`/`inspect` callbacks. 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. It does not receive React nodes, Runtime services, or root/subcall knowledge.
 
 This package currently owns the generic fallback and the built-in shell/pwsh, read, write/edit, grep/glob, web, todo, question, and Code Dispatch presentations. `ui-skill` demonstrates a business-owned registration for `skill`.
 

package/README.zh.md

@@ -28,7 +28,7 @@ ctx.slots.inject('tool.call.toolview', () =>
   }, BusinessToolRow))
 ```
 
-owner 载荷为 `ToolCallOwnerProps`：`callId`、`toolName`、冻结的 `block`、可选 `cwd`，以及普通的 `openFile`、`inspect` 回调。注册项会收到常规的会话 slot 运行时共享数据，但不会收到 React node、运行时服务或 root/subcall 知识。
+owner 载荷为 `ToolCallOwnerProps`：`callId`、`toolName`、冻结的 `block`、可选 `cwd` 与 `home`，以及普通的 `openFile`、`inspect` 回调。路径摘要先相对会话 cwd 缩短，再把剩余的 POSIX 宿主家目录写成 `~`；`filePath` 与 Host 打开仍使用作者给出的文件系统路径。注册项会收到常规的会话 slot 运行时共享数据，但不会收到 React node、运行时服务或 root/subcall 知识。
 
 本包当前拥有 generic fallback，以及 shell/pwsh、read、write/edit、grep/glob、web、todo、question 和 Code Dispatch 的内置展示。`ui-skill` 展示了业务包自行拥有的 `skill` 注册项。
 

package/lib/client.js

@@ -9,6 +9,14 @@ window.__ModuleLoader__.load({
 		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let _deepseek_ai_dsh_client_runtime_client = require("@deepseek-ai/dsh-client-runtime/client");
 		//#region lib/types/client/tool/models/tool-call-model.js
+		/**
+		* 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 call whose render intent is
+		* a terminal card gets its expanded body from the views instead, through
+		* `terminalCardModel` in terminal-card-model.ts.
+		*/
 		/** Figma row titles per variant (design literals, not translatable copy). */
 		const VARIANT_TITLES = {
 			search: "Search",
@@ -127,6 +135,10 @@ window.__ModuleLoader__.load({
 			const parsed = parseArgs(argsRaw);
 			if (typeof parsed !== "object" || parsed === null) return firstLine(argsRaw);
 			const args = parsed;
+			if (variant === "search" && Array.isArray(args.queries)) {
+				const queries = args.queries.filter((query) => typeof query === "string" && query !== "");
+				if (queries.length > 0) return queries.map(firstLine).join(", ");
+			}
 			const picked = pickString(args, SUMMARY_KEYS[variant]);
 			if (picked !== void 0) return firstLine(picked);
 			for (const v of Object.values(args)) if (typeof v === "string" && v !== "") return firstLine(v);
@@ -162,14 +174,15 @@ window.__ModuleLoader__.load({
 		* @param toolName - wire tool name (dispatch-supplied; survives windowless results).
 		* @param block - RunningToolCall or ToolResultNode off the snapshot caches.
 		* @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) {
+		function toolRowModel(toolName, block, cwd, home) {
 			const variant = classifyTool(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 : relativizeToCwd(deriveSummary(variant, argsRaw), cwd);
+			const base = argsRaw === "" ? block.callId : (0, _deepseek_ai_dsh_client_runtime_client.abbreviateHomePath)(relativizeToCwd(deriveSummary(variant, argsRaw), cwd), home);
 			const toolTitle = TOOL_TITLES[toolName];
 			const summary = variant === "others" && toolName !== "" && toolTitle === void 0 ? `${toolName} · ${base}` : base;
 			const output = done ? resultText(block) || null : null;
@@ -188,6 +201,21 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region lib/types/client/tool/models/read-card-model.js
 		/**
+		* Pure derivation of the read-card props from a frozen call slice: the
+		* `card:'read'` render intent the read tool declares arrives on the snapshot as
+		* the settled result node's `resultView`, and this is the one place that turns
+		* it into what {@link ReadBlock} draws. Both conversation render sites (the chat
+		* tool row's resident body and the details panel's Output section) call this, so
+		* the path, lines, total, and language they show are derived once.
+		*
+		* The read card is result-side only ([read card note](../../../../../../.agents/notes/implemented/feature/2026-07-30-web-read-card.md)):
+		* a call carries no file content until `execute` returns, so the pending call
+		* stays a generic card (`kind: 'read'`). A running read therefore has no read
+		* card, and this returns null for it — the row keeps its args-derived summary
+		* until the result arrives.
+		* @module
+		*/
+		/**
 		* Derive the read-card props for a tool call, or null when this call is not a
 		* read card and belongs on the generic path.
 		*
@@ -204,14 +232,15 @@ window.__ModuleLoader__.load({
 		*
 		* The label is the read view's `title` when the tool supplied one (the
 		* presentation contract's replacement-title rule), otherwise the file path
-		* relativized to the session workspace so a workspace-rooted absolute path
-		* displays the same short form the row summary shows.
+		* shortened the same way the row summary is: workspace-relative first, then
+		* POSIX `~` for a leftover host-home path.
 		* @param block - RunningToolCall or ToolResultNode off the snapshot caches.
 		* @param sessionCwd - the session workspace root; a workspace-rooted absolute
 		*   path label displays relative to it. Absent leaves the path as authored.
+		* @param home - host account home; a leftover POSIX home path displays as `~`.
 		* @returns the read-card props, or null for the generic path.
 		*/
-		function readCardModel(block, sessionCwd) {
+		function readCardModel(block, sessionCwd, home) {
 			if (!("kind" in block)) return null;
 			const result = block.resultView?.card === "read" ? block.resultView : null;
 			if (result === null) return null;
@@ -220,7 +249,7 @@ window.__ModuleLoader__.load({
 				text: line.text
 			}));
 			return {
-				label: result.title ?? relativizeToCwd(result.path, sessionCwd),
+				label: result.title ?? (0, _deepseek_ai_dsh_client_runtime_client.abbreviateHomePath)(relativizeToCwd(result.path, sessionCwd), home),
 				lines,
 				totalLines: result.totalLines,
 				lang: result.lang
@@ -605,33 +634,33 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var ToolRow_module_css_default = {
-			"inspectButton": "o3BgMG_inspectButton",
-			"leading": "o3BgMG_leading",
-			"ioSection": "o3BgMG_ioSection",
-			"row": "o3BgMG_row",
-			"ioDivider": "o3BgMG_ioDivider",
-			"terminalBody": "o3BgMG_terminalBody",
+			"bodyScroll": "o3BgMG_bodyScroll",
+			"bodyWrap": "o3BgMG_bodyWrap",
+			"chevron": "o3BgMG_chevron",
+			"codeBody": "o3BgMG_codeBody",
 			"diffBody": "o3BgMG_diffBody",
-			"title": "o3BgMG_title",
-			"searchBody": "o3BgMG_searchBody",
 			"dsh-tool-row-sweep": "o3BgMG_dsh-tool-row-sweep",
-			"webBody": "o3BgMG_webBody",
+			"errorSummary": "o3BgMG_errorSummary",
+			"fileLink": "o3BgMG_fileLink",
+			"inspectButton": "o3BgMG_inspectButton",
 			"ioCard": "o3BgMG_ioCard",
-			"searchRecovery": "o3BgMG_searchRecovery",
-			"visuallyHidden": "o3BgMG_visuallyHidden",
-			"bodyScroll": "o3BgMG_bodyScroll",
+			"ioDivider": "o3BgMG_ioDivider",
+			"ioLabel": "o3BgMG_ioLabel",
+			"ioSection": "o3BgMG_ioSection",
 			"ioText": "o3BgMG_ioText",
-			"bodyWrap": "o3BgMG_bodyWrap",
+			"leading": "o3BgMG_leading",
 			"readBody": "o3BgMG_readBody",
+			"root": "o3BgMG_root",
+			"row": "o3BgMG_row",
+			"searchBody": "o3BgMG_searchBody",
+			"searchRecovery": "o3BgMG_searchRecovery",
 			"sep": "o3BgMG_sep",
-			"errorSummary": "o3BgMG_errorSummary",
-			"ioLabel": "o3BgMG_ioLabel",
 			"summary": "o3BgMG_summary",
-			"fileLink": "o3BgMG_fileLink",
-			"codeBody": "o3BgMG_codeBody",
 			"summarySuffix": "o3BgMG_summarySuffix",
-			"chevron": "o3BgMG_chevron",
-			"root": "o3BgMG_root"
+			"terminalBody": "o3BgMG_terminalBody",
+			"title": "o3BgMG_title",
+			"visuallyHidden": "o3BgMG_visuallyHidden",
+			"webBody": "o3BgMG_webBody"
 		};
 		//#endregion
 		//#region lib/types/client/tool/components/ToolRow.js
@@ -808,10 +837,10 @@ window.__ModuleLoader__.load({
 			code: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCodeOutline16, { size: 14 }),
 			others: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSparkle16, { size: 14 })
 		};
-		function GenericToolCard({ toolName, block, cwd, openFile, inspect, t }) {
-			const model = toolRowModel(toolName, block, cwd);
+		function GenericToolCard({ toolName, block, cwd, home, openFile, inspect, t }) {
+			const model = toolRowModel(toolName, block, cwd, home);
 			const terminal = terminalCardModel(block, cwd);
-			const read = readCardModel(block, cwd);
+			const read = readCardModel(block, cwd, home);
 			const diff = diffCardModel(block);
 			const search = searchCardModel(block);
 			const web = webCardModel(block);
@@ -861,13 +890,14 @@ window.__ModuleLoader__.load({
 			return "kind" in node ? node.call?.name ?? "" : node.name;
 		}
 		/** One atomic call dispatched through the Tool-owned keyed slot. */
-		const ToolCall = (0, react.memo)(function ToolCall({ renderSlot, callId, toolName, block, openFile, selected, cwd, inspectCall, t, children }) {
+		const ToolCall = (0, react.memo)(function ToolCall({ renderSlot, callId, toolName, block, openFile, selected, cwd, home, inspectCall, t, children }) {
 			const owner = (0, react.useMemo)(() => ({
 				callId,
 				toolName,
 				block,
 				openFile,
 				cwd,
+				home,
 				inspect: () => {
 					inspectCall(callId);
 				}
@@ -877,6 +907,7 @@ window.__ModuleLoader__.load({
 				block,
 				openFile,
 				cwd,
+				home,
 				inspectCall
 			]);
 			return (0, react_jsx_runtime.jsxs)("div", {
@@ -893,7 +924,7 @@ window.__ModuleLoader__.load({
 				}), children]
 			});
 		});
-		const ToolCallBranch = (0, react.memo)(function ToolCallBranch({ renderSlot, block, selectedCallId, cwd, openFile, inspectCall, t }) {
+		const ToolCallBranch = (0, react.memo)(function ToolCallBranch({ renderSlot, block, selectedCallId, cwd, home, openFile, inspectCall, t }) {
 			return (0, react_jsx_runtime.jsx)(ToolCall, {
 				renderSlot,
 				callId: block.callId,
@@ -902,6 +933,7 @@ window.__ModuleLoader__.load({
 				openFile,
 				selected: block.callId === selectedCallId,
 				cwd,
+				home,
 				inspectCall,
 				t,
 				children: block.subCalls.length > 0 ? (0, react_jsx_runtime.jsx)("div", {
@@ -912,6 +944,7 @@ window.__ModuleLoader__.load({
 						block: child,
 						selectedCallId,
 						cwd,
+						home,
 						openFile,
 						inspectCall,
 						t
@@ -925,13 +958,15 @@ window.__ModuleLoader__.load({
 		* @param props - whole-Tool owner data and the Tool-owned child-slot share.
 		* @returns the Tool call tree.
 		*/
-		function ToolCallTree({ renderSlot, node, selectedCallId, cwd, openFile, inspectCall, t }) {
+		function ToolCallTree({ renderSlot, node, selectedCallId, cwd, openFile, inspectCall, useHostDescription, t }) {
+			const home = useHostDescription((description) => description?.home);
 			const block = node.data.root;
 			return (0, react_jsx_runtime.jsx)(ToolCallBranch, {
 				renderSlot,
 				block,
 				selectedCallId,
 				cwd,
+				home,
 				openFile,
 				inspectCall,
 				t
@@ -949,13 +984,13 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var ToolDetails_module_css_default = {
-			"read": "xDAfVq_read",
-			"empty": "xDAfVq_empty",
-			"web": "xDAfVq_web",
-			"description": "xDAfVq_description",
 			"cardBody": "xDAfVq_cardBody",
+			"code": "xDAfVq_code",
+			"description": "xDAfVq_description",
+			"empty": "xDAfVq_empty",
+			"read": "xDAfVq_read",
 			"recovery": "xDAfVq_recovery",
-			"code": "xDAfVq_code"
+			"web": "xDAfVq_web"
 		};
 		//#endregion
 		//#region lib/types/client/tool/ToolDetails.js
@@ -963,10 +998,11 @@ window.__ModuleLoader__.load({
 		/**
 		* Render the selected Tool call's structured output when its presentation
 		* intent is known, otherwise preserve the flattened result text.
-		* @param props - selected call slice, workspace root, and locale seat.
+		* @param props - selected call slice, workspace root, host home, and locale seat.
 		* @returns the details output body.
 		*/
-		function ToolDetails({ block, cwd, t }) {
+		function ToolDetails({ block, cwd, useHostDescription, t }) {
+			const home = useHostDescription((description) => description?.home);
 			const terminal = terminalCardModel(block, cwd);
 			if (terminal !== null) return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [terminal.description !== void 0 ? (0, react_jsx_runtime.jsx)("div", {
 				className: ToolDetails_module_css_default.description,
@@ -976,7 +1012,7 @@ window.__ModuleLoader__.load({
 				labels: terminalBlockLabels(t),
 				className: ToolDetails_module_css_default.cardBody
 			})] });
-			const read = readCardModel(block, cwd);
+			const read = readCardModel(block, cwd, home);
 			if (read !== null) return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.ReadBlock, {
 				...read,
 				className: ToolDetails_module_css_default.read
@@ -1099,26 +1135,26 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var bash_sample_module_css_default = {
-			"ioLabel": "CY-8Ka_ioLabel",
+			"bodyWrap": "CY-8Ka_bodyWrap",
+			"card": "CY-8Ka_card",
 			"chevron": "CY-8Ka_chevron",
-			"leading": "CY-8Ka_leading",
-			"ioSection": "CY-8Ka_ioSection",
 			"chevronHover": "CY-8Ka_chevronHover",
-			"inspectButton": "CY-8Ka_inspectButton",
+			"dsh-bash-row-sweep": "CY-8Ka_dsh-bash-row-sweep",
+			"errorSummary": "CY-8Ka_errorSummary",
 			"iconIdle": "CY-8Ka_iconIdle",
-			"card": "CY-8Ka_card",
+			"inspectButton": "CY-8Ka_inspectButton",
 			"ioCard": "CY-8Ka_ioCard",
-			"dsh-bash-row-sweep": "CY-8Ka_dsh-bash-row-sweep",
-			"sep": "CY-8Ka_sep",
-			"title": "CY-8Ka_title",
-			"terminal": "CY-8Ka_terminal",
-			"bodyWrap": "CY-8Ka_bodyWrap",
+			"ioDivider": "CY-8Ka_ioDivider",
+			"ioLabel": "CY-8Ka_ioLabel",
+			"ioSection": "CY-8Ka_ioSection",
 			"ioText": "CY-8Ka_ioText",
+			"leading": "CY-8Ka_leading",
 			"root": "CY-8Ka_root",
-			"ioDivider": "CY-8Ka_ioDivider",
-			"errorSummary": "CY-8Ka_errorSummary",
-			"visuallyHidden": "CY-8Ka_visuallyHidden",
-			"summary": "CY-8Ka_summary"
+			"sep": "CY-8Ka_sep",
+			"summary": "CY-8Ka_summary",
+			"terminal": "CY-8Ka_terminal",
+			"title": "CY-8Ka_title",
+			"visuallyHidden": "CY-8Ka_visuallyHidden"
 		};
 		//#endregion
 		//#region lib/types/client/tool/toolviews/bash-sample.js
@@ -1275,8 +1311,8 @@ window.__ModuleLoader__.load({
 		* model-facing error text through its Output section and its first line in the
 		* collapsed summary instead.
 		*/
-		function FileMutationRow({ toolName, block, cwd, openFile, inspect, t }) {
-			const model = toolRowModel(toolName, block, cwd);
+		function FileMutationRow({ toolName, block, cwd, home, openFile, inspect, t }) {
+			const model = toolRowModel(toolName, block, cwd, home);
 			const diff = diffCardModel(block);
 			return (0, react_jsx_runtime.jsx)(ToolRow, {
 				t,
@@ -1329,9 +1365,9 @@ window.__ModuleLoader__.load({
 		* read card as the row's collapsed-by-default card body. The summary path is an
 		* openable host link when the row names a single file.
 		*/
-		function ReadRow({ toolName, block, cwd, openFile, inspect, t }) {
-			const model = toolRowModel(toolName, block, cwd);
-			const read = readCardModel(block, cwd);
+		function ReadRow({ toolName, block, cwd, home, openFile, inspect, t }) {
+			const model = toolRowModel(toolName, block, cwd, home);
+			const read = readCardModel(block, cwd, home);
 			return (0, react_jsx_runtime.jsx)(ToolRow, {
 				t,
 				variant: model.variant,
@@ -1592,13 +1628,15 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region lib/types/client/apply.js
-		/** Required service: the slot registry that owns both Tool render seats. */
-		const inject = ["slots"];
+		/** Required services: the slot registry and the Host description used for POSIX `~`. */
+		const inject = ["slots", "connection"];
 		/**
 		* Mount the whole-Tool renderers and built-in atomic Tool registrations.
 		* @param ctx - Client root context.
 		*/
 		function apply(ctx) {
+			const connection = ctx.get("connection");
+			const toolInject = () => ({ hooks: { hostDescription: connection.hostDescription } });
 			ctx.slots.inject("conversation.chat.node", () => ctx.slots.register({
 				name: "conversation.chat.node",
 				key: "tool-call",
@@ -1606,11 +1644,13 @@ window.__ModuleLoader__.load({
 				children: { "tool.call.toolview": {
 					kind: "keyed",
 					scope: "session"
-				} }
+				} },
+				inject: toolInject
 			}, ToolCallTree));
 			ctx.slots.inject("conversation.details.tool", () => ctx.slots.register({
 				name: "conversation.details.tool",
-				locale: CONVERSATION_NS
+				locale: CONVERSATION_NS,
+				inject: toolInject
 			}, ToolDetails));
 			ctx.plugin(bashToolviewSample);
 			ctx.plugin(readToolview);

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

@@ -1,6 +1,5 @@
-/** Register the Tool call tree, details renderer, and built-in atomic views. */
 import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
-/** Required service: the slot registry that owns both Tool render seats. */
+/** Required services: the slot registry and the Host description used for POSIX `~`. */
 export declare const inject: string[];
 /**
  * Mount the whole-Tool renderers and built-in atomic Tool registrations.

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

@@ -1,5 +1,6 @@
 /** Tool UI slot declarations and their composed component props. */
-import type { PropsLocale, PropsRenderSlots, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { HostDescriptionSource } from '@deepseek-ai/dsh-client-connection/client';
+import type { InjectFace, PropsLocale, PropsRenderSlots, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolCallBlock } from '@deepseek-ai/dsh-client-runtime/client';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface SlotMap {
@@ -34,6 +35,8 @@ export interface ToolCallOwnerProps {
     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 through the Host. */
     openFile: (path: string) => void;
     /** Inspect this call in the trajectory view when available. */
@@ -41,8 +44,15 @@ export interface ToolCallOwnerProps {
 }
 /** Full props of a registered atomic Tool view. */
 export type ToolCallViewProps = PropsRuntime<'tool.call.toolview'>;
+/** Injected Host description for POSIX home-path display. */
+export type ToolHostDescriptionInjected = {
+    hooks: {
+        /** Current generation's Host description, bound by the slot renderer. */
+        hostDescription: HostDescriptionSource;
+    };
+};
 /** 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'>;
+export type ToolTreeProps = PropsRuntime<'conversation.chat.node', 'tool-call'> & PropsRenderSlots<'tool.call.toolview'> & PropsLocale<'conversation'> & InjectFace<ToolHostDescriptionInjected>;
 /** Full props of the selected Tool output renderer in the details panel. */
-export type ToolDetailsProps = PropsRuntime<'conversation.details.tool'> & PropsLocale<'conversation'>;
+export type ToolDetailsProps = PropsRuntime<'conversation.details.tool'> & PropsLocale<'conversation'> & InjectFace<ToolHostDescriptionInjected>;
 //# 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, ToolDetailsProps, ToolTreeProps } from './contract/slots.ts';
+export type { ToolCallOwnerProps, ToolCallViewProps, ToolDetailsProps, ToolHostDescriptionInjected, ToolTreeProps, } from './contract/slots.ts';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/client/tool/ToolCallTree.d.ts

@@ -5,5 +5,5 @@ import type { ToolTreeProps } from '../contract/slots.ts';
  * @param props - whole-Tool owner data and the Tool-owned child-slot share.
  * @returns the Tool call tree.
  */
-export declare function ToolCallTree({ renderSlot, node, selectedCallId, cwd, openFile, inspectCall, t, }: ToolTreeProps): import("react").JSX.Element;
+export declare function ToolCallTree({ renderSlot, node, selectedCallId, cwd, openFile, inspectCall, useHostDescription, t, }: ToolTreeProps): import("react").JSX.Element;
 //# sourceMappingURL=ToolCallTree.d.ts.map

package/lib/types/client/tool/ToolDetails.d.ts

@@ -1,16 +1,9 @@
 import type { ToolDetailsProps } from '../contract/slots.ts';
-/** Pure details-body inputs; framework session seats stay at the slot boundary. */
-interface ToolDetailsContentProps {
-    block: ToolDetailsProps['block'];
-    cwd?: ToolDetailsProps['cwd'];
-    t: ToolDetailsProps['t'];
-}
 /**
  * Render the selected Tool call's structured output when its presentation
  * intent is known, otherwise preserve the flattened result text.
- * @param props - selected call slice, workspace root, and locale seat.
+ * @param props - selected call slice, workspace root, host home, and locale seat.
  * @returns the details output body.
  */
-export declare function ToolDetails({ block, cwd, t }: ToolDetailsContentProps): import("react").JSX.Element;
-export {};
+export declare function ToolDetails({ block, cwd, useHostDescription, t, }: Pick<ToolDetailsProps, 'block' | 'cwd' | 'useHostDescription' | 't'>): import("react").JSX.Element;
 //# sourceMappingURL=ToolDetails.d.ts.map

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

@@ -1,18 +1,3 @@
-/**
- * Pure derivation of the read-card props from a frozen call slice: the
- * `card:'read'` render intent the read tool declares arrives on the snapshot as
- * the settled result node's `resultView`, and this is the one place that turns
- * it into what {@link ReadBlock} draws. Both conversation render sites (the chat
- * tool row's resident body and the details panel's Output section) call this, so
- * the path, lines, total, and language they show are derived once.
- *
- * The read card is result-side only ([read card note](../../../../../../.agents/notes/implemented/feature/2026-07-30-web-read-card.md)):
- * a call carries no file content until `execute` returns, so the pending call
- * stays a generic card (`kind: 'read'`). A running read therefore has no read
- * card, and this returns null for it — the row keeps its args-derived summary
- * until the result arrives.
- * @module
- */
 import type { ReadBlockProps } from '@deepseek-ai/dsh-client-ui-primitives';
 import { type ToolCallBlock } from './tool-call-model.ts';
 /**
@@ -49,12 +34,13 @@ export type ReadCardModel = Pick<ReadBlockProps, 'label' | 'lines' | 'totalLines
  *
  * The label is the read view's `title` when the tool supplied one (the
  * presentation contract's replacement-title rule), otherwise the file path
- * relativized to the session workspace so a workspace-rooted absolute path
- * displays the same short form the row summary shows.
+ * shortened the same way the row summary is: workspace-relative first, then
+ * POSIX `~` for a leftover host-home path.
  * @param block - RunningToolCall or ToolResultNode off the snapshot caches.
  * @param sessionCwd - the session workspace root; a workspace-rooted absolute
  *   path label displays relative to it. Absent leaves the path as authored.
+ * @param home - host account home; a leftover POSIX home path displays as `~`.
  * @returns the read-card props, or null for the generic path.
  */
-export declare function readCardModel(block: ToolCallBlock, sessionCwd?: string): ReadCardModel | null;
+export declare function readCardModel(block: ToolCallBlock, sessionCwd?: string, home?: string): ReadCardModel | null;
 //# sourceMappingURL=read-card-model.d.ts.map

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

@@ -1,11 +1,3 @@
-/**
- * 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 call whose render intent is
- * a terminal card gets its expanded body from the views instead, through
- * `terminalCardModel` in terminal-card-model.ts.
- */
 import type { ToolCallBlock, ToolResultNode } from '@deepseek-ai/dsh-client-runtime/client';
 export type { ToolCallBlock } from '@deepseek-ai/dsh-client-runtime/client';
 /** Tool-call row variants selected by the generic atomic renderer. */
@@ -59,7 +51,8 @@ export declare function relativizeToCwd(text: string, cwd: string | undefined):
  * @param toolName - wire tool name (dispatch-supplied; survives windowless results).
  * @param block - RunningToolCall or ToolResultNode off the snapshot caches.
  * @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.
  */
-export declare function toolRowModel(toolName: string, block: ToolCallBlock, cwd?: string): ToolRowModel;
+export declare function toolRowModel(toolName: string, block: ToolCallBlock, cwd?: string, home?: string): ToolRowModel;
 //# sourceMappingURL=tool-call-model.d.ts.map

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

@@ -3,5 +3,5 @@ import type { ToolCallOwnerProps, ToolTreeProps } from '../../contract/slots.ts'
 export interface GenericToolCardProps extends ToolCallOwnerProps {
     t: ToolTreeProps['t'];
 }
-export declare function GenericToolCard({ toolName, block, cwd, openFile, inspect, t }: GenericToolCardProps): import("react").JSX.Element;
+export declare function GenericToolCard({ toolName, block, cwd, home, openFile, inspect, t }: GenericToolCardProps): import("react").JSX.Element;
 //# sourceMappingURL=GenericToolCard.d.ts.map

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

@@ -12,7 +12,7 @@ type FileMutationRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
  * model-facing error text through its Output section and its first line in the
  * collapsed summary instead.
  */
-export declare function FileMutationRow({ toolName, block, cwd, openFile, inspect, t }: FileMutationRowProps): import("react").JSX.Element;
+export declare function FileMutationRow({ toolName, block, cwd, home, openFile, inspect, t }: FileMutationRowProps): import("react").JSX.Element;
 /**
  * The file-mutation rows as a plain registrant plugin following the chat
  * toolview declaration across independent activation and reload lifetimes.

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

@@ -8,7 +8,7 @@ type ReadRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
  * read card as the row's collapsed-by-default card body. The summary path is an
  * openable host link when the row names a single file.
  */
-export declare function ReadRow({ toolName, block, cwd, openFile, inspect, t }: ReadRowProps): import("react").JSX.Element;
+export declare function ReadRow({ toolName, block, cwd, home, openFile, inspect, t }: ReadRowProps): import("react").JSX.Element;
 /**
  * The read row as a plain registrant plugin following the atomic Tool-view
  * declaration across independent activation and reload lifetimes.

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.0-rc.7",
+  "version": "0.1.0-rc.8",
   "publishConfig": {
     "access": "public"
   },
@@ -32,6 +32,7 @@
   "dsh": {
     "client": {
       "inject": [
+        "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-conversation"
@@ -44,32 +45,29 @@
     "clsx": "^2.0.0"
   },
   "peerDependencies": {
-    "react": "^18.2.0",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.8",
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7"
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.8"
   },
   "devDependencies": {
     "@testing-library/react": "^16.1.0",
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.8",
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-web-react": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7"
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.8"
   },
   "files": [
     "lib/index.js",