@mars_ai/marscli 2.0.13 → 2.0.14

package/dist/core/tools/powershell.js

@@ -0,0 +1,39 @@
+import { getPowerShellConfig } from "../../utils/shell.js";
+import { createLocalShellOperations, createShellToolDefinition, } from "./bash.js";
+import { wrapToolDefinition } from "./tool-definition-wrapper.js";
+const UTF8_OUTPUT_PREFIX = "try { [Console]::OutputEncoding=[System.Text.Encoding]::UTF8 } catch {}\n";
+export const powershellToolSystemPromptContribution = {
+    snippet: "Execute PowerShell commands",
+    guidelines: ["You can inspect PI_* environment variables for current model and session details."],
+};
+export function createLocalPowerShellOperations() {
+    const operations = createLocalShellOperations("PowerShell", getPowerShellConfig);
+    return {
+        exec: (command, cwd, options) => operations.exec(`${UTF8_OUTPUT_PREFIX}${command}`, cwd, options),
+    };
+}
+const powershellToolConfig = {
+    name: "powershell",
+    label: "powershell",
+    shellName: "PowerShell",
+    prompt: "PS>",
+    promptSnippet: powershellToolSystemPromptContribution.snippet,
+    promptGuidelines: powershellToolSystemPromptContribution.guidelines,
+    tempFilePrefix: "pi-powershell",
+};
+export function createPowerShellToolDefinition(cwd, options) {
+    return createShellToolDefinition(cwd, powershellToolConfig, {
+        ...options,
+        operations: options?.operations ?? createLocalPowerShellOperations(),
+    });
+}
+export function createPowerShellTool(cwd, options) {
+    const definition = createPowerShellToolDefinition(cwd, options);
+    const tool = wrapToolDefinition(definition);
+    Object.assign(tool, {
+        promptSnippet: definition.promptSnippet,
+        promptGuidelines: definition.promptGuidelines,
+    });
+    return tool;
+}
+//# sourceMappingURL=powershell.js.map

package/dist/core/tools/powershell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"powershell.js","sourceRoot":"","sources":["../../../src/core/tools/powershell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAQN,0BAA0B,EAC1B,yBAAyB,GAEzB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,kBAAkB,GAAG,2EAA2E,CAAC;AAEvG,MAAM,CAAC,MAAM,sCAAsC,GAAG;IACrD,OAAO,EAAE,6BAA6B;IACtC,UAAU,EAAE,CAAC,mFAAmF,CAAC;CACxF,CAAC;AAWX,MAAM,UAAU,+BAA+B;IAC9C,MAAM,UAAU,GAAG,0BAA0B,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;IACjF,OAAO;QACN,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,kBAAkB,GAAG,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC;KACjG,CAAC;AACH,CAAC;AAED,MAAM,oBAAoB,GAAoB;IAC7C,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,YAAY;IACnB,SAAS,EAAE,YAAY;IACvB,MAAM,EAAE,KAAK;IACb,aAAa,EAAE,sCAAsC,CAAC,OAAO;IAC7D,gBAAgB,EAAE,sCAAsC,CAAC,UAAU;IACnE,cAAc,EAAE,eAAe;CAC/B,CAAC;AAEF,MAAM,UAAU,8BAA8B,CAC7C,GAAW,EACX,OAA+B;IAE/B,OAAO,yBAAyB,CAAC,GAAG,EAAE,oBAAoB,EAAE;QAC3D,GAAG,OAAO;QACV,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,+BAA+B,EAAE;KACpE,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,OAA+B;IAChF,MAAM,UAAU,GAAG,8BAA8B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QACnB,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,gBAAgB,EAAE,UAAU,CAAC,gBAAgB;KAC7C,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACb,CAAC","sourcesContent":["import { getPowerShellConfig } from \"../../utils/shell.ts\";\nimport {\n\ttype BashOperations,\n\ttype BashSpawnContext,\n\ttype BashSpawnHook,\n\ttype BashToolDetails,\n\ttype BashToolInput,\n\ttype BashToolOptions,\n\ttype createBashTool,\n\tcreateLocalShellOperations,\n\tcreateShellToolDefinition,\n\ttype ShellToolConfig,\n} from \"./bash.ts\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\n\nconst UTF8_OUTPUT_PREFIX = \"try { [Console]::OutputEncoding=[System.Text.Encoding]::UTF8 } catch {}\\n\";\n\nexport const powershellToolSystemPromptContribution = {\n\tsnippet: \"Execute PowerShell commands\",\n\tguidelines: [\"You can inspect PI_* environment variables for current model and session details.\"],\n} as const;\n\nexport type PowerShellOperations = BashOperations;\nexport type PowerShellSpawnContext = BashSpawnContext;\nexport type PowerShellSpawnHook = BashSpawnHook;\nexport type PowerShellToolDetails = BashToolDetails;\nexport type PowerShellToolInput = BashToolInput;\n\nexport interface PowerShellToolOptions\n\textends Pick<BashToolOptions, \"operations\" | \"exposeSessionEnvironment\" | \"spawnHook\"> {}\n\nexport function createLocalPowerShellOperations(): PowerShellOperations {\n\tconst operations = createLocalShellOperations(\"PowerShell\", getPowerShellConfig);\n\treturn {\n\t\texec: (command, cwd, options) => operations.exec(`${UTF8_OUTPUT_PREFIX}${command}`, cwd, options),\n\t};\n}\n\nconst powershellToolConfig: ShellToolConfig = {\n\tname: \"powershell\",\n\tlabel: \"powershell\",\n\tshellName: \"PowerShell\",\n\tprompt: \"PS>\",\n\tpromptSnippet: powershellToolSystemPromptContribution.snippet,\n\tpromptGuidelines: powershellToolSystemPromptContribution.guidelines,\n\ttempFilePrefix: \"pi-powershell\",\n};\n\nexport function createPowerShellToolDefinition(\n\tcwd: string,\n\toptions?: PowerShellToolOptions,\n): ReturnType<typeof createShellToolDefinition> {\n\treturn createShellToolDefinition(cwd, powershellToolConfig, {\n\t\t...options,\n\t\toperations: options?.operations ?? createLocalPowerShellOperations(),\n\t});\n}\n\nexport function createPowerShellTool(cwd: string, options?: PowerShellToolOptions): ReturnType<typeof createBashTool> {\n\tconst definition = createPowerShellToolDefinition(cwd, options);\n\tconst tool = wrapToolDefinition(definition);\n\tObject.assign(tool, {\n\t\tpromptSnippet: definition.promptSnippet,\n\t\tpromptGuidelines: definition.promptGuidelines,\n\t});\n\treturn tool;\n}\n"]}

package/dist/core/tools/read.d.ts

@@ -0,0 +1,63 @@
+import type { ModelImageResizeOptions } from "@earendil-works/pi-ai";
+import { type Static, Type } from "typebox";
+import type { ToolDefinition } from "../extensions/types.ts";
+import { type TypeBoxAgentTool } from "./tool-definition-wrapper.ts";
+import { type TruncationResult } from "./truncate.ts";
+declare const readSchema: Type.TObject<{
+    path: Type.TString;
+    offset: Type.TOptional<Type.TNumber>;
+    limit: Type.TOptional<Type.TNumber>;
+}>;
+export declare const readToolSystemPromptContribution: {
+    readonly snippet: "Read file contents";
+    readonly guidelines: readonly ["Use read to examine files instead of cat or sed."];
+};
+export type ReadToolInput = Static<typeof readSchema>;
+/**
+ * Result for programmatic callers such as codemode scripts: the text for text files, and an image
+ * block for images that codemode's `image()` accepts. `note` is the text that goes with the image,
+ * such as resize hints. Property descriptions are left out so the type stays on one line in tool
+ * descriptions.
+ */
+declare const readOutputSchema: Type.TUnion<[Type.TString, Type.TObject<{
+    type: Type.TLiteral<"image">;
+    data: Type.TString;
+    mimeType: Type.TString;
+    note: Type.TString;
+}>]>;
+export type ReadToolOutput = Static<typeof readOutputSchema>;
+export interface ReadToolDetails {
+    truncation?: TruncationResult;
+}
+/**
+ * Pluggable operations for the read tool.
+ * Override these to delegate file reading to remote systems (for example SSH).
+ */
+export interface ReadOperations {
+    /** Read file contents as a Buffer */
+    readFile: (absolutePath: string) => Promise<Buffer>;
+    /** Check if file is readable (throw if not) */
+    access: (absolutePath: string) => Promise<void>;
+    /** Detect image MIME type, return null or undefined for non-images */
+    detectImageMimeType?: (absolutePath: string) => Promise<string | null | undefined>;
+    /**
+     * Stream file contents in chunks. When present, text files are read through it and only the lines
+     * that will be shown are kept in memory; otherwise readFile loads the whole file. Stop reading when
+     * the signal aborts; the read tool also stops consuming the stream then.
+     */
+    createReadStream?: (absolutePath: string, options: {
+        signal?: AbortSignal;
+    }) => AsyncIterable<Uint8Array>;
+}
+export interface ReadToolOptions {
+    /** Whether to auto-resize images. Default: true */
+    autoResizeImages?: boolean;
+    /** Fallback resize profile when the execution context has no model metadata. */
+    resizeOptions?: ModelImageResizeOptions;
+    /** Custom operations for file reading. Default: local filesystem */
+    operations?: ReadOperations;
+}
+export declare function createReadToolDefinition(cwd: string, options?: ReadToolOptions): ToolDefinition<typeof readSchema, ReadToolDetails | undefined>;
+export declare function createReadTool(cwd: string, options?: ReadToolOptions): TypeBoxAgentTool<typeof readSchema>;
+export {};
+//# sourceMappingURL=read.d.ts.map

package/dist/core/tools/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/core/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,uBAAuB,EAAe,MAAM,uBAAuB,CAAC;AAG5G,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAI5C,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG/E,OAAO,EAAE,KAAK,gBAAgB,EAAsB,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAoD,KAAK,gBAAgB,EAAgB,MAAM,eAAe,CAAC;AAEtH,QAAA,MAAM,UAAU;;;;EAId,CAAC;AAEH,eAAO,MAAM,gCAAgC;aAC5C,OAAO,EAAE,oBAAoB;aAC7B,UAAU,YAAG,kDAAkD;CACtD,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,QAAA,MAAM,gBAAgB;;;;;IAGpB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,qCAAqC;IACrC,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,+CAA+C;IAC/C,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACnF;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,aAAa,CAAC,UAAU,CAAC,CAAC;CAC1G;AAyBD,MAAM,WAAW,eAAe;IAC/B,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gFAAgF;IAChF,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,oEAAoE;IACpE,UAAU,CAAC,EAAE,cAAc,CAAC;CAC5B;AAuID,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,eAAe,GACvB,cAAc,CAAC,OAAO,UAAU,EAAE,eAAe,GAAG,SAAS,CAAC,CA+HhE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAAC,OAAO,UAAU,CAAC,CAE1G"}

package/dist/core/tools/read.js

@@ -0,0 +1,302 @@
+import { constants } from "fs";
+import { access as fsAccess, open as fsOpen, readFile as fsReadFile } from "fs/promises";
+import { Type } from "typebox";
+import { TextDecoder } from "util";
+import { processImage } from "../../utils/image-process.js";
+import { detectSupportedImageMimeTypeFromFile } from "../../utils/mime.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({
+    path: Type.String({ description: "Path to the file to read (relative or absolute)" }),
+    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" })),
+});
+export const readToolSystemPromptContribution = {
+    snippet: "Read file contents",
+    guidelines: ["Use read to examine files instead of cat or sed."],
+};
+/**
+ * Result for programmatic callers such as codemode scripts: the text for text files, and an image
+ * block for images that codemode's `image()` accepts. `note` is the text that goes with the image,
+ * such as resize hints. Property descriptions are left out so the type stays on one line in tool
+ * descriptions.
+ */
+const readOutputSchema = Type.Union([
+    Type.String(),
+    Type.Object({ type: Type.Literal("image"), data: Type.String(), mimeType: Type.String(), note: Type.String() }),
+]);
+const defaultReadOperations = {
+    readFile: (path) => fsReadFile(path),
+    createReadStream: readLocalFileChunks,
+    access: (path) => fsAccess(path, constants.R_OK),
+    detectImageMimeType: detectSupportedImageMimeTypeFromFile,
+};
+/**
+ * Stream a local file the way fs.readFile reads it: a regular file up to its size when opened, so text
+ * appended during the read is not counted and a growing file still ends; a file reporting size 0 (such
+ * as /proc files) and other file types until EOF.
+ */
+async function* readLocalFileChunks(path, { signal }) {
+    const handle = await fsOpen(path, "r");
+    try {
+        const stats = await handle.stat();
+        const end = stats.isFile() && stats.size > 0 ? stats.size - 1 : undefined;
+        yield* handle.createReadStream({ end, signal, autoClose: false });
+    }
+    finally {
+        await handle.close();
+    }
+}
+/** The image block and its note, or the text for text files and images that could not be processed. */
+function toReadOutput(content) {
+    const text = content.find((block) => block.type === "text")?.text ?? "";
+    const image = content.find((block) => block.type === "image");
+    return image ? { type: "image", data: image.data, mimeType: image.mimeType, note: text } : text;
+}
+function getNonVisionImageNote(model) {
+    if (!model || model.input.includes("image")) {
+        return undefined;
+    }
+    return "[Current model does not support images. The image will be omitted from this request.]";
+}
+/**
+ * Whether a range can be streamed. Other values (fractional, negative limit) keep the whole-file path,
+ * whose array slicing defines what they select, for example limit -1 as all lines but the last.
+ */
+function isStreamableRange(offset, limit) {
+    return ((offset === undefined || Number.isInteger(offset)) &&
+        (limit === undefined || (Number.isInteger(limit) && limit >= 0)));
+}
+/** Select lines from a whole file in memory: for operations without createReadStream and unusual ranges. */
+function selectLinesFromBuffer(buffer, startLine, limit) {
+    const allLines = buffer.toString("utf-8").split("\n");
+    const endLine = limit === undefined ? undefined : Math.min(startLine + limit, allLines.length);
+    const truncation = truncateHead(allLines.slice(startLine, endLine).join("\n"));
+    const firstLineBytes = truncation.firstLineExceedsLimit ? Buffer.byteLength(allLines[startLine], "utf-8") : 0;
+    return { totalFileLines: allLines.length, truncation, firstLineBytes };
+}
+/**
+ * Select lines from a file read in chunks. Only lines truncateHead can show are stored; the rest are
+ * counted, so memory does not grow with the file. Stops reading when the signal aborts.
+ */
+async function selectLinesFromStream(chunks, startLine, limit, signal) {
+    const endLine = limit === undefined ? Number.POSITIVE_INFINITY : startLine + limit;
+    // Non-fatal UTF-8 that keeps a byte order mark decodes like Buffer.toString("utf-8").
+    const decoder = new TextDecoder("utf-8", { ignoreBOM: true });
+    const storedLines = [];
+    let storedBytes = 0;
+    let storedPastCaps = false;
+    let line = 0;
+    let selectedLines = 0;
+    let selectedBytes = 0;
+    let firstLineBytes = 0;
+    let lastLineEmpty = true;
+    // The selected line being read: its text, while it is stored, and its size.
+    let pieces = [];
+    let lineBytes = 0;
+    let lineHasText = false;
+    const appendToLine = (text, start, end) => {
+        lineHasText = true;
+        if (!pieces)
+            return;
+        const piece = text.slice(start, end);
+        // A line over the byte cap is never shown, and a first line over it is only measured: never store
+        // all of a 1 GB line.
+        if (lineBytes <= DEFAULT_MAX_BYTES)
+            pieces.push(piece);
+        lineBytes += Buffer.byteLength(piece, "utf-8");
+    };
+    const finishLine = () => {
+        if (pieces) {
+            if (selectedLines === 0)
+                firstLineBytes = lineBytes;
+            // Storing continues one line past the caps: truncateHead ignores a trailing empty line, so the
+            // line after the cap must be there for it to decide truncation as for the full text.
+            if (storedLines.length > DEFAULT_MAX_LINES || storedBytes > DEFAULT_MAX_BYTES)
+                storedPastCaps = true;
+            const text = pieces.join("");
+            storedBytes += Buffer.byteLength(text, "utf-8") + (storedLines.length > 0 ? 1 : 0);
+            storedLines.push(text);
+        }
+        selectedLines++;
+        lastLineEmpty = !lineHasText;
+        pieces = storedPastCaps ? undefined : [];
+        lineBytes = 0;
+        lineHasText = false;
+    };
+    const select = (text) => {
+        let position = 0;
+        // Start of the selected text in this piece, measured as a whole: the joined lines' size.
+        let selectionStart = -1;
+        while (true) {
+            const selected = line >= startLine && line < endLine;
+            if (selected && selectionStart === -1)
+                selectionStart = position;
+            const newline = text.indexOf("\n", position);
+            const end = newline === -1 ? text.length : newline;
+            if (selected && end > position)
+                appendToLine(text, position, end);
+            if (newline === -1)
+                break;
+            if (selected) {
+                finishLine();
+                if (line + 1 === endLine) {
+                    selectedBytes += Buffer.byteLength(text.slice(selectionStart, newline), "utf-8");
+                    selectionStart = -1;
+                }
+            }
+            line++;
+            position = newline + 1;
+        }
+        if (selectionStart !== -1)
+            selectedBytes += Buffer.byteLength(text.slice(selectionStart), "utf-8");
+    };
+    for await (const chunk of chunks) {
+        // Leaving the loop closes the stream.
+        if (signal?.aborted)
+            throw new Error("Operation aborted");
+        select(decoder.decode(chunk, { stream: true }));
+    }
+    select(decoder.decode());
+    if (line >= startLine && line < endLine)
+        finishLine();
+    const truncation = {
+        ...truncateHead(storedLines.join("\n")),
+        // truncateHead's counts for the joined selected lines, which drop a trailing empty line.
+        totalLines: selectedBytes === 0 ? 0 : selectedLines - (lastLineEmpty ? 1 : 0),
+        totalBytes: selectedBytes,
+    };
+    return { totalFileLines: line + 1, truncation, firstLineBytes };
+}
+export function createReadToolDefinition(cwd, options) {
+    const autoResizeImages = options?.autoResizeImages ?? true;
+    const fallbackResizeOptions = options?.resizeOptions;
+    const ops = options?.operations ?? defaultReadOperations;
+    return {
+        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: readToolSystemPromptContribution.snippet,
+        promptGuidelines: [...readToolSystemPromptContribution.guidelines],
+        parameters: readSchema,
+        outputSchema: readOutputSchema,
+        constrainedSampling: { type: "json_schema", strict: "prefer" },
+        async execute(_toolCallId, { path, offset, limit }, signal, _onUpdate, ctx) {
+            return new Promise((resolve, reject) => {
+                if (signal?.aborted) {
+                    reject(new Error("Operation aborted"));
+                    return;
+                }
+                let aborted = false;
+                const onAbort = () => {
+                    aborted = true;
+                    reject(new Error("Operation aborted"));
+                };
+                signal?.addEventListener("abort", onAbort, { once: true });
+                (async () => {
+                    try {
+                        const absolutePath = await resolveReadPathAsync(path, ctx?.cwd || cwd);
+                        if (aborted)
+                            return;
+                        // Check if file exists and is readable.
+                        await ops.access(absolutePath);
+                        if (aborted)
+                            return;
+                        const mimeType = ops.detectImageMimeType ? await ops.detectImageMimeType(absolutePath) : undefined;
+                        let content;
+                        let details;
+                        const nonVisionImageNote = getNonVisionImageNote(ctx?.model);
+                        if (mimeType) {
+                            // Read image as binary.
+                            const buffer = await ops.readFile(absolutePath);
+                            const processed = await processImage(buffer, mimeType, {
+                                autoResizeImages,
+                                resizeOptions: ctx?.model?.inputLimits?.images?.resize ?? fallbackResizeOptions,
+                            });
+                            if (!processed.ok) {
+                                let textNote = `Read image file [${mimeType}]\n${processed.message}`;
+                                if (nonVisionImageNote)
+                                    textNote += `\n${nonVisionImageNote}`;
+                                content = [{ type: "text", text: textNote }];
+                            }
+                            else {
+                                let textNote = `Read image file [${processed.mimeType}]`;
+                                if (processed.hints.length > 0)
+                                    textNote += `\n${processed.hints.join("\n")}`;
+                                if (nonVisionImageNote)
+                                    textNote += `\n${nonVisionImageNote}`;
+                                content = [
+                                    { type: "text", text: textNote },
+                                    { type: "image", data: processed.data, mimeType: processed.mimeType },
+                                ];
+                            }
+                        }
+                        else {
+                            // Read text content. Convert offset from 1-indexed input to 0-indexed line access.
+                            const startLine = offset ? Math.max(0, offset - 1) : 0;
+                            const startLineDisplay = startLine + 1;
+                            const { totalFileLines, truncation, firstLineBytes } = ops.createReadStream && isStreamableRange(offset, limit)
+                                ? await selectLinesFromStream(ops.createReadStream(absolutePath, { signal }), startLine, limit, signal)
+                                : selectLinesFromBuffer(await ops.readFile(absolutePath), startLine, limit);
+                            if (aborted)
+                                return;
+                            // Check if offset is out of bounds.
+                            if (startLine >= totalFileLines) {
+                                throw new Error(`Offset ${offset} is beyond end of file (${totalFileLines} lines total)`);
+                            }
+                            // A user-specified limit is honored before truncation.
+                            const userLimitedLines = limit === undefined ? undefined : Math.min(startLine + limit, totalFileLines) - startLine;
+                            let outputText;
+                            if (truncation.firstLineExceedsLimit) {
+                                // First line alone exceeds the byte limit. Point the model at a bash fallback.
+                                const firstLineSize = formatSize(firstLineBytes);
+                                outputText = `[Line ${startLineDisplay} is ${firstLineSize}, exceeds ${formatSize(DEFAULT_MAX_BYTES)} limit. Use bash: sed -n '${startLineDisplay}p' ${path} | head -c ${DEFAULT_MAX_BYTES}]`;
+                                details = { truncation };
+                            }
+                            else if (truncation.truncated) {
+                                // Truncation occurred. Build an actionable continuation notice.
+                                const endLineDisplay = startLineDisplay + truncation.outputLines - 1;
+                                const nextOffset = endLineDisplay + 1;
+                                outputText = truncation.content;
+                                if (truncation.truncatedBy === "lines") {
+                                    outputText += `\n\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines}. Use offset=${nextOffset} to continue.]`;
+                                }
+                                else {
+                                    outputText += `\n\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Use offset=${nextOffset} to continue.]`;
+                                }
+                                details = { truncation };
+                            }
+                            else if (userLimitedLines !== undefined && startLine + userLimitedLines < totalFileLines) {
+                                // User-specified limit stopped early, but the file still has more content.
+                                const remaining = totalFileLines - (startLine + userLimitedLines);
+                                const nextOffset = startLine + userLimitedLines + 1;
+                                outputText = `${truncation.content}\n\n[${remaining} more lines in file. Use offset=${nextOffset} to continue.]`;
+                            }
+                            else {
+                                // No truncation and no remaining user-limited content.
+                                outputText = truncation.content;
+                            }
+                            content = [{ type: "text", text: outputText }];
+                        }
+                        if (aborted)
+                            return;
+                        signal?.removeEventListener("abort", onAbort);
+                        resolve({ content, details });
+                    }
+                    catch (error) {
+                        signal?.removeEventListener("abort", onAbort);
+                        if (!aborted)
+                            reject(error);
+                    }
+                })();
+            }).then((result) => ({ ...result, structuredContent: toReadOutput(result.content) }));
+        },
+        ...readRenderers,
+    };
+}
+export function createReadTool(cwd, options) {
+    return wrapToolDefinition(createReadToolDefinition(cwd, options));
+}
+//# sourceMappingURL=read.js.map

package/dist/core/tools/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/core/tools/read.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Api, ImageContent, Model, ModelImageResizeOptions, TextContent } from \"@earendil-works/pi-ai\";\nimport { constants } from \"fs\";\nimport { access as fsAccess, open as fsOpen, readFile as fsReadFile } from \"fs/promises\";\nimport { type Static, Type } from \"typebox\";\nimport { TextDecoder } from \"util\";\nimport { processImage } from \"../../utils/image-process.ts\";\nimport { detectSupportedImageMimeTypeFromFile } from \"../../utils/mime.ts\";\nimport type { ExtensionContext, ToolDefinition } from \"../extensions/types.ts\";\nimport { resolveReadPathAsync } from \"./path-utils.ts\";\nimport { readRenderers } from \"./renderers/read.ts\";\nimport { type TypeBoxAgentTool, wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\nimport { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, type TruncationResult, truncateHead } from \"./truncate.ts\";\n\nconst readSchema = Type.Object({\n\tpath: Type.String({ description: \"Path to the file to read (relative or absolute)\" }),\n\toffset: Type.Optional(Type.Number({ description: \"Line number to start reading from (1-indexed)\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of lines to read\" })),\n});\n\nexport const readToolSystemPromptContribution = {\n\tsnippet: \"Read file contents\",\n\tguidelines: [\"Use read to examine files instead of cat or sed.\"],\n} as const;\n\nexport type ReadToolInput = Static<typeof readSchema>;\n\n/**\n * Result for programmatic callers such as codemode scripts: the text for text files, and an image\n * block for images that codemode's `image()` accepts. `note` is the text that goes with the image,\n * such as resize hints. Property descriptions are left out so the type stays on one line in tool\n * descriptions.\n */\nconst readOutputSchema = Type.Union([\n\tType.String(),\n\tType.Object({ type: Type.Literal(\"image\"), data: Type.String(), mimeType: Type.String(), note: Type.String() }),\n]);\n\nexport type ReadToolOutput = Static<typeof readOutputSchema>;\n\nexport interface ReadToolDetails {\n\ttruncation?: TruncationResult;\n}\n\n/**\n * Pluggable operations for the read tool.\n * Override these to delegate file reading to remote systems (for example SSH).\n */\nexport interface ReadOperations {\n\t/** Read file contents as a Buffer */\n\treadFile: (absolutePath: string) => Promise<Buffer>;\n\t/** Check if file is readable (throw if not) */\n\taccess: (absolutePath: string) => Promise<void>;\n\t/** Detect image MIME type, return null or undefined for non-images */\n\tdetectImageMimeType?: (absolutePath: string) => Promise<string | null | undefined>;\n\t/**\n\t * Stream file contents in chunks. When present, text files are read through it and only the lines\n\t * that will be shown are kept in memory; otherwise readFile loads the whole file. Stop reading when\n\t * the signal aborts; the read tool also stops consuming the stream then.\n\t */\n\tcreateReadStream?: (absolutePath: string, options: { signal?: AbortSignal }) => AsyncIterable<Uint8Array>;\n}\n\nconst defaultReadOperations: ReadOperations = {\n\treadFile: (path) => fsReadFile(path),\n\tcreateReadStream: readLocalFileChunks,\n\taccess: (path) => fsAccess(path, constants.R_OK),\n\tdetectImageMimeType: detectSupportedImageMimeTypeFromFile,\n};\n\n/**\n * Stream a local file the way fs.readFile reads it: a regular file up to its size when opened, so text\n * appended during the read is not counted and a growing file still ends; a file reporting size 0 (such\n * as /proc files) and other file types until EOF.\n */\nasync function* readLocalFileChunks(path: string, { signal }: { signal?: AbortSignal }): AsyncIterable<Uint8Array> {\n\tconst handle = await fsOpen(path, \"r\");\n\ttry {\n\t\tconst stats = await handle.stat();\n\t\tconst end = stats.isFile() && stats.size > 0 ? stats.size - 1 : undefined;\n\t\tyield* handle.createReadStream({ end, signal, autoClose: false });\n\t} finally {\n\t\tawait handle.close();\n\t}\n}\n\nexport interface ReadToolOptions {\n\t/** Whether to auto-resize images. Default: true */\n\tautoResizeImages?: boolean;\n\t/** Fallback resize profile when the execution context has no model metadata. */\n\tresizeOptions?: ModelImageResizeOptions;\n\t/** Custom operations for file reading. Default: local filesystem */\n\toperations?: ReadOperations;\n}\n\n/** The image block and its note, or the text for text files and images that could not be processed. */\nfunction toReadOutput(content: (TextContent | ImageContent)[]): ReadToolOutput {\n\tconst text = content.find((block) => block.type === \"text\")?.text ?? \"\";\n\tconst image = content.find((block) => block.type === \"image\");\n\treturn image ? { type: \"image\", data: image.data, mimeType: image.mimeType, note: text } : text;\n}\n\nfunction getNonVisionImageNote(model: Model<Api> | undefined): string | undefined {\n\tif (!model || model.input.includes(\"image\")) {\n\t\treturn undefined;\n\t}\n\treturn \"[Current model does not support images. The image will be omitted from this request.]\";\n}\n\n/** The lines a read shows, with the file's line count; line counts follow `text.split(\"\\n\")`. */\ninterface SelectedLines {\n\ttotalFileLines: number;\n\ttruncation: TruncationResult;\n\t/** Bytes of the first selected line, for the notice when it alone exceeds the byte limit. */\n\tfirstLineBytes: number;\n}\n\n/**\n * Whether a range can be streamed. Other values (fractional, negative limit) keep the whole-file path,\n * whose array slicing defines what they select, for example limit -1 as all lines but the last.\n */\nfunction isStreamableRange(offset: number | undefined, limit: number | undefined): boolean {\n\treturn (\n\t\t(offset === undefined || Number.isInteger(offset)) &&\n\t\t(limit === undefined || (Number.isInteger(limit) && limit >= 0))\n\t);\n}\n\n/** Select lines from a whole file in memory: for operations without createReadStream and unusual ranges. */\nfunction selectLinesFromBuffer(buffer: Buffer, startLine: number, limit: number | undefined): SelectedLines {\n\tconst allLines = buffer.toString(\"utf-8\").split(\"\\n\");\n\tconst endLine = limit === undefined ? undefined : Math.min(startLine + limit, allLines.length);\n\tconst truncation = truncateHead(allLines.slice(startLine, endLine).join(\"\\n\"));\n\tconst firstLineBytes = truncation.firstLineExceedsLimit ? Buffer.byteLength(allLines[startLine], \"utf-8\") : 0;\n\treturn { totalFileLines: allLines.length, truncation, firstLineBytes };\n}\n\n/**\n * Select lines from a file read in chunks. Only lines truncateHead can show are stored; the rest are\n * counted, so memory does not grow with the file. Stops reading when the signal aborts.\n */\nasync function selectLinesFromStream(\n\tchunks: AsyncIterable<Uint8Array>,\n\tstartLine: number,\n\tlimit: number | undefined,\n\tsignal: AbortSignal | undefined,\n): Promise<SelectedLines> {\n\tconst endLine = limit === undefined ? Number.POSITIVE_INFINITY : startLine + limit;\n\t// Non-fatal UTF-8 that keeps a byte order mark decodes like Buffer.toString(\"utf-8\").\n\tconst decoder = new TextDecoder(\"utf-8\", { ignoreBOM: true });\n\tconst storedLines: string[] = [];\n\tlet storedBytes = 0;\n\tlet storedPastCaps = false;\n\tlet line = 0;\n\tlet selectedLines = 0;\n\tlet selectedBytes = 0;\n\tlet firstLineBytes = 0;\n\tlet lastLineEmpty = true;\n\t// The selected line being read: its text, while it is stored, and its size.\n\tlet pieces: string[] | undefined = [];\n\tlet lineBytes = 0;\n\tlet lineHasText = false;\n\n\tconst appendToLine = (text: string, start: number, end: number) => {\n\t\tlineHasText = true;\n\t\tif (!pieces) return;\n\t\tconst piece = text.slice(start, end);\n\t\t// A line over the byte cap is never shown, and a first line over it is only measured: never store\n\t\t// all of a 1 GB line.\n\t\tif (lineBytes <= DEFAULT_MAX_BYTES) pieces.push(piece);\n\t\tlineBytes += Buffer.byteLength(piece, \"utf-8\");\n\t};\n\tconst finishLine = () => {\n\t\tif (pieces) {\n\t\t\tif (selectedLines === 0) firstLineBytes = lineBytes;\n\t\t\t// Storing continues one line past the caps: truncateHead ignores a trailing empty line, so the\n\t\t\t// line after the cap must be there for it to decide truncation as for the full text.\n\t\t\tif (storedLines.length > DEFAULT_MAX_LINES || storedBytes > DEFAULT_MAX_BYTES) storedPastCaps = true;\n\t\t\tconst text = pieces.join(\"\");\n\t\t\tstoredBytes += Buffer.byteLength(text, \"utf-8\") + (storedLines.length > 0 ? 1 : 0);\n\t\t\tstoredLines.push(text);\n\t\t}\n\t\tselectedLines++;\n\t\tlastLineEmpty = !lineHasText;\n\t\tpieces = storedPastCaps ? undefined : [];\n\t\tlineBytes = 0;\n\t\tlineHasText = false;\n\t};\n\tconst select = (text: string) => {\n\t\tlet position = 0;\n\t\t// Start of the selected text in this piece, measured as a whole: the joined lines' size.\n\t\tlet selectionStart = -1;\n\t\twhile (true) {\n\t\t\tconst selected = line >= startLine && line < endLine;\n\t\t\tif (selected && selectionStart === -1) selectionStart = position;\n\t\t\tconst newline = text.indexOf(\"\\n\", position);\n\t\t\tconst end = newline === -1 ? text.length : newline;\n\t\t\tif (selected && end > position) appendToLine(text, position, end);\n\t\t\tif (newline === -1) break;\n\t\t\tif (selected) {\n\t\t\t\tfinishLine();\n\t\t\t\tif (line + 1 === endLine) {\n\t\t\t\t\tselectedBytes += Buffer.byteLength(text.slice(selectionStart, newline), \"utf-8\");\n\t\t\t\t\tselectionStart = -1;\n\t\t\t\t}\n\t\t\t}\n\t\t\tline++;\n\t\t\tposition = newline + 1;\n\t\t}\n\t\tif (selectionStart !== -1) selectedBytes += Buffer.byteLength(text.slice(selectionStart), \"utf-8\");\n\t};\n\n\tfor await (const chunk of chunks) {\n\t\t// Leaving the loop closes the stream.\n\t\tif (signal?.aborted) throw new Error(\"Operation aborted\");\n\t\tselect(decoder.decode(chunk, { stream: true }));\n\t}\n\tselect(decoder.decode());\n\tif (line >= startLine && line < endLine) finishLine();\n\tconst truncation: TruncationResult = {\n\t\t...truncateHead(storedLines.join(\"\\n\")),\n\t\t// truncateHead's counts for the joined selected lines, which drop a trailing empty line.\n\t\ttotalLines: selectedBytes === 0 ? 0 : selectedLines - (lastLineEmpty ? 1 : 0),\n\t\ttotalBytes: selectedBytes,\n\t};\n\treturn { totalFileLines: line + 1, truncation, firstLineBytes };\n}\n\nexport function createReadToolDefinition(\n\tcwd: string,\n\toptions?: ReadToolOptions,\n): ToolDefinition<typeof readSchema, ReadToolDetails | undefined> {\n\tconst autoResizeImages = options?.autoResizeImages ?? true;\n\tconst fallbackResizeOptions = options?.resizeOptions;\n\tconst ops = options?.operations ?? defaultReadOperations;\n\treturn {\n\t\tname: \"read\",\n\t\tlabel: \"read\",\n\t\tdescription: `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.`,\n\t\tpromptSnippet: readToolSystemPromptContribution.snippet,\n\t\tpromptGuidelines: [...readToolSystemPromptContribution.guidelines],\n\t\tparameters: readSchema,\n\t\toutputSchema: readOutputSchema,\n\t\tconstrainedSampling: { type: \"json_schema\", strict: \"prefer\" },\n\t\tasync execute(\n\t\t\t_toolCallId,\n\t\t\t{ path, offset, limit }: { path: string; offset?: number; limit?: number },\n\t\t\tsignal?: AbortSignal,\n\t\t\t_onUpdate?,\n\t\t\tctx?: ExtensionContext,\n\t\t) {\n\t\t\treturn new Promise<{ content: (TextContent | ImageContent)[]; details: ReadToolDetails | undefined }>(\n\t\t\t\t(resolve, reject) => {\n\t\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\t\treject(new Error(\"Operation aborted\"));\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tlet aborted = false;\n\t\t\t\t\tconst onAbort = () => {\n\t\t\t\t\t\taborted = true;\n\t\t\t\t\t\treject(new Error(\"Operation aborted\"));\n\t\t\t\t\t};\n\t\t\t\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\n\t\t\t\t\t(async () => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst absolutePath = await resolveReadPathAsync(path, ctx?.cwd || cwd);\n\t\t\t\t\t\t\tif (aborted) return;\n\t\t\t\t\t\t\t// Check if file exists and is readable.\n\t\t\t\t\t\t\tawait ops.access(absolutePath);\n\t\t\t\t\t\t\tif (aborted) return;\n\t\t\t\t\t\t\tconst mimeType = ops.detectImageMimeType ? await ops.detectImageMimeType(absolutePath) : undefined;\n\t\t\t\t\t\t\tlet content: (TextContent | ImageContent)[];\n\t\t\t\t\t\t\tlet details: ReadToolDetails | undefined;\n\t\t\t\t\t\t\tconst nonVisionImageNote = getNonVisionImageNote(ctx?.model);\n\t\t\t\t\t\t\tif (mimeType) {\n\t\t\t\t\t\t\t\t// Read image as binary.\n\t\t\t\t\t\t\t\tconst buffer = await ops.readFile(absolutePath);\n\t\t\t\t\t\t\t\tconst processed = await processImage(buffer, mimeType, {\n\t\t\t\t\t\t\t\t\tautoResizeImages,\n\t\t\t\t\t\t\t\t\tresizeOptions: ctx?.model?.inputLimits?.images?.resize ?? fallbackResizeOptions,\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\tif (!processed.ok) {\n\t\t\t\t\t\t\t\t\tlet textNote = `Read image file [${mimeType}]\\n${processed.message}`;\n\t\t\t\t\t\t\t\t\tif (nonVisionImageNote) textNote += `\\n${nonVisionImageNote}`;\n\t\t\t\t\t\t\t\t\tcontent = [{ type: \"text\", text: textNote }];\n\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\tlet textNote = `Read image file [${processed.mimeType}]`;\n\t\t\t\t\t\t\t\t\tif (processed.hints.length > 0) textNote += `\\n${processed.hints.join(\"\\n\")}`;\n\t\t\t\t\t\t\t\t\tif (nonVisionImageNote) textNote += `\\n${nonVisionImageNote}`;\n\t\t\t\t\t\t\t\t\tcontent = [\n\t\t\t\t\t\t\t\t\t\t{ type: \"text\", text: textNote },\n\t\t\t\t\t\t\t\t\t\t{ type: \"image\", data: processed.data, mimeType: processed.mimeType },\n\t\t\t\t\t\t\t\t\t];\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t// Read text content. Convert offset from 1-indexed input to 0-indexed line access.\n\t\t\t\t\t\t\t\tconst startLine = offset ? Math.max(0, offset - 1) : 0;\n\t\t\t\t\t\t\t\tconst startLineDisplay = startLine + 1;\n\t\t\t\t\t\t\t\tconst { totalFileLines, truncation, firstLineBytes } =\n\t\t\t\t\t\t\t\t\tops.createReadStream && isStreamableRange(offset, limit)\n\t\t\t\t\t\t\t\t\t\t? await selectLinesFromStream(\n\t\t\t\t\t\t\t\t\t\t\t\tops.createReadStream(absolutePath, { signal }),\n\t\t\t\t\t\t\t\t\t\t\t\tstartLine,\n\t\t\t\t\t\t\t\t\t\t\t\tlimit,\n\t\t\t\t\t\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t\t\t: selectLinesFromBuffer(await ops.readFile(absolutePath), startLine, limit);\n\t\t\t\t\t\t\t\tif (aborted) return;\n\t\t\t\t\t\t\t\t// Check if offset is out of bounds.\n\t\t\t\t\t\t\t\tif (startLine >= totalFileLines) {\n\t\t\t\t\t\t\t\t\tthrow new Error(`Offset ${offset} is beyond end of file (${totalFileLines} lines total)`);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t// A user-specified limit is honored before truncation.\n\t\t\t\t\t\t\t\tconst userLimitedLines =\n\t\t\t\t\t\t\t\t\tlimit === undefined ? undefined : Math.min(startLine + limit, totalFileLines) - startLine;\n\t\t\t\t\t\t\t\tlet outputText: string;\n\t\t\t\t\t\t\t\tif (truncation.firstLineExceedsLimit) {\n\t\t\t\t\t\t\t\t\t// First line alone exceeds the byte limit. Point the model at a bash fallback.\n\t\t\t\t\t\t\t\t\tconst firstLineSize = formatSize(firstLineBytes);\n\t\t\t\t\t\t\t\t\toutputText = `[Line ${startLineDisplay} is ${firstLineSize}, exceeds ${formatSize(DEFAULT_MAX_BYTES)} limit. Use bash: sed -n '${startLineDisplay}p' ${path} | head -c ${DEFAULT_MAX_BYTES}]`;\n\t\t\t\t\t\t\t\t\tdetails = { truncation };\n\t\t\t\t\t\t\t\t} else if (truncation.truncated) {\n\t\t\t\t\t\t\t\t\t// Truncation occurred. Build an actionable continuation notice.\n\t\t\t\t\t\t\t\t\tconst endLineDisplay = startLineDisplay + truncation.outputLines - 1;\n\t\t\t\t\t\t\t\t\tconst nextOffset = endLineDisplay + 1;\n\t\t\t\t\t\t\t\t\toutputText = truncation.content;\n\t\t\t\t\t\t\t\t\tif (truncation.truncatedBy === \"lines\") {\n\t\t\t\t\t\t\t\t\t\toutputText += `\\n\\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines}. Use offset=${nextOffset} to continue.]`;\n\t\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\t\toutputText += `\\n\\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Use offset=${nextOffset} to continue.]`;\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t\tdetails = { truncation };\n\t\t\t\t\t\t\t\t} else if (userLimitedLines !== undefined && startLine + userLimitedLines < totalFileLines) {\n\t\t\t\t\t\t\t\t\t// User-specified limit stopped early, but the file still has more content.\n\t\t\t\t\t\t\t\t\tconst remaining = totalFileLines - (startLine + userLimitedLines);\n\t\t\t\t\t\t\t\t\tconst nextOffset = startLine + userLimitedLines + 1;\n\t\t\t\t\t\t\t\t\toutputText = `${truncation.content}\\n\\n[${remaining} more lines in file. Use offset=${nextOffset} to continue.]`;\n\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\t// No truncation and no remaining user-limited content.\n\t\t\t\t\t\t\t\t\toutputText = truncation.content;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tcontent = [{ type: \"text\", text: outputText }];\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tif (aborted) return;\n\t\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\t\t\tresolve({ content, details });\n\t\t\t\t\t\t} catch (error: any) {\n\t\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\t\t\tif (!aborted) reject(error);\n\t\t\t\t\t\t}\n\t\t\t\t\t})();\n\t\t\t\t},\n\t\t\t).then((result) => ({ ...result, structuredContent: toReadOutput(result.content) }));\n\t\t},\n\t\t...readRenderers,\n\t};\n}\n\nexport function createReadTool(cwd: string, options?: ReadToolOptions): TypeBoxAgentTool<typeof readSchema> {\n\treturn wrapToolDefinition(createReadToolDefinition(cwd, options));\n}\n"]}

package/dist/core/tools/render-utils.d.ts

@@ -0,0 +1,50 @@
+import type { ImageContent, TextContent } from "@earendil-works/pi-ai";
+import type { Theme } from "../../modes/interactive/theme/theme.ts";
+import type { ToolRenderContext } from "../extensions/types.ts";
+export declare function shortenPath(path: unknown): string;
+export declare function linkPath(styledText: string, rawPath: string, cwd: string): string;
+export declare function str(value: unknown): string | null;
+/** Format finite numbers or numeric strings as a read line range, omitting malformed ranges. */
+export declare function formatReadLineRange(offset: unknown, limit: unknown): string;
+export declare function replaceTabs(text: string): string;
+export declare function normalizeDisplayText(text: string): string;
+export declare function getTextOutput(result: {
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+} | undefined, showImages: boolean): string;
+export type ToolRenderResultLike<TDetails> = {
+    content: (TextContent | ImageContent)[];
+    details: TDetails;
+};
+/**
+ * Generic tool call header: the title followed by the arguments. Collapsed, they are `key=value`
+ * pairs on the title line, cut to {@link COLLAPSED_ARGS_CHARS}. Expanded, each is a `key: value`
+ * line below the title, with strings shown raw and continuation lines indented.
+ */
+export declare function formatToolCallWithArgs(title: string, args: unknown, theme: Theme, expanded: boolean): string;
+/** Duration as `4.2s` below a minute, then `1m 30s` and `2h 3m 4s`. */
+export declare function formatToolDuration(ms: number): string;
+/** Renderer state of {@link startToolTimer} and {@link toolTimerText}, kept in `ToolRenderContext.state`. */
+interface ToolTimerState {
+    startedAt?: number;
+    endedAt?: number;
+    interval?: ReturnType<typeof setInterval>;
+}
+/** Start the row's clock once execution starts. Call from `renderCall`. */
+export declare function startToolTimer(context: ToolRenderContext<ToolTimerState>): void;
+/**
+ * The row's timing line, from `renderResult`: `Elapsed 4.2s` while the result is partial, redrawn
+ * every second, and `Took 4.2s` once it is final. Undefined when the row has no start time and no
+ * recorded duration.
+ */
+export declare function toolTimerText(context: ToolRenderContext<ToolTimerState>, isPartial: boolean): string | undefined;
+export declare function invalidArgText(theme: Theme): string;
+export declare function renderToolPath(rawPath: string | null, theme: Theme, cwd: string, options?: {
+    emptyFallback?: string;
+}): string;
+export {};
+//# sourceMappingURL=render-utils.d.ts.map

package/dist/core/tools/render-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-utils.d.ts","sourceRoot":"","sources":["../../../src/core/tools/render-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAC;AAIpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAGjD;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIjF;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIjD;AAOD,gGAAgG;AAChG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAU3E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,aAAa,CAC5B,MAAM,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,SAAS,EACzG,UAAU,EAAE,OAAO,GACjB,MAAM,CAsBR;AAED,MAAM,MAAM,oBAAoB,CAAC,QAAQ,IAAI;IAC5C,OAAO,EAAE,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,CAAC;IACxC,OAAO,EAAE,QAAQ,CAAC;CAClB,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAkB5G;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAUrD;AAED,6GAA6G;AAC7G,UAAU,cAAc;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;CAC1C;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,CAAC,cAAc,CAAC,GAAG,IAAI,CAM/E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAkBhH;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEnD;AAED,wBAAgB,cAAc,CAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC,MAAM,CAKR"}