@jackchen_me/open-multi-agent 0.1.0

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":"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"}

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/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;AA8BH,eAAO,MAAM,QAAQ;;;;;EAuEnB,CAAA"}

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

@@ -0,0 +1,287 @@
+/**
+ * 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.
+ */
+import { spawn } from 'child_process';
+import { readdir, readFile, stat } from 'fs/promises';
+// Note: readdir is used with { encoding: 'utf8' } to return string[] directly.
+import { join, relative } from 'path';
+import { z } from 'zod';
+import { defineTool } from '../framework.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_MAX_RESULTS = 100;
+// Directories that are almost never useful to search inside
+const SKIP_DIRS = new Set([
+    '.git',
+    '.svn',
+    '.hg',
+    'node_modules',
+    '.next',
+    'dist',
+    'build',
+]);
+// ---------------------------------------------------------------------------
+// Tool definition
+// ---------------------------------------------------------------------------
+export const grepTool = defineTool({
+    name: 'grep',
+    description: 'Search for a regular-expression pattern in one or more files. ' +
+        'Returns matching lines with their file paths and 1-based line numbers. ' +
+        'Use the `glob` parameter to restrict the search to specific file types ' +
+        '(e.g. "*.ts"). ' +
+        'Results are capped by `maxResults` to keep the response manageable.',
+    inputSchema: z.object({
+        pattern: z
+            .string()
+            .describe('Regular expression pattern to search for in file contents.'),
+        path: z
+            .string()
+            .optional()
+            .describe('Directory or file path to search in. ' +
+            'Defaults to the current working directory.'),
+        glob: z
+            .string()
+            .optional()
+            .describe('Glob pattern to filter which files are searched ' +
+            '(e.g. "*.ts", "**/*.json"). ' +
+            'Only used when `path` is a directory.'),
+        maxResults: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe(`Maximum number of matching lines to return. ` +
+            `Defaults to ${DEFAULT_MAX_RESULTS}.`),
+    }),
+    execute: async (input, context) => {
+        const searchPath = input.path ?? process.cwd();
+        const maxResults = input.maxResults ?? DEFAULT_MAX_RESULTS;
+        // Compile the regex once and surface bad patterns immediately.
+        let regex;
+        try {
+            regex = new RegExp(input.pattern);
+        }
+        catch {
+            return {
+                data: `Invalid regular expression: "${input.pattern}"`,
+                isError: true,
+            };
+        }
+        // Attempt ripgrep first.
+        const rgAvailable = await isRipgrepAvailable();
+        if (rgAvailable) {
+            return runRipgrep(input.pattern, searchPath, {
+                glob: input.glob,
+                maxResults,
+                signal: context.abortSignal,
+            });
+        }
+        // Fallback: pure Node.js recursive search.
+        return runNodeSearch(regex, searchPath, {
+            glob: input.glob,
+            maxResults,
+            signal: context.abortSignal,
+        });
+    },
+});
+async function runRipgrep(pattern, searchPath, options) {
+    const args = [
+        '--line-number',
+        '--no-heading',
+        '--color=never',
+        `--max-count=${options.maxResults}`,
+    ];
+    if (options.glob !== undefined) {
+        args.push('--glob', options.glob);
+    }
+    args.push('--', pattern, searchPath);
+    return new Promise((resolve) => {
+        const chunks = [];
+        const errChunks = [];
+        const child = spawn('rg', args, { stdio: ['ignore', 'pipe', 'pipe'] });
+        child.stdout.on('data', (d) => chunks.push(d));
+        child.stderr.on('data', (d) => errChunks.push(d));
+        const onAbort = () => { child.kill('SIGKILL'); };
+        if (options.signal !== undefined) {
+            options.signal.addEventListener('abort', onAbort, { once: true });
+        }
+        child.on('close', (code) => {
+            if (options.signal !== undefined) {
+                options.signal.removeEventListener('abort', onAbort);
+            }
+            const output = Buffer.concat(chunks).toString('utf8').trimEnd();
+            // rg exit code 1 = no matches (not an error)
+            if (code !== 0 && code !== 1) {
+                const errMsg = Buffer.concat(errChunks).toString('utf8').trim();
+                resolve({
+                    data: `ripgrep failed (exit ${code}): ${errMsg}`,
+                    isError: true,
+                });
+                return;
+            }
+            if (output.length === 0) {
+                resolve({ data: 'No matches found.', isError: false });
+                return;
+            }
+            const lines = output.split('\n');
+            resolve({
+                data: lines.join('\n'),
+                isError: false,
+            });
+        });
+        child.on('error', () => {
+            if (options.signal !== undefined) {
+                options.signal.removeEventListener('abort', onAbort);
+            }
+            // Caller will see an error result — the tool won't retry with Node search
+            // since this branch is only reachable after we confirmed rg is available.
+            resolve({
+                data: 'ripgrep process error — run may be retried with the Node.js fallback.',
+                isError: true,
+            });
+        });
+    });
+}
+async function runNodeSearch(regex, searchPath, options) {
+    // Collect files
+    let files;
+    try {
+        const info = await stat(searchPath);
+        if (info.isFile()) {
+            files = [searchPath];
+        }
+        else {
+            files = await collectFiles(searchPath, options.glob, options.signal);
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        return {
+            data: `Cannot access path "${searchPath}": ${message}`,
+            isError: true,
+        };
+    }
+    const matches = [];
+    for (const file of files) {
+        if (options.signal?.aborted === true)
+            break;
+        if (matches.length >= options.maxResults)
+            break;
+        let fileContent;
+        try {
+            fileContent = (await readFile(file)).toString('utf8');
+        }
+        catch {
+            // Skip unreadable files (binary, permission denied, etc.)
+            continue;
+        }
+        const lines = fileContent.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            if (matches.length >= options.maxResults)
+                break;
+            // Reset lastIndex for global regexes
+            regex.lastIndex = 0;
+            if (regex.test(lines[i])) {
+                matches.push({
+                    file: relative(process.cwd(), file) || file,
+                    lineNumber: i + 1,
+                    text: lines[i],
+                });
+            }
+        }
+    }
+    if (matches.length === 0) {
+        return { data: 'No matches found.', isError: false };
+    }
+    const formatted = matches
+        .map((m) => `${m.file}:${m.lineNumber}:${m.text}`)
+        .join('\n');
+    const truncationNote = matches.length >= options.maxResults
+        ? `\n\n(results capped at ${options.maxResults}; use maxResults to raise the limit)`
+        : '';
+    return {
+        data: formatted + truncationNote,
+        isError: false,
+    };
+}
+// ---------------------------------------------------------------------------
+// File collection with glob filtering
+// ---------------------------------------------------------------------------
+/**
+ * Recursively walk `dir` and return file paths, honouring `SKIP_DIRS` and an
+ * optional glob pattern.
+ */
+async function collectFiles(dir, glob, signal) {
+    const results = [];
+    await walk(dir, glob, results, signal);
+    return results;
+}
+async function walk(dir, glob, results, signal) {
+    if (signal?.aborted === true)
+        return;
+    let entryNames;
+    try {
+        // Read as plain strings so we don't have to deal with Buffer Dirent variants.
+        entryNames = await readdir(dir, { encoding: 'utf8' });
+    }
+    catch {
+        return;
+    }
+    for (const entryName of entryNames) {
+        if (signal !== undefined && signal.aborted)
+            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);
+            }
+        }
+        else if (entryInfo.isFile()) {
+            if (glob === undefined || matchesGlob(entryName, glob)) {
+                results.push(fullPath);
+            }
+        }
+    }
+}
+/**
+ * Minimal glob match supporting `*.ext` and `**\/<pattern>` forms.
+ */
+function matchesGlob(filename, glob) {
+    // Strip leading **/ prefix — we already recurse into all directories
+    const pattern = glob.startsWith('**/') ? glob.slice(3) : glob;
+    // Convert shell glob characters to regex equivalents
+    const regexSource = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&') // escape special regex chars first
+        .replace(/\*/g, '.*') // * -> .*
+        .replace(/\?/g, '.'); // ? -> .
+    const re = new RegExp(`^${regexSource}$`, 'i');
+    return re.test(filename);
+}
+// ---------------------------------------------------------------------------
+// ripgrep availability check (cached per process)
+// ---------------------------------------------------------------------------
+let rgAvailableCache;
+async function isRipgrepAvailable() {
+    if (rgAvailableCache !== undefined)
+        return rgAvailableCache;
+    rgAvailableCache = await new Promise((resolve) => {
+        const child = spawn('rg', ['--version'], { stdio: 'ignore' });
+        child.on('close', (code) => resolve(code === 0));
+        child.on('error', () => resolve(false));
+    });
+    return rgAvailableCache;
+}
+//# sourceMappingURL=grep.js.map

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * Built-in tool collection.
+ *
+ * Re-exports every built-in tool and provides a convenience function to
+ * register them all with a {@link ToolRegistry} in one call.
+ */
+import type { ToolDefinition } from '../../types.js';
+import { ToolRegistry } from '../framework.js';
+import { bashTool } from './bash.js';
+import { fileEditTool } from './file-edit.js';
+import { fileReadTool } from './file-read.js';
+import { fileWriteTool } from './file-write.js';
+import { grepTool } from './grep.js';
+export { bashTool, fileEditTool, fileReadTool, fileWriteTool, grepTool };
+/**
+ * The ordered list of all built-in tools.  Import this when you need to
+ * iterate over them without calling `registerBuiltInTools`.
+ *
+ * The array is typed as `ToolDefinition<unknown>[]` so it can be passed to
+ * APIs that accept any ToolDefinition without requiring a union type.
+ */
+export declare const BUILT_IN_TOOLS: ToolDefinition<any>[];
+/**
+ * Register all built-in tools with the given registry.
+ *
+ * @example
+ * ```ts
+ * import { ToolRegistry } from '../framework.js'
+ * import { registerBuiltInTools } from './built-in/index.js'
+ *
+ * const registry = new ToolRegistry()
+ * registerBuiltInTools(registry)
+ * ```
+ */
+export declare function registerBuiltInTools(registry: ToolRegistry): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tool/built-in/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAA;AAExE;;;;;;GAMG;AAEH,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,GAAG,CAAC,EAM/C,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAIjE"}

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

@@ -0,0 +1,45 @@
+/**
+ * Built-in tool collection.
+ *
+ * Re-exports every built-in tool and provides a convenience function to
+ * register them all with a {@link ToolRegistry} in one call.
+ */
+import { bashTool } from './bash.js';
+import { fileEditTool } from './file-edit.js';
+import { fileReadTool } from './file-read.js';
+import { fileWriteTool } from './file-write.js';
+import { grepTool } from './grep.js';
+export { bashTool, fileEditTool, fileReadTool, fileWriteTool, grepTool };
+/**
+ * The ordered list of all built-in tools.  Import this when you need to
+ * iterate over them without calling `registerBuiltInTools`.
+ *
+ * The array is typed as `ToolDefinition<unknown>[]` so it can be passed to
+ * APIs that accept any ToolDefinition without requiring a union type.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const BUILT_IN_TOOLS = [
+    bashTool,
+    fileReadTool,
+    fileWriteTool,
+    fileEditTool,
+    grepTool,
+];
+/**
+ * Register all built-in tools with the given registry.
+ *
+ * @example
+ * ```ts
+ * import { ToolRegistry } from '../framework.js'
+ * import { registerBuiltInTools } from './built-in/index.js'
+ *
+ * const registry = new ToolRegistry()
+ * registerBuiltInTools(registry)
+ * ```
+ */
+export function registerBuiltInTools(registry) {
+    for (const tool of BUILT_IN_TOOLS) {
+        registry.register(tool);
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tool/built-in/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAA;AAExE;;;;;;GAMG;AACH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD,QAAQ;IACR,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,QAAQ;CACT,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAsB;IACzD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;AACH,CAAC"}

package/dist/tool/executor.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Parallel tool executor with concurrency control and error isolation.
+ *
+ * Validates input via Zod schemas, enforces a maximum concurrency limit using
+ * a lightweight semaphore, tracks execution duration, and surfaces any
+ * execution errors as ToolResult objects rather than thrown exceptions.
+ *
+ * Types are imported from `../types` to ensure consistency with the rest of
+ * the framework.
+ */
+import type { ToolResult, ToolUseContext } from '../types.js';
+import { ToolRegistry } from './framework.js';
+export interface ToolExecutorOptions {
+    /**
+     * Maximum number of tool calls that may run in parallel.
+     * Defaults to 4.
+     */
+    maxConcurrency?: number;
+}
+/** Describes one call in a batch. */
+export interface BatchToolCall {
+    /** Caller-assigned ID used as the key in the result map. */
+    id: string;
+    /** Registered tool name. */
+    name: string;
+    /** Raw (unparsed) input object from the LLM. */
+    input: Record<string, unknown>;
+}
+/**
+ * Executes tools from a {@link ToolRegistry}, validating input against each
+ * tool's Zod schema and enforcing a concurrency limit for batch execution.
+ *
+ * All errors — including unknown tool names, Zod validation failures, and
+ * execution exceptions — are caught and returned as `ToolResult` objects with
+ * `isError: true` so the agent runner can forward them to the LLM.
+ */
+export declare class ToolExecutor {
+    private readonly registry;
+    private readonly semaphore;
+    constructor(registry: ToolRegistry, options?: ToolExecutorOptions);
+    /**
+     * Execute a single tool by name.
+     *
+     * Errors are caught and returned as a {@link ToolResult} with
+     * `isError: true` — this method itself never rejects.
+     *
+     * @param toolName  The registered tool name.
+     * @param input     Raw input object (before Zod validation).
+     * @param context   Execution context forwarded to the tool.
+     */
+    execute(toolName: string, input: Record<string, unknown>, context: ToolUseContext): Promise<ToolResult>;
+    /**
+     * Execute multiple tool calls in parallel, honouring the concurrency limit.
+     *
+     * Returns a `Map` from call ID to result.  Every call in `calls` is
+     * guaranteed to produce an entry — errors are captured as results.
+     *
+     * @param calls    Array of tool calls to execute.
+     * @param context  Shared execution context for all calls in this batch.
+     */
+    executeBatch(calls: BatchToolCall[], context: ToolUseContext): Promise<Map<string, ToolResult>>;
+    /**
+     * Validate input with the tool's Zod schema, then call `execute`.
+     * Any synchronous or asynchronous error is caught and turned into an error
+     * ToolResult.
+     */
+    private runTool;
+    /** Construct an error ToolResult. */
+    private errorResult;
+}
+//# sourceMappingURL=executor.d.ts.map