@xiaoso/dsh-tool-plus 0.1.8-beta.3 → 0.1.8-beta.4

package/lib/client.js

@@ -3349,6 +3349,7 @@ window.__ModuleLoader__.load({
 				running: "运行中",
 				done: "完成",
 				failed: "失败",
+				stopped: "已停止",
 				cancelled: "已取消",
 				timedOut: "已超时",
 				noOutput: "无输出",
@@ -3412,6 +3413,7 @@ window.__ModuleLoader__.load({
 				running: "Running",
 				done: "Done",
 				failed: "Failed",
+				stopped: "Stopped",
 				cancelled: "Cancelled",
 				timedOut: "Timed out",
 				noOutput: "No output",
@@ -3470,7 +3472,7 @@ window.__ModuleLoader__.load({
 			running: "running",
 			ok: null,
 			error: "failed",
-			warning: "failed"
+			warning: "stopped"
 		};
 		/** Parsed-argument cache: the node is immutable, so one parse serves every render. */
 		const parsedArgs = /* @__PURE__ */ new WeakMap();
@@ -3493,6 +3495,21 @@ window.__ModuleLoader__.load({
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		/**
+		* The call's original argument text.
+		*
+		* A running call carries it directly; a settled result carries the head
+		* backfilled from the in-window `tool/call`, which is absent when window
+		* truncation left that event outside. The text outlives the parse: a call whose
+		* arguments are still streaming is not valid JSON yet, and the shell states its
+		* first line rather than pretending the call said nothing.
+		* @param block - the frozen running-or-settled call node.
+		* @returns the argument text, or `''` when no head survives.
+		*/
+		function cardArgsRaw(block) {
+			const raw = callHead(block)?.argsRaw;
+			return typeof raw === "string" ? raw : "";
+		}
+		/**
 		* Parse the call's raw argument JSON.
 		*
 		* The parsed object is memoized per node (the node is immutable), so repeated
@@ -3521,30 +3538,26 @@ window.__ModuleLoader__.load({
 		/**
 		* 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.
+		* A turn stopped mid-call is projected as a settled `isError` block carrying
+		* `error.code === 'interrupted'`; the shipped row model reads that before
+		* `isError`, so a stopped call is amber and named "stopped" rather than failed.
+		* Any other 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 (isRecord$2(block.error) && block.error.code === "interrupted") return "warning";
 			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.
@@ -3788,15 +3801,339 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/web/client/rows/card-leading.ts
+		/**
+		* Wire tool name to glyph family: the shipped name table for the six keys this
+		* plugin shadows, plus its own two tools.
+		*/
+		const GLYPH_BY_TOOL = {
+			bash: "bash",
+			read: "read",
+			write: "edit",
+			edit: "edit",
+			grep: "search",
+			glob: "search",
+			ast_grep: "search",
+			ast_edit: "edit"
+		};
+		/**
+		* Glyph family a row leads with.
+		* @param toolName - the call's wire tool name, when the node carries one.
+		* @returns the family, or `others` (the shipped generic glyph) for an unknown name.
+		*/
+		function leadingGlyph(toolName) {
+			if (typeof toolName !== "string") return "others";
+			return GLYPH_BY_TOOL[toolName] ?? "others";
+		}
+		/**
+		* Whether a run state keeps the row's glyph or replaces it with a state dot.
+		* @param state - the card's run state.
+		* @returns the leading kind; `error` and `warning` are the two dot states.
+		*/
+		function leadingKind(state) {
+			switch (state) {
+				case "error": return "error";
+				case "warning": return "warning";
+				default: return "glyph";
+			}
+		}
+		//#endregion
+		//#region src/web/client/rows/command-card-facts.ts
+		/**
+		* Collapsed-fact builders for the two command-shaped cards: the command a
+		* `bash` description hides, and the rewrite rule an `ast_edit` preview only
+		* shows once expanded.
+		*
+		* Both cards collapse to one head line. `bash`'s head used to be the model's
+		* own `description` — a sentence about intent, never the command that ran — so
+		* the only way to learn what executed was to expand the card. `ast_edit`'s head
+		* names the file and the replacement count, and its body previews the *result*:
+		* the rule that produced that result lives only in the call's `ops` argument,
+		* which no card showed at all. Each builder recovers one fact from the call's
+		* own arguments, so nothing is inferred from output, and a call head that fell
+		* outside the session window degrades to the facts the card already holds.
+		* @module @xiaoso/dsh-tool-plus/web/client/rows/command-card-facts
+		*/
+		/** Whether `value` is a plain object — the only op shape the engine sends. */
+		function isRecord$1(value) {
+			return typeof value === "object" && value !== null && !Array.isArray(value);
+		}
+		/**
+		* The `bash` card's collapsed summary: what ran, placed after the sentence
+		* saying why.
+		*
+		* The command is the fact the head must carry, so the description can never be
+		* the whole summary — it is a prefix at most. Only its first line is used: a
+		* summary is one row high, and the rest of a multi-line command belongs to the
+		* expanded body, which draws the whole thing.
+		* @param description - the model's one-line intent, or `null` when absent.
+		* @param command - the command actually executed (never empty).
+		* @param outcome - the interruption word (`timedOut` / `cancelled`), or `null`.
+		* @returns the outcome alone when the run was interrupted; otherwise the
+		*   description joined to the command's first line, or that line alone.
+		*/
+		function bashCardSummary(description, command, outcome) {
+			if (outcome !== null && outcome !== "") return outcome;
+			const intent = description === null ? "" : description.trim();
+			const line = firstLine(command);
+			return intent === "" ? line : `${intent} · ${line}`;
+		}
+		/**
+		* The `ast_edit` card's rule line: the first usable `ops` entry, written the
+		* way the tool's own `ops` argument writes it (`pat → out`).
+		*
+		* Only the first rule is stated, with the count of the entries behind it: the
+		* card exists to preview one change, and a call may carry many rules whose
+		* patterns are whole AST fragments — listing them would bury the preview. The
+		* remaining count is the array tail, not the number of *usable* entries, so it
+		* always describes the call as it was made.
+		* @param args - the call's parsed arguments, or `null` when its head is gone.
+		* @param t - this plugin's card translate seat.
+		* @returns the rule line, or `null` when the call carries no usable rule.
+		*/
+		function astEditRuleLine(args, t) {
+			const ops = args?.ops;
+			if (!Array.isArray(ops)) return null;
+			for (let index = 0; index < ops.length; index += 1) {
+				const op = ops[index];
+				if (!isRecord$1(op)) continue;
+				const pat = argText(op, "pat");
+				if (pat === null) continue;
+				const replacement = op.out;
+				if (typeof replacement !== "string") continue;
+				const rest = ops.length - 1;
+				const rule = `${t("astEdit.rules")}: ${pat} →${replacement === "" ? "" : ` ${replacement}`}`;
+				return rest === 0 ? rule : `${rule} · ${t("astEdit.rulesRest", { count: rest })}`;
+			}
+			return null;
+		}
+		//#endregion
+		//#region src/web/client/rows/read-card-facts.ts
+		/**
+		* Collapsed-summary facts for the `read` card.
+		*
+		* The Host projection strips the inline selector off the path
+		* (`stripReadSelector` in `web/host/read.ts`) because the card's *link* must
+		* point at a real file, and it keeps only the file's own window. The collapsed
+		* head is then the one place where the question the model actually asked is
+		* still readable — and the projected path cannot answer it: a windowed read of
+		* `package.json:22-25,31-34` and a whole-file read of `package.json` project to
+		* the very same string, so the card hides the difference.
+		*
+		* The summary is therefore built from the call's own argument, selector and
+		* all, with the projected path kept as the fallback for a result whose call
+		* head fell outside the session window (a truncated window carries no
+		* `tool/call` event, so no argument survives). That fallback states a fact the
+		* card already holds; nothing is invented.
+		* @module @xiaoso/dsh-tool-plus/web/client/rows/read-card-facts
+		*/
+		/**
+		* The `read` card's collapsed summary: the path the model asked for, keeping
+		* whatever inline selector it carried (`:22-25`, `:raw`, `:conflicts`, `:28-`,
+		* a sqlite row, an archive member) and shortened against the workspace root.
+		*
+		* The selector is deliberately not validated against the read grammar: the head
+		* reports the call verbatim, and a selector this plugin does not recognize is
+		* still what the model typed — substituting the projection's stripped path
+		* would erase the evidence that two calls differ.
+		* @param args - the call's parsed arguments, or `null` when its head is gone.
+		* @param metaPath - the Host-projected path (already selector-free).
+		* @param cwd - the session workspace root, when known.
+		* @returns the workspace-shortened argument path, or the projected path.
+		*/
+		function readCardSummary(args, metaPath, cwd) {
+			return displayPath(argText(args, "path") ?? metaPath, cwd);
+		}
+		//#endregion
+		//#region src/web/client/rows/fallback-card-facts.ts
+		/**
+		* Collapsed-summary facts for the generic card — every row's degradation path.
+		*
+		* A call lands on the generic shell when its own card cannot be built: it is
+		* still running, its result carried no text, its metadata fell outside the
+		* session window, it is a Code Dispatch child, or the Host projected an
+		* interruption the card has no material for. In every one of those cases the
+		* call's ARGUMENTS are the only material left, and the shipped generic row
+		* answers them with the call's own fact: its variant's summary keys first, then
+		* ANY string the payload carries, then the first line of the raw argument text
+		* (`deriveSummary` in ui-tool's `tool-call-model.ts`). It never answers with an
+		* argument count.
+		*
+		* That is the rule here. The count it replaces told the reader nothing: a
+		* directory read, a `:raw` window, a running `grep` and a child call all
+		* collapsed to "1 个参数" — the one thing a degraded row must not do, since the
+		* head is then the only place the fact exists.
+		*
+		* The key preference follows THIS plugin's own tool schemas rather than the
+		* shipped `SUMMARY_KEYS`: our tools replaced the built-in ones with the OMP
+		* native parameter names (`read`/`write` take `path`, `ast_grep` takes `pat`,
+		* `ast_edit` takes `paths`), and the shipped table's `file_path` is what the
+		* built-in tools used. Both spellings are accepted, ours first, so a transcript
+		* recorded before the takeover still states its path.
+		* @module @xiaoso/dsh-tool-plus/web/client/rows/fallback-card-facts
+		*/
+		/**
+		* First entry of a path-list argument (`ast_edit.paths`), tolerating the
+		* single-string form some calls use.
+		* @param args - the call's parsed arguments, or `null`.
+		* @param name - the argument's name.
+		* @returns the first non-empty path, or `null`.
+		*/
+		function firstPath(args, name) {
+			const value = args?.[name];
+			if (typeof value === "string" && value !== "") return value;
+			if (!Array.isArray(value)) return null;
+			for (const entry of value) if (typeof entry === "string" && entry !== "") return entry;
+			return null;
+		}
+		/**
+		* The first non-empty string the payload carries under one of `keys` — the
+		* shipped row's own key-preference rule, first line only (a payload's own
+		* newlines never reach a one-line head).
+		* @param args - the call's parsed arguments, or `null`.
+		* @param keys - argument names, most significant first.
+		* @returns the value, or `null` when none of them is a non-empty string.
+		*/
+		function pickKeys(args, keys) {
+			for (const key of keys) {
+				const value = argText(args, key);
+				if (value !== null) return firstLine(value);
+			}
+			return null;
+		}
+		/**
+		* The `queries` a search call may carry, joined one query per line — the one
+		* special case the shipped row makes before its key table.
+		* @param args - the call's parsed arguments, or `null`.
+		* @returns the joined subject, or `null` when there is no usable query.
+		*/
+		function queriesSubject(args) {
+			const queries = args?.["queries"];
+			if (!Array.isArray(queries)) return null;
+			const parts = queries.filter((query) => typeof query === "string" && query !== "").map(firstLine);
+			return parts.length === 0 ? null : parts.join(", ");
+		}
+		/**
+		* The fact the call states for a key this plugin renders.
+		* @param toolName - the call's wire tool name.
+		* @param args - the call's parsed arguments, or `null`.
+		* @param cwd - the session workspace root, for shortening an absolute path.
+		* @returns the stated fact, or `null` when this key states nothing usable.
+		*/
+		function statedFact(toolName, args, cwd) {
+			switch (toolName) {
+				case "read": {
+					const asked = pickKeys(args, [
+						"path",
+						"file_path",
+						"url"
+					]);
+					return asked === null ? null : readCardSummary(args, asked, cwd);
+				}
+				case "bash": {
+					const command = argText(args, "command");
+					const description = argText(args, "description");
+					if (command === null) return description;
+					return bashCardSummary(description, command, null);
+				}
+				case "write": {
+					const path = pickKeys(args, ["path", "file_path"]);
+					return path === null ? null : displayPath(path, cwd);
+				}
+				case "edit": {
+					const path = pickKeys(args, ["file_path", "path"]);
+					return path === null ? null : displayPath(path, cwd);
+				}
+				case "ast_edit": {
+					const path = firstPath(args, "paths");
+					return path === null ? null : displayPath(path, cwd);
+				}
+				case "grep":
+				case "glob":
+				case "ast_grep": {
+					const subject = queriesSubject(args) ?? pickKeys(args, [
+						"query",
+						"pattern",
+						"pat",
+						"url",
+						"path"
+					]);
+					return subject === null ? null : displayPath(subject, cwd);
+				}
+				default: return null;
+			}
+		}
+		/**
+		* The generic card's collapsed summary: the fact the call itself states.
+		* @param toolName - the call's wire tool name (empty when truncated).
+		* @param args - the call's parsed arguments, or `null` when its head is gone.
+		* @param cwd - the session workspace root, for shortening an absolute path.
+		* @param t - the card translate seat.
+		* @param raw - the call's original argument text, for a payload that is not
+		*   valid JSON yet (a call still streaming its arguments) or whose only values
+		*   are non-strings.
+		* @returns the collapsed summary text.
+		*/
+		function fallbackCardSummary(toolName, args, cwd, t, raw = null) {
+			const stated = statedFact(toolName, args, cwd);
+			if (stated !== null) return stated;
+			if (args !== null) {
+				for (const value of Object.values(args)) if (typeof value === "string" && value !== "") return firstLine(value);
+			}
+			const text = raw === null || raw === "" ? null : firstLine(raw);
+			if (text !== null && text !== "") return text;
+			return argsSummary(args, t);
+		}
+		/**
+		* Everything from the first colon is a read selector, not part of a filename.
+		* The colon after a Windows drive letter is not one, and a URL is not a session
+		* file at all.
+		* @param value - the path argument, verbatim.
+		* @returns the file the path names, or `null` when it names no openable file.
+		*/
+		function stripSelector(value) {
+			if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(value)) return null;
+			const start = /^[a-zA-Z]:[\\/]/.test(value) ? 2 : 0;
+			const colon = value.indexOf(":", start);
+			const base = colon === -1 ? value : value.slice(0, colon);
+			return base === "" ? null : base;
+		}
+		/**
+		* The real file a degraded file-backed row may offer to open — `null` when the
+		* call names no single file.
+		*
+		* The head states the call verbatim (selector included) while the link has to
+		* name a real file: the same split the read card itself makes between its
+		* summary and its link. Whether that file then previews is the side bar's
+		* decision, never this module's.
+		* @param toolName - the call's wire tool name.
+		* @param args - the call's parsed arguments, or `null`.
+		* @returns the file to open, or `null` when there is nothing to open.
+		*/
+		function fallbackCardLink(toolName, args) {
+			switch (toolName) {
+				case "read": {
+					const asked = pickKeys(args, ["path", "file_path"]);
+					return asked === null ? null : stripSelector(asked);
+				}
+				case "write": return pickKeys(args, ["path", "file_path"]);
+				case "edit": return pickKeys(args, ["file_path", "path"]);
+				case "ast_edit": return firstPath(args, "paths");
+				default: return null;
+			}
+		}
+		//#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`
+		* (tool glyph + 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.
+		* is either the card a row built or the flattened result text. The leading
+		* glyph gives way to a state dot on a failed or interrupted call, and the row
+		* sweeps while the call runs, as the shipped row does.
 		*
 		* Two properties matter more than the visuals:
 		* - **Never throw.** Every value is coerced defensively, and {@link CardBoundary}
@@ -3808,11 +4145,45 @@ window.__ModuleLoader__.load({
 		*   both come out right.
 		* @module @xiaoso/dsh-tool-plus/web/client/ToolCardShell
 		*/
+		/** Leading glyphs (the shipped table): every glyph renders at 14 inside the 16px leading box. */
+		const LEADING_GLYPHS = {
+			bash: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconApiOutline14, { size: 14 }),
+			read: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconBrowseOutline16, { size: 14 }),
+			edit: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutline16, { size: 14 }),
+			search: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSearchOutline16, { size: 14 }),
+			others: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSparkle16, { size: 14 })
+		};
+		/**
+		* The leading mark of one row: the tool's glyph while the call is clean or
+		* running, and the state dot a failure or an interrupt swaps in — the shipped
+		* `leadingFor` rule, so a failed row gives up its identity for the state
+		* exactly where the shipped row does.
+		* @param state - the card's run state.
+		* @param toolName - the call's wire tool name, when the node carries one.
+		* @returns the node the leading box draws.
+		*/
+		function leadingFor(state, toolName) {
+			switch (leadingKind(state)) {
+				case "error": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: "error" });
+				case "warning": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: "warning" });
+				default: return LEADING_GLYPHS[leadingGlyph(toolName)];
+			}
+		}
 		/** 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}
+/* The sweep's own anchor and clip, repeated from the shipped sheet so the band
+   cannot escape the row if the shared row chrome ever drops them. */
+.twc-row{position:relative;min-width:0;overflow:hidden}
 .twc-leading{flex-shrink:0}
+/* Running sweep — the shipped row's own treatment (ui-tool/ToolRow.module.css),
+   copied band for band: a 300px glare of the theme background glides from
+   off-left to off-right, washing the glyph and the text toward the background
+   as it passes. Same anchor as the shipped sheet puts it on: DisclosureRow's
+   own row already carries the position:relative and the overflow:hidden that
+   clips the band. */
+.twc-root[data-state='running'] .twc-row::after{content:'';position:absolute;top:0;bottom:0;left:0;width:300px;background:linear-gradient(90deg,transparent 0%,color-mix(in srgb, var(--dsw-alias-bg-base) 60%, transparent) 55%,transparent 100%);animation:twc-row-sweep 2.6s ease-out infinite;pointer-events:none}
+@keyframes twc-row-sweep{0%{left:-300px}90%,100%{left:100%}}
 .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)}
@@ -3878,8 +4249,11 @@ window.__ModuleLoader__.load({
 .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}}
+/* Motion is feedback, never decoration: the running sweep is the one animation
+   this shell borrows from the shipped row, which runs it with no motion query
+   at all. A reduced-motion reader loses only the glide — the state itself is
+   still announced through the visually-hidden status word. */
+@media (prefers-reduced-motion: reduce){.twc-inspect{transition:none}.twc-root[data-state='running'] .twc-row::after{display:none}}
 `;
 		/** Inject the card stylesheet once per page; the loader drops plugin style tags on unload. */
 		let cssInjected = false;
@@ -3906,7 +4280,7 @@ window.__ModuleLoader__.load({
 		*/
 		function ToolCardShell(props) {
 			injectCss();
-			const { t, state, title, children, filePath, openFile, inspect } = props;
+			const { t, state, title, children, filePath, openFile, inspect, tool } = 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;
@@ -3937,7 +4311,7 @@ window.__ModuleLoader__.load({
 				}),
 				fileLink ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 					type: "button",
-					className: "twc-fileLink",
+					className: errorTone ? "twc-fileLink twc-errorSummary" : "twc-fileLink",
 					onClick: openPath,
 					onKeyDown: openPathKeyDown,
 					children: summaryText
@@ -3962,7 +4336,7 @@ window.__ModuleLoader__.load({
 					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) }),
+					icon: leadingFor(state, tool),
 					title,
 					open,
 					expandable,
@@ -3991,20 +4365,24 @@ window.__ModuleLoader__.load({
 		* 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.
+		* own title, run state, the fact its arguments state, and result text.
 		* @param props - see {@link GenericCardProps}.
 		* @returns the generic shell.
 		*/
-		function GenericCard({ t, title, block, args, inspect }) {
+		function GenericCard({ t, title, block, args, toolName, cwd, openFile, inspect }) {
 			const state = cardState(block);
 			const output = resultText(block);
 			const failure = state === "error" ? firstLine(output) : "";
+			const link = failure === "" ? fallbackCardLink(toolName, args) : null;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
 				t,
 				state,
 				title,
-				summary: failure === "" ? argsSummary(args, t) : failure,
+				tool: toolName,
+				summary: failure === "" ? fallbackCardSummary(toolName, args, cwd, t, cardArgsRaw(block)) : failure,
 				summaryTone: failure === "" ? "default" : "error",
+				filePath: link,
+				openFile: link === null ? void 0 : openFile,
 				text: output,
 				inspect
 			});
@@ -4054,76 +4432,6 @@ window.__ModuleLoader__.load({
 			}
 		};
 		//#endregion
-		//#region src/web/client/rows/command-card-facts.ts
-		/**
-		* Collapsed-fact builders for the two command-shaped cards: the command a
-		* `bash` description hides, and the rewrite rule an `ast_edit` preview only
-		* shows once expanded.
-		*
-		* Both cards collapse to one head line. `bash`'s head used to be the model's
-		* own `description` — a sentence about intent, never the command that ran — so
-		* the only way to learn what executed was to expand the card. `ast_edit`'s head
-		* names the file and the replacement count, and its body previews the *result*:
-		* the rule that produced that result lives only in the call's `ops` argument,
-		* which no card showed at all. Each builder recovers one fact from the call's
-		* own arguments, so nothing is inferred from output, and a call head that fell
-		* outside the session window degrades to the facts the card already holds.
-		* @module @xiaoso/dsh-tool-plus/web/client/rows/command-card-facts
-		*/
-		/** Whether `value` is a plain object — the only op shape the engine sends. */
-		function isRecord$1(value) {
-			return typeof value === "object" && value !== null && !Array.isArray(value);
-		}
-		/**
-		* The `bash` card's collapsed summary: what ran, placed after the sentence
-		* saying why.
-		*
-		* The command is the fact the head must carry, so the description can never be
-		* the whole summary — it is a prefix at most. Only its first line is used: a
-		* summary is one row high, and the rest of a multi-line command belongs to the
-		* expanded body, which draws the whole thing.
-		* @param description - the model's one-line intent, or `null` when absent.
-		* @param command - the command actually executed (never empty).
-		* @param outcome - the interruption word (`timedOut` / `cancelled`), or `null`.
-		* @returns the outcome alone when the run was interrupted; otherwise the
-		*   description joined to the command's first line, or that line alone.
-		*/
-		function bashCardSummary(description, command, outcome) {
-			if (outcome !== null && outcome !== "") return outcome;
-			const intent = description === null ? "" : description.trim();
-			const line = firstLine(command);
-			return intent === "" ? line : `${intent} · ${line}`;
-		}
-		/**
-		* The `ast_edit` card's rule line: the first usable `ops` entry, written the
-		* way the tool's own `ops` argument writes it (`pat → out`).
-		*
-		* Only the first rule is stated, with the count of the entries behind it: the
-		* card exists to preview one change, and a call may carry many rules whose
-		* patterns are whole AST fragments — listing them would bury the preview. The
-		* remaining count is the array tail, not the number of *usable* entries, so it
-		* always describes the call as it was made.
-		* @param args - the call's parsed arguments, or `null` when its head is gone.
-		* @param t - this plugin's card translate seat.
-		* @returns the rule line, or `null` when the call carries no usable rule.
-		*/
-		function astEditRuleLine(args, t) {
-			const ops = args?.ops;
-			if (!Array.isArray(ops)) return null;
-			for (let index = 0; index < ops.length; index += 1) {
-				const op = ops[index];
-				if (!isRecord$1(op)) continue;
-				const pat = argText(op, "pat");
-				if (pat === null) continue;
-				const replacement = op.out;
-				if (typeof replacement !== "string") continue;
-				const rest = ops.length - 1;
-				const rule = `${t("astEdit.rules")}: ${pat} →${replacement === "" ? "" : ` ${replacement}`}`;
-				return rest === 0 ? rule : `${rule} · ${t("astEdit.rulesRest", { count: rest })}`;
-			}
-			return null;
-		}
-		//#endregion
 		//#region src/web/client/rows/AstEditRow.tsx
 		/**
 		* `ast_edit` row: the engine's own change preview.
@@ -4161,7 +4469,7 @@ window.__ModuleLoader__.load({
 		* @returns the preview card.
 		*/
 		function AstEditCard(props) {
-			const { t, block, cwd, inspect, openFile, title } = props;
+			const { t, block, cwd, inspect, openFile, title, toolName } = 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, {
@@ -4169,6 +4477,9 @@ window.__ModuleLoader__.load({
 				title,
 				block,
 				args,
+				toolName,
+				cwd,
+				openFile,
 				inspect
 			});
 			const files = meta.files.length;
@@ -4181,6 +4492,7 @@ window.__ModuleLoader__.load({
 				t,
 				state: cardState(block),
 				title,
+				tool: toolName,
 				summary,
 				summarySuffix: `${t("astEdit.replacements", { count: meta.replacements })} · ${t("astEdit.files", { count: files })}`,
 				filePath: single,
@@ -4243,7 +4555,7 @@ window.__ModuleLoader__.load({
 		* @returns the diff card.
 		*/
 		function FileMutationCard(props) {
-			const { t, block, cwd, inspect, openFile, title } = props;
+			const { t, block, cwd, inspect, openFile, title, toolName } = props;
 			const args = parseCardArgs(block);
 			const meta = narrowEditCardMeta(cardMeta(block));
 			const replaceForm = replaceHunks(args);
@@ -4252,6 +4564,9 @@ window.__ModuleLoader__.load({
 				title,
 				block,
 				args,
+				toolName,
+				cwd,
+				openFile,
 				inspect
 			});
 			const diffs = meta === null ? replaceForm ?? [] : meta.diffs;
@@ -4263,6 +4578,7 @@ window.__ModuleLoader__.load({
 				t,
 				state: cardState(block),
 				title,
+				tool: toolName,
 				summary,
 				summarySuffix: `+${totals.added} -${totals.removed}`,
 				filePath: single,
@@ -4410,43 +4726,6 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
-		//#region src/web/client/rows/read-card-facts.ts
-		/**
-		* Collapsed-summary facts for the `read` card.
-		*
-		* The Host projection strips the inline selector off the path
-		* (`stripReadSelector` in `web/host/read.ts`) because the card's *link* must
-		* point at a real file, and it keeps only the file's own window. The collapsed
-		* head is then the one place where the question the model actually asked is
-		* still readable — and the projected path cannot answer it: a windowed read of
-		* `package.json:22-25,31-34` and a whole-file read of `package.json` project to
-		* the very same string, so the card hides the difference.
-		*
-		* The summary is therefore built from the call's own argument, selector and
-		* all, with the projected path kept as the fallback for a result whose call
-		* head fell outside the session window (a truncated window carries no
-		* `tool/call` event, so no argument survives). That fallback states a fact the
-		* card already holds; nothing is invented.
-		* @module @xiaoso/dsh-tool-plus/web/client/rows/read-card-facts
-		*/
-		/**
-		* The `read` card's collapsed summary: the path the model asked for, keeping
-		* whatever inline selector it carried (`:22-25`, `:raw`, `:conflicts`, `:28-`,
-		* a sqlite row, an archive member) and shortened against the workspace root.
-		*
-		* The selector is deliberately not validated against the read grammar: the head
-		* reports the call verbatim, and a selector this plugin does not recognize is
-		* still what the model typed — substituting the projection's stripped path
-		* would erase the evidence that two calls differ.
-		* @param args - the call's parsed arguments, or `null` when its head is gone.
-		* @param metaPath - the Host-projected path (already selector-free).
-		* @param cwd - the session workspace root, when known.
-		* @returns the workspace-shortened argument path, or the projected path.
-		*/
-		function readCardSummary(args, metaPath, cwd) {
-			return displayPath(argText(args, "path") ?? metaPath, cwd);
-		}
-		//#endregion
 		//#region src/web/client/rows/ReadRow.tsx
 		/**
 		* `read` row: a line-numbered window view, or the image the read returned.
@@ -4491,7 +4770,7 @@ window.__ModuleLoader__.load({
 		* @returns the read card.
 		*/
 		function ReadCard(props) {
-			const { t, block, cwd, inspect, openFile, title } = props;
+			const { t, block, cwd, inspect, openFile, title, toolName } = props;
 			const args = parseCardArgs(block);
 			const meta = narrowReadCardMeta(cardMeta(block));
 			const material = (0, react.useMemo)(() => imageCardMaterial(block, cwd), [block, cwd]);
@@ -4500,6 +4779,9 @@ window.__ModuleLoader__.load({
 				title,
 				block,
 				args,
+				toolName,
+				cwd,
+				openFile,
 				inspect
 			});
 			if (meta === null) {
@@ -4508,6 +4790,9 @@ window.__ModuleLoader__.load({
 					title,
 					block,
 					args,
+					toolName,
+					cwd,
+					openFile,
 					inspect
 				});
 				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ImageReadCard, {
@@ -4515,6 +4800,7 @@ window.__ModuleLoader__.load({
 					block,
 					material,
 					title,
+					toolName,
 					inspect,
 					openFile,
 					loadImage: props.loadImage
@@ -4524,6 +4810,7 @@ window.__ModuleLoader__.load({
 				t,
 				state: cardState(block),
 				title,
+				tool: toolName,
 				summary: readCardSummary(args, meta.path, cwd),
 				filePath: meta.path,
 				filePathLine: meta.offset,
@@ -4568,13 +4855,14 @@ window.__ModuleLoader__.load({
 		* @param props - see {@link ImageReadCardProps}.
 		* @returns the image card.
 		*/
-		function ImageReadCard({ t, block, material, title, inspect, openFile, loadImage }) {
+		function ImageReadCard({ t, block, material, title, toolName, inspect, openFile, loadImage }) {
 			const images = material.images;
 			const text = resultText(block);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ToolCardShell, {
 				t,
 				state: cardState(block),
 				title,
+				tool: toolName,
 				summary: material.label,
 				filePath: material.path,
 				openFile,
@@ -4848,7 +5136,7 @@ window.__ModuleLoader__.load({
 		* @returns the search card.
 		*/
 		function SearchCard(props) {
-			const { t, block, cwd, inspect, title } = props;
+			const { t, block, cwd, inspect, title, toolName } = 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, {
@@ -4856,6 +5144,8 @@ window.__ModuleLoader__.load({
 				title,
 				block,
 				args,
+				toolName,
+				cwd,
 				inspect
 			});
 			const subject = argText(args, "pattern") ?? argText(args, "pat") ?? argText(args, "path");
@@ -4864,6 +5154,7 @@ window.__ModuleLoader__.load({
 				t,
 				state: cardState(block),
 				title,
+				tool: toolName,
 				summary: subject ?? argsSummary(args, t),
 				summarySuffix: searchCardSuffix(args, meta, cwd, t),
 				inspect,
@@ -4922,7 +5213,7 @@ window.__ModuleLoader__.load({
 		* @returns the terminal card or the generic shell.
 		*/
 		function TerminalCard(props) {
-			const { t, block, cwd: sessionCwd, home, inspect, title } = props;
+			const { t, block, cwd: sessionCwd, home, inspect, title, toolName } = props;
 			const args = parseCardArgs(block);
 			const meta = narrowTerminalCardMeta(cardMeta(block));
 			const command = argText(args, "command");
@@ -4932,12 +5223,15 @@ window.__ModuleLoader__.load({
 				title,
 				block,
 				args,
+				toolName,
+				cwd: sessionCwd,
 				inspect
 			});
 			if (meta !== null && meta.mode === "background") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
 				t,
 				state,
 				title,
+				tool: toolName,
 				summary: t("bash.background", { jobId: meta.jobId }),
 				text: resultText(block),
 				inspect
@@ -4955,6 +5249,7 @@ window.__ModuleLoader__.load({
 				t,
 				state,
 				title,
+				tool: toolName,
 				summary,
 				inspect,
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.TerminalBlock, {
@@ -5006,7 +5301,7 @@ window.__ModuleLoader__.load({
 		* @returns the preview card.
 		*/
 		function WriteCard(props) {
-			const { t, block, cwd, inspect, openFile, title } = props;
+			const { t, block, cwd, inspect, openFile, title, toolName } = props;
 			const args = parseCardArgs(block);
 			const meta = narrowWriteCardMeta(cardMeta(block));
 			const content = argText(args, "content");
@@ -5016,6 +5311,9 @@ window.__ModuleLoader__.load({
 				title,
 				block,
 				args,
+				toolName,
+				cwd,
+				openFile,
 				inspect
 			});
 			const lines = t("write.lines", { count: lineCount(content) });
@@ -5025,6 +5323,7 @@ window.__ModuleLoader__.load({
 				t,
 				state: cardState(block),
 				title,
+				tool: toolName,
 				summary: displayPath(path, cwd),
 				summarySuffix: lines + skip,
 				filePath: path,

package/lib/index.mjs

@@ -3,7 +3,7 @@ __installBunShim();
 import { n as fs_promises_shim_exports, t as exists } from "./fs-promises-shim-Bx0fpxuk.mjs";
 import { i as setRuntimeLogger, n as systemChromiumCandidatesForTest, r as runtimeLogger } from "./launch-Uq7920ng.mjs";
 import { $ as isEnoent, A as formatCount, C as warn, D as installBunShim, F as $flag, N as $env, O as formatAge, P as $envpos, Q as hasFsCode, U as getAutoQaDbPath, V as VERSION, X as getRemoteDir, Y as getPuppeteerDir, at as findOnPath, b as debug, c as combineSignals, d as $which, et as isEnotdir, it as untilAborted, k as formatBytes$1, l as exec, m as readImageMetadata, nt as peekFile, q as getInstallId, tt as isProbablyBinary, u as render, x as error } from "./src-DUUqyo9y.mjs";
-import { C as truncateToWidth$1, S as replaceTabs, _ as formatCodeFrameLine, a as fetchBinary, b as LRUCache, c as getParallelExtractContent, d as convertFileWithMarkit, f as Settings, g as capParseErrors, h as OMP_DEFAULTS, i as convertWithMarkit, l as ensureTool, m as settings, o as extractWithParallel, p as isSettingsInitialized, s as findParallelApiKey, u as CONVERTIBLE_EXTENSIONS, v as formatParseErrors, x as padding, y as shortenPath } from "./utils-C-Lo_JC6.mjs";
+import { C as truncateToWidth$1, S as replaceTabs, _ as formatCodeFrameLine, a as fetchBinary, b as LRUCache, c as getParallelExtractContent, d as convertFileWithMarkit, f as Settings, g as capParseErrors, h as OMP_DEFAULTS, i as convertWithMarkit, l as ensureTool, m as settings, o as extractWithParallel, p as isSettingsInitialized, s as findParallelApiKey, u as CONVERTIBLE_EXTENSIONS, v as formatParseErrors, x as padding, y as shortenPath } from "./utils-CdKv-8uE.mjs";
 import { t as sanitizeText } from "./sanitize-text-BCf5KmCf.mjs";
 import { n as isRecord$5 } from "./type-guards-CttAANEx.mjs";
 import { n as ToolError, r as throwIfAborted, t as ToolAbortError } from "./tool-errors-DoyxivAR.mjs";
@@ -10317,7 +10317,7 @@ let specialHandlersPromise;
 * requires a special handler, so we keep them out of the cold-startup graph.
 */
 function loadSpecialHandlers() {
-	specialHandlersPromise ??= import("./scrapers-DU4u4-Co.mjs").then((m) => m.specialHandlers);
+	specialHandlersPromise ??= import("./scrapers-BWgeG8qC.mjs").then((m) => m.specialHandlers);
 	return specialHandlersPromise;
 }
 /**

package/lib/{scrapers-DU4u4-Co.mjs → scrapers-BWgeG8qC.mjs}

@@ -3,7 +3,7 @@ __installBunShim();
 import { n as fs_promises_shim_exports } from "./fs-promises-shim-Bx0fpxuk.mjs";
 import { $ as isEnoent, B as USER_AGENT, C as warn, G as getDocsRsCacheDir, N as $env, c as combineSignals, j as formatNumber, k as formatBytes, l as exec, s as Snowflake, y as parseFrontmatter } from "./src-DUUqyo9y.mjs";
 import { W as tryParseJson } from "./utils-BMmwLB0f.mjs";
-import { a as fetchBinary, c as getParallelExtractContent, i as convertWithMarkit, l as ensureTool, m as settings, n as asRecord, o as extractWithParallel, r as asString, s as findParallelApiKey, t as asNumber } from "./utils-C-Lo_JC6.mjs";
+import { a as fetchBinary, c as getParallelExtractContent, i as convertWithMarkit, l as ensureTool, m as settings, n as asRecord, o as extractWithParallel, r as asString, s as findParallelApiKey, t as asNumber } from "./utils-CdKv-8uE.mjs";
 import { n as isRecord } from "./type-guards-CttAANEx.mjs";
 import { r as throwIfAborted, t as ToolAbortError } from "./tool-errors-DoyxivAR.mjs";
 import { c as getLocalizedText, d as looksLikeHtml, i as decodeHtmlEntities, l as htmlToBasicMarkdown, o as formatIsoDate, r as buildResult, s as formatMediaDuration, u as loadPage } from "./types-DT9vgZ3S.mjs";

package/lib/types/web/client/ToolCardShell.d.ts

@@ -3,9 +3,11 @@
  *
  * 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`
+ * (tool glyph + 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.
+ * is either the card a row built or the flattened result text. The leading
+ * glyph gives way to a state dot on a failed or interrupted call, and the row
+ * sweeps while the call runs, as the shipped row does.
  *
  * Two properties matter more than the visuals:
  * - **Never throw.** Every value is coerced defensively, and {@link CardBoundary}
@@ -23,8 +25,10 @@ import { type CardBlockView, type CardOpenFileOptions, type CardState, type Card
 export interface ToolCardShellProps {
     /** Card translate seat. */
     t: CardTranslate;
-    /** Run state driving the leading dot and the status word. */
+    /** Run state driving the leading mark and the status word. */
     state: CardState;
+    /** Wire tool name selecting the leading glyph; absent/unknown = the generic glyph. */
+    tool?: string | null | undefined;
     /** Single-line title (the tool name). */
     title: string;
     /** Collapsed summary after the separator; empty renders no separator. */
@@ -64,6 +68,12 @@ export interface GenericCardProps {
     block: CardBlockView;
     /** The call's parsed arguments, when there are any. */
     args: Record<string, unknown> | null;
+    /** Wire tool name selecting the leading glyph; absent/unknown = the generic glyph. */
+    toolName?: string | null | undefined;
+    /** Session workspace root, so a stated path is shortened the rows' way. */
+    cwd?: string | undefined;
+    /** Opens the call's file in the host's viewer; absent = the path is plain text. */
+    openFile?: ((path: string, options?: CardOpenFileOptions) => void) | undefined;
     /** Jump to this call in the trajectory view. */
     inspect?: (() => void) | undefined;
 }
@@ -73,11 +83,11 @@ export interface GenericCardProps {
  * 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.
+ * own title, run state, the fact its arguments state, and result text.
  * @param props - see {@link GenericCardProps}.
  * @returns the generic shell.
  */
-export declare function GenericCard({ t, title, block, args, inspect }: GenericCardProps): import("react").JSX.Element;
+export declare function GenericCard({ t, title, block, args, toolName, cwd, openFile, inspect }: GenericCardProps): import("react").JSX.Element;
 /** Props of {@link CardBoundary}. */
 export interface CardBoundaryProps {
     /** Card translate seat, forwarded to the fallback shell. */

package/lib/types/web/client/labels.d.ts

@@ -17,7 +17,7 @@
 /** Locale namespace of the tool-card bundle (registered by `registerToolCards`). */
 export declare const CARD_LOCALE_NS = "tool-plus-cards";
 /** Every copy key of the tool-card namespace. */
-export type ToolCardLocaleKey = 'copy' | 'copied' | 'collapse' | 'expand' | 'collapseAria' | 'expandAria' | 'expandRest' | 'files.one' | 'files.other' | 'running' | 'done' | 'failed' | 'cancelled' | 'timedOut' | 'noOutput' | 'title.bash' | 'title.read' | 'title.write' | 'title.edit' | 'title.grep' | 'title.glob' | 'title.astGrep' | 'title.astEdit' | 'write.lines' | 'write.madeExecutable' | 'astEdit.replacements' | 'astEdit.files' | 'astEdit.parseErrors' | 'astEdit.rules' | 'astEdit.rulesRest' | 'read.window' | 'read.collapseAria' | 'read.expandAria' | 'read.expandRest' | 'search.paths' | 'search.paths.truncated' | 'search.matches' | 'search.matches.truncated' | 'search.noResults' | 'search.scope' | 'search.collapseAria' | 'search.expandAria' | 'search.expandRest' | 'terminal.signal' | 'terminal.exitCode' | 'terminal.running' | 'terminal.failed' | 'terminal.done' | 'terminal.noOutput' | 'bash.background' | 'image.loading' | 'image.loadFailed' | 'image.open' | 'image.openNamed' | 'image.dialog' | 'image.close' | 'image.unnamed' | 'image.caption' | 'generic.params' | 'generic.noDetail' | 'inspect';
+export type ToolCardLocaleKey = 'copy' | 'copied' | 'collapse' | 'expand' | 'collapseAria' | 'expandAria' | 'expandRest' | 'files.one' | 'files.other' | 'running' | 'done' | 'failed' | 'stopped' | 'cancelled' | 'timedOut' | 'noOutput' | 'title.bash' | 'title.read' | 'title.write' | 'title.edit' | 'title.grep' | 'title.glob' | 'title.astGrep' | 'title.astEdit' | 'write.lines' | 'write.madeExecutable' | 'astEdit.replacements' | 'astEdit.files' | 'astEdit.parseErrors' | 'astEdit.rules' | 'astEdit.rulesRest' | 'read.window' | 'read.collapseAria' | 'read.expandAria' | 'read.expandRest' | 'search.paths' | 'search.paths.truncated' | 'search.matches' | 'search.matches.truncated' | 'search.noResults' | 'search.scope' | 'search.collapseAria' | 'search.expandAria' | 'search.expandRest' | 'terminal.signal' | 'terminal.exitCode' | 'terminal.running' | 'terminal.failed' | 'terminal.done' | 'terminal.noOutput' | 'bash.background' | 'image.loading' | 'image.loadFailed' | 'image.open' | 'image.openNamed' | 'image.dialog' | 'image.close' | 'image.unnamed' | 'image.caption' | 'generic.params' | 'generic.noDetail' | 'inspect';
 /** Simplified Chinese copy (the source dictionary). */
 export declare const zh: Record<ToolCardLocaleKey, string>;
 /** English dictionary, checked complete against the zh key set. */

package/lib/types/web/client/row-utils.d.ts

@@ -14,7 +14,7 @@
  * nothing here touches a raw `meta` field directly.
  * @module @xiaoso/dsh-tool-plus/web/client/row-utils
  */
-import type { DiffBlockLabels, ReadBlockLabels, SearchBlockLabels, StateDotState, TerminalBlockLabels } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { DiffBlockLabels, ReadBlockLabels, SearchBlockLabels, TerminalBlockLabels } from '@deepseek-ai/dsh-client-ui-primitives';
 import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
 import type { CARD_LOCALE_NS, ToolCardLocaleKey } from './labels.ts';
 /** Translate seat of this plugin's card namespace. */
@@ -36,12 +36,30 @@ export interface CardBlockView {
     } | null;
     readonly content?: unknown;
     readonly isError?: unknown;
+    /**
+     * Settled failure detail. A turn stopped mid-call is projected as a settled
+     * `isError` block carrying `code: 'interrupted'`, which is a stop, not a
+     * failure — the shipped row model reads this before `isError`.
+     */
+    readonly error?: unknown;
     readonly meta?: unknown;
 }
 /** Card run state, one step off the shipped `ToolRowState` (no `stopped`). */
 export type CardState = 'running' | 'ok' | 'error' | 'warning';
 /** Whether a block is the settled half of a call pair. */
 export declare function isSettled(block: CardBlockView): boolean;
+/**
+ * The call's original argument text.
+ *
+ * A running call carries it directly; a settled result carries the head
+ * backfilled from the in-window `tool/call`, which is absent when window
+ * truncation left that event outside. The text outlives the parse: a call whose
+ * arguments are still streaming is not valid JSON yet, and the shell states its
+ * first line rather than pretending the call said nothing.
+ * @param block - the frozen running-or-settled call node.
+ * @returns the argument text, or `''` when no head survives.
+ */
+export declare function cardArgsRaw(block: CardBlockView): string;
 /**
  * Parse the call's raw argument JSON.
  *
@@ -55,17 +73,19 @@ export declare function parseCardArgs(block: CardBlockView): Record<string, unkn
 /**
  * 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.
+ * A turn stopped mid-call is projected as a settled `isError` block carrying
+ * `error.code === 'interrupted'`; the shipped row model reads that before
+ * `isError`, so a stopped call is amber and named "stopped" rather than failed.
+ * Any other 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.
  */
 export declare function cardState(block: CardBlockView): CardState;
-/** Map a card run state onto the primitive's dot semantics. */
-export declare function dotState(state: CardState): StateDotState;
 /**
  * The assistive-technology status word for a run state, or `null` when the
  * state is already carried by the row's content.

package/lib/types/web/client/rows/card-leading.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Row-leading treatment: which glyph a row leads with, and what replaces it
+ * when the call did not settle cleanly.
+ *
+ * The shipped `ToolRow` does not lead with a status dot. A clean or running row
+ * leads with its tool's own glyph, and only `error` / `stopped` swap that glyph
+ * for a `StateDot` (`ui-tool/src/client/tool/components/ToolRow.tsx::leadingFor`);
+ * the glyph per tool name comes from the shipped variant table
+ * (`ui-tool/src/client/tool/toolviews/GenericToolCard.tsx::VARIANT_ICONS`).
+ * This module is that rule and that table, kept pure so the mapping is testable
+ * under the Node runner — the component that draws it lives in
+ * `ToolCardShell`.
+ *
+ * Two of the eight card keys are this plugin's own tools, so they are absent
+ * from the shipped name table. They take the family whose shipped glyph
+ * describes the act — a structural search reads like `grep`, an atomic edit
+ * writes like `edit` — rather than the shipped `others` sparkle, which would
+ * make the two cards this plugin is the only home of look like unknown tools.
+ * @module @xiaoso/dsh-tool-plus/web/client/rows/card-leading
+ */
+import type { CardState } from '../row-utils.ts';
+/** Glyph families of the shipped leading table. */
+export type CardLeadingGlyph = 'bash' | 'read' | 'edit' | 'search' | 'others';
+/**
+ * Glyph family a row leads with.
+ * @param toolName - the call's wire tool name, when the node carries one.
+ * @returns the family, or `others` (the shipped generic glyph) for an unknown name.
+ */
+export declare function leadingGlyph(toolName: string | null | undefined): CardLeadingGlyph;
+/** What the leading box draws for one run state. */
+export type CardLeadingKind = 'glyph' | 'error' | 'warning';
+/**
+ * Whether a run state keeps the row's glyph or replaces it with a state dot.
+ * @param state - the card's run state.
+ * @returns the leading kind; `error` and `warning` are the two dot states.
+ */
+export declare function leadingKind(state: CardState): CardLeadingKind;

package/lib/types/web/client/rows/fallback-card-facts.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Collapsed-summary facts for the generic card — every row's degradation path.
+ *
+ * A call lands on the generic shell when its own card cannot be built: it is
+ * still running, its result carried no text, its metadata fell outside the
+ * session window, it is a Code Dispatch child, or the Host projected an
+ * interruption the card has no material for. In every one of those cases the
+ * call's ARGUMENTS are the only material left, and the shipped generic row
+ * answers them with the call's own fact: its variant's summary keys first, then
+ * ANY string the payload carries, then the first line of the raw argument text
+ * (`deriveSummary` in ui-tool's `tool-call-model.ts`). It never answers with an
+ * argument count.
+ *
+ * That is the rule here. The count it replaces told the reader nothing: a
+ * directory read, a `:raw` window, a running `grep` and a child call all
+ * collapsed to "1 个参数" — the one thing a degraded row must not do, since the
+ * head is then the only place the fact exists.
+ *
+ * The key preference follows THIS plugin's own tool schemas rather than the
+ * shipped `SUMMARY_KEYS`: our tools replaced the built-in ones with the OMP
+ * native parameter names (`read`/`write` take `path`, `ast_grep` takes `pat`,
+ * `ast_edit` takes `paths`), and the shipped table's `file_path` is what the
+ * built-in tools used. Both spellings are accepted, ours first, so a transcript
+ * recorded before the takeover still states its path.
+ * @module @xiaoso/dsh-tool-plus/web/client/rows/fallback-card-facts
+ */
+import { type CardTranslate } from '../row-utils.ts';
+/**
+ * The generic card's collapsed summary: the fact the call itself states.
+ * @param toolName - the call's wire tool name (empty when truncated).
+ * @param args - the call's parsed arguments, or `null` when its head is gone.
+ * @param cwd - the session workspace root, for shortening an absolute path.
+ * @param t - the card translate seat.
+ * @param raw - the call's original argument text, for a payload that is not
+ *   valid JSON yet (a call still streaming its arguments) or whose only values
+ *   are non-strings.
+ * @returns the collapsed summary text.
+ */
+export declare function fallbackCardSummary(toolName: string | null | undefined, args: Record<string, unknown> | null, cwd: string | undefined, t: CardTranslate, raw?: string | null): string;
+/**
+ * The real file a degraded file-backed row may offer to open — `null` when the
+ * call names no single file.
+ *
+ * The head states the call verbatim (selector included) while the link has to
+ * name a real file: the same split the read card itself makes between its
+ * summary and its link. Whether that file then previews is the side bar's
+ * decision, never this module's.
+ * @param toolName - the call's wire tool name.
+ * @param args - the call's parsed arguments, or `null`.
+ * @returns the file to open, or `null` when there is nothing to open.
+ */
+export declare function fallbackCardLink(toolName: string | null | undefined, args: Record<string, unknown> | null): string | null;

package/lib/{utils-C-Lo_JC6.mjs → utils-CdKv-8uE.mjs}

@@ -6267,7 +6267,7 @@ const settings = {
 };
 //#endregion
 //#region package.json
-var version = "0.1.8-beta.2";
+var version = "0.1.8-beta.4";
 /** `.tmp` files older than this are treated as orphaned writes and swept. */
 const TMP_ORPHAN_MAX_AGE_MS = 3e5;
 function markitConversionCacheKey(bytes, extension) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xiaoso/dsh-tool-plus",
   "description": "Oh My Pi bash runtime ported as a deepseek-harness tool plugin: persistent shell session, output minimizer, managed background jobs, command interception",
-  "version": "0.1.8-beta.3",
+  "version": "0.1.8-beta.4",
   "license": "MIT",
   "keywords": [
     "deepseek-harness",

package/presets/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaoso/dsh-tool-plus-presets",
-  "version": "0.1.8-beta.3",
+  "version": "0.1.8-beta.4",
   "description": "Agent-preset installer for dsh-tool-plus: installs the standard / PTC enhanced preset templates into a DeepSeek Harness home.",
   "license": "MIT",
   "keywords": [