@open-multi-agent/core 1.4.0

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

@@ -0,0 +1,218 @@
+/**
+ * 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 { readFile, stat } from 'fs/promises';
+import { relative } from 'path';
+import { z } from 'zod';
+import { defineTool } from '../framework.js';
+import { collectFiles } from './fs-walk.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_MAX_RESULTS = 100;
+// ---------------------------------------------------------------------------
+// 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"). ' +
+        'To list matching file paths without reading contents, use the `glob` tool. ' +
+        '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,
+    };
+}
+// ---------------------------------------------------------------------------
+// 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,48 @@
+/**
+ * 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 { delegateToAgentTool } from './delegate.js';
+import { fileEditTool } from './file-edit.js';
+import { fileReadTool } from './file-read.js';
+import { fileWriteTool } from './file-write.js';
+import { globTool } from './glob.js';
+import { grepTool } from './grep.js';
+export { bashTool, delegateToAgentTool, fileEditTool, fileReadTool, fileWriteTool, globTool, grepTool };
+/** Options for {@link registerBuiltInTools}. */
+export interface RegisterBuiltInToolsOptions {
+    /**
+     * When true, registers `delegate_to_agent` (team orchestration handoff).
+     * Default false so standalone agents and `runAgent` do not expose a tool that always errors.
+     */
+    readonly includeDelegateTool?: boolean;
+}
+/**
+ * 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>[];
+/** All built-ins including `delegate_to_agent` (for team registry setup). */
+export declare const ALL_BUILT_IN_TOOLS_WITH_DELEGATE: 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, options?: RegisterBuiltInToolsOptions): 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,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,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;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAA;AAEvG,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CACvC;AAED;;;;;;GAMG;AAEH,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,GAAG,CAAC,EAO/C,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,gCAAgC,EAAE,cAAc,CAAC,GAAG,CAAC,EAGjE,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,2BAA2B,GACpC,IAAI,CAON"}

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

@@ -0,0 +1,56 @@
+/**
+ * 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 { delegateToAgentTool } from './delegate.js';
+import { fileEditTool } from './file-edit.js';
+import { fileReadTool } from './file-read.js';
+import { fileWriteTool } from './file-write.js';
+import { globTool } from './glob.js';
+import { grepTool } from './grep.js';
+export { bashTool, delegateToAgentTool, fileEditTool, fileReadTool, fileWriteTool, globTool, 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,
+    globTool,
+];
+/** All built-ins including `delegate_to_agent` (for team registry setup). */
+export const ALL_BUILT_IN_TOOLS_WITH_DELEGATE = [
+    ...BUILT_IN_TOOLS,
+    delegateToAgentTool,
+];
+/**
+ * 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, options) {
+    for (const tool of BUILT_IN_TOOLS) {
+        registry.register(tool);
+    }
+    if (options?.includeDelegateTool) {
+        registry.register(delegateToAgentTool);
+    }
+}
+//# 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,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,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;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAA;AAWvG;;;;;;GAMG;AACH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD,QAAQ;IACR,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,QAAQ;CACT,CAAA;AAED,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gCAAgC,GAA0B;IACrE,GAAG,cAAc;IACjB,mBAAmB;CACpB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAsB,EACtB,OAAqC;IAErC,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IACD,IAAI,OAAO,EAAE,mBAAmB,EAAE,CAAC;QACjC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAA;IACxC,CAAC;AACH,CAAC"}

package/dist/tool/executor.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Parallel tool executor with concurrency control and error isolation.
+ *
+ * Validates input via Zod schemas, optionally validates tool output via
+ * `tool.outputSchema`, enforces a maximum concurrency limit using a lightweight
+ * semaphore, 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;
+    /**
+     * Agent-level default for maximum tool output length in characters.
+     * Per-tool `maxOutputChars` takes priority over this value.
+     */
+    maxToolOutputChars?: 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;
+    private readonly maxToolOutputChars?;
+    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`.
+     *
+     * When `tool.outputSchema` is configured and the tool returned a
+     * **non-error** result, `result.data` is validated against the schema
+     * before truncation is applied. Error results are forwarded as-is so the
+     * LLM still sees the original failure message.
+     *
+     * Any synchronous or asynchronous error thrown by the tool is caught and
+     * turned into an error {@link ToolResult} instead of propagating.
+     */
+    private runTool;
+    /** Run a Zod schema and return a flattened issue string on failure. */
+    private runZodSchema;
+    /**
+     * Apply truncation to a tool result if a character limit is configured.
+     * Priority: per-tool `maxOutputChars` > agent-level `maxToolOutputChars`.
+     */
+    private maybeTruncate;
+    /** Construct an error ToolResult. */
+    private errorResult;
+}
+/**
+ * Truncate tool output to fit within `maxChars`, preserving the head (~70%)
+ * and tail (~30%) with a marker indicating how many characters were removed.
+ *
+ * The marker itself is counted against the budget so the returned string
+ * never exceeds `maxChars`. When `maxChars` is too small to fit any
+ * content alongside the marker, a marker-only string is returned.
+ */
+export declare function truncateToolOutput(data: string, maxChars: number): string;
+//# sourceMappingURL=executor.d.ts.map

package/dist/tool/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/tool/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAQ7C,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAA;IACV,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAQ;gBAEhC,QAAQ,EAAE,YAAY,EAAE,OAAO,GAAE,mBAAwB;IAUrE;;;;;;;;;OASG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;IAsBtB;;;;;;;;OAQG;IACG,YAAY,CAChB,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAmBnC;;;;;;;;;;OAUG;YACW,OAAO;IA4CrB,uEAAuE;IACvE,OAAO,CAAC,YAAY;IAcpB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAYrB,qCAAqC;IACrC,OAAO,CAAC,WAAW;CAMpB;AAMD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoBzE"}

package/dist/tool/executor.js

@@ -0,0 +1,184 @@
+/**
+ * Parallel tool executor with concurrency control and error isolation.
+ *
+ * Validates input via Zod schemas, optionally validates tool output via
+ * `tool.outputSchema`, enforces a maximum concurrency limit using a lightweight
+ * semaphore, 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 { Semaphore } from '../utils/semaphore.js';
+/**
+ * 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 class ToolExecutor {
+    registry;
+    semaphore;
+    maxToolOutputChars;
+    constructor(registry, options = {}) {
+        this.registry = registry;
+        this.semaphore = new Semaphore(options.maxConcurrency ?? 4);
+        this.maxToolOutputChars = options.maxToolOutputChars;
+    }
+    // -------------------------------------------------------------------------
+    // Single execution
+    // -------------------------------------------------------------------------
+    /**
+     * 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.
+     */
+    async execute(toolName, input, context) {
+        const tool = this.registry.get(toolName);
+        if (tool === undefined) {
+            return this.errorResult(`Tool "${toolName}" is not registered in the ToolRegistry.`);
+        }
+        // Check abort before even starting
+        if (context.abortSignal?.aborted === true) {
+            return this.errorResult(`Tool "${toolName}" was aborted before execution began.`);
+        }
+        return this.runTool(tool, input, context);
+    }
+    // -------------------------------------------------------------------------
+    // Batch execution
+    // -------------------------------------------------------------------------
+    /**
+     * 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.
+     */
+    async executeBatch(calls, context) {
+        const results = new Map();
+        await Promise.all(calls.map(async (call) => {
+            const result = await this.semaphore.run(() => this.execute(call.name, call.input, context));
+            results.set(call.id, result);
+        }));
+        return results;
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Validate input with the tool's Zod schema, then call `execute`.
+     *
+     * When `tool.outputSchema` is configured and the tool returned a
+     * **non-error** result, `result.data` is validated against the schema
+     * before truncation is applied. Error results are forwarded as-is so the
+     * LLM still sees the original failure message.
+     *
+     * Any synchronous or asynchronous error thrown by the tool is caught and
+     * turned into an error {@link ToolResult} instead of propagating.
+     */
+    async runTool(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    tool, rawInput, context) {
+        // --- Zod validation ---
+        const inputParseResult = this.runZodSchema(tool.inputSchema, rawInput);
+        if (!inputParseResult.success) {
+            return this.errorResult(`Invalid input for tool "${tool.name}":\n${inputParseResult.issuesMessage}`);
+        }
+        // --- Abort check after parse (parse can be expensive for large inputs) ---
+        if (context.abortSignal?.aborted === true) {
+            return this.errorResult(`Tool "${tool.name}" was aborted before execution began.`);
+        }
+        // --- Execute ---
+        try {
+            const result = await tool.execute(inputParseResult.data, context);
+            if (!result.isError && tool.outputSchema) {
+                const outputParseResult = this.runZodSchema(tool.outputSchema, result.data);
+                if (!outputParseResult.success) {
+                    return this.errorResult(`Invalid output for tool "${tool.name}":\n${outputParseResult.issuesMessage}`);
+                }
+            }
+            return this.maybeTruncate(tool, result);
+        }
+        catch (err) {
+            const message = err instanceof Error
+                ? err.message
+                : typeof err === 'string'
+                    ? err
+                    : JSON.stringify(err);
+            return this.maybeTruncate(tool, this.errorResult(`Tool "${tool.name}" threw an error: ${message}`));
+        }
+    }
+    /** Run a Zod schema and return a flattened issue string on failure. */
+    runZodSchema(schema, rawInput) {
+        const parseResult = schema.safeParse(rawInput);
+        if (!parseResult.success) {
+            const issuesMessage = parseResult.error.issues
+                .map((issue) => `  • ${issue.path.join('.')}: ${issue.message}`)
+                .join('\n');
+            return {
+                ...parseResult,
+                issuesMessage,
+            };
+        }
+        return parseResult;
+    }
+    /**
+     * Apply truncation to a tool result if a character limit is configured.
+     * Priority: per-tool `maxOutputChars` > agent-level `maxToolOutputChars`.
+     */
+    maybeTruncate(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    tool, result) {
+        const maxChars = tool.maxOutputChars ?? this.maxToolOutputChars;
+        if (maxChars === undefined || maxChars <= 0 || result.data.length <= maxChars) {
+            return result;
+        }
+        return { ...result, data: truncateToolOutput(result.data, maxChars) };
+    }
+    /** Construct an error ToolResult. */
+    errorResult(message) {
+        return {
+            data: message,
+            isError: true,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Truncation helper
+// ---------------------------------------------------------------------------
+/**
+ * Truncate tool output to fit within `maxChars`, preserving the head (~70%)
+ * and tail (~30%) with a marker indicating how many characters were removed.
+ *
+ * The marker itself is counted against the budget so the returned string
+ * never exceeds `maxChars`. When `maxChars` is too small to fit any
+ * content alongside the marker, a marker-only string is returned.
+ */
+export function truncateToolOutput(data, maxChars) {
+    if (data.length <= maxChars)
+        return data;
+    // Estimate marker length (digit count may shrink after subtracting content,
+    // but using data.length gives a safe upper-bound for the digit count).
+    const markerTemplate = '\n\n[...truncated  characters...]\n\n';
+    const markerOverhead = markerTemplate.length + String(data.length).length;
+    // When maxChars is too small to fit any content alongside the marker,
+    // fall back to a hard slice so the result never exceeds maxChars.
+    if (maxChars <= markerOverhead) {
+        return data.slice(0, maxChars);
+    }
+    const available = maxChars - markerOverhead;
+    const headChars = Math.floor(available * 0.7);
+    const tailChars = available - headChars;
+    const truncatedCount = data.length - headChars - tailChars;
+    return `${data.slice(0, headChars)}\n\n[...truncated ${truncatedCount} characters...]\n\n${data.slice(-tailChars)}`;
+}
+//# sourceMappingURL=executor.js.map

package/dist/tool/executor.js.map

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