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

package/lib/client.js

@@ -1720,13 +1720,13 @@ window.__ModuleLoader__.load({
 				return (c === "x" ? r : r & 3 | 8).toString(16);
 			});
 		}
-		function isRecord$3(value) {
+		function isRecord$4(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		function parseConnectionResponse(value) {
-			if (!isRecord$3(value) || value.type !== "server-response" || typeof value.rpcId !== "string") throw new TypeError("connection: invalid server-response envelope");
+			if (!isRecord$4(value) || value.type !== "server-response" || typeof value.rpcId !== "string") throw new TypeError("connection: invalid server-response envelope");
 			const result = value.result;
-			if (!isRecord$3(result)) throw new TypeError("connection: invalid server-response result");
+			if (!isRecord$4(result)) throw new TypeError("connection: invalid server-response result");
 			if (result.ok === true) return {
 				rpcId: value.rpcId,
 				result: {
@@ -1734,9 +1734,9 @@ window.__ModuleLoader__.load({
 					value: result.value
 				}
 			};
-			if (result.ok !== false || !isRecord$3(result.error)) throw new TypeError("connection: invalid server-response result");
+			if (result.ok !== false || !isRecord$4(result.error)) throw new TypeError("connection: invalid server-response result");
 			const error = result.error;
-			if (typeof error.code !== "string" || typeof error.message !== "string" || !isRecord$3(error.details)) throw new TypeError("connection: invalid server-response failure");
+			if (typeof error.code !== "string" || typeof error.message !== "string" || !isRecord$4(error.details)) throw new TypeError("connection: invalid server-response failure");
 			return {
 				rpcId: value.rpcId,
 				result: {
@@ -3085,7 +3085,7 @@ window.__ModuleLoader__.load({
 			return json === void 0 ? 0 : utf8ByteLength(json);
 		}
 		/** Whether `value` is a plain object (never an array or `null`). */
-		function isRecord$2(value) {
+		function isRecord$3(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		/** Non-blank string, or `null`. */
@@ -3110,7 +3110,7 @@ window.__ModuleLoader__.load({
 		* @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;
+			if (!isRecord$3(meta) || meta.kind !== "write") return null;
 			const path = nonBlankString(meta.path);
 			if (path === null) return null;
 			return {
@@ -3130,13 +3130,13 @@ window.__ModuleLoader__.load({
 		* @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 (!isRecord$3(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;
+				if (!isRecord$3(hunk)) return null;
 				const path = nonBlankString(hunk.path);
 				if (path === null) return null;
 				const { oldText, newText } = hunk;
@@ -3159,7 +3159,7 @@ window.__ModuleLoader__.load({
 		* @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 (!isRecord$3(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);
@@ -3167,7 +3167,7 @@ window.__ModuleLoader__.load({
 			if (!Array.isArray(meta.files)) return null;
 			const files = [];
 			for (const file of meta.files) {
-				if (!isRecord$2(file)) return null;
+				if (!isRecord$3(file)) return null;
 				const path = nonBlankString(file.path);
 				const count = nonNegativeInteger(file.count);
 				if (path === null || count === null) return null;
@@ -3195,7 +3195,7 @@ window.__ModuleLoader__.load({
 		* @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 (!isRecord$3(meta) || meta.kind !== "read") return null;
 			if (jsonByteLength(meta) > 262144) return null;
 			const path = nonBlankString(meta.path);
 			const offset = positiveInteger(meta.offset);
@@ -3205,7 +3205,7 @@ window.__ModuleLoader__.load({
 			const lines = [];
 			let previous = offset - 1;
 			for (const line of meta.lines) {
-				if (!isRecord$2(line)) return null;
+				if (!isRecord$3(line)) return null;
 				const number = positiveInteger(line.number);
 				if (number === null || number <= previous || number > totalLines) return null;
 				if (typeof line.text !== "string") return null;
@@ -3226,12 +3226,12 @@ window.__ModuleLoader__.load({
 		}
 		/** Narrow one grouped-matches file entry, or `null` when malformed. */
 		function narrowSearchFile(file) {
-			if (!isRecord$2(file)) return null;
+			if (!isRecord$3(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;
+				if (!isRecord$3(match)) return null;
 				const lineNumber = positiveInteger(match.lineNumber);
 				if (lineNumber === null || typeof match.line !== "string") return null;
 				matches.push({
@@ -3250,7 +3250,7 @@ window.__ModuleLoader__.load({
 		* @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 (!isRecord$3(meta) || meta.kind !== "search") return null;
 			if (jsonByteLength(meta) > 65536) return null;
 			if (typeof meta.truncated !== "boolean") return null;
 			const total = nonNegativeInteger(meta.total);
@@ -3291,7 +3291,7 @@ window.__ModuleLoader__.load({
 		* @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 (!isRecord$3(meta) || meta.kind !== "terminal") return null;
 			if (meta.mode === "background") {
 				const jobId = nonBlankString(meta.jobId);
 				return jobId === null ? null : {
@@ -3365,6 +3365,8 @@ window.__ModuleLoader__.load({
 				"astEdit.replacements": "{count} 处替换",
 				"astEdit.files": "{count} 个文件",
 				"astEdit.parseErrors": "解析错误",
+				"astEdit.rules": "规则",
+				"astEdit.rulesRest": "… 其余 {count} 条",
 				"read.window": "显示 {shown} / {total} 行",
 				"read.collapseAria": "收起内容",
 				"read.expandAria": "展开其余 {count} 行",
@@ -3374,6 +3376,7 @@ window.__ModuleLoader__.load({
 				"search.matches": "{shown} 处匹配 · {files} 个文件",
 				"search.matches.truncated": "显示 {shown} / 共 {total} 处匹配 · {files} 个文件",
 				"search.noResults": "无结果",
+				"search.scope": "范围 {path}",
 				"search.collapseAria": "收起结果",
 				"search.expandAria": "展开其余 {count} 行结果",
 				"search.expandRest": "… 其余 {count} 行",
@@ -3425,6 +3428,8 @@ window.__ModuleLoader__.load({
 				"astEdit.replacements": "{count} replacements",
 				"astEdit.files": "{count} files",
 				"astEdit.parseErrors": "Parse errors",
+				"astEdit.rules": "Rules",
+				"astEdit.rulesRest": "… {count} more",
 				"read.window": "Showing {shown} of {total} lines",
 				"read.collapseAria": "Collapse content",
 				"read.expandAria": "Expand {count} more lines",
@@ -3434,6 +3439,7 @@ window.__ModuleLoader__.load({
 				"search.matches": "{shown} matches · {files} files",
 				"search.matches.truncated": "Showing {shown} of {total} matches · {files} files",
 				"search.noResults": "No results",
+				"search.scope": "in {path}",
 				"search.collapseAria": "Collapse results",
 				"search.expandAria": "Expand {count} more result lines",
 				"search.expandRest": "… {count} more lines",
@@ -3483,7 +3489,7 @@ window.__ModuleLoader__.load({
 			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) {
+		function isRecord$2(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		/**
@@ -3505,7 +3511,7 @@ window.__ModuleLoader__.load({
 			let parsed = null;
 			if (typeof raw === "string") try {
 				const value = JSON.parse(raw);
-				if (isRecord$1(value)) parsed = value;
+				if (isRecord$2(value)) parsed = value;
 			} catch {
 				parsed = null;
 			}
@@ -3556,7 +3562,7 @@ window.__ModuleLoader__.load({
 			if (!isSettled(block) || !Array.isArray(block.content)) return "";
 			const parts = [];
 			for (const part of block.content) {
-				if (!isRecord$1(part)) continue;
+				if (!isRecord$2(part)) continue;
 				if (part.type === "text" && typeof part.text === "string") parts.push(part.text);
 			}
 			return parts.join("\n");
@@ -3810,9 +3816,8 @@ window.__ModuleLoader__.load({
 .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-summary{flex:0 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}
@@ -4049,6 +4054,76 @@ 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.
@@ -4100,6 +4175,7 @@ window.__ModuleLoader__.load({
 			const single = files === 1 ? meta.files[0]?.path : void 0;
 			const output = resultText(block);
 			const parseErrors = PARSE_ERROR.test(output);
+			const rule = astEditRuleLine(args, t);
 			const summary = single !== void 0 && single !== "" ? displayPath(single, cwd) : t("astEdit.files", { count: files });
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
 				t,
@@ -4112,14 +4188,21 @@ window.__ModuleLoader__.load({
 				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
-					})]
+					children: [
+						rule !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: "twc-note",
+							children: rule
+						}),
+						/* @__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
+						})
+					]
 				})
 			});
 		}
@@ -4327,6 +4410,43 @@ 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.
@@ -4404,7 +4524,7 @@ window.__ModuleLoader__.load({
 				t,
 				state: cardState(block),
 				title,
-				summary: displayPath(meta.path, cwd),
+				summary: readCardSummary(args, meta.path, cwd),
 				filePath: meta.path,
 				filePathLine: meta.offset,
 				openFile,
@@ -4655,6 +4775,45 @@ window.__ModuleLoader__.load({
 			}), document.body);
 		}
 		//#endregion
+		//#region src/web/client/rows/search-card-facts.ts
+		/** Separator between the suffix's facts; the shell adds the summary's own. */
+		const FACT_SEPARATOR = " · ";
+		/**
+		* A target may be a `;`-delimited list of paths. Shortening the whole list in
+		* one pass would cut the workspace prefix off its first entry only — the rest
+		* stay absolute, and the same scope then reads as two unrelated places — so
+		* each entry is shortened on its own and the list is rejoined.
+		* @param scope - the call's own target argument.
+		* @param cwd - the session workspace root, when known.
+		* @returns the workspace-shortened target.
+		*/
+		function displayScope(scope, cwd) {
+			if (!scope.includes(";")) return displayPath(scope, cwd);
+			return scope.split(";").map((entry) => displayPath(entry.trim(), cwd)).join("; ");
+		}
+		/**
+		* The search card's collapsed trailing fragment: the scope the call searched,
+		* then what the search found.
+		* @param args - the call's parsed arguments, or `null` when its head is gone.
+		* @param meta - the Host-projected search metadata (already narrowed).
+		* @param cwd - the session workspace root, for shortening an absolute scope.
+		* @param t - the card translate seat.
+		* @returns the joined fragment, or `null` when there is no fact to add.
+		*/
+		function searchCardSuffix(args, meta, cwd, t) {
+			const facts = [];
+			if (meta.shape === "matches") {
+				const scope = argText(args, "path");
+				if (scope !== null) facts.push(t("search.scope", { path: displayScope(scope, cwd) }));
+			}
+			if (meta.total === 0) facts.push(t("search.noResults"));
+			else if (meta.shape === "matches") {
+				const shown = meta.files.reduce((count, file) => count + file.matches.length, 0);
+				facts.push(searchBlockLabels(t).matchesSummary(shown, meta.total, meta.files.length, meta.truncated));
+			} else facts.push(searchBlockLabels(t).pathsSummary(meta.paths.length, meta.total, meta.truncated));
+			return facts.length === 0 ? null : `· ${facts.join(FACT_SEPARATOR)}`;
+		}
+		//#endregion
 		//#region src/web/client/rows/SearchRow.tsx
 		/**
 		* `grep` / `glob` / `ast_grep` row: a search result card.
@@ -4689,7 +4848,7 @@ window.__ModuleLoader__.load({
 		* @returns the search card.
 		*/
 		function SearchCard(props) {
-			const { t, block, inspect, title } = props;
+			const { t, block, cwd, 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, {
@@ -4706,6 +4865,7 @@ window.__ModuleLoader__.load({
 				state: cardState(block),
 				title,
 				summary: subject ?? argsSummary(args, t),
+				summarySuffix: searchCardSuffix(args, meta, cwd, t),
 				inspect,
 				children: meta.shape === "matches" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.SearchBlock, {
 					kind: "matches",
@@ -4790,7 +4950,7 @@ window.__ModuleLoader__.load({
 			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);
+			const summary = bashCardSummary(argText(args, "description"), command, interrupted ? timedOut ? t("timedOut") : t("cancelled") : null);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCardShell, {
 				t,
 				state,

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' | 'read.window' | 'read.collapseAria' | 'read.expandAria' | 'read.expandRest' | 'search.paths' | 'search.paths.truncated' | 'search.matches' | 'search.matches.truncated' | 'search.noResults' | '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' | '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/rows/command-card-facts.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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
+ */
+import { type CardTranslate } from '../row-utils.ts';
+/**
+ * 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.
+ */
+export declare function bashCardSummary(description: string | null, command: string, outcome: string | null): string;
+/**
+ * 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.
+ */
+export declare function astEditRuleLine(args: Record<string, unknown> | null, t: CardTranslate): string | null;

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

@@ -0,0 +1,33 @@
+/**
+ * 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.
+ */
+export declare function readCardSummary(args: Record<string, unknown> | null, metaPath: string, cwd: string | undefined): string;

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

@@ -0,0 +1,37 @@
+/**
+ * Collapsed-summary facts for the `grep` / `ast_grep` / `glob` cards.
+ *
+ * The row's summary is the search's *subject* — `pattern` for grep, `pat` for
+ * ast_grep, the path pattern for glob — so the one question the collapsed head
+ * could not answer is "which tree was searched?", and the counts sat in the
+ * folded body. That reads worst on an empty result: a bare `Grep · zzz` looks
+ * like a bad pattern rather than like a search of the wrong directory.
+ *
+ * Two facts therefore ride the head as a trailing fragment, after the summary
+ * and outside its ellipsis, because they are the parts a narrow row must never
+ * clip:
+ *  - the scope, taken from the call's own `path` argument. Only `matches`
+ *    shapes take it: a glob's `path` argument *is* its pattern, which the
+ *    summary already shows, so repeating it as a scope would claim a second
+ *    fact out of one argument. A call without `path` searched the workspace
+ *    root — naming no scope is honest, inventing one is not;
+ *  - the count, or "no results" instead of a zero count (a zero count is what
+ *    the empty-state failure reads as, not what it says).
+ *
+ * The counting labels are the {@link searchBlockLabels} adapter the block body
+ * already uses, so the head and the body say the same thing in the same words,
+ * including the "showing N of M" wording of a capped payload.
+ * @module @xiaoso/dsh-tool-plus/web/client/rows/search-card-facts
+ */
+import type { SearchCardMeta } from '../../contract.ts';
+import type { CardTranslate } from '../row-utils.ts';
+/**
+ * The search card's collapsed trailing fragment: the scope the call searched,
+ * then what the search found.
+ * @param args - the call's parsed arguments, or `null` when its head is gone.
+ * @param meta - the Host-projected search metadata (already narrowed).
+ * @param cwd - the session workspace root, for shortening an absolute scope.
+ * @param t - the card translate seat.
+ * @returns the joined fragment, or `null` when there is no fact to add.
+ */
+export declare function searchCardSuffix(args: Record<string, unknown> | null, meta: SearchCardMeta, cwd: string | undefined, t: CardTranslate): string | null;

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.2",
+  "version": "0.1.8-beta.3",
   "license": "MIT",
   "keywords": [
     "deepseek-harness",

package/presets/package.json

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