@xiaoso/dsh-tool-plus 0.1.7 → 0.1.8-beta.2

package/lib/client.js

@@ -8,6 +8,7 @@ window.__ModuleLoader__.load({
 		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let react_jsx_runtime = require("react/jsx-runtime");
 		let _deepseek_ai_dsh_client_connection_client = require("@deepseek-ai/dsh-client-connection/client");
+		let react_dom = require("react-dom");
 		//#region src/config/fields.ts
 		/** Field group ids -> locale key of the group heading. */
 		const TOOL_PLUS_GROUP_LABELS = {
@@ -94,6 +95,15 @@ window.__ModuleLoader__.load({
 				group: "behavior",
 				tool: "bash"
 			},
+			{
+				name: "webCards",
+				kind: "boolean",
+				default: true,
+				labelKey: "webCards",
+				hintKey: "webCardsHint",
+				group: "behavior",
+				tool: "bash"
+			},
 			{
 				name: "autoBackgroundMs",
 				kind: "number",
@@ -1136,7 +1146,7 @@ window.__ModuleLoader__.load({
 			return SCHEMA_DEFAULTS[field];
 		}
 		/** Card chrome CSS, keyed by `data-plugin-css` and injected once (design-token driven). */
-		const CSS$1 = `
+		const CSS$2 = `
 .tp-card{list-style:none;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;background:var(--dsw-alias-bg-layer-3);transition:border-color .16s,background .16s;margin:0 0 8px}
 .tp-card:hover{border-color:var(--dsw-alias-label-dimmed)}
 .tp-card.tp-open{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}
@@ -1175,16 +1185,16 @@ window.__ModuleLoader__.load({
 }
 `;
 		/** Inject the card stylesheet once per page; the loader removes plugin-owned style tags on unload. */
-		let cssInjected$1 = false;
+		let cssInjected$2 = false;
 		function injectCardCss() {
-			if (cssInjected$1 || typeof document === "undefined") return;
-			cssInjected$1 = true;
+			if (cssInjected$2 || typeof document === "undefined") return;
+			cssInjected$2 = true;
 			const id = "tool-plus-card";
 			if (document.querySelector("style[data-plugin-css=\"tool-plus-card\"]") !== null) return;
 			const tag = document.createElement("style");
 			tag.dataset.plugin = "@xiaoso/dsh-tool-plus";
 			tag.dataset.pluginCss = id;
-			tag.textContent = CSS$1;
+			tag.textContent = CSS$2;
 			document.head.appendChild(tag);
 		}
 		/** Text of a staged (or resolved) value for the number controls. */
@@ -1710,13 +1720,13 @@ window.__ModuleLoader__.load({
 				return (c === "x" ? r : r & 3 | 8).toString(16);
 			});
 		}
-		function isRecord(value) {
+		function isRecord$3(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		function parseConnectionResponse(value) {
-			if (!isRecord(value) || value.type !== "server-response" || typeof value.rpcId !== "string") throw new TypeError("connection: invalid server-response envelope");
+			if (!isRecord$3(value) || value.type !== "server-response" || typeof value.rpcId !== "string") throw new TypeError("connection: invalid server-response envelope");
 			const result = value.result;
-			if (!isRecord(result)) throw new TypeError("connection: invalid server-response result");
+			if (!isRecord$3(result)) throw new TypeError("connection: invalid server-response result");
 			if (result.ok === true) return {
 				rpcId: value.rpcId,
 				result: {
@@ -1724,9 +1734,9 @@ window.__ModuleLoader__.load({
 					value: result.value
 				}
 			};
-			if (result.ok !== false || !isRecord(result.error)) throw new TypeError("connection: invalid server-response result");
+			if (result.ok !== false || !isRecord$3(result.error)) throw new TypeError("connection: invalid server-response result");
 			const error = result.error;
-			if (typeof error.code !== "string" || typeof error.message !== "string" || !isRecord(error.details)) throw new TypeError("connection: invalid server-response failure");
+			if (typeof error.code !== "string" || typeof error.message !== "string" || !isRecord$3(error.details)) throw new TypeError("connection: invalid server-response failure");
 			return {
 				rpcId: value.rpcId,
 				result: {
@@ -2131,7 +2141,7 @@ window.__ModuleLoader__.load({
 		* off under prefers-reduced-motion (CSS here, matchMedia for the
 		* JS-driven underline).
 		*/
-		const CSS = `
+		const CSS$1 = `
 .tps-section{box-sizing:border-box;display:flex;flex-direction:column;gap:16px;padding-top:2px}
 .tps-heading{margin:0;font-size:18px;font-weight:600;line-height:26px;color:var(--dsw-alias-label-primary);animation:tps-rise .38s cubic-bezier(.22,1,.36,1) both}
 .tps-intro{margin:0;font-size:13px;line-height:20px;color:var(--dsw-alias-label-tertiary);max-width:64ch;animation:tps-rise .38s cubic-bezier(.22,1,.36,1) .05s both}
@@ -2176,16 +2186,16 @@ window.__ModuleLoader__.load({
 }
 `;
 		/** Inject the section stylesheet once per page. */
-		let cssInjected = false;
+		let cssInjected$1 = false;
 		function injectSectionCss() {
-			if (cssInjected || typeof document === "undefined") return;
-			cssInjected = true;
+			if (cssInjected$1 || typeof document === "undefined") return;
+			cssInjected$1 = true;
 			const id = "tool-plus-section";
 			if (document.querySelector("style[data-plugin-css=\"tool-plus-section\"]") !== null) return;
 			const tag = document.createElement("style");
 			tag.dataset.plugin = "@xiaoso/dsh-tool-plus";
 			tag.dataset.pluginCss = id;
-			tag.textContent = CSS;
+			tag.textContent = CSS$1;
 			document.head.appendChild(tag);
 		}
 		/** Tool tabs with their owned fields, derived from the single-source table. */
@@ -2621,7 +2631,7 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/locales.ts
 		/** Simplified Chinese copy. */
-		const zh = {
+		const zh$1 = {
 			title: "Bash（bash-plus）",
 			description: "持久化 shell 工具：超时、后台化、命令拦截与运行环境。",
 			nav: "Tool Plus",
@@ -2774,6 +2784,8 @@ window.__ModuleLoader__.load({
 			rmSafeReasonRuntimeNotEffective: "运行时未生效",
 			useShellCommandWrapper: "用 bash -c 包裹命令",
 			useShellCommandWrapperHint: "把每条命令用 bash -c 包裹，以获得完整的 bash 环境。",
+			webCards: "Web 工具卡片",
+			webCardsHint: "在对话里用本插件的卡片展示 write / edit / read / grep / glob / ast_grep / ast_edit / bash 的调用结果；关闭后回到官方行。",
 			outputTruncateStrategy: "截断单位",
 			outputTruncateStrategyHint: "后台任务完成消息达到阈值时的截断单位：按字节或按行。切换后下方显示对应单位的配置。",
 			outputTruncateTriggerBytes: "字节触发阈值",
@@ -2811,7 +2823,7 @@ window.__ModuleLoader__.load({
 			appliesTo: "保存后对新调用生效。"
 		};
 		/** English copy. */
-		const en = {
+		const en$1 = {
 			title: "Bash (bash-plus)",
 			description: "Persistent shell tool: timeouts, backgrounding, interception, and environment.",
 			nav: "Tool Plus",
@@ -2964,6 +2976,8 @@ window.__ModuleLoader__.load({
 			rmSafeReasonRuntimeNotEffective: "not effective at runtime",
 			useShellCommandWrapper: "Wrap commands in bash -c",
 			useShellCommandWrapperHint: "Wrap every command in bash -c for a full bash environment.",
+			webCards: "Web tool cards",
+			webCardsHint: "Show this plugin's cards for write / edit / read / grep / glob / ast_grep / ast_edit / bash calls in chat; off falls back to the shipped rows.",
 			outputTruncateStrategy: "Truncate unit",
 			outputTruncateStrategyHint: "Unit used when a background completion message crosses its threshold: bytes or lines. Switching shows the matching unit's settings below.",
 			outputTruncateTriggerBytes: "Byte trigger threshold",
@@ -3001,6 +3015,2017 @@ window.__ModuleLoader__.load({
 			appliesTo: "Values apply to new calls."
 		};
 		//#endregion
+		//#region src/web/contract.ts
+		/**
+		* Web tool-card contract: the payload this plugin's Host half projects into
+		* `output.presentationMeta` and its browser half narrows back before drawing.
+		*
+		* Dependency-free by design (no React, no cordis, no Node built-ins): the Node
+		* half imports it to build metadata, the browser half imports it to validate
+		* it, and because it carries no React import it can never drag the browser
+		* bundle into the Node build.
+		*
+		* `edit` / `read` / `search` mirror the exact shapes the shipped
+		* `@deepseek-ai/dsh-client-ui-tool` card models accept — a `kind` tag rides on
+		* top, and those models ignore unknown keys — so the same payload stays
+		* readable if this plugin ever stops shadowing those rows. `write`,
+		* `ast_edit` and `terminal` are this plugin's own shapes: the shipped rows have
+		* no equivalent (their write card is a diff card; ours is a content preview,
+		* matching the OMP card the model already sees).
+		*
+		* Everything here is defensive: a card never throws. The browser half turns any
+		* malformed, oversized or foreign payload into `null`, and the row falls back
+		* to the generic shell.
+		*
+		* @module @xiaoso/dsh-tool-plus/web/contract
+		*/
+		/**
+		* Cell-shadowing rank of every card entry this plugin registers.
+		*
+		* The shipped `tool.call.toolview` entries all register at the default
+		* priority 0, and the lowest live entry of a cell renders. A large negative
+		* constant keeps this plugin first even if a future release starts ranking its
+		* own rows below zero — the gap is deliberate, not a tuned value.
+		*/
+		const CARD_TAKEOVER_PRIORITY = -1e3;
+		/**
+		* Wire tool names whose `tool.call.toolview` cell this plugin renders.
+		*
+		* `ast_grep` / `ast_edit` are this plugin's own tool names (no shipped entry
+		* claims those keys), so registering them is purely additive; the other six
+		* shadow a shipped row.
+		*/
+		const CARD_TOOL_KEYS = [
+			"bash",
+			"read",
+			"write",
+			"edit",
+			"grep",
+			"glob",
+			"ast_grep",
+			"ast_edit"
+		];
+		/** UTF-8 byte length of `text`, without allocating an encoder. */
+		function utf8ByteLength(text) {
+			let bytes = 0;
+			for (let index = 0; index < text.length; index += 1) {
+				const code = text.charCodeAt(index);
+				if (code < 128) bytes += 1;
+				else if (code < 2048) bytes += 2;
+				else if (code >= 55296 && code <= 56319) {
+					bytes += 4;
+					index += 1;
+				} else bytes += 3;
+			}
+			return bytes;
+		}
+		/** UTF-8 byte length of a value's JSON form; the unit every cap above uses. */
+		function jsonByteLength(value) {
+			const json = JSON.stringify(value);
+			return json === void 0 ? 0 : utf8ByteLength(json);
+		}
+		/** Whether `value` is a plain object (never an array or `null`). */
+		function isRecord$2(value) {
+			return typeof value === "object" && value !== null && !Array.isArray(value);
+		}
+		/** Non-blank string, or `null`. */
+		function nonBlankString(value) {
+			return typeof value === "string" && value.trim() !== "" ? value : null;
+		}
+		/** 1-based integer, or `null` (the shipped card models' own line rule). */
+		function positiveInteger(value) {
+			return typeof value === "number" && Number.isInteger(value) && value >= 1 ? value : null;
+		}
+		/** Non-negative integer, or `null`. */
+		function nonNegativeInteger(value) {
+			return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : null;
+		}
+		/** Optional grammar hint: a non-empty string stays, anything else drops. */
+		function lang(value) {
+			return typeof value === "string" && value !== "" ? { lang: value } : {};
+		}
+		/**
+		* Narrow opaque metadata to a {@link WriteCardMeta}.
+		* @param meta - the result node's `meta` field.
+		* @returns the narrowed metadata, or `null` when it is not a usable write card.
+		*/
+		function narrowWriteCardMeta(meta) {
+			if (!isRecord$2(meta) || meta.kind !== "write") return null;
+			const path = nonBlankString(meta.path);
+			if (path === null) return null;
+			return {
+				kind: "write",
+				path,
+				...lang(meta.lang),
+				...meta.madeExecutable === true ? { madeExecutable: true } : {}
+			};
+		}
+		/**
+		* Narrow opaque metadata to an {@link EditCardMeta}.
+		*
+		* Mirrors the shipped diff card's own validation (a hunk needs a non-blank
+		* `path`, an explicit `null` or string `oldText`, and a string `newText`) and
+		* additionally rejects a payload past {@link EDIT_META_MAX_BYTES}.
+		* @param meta - the result node's `meta` field.
+		* @returns the narrowed metadata, or `null` when it is not a usable diff card.
+		*/
+		function narrowEditCardMeta(meta) {
+			if (!isRecord$2(meta) || meta.kind !== "edit") return null;
+			if (jsonByteLength(meta) > 131072) return null;
+			const raw = meta.diffs;
+			if (!Array.isArray(raw) || raw.length === 0) return null;
+			const diffs = [];
+			for (const hunk of raw) {
+				if (!isRecord$2(hunk)) return null;
+				const path = nonBlankString(hunk.path);
+				if (path === null) return null;
+				const { oldText, newText } = hunk;
+				if (oldText !== null && typeof oldText !== "string") return null;
+				if (typeof newText !== "string") return null;
+				diffs.push({
+					path,
+					oldText,
+					newText
+				});
+			}
+			return {
+				kind: "edit",
+				diffs
+			};
+		}
+		/**
+		* Narrow opaque metadata to an {@link AstEditCardMeta}.
+		* @param meta - the result node's `meta` field.
+		* @returns the narrowed metadata, or `null` when it is not a usable preview.
+		*/
+		function narrowAstEditCardMeta(meta) {
+			if (!isRecord$2(meta) || meta.kind !== "ast_edit") return null;
+			if (jsonByteLength(meta) > 65536) return null;
+			if (typeof meta.preview !== "string") return null;
+			const replacements = nonNegativeInteger(meta.replacements);
+			if (replacements === null || typeof meta.applied !== "boolean") return null;
+			if (!Array.isArray(meta.files)) return null;
+			const files = [];
+			for (const file of meta.files) {
+				if (!isRecord$2(file)) return null;
+				const path = nonBlankString(file.path);
+				const count = nonNegativeInteger(file.count);
+				if (path === null || count === null) return null;
+				files.push({
+					path,
+					count
+				});
+			}
+			return {
+				kind: "ast_edit",
+				preview: meta.preview,
+				files,
+				replacements,
+				applied: meta.applied
+			};
+		}
+		/**
+		* Narrow opaque metadata to a {@link ReadCardMeta}.
+		*
+		* Mirrors the shipped read card's own validation: a 1-based `offset`, lines
+		* strictly increasing in `number` and never past `totalLines`. A window whose
+		* lines were all elided therefore narrows to a card with an empty body, not to
+		* a malformed one.
+		* @param meta - the result node's `meta` field.
+		* @returns the narrowed metadata, or `null` when it is not a usable read card.
+		*/
+		function narrowReadCardMeta(meta) {
+			if (!isRecord$2(meta) || meta.kind !== "read") return null;
+			if (jsonByteLength(meta) > 262144) return null;
+			const path = nonBlankString(meta.path);
+			const offset = positiveInteger(meta.offset);
+			const totalLines = nonNegativeInteger(meta.totalLines);
+			if (path === null || offset === null || totalLines === null) return null;
+			if (!Array.isArray(meta.lines)) return null;
+			const lines = [];
+			let previous = offset - 1;
+			for (const line of meta.lines) {
+				if (!isRecord$2(line)) return null;
+				const number = positiveInteger(line.number);
+				if (number === null || number <= previous || number > totalLines) return null;
+				if (typeof line.text !== "string") return null;
+				previous = number;
+				lines.push({
+					number,
+					text: line.text
+				});
+			}
+			return {
+				kind: "read",
+				path,
+				offset,
+				lines,
+				totalLines,
+				...lang(meta.lang)
+			};
+		}
+		/** Narrow one grouped-matches file entry, or `null` when malformed. */
+		function narrowSearchFile(file) {
+			if (!isRecord$2(file)) return null;
+			const path = nonBlankString(file.path);
+			if (path === null || !Array.isArray(file.matches)) return null;
+			const matches = [];
+			for (const match of file.matches) {
+				if (!isRecord$2(match)) return null;
+				const lineNumber = positiveInteger(match.lineNumber);
+				if (lineNumber === null || typeof match.line !== "string") return null;
+				matches.push({
+					lineNumber,
+					line: match.line
+				});
+			}
+			return {
+				path,
+				matches
+			};
+		}
+		/**
+		* Narrow opaque metadata to a {@link SearchCardMeta}.
+		* @param meta - the result node's `meta` field.
+		* @returns the narrowed metadata, or `null` when it is not a usable search card.
+		*/
+		function narrowSearchCardMeta(meta) {
+			if (!isRecord$2(meta) || meta.kind !== "search") return null;
+			if (jsonByteLength(meta) > 65536) return null;
+			if (typeof meta.truncated !== "boolean") return null;
+			const total = nonNegativeInteger(meta.total);
+			if (total === null) return null;
+			if (meta.shape === "matches") {
+				if (!Array.isArray(meta.files)) return null;
+				const files = [];
+				for (const file of meta.files) {
+					const narrowed = narrowSearchFile(file);
+					if (narrowed === null) return null;
+					files.push(narrowed);
+				}
+				return {
+					kind: "search",
+					shape: "matches",
+					files,
+					truncated: meta.truncated,
+					total
+				};
+			}
+			if (meta.shape !== "paths" || !Array.isArray(meta.paths)) return null;
+			const paths = [];
+			for (const path of meta.paths) {
+				if (typeof path !== "string") return null;
+				paths.push(path);
+			}
+			return {
+				kind: "search",
+				shape: "paths",
+				paths,
+				truncated: meta.truncated,
+				total
+			};
+		}
+		/**
+		* Narrow opaque metadata to a {@link TerminalCardMeta}.
+		* @param meta - the result node's `meta` field.
+		* @returns the narrowed metadata, or `null` when it is not a usable terminal card.
+		*/
+		function narrowTerminalCardMeta(meta) {
+			if (!isRecord$2(meta) || meta.kind !== "terminal") return null;
+			if (meta.mode === "background") {
+				const jobId = nonBlankString(meta.jobId);
+				return jobId === null ? null : {
+					kind: "terminal",
+					mode: "background",
+					jobId
+				};
+			}
+			if (meta.mode !== "foreground") return null;
+			const { exitCode, timedOut, aborted, workingDir } = meta;
+			if (exitCode !== null && (typeof exitCode !== "number" || !Number.isInteger(exitCode))) return null;
+			if (typeof timedOut !== "boolean" || typeof aborted !== "boolean") return null;
+			if (workingDir !== void 0 && typeof workingDir !== "string") return null;
+			return {
+				kind: "terminal",
+				mode: "foreground",
+				exitCode,
+				timedOut,
+				aborted,
+				...typeof workingDir === "string" && workingDir !== "" ? { workingDir } : {}
+			};
+		}
+		//#endregion
+		//#region src/web/client/labels.ts
+		/**
+		* Card copy for the browser tool views: every string the six row components
+		* and the shared shell draw, in its own locale namespace so it can never
+		* collide with the settings card's `tool-plus` bundle (the slots registry
+		* merges namespaces, and re-declaring one would be a compile error).
+		*
+		* zh is the source of truth for the key set; both dictionaries are
+		* `Record<ToolCardLocaleKey, string>`, so a missing or extra key in either is
+		* a compile error. Template parameters use the host's `{name}` placeholder
+		* convention (the seat interpolates the params record into the string).
+		*
+		* The wording mirrors the shipped conversation namespace for the same
+		* primitives (diff / read / search / terminal chrome) so a takeover does not
+		* change how the cards read; tool titles and the generic-row copy are ours.
+		* @module @xiaoso/dsh-tool-plus/web/client/labels
+		*/
+		/** Locale namespace of the tool-card bundle (registered by `registerToolCards`). */
+		const CARD_LOCALE_NS = "tool-plus-cards";
+		/** The bilingual bundle handed to `ctx.locale.register(CARD_LOCALE_NS, …)`. */
+		const cardLocales = {
+			zh: {
+				copy: "复制",
+				copied: "已复制",
+				collapse: "收起",
+				expand: "展开",
+				collapseAria: "收起",
+				expandAria: "展开其余 {count} 行",
+				expandRest: "… 其余 {count} 行",
+				"files.one": "{count} 个文件",
+				"files.other": "{count} 个文件",
+				running: "运行中",
+				done: "完成",
+				failed: "失败",
+				cancelled: "已取消",
+				timedOut: "已超时",
+				noOutput: "无输出",
+				"title.bash": "Bash",
+				"title.read": "读取",
+				"title.write": "写入",
+				"title.edit": "编辑",
+				"title.grep": "Grep",
+				"title.glob": "Glob",
+				"title.astGrep": "AST Grep",
+				"title.astEdit": "AST Edit",
+				"write.lines": "{count} 行",
+				"write.madeExecutable": "已赋予可执行权限",
+				"astEdit.replacements": "{count} 处替换",
+				"astEdit.files": "{count} 个文件",
+				"astEdit.parseErrors": "解析错误",
+				"read.window": "显示 {shown} / {total} 行",
+				"read.collapseAria": "收起内容",
+				"read.expandAria": "展开其余 {count} 行",
+				"read.expandRest": "… 其余 {count} 行",
+				"search.paths": "{shown} 个路径",
+				"search.paths.truncated": "显示 {shown} / 共 {total} 个路径",
+				"search.matches": "{shown} 处匹配 · {files} 个文件",
+				"search.matches.truncated": "显示 {shown} / 共 {total} 处匹配 · {files} 个文件",
+				"search.noResults": "无结果",
+				"search.collapseAria": "收起结果",
+				"search.expandAria": "展开其余 {count} 行结果",
+				"search.expandRest": "… 其余 {count} 行",
+				"terminal.signal": "信号 {signal}",
+				"terminal.exitCode": "退出码 {code}",
+				"terminal.running": "运行中",
+				"terminal.failed": "失败",
+				"terminal.done": "已完成",
+				"terminal.noOutput": "无输出",
+				"bash.background": "后台任务 {jobId}",
+				"image.loading": "加载中",
+				"image.loadFailed": "加载失败",
+				"image.open": "查看原图",
+				"image.openNamed": "查看原图：{name}",
+				"image.dialog": "原图预览",
+				"image.close": "关闭",
+				"image.unnamed": "图片",
+				"image.caption": "{name} · {width}×{height} · {size}",
+				"generic.params": "{count} 个参数",
+				"generic.noDetail": "没有更多可展示的细节",
+				inspect: "查看"
+			},
+			en: {
+				copy: "Copy",
+				copied: "Copied",
+				collapse: "Collapse",
+				expand: "Expand",
+				collapseAria: "Collapse",
+				expandAria: "Expand {count} more lines",
+				expandRest: "… {count} more lines",
+				"files.one": "{count} file",
+				"files.other": "{count} files",
+				running: "Running",
+				done: "Done",
+				failed: "Failed",
+				cancelled: "Cancelled",
+				timedOut: "Timed out",
+				noOutput: "No output",
+				"title.bash": "Bash",
+				"title.read": "Read",
+				"title.write": "Write",
+				"title.edit": "Edit",
+				"title.grep": "Grep",
+				"title.glob": "Glob",
+				"title.astGrep": "AST Grep",
+				"title.astEdit": "AST Edit",
+				"write.lines": "{count} lines",
+				"write.madeExecutable": "Made executable",
+				"astEdit.replacements": "{count} replacements",
+				"astEdit.files": "{count} files",
+				"astEdit.parseErrors": "Parse errors",
+				"read.window": "Showing {shown} of {total} lines",
+				"read.collapseAria": "Collapse content",
+				"read.expandAria": "Expand {count} more lines",
+				"read.expandRest": "… {count} more lines",
+				"search.paths": "{shown} paths",
+				"search.paths.truncated": "Showing {shown} of {total} paths",
+				"search.matches": "{shown} matches · {files} files",
+				"search.matches.truncated": "Showing {shown} of {total} matches · {files} files",
+				"search.noResults": "No results",
+				"search.collapseAria": "Collapse results",
+				"search.expandAria": "Expand {count} more result lines",
+				"search.expandRest": "… {count} more lines",
+				"terminal.signal": "signal {signal}",
+				"terminal.exitCode": "exit code {code}",
+				"terminal.running": "Running",
+				"terminal.failed": "Failed",
+				"terminal.done": "Done",
+				"terminal.noOutput": "No output",
+				"bash.background": "Background job {jobId}",
+				"image.loading": "Loading",
+				"image.loadFailed": "Load failed",
+				"image.open": "View original",
+				"image.openNamed": "View original: {name}",
+				"image.dialog": "Original image",
+				"image.close": "Close",
+				"image.unnamed": "Image",
+				"image.caption": "{name} · {width}×{height} · {size}",
+				"generic.params": "{count} params",
+				"generic.noDetail": "No further detail",
+				inspect: "Inspect"
+			}
+		};
+		//#endregion
+		//#region src/web/client/row-utils.ts
+		/** Run state word the shell exposes to assistive technology; `ok` says nothing. */
+		const STATE_STATUS_KEY = {
+			running: "running",
+			ok: null,
+			error: "failed",
+			warning: "failed"
+		};
+		/** Parsed-argument cache: the node is immutable, so one parse serves every render. */
+		const parsedArgs = /* @__PURE__ */ new WeakMap();
+		/** Whether a block is the settled half of a call pair. */
+		function isSettled(block) {
+			return block.kind === "tool-result";
+		}
+		/**
+		* The call head paired with a block: a running call is its own head; a settled
+		* result carries the head backfilled from the in-window `tool/call`, which is
+		* `null` when window truncation left that event outside.
+		*/
+		function callHead(block) {
+			if (!isSettled(block)) return block;
+			const call = block.call;
+			return typeof call === "object" && call !== null ? call : null;
+		}
+		/** Whether `value` is a plain object, the only argument shape the cards accept. */
+		function isRecord$1(value) {
+			return typeof value === "object" && value !== null && !Array.isArray(value);
+		}
+		/**
+		* Parse the call's raw argument JSON.
+		*
+		* The parsed object is memoized per node (the node is immutable), so repeated
+		* renders of one card pay for a single parse.
+		* @param block - the frozen running-or-settled call node.
+		* @returns the argument object, or `null` when the head is missing or its JSON
+		*   is not an object.
+		*/
+		function parseCardArgs(block) {
+			const cacheable = typeof block === "object" && block !== null ? block : null;
+			if (cacheable !== null) {
+				const hit = parsedArgs.get(cacheable);
+				if (hit !== void 0 || parsedArgs.has(cacheable)) return hit ?? null;
+			}
+			const raw = callHead(block)?.argsRaw;
+			let parsed = null;
+			if (typeof raw === "string") try {
+				const value = JSON.parse(raw);
+				if (isRecord$1(value)) parsed = value;
+			} catch {
+				parsed = null;
+			}
+			if (cacheable !== null) parsedArgs.set(cacheable, parsed);
+			return parsed;
+		}
+		/**
+		* Run state of one call.
+		*
+		* A settled `isError` result is an error; a foreground command that timed out
+		* or was cancelled is amber rather than green (the shipped terminal model
+		* reads only the trailing exit marker, which is exactly what the card owner
+		* was told not to trust). A non-zero exit stays `ok`: bash reports a failing
+		* command as result data, and the card's own status pill carries the red.
+		* @param block - the frozen running-or-settled call node.
+		* @returns the card run state.
+		*/
+		function cardState(block) {
+			if (!isSettled(block)) return "running";
+			if (block.isError === true) return "error";
+			const terminal = narrowTerminalCardMeta(cardMeta(block));
+			if (terminal !== null && terminal.mode === "foreground" && (terminal.timedOut || terminal.aborted)) return "warning";
+			return "ok";
+		}
+		/** Map a card run state onto the primitive's dot semantics. */
+		function dotState(state) {
+			switch (state) {
+				case "running": return "ongoing";
+				case "error": return "error";
+				case "warning": return "warning";
+				default: return "done";
+			}
+		}
+		/**
+		* The assistive-technology status word for a run state, or `null` when the
+		* state is already carried by the row's content.
+		*/
+		function stateStatus(state, t) {
+			const key = STATE_STATUS_KEY[state];
+			return key === null ? null : t(key);
+		}
+		/**
+		* Flatten a settled result's text blocks.
+		* @param block - the frozen call node.
+		* @returns the joined text blocks (empty for a running call or non-text output).
+		*/
+		function resultText(block) {
+			if (!isSettled(block) || !Array.isArray(block.content)) return "";
+			const parts = [];
+			for (const part of block.content) {
+				if (!isRecord$1(part)) continue;
+				if (part.type === "text" && typeof part.text === "string") parts.push(part.text);
+			}
+			return parts.join("\n");
+		}
+		/**
+		* The opaque metadata a call's result carried, exactly as the transport
+		* delivered it. Callers must run it through a `narrow*` guard before reading.
+		* @param block - the frozen call node.
+		* @returns the raw metadata, or `undefined` while the call is running.
+		*/
+		function cardMeta(block) {
+			return isSettled(block) ? block.meta : void 0;
+		}
+		/**
+		* Whether the call was dispatched by another tool (a Code Dispatch child).
+		* The card rows fall back to the generic shell for those, mirroring the
+		* shipped rows: a child diff/read/search inside a parent card would nest a
+		* surface inside the parent's own body.
+		*/
+		function isSubCall(block) {
+			return typeof block.parentCallId === "string";
+		}
+		/** Longest summary the shell renders before it is clipped for the row. */
+		const FIRST_LINE_MAX = 200;
+		/**
+		* The first non-empty line of a text, trimmed — the collapsed summary of an
+		* error, and the closing line of the generic shell's body.
+		* @param text - the source text.
+		* @returns the first line, clipped to a row-sized maximum (never throws).
+		*/
+		function firstLine(text) {
+			if (typeof text !== "string") return "";
+			const line = text.trim().split("\n", 1)[0]?.trim() ?? "";
+			return line.length > FIRST_LINE_MAX ? `${line.slice(0, 199)}…` : line;
+		}
+		/**
+		* A string argument by name.
+		* @param args - parsed arguments, or `null`.
+		* @param name - the argument key.
+		* @returns its value when it is a non-empty string, else `null`.
+		*/
+		function argText(args, name) {
+			const value = args?.[name];
+			return typeof value === "string" && value !== "" ? value : null;
+		}
+		/**
+		* Shorten an absolute path against the session workspace so a summary stays
+		* readable in a narrow row.
+		* @param path - the path to display.
+		* @param cwd - the session workspace root, when known.
+		* @returns the path relative to `cwd`, or `path` unchanged.
+		*/
+		function displayPath(path, cwd) {
+			if (cwd === void 0 || cwd === "") return path;
+			const root = cwd.endsWith("/") || cwd.endsWith("\\") ? cwd : `${cwd}/`;
+			const normalized = path.replace(/\\/g, "/");
+			const prefix = root.replace(/\\/g, "/");
+			if (!normalized.startsWith(prefix)) return path;
+			const rest = normalized.slice(prefix.length);
+			return rest === "" ? path : rest;
+		}
+		/**
+		* The collapsed summary for a call whose card could not be built: how many
+		* arguments the model sent, so the row is not blank.
+		* @param args - parsed arguments, or `null`.
+		* @param t - the card translate seat.
+		* @returns the localized parameter count.
+		*/
+		function argsSummary(args, t) {
+			const count = args === null ? 0 : Object.keys(args).length;
+			return count === 0 ? t("generic.noDetail") : t("generic.params", { count });
+		}
+		/** Card title key of every wire tool name this plugin renders. */
+		const TITLE_KEYS = {
+			bash: "title.bash",
+			read: "title.read",
+			write: "title.write",
+			edit: "title.edit",
+			grep: "title.grep",
+			glob: "title.glob",
+			ast_grep: "title.astGrep",
+			ast_edit: "title.astEdit"
+		};
+		/**
+		* The card title for a wire tool name.
+		*
+		* The same row component can be registered under several keys (one search row
+		* serves `grep`, `glob`, and `ast_grep`), and a window-truncated call has no
+		* name at all, so the caller names the key it was registered for as a fallback.
+		* @param toolName - the node's wire tool name (empty when truncated).
+		* @param t - the card translate seat.
+		* @param fallback - title key to use when the name is unknown.
+		* @returns the localized title.
+		*/
+		function cardTitle(toolName, t, fallback) {
+			return t((typeof toolName === "string" ? TITLE_KEYS[toolName] : void 0) ?? fallback);
+		}
+		/**
+		* Count a preview's content lines, ignoring the single trailing newline that
+		* terminates the last line.
+		* @param text - the preview text.
+		* @returns its line count (0 for empty text).
+		*/
+		function lineCount(text) {
+			if (typeof text !== "string" || text === "") return 0;
+			return (text.endsWith("\n") ? text.slice(0, -1) : text).split("\n").length;
+		}
+		/** `[timed out after 30000ms]` — `@deepseek-ai/dsh-shell/render`'s own literal. */
+		const TIMEOUT_MARKER = /^\[timed out after [^\]\n]*\]$/;
+		/** `[killed by signal: SIGTERM]`. */
+		const SIGNAL_MARKER = /^\[killed by signal: ([^\]\n]+)\]$/;
+		/** `[exit code: 1]`, or `[exit code: null]` for an unknown status. */
+		const EXIT_MARKER = /^\[exit code: (\d+|null)\]$/;
+		/**
+		* Split a settled shell result into its output and the status markers the
+		* renderer appended (timeout, terminating signal, exit code — in that order,
+		* so every marker is at the end and any run of them is stripped).
+		*
+		* The Host metadata already carries the run state; parsing is what keeps the
+		* markers out of the terminal card's output pane, and it is the only source
+		* for a signal name the projection does not carry.
+		* @param text - the result text.
+		* @returns the marker-free output and the facts the markers named.
+		*/
+		function parseShellStatus(text) {
+			let rest = typeof text === "string" ? text : "";
+			let exitCode;
+			let signal;
+			let timedOut = false;
+			for (;;) {
+				const trimmed = rest.endsWith("\n") ? rest.slice(0, -1) : rest;
+				const breakAt = trimmed.lastIndexOf("\n");
+				const last = breakAt === -1 ? trimmed : trimmed.slice(breakAt + 1);
+				const exit = EXIT_MARKER.exec(last);
+				if (exit !== null) {
+					exitCode = exit[1] === "null" ? null : Number(exit[1]);
+					rest = breakAt === -1 ? "" : trimmed.slice(0, breakAt);
+					continue;
+				}
+				const killed = SIGNAL_MARKER.exec(last);
+				if (killed !== null) {
+					signal = killed[1];
+					rest = breakAt === -1 ? "" : trimmed.slice(0, breakAt);
+					continue;
+				}
+				if (TIMEOUT_MARKER.test(last)) {
+					timedOut = true;
+					rest = breakAt === -1 ? "" : trimmed.slice(0, breakAt);
+					continue;
+				}
+				break;
+			}
+			return {
+				output: rest,
+				exitCode,
+				signal,
+				timedOut
+			};
+		}
+		/** Bind the card dictionary to the diff primitive's chrome labels. */
+		function diffBlockLabels(t) {
+			return {
+				copy: t("copy"),
+				copied: t("copied"),
+				collapseAria: t("collapseAria"),
+				expandAria: (count) => t("expandAria", { count }),
+				collapse: t("collapse"),
+				expand: (count) => t("expandRest", { count }),
+				files: (count) => t(count === 1 ? "files.one" : "files.other", { count })
+			};
+		}
+		/** Bind the card dictionary to the read primitive's chrome labels. */
+		function readBlockLabels(t) {
+			return {
+				window: (shown, total) => t("read.window", {
+					shown,
+					total
+				}),
+				copy: t("copy"),
+				copied: t("copied"),
+				collapseAria: t("read.collapseAria"),
+				expandAria: (count) => t("read.expandAria", { count }),
+				collapse: t("collapse"),
+				expand: (count) => t("read.expandRest", { count })
+			};
+		}
+		/** Bind the card dictionary to the search primitive's chrome labels. */
+		function searchBlockLabels(t) {
+			return {
+				pathsSummary: (shown, total, truncated) => t(truncated ? "search.paths.truncated" : "search.paths", {
+					shown,
+					total
+				}),
+				matchesSummary: (shown, total, files, truncated) => t(truncated ? "search.matches.truncated" : "search.matches", {
+					shown,
+					total,
+					files
+				}),
+				copy: t("copy"),
+				copied: t("copied"),
+				noResults: t("search.noResults"),
+				collapseAria: t("search.collapseAria"),
+				expandAria: (count) => t("search.expandAria", { count }),
+				collapse: t("collapse"),
+				expand: (count) => t("search.expandRest", { count })
+			};
+		}
+		/** Bind the card dictionary to the terminal primitive's chrome labels. */
+		function terminalBlockLabels(t) {
+			return {
+				signal: (signal) => t("terminal.signal", { signal }),
+				exitCode: (exitCode) => t("terminal.exitCode", { code: exitCode }),
+				running: t("terminal.running"),
+				failed: t("terminal.failed"),
+				done: t("terminal.done"),
+				copy: t("copy"),
+				copied: t("copied"),
+				noOutput: t("terminal.noOutput"),
+				collapseAria: t("collapseAria"),
+				collapse: t("collapse"),
+				expandAria: (hidden) => t("expandAria", { count: hidden }),
+				expand: (hidden) => t("expandRest", { count: hidden })
+			};
+		}
+		//#endregion
+		//#region src/web/client/ToolCardShell.tsx
+		/**
+		* The shared card shell every row renders through.
+		*
+		* The shipped `ToolRow` is not reusable from a plugin (ui-tool is not part of
+		* the client platform baseline), so this is our own: one 24px header line
+		* (state dot + title + separator + ellipsized summary + optional `+N -M`
+		* suffix + clickable path), a keyboard-reachable disclosure, and a body that
+		* is either the card a row built or the flattened result text.
+		*
+		* Two properties matter more than the visuals:
+		* - **Never throw.** Every value is coerced defensively, and {@link CardBoundary}
+		*   turns a crash inside a card into the same generic shell, because an
+		*   exception reaching the slot retires the cell and abdicates the call to the
+		*   shipped row.
+		* - **Theme tokens only.** The sheet below reads `--dsw-alias-*` (plus the two
+		*   published content-font vars) and hard-codes no colour, so light and dark
+		*   both come out right.
+		* @module @xiaoso/dsh-tool-plus/web/client/ToolCardShell
+		*/
+		/** Chrome CSS, keyed by `data-plugin-css` and injected once per page. */
+		const CSS = `
+.twc-root{display:flex;flex-direction:column;min-width:0}
+.twc-row{position:relative;min-width:0}
+.twc-leading{flex-shrink:0}
+.twc-chevron{color:var(--dsw-alias-label-secondary)}
+.twc-title{font-weight:400}
+.twc-sep{flex:none;width:2px;height:2px;border-radius:1px;margin:0 8px;background:var(--dsw-alias-label-caption)}
+.twc-summary{flex:1 1 auto;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;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)}
+.twc-summarySuffix{flex:none;margin-left:4px;white-space:nowrap;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)}
+.twc-diffStat{margin-left:10px;font-family:var(--ds-font-family-code);font-size:calc(var(--dsh-content-font-size-secondary,13px) - 2px);color:var(--dsw-alias-label-caption)}
+.twc-errorSummary{color:var(--dsw-alias-state-error-primary)}
+.twc-fileLink{flex:0 1 auto;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;margin:0;padding:0;border:none;background:none;font:inherit;text-align:left;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);text-decoration:underline dotted;text-decoration-color:var(--dsw-alias-label-tertiary);text-decoration-thickness:1px;text-underline-offset:3px;cursor:pointer;border-radius:4px}
+.twc-fileLink:hover{color:var(--dsw-alias-label-primary);text-decoration-color:currentColor}
+.twc-fileLink:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}
+.twc-bodyWrap{display:flex;flex-direction:column;min-width:0}
+.twc-body{margin:4px 0 4px 4px;min-width:0}
+.twc-text{margin:4px 0 4px 4px;padding:10px 14px;max-height:260px;overflow:auto;border-radius:12px;background:var(--dsw-alias-markdown-code-block);color:var(--dsw-alias-label-secondary);font-family:var(--ds-font-family-code);font-size:12px;line-height:18px;white-space:pre-wrap;word-break:break-word}
+.twc-note{margin:4px 0 4px 4px;font-size:12px;line-height:18px;color:var(--dsw-alias-label-tertiary)}
+.twc-media{display:flex;flex-direction:column;align-items:flex-start;gap:8px;margin:4px 0 4px 4px;min-width:0}
+/* Image gallery: the wrapping group the message gallery uses, so a card's
+   images and a message's images wrap the same way. */
+.twc-imgGallery{display:flex;flex-wrap:wrap;gap:10px;max-width:100%;min-width:0}
+/* Thumbnail frame (figma message-image rule): a 16px-radius tile that crops
+   with object-fit cover, sized inline for a lone image and 64×64 in a gallery. */
+.twc-imgFrame{display:grid;flex:0 0 auto;place-items:center;box-sizing:border-box;min-width:44px;min-height:44px;padding:0;overflow:hidden;border:0.5px solid var(--dsw-alias-border-l2-darkmode-thin);border-radius:16px;background:var(--dsw-alias-interactive-bg-hover);cursor:zoom-in}
+.twc-imgFrame[data-variant='tile']{width:64px;height:64px;min-width:64px;min-height:64px}
+.twc-imgFrame:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}
+.twc-mediaImg{display:block;width:100%;height:100%;object-fit:cover}
+.twc-imgLoading{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}
+/* Failed load: the frame itself becomes the retry control (the official
+   behaviour), so a transient failure costs one click instead of a reload. It
+   carries the frame's own box model — border-box, same 44px floor — so the
+   reserved box survives loading → loaded → failed unchanged (no jump). */
+.twc-imgError{box-sizing:border-box;min-width:44px;min-height:44px;max-width:240px;padding:10px 12px;overflow:hidden;border:0.5px solid var(--dsw-alias-border-l2-darkmode-thin);border-radius:10px;background:var(--dsw-alias-interactive-bg-hover-danger);color:var(--dsw-alias-label-tertiary);font:inherit;font-size:12px;line-height:18px;text-align:left;cursor:pointer}
+.twc-imgError[data-variant='tile']{width:64px;height:64px;min-width:64px;min-height:64px;padding:4px;border-radius:16px}
+.twc-imgError:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}
+/* Original-image lightbox: a body portal, a mask on its own layer (blurring
+   the backdrop itself would blur the preview and the close control), and the
+   preview stacked with its caption so the two always read as one object. */
+.twc-lightbox{position:fixed;inset:0;z-index:1000;display:grid;place-items:center;padding:40px}
+.twc-lightboxMask{position:absolute;inset:0;background:var(--dsw-alias-bg-mask-1);backdrop-filter:var(--dsw-mask-blur)}
+.twc-lightboxStack{position:relative;display:flex;flex-direction:column;align-items:center;gap:10px;max-height:calc(100vh - 80px);min-width:0}
+.twc-lightboxImg{max-width:min(100%,1600px);max-height:calc(100vh - 130px);object-fit:contain;border-radius:12px;background:var(--dsw-specific-input-major);box-shadow:var(--dsw-shadow-lv3)}
+.twc-lightboxClose{position:fixed;top:20px;right:20px;z-index:1;display:grid;place-items:center;width:36px;height:36px;border:0.5px solid var(--dsw-alias-border-l2-darkmode-thin);border-radius:999px;background:var(--dsw-specific-input-major);color:var(--dsw-alias-label-primary);cursor:pointer}
+.twc-lightboxClose:hover{background:var(--dsw-alias-interactive-bg-hover-solid)}
+.twc-lightboxClose:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}
+/* The caption carries the reference's own numbers — name, intrinsic size,
+   byte length — so the enlarged view states what the file actually is. It sits
+   in the stack under the image: fixed to the viewport it read as a separate
+   object from a centred image, and a tall image could squeeze it out. */
+.twc-lightboxCaption{margin:0;max-width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;padding:5px 14px;border:0.5px solid var(--dsw-alias-border-l2-darkmode-thin);border-radius:999px;background:var(--dsw-specific-input-major);color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}
+/* Motion is feedback, never decoration: the hover lift, the skeleton pulse,
+   and the lightbox entrance all sit behind the user's motion preference. A
+   reduced-motion reader keeps every state change, just without the glide. */
+.twc-imgFrame:hover{box-shadow:var(--dsw-shadow-lv1-blur)}
+@media (prefers-reduced-motion: no-preference){
+  .twc-imgFrame{transition:transform 160ms ease,box-shadow 160ms ease}
+  .twc-imgFrame:hover{transform:scale(1.01)}
+  .twc-imgFrame:active{transform:scale(0.99)}
+  .twc-imgLoading{animation:twc-img-pulse 1.6s ease-in-out infinite}
+  .twc-lightbox{animation:twc-lightbox-in 160ms ease-out}
+  .twc-lightboxImg{animation:twc-lightbox-img-in 180ms ease-out}
+  @keyframes twc-img-pulse{0%,100%{opacity:.55}50%{opacity:1}}
+  @keyframes twc-lightbox-in{from{opacity:0}to{opacity:1}}
+  @keyframes twc-lightbox-img-in{from{opacity:0;transform:scale(.98)}to{opacity:1;transform:scale(1)}}
+}
+.twc-inspect{display:inline-flex;align-self:flex-start;align-items:center;gap:4px;margin:4px 0 2px 4px;padding:2px 8px;border:0.5px solid var(--dsw-alias-border-l3);border-radius:999px;background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-secondary);font:inherit;font-size:11px;line-height:16px;cursor:pointer;opacity:0;transition:opacity 100ms ease}
+.twc-root:hover .twc-inspect,.twc-inspect:focus-visible{opacity:1}
+.twc-inspect:hover{background:var(--dsw-alias-interactive-bg-hover-solid);color:var(--dsw-alias-label-primary)}
+.twc-visuallyHidden{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0}
+.twc-fallbackDot{flex:none;width:8px;height:8px;border-radius:999px;background:var(--dsw-alias-state-error-primary)}
+@media (prefers-reduced-motion: reduce){.twc-inspect{transition:none}}
+`;
+		/** Inject the card stylesheet once per page; the loader drops plugin style tags on unload. */
+		let cssInjected = false;
+		function injectCss() {
+			if (cssInjected) return;
+			if (typeof document === "undefined") return;
+			cssInjected = true;
+			const id = "tool-plus-cards";
+			if (document.querySelector("style[data-plugin-css=\"tool-plus-cards\"]") !== null) return;
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@xiaoso/dsh-tool-plus";
+			tag.dataset.pluginCss = id;
+			tag.textContent = CSS;
+			document.head.appendChild(tag);
+		}
+		/** Whether a React node would draw anything. */
+		function hasContent(node) {
+			return node !== void 0 && node !== null && node !== false;
+		}
+		/**
+		* Render the shared card shell.
+		* @param props - see {@link ToolCardShellProps}.
+		* @returns the card row and, when expanded, its body.
+		*/
+		function ToolCardShell(props) {
+			injectCss();
+			const { t, state, title, children, filePath, openFile, inspect } = props;
+			const [expanded, setExpanded] = (0, react.useState)(props.defaultOpen === true);
+			const bodyCard = hasContent(children) ? children : null;
+			const bodyText = typeof props.text === "string" && props.text !== "" ? props.text : null;
+			const expandable = bodyCard !== null || bodyText !== null;
+			const open = expanded && expandable;
+			const status = stateStatus(state, t);
+			const summaryText = typeof props.summary === "string" ? props.summary : "";
+			const suffix = typeof props.summarySuffix === "string" && props.summarySuffix !== "" ? props.summarySuffix : null;
+			const fileLink = filePath !== void 0 && filePath !== null && filePath !== "" && openFile !== void 0;
+			const errorTone = props.summaryTone === "error";
+			const toggle = () => {
+				setExpanded((value) => !value);
+			};
+			const openPath = (event) => {
+				event.stopPropagation();
+				if (!fileLink || openFile === void 0) return;
+				const line = props.filePathLine;
+				if (typeof line === "number") openFile(filePath, { line });
+				else openFile(filePath);
+			};
+			const openPathKeyDown = (event) => {
+				if (event.key === "Enter" || event.key === " ") event.stopPropagation();
+			};
+			const collapsed = summaryText === "" ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "twc-sep",
+					"aria-hidden": true
+				}),
+				fileLink ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					type: "button",
+					className: "twc-fileLink",
+					onClick: openPath,
+					onKeyDown: openPathKeyDown,
+					children: summaryText
+				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: errorTone ? "twc-summary twc-errorSummary" : "twc-summary",
+					children: summaryText
+				}),
+				suffix !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "twc-summarySuffix",
+					children: suffix
+				})
+			] });
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "twc-root",
+				"data-state": state,
+				"data-tool": title,
+				children: [status !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "twc-visuallyHidden",
+					children: status
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.DisclosureRow, {
+					rowClassName: "twc-row",
+					leadingClassName: "twc-leading",
+					titleClassName: "twc-title",
+					chevronClassName: "twc-chevron",
+					icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: dotState(state) }),
+					title,
+					open,
+					expandable,
+					expandOnRowClick: true,
+					keepContentWhenOpen: true,
+					onToggle: toggle,
+					collapsedContent: collapsed,
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "twc-bodyWrap",
+						children: [bodyCard ?? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
+							className: "twc-text",
+							children: bodyText
+						}), inspect !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							type: "button",
+							className: "twc-inspect",
+							onClick: inspect,
+							children: t("inspect")
+						})]
+					})
+				})]
+			});
+		}
+		/**
+		* The generic card: every row's degradation path.
+		*
+		* A card is only drawn once its metadata passed a `narrow*` guard, so anything
+		* else — a running call, a window-truncated call, a Code Dispatch child, a
+		* failure, a payload from another plugin version — lands here with the call's
+		* own title, run state, argument count, and result text.
+		* @param props - see {@link GenericCardProps}.
+		* @returns the generic shell.
+		*/
+		function GenericCard({ t, title, block, args, inspect }) {
+			const state = cardState(block);
+			const output = resultText(block);
+			const failure = state === "error" ? firstLine(output) : "";
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
+				t,
+				state,
+				title,
+				summary: failure === "" ? argsSummary(args, t) : failure,
+				summaryTone: failure === "" ? "default" : "error",
+				text: output,
+				inspect
+			});
+		}
+		/** Best-effort message for a thrown value; never throws itself. */
+		function failureText(error) {
+			try {
+				if (error instanceof Error && typeof error.message === "string" && error.message !== "") return error.message;
+				if (typeof error === "string" && error !== "") return error;
+			} catch {}
+			return "Unknown card error";
+		}
+		/**
+		* Contain a card's render failure: the fallback is a generic shell (never the
+		* card's own chrome), so one malformed payload cannot take the call's cell —
+		* or the whole slot — down with it.
+		*/
+		var CardBoundary = class extends react.Component {
+			state = { failure: null };
+			/** React's error-boundary hook: record the failure and render the fallback. */
+			static getDerivedStateFromError(error) {
+				return { failure: failureText(error) };
+			}
+			/** Report the failure without rethrowing. */
+			componentDidCatch(error) {
+				console.error("[tool-plus] a web tool card failed to render; showing the generic card instead.", error);
+			}
+			render() {
+				const { failure } = this.state;
+				if (failure === null) return this.props.children;
+				const { t, title, block, summary } = this.props;
+				let text = null;
+				try {
+					const output = block === void 0 ? "" : resultText(block);
+					text = output === "" ? null : output;
+				} catch {
+					text = null;
+				}
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
+					t,
+					state: "error",
+					title,
+					summary: failure === "" ? summary ?? null : firstLine(failure),
+					summaryTone: "error",
+					text
+				});
+			}
+		};
+		//#endregion
+		//#region src/web/client/rows/AstEditRow.tsx
+		/**
+		* `ast_edit` row: the engine's own change preview.
+		*
+		* The AST engine already renders a grouped preview (file header, replacement
+		* count, the first line of each change) and hands it to the Host as
+		* `displayContent`; that text is what this card shows, because the exact
+		* before/after hunks are dropped inside the ported tool and the write happens
+		* in the native engine. No diff is computed here, and no `±` totals are shown.
+		* @module @xiaoso/dsh-tool-plus/web/client/rows/AstEditRow
+		*/
+		/** The engine reports parse failures in its result text, not in the metadata. */
+		const PARSE_ERROR = /parse error/i;
+		/**
+		* Render an `ast_edit` call as a change preview.
+		* @param props - the slot's owner props and this plugin's translate seat.
+		* @returns the preview card, or the generic shell when there is no preview.
+		*/
+		function AstEditRow(props) {
+			const { t, block } = props;
+			const title = cardTitle(props.toolName, t, "title.astEdit");
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CardBoundary, {
+				t,
+				title,
+				block,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AstEditCard, {
+					...props,
+					title
+				})
+			});
+		}
+		/**
+		* The card itself, inside the boundary.
+		* @param props - row props plus the resolved title.
+		* @returns the preview card.
+		*/
+		function AstEditCard(props) {
+			const { t, block, cwd, inspect, openFile, title } = props;
+			const args = parseCardArgs(block);
+			const meta = narrowAstEditCardMeta(cardMeta(block));
+			if (isSubCall(block) || block.isError === true || meta === null || meta.preview === "") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(GenericCard, {
+				t,
+				title,
+				block,
+				args,
+				inspect
+			});
+			const files = meta.files.length;
+			const single = files === 1 ? meta.files[0]?.path : void 0;
+			const output = resultText(block);
+			const parseErrors = PARSE_ERROR.test(output);
+			const summary = single !== void 0 && single !== "" ? displayPath(single, cwd) : t("astEdit.files", { count: files });
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
+				t,
+				state: cardState(block),
+				title,
+				summary,
+				summarySuffix: `${t("astEdit.replacements", { count: meta.replacements })} · ${t("astEdit.files", { count: files })}`,
+				filePath: single,
+				openFile,
+				inspect,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "twc-body",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.CodeBlock, {
+						code: meta.preview,
+						copyLabel: t("copy"),
+						copiedLabel: t("copied")
+					}), output !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "twc-note",
+						children: parseErrors ? `${t("astEdit.parseErrors")}: ${output}` : output
+					})]
+				})
+			});
+		}
+		//#endregion
+		//#region src/web/client/rows/FileMutationRow.tsx
+		/**
+		* `edit` row: a diff card.
+		*
+		* Two sources, in order: the Host projection (`meta.diffs`, built from the
+		* engine's own unified diff — the change is already computed and needs no
+		* extra I/O), then the replace-form arguments while the call is still running
+		* (or when the Host could not project a diff). Every other edit mode (patch,
+		* hashline, apply_patch) has no diff until it settles, so it falls back to the
+		* generic shell rather than guessing from `patch`/`input` text.
+		* @module @xiaoso/dsh-tool-plus/web/client/rows/FileMutationRow
+		*/
+		/**
+		* Render an `edit` call as a diff card.
+		* @param props - the slot's owner props and this plugin's translate seat.
+		* @returns the diff card, or the generic shell for a mode with no diff yet.
+		*/
+		function FileMutationRow(props) {
+			const { t, block } = props;
+			const title = cardTitle(props.toolName, t, "title.edit");
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CardBoundary, {
+				t,
+				title,
+				block,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FileMutationCard, {
+					...props,
+					title
+				})
+			});
+		}
+		/**
+		* The card itself, inside the boundary.
+		* @param props - row props plus the resolved title.
+		* @returns the diff card.
+		*/
+		function FileMutationCard(props) {
+			const { t, block, cwd, inspect, openFile, title } = props;
+			const args = parseCardArgs(block);
+			const meta = narrowEditCardMeta(cardMeta(block));
+			const replaceForm = replaceHunks(args);
+			if (isSubCall(block) || block.isError === true || meta === null && replaceForm === null) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(GenericCard, {
+				t,
+				title,
+				block,
+				args,
+				inspect
+			});
+			const diffs = meta === null ? replaceForm ?? [] : meta.diffs;
+			const paths = [...new Set(diffs.map((hunk) => hunk.path))];
+			const single = paths.length === 1 ? paths[0] : void 0;
+			const totals = (0, _deepseek_ai_dsh_client_ui_primitives.diffTotals)(diffs);
+			const summary = single === void 0 ? t("files.other", { count: paths.length }) : displayPath(single, cwd);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
+				t,
+				state: cardState(block),
+				title,
+				summary,
+				summarySuffix: `+${totals.added} -${totals.removed}`,
+				filePath: single,
+				openFile,
+				inspect,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.DiffBlock, {
+					diffs,
+					labels: diffBlockLabels(t),
+					className: "twc-body"
+				})
+			});
+		}
+		/**
+		* The replace form's diff, straight from the call's arguments: one hunk for
+		* `old_string` → `new_string`. The empty `new_string` is a real value (it
+		* deletes), so only the path and `old_string` are required to be non-empty.
+		* @param args - the call's parsed arguments, or `null`.
+		* @returns one hunk, or `null` when the call is not the replace form.
+		*/
+		function replaceHunks(args) {
+			const path = argText(args, "file_path");
+			const oldText = argText(args, "old_string");
+			const newText = args?.new_string;
+			if (path === null || oldText === null || typeof newText !== "string") return null;
+			return [{
+				path,
+				oldText,
+				newText
+			}];
+		}
+		//#endregion
+		//#region src/web/client/rows/image-card.ts
+		/** Whether `value` is a plain object. */
+		function isRecord(value) {
+			return typeof value === "object" && value !== null && !Array.isArray(value);
+		}
+		/** A finite number — a `NaN` dimension would only break layout later. */
+		function isFiniteNumber(value) {
+			return typeof value === "number" && Number.isFinite(value);
+		}
+		/**
+		* Display box for a lone image — DSH's own rule, copied from
+		* `ui-attachment/src/MessageImage.tsx::singleFit` so a tool-card image and a
+		* message image of the same file occupy the same box: long edge 240px, the
+		* rendered aspect ratio clamped to [0.25, 4] (the clamped overflow is cropped
+		* by `object-fit: cover`), never upscaled past the natural size, and the crop
+		* anchored to the top of very tall images / the left of very wide ones, where
+		* the informative content usually starts.
+		*
+		* The clamp is deliberately not strict: an exactly 4:1 image stays centred.
+		* @param size - the reference's intrinsic dimensions, in pixels.
+		* @returns the rendered box and the crop anchor.
+		*/
+		function imageFitBox(size) {
+			const natural = size.width / size.height;
+			const ratio = Math.min(4, Math.max(.25, natural));
+			const box = ratio >= 1 ? {
+				width: 240,
+				height: 240 / ratio
+			} : {
+				width: 240 * ratio,
+				height: 240
+			};
+			const scale = Math.min(1, size.width / box.width, size.height / box.height);
+			return {
+				width: Math.max(1, Math.round(box.width * scale)),
+				height: Math.max(1, Math.round(box.height * scale)),
+				objectPosition: natural < .25 ? "center top" : natural > 4 ? "left center" : "center"
+			};
+		}
+		/**
+		* The call's arguments.
+		*
+		* A settled node carries the paired call head under `call`, and that is the
+		* only source: the node-level `argsRaw` belongs to a *running* call, so reading
+		* it here would let a truncated settled call (head outside the window) render a
+		* card whose argument summary is empty. `parseCardArgs` narrows the same field
+		* the same way.
+		* @param block - the settled call node.
+		* @returns the parsed argument object, or `null`.
+		*/
+		function callArgs(block) {
+			const raw = block.call?.argsRaw;
+			if (typeof raw !== "string") return null;
+			try {
+				const value = JSON.parse(raw);
+				return isRecord(value) ? value : null;
+			} catch {
+				return null;
+			}
+		}
+		/**
+		* Validate one wire attachment object as a durable image reference.
+		*
+		* The store's `ImageAttachmentRef` brands `attachmentId` and `mediaType`; the
+		* result's JSON carries plain strings. This is the single boundary where a
+		* validated wire object becomes that typed reference, field by field — and the
+		* copy keeps the optional fields (`name`, `originalDimensions`) the wire may
+		* carry.
+		* @param value - the image block's `attachment` field.
+		* @returns the typed reference, or `null` when any required field is wrong.
+		*/
+		function typedAttachment(value) {
+			if (!isRecord(value)) return null;
+			if (typeof value.attachmentId !== "string") return null;
+			if (typeof value.mediaType !== "string") return null;
+			if (!isFiniteNumber(value.bytes)) return null;
+			if (!isFiniteNumber(value.width)) return null;
+			if (!isFiniteNumber(value.height)) return null;
+			if (value.width <= 0 || value.height <= 0) return null;
+			return { ...value };
+		}
+		/**
+		* Derive the read card's image material from a settled result.
+		*
+		* Declines — rather than guessing — whenever the result would not be fully
+		* representable: a running call, a failed call, a result whose content carries
+		* a block that is neither text nor image, an image whose reference is
+		* malformed, a text-only result (the text card owns those), or a call whose
+		* arguments name no path.
+		* @param block - the frozen call node.
+		* @param cwd - the session workspace root, for shortening the label.
+		* @returns the material, or `null` to leave the row on its existing path.
+		*/
+		function imageCardMaterial(block, cwd) {
+			if (!isSettled(block) || block.isError === true) return null;
+			const content = block.content;
+			if (!Array.isArray(content)) return null;
+			const images = [];
+			for (const blockContent of content) {
+				if (!isRecord(blockContent)) return null;
+				if (blockContent.type === "text") continue;
+				if (blockContent.type !== "image") return null;
+				const image = typedAttachment(blockContent.attachment);
+				if (image === null) return null;
+				images.push(image);
+			}
+			if (images.length === 0) return null;
+			const path = callArgs(block)?.path;
+			if (typeof path !== "string" || path.trim() === "") return null;
+			return {
+				label: displayPath(path, cwd),
+				path,
+				images
+			};
+		}
+		//#endregion
+		//#region src/web/client/rows/ReadRow.tsx
+		/**
+		* `read` row: a line-numbered window view, or the image the read returned.
+		*
+		* Two mutually exclusive bodies hang off one call:
+		* - The Host projected a readable window (`meta`) → the line-numbered text card.
+		* - It did not (an image, a directory, a sqlite or archive target, an internal
+		*   URL, a multi-range `:raw` read) → this row tries the image branch, which
+		*   draws the result's image blocks through the session-authorized loader the
+		*   slot hands every tool view. Anything else keeps the generic shell and its
+		*   result text.
+		*
+		* The image branch reimplements the shipped message-image interaction — the
+		* `singleFit` box, 64px gallery tiles, a retry control on a failed load, and a
+		* body-portal lightbox for the original — so a tool-card image and a message
+		* image of the same file behave identically. It lives here rather than in
+		* `image-card.ts` because that module stays pure: this file owns the loader
+		* calls, their cancellation, and the DOM.
+		* @module @xiaoso/dsh-tool-plus/web/client/rows/ReadRow
+		*/
+		/**
+		* Render a `read` call as a line-numbered window or an image.
+		* @param props - the slot's owner props and this plugin's translate seat.
+		* @returns the read card, or the generic shell when nothing else fits.
+		*/
+		function ReadRow(props) {
+			const { t, block } = props;
+			const title = cardTitle(props.toolName, t, "title.read");
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CardBoundary, {
+				t,
+				title,
+				block,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ReadCard, {
+					...props,
+					title
+				})
+			});
+		}
+		/**
+		* The card itself, inside the boundary.
+		* @param props - row props plus the resolved title.
+		* @returns the read card.
+		*/
+		function ReadCard(props) {
+			const { t, block, cwd, inspect, openFile, title } = props;
+			const args = parseCardArgs(block);
+			const meta = narrowReadCardMeta(cardMeta(block));
+			const material = (0, react.useMemo)(() => imageCardMaterial(block, cwd), [block, cwd]);
+			if (isSubCall(block) || block.isError === true) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(GenericCard, {
+				t,
+				title,
+				block,
+				args,
+				inspect
+			});
+			if (meta === null) {
+				if (material === null) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(GenericCard, {
+					t,
+					title,
+					block,
+					args,
+					inspect
+				});
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ImageReadCard, {
+					t,
+					block,
+					material,
+					title,
+					inspect,
+					openFile,
+					loadImage: props.loadImage
+				});
+			}
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
+				t,
+				state: cardState(block),
+				title,
+				summary: displayPath(meta.path, cwd),
+				filePath: meta.path,
+				filePathLine: meta.offset,
+				openFile,
+				inspect,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.ReadBlock, {
+					label: displayPath(meta.path, cwd),
+					lines: meta.lines,
+					totalLines: meta.totalLines,
+					lang: meta.lang,
+					labels: readBlockLabels(t),
+					className: "twc-body"
+				})
+			});
+		}
+		/**
+		* Ask the loader's synchronous cache for an already-known URL.
+		* @param loader - the host's image loader.
+		* @param attachment - the reference to resolve.
+		* @returns the cached URL, or `null` when there is none.
+		*/
+		function peekUrl(loader, attachment) {
+			if (loader?.peek === void 0) return null;
+			try {
+				const url = loader.peek(attachment);
+				return typeof url === "string" && url !== "" ? url : null;
+			} catch {
+				return null;
+			}
+		}
+		/** Whether two per-image states are the same, so state identity can be kept. */
+		function sameImageState(left, right) {
+			return left.url === right.url && left.failed === right.failed;
+		}
+		/**
+		* The image body: one framed thumbnail per reference over the result's own
+		* envelope text.
+		*
+		* A rejected load or a missing loader leaves that image's frame as a retry
+		* control and the text in place: an image card that cannot show its picture
+		* must still show that the call returned one.
+		* @param props - see {@link ImageReadCardProps}.
+		* @returns the image card.
+		*/
+		function ImageReadCard({ t, block, material, title, inspect, openFile, loadImage }) {
+			const images = material.images;
+			const text = resultText(block);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ToolCardShell, {
+				t,
+				state: cardState(block),
+				title,
+				summary: material.label,
+				filePath: material.path,
+				openFile,
+				inspect,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "twc-media",
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "twc-imgGallery",
+						children: images.map((image, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CardImage, {
+							t,
+							image,
+							single: images.length === 1,
+							loadImage
+						}, `${image.attachmentId}:${index}`))
+					})
+				}), text !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "twc-note",
+					children: text
+				})]
+			});
+		}
+		/**
+		* One image: a framed thumbnail that opens the original.
+		*
+		* The load runs under a liveness guard and is re-armed by {@link CardImage}'s
+		* retry counter, so a failed load costs one click rather than a page reload.
+		* @param props - see {@link CardImageProps}.
+		* @returns the frame, or the retry control when the load failed.
+		*/
+		function CardImage({ t, image, single, loadImage }) {
+			const [state, setState] = (0, react.useState)(() => ({
+				url: peekUrl(loadImage, image),
+				failed: false
+			}));
+			const [attempt, setAttempt] = (0, react.useState)(0);
+			const [open, setOpen] = (0, react.useState)(false);
+			const close = (0, react.useCallback)(() => {
+				setOpen(false);
+			}, []);
+			const retry = (0, react.useCallback)(() => {
+				setAttempt((value) => value + 1);
+			}, []);
+			const frameRef = (0, react.useRef)(null);
+			const focusOpener = (0, react.useCallback)(() => {
+				frameRef.current?.focus();
+			}, []);
+			(0, react.useEffect)(() => {
+				let live = true;
+				setState((previous) => previous.failed ? {
+					url: peekUrl(loadImage, image),
+					failed: false
+				} : previous);
+				const load = async () => {
+					if (loadImage === void 0) {
+						if (live) setState((previous) => previous.failed ? previous : {
+							url: null,
+							failed: true
+						});
+						return;
+					}
+					try {
+						const url = await loadImage(image);
+						const next = typeof url === "string" && url !== "" ? {
+							url,
+							failed: false
+						} : {
+							url: null,
+							failed: true
+						};
+						if (live) setState((previous) => sameImageState(previous, next) ? previous : next);
+					} catch {
+						if (live) setState((previous) => previous.failed ? previous : {
+							url: null,
+							failed: true
+						});
+					}
+				};
+				load();
+				return () => {
+					live = false;
+				};
+			}, [
+				image,
+				loadImage,
+				attempt
+			]);
+			const variant = single ? "single" : "tile";
+			const name = image.name ?? t("image.unnamed");
+			const fit = (0, react.useMemo)(() => imageFitBox(image), [image]);
+			if (state.failed) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: "twc-imgError",
+				"data-variant": variant,
+				style: single ? {
+					width: fit.width,
+					height: fit.height
+				} : void 0,
+				title: t("image.loadFailed"),
+				"aria-label": t("image.loadFailed"),
+				onClick: retry,
+				children: t("image.loadFailed")
+			});
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				ref: frameRef,
+				type: "button",
+				className: "twc-imgFrame",
+				"data-variant": variant,
+				style: single ? {
+					width: fit.width,
+					height: fit.height
+				} : void 0,
+				title: t("image.open"),
+				"aria-label": t("image.openNamed", { name }),
+				onClick: () => {
+					if (state.url !== null) setOpen(true);
+				},
+				children: state.url === null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "twc-imgLoading",
+					children: t("image.loading")
+				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("img", {
+					className: "twc-mediaImg",
+					src: state.url,
+					alt: name,
+					style: single ? { objectPosition: fit.objectPosition } : void 0
+				})
+			}), open && state.url !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CardLightbox, {
+				t,
+				src: state.url,
+				image,
+				name,
+				onClose: close,
+				focusOpener
+			})] });
+		}
+		/**
+		* The document-level original-image preview.
+		*
+		* Closes on Escape, a mask press, or the close control, and restores focus to
+		* the opener on unmount. Rendered through a body portal: an opener inside a
+		* transformed or filtered ancestor would otherwise trap the fixed backdrop in
+		* that ancestor's box instead of covering the viewport.
+		* @param props - see {@link CardLightboxProps}.
+		* @returns the modal preview.
+		*/
+		function CardLightbox({ t, src, image, name, onClose, focusOpener }) {
+			const closeRef = (0, react.useRef)(null);
+			(0, react.useEffect)(() => {
+				closeRef.current?.focus();
+				const onKeyDown = (event) => {
+					if (event.key === "Escape") onClose();
+				};
+				window.addEventListener("keydown", onKeyDown);
+				return () => {
+					window.removeEventListener("keydown", onKeyDown);
+					focusOpener();
+				};
+			}, [onClose, focusOpener]);
+			const caption = t("image.caption", {
+				name,
+				width: image.width,
+				height: image.height,
+				size: (0, _deepseek_ai_dsh_client_ui_primitives.fileSizeText)(image.bytes)
+			});
+			return (0, react_dom.createPortal)(/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "twc-lightbox",
+				role: "dialog",
+				"aria-modal": "true",
+				"aria-label": t("image.dialog"),
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "twc-lightboxMask",
+						"aria-hidden": "true",
+						onMouseDown: (event) => {
+							event.preventDefault();
+							onClose();
+						}
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "twc-lightboxStack",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("img", {
+							className: "twc-lightboxImg",
+							src,
+							alt: name
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: "twc-lightboxCaption",
+							children: caption
+						})]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						ref: closeRef,
+						type: "button",
+						className: "twc-lightboxClose",
+						"aria-label": t("image.close"),
+						onClick: onClose,
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseOutline16, { size: 16 })
+					})
+				]
+			}), document.body);
+		}
+		//#endregion
+		//#region src/web/client/rows/SearchRow.tsx
+		/**
+		* `grep` / `glob` / `ast_grep` row: a search result card.
+		*
+		* One component serves all three keys because the Host projects one
+		* `shape`-discriminated metadata form for them: grouped matches for the two
+		* grep engines, a flat path list for glob. The title follows the call's own
+		* wire name, so the same component reads as Grep, Glob, or AST Grep.
+		* @module @xiaoso/dsh-tool-plus/web/client/rows/SearchRow
+		*/
+		/**
+		* Render a search call as a result card.
+		* @param props - the slot's owner props and this plugin's translate seat.
+		* @returns the search card, or the generic shell with the result text.
+		*/
+		function SearchRow(props) {
+			const { t, block } = props;
+			const title = cardTitle(props.toolName, t, "title.grep");
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CardBoundary, {
+				t,
+				title,
+				block,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SearchCard, {
+					...props,
+					title
+				})
+			});
+		}
+		/**
+		* The card itself, inside the boundary.
+		* @param props - row props plus the resolved title.
+		* @returns the search card.
+		*/
+		function SearchCard(props) {
+			const { t, block, inspect, title } = props;
+			const args = parseCardArgs(block);
+			const meta = narrowSearchCardMeta(cardMeta(block));
+			if (isSubCall(block) || block.isError === true || meta === null) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(GenericCard, {
+				t,
+				title,
+				block,
+				args,
+				inspect
+			});
+			const subject = argText(args, "pattern") ?? argText(args, "pat") ?? argText(args, "path");
+			const labels = searchBlockLabels(t);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
+				t,
+				state: cardState(block),
+				title,
+				summary: subject ?? argsSummary(args, t),
+				inspect,
+				children: meta.shape === "matches" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.SearchBlock, {
+					kind: "matches",
+					files: meta.files,
+					truncated: meta.truncated,
+					total: meta.total,
+					labels,
+					className: "twc-body"
+				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.SearchBlock, {
+					kind: "paths",
+					paths: meta.paths,
+					truncated: meta.truncated,
+					total: meta.total,
+					labels,
+					className: "twc-body"
+				})
+			});
+		}
+		//#endregion
+		//#region src/web/client/rows/TerminalRow.tsx
+		/**
+		* `bash` row: a terminal card for foreground runs, a generic row for jobs.
+		*
+		* The card's command comes from the arguments, its working directory from the
+		* arguments falling back to the Host projection and then the session root, and
+		* its exit status from the Host projection — the trailing `[exit code: N]`
+		* marker is only parsed to keep it out of the output pane (and to recover the
+		* signal name the projection does not carry). A call the Host handed to a
+		* background job shows the job id instead: its result is a hand-off notice,
+		* not a finished command.
+		* @module @xiaoso/dsh-tool-plus/web/client/rows/TerminalRow
+		*/
+		/**
+		* Render a `bash` call as a terminal card.
+		* @param props - the slot's owner props and this plugin's translate seat.
+		* @returns the terminal card, the job hand-off row, or the generic shell.
+		*/
+		function TerminalRow(props) {
+			const { t, block } = props;
+			const title = cardTitle(props.toolName, t, "title.bash");
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CardBoundary, {
+				t,
+				title,
+				block,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TerminalCard, {
+					...props,
+					title
+				})
+			});
+		}
+		/**
+		* The card itself, inside the boundary.
+		* @param props - row props plus the resolved title.
+		* @returns the terminal card or the generic shell.
+		*/
+		function TerminalCard(props) {
+			const { t, block, cwd: sessionCwd, home, inspect, title } = props;
+			const args = parseCardArgs(block);
+			const meta = narrowTerminalCardMeta(cardMeta(block));
+			const command = argText(args, "command");
+			const state = cardState(block);
+			if (block.isError === true || command === null) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(GenericCard, {
+				t,
+				title,
+				block,
+				args,
+				inspect
+			});
+			if (meta !== null && meta.mode === "background") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
+				t,
+				state,
+				title,
+				summary: t("bash.background", { jobId: meta.jobId }),
+				text: resultText(block),
+				inspect
+			});
+			const foreground = meta !== null && meta.mode === "foreground" ? meta : null;
+			const status = parseShellStatus(resultText(block));
+			const running = state === "running";
+			const timedOut = status.timedOut || foreground?.timedOut === true;
+			const aborted = foreground?.aborted === true;
+			const interrupted = timedOut || aborted;
+			const exitCode = running || interrupted ? void 0 : typeof foreground?.exitCode === "number" ? foreground.exitCode : typeof status.exitCode === "number" ? status.exitCode : void 0;
+			const workdir = argText(args, "workdir") ?? foreground?.workingDir ?? sessionCwd;
+			const summary = interrupted ? timedOut ? t("timedOut") : t("cancelled") : argText(args, "description") ?? firstLine(command);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
+				t,
+				state,
+				title,
+				summary,
+				inspect,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.TerminalBlock, {
+					command,
+					cwd: workdir,
+					home,
+					output: status.output,
+					exitCode,
+					signal: status.signal,
+					running,
+					labels: terminalBlockLabels(t),
+					className: "twc-body"
+				})
+			});
+		}
+		//#endregion
+		//#region src/web/client/rows/WriteRow.tsx
+		/**
+		* `write` row: a content preview card.
+		*
+		* The engine's write card is a preview of what was written, not a diff, and
+		* the content is in the arguments — so the card is complete while the call is
+		* still running, and the line count is counted on the client exactly as the
+		* engine's own header does. The language hint comes from the Host projection
+		* (`meta.lang`), which is the only part the arguments cannot supply.
+		* @module @xiaoso/dsh-tool-plus/web/client/rows/WriteRow
+		*/
+		/**
+		* Render a `write` call as a content preview.
+		* @param props - the slot's owner props and this plugin's translate seat.
+		* @returns the card, or the generic shell when the arguments are unusable.
+		*/
+		function WriteRow(props) {
+			const { t, block } = props;
+			const title = cardTitle(props.toolName, t, "title.write");
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CardBoundary, {
+				t,
+				title,
+				block,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(WriteCard, {
+					...props,
+					title
+				})
+			});
+		}
+		/**
+		* The card itself, inside the boundary.
+		* @param props - row props plus the resolved title.
+		* @returns the preview card.
+		*/
+		function WriteCard(props) {
+			const { t, block, cwd, inspect, openFile, title } = props;
+			const args = parseCardArgs(block);
+			const meta = narrowWriteCardMeta(cardMeta(block));
+			const content = argText(args, "content");
+			const path = meta?.path ?? argText(args, "path");
+			if (isSubCall(block) || block.isError === true || content === null || path === null) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(GenericCard, {
+				t,
+				title,
+				block,
+				args,
+				inspect
+			});
+			const lines = t("write.lines", { count: lineCount(content) });
+			const skip = meta?.madeExecutable === true ? ` · ${t("write.madeExecutable")}` : "";
+			const output = resultText(block);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
+				t,
+				state: cardState(block),
+				title,
+				summary: displayPath(path, cwd),
+				summarySuffix: lines + skip,
+				filePath: path,
+				openFile,
+				inspect,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "twc-body",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.CodeBlock, {
+						code: content,
+						lang: meta?.lang,
+						lineNumbers: true,
+						copyLabel: t("copy"),
+						copiedLabel: t("copied")
+					}), output !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "twc-note",
+						children: output
+					})]
+				})
+			});
+		}
+		//#endregion
+		//#region src/web/client/registerToolCards.ts
+		/** The shipped atomic tool-view slot every card registers into. */
+		const TOOLVIEW_SLOT = "tool.call.toolview";
+		/** Settings namespace of this plugin (the browser half spells the Host's). */
+		const SETTINGS_NS = "tool-plus";
+		/** Every row component this module owns, for the winner self-check. */
+		const OWN_COMPONENTS = /* @__PURE__ */ new Set([
+			WriteRow,
+			FileMutationRow,
+			AstEditRow,
+			ReadRow,
+			SearchRow,
+			TerminalRow
+		]);
+		/**
+		* Mount the tool cards.
+		*
+		* Registers the card dictionaries and one entry per tool key, then keeps the
+		* registration in step with the `webCards` switch. Everything
+		* installed here rides the caller's fiber, so plugin unload removes it all.
+		* @param ctx - the browser plugin context.
+		*/
+		function registerToolCards(ctx) {
+			ctx.effect(() => ctx.locale.register(CARD_LOCALE_NS, cardLocales), "tool-plus: card dictionaries");
+			let disposeEntries;
+			const installEntries = () => {
+				const disposers = [
+					ctx.slots.register({
+						name: TOOLVIEW_SLOT,
+						key: "write",
+						priority: CARD_TAKEOVER_PRIORITY,
+						locale: CARD_LOCALE_NS
+					}, WriteRow),
+					ctx.slots.register({
+						name: TOOLVIEW_SLOT,
+						key: "edit",
+						priority: CARD_TAKEOVER_PRIORITY,
+						locale: CARD_LOCALE_NS
+					}, FileMutationRow),
+					ctx.slots.register({
+						name: TOOLVIEW_SLOT,
+						key: "ast_edit",
+						priority: CARD_TAKEOVER_PRIORITY,
+						locale: CARD_LOCALE_NS
+					}, AstEditRow),
+					ctx.slots.register({
+						name: TOOLVIEW_SLOT,
+						key: "read",
+						priority: CARD_TAKEOVER_PRIORITY,
+						locale: CARD_LOCALE_NS
+					}, ReadRow),
+					ctx.slots.register({
+						name: TOOLVIEW_SLOT,
+						key: "grep",
+						priority: CARD_TAKEOVER_PRIORITY,
+						locale: CARD_LOCALE_NS
+					}, SearchRow),
+					ctx.slots.register({
+						name: TOOLVIEW_SLOT,
+						key: "glob",
+						priority: CARD_TAKEOVER_PRIORITY,
+						locale: CARD_LOCALE_NS
+					}, SearchRow),
+					ctx.slots.register({
+						name: TOOLVIEW_SLOT,
+						key: "ast_grep",
+						priority: CARD_TAKEOVER_PRIORITY,
+						locale: CARD_LOCALE_NS
+					}, SearchRow),
+					ctx.slots.register({
+						name: TOOLVIEW_SLOT,
+						key: "bash",
+						priority: CARD_TAKEOVER_PRIORITY,
+						locale: CARD_LOCALE_NS
+					}, TerminalRow)
+				];
+				if (!winnersAreOurs(ctx)) console.error(`[tool-plus] web tool cards did not win ${TOOLVIEW_SLOT} at priority ${String(CARD_TAKEOVER_PRIORITY)} for: ${lostCardKeys(ctx).join(", ")}. Keeping our entries; another component renders those cells.`);
+				return disposers;
+			};
+			const install = () => {
+				if (disposeEntries !== void 0) return;
+				disposeEntries = ctx.slots.inject(TOOLVIEW_SLOT, () => installEntries());
+			};
+			const uninstall = () => {
+				disposeEntries?.();
+				disposeEntries = void 0;
+			};
+			const scope = ctx.settingsScope.bind({ namespace: SETTINGS_NS });
+			ctx.effect(() => {
+				const sync = () => {
+					if (cardsEnabled(scope.getSnapshot().value)) install();
+					else uninstall();
+				};
+				const stop = scope.subscribe(sync);
+				sync();
+				return stop;
+			}, "tool-plus: web card switch");
+		}
+		/**
+		* Whether the cards should be mounted for one settings document.
+		*
+		* An absent field (first load, namespace not exposed to this client, plugin not
+		* yet described) means on: the shipped rows are the fallback, not the target.
+		* @param value - the namespace's last accepted section, when there is one.
+		* @returns `true` unless the field is explicitly `false`.
+		*/
+		function cardsEnabled(value) {
+			return value?.webCards !== false;
+		}
+		/**
+		* Read the current cell winners back and report whether every one of them is a
+		* row this module registered.
+		*
+		* Called immediately after registering, while the ledger is synchronously
+		* consistent: a cell whose winner is some other component means our entry did
+		* not take the cell — something outranks it, or a boundary retired it.
+		* @param ctx - the browser plugin context owning this registration.
+		* @returns `true` when every card key resolves to one of this module's rows.
+		*/
+		function winnersAreOurs(ctx) {
+			return lostCardKeys(ctx).length === 0;
+		}
+		/**
+		* The card keys whose current cell winner is not one of this module's rows.
+		*
+		* The takeover assumption is unverified host behaviour, so a lost cell is
+		* reported by name rather than swallowed.
+		* @param ctx - the browser plugin context owning this registration.
+		* @returns the lost keys, in contract order (empty when every cell is ours).
+		*/
+		function lostCardKeys(ctx) {
+			const winners = ctx.slots.entriesOfSlot(TOOLVIEW_SLOT);
+			const lost = [];
+			for (const key of CARD_TOOL_KEYS) {
+				const winner = winners.find((entry) => entry.options.key === key);
+				if (winner === void 0 || !OWN_COMPONENTS.has(winner.component)) lost.push(key);
+			}
+			return lost;
+		}
+		//#endregion
 		//#region src/client/index.ts
 		/**
 		* Settings namespace of this plugin, spelled here because a client package
@@ -3022,8 +5047,8 @@ window.__ModuleLoader__.load({
 		*/
 		function apply(ctx) {
 			ctx.effect(() => ctx.locale.register(BASH_PLUS_LOCALE_NS, {
-				zh,
-				en
+				zh: zh$1,
+				en: en$1
 			}), "tool-plus: card dictionaries");
 			const scope = ctx.settingsScope.bind({ namespace: BASH_PLUS_CLIENT_NS });
 			ctx.slots.inject("settings.plugin.item", () => ctx.slots.register({
@@ -3032,6 +5057,7 @@ window.__ModuleLoader__.load({
 				locale: BASH_PLUS_LOCALE_NS,
 				inject: () => ({ scope })
 			}, BashPlusCard));
+			registerToolCards(ctx);
 			const sectionScope = ctx.settingsScope.bind({ namespace: BASH_PLUS_CLIENT_NS });
 			ctx.slots.inject("settings.section", () => ctx.slots.register({
 				name: "settings.section",