@matimo/core 0.1.0-alpha.10

package/dist/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/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/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/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;AAIhD;;;;;;;;;;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;CAkLvF;AAED,eAAe,gBAAgB,CAAC"}

package/dist/executors/function-executor.js

@@ -0,0 +1,181 @@
+import fs from 'fs';
+import path from 'path';
+import { pathToFileURL } from 'node:url';
+import axios from 'axios';
+import { MatimoError, ErrorCode } from '../errors/matimo-error';
+import { getGlobalMatimoLogger } from '../logging/logger';
+/**
+ * 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 class FunctionExecutor {
+    constructor(toolsPath) {
+        this.toolsPath = toolsPath || process.cwd();
+    }
+    /**
+     * Execute a tool that runs an async function
+     * Supports both embedded code and external .ts/.js files
+     */
+    async execute(tool, params) {
+        if (tool.execution.type !== 'function') {
+            throw new MatimoError('Tool execution type is not function', ErrorCode.EXECUTION_FAILED, {
+                expectedType: 'function',
+                actualType: tool.execution.type,
+            });
+        }
+        const { code, timeout = 30000 } = tool.execution;
+        if (!code || code.trim().length === 0) {
+            throw new MatimoError('Function code is empty', ErrorCode.EXECUTION_FAILED, {
+                toolName: tool.name,
+            });
+        }
+        return new Promise((resolve) => {
+            let timedOut = false;
+            let settled = false;
+            // Set up timeout that resolves with error
+            const timer = setTimeout(() => {
+                timedOut = true;
+                if (!settled) {
+                    settled = true;
+                    resolve({
+                        success: false,
+                        error: 'Function execution timeout',
+                        code: ErrorCode.EXECUTION_FAILED,
+                    });
+                }
+            }, timeout);
+            const cleanup = () => {
+                clearTimeout(timer);
+            };
+            const handleError = (error) => {
+                cleanup();
+                if (!settled) {
+                    settled = true;
+                    // Resolve with error object for tools to handle
+                    if (error instanceof MatimoError) {
+                        resolve({
+                            success: false,
+                            error: error.message,
+                            code: error.code,
+                            details: error.details,
+                        });
+                    }
+                    else if (error instanceof Error) {
+                        resolve({
+                            success: false,
+                            error: error.message,
+                        });
+                    }
+                    else {
+                        resolve({
+                            success: false,
+                            error: String(error),
+                        });
+                    }
+                }
+            };
+            const handleSuccess = (data) => {
+                cleanup();
+                if (!settled) {
+                    settled = true;
+                    if (timedOut) {
+                        resolve({
+                            success: false,
+                            error: 'Function execution timeout',
+                            code: ErrorCode.EXECUTION_FAILED,
+                        });
+                    }
+                    else {
+                        resolve(data);
+                    }
+                }
+            };
+            try {
+                // Check if code is a file path (starts with ./ or contains .ts or .js)
+                if (code.includes('.ts') || code.includes('.js') || code.startsWith('./')) {
+                    // Load from external file using dynamic import()
+                    // This works with TypeScript via ESM import
+                    // Resolve relative to the tool definition file location
+                    let absolutePath;
+                    if (tool._definitionPath) {
+                        // Use the definition file directory as the base for relative paths
+                        const definitionDir = path.dirname(tool._definitionPath);
+                        absolutePath = path.resolve(definitionDir, code);
+                    }
+                    else {
+                        // Fallback: use the old logic (for backward compatibility)
+                        // Compute tool directory: tools/{provider}/{tool-name}/
+                        const toolName = tool.name;
+                        let toolDir;
+                        if (toolName.includes('-')) {
+                            const parts = toolName.split('-');
+                            const provider = parts[0];
+                            toolDir = path.join(this.toolsPath, provider, toolName);
+                        }
+                        else {
+                            toolDir = path.join(this.toolsPath, toolName);
+                        }
+                        absolutePath = path.resolve(toolDir, code);
+                    }
+                    const fileUrl = pathToFileURL(absolutePath).href;
+                    // Use dynamic import() for ESM/TypeScript compatibility with robust URL handling
+                    import(fileUrl)
+                        .then((module) => {
+                        const fn = (module.default || module);
+                        const result = fn(params);
+                        // Handle both Promise and non-Promise returns
+                        if (result instanceof Promise) {
+                            result.then(handleSuccess).catch(handleError);
+                        }
+                        else {
+                            handleSuccess(result);
+                        }
+                    })
+                        .catch(handleError);
+                }
+                else {
+                    // Execute embedded code (legacy) - create function from string
+                    // SECURITY WARNING: Embedded code execution runs arbitrary JS with fs/path/axios access.
+                    // This is a potential RCE vector if tool YAML files come from untrusted sources.
+                    // Embedded code is DISABLED by default. Must explicitly opt-in via MATIMO_ALLOW_EMBEDDED_CODE=true
+                    const embeddedCodeDisabled = process.env.MATIMO_ALLOW_EMBEDDED_CODE !== 'true';
+                    if (embeddedCodeDisabled) {
+                        throw new MatimoError('Embedded code execution is disabled by default for security. Use external .ts/.js files instead.', ErrorCode.EXECUTION_FAILED, {
+                            toolName: tool.name,
+                            recommendation: 'Create a separate .ts file in the tool directory instead of using embedded code',
+                            enableFeatureFlag: 'Set MATIMO_ALLOW_EMBEDDED_CODE=true to enable (not recommended)',
+                        });
+                    }
+                    // Log warning when embedded code is executed
+                    const logger = getGlobalMatimoLogger();
+                    logger.warn(`⚠️  Warning: Executing embedded code from tool '${tool.name}'. This carries security risks if tool YAML is from untrusted sources.`, { toolName: tool.name });
+                    // In ESM modules, require is not available by default
+                    // We pass a safe require function that embedded code can use
+                    const functionBody = `return (${code})`;
+                    const fn = new Function(functionBody)();
+                    // Pass undefined for require in ESM - embedded code should use import syntax
+                    const result = fn(params, {}, fs, path, axios, undefined);
+                    // Handle both Promise and non-Promise returns
+                    if (result instanceof Promise) {
+                        result.then(handleSuccess).catch(handleError);
+                    }
+                    else {
+                        handleSuccess(result);
+                    }
+                }
+            }
+            catch (error) {
+                handleError(error);
+            }
+        });
+    }
+}
+export default FunctionExecutor;
+//# sourceMappingURL=function-executor.js.map

package/dist/executors/function-executor.js.map

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

package/dist/executors/http-executor.d.ts

@@ -0,0 +1,78 @@
+import { ToolDefinition } from '../core/schema';
+/**
+ * HttpExecutor - Executes HTTP requests
+ * Handles authentication, retries, and response validation
+ */
+export declare class HttpExecutor {
+    /**
+     * Execute a tool that makes an HTTP request
+     */
+    execute(tool: ToolDefinition, params: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Replace parameter placeholders in a string
+     */
+    private templateString;
+    /**
+     * Check if a string is an unfilled placeholder
+     * Only matches single placeholders like "{param}", not "{...}" or embedded placeholders
+     */
+    private isUnfilledPlaceholder;
+    /**
+     * Validate that all URL parameters are provided
+     */
+    private validateUrlParameters;
+    /**
+     * Build query string from query_params, only including provided values
+     */
+    private buildQueryString;
+    /**
+     * Replace parameter placeholders in an object (headers, body, query params)
+     *
+     * CORE PRINCIPLE: "Define once in YAML, embed correctly at execution time"
+     *
+     * This method intelligently handles different parameter types:
+     * - STRING placeholders like "{title}": Always templated as strings
+     * - OBJECT placeholders like "{parent}": Embedded directly as JSON objects (not stringified) if paramDefinitions specifies type:object
+     * - ARRAY placeholders like "{items}": Embedded directly as JSON arrays (not stringified) if paramDefinitions specifies type:array
+     *
+     * Key behaviors:
+     * - Recursively processes nested objects
+     * - Skips keys with unfilled placeholders (e.g., "{sort_by}" when sort_by not provided)
+     * - Uses parameter schema type from YAML to determine how to embed values
+     * - Preserves JSON structure for complex types (objects/arrays) sent to APIs
+     *
+     * @example
+     * ```
+     * // YAML definition:
+     * parameters:
+     *   parent:
+     *     type: object  // <-- Tells executor to embed as-is, not stringify
+     *   items:
+     *     type: array   // <-- Tells executor to embed as-is, not stringify
+     *   title:
+     *     type: string  // <-- String templating applies
+     *
+     * body:
+     *   parent: "{parent}"  // Object embedded as {"id": "123", ...}
+     *   items: "{items}"    // Array embedded as [{"name": "a"}, ...]
+     *   title: "{title}"    // String embedded as "My Title"
+     *
+     * // JavaScript call:
+     * const result = await matimo.execute('notion_create_page', {
+     *   parent: { database_id: 'abc123' },  // JavaScript object
+     *   items: [{ type: 'text' }],          // JavaScript array
+     *   title: 'Create This Page'           // String
+     * });
+     *
+     * // HTTP body sent to API:
+     * {
+     *   "parent": {"database_id": "abc123"},     // Proper JSON object
+     *   "items": [{"type": "text"}],            // Proper JSON array
+     *   "title": "Create This Page"             // String
+     * }
+     * ```
+     */
+    private templateObject;
+}
+export default HttpExecutor;
+//# sourceMappingURL=http-executor.d.ts.map

package/dist/executors/http-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-executor.d.ts","sourceRoot":"","sources":["../../src/executors/http-executor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhD;;;GAGG;AAEH,qBAAa,YAAY;IACvB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAsFtF;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,OAAO,CAAC,cAAc;CA+GvB;AAED,eAAe,YAAY,CAAC"}