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

package/lib/index.mjs

@@ -1,14 +1,14 @@
 import { installBunShim as __installBunShim } from "./bun-shim.mjs";
 __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-DKDH71En.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-BwW51vA5.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-ECAwvaPQ.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 { t as sanitizeText } from "./sanitize-text-BCf5KmCf.mjs";
-import { n as isRecord$2 } from "./type-guards-CttAANEx.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";
-import { a as openArchive, c as sniffArchiveFormat, d as writeArchive, i as listArchiveRoot, o as parseArchivePathCandidates, r as formatArchiveEntryLines, s as readArchiveEntries, t as archiveFormatFromPath } from "./zip-Kd602XNe.mjs";
-import { a as finalizeOutput, d as looksLikeHtml, n as MAX_OUTPUT_CHARS, t as MAX_BYTES, u as loadPage } from "./types-PVueGi9S.mjs";
+import { a as openArchive, c as sniffArchiveFormat, d as writeArchive, i as listArchiveRoot, o as parseArchivePathCandidates, r as formatArchiveEntryLines, s as readArchiveEntries, t as archiveFormatFromPath } from "./zip-CNtIFfyV.mjs";
+import { a as finalizeOutput, d as looksLikeHtml, n as MAX_OUTPUT_CHARS, t as MAX_BYTES, u as loadPage } from "./types-DT9vgZ3S.mjs";
 import * as fs from "node:fs";
 import { existsSync } from "node:fs";
 import { TOOL_ABORTED, defineTool } from "@deepseek-ai/dsh-tools";
@@ -16,7 +16,8 @@ import { HarnessError } from "@deepseek-ai/dsh-llm";
 import { DSH_ENV_PREFIX, parseExitStatus } from "@deepseek-ai/dsh-shell";
 import * as natives from "@oh-my-pi/pi-natives";
 import { EditSession, EditStore, FileType, GrepOutputMode, Shell, astEdit, astGrep, diffLines, editDescription, enclosingBlockBoundaries, glob, grep, hashlineFormatHeader, hashlineFormatNumberedLines, hashlineStripPrefixes, htmlToMarkdown, invalidateFsScanCache, listWorkspace, notebookToEditableText, structuredPatchHunks, summarizeCode } from "@oh-my-pi/pi-natives";
-import * as path from "node:path";
+import * as path$1 from "node:path";
+import path from "node:path";
 import { spawn } from "node:child_process";
 import * as os from "node:os";
 import { tmpdir } from "node:os";
@@ -482,7 +483,7 @@ function buildNonInteractiveEnv(overrides, baseEnv = process.env, platform = pro
 * shell experience.
 */
 function loadFnEnvHelper() {
-	const candidates = [path.join(fileURLToPath(new URL(".", import.meta.url)), "shell-snapshot-fn-env.sh"), path.join(path.dirname(process.execPath), "shell-snapshot-fn-env.sh")];
+	const candidates = [path$1.join(fileURLToPath(new URL(".", import.meta.url)), "shell-snapshot-fn-env.sh"), path$1.join(path$1.dirname(process.execPath), "shell-snapshot-fn-env.sh")];
 	for (const candidate of candidates) try {
 		return fs.readFileSync(candidate, "utf-8");
 	} catch {}
@@ -564,9 +565,9 @@ function sanitizeSnapshotEnv(env) {
 */
 function getShellConfigFile(shell, env) {
 	const home = env.HOME || os.homedir();
-	if (shell.includes("zsh")) return path.join(home, ".zshrc");
-	if (shell.includes("bash")) return path.join(home, ".bashrc");
-	return path.join(home, ".profile");
+	if (shell.includes("zsh")) return path$1.join(home, ".zshrc");
+	if (shell.includes("bash")) return path$1.join(home, ".bashrc");
+	return path$1.join(home, ".profile");
 }
 /**
 * Generate the snapshot creation script.
@@ -676,8 +677,8 @@ async function getOrCreateSnapshot(shell, env, timeoutMs = SNAPSHOT_TIMEOUT_MS)
 	if (cached) cachedSnapshotPaths.delete(cacheKey);
 	if (process.platform === "win32") {
 		const uid = process.getuid?.();
-		const snapshotDir = path.join(os.tmpdir(), uid === void 0 ? "omp-shell-snapshots" : `omp-shell-snapshots-${uid}`);
-		const snapshotPath = path.join(snapshotDir, `snapshot-bash-${crypto.randomUUID()}.sh`);
+		const snapshotDir = path$1.join(os.tmpdir(), uid === void 0 ? "omp-shell-snapshots" : `omp-shell-snapshots-${uid}`);
+		const snapshotPath = path$1.join(snapshotDir, `snapshot-bash-${crypto.randomUUID()}.sh`);
 		try {
 			fs.mkdirSync(snapshotDir, {
 				recursive: true,
@@ -696,9 +697,9 @@ async function getOrCreateSnapshot(shell, env, timeoutMs = SNAPSHOT_TIMEOUT_MS)
 	}
 	const rcFile = getShellConfigFile(shell, env);
 	const uid = process.getuid?.();
-	const snapshotDir = path.join(os.tmpdir(), uid === void 0 ? "omp-shell-snapshots" : `omp-shell-snapshots-${uid}`);
+	const snapshotDir = path$1.join(os.tmpdir(), uid === void 0 ? "omp-shell-snapshots" : `omp-shell-snapshots-${uid}`);
 	const shellName = shell.includes("zsh") ? "zsh" : shell.includes("bash") ? "bash" : "sh";
-	const snapshotPath = path.join(snapshotDir, `snapshot-${shellName}-${crypto.randomUUID()}.sh`);
+	const snapshotPath = path$1.join(snapshotDir, `snapshot-${shellName}-${crypto.randomUUID()}.sh`);
 	try {
 		fs.mkdirSync(snapshotDir, {
 			recursive: true,
@@ -2023,23 +2024,23 @@ var TailBuffer = class {
 */
 function resolveWindowsShell(env = process.env) {
 	const gitRoots = [
-		env.ProgramFiles && path.join(env.ProgramFiles, "Git"),
-		env["ProgramFiles(x86)"] && path.join(env["ProgramFiles(x86)"], "Git"),
-		env.LOCALAPPDATA && path.join(env.LOCALAPPDATA, "Programs", "Git"),
+		env.ProgramFiles && path$1.join(env.ProgramFiles, "Git"),
+		env["ProgramFiles(x86)"] && path$1.join(env["ProgramFiles(x86)"], "Git"),
+		env.LOCALAPPDATA && path$1.join(env.LOCALAPPDATA, "Programs", "Git"),
 		env.GIT_INSTALL_ROOT,
-		env.SCOOP && path.join(env.SCOOP, "apps", "git", "current"),
-		env.USERPROFILE && path.join(env.USERPROFILE, "scoop", "apps", "git", "current")
+		env.SCOOP && path$1.join(env.SCOOP, "apps", "git", "current"),
+		env.USERPROFILE && path$1.join(env.USERPROFILE, "scoop", "apps", "git", "current")
 	];
 	for (const root of gitRoots) {
 		if (!root) continue;
-		const candidate = path.join(root, "bin", "bash.exe");
+		const candidate = path$1.join(root, "bin", "bash.exe");
 		if (fs.existsSync(candidate)) return candidate;
 	}
 	const bashOnPath = findOnPath("bash.exe", env);
 	if (bashOnPath) return bashOnPath;
 	const shOnPath = findOnPath("sh.exe", env);
 	if (shOnPath) {
-		const siblingBash = path.join(path.dirname(shOnPath), "bash.exe");
+		const siblingBash = path$1.join(path$1.dirname(shOnPath), "bash.exe");
 		return fs.existsSync(siblingBash) ? siblingBash : shOnPath;
 	}
 	return env.ComSpec || env.COMSPEC || "C:\\Windows\\System32\\cmd.exe";
@@ -2574,7 +2575,7 @@ function buildSessionKey(shell, prefix, snapshotPath, env, agentSessionKey, mini
 */
 /** Directory holding all bash spill files. */
 function spillDir() {
-	return path.join(os.tmpdir(), "dsh-bash-spill");
+	return path$1.join(os.tmpdir(), "dsh-bash-spill");
 }
 /** Age after which a spill file is considered orphaned and swept. */
 const STALE_MS = 864e5;
@@ -2596,7 +2597,7 @@ function allocateOriginalFile() {
 function allocate(kind) {
 	try {
 		fs.mkdirSync(spillDir(), { recursive: true });
-		return path.join(spillDir(), `${kind}-${Date.now().toString(36)}-${randomBytes(4).toString("hex")}.log`);
+		return path$1.join(spillDir(), `${kind}-${Date.now().toString(36)}-${randomBytes(4).toString("hex")}.log`);
 	} catch {
 		return;
 	}
@@ -2636,11 +2637,11 @@ function sweepStaleSpillFiles(now = Date.now()) {
 		} catch {}
 	};
 	try {
-		for (const entry of fs.readdirSync(spillDir())) sweepOne(path.join(spillDir(), entry));
+		for (const entry of fs.readdirSync(spillDir())) sweepOne(path$1.join(spillDir(), entry));
 	} catch {}
 	try {
 		const tmp = os.tmpdir();
-		for (const entry of fs.readdirSync(tmp)) if (/^dsh-bash-[0-9a-f]{8}\.log$/.test(entry)) sweepOne(path.join(tmp, entry));
+		for (const entry of fs.readdirSync(tmp)) if (/^dsh-bash-[0-9a-f]{8}\.log$/.test(entry)) sweepOne(path$1.join(tmp, entry));
 	} catch {}
 	return removed;
 }
@@ -2788,7 +2789,7 @@ function startBashJob(options) {
 function expandTilde$1(filePath, home = os.homedir()) {
 	if (filePath === "~") return home;
 	if (filePath.startsWith("~/") || filePath.startsWith("~\\")) return home + filePath.slice(1);
-	if (filePath.startsWith("~")) return path.join(home, filePath.slice(1));
+	if (filePath.startsWith("~")) return path$1.join(home, filePath.slice(1));
 	return filePath;
 }
 /**
@@ -2941,7 +2942,7 @@ function fileExists(filePath) {
 function normalizeAtPrefix(filePath) {
 	if (!filePath.startsWith("@")) return filePath;
 	const withoutAt = filePath.slice(1);
-	if (withoutAt.startsWith("/") || withoutAt === "~" || withoutAt.startsWith("~/") || path.win32.isAbsolute(withoutAt) || withoutAt.startsWith("agent://") || withoutAt.startsWith("artifact://") || withoutAt.startsWith("skill://") || withoutAt.startsWith("rule://") || withoutAt.startsWith("security://") || withoutAt.startsWith("local:") || withoutAt.startsWith("mcp://")) return withoutAt;
+	if (withoutAt.startsWith("/") || withoutAt === "~" || withoutAt.startsWith("~/") || path$1.win32.isAbsolute(withoutAt) || withoutAt.startsWith("agent://") || withoutAt.startsWith("artifact://") || withoutAt.startsWith("skill://") || withoutAt.startsWith("rule://") || withoutAt.startsWith("security://") || withoutAt.startsWith("local:") || withoutAt.startsWith("mcp://")) return withoutAt;
 	return filePath;
 }
 function stripFileUrl(filePath) {
@@ -2956,7 +2957,7 @@ function expandTilde(filePath, home) {
 	const h = home ?? os.homedir();
 	if (filePath === "~") return h;
 	if (filePath.startsWith("~/") || filePath.startsWith("~\\")) return h + filePath.slice(1);
-	if (filePath.startsWith("~")) return path.join(h, filePath.slice(1));
+	if (filePath.startsWith("~")) return path$1.join(h, filePath.slice(1));
 	return filePath;
 }
 function expandPath(filePath) {
@@ -3231,17 +3232,17 @@ function resolveToCwd(filePath, cwd) {
 	const expanded = normalizeWindowsDriveAliasPath(expandPath(normalized));
 	assertNotInternalUrl(normalizeLocalScheme(expanded), normalized);
 	if (/^\/+$/.test(expanded)) return cwd;
-	if (path.isAbsolute(expanded)) return expanded;
-	return path.resolve(cwd, expanded);
+	if (path$1.isAbsolute(expanded)) return expanded;
+	return path$1.resolve(cwd, expanded);
 }
 function formatPathRelativeToCwd(filePath, cwd, options = {}) {
-	const resolvedCwd = path.resolve(cwd);
+	const resolvedCwd = path$1.resolve(cwd);
 	const normalized = normalizeLocalScheme(filePath);
 	if (isInternalUrlPath(normalized)) return normalized;
 	const expanded = expandPath(normalized);
-	const resolvedPath = path.isAbsolute(expanded) ? path.resolve(expanded) : path.resolve(cwd, expanded);
-	const relative = path.relative(resolvedCwd, resolvedPath);
-	let displayPath = normalizePosixPath(relative === "" || !relative.startsWith("..") && !path.isAbsolute(relative) ? relative || "." : resolvedPath);
+	const resolvedPath = path$1.isAbsolute(expanded) ? path$1.resolve(expanded) : path$1.resolve(cwd, expanded);
+	const relative = path$1.relative(resolvedCwd, resolvedPath);
+	let displayPath = normalizePosixPath(relative === "" || !relative.startsWith("..") && !path$1.isAbsolute(relative) ? relative || "." : resolvedPath);
 	if (options.trailingSlash && displayPath !== "." && !displayPath.endsWith("/")) displayPath += "/";
 	return displayPath;
 }
@@ -3484,16 +3485,16 @@ function buildBraceUnion(patterns) {
 }
 function findCommonBasePath(paths) {
 	if (paths.length === 0) return ".";
-	let commonParts = path.resolve(paths[0]).split(path.sep);
+	let commonParts = path$1.resolve(paths[0]).split(path$1.sep);
 	for (const candidatePath of paths.slice(1)) {
-		const candidateParts = path.resolve(candidatePath).split(path.sep);
+		const candidateParts = path$1.resolve(candidatePath).split(path$1.sep);
 		let sharedCount = 0;
 		const maxShared = Math.min(commonParts.length, candidateParts.length);
 		while (sharedCount < maxShared && commonParts[sharedCount] === candidateParts[sharedCount]) sharedCount += 1;
 		commonParts = commonParts.slice(0, sharedCount);
 	}
-	if (commonParts.length === 0) return path.parse(path.resolve(paths[0])).root;
-	return commonParts.join(path.sep) || path.parse(path.resolve(paths[0])).root;
+	if (commonParts.length === 0) return path$1.parse(path$1.resolve(paths[0])).root;
+	return commonParts.join(path$1.sep) || path$1.parse(path$1.resolve(paths[0])).root;
 }
 function toScopeDisplay(items, cwd) {
 	return items.map((item) => formatPathRelativeToCwd(item, cwd, { trailingSlash: item.endsWith("/") || item.endsWith("\\") })).join(", ");
@@ -3513,14 +3514,14 @@ async function resolveSearchPathItems(pathItems, cwd, suffixGlob, fanOutFileItem
 	const allExactFiles = !suffixGlob && parsedItems.every((item) => !item.parsedPath.glob && item.stat.isFile());
 	const commonBasePath = findCommonBasePath(parsedItems.map((item) => item.absoluteBasePath));
 	const combinedPatterns = parsedItems.map((item) => {
-		const relativeBasePath = normalizePosixPath(path.relative(commonBasePath, item.absoluteBasePath)) || ".";
+		const relativeBasePath = normalizePosixPath(path$1.relative(commonBasePath, item.absoluteBasePath)) || ".";
 		if (item.parsedPath.glob) {
 			const pathGlob = joinRelativeGlob(relativeBasePath, item.parsedPath.glob);
 			return combineSearchGlobs(pathGlob, suffixGlob) ?? pathGlob;
 		}
 		if (suffixGlob) return combineSearchGlobs(relativeBasePath === "." ? void 0 : relativeBasePath, suffixGlob) ?? suffixGlob;
 		if (item.stat.isDirectory()) return joinRelativeGlob(relativeBasePath, "**/*");
-		return relativeBasePath === "." ? path.basename(item.absoluteBasePath) : relativeBasePath;
+		return relativeBasePath === "." ? path$1.basename(item.absoluteBasePath) : relativeBasePath;
 	});
 	const commonIsRequestedScope = parsedItems.some((item) => item.absoluteBasePath === commonBasePath);
 	const demotesFileItem = fanOutFileItems && !allExactFiles && parsedItems.some((item) => !item.parsedPath.glob && item.stat.isFile());
@@ -3641,7 +3642,7 @@ async function findUniqueWorkspaceSuffix(rawPath, cwd, signal) {
 	}
 	if (matches.length !== 1) return null;
 	return {
-		absolutePath: path.resolve(cwd, matches[0]),
+		absolutePath: path$1.resolve(cwd, matches[0]),
 		displayPath: matches[0]
 	};
 }
@@ -3674,7 +3675,7 @@ async function resolveToolSearchScope(opts) {
 			const resolved = opts.resolveExternalUrl ? await opts.resolveExternalUrl(rawPath) : void 0;
 			if (resolved) {
 				resolvedPathInputs.push(resolved.sourcePath);
-				if (opts.trackImmutableSources && resolved.immutable) immutableSourcePaths.add(path.resolve(resolved.sourcePath));
+				if (opts.trackImmutableSources && resolved.immutable) immutableSourcePaths.add(path$1.resolve(resolved.sourcePath));
 				continue;
 			}
 			throw new ToolError(`Cannot ${internalUrlAction} external URL: ${rawPath}. Use \`read\` to fetch web content, then search the returned text.`);
@@ -3694,7 +3695,7 @@ async function resolveToolSearchScope(opts) {
 			pathOnly: true
 		});
 		if (!resource.sourcePath) throw new ToolError(`Cannot ${internalUrlAction} internal URL without a backing file: ${rawPath}`);
-		if (opts.trackImmutableSources && resource.immutable) immutableSourcePaths.add(path.resolve(resource.sourcePath));
+		if (opts.trackImmutableSources && resource.immutable) immutableSourcePaths.add(path$1.resolve(resource.sourcePath));
 		resolvedPathInputs.push(resource.sourcePath);
 	}
 	let missingPaths = [];
@@ -4235,6 +4236,15 @@ const TOOL_PLUS_FIELDS = [
 		group: "behavior",
 		tool: "bash"
 	},
+	{
+		name: "webCards",
+		kind: "boolean",
+		default: true,
+		labelKey: "webCards",
+		hintKey: "webCardsHint",
+		group: "behavior",
+		tool: "bash"
+	},
 	{
 		name: "autoBackgroundMs",
 		kind: "number",
@@ -4930,6 +4940,7 @@ const Config = z.object({
 	snapshotEnabled: z.boolean().default(fieldDefault("snapshotEnabled", true)),
 	rmSafe: z.boolean().default(fieldDefault("rmSafe", true)),
 	useShellCommandWrapper: z.boolean().default(fieldDefault("useShellCommandWrapper", false)),
+	webCards: z.boolean().default(fieldDefault("webCards", true)),
 	maxBackgroundJobs: z.number().default(fieldDefault("maxBackgroundJobs", 15)),
 	outputTruncateStrategy: z.union(["bytes", "lines"]).default(fieldDefault("outputTruncateStrategy", "bytes")),
 	outputTruncateTriggerBytes: z.number().default(fieldDefault("outputTruncateTriggerBytes", 10240)),
@@ -5027,6 +5038,7 @@ function resolveConfig(config) {
 		snapshotEnabled: config.snapshotEnabled ?? fieldDefault("snapshotEnabled", true),
 		rmSafe: config.rmSafe ?? fieldDefault("rmSafe", true),
 		useShellCommandWrapper: config.useShellCommandWrapper ?? fieldDefault("useShellCommandWrapper", false),
+		webCards: config.webCards ?? fieldDefault("webCards", true),
 		maxBackgroundJobs: config.maxBackgroundJobs ?? fieldDefault("maxBackgroundJobs", 15),
 		outputTruncate: {
 			strategy: config.outputTruncateStrategy ?? fieldDefault("outputTruncateStrategy", DEFAULT_OUTPUT_TRUNCATE.strategy),
@@ -5435,6 +5447,47 @@ function installBrowserProbeRpc(ctx, deps) {
 	return () => disposer?.();
 }
 //#endregion
+//#region src/web/host/bash.ts
+/** Whether `value` is a plain object (never `null` or an array). */
+function isRecord$4(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* Project a bash result value into terminal-card metadata.
+*
+* Every emitted field is a plain JSON scalar and no key is ever set to
+* `undefined`: the metadata rides `presentationMeta`, where a non-lossless
+* payload turns a successful call into a failed one. An unrecognized value
+* yields `null`, which simply leaves the row on the generic shell.
+* @param value - the tool's own output value (foreground or background arm).
+* @returns the card metadata, or `null` when the value is not a usable bash result.
+*/
+function bashCardMeta(value) {
+	if (!isRecord$4(value)) return null;
+	if (value.kind === "background") {
+		const jobId = value.jobId;
+		if (typeof jobId !== "string" || jobId.trim() === "") return null;
+		return {
+			kind: "terminal",
+			mode: "background",
+			jobId
+		};
+	}
+	if (value.kind !== "foreground") return null;
+	const { exitCode, timedOut, aborted } = value;
+	if (exitCode !== null && !(typeof exitCode === "number" && Number.isInteger(exitCode))) return null;
+	if (typeof timedOut !== "boolean" || typeof aborted !== "boolean") return null;
+	const workingDir = value.workingDir;
+	return {
+		kind: "terminal",
+		mode: "foreground",
+		exitCode,
+		timedOut,
+		aborted,
+		...typeof workingDir === "string" && workingDir !== "" ? { workingDir } : {}
+	};
+}
+//#endregion
 //#region src/config/truncate.ts
 /**
 * Config-driven output truncation for background→foreground completion text.
@@ -5811,8 +5864,8 @@ function canonicalSnapshotKey(absolutePath) {
 		return fs.realpathSync.native(absolutePath);
 	} catch {
 		try {
-			const parent = fs.realpathSync.native(path.dirname(absolutePath));
-			return path.join(parent, path.basename(absolutePath));
+			const parent = fs.realpathSync.native(path$1.dirname(absolutePath));
+			return path$1.join(parent, path$1.basename(absolutePath));
 		} catch {
 			return absolutePath;
 		}
@@ -6071,9 +6124,9 @@ function unescapeMarkerLikeLine(line) {
 	return ESCAPED_MARKER_RE.test(line) ? line.replace("# %%", "# %") : line;
 }
 function isNotebookPath(filePath) {
-	return path.extname(filePath).toLowerCase() === ".ipynb";
+	return path$1.extname(filePath).toLowerCase() === ".ipynb";
 }
-function isRecord$1(value) {
+function isRecord$3(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isCellType(value) {
@@ -6107,11 +6160,11 @@ function createEmptyNotebook() {
 	};
 }
 function validateNotebook(value, displayPath) {
-	if (!isRecord$1(value)) throw new Error(`Invalid notebook structure (expected object): ${displayPath}`);
+	if (!isRecord$3(value)) throw new Error(`Invalid notebook structure (expected object): ${displayPath}`);
 	if (!Array.isArray(value.cells)) throw new Error(`Invalid notebook structure (missing cells array): ${displayPath}`);
 	for (let index = 0; index < value.cells.length; index++) {
 		const cell = value.cells[index];
-		if (!isRecord$1(cell) || !isCellType(cell.cell_type)) throw new Error(`Invalid notebook cell ${index} in ${displayPath}`);
+		if (!isRecord$3(cell) || !isCellType(cell.cell_type)) throw new Error(`Invalid notebook cell ${index} in ${displayPath}`);
 	}
 	return value;
 }
@@ -6325,7 +6378,7 @@ async function resolveArtifactFile(url, context) {
 		}
 		const match = files.find((f) => f.startsWith(`${id}.`));
 		if (match) {
-			foundPath = path.join(dir, match);
+			foundPath = path$1.join(dir, match);
 			break;
 		}
 		for (const f of files) {
@@ -6737,7 +6790,7 @@ function renderProfileNode(node, indent, ctx) {
 function isCpuProfilePath(filePath) {
 	return /\.cpuprofile$/i.test(filePath);
 }
-function isRecord(value) {
+function isRecord$2(value) {
 	return typeof value === "object" && value !== null;
 }
 /**
@@ -6752,14 +6805,14 @@ function parseCpuProfile(text) {
 	} catch {
 		return null;
 	}
-	if (isRecord(data) && !("nodes" in data) && isRecord(data.profile)) data = data.profile;
-	if (!isRecord(data)) return null;
+	if (isRecord$2(data) && !("nodes" in data) && isRecord$2(data.profile)) data = data.profile;
+	if (!isRecord$2(data)) return null;
 	const { nodes, startTime, endTime, samples, timeDeltas } = data;
 	if (!Array.isArray(nodes) || nodes.length === 0) return null;
 	if (typeof startTime !== "number" || typeof endTime !== "number") return null;
 	for (const node of nodes) {
-		if (!isRecord(node) || typeof node.id !== "number") return null;
-		if (!isRecord(node.callFrame) || typeof node.callFrame.functionName !== "string") return null;
+		if (!isRecord$2(node) || typeof node.id !== "number") return null;
+		if (!isRecord$2(node.callFrame) || typeof node.callFrame.functionName !== "string") return null;
 	}
 	return {
 		nodes,
@@ -7361,7 +7414,7 @@ function renderSampleProfile(text) {
 * walker. Used by the read tool's directory-listing path.
 */
 async function buildDirectoryTree(cwd, options = {}) {
-	const rootPath = path.resolve(cwd);
+	const rootPath = path$1.resolve(cwd);
 	const maxDepth = options.maxDepth ?? 1;
 	const perDirLimit = options.perDirLimit === void 0 ? null : options.perDirLimit;
 	const rootLimit = options.rootLimit === void 0 ? perDirLimit : options.rootLimit;
@@ -9708,7 +9761,7 @@ function normalizeMime(contentType) {
 }
 function getFilenameExtensionHint(filename) {
 	if (filename.toLowerCase().endsWith(".tar.gz")) return ".tar.gz";
-	return path.extname(filename).toLowerCase();
+	return path$1.extname(filename).toLowerCase();
 }
 /**
 * Get extension from URL or Content-Disposition
@@ -9860,7 +9913,7 @@ function extractDocumentLinks(html, baseUrl) {
 		for (const tag of anchorTags) {
 			const href = getHtmlAttribute(tag, "href");
 			if (!href) continue;
-			const ext = path.extname(href).toLowerCase();
+			const ext = path$1.extname(href).toLowerCase();
 			if (!CONVERTIBLE_EXTENSIONS.has(ext)) continue;
 			const resolved = href.startsWith("http") ? href : new URL(href, baseUrl).href;
 			if (seen.has(resolved)) continue;
@@ -10043,7 +10096,7 @@ async function renderHtmlToText(url, html, timeout, settings, userSignal, storag
 		},
 		browser: async () => {
 			if (settings.get("browser.readerEnabled") === false) return null;
-			const { renderUrlWithBrowser } = await import("./browser-render-9o0Rknop.mjs");
+			const { renderUrlWithBrowser } = await import("./browser-render-i7uYOl4f.mjs");
 			return renderUrlWithBrowser(url, {
 				timeoutMs: remoteBudgetMs,
 				signal: userSignal
@@ -10190,8 +10243,8 @@ function buildBinaryPayloadResult(url, finalUrl, mime, method, content, fetchedA
 	};
 }
 async function withTempBinaryFile(prefix, extension, bytes, readTempFile) {
-	const tempDir = await fs_promises_shim_exports.mkdtemp(path.join(os.tmpdir(), prefix));
-	const tempPath = path.join(tempDir, `payload${extension}`);
+	const tempDir = await fs_promises_shim_exports.mkdtemp(path$1.join(os.tmpdir(), prefix));
+	const tempPath = path$1.join(tempDir, `payload${extension}`);
 	try {
 		await Bun.write(tempPath, bytes);
 		return await readTempFile(tempPath);
@@ -10264,7 +10317,7 @@ let specialHandlersPromise;
 * requires a special handler, so we keep them out of the cold-startup graph.
 */
 function loadSpecialHandlers() {
-	specialHandlersPromise ??= import("./scrapers-CtQrQ5kG.mjs").then((m) => m.specialHandlers);
+	specialHandlersPromise ??= import("./scrapers-DU4u4-Co.mjs").then((m) => m.specialHandlers);
 	return specialHandlersPromise;
 }
 /**
@@ -10409,7 +10462,7 @@ async function renderUrl(url, timeout, raw, settings, signal, storage, fetchOver
 					};
 				}
 				const imageBridge = session?.imageBridge?.();
-				const displayName = path.basename(new URL(finalUrl).pathname) || "image";
+				const displayName = path$1.basename(new URL(finalUrl).pathname) || "image";
 				let bridgeNote;
 				let committed;
 				let savedRef;
@@ -10728,7 +10781,7 @@ async function findArtifactPath(session, artifactId) {
 	if (!artifactsDir) return null;
 	try {
 		const match = (await fs_promises_shim_exports.readdir(artifactsDir)).find((file) => file.startsWith(`${artifactId}.`));
-		return match ? path.join(artifactsDir, match) : null;
+		return match ? path$1.join(artifactsDir, match) : null;
 	} catch {
 		return null;
 	}
@@ -10766,10 +10819,10 @@ function readUrlContentExtension(finalUrl) {
 async function materializeReadUrlContent(session, entry, raw) {
 	const root = session.getArtifactsDir?.();
 	if (!root) throw new ToolError("Cannot search URL output because this session cannot materialize read artifacts.");
-	const dir = path.join(root, "url-search");
+	const dir = path$1.join(root, "url-search");
 	await fs_promises_shim_exports.mkdir(dir, { recursive: true });
 	const hash = Bun.hash(`${raw ? "raw" : "rendered"}:${entry.details.finalUrl}`).toString(36);
-	const contentPath = path.join(dir, `${hash}${readUrlContentExtension(entry.details.finalUrl)}`);
+	const contentPath = path$1.join(dir, `${hash}${readUrlContentExtension(entry.details.finalUrl)}`);
 	await Bun.write(contentPath, entry.content);
 	return contentPath;
 }
@@ -11097,7 +11150,7 @@ function themeExtensionKey(filePath) {
 * Language id for syntax highlighting and UI (icons, read tool), or undefined if unknown.
 */
 function getLanguageFromPath(filePath) {
-	const baseName = path.basename(filePath).toLowerCase();
+	const baseName = path$1.basename(filePath).toLowerCase();
 	if (baseName.startsWith(".env.")) return "env";
 	if (baseName === "dockerfile" || baseName.startsWith("dockerfile.") || baseName === "containerfile") return "dockerfile";
 	if (baseName === ".emacs") return "emacs-lisp";
@@ -11115,10 +11168,10 @@ function prependLineNumbers(text, startNum) {
 	return text.split("\n").map((line, i) => `${startNum + i}|${line}`).join("\n");
 }
 function formatReadHashlineHeader(displayPath, tag) {
-	return formatHashlineHeader(path.isAbsolute(displayPath) ? shortenPath(displayPath) : displayPath, tag);
+	return formatHashlineHeader(path$1.isAbsolute(displayPath) ? shortenPath(displayPath) : displayPath, tag);
 }
 function recordFullHashlineContext(session, absolutePath, displayPath, fullText) {
-	if (!absolutePath || !path.isAbsolute(absolutePath)) return void 0;
+	if (!absolutePath || !path$1.isAbsolute(absolutePath)) return void 0;
 	const normalized = normalizeToLF(fullText);
 	const tag = getFileSnapshotStore(session).recordSnapshot(canonicalSnapshotKey(absolutePath), normalized);
 	return {
@@ -11213,7 +11266,7 @@ function lineNumbersFromSpans(spans) {
 	return lines;
 }
 function recordInMemorySeenLines(session, absolutePath, fullText, seenLines) {
-	if (!absolutePath || !path.isAbsolute(absolutePath) || !seenLines || seenLines.length === 0) return;
+	if (!absolutePath || !path$1.isAbsolute(absolutePath) || !seenLines || seenLines.length === 0) return;
 	getFileSnapshotStore(session).recordSnapshot(canonicalSnapshotKey(absolutePath), normalizeToLF(fullText), [...seenLines]);
 }
 function lineNumbersFromEntries(entries) {
@@ -11459,7 +11512,7 @@ function markMarkdownContentType(session, details, filePath) {
 }
 //#endregion
 //#region src/tools/omp/tools/read-path-resolution.ts
-const REMOTE_MOUNT_PREFIX = getRemoteDir() + path.sep;
+const REMOTE_MOUNT_PREFIX = getRemoteDir() + path$1.sep;
 function isRemoteMountPath(absolutePath) {
 	return absolutePath.startsWith(REMOTE_MOUNT_PREFIX);
 }
@@ -11789,7 +11842,7 @@ const MAX_SUMMARY_LINES = 2e4;
 * unless `read.summarize.prose` opts them in.
 */
 function isProseSummaryPath(filePath) {
-	return isMarkdownPath(filePath) || path.extname(filePath).toLowerCase() === ".txt";
+	return isMarkdownPath(filePath) || path$1.extname(filePath).toLowerCase() === ".txt";
 }
 async function trySummarize(session, absolutePath, fileSize, signal) {
 	if (fileSize > MAX_SUMMARY_BYTES) return null;
@@ -12029,7 +12082,7 @@ function openAutoQaDb() {
 	const dbPath = getAutoQaDbPath();
 	if (!dbPath) return null;
 	try {
-		fs.mkdirSync(path.dirname(dbPath), { recursive: true });
+		fs.mkdirSync(path$1.dirname(dbPath), { recursive: true });
 		const db = new Database(dbPath, { create: true });
 		db.run("PRAGMA busy_timeout = 5000");
 		db.exec(`
@@ -12741,7 +12794,7 @@ var ReadTool = class {
 			"image/jpeg",
 			"image/webp",
 			"image/gif"
-		])).has(loaded.mimeType) ? loaded.mimeType : void 0) ?? imageMediaTypeForExtension(path.extname(absolutePath));
+		])).has(loaded.mimeType) ? loaded.mimeType : void 0) ?? imageMediaTypeForExtension(path$1.extname(absolutePath));
 		if (!commitMediaType) return finish([{
 			type: "text",
 			text: formatImageUnsupportedNote(displayPath, {
@@ -12754,7 +12807,7 @@ var ReadTool = class {
 		const saved = await saveImageViaBridge(bridge, {
 			data: new Uint8Array(Buffer.from(loaded.data, "base64")),
 			mediaType: commitMediaType,
-			name: path.basename(absolutePath),
+			name: path$1.basename(absolutePath),
 			displayPath
 		});
 		const blocks = imageContentBlocks(displayPath, saved);
@@ -12774,15 +12827,15 @@ var ReadTool = class {
 	#approvedPlanAlias(missingAbsolutePath) {
 		const planReferencePath = this.session.getPlanReferencePath?.();
 		if (!planReferencePath?.startsWith("local:")) return void 0;
-		const requestedPath = path.resolve(missingAbsolutePath);
-		if (path.dirname(requestedPath) !== path.resolve(this.session.cwd)) return void 0;
+		const requestedPath = path$1.resolve(missingAbsolutePath);
+		if (path$1.dirname(requestedPath) !== path$1.resolve(this.session.cwd)) return void 0;
 		const localProtocolOptions = this.session.localProtocolOptions ?? {
 			getArtifactsDir: () => this.session.getArtifactsDir?.() ?? null,
 			getSessionId: () => this.session.getSessionId?.() ?? null
 		};
 		try {
 			const approvedPlanPath = resolveLocalUrlToPath(planReferencePath, localProtocolOptions);
-			return path.basename(requestedPath) === path.basename(approvedPlanPath) ? approvedPlanPath : void 0;
+			return path$1.basename(requestedPath) === path$1.basename(approvedPlanPath) ? approvedPlanPath : void 0;
 		} catch {
 			return;
 		}
@@ -13078,7 +13131,7 @@ var ReadTool = class {
 		if (parsed.kind === "conflicts") return this.#readFileConflicts(absolutePath, suffixResolution, signal);
 		const imageMetadata = await readImageMetadata(absolutePath);
 		const mimeType = imageMetadata?.mimeType;
-		const ext = path.extname(absolutePath).toLowerCase();
+		const ext = path$1.extname(absolutePath).toLowerCase();
 		const resolvedDisplayPath = formatPathRelativeToCwd(absolutePath, this.session.cwd);
 		const shouldConvertWithMarkit = CONVERTIBLE_EXTENSIONS.has(ext);
 		if (!mimeType && !isRawSelector(parsed) && fileSize <= MAX_PROFILE_SUMMARY_BYTES) {
@@ -13718,6 +13771,253 @@ var ReadTool = class {
 	}
 };
 //#endregion
+//#region src/web/contract.ts
+/**
+* Cap on the serialized `edit` metadata. The engine's unified diff is already
+* bounded per file but unbounded across files; past this budget whole trailing
+* files are dropped, and once nothing is left the call falls back to the
+* generic shell rather than writing an oversized session entry.
+*/
+const EDIT_META_MAX_BYTES = 131072;
+/** Cap on the `ast_edit` change preview (the engine's own display text). */
+const AST_EDIT_META_MAX_BYTES = 65536;
+/** Cap on the serialized `read` metadata (the returned window's lines). */
+const READ_META_MAX_BYTES = 262144;
+/**
+* Cap on the serialized search metadata. Same value and meaning as the shipped
+* search card's own `searchMetaMaxBytes`.
+*/
+const SEARCH_META_MAX_BYTES = 65536;
+/** 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);
+}
+/**
+* Longest prefix of `text` that fits in `cap` UTF-8 bytes, never splitting a
+* surrogate pair.
+* @param text - the text to bound.
+* @param cap - the byte budget.
+* @returns `text` when it already fits, otherwise its longest fitting prefix.
+*/
+function capText(text, cap) {
+	if (utf8ByteLength(text) <= cap) return text;
+	let low = 0;
+	let high = text.length;
+	while (low < high) {
+		const mid = Math.ceil((low + high) / 2);
+		if (utf8ByteLength(text.slice(0, mid)) <= cap) low = mid;
+		else high = mid - 1;
+	}
+	if (low > 0 && low < text.length) {
+		const code = text.charCodeAt(low - 1);
+		if (code >= 55296 && code <= 56319) low -= 1;
+	}
+	return text.slice(0, low);
+}
+/**
+* Drop entries from the tail until the payload `wrap(retained)` serializes
+* within `cap`.
+*
+* `wrap` receives the retained slice only, so the caller measures the real
+* payload — including its fixed fields — and a single oversized entry ends as
+* an empty list rather than an oversized one.
+* @param items - the ordered entries to bound.
+* @param cap - byte budget for `wrap`'s result.
+* @param wrap - builds the payload that would be emitted for a retained slice.
+* @returns the retained head, in input order.
+*/
+function capTail(items, cap, wrap) {
+	const retained = [...items];
+	while (retained.length > 0 && jsonByteLength(wrap(retained)) > cap) retained.pop();
+	return retained;
+}
+//#endregion
+//#region src/web/host/read.ts
+/**
+* Host projection for the `read` card: the OMP engine already hands the renderer
+* a prefix-free window (`details.displayContent` —
+* `{text, startLine, lineNumbers?}`) exactly so the UI can draw its own gutter,
+* and that is what the shipped read card consumes
+* (`{kind:'read', path, offset, lines, totalLines, lang?}`).
+*
+* Three details drive the projection:
+*  - the card path must be the file, never the model-facing argument: the OMP
+*    argument carries an inline selector (`src/foo.ts:5-16,40-80`, `:raw`), so
+*    the selector is stripped from whatever path source wins;
+*  - `lineNumbers[i] === null` marks an elided span (the body renders `…`); such
+*    entries carry no file line number and must be dropped, or the card's
+*    "strictly increasing" rule breaks;
+*  - only local, text-like reads take the card. Images, directories, internal
+*    URLs (`skill://`, `conflict://N`, …), web URLs, SQLite, archives and
+*    converted documents all fall back to the generic shell.
+*
+* The projection is bounded: past {@link READ_META_MAX_BYTES} whole trailing
+* lines are dropped, and an empty window projects to `null` rather than to an
+* empty card.
+*
+* @module @xiaoso/dsh-tool-plus/web/host/read
+*/
+/** `scheme://` — `file://` is still a local read; every other scheme is not. */
+const SCHEME_RE = /^([a-z][a-z0-9+.-]*):\/\//i;
+/**
+* Extensions whose reads are never a plain line window: SQLite and archive
+* readers (`omp/tools/sqlite-reader.ts`, `read/adapter/omp/tools/read-archive.ts`)
+* and markit document conversions (`omp/utils/markit.ts` CONVERTIBLE_EXTENSIONS)
+* all render their own body, so a line-numbered card would misrepresent them.
+*/
+const NON_TEXT_EXTENSIONS = /* @__PURE__ */ new Set([
+	".sqlite",
+	".sqlite3",
+	".db",
+	".db3",
+	".zip",
+	".jar",
+	".war",
+	".ear",
+	".apk",
+	".tar",
+	".tgz",
+	".pdf",
+	".docx",
+	".pptx",
+	".xlsx",
+	".epub"
+]);
+/** Whether `value` is a plain object (never `null` or an array). */
+function isRecord$1(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** A positive integer, or `undefined`. */
+function positiveInteger(value) {
+	return typeof value === "number" && Number.isInteger(value) && value >= 1 ? value : void 0;
+}
+/** Non-blank string, or `undefined`. */
+function nonBlankString$2(value) {
+	return typeof value === "string" && value.trim() !== "" ? value : void 0;
+}
+/** Whether the colon at `index` separates a Windows drive letter from its path. */
+function isDriveColon(target, index) {
+	if (index < 1 || !/[a-zA-Z]/.test(target[index - 1] ?? "")) return false;
+	const next = target[index + 1];
+	if (next !== "/" && next !== "\\") return false;
+	const before = index >= 2 ? target[index - 2] : void 0;
+	return before === void 0 || before === "/" || before === "\\";
+}
+/**
+* Strip the model-facing inline selector from a read target, leaving the file
+* path the card should show.
+*
+* Handles `:5-16,40-80`, `:raw`, `:50+150`, `:conflicts` and the SQLite/archive
+* sub-selectors (`db.sqlite:table:key`), plus the `file://` form the engine
+* itself expands. Windows drive letters survive.
+* @param target - the raw read target (`args.path`, or a resolved path).
+* @returns the path without its selector.
+*/
+function stripReadSelector(target) {
+	let value = target.trim();
+	if (/^file:\/\//i.test(value)) value = value.slice(7);
+	let end = value.length;
+	for (let index = 0; index < value.length; index += 1) {
+		if (value[index] !== ":") continue;
+		if (value[index + 1] === "/" && value[index + 2] === "/") continue;
+		if (isDriveColon(value, index)) continue;
+		end = index;
+		break;
+	}
+	let base = value.slice(0, end);
+	if (/^\/[a-zA-Z]:[\\/]/.test(base)) base = base.slice(1);
+	return base;
+}
+/** Whether the target names something other than a local file path. */
+function isNonLocalTarget(target) {
+	const scheme = SCHEME_RE.exec(target.trim());
+	return scheme !== null && scheme[1].toLowerCase() !== "file";
+}
+/** Whether the path is one of the non-text extension families above. */
+function hasNonTextExtension(target) {
+	const lower = target.toLowerCase();
+	if (/\.tar\.gz$/.test(lower)) return true;
+	return NON_TEXT_EXTENSIONS.has(path$1.extname(lower));
+}
+/** Read the display window into strictly increasing, numbered lines. */
+function readWindowLines(text, startLine, rawNumbers) {
+	if (text === "") return [];
+	const textLines = text.split("\n");
+	const numbers = Array.isArray(rawNumbers) ? rawNumbers : void 0;
+	const lines = [];
+	for (let index = 0; index < textLines.length; index += 1) {
+		const number = numbers === void 0 ? startLine + index : positiveInteger(numbers[index]);
+		if (number === void 0) continue;
+		if (lines.length > 0 && number <= lines[lines.length - 1].number) continue;
+		lines.push({
+			number,
+			text: textLines[index] ?? ""
+		});
+	}
+	return lines;
+}
+/**
+* Project a read result value into read-card metadata.
+*
+* Every emitted field is plain JSON and no key is ever `undefined`: the metadata
+* rides `presentationMeta`, where a non-lossless payload turns a successful call
+* into a failed one. A non-text read, or a window without a single numbered
+* line, yields `null` and leaves the row on the generic shell.
+* @param args - the tool's arguments (only `path` is read).
+* @param value - the tool's output value, as the adapter projects it.
+* @returns the card metadata, or `null` when this read does not take the card.
+*/
+function readCardMeta(args, value) {
+	if (!isRecord$1(value)) return null;
+	if (value.image !== void 0 && value.image !== null) return null;
+	if (value.isDirectory === true) return null;
+	if (value.textBlocks !== void 0 && value.textBlocks !== 1) return null;
+	const source = isRecord$1(value.source) ? value.source : void 0;
+	if (source !== void 0 && (source.type === "url" || source.type === "internal")) return null;
+	const requested = isRecord$1(args) ? nonBlankString$2(args.path) : void 0;
+	if (requested !== void 0 && isNonLocalTarget(requested)) return null;
+	const sourcePath = source !== void 0 && source.type === "path" ? nonBlankString$2(source.value) : void 0;
+	const resolved = nonBlankString$2(value.path);
+	const raw = sourcePath ?? resolved ?? requested;
+	if (raw === void 0) return null;
+	const target = stripReadSelector(raw);
+	if (target === "" || isNonLocalTarget(target) || hasNonTextExtension(target)) return null;
+	const display = isRecord$1(value.display) ? value.display : void 0;
+	const startLine = display === void 0 ? void 0 : positiveInteger(display.startLine);
+	if (display === void 0 || typeof display.text !== "string" || startLine === void 0) return null;
+	const lines = readWindowLines(display.text, startLine, display.lineNumbers);
+	if (lines.length === 0) return null;
+	const declaredTotal = positiveInteger(value.totalLines);
+	const lastLine = lines[lines.length - 1].number;
+	const totalLines = declaredTotal !== void 0 && declaredTotal >= lastLine ? declaredTotal : lastLine;
+	const language = getLanguageFromPath(target);
+	const build = (kept) => ({
+		kind: "read",
+		path: target,
+		offset: kept[0]?.number ?? lines[0].number,
+		lines: [...kept],
+		totalLines,
+		...language === void 0 || language === "" ? {} : { lang: language }
+	});
+	const retained = capTail(lines, READ_META_MAX_BYTES, build);
+	return retained.length === 0 ? null : build(retained);
+}
+//#endregion
 //#region src/tools/read/adapter/index.ts
 /** Build the OMP ToolSession facade over a DSH exec context + tool-plus config. */
 function createToolSession$6(exec, cfg, ctx) {
@@ -13773,13 +14073,34 @@ function toReadToolResult(result, args) {
 	const text = toText$6(result);
 	const details = result.details ?? {};
 	const notice = formatOutputNotice(details.meta);
+	const source = details.meta?.source;
+	const display = asDisplayContent(details.displayContent);
 	return {
 		path: String(details.resolvedPath ?? args.path ?? ""),
 		text,
+		textBlocks: result.content.filter((block) => block.type === "text").length,
 		...notice ? { notice } : {},
 		...typeof details.totalLines === "number" ? { totalLines: details.totalLines } : {},
 		...typeof details.truncation !== "undefined" ? { truncated: true } : {},
-		...details.image !== void 0 && typeof details.image === "object" ? { image: details.image } : {}
+		...details.image !== void 0 && typeof details.image === "object" ? { image: details.image } : {},
+		...display === void 0 ? {} : { display },
+		...source === void 0 ? {} : { source: {
+			type: String(source.type),
+			value: String(source.value)
+		} },
+		...details.isDirectory === true ? { isDirectory: true } : {}
+	};
+}
+/** 校验并逐字带出引擎的 displayContent（形状不对就当没有，降级走通用行）。 */
+function asDisplayContent(raw) {
+	if (raw === null || typeof raw !== "object") return void 0;
+	const display = raw;
+	if (typeof display.text !== "string" || typeof display.startLine !== "number") return void 0;
+	const lineNumbers = Array.isArray(display.lineNumbers) ? display.lineNumbers : void 0;
+	return {
+		text: display.text,
+		startLine: display.startLine,
+		...lineNumbers === void 0 ? {} : { lineNumbers }
 	};
 }
 /** render：模型可见文本 = 工具文本 + session 层提示（OMP messages.ts 语义）。 */
@@ -13826,6 +14147,40 @@ function registerRead(ctx, getConfig) {
 					truncated: { type: "boolean" },
 					totalLines: { type: "number" },
 					offset: { type: "number" },
+					display: {
+						type: "object",
+						additionalProperties: false,
+						properties: {
+							text: {
+								type: "string",
+								required: true
+							},
+							startLine: {
+								type: "integer",
+								required: true
+							},
+							lineNumbers: {
+								type: "array",
+								items: { oneOf: [{ type: "integer" }, { type: "null" }] }
+							}
+						}
+					},
+					source: {
+						type: "object",
+						additionalProperties: false,
+						properties: {
+							type: {
+								type: "string",
+								required: true
+							},
+							value: {
+								type: "string",
+								required: true
+							}
+						}
+					},
+					isDirectory: { type: "boolean" },
+					textBlocks: { type: "integer" },
 					image: {
 						type: "object",
 						additionalProperties: false,
@@ -13889,11 +14244,7 @@ function registerRead(ctx, getConfig) {
 				});
 				return blocks;
 			},
-			presentationMeta: (_args, value) => ({
-				...value.path !== void 0 ? { path: value.path } : {},
-				...value.offset !== void 0 ? { offset: value.offset } : {},
-				...value.totalLines !== void 0 ? { lines: value.totalLines } : {}
-			})
+			presentationMeta: (args, value) => readCardMeta(args, value) ?? null
 		},
 		async execute(args, exec) {
 			return executeReadTool(exec, getConfig(), args, ctx);
@@ -13911,6 +14262,61 @@ function registerRead(ctx, getConfig) {
 	}));
 }
 //#endregion
+//#region src/web/host/write.ts
+/**
+* `write` tool card: project the engine's result into the `{kind:'write'}` meta
+* this plugin's browser half consumes (plan §4.1).
+*
+* The card is a **content preview** (matching the OMP card the model already
+* sees), so metadata carries only the target path plus an optional grammar
+* hint — never a diff, never a `before` read, never `±` counts. Both fields are
+* pure computation over data the adapter already holds: `lang` comes from the
+* shared `getLanguageFromPath` table, and no I/O happens here.
+*
+* Zero-dependency by design, like the contract it fills in: the Node half
+* imports it from `presentationMeta`, the browser half never does.
+*
+* Defensive: a card never throws and never emits `undefined` values (the host
+* rejects non-lossless metadata and turns a successful call into an error), so
+* an unusable path projects to `null` and the row falls back to the generic
+* shell.
+*
+* @module @xiaoso/dsh-tool-plus/web/host/write
+*/
+/** `value` as a plain record, or `null` (arrays, `null` and primitives drop). */
+function asRecord$2(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+/** First non-blank string among `values`, or `null`. */
+function firstNonBlank(...values) {
+	for (const value of values) if (typeof value === "string" && value.trim() !== "") return value;
+	return null;
+}
+/**
+* Project the write tool's result (and its call arguments) into card metadata.
+*
+* The path is the engine's resolved target when it has one, falling back to the
+* authored `args.path` (matching the value the adapter already emits). A blank
+* or missing path projects to `null`; an unrecognized extension omits `lang`
+* instead of writing `undefined`.
+* @param details - the engine's `resolvedPath` / the adapter's value (`path`).
+* @param args - the tool call arguments (`path`), used only as a fallback.
+* @returns the write card metadata, or `null` when no usable path is present.
+*/
+function projectWriteCardMeta(details, args) {
+	const result = asRecord$2(details);
+	const parameters = asRecord$2(args);
+	const path = firstNonBlank(result?.resolvedPath, result?.path, parameters?.path);
+	if (path === null) return null;
+	const language = getLanguageFromPath(path);
+	return {
+		kind: "write",
+		path,
+		...language !== void 0 && language !== "" ? { lang: language } : {},
+		...result?.madeExecutable === true ? { madeExecutable: true } : {}
+	};
+}
+//#endregion
 //#region src/tools/omp/tools/writethrough.ts
 /** Write `content` to `dst` (or the passed file handle) — no LSP pass. */
 async function writethroughNoop(dst, content, _signal, file) {
@@ -14045,10 +14451,10 @@ function stripBom(content) {
 }
 function getCommentStylesForPath(filePath) {
 	const normalizedPath = filePath.toLowerCase();
-	const fileName = path.basename(normalizedPath);
+	const fileName = path$1.basename(normalizedPath);
 	const stylesByName = COMMENT_STYLES_BY_BASENAME.get(fileName);
 	if (stylesByName) return stylesByName;
-	const ext = path.extname(fileName);
+	const ext = path$1.extname(fileName);
 	return COMMENT_STYLES_BY_EXTENSION.get(ext) ?? [];
 }
 function extractLeadingHeaderCommentText(content, commentStyles) {
@@ -14232,7 +14638,7 @@ function planLocalProtocolOptions(session) {
 *  Returns `null` when the session has no artifact wiring (e.g. tests). */
 function localSandboxRoot(session) {
 	try {
-		return path.resolve(resolveLocalRoot(planLocalProtocolOptions(session)));
+		return path$1.resolve(resolveLocalRoot(planLocalProtocolOptions(session)));
 	} catch {
 		return null;
 	}
@@ -14240,7 +14646,7 @@ function localSandboxRoot(session) {
 /** True when `absolutePath` resolves inside `root` (== root or under it). */
 function isWithinRoot(absolutePath, root) {
 	if (absolutePath === root) return true;
-	const sep = `${root}${path.sep}`;
+	const sep = `${root}${path$1.sep}`;
 	return absolutePath.startsWith(sep);
 }
 /** Strip the hashline `[path#TAG]` wrapper from a write/edit target so the inner
@@ -14273,14 +14679,14 @@ function targetsLocalSandbox(session, targetPath) {
 	} catch {
 		return false;
 	}
-	if (!path.isAbsolute(resolved)) return false;
-	const absolute = path.resolve(resolved);
+	if (!path$1.isAbsolute(resolved)) return false;
+	const absolute = path$1.resolve(resolved);
 	if (isWithinRoot(absolute, root)) return true;
 	try {
 		const realRoot = fs.realpathSync.native(root);
 		if (isWithinRoot(absolute, realRoot)) return true;
-		const realParent = fs.realpathSync.native(path.dirname(absolute));
-		return isWithinRoot(path.join(realParent, path.basename(absolute)), realRoot);
+		const realParent = fs.realpathSync.native(path$1.dirname(absolute));
+		return isWithinRoot(path$1.join(realParent, path$1.basename(absolute)), realRoot);
 	} catch {
 		return false;
 	}
@@ -14324,7 +14730,7 @@ const XD_SCHEME_NEAR_MISSES = {
 };
 function assertWriteTargetAddressable(target, router) {
 	const trimmed = target.trim();
-	if (path.win32.isAbsolute(trimmed) || router.canHandle(trimmed)) return;
+	if (path$1.win32.isAbsolute(trimmed) || router.canHandle(trimmed)) return;
 	const missingDelimiter = trimmed.match(XD_MISSING_DELIMITER_RE);
 	if (missingDelimiter) throw new ToolError(`Unknown URI-like write target '${trimmed}'. Did you mean 'xd://${missingDelimiter[1]}'? Prefix the path with './' to write it as a filesystem path.`);
 	const uriLike = trimmed.match(URI_LIKE_WRITE_PATH_RE);
@@ -14683,7 +15089,7 @@ var WriteTool = class {
 		const finalPath = resolvedArchivePath.exists ? await fs_promises_shim_exports.realpath(resolvedArchivePath.absolutePath).catch(() => resolvedArchivePath.absolutePath) : resolvedArchivePath.absolutePath;
 		const format = archiveFormatFromPath(finalPath) ?? "tar";
 		const tmpPath = `${finalPath}.tmp-${process.pid}`;
-		const parentDir = path.dirname(resolvedArchivePath.absolutePath);
+		const parentDir = path$1.dirname(resolvedArchivePath.absolutePath);
 		if (parentDir && parentDir !== ".") await fs_promises_shim_exports.mkdir(parentDir, { recursive: true });
 		const entries = /* @__PURE__ */ new Map();
 		if (resolvedArchivePath.exists) try {
@@ -14774,7 +15180,7 @@ var WriteTool = class {
 				} catch (error) {
 					throw new ToolError(`SQLite write content must be valid JSON5: ${error instanceof Error ? error.message : String(error)}`);
 				}
-				if (!isRecord$2(parsedContent)) throw new ToolError("SQLite write content must be a JSON object");
+				if (!isRecord$5(parsedContent)) throw new ToolError("SQLite write content must be a JSON object");
 				if (resolvedSqlitePath.key) {
 					const lookup = resolveTableRowLookup(db, resolvedSqlitePath.table);
 					resultText = (lookup.kind === "pk" ? updateRowByKey(db, resolvedSqlitePath.table, lookup, resolvedSqlitePath.key, parsedContent) : updateRowByRowId(db, resolvedSqlitePath.table, resolvedSqlitePath.key, parsedContent)) > 0 ? `Updated row '${resolvedSqlitePath.key}' in ${resolvedSqlitePath.table}` : `No row updated in ${resolvedSqlitePath.table} for key '${resolvedSqlitePath.key}'`;
@@ -15112,9 +15518,11 @@ async function executeWriteTool(exec, cfg, args) {
 	persistOmpSessionState(exec?.agent?.session, session);
 	const text = toText$5(result);
 	const details = result.details ?? {};
+	const card = projectWriteCardMeta({ resolvedPath: details.resolvedPath }, args);
 	return {
 		path: String(details.resolvedPath ?? args.path ?? ""),
-		text
+		text,
+		...card !== null && card.lang !== void 0 ? { lang: card.lang } : {}
 	};
 }
 /**
@@ -15148,14 +15556,15 @@ function registerWrite(ctx, getConfig) {
 					text: {
 						type: "string",
 						required: true
-					}
+					},
+					lang: { type: "string" }
 				}
 			},
 			render: (_args, value) => [{
 				type: "text",
 				text: String(value.text ?? "")
 			}],
-			presentationMeta: (_args, value) => ({ ...value.path !== void 0 ? { path: value.path } : {} })
+			presentationMeta: (_args, value) => projectWriteCardMeta(value) ?? null
 		},
 		async execute(args, exec) {
 			return executeWriteTool(exec, getConfig(), args);
@@ -17552,7 +17961,7 @@ async function applyNormalizedPatch(input, options) {
 		const normalizedContent = normalizeCreateContent(input.diff);
 		const content = normalizedContent.endsWith("\n") ? normalizedContent : `${normalizedContent}\n`;
 		if (!dryRun) {
-			const parentDir = path.dirname(absolutePath);
+			const parentDir = path$1.dirname(absolutePath);
 			if (parentDir && parentDir !== ".") await fs.mkdir(parentDir);
 			await fs.write(absolutePath, content);
 		}
@@ -17589,7 +17998,7 @@ async function applyNormalizedPatch(input, options) {
 	const isMove = Boolean(input.rename) && destPath !== absolutePath;
 	if (!dryRun) {
 		if (isMove) {
-			const parentDir = path.dirname(destPath);
+			const parentDir = path$1.dirname(destPath);
 			if (parentDir && parentDir !== ".") await fs.mkdir(parentDir);
 			await fs.write(destPath, finalContent);
 			await fs.delete(absolutePath);
@@ -18401,6 +18810,169 @@ async function executeSinglePathEntries(path, runs, outerBatchRequest, onUpdate,
 	};
 }
 //#endregion
+//#region src/web/host/edit.ts
+/**
+* `edit` tool card: project the engine's already-computed diff into the
+* `{kind:'edit'}` meta this plugin's browser half consumes (plan §4.2).
+*
+* The engine puts the diff in `details.diff` (single file) and in
+* `details.perFileResults[].diff` (multi file), so the card costs no extra I/O
+* and no extra diff computation. Its rows are `<sign><line>|<content>`
+* (`omp/edit/diff.ts:54` `formatNumberedDiffLine`):
+*  - replace / hashline emit numbered rows only (`generateDiffString`);
+*  - patch / apply_patch emit a `@@ -x,y +a,b @@` header plus the same rows
+*    (`generateUnifiedDiffString`).
+*
+* The repo's `parseDiffHunks` parses the *authored* patch format and only
+* strips a `12 content` line-number prefix (space-separated), not the engine's
+* `12|content` (pipe-separated) — reusing it would leave the gutter inside the
+* card's content. `parseNumberedDiffHunks` below is the display-side minimum:
+* it drops the gutter, splits hunks on `@@` headers, blank gap rows and line
+* number breaks, and returns the line content byte-for-byte.
+*
+* Zero-dependency by design: the Node half imports it from `presentationMeta`,
+* the browser half never does.
+*
+* Defensive: a card never throws and never emits `undefined` values (the host
+* rejects non-lossless metadata and turns a successful call into an error), so
+* an empty or unparseable diff projects to `null`.
+*
+* @module @xiaoso/dsh-tool-plus/web/host/edit
+*/
+/** One engine diff row: `<sign><line>|<content>` (`-2|beta`, ` 3|gamma`). */
+const NUMBERED_ROW = /^([+\- ])(\d+)\|([\s\S]*)$/;
+/** One authored unified row without a gutter: `-beta`, `+BETA`, ` gamma`. */
+const PLAIN_ROW = /^([+\- ])([\s\S]*)$/;
+/** Diff metadata that is never line content (file headers, envelope markers). */
+const METADATA_PREFIXES = [
+	"*** ",
+	"diff --git ",
+	"index ",
+	"--- ",
+	"+++ "
+];
+/** Whether `line` continues the current hunk (a line-number break starts a new one). */
+function breaksContinuity(prefix, oldNumber, newNumber, nextOld, nextNew) {
+	if (prefix === "-") return oldNumber !== null && nextOld !== null && oldNumber !== nextOld;
+	if (prefix === "+") return newNumber !== null && nextNew !== null && newNumber !== nextNew;
+	return oldNumber !== null && nextOld !== null && oldNumber !== nextOld || newNumber !== null && nextNew !== null && newNumber !== nextNew;
+}
+/**
+* Parse an engine diff body into display hunks.
+*
+* Boundaries: a `@@ … @@` header, a blank gap row (the engine's own
+* non-contiguity marker), or a line-number break after a change (how joined
+* per-entry diffs and skipped context regions read). Hunks without a change are
+* dropped — they would render as an empty diff.
+* @param diff - `details.diff` / `details.perFileResults[].diff`.
+* @returns the hunks, in diff order; empty when nothing parses.
+*/
+function parseNumberedDiffHunks(diff) {
+	const hunks = [];
+	let current = null;
+	let nextOld = null;
+	let nextNew = null;
+	const flush = () => {
+		if (current !== null && current.changed) hunks.push(current);
+		current = null;
+	};
+	for (const rawLine of diff.split("\n")) {
+		const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
+		if (line === "" || line.startsWith("@@")) {
+			flush();
+			continue;
+		}
+		if (METADATA_PREFIXES.some((prefix) => line.startsWith(prefix))) continue;
+		const numbered = NUMBERED_ROW.exec(line);
+		const plain = numbered === null ? PLAIN_ROW.exec(line) : null;
+		if (numbered === null && plain === null) continue;
+		const prefix = numbered?.[1] ?? plain?.[1];
+		const content = numbered?.[3] ?? plain?.[2] ?? "";
+		const digits = numbered?.[2];
+		const oldNumber = digits === void 0 || prefix === "+" ? null : Number.parseInt(digits, 10);
+		const newNumber = digits === void 0 || prefix === "-" ? null : Number.parseInt(digits, 10);
+		if (current !== null && current.changed && breaksContinuity(prefix, oldNumber, newNumber, nextOld, nextNew)) flush();
+		if (current === null) {
+			current = {
+				oldLines: [],
+				newLines: [],
+				changed: false
+			};
+			nextOld = null;
+			nextNew = null;
+		}
+		if (prefix === "-") {
+			current.oldLines.push(content);
+			current.changed = true;
+			nextOld = oldNumber === null ? null : oldNumber + 1;
+		} else if (prefix === "+") {
+			current.newLines.push(content);
+			current.changed = true;
+			nextNew = newNumber === null ? null : newNumber + 1;
+		} else {
+			current.oldLines.push(content);
+			current.newLines.push(content);
+			nextOld = oldNumber === null ? null : oldNumber + 1;
+			nextNew = newNumber === null ? null : newNumber + 1;
+		}
+	}
+	flush();
+	return hunks;
+}
+/** `value` as a plain record, or `null` (arrays, `null` and primitives drop). */
+function asRecord$1(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+/**
+* Append one file's hunks to `out`.
+*
+* A pure addition (no removed and no context rows) carries `oldText: null`, the
+* shape the shipped diff card reads as "new file". A move/rename has no
+* pre-move side to show in a two-column diff, so its target is recorded the
+* same way (the source side is deliberately not recorded).
+*/
+function pushFileHunks(out, pathValue, diffValue, isMove) {
+	if (typeof pathValue !== "string" || pathValue.trim() === "") return;
+	if (typeof diffValue !== "string" || diffValue.trim() === "") return;
+	for (const hunk of parseNumberedDiffHunks(diffValue)) out.push({
+		path: pathValue,
+		oldText: isMove || hunk.oldLines.length === 0 ? null : hunk.oldLines.join("\n"),
+		newText: hunk.newLines.join("\n")
+	});
+}
+/**
+* Project the edit engine's result details into card metadata.
+*
+* Multi-file results (`perFileResults`) are read file by file; single-file
+* results use `path` + `diff`. The payload is capped at
+* {@link EDIT_META_MAX_BYTES} by dropping whole trailing files; when nothing is
+* left the call projects to `null` and falls back to the generic shell rather
+* than writing an oversized session entry.
+* @param details - the engine's `EditToolDetails` (or the adapter's value).
+* @returns the edit card metadata, or `null` when there is no usable diff.
+*/
+function projectEditCardMeta(details) {
+	const record = asRecord$1(details);
+	if (record === null) return null;
+	const hunks = [];
+	const perFile = Array.isArray(record.perFileResults) ? record.perFileResults : null;
+	if (perFile !== null) for (const entry of perFile) {
+		const file = asRecord$1(entry);
+		if (file === null) continue;
+		pushFileHunks(hunks, file.path, file.diff, file.move !== void 0);
+	}
+	else pushFileHunks(hunks, record.path, record.diff, record.move !== void 0);
+	if (hunks.length === 0) return null;
+	const retained = capTail(hunks, EDIT_META_MAX_BYTES, (kept) => ({
+		kind: "edit",
+		diffs: kept
+	}));
+	return retained.length === 0 ? null : {
+		kind: "edit",
+		diffs: retained
+	};
+}
+//#endregion
 //#region src/tools/shared/sandbox-policy.ts
 /**
 * Resolve the per-call mutation policy for the given exec context, or
@@ -18501,6 +19073,17 @@ function runPatchEntry(options) {
 	});
 }
 /**
+* 把成功结果带上卡片投影（纯展示用；投影不抛异常，null → 不产 meta）。
+* 错误路径不经此函数，保证报错文案一字不变。
+*/
+function withEditCard(result, text) {
+	const diffs = projectEditCardMeta(result.details)?.diffs;
+	return diffs === void 0 ? { text } : {
+		text,
+		diffs
+	};
+}
+/**
 * 把 dispatch 聚合结果转成 DSH 输出。成功：保留引擎 per-entry 摘要原文；
 * 失败：抛出完整聚合文案，并在“失败即末条目”的空档补上游同款未应用指引。
 *
@@ -18515,7 +19098,7 @@ function toEditToolResult(result, entryCount, failedEntry, failedPath) {
 		const supplement = entryCount > 1 && failedEntry !== void 0 && failedEntry === entryCount ? failedPath !== void 0 ? `\nFiles NOT applied: ${failedPath}; re-read the affected files and re-issue only the failed and unapplied files.` : `\nEntry ${failedEntry} was NOT applied; re-read the file and re-issue only the failed and unapplied entries.` : "";
 		throw new Error(`${text || "edit failed"}${supplement}`);
 	}
-	return { text };
+	return withEditCard(result, text);
 }
 /**
 * S-13：edit.fuzzyThreshold 解析——上游 settings 面原样放行显式 0/负值
@@ -18575,31 +19158,35 @@ async function executeEditTool(exec, cfg, args, ctx) {
 					};
 				}), void 0, cwd, signal), entries.length, failedFile, failedFile !== void 0 ? entries[failedFile - 1]?.path : void 0);
 			}
-			return { text: toText$4(await executeHashlineSingle({
+			const result = await executeHashlineSingle({
 				session,
 				input: args.input,
 				signal,
 				writethrough
-			})) };
+			});
+			return withEditCard(result, toText$4(result));
 		}
 		const filePath = args.file_path ?? args.path ?? "";
 		if (!filePath || typeof filePath !== "string" || filePath.trim().length === 0) throw new Error("file_path must be a non-empty string");
-		if (typeof args.patch === "string" && args.patch.trim().length > 0) return { text: toText$4(await runPatchEntry({
-			session,
-			path: await resolveEditPath(session, filePath, {
-				mustExist: true,
-				signal
-			}),
-			entry: {
-				op: "update",
-				diff: args.patch
-			},
-			signal,
-			writethrough,
-			allowFuzzy,
-			fuzzyThreshold,
-			allowCreateOverwrite: true
-		})) };
+		if (typeof args.patch === "string" && args.patch.trim().length > 0) {
+			const result = await runPatchEntry({
+				session,
+				path: await resolveEditPath(session, filePath, {
+					mustExist: true,
+					signal
+				}),
+				entry: {
+					op: "update",
+					diff: args.patch
+				},
+				signal,
+				writethrough,
+				allowFuzzy,
+				fuzzyThreshold,
+				allowCreateOverwrite: true
+			});
+			return withEditCard(result, toText$4(result));
+		}
 		const editsInput = Array.isArray(args.edits) && args.edits.length > 0 ? args.edits : typeof args.old_string === "string" ? [{
 			oldText: args.old_string,
 			newText: String(args.new_string ?? "")
@@ -18693,15 +19280,42 @@ function registerEdit(ctx, getConfig) {
 			schema: {
 				type: "object",
 				additionalProperties: false,
-				properties: { text: {
-					type: "string",
-					required: true
-				} }
+				properties: {
+					text: {
+						type: "string",
+						required: true
+					},
+					diffs: {
+						type: "array",
+						items: {
+							type: "object",
+							additionalProperties: false,
+							properties: {
+								path: {
+									type: "string",
+									required: true
+								},
+								oldText: {
+									required: true,
+									oneOf: [{ type: "string" }, { type: "null" }]
+								},
+								newText: {
+									type: "string",
+									required: true
+								}
+							}
+						}
+					}
+				}
 			},
 			render: (_args, value) => [{
 				type: "text",
 				text: String(value.text ?? "")
-			}]
+			}],
+			presentationMeta: (_args, value) => Array.isArray(value?.diffs) && value.diffs.length > 0 ? {
+				kind: "edit",
+				diffs: value.diffs
+			} : null
 		},
 		async execute(args, exec) {
 			return executeEditTool(exec, getConfig(), args, ctx);
@@ -18777,7 +19391,7 @@ function createFileRecorder() {
 */
 function formatResultPath(filePath, isDirectory, basePath, cwd) {
 	const cleanPath = filePath.startsWith("/") ? filePath.slice(1) : filePath;
-	if (isDirectory) return formatPathRelativeToCwd(path.resolve(basePath, cleanPath), cwd);
+	if (isDirectory) return formatPathRelativeToCwd(path$1.resolve(basePath, cleanPath), cwd);
 	return formatPathRelativeToCwd(basePath, cwd);
 }
 //#endregion
@@ -18839,6 +19453,80 @@ function formatGroupedFiles(files, renderFile) {
 		display
 	};
 }
+const GROUPED_HEADER_RE = /^(#+)\s+(.*)$/;
+const HEADER_SUFFIX_RE = /\s+\([^)]*\)\s*$/;
+const HEADER_HASH_TAG_RE = /#[0-9a-f]+$/i;
+function resolveGroupedPath(parent, name) {
+	if (parent === void 0) return void 0;
+	if (name === "" || name === ".") return parent;
+	return path.resolve(parent, name);
+}
+/**
+* Walk grouped output lines, tracking a directory stack keyed by header depth, so
+* each header and body line can be linked back to its absolute filesystem path.
+* Reconstruction is stack-based (not per-blank-group) so nested directory headers
+* resolve correctly across the whole output.
+*
+* `headerBase` is the directory the displayed (folded) header paths are relative
+* to — for grep/ast tools that is the session cwd, since display paths are
+* formatted relative to cwd regardless of the (sub)directory the search was
+* scoped to. `fileScope` is the initial owning file for body lines that appear
+* before any header (single-file scopes have no `#` headers); it defaults to
+* `headerBase` and should be passed the scoped file's absolute path.
+*/
+function classifyGroupedLines(lines, headerBase, fileScope = headerBase) {
+	const result = [];
+	const dirAtDepth = /* @__PURE__ */ new Map();
+	let currentFile = fileScope;
+	const clearDeeper = (depth) => {
+		for (const key of dirAtDepth.keys()) if (key >= depth) dirAtDepth.delete(key);
+	};
+	for (const line of lines) {
+		const match = GROUPED_HEADER_RE.exec(line);
+		if (!match) {
+			result.push({
+				kind: "content",
+				depth: 0,
+				filePath: currentFile
+			});
+			continue;
+		}
+		const depth = match[1].length;
+		const rest = match[2].trimEnd();
+		if (isUrlLikePath(rest)) {
+			clearDeeper(depth);
+			currentFile = void 0;
+			result.push({
+				kind: "file",
+				depth,
+				isUrl: true
+			});
+			continue;
+		}
+		const parent = depth > 1 ? dirAtDepth.get(depth - 1) : headerBase;
+		if (rest.endsWith("/")) {
+			const abs = resolveGroupedPath(parent, rest.slice(0, -1).replace(HEADER_SUFFIX_RE, ""));
+			clearDeeper(depth);
+			if (abs !== void 0) dirAtDepth.set(depth, abs);
+			currentFile = void 0;
+			result.push({
+				kind: "dir",
+				depth,
+				headerPath: abs
+			});
+			continue;
+		}
+		const name = rest.replace(HEADER_SUFFIX_RE, "").replace(HEADER_HASH_TAG_RE, "");
+		const abs = name ? resolveGroupedPath(parent, name) : void 0;
+		currentFile = abs;
+		result.push({
+			kind: "file",
+			depth,
+			headerPath: abs
+		});
+	}
+	return result;
+}
 //#endregion
 //#region src/tools/omp/tools/match-line-format.ts
 /**
@@ -18869,8 +19557,8 @@ function formatMatchLine(lineNumber, line, isMatch, options) {
 */
 function matchAbsolutePath(matchPath, searchPath) {
 	if (matchPath === "") return searchPath;
-	if (path.isAbsolute(matchPath)) return path.resolve(matchPath);
-	return path.resolve(searchPath, matchPath);
+	if (path$1.isAbsolute(matchPath)) return path$1.resolve(matchPath);
+	return path$1.resolve(searchPath, matchPath);
 }
 //#endregion
 //#region src/tools/omp/tools/grep.ts
@@ -19015,9 +19703,9 @@ async function resolveArchiveSearchPaths(pathSpecs, cwd) {
 			unreadable.push(`${entry} (non-UTF-8 archive entry)`);
 			continue;
 		}
-		if (!tempDir) tempDir = await (0, fs_promises_shim_exports.mkdtemp)(path.join(tmpdir(), "omp-search-archive-"));
-		const safeBase = path.basename(member.subPath).replace(/[^\w.-]+/g, "_") || "entry";
-		const tempPath = path.join(tempDir, `${idx}-${safeBase}`);
+		if (!tempDir) tempDir = await (0, fs_promises_shim_exports.mkdtemp)(path$1.join(tmpdir(), "omp-search-archive-"));
+		const safeBase = path$1.basename(member.subPath).replace(/[^\w.-]+/g, "_") || "entry";
+		const tempPath = path$1.join(tempDir, `${idx}-${safeBase}`);
 		await (0, fs_promises_shim_exports.writeFile)(tempPath, text);
 		resolvedPaths[idx] = tempPath;
 		displayMap.set(tempPath, entry);
@@ -19038,7 +19726,7 @@ async function resolveArchiveSearchPaths(pathSpecs, cwd) {
 	};
 }
 function isImmutableSourcePath(filePath, immutableSourcePaths) {
-	for (const immutablePath of immutableSourcePaths) if (filePath === immutablePath || filePath.startsWith(`${immutablePath}${path.sep}`)) return true;
+	for (const immutablePath of immutableSourcePaths) if (filePath === immutablePath || filePath.startsWith(`${immutablePath}${path$1.sep}`)) return true;
 	return false;
 }
 const OMP_ROOT_URL_RE = /^omp:\/\/(?:\/?|docs\/?)$/i;
@@ -19156,7 +19844,7 @@ async function nativeChunkedLineIndexes(dir, resourceIdx, content, pattern, igno
 	let chunkSeq = 0;
 	const flush = async () => {
 		if (chunkLines.length === 0) return;
-		const scratch = path.resolve(dir, `${resourceIdx}-chunk-${chunkSeq++}`);
+		const scratch = path$1.resolve(dir, `${resourceIdx}-chunk-${chunkSeq++}`);
 		await (0, fs_promises_shim_exports.writeFile)(scratch, chunkLines.join("\n"));
 		const probe = await grep({
 			pattern,
@@ -19264,7 +19952,7 @@ async function searchVirtualResources(resources, pattern, ignoreCase, multiline,
 	const filesWithMatches = /* @__PURE__ */ new Set();
 	let totalMatches = 0;
 	let limitReached = false;
-	const dir = await (0, fs_promises_shim_exports.mkdtemp)(path.join(tmpdir(), "omp-search-virtual-"));
+	const dir = await (0, fs_promises_shim_exports.mkdtemp)(path$1.join(tmpdir(), "omp-search-virtual-"));
 	try {
 		for (let idx = 0; idx < resources.length; idx++) {
 			const resource = resources[idx];
@@ -19277,7 +19965,7 @@ async function searchVirtualResources(resources, pattern, ignoreCase, multiline,
 			let matchedIndexes;
 			if (Buffer.byteLength(resource.content, "utf8") > NATIVE_GREP_MAX_FILE_BYTES) matchedIndexes = (multiline ? jsMatchedLineIndexes(resource.content, lines, pattern, ignoreCase, true) : await nativeChunkedLineIndexes(dir, idx, resource.content, pattern, ignoreCase, signal)).filter((lineIndex) => lineAllowed(lineIndex + 1, resource.ranges));
 			else {
-				const scratch = path.resolve(dir, `${idx}`);
+				const scratch = path$1.resolve(dir, `${idx}`);
 				await (0, fs_promises_shim_exports.writeFile)(scratch, resource.content);
 				const probe = await grep({
 					pattern,
@@ -19380,7 +20068,7 @@ async function resolveInternalSearchInputs(opts) {
 		if (resource.isDirectory && !resource.sourcePath) throw new ToolError(`search cannot recurse the directory listing at ${rawPath}; search a specific file under it (e.g. ${rawPath.replace(/\/+$/, "")}/<file>) or read ${rawPath} to list its entries`);
 		if (resource.sourcePath) {
 			paths[idx] = resource.sourcePath;
-			if (resource.immutable) immutableSourcePaths.add(path.resolve(resource.sourcePath));
+			if (resource.immutable) immutableSourcePaths.add(path$1.resolve(resource.sourcePath));
 			continue;
 		}
 		if (context.pathOnly) resource = await internalRouter.resolve(rawPath, {
@@ -19520,16 +20208,16 @@ var GrepTool = class {
 						if (!resolved) continue;
 						const materializedExternalPath = materializedExternalPaths.get(spec.clean);
 						if (materializedExternalPath) {
-							mergeRangesInto(rangesByAbsPath, path.resolve(materializedExternalPath), spec.ranges);
+							mergeRangesInto(rangesByAbsPath, path$1.resolve(materializedExternalPath), spec.ranges);
 							continue;
 						}
 						if (resolved === spec.clean && !archiveDisplayMap.has(resolved)) {
-							const absKey = path.resolve(resolveReadPath(resolved, this.session.cwd));
+							const absKey = path$1.resolve(resolveReadPath(resolved, this.session.cwd));
 							const stats = await (0, fs_promises_shim_exports.stat)(absKey).catch(() => null);
 							if (!stats) throw new ToolError(`Path not found for line-range selector: ${spec.original}`);
 							if (!stats.isFile()) throw new ToolError(`Line-range selector requires a single file: ${spec.original} is a directory`);
 							mergeRangesInto(rangesByAbsPath, absKey, spec.ranges);
-						} else mergeRangesInto(rangesByAbsPath, path.resolve(resolved), spec.ranges);
+						} else mergeRangesInto(rangesByAbsPath, path$1.resolve(resolved), spec.ranges);
 					}
 					const physicalScopePath = searchablePaths.length === 1 && archiveDisplayMap.get(searchPath) ? archiveDisplayMap.get(searchPath) : scope.scopePath;
 					scopePath = internalResolution.virtualScopePath ? `${physicalScopePath}, ${internalResolution.virtualScopePath}` : physicalScopePath;
@@ -19596,14 +20284,14 @@ var GrepTool = class {
 								totalMatches += targetResult.totalMatches;
 								filesSearched += targetResult.filesSearched;
 								for (const match of targetResult.matches) {
-									const absolute = path.resolve(target.basePath, match.path);
+									const absolute = path$1.resolve(target.basePath, match.path);
 									const matchKey = `${absolute}\0${match.lineNumber}`;
 									if (seenMatchKeys.has(matchKey)) {
 										totalMatches = Math.max(0, totalMatches - 1);
 										continue;
 									}
 									seenMatchKeys.add(matchKey);
-									const rebased = path.relative(searchPath, absolute).replace(/\\/g, "/");
+									const rebased = path$1.relative(searchPath, absolute).replace(/\\/g, "/");
 									matches.push({
 										...match,
 										path: rebased
@@ -19740,7 +20428,7 @@ var GrepTool = class {
 					await Promise.all(explicitFileTargets.map(async (target) => {
 						try {
 							const st = await (0, fs_promises_shim_exports.stat)(target);
-							if (st.isFile() && st.size > NATIVE_GREP_MAX_FILE_BYTES) oversized.push(path.relative(this.session.cwd, target) || target);
+							if (st.isFile() && st.size > NATIVE_GREP_MAX_FILE_BYTES) oversized.push(path$1.relative(this.session.cwd, target) || target);
 						} catch {}
 					}));
 					if (oversized.length === 0) return void 0;
@@ -19785,7 +20473,7 @@ var GrepTool = class {
 				const hashContexts = /* @__PURE__ */ new Map();
 				if (baseDisplayMode.hashLines) for (const relativePath of fileList) {
 					if (archiveDisplaySet.has(relativePath) || virtualPathSet.has(relativePath)) continue;
-					const absoluteFilePath = path.resolve(this.session.cwd, relativePath);
+					const absoluteFilePath = path$1.resolve(this.session.cwd, relativePath);
 					if (isImmutableSourcePath(absoluteFilePath, immutableSourcePaths)) continue;
 					const tag = await recordFileSnapshot(this.session, absoluteFilePath);
 					if (tag) hashContexts.set(relativePath, { tag });
@@ -19821,7 +20509,7 @@ var GrepTool = class {
 						fileMatchCounts.set(relativePath, (fileMatchCounts.get(relativePath) ?? 0) + 1);
 					}
 					if (hashContext?.tag) {
-						const absoluteFilePath = path.resolve(this.session.cwd, relativePath);
+						const absoluteFilePath = path$1.resolve(this.session.cwd, relativePath);
 						recordSeenLinesFromBody(this.session, absoluteFilePath, hashContext.tag, modelOut.join("\n"));
 					}
 					return {
@@ -19889,6 +20577,204 @@ var GrepTool = class {
 	}
 };
 //#endregion
+//#region src/web/host/search.ts
+/**
+* Host projection for the `grep` / `ast_grep` / `glob` search cards.
+*
+* The engines already render the display text the TUI used to read: the grouped
+* file output (`# dir/` / `## file.ts#<tag>` headers) followed by code-frame
+* body lines (`*12│text` for a match, ` 12│text` for context, `…` for a gap).
+* That text is the only place the matched *line numbers* live — `details` only
+* carries per-file counts — so the card is rebuilt by parsing it with the same
+* `classifyGroupedLines` helper the TUI renderers used, then reading each
+* `formatCodeFrameLine` gutter back.
+*
+* Everything is defensive and bounded:
+*  - an engine that explicitly reports zero (a `matchCount` of `0`, or an empty
+*    `paths` array backed by a zero count) is a *known empty result*: it projects
+*    to the empty card the client already renders, so the same tool never shows
+*    two different shells;
+*  - a display that yields no file group at all projects to `null` unless that
+*    zero was reported (the row then falls back to the generic shell — the result
+*    text stays fully visible);
+*  - the payload is capped at {@link SEARCH_META_MAX_BYTES} by dropping trailing
+*    groups/paths, with `truncated` raised and `total` left at its pre-cap value.
+*
+* @module @xiaoso/dsh-tool-plus/web/host/search
+*/
+/**
+* One rendered body line's gutter: optional `formatCodeFrameLine` match marker,
+* the 1-based line number, and the display separator. Both shipped modes end up
+* in `displayContent`, so the parser also accepts the model-facing `|` / `:`
+* separators an older engine version could emit.
+*/
+const CODE_FRAME_RE = /^\s*(\*?)(\d+)[│|:]([\s\S]*)$/;
+/** Whether `value` is a plain object (never `null` or an array). */
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Non-negative integer, or `undefined`. */
+function nonNegativeInteger$1(value) {
+	return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : void 0;
+}
+/** The non-blank string `value` holds, or `undefined`. */
+function nonBlankString$1(value) {
+	return typeof value === "string" && value.trim() !== "" ? value : void 0;
+}
+/**
+* The pre-cap total to report: the engine's own count when it is present and at
+* least what the display actually holds, otherwise the parsed count. The
+* metadata contract requires `total >= files.length`, and an engine count below
+* the parsed one only means the display and the count disagree.
+*/
+function reportedTotal(declared, parsed) {
+	const count = nonNegativeInteger$1(declared);
+	return count !== void 0 && count >= parsed ? count : parsed;
+}
+/** One parsed code-frame body line, or `null` for headers/gaps/unparsable text. */
+function parseFrameLine(line) {
+	const match = CODE_FRAME_RE.exec(line);
+	if (match === null) return null;
+	const lineNumber = Number(match[2]);
+	if (!Number.isInteger(lineNumber) || lineNumber < 1) return null;
+	return {
+		lineNumber,
+		line: match[3] ?? "",
+		isMatch: match[1] === "*"
+	};
+}
+/**
+* Parse one grouped display into per-file match groups, in first-seen order.
+*
+* Only `*`-marked body lines become matches; context lines and `…` gap lines are
+* dropped. A body line whose owning file cannot be resolved (a URL group, or a
+* display read without a session base) is skipped rather than attributed to the
+* wrong file.
+* @param display - the engine's `displayContent`.
+* @param base - directory the display-relative header paths are relative to (the session cwd).
+* @param fileScope - absolute path of the only file, for a display without headers.
+* @returns the match groups; empty when nothing could be attributed.
+*/
+function parseMatchGroups(display, base, fileScope) {
+	const lines = display.split("\n");
+	const contexts = classifyGroupedLines(lines, base, fileScope);
+	const groups = [];
+	const byPath = /* @__PURE__ */ new Map();
+	for (let index = 0; index < lines.length; index += 1) {
+		const context = contexts[index];
+		if (context === void 0 || context.kind !== "content") continue;
+		const parsed = parseFrameLine(lines[index] ?? "");
+		if (parsed === null || !parsed.isMatch) continue;
+		const filePath = context.filePath;
+		if (typeof filePath !== "string" || filePath === "") continue;
+		let group = byPath.get(filePath);
+		if (group === void 0) {
+			group = {
+				path: filePath,
+				matches: []
+			};
+			byPath.set(filePath, group);
+			groups.push(group);
+		}
+		const matchLine = {
+			lineNumber: parsed.lineNumber,
+			line: parsed.line
+		};
+		group.matches.push(matchLine);
+	}
+	return groups;
+}
+/**
+* The known-empty matches card: the engine explicitly reported `matchCount: 0`,
+* so there is no grouping to parse but the empty result itself is definitive.
+*/
+function emptyMatchesMeta() {
+	return {
+		kind: "search",
+		shape: "matches",
+		files: [],
+		truncated: false,
+		total: 0
+	};
+}
+/**
+* Project a `grep` / `ast_grep` result value into grouped-matches card metadata.
+*
+* @param input - the tool's output value: `displayContent`, `cwd`, `files`,
+*   `matchCount` and `truncated` as the adapters project them.
+* @returns the card metadata, or `null` when no file group could be parsed.
+*/
+function searchMatchesCardMeta(input) {
+	if (!isRecord(input)) return null;
+	const zeroMatches = input.matchCount === 0;
+	const display = typeof input.displayContent === "string" ? input.displayContent : void 0;
+	if (display === void 0 || display === "") return zeroMatches ? emptyMatchesMeta() : null;
+	const base = nonBlankString$1(input.cwd);
+	const files = Array.isArray(input.files) ? input.files : [];
+	let fileScope = files.length === 1 ? nonBlankString$1(files[0]) : void 0;
+	if (fileScope !== void 0 && base !== void 0 && !path$1.isAbsolute(fileScope)) fileScope = path$1.resolve(base, fileScope);
+	const groups = parseMatchGroups(display, base, fileScope);
+	if (groups.length === 0) return zeroMatches ? emptyMatchesMeta() : null;
+	const parsedMatches = groups.reduce((total, group) => total + group.matches.length, 0);
+	const total = reportedTotal(input.matchCount, parsedMatches);
+	const retained = capTail(groups, SEARCH_META_MAX_BYTES, (kept) => ({
+		kind: "search",
+		shape: "matches",
+		files: kept,
+		truncated: true,
+		total
+	}));
+	if (retained.length === 0) return null;
+	const retainedMatches = retained.reduce((count, group) => count + group.matches.length, 0);
+	return {
+		kind: "search",
+		shape: "matches",
+		files: retained,
+		truncated: input.truncated === true || retainedMatches < total,
+		total
+	};
+}
+/**
+* Project a `glob` result value into path-list card metadata.
+*
+* @param input - the tool's output value: `paths`, `fileCount`, `total` and `truncated`.
+* @returns the card metadata, or `null` when the value is not a glob result (no
+*   `paths` key, or an empty one the engine never backed with a zero count).
+*/
+function searchPathsCardMeta(input) {
+	if (!isRecord(input)) return null;
+	const listed = input.paths;
+	if (!Array.isArray(listed)) return null;
+	if (listed.length === 0) {
+		if (!(nonNegativeInteger$1(input.fileCount) === 0 || nonNegativeInteger$1(input.total) === 0)) return null;
+		return {
+			kind: "search",
+			shape: "paths",
+			paths: [],
+			truncated: false,
+			total: reportedTotal(input.total, 0)
+		};
+	}
+	const raw = listed.filter((entry) => typeof entry === "string");
+	if (raw.length === 0) return null;
+	const total = reportedTotal(input.total, raw.length);
+	const retained = capTail(raw, SEARCH_META_MAX_BYTES, (kept) => ({
+		kind: "search",
+		shape: "paths",
+		paths: kept,
+		truncated: true,
+		total
+	}));
+	if (retained.length === 0) return null;
+	return {
+		kind: "search",
+		shape: "paths",
+		paths: retained,
+		truncated: input.truncated === true || retained.length < total,
+		total
+	};
+}
+//#endregion
 //#region src/tools/grep/adapter/index.ts
 /** Build the OMP ToolSession facade over a DSH exec context. */
 function createToolSession$3(exec, cfg) {
@@ -19921,7 +20807,9 @@ function toGrepToolResult(result) {
 		...typeof details.fileCount === "number" ? { fileCount: details.fileCount } : {},
 		...Array.isArray(details.files) ? { files: details.files } : {},
 		...typeof details.scopePath === "string" ? { scopePath: details.scopePath } : {},
-		...details.truncated === true ? { truncated: true } : {}
+		...details.truncated === true ? { truncated: true } : {},
+		...typeof details.displayContent === "string" ? { displayContent: details.displayContent } : {},
+		...typeof details.cwd === "string" ? { cwd: details.cwd } : {}
 	};
 }
 /**
@@ -19988,18 +20876,16 @@ function registerGrep(ctx, getConfig) {
 						items: { type: "string" }
 					},
 					scopePath: { type: "string" },
-					truncated: { type: "boolean" }
+					truncated: { type: "boolean" },
+					displayContent: { type: "string" },
+					cwd: { type: "string" }
 				}
 			},
 			render: (_args, value) => [{
 				type: "text",
 				text: String(value.text ?? "")
 			}],
-			presentationMeta: (_args, value) => ({
-				...typeof value.matchCount === "number" ? { matches: value.matchCount } : {},
-				...typeof value.fileCount === "number" ? { files: value.fileCount } : {},
-				...value.scopePath !== void 0 ? { path: value.scopePath } : {}
-			})
+			presentationMeta: (_args, value) => searchMatchesCardMeta(value) ?? null
 		},
 		async execute(args, exec) {
 			return executeGrepTool(exec, getConfig(), args, ctx);
@@ -20132,7 +21018,7 @@ var GlobTool = class {
 			const combinedSignal = signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;
 			const formatMatchPath = (matchPath, base, fileType) => {
 				const hadTrailingSlash = matchPath.endsWith("/") || matchPath.endsWith("\\");
-				return formatPathRelativeToCwd(path.isAbsolute(matchPath) ? matchPath : path.resolve(base, matchPath), this.session.cwd, { trailingSlash: fileType === natives.FileType.Dir || hadTrailingSlash });
+				return formatPathRelativeToCwd(path$1.isAbsolute(matchPath) ? matchPath : path$1.resolve(base, matchPath), this.session.cwd, { trailingSlash: fileType === natives.FileType.Dir || hadTrailingSlash });
 			};
 			const missingPathsNote = missingPaths.length > 0 ? `Skipped missing paths: ${missingPaths.join(", ")}` : void 0;
 			const buildResult = (files, opts) => {
@@ -20342,7 +21228,8 @@ function toGlobToolResult(result, args) {
 		path: String(details.scopePath ?? args.path ?? ""),
 		text: text + notice,
 		...typeof details.fileCount === "number" ? { fileCount: details.fileCount } : {},
-		...typeof details.truncated === "boolean" ? { truncated: details.truncated } : {}
+		...typeof details.truncated === "boolean" ? { truncated: details.truncated } : {},
+		...Array.isArray(details.files) ? { paths: details.files.filter((entry) => typeof entry === "string") } : {}
 	};
 }
 /**
@@ -20399,17 +21286,18 @@ function registerGlob(ctx, getConfig) {
 						required: true
 					},
 					fileCount: { type: "number" },
-					truncated: { type: "boolean" }
+					truncated: { type: "boolean" },
+					paths: {
+						type: "array",
+						items: { type: "string" }
+					}
 				}
 			},
 			render: (_args, value) => [{
 				type: "text",
 				text: String(value.text ?? "")
 			}],
-			presentationMeta: (_args, value) => ({
-				...value.fileCount !== void 0 ? { files: value.fileCount } : {},
-				...value.truncated !== void 0 ? { truncated: value.truncated } : {}
-			})
+			presentationMeta: (_args, value) => searchPathsCardMeta(value) ?? null
 		},
 		async execute(args, exec) {
 			return executeGlobTool(exec, getConfig(), args, ctx);
@@ -20462,16 +21350,16 @@ async function runAstEditTargets(targets, commonBasePath, options) {
 		applied = applied && targetResult.applied;
 		if (targetResult.parseErrors) parseErrors.push(...targetResult.parseErrors);
 		for (const change of targetResult.changes) {
-			const absolute = path.resolve(target.basePath, change.path);
-			const rebased = path.relative(commonBasePath, absolute).replace(/\\/g, "/");
+			const absolute = path$1.resolve(target.basePath, change.path);
+			const rebased = path$1.relative(commonBasePath, absolute).replace(/\\/g, "/");
 			aggregatedChanges.push({
 				...change,
 				path: rebased
 			});
 		}
 		for (const fileChange of targetResult.fileChanges) {
-			const absolute = path.resolve(target.basePath, fileChange.path);
-			const rebased = path.relative(commonBasePath, absolute).replace(/\\/g, "/");
+			const absolute = path$1.resolve(target.basePath, fileChange.path);
+			const rebased = path$1.relative(commonBasePath, absolute).replace(/\\/g, "/");
 			fileCounts.set(rebased, (fileCounts.get(rebased) ?? 0) + fileChange.count);
 		}
 	}
@@ -20670,7 +21558,7 @@ var AstEditTool = class {
 			if (useHashLines) {
 				const snapshotStore = getFileSnapshotStore(this.session);
 				for (const relativePath of fileList) {
-					const absolutePath = path.resolve(this.session.cwd, relativePath);
+					const absolutePath = path$1.resolve(this.session.cwd, relativePath);
 					try {
 						const fullText = normalizeToLF(await Bun.file(absolutePath).text());
 						const tag = snapshotStore.recordSnapshot(canonicalSnapshotKey(absolutePath), fullText);
@@ -20762,7 +21650,7 @@ var AstEditTool = class {
 						if (useHashLines) {
 							const snapshotStore = getFileSnapshotStore(this.session);
 							for (const relativePath of appliedFileList) {
-								const appliedAbsolutePath = path.resolve(this.session.cwd, relativePath);
+								const appliedAbsolutePath = path$1.resolve(this.session.cwd, relativePath);
 								try {
 									const fullText = normalizeToLF(await Bun.file(appliedAbsolutePath).text());
 									const freshTag = snapshotStore.recordSnapshot(canonicalSnapshotKey(appliedAbsolutePath), fullText);
@@ -20814,6 +21702,116 @@ var AstEditTool = class {
 	}
 };
 //#endregion
+//#region src/web/host/ast-edit.ts
+/**
+* `ast_edit` tool card: project the engine's own change preview plus its
+* counters into the `{kind:'ast_edit'}` meta this plugin's browser half
+* consumes (plan §4.3).
+*
+* The engine renders a preview (`displayContent`: grouped hits with a `│` line
+* gutter) for exactly the replacements it found, so the card reuses that text
+* verbatim instead of sampling `before`/`after`. The preview is bounded by
+* {@link AST_EDIT_META_MAX_BYTES}: past that budget the text is truncated (the
+* file list and counters survive), and if even an empty preview cannot fit the
+* payload, trailing files are dropped.
+*
+* Zero-dependency by design (no React, no Node built-ins beyond the contract's
+* own helpers), so the Node half can import it from `presentationMeta` without
+* dragging anything into the browser bundle.
+*
+* Defensive: a card never throws and never emits `undefined` values (the host
+* rejects non-lossless metadata and turns a successful call into an error); no
+* replacement, or no preview text, projects to `null` so the row falls back to
+* the generic shell.
+*
+* @module @xiaoso/dsh-tool-plus/web/host/ast-edit
+*/
+/** `value` as a plain record, or `null` (arrays, `null` and primitives drop). */
+function asRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+/** Non-negative integer, or `null`. */
+function nonNegativeInteger(value) {
+	return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : null;
+}
+/** Non-blank string, or `null`. */
+function nonBlankString(value) {
+	return typeof value === "string" && value.trim() !== "" ? value : null;
+}
+/** The engine's `fileReplacements[{path,count}]`, malformed entries dropped. */
+function projectFiles(value) {
+	if (!Array.isArray(value)) return [];
+	const files = [];
+	for (const entry of value) {
+		const file = asRecord(entry);
+		if (file === null) continue;
+		const path = nonBlankString(file.path);
+		const count = nonNegativeInteger(file.count);
+		if (path === null || count === null) continue;
+		files.push({
+			path,
+			count
+		});
+	}
+	return files;
+}
+/**
+* Total replacements: the engine's own count when present, else the file
+* counts' sum (a missing array then counts as zero).
+*/
+function replacementsOf(record, files) {
+	const reported = nonNegativeInteger(record.totalReplacements);
+	if (reported !== null) return reported;
+	return files.reduce((total, file) => total + file.count, 0);
+}
+/**
+* Build the payload within {@link AST_EDIT_META_MAX_BYTES}.
+*
+* Trailing files are dropped first (the counters survive), then the preview
+* gets every remaining byte. The preview budget is found by binary search over
+* `capText` — the raw text is measured in UTF-8 bytes while the payload is
+* measured as JSON, and escaping can inflate the latter, so spending the exact
+* cap on text is not enough.
+*/
+function fitAstEditMeta(raw, files, replacements, applied) {
+	const build = (preview, retained) => ({
+		kind: "ast_edit",
+		preview,
+		files: [...retained],
+		replacements,
+		applied
+	});
+	const retained = capTail(files, AST_EDIT_META_MAX_BYTES, (kept) => build("", kept));
+	const fits = (budget) => jsonByteLength(build(capText(raw, budget), retained)) <= AST_EDIT_META_MAX_BYTES;
+	if (!fits(0)) return null;
+	let low = 0;
+	let high = AST_EDIT_META_MAX_BYTES;
+	while (low < high) {
+		const mid = Math.ceil((low + high) / 2);
+		if (fits(mid)) low = mid;
+		else high = mid - 1;
+	}
+	return build(capText(raw, low), retained);
+}
+/**
+* Project the ast_edit engine's result into card metadata.
+* @param details - the engine's `displayContent` / `fileReplacements` /
+*   `totalReplacements` / `applied` fields (the adapter's value carries the
+*   same names).
+* @returns the ast_edit card metadata, or `null` when the call previews no
+*   replacement or produced no preview text.
+*/
+function projectAstEditCardMeta(details) {
+	const record = asRecord(details);
+	if (record === null) return null;
+	const preview = nonBlankString(record.displayContent);
+	if (preview === null) return null;
+	const files = projectFiles(record.fileReplacements);
+	const replacements = replacementsOf(record, files);
+	if (replacements <= 0) return null;
+	return fitAstEditMeta(preview, files, replacements, record.applied === true);
+}
+//#endregion
 //#region src/tools/ast-edit/adapter/index.ts
 /**
 * Build the OMP ToolSession facade over a DSH exec context.
@@ -20850,6 +21848,18 @@ function toText$1(result) {
 	return text;
 }
 /**
+* ast_edit 卡片 value 字段（output.schema 镜像）。预览已按 AST_EDIT_META_MAX_BYTES
+* 在投影里截断，这里只做搬运，保证 meta 里不出现 undefined。
+*/
+function astEditCardFields(card) {
+	return {
+		preview: card.preview,
+		files: card.files,
+		replacements: card.replacements,
+		applied: card.applied
+	};
+}
+/**
 * Register the ast_edit tool. Argument shape matches OMP verbatim:
 * `ops` is a non-empty array of `{ pat, out }` rewrite rules, and `paths` is a
 * non-empty array of files, directories, globs, or internal URLs.
@@ -20891,15 +21901,44 @@ function registerAstEdit(ctx, getConfig) {
 			schema: {
 				type: "object",
 				additionalProperties: false,
-				properties: { text: {
-					type: "string",
-					required: true
-				} }
+				properties: {
+					text: {
+						type: "string",
+						required: true
+					},
+					preview: { type: "string" },
+					files: {
+						type: "array",
+						items: {
+							type: "object",
+							additionalProperties: false,
+							properties: {
+								path: {
+									type: "string",
+									required: true
+								},
+								count: {
+									type: "integer",
+									required: true
+								}
+							}
+						}
+					},
+					replacements: { type: "integer" },
+					applied: { type: "boolean" }
+				}
 			},
 			render: (_args, value) => [{
 				type: "text",
 				text: String(value.text ?? "")
-			}]
+			}],
+			presentationMeta: (_args, value) => typeof value?.preview === "string" && value.preview !== "" ? {
+				kind: "ast_edit",
+				preview: value.preview,
+				files: Array.isArray(value.files) ? value.files : [],
+				replacements: typeof value.replacements === "number" ? value.replacements : 0,
+				applied: value.applied === true
+			} : null
 		},
 		async execute(args, exec) {
 			const session = createToolSession$1(exec, getConfig());
@@ -20907,8 +21946,27 @@ function registerAstEdit(ctx, getConfig) {
 				ops: Array.isArray(args.ops) ? args.ops : [],
 				paths: Array.isArray(args.paths) ? args.paths : []
 			}, exec.signal);
-			if (session.pendingInvoker) return { text: toText$1(await session.pendingInvoker()) };
-			return { text: toText$1(result) };
+			const previewDetails = result.details ?? {};
+			if (session.pendingInvoker) {
+				const applied = await session.pendingInvoker();
+				const resolveDetails = applied.details ?? {};
+				const appliedDetails = typeof resolveDetails.sourceResultDetails === "object" && resolveDetails.sourceResultDetails !== null ? resolveDetails.sourceResultDetails : resolveDetails;
+				const card = projectAstEditCardMeta({
+					...appliedDetails,
+					displayContent: appliedDetails.displayContent ?? previewDetails.displayContent
+				});
+				const text = toText$1(applied);
+				return card === null ? { text } : {
+					text,
+					...astEditCardFields(card)
+				};
+			}
+			const card = projectAstEditCardMeta(previewDetails);
+			const text = toText$1(result);
+			return card === null ? { text } : {
+				text,
+				...astEditCardFields(card)
+			};
 		},
 		presentCall: (args) => ({
 			card: "generic",
@@ -20977,8 +22035,8 @@ async function runMultiTargetAstGrep(targets, options) {
 		limitReached = limitReached || targetResult.limitReached;
 		if (targetResult.parseErrors) parseErrors.push(...targetResult.parseErrors);
 		for (const match of targetResult.matches) {
-			const absolute = path.resolve(target.basePath, match.path);
-			const rebased = path.relative(options.commonBasePath, absolute).replace(/\\/g, "/");
+			const absolute = path$1.resolve(target.basePath, match.path);
+			const rebased = path$1.relative(options.commonBasePath, absolute).replace(/\\/g, "/");
 			retainAstFindMatch(retainedMatches, retainedCapacity, {
 				...match,
 				path: rebased
@@ -21127,7 +22185,7 @@ var AstGrepTool = class {
 			const useHashLines = resolveFileDisplayMode(this.session).hashLines;
 			const hashContexts = /* @__PURE__ */ new Map();
 			if (useHashLines) for (const relativePath of fileList) {
-				const absolutePath = path.resolve(this.session.cwd, relativePath);
+				const absolutePath = path$1.resolve(this.session.cwd, relativePath);
 				const tag = await recordFileSnapshot(this.session, absolutePath);
 				if (tag) hashContexts.set(relativePath, { tag });
 			}
@@ -21160,7 +22218,7 @@ var AstGrepTool = class {
 					fileMatchCounts.set(relativePath, (fileMatchCounts.get(relativePath) ?? 0) + 1);
 				}
 				if (hashContext?.tag) {
-					const absoluteFilePath = path.resolve(this.session.cwd, relativePath);
+					const absoluteFilePath = path$1.resolve(this.session.cwd, relativePath);
 					recordSeenLinesFromBody(this.session, absoluteFilePath, hashContext.tag, modelOut.join("\n"));
 				}
 				return {
@@ -21224,6 +22282,28 @@ function toText(result) {
 	return text;
 }
 /**
+* 把 OMP AgentToolResult 转成 DSH ast_grep 工具输出。
+*
+* 此前适配层只回 `{text}`，卡片拿不到任何结构化数据；现在把引擎的
+* `displayContent`（分组显示文本）+ `files` + `matchCount` + `limitReached`
+* 一并带出，供 `presentationMeta` 投影成 search 卡（§4.6）。isError 仍抛错，
+* 报错文案不变。
+*/
+function toAstGrepToolResult(result) {
+	const text = toText(result);
+	const details = result.details ?? {};
+	return {
+		text,
+		...typeof details.matchCount === "number" ? { matchCount: details.matchCount } : {},
+		...typeof details.fileCount === "number" ? { fileCount: details.fileCount } : {},
+		...Array.isArray(details.files) ? { files: details.files.filter((entry) => typeof entry === "string") } : {},
+		...typeof details.scopePath === "string" ? { scopePath: details.scopePath } : {},
+		...details.limitReached === true || details.truncated === true ? { truncated: true } : {},
+		...typeof details.displayContent === "string" ? { displayContent: details.displayContent } : {},
+		...typeof details.cwd === "string" ? { cwd: details.cwd } : {}
+	};
+}
+/**
 * Register the ast_grep tool. Argument shape matches OMP verbatim:
 * `pat` is a required AST pattern; `path` optionally selects files,
 * directories, globs, or internal URLs (semicolon-delimited list); `skip`
@@ -21252,22 +22332,35 @@ function registerAstGrep(ctx, getConfig) {
 			schema: {
 				type: "object",
 				additionalProperties: false,
-				properties: { text: {
-					type: "string",
-					required: true
-				} }
+				properties: {
+					text: {
+						type: "string",
+						required: true
+					},
+					matchCount: { type: "number" },
+					fileCount: { type: "number" },
+					files: {
+						type: "array",
+						items: { type: "string" }
+					},
+					scopePath: { type: "string" },
+					truncated: { type: "boolean" },
+					displayContent: { type: "string" },
+					cwd: { type: "string" }
+				}
 			},
 			render: (_args, value) => [{
 				type: "text",
 				text: String(value.text ?? "")
-			}]
+			}],
+			presentationMeta: (_args, value) => searchMatchesCardMeta(value) ?? null
 		},
 		async execute(args, exec) {
-			return { text: toText(await new AstGrepTool(createToolSession(exec, getConfig())).execute("ast_grep", {
+			return toAstGrepToolResult(await new AstGrepTool(createToolSession(exec, getConfig())).execute("ast_grep", {
 				pat: String(args.pat ?? ""),
 				...args.path !== void 0 ? { path: String(args.path) } : {},
 				...args.skip !== void 0 ? { skip: Number(args.skip) } : {}
-			}, exec.signal)) };
+			}, exec.signal));
 		},
 		presentCall: (args) => ({
 			card: "generic",
@@ -21540,7 +22633,8 @@ function apply(ctx, config = {}) {
 			render: (_args, value) => [{
 				type: "text",
 				text: value.kind === "background" ? `Backgrounded as job ${value.jobId}; result will be delivered automatically when it finishes. Continue with other work — do not poll for it.` : renderBashResult(value)
-			}]
+			}],
+			presentationMeta: (_args, value) => bashCardMeta(value)
 		},
 		async execute(args, exec) {
 			validateBashArgs(args);