pi-compact-tools 0.6.1 → 0.6.3

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Dong Hyeong Lee
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Dong Hyeong Lee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,183 +1,183 @@
-# pi-compact-tools
-
-Compact, expandable rendering for Pi's built-in tools, with a polished GitHub Dark theme.
-
-> Formerly `@nedleeds/pi-compact-ui`. New installations should use `pi-compact-tools`.
-
-## Demo
-
-The recordings below use the optional [Nerd Font](#nerd-font-spinner-preset) spinner preset. **The default configuration does not require a Nerd Font**.
-
-### Compact tool workflow
-
-Active, successful, and failed tool calls stay compact while preserving useful status and timing information.
-
-![Compact tool workflow with Nerd Font](https://raw.githubusercontent.com/nedleeds/pi-compact-tools/main/assets/nerd-font-workflow-optimized.gif)
-
-### Spinner and duration display
-
-The spinner animates during execution, then returns to a green success circle or red failure circle. Elapsed time remains visible in the neutral control color.
-
-![Spinner and elapsed-time display](https://raw.githubusercontent.com/nedleeds/pi-compact-tools/main/assets/spinner-duration-optimized.gif)
-
-### Initially visible edit diffs
-
-Completed `edit` rows show their full diff initially by default. The per-tool `auto_compact` setting controls which tools start with their result hidden without disabling click or `Ctrl+O` interaction.
-
-![Edit diff](https://raw.githubusercontent.com/nedleeds/pi-compact-tools/main/assets/edit-diff.gif)
-
-## Features
-
-- Compact rendering for `read`, `write`, `edit`, `bash`, `powershell`, `grep`, `find`, and `ls`
-- Animated configurable spinner in fullscreen TUI mode
-- Four-step `Ctrl+T` thinking cycle: summary, detail, summary, then hidden
-- Millisecond-precision duration with neutral status text
-- Per-tool initial compaction and global-toggle participation with `auto_compact: true` or `false`
-- Tool invocation details are always fully visible
-- Click toggles one result between hidden and fully visible; `Ctrl+O` toggles all participating rows
-- Full output on expansion and initially visible edit diffs by default
-- Width-cached expanded results and edit-diff processing for responsive fullscreen scrolling
-- Dark `│` and `└─` visual grouping
-- Distinct cool-blue thinking text
-- Windows, Unix, and classic Mac line-ending support
-- No Nerd Font requirement
-
-## Install
-
-```bash
-pi install npm:pi-compact-tools
-```
-
-Or install from GitHub:
-
-```bash
-pi install git:github.com/nedleeds/pi-compact-tools
-```
-
-Restart Pi or run `/reload`.
-
-Migrating from the previous package name:
-
-```bash
-pi remove npm:@nedleeds/pi-compact-ui
-pi install npm:pi-compact-tools
-```
-
-## Theme
-
-Select `github-dark-pro` in Pi's settings, or add it to `~/.pi/agent/settings.json`:
-
-```json
-{
-  "theme": "github-dark-pro"
-}
-```
-
-## Configuration
-
-Configuration is optional. Create `~/.pi/agent/compact-tools.json` for global settings or `<project>/.pi/compact-tools.json` for a trusted project.
-
-Default configuration:
-
-```json
-{
-  "$schema": "https://raw.githubusercontent.com/nedleeds/pi-compact-tools/main/schemas/compact-tools.schema.json",
-  "tools": ["read", "write", "edit", "bash"],
-  "auto_compact": {
-    "read": true,
-    "write": true,
-    "edit": false,
-    "bash": true
-  },
-  "spinner": {
-    "frames": ["◐", "◓", "◑", "◒"],
-    "intervalMs": 120
-  }
-}
-```
-
-Successful call titles use a green `●`, while failed call titles use a red `●`. `Done`, `Failed`, and elapsed time use the same neutral control color. Fast tools finish immediately; no artificial spinner delay is added.
-
-For a minimal blinking spinner, copy [`examples/compact-tools-2.json`](examples/compact-tools-2.json). Its frames use `● ● (blank) ● ●` at 120 ms intervals. The renderer's built-in frame dimming turns this into a fade-out/fade-in animation. Rename it to `compact-tools.json` or copy its contents to the active configuration path.
-
-`auto_compact` controls each tool's initial state and whether it participates in the global `Ctrl+O` toggle:
-
-- `true` starts with the result hidden and participates in `Ctrl+O`.
-- `false` starts with the full result visible and is unaffected by `Ctrl+O`.
-- Clicking any compact-rendered row still toggles that row's result.
-
-Unspecified entries inherit the previous configuration layer. By default, `read`, `write`, and `bash` start compact and participate in the global toggle, while `edit` starts expanded and remains unaffected so code diffs stay visible.
-
-To enable all Unix-compatible tools:
-
-```json
-{
-  "tools": ["read", "write", "edit", "bash", "grep", "find", "ls"]
-}
-```
-
-Add `"powershell"` on Windows if desired.
-
-## Nerd Font spinner preset
-
-If your terminal uses a [Nerd Font](https://www.nerdfonts.com/), this preset enables all eight tools and the spinner shown in the demos:
-
-```json
-{
-  "$schema": "https://raw.githubusercontent.com/nedleeds/pi-compact-tools/main/schemas/compact-tools.schema.json",
-  "tools": ["read", "write", "edit", "bash", "powershell", "grep", "find", "ls"],
-  "spinner": {
-    "frames": ["✽", "✻", "✲", "✢", "✲", "✻"],
-    "intervalMs": 80
-  }
-}
-```
-
-Remove `"powershell"` on systems where it is unavailable.
-
-## Controls
-
-`Ctrl+T` cycles every thinking block through:
-
-```text
-one-line summary → summary + │-indented detail → one-line summary → Thinking...
-```
-
-Standalone bold lines and Markdown headings split one provider thinking run into logical sections. Each section gets its own summary, optional `│`-indented detail, and control row; `Ctrl+T` cycles all sections together. While thinking streams, a text-color highlight sweeps across summaries using streaming updates; no spinner glyph or title circle is shown. The transformation is display-only; complete thinking remains unchanged in the session and model context.
-
-Relevant invocation details stay visible, including paths, patterns, shell commands, and auxiliary arguments. After `grep`, `find`, or `ls` completes, auxiliary arguments appear in parentheses beside the `Done in …s` status instead of in the invocation line or a JSON block. Read calls omit offset and limit noise, then report the number of lines read after completion. Large payloads represented as results, such as write content and edit diffs, follow the result toggle.
-
-A mouse click toggles one row's result:
-
-```text
-result hidden ↔ full result
-```
-
-`Ctrl+O` operates on all rows whose tool has `auto_compact: true`:
-
-- If any participating row is not fully expanded, it expands all participating rows.
-- If every participating row is fully expanded, it collapses all participating rows.
-- Rows whose tool has `auto_compact: false` are left unchanged.
-
-The extension handles and consumes `Ctrl+O` directly, so no Pi keybinding changes are required. With the default `edit: false`, edit diffs start visible and are excluded from the global toggle, while clicking an edit row still collapses or expands it.
-
-## Notes
-
-- Pi `0.85.1+` and Node.js 20+ are recommended.
-- Fullscreen TUI mode is required for spinner animation and mouse interaction; `Ctrl+O` also works in regular mode.
-- Duration covers the full rendered tool-call lifecycle, including streamed `write` and `edit` arguments.
-- Selected tools override Pi's built-in definitions; other extensions overriding the same names may conflict by load order.
-
-## Development
-
-```bash
-npm install
-npm run check
-pi -e .
-```
-
-Pi extensions execute with full system access. Review third-party extension source before installation.
-
-## License
-
-MIT
+# pi-compact-tools
+
+Compact, expandable rendering for Pi's built-in tools, with a polished GitHub Dark theme.
+
+> Formerly `@nedleeds/pi-compact-ui`. New installations should use `pi-compact-tools`.
+
+## Demo
+
+The recordings below use the optional [Nerd Font](#nerd-font-spinner-preset) spinner preset. **The default configuration does not require a Nerd Font**.
+
+### Compact tool workflow
+
+Active, successful, and failed tool calls stay compact while preserving useful status and timing information.
+
+![Compact tool workflow with Nerd Font](https://raw.githubusercontent.com/nedleeds/pi-compact-tools/main/assets/nerd-font-workflow-optimized.gif)
+
+### Spinner and duration display
+
+The spinner animates during execution, then returns to a green success circle or red failure circle. Elapsed time remains visible in the neutral control color.
+
+![Spinner and elapsed-time display](https://raw.githubusercontent.com/nedleeds/pi-compact-tools/main/assets/spinner-duration-optimized.gif)
+
+### Initially visible edit diffs
+
+Completed `edit` rows show their full diff initially by default. The per-tool `auto_compact` setting controls which tools start with their result hidden without disabling click or `Ctrl+O` interaction.
+
+![Edit diff](https://raw.githubusercontent.com/nedleeds/pi-compact-tools/main/assets/edit-diff.gif)
+
+## Features
+
+- Compact rendering for `read`, `write`, `edit`, `bash`, `powershell`, `grep`, `find`, and `ls`
+- Animated configurable spinner in fullscreen TUI mode
+- Four-step `Ctrl+T` thinking cycle when provider detail is available: summary, detail, summary, then hidden
+- Millisecond-precision duration and completed output line counts with neutral status text
+- Per-tool initial compaction and global-toggle participation with `auto_compact: true` or `false`
+- Primary invocation targets such as paths, patterns, and shell commands stay visible
+- Click toggles one result between hidden and fully visible; `Ctrl+O` toggles all participating rows
+- Full output on expansion and initially visible edit diffs by default
+- Width-cached expanded results and edit-diff processing for responsive fullscreen scrolling
+- Dark `│` and `└─` visual grouping
+- Distinct cool-blue thinking text
+- Windows, Unix, and classic Mac line-ending support
+- No Nerd Font requirement
+
+## Install
+
+```bash
+pi install npm:pi-compact-tools
+```
+
+Or install from GitHub:
+
+```bash
+pi install git:github.com/nedleeds/pi-compact-tools
+```
+
+Restart Pi or run `/reload`.
+
+Migrating from the previous package name:
+
+```bash
+pi remove npm:@nedleeds/pi-compact-ui
+pi install npm:pi-compact-tools
+```
+
+## Theme
+
+Select `github-dark-pro` in Pi's settings, or add it to `~/.pi/agent/settings.json`:
+
+```json
+{
+  "theme": "github-dark-pro"
+}
+```
+
+## Configuration
+
+Configuration is optional. Create `~/.pi/agent/compact-tools.json` for global settings or `<project>/.pi/compact-tools.json` for a trusted project.
+
+Default configuration:
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/nedleeds/pi-compact-tools/main/schemas/compact-tools.schema.json",
+  "tools": ["read", "write", "edit", "bash"],
+  "auto_compact": {
+    "read": true,
+    "write": true,
+    "edit": false,
+    "bash": true
+  },
+  "spinner": {
+    "frames": ["◐", "◓", "◑", "◒"],
+    "intervalMs": 120
+  }
+}
+```
+
+Successful call titles use a green `●`, while failed call titles use a red `●`. `Done`, `Failed`, and elapsed time use the same neutral control color. Fast tools finish immediately; no artificial spinner delay is added.
+
+For a minimal blinking spinner, copy [`examples/compact-tools-2.json`](examples/compact-tools-2.json). Its frames use `● ● (blank) ● ●` at 120 ms intervals. The renderer's built-in frame dimming turns this into a fade-out/fade-in animation. Rename it to `compact-tools.json` or copy its contents to the active configuration path.
+
+`auto_compact` controls each tool's initial state and whether it participates in the global `Ctrl+O` toggle:
+
+- `true` starts with the result hidden and participates in `Ctrl+O`.
+- `false` starts with the full result visible and is unaffected by `Ctrl+O`.
+- Clicking any compact-rendered row still toggles that row's result.
+
+Unspecified entries inherit the previous configuration layer. By default, `read`, `write`, and `bash` start compact and participate in the global toggle, while `edit` starts expanded and remains unaffected so code diffs stay visible.
+
+To enable all Unix-compatible tools:
+
+```json
+{
+  "tools": ["read", "write", "edit", "bash", "grep", "find", "ls"]
+}
+```
+
+Add `"powershell"` on Windows if desired.
+
+## Nerd Font spinner preset
+
+If your terminal uses a [Nerd Font](https://www.nerdfonts.com/), this preset enables all eight tools and the spinner shown in the demos:
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/nedleeds/pi-compact-tools/main/schemas/compact-tools.schema.json",
+  "tools": ["read", "write", "edit", "bash", "powershell", "grep", "find", "ls"],
+  "spinner": {
+    "frames": ["✽", "✻", "✲", "✢", "✲", "✻"],
+    "intervalMs": 80
+  }
+}
+```
+
+Remove `"powershell"` on systems where it is unavailable.
+
+## Controls
+
+`Ctrl+T` cycles every thinking block through:
+
+```text
+one-line summary → summary + │-indented detail → one-line summary → Thinking...
+```
+
+Standalone bold lines and Markdown headings split one provider thinking run into logical sections. Each section gets its own summary and optional `│`-indented detail. The control row appears only on sections for which the provider returned expandable detail; when no thinking detail exists, no toggle hint is shown and `Ctrl+T` falls back to Pi's normal visible/hidden toggle instead of showing a duplicate detail phase. While thinking streams, a text-color highlight sweeps across summaries using streaming updates; no spinner glyph or title circle is shown. The transformation is display-only; complete thinking remains unchanged in the session and model context.
+
+Primary invocation targets stay visible, including paths, patterns, and shell commands. After every supported tool completes, the status reports the expanded result size as `Done in …s (N lines)` instead of repeating options such as context and limit. Counts use the returned text for reads, searches, listings, and shell commands, written content for `write`, and the rendered diff for `edit`. The count is computed once after completion and cached with the row, so streaming and repeated expansion do not add ongoing work. Large payloads represented as results, such as write content and edit diffs, follow the result toggle.
+
+A mouse click toggles one row's result:
+
+```text
+result hidden ↔ full result
+```
+
+`Ctrl+O` operates on all rows whose tool has `auto_compact: true`:
+
+- If any participating row is not fully expanded, it expands all participating rows.
+- If every participating row is fully expanded, it collapses all participating rows.
+- Rows whose tool has `auto_compact: false` are left unchanged.
+
+The extension handles and consumes `Ctrl+O` directly, so no Pi keybinding changes are required. With the default `edit: false`, edit diffs start visible and are excluded from the global toggle, while clicking an edit row still collapses or expands it.
+
+## Notes
+
+- Pi `0.85.1+` and Node.js 20+ are recommended.
+- Fullscreen TUI mode is required for spinner animation and mouse interaction; `Ctrl+O` also works in regular mode.
+- Duration covers the full rendered tool-call lifecycle, including streamed `write` and `edit` arguments.
+- Selected tools override Pi's built-in definitions; other extensions overriding the same names may conflict by load order.
+
+## Development
+
+```bash
+npm install
+npm run check
+pi -e .
+```
+
+Pi extensions execute with full system access. Review third-party extension source before installation.
+
+## License
+
+MIT

package/extensions/compact-tools-invocation.ts

@@ -1,93 +1,117 @@
-import type { AgentToolResult } from "@earendil-works/pi-coding-agent";
-import { normalizeLineEndings } from "./compact-tools-core.ts";
-import type { ToolArgs } from "./compact-tools-types.ts";
-
-function pathFrom(args: ToolArgs): string {
-	const value = args.path ?? args.file_path;
-	return typeof value === "string" ? normalizeLineEndings(value) : "";
-}
-
-const INLINE_ARGUMENT_TOOLS = new Set(["grep", "find", "ls"]);
-
-function omitArgument(name: string, key: string): boolean {
-	if (key === "path" || key === "file_path") return true;
-	if (name === "read" && (key === "offset" || key === "limit")) return true;
-	if (name === "write" && key === "content") return true;
-	return (name === "grep" || name === "find") && key === "pattern";
-}
-
-function collectArgumentDetails(name: string, args: ToolArgs): ToolArgs {
-	const details: ToolArgs = {};
-	for (const [key, value] of Object.entries(args)) {
-		if (value !== undefined && !omitArgument(name, key)) details[key] = value;
-	}
-	return details;
-}
-
-function formatInlineValue(value: unknown): string {
-	if (typeof value === "string") {
-		const compact = normalizeLineEndings(value).replace(/\s+/gu, " ").trim();
-		return compact || '""';
-	}
-	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
-		return String(value);
-	}
-	return JSON.stringify(value) ?? String(value);
-}
-
-export function formatArgumentSummary(name: string, args: ToolArgs): string | undefined {
-	if (!INLINE_ARGUMENT_TOOLS.has(name)) return undefined;
-	const arguments_ = Object.entries(collectArgumentDetails(name, args));
-	if (arguments_.length === 0) return undefined;
-	return arguments_.map(([key, value]) => `${key} ${formatInlineValue(value)}`).join(" · ");
-}
-
-export function getCallDetails(name: string, args: ToolArgs): string {
-	const path = pathFrom(args) || (INLINE_ARGUMENT_TOOLS.has(name) ? "." : "");
-	if (name === "read") return path;
-	if (name !== "grep" && name !== "find") return path;
-	const pattern = typeof args.pattern === "string" ? normalizeLineEndings(args.pattern) : "…";
-	return name === "grep" ? `/${pattern}/ in ${path}` : `${pattern} in ${path}`;
-}
-
-export function getArgumentDetails(name: string, args: ToolArgs): ToolArgs {
-	if (name === "edit" || INLINE_ARGUMENT_TOOLS.has(name)) return {};
-	return collectArgumentDetails(name, args);
-}
-
-export function getTextResult(result: AgentToolResult<unknown>): string {
-	const parts: string[] = [];
-	for (const item of result.content) {
-		if (item.type === "text") parts.push(item.text);
-	}
-	return normalizeLineEndings(parts.join("\n")).trimEnd();
-}
-
-export function formatReadResultSummary(result: AgentToolResult<unknown>): string | undefined {
-	if (!result.content.some((item) => item.type === "text")) return undefined;
-	const truncation = (result.details as {
-		truncation?: { firstLineExceedsLimit?: boolean; outputLines?: number };
-	} | undefined)?.truncation;
-	if (truncation?.firstLineExceedsLimit) return undefined;
-	let lineCount = truncation?.outputLines;
-	if (!Number.isInteger(lineCount) || lineCount === undefined || lineCount < 0) {
-		const content = getTextResult(result).replace(
-			/\n\n\[(?:Showing lines |\d+ more lines in file\.)[^\n]*\]$/u,
-			"",
-		);
-		lineCount = content.length === 0 ? 0 : content.split("\n").length;
-	}
-	return `${lineCount} ${lineCount === 1 ? "line" : "lines"}`;
-}
-
-export function getFileOutput(
-	name: string,
-	args: ToolArgs,
-	result: AgentToolResult<unknown>,
-	isError: boolean,
-): string {
-	if (isError || name === "read" || name === "grep" || name === "find" || name === "ls") {
-		return getTextResult(result);
-	}
-	return name === "write" ? String(args.content ?? "") : "";
-}
+import type { AgentToolResult } from "@earendil-works/pi-coding-agent";
+import { normalizeLineEndings } from "./compact-tools-core.ts";
+import type { ToolArgs } from "./compact-tools-types.ts";
+
+function pathFrom(args: ToolArgs): string {
+	const value = args.path ?? args.file_path;
+	return typeof value === "string" ? normalizeLineEndings(value) : "";
+}
+
+const INLINE_ARGUMENT_TOOLS = new Set(["grep", "find", "ls"]);
+
+function omitArgument(name: string, key: string): boolean {
+	if (key === "path" || key === "file_path") return true;
+	if (name === "read" && (key === "offset" || key === "limit")) return true;
+	if (name === "write" && key === "content") return true;
+	return (name === "grep" || name === "find") && key === "pattern";
+}
+
+function collectArgumentDetails(name: string, args: ToolArgs): ToolArgs {
+	const details: ToolArgs = {};
+	for (const [key, value] of Object.entries(args)) {
+		if (value !== undefined && !omitArgument(name, key)) details[key] = value;
+	}
+	return details;
+}
+
+export function getCallDetails(name: string, args: ToolArgs): string {
+	const path = pathFrom(args) || (INLINE_ARGUMENT_TOOLS.has(name) ? "." : "");
+	if (name === "read") return path;
+	if (name !== "grep" && name !== "find") return path;
+	const pattern = typeof args.pattern === "string" ? normalizeLineEndings(args.pattern) : "…";
+	return name === "grep" ? `/${pattern}/ in ${path}` : `${pattern} in ${path}`;
+}
+
+export function getArgumentDetails(name: string, args: ToolArgs): ToolArgs {
+	if (name === "edit" || INLINE_ARGUMENT_TOOLS.has(name)) return {};
+	return collectArgumentDetails(name, args);
+}
+
+export function getTextResult(result: AgentToolResult<unknown>): string {
+	const parts: string[] = [];
+	for (const item of result.content) {
+		if (item.type === "text") parts.push(item.text);
+	}
+	return normalizeLineEndings(parts.join("\n")).trimEnd();
+}
+
+type ResultDetails = {
+	diff?: unknown;
+	truncation?: {
+		firstLineExceedsLimit?: boolean;
+		outputLines?: number;
+	};
+	matchLimitReached?: unknown;
+	resultLimitReached?: unknown;
+	entryLimitReached?: unknown;
+	linesTruncated?: unknown;
+};
+
+function countTextLines(text: string): number {
+	const normalized = normalizeLineEndings(text).trimEnd();
+	if (!normalized) return 0;
+	let count = 1;
+	for (let index = 0; index < normalized.length; index++) {
+		if (normalized.charCodeAt(index) === 10) count++;
+	}
+	return count;
+}
+
+function stripGeneratedFooter(name: string, text: string, details: ResultDetails | undefined): string {
+	if (name === "read") {
+		return text.replace(/\n\n\[(?:Showing lines |\d+ more lines in file\.)[^\n]*\]$/u, "");
+	}
+	const hasGeneratedFooter = details?.truncation?.outputLines !== undefined
+		|| details?.matchLimitReached !== undefined
+		|| details?.resultLimitReached !== undefined
+		|| details?.entryLimitReached !== undefined
+		|| details?.linesTruncated !== undefined;
+	return hasGeneratedFooter ? text.replace(/\n\n\[[^\n]*\]$/u, "") : text;
+}
+
+export function formatResultLineSummary(
+	name: string,
+	args: ToolArgs,
+	result: AgentToolResult<unknown>,
+	output?: string,
+): string | undefined {
+	const details = result.details as ResultDetails | undefined;
+	const text = name === "edit" && typeof details?.diff === "string"
+		? details.diff
+		: output ?? (name === "write"
+			? String(args.content ?? "")
+			: result.content.some((item) => item.type === "text")
+				? getTextResult(result)
+				: undefined);
+	if (text === undefined) return undefined;
+	const truncationLines = details?.truncation?.outputLines;
+	const lineCount = !details?.truncation?.firstLineExceedsLimit
+		&& typeof truncationLines === "number"
+		&& Number.isInteger(truncationLines)
+		&& truncationLines >= 0
+		? truncationLines
+		: countTextLines(stripGeneratedFooter(name, text, details));
+	return `${lineCount} ${lineCount === 1 ? "line" : "lines"}`;
+}
+
+export function getFileOutput(
+	name: string,
+	args: ToolArgs,
+	result: AgentToolResult<unknown>,
+	isError: boolean,
+): string {
+	if (isError || name === "read" || name === "grep" || name === "find" || name === "ls") {
+		return getTextResult(result);
+	}
+	return name === "write" ? String(args.content ?? "") : "";
+}