@matimo/core 0.1.0-alpha.10

package/dist/logging/logger.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Logger interface for Matimo SDK
+ * Provides a contract for logging implementations allowing users to plug in
+ * their own loggers (Winston, Pino, custom) or use the default Winston logger.
+ *
+ * @example
+ * ```typescript
+ * // Use default Winston logger
+ * const matimo = await MatimoInstance.init({
+ *   toolPaths: ['./tools'],
+ *   logLevel: 'debug'
+ * });
+ *
+ * // Use custom logger
+ * const customLogger = { info: (...) => {}, warn: (...) => {}, ... };
+ * const matimo = await MatimoInstance.init({
+ *   toolPaths: ['./tools'],
+ *   logger: customLogger
+ * });
+ * ```
+ */
+export interface MatimoLogger {
+    /**
+     * Log an informational message with optional metadata
+     */
+    info(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log a warning message with optional metadata
+     */
+    warn(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log an error message with optional metadata
+     */
+    error(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log a debug message with optional metadata
+     */
+    debug(message: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Log level for Matimo logger
+ * silent: No logs (useful for testing)
+ * error: Only errors
+ * warn: Warnings and errors
+ * info: Info, warnings, and errors
+ * debug: All logs including debug messages
+ */
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
+/**
+ * Logger configuration options
+ */
+export interface LoggerConfig {
+    /**
+     * Log level for output (default: 'info')
+     * Environment variable: MATIMO_LOG_LEVEL
+     */
+    logLevel?: LogLevel;
+    /**
+     * Log format: 'json' for structured logging, 'simple' for human-readable
+     * Default: 'json' in production, 'simple' in development
+     * Environment variable: MATIMO_LOG_FORMAT
+     */
+    logFormat?: 'json' | 'simple';
+    /**
+     * Custom logger instance. If provided, overrides all other logger options.
+     * Allows users to plug in Winston, Pino, or any custom logger.
+     */
+    logger?: MatimoLogger;
+}
+/**
+ * Get logger configuration from environment variables and config object
+ * Environment variables take precedence over programmatic config.
+ * Supports:
+ * - MATIMO_LOG_LEVEL: 'silent' | 'error' | 'warn' | 'info' | 'debug'
+ * - MATIMO_LOG_FORMAT: 'json' | 'simple'
+ */
+export declare function getLoggerConfig(config?: LoggerConfig): {
+    logLevel: LogLevel;
+    logFormat: 'json' | 'simple';
+    logger?: MatimoLogger;
+};
+/**
+ * Set the global Matimo logger instance
+ * Called by MatimoInstance.init() during initialization
+ *
+ * @internal
+ */
+export declare function setGlobalMatimoLogger(logger: MatimoLogger): void;
+/**
+ * Get the global Matimo logger instance
+ * Returns a no-op logger if not initialized (safe fallback)
+ *
+ * @internal
+ */
+export declare function getGlobalMatimoLogger(): MatimoLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE5D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE5D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE7D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAE9B;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG;IACtD,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAYA;AAUD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,YAAY,CAWpD"}

package/dist/logging/logger.js

@@ -0,0 +1,53 @@
+/**
+ * Get logger configuration from environment variables and config object
+ * Environment variables take precedence over programmatic config.
+ * Supports:
+ * - MATIMO_LOG_LEVEL: 'silent' | 'error' | 'warn' | 'info' | 'debug'
+ * - MATIMO_LOG_FORMAT: 'json' | 'simple'
+ */
+export function getLoggerConfig(config) {
+    const logLevel = process.env.MATIMO_LOG_LEVEL || config?.logLevel || 'info';
+    const logFormat = process.env.MATIMO_LOG_FORMAT ||
+        config?.logFormat ||
+        (process.env.NODE_ENV === 'production' ? 'json' : 'simple');
+    return {
+        logLevel,
+        logFormat,
+        logger: config?.logger,
+    };
+}
+/**
+ * Global logger instance used by Matimo modules
+ * Set via setGlobalMatimoLogger, accessed via getGlobalMatimoLogger
+ *
+ * @internal
+ */
+let globalMatimoLogger;
+/**
+ * Set the global Matimo logger instance
+ * Called by MatimoInstance.init() during initialization
+ *
+ * @internal
+ */
+export function setGlobalMatimoLogger(logger) {
+    globalMatimoLogger = logger;
+}
+/**
+ * Get the global Matimo logger instance
+ * Returns a no-op logger if not initialized (safe fallback)
+ *
+ * @internal
+ */
+export function getGlobalMatimoLogger() {
+    if (!globalMatimoLogger) {
+        // Return no-op logger if not initialized (safe fallback for tests/edge cases)
+        return {
+            info: () => { },
+            warn: () => { },
+            error: () => { },
+            debug: () => { },
+        };
+    }
+    return globalMatimoLogger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logging/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AA6EA;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,MAAqB;IAKnD,MAAM,QAAQ,GAAI,OAAO,CAAC,GAAG,CAAC,gBAA6B,IAAI,MAAM,EAAE,QAAQ,IAAI,MAAM,CAAC;IAC1F,MAAM,SAAS,GACZ,OAAO,CAAC,GAAG,CAAC,iBAAuC;QACpD,MAAM,EAAE,SAAS;QACjB,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE9D,OAAO;QACL,QAAQ;QACR,SAAS;QACT,MAAM,EAAE,MAAM,EAAE,MAAM;KACvB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,IAAI,kBAA4C,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,kBAAkB,GAAG,MAAM,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,8EAA8E;QAC9E,OAAO;YACL,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;YACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;YACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;YACf,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;SAChB,CAAC;IACJ,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/logging/winston-logger.d.ts

@@ -0,0 +1,29 @@
+import { MatimoLogger, LogLevel, LoggerConfig } from './logger.js';
+/**
+ * Winston-based logger implementation for Matimo SDK
+ * Provides structured logging with optional JSON format for production use.
+ * Supports environment variable overrides for log level and format.
+ *
+ * @internal
+ */
+export declare class WinstonMatimoLogger implements MatimoLogger {
+    private winstonLogger;
+    constructor(config: {
+        logLevel: LogLevel;
+        logFormat: 'json' | 'simple';
+    });
+    private mapLogLevel;
+    private createFormat;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Create a logger from config
+ * Uses Winston if no custom logger provided, otherwise returns the custom logger
+ *
+ * @internal
+ */
+export declare function createLogger(config: LoggerConfig): MatimoLogger;
+//# sourceMappingURL=winston-logger.d.ts.map

package/dist/logging/winston-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winston-logger.d.ts","sourceRoot":"","sources":["../../src/logging/winston-logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnE;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,aAAa,CAAiB;gBAE1B,MAAM,EAAE;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE;IAkBxE,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,YAAY;IAsBpB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAG7D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAS/D"}

package/dist/logging/winston-logger.js

@@ -0,0 +1,73 @@
+import winston from 'winston';
+/**
+ * Winston-based logger implementation for Matimo SDK
+ * Provides structured logging with optional JSON format for production use.
+ * Supports environment variable overrides for log level and format.
+ *
+ * @internal
+ */
+export class WinstonMatimoLogger {
+    constructor(config) {
+        // Map Matimo log levels to Winston levels
+        const winstonLevel = this.mapLogLevel(config.logLevel);
+        // Create format based on config
+        const format = this.createFormat(config.logFormat);
+        this.winstonLogger = winston.createLogger({
+            level: winstonLevel,
+            format,
+            transports: [
+                new winston.transports.Console({
+                    format: winston.format.combine(winston.format.colorize(), format),
+                }),
+            ],
+        });
+    }
+    mapLogLevel(level) {
+        const levelMap = {
+            silent: 'error', // Log errors even in silent mode (they'll be filtered at transport level)
+            error: 'error',
+            warn: 'warn',
+            info: 'info',
+            debug: 'debug',
+        };
+        return levelMap[level];
+    }
+    createFormat(format) {
+        if (format === 'json') {
+            return winston.format.combine(winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston.format.errors({ stack: true }), winston.format.splat(), winston.format.json());
+        }
+        // Simple human-readable format
+        return winston.format.combine(winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston.format.errors({ stack: true }), winston.format.splat(), winston.format.printf(({ timestamp, level, message, ...meta }) => {
+            const metaStr = Object.keys(meta).length > 0 ? JSON.stringify(meta, null, 2) : '';
+            return `[${timestamp}] [${level.toUpperCase()}] ${message}${metaStr ? '\n' + metaStr : ''}`;
+        }));
+    }
+    info(message, meta) {
+        this.winstonLogger.info(message, meta);
+    }
+    warn(message, meta) {
+        this.winstonLogger.warn(message, meta);
+    }
+    error(message, meta) {
+        this.winstonLogger.error(message, meta);
+    }
+    debug(message, meta) {
+        this.winstonLogger.debug(message, meta);
+    }
+}
+/**
+ * Create a logger from config
+ * Uses Winston if no custom logger provided, otherwise returns the custom logger
+ *
+ * @internal
+ */
+export function createLogger(config) {
+    if (config.logger) {
+        return config.logger;
+    }
+    return new WinstonMatimoLogger({
+        logLevel: config.logLevel || 'info',
+        logFormat: config.logFormat || (process.env.NODE_ENV === 'production' ? 'json' : 'simple'),
+    });
+}
+//# sourceMappingURL=winston-logger.js.map

package/dist/logging/winston-logger.js.map

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

package/dist/matimo-instance.d.ts

@@ -0,0 +1,140 @@
+import { ToolDefinition } from './core/schema';
+import { MatimoLogger, LoggerConfig } from './logging';
+/**
+ * Options for MatimoInstance initialization
+ */
+export interface InitOptions extends LoggerConfig {
+    toolPaths?: string[];
+    autoDiscover?: boolean;
+    includeCore?: boolean;
+}
+/**
+ * Matimo Instance - Single initialization point for tool execution
+ * Combines loader, registry, and executors into one interface
+ */
+export declare class MatimoInstance {
+    private toolPaths;
+    private loader;
+    private registry;
+    private commandExecutor;
+    private httpExecutor;
+    private functionExecutor;
+    private logger;
+    private approvalHandler;
+    private constructor();
+    /**
+     * Initialize Matimo with tools from directory or auto-discovery
+     * @param options - Initialization options (string for backward compatibility)
+     * @returns MatimoInstance ready to execute tools
+     *
+     * @example
+     * // Backward compatible - single path
+     * const matimo = await MatimoInstance.init('./tools');
+     *
+     * // New - auto-discovery
+     * const matimo = await MatimoInstance.init({ autoDiscover: true });
+     *
+     * // Explicit paths with logging config
+     * const matimo = await MatimoInstance.init({
+     *   toolPaths: ['./tools'],
+     *   logLevel: 'debug',
+     *   logFormat: 'json'
+     * });
+     *
+     * // Custom logger
+     * const matimo = await MatimoInstance.init({
+     *   toolPaths: ['./tools'],
+     *   logger: myCustomLogger
+     * });
+     */
+    static init(options?: InitOptions | string): Promise<MatimoInstance>;
+    /**
+     * Get tool paths
+     * @returns Array of tool paths
+     */
+    getToolPaths(): string[];
+    /**
+     * Get the logger instance
+     * @returns MatimoLogger instance
+     */
+    getLogger(): MatimoLogger;
+    /**
+     * 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":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EACL,YAAY,EACZ,YAAY,EAIb,MAAM,WAAW,CAAC;AAGnB;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,eAAe,CAAkB;IAEzC,OAAO;IAaP;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;WACU,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAqE1E;;;OAGG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;;OAGG;IACH,SAAS,IAAI,YAAY;IAIzB;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAiFlF;;;;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;IAmD5B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAkDpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;OAEG;IACH,OAAO,CAAC,WAAW;CAiBpB;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB;;;;OAIG;oBACmB,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAGvD,CAAC"}