@open-multi-agent/core 1.4.0

package/dist/tool/built-in/file-edit.js

@@ -0,0 +1,130 @@
+/**
+ * Built-in file-edit tool.
+ *
+ * Performs a targeted string replacement inside an existing file.
+ * The uniqueness invariant (one match unless replace_all is set) prevents the
+ * common class of bugs where a generic pattern matches the wrong occurrence.
+ */
+import { readFile, writeFile } from 'fs/promises';
+import { z } from 'zod';
+import { defineTool } from '../framework.js';
+// ---------------------------------------------------------------------------
+// Tool definition
+// ---------------------------------------------------------------------------
+export const fileEditTool = defineTool({
+    name: 'file_edit',
+    description: 'Edit a file by replacing a specific string with new content. ' +
+        'The `old_string` must appear verbatim in the file. ' +
+        'By default the tool errors if `old_string` appears more than once — ' +
+        'use `replace_all: true` to replace every occurrence. ' +
+        'Use file_write when you need to create a new file or rewrite it entirely.',
+    inputSchema: z.object({
+        path: z
+            .string()
+            .describe('Absolute path to the file to edit.'),
+        old_string: z
+            .string()
+            .describe('The exact string to find and replace. ' +
+            'Must match character-for-character including whitespace and newlines.'),
+        new_string: z
+            .string()
+            .describe('The replacement string that will be inserted in place of `old_string`.'),
+        replace_all: z
+            .boolean()
+            .optional()
+            .describe('When true, replace every occurrence of `old_string` instead of requiring it ' +
+            'to be unique. Defaults to false.'),
+    }),
+    execute: async (input) => {
+        // Read the existing file.
+        let original;
+        try {
+            const buffer = await readFile(input.path);
+            original = buffer.toString('utf8');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error reading file.';
+            return {
+                data: `Could not read "${input.path}": ${message}`,
+                isError: true,
+            };
+        }
+        const occurrences = countOccurrences(original, input.old_string);
+        if (occurrences === 0) {
+            return {
+                data: `The string to replace was not found in "${input.path}".\n` +
+                    'Make sure `old_string` matches the file contents exactly, ' +
+                    'including indentation and line endings.',
+                isError: true,
+            };
+        }
+        const replaceAll = input.replace_all ?? false;
+        if (occurrences > 1 && !replaceAll) {
+            return {
+                data: `\`old_string\` appears ${occurrences} times in "${input.path}". ` +
+                    'Provide a more specific string to uniquely identify the section you want ' +
+                    'to replace, or set `replace_all: true` to replace every occurrence.',
+                isError: true,
+            };
+        }
+        // Perform the replacement.
+        const updated = replaceAll
+            ? replaceAllOccurrences(original, input.old_string, input.new_string)
+            : original.replace(input.old_string, input.new_string);
+        // Persist the result.
+        try {
+            await writeFile(input.path, updated, 'utf8');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error writing file.';
+            return {
+                data: `Failed to write "${input.path}": ${message}`,
+                isError: true,
+            };
+        }
+        const replacedCount = replaceAll ? occurrences : 1;
+        return {
+            data: `Replaced ${replacedCount} occurrence${replacedCount === 1 ? '' : 's'} ` +
+                `in "${input.path}".`,
+            isError: false,
+        };
+    },
+});
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Count how many times `needle` appears in `haystack`.
+ * Uses a plain loop to avoid constructing a potentially large regex from
+ * untrusted input.
+ */
+function countOccurrences(haystack, needle) {
+    if (needle.length === 0)
+        return 0;
+    let count = 0;
+    let pos = 0;
+    while ((pos = haystack.indexOf(needle, pos)) !== -1) {
+        count++;
+        pos += needle.length;
+    }
+    return count;
+}
+/**
+ * Replace all occurrences of `needle` in `haystack` with `replacement`
+ * without using a regex (avoids regex-special-character escaping issues).
+ */
+function replaceAllOccurrences(haystack, needle, replacement) {
+    if (needle.length === 0)
+        return haystack;
+    const parts = [];
+    let pos = 0;
+    let next;
+    while ((next = haystack.indexOf(needle, pos)) !== -1) {
+        parts.push(haystack.slice(pos, next));
+        parts.push(replacement);
+        pos = next + needle.length;
+    }
+    parts.push(haystack.slice(pos));
+    return parts.join('');
+}
+//# sourceMappingURL=file-edit.js.map

package/dist/tool/built-in/file-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-edit.js","sourceRoot":"","sources":["../../../src/tool/built-in/file-edit.ts"],"names":[],"mappings":"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"}

package/dist/tool/built-in/file-read.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Built-in file-read tool.
+ *
+ * Reads a file from disk and returns its contents with 1-based line numbers.
+ * Supports reading a slice of lines via `offset` and `limit` for large files.
+ */
+export declare const fileReadTool: import("../framework.js").ToolDefinition<{
+    path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}>;
+//# sourceMappingURL=file-read.d.ts.map

package/dist/tool/built-in/file-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-read.d.ts","sourceRoot":"","sources":["../../../src/tool/built-in/file-read.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,eAAO,MAAM,YAAY;;;;EAyFvB,CAAA"}

package/dist/tool/built-in/file-read.js

@@ -0,0 +1,82 @@
+/**
+ * Built-in file-read tool.
+ *
+ * Reads a file from disk and returns its contents with 1-based line numbers.
+ * Supports reading a slice of lines via `offset` and `limit` for large files.
+ */
+import { readFile } from 'fs/promises';
+import { z } from 'zod';
+import { defineTool } from '../framework.js';
+// ---------------------------------------------------------------------------
+// Tool definition
+// ---------------------------------------------------------------------------
+export const fileReadTool = defineTool({
+    name: 'file_read',
+    description: 'Read the contents of a file from disk. ' +
+        'Returns the file contents with line numbers prefixed in the format "N\\t<line>". ' +
+        'Use `offset` and `limit` to read large files in chunks without loading the ' +
+        'entire file into the context window.',
+    inputSchema: z.object({
+        path: z.string().describe('Absolute path to the file to read.'),
+        offset: z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe('1-based line number to start reading from. ' +
+            'When omitted the file is read from the beginning.'),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe('Maximum number of lines to return. ' +
+            'When omitted all lines from `offset` to the end of the file are returned.'),
+    }),
+    execute: async (input) => {
+        let raw;
+        try {
+            const buffer = await readFile(input.path);
+            raw = buffer.toString('utf8');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error reading file.';
+            return {
+                data: `Could not read file "${input.path}": ${message}`,
+                isError: true,
+            };
+        }
+        // Split preserving trailing newlines correctly
+        const lines = raw.split('\n');
+        // Remove the last empty string produced by a trailing newline
+        if (lines.length > 0 && lines[lines.length - 1] === '') {
+            lines.pop();
+        }
+        const totalLines = lines.length;
+        // Apply offset (convert from 1-based to 0-based)
+        const startIndex = input.offset !== undefined ? Math.max(0, input.offset - 1) : 0;
+        if (startIndex >= totalLines && totalLines > 0) {
+            return {
+                data: `File "${input.path}" has ${totalLines} line${totalLines === 1 ? '' : 's'} ` +
+                    `but offset ${input.offset} is beyond the end.`,
+                isError: true,
+            };
+        }
+        const endIndex = input.limit !== undefined
+            ? Math.min(startIndex + input.limit, totalLines)
+            : totalLines;
+        const slice = lines.slice(startIndex, endIndex);
+        // Build line-numbered output (1-based line numbers matching file positions)
+        const numbered = slice
+            .map((line, i) => `${startIndex + i + 1}\t${line}`)
+            .join('\n');
+        const meta = endIndex < totalLines
+            ? `\n\n(showing lines ${startIndex + 1}–${endIndex} of ${totalLines})`
+            : '';
+        return {
+            data: numbered + meta,
+            isError: false,
+        };
+    },
+});
+//# sourceMappingURL=file-read.js.map

package/dist/tool/built-in/file-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-read.js","sourceRoot":"","sources":["../../../src/tool/built-in/file-read.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;IACrC,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,yCAAyC;QACzC,mFAAmF;QACnF,6EAA6E;QAC7E,sCAAsC;IAExC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAC/D,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,EAAE;aACL,WAAW,EAAE;aACb,QAAQ,EAAE;aACV,QAAQ,CACP,6CAA6C;YAC3C,mDAAmD,CACtD;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CACP,qCAAqC;YACnC,2EAA2E,CAC9E;KACJ,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,IAAI,GAAW,CAAA;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACzC,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAA;YACpE,OAAO;gBACL,IAAI,EAAE,wBAAwB,KAAK,CAAC,IAAI,MAAM,OAAO,EAAE;gBACvD,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;QAED,+CAA+C;QAC/C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAE7B,8DAA8D;QAC9D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YACvD,KAAK,CAAC,GAAG,EAAE,CAAA;QACb,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAA;QAE/B,iDAAiD;QACjD,MAAM,UAAU,GACd,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAEhE,IAAI,UAAU,IAAI,UAAU,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YAC/C,OAAO;gBACL,IAAI,EACF,SAAS,KAAK,CAAC,IAAI,SAAS,UAAU,QAAQ,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;oBAC5E,cAAc,KAAK,CAAC,MAAM,qBAAqB;gBACjD,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;QAED,MAAM,QAAQ,GACZ,KAAK,CAAC,KAAK,KAAK,SAAS;YACvB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC;YAChD,CAAC,CAAC,UAAU,CAAA;QAEhB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;QAE/C,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,KAAK;aACnB,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;aAClD,IAAI,CAAC,IAAI,CAAC,CAAA;QAEb,MAAM,IAAI,GACR,QAAQ,GAAG,UAAU;YACnB,CAAC,CAAC,sBAAsB,UAAU,GAAG,CAAC,IAAI,QAAQ,OAAO,UAAU,GAAG;YACtE,CAAC,CAAC,EAAE,CAAA;QAER,OAAO;YACL,IAAI,EAAE,QAAQ,GAAG,IAAI;YACrB,OAAO,EAAE,KAAK;SACf,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/tool/built-in/file-write.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Built-in file-write tool.
+ *
+ * Creates or overwrites a file with the supplied content.  Parent directories
+ * are created automatically (equivalent to `mkdir -p`).
+ */
+export declare const fileWriteTool: import("../framework.js").ToolDefinition<{
+    content: string;
+    path: string;
+}>;
+//# sourceMappingURL=file-write.d.ts.map

package/dist/tool/built-in/file-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-write.d.ts","sourceRoot":"","sources":["../../../src/tool/built-in/file-write.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,eAAO,MAAM,aAAa;;;EAgExB,CAAA"}

package/dist/tool/built-in/file-write.js

@@ -0,0 +1,70 @@
+/**
+ * Built-in file-write tool.
+ *
+ * Creates or overwrites a file with the supplied content.  Parent directories
+ * are created automatically (equivalent to `mkdir -p`).
+ */
+import { mkdir, stat, writeFile } from 'fs/promises';
+import { dirname } from 'path';
+import { z } from 'zod';
+import { defineTool } from '../framework.js';
+// ---------------------------------------------------------------------------
+// Tool definition
+// ---------------------------------------------------------------------------
+export const fileWriteTool = defineTool({
+    name: 'file_write',
+    description: 'Write content to a file, creating it (and any missing parent directories) if it ' +
+        'does not already exist, or overwriting it if it does. ' +
+        'Prefer this tool for creating new files; use file_edit for targeted in-place edits ' +
+        'of existing files.',
+    inputSchema: z.object({
+        path: z
+            .string()
+            .describe('Absolute path to the file to write. ' +
+            'The path must be absolute (starting with /).'),
+        content: z.string().describe('The full content to write to the file.'),
+    }),
+    execute: async (input) => {
+        // Determine whether the file already exists so we can report create vs update.
+        let existed = false;
+        try {
+            await stat(input.path);
+            existed = true;
+        }
+        catch {
+            // File does not exist — will be created.
+        }
+        // Ensure parent directory hierarchy exists.
+        const parentDir = dirname(input.path);
+        try {
+            await mkdir(parentDir, { recursive: true });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error creating directories.';
+            return {
+                data: `Failed to create parent directory "${parentDir}": ${message}`,
+                isError: true,
+            };
+        }
+        // Write the file.
+        try {
+            await writeFile(input.path, input.content, 'utf8');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error writing file.';
+            return {
+                data: `Failed to write file "${input.path}": ${message}`,
+                isError: true,
+            };
+        }
+        const lineCount = input.content.split('\n').length;
+        const byteCount = Buffer.byteLength(input.content, 'utf8');
+        const action = existed ? 'Updated' : 'Created';
+        return {
+            data: `${action} "${input.path}" ` +
+                `(${lineCount} line${lineCount === 1 ? '' : 's'}, ${byteCount} bytes).`,
+            isError: false,
+        };
+    },
+});
+//# sourceMappingURL=file-write.js.map

package/dist/tool/built-in/file-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-write.js","sourceRoot":"","sources":["../../../src/tool/built-in/file-write.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAC9B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACtC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,kFAAkF;QAClF,wDAAwD;QACxD,qFAAqF;QACrF,oBAAoB;IAEtB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CACP,sCAAsC;YACpC,8CAA8C,CACjD;QACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;KACvE,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,+EAA+E;QAC/E,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACtB,OAAO,GAAG,IAAI,CAAA;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;QAED,4CAA4C;QAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACrC,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,qCAAqC,CAAA;YAC5E,OAAO;gBACL,IAAI,EAAE,sCAAsC,SAAS,MAAM,OAAO,EAAE;gBACpE,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;QAED,kBAAkB;QAClB,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAA;YACpE,OAAO;gBACL,IAAI,EAAE,yBAAyB,KAAK,CAAC,IAAI,MAAM,OAAO,EAAE;gBACxD,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAA;QAClD,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;QAE9C,OAAO;YACL,IAAI,EACF,GAAG,MAAM,KAAK,KAAK,CAAC,IAAI,IAAI;gBAC5B,IAAI,SAAS,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,UAAU;YACzE,OAAO,EAAE,KAAK;SACf,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/tool/built-in/fs-walk.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared recursive directory walk for built-in file tools.
+ *
+ * Used by {@link grepTool} and {@link globTool} so glob filtering and skip
+ * rules stay consistent.
+ */
+/** Directories that are almost never useful to traverse for code search. */
+export declare const SKIP_DIRS: Set<string>;
+export interface CollectFilesOptions {
+    /** When set, stop collecting once this many paths are gathered. */
+    readonly maxFiles?: number;
+}
+/**
+ * Recursively walk `dir` and return file paths, honouring {@link SKIP_DIRS}
+ * and an optional filename glob pattern.
+ */
+export declare function collectFiles(dir: string, glob: string | undefined, signal: AbortSignal | undefined, options?: CollectFilesOptions): Promise<string[]>;
+/**
+ * Minimal glob match supporting `*.ext` and `**<pattern>` forms.
+ *
+*/
+export declare function matchesGlob(filename: string, glob: string): boolean;
+//# sourceMappingURL=fs-walk.d.ts.map

package/dist/tool/built-in/fs-walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-walk.d.ts","sourceRoot":"","sources":["../../../src/tool/built-in/fs-walk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,4EAA4E;AAC5E,eAAO,MAAM,SAAS,aAQpB,CAAA;AAEF,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAInB;AA2CD;;;EAGE;AAGF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQnE"}

package/dist/tool/built-in/fs-walk.js

@@ -0,0 +1,78 @@
+/**
+ * Shared recursive directory walk for built-in file tools.
+ *
+ * Used by {@link grepTool} and {@link globTool} so glob filtering and skip
+ * rules stay consistent.
+ */
+import { readdir, stat } from 'fs/promises';
+import { join } from 'path';
+/** Directories that are almost never useful to traverse for code search. */
+export const SKIP_DIRS = new Set([
+    '.git',
+    '.svn',
+    '.hg',
+    'node_modules',
+    '.next',
+    'dist',
+    'build',
+]);
+/**
+ * Recursively walk `dir` and return file paths, honouring {@link SKIP_DIRS}
+ * and an optional filename glob pattern.
+ */
+export async function collectFiles(dir, glob, signal, options) {
+    const results = [];
+    await walk(dir, glob, results, signal, options?.maxFiles);
+    return results;
+}
+async function walk(dir, glob, results, signal, maxFiles) {
+    if (signal?.aborted === true)
+        return;
+    if (maxFiles !== undefined && results.length >= maxFiles)
+        return;
+    let entryNames;
+    try {
+        entryNames = await readdir(dir, { encoding: 'utf8' });
+    }
+    catch {
+        return;
+    }
+    for (const entryName of entryNames) {
+        if (signal !== undefined && signal.aborted)
+            return;
+        if (maxFiles !== undefined && results.length >= maxFiles)
+            return;
+        const fullPath = join(dir, entryName);
+        let entryInfo;
+        try {
+            entryInfo = await stat(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (entryInfo.isDirectory()) {
+            if (!SKIP_DIRS.has(entryName)) {
+                await walk(fullPath, glob, results, signal, maxFiles);
+            }
+        }
+        else if (entryInfo.isFile()) {
+            if (glob === undefined || matchesGlob(entryName, glob)) {
+                results.push(fullPath);
+            }
+        }
+    }
+}
+/**
+ * Minimal glob match supporting `*.ext` and `**<pattern>` forms.
+ *
+*/
+export function matchesGlob(filename, glob) {
+    const pattern = glob.startsWith('**/') ? glob.slice(3) : glob;
+    const regexSource = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.');
+    const re = new RegExp(`^${regexSource}$`, 'i');
+    return re.test(filename);
+}
+//# sourceMappingURL=fs-walk.js.map

package/dist/tool/built-in/fs-walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-walk.js","sourceRoot":"","sources":["../../../src/tool/built-in/fs-walk.ts"],"names":[],"mappings":"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"}

package/dist/tool/built-in/glob.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Built-in glob tool.
+ *
+ * Lists file paths under a directory matching an optional filename glob.
+ * Does not read file contents — use {@link grepTool} to search inside files.
+ */
+export declare const globTool: import("../framework.js").ToolDefinition<{
+    path?: string | undefined;
+    pattern?: string | undefined;
+    maxFiles?: number | undefined;
+}>;
+//# sourceMappingURL=glob.d.ts.map

package/dist/tool/built-in/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../../src/tool/built-in/glob.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,eAAO,MAAM,QAAQ;;;;EAkFnB,CAAA"}

package/dist/tool/built-in/glob.js

@@ -0,0 +1,82 @@
+/**
+ * Built-in glob tool.
+ *
+ * Lists file paths under a directory matching an optional filename glob.
+ * Does not read file contents — use {@link grepTool} to search inside files.
+ */
+import { stat } from 'fs/promises';
+import { basename, relative } from 'path';
+import { z } from 'zod';
+import { collectFiles, matchesGlob } from './fs-walk.js';
+import { defineTool } from '../framework.js';
+const DEFAULT_MAX_FILES = 500;
+export const globTool = defineTool({
+    name: 'glob',
+    description: 'List file paths under a directory that match an optional filename glob. ' +
+        'Does not read file contents — use `grep` to search inside files. ' +
+        'Skips common bulky directories (node_modules, .git, dist, etc.). ' +
+        'Paths in the result are relative to the process working directory. ' +
+        'Results are capped by `maxFiles`.',
+    inputSchema: z.object({
+        path: z
+            .string()
+            .optional()
+            .describe('Directory to list files under. Defaults to the current working directory.'),
+        pattern: z
+            .string()
+            .optional()
+            .describe('Filename glob (e.g. "*.ts", "**/*.json"). When omitted, every file ' +
+            'under the directory is listed (subject to maxFiles and skipped dirs).'),
+        maxFiles: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe(`Maximum number of file paths to return. Defaults to ${DEFAULT_MAX_FILES}.`),
+    }),
+    execute: async (input, context) => {
+        const root = input.path ?? process.cwd();
+        const maxFiles = input.maxFiles ?? DEFAULT_MAX_FILES;
+        const signal = context.abortSignal;
+        let linesOut;
+        let truncated = false;
+        try {
+            const info = await stat(root);
+            if (info.isFile()) {
+                const name = basename(root);
+                if (input.pattern !== undefined &&
+                    !matchesGlob(name, input.pattern)) {
+                    return { data: 'No files matched.', isError: false };
+                }
+                linesOut = [relative(process.cwd(), root) || root];
+            }
+            else {
+                const collected = await collectFiles(root, input.pattern, signal, {
+                    maxFiles: maxFiles + 1,
+                });
+                truncated = collected.length > maxFiles;
+                const capped = collected.slice(0, maxFiles);
+                linesOut = capped.map((f) => relative(process.cwd(), f) || f);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return {
+                data: `Cannot access path "${root}": ${message}`,
+                isError: true,
+            };
+        }
+        if (linesOut.length === 0) {
+            return { data: 'No files matched.', isError: false };
+        }
+        const sorted = [...linesOut].sort((a, b) => a.localeCompare(b));
+        const truncationNote = truncated
+            ? `\n\n(listing capped at ${maxFiles} paths; raise maxFiles for more)`
+            : '';
+        return {
+            data: sorted.join('\n') + truncationNote,
+            isError: false,
+        };
+    },
+});
+//# sourceMappingURL=glob.js.map

package/dist/tool/built-in/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../../src/tool/built-in/glob.ts"],"names":[],"mappings":"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"}

package/dist/tool/built-in/grep.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Built-in grep tool.
+ *
+ * Searches for a regex pattern in files.  Prefers the `rg` (ripgrep) binary
+ * when available for performance; falls back to a pure Node.js recursive
+ * implementation using the standard `fs` module so the tool works in
+ * environments without ripgrep installed.
+ */
+export declare const grepTool: import("../framework.js").ToolDefinition<{
+    pattern: string;
+    path?: string | undefined;
+    glob?: string | undefined;
+    maxResults?: number | undefined;
+}>;
+//# sourceMappingURL=grep.d.ts.map

package/dist/tool/built-in/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../../src/tool/built-in/grep.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoBH,eAAO,MAAM,QAAQ;;;;;EAwEnB,CAAA"}