@matimo/core 0.1.0-alpha.4

package/dist/src/decorators/tool-decorator.js

@@ -0,0 +1,157 @@
+import { MatimoError, ErrorCode } from '../errors/matimo-error';
+/**
+ * Global Matimo instance for decorator usage
+ * Set via setGlobalMatimoInstance() before using @tool decorators
+ */
+let globalMatimoInstance = null;
+/**
+ * Set the global Matimo instance for decorator usage
+ *
+ * Must be called before any @tool decorated methods are invoked
+ *
+ * @param instance - The MatimoInstance to use globally
+ *
+ * @example
+ * ```typescript
+ * const matimo = await MatimoInstance.init('./tools');
+ * setGlobalMatimoInstance(matimo);
+ *
+ * class MyAgent {
+ *   @tool('calculator')
+ *   async calculate(operation: string, a: number, b: number) { }
+ * }
+ *
+ * const agent = new MyAgent();
+ * await agent.calculate('add', 5, 3);
+ * ```
+ */
+export function setGlobalMatimoInstance(instance) {
+    globalMatimoInstance = instance;
+}
+/**
+ * Get the global Matimo instance
+ *
+ * @throws {Error} If no global instance is set
+ */
+export function getGlobalMatimoInstance() {
+    if (!globalMatimoInstance) {
+        throw new MatimoError('Global MatimoInstance not set. Call setGlobalMatimoInstance() before using @tool decorator.', ErrorCode.TOOL_NOT_FOUND);
+    }
+    return globalMatimoInstance;
+}
+/**
+ * Tool decorator - transforms a method into a tool executor
+ *
+ * Automatically calls matimo.execute() with the method's arguments mapped to tool parameters.
+ * Must be used in a class that has a `matimo` property or after setGlobalMatimoInstance() is called.
+ *
+ * Works with both traditional and modern TypeScript decorator syntax.
+ *
+ * @param toolName - Name of the tool to execute (e.g., 'calculator', 'github-get-repo')
+ *
+ * @example
+ * ```typescript
+ * // Using global instance
+ * const matimo = await MatimoInstance.init('./tools');
+ * setGlobalMatimoInstance(matimo);
+ *
+ * class MyAgent {
+ *   @tool('calculator')
+ *   async calculate(operation: string, a: number, b: number) {
+ *     // Automatically executes: matimo.execute('calculator', { operation, a, b })
+ *   }
+ *
+ *   @tool('github-get-repo')
+ *   async getRepo(owner: string, repo: string) {
+ *     // Automatically executes: matimo.execute('github-get-repo', { owner, repo })
+ *   }
+ * }
+ *
+ * const agent = new MyAgent();
+ * const result = await agent.calculate('add', 5, 3);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using instance property
+ * class MyAgent {
+ *   constructor(public matimo: MatimoInstance) {}
+ *
+ *   @tool('calculator')
+ *   async calculate(operation: string, a: number, b: number) { }
+ * }
+ *
+ * const matimo = await MatimoInstance.init('./tools');
+ * const agent = new MyAgent(matimo);
+ * const result = await agent.calculate('add', 5, 3);
+ * ```
+ */
+export function tool(toolName) {
+    return function (_target, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _context) {
+        // Handle modern experimental decorator API
+        // The decorator can be used on methods and will receive the method and context
+        // Return a new function that intercepts the call
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return async function (...args) {
+            return executeToolViaDecorator(toolName, this, args);
+        };
+    };
+}
+/**
+ * Execute tool via decorator - shared logic for both decorator syntaxes
+ * Exported for testing purposes
+ */
+export async function executeToolViaDecorator(toolName, thisArg, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+args) {
+    // Get Matimo instance (from class property or global)
+    let matimoInstance = null;
+    if (thisArg && typeof thisArg === 'object' && 'matimo' in thisArg) {
+        matimoInstance = thisArg.matimo || null;
+    }
+    if (!matimoInstance) {
+        matimoInstance = globalMatimoInstance;
+    }
+    if (!matimoInstance) {
+        throw new MatimoError(`Matimo instance not found for @tool('${toolName}') decorator. ` +
+            `Either add matimo property to class or call setGlobalMatimoInstance() first.`, ErrorCode.TOOL_NOT_FOUND, { toolName });
+    }
+    // Get tool definition
+    const toolDef = matimoInstance.getTool(toolName);
+    if (!toolDef) {
+        throw new MatimoError(`Tool '${toolName}' not found in Matimo registry`, ErrorCode.TOOL_NOT_FOUND, {
+            toolName,
+        });
+    }
+    // Convert positional arguments to parameters object
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const params = convertArgsToParams(args, toolDef);
+    // Execute tool via Matimo
+    return matimoInstance.execute(toolName, params);
+}
+/**
+ * Convert positional arguments to named parameters object
+ * Maps function arguments to tool parameter names in order
+ * Exported for testing purposes
+ *
+ * @example
+ * ```
+ * Tool has parameters: { operation, a, b }
+ * Args: ['add', 5, 3]
+ * Result: { operation: 'add', a: 5, b: 3 }
+ * ```
+ */
+export function convertArgsToParams(args, toolDef) {
+    const params = {};
+    if (!toolDef.parameters) {
+        return params;
+    }
+    const paramNames = Object.keys(toolDef.parameters);
+    for (let i = 0; i < args.length && i < paramNames.length; i++) {
+        params[paramNames[i]] = args[i];
+    }
+    return params;
+}
+//# sourceMappingURL=tool-decorator.js.map

package/dist/src/decorators/tool-decorator.js.map

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

package/dist/src/encodings/parameter-encoding.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Generic parameter encoding system for transforming input parameters
+ * Used to convert structured parameters into API-specific formats (MIME, JSON, etc.)
+ *
+ * This is YAML-driven via the parameter_encoding directive in tool definitions.
+ * No tool-specific code needed - keeps Matimo universal.
+ */
+/**
+ * Encoding configuration from YAML
+ */
+export interface ParameterEncodingConfig {
+    source: string[];
+    target: string;
+    encoding: string;
+    options?: Record<string, unknown>;
+}
+/**
+ * Apply parameter encodings to transform input parameters
+ * @param params - User-provided parameters
+ * @param encodings - List of encoding configurations from tool YAML
+ * @returns Parameters with encoded values added
+ */
+export declare function applyParameterEncodings(params: Record<string, unknown>, encodings: ParameterEncodingConfig[]): Record<string, unknown>;
+/**
+ * Example usage in YAML:
+ *
+ * execution:
+ *   type: http
+ *   method: POST
+ *   url: 'https://www.googleapis.com/gmail/v1/users/me/messages/send'
+ *   headers:
+ *     Content-Type: 'application/json'
+ *     Authorization: 'Bearer {GMAIL_ACCESS_TOKEN}'
+ *
+ *   parameter_encoding:
+ *     - source: [to, subject, body, cc, bcc, is_html]
+ *       target: raw
+ *       encoding: mime_rfc2822_base64url
+ *
+ *   body:
+ *     raw: '{raw}'
+ *
+ * Then users call:
+ *   matimo.execute('gmail-send-email', {
+ *     to: 'user@example.com',
+ *     subject: 'Hello',
+ *     body: 'Hi there',
+ *     GMAIL_ACCESS_TOKEN: token
+ *   });
+ */
+//# sourceMappingURL=parameter-encoding.d.ts.map

package/dist/src/encodings/parameter-encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-encoding.d.ts","sourceRoot":"","sources":["../../../src/encodings/parameter-encoding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,uBAAuB,EAAE,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB;AAkFD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/dist/src/encodings/parameter-encoding.js

@@ -0,0 +1,123 @@
+/**
+ * Generic parameter encoding system for transforming input parameters
+ * Used to convert structured parameters into API-specific formats (MIME, JSON, etc.)
+ *
+ * This is YAML-driven via the parameter_encoding directive in tool definitions.
+ * No tool-specific code needed - keeps Matimo universal.
+ */
+import { MatimoError, ErrorCode } from '../errors/matimo-error';
+/**
+ * Apply parameter encodings to transform input parameters
+ * @param params - User-provided parameters
+ * @param encodings - List of encoding configurations from tool YAML
+ * @returns Parameters with encoded values added
+ */
+export function applyParameterEncodings(params, encodings) {
+    const result = { ...params };
+    for (const config of encodings) {
+        // Extract source parameters
+        const sourceValues = {};
+        for (const key of config.source) {
+            if (key in params) {
+                sourceValues[key] = params[key];
+            }
+        }
+        // Apply encoding function
+        const encodedValue = encodeParameters(sourceValues, config.encoding, config.options);
+        // Store in target parameter
+        result[config.target] = encodedValue;
+    }
+    return result;
+}
+/**
+ * Route to specific encoding function based on type
+ */
+function encodeParameters(sourceValues, encoding, _options) {
+    switch (encoding) {
+        case 'mime_rfc2822_base64url':
+            return encodeMimeRfc2822(sourceValues);
+        case 'json_compact':
+            return JSON.stringify(sourceValues);
+        case 'url_encoded':
+            return encodeUrlParams(sourceValues);
+        default:
+            throw new MatimoError(`Unknown parameter encoding type: ${encoding}`, ErrorCode.INVALID_PARAMETER, {
+                encodingType: encoding,
+                supportedTypes: ['mime_rfc2822_base64url', 'json_compact', 'url_encoded'],
+            });
+    }
+}
+/**
+ * Encode parameters as RFC 2822 MIME message with base64url encoding
+ * Used for Gmail and other email APIs that accept raw MIME format
+ */
+function encodeMimeRfc2822(sourceValues) {
+    const to = sourceValues.to;
+    const subject = sourceValues.subject;
+    const body = sourceValues.body;
+    const cc = sourceValues.cc;
+    const bcc = sourceValues.bcc;
+    const isHtml = sourceValues.is_html || false;
+    if (!to || !subject || !body) {
+        throw new MatimoError('MIME encoding requires: to, subject, body parameters', ErrorCode.INVALID_PARAMETER, {
+            requiredFields: ['to', 'subject', 'body'],
+            providedFields: Object.keys(sourceValues),
+        });
+    }
+    // Build RFC 2822 MIME message
+    let message = '';
+    message += `To: ${to}\r\n`;
+    message += `Subject: ${subject}\r\n`;
+    if (cc)
+        message += `Cc: ${cc}\r\n`;
+    if (bcc)
+        message += `Bcc: ${bcc}\r\n`;
+    message += `Content-Type: ${isHtml ? 'text/html' : 'text/plain'}; charset="UTF-8"\r\n`;
+    message += 'Content-Transfer-Encoding: 7bit\r\n';
+    message += '\r\n'; // Empty line separates headers from body
+    message += body;
+    // Convert to base64url
+    const base64 = Buffer.from(message).toString('base64');
+    // Replace standard base64 characters with URL-safe variants
+    return base64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+/**
+ * Encode parameters as URL-encoded form data
+ */
+function encodeUrlParams(sourceValues) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(sourceValues)) {
+        if (value !== undefined && value !== null) {
+            params.append(key, String(value));
+        }
+    }
+    return params.toString();
+}
+/**
+ * Example usage in YAML:
+ *
+ * execution:
+ *   type: http
+ *   method: POST
+ *   url: 'https://www.googleapis.com/gmail/v1/users/me/messages/send'
+ *   headers:
+ *     Content-Type: 'application/json'
+ *     Authorization: 'Bearer {GMAIL_ACCESS_TOKEN}'
+ *
+ *   parameter_encoding:
+ *     - source: [to, subject, body, cc, bcc, is_html]
+ *       target: raw
+ *       encoding: mime_rfc2822_base64url
+ *
+ *   body:
+ *     raw: '{raw}'
+ *
+ * Then users call:
+ *   matimo.execute('gmail-send-email', {
+ *     to: 'user@example.com',
+ *     subject: 'Hello',
+ *     body: 'Hi there',
+ *     GMAIL_ACCESS_TOKEN: token
+ *   });
+ */
+//# sourceMappingURL=parameter-encoding.js.map

package/dist/src/encodings/parameter-encoding.js.map

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

package/dist/src/errors/matimo-error.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Error codes and custom error class for Matimo
+ */
+export declare enum ErrorCode {
+    INVALID_SCHEMA = "INVALID_SCHEMA",
+    EXECUTION_FAILED = "EXECUTION_FAILED",
+    AUTH_FAILED = "AUTH_FAILED",
+    TOOL_NOT_FOUND = "TOOL_NOT_FOUND",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    VALIDATION_FAILED = "VALIDATION_FAILED",
+    RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
+    TIMEOUT = "TIMEOUT",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    INVALID_PARAMETER = "INVALID_PARAMETER",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * Custom error class for Matimo
+ */
+export declare class MatimoError extends Error {
+    code: ErrorCode;
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: ErrorCode, details?: Record<string, unknown> | undefined);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Create a validation error with context
+ */
+export declare function createValidationError(message: string, details?: Record<string, unknown>): MatimoError;
+/**
+ * Create an execution error with context
+ */
+export declare function createExecutionError(message: string, details?: Record<string, unknown>): MatimoError;
+//# sourceMappingURL=matimo-error.d.ts.map

package/dist/src/errors/matimo-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matimo-error.d.ts","sourceRoot":"","sources":["../../../src/errors/matimo-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,SAAS;IACnB,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAG3B,IAAI,EAAE,SAAS;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFxC,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;IAM1C,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW,CAEb"}

package/dist/src/errors/matimo-error.js

@@ -0,0 +1,49 @@
+/**
+ * Error codes and custom error class for Matimo
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["INVALID_SCHEMA"] = "INVALID_SCHEMA";
+    ErrorCode["EXECUTION_FAILED"] = "EXECUTION_FAILED";
+    ErrorCode["AUTH_FAILED"] = "AUTH_FAILED";
+    ErrorCode["TOOL_NOT_FOUND"] = "TOOL_NOT_FOUND";
+    ErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    ErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+    ErrorCode["RATE_LIMIT_EXCEEDED"] = "RATE_LIMIT_EXCEEDED";
+    ErrorCode["TIMEOUT"] = "TIMEOUT";
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCode["INVALID_PARAMETER"] = "INVALID_PARAMETER";
+    ErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+/**
+ * Custom error class for Matimo
+ */
+export class MatimoError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'MatimoError';
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            details: this.details,
+        };
+    }
+}
+/**
+ * Create a validation error with context
+ */
+export function createValidationError(message, details) {
+    return new MatimoError(message, ErrorCode.VALIDATION_FAILED, details);
+}
+/**
+ * Create an execution error with context
+ */
+export function createExecutionError(message, details) {
+    return new MatimoError(message, ErrorCode.EXECUTION_FAILED, details);
+}
+//# sourceMappingURL=matimo-error.js.map

package/dist/src/errors/matimo-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matimo-error.js","sourceRoot":"","sources":["../../../src/errors/matimo-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,SAYX;AAZD,WAAY,SAAS;IACnB,8CAAiC,CAAA;IACjC,kDAAqC,CAAA;IACrC,wCAA2B,CAAA;IAC3B,8CAAiC,CAAA;IACjC,8CAAiC,CAAA;IACjC,oDAAuC,CAAA;IACvC,wDAA2C,CAAA;IAC3C,gCAAmB,CAAA;IACnB,4CAA+B,CAAA;IAC/B,oDAAuC,CAAA;IACvC,4CAA+B,CAAA;AACjC,CAAC,EAZW,SAAS,KAAT,SAAS,QAYpB;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YACE,OAAe,EACR,IAAe,EACf,OAAiC;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAW;QACf,YAAO,GAAP,OAAO,CAA0B;QAGxC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,OAAiC;IAEjC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,OAAiC;IAEjC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC"}

package/dist/src/executors/command-executor.d.ts

@@ -0,0 +1,19 @@
+import { ToolDefinition } from '../core/schema';
+/**
+ * CommandExecutor - Executes shell commands
+ * Handles parameter templating, timeouts, and error capture
+ */
+export declare class CommandExecutor {
+    private cwd?;
+    constructor(cwd?: string);
+    /**
+     * Execute a tool that runs a shell command
+     */
+    execute(tool: ToolDefinition, params: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Replace parameter placeholders in a string
+     */
+    private templateString;
+}
+export default CommandExecutor;
+//# sourceMappingURL=command-executor.d.ts.map

package/dist/src/executors/command-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-executor.d.ts","sourceRoot":"","sources":["../../../src/executors/command-executor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;;GAGG;AAEH,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAC,CAAS;gBAET,GAAG,CAAC,EAAE,MAAM;IAIxB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAqFtF;;OAEG;IACH,OAAO,CAAC,cAAc;CAQvB;AAED,eAAe,eAAe,CAAC"}

package/dist/src/executors/command-executor.js

@@ -0,0 +1,98 @@
+import { spawn } from 'child_process';
+import { MatimoError, ErrorCode } from '../errors/matimo-error';
+/**
+ * CommandExecutor - Executes shell commands
+ * Handles parameter templating, timeouts, and error capture
+ */
+export class CommandExecutor {
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    /**
+     * Execute a tool that runs a shell command
+     */
+    async execute(tool, params) {
+        if (tool.execution.type !== 'command') {
+            throw new MatimoError('Tool execution type is not command', ErrorCode.EXECUTION_FAILED, {
+                expectedType: 'command',
+                actualType: tool.execution.type,
+            });
+        }
+        const { command, args = [], timeout = 30000 } = tool.execution;
+        const startTime = Date.now();
+        // Implement parameter templating
+        const templatedCommand = this.templateString(command, params);
+        const templatedArgs = args.map((arg) => this.templateString(arg, params));
+        return new Promise((resolve) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const spawnOptions = {
+                stdio: ['pipe', 'pipe', 'pipe'],
+            };
+            // Set working directory if provided
+            if (this.cwd) {
+                spawnOptions.cwd = this.cwd;
+            }
+            const child = spawn(templatedCommand, templatedArgs, spawnOptions);
+            let stdout = '';
+            let stderr = '';
+            let timedOut = false;
+            // Set up timeout
+            const timer = setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGTERM');
+            }, timeout);
+            child.stdout?.on('data', (data) => {
+                stdout += data.toString();
+            });
+            child.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            child.on('close', (code) => {
+                clearTimeout(timer);
+                const duration = Date.now() - startTime;
+                if (timedOut) {
+                    resolve({
+                        success: false,
+                        error: 'timeout',
+                        exitCode: -1,
+                        duration,
+                    });
+                }
+                else {
+                    const exitCode = code || 0;
+                    const success = exitCode === 0;
+                    resolve({
+                        success,
+                        stdout: stdout.trim(),
+                        stderr: stderr.trim(),
+                        exitCode,
+                        duration,
+                    });
+                }
+            });
+            child.on('error', (error) => {
+                clearTimeout(timer);
+                const duration = Date.now() - startTime;
+                resolve({
+                    success: false,
+                    error: error.message,
+                    exitCode: -1,
+                    duration,
+                });
+            });
+        });
+    }
+    /**
+     * Replace parameter placeholders in a string
+     */
+    templateString(str, params) {
+        let result = str;
+        for (const [key, value] of Object.entries(params)) {
+            const placeholder = `{${key}}`;
+            result = result.replace(new RegExp(placeholder, 'g'), String(value));
+        }
+        return result;
+    }
+}
+export default CommandExecutor;
+//# sourceMappingURL=command-executor.js.map

package/dist/src/executors/command-executor.js.map

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

package/dist/src/executors/function-executor.d.ts

@@ -0,0 +1,23 @@
+import { ToolDefinition } from '../core/schema';
+/**
+ * FunctionExecutor - Executes async functions
+ * Supports functions defined in:
+ * 1. Embedded code in tool YAML (legacy)
+ * 2. Colocated .ts files (recommended)
+ *
+ * For .ts files, the tool directory structure should be:
+ * tools/provider/tool-name/
+ * ├── definition.yaml
+ * └── tool-name.ts (exports default async function)
+ */
+export declare class FunctionExecutor {
+    private toolsPath;
+    constructor(toolsPath?: string);
+    /**
+     * Execute a tool that runs an async function
+     * Supports both embedded code and external .ts/.js files
+     */
+    execute(tool: ToolDefinition, params: Record<string, unknown>): Promise<unknown>;
+}
+export default FunctionExecutor;
+//# sourceMappingURL=function-executor.d.ts.map

package/dist/src/executors/function-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-executor.d.ts","sourceRoot":"","sources":["../../../src/executors/function-executor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,CAAC,EAAE,MAAM;IAI9B;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAmKvF;AAED,eAAe,gBAAgB,CAAC"}