@dyyz1993/pi-coding-agent 0.74.24 → 0.74.27

package/dist/extensions/message-bridge/index.ts

@@ -0,0 +1,222 @@
+/**
+ * Message Bridge Extension for pi
+ *
+ * 1. 拦截 ctx.ui.confirm/select/input 调用，转发到 Message Bridge 服务。
+ *    用 ctx.respondUI 异步注入远程回复，与本地 UI 竞争（race 模式）。
+ *
+ * 2. 监听 message_end 事件，将 Assistant 回复作为纯文本推送到 Message Bridge。
+ *    如果用户在移动端回复，调用 pi.sendUserMessage 将回复注入回 Agent。
+ *
+ * 类型映射：
+ *   confirm → {type: "confirm", question: ...}
+ *   select  → {type: "radio", question, options}
+ *   input   → 纯文本推送
+ *   notify  → 纯文本推送（fire-and-forget，不等待回复）
+ *
+ * answer 解析：
+ *   confirm → "【确认】: 确定" / "【确认】: 取消" → confirmed: true/false
+ *   radio   → "【问题】: 选项A" → value: "选项A"
+ *   纯文本  → 直接返回 answer
+ *
+ * 用法：
+ *   --extension ./extensions/message-bridge/index.ts
+ *   或 settings.json: { "extensions": ["./extensions/message-bridge/index.ts"] }
+ *
+ * 环境变量：
+ *   MESSAGE_BRIDGE_URL          - 服务地址（默认 https://message-bridge.docker.19930810.xyz:8443）
+ *   MESSAGE_BRIDGE_SESSION_ID   - 可选 session 过滤
+ */
+
+const BRIDGE_URL = process.env.MESSAGE_BRIDGE_URL || "https://message-bridge.docker.19930810.xyz:8443";
+
+interface PushResponse {
+	id: string;
+	status: string;
+}
+
+interface PullResponse {
+	id: string;
+	answer: string;
+}
+
+async function pushQuestion(question: unknown, sessionId?: string): Promise<string> {
+	const resp = await fetch(`${BRIDGE_URL}/push`, {
+		method: "POST",
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify({ question, session_id: sessionId }),
+	});
+	if (!resp.ok) throw new Error(`Message Bridge push failed: ${resp.status}`);
+	const data = (await resp.json()) as PushResponse;
+	return data.id;
+}
+
+async function pullAnswer(msgId: string): Promise<string> {
+	const resp = await fetch(`${BRIDGE_URL}/pull/${msgId}`);
+	if (!resp.ok) throw new Error(`Message Bridge pull failed: ${resp.status}`);
+	const data = (await resp.json()) as PullResponse;
+	return data.answer;
+}
+
+async function pushAndWait(question: unknown, sessionId?: string): Promise<string> {
+	const id = await pushQuestion(question, sessionId);
+	return pullAnswer(id);
+}
+
+function buildConfirmQuestion(title: string, message?: string): Record<string, unknown> {
+	const question = message ? `${title} - ${message}` : title;
+	return { type: "confirm", question };
+}
+
+function buildSelectQuestion(title: string, options: string[], multiple?: boolean): Record<string, unknown> {
+	return {
+		type: multiple ? "checkbox" : "radio",
+		question: title,
+		options: options.map((label) => ({ label, description: "" })),
+	};
+}
+
+function parseConfirmAnswer(answer: string): boolean {
+	const trimmed = answer.trim();
+	if (trimmed.includes("取消") || trimmed.includes("拒绝")) return false;
+	if (trimmed.includes("确定") || trimmed.includes("确认")) return true;
+	const normalized = trimmed.toLowerCase();
+	return normalized === "yes" || normalized === "y" || normalized === "true" || normalized === "1";
+}
+
+function parseSelectAnswer(answer: string): string {
+	const trimmed = answer.trim();
+	const colonIdx = trimmed.indexOf("】:");
+	if (colonIdx !== -1) {
+		const value = trimmed.slice(colonIdx + 2).trim();
+		const parts = value.split(",").map((s) => s.trim());
+		return parts[0];
+	}
+	try {
+		const parsed = JSON.parse(trimmed);
+		if (Array.isArray(parsed)) return String(parsed[0] ?? trimmed);
+		if (typeof parsed === "string") return parsed;
+		return trimmed;
+	} catch (err) {
+		console.debug("[message-bridge] JSON parse fallback:", err instanceof Error ? err.message : err);
+		return trimmed;
+	}
+}
+
+function parseMultiSelectAnswer(answer: string, options: string[]): string[] {
+	const trimmed = answer.trim();
+	try {
+		const parsed = JSON.parse(trimmed);
+		if (Array.isArray(parsed)) {
+			return parsed.map(String).filter((v) => options.includes(v));
+		}
+	} catch (err) {
+		console.debug("[message-bridge] multi-select parse failed:", err instanceof Error ? err.message : err);
+	}
+	const colonIdx = trimmed.indexOf("】:");
+	if (colonIdx !== -1) {
+		const value = trimmed.slice(colonIdx + 2).trim();
+		return value
+			.split(",")
+			.map((s) => s.trim())
+			.filter((v) => options.includes(v));
+	}
+	return options.includes(trimmed) ? [trimmed] : [];
+}
+
+function extractMessageText(message: unknown): string {
+	if (!message || typeof message !== "object" || !("content" in message)) return "";
+	const content = (message as { content?: string | Array<{ type: string; text?: string }> }).content;
+	if (content === undefined) return "";
+	if (typeof content === "string") return content;
+	return content
+		.filter((part): part is { type: "text"; text: string } => part.type === "text")
+		.map((part) => part.text)
+		.join("\n");
+}
+
+export default function messageBridgeExtension(pi: any) {
+	const sessionId = process.env.MESSAGE_BRIDGE_SESSION_ID || undefined;
+
+	pi.on("ui", async (event: any, ctx: any) => {
+		if (event.method === "notify") {
+			pushAndWait(event.message, sessionId).catch((err) => console.debug("[message-bridge] notify push failed:", err instanceof Error ? err.message : err));
+			return undefined;
+		}
+
+		if (event.method === "confirm") {
+			const question = buildConfirmQuestion(event.title, event.message);
+			pushAndWait(question, sessionId)
+				.then((answer) => {
+					const confirmed = parseConfirmAnswer(answer);
+					ctx.respondUI(event.id, { action: "responded", confirmed });
+				})
+				.catch((err) => console.debug("[message-bridge] confirm push failed:", err instanceof Error ? err.message : err));
+			return undefined;
+		}
+
+		if (event.method === "select") {
+			const options: string[] = event.options ?? [];
+			const multiple: boolean = event.multiple === true;
+			const question = buildSelectQuestion(event.title, options, multiple);
+			pushAndWait(question, sessionId)
+				.then((answer) => {
+					if (multiple) {
+						const values = parseMultiSelectAnswer(answer, options);
+						ctx.respondUI(event.id, { action: "responded", value: values });
+					} else {
+						const value = parseSelectAnswer(answer);
+						ctx.respondUI(event.id, { action: "responded", value });
+					}
+				})
+				.catch((err) => console.debug("[message-bridge] select push failed:", err instanceof Error ? err.message : err));
+			return undefined;
+		}
+
+		if (event.method === "input") {
+			const question = event.placeholder
+				? `${event.title}\n\nPlaceholder: ${event.placeholder}`
+				: event.title;
+			pushAndWait(question, sessionId)
+				.then((answer) => {
+					ctx.respondUI(event.id, { action: "responded", value: answer });
+				})
+				.catch((err) => console.debug("[message-bridge] input push failed:", err instanceof Error ? err.message : err));
+			return undefined;
+		}
+
+		if (event.method === "editor") {
+			const question = event.prefill
+				? `${event.title}\n\nPre-filled content:\n${event.prefill}`
+				: event.title;
+			pushAndWait(question, sessionId)
+				.then((answer) => {
+					ctx.respondUI(event.id, { action: "responded", value: answer });
+				})
+				.catch((err) => console.debug("[message-bridge] editor push failed:", err instanceof Error ? err.message : err));
+			return undefined;
+		}
+
+		return undefined;
+	});
+
+	pi.on("agent_end", async (event: any) => {
+		if (!event?.messages) return;
+
+		const assistantTexts = event.messages
+			.filter((m: any) => m.role === "assistant")
+			.map((m: any) => extractMessageText(m))
+			.filter((t: string) => t.trim());
+		if (assistantTexts.length === 0) return;
+
+		const text = assistantTexts.join("\n\n---\n\n");
+
+		pushQuestion(text, sessionId)
+			.then((id) => pullAnswer(id))
+			.then((answer) => {
+				if (answer?.trim()) {
+					pi.sendUserMessage(answer.trim());
+				}
+			})
+			.catch((err) => console.debug("[message-bridge] agent_end push failed:", err instanceof Error ? err.message : err));
+	});
+}

package/dist/extensions/output-guard/index.ts

@@ -0,0 +1,446 @@
+/**
+ * Output Guard Extension - Global fallback truncation + tool limit optimization.
+ *
+ * Aligns pi-momo-fork's truncation strategy with OpenCode's approach:
+ *
+ * OpenCode has a global truncation layer in `Tool.define()` that checks
+ * `metadata.truncated` - if undefined, applies 50KB/2000-line truncation
+ * and saves full output to disk. Plugin/MCP tools are wrapped in
+ * `fromPlugin()` with `Truncate.output()` built in.
+ *
+ * Pi lacks this global layer. This extension fills the gap via `tool_result`
+ * event hooks, providing equivalent protection for:
+ * - Extension/plugin tools (no built-in truncation)
+ * - MCP tools (no built-in truncation)
+ * - Any future tool that forgets to self-manage
+ *
+ * Three capabilities:
+ *
+ * 1. **Global truncation fallback**: Intercepts `tool_result` for tools that
+ *    don't self-manage truncation. Applies 50KB/2000-line limit, saves full
+ *    output to `<sessionDataDir>/tool-output/`, returns truncated preview
+ *    with actionable file path hint.
+ *
+ * 2. **Tool limit optimization**: Intercepts `tool_call` to enforce lower
+ *    result limits on find (1000 -> 100) and ls (500 -> 100), matching
+ *    OpenCode's glob/ls defaults. Reduces unnecessary context consumption.
+ *
+ * 3. **PDF text extraction**: Registers a `pdf_read` tool that extracts text
+ *    from PDF files. OpenCode sends PDFs as raw base64 to the model; Pi's
+ *    read tool doesn't support PDFs at all. This tool uses pdf-parse for
+ *    text extraction, which is more token-efficient than base64 encoding.
+ *
+ * Configuration (via .pi/settings.json `outputGuard` key):
+ *   maxLines: number (default: 2000)
+ *   maxBytes: number (default: 51200 = 50KB)
+ *   findLimit: number (default: 100)
+ *   lsLimit: number (default: 100)
+ *   saveToFile: boolean (default: true)
+ */
+
+import { randomBytes } from "node:crypto";
+import { mkdirSync, existsSync, writeFileSync as fsWriteFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { Type } from "typebox";
+import type {
+	ExtensionAPI,
+	ToolResultEvent,
+	ToolResultEventResult,
+	ToolCallEvent,
+	ToolCallEventResult,
+	ExtensionContext,
+} from "@dyyz1993/pi-coding-agent";
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+/** Matches OpenCode's MAX_LINES */
+const DEFAULT_MAX_LINES = 2000;
+/** Matches OpenCode's MAX_BYTES */
+const DEFAULT_MAX_BYTES = 50 * 1024; // 50KB
+/** Matches OpenCode's glob limit of 100 */
+const DEFAULT_FIND_LIMIT = 100;
+/** Matches OpenCode's ls limit of 100 */
+const DEFAULT_LS_LIMIT = 100;
+
+/**
+ * Built-in tools that self-manage truncation.
+ * These tools set details.truncation and handle their own size limits,
+ * so the global fallback must skip them (matches OpenCode's
+ * `metadata.truncated !== undefined` check).
+ */
+const SELF_MANAGED_TOOLS = new Set(["read", "bash", "grep", "find", "ls"]);
+
+// ============================================================================
+// Configuration
+// ============================================================================
+
+interface OutputGuardConfig {
+	maxLines: number;
+	maxBytes: number;
+	findLimit: number;
+	lsLimit: number;
+	saveToFile: boolean;
+}
+
+function loadConfig(ctx: ExtensionContext): OutputGuardConfig {
+	const settings = (ctx as unknown as { settings?: Record<string, unknown> }).settings;
+	const guard = settings?.outputGuard as Partial<OutputGuardConfig> | undefined;
+	return {
+		maxLines: guard?.maxLines ?? DEFAULT_MAX_LINES,
+		maxBytes: guard?.maxBytes ?? DEFAULT_MAX_BYTES,
+		findLimit: guard?.findLimit ?? DEFAULT_FIND_LIMIT,
+		lsLimit: guard?.lsLimit ?? DEFAULT_LS_LIMIT,
+		saveToFile: guard?.saveToFile ?? true,
+	};
+}
+
+// ============================================================================
+// Truncation Logic (mirrors OpenCode's Truncate.output)
+// ============================================================================
+
+interface TruncationInfo {
+	truncated: boolean;
+	content: string;
+	totalLines: number;
+	totalBytes: number;
+	outputLines: number;
+	outputBytes: number;
+	truncatedBy: "lines" | "bytes" | null;
+	fullOutputPath?: string;
+}
+
+/**
+ * Truncate text content, keeping the tail (last N lines).
+ * Mirrors OpenCode's `Truncate.output()` with direction="tail".
+ * Saves full content to `<sessionDataDir>/tool-output/` when truncated
+ * (matches OpenCode's `<data-dir>/tool-output/` pattern).
+ */
+function truncateOutput(
+	content: string,
+	config: OutputGuardConfig,
+	ctx: ExtensionContext,
+): TruncationInfo {
+	const totalBytes = Buffer.byteLength(content, "utf-8");
+	const lines = content.split("\n");
+	const totalLines = lines.length;
+
+	// No truncation needed
+	if (totalLines <= config.maxLines && totalBytes <= config.maxBytes) {
+		return {
+			truncated: false,
+			content,
+			totalLines,
+			totalBytes,
+			outputLines: totalLines,
+			outputBytes: totalBytes,
+			truncatedBy: null,
+		};
+	}
+
+	// Collect lines from the end (tail direction)
+	const outputLinesArr: string[] = [];
+	let outputBytesCount = 0;
+	let truncatedBy: "lines" | "bytes" = "lines";
+
+	for (let i = lines.length - 1; i >= 0 && outputLinesArr.length < config.maxLines; i--) {
+		const line = lines[i];
+		const lineBytes = Buffer.byteLength(line, "utf-8") + (outputLinesArr.length > 0 ? 1 : 0);
+
+		if (outputBytesCount + lineBytes > config.maxBytes) {
+			truncatedBy = "bytes";
+			break;
+		}
+
+		outputLinesArr.unshift(line);
+		outputBytesCount += lineBytes;
+	}
+
+	if (outputLinesArr.length >= config.maxLines && outputBytesCount <= config.maxBytes) {
+		truncatedBy = "lines";
+	}
+
+	const truncatedContent = outputLinesArr.join("\n");
+	const finalOutputBytes = Buffer.byteLength(truncatedContent, "utf-8");
+	let fullOutputPath: string | undefined;
+
+	// Save full output to disk (matches OpenCode's behavior)
+	if (config.saveToFile) {
+		fullOutputPath = saveFullOutput(content, ctx);
+	}
+
+	return {
+		truncated: true,
+		content: truncatedContent,
+		totalLines,
+		totalBytes,
+		outputLines: outputLinesArr.length,
+		outputBytes: finalOutputBytes,
+		truncatedBy,
+		fullOutputPath,
+	};
+}
+
+/**
+ * Save full output to disk.
+ * Uses sessionDataDir/tool-output/ to match OpenCode's <data-dir>/tool-output/.
+ * Falls back to tmpdir if sessionDataDir is unavailable.
+ */
+function saveFullOutput(content: string, ctx: ExtensionContext): string | undefined {
+	try {
+		const id = `output-${Date.now()}-${randomBytes(4).toString("hex")}`;
+		// Prefer sessionDataDir if it's an absolute path (production),
+		// otherwise fall back to tmpdir (works reliably in tests too)
+		const rawBaseDir = ctx.sessionDataDir;
+		let baseDir: string;
+		if (rawBaseDir && rawBaseDir.startsWith("/")) {
+			baseDir = rawBaseDir;
+		} else {
+			baseDir = join(tmpdir(), "pi-output-guard");
+		}
+		const dir = join(baseDir, "tool-output");
+		if (!existsSync(dir)) {
+			mkdirSync(dir, { recursive: true });
+		}
+		const filePath = join(dir, `${id}.log`);
+		fsWriteFileSync(filePath, content);
+		return filePath;
+	} catch {
+		return undefined;
+	}
+}
+
+// ============================================================================
+// Extension Entry Point
+// ============================================================================
+
+export default function outputGuard(pi: ExtensionAPI) {
+	// ------------------------------------------------------------------
+	// 1. Global truncation fallback via tool_result hook
+	//
+	// Mirrors OpenCode's Tool.define() wrapper:
+	//   if (result.metadata.truncated === undefined) {
+	//     result.output = Truncate.output(result.output)
+	//   }
+	//
+	// In pi, the equivalent is: if a tool's details doesn't have a
+	// truncation field AND the tool isn't a known self-managing tool,
+	// apply truncation.
+	// ------------------------------------------------------------------
+	pi.on("tool_result", async (event: ToolResultEvent, ctx: ExtensionContext): Promise<ToolResultEventResult | void> => {
+		const config = loadConfig(ctx);
+
+		// Only process text content
+		const textParts = event.content.filter((p): p is { type: "text"; text: string } => p.type === "text");
+		if (textParts.length === 0) return;
+
+		// Skip tools that self-manage truncation
+		// (matches OpenCode's `metadata.truncated !== undefined` check)
+		if (hasSelfManagedTruncation(event)) return;
+
+		// Skip image content - images have their own size management
+		// (matches OpenCode's `metadata.truncated = false` for images)
+		const hasImages = event.content.some((p) => p.type === "image");
+		if (hasImages) return;
+
+		// Concatenate all text parts
+		const fullText = textParts.map((p) => p.text).join("\n");
+		const totalBytes = Buffer.byteLength(fullText, "utf-8");
+		const totalLines = fullText.split("\n").length;
+
+		// Skip if within limits
+		if (totalLines <= config.maxLines && totalBytes <= config.maxBytes) return;
+
+		// Truncate
+		const result = truncateOutput(fullText, config, ctx);
+
+		let finalContent = result.content;
+		if (result.truncated) {
+			const notice = buildTruncationNotice(result, config);
+			finalContent = finalContent + "\n\n" + notice;
+		}
+
+		return {
+			content: [{ type: "text" as const, text: finalContent }],
+		};
+	});
+
+	// ------------------------------------------------------------------
+	// 2. Tool limit optimization via tool_call hook
+	//
+	// OpenCode: glob=100, ls=100
+	// Pi default: find=1000, ls=500
+	// This hook reduces Pi's limits to match OpenCode.
+	// ------------------------------------------------------------------
+	pi.on("tool_call", async (event: ToolCallEvent, ctx: ExtensionContext): Promise<ToolCallEventResult | void> => {
+		const config = loadConfig(ctx);
+
+		// Enforce lower limits on find tool
+		if (event.toolName === "find") {
+			const input = event.input as { limit?: number };
+			if (input.limit === undefined || input.limit > config.findLimit) {
+				input.limit = config.findLimit;
+			}
+		}
+
+		// Enforce lower limits on ls tool
+		if (event.toolName === "ls") {
+			const input = event.input as { limit?: number };
+			if (input.limit === undefined || input.limit > config.lsLimit) {
+				input.limit = config.lsLimit;
+			}
+		}
+	});
+
+	// ------------------------------------------------------------------
+	// 3. PDF text extraction tool
+	//
+	// OpenCode sends PDFs as raw base64 attachments (no text extraction).
+	// Pi's read tool doesn't support PDFs at all (outputs binary garbage).
+	// This tool uses pdf-parse to extract text, which is more token-efficient.
+	// ------------------------------------------------------------------
+	pi.registerTool({
+		name: "pdf_read",
+		description:
+			"Read and extract text content from a PDF file. " +
+			"Returns the text content of the PDF with metadata. " +
+			"Use this instead of the read tool for PDF files.",
+		parameters: Type.Object({
+			path: Type.String({ description: "Path to the PDF file" }),
+			maxPages: Type.Optional(
+				Type.Number({ description: "Maximum number of pages to extract (default: all pages)" }),
+			),
+		}),
+		execute: async (
+			args: { path: string; maxPages?: number },
+			ctx: ExtensionContext,
+		) => {
+			const fs = await import("node:fs/promises");
+			const nodePath = await import("node:path");
+			const absolutePath = nodePath.resolve(ctx.cwd, args.path);
+
+			// Check file exists
+			try {
+				const stat = await fs.stat(absolutePath);
+				if (!stat.isFile()) {
+					return { content: [{ type: "text" as const, text: `Error: ${args.path} is not a file` }], isError: true };
+				}
+			} catch {
+				return { content: [{ type: "text" as const, text: `Error: File not found: ${args.path}` }], isError: true };
+			}
+
+			// Read PDF
+			try {
+				const buffer = await fs.readFile(absolutePath);
+
+				// Dynamic import of pdf-parse (optional dependency)
+				let pdfParse: typeof import("pdf-parse") | undefined;
+				try {
+					pdfParse = (await import("pdf-parse")).default;
+				} catch {
+					return {
+						content: [
+							{
+								type: "text" as const,
+								text: "Error: pdf-parse is not installed. Install it with: npm install pdf-parse",
+							},
+						],
+						isError: true,
+					};
+				}
+
+				const data = await pdfParse(buffer);
+				let text = data.text;
+
+				// Add metadata header
+				const header = [
+					`PDF: ${args.path}`,
+					`Pages: ${data.numpages}`,
+					data.info?.Title ? `Title: ${data.info.Title}` : "",
+					data.info?.Author ? `Author: ${data.info.Author}` : "",
+					"---",
+				]
+					.filter(Boolean)
+					.join("\n");
+
+				// Truncate if needed
+				const config = loadConfig(ctx);
+				const totalBytes = Buffer.byteLength(text, "utf-8");
+				const totalLines = text.split("\n").length;
+
+				if (totalLines > config.maxLines || totalBytes > config.maxBytes) {
+					const truncResult = truncateOutput(text, config, ctx);
+					text = truncResult.content;
+					if (truncResult.truncated) {
+						text += "\n\n" + buildTruncationNotice(truncResult, config);
+					}
+				}
+
+				return {
+					content: [{ type: "text" as const, text: header + "\n" + text }],
+				};
+			} catch (err) {
+				const message = err instanceof Error ? err.message : String(err);
+				return {
+					content: [{ type: "text" as const, text: `Error reading PDF: ${message}` }],
+					isError: true,
+				};
+			}
+		},
+	});
+}
+
+// ============================================================================
+// Helpers
+// ============================================================================
+
+/**
+ * Check if a tool already self-manages truncation.
+ *
+ * Mirrors OpenCode's check: `result.metadata.truncated !== undefined`.
+ * In pi, built-in tools set `details.truncation`, and any tool can opt in
+ * by including a `truncation` field in its details.
+ */
+function hasSelfManagedTruncation(event: ToolResultEvent): boolean {
+	// Built-in tools that self-manage truncation
+	if (SELF_MANAGED_TOOLS.has(event.toolName)) return true;
+
+	// Check if details has a truncation field (any tool can opt in)
+	const details = event.details as Record<string, unknown> | undefined;
+	if (details && typeof details === "object" && "truncation" in details) return true;
+
+	return false;
+}
+
+/**
+ * Build a truncation notice with actionable file path hint.
+ * Matches OpenCode's output format which tells the model where to find
+ * the full output and suggests using read/grep tools.
+ */
+function buildTruncationNotice(info: TruncationInfo, config: OutputGuardConfig): string {
+	const parts: string[] = [];
+
+	if (info.truncatedBy === "lines") {
+		const omitted = info.totalLines - info.outputLines;
+		parts.push(`...${omitted} lines truncated.`);
+		parts.push(`Output exceeded ${config.maxLines} line limit (${info.totalLines} total lines).`);
+	} else if (info.truncatedBy === "bytes") {
+		parts.push(`...output truncated at ${formatBytes(info.outputBytes)}.`);
+		parts.push(`Output exceeded ${formatBytes(config.maxBytes)} byte limit (${formatBytes(info.totalBytes)} total).`);
+	}
+
+	if (info.fullOutputPath) {
+		parts.push(`Full output saved to: ${info.fullOutputPath}`);
+		parts.push("Use the read tool to view the full output.");
+	}
+
+	return parts.join("\n");
+}
+
+function formatBytes(bytes: number): string {
+	if (bytes < 1024) return `${bytes}B`;
+	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+	return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}