@matimo/core 0.1.0-alpha.10

package/dist/decorators/tool-decorator.d.ts

@@ -0,0 +1,97 @@
+import { ToolDefinition } from '../core/types.js';
+import type { MatimoInstance } from '../matimo-instance.js';
+/**
+ * Set the global Matimo instance for decorator usage
+ *
+ * Must be called before any @tool decorated methods are invoked
+ *
+ * @param instance - The MatimoInstance to use globally
+ *
+ * @example
+ * ```typescript
+ * const matimo = await MatimoInstance.init('./tools');
+ * setGlobalMatimoInstance(matimo);
+ *
+ * class MyAgent {
+ *   @tool('calculator')
+ *   async calculate(operation: string, a: number, b: number) { }
+ * }
+ *
+ * const agent = new MyAgent();
+ * await agent.calculate('add', 5, 3);
+ * ```
+ */
+export declare function setGlobalMatimoInstance(instance: MatimoInstance | null): void;
+/**
+ * Get the global Matimo instance
+ *
+ * @throws {Error} If no global instance is set
+ */
+export declare function getGlobalMatimoInstance(): MatimoInstance;
+/**
+ * Tool decorator - transforms a method into a tool executor
+ *
+ * Automatically calls matimo.execute() with the method's arguments mapped to tool parameters.
+ * Must be used in a class that has a `matimo` property or after setGlobalMatimoInstance() is called.
+ *
+ * Works with both traditional and modern TypeScript decorator syntax.
+ *
+ * @param toolName - Name of the tool to execute (e.g., 'calculator', 'github-get-repo')
+ *
+ * @example
+ * ```typescript
+ * // Using global instance
+ * const matimo = await MatimoInstance.init('./tools');
+ * setGlobalMatimoInstance(matimo);
+ *
+ * class MyAgent {
+ *   @tool('calculator')
+ *   async calculate(operation: string, a: number, b: number) {
+ *     // Automatically executes: matimo.execute('calculator', { operation, a, b })
+ *   }
+ *
+ *   @tool('github-get-repo')
+ *   async getRepo(owner: string, repo: string) {
+ *     // Automatically executes: matimo.execute('github-get-repo', { owner, repo })
+ *   }
+ * }
+ *
+ * const agent = new MyAgent();
+ * const result = await agent.calculate('add', 5, 3);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using instance property
+ * class MyAgent {
+ *   constructor(public matimo: MatimoInstance) {}
+ *
+ *   @tool('calculator')
+ *   async calculate(operation: string, a: number, b: number) { }
+ * }
+ *
+ * const matimo = await MatimoInstance.init('./tools');
+ * const agent = new MyAgent(matimo);
+ * const result = await agent.calculate('add', 5, 3);
+ * ```
+ */
+export declare function tool(toolName: string): <This, Args extends unknown[], Return>(_target: (this: This, ...args: Args) => Return, _context: any) => (this: any, ...args: Args) => Promise<unknown>;
+/**
+ * Execute tool via decorator - shared logic for both decorator syntaxes
+ * Exported for testing purposes
+ */
+export declare function executeToolViaDecorator(toolName: string, thisArg: unknown, args: any[]): Promise<unknown>;
+/**
+ * Convert positional arguments to named parameters object
+ * Maps function arguments to tool parameter names in order
+ * Exported for testing purposes
+ *
+ * @example
+ * ```
+ * Tool has parameters: { operation, a, b }
+ * Args: ['add', 5, 3]
+ * Result: { operation: 'add', a: 5, b: 3 }
+ * ```
+ */
+export declare function convertArgsToParams(args: unknown[], toolDef: ToolDefinition): Record<string, unknown>;
+//# sourceMappingURL=tool-decorator.d.ts.map

package/dist/decorators/tool-decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/tool-decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAS5D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,cAAc,CAQxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,IAClB,IAAI,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACnD,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,EAE9C,UAAU,GAAG,MAOU,MAAM,GAAG,EAAE,GAAG,MAAM,IAAI,KAAG,OAAO,CAAC,OAAO,CAAC,CAIrE;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAEhB,IAAI,EAAE,GAAG,EAAE,GACV,OAAO,CAAC,OAAO,CAAC,CAuClB;AACD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,EAAE,cAAc,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB"}

package/dist/decorators/tool-decorator.js

@@ -0,0 +1,157 @@
+import { MatimoError, ErrorCode } from '../errors/matimo-error';
+/**
+ * Global Matimo instance for decorator usage
+ * Set via setGlobalMatimoInstance() before using @tool decorators
+ */
+let globalMatimoInstance = null;
+/**
+ * Set the global Matimo instance for decorator usage
+ *
+ * Must be called before any @tool decorated methods are invoked
+ *
+ * @param instance - The MatimoInstance to use globally
+ *
+ * @example
+ * ```typescript
+ * const matimo = await MatimoInstance.init('./tools');
+ * setGlobalMatimoInstance(matimo);
+ *
+ * class MyAgent {
+ *   @tool('calculator')
+ *   async calculate(operation: string, a: number, b: number) { }
+ * }
+ *
+ * const agent = new MyAgent();
+ * await agent.calculate('add', 5, 3);
+ * ```
+ */
+export function setGlobalMatimoInstance(instance) {
+    globalMatimoInstance = instance;
+}
+/**
+ * Get the global Matimo instance
+ *
+ * @throws {Error} If no global instance is set
+ */
+export function getGlobalMatimoInstance() {
+    if (!globalMatimoInstance) {
+        throw new MatimoError('Global MatimoInstance not set. Call setGlobalMatimoInstance() before using @tool decorator.', ErrorCode.TOOL_NOT_FOUND);
+    }
+    return globalMatimoInstance;
+}
+/**
+ * Tool decorator - transforms a method into a tool executor
+ *
+ * Automatically calls matimo.execute() with the method's arguments mapped to tool parameters.
+ * Must be used in a class that has a `matimo` property or after setGlobalMatimoInstance() is called.
+ *
+ * Works with both traditional and modern TypeScript decorator syntax.
+ *
+ * @param toolName - Name of the tool to execute (e.g., 'calculator', 'github-get-repo')
+ *
+ * @example
+ * ```typescript
+ * // Using global instance
+ * const matimo = await MatimoInstance.init('./tools');
+ * setGlobalMatimoInstance(matimo);
+ *
+ * class MyAgent {
+ *   @tool('calculator')
+ *   async calculate(operation: string, a: number, b: number) {
+ *     // Automatically executes: matimo.execute('calculator', { operation, a, b })
+ *   }
+ *
+ *   @tool('github-get-repo')
+ *   async getRepo(owner: string, repo: string) {
+ *     // Automatically executes: matimo.execute('github-get-repo', { owner, repo })
+ *   }
+ * }
+ *
+ * const agent = new MyAgent();
+ * const result = await agent.calculate('add', 5, 3);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using instance property
+ * class MyAgent {
+ *   constructor(public matimo: MatimoInstance) {}
+ *
+ *   @tool('calculator')
+ *   async calculate(operation: string, a: number, b: number) { }
+ * }
+ *
+ * const matimo = await MatimoInstance.init('./tools');
+ * const agent = new MyAgent(matimo);
+ * const result = await agent.calculate('add', 5, 3);
+ * ```
+ */
+export function tool(toolName) {
+    return function (_target, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _context) {
+        // Handle modern experimental decorator API
+        // The decorator can be used on methods and will receive the method and context
+        // Return a new function that intercepts the call
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return async function (...args) {
+            return executeToolViaDecorator(toolName, this, args);
+        };
+    };
+}
+/**
+ * Execute tool via decorator - shared logic for both decorator syntaxes
+ * Exported for testing purposes
+ */
+export async function executeToolViaDecorator(toolName, thisArg, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+args) {
+    // Get Matimo instance (from class property or global)
+    let matimoInstance = null;
+    if (thisArg && typeof thisArg === 'object' && 'matimo' in thisArg) {
+        matimoInstance = thisArg.matimo || null;
+    }
+    if (!matimoInstance) {
+        matimoInstance = globalMatimoInstance;
+    }
+    if (!matimoInstance) {
+        throw new MatimoError(`Matimo instance not found for @tool('${toolName}') decorator. ` +
+            `Either add matimo property to class or call setGlobalMatimoInstance() first.`, ErrorCode.TOOL_NOT_FOUND, { toolName });
+    }
+    // Get tool definition
+    const toolDef = matimoInstance.getTool(toolName);
+    if (!toolDef) {
+        throw new MatimoError(`Tool '${toolName}' not found in Matimo registry`, ErrorCode.TOOL_NOT_FOUND, {
+            toolName,
+        });
+    }
+    // Convert positional arguments to parameters object
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const params = convertArgsToParams(args, toolDef);
+    // Execute tool via Matimo
+    return matimoInstance.execute(toolName, params);
+}
+/**
+ * Convert positional arguments to named parameters object
+ * Maps function arguments to tool parameter names in order
+ * Exported for testing purposes
+ *
+ * @example
+ * ```
+ * Tool has parameters: { operation, a, b }
+ * Args: ['add', 5, 3]
+ * Result: { operation: 'add', a: 5, b: 3 }
+ * ```
+ */
+export function convertArgsToParams(args, toolDef) {
+    const params = {};
+    if (!toolDef.parameters) {
+        return params;
+    }
+    const paramNames = Object.keys(toolDef.parameters);
+    for (let i = 0; i < args.length && i < paramNames.length; i++) {
+        params[paramNames[i]] = args[i];
+    }
+    return params;
+}
+//# sourceMappingURL=tool-decorator.js.map

package/dist/decorators/tool-decorator.js.map

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

package/dist/encodings/parameter-encoding.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Generic parameter encoding system for transforming input parameters
+ * Used to convert structured parameters into API-specific formats (MIME, JSON, etc.)
+ *
+ * This is YAML-driven via the parameter_encoding directive in tool definitions.
+ * No tool-specific code needed - keeps Matimo universal.
+ */
+/**
+ * Encoding configuration from YAML
+ */
+export interface ParameterEncodingConfig {
+    source: string[];
+    target: string;
+    encoding: string;
+    options?: Record<string, unknown>;
+}
+/**
+ * Apply parameter encodings to transform input parameters
+ * @param params - User-provided parameters
+ * @param encodings - List of encoding configurations from tool YAML
+ * @returns Parameters with encoded values added
+ */
+export declare function applyParameterEncodings(params: Record<string, unknown>, encodings: ParameterEncodingConfig[]): Record<string, unknown>;
+/**
+ * Example usage in YAML:
+ *
+ * execution:
+ *   type: http
+ *   method: POST
+ *   url: 'https://www.googleapis.com/gmail/v1/users/me/messages/send'
+ *   headers:
+ *     Content-Type: 'application/json'
+ *     Authorization: 'Bearer {GMAIL_ACCESS_TOKEN}'
+ *
+ *   parameter_encoding:
+ *     - source: [to, subject, body, cc, bcc, isHtml]
+ *       target: raw
+ *       encoding: mime_rfc2822_base64url
+ *
+ *   body:
+ *     raw: '{raw}'
+ *
+ * Then users call:
+ *   matimo.execute('gmail-send-email', {
+ *     to: 'user@example.com',
+ *     subject: 'Hello',
+ *     body: 'Hi there',
+ *     GMAIL_ACCESS_TOKEN: token
+ *   });
+ */
+//# sourceMappingURL=parameter-encoding.d.ts.map

package/dist/encodings/parameter-encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-encoding.d.ts","sourceRoot":"","sources":["../../src/encodings/parameter-encoding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,uBAAuB,EAAE,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB;AAmFD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/dist/encodings/parameter-encoding.js

@@ -0,0 +1,124 @@
+/**
+ * Generic parameter encoding system for transforming input parameters
+ * Used to convert structured parameters into API-specific formats (MIME, JSON, etc.)
+ *
+ * This is YAML-driven via the parameter_encoding directive in tool definitions.
+ * No tool-specific code needed - keeps Matimo universal.
+ */
+import { MatimoError, ErrorCode } from '../errors/matimo-error';
+/**
+ * Apply parameter encodings to transform input parameters
+ * @param params - User-provided parameters
+ * @param encodings - List of encoding configurations from tool YAML
+ * @returns Parameters with encoded values added
+ */
+export function applyParameterEncodings(params, encodings) {
+    const result = { ...params };
+    for (const config of encodings) {
+        // Extract source parameters
+        const sourceValues = {};
+        for (const key of config.source) {
+            if (key in params) {
+                sourceValues[key] = params[key];
+            }
+        }
+        // Apply encoding function
+        const encodedValue = encodeParameters(sourceValues, config.encoding, config.options);
+        // Store in target parameter
+        result[config.target] = encodedValue;
+    }
+    return result;
+}
+/**
+ * Route to specific encoding function based on type
+ */
+function encodeParameters(sourceValues, encoding, _options) {
+    switch (encoding) {
+        case 'mime_rfc2822_base64url':
+            return encodeMimeRfc2822(sourceValues);
+        case 'json_compact':
+            return JSON.stringify(sourceValues);
+        case 'url_encoded':
+            return encodeUrlParams(sourceValues);
+        default:
+            throw new MatimoError(`Unknown parameter encoding type: ${encoding}`, ErrorCode.INVALID_PARAMETER, {
+                encodingType: encoding,
+                supportedTypes: ['mime_rfc2822_base64url', 'json_compact', 'url_encoded'],
+            });
+    }
+}
+/**
+ * Encode parameters as RFC 2822 MIME message with base64url encoding
+ * Used for Gmail and other email APIs that accept raw MIME format
+ */
+function encodeMimeRfc2822(sourceValues) {
+    const to = sourceValues.to;
+    const subject = sourceValues.subject;
+    const body = sourceValues.body;
+    const cc = sourceValues.cc;
+    const bcc = sourceValues.bcc;
+    // Accept both camelCase (`isHtml`) and snake_case (`is_html`) for backward compatibility
+    const isHtml = (sourceValues.isHtml ?? sourceValues.is_html) || false;
+    if (!to || !subject || !body) {
+        throw new MatimoError('MIME encoding requires: to, subject, body parameters', ErrorCode.INVALID_PARAMETER, {
+            requiredFields: ['to', 'subject', 'body'],
+            providedFields: Object.keys(sourceValues),
+        });
+    }
+    // Build RFC 2822 MIME message
+    let message = '';
+    message += `To: ${to}\r\n`;
+    message += `Subject: ${subject}\r\n`;
+    if (cc)
+        message += `Cc: ${cc}\r\n`;
+    if (bcc)
+        message += `Bcc: ${bcc}\r\n`;
+    message += `Content-Type: ${isHtml ? 'text/html' : 'text/plain'}; charset="UTF-8"\r\n`;
+    message += 'Content-Transfer-Encoding: 7bit\r\n';
+    message += '\r\n'; // Empty line separates headers from body
+    message += body;
+    // Convert to base64url
+    const base64 = Buffer.from(message).toString('base64');
+    // Replace standard base64 characters with URL-safe variants
+    return base64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+/**
+ * Encode parameters as URL-encoded form data
+ */
+function encodeUrlParams(sourceValues) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(sourceValues)) {
+        if (value !== undefined && value !== null) {
+            params.append(key, String(value));
+        }
+    }
+    return params.toString();
+}
+/**
+ * Example usage in YAML:
+ *
+ * execution:
+ *   type: http
+ *   method: POST
+ *   url: 'https://www.googleapis.com/gmail/v1/users/me/messages/send'
+ *   headers:
+ *     Content-Type: 'application/json'
+ *     Authorization: 'Bearer {GMAIL_ACCESS_TOKEN}'
+ *
+ *   parameter_encoding:
+ *     - source: [to, subject, body, cc, bcc, isHtml]
+ *       target: raw
+ *       encoding: mime_rfc2822_base64url
+ *
+ *   body:
+ *     raw: '{raw}'
+ *
+ * Then users call:
+ *   matimo.execute('gmail-send-email', {
+ *     to: 'user@example.com',
+ *     subject: 'Hello',
+ *     body: 'Hi there',
+ *     GMAIL_ACCESS_TOKEN: token
+ *   });
+ */
+//# sourceMappingURL=parameter-encoding.js.map

package/dist/encodings/parameter-encoding.js.map

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

package/dist/errors/matimo-error.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Error codes and custom error class for Matimo
+ */
+export declare enum ErrorCode {
+    INVALID_SCHEMA = "INVALID_SCHEMA",
+    EXECUTION_FAILED = "EXECUTION_FAILED",
+    AUTH_FAILED = "AUTH_FAILED",
+    TOOL_NOT_FOUND = "TOOL_NOT_FOUND",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    VALIDATION_FAILED = "VALIDATION_FAILED",
+    RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
+    TIMEOUT = "TIMEOUT",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    INVALID_PARAMETER = "INVALID_PARAMETER",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * Custom error class for Matimo
+ */
+export declare class MatimoError extends Error {
+    code: ErrorCode;
+    details?: Record<string, unknown> | undefined;
+    cause?: Error | unknown;
+    constructor(message: string, code: ErrorCode, details?: Record<string, unknown> | undefined, cause?: Error | unknown);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Normalize an HTTP/Axios-style error into a MatimoError preserving useful metadata.
+ * This avoids importing axios in the errors module and works with any object
+ * that follows the common `error.response` shape.
+ */
+export declare function fromHttpError(error: unknown, message?: string): MatimoError;
+/**
+ * Create a validation error with context
+ */
+export declare function createValidationError(message: string, details?: Record<string, unknown>): MatimoError;
+/**
+ * Create an execution error with context
+ */
+export declare function createExecutionError(message: string, details?: Record<string, unknown>): MatimoError;
+//# sourceMappingURL=matimo-error.d.ts.map

package/dist/errors/matimo-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matimo-error.d.ts","sourceRoot":"","sources":["../../src/errors/matimo-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,SAAS;IACnB,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAK3B,IAAI,EAAE,SAAS;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IALnC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;gBAG7B,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA,EACxC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO;IAOzB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYlC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAAwB,eAW5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW,CAEb"}

package/dist/errors/matimo-error.js

@@ -0,0 +1,71 @@
+/**
+ * Error codes and custom error class for Matimo
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["INVALID_SCHEMA"] = "INVALID_SCHEMA";
+    ErrorCode["EXECUTION_FAILED"] = "EXECUTION_FAILED";
+    ErrorCode["AUTH_FAILED"] = "AUTH_FAILED";
+    ErrorCode["TOOL_NOT_FOUND"] = "TOOL_NOT_FOUND";
+    ErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    ErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+    ErrorCode["RATE_LIMIT_EXCEEDED"] = "RATE_LIMIT_EXCEEDED";
+    ErrorCode["TIMEOUT"] = "TIMEOUT";
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCode["INVALID_PARAMETER"] = "INVALID_PARAMETER";
+    ErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+/**
+ * Custom error class for Matimo
+ */
+export class MatimoError extends Error {
+    constructor(message, code, details, cause) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'MatimoError';
+        this.cause = cause;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            details: this.details,
+            cause: this.cause instanceof Error
+                ? { message: this.cause.message, name: this.cause.name }
+                : this.cause,
+        };
+    }
+}
+/**
+ * Normalize an HTTP/Axios-style error into a MatimoError preserving useful metadata.
+ * This avoids importing axios in the errors module and works with any object
+ * that follows the common `error.response` shape.
+ */
+export function fromHttpError(error, message = 'HTTP request failed') {
+    // Attempt to extract common HTTP error fields
+    const asAny = error;
+    const response = asAny?.response;
+    const statusCode = response?.status ?? 500;
+    const details = response?.data;
+    const meta = { statusCode };
+    if (details !== undefined)
+        meta.details = details;
+    // Preserve original error message/cause for debugging (redaction handled elsewhere)
+    meta.originalError = asAny?.message ?? String(error ?? '');
+    return new MatimoError(message, ErrorCode.EXECUTION_FAILED, meta, error);
+}
+/**
+ * Create a validation error with context
+ */
+export function createValidationError(message, details) {
+    return new MatimoError(message, ErrorCode.VALIDATION_FAILED, details);
+}
+/**
+ * Create an execution error with context
+ */
+export function createExecutionError(message, details) {
+    return new MatimoError(message, ErrorCode.EXECUTION_FAILED, details);
+}
+//# sourceMappingURL=matimo-error.js.map

package/dist/errors/matimo-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matimo-error.js","sourceRoot":"","sources":["../../src/errors/matimo-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,SAYX;AAZD,WAAY,SAAS;IACnB,8CAAiC,CAAA;IACjC,kDAAqC,CAAA;IACrC,wCAA2B,CAAA;IAC3B,8CAAiC,CAAA;IACjC,8CAAiC,CAAA;IACjC,oDAAuC,CAAA;IACvC,wDAA2C,CAAA;IAC3C,gCAAmB,CAAA;IACnB,4CAA+B,CAAA;IAC/B,oDAAuC,CAAA;IACvC,4CAA+B,CAAA;AACjC,CAAC,EAZW,SAAS,KAAT,SAAS,QAYpB;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGpC,YACE,OAAe,EACR,IAAe,EACf,OAAiC,EACxC,KAAuB;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAW;QACf,YAAO,GAAP,OAAO,CAA0B;QAIxC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EACH,IAAI,CAAC,KAAK,YAAY,KAAK;gBACzB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;gBACxD,CAAC,CAAC,IAAI,CAAC,KAAK;SACjB,CAAC;IACJ,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,OAAO,GAAG,qBAAqB;IAC3E,8CAA8C;IAC9C,MAAM,KAAK,GAAG,KAA4C,CAAC;IAC3D,MAAM,QAAQ,GAAG,KAAK,EAAE,QAA+C,CAAC;IACxE,MAAM,UAAU,GAAI,QAAQ,EAAE,MAA6B,IAAI,GAAG,CAAC;IACnE,MAAM,OAAO,GAAG,QAAQ,EAAE,IAA2C,CAAC;IACtE,MAAM,IAAI,GAA4B,EAAE,UAAU,EAAE,CAAC;IACrD,IAAI,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAClD,oFAAoF;IACpF,IAAI,CAAC,aAAa,GAAG,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC3D,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,OAAiC;IAEjC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,OAAiC;IAEjC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC"}

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

@@ -0,0 +1,19 @@
+import { ToolDefinition } from '../core/schema';
+/**
+ * CommandExecutor - Executes shell commands
+ * Handles parameter templating, timeouts, and error capture
+ */
+export declare class CommandExecutor {
+    private cwd?;
+    constructor(cwd?: string);
+    /**
+     * Execute a tool that runs a shell command
+     */
+    execute(tool: ToolDefinition, params: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Replace parameter placeholders in a string
+     */
+    private templateString;
+}
+export default CommandExecutor;
+//# sourceMappingURL=command-executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-executor.d.ts","sourceRoot":"","sources":["../../src/executors/command-executor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;;GAGG;AAEH,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAC,CAAS;gBAET,GAAG,CAAC,EAAE,MAAM;IAIxB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAqFtF;;OAEG;IACH,OAAO,CAAC,cAAc;CAQvB;AAED,eAAe,eAAe,CAAC"}