matimo 0.1.0-alpha.2 → 0.1.0-alpha.4

package/packages/core/dist/src/executors/function-executor.js

@@ -0,0 +1,164 @@
+import fs from 'fs';
+import path from 'path';
+import { pathToFileURL } from 'node:url';
+import axios from 'axios';
+import { MatimoError, ErrorCode } from '../errors/matimo-error';
+/**
+ * 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;
+        const startTime = Date.now();
+        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 properly rejects
+            const timer = setTimeout(() => {
+                timedOut = true;
+                if (!settled) {
+                    settled = true;
+                    resolve({
+                        success: false,
+                        error: 'Function execution timeout',
+                        duration: Date.now() - startTime,
+                    });
+                }
+            }, timeout);
+            const cleanup = () => {
+                clearTimeout(timer);
+            };
+            const handleError = (error) => {
+                cleanup();
+                if (!settled) {
+                    settled = true;
+                    resolve({
+                        success: false,
+                        error: error instanceof Error ? error.message : String(error),
+                        duration: Date.now() - startTime,
+                    });
+                }
+            };
+            const handleSuccess = (data) => {
+                cleanup();
+                if (!settled) {
+                    settled = true;
+                    if (timedOut) {
+                        resolve({
+                            success: false,
+                            error: 'Function execution timeout',
+                            duration: Date.now() - startTime,
+                        });
+                    }
+                    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
+                    console.info(`⚠️  Warning: Executing embedded code from tool '${tool.name}'. This carries security risks if tool YAML is from untrusted sources.`);
+                    // 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/packages/core/dist/src/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/packages/core/dist/src/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;IAoFtF;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;OAGG;IACH,OAAO,CAAC,cAAc;CA2BvB;AAED,eAAe,YAAY,CAAC"}

package/{dist → packages/core/dist/src}/executors/http-executor.js

@@ -1,5 +1,6 @@
 import axios from 'axios';
 import { applyParameterEncodings } from '../encodings/parameter-encoding';
+import { MatimoError, ErrorCode } from '../errors/matimo-error';
 /**
  * HttpExecutor - Executes HTTP requests
  * Handles authentication, retries, and response validation
@@ -10,7 +11,10 @@ export class HttpExecutor {
      */
     async execute(tool, params) {
         if (tool.execution.type !== 'http') {
-            throw new Error('Tool execution type is not http');
+            throw new MatimoError('Tool execution type is not http', ErrorCode.EXECUTION_FAILED, {
+                expectedType: 'http',
+                actualType: tool.execution.type,
+            });
         }
         const { method, url, headers = {}, body, timeout, query_params, parameter_encoding, } = tool.execution;
         const queryParams = query_params;

package/packages/core/dist/src/executors/http-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-executor.js","sourceRoot":"","sources":["../../../src/executors/http-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;GAGG;AAEH,MAAM,OAAO,YAAY;IACvB;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,IAAoB,EAAE,MAA+B;QACjE,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACnC,MAAM,IAAI,WAAW,CAAC,iCAAiC,EAAE,SAAS,CAAC,gBAAgB,EAAE;gBACnF,YAAY,EAAE,MAAM;gBACpB,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI;aAChC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,EACJ,MAAM,EACN,GAAG,EACH,OAAO,GAAG,EAAE,EACZ,IAAI,EACJ,OAAO,EACP,YAAY,EACZ,kBAAkB,GACnB,GAAG,IAAI,CAAC,SAAS,CAAC;QACnB,MAAM,WAAW,GAAG,YAAY,CAAC;QACjC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;QAE9C,uEAAuE;QACvE,IAAI,WAAW,GAAG,MAAM,CAAC;QACzB,IAAI,kBAAkB,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,WAAW,GAAG,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;QACpE,CAAC;QAED,iCAAiC;QACjC,IAAI,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAErD,wDAAwD;QACxD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YACpE,IAAI,WAAW,EAAE,CAAC;gBAChB,QAAQ,IAAI,GAAG,GAAG,WAAW,CAAC;YAChC,CAAC;QACH,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACnE,MAAM,aAAa,GACjB,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAC9B,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,IAA+B,EAAE,WAAW,CAAC;YACnE,CAAC,CAAC,IAAI,CAAC;QAEX,uBAAuB;QACvB,MAAM,aAAa,GAAuB;YACxC,MAAM;YACN,GAAG,EAAE,QAAQ;SACd,CAAC;QAEF,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,aAAa,CAAC,OAAO,GAAG,gBAA0C,CAAC;QACrE,CAAC;QAED,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,aAAa,CAAC,IAAI,GAAG,aAAa,CAAC;QACrC,CAAC;QAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,aAAa,CAAC,OAAO,GAAG,OAAO,CAAC;QAClC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAEpD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;YAChE,OAAO;gBACL,OAAO;gBACP,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,UAAU,EAAE,QAAQ,CAAC,MAAM;gBAC3B,OAAO,EAAE,QAAQ,CAAC,OAAO;aAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,KAAmB,CAAC;YACvC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC;YAClD,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC;YAChD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,UAAU,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC;gBAC1C,UAAU,EAAE,MAAM;gBAClB,OAAO;aACR,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,GAAW,EAAE,MAA+B;QACjE,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,MAAM,WAAW,GAAG,IAAI,GAAG,GAAG,CAAC;YAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBAC1D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,WAAmC,EACnC,MAA+B;QAE/B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACpD,kFAAkF;YAClF,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACK,cAAc,CACpB,GAA4B,EAC5B,MAA+B;QAE/B,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChF,sCAAsC;gBACtC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,KAAgC,EAAE,MAAM,CAAC,CAAC;YAC9E,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChC,2BAA2B;gBAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;oBAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;wBAC7B,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBAC3C,CAAC;yBAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC7E,OAAO,IAAI,CAAC,cAAc,CAAC,IAA+B,EAAE,MAAM,CAAC,CAAC;oBACtE,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,eAAe,YAAY,CAAC"}

package/{dist → packages/core/dist/src}/index.d.ts

@@ -4,19 +4,23 @@
  * Framework-agnostic SDK that enables any developer to integrate 1000+ tools
  * across any AI framework (LangChain, CrewAI, Anthropic SDK, etc.).
  */
-export type { Parameter, AuthConfig, HttpExecution, CommandExecution, OutputSchema, RateLimitConfig, ErrorHandlingConfig, } from './core/types';
+export type { Parameter, AuthConfig, HttpExecution, CommandExecution, FunctionExecution, OutputSchema, RateLimitConfig, ErrorHandlingConfig, ToolDefinition, } from './core/types';
 export { ParameterSchema, AuthConfigSchema, ExecutionConfigSchema } from './core/schema';
 export { ToolLoader } from './core/tool-loader';
 export { ToolRegistry } from './core/tool-registry';
 export { CommandExecutor } from './executors/command-executor';
 export { HttpExecutor } from './executors/http-executor';
+export { FunctionExecutor } from './executors/function-executor';
 export { applyParameterEncodings } from './encodings/parameter-encoding';
 export type { ParameterEncodingConfig } from './encodings/parameter-encoding';
 export { tool, setGlobalMatimoInstance, getGlobalMatimoInstance, } from './decorators/tool-decorator';
 export { MatimoError, ErrorCode, createValidationError, createExecutionError, } from './errors/matimo-error';
 export { MatimoInstance, matimo } from './matimo-instance';
+export type { InitOptions } from './matimo-instance';
 export type { OAuth2Provider, OAuth2Token, OAuth2Config, AuthorizationOptions, TokenResponse, OAuth2Endpoints, } from './auth/oauth2-config';
 export type { ProviderDefinition } from './core/schema';
 export { OAuth2ProviderLoader } from './auth/oauth2-provider-loader';
 export { OAuth2Handler } from './auth/oauth2-handler';
+export { convertToolsToLangChain } from './integrations/langchain';
+export type { LangChainTool } from './integrations/langchain';
 //# sourceMappingURL=index.d.ts.map

package/packages/core/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,YAAY,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAG9E,OAAO,EACL,IAAI,EACJ,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,WAAW,EACX,SAAS,EACT,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,YAAY,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC"}

package/{dist → packages/core/dist/src}/index.js

@@ -10,6 +10,7 @@ export { ToolRegistry } from './core/tool-registry';
 // Executors
 export { CommandExecutor } from './executors/command-executor';
 export { HttpExecutor } from './executors/http-executor';
+export { FunctionExecutor } from './executors/function-executor';
 // Parameter Encoding
 export { applyParameterEncodings } from './encodings/parameter-encoding';
 // Decorators
@@ -20,4 +21,6 @@ export { MatimoError, ErrorCode, createValidationError, createExecutionError, }
 export { MatimoInstance, matimo } from './matimo-instance';
 export { OAuth2ProviderLoader } from './auth/oauth2-provider-loader';
 export { OAuth2Handler } from './auth/oauth2-handler';
+// LangChain integration
+export { convertToolsToLangChain } from './integrations/langchain';
 //# sourceMappingURL=index.js.map

package/packages/core/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,qBAAqB;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,aAAa;AACb,OAAO,EACL,IAAI,EACJ,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAErC,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,SAAS,EACT,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,gCAAgC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAa3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,wBAAwB;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}

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