@loop_ouroboros/mcp-hub-lite 1.3.0 → 1.3.1

package/dist/server/src/utils/logger/log-output.js

@@ -87,9 +87,29 @@ export function logNotificationMessage(message, context, serverId) {
         logStorage.append(serverId, logLevel, `[${serverName}] ${messageContent}`);
     }
 }
+/**
+ * Check if JSON string contains data:image/*;base64 data URIs.
+ * These commonly appear in serverInfo.icons[].src and other metadata fields.
+ *
+ * @param data - JSON string to check
+ * @returns true if it contains data:image data URIs
+ */
+export function hasDataUriImage(data) {
+    return /data:image\/[^;]+;base64,/.test(data);
+}
+/**
+ * Simplify data URI images by replacing base64 payload with placeholder.
+ * Matches all data:image/*;base64,... patterns and truncates the payload.
+ *
+ * @param data - JSON string containing data URIs
+ * @returns JSON string with base64 payloads replaced
+ */
+export function simplifyDataUriImages(data) {
+    return data.replace(/(data:image\/[^;]+;base64,)[A-Za-z0-9+/=]+/g, '$1[Truncated]');
+}
 /**
  * Format an MCP message for logging, with simplification for tools/list,
- * resources/list, capabilities responses, and image content.
+ * resources/list, capabilities responses, image content, and data URI images.
  *
  * @param message - The MCP message object to format
  * @returns Formatted log message string
@@ -101,8 +121,20 @@ export function formatMcpMessageForLogging(message) {
         if (isToolsListResponse(rawJson)) {
             const simplified = simplifyToolsListResponse(rawJson);
             if (simplified === null) {
-                // Could not simplify, use pretty JSON formatting
-                logMessage = stringifyForLogging(message);
+                // Could not simplify, fall through to other checks
+                if (hasDataUriImage(rawJson)) {
+                    const truncated = simplifyDataUriImages(rawJson);
+                    try {
+                        const parsed = JSON.parse(truncated);
+                        logMessage = stringifyForLogging(parsed);
+                    }
+                    catch {
+                        logMessage = truncated;
+                    }
+                }
+                else {
+                    logMessage = stringifyForLogging(message);
+                }
             }
             else {
                 logMessage = simplified;
@@ -118,6 +150,16 @@ export function formatMcpMessageForLogging(message) {
                 logMessage = simplified;
             }
         }
+        else if (hasDataUriImage(rawJson)) {
+            const simplified = simplifyDataUriImages(rawJson);
+            try {
+                const parsed = JSON.parse(simplified);
+                logMessage = stringifyForLogging(parsed);
+            }
+            catch {
+                logMessage = simplified;
+            }
+        }
         else {
             logMessage = stringifyForLogging(message);
         }
@@ -192,7 +234,7 @@ export function simplifyImageContent(data) {
                                 'data' in item) {
                                 return {
                                     ...item,
-                                    data: '[BinaryImageData]'
+                                    data: '[Truncated]'
                                 };
                             }
                             return item;
@@ -243,14 +285,6 @@ export function isToolsListResponse(data) {
                     if ('resources' in result) {
                         return true;
                     }
-                    if ('capabilities' in result &&
-                        typeof result.capabilities === 'object' &&
-                        result.capabilities !== null) {
-                        const capabilities = result.capabilities;
-                        if ('tools' in capabilities || 'resources' in capabilities) {
-                            return true;
-                        }
-                    }
                 }
             }
         }
@@ -301,34 +335,6 @@ export function simplifyToolsListResponse(data) {
                         // No resources, don't simplify
                         return null;
                     }
-                    if ('capabilities' in result &&
-                        typeof result.capabilities === 'object' &&
-                        result.capabilities !== null) {
-                        const capabilities = result.capabilities;
-                        let toolsCount = 0;
-                        let resourcesCount = 0;
-                        if ('tools' in capabilities &&
-                            typeof capabilities.tools === 'object' &&
-                            capabilities.tools !== null) {
-                            toolsCount = Object.keys(capabilities.tools).length;
-                        }
-                        if ('resources' in capabilities &&
-                            typeof capabilities.resources === 'object' &&
-                            capabilities.resources !== null) {
-                            resourcesCount = Object.keys(capabilities.resources).length;
-                        }
-                        if (toolsCount > 0 && resourcesCount > 0) {
-                            return `Returned ${toolsCount} tools and ${resourcesCount} resources`;
-                        }
-                        else if (toolsCount > 0) {
-                            return `Returned ${toolsCount} tools`;
-                        }
-                        else if (resourcesCount > 0) {
-                            return `Returned ${resourcesCount} resources`;
-                        }
-                        // No tools or resources, don't simplify
-                        return null;
-                    }
                 }
             }
         }

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../../src/utils/logger/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAc5C,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,SAAS,CAA8B;gBAEnC,KAAK,GAAE,QAAiB;IAoBpC;;;;;;;;;OASG;IACI,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIzC;;;;;;;;;;;;OAYG;IACI,YAAY,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAO5E,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAIvC;;;;;;;;;OASG;IACI,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAItC;;;OAGG;IACH,SAAS,CAAC,YAAY,EAAE,QAAQ,GAAG,OAAO;IAK1C;;OAEG;IACH,OAAO,CAAC,GAAG;IAuDX;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAKhD;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAK/C;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAK/C;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAKhD,OAAO,CAAC,qBAAqB;IAkB7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B;;;OAGG;IACH,SAAS,CACP,KAAK,EAAE,QAAQ,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,GACvC,IAAI;IAuBP;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAuD3B;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM;IAIvF;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM;IAIhF;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAInC;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAInC;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAIvC;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAG/B"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../../src/utils/logger/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAmB5C,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,SAAS,CAA8B;gBAEnC,KAAK,GAAE,QAAiB;IAoBpC;;;;;;;;;OASG;IACI,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIzC;;;;;;;;;;;;OAYG;IACI,YAAY,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAO5E,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAIvC;;;;;;;;;OASG;IACI,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAItC;;;OAGG;IACH,SAAS,CAAC,YAAY,EAAE,QAAQ,GAAG,OAAO;IAK1C;;OAEG;IACH,OAAO,CAAC,GAAG;IA8DX;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAKhD;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAK/C;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAK/C;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAKhD,OAAO,CAAC,qBAAqB;IAkB7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B;;;OAGG;IACH,SAAS,CACP,KAAK,EAAE,QAAQ,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,GACvC,IAAI;IAuBP;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA6D3B;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM;IAIvF;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM;IAIhF;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAInC;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAInC;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAIvC;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAG/B"}

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

@@ -30,7 +30,8 @@
 import { DevLogger } from './dev-logger.js';
 import { LOG_MODULES } from './log-modules.js';
 import { createColoredLogMessage, createLogMessage, formatError, formatTimestamp, formatLogLevel, formatPid, getCallerInfo, formatCallerInfo } from './log-formatter.js';
-import { setDevModeEnabled } from '../json-utils.js';
+import { setDevModeEnabled, getShowTraceContextSetting } from '../json-utils.js';
+import { getTraceIdFromContext, getSessionIdFromContext, isInRequestContext } from '../request-context.js';
 export class Logger {
     level = 'info';
     useStderr = false;
@@ -124,9 +125,17 @@ export class Logger {
         // Build context object
         const context = {
             ...(options?.module && { module: options.module }),
+            ...(options?.sessionId && { sessionId: options.sessionId }),
             ...(options?.traceId && { traceId: options.traceId }),
             ...(options?.spanId && { spanId: options.spanId })
         };
+        // Auto-inject trace context from ALS when showTraceContext enabled
+        if (getShowTraceContextSetting() && isInRequestContext()) {
+            if (!context.sessionId)
+                context.sessionId = getSessionIdFromContext() || '-';
+            if (!context.traceId)
+                context.traceId = getTraceIdFromContext() || '-';
+        }
         // Add caller info if enabled
         if (this.showCaller) {
             const callerInfo = getCallerInfo(4); // Skip 4 frames to get to the actual caller
@@ -241,7 +250,7 @@ export class Logger {
         const optionsIndex = args.findIndex((arg) => typeof arg === 'object' &&
             arg !== null &&
             !Array.isArray(arg) &&
-            ('module' in arg || 'traceId' in arg || 'spanId' in arg));
+            ('module' in arg || 'sessionId' in arg || 'traceId' in arg || 'spanId' in arg));
         if (optionsIndex !== -1) {
             const options = args[optionsIndex];
             const restArgs = [...args.slice(0, optionsIndex), ...args.slice(optionsIndex + 1)];
@@ -287,6 +296,13 @@ export class Logger {
             ...context,
             serverName
         };
+        // Auto-inject trace context from ALS when showTraceContext enabled
+        if (getShowTraceContextSetting() && isInRequestContext()) {
+            if (!logContext.sessionId)
+                logContext.sessionId = getSessionIdFromContext() || '-';
+            if (!logContext.traceId)
+                logContext.traceId = getTraceIdFromContext() || '-';
+        }
         // Add caller info if enabled (only once per serverLog call would be better,
         // but for consistency with multi-line logging, we add it for each line)
         if (this.showCaller) {

package/dist/server/src/utils/request-context.d.ts

@@ -1,71 +1,9 @@
-/**
- * Request context management using AsyncLocalStorage for request-scoped data.
- *
- * This module provides a way to store and access request-specific context data
- * across asynchronous operations without having to pass context objects through
- * every function call. It uses Node.js AsyncLocalStorage to maintain context
- * throughout the request lifecycle.
- *
- * The primary use case is storing session context information (sessionId, clientName,
- * cwd, project, etc.) that needs to be accessible from any part of the application
- * during request processing.
- *
- * @module utils/request-context
- */
-import { AsyncLocalStorage } from 'async_hooks';
-import type { SessionContext } from '../../shared/types/session-context.types.js';
-/**
- * AsyncLocalStorage instance for storing request context.
- *
- * This storage holds the SessionContext object for the current request and
- * makes it available throughout the entire request processing chain,
- * including asynchronous operations and nested function calls.
- *
- * @example
- * ```typescript
- * // In route handler
- * await requestContext.run(sessionContext, async () => {
- *   // Any code executed here can access the session context
- *   const ctx = getSessionContext();
- *   console.log(ctx.sessionId);
- * });
- * ```
- */
-export declare const requestContext: AsyncLocalStorage<SessionContext>;
-/**
- * Retrieves the current request's session context.
- *
- * This function returns the SessionContext object stored in the AsyncLocalStorage
- * for the current request. It should only be called within a request context
- * that has been established using requestContext.run().
- *
- * @returns {SessionContext | undefined} The current request's session context, or undefined if not in a request context
- *
- * @example
- * ```typescript
- * const context = getSessionContext();
- * if (context) {
- *   console.log(`Processing request for session: ${context.sessionId}`);
- * }
- * ```
- */
-export declare function getSessionContext(): SessionContext | undefined;
-/**
- * Retrieves the current request's working directory (cwd).
- *
- * This is a convenience function that extracts the cwd property from the
- * current request's session context. It's commonly used in file operations
- * that need to respect the session's current working directory.
- *
- * @returns {string | undefined} The current request's working directory, or undefined if not available
- *
- * @example
- * ```typescript
- * const cwd = getSessionCwd();
- * if (cwd) {
- *   const fullPath = path.join(cwd, relativePath);
- * }
- * ```
- */
-export declare function getSessionCwd(): string | undefined;
+export interface RequestContext {
+    sessionId?: string;
+    traceId?: string;
+}
+export declare function runWithRequestContext(context: RequestContext, fn: () => Promise<void>): Promise<void>;
+export declare function getSessionIdFromContext(): string | undefined;
+export declare function getTraceIdFromContext(): string | undefined;
+export declare function isInRequestContext(): boolean;
 //# sourceMappingURL=request-context.d.ts.map

package/dist/server/src/utils/request-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../../../src/utils/request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,mCAA0C,CAAC;AAEtE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD"}
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../../../src/utils/request-context.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,SAAS,CAE5D;AAED,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAE1D;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C"}

package/dist/server/src/utils/request-context.js

@@ -1,73 +1,14 @@
-/**
- * Request context management using AsyncLocalStorage for request-scoped data.
- *
- * This module provides a way to store and access request-specific context data
- * across asynchronous operations without having to pass context objects through
- * every function call. It uses Node.js AsyncLocalStorage to maintain context
- * throughout the request lifecycle.
- *
- * The primary use case is storing session context information (sessionId, clientName,
- * cwd, project, etc.) that needs to be accessible from any part of the application
- * during request processing.
- *
- * @module utils/request-context
- */
 import { AsyncLocalStorage } from 'async_hooks';
-/**
- * AsyncLocalStorage instance for storing request context.
- *
- * This storage holds the SessionContext object for the current request and
- * makes it available throughout the entire request processing chain,
- * including asynchronous operations and nested function calls.
- *
- * @example
- * ```typescript
- * // In route handler
- * await requestContext.run(sessionContext, async () => {
- *   // Any code executed here can access the session context
- *   const ctx = getSessionContext();
- *   console.log(ctx.sessionId);
- * });
- * ```
- */
-export const requestContext = new AsyncLocalStorage();
-/**
- * Retrieves the current request's session context.
- *
- * This function returns the SessionContext object stored in the AsyncLocalStorage
- * for the current request. It should only be called within a request context
- * that has been established using requestContext.run().
- *
- * @returns {SessionContext | undefined} The current request's session context, or undefined if not in a request context
- *
- * @example
- * ```typescript
- * const context = getSessionContext();
- * if (context) {
- *   console.log(`Processing request for session: ${context.sessionId}`);
- * }
- * ```
- */
-export function getSessionContext() {
-    return requestContext.getStore();
+const als = new AsyncLocalStorage();
+export function runWithRequestContext(context, fn) {
+    return als.run(context, fn);
 }
-/**
- * Retrieves the current request's working directory (cwd).
- *
- * This is a convenience function that extracts the cwd property from the
- * current request's session context. It's commonly used in file operations
- * that need to respect the session's current working directory.
- *
- * @returns {string | undefined} The current request's working directory, or undefined if not available
- *
- * @example
- * ```typescript
- * const cwd = getSessionCwd();
- * if (cwd) {
- *   const fullPath = path.join(cwd, relativePath);
- * }
- * ```
- */
-export function getSessionCwd() {
-    return requestContext.getStore()?.cwd;
+export function getSessionIdFromContext() {
+    return als.getStore()?.sessionId;
+}
+export function getTraceIdFromContext() {
+    return als.getStore()?.traceId;
+}
+export function isInRequestContext() {
+    return als.getStore() !== undefined;
 }

package/dist/server/tests/unit/config/config.schema.test.js

@@ -218,7 +218,8 @@ describe('Config Schema (v1.1)', () => {
                         jsonPretty: true,
                         mcpCommDebug: false,
                         apiDebug: false,
-                        gatewayDebug: false
+                        gatewayDebug: false,
+                        showTraceContext: true
                     }
                 },
                 security: {

package/dist/server/tests/unit/server/runner.test.js

@@ -95,7 +95,8 @@ describe('Server Runner', () => {
                         jsonPretty: true,
                         mcpCommDebug: false,
                         apiDebug: false,
-                        gatewayDebug: false
+                        gatewayDebug: false,
+                        showTraceContext: true
                     }
                 },
                 security: {
@@ -136,7 +137,8 @@ describe('Server Runner', () => {
                         jsonPretty: true,
                         mcpCommDebug: false,
                         apiDebug: false,
-                        gatewayDebug: false
+                        gatewayDebug: false,
+                        showTraceContext: true
                     }
                 },
                 security: {
@@ -186,7 +188,8 @@ describe('Server Runner', () => {
                         jsonPretty: true,
                         mcpCommDebug: false,
                         apiDebug: false,
-                        gatewayDebug: false
+                        gatewayDebug: false,
+                        showTraceContext: true
                     }
                 },
                 security: {
@@ -241,7 +244,8 @@ describe('Server Runner', () => {
                         jsonPretty: true,
                         mcpCommDebug: false,
                         apiDebug: false,
-                        gatewayDebug: false
+                        gatewayDebug: false,
+                        showTraceContext: true
                     }
                 },
                 security: {
@@ -359,7 +363,8 @@ describe('Server Runner', () => {
                         jsonPretty: true,
                         mcpCommDebug: false,
                         apiDebug: false,
-                        gatewayDebug: false
+                        gatewayDebug: false,
+                        showTraceContext: true
                     }
                 },
                 security: {
@@ -414,7 +419,8 @@ describe('Server Runner', () => {
                         jsonPretty: true,
                         mcpCommDebug: false,
                         apiDebug: false,
-                        gatewayDebug: false
+                        gatewayDebug: false,
+                        showTraceContext: true
                     }
                 },
                 security: {
@@ -465,7 +471,8 @@ describe('Server Runner', () => {
                         jsonPretty: true,
                         mcpCommDebug: false,
                         apiDebug: false,
-                        gatewayDebug: false
+                        gatewayDebug: false,
+                        showTraceContext: true
                     }
                 },
                 security: {

package/dist/server/tests/unit/services/gateway-session-mode.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gateway-session-mode.test.d.ts.map

package/dist/server/tests/unit/services/gateway-session-mode.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-session-mode.test.d.ts","sourceRoot":"","sources":["../../../../../tests/unit/services/gateway-session-mode.test.ts"],"names":[],"mappings":""}

package/dist/server/tests/unit/services/gateway-session-mode.test.js

@@ -0,0 +1,174 @@
+import { describe, test, expect, beforeEach, vi } from 'vitest';
+import { SESSION_MODE_STATEFUL, SESSION_MODE_STATELESS } from '../../../shared/models/constants.js';
+// Mock configManager before importing the module under test
+const mockGetConfig = vi.fn();
+vi.mock('@config/config-manager.js', () => ({
+    configManager: {
+        getConfig: () => mockGetConfig()
+    }
+}));
+// We need to import resolveSessionMode from gateway.ts
+// It's exported from the module, but the module has side-effects (Fastify routes)
+// Use dynamic import after mocks are set up
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let resolveSessionMode;
+beforeEach(async () => {
+    vi.resetModules();
+    mockGetConfig.mockReset();
+    const mod = await import('../../../src/api/mcp/gateway.js');
+    resolveSessionMode = mod.resolveSessionMode;
+});
+function makeRequest(headers = {}) {
+    return { headers };
+}
+describe('resolveSessionMode', () => {
+    describe('request header override (highest priority)', () => {
+        test('x-mcp-session-mode: stateless overrides UA match', () => {
+            mockGetConfig.mockReturnValue({
+                system: {
+                    session: {
+                        sessionModeRules: { stateful: ['claude-code'], stateless: [] },
+                        defaultSessionMode: SESSION_MODE_STATEFUL
+                    }
+                }
+            });
+            const request = makeRequest({
+                'x-mcp-session-mode': SESSION_MODE_STATELESS,
+                'user-agent': 'claude-code/2.1.140 (cli)'
+            });
+            expect(resolveSessionMode(request)).toBe(SESSION_MODE_STATELESS);
+        });
+        test('x-mcp-session-mode: stateful overrides UA match', () => {
+            mockGetConfig.mockReturnValue({
+                system: {
+                    session: {
+                        sessionModeRules: { stateful: [], stateless: ['cherrystudio'] },
+                        defaultSessionMode: SESSION_MODE_STATELESS
+                    }
+                }
+            });
+            const request = makeRequest({
+                'x-mcp-session-mode': SESSION_MODE_STATEFUL,
+                'user-agent': 'CherryStudio/1.9.7'
+            });
+            expect(resolveSessionMode(request)).toBe(SESSION_MODE_STATEFUL);
+        });
+    });
+    describe('UA keyword matching', () => {
+        test('matches stateless pattern (case-insensitive)', () => {
+            mockGetConfig.mockReturnValue({
+                system: {
+                    session: {
+                        sessionModeRules: { stateful: [], stateless: ['cherrystudio'] },
+                        defaultSessionMode: SESSION_MODE_STATEFUL
+                    }
+                }
+            });
+            const request = makeRequest({
+                'user-agent': 'Mozilla/5.0 ... CherryStudio/1.9.7 Chrome/146.0.7680.188 Electron/41.2.1'
+            });
+            expect(resolveSessionMode(request)).toBe(SESSION_MODE_STATELESS);
+        });
+        test('matches stateless pattern with different casing in UA', () => {
+            mockGetConfig.mockReturnValue({
+                system: {
+                    session: {
+                        sessionModeRules: { stateful: [], stateless: ['cherrystudio'] },
+                        defaultSessionMode: SESSION_MODE_STATEFUL
+                    }
+                }
+            });
+            const request = makeRequest({ 'user-agent': 'CHERRYSTUDIO/1.9.7' });
+            expect(resolveSessionMode(request)).toBe(SESSION_MODE_STATELESS);
+        });
+        test('matches stateless pattern with different casing in rule', () => {
+            mockGetConfig.mockReturnValue({
+                system: {
+                    session: {
+                        sessionModeRules: { stateful: [], stateless: ['CherryStudio'] },
+                        defaultSessionMode: SESSION_MODE_STATEFUL
+                    }
+                }
+            });
+            const request = makeRequest({ 'user-agent': 'cherrystudio/1.9.7' });
+            expect(resolveSessionMode(request)).toBe(SESSION_MODE_STATELESS);
+        });
+        test('matches stateful pattern', () => {
+            mockGetConfig.mockReturnValue({
+                system: {
+                    session: {
+                        sessionModeRules: { stateful: ['claude-code'], stateless: [] },
+                        defaultSessionMode: SESSION_MODE_STATELESS
+                    }
+                }
+            });
+            const request = makeRequest({ 'user-agent': 'claude-code/2.1.140 (cli)' });
+            expect(resolveSessionMode(request)).toBe(SESSION_MODE_STATEFUL);
+        });
+        test('stateless rules checked before stateful (stateless wins on conflict)', () => {
+            mockGetConfig.mockReturnValue({
+                system: {
+                    session: {
+                        sessionModeRules: { stateful: ['claude'], stateless: ['claude-code'] },
+                        defaultSessionMode: SESSION_MODE_STATEFUL
+                    }
+                }
+            });
+            // "claude-code" matches both "claude" and "claude-code", but stateless checked first
+            const request = makeRequest({ 'user-agent': 'claude-code/2.1.140' });
+            expect(resolveSessionMode(request)).toBe(SESSION_MODE_STATELESS);
+        });
+    });
+    describe('default fallback', () => {
+        test('no matching UA falls back to defaultSessionMode', () => {
+            mockGetConfig.mockReturnValue({
+                system: {
+                    session: {
+                        sessionModeRules: { stateful: ['claude-code'], stateless: ['cherrystudio'] },
+                        defaultSessionMode: SESSION_MODE_STATEFUL
+                    }
+                }
+            });
+            const request = makeRequest({ 'user-agent': 'SomeUnknownClient/1.0' });
+            expect(resolveSessionMode(request)).toBe(SESSION_MODE_STATEFUL);
+        });
+        test('empty UA falls back to defaultSessionMode', () => {
+            mockGetConfig.mockReturnValue({
+                system: {
+                    session: {
+                        sessionModeRules: { stateful: ['claude-code'], stateless: [] },
+                        defaultSessionMode: SESSION_MODE_STATEFUL
+                    }
+                }
+            });
+            const request = makeRequest({});
+            expect(resolveSessionMode(request)).toBe(SESSION_MODE_STATEFUL);
+        });
+        test('no gateway config falls back to stateful (hardcoded default)', () => {
+            mockGetConfig.mockReturnValue({
+                system: {}
+            });
+            const request = makeRequest({ 'user-agent': 'SomeClient/1.0' });
+            expect(resolveSessionMode(request)).toBe(SESSION_MODE_STATEFUL);
+        });
+        test('no config at all falls back to stateful', () => {
+            mockGetConfig.mockReturnValue(null);
+            const request = makeRequest({ 'user-agent': 'SomeClient/1.0' });
+            expect(resolveSessionMode(request)).toBe(SESSION_MODE_STATEFUL);
+        });
+    });
+    describe('empty rules arrays', () => {
+        test('empty stateful and stateless arrays use default', () => {
+            mockGetConfig.mockReturnValue({
+                system: {
+                    session: {
+                        sessionModeRules: { stateful: [], stateless: [] },
+                        defaultSessionMode: SESSION_MODE_STATELESS
+                    }
+                }
+            });
+            const request = makeRequest({ 'user-agent': 'SomeClient/1.0' });
+            expect(resolveSessionMode(request)).toBe(SESSION_MODE_STATELESS);
+        });
+    });
+});

package/dist/server/tests/unit/services/hub-tools.service.test.js

@@ -776,10 +776,10 @@ describe('HubToolsService', () => {
             const result = await hubToolsService.readResource('hub://use-guide');
             // Assert
             expect(typeof result).toBe('string');
-            expect(result).toContain('# MCP Hub Lite Use Guide');
-            expect(result).toContain('Getting Started');
-            expect(result).toContain('Progressive Discovery Workflow');
-            expect(result).toContain('System Tools Reference');
+            expect(result).toContain('# MCP Hub Lite');
+            expect(result).toContain('快速上手');
+            expect(result).toContain('渐进式发现工作流');
+            expect(result).toContain('系统工具参考');
         });
         it('should throw error for invalid URI format', async () => {
             // Act & Assert