@loop_ouroboros/mcp-hub-lite 1.0.1 → 1.1.0

package/dist/server/src/services/session-tracker.service.d.ts

@@ -0,0 +1,124 @@
+import type { SessionContext, SessionInfo, SessionRoot } from '../../shared/types/session-context.types.js';
+/**
+ * Session tracking service that manages session connections and their metadata.
+ *
+ * This service maintains a registry of connected sessions (typically IDEs or other
+ * MCP clients) and tracks their connection state, metadata, and workspace roots.
+ * It provides automatic cleanup of stale sessions after a timeout period and
+ * publishes connection/disconnection events via the event bus.
+ *
+ * The service is primarily used by the MCP session manager to track which sessions
+ * are connected and maintain their context information for proper session management.
+ *
+ * @example
+ * // Update session information when a new connection is established
+ * sessionTrackerService.updateSession({
+ *   sessionId: 'session-123',
+ *   clientName: 'VS Code',
+ *   clientVersion: '1.85.0',
+ *   cwd: '/home/user/project'
+ * });
+ *
+ * // Get all currently connected sessions
+ * const sessions = sessionTrackerService.getSessions();
+ */
+declare class SessionTrackerService {
+    private sessions;
+    private get TIMEOUT_MS();
+    /**
+     * Creates a new session tracker service instance.
+     *
+     * Initializes the service with automatic periodic cleanup of stale sessions
+     * every 60 seconds to prevent memory leaks from disconnected sessions.
+     */
+    constructor();
+    /**
+     * Updates or creates a session entry with the provided context information.
+     *
+     * This method is called whenever a session sends a request with context information.
+     * It preserves existing session metadata that isn't provided in the new context,
+     * ensuring that sessions don't lose their previously established information.
+     *
+     * If this is a new session (not previously tracked), it publishes a 'session-connected'
+     * event to notify other services about the new connection.
+     *
+     * @param context - The session context containing session ID and optional metadata
+     * @param context.sessionId - Unique identifier for the session
+     * @param context.clientName - Optional name of the client application
+     * @param context.clientVersion - Optional version of the client application
+     * @param context.protocolVersion - Optional MCP protocol version
+     * @param context.userAgent - Optional user agent string
+     * @param context.ip - Optional session IP address
+     *
+     * @example
+     * sessionTrackerService.updateSession({
+     *   sessionId: 'session-123',
+     *   clientName: 'VS Code',
+     *   clientVersion: '1.85.0'
+     * });
+     */
+    updateSession(context: SessionContext): void;
+    /**
+     * Updates the workspace roots for a specific session.
+     *
+     * This method is typically called when a session provides its workspace root
+     * directories.
+     *
+     * @param sessionId - The unique session identifier for the session
+     * @param roots - Array of session root objects containing URI information
+     *
+     * @example
+     * sessionTrackerService.updateSessionRoots('session-123', [
+     *   { uri: 'file:///home/user/project' },
+     *   { uri: 'file:///home/user/other-project' }
+     * ]);
+     */
+    updateSessionRoots(sessionId: string, roots: SessionRoot[]): void;
+    /**
+     * Retrieves all currently tracked session information.
+     *
+     * Returns an array of all active session info objects, including their metadata
+     * and connection state. This is useful for monitoring all connected sessions
+     * or displaying session information in administrative interfaces.
+     *
+     * @returns Array of SessionInfo objects representing all tracked sessions
+     *
+     * @example
+     * const allSessions = sessionTrackerService.getSessions();
+     * console.log(`Currently tracking ${allSessions.length} sessions`);
+     */
+    getSessions(): SessionInfo[];
+    /**
+     * Retrieves session information for a specific session ID.
+     *
+     * Returns the complete session info object for the given session ID, or undefined
+     * if no session with that session ID is currently being tracked.
+     *
+     * @param sessionId - The unique session identifier to look up
+     * @returns SessionInfo object if found, undefined otherwise
+     *
+     * @example
+     * const session = sessionTrackerService.getSession('session-123');
+     * if (session) {
+     *   console.log(`Session ${session.clientName} is connected`);
+     * }
+     */
+    getSession(sessionId: string): SessionInfo | undefined;
+    /**
+     * Cleans up stale session entries that haven't been seen recently.
+     *
+     * This private method is called periodically to remove sessions that haven't
+     * sent any requests within the timeout period (5 minutes by default). When
+     * a session is removed, it publishes a 'session-disconnected' event to notify
+     * other services about the disconnection.
+     *
+     * This prevents memory leaks from accumulating disconnected sessions and ensures
+     * that the session registry only contains active connections.
+     *
+     * @private
+     */
+    private cleanup;
+}
+export declare const sessionTrackerService: SessionTrackerService;
+export type { SessionTrackerService };
+//# sourceMappingURL=session-tracker.service.d.ts.map

package/dist/server/src/services/session-tracker.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tracker.service.d.ts","sourceRoot":"","sources":["../../../../src/services/session-tracker.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,WAAW,EACZ,MAAM,wCAAwC,CAAC;AAMhD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,cAAM,qBAAqB;IACzB,OAAO,CAAC,QAAQ,CAAuC;IAEvD,OAAO,KAAK,UAAU,GAErB;IAED;;;;;OAKG;;IAMH;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACI,aAAa,CAAC,OAAO,EAAE,cAAc;IA0B5C;;;;;;;;;;;;;;OAcG;IACI,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE;IAQjE;;;;;;;;;;;;OAYG;IACI,WAAW,IAAI,WAAW,EAAE;IAInC;;;;;;;;;;;;;;OAcG;IACI,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7D;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,OAAO;CAkBhB;AAED,eAAO,MAAM,qBAAqB,uBAA8B,CAAC;AAEjE,YAAY,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/server/src/services/session-tracker.service.js

@@ -0,0 +1,176 @@
+import { logger, LOG_MODULES } from '../utils/logger.js';
+import { eventBus } from './event-bus.service.js';
+import { configManager } from '../config/config-manager.js';
+import { formatDuration } from '../utils/format-utils.js';
+/**
+ * Session tracking service that manages session connections and their metadata.
+ *
+ * This service maintains a registry of connected sessions (typically IDEs or other
+ * MCP clients) and tracks their connection state, metadata, and workspace roots.
+ * It provides automatic cleanup of stale sessions after a timeout period and
+ * publishes connection/disconnection events via the event bus.
+ *
+ * The service is primarily used by the MCP session manager to track which sessions
+ * are connected and maintain their context information for proper session management.
+ *
+ * @example
+ * // Update session information when a new connection is established
+ * sessionTrackerService.updateSession({
+ *   sessionId: 'session-123',
+ *   clientName: 'VS Code',
+ *   clientVersion: '1.85.0',
+ *   cwd: '/home/user/project'
+ * });
+ *
+ * // Get all currently connected sessions
+ * const sessions = sessionTrackerService.getSessions();
+ */
+class SessionTrackerService {
+    sessions = new Map();
+    // Use the same timeout as session manager (default 30 minutes)
+    get TIMEOUT_MS() {
+        return configManager.getConfig().security.sessionTimeout;
+    }
+    /**
+     * Creates a new session tracker service instance.
+     *
+     * Initializes the service with automatic periodic cleanup of stale sessions
+     * every 60 seconds to prevent memory leaks from disconnected sessions.
+     */
+    constructor() {
+        // Periodic cleanup
+        setInterval(() => this.cleanup(), 60000);
+    }
+    /**
+     * Updates or creates a session entry with the provided context information.
+     *
+     * This method is called whenever a session sends a request with context information.
+     * It preserves existing session metadata that isn't provided in the new context,
+     * ensuring that sessions don't lose their previously established information.
+     *
+     * If this is a new session (not previously tracked), it publishes a 'session-connected'
+     * event to notify other services about the new connection.
+     *
+     * @param context - The session context containing session ID and optional metadata
+     * @param context.sessionId - Unique identifier for the session
+     * @param context.clientName - Optional name of the client application
+     * @param context.clientVersion - Optional version of the client application
+     * @param context.protocolVersion - Optional MCP protocol version
+     * @param context.userAgent - Optional user agent string
+     * @param context.ip - Optional session IP address
+     *
+     * @example
+     * sessionTrackerService.updateSession({
+     *   sessionId: 'session-123',
+     *   clientName: 'VS Code',
+     *   clientVersion: '1.85.0'
+     * });
+     */
+    updateSession(context) {
+        const existing = this.sessions.get(context.sessionId);
+        const sessionInfo = {
+            ...context,
+            // Preserve existing info if not provided in new request
+            clientName: context.clientName || existing?.clientName,
+            clientVersion: context.clientVersion || existing?.clientVersion,
+            protocolVersion: context.protocolVersion || existing?.protocolVersion,
+            capabilities: context.capabilities || existing?.capabilities,
+            userAgent: context.userAgent || existing?.userAgent,
+            ip: context.ip || existing?.ip,
+            lastSeen: Date.now(),
+            roots: existing?.roots // Preserve roots if already fetched
+        };
+        this.sessions.set(context.sessionId, sessionInfo);
+        // If it's a new session, publish connection event
+        if (!existing) {
+            eventBus.publish('session-connected', {
+                timestamp: Date.now(),
+                session: sessionInfo
+            });
+        }
+    }
+    /**
+     * Updates the workspace roots for a specific session.
+     *
+     * This method is typically called when a session provides its workspace root
+     * directories.
+     *
+     * @param sessionId - The unique session identifier for the session
+     * @param roots - Array of session root objects containing URI information
+     *
+     * @example
+     * sessionTrackerService.updateSessionRoots('session-123', [
+     *   { uri: 'file:///home/user/project' },
+     *   { uri: 'file:///home/user/other-project' }
+     * ]);
+     */
+    updateSessionRoots(sessionId, roots) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.roots = roots;
+            session.lastSeen = Date.now();
+        }
+    }
+    /**
+     * Retrieves all currently tracked session information.
+     *
+     * Returns an array of all active session info objects, including their metadata
+     * and connection state. This is useful for monitoring all connected sessions
+     * or displaying session information in administrative interfaces.
+     *
+     * @returns Array of SessionInfo objects representing all tracked sessions
+     *
+     * @example
+     * const allSessions = sessionTrackerService.getSessions();
+     * console.log(`Currently tracking ${allSessions.length} sessions`);
+     */
+    getSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /**
+     * Retrieves session information for a specific session ID.
+     *
+     * Returns the complete session info object for the given session ID, or undefined
+     * if no session with that session ID is currently being tracked.
+     *
+     * @param sessionId - The unique session identifier to look up
+     * @returns SessionInfo object if found, undefined otherwise
+     *
+     * @example
+     * const session = sessionTrackerService.getSession('session-123');
+     * if (session) {
+     *   console.log(`Session ${session.clientName} is connected`);
+     * }
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Cleans up stale session entries that haven't been seen recently.
+     *
+     * This private method is called periodically to remove sessions that haven't
+     * sent any requests within the timeout period (5 minutes by default). When
+     * a session is removed, it publishes a 'session-disconnected' event to notify
+     * other services about the disconnection.
+     *
+     * This prevents memory leaks from accumulating disconnected sessions and ensures
+     * that the session registry only contains active connections.
+     *
+     * @private
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [id, info] of this.sessions.entries()) {
+            if (now - info.lastSeen > this.TIMEOUT_MS) {
+                logger.debug(`Removing stale session: ${id}. Last seen ${formatDuration(now - info.lastSeen)} ago, timeout ${formatDuration(this.TIMEOUT_MS)}`, LOG_MODULES.SESSION_TRACKER);
+                this.sessions.delete(id);
+                eventBus.publish('session-disconnected', {
+                    timestamp: Date.now(),
+                    sessionId: id,
+                    session: info
+                });
+            }
+        }
+    }
+}
+export const sessionTrackerService = new SessionTrackerService();

package/dist/server/src/services/system-tool-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-tool-handler.d.ts","sourceRoot":"","sources":["../../../../src/services/system-tool-handler.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;WACU,oBAAoB,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,OAAO,CAAC;CAwEpB"}
+{"version":3,"file":"system-tool-handler.d.ts","sourceRoot":"","sources":["../../../../src/services/system-tool-handler.ts"],"names":[],"mappings":"AAoBA;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;WACU,oBAAoB,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,OAAO,CAAC;CA8DpB"}

package/dist/server/src/services/system-tool-handler.js

@@ -1,7 +1,7 @@
 import { hubToolsService } from './hub-tools.service.js';
 import { McpError } from '@modelcontextprotocol/sdk/types.js';
 import { logger, LOG_MODULES } from '../utils/logger.js';
-import { LIST_SERVERS_TOOL, FIND_SERVERS_TOOL, LIST_ALL_TOOLS_IN_SERVER_TOOL, FIND_TOOLS_IN_SERVER_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, FIND_TOOLS_TOOL, MCP_HUB_LITE_SERVER } from '../models/system-tools.constants.js';
+import { LIST_SERVERS_TOOL, LIST_TOOLS_IN_SERVER_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL, MCP_HUB_LITE_SERVER } from '../models/system-tools.constants.js';
 import { stringifyForLogging } from '../utils/json-utils.js';
 /**
  * Unified system tool call handler
@@ -18,19 +18,9 @@ export class SystemToolHandler {
                 case LIST_SERVERS_TOOL:
                     result = await hubToolsService.listServers();
                     break;
-                case FIND_SERVERS_TOOL: {
-                    const findServersArgs = toolArgs;
-                    result = await hubToolsService.findServers(findServersArgs);
-                    break;
-                }
-                case LIST_ALL_TOOLS_IN_SERVER_TOOL: {
-                    const listAllToolsArgs = toolArgs;
-                    result = await hubToolsService.listAllToolsInServer(listAllToolsArgs);
-                    break;
-                }
-                case FIND_TOOLS_IN_SERVER_TOOL: {
-                    const findToolsInServerArgs = toolArgs;
-                    result = await hubToolsService.findToolsInServer(findToolsInServerArgs);
+                case LIST_TOOLS_IN_SERVER_TOOL: {
+                    const listToolsArgs = toolArgs;
+                    result = await hubToolsService.listToolsInServer(listToolsArgs);
                     break;
                 }
                 case GET_TOOL_TOOL: {
@@ -50,9 +40,9 @@ export class SystemToolHandler {
                     });
                     break;
                 }
-                case FIND_TOOLS_TOOL: {
-                    const findToolsArgs = toolArgs;
-                    result = await hubToolsService.findTools(findToolsArgs);
+                case UPDATE_SERVER_DESCRIPTION_TOOL: {
+                    const updateDescArgs = toolArgs;
+                    result = await hubToolsService.updateServerDescription(updateDescArgs);
                     break;
                 }
                 default:

package/dist/server/src/utils/composite-key.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Composite key utilities for server instance identification
+ *
+ * This module provides utilities for generating and parsing composite keys
+ * that uniquely identify a server instance across multiple instances
+ * of the same server name.
+ *
+ * Format: `${serverName}-${serverIndex}`
+ * Example: 'my-server-0', 'my-server-1', 'test-server-0'
+ */
+/**
+ * Generates a composite key from serverName and serverIndex
+ * @param serverName - The server name
+ * @param serverIndex - The instance index
+ * @returns Composite key string
+ * @example getCompositeKey('my-server', 0) => 'my-server-0'
+ */
+export declare function getCompositeKey(serverName: string, serverIndex: number): string;
+/**
+ * Parses a composite key back into serverName and serverIndex
+ * @param key - The composite key to parse
+ * @returns Object with serverName and serverIndex, or null if invalid
+ * @example parseCompositeKey('my-server-0') => { serverName: 'my-server', serverIndex: 0 }
+ */
+export declare function parseCompositeKey(key: string): {
+    serverName: string;
+    serverIndex: number;
+} | null;
+//# sourceMappingURL=composite-key.d.ts.map

package/dist/server/src/utils/composite-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-key.d.ts","sourceRoot":"","sources":["../../../../src/utils/composite-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAYjG"}

package/dist/server/src/utils/composite-key.js

@@ -0,0 +1,39 @@
+/**
+ * Composite key utilities for server instance identification
+ *
+ * This module provides utilities for generating and parsing composite keys
+ * that uniquely identify a server instance across multiple instances
+ * of the same server name.
+ *
+ * Format: `${serverName}-${serverIndex}`
+ * Example: 'my-server-0', 'my-server-1', 'test-server-0'
+ */
+/**
+ * Generates a composite key from serverName and serverIndex
+ * @param serverName - The server name
+ * @param serverIndex - The instance index
+ * @returns Composite key string
+ * @example getCompositeKey('my-server', 0) => 'my-server-0'
+ */
+export function getCompositeKey(serverName, serverIndex) {
+    return `${serverName}-${serverIndex}`;
+}
+/**
+ * Parses a composite key back into serverName and serverIndex
+ * @param key - The composite key to parse
+ * @returns Object with serverName and serverIndex, or null if invalid
+ * @example parseCompositeKey('my-server-0') => { serverName: 'my-server', serverIndex: 0 }
+ */
+export function parseCompositeKey(key) {
+    const lastDashIndex = key.lastIndexOf('-');
+    if (lastDashIndex === -1) {
+        return null;
+    }
+    const serverName = key.slice(0, lastDashIndex);
+    const serverIndexPart = key.slice(lastDashIndex + 1);
+    const serverIndex = parseInt(serverIndexPart, 10);
+    if (isNaN(serverIndex)) {
+        return null;
+    }
+    return { serverName, serverIndex };
+}

package/dist/server/src/utils/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../../src/utils/error-handler.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK;IAgBrE;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK;IA6BzF;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK;CAWlE"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../../src/utils/error-handler.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK;IAgBrE;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK;IA6BzF;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK;CAWlE"}

package/dist/server/src/utils/error-handler.js

@@ -1,5 +1,6 @@
 import { McpError } from '@modelcontextprotocol/sdk/types.js';
-import { logger, LOG_MODULES } from './logger.js';
+import { logger } from './logger.js';
+import { LOG_MODULES } from './logger/log-modules.js';
 /**
  * Unified error handler
  */
@@ -45,7 +46,7 @@ export class ErrorHandler {
      * Handles general errors
      */
     static handleGeneralError(error, message) {
-        logger.error(message, error);
+        logger.error(message, error, LOG_MODULES.ERROR_HANDLER);
         if (error instanceof McpError) {
             throw error;
         }

package/dist/server/src/utils/index.d.ts

@@ -1,2 +1,4 @@
 export { logger, LOG_MODULES } from './logger.js';
+export * from './sort-utils.js';
+export * from './version.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/server/src/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClD,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/server/src/utils/index.js

@@ -1 +1,3 @@
 export { logger, LOG_MODULES } from './logger.js';
+export * from './sort-utils.js';
+export * from './version.js';

package/dist/server/src/utils/instance-id.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Instance ID generation utilities using content-based hashing.
+ */
+import type { ServerInstance } from '../config/config.schema.js';
+/**
+ * Generates a stable 8-character hash from an object.
+ * Uses SHA-256 and returns the first 8 hex characters.
+ *
+ * @param obj - The object to hash
+ * @returns An 8-character hex string
+ */
+export declare function generateInstanceHash(obj: Record<string, unknown>): string;
+/**
+ * Generates a deterministic instance ID based on server name and instance configuration.
+ * The ID format is: ${serverName}-${hash}
+ *
+ * @param serverName - Name of the server
+ * @param instanceConfig - Partial instance configuration
+ * @returns A deterministic instance ID
+ */
+export declare function generateInstanceId(serverName: string, instanceConfig: Partial<ServerInstance>): string;
+//# sourceMappingURL=instance-id.d.ts.map

package/dist/server/src/utils/instance-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-id.d.ts","sourceRoot":"","sources":["../../../../src/utils/instance-id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAyBzE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,GACtC,MAAM,CAiBR"}

package/dist/server/src/utils/instance-id.js

@@ -0,0 +1,59 @@
+/**
+ * Instance ID generation utilities using content-based hashing.
+ */
+import { createHash } from 'node:crypto';
+/**
+ * Generates a stable 8-character hash from an object.
+ * Uses SHA-256 and returns the first 8 hex characters.
+ *
+ * @param obj - The object to hash
+ * @returns An 8-character hex string
+ */
+export function generateInstanceHash(obj) {
+    function stableStringify(value) {
+        if (value === null || typeof value !== 'object') {
+            return JSON.stringify(value);
+        }
+        if (Array.isArray(value)) {
+            return '[' + value.map(stableStringify).join(',') + ']';
+        }
+        const sortedObj = {};
+        for (const key of Object.keys(value).sort()) {
+            sortedObj[key] = value[key];
+        }
+        return ('{' +
+            Object.keys(sortedObj)
+                .map((key) => JSON.stringify(key) + ':' + stableStringify(sortedObj[key]))
+                .join(',') +
+            '}');
+    }
+    const stableString = stableStringify(obj);
+    const hash = createHash('sha256');
+    hash.update(stableString);
+    return hash.digest('hex').slice(0, 8);
+}
+/**
+ * Generates a deterministic instance ID based on server name and instance configuration.
+ * The ID format is: ${serverName}-${hash}
+ *
+ * @param serverName - Name of the server
+ * @param instanceConfig - Partial instance configuration
+ * @returns A deterministic instance ID
+ */
+export function generateInstanceId(serverName, instanceConfig) {
+    const hashableContent = {};
+    if (instanceConfig.args && instanceConfig.args.length > 0) {
+        hashableContent.args = instanceConfig.args;
+    }
+    if (instanceConfig.env) {
+        hashableContent.env = instanceConfig.env;
+    }
+    if (instanceConfig.headers) {
+        hashableContent.headers = instanceConfig.headers;
+    }
+    if (instanceConfig.tags && Object.keys(instanceConfig.tags).length > 0) {
+        hashableContent.tags = instanceConfig.tags;
+    }
+    const hash = generateInstanceHash(hashableContent);
+    return `${serverName}-${hash}`;
+}

package/dist/server/src/utils/json-utils.d.ts

@@ -23,7 +23,7 @@ type ConfigGetter = () => {
         logging: {
             jsonPretty: boolean;
             mcpCommDebug: boolean;
-            sessionDebug: boolean;
+            apiDebug: boolean;
         };
     };
 };
@@ -60,11 +60,11 @@ export declare function getJsonPrettySetting(): boolean;
  */
 export declare function getMcpCommDebugSetting(): boolean;
 /**
- * Get session debug setting from config getter.
+ * Get API debug setting from config getter.
  *
- * @returns boolean indicating whether to enable session debug logging
+ * @returns boolean indicating whether to enable API debug logging
  */
-export declare function getSessionDebugSetting(): boolean;
+export declare function getApiDebugSetting(): boolean;
 /**
  * Stringify object for logging with dynamic pretty formatting based on LOG_JSON_PRETTY environment variable
  * @param obj Object to stringify

package/dist/server/src/utils/json-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-utils.d.ts","sourceRoot":"","sources":["../../../../src/utils/json-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAiED;;GAEG;AACH,KAAK,YAAY,GAAG,MAAM;IACxB,MAAM,EAAE;QACN,OAAO,EAAE;YACP,UAAU,EAAE,OAAO,CAAC;YACpB,YAAY,EAAE,OAAO,CAAC;YACtB,YAAY,EAAE,OAAO,CAAC;SACvB,CAAC;KACH,CAAC;CACH,CAAC;AAQF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU/E;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAG1E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAU9C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAUhD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAUhD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAOxD;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,OAAO,EACZ,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,GAClD,MAAM,CAOR"}
+{"version":3,"file":"json-utils.d.ts","sourceRoot":"","sources":["../../../../src/utils/json-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAiED;;GAEG;AACH,KAAK,YAAY,GAAG,MAAM;IACxB,MAAM,EAAE;QACN,OAAO,EAAE;YACP,UAAU,EAAE,OAAO,CAAC;YACpB,YAAY,EAAE,OAAO,CAAC;YACtB,QAAQ,EAAE,OAAO,CAAC;SACnB,CAAC;KACH,CAAC;CACH,CAAC;AAQF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU/E;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAG1E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAiB9C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAUhD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAU5C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAOxD;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,OAAO,EACZ,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,GAClD,MAAM,CAOR"}

package/dist/server/src/utils/json-utils.js

@@ -130,6 +130,12 @@ export function stringifyRawHeadersForLogging(rawHeaders) {
  * @returns boolean indicating whether to use pretty JSON formatting
  */
 export function getJsonPrettySetting() {
+    // Check environment variable first (highest priority)
+    const envValue = process.env.LOG_JSON_PRETTY;
+    if (envValue !== undefined) {
+        return envValue === 'true' || envValue === '1';
+    }
+    // Then check config getter
     if (_configGetter) {
         try {
             const config = _configGetter();
@@ -159,15 +165,15 @@ export function getMcpCommDebugSetting() {
     return getDefaultForDevMode(false);
 }
 /**
- * Get session debug setting from config getter.
+ * Get API debug setting from config getter.
  *
- * @returns boolean indicating whether to enable session debug logging
+ * @returns boolean indicating whether to enable API debug logging
  */
-export function getSessionDebugSetting() {
+export function getApiDebugSetting() {
     if (_configGetter) {
         try {
             const config = _configGetter();
-            return config.system.logging.sessionDebug;
+            return config.system.logging.apiDebug;
         }
         catch {
             // Fall through to default if config getter fails

package/dist/server/src/utils/logger/dev-logger.d.ts

@@ -3,7 +3,8 @@
  * This file contains development log initialization and management.
  */
 import fs from 'fs';
-import { LogRotator, type RotatorConfig } from '../log-rotator.js';
+import { LogRotator } from '../log-rotator.js';
+import type { RotatorConfig } from '../log-rotator.js';
 /**
  * Development logger configuration and setup.
  */

package/dist/server/src/utils/logger/dev-logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-logger.d.ts","sourceRoot":"","sources":["../../../../../src/utils/logger/dev-logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,aAAa,CAA2B;IAEhD;;OAEG;IACH,IAAI,MAAM,IAAI,EAAE,CAAC,WAAW,GAAG,IAAI,CAElC;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,UAAU,GAAG,IAAI,CAE/B;IAED;;;;;;;;;;OAUG;IACH,YAAY,CAAC,aAAa,CAAC,EAAE,aAAa,EAAE,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAoB/F;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd"}
+{"version":3,"file":"dev-logger.d.ts","sourceRoot":"","sources":["../../../../../src/utils/logger/dev-logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,aAAa,CAA2B;IAEhD;;OAEG;IACH,IAAI,MAAM,IAAI,EAAE,CAAC,WAAW,GAAG,IAAI,CAElC;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,UAAU,GAAG,IAAI,CAE/B;IAED;;;;;;;;;;OAUG;IACH,YAAY,CAAC,aAAa,CAAC,EAAE,aAAa,EAAE,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAoB/F;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd"}

package/dist/server/src/utils/logger/log-colors.d.ts

@@ -12,6 +12,7 @@ export declare const COLORS: {
     readonly gray: "\u001B[90m";
     readonly brightCyan: "\u001B[96m";
     readonly brightMagenta: "\u001B[95m";
+    readonly brightBlue: "\u001B[94m";
 };
 /**
  * Get color code for a specific log level.

package/dist/server/src/utils/logger/log-colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-colors.d.ts","sourceRoot":"","sources":["../../../../../src/utils/logger/log-colors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAG9D,eAAO,MAAM,MAAM;;;;;;;;;CAST,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAa5D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}
+{"version":3,"file":"log-colors.d.ts","sourceRoot":"","sources":["../../../../../src/utils/logger/log-colors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAG9D,eAAO,MAAM,MAAM;;;;;;;;;;CAUT,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAa5D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}