matimo 0.1.0-alpha.3 → 0.1.0-alpha.5

package/packages/core/dist/src/integrations/langchain.d.ts

@@ -0,0 +1,46 @@
+/**
+ * LangChain Integration for Matimo
+ *
+ * Converts Matimo tools to LangChain-compatible format.
+ * Simple, lightweight, scales to 2000+ tools.
+ *
+ * NOTE: Requires @langchain/core as peer dependency.
+ * Install with: npm install @langchain/core langchain
+ *
+ * Usage:
+ *   const matimo = await MatimoInstance.init('./tools');
+ *   const langchainTools = await convertToolsToLangChain(
+ *     matimo.listTools(),
+ *     matimo,
+ *     { SLACK_BOT_TOKEN: process.env.SLACK_BOT_TOKEN }
+ *   );
+ */
+import { z } from 'zod';
+import type { ToolDefinition } from '../core/types';
+import type { MatimoInstance } from '../matimo-instance';
+export interface LangChainTool {
+    name: string;
+    description: string;
+    schema: z.ZodSchema;
+    invoke: (input: Record<string, unknown>) => Promise<unknown>;
+}
+/**
+ * Convert Matimo tools to LangChain format
+ *
+ * @param tools - Matimo tools
+ * @param matimo - MatimoInstance
+ * @param secrets - Map of parameter names to secret values
+ * @param secretParamNames - Explicitly declared secret parameters (optional)
+ * @returns LangChain tools
+ *
+ * @example
+ * ```ts
+ * const tools = await convertToolsToLangChain(
+ *   matimo.listTools().filter(t => t.name.startsWith('slack')),
+ *   matimo,
+ *   { SLACK_BOT_TOKEN: process.env.SLACK_BOT_TOKEN }
+ * );
+ * ```
+ */
+export declare function convertToolsToLangChain(tools: ToolDefinition[], matimo: MatimoInstance, secrets?: Record<string, string>, secretParamNames?: Set<string>): Promise<LangChainTool[]>;
+//# sourceMappingURL=langchain.d.ts.map

package/packages/core/dist/src/integrations/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D;AAgMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,cAAc,EAAE,EACvB,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC7B,OAAO,CAAC,aAAa,EAAE,CAAC,CAiB1B"}

package/packages/core/dist/src/integrations/langchain.js

@@ -0,0 +1,197 @@
+/**
+ * LangChain Integration for Matimo
+ *
+ * Converts Matimo tools to LangChain-compatible format.
+ * Simple, lightweight, scales to 2000+ tools.
+ *
+ * NOTE: Requires @langchain/core as peer dependency.
+ * Install with: npm install @langchain/core langchain
+ *
+ * Usage:
+ *   const matimo = await MatimoInstance.init('./tools');
+ *   const langchainTools = await convertToolsToLangChain(
+ *     matimo.listTools(),
+ *     matimo,
+ *     { SLACK_BOT_TOKEN: process.env.SLACK_BOT_TOKEN }
+ *   );
+ */
+import { z } from 'zod';
+// Lazy load LangChain to avoid hard dependency
+let langChainToolFn = null;
+async function getLangChainTool() {
+    if (!langChainToolFn) {
+        try {
+            const langChainModule = await import('@langchain/core/tools');
+            langChainToolFn = langChainModule.tool;
+        }
+        catch {
+            throw new Error('LangChain not installed. Install: npm install @langchain/core langchain');
+        }
+    }
+    return langChainToolFn;
+}
+/**
+ * Convert parameter to Zod schema
+ *
+ * Supports:
+ * - enum constraints (if present, validates against allowed values)
+ * - default values (sets default in schema)
+ * - type validation (string, number, boolean, array, object)
+ * - description and required metadata
+ */
+function parameterToZod(param) {
+    let schema;
+    // If enum is present, validate against allowed values
+    if (param.enum && param.enum.length > 0) {
+        // Create enum schema from allowed values using z.union for mixed types
+        const enumSchemas = param.enum.map((value) => z.literal(value));
+        // Build union from array of literal schemas (type-safe via unknown cast)
+        schema = z.union(enumSchemas);
+    }
+    else {
+        switch (param.type) {
+            case 'string':
+                schema = z.string();
+                break;
+            case 'number':
+                schema = z.number();
+                break;
+            case 'boolean':
+                schema = z.boolean();
+                break;
+            case 'array': {
+                const itemSchema = param.items ? parameterToZod(param.items) : z.unknown();
+                schema = z.array(itemSchema);
+                break;
+            }
+            case 'object': {
+                if (param.properties) {
+                    const props = {};
+                    for (const [key, prop] of Object.entries(param.properties)) {
+                        props[key] = parameterToZod(prop);
+                    }
+                    schema = z.object(props);
+                }
+                else {
+                    schema = z.record(z.string(), z.unknown());
+                }
+                break;
+            }
+            default:
+                schema = z.unknown();
+        }
+    }
+    if (param.description) {
+        schema = schema.describe(param.description);
+    }
+    // Apply default value if present
+    if (param.default !== undefined) {
+        schema = schema.default(param.default);
+    }
+    if (!param.required) {
+        schema = schema.optional();
+    }
+    return schema;
+}
+/**
+ * Auto-detect if a parameter name looks like a secret
+ * based on common patterns (TOKEN, KEY, SECRET, PASSWORD)
+ *
+ * Uses word-boundary matching and camelCase detection to avoid false positives:
+ * - ✅ Matches: "api_token", "API_KEY", "getToken", "secret", "password_hash"
+ * - ❌ Rejects: "monkey", "turkey_id", "donkey" (substrings only)
+ */
+function isSecretParameter(paramName) {
+    const upperName = paramName.toUpperCase();
+    // Pattern 1: Word boundaries (works for snake_case: api_token, API_KEY)
+    if (/\b(TOKEN|KEY|SECRET|PASSWORD)\b/.test(upperName)) {
+        return true;
+    }
+    // Pattern 2: Underscore prefix/suffix (works for snake_case: _token_, prefix_token_)
+    if (/(^|_)(TOKEN|KEY|SECRET|PASSWORD)(_|$)/.test(upperName)) {
+        return true;
+    }
+    // Pattern 3: CamelCase detection (works for camelCase: getToken, apiKey)
+    // Check if secret word appears after a lowercase letter (camelCase boundary)
+    if (/[a-z](TOKEN|KEY|SECRET|PASSWORD)/.test(paramName)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Build Zod schema for tool input, excluding secret parameters
+ */
+function buildInputSchema(tool, secretParams) {
+    if (!tool.parameters) {
+        return z.object({});
+    }
+    const shape = {};
+    for (const [name, param] of Object.entries(tool.parameters)) {
+        if (secretParams.has(name)) {
+            continue; // Skip secrets - they're injected
+        }
+        shape[name] = parameterToZod(param);
+    }
+    return z.object(shape);
+}
+/**
+ * Convert Matimo tool to LangChain format
+ */
+async function convertTool(matimo, tool, secretParams, secrets) {
+    const toolFn = await getLangChainTool();
+    const schema = buildInputSchema(tool, secretParams);
+    return toolFn(async (input) => {
+        const params = { ...input };
+        // Inject secrets
+        for (const param of secretParams) {
+            if (param in secrets) {
+                params[param] = secrets[param];
+            }
+        }
+        try {
+            return await matimo.execute(tool.name, params);
+        }
+        catch (error) {
+            return `Error: ${error instanceof Error ? error.message : String(error)}`;
+        }
+    }, {
+        name: tool.name,
+        description: tool.description || tool.name,
+        schema,
+    });
+}
+/**
+ * Convert Matimo tools to LangChain format
+ *
+ * @param tools - Matimo tools
+ * @param matimo - MatimoInstance
+ * @param secrets - Map of parameter names to secret values
+ * @param secretParamNames - Explicitly declared secret parameters (optional)
+ * @returns LangChain tools
+ *
+ * @example
+ * ```ts
+ * const tools = await convertToolsToLangChain(
+ *   matimo.listTools().filter(t => t.name.startsWith('slack')),
+ *   matimo,
+ *   { SLACK_BOT_TOKEN: process.env.SLACK_BOT_TOKEN }
+ * );
+ * ```
+ */
+export async function convertToolsToLangChain(tools, matimo, secrets = {}, secretParamNames) {
+    // Start with explicitly declared secret param names or auto-detect from secrets keys
+    const detectedSecrets = secretParamNames || new Set(Object.keys(secrets));
+    // Auto-detect additional secret parameters by scanning all tool parameters
+    for (const tool of tools) {
+        if (tool.parameters) {
+            for (const paramName of Object.keys(tool.parameters)) {
+                // Auto-detect if parameter looks like a secret
+                if (isSecretParameter(paramName)) {
+                    detectedSecrets.add(paramName);
+                }
+            }
+        }
+    }
+    return Promise.all(tools.map((tool) => convertTool(matimo, tool, detectedSecrets, secrets)));
+}
+//# sourceMappingURL=langchain.js.map

package/packages/core/dist/src/integrations/langchain.js.map

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

package/{dist → packages/core/dist/src}/matimo-instance.d.ts

@@ -1,21 +1,47 @@
 import { ToolDefinition } from './core/schema';
+/**
+ * Options for MatimoInstance initialization
+ */
+export interface InitOptions {
+    toolPaths?: string[];
+    autoDiscover?: boolean;
+    includeCore?: boolean;
+}
 /**
  * Matimo Instance - Single initialization point for tool execution
  * Combines loader, registry, and executors into one interface
  */
 export declare class MatimoInstance {
-    private toolsPath;
+    private toolPaths;
     private loader;
     private registry;
     private commandExecutor;
     private httpExecutor;
+    private functionExecutor;
     private constructor();
     /**
-     * Initialize Matimo with tools from a directory
-     * @param toolsPath - Path to tools directory
+     * Initialize Matimo with tools from directory or auto-discovery
+     * @param options - Initialization options (string for backward compatibility)
      * @returns MatimoInstance ready to execute tools
+     *
+     * @example
+     * // Backward compatible - single path
+     * const matimo = await MatimoInstance.init('./tools');
+     *
+     * // New - auto-discovery
+     * const matimo = await MatimoInstance.init({ autoDiscover: true });
+     *
+     * // Explicit paths
+     * const matimo = await MatimoInstance.init({
+     *   toolPaths: ['./tools', require.resolve('@matimo/slack/tools')]
+     * });
+     */
+    static init(options?: InitOptions | string): Promise<MatimoInstance>;
+    /**
+     * Get tool paths
+     * @returns Array of tool paths
      */
-    static init(toolsPath: string): Promise<MatimoInstance>;
+    getToolPaths(): string[];
     /**
      * Execute a tool by name with parameters
      * @param toolName - Name of the tool to execute

package/packages/core/dist/src/matimo-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matimo-instance.d.ts","sourceRoot":"","sources":["../../src/matimo-instance.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAE3C,OAAO;IAWP;;;;;;;;;;;;;;;;OAgBG;WACU,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA4C1E;;;OAGG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBlF;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIrD;;;OAGG;IACH,SAAS,IAAI,cAAc,EAAE;IAI7B;;;OAGG;IACH,WAAW,IAAI,cAAc,EAAE;IAI/B;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IAI5C;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE;IAI5C;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,oBAAoB;IAoD5B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAkDpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;OAEG;IACH,OAAO,CAAC,WAAW;CAiBpB;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB;;;;OAIG;oBACmB,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAGvD,CAAC"}

package/{dist → packages/core/dist/src}/matimo-instance.js

@@ -3,32 +3,83 @@ import { ToolLoader } from './core/tool-loader';
 import { ToolRegistry } from './core/tool-registry';
 import { CommandExecutor } from './executors/command-executor';
 import { HttpExecutor } from './executors/http-executor';
+import { FunctionExecutor } from './executors/function-executor';
 import { MatimoError, ErrorCode } from './errors/matimo-error';
 /**
  * Matimo Instance - Single initialization point for tool execution
  * Combines loader, registry, and executors into one interface
  */
 export class MatimoInstance {
-    constructor(toolsPath) {
-        this.toolsPath = toolsPath;
+    constructor(toolPaths) {
+        this.toolPaths = toolPaths;
         this.loader = new ToolLoader();
         this.registry = new ToolRegistry();
-        // Use dirname to get parent directory reliably - works regardless of directory name
-        const workingDir = path.dirname(toolsPath);
+        // Use the first path (primary) as working directory for command executor
+        const workingDir = toolPaths.length > 0 ? path.dirname(toolPaths[0]) : process.cwd();
         this.commandExecutor = new CommandExecutor(workingDir);
         this.httpExecutor = new HttpExecutor();
+        this.functionExecutor = new FunctionExecutor(toolPaths[0] || '');
     }
     /**
-     * Initialize Matimo with tools from a directory
-     * @param toolsPath - Path to tools directory
+     * Initialize Matimo with tools from directory or auto-discovery
+     * @param options - Initialization options (string for backward compatibility)
      * @returns MatimoInstance ready to execute tools
+     *
+     * @example
+     * // Backward compatible - single path
+     * const matimo = await MatimoInstance.init('./tools');
+     *
+     * // New - auto-discovery
+     * const matimo = await MatimoInstance.init({ autoDiscover: true });
+     *
+     * // Explicit paths
+     * const matimo = await MatimoInstance.init({
+     *   toolPaths: ['./tools', require.resolve('@matimo/slack/tools')]
+     * });
      */
-    static async init(toolsPath) {
-        const instance = new MatimoInstance(toolsPath);
-        const tools = await instance.loader.loadToolsFromDirectory(toolsPath);
-        instance.registry.registerAll(Array.from(tools.values()));
+    static async init(options) {
+        let finalOptions;
+        // Backward compatibility: if string is passed, treat as toolPath
+        if (typeof options === 'string') {
+            finalOptions = {
+                toolPaths: [options],
+                autoDiscover: false,
+                includeCore: false,
+            };
+        }
+        else {
+            finalOptions = {
+                autoDiscover: false,
+                includeCore: true,
+                ...options,
+            };
+        }
+        const toolPaths = [];
+        // Include core tools (calculator, etc.) - currently not used in monorepo
+        // Use explicit toolPaths or autoDiscover instead
+        // if (finalOptions.includeCore) { ... }
+        // Add explicit paths
+        if (finalOptions.toolPaths) {
+            toolPaths.push(...finalOptions.toolPaths);
+        }
+        // Auto-discover @matimo/* packages
+        if (finalOptions.autoDiscover) {
+            const discoveredPaths = new ToolLoader().autoDiscoverPackages();
+            toolPaths.push(...discoveredPaths);
+        }
+        const instance = new MatimoInstance(toolPaths);
+        // Load tools from all paths
+        const allTools = instance.loader.loadToolsFromMultiplePaths(toolPaths);
+        instance.registry.registerAll(Array.from(allTools.values()));
         return instance;
     }
+    /**
+     * Get tool paths
+     * @returns Array of tool paths
+     */
+    getToolPaths() {
+        return [...this.toolPaths];
+    }
     /**
      * Execute a tool by name with parameters
      * @param toolName - Name of the tool to execute
@@ -239,6 +290,8 @@ export class MatimoInstance {
                 return this.commandExecutor;
             case 'http':
                 return this.httpExecutor;
+            case 'function':
+                return this.functionExecutor;
             default:
                 throw new MatimoError(`Unsupported execution type: ${executionType}`, ErrorCode.EXECUTION_FAILED, { executionType });
         }

package/packages/core/dist/src/matimo-instance.js.map

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

package/packages/core/dist/tools/calculator/calculator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Calculator utility functions
+ */
+declare const Calculator: {
+    /**
+     * Normalize operation name to handle variations
+     */
+    normalizeOperation(op: string): string;
+    /**
+     * Perform arithmetic calculation
+     */
+    calculate(operation: string, a: number, b: number): {
+        result: number;
+        operation: string;
+        original_operation: string;
+        operands: {
+            a: number;
+            b: number;
+        };
+    };
+};
+/**
+ * CLI entry point
+ */
+declare function main(): void;
+//# sourceMappingURL=calculator.d.ts.map

package/packages/core/dist/tools/calculator/calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../../tools/calculator/calculator.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,QAAA,MAAM,UAAU;IACd;;OAEG;2BACoB,MAAM,GAAG,MAAM;IAsCtC;;OAEG;yBAEU,MAAM,KACd,MAAM,KACN,MAAM,GACR;QACD,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACpC;CA+BF,CAAC;AAEF;;GAEG;AACH,iBAAS,IAAI,IAAI,IAAI,CAyBpB"}

package/packages/core/dist/tools/calculator/calculator.js

@@ -0,0 +1,104 @@
+"use strict";
+// Calculator implementation
+// This script is executed by the calculator tool
+/**
+ * Calculator utility functions
+ */
+const Calculator = {
+    /**
+     * Normalize operation name to handle variations
+     */
+    normalizeOperation(op) {
+        const normalized = op.toLowerCase().trim();
+        // Map variations to canonical operation names
+        const operationMap = {
+            // Addition variants
+            add: 'add',
+            addition: 'add',
+            sum: 'add',
+            plus: 'add',
+            '+': 'add',
+            // Subtraction variants
+            subtract: 'subtract',
+            subtraction: 'subtract',
+            minus: 'subtract',
+            sub: 'subtract',
+            '-': 'subtract',
+            // Multiplication variants
+            multiply: 'multiply',
+            multiplication: 'multiply',
+            times: 'multiply',
+            product: 'multiply',
+            mul: 'multiply',
+            '*': 'multiply',
+            x: 'multiply',
+            // Division variants
+            divide: 'divide',
+            division: 'divide',
+            div: 'divide',
+            '/': 'divide',
+        };
+        return operationMap[normalized] || normalized;
+    },
+    /**
+     * Perform arithmetic calculation
+     */
+    calculate(operation, a, b) {
+        const normalizedOp = this.normalizeOperation(operation);
+        let result;
+        switch (normalizedOp) {
+            case 'add':
+                result = a + b;
+                break;
+            case 'subtract':
+                result = a - b;
+                break;
+            case 'multiply':
+                result = a * b;
+                break;
+            case 'divide':
+                if (b === 0) {
+                    throw new Error('Division by zero');
+                }
+                result = a / b;
+                break;
+            default:
+                throw new Error(`Unknown operation: ${operation}`);
+        }
+        return {
+            result,
+            operation: normalizedOp,
+            original_operation: operation,
+            operands: { a, b },
+        };
+    },
+};
+/**
+ * CLI entry point
+ */
+function main() {
+    try {
+        const [operation, aStr, bStr] = process.argv.slice(2);
+        if (!operation || !aStr || !bStr) {
+            console.error('Usage: calculator.ts <operation> <a> <b>');
+            console.error('Operations: add, subtract, multiply, divide');
+            process.exit(1);
+        }
+        const a = parseFloat(aStr);
+        const b = parseFloat(bStr);
+        if (isNaN(a) || isNaN(b)) {
+            console.error('Error: Arguments must be valid numbers');
+            process.exit(1);
+        }
+        const result = Calculator.calculate(operation, a, b);
+        console.log(JSON.stringify(result));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(message);
+        process.exit(1);
+    }
+}
+// Execute CLI entry point
+main();
+//# sourceMappingURL=calculator.js.map

package/packages/core/dist/tools/calculator/calculator.js.map

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