@slopus/rig 0.0.1

package/dist/tools/pi/ls.js

@@ -0,0 +1,31 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+import { countTextLines, resolveToolPath, textOutputSchema, toTextBlocks } from "../utils/index.js";
+const DEFAULT_LIMIT = 500;
+const DEFAULT_MAX_BYTES = 50 * 1024;
+export const piLsTool = defineTool({
+    name: "ls",
+    label: "ls",
+    description: `List directory contents. Returns entries sorted alphabetically, with '/' suffix for directories. Includes dotfiles. Output is truncated to ${DEFAULT_LIMIT} entries or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first).`,
+    arguments: Type.Object({
+        path: Type.Optional(Type.String({ description: "Directory to list (default: current directory)" })),
+        limit: Type.Optional(Type.Number({ description: "Maximum number of entries to return (default: 500)" })),
+    }),
+    returnType: textOutputSchema,
+    execute: async ({ path, limit }, context) => {
+        const dirPath = resolveToolPath(path || ".", context.fs.cwd);
+        const entries = [...(await context.fs.readdir(dirPath))];
+        entries.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));
+        const output = [];
+        for (const entry of entries.slice(0, limit ?? DEFAULT_LIMIT)) {
+            const entryStats = await context.fs.stat(resolveToolPath(entry, dirPath));
+            output.push(entryStats.isDirectory ? `${entry}/` : entry);
+        }
+        return { text: output.length > 0 ? output.join("\n") : "(empty directory)" };
+    },
+    toLLM: toTextBlocks,
+    toUI: (result, args) => result.text === "(empty directory)"
+        ? `Listed ${args.path ?? "."} (empty)`
+        : `Listed ${args.path ?? "."} (${countTextLines(result.text)} entries)`,
+    locks: [],
+});

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

@@ -0,0 +1,13 @@
+export declare const piReadTool: import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    content: import("@sinclair/typebox").TString;
+    startLine: import("@sinclair/typebox").TNumber;
+    totalLines: import("@sinclair/typebox").TNumber;
+    returnedLines: import("@sinclair/typebox").TNumber;
+    truncated: import("@sinclair/typebox").TBoolean;
+}>>;
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../sources/tools/pi/read.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,UAAU;;;;;;;;;;;GA2BrB,CAAC"}

package/dist/tools/pi/read.js

@@ -0,0 +1,32 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+import { readFileReturnSchema, readTextFile } from "../utils/index.js";
+const DEFAULT_MAX_LINES = 2000;
+const DEFAULT_MAX_BYTES = 50 * 1024;
+export const piReadTool = defineTool({
+    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.`,
+    arguments: 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" })),
+    }),
+    returnType: readFileReturnSchema,
+    execute: async ({ path, offset, limit }, context) => {
+        const options = { path };
+        if (offset !== undefined)
+            options.offset = offset;
+        if (limit !== undefined)
+            options.limit = limit;
+        return readTextFile(options, context);
+    },
+    toLLM: (result) => [
+        {
+            type: "text",
+            text: result.content.length > 0 ? result.content : "(empty file)",
+        },
+    ],
+    toUI: (result) => `Read ${result.path} (${result.returnedLines}/${result.totalLines} lines${result.truncated ? ", truncated" : ""})`,
+    locks: [],
+});

package/dist/tools/pi/write.d.ts

@@ -0,0 +1,9 @@
+export declare const piWriteTool: import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    content: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    created: import("@sinclair/typebox").TBoolean;
+    bytes: import("@sinclair/typebox").TNumber;
+}>>;
+//# sourceMappingURL=write.d.ts.map

package/dist/tools/pi/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../sources/tools/pi/write.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW;;;;;;;GAmBtB,CAAC"}

package/dist/tools/pi/write.js

@@ -0,0 +1,22 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+import { writeFileReturnSchema, writeTextFile } from "../utils/index.js";
+export const piWriteTool = defineTool({
+    name: "write",
+    label: "write",
+    description: "Write content to a file. Creates the file if it doesn't exist, overwrites if it does. Automatically creates parent directories.",
+    arguments: Type.Object({
+        path: Type.String({ description: "Path to the file to write (relative or absolute)" }),
+        content: Type.String({ description: "Content to write to the file" }),
+    }),
+    returnType: writeFileReturnSchema,
+    execute: async ({ path, content }, context) => writeTextFile({ path, content }, context),
+    toLLM: (result) => [
+        {
+            type: "text",
+            text: `Successfully wrote ${result.bytes} bytes to ${result.path}`,
+        },
+    ],
+    toUI: (result) => `Wrote ${result.path} (${result.bytes} bytes)`,
+    locks: [(args) => args.path],
+});

package/dist/tools/testing/createJustBashToolHarness.d.ts

@@ -0,0 +1,18 @@
+import { Bash, type InitialFiles } from "just-bash";
+import type { Static, TSchema } from "@sinclair/typebox";
+import type { AgentContext } from "../../agent/context/AgentContext.js";
+import type { AnyDefinedTool, DefinedTool } from "../../agent/types.js";
+export interface ToolHarnessOptions {
+    cwd?: string;
+    files?: InitialFiles;
+}
+export interface ToolTestHarness {
+    bash: Bash;
+    context: AgentContext;
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    runTool<TArgsSchema extends TSchema, TReturnSchema extends TSchema>(tool: DefinedTool<TArgsSchema, TReturnSchema>, args: Static<TArgsSchema>): Promise<Static<TReturnSchema>>;
+    runToolByName(tools: readonly AnyDefinedTool[], name: string, args: unknown): Promise<unknown>;
+}
+export declare function createJustBashToolHarness(options?: ToolHarnessOptions): ToolTestHarness;
+//# sourceMappingURL=createJustBashToolHarness.d.ts.map

package/dist/tools/testing/createJustBashToolHarness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJustBashToolHarness.d.ts","sourceRoot":"","sources":["../../../sources/tools/testing/createJustBashToolHarness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAwB,MAAM,sBAAsB,CAAC;AAG9F,MAAM,WAAW,kBAAkB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,WAAW,SAAS,OAAO,EAAE,aAAa,SAAS,OAAO,EAC9D,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,EAC7C,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IAClC,aAAa,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClG;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,kBAAuB,GAAG,eAAe,CAuC3F"}

package/dist/tools/testing/createJustBashToolHarness.js

@@ -0,0 +1,33 @@
+import { Bash } from "just-bash";
+import { createJustBashAgentContext } from "../../agent/context/createJustBashAgentContext.js";
+export function createJustBashToolHarness(options = {}) {
+    const cwd = options.cwd ?? "/workspace";
+    const bashOptions = {
+        cwd,
+    };
+    if (options.files !== undefined)
+        bashOptions.files = options.files;
+    const bash = new Bash(bashOptions);
+    const context = createJustBashAgentContext(bash, cwd);
+    return {
+        bash,
+        context,
+        readFile(path) {
+            return context.fs.readFile(path);
+        },
+        writeFile(path, content) {
+            return context.fs.writeFile(path, content);
+        },
+        async runTool(tool, args) {
+            return tool.execute(args, context, {});
+        },
+        async runToolByName(tools, name, args) {
+            const tool = tools.find((candidate) => candidate.name === name);
+            if (!tool) {
+                throw new Error(`Unknown tool: ${name}`);
+            }
+            const execute = tool.execute;
+            return execute(args, context, {});
+        },
+    };
+}

package/dist/tools/testing/validImageFixtures.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The exact 32×32 PNG and JPEG files from the view_image smoke-test failure,
+ * kept as base64 so tests do not depend on an image encoder being installed.
+ */
+export declare const validPng32Base64 = "iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAIAAAD8GO2jAAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAIKADAAQAAAABAAAAIAAAAACshmLzAAAARklEQVRIDe3SsQkAMAwDQQVcZP9ZMmDwBF+pe+NS2HDoJO8mvZ293RwfoK5EEqEABmyRRCiAAVskEQpgwBZJhAIYsEVI9AH7IAMiyextiAAAAABJRU5ErkJggg==";
+export declare const validJpeg32Base64 = "/9j/4AAQSkZJRgABAQAASABIAAD/4QBMRXhpZgAATU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAIKADAAQAAAABAAAAIAAAAAD/7QA4UGhvdG9zaG9wIDMuMAA4QklNBAQAAAAAAAA4QklNBCUAAAAAABDUHYzZjwCyBOmACZjs+EJ+/8AAEQgAIAAgAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMAAgICAgICAwICAwUDAwMFBgUFBQUGCAYGBgYGCAoICAgICAgKCgoKCgoKCgwMDAwMDA4ODg4ODw8PDw8PDw8PD//bAEMBAgICBAQEBwQEBxALCQsQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEP/dAAQAAv/aAAwDAQACEQMRAD8A/LTSfCnT5K9N0nwp935K9K0nwp935K9M0nwp0+Sv7wzjjHfU+a8NuPfh94810nwp0+SvTdJ8Kfd+SvStJ8Kfd+SvTNJ8KdPkr8pznjDfU/0A8NuPfh94/9DB0nwp935K9N0nwp0+SvSdJ8KdPkr03SfCn3fkr9GznjDfU/gPw249+H3jzXSfCn3fkr03SfCn3fkr0nSfCnT5K9N0nwp935K/Kc44x31P9APDbj34feP/2Q==";
+//# sourceMappingURL=validImageFixtures.d.ts.map

package/dist/tools/testing/validImageFixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validImageFixtures.d.ts","sourceRoot":"","sources":["../../../sources/tools/testing/validImageFixtures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,6SACiR,CAAC;AAE/S,eAAO,MAAM,iBAAiB,6uCACgtC,CAAC"}

package/dist/tools/testing/validImageFixtures.js

@@ -0,0 +1,6 @@
+/**
+ * The exact 32×32 PNG and JPEG files from the view_image smoke-test failure,
+ * kept as base64 so tests do not depend on an image encoder being installed.
+ */
+export const validPng32Base64 = "iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAIAAAD8GO2jAAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAIKADAAQAAAABAAAAIAAAAACshmLzAAAARklEQVRIDe3SsQkAMAwDQQVcZP9ZMmDwBF+pe+NS2HDoJO8mvZ293RwfoK5EEqEABmyRRCiAAVskEQpgwBZJhAIYsEVI9AH7IAMiyextiAAAAABJRU5ErkJggg==";
+export const validJpeg32Base64 = "/9j/4AAQSkZJRgABAQAASABIAAD/4QBMRXhpZgAATU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAIKADAAQAAAABAAAAIAAAAAD/7QA4UGhvdG9zaG9wIDMuMAA4QklNBAQAAAAAAAA4QklNBCUAAAAAABDUHYzZjwCyBOmACZjs+EJ+/8AAEQgAIAAgAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMAAgICAgICAwICAwUDAwMFBgUFBQUGCAYGBgYGCAoICAgICAgKCgoKCgoKCgwMDAwMDA4ODg4ODw8PDw8PDw8PD//bAEMBAgICBAQEBwQEBxALCQsQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEP/dAAQAAv/aAAwDAQACEQMRAD8A/LTSfCnT5K9N0nwp935K9K0nwp935K9M0nwp0+Sv7wzjjHfU+a8NuPfh94810nwp0+SvTdJ8Kfd+SvStJ8Kfd+SvTNJ8KdPkr8pznjDfU/0A8NuPfh94/9DB0nwp935K9N0nwp0+SvSdJ8KdPkr03SfCn3fkr9GznjDfU/gPw249+H3jzXSfCn3fkr03SfCn3fkr0nSfCnT5K9N0nwp935K/Kc44x31P9APDbj34feP/2Q==";

package/dist/tools/utils/ImageProcessingError.d.ts

@@ -0,0 +1,4 @@
+export declare class ImageProcessingError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=ImageProcessingError.d.ts.map

package/dist/tools/utils/ImageProcessingError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageProcessingError.d.ts","sourceRoot":"","sources":["../../../sources/tools/utils/ImageProcessingError.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAItD"}

package/dist/tools/utils/ImageProcessingError.js

@@ -0,0 +1,6 @@
+export class ImageProcessingError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ImageProcessingError";
+    }
+}

package/dist/tools/utils/content.d.ts

@@ -0,0 +1,11 @@
+import { type Static } from "@sinclair/typebox";
+import type { ContentBlock } from "../../agent/types.js";
+export declare const textOutputSchema: import("@sinclair/typebox").TObject<{
+    text: import("@sinclair/typebox").TString;
+}>;
+export type TextOutput = Static<typeof textOutputSchema>;
+export declare function toTextBlocks(result: TextOutput): readonly ContentBlock[];
+export declare function createStubTool(name: string, description: string): import("../../agent/types.js").DefinedTool<import("@sinclair/typebox").TObject<{}>, import("@sinclair/typebox").TObject<{
+    text: import("@sinclair/typebox").TString;
+}>>;
+//# sourceMappingURL=content.d.ts.map

package/dist/tools/utils/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../sources/tools/utils/content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIzD,eAAO,MAAM,gBAAgB;;EAE3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEzD,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,YAAY,EAAE,CAExE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;;IAc/D"}

package/dist/tools/utils/content.js

@@ -0,0 +1,24 @@
+import { Type } from "@sinclair/typebox";
+import { defineTool } from "../../agent/types.js";
+import { singleLineText } from "./singleLineText.js";
+export const textOutputSchema = Type.Object({
+    text: Type.String(),
+});
+export function toTextBlocks(result) {
+    return [{ type: "text", text: result.text }];
+}
+export function createStubTool(name, description) {
+    return defineTool({
+        name,
+        label: name,
+        description,
+        arguments: Type.Object({}),
+        returnType: textOutputSchema,
+        execute() {
+            return { text: `${name} is declared but requires host application state.` };
+        },
+        toLLM: toTextBlocks,
+        toUI: (result) => singleLineText(result.text),
+        locks: [],
+    });
+}

package/dist/tools/utils/countTextLines.d.ts

@@ -0,0 +1,2 @@
+export declare function countTextLines(text: string): number;
+//# sourceMappingURL=countTextLines.d.ts.map

package/dist/tools/utils/countTextLines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countTextLines.d.ts","sourceRoot":"","sources":["../../../sources/tools/utils/countTextLines.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnD"}

package/dist/tools/utils/countTextLines.js

@@ -0,0 +1,6 @@
+export function countTextLines(text) {
+    if (text.length === 0) {
+        return 0;
+    }
+    return text.split(/\r?\n/u).filter((line) => line.length > 0).length;
+}

package/dist/tools/utils/file.d.ts

@@ -0,0 +1,90 @@
+import type { AgentContext } from "../../agent/context/AgentContext.js";
+export declare const readFileReturnSchema: import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    content: import("@sinclair/typebox").TString;
+    startLine: import("@sinclair/typebox").TNumber;
+    totalLines: import("@sinclair/typebox").TNumber;
+    returnedLines: import("@sinclair/typebox").TNumber;
+    truncated: import("@sinclair/typebox").TBoolean;
+}>;
+export declare const writeFileReturnSchema: import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    created: import("@sinclair/typebox").TBoolean;
+    bytes: import("@sinclair/typebox").TNumber;
+}>;
+export declare const editFileReturnSchema: import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    replacements: import("@sinclair/typebox").TNumber;
+    fuzzy: import("@sinclair/typebox").TBoolean;
+    oldString: import("@sinclair/typebox").TString;
+    newString: import("@sinclair/typebox").TString;
+}>;
+export interface ReadFileOptions {
+    path: string;
+    offset?: number;
+    limit?: number;
+    cwd?: string;
+    numbered?: boolean;
+}
+export interface ReadFileResult {
+    path: string;
+    content: string;
+    startLine: number;
+    totalLines: number;
+    returnedLines: number;
+    truncated: boolean;
+}
+export declare function readTextFile(options: ReadFileOptions, context: AgentContext): Promise<ReadFileResult>;
+export interface WriteFileOptions {
+    path: string;
+    content: string;
+    cwd?: string;
+}
+export interface WriteFileResult {
+    path: string;
+    created: boolean;
+    bytes: number;
+}
+export declare function writeTextFile(options: WriteFileOptions, context: AgentContext): Promise<WriteFileResult>;
+export interface EditFileOptions {
+    path: string;
+    oldString: string;
+    newString: string;
+    replaceAll?: boolean;
+    lineNumber?: number;
+    cwd?: string;
+    fuzzy?: boolean;
+}
+export interface EditFileResult {
+    path: string;
+    replacements: number;
+    fuzzy: boolean;
+    oldString: string;
+    newString: string;
+}
+export declare function editTextFile(options: EditFileOptions, context: AgentContext): Promise<EditFileResult>;
+interface TextEditPlan {
+    path: string;
+    nextContent: string;
+    replacements: number;
+    fuzzy: boolean;
+}
+export declare function planTextEdit(options: EditFileOptions, context: AgentContext): Promise<TextEditPlan>;
+export interface BatchEdit {
+    oldText: string;
+    newText: string;
+}
+export interface BatchEditFileOptions {
+    path: string;
+    edits: readonly BatchEdit[];
+    cwd?: string;
+    fuzzy?: boolean;
+}
+export interface BatchEditFileResult {
+    path: string;
+    replacements: number;
+    fuzzy: boolean;
+}
+export declare function editTextFileBatch(options: BatchEditFileOptions, context: AgentContext): Promise<BatchEditFileResult>;
+export {};
+//# sourceMappingURL=file.d.ts.map

package/dist/tools/utils/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../sources/tools/utils/file.ts"],"names":[],"mappings":"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"}