matimo 0.1.0-alpha.1

package/dist/executors/http-executor.js

@@ -0,0 +1,133 @@
+import axios from 'axios';
+import { applyParameterEncodings } from '../encodings/parameter-encoding';
+/**
+ * HttpExecutor - Executes HTTP requests
+ * Handles authentication, retries, and response validation
+ */
+export class HttpExecutor {
+    /**
+     * Execute a tool that makes an HTTP request
+     */
+    async execute(tool, params) {
+        if (tool.execution.type !== 'http') {
+            throw new Error('Tool execution type is not http');
+        }
+        const { method, url, headers = {}, body, timeout, query_params, parameter_encoding, } = tool.execution;
+        const queryParams = query_params;
+        const parameterEncodings = parameter_encoding;
+        // Apply parameter encodings (e.g., MIME encoding for email parameters)
+        let finalParams = params;
+        if (parameterEncodings && parameterEncodings.length > 0) {
+            finalParams = applyParameterEncodings(params, parameterEncodings);
+        }
+        // Implement parameter templating
+        let finalUrl = this.templateString(url, finalParams);
+        // Handle query parameters - only include non-empty ones
+        if (queryParams) {
+            const queryString = this.buildQueryString(queryParams, finalParams);
+            if (queryString) {
+                finalUrl += '?' + queryString;
+            }
+        }
+        const templatedHeaders = this.templateObject(headers, finalParams);
+        const templatedBody = body && typeof body === 'object'
+            ? this.templateObject(body, finalParams)
+            : body;
+        // Build request config
+        const requestConfig = {
+            method,
+            url: finalUrl,
+        };
+        if (Object.keys(templatedHeaders).length > 0) {
+            requestConfig.headers = templatedHeaders;
+        }
+        if (templatedBody !== undefined) {
+            requestConfig.data = templatedBody;
+        }
+        if (timeout !== undefined) {
+            requestConfig.timeout = timeout;
+        }
+        try {
+            const response = await axios.request(requestConfig);
+            const success = response.status >= 200 && response.status < 300;
+            return {
+                success,
+                data: response.data,
+                statusCode: response.status,
+                headers: response.headers,
+            };
+        }
+        catch (error) {
+            const axiosError = error;
+            const status = axiosError.response?.status || 500;
+            const details = axiosError.response?.data || {};
+            return {
+                success: false,
+                error: axiosError.message || String(error),
+                statusCode: status,
+                details,
+            };
+        }
+    }
+    /**
+     * Replace parameter placeholders in a string
+     */
+    templateString(str, params) {
+        let result = str;
+        for (const [key, value] of Object.entries(params)) {
+            const placeholder = `{${key}}`;
+            if (value !== undefined && value !== null && value !== '') {
+                result = result.replace(new RegExp(placeholder, 'g'), String(value));
+            }
+        }
+        return result;
+    }
+    /**
+     * Build query string from query_params, only including provided values
+     */
+    buildQueryString(queryParams, params) {
+        const parts = [];
+        for (const [key, template] of Object.entries(queryParams)) {
+            const value = this.templateString(template, params);
+            // Only include if not empty and didn't result in "{param}" (unfilled placeholder)
+            if (value && !value.startsWith('{')) {
+                parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
+            }
+        }
+        return parts.join('&');
+    }
+    /**
+     * Replace parameter placeholders in an object (headers, body)
+     * Recursively handles nested objects
+     */
+    templateObject(obj, params) {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (typeof value === 'string') {
+                result[key] = this.templateString(value, params);
+            }
+            else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                // Recursively template nested objects
+                result[key] = this.templateObject(value, params);
+            }
+            else if (Array.isArray(value)) {
+                // Handle arrays of objects
+                result[key] = value.map((item) => {
+                    if (typeof item === 'string') {
+                        return this.templateString(item, params);
+                    }
+                    else if (typeof item === 'object' && item !== null && !Array.isArray(item)) {
+                        return this.templateObject(item, params);
+                    }
+                    return item;
+                });
+            }
+            else {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+}
+export default HttpExecutor;
+//# sourceMappingURL=http-executor.js.map

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

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Matimo - Universal AI Agent Tools Ecosystem
+ *
+ * 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 { 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 { 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 { 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';
+//# sourceMappingURL=index.d.ts.map

package/dist/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,YAAY,EACZ,eAAe,EACf,mBAAmB,GACpB,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;AAGzD,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;AAG3D,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"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * Matimo - Universal AI Agent Tools Ecosystem
+ *
+ * Framework-agnostic SDK that enables any developer to integrate 1000+ tools
+ * across any AI framework (LangChain, CrewAI, Anthropic SDK, etc.).
+ */
+export { ParameterSchema, AuthConfigSchema, ExecutionConfigSchema } from './core/schema';
+export { ToolLoader } from './core/tool-loader';
+export { ToolRegistry } from './core/tool-registry';
+// Executors
+export { CommandExecutor } from './executors/command-executor';
+export { HttpExecutor } from './executors/http-executor';
+// Parameter Encoding
+export { applyParameterEncodings } from './encodings/parameter-encoding';
+// Decorators
+export { tool, setGlobalMatimoInstance, getGlobalMatimoInstance, } from './decorators/tool-decorator';
+// Error handling
+export { MatimoError, ErrorCode, createValidationError, createExecutionError, } from './errors/matimo-error';
+// Matimo instance and namespace
+export { MatimoInstance, matimo } from './matimo-instance';
+export { OAuth2ProviderLoader } from './auth/oauth2-provider-loader';
+export { OAuth2Handler } from './auth/oauth2-handler';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,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;AAEzD,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;AAY3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/matimo-instance.d.ts

@@ -0,0 +1,98 @@
+import { ToolDefinition } from './core/schema';
+/**
+ * Matimo Instance - Single initialization point for tool execution
+ * Combines loader, registry, and executors into one interface
+ */
+export declare class MatimoInstance {
+    private toolsPath;
+    private loader;
+    private registry;
+    private commandExecutor;
+    private httpExecutor;
+    private constructor();
+    /**
+     * Initialize Matimo with tools from a directory
+     * @param toolsPath - Path to tools directory
+     * @returns MatimoInstance ready to execute tools
+     */
+    static init(toolsPath: string): Promise<MatimoInstance>;
+    /**
+     * Execute a tool by name with parameters
+     * @param toolName - Name of the tool to execute
+     * @param params - Tool parameters
+     * @returns Tool execution result
+     */
+    execute(toolName: string, params: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get a tool definition by name
+     * @param toolName - Name of the tool
+     * @returns Tool definition or undefined
+     */
+    getTool(toolName: string): ToolDefinition | undefined;
+    /**
+     * List all available tools
+     * @returns Array of tool definitions
+     */
+    listTools(): ToolDefinition[];
+    /**
+     * Get all available tools (alias for listTools)
+     * @returns Array of tool definitions
+     */
+    getAllTools(): ToolDefinition[];
+    /**
+     * Search tools by name or description
+     * @param query - Search query
+     * @returns Matching tools
+     */
+    searchTools(query: string): ToolDefinition[];
+    /**
+     * Get tools by tag
+     * @param tag - Tag to search for
+     * @returns Tools with the given tag
+     */
+    getToolsByTag(tag: string): ToolDefinition[];
+    /**
+     * Automatically inject parameters from environment variables
+     * Uses a YAML-native, scale-friendly approach:
+     *
+     * 1. Scans the execution config for all parameter placeholders
+     * 2. For each parameter not provided by user, checks if it looks like auth (TOKEN, KEY, SECRET, etc.)
+     * 3. If yes, attempts to load from environment: MATIMO_<PARAM_NAME> or <PARAM_NAME>
+     *
+     * This works for ANY tool with ANY auth parameter name - no hardcoding needed.
+     * Scales to unlimited tools - contributors just submit YAML.
+     *
+     * Examples:
+     * - GMAIL_ACCESS_TOKEN → looks in env vars
+     * - GITHUB_TOKEN → looks in env vars
+     * - SLACK_BOT_TOKEN → looks in env vars
+     * - MY_CUSTOM_API_KEY → looks in env vars
+     * - ANY_SECRET → looks in env vars
+     */
+    private injectAuthParameters;
+    /**
+     * Extract all parameter placeholders from execution config
+     * Scans headers, body, URL, and query_params for {paramName} patterns
+     */
+    private extractParameterPlaceholders;
+    /**
+     * Recursively scan object for parameter placeholders
+     */
+    private scanObjectForParams;
+    /**
+     * Get the appropriate executor for a tool
+     */
+    private getExecutor;
+}
+/**
+ * Matimo namespace - Entry point for the SDK
+ */
+export declare const matimo: {
+    /**
+     * Initialize Matimo with a tools directory
+     * @param toolsPath - Path to tools directory
+     * @returns MatimoInstance ready to use
+     */
+    init(toolsPath: string): Promise<MatimoInstance>;
+};
+//# sourceMappingURL=matimo-instance.d.ts.map

package/dist/matimo-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matimo-instance.d.ts","sourceRoot":"","sources":["../src/matimo-instance.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAe;IAEnC,OAAO;IAUP;;;;OAIG;WACU,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAO7D;;;;;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;CAepB;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB;;;;OAIG;oBACmB,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAGvD,CAAC"}

package/dist/matimo-instance.js

@@ -0,0 +1,260 @@
+import path from 'path';
+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 { 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;
+        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);
+        this.commandExecutor = new CommandExecutor(workingDir);
+        this.httpExecutor = new HttpExecutor();
+    }
+    /**
+     * Initialize Matimo with tools from a directory
+     * @param toolsPath - Path to tools directory
+     * @returns MatimoInstance ready to execute tools
+     */
+    static async init(toolsPath) {
+        const instance = new MatimoInstance(toolsPath);
+        const tools = await instance.loader.loadToolsFromDirectory(toolsPath);
+        instance.registry.registerAll(Array.from(tools.values()));
+        return instance;
+    }
+    /**
+     * Execute a tool by name with parameters
+     * @param toolName - Name of the tool to execute
+     * @param params - Tool parameters
+     * @returns Tool execution result
+     */
+    async execute(toolName, params) {
+        const tool = this.registry.get(toolName);
+        if (!tool) {
+            throw new MatimoError(`Tool '${toolName}' not found in registry`, ErrorCode.TOOL_NOT_FOUND, {
+                toolName,
+                availableTools: this.registry.getAll().map((t) => t.name),
+            });
+        }
+        // Auto-inject authentication parameters from environment variables
+        const finalParams = this.injectAuthParameters(tool, params);
+        const executor = this.getExecutor(tool);
+        return executor.execute(tool, finalParams);
+    }
+    /**
+     * Get a tool definition by name
+     * @param toolName - Name of the tool
+     * @returns Tool definition or undefined
+     */
+    getTool(toolName) {
+        return this.registry.get(toolName);
+    }
+    /**
+     * List all available tools
+     * @returns Array of tool definitions
+     */
+    listTools() {
+        return this.registry.getAll();
+    }
+    /**
+     * Get all available tools (alias for listTools)
+     * @returns Array of tool definitions
+     */
+    getAllTools() {
+        return this.registry.getAll();
+    }
+    /**
+     * Search tools by name or description
+     * @param query - Search query
+     * @returns Matching tools
+     */
+    searchTools(query) {
+        return this.registry.search(query);
+    }
+    /**
+     * Get tools by tag
+     * @param tag - Tag to search for
+     * @returns Tools with the given tag
+     */
+    getToolsByTag(tag) {
+        return this.registry.getByTag(tag);
+    }
+    /**
+     * Automatically inject parameters from environment variables
+     * Uses a YAML-native, scale-friendly approach:
+     *
+     * 1. Scans the execution config for all parameter placeholders
+     * 2. For each parameter not provided by user, checks if it looks like auth (TOKEN, KEY, SECRET, etc.)
+     * 3. If yes, attempts to load from environment: MATIMO_<PARAM_NAME> or <PARAM_NAME>
+     *
+     * This works for ANY tool with ANY auth parameter name - no hardcoding needed.
+     * Scales to unlimited tools - contributors just submit YAML.
+     *
+     * Examples:
+     * - GMAIL_ACCESS_TOKEN → looks in env vars
+     * - GITHUB_TOKEN → looks in env vars
+     * - SLACK_BOT_TOKEN → looks in env vars
+     * - MY_CUSTOM_API_KEY → looks in env vars
+     * - ANY_SECRET → looks in env vars
+     */
+    injectAuthParameters(tool, params) {
+        const result = { ...params };
+        // Collect all parameter names referenced in the execution config
+        const referencedParams = this.extractParameterPlaceholders(tool);
+        // Auth-related parameter name patterns (case-insensitive)
+        const authPatterns = [
+            'token',
+            'key',
+            'secret',
+            'password',
+            'credential',
+            'auth',
+            'bearer',
+            'api_key',
+        ];
+        // Check each referenced parameter
+        for (const paramName of referencedParams) {
+            // Skip if user already provided it
+            if (paramName in result) {
+                continue;
+            }
+            // Check if parameter name looks like auth
+            const lowerName = paramName.toLowerCase();
+            const isAuthParam = authPatterns.some((pattern) => lowerName.includes(pattern));
+            if (isAuthParam) {
+                // Try to load from environment
+                // First try MATIMO_ prefixed version for organization
+                let envValue = process.env[`MATIMO_${paramName}`];
+                // If not found, try the parameter name directly
+                if (!envValue) {
+                    envValue = process.env[paramName];
+                }
+                // If found, inject it
+                if (envValue) {
+                    result[paramName] = envValue;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Extract all parameter placeholders from execution config
+     * Scans headers, body, URL, and query_params for {paramName} patterns
+     */
+    extractParameterPlaceholders(tool) {
+        const params = new Set();
+        const placeholderRegex = /\{([^}]+)\}/g;
+        const execution = tool.execution;
+        // Scan URL
+        if ('url' in execution && execution.url) {
+            let match;
+            while ((match = placeholderRegex.exec(execution.url)) !== null) {
+                params.add(match[1]);
+            }
+        }
+        // Scan headers
+        if ('headers' in execution && execution.headers && typeof execution.headers === 'object') {
+            for (const value of Object.values(execution.headers)) {
+                if (typeof value === 'string') {
+                    let match;
+                    while ((match = placeholderRegex.exec(value)) !== null) {
+                        params.add(match[1]);
+                    }
+                }
+            }
+        }
+        // Scan body (recursively for nested objects)
+        if ('body' in execution && execution.body) {
+            this.scanObjectForParams(execution.body, params);
+        }
+        // Scan query_params
+        if ('query_params' in execution &&
+            execution.query_params &&
+            typeof execution.query_params === 'object') {
+            for (const value of Object.values(execution.query_params)) {
+                if (typeof value === 'string') {
+                    let match;
+                    while ((match = placeholderRegex.exec(value)) !== null) {
+                        params.add(match[1]);
+                    }
+                }
+            }
+        }
+        return params;
+    }
+    /**
+     * Recursively scan object for parameter placeholders
+     */
+    scanObjectForParams(obj, params, visited = new WeakSet()) {
+        if (!obj || typeof obj !== 'object') {
+            return;
+        }
+        // Prevent infinite loops
+        if (visited.has(obj)) {
+            return;
+        }
+        visited.add(obj);
+        const placeholderRegex = /\{([^}]+)\}/g;
+        if (Array.isArray(obj)) {
+            for (const item of obj) {
+                if (typeof item === 'string') {
+                    let match;
+                    while ((match = placeholderRegex.exec(item)) !== null) {
+                        params.add(match[1]);
+                    }
+                }
+                else if (item && typeof item === 'object') {
+                    this.scanObjectForParams(item, params, visited);
+                }
+            }
+        }
+        else {
+            for (const value of Object.values(obj)) {
+                if (typeof value === 'string') {
+                    let match;
+                    while ((match = placeholderRegex.exec(value)) !== null) {
+                        params.add(match[1]);
+                    }
+                }
+                else if (value && typeof value === 'object') {
+                    this.scanObjectForParams(value, params, visited);
+                }
+            }
+        }
+    }
+    /**
+     * Get the appropriate executor for a tool
+     */
+    getExecutor(tool) {
+        const executionType = tool.execution.type;
+        switch (executionType) {
+            case 'command':
+                return this.commandExecutor;
+            case 'http':
+                return this.httpExecutor;
+            default:
+                throw new MatimoError(`Unsupported execution type: ${executionType}`, ErrorCode.EXECUTION_FAILED, { executionType });
+        }
+    }
+}
+/**
+ * Matimo namespace - Entry point for the SDK
+ */
+export const matimo = {
+    /**
+     * Initialize Matimo with a tools directory
+     * @param toolsPath - Path to tools directory
+     * @returns MatimoInstance ready to use
+     */
+    async init(toolsPath) {
+        return MatimoInstance.init(toolsPath);
+    },
+};
+//# sourceMappingURL=matimo-instance.js.map

package/dist/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/docs/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "jekyll", "~> 4.3.0"
+gem "jekyll-theme-slate"
+gem "webrick", "~> 1.8"

package/docs/RELEASES.md

@@ -0,0 +1,69 @@
+# v0.1.0-alpha.1
+
+> First alpha release - Core OAuth2, tool execution, and SDK patterns
+
+**Released**: February 3, 2026
+
+## What's New
+
+### OAuth2 Multi-Provider Support
+- OAuth2 handler with token injection
+- Providers: Google (Gmail), GitHub, Slack
+- Provider YAML configuration
+- Automatic token injection into requests
+
+### Tool System
+- YAML/JSON tool definitions with Zod validation
+- Command executor (shell commands with templating)
+- HTTP executor (REST APIs with OAuth2)
+- Provider definition system
+- Tool discovery and filtering
+
+### SDK Patterns
+- **Factory pattern**: `const m = await matimo.init('./tools'); m.execute(toolName, params)`
+- **Decorator pattern**: `@tool('calculator')` for class-based usage
+- Tool discovery, filtering, and search
+- Full TypeScript support with strict types
+
+### Tools Included
+- **Gmail** (5 tools): send, list, get, draft, delete
+- **Utilities**: calculator, echo, HTTP client
+- **Provider configs**: Google, GitHub, Slack
+
+## Installation
+
+```bash
+npm install matimo@0.1.0-alpha.1
+pnpm add matimo@0.1.0-alpha.1
+```
+
+## Quick Start
+
+```typescript
+import { matimo } from 'matimo';
+
+const m = await matimo.init('./tools');
+const result = await m.execute('calculator', { 
+  operation: 'add', a: 5, b: 3 
+});
+```
+
+## Documentation
+
+- [Installation & Setup](./getting-started/installation.md)
+- [Quick Start](./getting-started/QUICK_START.md)
+- [SDK Patterns](./user-guide/SDK_PATTERNS.md)
+- [OAuth2 Guide](./architecture/OAUTH.md)
+- [API Reference](./api-reference/SDK.md)
+- [Examples](../examples/)
+
+
+## Known Limitations
+
+This is an **alpha release**. Not recommended for production without thorough testing.
+
+See [Roadmap](./ROADMAP.md) for future features.
+
+## Contributing
+
+[Contributing Guide](../CONTRIBUTING.md) | [Report Issues](https://github.com/tallclub/matimo/issues)