@measureoneinc/savant 1.0.0

package/dist/lib/utils/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * @fileoverview Shared Utilities Index
+ *
+ * Exports all shared utility functions and services for use across microservices.
+ *
+ * @author MeasureOne, Inc.
+ * @version 1.0.0
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./file-util"), exports);
+__exportStar(require("./logger"), exports);
+__exportStar(require("./sequelize-service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/utils/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;AAEH,8CAA4B;AAC5B,2CAAyB;AACzB,sDAAoC"}

package/dist/lib/utils/logger.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Shared Logger Utility
+ *
+ * Centralized logging utility for all MeasureOne services using log4js.
+ * Provides simple, straightforward logging with consistent format.
+ *
+ * @author MeasureOne, Inc.
+ */
+import log4js from 'log4js';
+/**
+ * Logger interface compatible with log4js API
+ */
+export type Logger = log4js.Logger;
+/**
+ * Create a logger for a service
+ */
+export declare const create_default_logger: (service_name: string, version?: string) => Logger;
+/**
+ * Compact logger for services (alias for create_default_logger)
+ */
+export declare const create_compact_logger: (service_name: string, version?: string) => Logger;
+/**
+ * Create a silent logger (no output)
+ */
+export declare const create_silent_logger: (service_name: string, version?: string) => Logger;
+/**
+ * Create a JSON logger for structured logging
+ */
+export declare const create_json_logger: (service_name: string, version?: string) => Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;AA4CnC;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,cAAc,MAAM,EAAE,UAAU,MAAM,KAAG,MAG9E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,cAAc,MAAM,EAAE,UAAU,MAAM,KAAG,MAE9E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,EAAE,UAAU,MAAM,KAAG,MAI7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,cAAc,MAAM,EAAE,UAAU,MAAM,KAAG,MAI3E,CAAC"}

package/dist/lib/utils/logger.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * @fileoverview Shared Logger Utility
+ *
+ * Centralized logging utility for all MeasureOne services using log4js.
+ * Provides simple, straightforward logging with consistent format.
+ *
+ * @author MeasureOne, Inc.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.create_json_logger = exports.create_silent_logger = exports.create_compact_logger = exports.create_default_logger = void 0;
+const log4js_1 = __importDefault(require("log4js"));
+// Global log4js configuration flag
+let is_logger_configured = false;
+/**
+ * Configure log4js once globally
+ */
+const configure_logger = () => {
+    if (!is_logger_configured) {
+        log4js_1.default.configure({
+            appenders: {
+                console: {
+                    type: 'console',
+                    layout: {
+                        type: 'pattern',
+                        pattern: '%d %p %c %m%n'
+                    }
+                },
+                file: {
+                    type: 'file',
+                    filename: 'logs/savant-orchestration.log',
+                    maxLogSize: 10485760,
+                    numBackups: 5,
+                    layout: {
+                        type: 'json',
+                        separator: ','
+                    }
+                }
+            },
+            categories: {
+                default: {
+                    appenders: ['console'],
+                    level: process.env.LOG_LEVEL || 'info'
+                }
+            }
+        });
+        is_logger_configured = true;
+    }
+};
+// Configure logger on module load
+configure_logger();
+/**
+ * Create a logger for a service
+ */
+const create_default_logger = (service_name, version) => {
+    const category = version ? `${service_name} v${version}` : service_name;
+    return log4js_1.default.getLogger(category);
+};
+exports.create_default_logger = create_default_logger;
+/**
+ * Compact logger for services (alias for create_default_logger)
+ */
+const create_compact_logger = (service_name, version) => {
+    return (0, exports.create_default_logger)(service_name, version);
+};
+exports.create_compact_logger = create_compact_logger;
+/**
+ * Create a silent logger (no output)
+ */
+const create_silent_logger = (service_name, version) => {
+    const logger = (0, exports.create_default_logger)(service_name, version);
+    logger.level = 'off';
+    return logger;
+};
+exports.create_silent_logger = create_silent_logger;
+/**
+ * Create a JSON logger for structured logging
+ */
+const create_json_logger = (service_name, version) => {
+    // For JSON logging, we'd need to reconfigure, but for simplicity, just return regular logger
+    // If JSON logging is needed, it can be added later
+    return (0, exports.create_default_logger)(service_name, version);
+};
+exports.create_json_logger = create_json_logger;
+//# sourceMappingURL=logger.js.map

package/dist/lib/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/lib/utils/logger.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;AAEH,oDAA4B;AAO5B,mCAAmC;AACnC,IAAI,oBAAoB,GAAG,KAAK,CAAC;AAEjC;;GAEG;AACH,MAAM,gBAAgB,GAAG,GAAG,EAAE;IAC1B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACxB,gBAAM,CAAC,SAAS,CAAC;YACb,SAAS,EAAE;gBACP,OAAO,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,MAAM,EAAE;wBACJ,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,eAAe;qBAC3B;iBACJ;gBACD,IAAI,EAAE;oBACF,IAAI,EAAE,MAAM;oBACZ,QAAQ,EAAE,+BAA+B;oBACzC,UAAU,EAAE,QAAQ;oBACpB,UAAU,EAAE,CAAC;oBACb,MAAM,EAAE;wBACJ,IAAI,EAAE,MAAM;wBACZ,SAAS,EAAE,GAAG;qBACjB;iBACJ;aACJ;YACD,UAAU,EAAE;gBACR,OAAO,EAAE;oBACL,SAAS,EAAE,CAAC,SAAS,CAAC;oBACtB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;iBACzC;aACJ;SACJ,CAAC,CAAC;QACH,oBAAoB,GAAG,IAAI,CAAC;IAChC,CAAC;AACL,CAAC,CAAC;AAEF,kCAAkC;AAClC,gBAAgB,EAAE,CAAC;AAEnB;;GAEG;AACI,MAAM,qBAAqB,GAAG,CAAC,YAAoB,EAAE,OAAgB,EAAU,EAAE;IACpF,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;IACxE,OAAO,gBAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC,CAAC;AAHW,QAAA,qBAAqB,yBAGhC;AAEF;;GAEG;AACI,MAAM,qBAAqB,GAAG,CAAC,YAAoB,EAAE,OAAgB,EAAU,EAAE;IACpF,OAAO,IAAA,6BAAqB,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC,CAAC;AAFW,QAAA,qBAAqB,yBAEhC;AAEF;;GAEG;AACI,MAAM,oBAAoB,GAAG,CAAC,YAAoB,EAAE,OAAgB,EAAU,EAAE;IACnF,MAAM,MAAM,GAAG,IAAA,6BAAqB,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC5D,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAJW,QAAA,oBAAoB,wBAI/B;AAEF;;GAEG;AACI,MAAM,kBAAkB,GAAG,CAAC,YAAoB,EAAE,OAAgB,EAAU,EAAE;IACjF,6FAA6F;IAC7F,mDAAmD;IACnD,OAAO,IAAA,6BAAqB,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC,CAAC;AAJW,QAAA,kBAAkB,sBAI7B"}

package/dist/lib/utils/mcp-utils.d.ts

@@ -0,0 +1,208 @@
+/**
+ * @fileoverview MCP (Model Context Protocol) Utilities
+ *
+ * Utility functions for managing MCP servers, including creation, connection,
+ * and lifecycle management. This centralizes MCP server operations across the application.
+ *
+ * @author MeasureOne, Inc.
+ * @version 1.0.0
+ */
+import { MCPServerConfig } from '../schemas';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+/**
+ * MCP Server entry with name and server instance
+ */
+export interface MCPServerEntry {
+    name: string;
+    server: Client;
+}
+/**
+ * MCP Tool entry with server and tool information
+ */
+export interface MCPToolEntry {
+    server: string;
+    name: string;
+    description: string;
+    inputSchema: any;
+    parameters: any;
+    tags: string[];
+}
+/**
+ * MCP Server Manager - Handles creation, connection, and lifecycle of MCP servers
+ */
+export declare class MCPServerManager {
+    private static instance;
+    private connected_servers;
+    private cached_tools;
+    private initialization_promise;
+    private constructor();
+    /**
+     * Get singleton instance of MCP Server Manager
+     */
+    static get_instance(): MCPServerManager;
+    /**
+     * Get all available MCP tools from all connected servers (static method)
+     *
+     * @param configs - Array of MCP server configurations
+     * @returns Promise<MCPToolEntry[]> - Array of all available tools
+     */
+    static get_all_mcp_tools(configs: MCPServerConfig[]): Promise<MCPToolEntry[]>;
+    /**
+     * Create and connect MCP servers from configurations
+     *
+     * @param configs - Array of MCP server configurations
+     * @returns Promise<Map<string, Client>> - Map of connected MCP servers by name
+     */
+    static create_and_connect_mcp_servers(configs: MCPServerConfig[]): Promise<Map<string, Client>>;
+    /**
+     * Create and connect MCP servers (instance method)
+     *
+     * @param configs - Array of MCP server configurations
+     * @returns Promise<Map<string, Client>> - Map of connected MCP servers by name
+     */
+    create_and_connect_servers(configs: MCPServerConfig[]): Promise<Map<string, Client>>;
+    /**
+     * Internal method to initialize servers
+     * Only initializes stdio servers. HTTP servers are handled via server_url in tool definitions.
+     *
+     * @param configs - Array of MCP server configurations
+     */
+    private _initialize_servers;
+    /**
+     * Get currently connected MCP servers
+     *
+     * @returns Map<string, Client> - Map of connected MCP servers by name
+     */
+    get_connected_servers(): Map<string, Client>;
+    /**
+     * Get all connected MCP servers as an array
+     *
+     * @returns Client[] - Array of connected MCP servers
+     */
+    get_connected_servers_array(): Client[];
+    /**
+     * Get all connected MCP servers with their names
+     *
+     * @returns Array<{name: string, server: Client}> - Array of connected MCP servers with names
+     */
+    get_connected_servers_with_names(): Array<{
+        name: string;
+        server: Client;
+    }>;
+    /**
+     * Get MCP server by exact name
+     *
+     * @param name - Exact name of the MCP server
+     * @returns Client | undefined - The MCP server or undefined if not found
+     */
+    get_server_by_name(name: string): Client | undefined;
+    /**
+     * Get MCP servers by name pattern
+     *
+     * @param name_pattern - Name pattern to filter by (e.g., 'embeddings', 'puppeteer')
+     * @returns Client[] - Filtered array of MCP servers
+     */
+    get_servers_by_name_pattern(name_pattern: string): Client[];
+    /**
+     * Get MCP servers by name pattern as a Map
+     *
+     * @param name_pattern - Name pattern to filter by (e.g., 'embeddings', 'puppeteer')
+     * @returns Map<string, Client> - Filtered map of MCP servers
+     */
+    get_servers_by_name_pattern_map(name_pattern: string): Map<string, Client>;
+    /**
+     * Disconnect all MCP servers
+     */
+    disconnect_all_servers(): Promise<void>;
+    /**
+     * Check if MCP servers are initialized
+     *
+     * @returns boolean - True if servers are initialized
+     */
+    is_initialized(): boolean;
+    /**
+     * Get server count
+     *
+     * @returns number - Number of connected servers
+     */
+    get_server_count(): number;
+    /**
+     * Get all server names
+     *
+     * @returns string[] - Array of server names
+     */
+    get_server_names(): string[];
+    /**
+     * Get all cached MCP tools
+     *
+     * @returns MCPToolEntry[] - Array of cached tools
+     */
+    get_cached_tools(): MCPToolEntry[];
+    /**
+     * Get cached tools filtered by server name
+     *
+     * @param server_name - Optional server name to filter by
+     * @returns MCPToolEntry[] - Array of filtered tools
+     */
+    get_cached_tools_by_server(server_name?: string): MCPToolEntry[];
+    /**
+     * Refresh the tools cache by re-fetching tools from all connected servers
+     *
+     * @returns Promise<void>
+     */
+    refresh_tools_cache(): Promise<void>;
+    /**
+     * Internal method to cache all tools from connected servers
+     */
+    private _cache_all_tools;
+    /**
+     * Extract parameters from MCP tool input schema
+     */
+    private _extract_parameters_from_schema;
+    /**
+     * Extract tags from tool information
+     */
+    private _extract_tags_from_tool;
+}
+/**
+ * Convenience function to create and connect MCP servers
+ *
+ * @param configs - Array of MCP server configurations
+ * @returns Promise<Map<string, Client>> - Map of connected MCP servers by name
+ */
+export declare function create_and_connect_mcp_servers(configs: MCPServerConfig[]): Promise<Map<string, Client>>;
+/**
+ * Convenience function to create and connect MCP servers as an array
+ *
+ * @param configs - Array of MCP server configurations
+ * @returns Promise<Client[]> - Array of connected MCP servers
+ */
+export declare function create_and_connect_mcp_servers_array(configs: MCPServerConfig[]): Promise<Client[]>;
+/**
+ * Get the MCP server manager instance
+ *
+ * @returns MCPServerManager - Singleton instance
+ */
+export declare function get_mcp_server_manager(): MCPServerManager;
+/**
+ * Convenience function to get MCP servers by name pattern
+ *
+ * @param name_pattern - Name pattern to filter by (e.g., 'embeddings', 'puppeteer')
+ * @returns Promise<Client[]> - Array of filtered MCP servers
+ */
+export declare function get_mcp_servers_by_name_pattern(name_pattern: string): Promise<Client[]>;
+/**
+ * Convenience function to get a specific MCP server by name
+ *
+ * @param name - Exact name of the MCP server
+ * @returns Promise<Client | undefined> - The MCP server or undefined if not found
+ */
+export declare function get_mcp_server_by_name(name: string): Promise<Client | undefined>;
+/**
+ * Convenience function to get all MCP tools from all servers
+ *
+ * @param configs - Array of MCP server configurations
+ * @returns Promise<MCPToolEntry[]> - Array of all available tools
+ */
+export declare function get_all_mcp_tools(configs: MCPServerConfig[]): Promise<MCPToolEntry[]>;
+//# sourceMappingURL=mcp-utils.d.ts.map

package/dist/lib/utils/mcp-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/mcp-utils.ts"],"names":[],"mappings":"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"}