@selesai/code 0.13.16 → 0.13.18

package/dist/core/tools/read.js

@@ -1,18 +1,12 @@
-import { basename, dirname, isAbsolute, relative, resolve as resolvePath, sep } from "node:path";
-import { Text } from "@earendil-works/pi-tui";
 import { constants } from "fs";
 import { access as fsAccess, readFile as fsReadFile } from "fs/promises";
 import { Type } from "typebox";
-import { getReadmePath } from "../../config.js";
-import { keyHint, keyText } from "../../modes/interactive/components/keybinding-hints.js";
-import { getLanguageFromPath, highlightCode } from "../../modes/interactive/theme/theme.js";
 import { processImage } from "../../utils/image-process.js";
 import { detectSupportedImageMimeTypeFromFile } from "../../utils/mime.js";
-import { formatPathRelativeToCwdOrAbsolute } from "../../utils/paths.js";
 import { getExperimentalToolSampling } from "../experimental.js";
 import { captionImageWithModel } from "../vision-caption.js";
-import { resolveReadPathAsync, resolveToCwd } from "./path-utils.js";
-import { getTextOutput, renderToolPath, replaceTabs, str } from "./render-utils.js";
+import { resolveReadPathAsync } from "./path-utils.js";
+import { readRenderers } from "./renderers/read.js";
 import { wrapToolDefinition } from "./tool-definition-wrapper.js";
 import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, truncateHead } from "./truncate.js";
 const readSchema = Type.Object({
@@ -20,30 +14,15 @@ const readSchema = Type.Object({
     offset: Type.Optional(Type.Number({ description: "Line number to start reading from (1-indexed)" })),
     limit: Type.Optional(Type.Number({ description: "Maximum number of lines to read" })),
 });
-const COMPACT_RESOURCE_FILE_NAMES = new Set(["AGENTS.md", "AGENTS.MD", "CLAUDE.md", "CLAUDE.MD"]);
+export const readToolSystemPromptContribution = {
+    snippet: "Read file contents",
+    guidelines: ["Use read to examine files instead of cat or sed."],
+};
 const defaultReadOperations = {
     readFile: (path) => fsReadFile(path),
     access: (path) => fsAccess(path, constants.R_OK),
     detectImageMimeType: detectSupportedImageMimeTypeFromFile,
 };
-function formatReadLineRange(args, theme) {
-    if (args?.offset === undefined && args?.limit === undefined)
-        return "";
-    const startLine = args.offset ?? 1;
-    const endLine = args.limit !== undefined ? startLine + args.limit - 1 : "";
-    return theme.fg("warning", `:${startLine}${endLine ? `-${endLine}` : ""}`);
-}
-function formatReadCall(args, theme, cwd) {
-    const pathDisplay = renderToolPath(str(args?.file_path ?? args?.path), theme, cwd);
-    return `${theme.fg("toolTitle", theme.bold("read"))} ${pathDisplay}${formatReadLineRange(args, theme)}`;
-}
-function trimTrailingEmptyLines(lines) {
-    let end = lines.length;
-    while (end > 0 && lines[end - 1] === "") {
-        end--;
-    }
-    return lines.slice(0, end);
-}
 function getNonVisionImageNote(model) {
     if (!model || model.input.includes("image")) {
         return undefined;
@@ -80,85 +59,6 @@ export async function captionImage(image, captionModelId, ctx, signal) {
         signal,
     });
 }
-function toPosixPath(filePath) {
-    return filePath.split(sep).join("/");
-}
-function getPiDocsClassification(absolutePath) {
-    const packageRoot = dirname(getReadmePath());
-    const relativePath = relative(resolvePath(packageRoot), resolvePath(absolutePath));
-    if (relativePath === "" ||
-        relativePath === ".." ||
-        relativePath.startsWith(`..${sep}`) ||
-        isAbsolute(relativePath)) {
-        return undefined;
-    }
-    const label = toPosixPath(relativePath);
-    if (label === "README.md" || label.startsWith("docs/") || label.startsWith("examples/")) {
-        return { kind: "docs", label };
-    }
-    return undefined;
-}
-function getCompactReadClassification(args, cwd) {
-    const rawPath = str(args?.file_path ?? args?.path);
-    if (!rawPath)
-        return undefined;
-    const absolutePath = resolveToCwd(rawPath, cwd);
-    const fileName = basename(absolutePath);
-    if (fileName === "SKILL.md") {
-        return { kind: "skill", label: basename(dirname(absolutePath)) || fileName };
-    }
-    const docsClassification = getPiDocsClassification(absolutePath);
-    if (docsClassification)
-        return docsClassification;
-    if (COMPACT_RESOURCE_FILE_NAMES.has(fileName)) {
-        return { kind: "resource", label: formatPathRelativeToCwdOrAbsolute(absolutePath, cwd) };
-    }
-    return undefined;
-}
-function formatCompactReadCall(classification, args, theme) {
-    const expandHint = theme.fg("dim", ` (${keyText("app.tools.expand")} to expand)`);
-    if (classification.kind === "skill") {
-        return (theme.fg("customMessageLabel", `\x1b[1m[skill]\x1b[22m `) +
-            theme.fg("customMessageText", classification.label) +
-            formatReadLineRange(args, theme) +
-            expandHint);
-    }
-    return (theme.fg("toolTitle", theme.bold(`read ${classification.kind}`)) +
-        " " +
-        theme.fg("accent", classification.label) +
-        formatReadLineRange(args, theme) +
-        expandHint);
-}
-function formatReadResult(args, result, options, theme, showImages, _cwd, isError) {
-    if (!options.expanded && !isError) {
-        return "";
-    }
-    const rawPath = str(args?.file_path ?? args?.path);
-    const output = getTextOutput(result, showImages);
-    const lang = !isError && rawPath ? getLanguageFromPath(rawPath) : undefined;
-    const renderedLines = lang ? highlightCode(replaceTabs(output), lang) : output.split("\n");
-    const lines = trimTrailingEmptyLines(renderedLines);
-    const maxLines = options.expanded ? lines.length : 10;
-    const displayLines = lines.slice(0, maxLines);
-    const remaining = lines.length - maxLines;
-    let text = `\n${displayLines.map((line) => (lang ? replaceTabs(line) : theme.fg("toolOutput", replaceTabs(line)))).join("\n")}`;
-    if (remaining > 0) {
-        text += `${theme.fg("muted", `\n... (${remaining} more lines,`)} ${keyHint("app.tools.expand", "to expand")}${theme.fg("muted", ")")}`;
-    }
-    const truncation = result.details?.truncation;
-    if (truncation?.truncated) {
-        if (truncation.firstLineExceedsLimit) {
-            text += `\n${theme.fg("warning", `[First line exceeds ${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit]`)}`;
-        }
-        else if (truncation.truncatedBy === "lines") {
-            text += `\n${theme.fg("warning", `[Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines (${truncation.maxLines ?? DEFAULT_MAX_LINES} line limit)]`)}`;
-        }
-        else {
-            text += `\n${theme.fg("warning", `[Truncated: ${truncation.outputLines} lines shown (${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit)]`)}`;
-        }
-    }
-    return text;
-}
 export function createReadToolDefinition(cwd, options) {
     const autoResizeImages = options?.autoResizeImages ?? true;
     const imageCaptionModel = options?.imageCaptionModel;
@@ -167,8 +67,8 @@ export function createReadToolDefinition(cwd, options) {
         name: "read",
         label: "read",
         description: `Read the contents of a file. Supports text files and images (jpg, png, gif, webp, bmp). Images are sent as attachments. For text files, output is truncated to ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Use offset/limit for large files. When you need the full file, continue with offset until complete.`,
-        promptSnippet: "Read file contents",
-        promptGuidelines: ["Use read to examine files instead of cat or sed."],
+        promptSnippet: readToolSystemPromptContribution.snippet,
+        promptGuidelines: [...readToolSystemPromptContribution.guidelines],
         parameters: readSchema,
         constrainedSampling: getExperimentalToolSampling(),
         async execute(_toolCallId, { path, offset, limit }, signal, _onUpdate, ctx) {
@@ -185,7 +85,7 @@ export function createReadToolDefinition(cwd, options) {
                 signal?.addEventListener("abort", onAbort, { once: true });
                 (async () => {
                     try {
-                        const absolutePath = await resolveReadPathAsync(path, cwd);
+                        const absolutePath = await resolveReadPathAsync(path, ctx?.cwd || cwd);
                         if (aborted)
                             return;
                         // Check if file exists and is readable.
@@ -307,19 +207,7 @@ export function createReadToolDefinition(cwd, options) {
                 })();
             });
         },
-        renderCall(args, theme, context) {
-            const text = context.lastComponent ?? new Text("", 0, 0);
-            const classification = !context.expanded ? getCompactReadClassification(args, context.cwd) : undefined;
-            text.setText(classification
-                ? formatCompactReadCall(classification, args, theme)
-                : formatReadCall(args, theme, context.cwd));
-            return text;
-        },
-        renderResult(result, options, theme, context) {
-            const text = context.lastComponent ?? new Text("", 0, 0);
-            text.setText(formatReadResult(context.args, result, options, theme, context.showImages, context.cwd, context.isError));
-            return text;
-        },
+        ...readRenderers,
     };
 }
 export function createReadTool(cwd, options) {

package/dist/core/tools/renderers/bash.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Presentation for the shell tools.
+ *
+ * Renderers live apart from the implementation so a process that only displays tool output does not
+ * load the execution path or its typebox parameter schema. `bash.ts` spreads these into the shell
+ * tool definition, so the tool's public shape is unchanged.
+ */
+import type { ToolDefinition } from "../../extensions/types.ts";
+export declare const BASH_UPDATE_THROTTLE_MS = 100;
+/** Shell renderers are shared by bash and powershell, which differ only in the prompt they display. */
+export declare function createShellRenderers(prompt: string): Pick<ToolDefinition<any, any>, "renderCall" | "renderResult">;

package/dist/core/tools/renderers/bash.js

@@ -0,0 +1,129 @@
+/**
+ * Presentation for the shell tools.
+ *
+ * Renderers live apart from the implementation so a process that only displays tool output does not
+ * load the execution path or its typebox parameter schema. `bash.ts` spreads these into the shell
+ * tool definition, so the tool's public shape is unchanged.
+ */
+import { Container, Text, truncateToWidth } from "@earendil-works/pi-tui";
+import { keyHint } from "../../../modes/interactive/components/keybinding-hints.js";
+import { truncateToVisualLines } from "../../../modes/interactive/components/visual-truncate.js";
+import { theme } from "../../../modes/interactive/theme/theme.js";
+import { getTextOutput, invalidArgText, str } from "../render-utils.js";
+import { DEFAULT_MAX_BYTES, formatSize } from "../truncate.js";
+const BASH_PREVIEW_LINES = 5;
+export const BASH_UPDATE_THROTTLE_MS = 100;
+class BashResultRenderComponent extends Container {
+    state = {
+        cachedWidth: undefined,
+        cachedLines: undefined,
+        cachedSkipped: undefined,
+    };
+}
+function formatDuration(ms) {
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+function formatShellCall(args, prompt) {
+    const command = str(args?.command);
+    const timeout = args?.timeout;
+    const timeoutSuffix = timeout ? theme.fg("muted", ` (timeout ${timeout}s)`) : "";
+    const commandDisplay = command === null ? invalidArgText(theme) : command ? command : theme.fg("toolOutput", "...");
+    return theme.fg("toolTitle", theme.bold(`${prompt} ${commandDisplay}`)) + timeoutSuffix;
+}
+function rebuildBashResultRenderComponent(component, result, options, showImages, startedAt, endedAt) {
+    const state = component.state;
+    component.clear();
+    let output = getTextOutput(result, showImages).trim();
+    const truncation = result.details?.truncation;
+    const fullOutputPath = result.details?.fullOutputPath;
+    if (!options.isPartial && truncation?.truncated && fullOutputPath && output.endsWith("]")) {
+        const footerStart = output.lastIndexOf("\n\n[");
+        if (footerStart !== -1 && output.slice(footerStart).includes(fullOutputPath)) {
+            output = output.slice(0, footerStart).trimEnd();
+        }
+    }
+    if (output) {
+        const styledOutput = output
+            .split("\n")
+            .map((line) => theme.fg("toolOutput", line))
+            .join("\n");
+        if (options.expanded) {
+            component.addChild(new Text(`\n${styledOutput}`, 0, 0));
+        }
+        else {
+            component.addChild({
+                render: (width) => {
+                    if (state.cachedLines === undefined || state.cachedWidth !== width) {
+                        const preview = truncateToVisualLines(styledOutput, BASH_PREVIEW_LINES, width);
+                        state.cachedLines = preview.visualLines;
+                        state.cachedSkipped = preview.skippedCount;
+                        state.cachedWidth = width;
+                    }
+                    if (state.cachedSkipped && state.cachedSkipped > 0) {
+                        const hint = theme.fg("muted", `... (${state.cachedSkipped} earlier lines,`) +
+                            ` ${keyHint("app.tools.expand", "to expand")}${theme.fg("muted", ")")}`;
+                        return ["", truncateToWidth(hint, width, "..."), ...(state.cachedLines ?? [])];
+                    }
+                    return ["", ...(state.cachedLines ?? [])];
+                },
+                invalidate: () => {
+                    state.cachedWidth = undefined;
+                    state.cachedLines = undefined;
+                    state.cachedSkipped = undefined;
+                },
+            });
+        }
+    }
+    if (truncation?.truncated || fullOutputPath) {
+        const warnings = [];
+        if (fullOutputPath) {
+            warnings.push(`Full output: ${fullOutputPath}`);
+        }
+        if (truncation?.truncated) {
+            if (truncation.truncatedBy === "lines") {
+                warnings.push(`Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines`);
+            }
+            else {
+                warnings.push(`Truncated: ${truncation.outputLines} lines shown (${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit)`);
+            }
+        }
+        component.addChild(new Text(`\n${theme.fg("warning", `[${warnings.join(". ")}]`)}`, 0, 0));
+    }
+    if (startedAt !== undefined) {
+        const label = options.isPartial ? "Elapsed" : "Took";
+        const endTime = endedAt ?? Date.now();
+        component.addChild(new Text(`\n${theme.fg("muted", `${label} ${formatDuration(endTime - startedAt)}`)}`, 0, 0));
+    }
+}
+/** Shell renderers are shared by bash and powershell, which differ only in the prompt they display. */
+export function createShellRenderers(prompt) {
+    return {
+        renderCall(args, _theme, context) {
+            const state = context.state;
+            if (context.executionStarted && state.startedAt === undefined) {
+                state.startedAt = Date.now();
+                state.endedAt = undefined;
+            }
+            const text = context.lastComponent ?? new Text("", 0, 0);
+            text.setText(formatShellCall(args, prompt));
+            return text;
+        },
+        renderResult(result, options, _theme, context) {
+            const state = context.state;
+            if (state.startedAt !== undefined && options.isPartial && !state.interval) {
+                state.interval = setInterval(() => context.invalidate(), 1000);
+            }
+            if (!options.isPartial || context.isError) {
+                state.endedAt ??= Date.now();
+                if (state.interval) {
+                    clearInterval(state.interval);
+                    state.interval = undefined;
+                }
+            }
+            const component = context.lastComponent ?? new BashResultRenderComponent();
+            rebuildBashResultRenderComponent(component, result, options, context.showImages, state.startedAt, state.endedAt);
+            component.invalidate();
+            return component;
+        },
+    };
+}

package/dist/core/tools/renderers/edit.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Presentation for the edit tool.
+ *
+ * Renderers live apart from the implementation so a process that only displays tool output does not
+ * load the execution path or its typebox parameter schema. `edit.ts` spreads these into its
+ * definition, so the tool's public shape is unchanged.
+ */
+import { Box } from "@earendil-works/pi-tui";
+import type { ToolDefinition } from "../../extensions/types.ts";
+import { type EditDiffError, type EditDiffResult } from "../edit-diff.ts";
+type EditPreview = EditDiffResult | EditDiffError;
+export type EditRenderState = {
+    callComponent?: EditCallRenderComponent;
+};
+type EditCallRenderComponent = Box & {
+    preview?: EditPreview;
+    previewArgsKey?: string;
+    previewPending?: boolean;
+    settledError?: boolean;
+};
+export declare const editRenderers: Pick<ToolDefinition<any, any>, "renderCall" | "renderResult">;
+export {};

package/dist/core/tools/renderers/edit.js

@@ -0,0 +1,166 @@
+/**
+ * Presentation for the edit tool.
+ *
+ * Renderers live apart from the implementation so a process that only displays tool output does not
+ * load the execution path or its typebox parameter schema. `edit.ts` spreads these into its
+ * definition, so the tool's public shape is unchanged.
+ */
+import { Box, Container, Spacer, Text } from "@earendil-works/pi-tui";
+import { renderDiff } from "../../../modes/interactive/components/diff.js";
+import { computeEditsDiff } from "../edit-diff.js";
+import { renderToolPath, str } from "../render-utils.js";
+function createEditCallRenderComponent() {
+    return Object.assign(new Box(1, 1, (text) => text), {
+        preview: undefined,
+        previewArgsKey: undefined,
+        previewPending: false,
+        settledError: false,
+    });
+}
+function getEditCallRenderComponent(state, lastComponent) {
+    if (lastComponent instanceof Box) {
+        const component = lastComponent;
+        state.callComponent = component;
+        return component;
+    }
+    if (state.callComponent) {
+        return state.callComponent;
+    }
+    const component = createEditCallRenderComponent();
+    state.callComponent = component;
+    return component;
+}
+function getRenderablePreviewInput(args) {
+    if (!args) {
+        return null;
+    }
+    const path = typeof args.path === "string" ? args.path : typeof args.file_path === "string" ? args.file_path : null;
+    if (!path) {
+        return null;
+    }
+    if (Array.isArray(args.edits) &&
+        args.edits.length > 0 &&
+        args.edits.every((edit) => typeof edit?.oldText === "string" && typeof edit?.newText === "string")) {
+        return { path, edits: args.edits };
+    }
+    if (typeof args.oldText === "string" && typeof args.newText === "string") {
+        return { path, edits: [{ oldText: args.oldText, newText: args.newText }] };
+    }
+    return null;
+}
+function formatEditCall(args, theme, cwd) {
+    const pathDisplay = renderToolPath(str(args?.file_path ?? args?.path), theme, cwd);
+    return `${theme.fg("toolTitle", theme.bold("edit"))} ${pathDisplay}`;
+}
+function formatEditResult(args, preview, result, theme, isError) {
+    const rawPath = str(args?.file_path ?? args?.path);
+    const previewDiff = preview && !("error" in preview) ? preview.diff : undefined;
+    const previewError = preview && "error" in preview ? preview.error : undefined;
+    if (isError) {
+        const errorText = result.content
+            .filter((c) => c.type === "text")
+            .map((c) => c.text || "")
+            .join("\n");
+        if (!errorText || errorText === previewError) {
+            return undefined;
+        }
+        return theme.fg("error", errorText);
+    }
+    const resultDiff = result.details?.diff;
+    if (resultDiff && resultDiff !== previewDiff) {
+        return renderDiff(resultDiff, { filePath: rawPath ?? undefined });
+    }
+    return undefined;
+}
+function getEditHeaderBg(preview, settledError, theme) {
+    if (preview) {
+        if ("error" in preview) {
+            return (text) => theme.bg("toolErrorBg", text);
+        }
+        return (text) => theme.bg("toolSuccessBg", text);
+    }
+    if (settledError) {
+        return (text) => theme.bg("toolErrorBg", text);
+    }
+    return (text) => theme.bg("toolPendingBg", text);
+}
+function buildEditCallComponent(component, args, theme, cwd) {
+    component.setBgFn(getEditHeaderBg(component.preview, component.settledError, theme));
+    component.clear();
+    component.addChild(new Text(formatEditCall(args, theme, cwd), 0, 0));
+    if (!component.preview) {
+        return component;
+    }
+    const body = "error" in component.preview ? theme.fg("error", component.preview.error) : renderDiff(component.preview.diff);
+    component.addChild(new Spacer(1));
+    component.addChild(new Text(body, 0, 0));
+    return component;
+}
+function setEditPreview(component, preview, argsKey) {
+    const current = component.preview;
+    const changed = current === undefined ||
+        ("error" in current && "error" in preview
+            ? current.error !== preview.error
+            : "error" in current !== "error" in preview) ||
+        (!("error" in current) &&
+            !("error" in preview) &&
+            (current.diff !== preview.diff || current.firstChangedLine !== preview.firstChangedLine));
+    component.preview = preview;
+    component.previewArgsKey = argsKey;
+    component.previewPending = false;
+    return changed;
+}
+export const editRenderers = {
+    renderCall(args, theme, context) {
+        const component = getEditCallRenderComponent(context.state, context.lastComponent);
+        const previewInput = getRenderablePreviewInput(args);
+        const argsKey = previewInput ? JSON.stringify({ path: previewInput.path, edits: previewInput.edits }) : undefined;
+        if (component.previewArgsKey !== argsKey) {
+            component.preview = undefined;
+            component.previewArgsKey = argsKey;
+            component.previewPending = false;
+            component.settledError = false;
+        }
+        if (context.argsComplete && previewInput && !component.preview && !component.previewPending) {
+            component.previewPending = true;
+            const requestKey = argsKey;
+            void computeEditsDiff(previewInput.path, previewInput.edits, context.cwd).then((preview) => {
+                if (component.previewArgsKey === requestKey) {
+                    setEditPreview(component, preview, requestKey);
+                    context.invalidate();
+                }
+            });
+        }
+        return buildEditCallComponent(component, args, theme, context.cwd);
+    },
+    renderResult(result, _options, theme, context) {
+        const callComponent = context.state.callComponent;
+        const previewInput = getRenderablePreviewInput(context.args);
+        const argsKey = previewInput ? JSON.stringify({ path: previewInput.path, edits: previewInput.edits }) : undefined;
+        const typedResult = result;
+        const resultDiff = !context.isError ? typedResult.details?.diff : undefined;
+        let changed = false;
+        if (callComponent) {
+            if (typeof resultDiff === "string") {
+                changed =
+                    setEditPreview(callComponent, { diff: resultDiff, firstChangedLine: typedResult.details?.firstChangedLine }, argsKey) || changed;
+            }
+            if (callComponent.settledError !== context.isError) {
+                callComponent.settledError = context.isError;
+                changed = true;
+            }
+            if (changed) {
+                buildEditCallComponent(callComponent, context.args, theme, context.cwd);
+            }
+        }
+        const output = formatEditResult(context.args, callComponent?.preview, typedResult, theme, context.isError);
+        const component = context.lastComponent ?? new Container();
+        component.clear();
+        if (!output) {
+            return component;
+        }
+        component.addChild(new Spacer(1));
+        component.addChild(new Text(output, 1, 0));
+        return component;
+    },
+};

package/dist/core/tools/renderers/find.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Presentation for the find tool.
+ *
+ * Renderers live apart from the implementation so a process that only displays tool output does not
+ * load the execution path or its typebox parameter schema. `find.ts` spreads these into its
+ * definition, so the tool's public shape is unchanged.
+ */
+import type { ToolDefinition } from "../../extensions/types.ts";
+export declare const findRenderers: Pick<ToolDefinition<any, any>, "renderCall" | "renderResult">;

package/dist/core/tools/renderers/find.js

@@ -0,0 +1,63 @@
+/**
+ * Presentation for the find tool.
+ *
+ * Renderers live apart from the implementation so a process that only displays tool output does not
+ * load the execution path or its typebox parameter schema. `find.ts` spreads these into its
+ * definition, so the tool's public shape is unchanged.
+ */
+import { Text } from "@earendil-works/pi-tui";
+import { keyHint } from "../../../modes/interactive/components/keybinding-hints.js";
+import { getTextOutput, invalidArgText, shortenPath, str } from "../render-utils.js";
+import { DEFAULT_MAX_BYTES, formatSize } from "../truncate.js";
+function formatFindCall(args, theme) {
+    const pattern = str(args?.pattern);
+    const rawPath = str(args?.path);
+    const path = rawPath !== null ? shortenPath(rawPath || ".") : null;
+    const limit = args?.limit;
+    const invalidArg = invalidArgText(theme);
+    let text = theme.fg("toolTitle", theme.bold("find")) +
+        " " +
+        (pattern === null ? invalidArg : theme.fg("accent", pattern || "")) +
+        theme.fg("toolOutput", ` in ${path === null ? invalidArg : path}`);
+    if (limit !== undefined) {
+        text += theme.fg("toolOutput", ` (limit ${limit})`);
+    }
+    return text;
+}
+function formatFindResult(result, options, theme, showImages) {
+    const output = getTextOutput(result, showImages).trim();
+    let text = "";
+    if (output) {
+        const lines = output.split("\n");
+        const maxLines = options.expanded ? lines.length : 20;
+        const displayLines = lines.slice(0, maxLines);
+        const remaining = lines.length - maxLines;
+        text += `\n${displayLines.map((line) => theme.fg("toolOutput", line)).join("\n")}`;
+        if (remaining > 0) {
+            text += `${theme.fg("muted", `\n... (${remaining} more lines,`)} ${keyHint("app.tools.expand", "to expand")}${theme.fg("muted", ")")}`;
+        }
+    }
+    const resultLimit = result.details?.resultLimitReached;
+    const truncation = result.details?.truncation;
+    if (resultLimit || truncation?.truncated) {
+        const warnings = [];
+        if (resultLimit)
+            warnings.push(`${resultLimit} results limit`);
+        if (truncation?.truncated)
+            warnings.push(`${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit`);
+        text += `\n${theme.fg("warning", `[Truncated: ${warnings.join(", ")}]`)}`;
+    }
+    return text;
+}
+export const findRenderers = {
+    renderCall(args, theme, context) {
+        const text = context.lastComponent ?? new Text("", 0, 0);
+        text.setText(formatFindCall(args, theme));
+        return text;
+    },
+    renderResult(result, options, theme, context) {
+        const text = context.lastComponent ?? new Text("", 0, 0);
+        text.setText(formatFindResult(result, options, theme, context.showImages));
+        return text;
+    },
+};

package/dist/core/tools/renderers/grep.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Presentation for the grep tool.
+ *
+ * Renderers live apart from the implementation so a process that only displays tool output does not
+ * load the execution path or its typebox parameter schema. `grep.ts` spreads these into its
+ * definition, so the tool's public shape is unchanged.
+ */
+import type { ToolDefinition } from "../../extensions/types.ts";
+export declare const grepRenderers: Pick<ToolDefinition<any, any>, "renderCall" | "renderResult">;

package/dist/core/tools/renderers/grep.js

@@ -0,0 +1,68 @@
+/**
+ * Presentation for the grep tool.
+ *
+ * Renderers live apart from the implementation so a process that only displays tool output does not
+ * load the execution path or its typebox parameter schema. `grep.ts` spreads these into its
+ * definition, so the tool's public shape is unchanged.
+ */
+import { Text } from "@earendil-works/pi-tui";
+import { keyHint } from "../../../modes/interactive/components/keybinding-hints.js";
+import { getTextOutput, invalidArgText, shortenPath, str } from "../render-utils.js";
+import { DEFAULT_MAX_BYTES, formatSize } from "../truncate.js";
+function formatGrepCall(args, theme) {
+    const pattern = str(args?.pattern);
+    const rawPath = str(args?.path);
+    const path = rawPath !== null ? shortenPath(rawPath || ".") : null;
+    const glob = str(args?.glob);
+    const limit = args?.limit;
+    const invalidArg = invalidArgText(theme);
+    let text = theme.fg("toolTitle", theme.bold("grep")) +
+        " " +
+        (pattern === null ? invalidArg : theme.fg("accent", `/${pattern || ""}/`)) +
+        theme.fg("toolOutput", ` in ${path === null ? invalidArg : path}`);
+    if (glob)
+        text += theme.fg("toolOutput", ` (${glob})`);
+    if (limit !== undefined)
+        text += theme.fg("toolOutput", ` limit ${limit}`);
+    return text;
+}
+function formatGrepResult(result, options, theme, showImages) {
+    const output = getTextOutput(result, showImages).trim();
+    let text = "";
+    if (output) {
+        const lines = output.split("\n");
+        const maxLines = options.expanded ? lines.length : 15;
+        const displayLines = lines.slice(0, maxLines);
+        const remaining = lines.length - maxLines;
+        text += `\n${displayLines.map((line) => theme.fg("toolOutput", line)).join("\n")}`;
+        if (remaining > 0) {
+            text += `${theme.fg("muted", `\n... (${remaining} more lines,`)} ${keyHint("app.tools.expand", "to expand")}${theme.fg("muted", ")")}`;
+        }
+    }
+    const matchLimit = result.details?.matchLimitReached;
+    const truncation = result.details?.truncation;
+    const linesTruncated = result.details?.linesTruncated;
+    if (matchLimit || truncation?.truncated || linesTruncated) {
+        const warnings = [];
+        if (matchLimit)
+            warnings.push(`${matchLimit} matches limit`);
+        if (truncation?.truncated)
+            warnings.push(`${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit`);
+        if (linesTruncated)
+            warnings.push("some lines truncated");
+        text += `\n${theme.fg("warning", `[Truncated: ${warnings.join(", ")}]`)}`;
+    }
+    return text;
+}
+export const grepRenderers = {
+    renderCall(args, theme, context) {
+        const text = context.lastComponent ?? new Text("", 0, 0);
+        text.setText(formatGrepCall(args, theme));
+        return text;
+    },
+    renderResult(result, options, theme, context) {
+        const text = context.lastComponent ?? new Text("", 0, 0);
+        text.setText(formatGrepResult(result, options, theme, context.showImages));
+        return text;
+    },
+};