@matimo/core 0.1.0-alpha.9 → 0.1.2

package/dist/executors/http-executor.js

@@ -1,15 +1,23 @@
 import axios from 'axios';
-import { applyParameterEncodings } from '../encodings/parameter-encoding';
-import { MatimoError, ErrorCode } from '../errors/matimo-error';
+import { applyParameterEncodings } from '../encodings/parameter-encoding.js';
+import { MatimoError, ErrorCode, fromHttpError } from '../errors/matimo-error.js';
 /**
  * HttpExecutor - Executes HTTP requests
  * Handles authentication, retries, and response validation
  */
 export class HttpExecutor {
     /**
-     * Execute a tool that makes an HTTP request
+     * Execute a tool that makes an HTTP request.
+     *
+     * @param tool - Tool definition
+     * @param params - Tool parameters (already env-injected by MatimoInstance)
+     * @param credentials - Optional per-call credential overrides. Used for
+     *   `authentication.type: basic` (username_env / password_env keys) instead of
+     *   reading from `process.env`. Other auth schemes (bearer, api_key) are handled
+     *   upstream via parameter templating in MatimoInstance.injectAuthParameters().
+     *   Values are never logged.
      */
-    async execute(tool, params) {
+    async execute(tool, params, credentials) {
         if (tool.execution.type !== 'http') {
             throw new MatimoError('Tool execution type is not http', ErrorCode.EXECUTION_FAILED, {
                 expectedType: 'http',
@@ -24,6 +32,8 @@ export class HttpExecutor {
         if (parameterEncodings && parameterEncodings.length > 0) {
             finalParams = applyParameterEncodings(params, parameterEncodings);
         }
+        // Validate URL parameters are provided
+        this.validateUrlParameters(url, finalParams);
         // Implement parameter templating
         let finalUrl = this.templateString(url, finalParams);
         // Handle query parameters - only include non-empty ones
@@ -33,10 +43,17 @@ export class HttpExecutor {
                 finalUrl += '?' + queryString;
             }
         }
-        const templatedHeaders = this.templateObject(headers, finalParams);
+        const templatedHeaders = this.templateObject(headers, finalParams, tool.parameters);
+        // Natively handle HTTP Basic Auth when authentication.type === 'basic' and
+        // username_env/password_env are declared. This eliminates the need for
+        // developers to pre-compute base64 credentials as a separate env var step.
+        // Credentials override takes precedence over process.env when provided.
+        this.applyBasicAuth(tool, templatedHeaders, credentials);
         const templatedBody = body && typeof body === 'object'
-            ? this.templateObject(body, finalParams)
-            : body;
+            ? this.templateObject(body, finalParams, tool.parameters)
+            : typeof body === 'string'
+                ? this.templateString(body, finalParams)
+                : body;
         // Build request config
         const requestConfig = {
             method,
@@ -46,7 +63,25 @@ export class HttpExecutor {
             requestConfig.headers = templatedHeaders;
         }
         if (templatedBody !== undefined) {
-            requestConfig.data = templatedBody;
+            // If Content-Type is application/x-www-form-urlencoded and body is an object,
+            // convert to URLSearchParams for proper form encoding by axios
+            const contentType = templatedHeaders['Content-Type'] ||
+                templatedHeaders['content-type'];
+            if (contentType?.includes('application/x-www-form-urlencoded') &&
+                typeof templatedBody === 'object' &&
+                templatedBody !== null &&
+                !(templatedBody instanceof FormData)) {
+                const params = new URLSearchParams();
+                for (const [key, value] of Object.entries(templatedBody)) {
+                    if (value !== undefined && value !== null) {
+                        params.append(key, String(value));
+                    }
+                }
+                requestConfig.data = params;
+            }
+            else {
+                requestConfig.data = templatedBody;
+            }
         }
         if (timeout !== undefined) {
             requestConfig.timeout = timeout;
@@ -62,17 +97,43 @@ export class HttpExecutor {
             };
         }
         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,
-            };
+            // If this is already a MatimoError, rethrow to preserve semantics
+            if (error instanceof MatimoError) {
+                throw error;
+            }
+            // Normalize any HTTP/axios-like or generic errors into MatimoError.
+            // This keeps callers consistent and preserves original cause via details.cause.
+            throw fromHttpError(error, 'HTTP request failed');
         }
     }
+    /**
+     * Automatically inject `Authorization: Basic <base64(username:password)>` when
+     * the tool declares `authentication.type: basic` with `username_env` and `password_env`.
+     *
+     * This is a zero-friction pattern: developers only set two natural env vars
+     * (e.g. TWILIO_ACCOUNT_SID + TWILIO_AUTH_TOKEN) and Matimo handles encoding.
+     * No pre-computed base64 credential string required.
+     *
+     * When `credentials` is provided the lookup order is:
+     *   1. `credentials[envVarName]`  (per-call override — multi-tenant use)
+     *   2. `process.env[envVarName]`  (singleton / single-tenant fallback)
+     *
+     * Credential values are never logged or included in error details.
+     */
+    applyBasicAuth(tool, headers, credentials) {
+        const auth = tool.authentication;
+        if (auth?.type !== 'basic' || !auth.username_env || !auth.password_env) {
+            return;
+        }
+        // Prefer per-call credentials, fall back to process.env
+        const username = (credentials && credentials[auth.username_env]) ?? process.env[auth.username_env];
+        const password = (credentials && credentials[auth.password_env]) ?? process.env[auth.password_env];
+        if (!username || !password) {
+            throw new MatimoError(`Basic Auth requires env vars '${auth.username_env}' and '${auth.password_env}' to be set`, ErrorCode.AUTH_FAILED, { toolName: tool.name, username_env: auth.username_env, password_env: auth.password_env });
+        }
+        const encoded = Buffer.from(`${username}:${password}`).toString('base64');
+        headers['Authorization'] = `Basic ${encoded}`;
+    }
     /**
      * Replace parameter placeholders in a string
      */
@@ -80,12 +141,42 @@ export class HttpExecutor {
         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));
+            // Allow empty-string values to be substituted (validation allows empty strings)
+            if (value !== undefined && value !== null) {
+                const replacement = String(value);
+                result = result.replace(new RegExp(placeholder, 'g'), () => replacement);
             }
         }
         return result;
     }
+    /**
+     * Check if a string is an unfilled placeholder
+     * Only matches single placeholders like "{param}", not "{...}" or embedded placeholders
+     */
+    isUnfilledPlaceholder(str) {
+        // Match exactly "{word}" where word is a valid identifier
+        return /^\{[a-zA-Z_][a-zA-Z0-9_]*\}$/.test(str);
+    }
+    /**
+     * Validate that all URL parameters are provided
+     */
+    validateUrlParameters(url, params) {
+        // Extract all placeholders from URL like {param_name}
+        const urlParamMatches = url.match(/\{([a-zA-Z_][a-zA-Z0-9_]*)\}/g);
+        if (!urlParamMatches) {
+            return; // No parameters in URL
+        }
+        for (const match of urlParamMatches) {
+            const paramName = match.slice(1, -1); // Remove { }
+            const paramValue = params[paramName];
+            // Check if parameter is missing or undefined
+            if (paramValue === undefined) {
+                throw new MatimoError(`Required URL parameter '${paramName}' is missing`, ErrorCode.INVALID_SCHEMA, { url, missingParam: paramName });
+            }
+            // Allow null, empty string, 0, false, etc. as valid values
+            // Just ensure the parameter is defined
+        }
+    }
     /**
      * Build query string from query_params, only including provided values
      */
@@ -101,32 +192,145 @@ export class HttpExecutor {
         return parts.join('&');
     }
     /**
-     * Replace parameter placeholders in an object (headers, body)
-     * Recursively handles nested objects
+     * 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
+     * }
+     * ```
      */
-    templateObject(obj, params) {
+    templateObject(obj, params, paramDefinitions) {
         const result = {};
         for (const [key, value] of Object.entries(obj)) {
             if (typeof value === 'string') {
-                result[key] = this.templateString(value, params);
+                // Check if this is exactly a placeholder like "{parent}"
+                const paramNameMatch = value.match(/^\{([a-zA-Z_][a-zA-Z0-9_]*)\}$/);
+                if (paramNameMatch) {
+                    const paramName = paramNameMatch[1];
+                    const paramValue = params[paramName];
+                    // If parameter is defined in schema with type object or array,
+                    // embed the value directly instead of stringifying
+                    if (paramValue !== undefined && paramDefinitions?.[paramName]) {
+                        const paramType = paramDefinitions[paramName].type;
+                        if ((paramType === 'object' || paramType === 'array') && paramValue !== null) {
+                            result[key] = paramValue;
+                            continue;
+                        }
+                    }
+                }
+                // Otherwise, do normal string templating
+                const templated = this.templateString(value, params);
+                if (templated !== undefined &&
+                    templated !== null &&
+                    !this.isUnfilledPlaceholder(templated)) {
+                    // Extract parameter name from template (e.g., "{page_size}" → "page_size")
+                    const paramName = paramNameMatch ? paramNameMatch[1] : null;
+                    // If this is a single parameter placeholder, use the parameter's defined type
+                    if (paramName && paramDefinitions?.[paramName]) {
+                        const paramType = paramDefinitions[paramName].type;
+                        if (paramType === 'number' && !isNaN(Number(templated))) {
+                            result[key] = Number(templated);
+                        }
+                        else if (paramType === 'boolean') {
+                            result[key] = templated === 'true' || templated === '1' || templated === 'yes';
+                        }
+                        else {
+                            result[key] = templated;
+                        }
+                    }
+                    else {
+                        result[key] = templated;
+                    }
+                }
             }
             else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
                 // Recursively template nested objects
-                result[key] = this.templateObject(value, params);
+                const nestedResult = this.templateObject(value, params, paramDefinitions);
+                // Only include nested object if it has content
+                if (Object.keys(nestedResult).length > 0) {
+                    result[key] = nestedResult;
+                }
             }
             else if (Array.isArray(value)) {
                 // Handle arrays of objects
-                result[key] = value.map((item) => {
+                const templatedArray = value
+                    .map((item) => {
                     if (typeof item === 'string') {
-                        return this.templateString(item, params);
+                        const templated = this.templateString(item, params);
+                        // Skip unfilled placeholders; allow empty strings
+                        if (templated !== undefined &&
+                            templated !== null &&
+                            !this.isUnfilledPlaceholder(templated)) {
+                            // Extract parameter name from template
+                            const paramNameMatch = item.match(/^\{([a-zA-Z_][a-zA-Z0-9_]*)\}$/);
+                            const paramName = paramNameMatch ? paramNameMatch[1] : null;
+                            // If this is a single parameter placeholder, use the parameter's defined type
+                            if (paramName && paramDefinitions?.[paramName]) {
+                                const paramType = paramDefinitions[paramName].type;
+                                if (paramType === 'number' && !isNaN(Number(templated))) {
+                                    return Number(templated);
+                                }
+                                else if (paramType === 'boolean') {
+                                    return templated === 'true' || templated === '1' || templated === 'yes';
+                                }
+                            }
+                            return templated;
+                        }
+                        return null;
                     }
                     else if (typeof item === 'object' && item !== null && !Array.isArray(item)) {
-                        return this.templateObject(item, params);
+                        const templated = this.templateObject(item, params, paramDefinitions);
+                        // Only include if has content
+                        return Object.keys(templated).length > 0 ? templated : null;
                     }
                     return item;
-                });
+                })
+                    .filter((item) => item !== null);
+                // Only include array if it has items
+                if (templatedArray.length > 0) {
+                    result[key] = templatedArray;
+                }
             }
-            else {
+            else if (value !== undefined && value !== null) {
                 result[key] = value;
             }
         }

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

@@ -1 +1 @@
-{"version":3,"file":"http-executor.js","sourceRoot":"","sources":["../../src/executors/http-executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http-executor.js","sourceRoot":"","sources":["../../src/executors/http-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAA6B,MAAM,OAAO,CAAC;AAElD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAElF;;;GAGG;AAEH,MAAM,OAAO,YAAY;IACvB;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,CACX,IAAoB,EACpB,MAA+B,EAC/B,WAAoC;QAEpC,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,uCAAuC;QACvC,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAE7C,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,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEpF,2EAA2E;QAC3E,uEAAuE;QACvE,2EAA2E;QAC3E,wEAAwE;QACxE,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,gBAA0C,EAAE,WAAW,CAAC,CAAC;QACnF,MAAM,aAAa,GACjB,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAC9B,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,IAA+B,EAAE,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC;YACpF,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ;gBACxB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC;gBACxC,CAAC,CAAC,IAAI,CAAC;QAEb,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,8EAA8E;YAC9E,+DAA+D;YAC/D,MAAM,WAAW,GACd,gBAA2C,CAAC,cAAc,CAAC;gBAC3D,gBAA2C,CAAC,cAAc,CAAC,CAAC;YAE/D,IACE,WAAW,EAAE,QAAQ,CAAC,mCAAmC,CAAC;gBAC1D,OAAO,aAAa,KAAK,QAAQ;gBACjC,aAAa,KAAK,IAAI;gBACtB,CAAC,CAAC,aAAa,YAAY,QAAQ,CAAC,EACpC,CAAC;gBACD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;gBACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAwC,CAAC,EAAE,CAAC;oBACpF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;wBAC1C,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC;gBACD,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,IAAI,GAAG,aAAa,CAAC;YACrC,CAAC;QACH,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,kEAAkE;YAClE,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;gBACjC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,oEAAoE;YACpE,gFAAgF;YAChF,MAAM,aAAa,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACK,cAAc,CACpB,IAAoB,EACpB,OAA+B,EAC/B,WAAoC;QAEpC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC;QACjC,IAAI,IAAI,EAAE,IAAI,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvE,OAAO;QACT,CAAC;QAED,wDAAwD;QACxD,MAAM,QAAQ,GACZ,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpF,MAAM,QAAQ,GACZ,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEpF,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,WAAW,CACnB,iCAAiC,IAAI,CAAC,YAAY,UAAU,IAAI,CAAC,YAAY,aAAa,EAC1F,SAAS,CAAC,WAAW,EACrB,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAC1F,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC1E,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,OAAO,EAAE,CAAC;IAChD,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,gFAAgF;YAChF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,qBAAqB,CAAC,GAAW;QACvC,0DAA0D;QAC1D,OAAO,8BAA8B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,GAAW,EAAE,MAA+B;QACxE,sDAAsD;QACtD,MAAM,eAAe,GAAG,GAAG,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnE,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,CAAC,uBAAuB;QACjC,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa;YACnD,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YAErC,6CAA6C;YAC7C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,WAAW,CACnB,2BAA2B,SAAS,cAAc,EAClD,SAAS,CAAC,cAAc,EACxB,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,CACjC,CAAC;YACJ,CAAC;YAED,2DAA2D;YAC3D,uCAAuC;QACzC,CAAC;IACH,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACK,cAAc,CACpB,GAA4B,EAC5B,MAA+B,EAC/B,gBAAmD;QAEnD,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,yDAAyD;gBACzD,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;gBAErE,IAAI,cAAc,EAAE,CAAC;oBACnB,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;oBACpC,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;oBAErC,+DAA+D;oBAC/D,mDAAmD;oBACnD,IAAI,UAAU,KAAK,SAAS,IAAI,gBAAgB,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;wBAC9D,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC;wBACnD,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,OAAO,CAAC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;4BAC7E,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;4BACzB,SAAS;wBACX,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,yCAAyC;gBACzC,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBACrD,IACE,SAAS,KAAK,SAAS;oBACvB,SAAS,KAAK,IAAI;oBAClB,CAAC,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,EACtC,CAAC;oBACD,2EAA2E;oBAC3E,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;oBAE5D,8EAA8E;oBAC9E,IAAI,SAAS,IAAI,gBAAgB,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;wBAC/C,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC;wBACnD,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;4BACxD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;wBAClC,CAAC;6BAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;4BACnC,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,KAAK,CAAC;wBACjF,CAAC;6BAAM,CAAC;4BACN,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;wBAC1B,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;oBAC1B,CAAC;gBACH,CAAC;YACH,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,YAAY,GAAG,IAAI,CAAC,cAAc,CACtC,KAAgC,EAChC,MAAM,EACN,gBAAgB,CACjB,CAAC;gBACF,+CAA+C;gBAC/C,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzC,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;gBAC7B,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChC,2BAA2B;gBAC3B,MAAM,cAAc,GAAG,KAAK;qBACzB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;oBACZ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;wBAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;wBACpD,kDAAkD;wBAClD,IACE,SAAS,KAAK,SAAS;4BACvB,SAAS,KAAK,IAAI;4BAClB,CAAC,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,EACtC,CAAC;4BACD,uCAAuC;4BACvC,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;4BACpE,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;4BAE5D,8EAA8E;4BAC9E,IAAI,SAAS,IAAI,gBAAgB,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;gCAC/C,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC;gCACnD,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;oCACxD,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;gCAC3B,CAAC;qCAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;oCACnC,OAAO,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,KAAK,CAAC;gCAC1E,CAAC;4BACH,CAAC;4BACD,OAAO,SAAS,CAAC;wBACnB,CAAC;wBACD,OAAO,IAAI,CAAC;oBACd,CAAC;yBAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC7E,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CACnC,IAA+B,EAC/B,MAAM,EACN,gBAAgB,CACjB,CAAC;wBACF,8BAA8B;wBAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;oBAC9D,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC,CAAC;qBACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;gBACnC,qCAAqC;gBACrC,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC;gBAC/B,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,eAAe,YAAY,CAAC"}

package/dist/index.d.ts

@@ -4,27 +4,49 @@
  * 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, 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 { MatimoLogger, LogLevel, LoggerConfig, getLoggerConfig, setGlobalMatimoLogger, getGlobalMatimoLogger, } from './logging';
-export { WinstonMatimoLogger, createLogger } from './logging/winston-logger';
-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';
-export { ApprovalHandler, getGlobalApprovalHandler } from './approval/approval-handler';
-export type { ApprovalRequest, ApprovalCallback } from './approval/approval-handler';
+export type { Parameter, AuthConfig, HttpExecution, CommandExecution, FunctionExecution, OutputSchema, RateLimitConfig, ErrorHandlingConfig, ToolDefinition, ExecuteOptions, SkillDefinition, SkillFrontmatter, ParsedSkill, SkillSummary, SearchSkillsOptions, BundledResources, SkillCatalogInfo, SkillSection, SkillContentOptions, EmbeddingProvider, } from './core/types.js';
+export { ParameterSchema, AuthConfigSchema, ExecutionConfigSchema } from './core/schema.js';
+export { ToolLoader } from './core/tool-loader.js';
+export { ToolRegistry } from './core/tool-registry.js';
+export { SkillLoader } from './core/skill-loader.js';
+export { SkillRegistry } from './core/skill-registry.js';
+export type { SemanticSearchResult } from './core/skill-registry.js';
+export { parseSkillSections, extractSkillContent, listSkillSections, } from './core/skill-content-parser.js';
+export { extractSkillMetadata } from './core/skill-loader.js';
+export type { ParsedSkillContent } from './core/skill-content-parser.js';
+export { TfIdfEmbeddingProvider, cosineSimilarity } from './core/tfidf-embedding.js';
+export { CommandExecutor } from './executors/command-executor.js';
+export { HttpExecutor } from './executors/http-executor.js';
+export { FunctionExecutor } from './executors/function-executor.js';
+export { applyParameterEncodings } from './encodings/parameter-encoding.js';
+export type { ParameterEncodingConfig } from './encodings/parameter-encoding.js';
+export { tool, setGlobalMatimoInstance, getGlobalMatimoInstance, } from './decorators/tool-decorator.js';
+export { MatimoError, ErrorCode, createValidationError, createExecutionError, } from './errors/matimo-error.js';
+export { MatimoLogger, LogLevel, LoggerConfig, getLoggerConfig, setGlobalMatimoLogger, getGlobalMatimoLogger, } from './logging/index.js';
+export { WinstonMatimoLogger, createLogger } from './logging/winston-logger.js';
+export { MatimoInstance, matimo } from './matimo-instance.js';
+export type { InitOptions } from './matimo-instance.js';
+export type { OAuth2Provider, OAuth2Token, OAuth2Config, AuthorizationOptions, TokenResponse, OAuth2Endpoints, } from './auth/oauth2-config.js';
+export type { ProviderDefinition } from './core/schema.js';
+export { OAuth2ProviderLoader } from './auth/oauth2-provider-loader.js';
+export { OAuth2Handler } from './auth/oauth2-handler.js';
+export { convertToolsToLangChain, getSkillsMetadata, buildRelevantSkillPrompt, } from './integrations/langchain.js';
+export type { LangChainTool, SkillContext } from './integrations/langchain.js';
+export type { PolicyEngine, PolicyContext, PolicyDecision, PolicyConfig, PolicyTier, RiskLevel, Violation, ValidationResult, ValidationContext, HITLCallback, HITLRequest, } from './policy/types.js';
+export { DefaultPolicyEngine, getTierForTool } from './policy/default-policy.js';
+export { validateToolContent, isSSRFTarget } from './policy/content-validator.js';
+export { classifyRisk } from './policy/risk-classifier.js';
+export { ToolIntegrityTracker } from './policy/integrity-tracker.js';
+export { ApprovalManifest } from './policy/approval-manifest.js';
+export { loadPolicyFromFile, parsePolicyFile } from './policy/policy-loader.js';
+export type { MatimoEvent, MatimoEventHandler } from './policy/events.js';
+export { ToolDefinitionSchema, validateToolDefinition } from './core/schema.js';
+export type { ReloadResult } from './matimo-instance.js';
+export { ApprovalHandler, getGlobalApprovalHandler } from './approval/approval-handler.js';
+export type { ApprovalRequest, ApprovalCallback } from './approval/approval-handler.js';
+export { MCPServer, createMCPServer } from './mcp/index.js';
+export type { MCPServerOptions } from './mcp/index.js';
+export type { SecretResolver, SecretResolverConfig, SecretResolverChainConfig, } from './mcp/index.js';
+export { EnvSecretResolver, DotenvSecretResolver, SecretResolverChain, createResolverChain, } from './mcp/index.js';
+export { convertParametersToMcpSchema, toolToMcpRegistration, extractAuthPlaceholders, } from './mcp/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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,EACL,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7E,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;AAK9D,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACxF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4,30 +4,48 @@
  * 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';
+export { ParameterSchema, AuthConfigSchema, ExecutionConfigSchema } from './core/schema.js';
+export { ToolLoader } from './core/tool-loader.js';
+export { ToolRegistry } from './core/tool-registry.js';
+export { SkillLoader } from './core/skill-loader.js';
+export { SkillRegistry } from './core/skill-registry.js';
+export { parseSkillSections, extractSkillContent, listSkillSections, } from './core/skill-content-parser.js';
+export { extractSkillMetadata } from './core/skill-loader.js';
+export { TfIdfEmbeddingProvider, cosineSimilarity } from './core/tfidf-embedding.js';
 // Executors
-export { CommandExecutor } from './executors/command-executor';
-export { HttpExecutor } from './executors/http-executor';
-export { FunctionExecutor } from './executors/function-executor';
+export { CommandExecutor } from './executors/command-executor.js';
+export { HttpExecutor } from './executors/http-executor.js';
+export { FunctionExecutor } from './executors/function-executor.js';
 // Parameter Encoding
-export { applyParameterEncodings } from './encodings/parameter-encoding';
+export { applyParameterEncodings } from './encodings/parameter-encoding.js';
 // Decorators
-export { tool, setGlobalMatimoInstance, getGlobalMatimoInstance, } from './decorators/tool-decorator';
+export { tool, setGlobalMatimoInstance, getGlobalMatimoInstance, } from './decorators/tool-decorator.js';
 // Error handling
-export { MatimoError, ErrorCode, createValidationError, createExecutionError, } from './errors/matimo-error';
+export { MatimoError, ErrorCode, createValidationError, createExecutionError, } from './errors/matimo-error.js';
 // Logging
-export { getLoggerConfig, setGlobalMatimoLogger, getGlobalMatimoLogger, } from './logging';
-export { WinstonMatimoLogger, createLogger } from './logging/winston-logger';
+export { getLoggerConfig, setGlobalMatimoLogger, getGlobalMatimoLogger, } from './logging/index.js';
+export { WinstonMatimoLogger, createLogger } from './logging/winston-logger.js';
 // Matimo instance and namespace
-export { MatimoInstance, matimo } from './matimo-instance';
-export { OAuth2ProviderLoader } from './auth/oauth2-provider-loader';
-export { OAuth2Handler } from './auth/oauth2-handler';
+export { MatimoInstance, matimo } from './matimo-instance.js';
+export { OAuth2ProviderLoader } from './auth/oauth2-provider-loader.js';
+export { OAuth2Handler } from './auth/oauth2-handler.js';
 // LangChain integration
-export { convertToolsToLangChain } from './integrations/langchain';
+export { convertToolsToLangChain, getSkillsMetadata, buildRelevantSkillPrompt, } from './integrations/langchain.js';
+export { DefaultPolicyEngine, getTierForTool } from './policy/default-policy.js';
+export { validateToolContent, isSSRFTarget } from './policy/content-validator.js';
+export { classifyRisk } from './policy/risk-classifier.js';
+export { ToolIntegrityTracker } from './policy/integrity-tracker.js';
+export { ApprovalManifest } from './policy/approval-manifest.js';
+export { loadPolicyFromFile, parsePolicyFile } from './policy/policy-loader.js';
+// Schema validation
+export { ToolDefinitionSchema, validateToolDefinition } from './core/schema.js';
 // Generic Approval System - Simple, scalable flow for any tool
 // Tools declare requires_approval in YAML, or system detects destructive keywords
 // Single approval callback handles all tools - no per-provider logic needed
-export { ApprovalHandler, getGlobalApprovalHandler } from './approval/approval-handler';
+export { ApprovalHandler, getGlobalApprovalHandler } from './approval/approval-handler.js';
+// MCP Server - Model Context Protocol integration
+// Exposes all Matimo tools via MCP for Claude Desktop, Cursor, etc.
+export { MCPServer, createMCPServer } from './mcp/index.js';
+export { EnvSecretResolver, DotenvSecretResolver, SecretResolverChain, createResolverChain, } from './mcp/index.js';
+export { convertParametersToMcpSchema, toolToMcpRegistration, extractAuthPlaceholders, } from './mcp/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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,UAAU;AACV,OAAO,EAIL,eAAe,EACf,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7E,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;AAGnE,+DAA+D;AAC/D,kFAAkF;AAClF,4EAA4E;AAC5E,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAErF,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,qBAAqB;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAG5E,aAAa;AACb,OAAO,EACL,IAAI,EACJ,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AAExC,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,SAAS,EACT,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,UAAU;AACV,OAAO,EAIL,eAAe,EACf,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhF,gCAAgC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAa9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,wBAAwB;AACxB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AAqBrC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGhF,oBAAoB;AACpB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAKhF,+DAA+D;AAC/D,kFAAkF;AAClF,4EAA4E;AAC5E,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAG3F,kDAAkD;AAClD,oEAAoE;AACpE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAS5D,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC"}

package/dist/integrations/langchain.d.ts

@@ -16,8 +16,8 @@
  *   );
  */
 import { z } from 'zod';
-import type { ToolDefinition } from '../core/types';
-import type { MatimoInstance } from '../matimo-instance';
+import type { ToolDefinition } from '../core/types.js';
+import type { MatimoInstance } from '../matimo-instance.js';
 export interface LangChainTool {
     name: string;
     description: string;
@@ -43,4 +43,59 @@ export interface LangChainTool {
  * ```
  */
 export declare function convertToolsToLangChain(tools: ToolDefinition[], matimo: MatimoInstance, secrets?: Record<string, string>, secretParamNames?: Set<string>): Promise<LangChainTool[]>;
+export interface SkillContext {
+    name: string;
+    description: string;
+    content: string;
+}
+/**
+ * Return Level 1 metadata (name + description) for all available skills.
+ *
+ * Token-safe — only a few lines per skill. Include this in the system prompt
+ * so the agent knows what skills exist and can request them by name, mirroring
+ * what `matimo_list_skills` does in the tool-based flow.
+ *
+ * @example
+ * ```ts
+ * const meta = getSkillsMetadata(matimo);
+ * // → [{ name: 'code-review', description: 'Code review checklist' }, ...]
+ * ```
+ */
+export declare function getSkillsMetadata(matimo: MatimoInstance): Array<{
+    name: string;
+    description: string;
+}>;
+/**
+ * Build a per-request system prompt snippet from semantically relevant skills.
+ *
+ * Uses TF-IDF semantic search (built-in, zero dependencies) to rank all skills
+ * against the user's query and loads full content only for the top matches.
+ * This preserves the progressive disclosure model without MCP:
+ *
+ *   Level 1 at startup → Level 2 per-request (only relevant skills)
+ *
+ * @param matimo     - Initialised MatimoInstance
+ * @param query      - The user's current message/query; drives semantic ranking
+ * @param options.topK      - Max skills to load (default 3); keeps token cost bounded
+ * @param options.minScore  - Minimum cosine similarity to include (default 0.3)
+ * @param options.header    - Custom header text (optional)
+ * @returns Formatted string ready to inject as a context block, or empty string
+ *          when no skills score above `minScore`.
+ *
+ * @example
+ * ```ts
+ * // In your ReAct loop, per message:
+ * const skillContext = await buildRelevantSkillPrompt(matimo, userMessage, { topK: 2 });
+ * const messages = [
+ *   new SystemMessage(baseSystemPrompt),
+ *   ...(skillContext ? [new SystemMessage(skillContext)] : []),
+ *   new HumanMessage(userMessage),
+ * ];
+ * ```
+ */
+export declare function buildRelevantSkillPrompt(matimo: MatimoInstance, query: string, options?: {
+    topK?: number;
+    minScore?: number;
+    header?: string;
+}): Promise<string>;
 //# sourceMappingURL=langchain.d.ts.map

package/dist/integrations/langchain.d.ts.map

@@ -1 +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"}
+{"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,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,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;AAiMD;;;;;;;;;;;;;;;;;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;AAoBD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,GACrB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAK9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,OAAO,CAAC,MAAM,CAAC,CAwBjB"}