@cyanheads/pubmed-mcp-server 1.3.4 → 1.4.1

package/dist/utils/internal/errorHandler.js

@@ -5,6 +5,7 @@
  * offers static methods for consistent error processing, logging, and transformation.
  * @module src/utils/internal/errorHandler
  */
+import { SpanStatusCode, trace } from "@opentelemetry/api";
 import { BaseErrorCode, McpError } from "../../types-global/errors.js";
 import { generateUUID, sanitizeInputForLogging } from "../index.js";
 import { logger } from "./logger.js";
@@ -153,8 +154,9 @@ export class ErrorHandler {
         }
         const errorName = getErrorName(error);
         const errorMessage = getErrorMessage(error);
-        if (errorName in ERROR_TYPE_MAPPINGS) {
-            return ERROR_TYPE_MAPPINGS[errorName];
+        const mappedFromType = ERROR_TYPE_MAPPINGS[errorName];
+        if (mappedFromType) {
+            return mappedFromType;
         }
         for (const mapping of COMMON_ERROR_PATTERNS) {
             const regex = createSafeRegex(mapping.pattern);
@@ -172,6 +174,18 @@ export class ErrorHandler {
      * @returns The handled (and potentially transformed) error instance.
      */
     static handleError(error, options) {
+        // --- OpenTelemetry Integration ---
+        const activeSpan = trace.getActiveSpan();
+        if (activeSpan) {
+            if (error instanceof Error) {
+                activeSpan.recordException(error);
+            }
+            activeSpan.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+        // --- End OpenTelemetry Integration ---
         const { context = {}, operation, input, rethrow = false, errorCode: explicitErrorCode, includeStack = true, critical = false, errorMapper, } = options;
         const sanitizedInput = input !== undefined ? sanitizeInputForLogging(input) : undefined;
         const originalErrorName = getErrorName(error);
@@ -194,11 +208,15 @@ export class ErrorHandler {
             !(error instanceof McpError && error.details?.originalStack)) {
             consolidatedDetails.originalStack = originalStack;
         }
+        const cause = error instanceof Error ? error : undefined;
         if (error instanceof McpError) {
             loggedErrorCode = error.code;
             finalError = errorMapper
                 ? errorMapper(error)
-                : new McpError(error.code, error.message, consolidatedDetails);
+                : new McpError(error.code, error.message, {
+                    ...consolidatedDetails,
+                    cause,
+                });
         }
         else {
             loggedErrorCode =
@@ -206,7 +224,10 @@ export class ErrorHandler {
             const message = `Error in ${operation}: ${originalErrorMessage}`;
             finalError = errorMapper
                 ? errorMapper(error)
-                : new McpError(loggedErrorCode, message, consolidatedDetails);
+                : new McpError(loggedErrorCode, message, {
+                    ...consolidatedDetails,
+                    cause,
+                });
         }
         if (finalError !== error &&
             error instanceof Error &&
@@ -222,6 +243,7 @@ export class ErrorHandler {
             ? context.timestamp
             : new Date().toISOString();
         const logPayload = {
+            ...Object.fromEntries(Object.entries(context).filter(([key]) => key !== "requestId" && key !== "timestamp")),
             requestId: logRequestId,
             timestamp: logTimestamp,
             operation,
@@ -230,7 +252,6 @@ export class ErrorHandler {
             errorCode: loggedErrorCode,
             originalErrorType: originalErrorName,
             finalErrorType: getErrorName(finalError),
-            ...Object.fromEntries(Object.entries(context).filter(([key]) => key !== "requestId" && key !== "timestamp")),
         };
         if (finalError instanceof McpError && finalError.details) {
             logPayload.errorDetails = finalError.details;
@@ -244,7 +265,7 @@ export class ErrorHandler {
                 logPayload.stack = stack;
             }
         }
-        logger.error(`Error in ${operation}: ${finalError.message || originalErrorMessage}`, logPayload);
+        logger.error(finalError.message || originalErrorMessage, logPayload);
         if (rethrow) {
             throw finalError;
         }
@@ -333,3 +354,4 @@ export class ErrorHandler {
         }
     }
 }
+//# sourceMappingURL=errorHandler.js.map

package/dist/utils/internal/errorHandler.js.map

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

package/dist/utils/internal/index.d.ts

@@ -6,4 +6,6 @@
  */
 export * from "./errorHandler.js";
 export * from "./logger.js";
+export * from "./performance.js";
 export * from "./requestContext.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/internal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/internal/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/utils/internal/index.js

@@ -6,4 +6,6 @@
  */
 export * from "./errorHandler.js";
 export * from "./logger.js";
+export * from "./performance.js";
 export * from "./requestContext.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/internal/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

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

@@ -151,3 +151,4 @@ export declare class Logger {
  * Use this instance for all logging operations.
  */
 export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/internal/logger.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AA6CZ;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,mBAAmB,EACzB,UAAU,CAAC,EAAE,MAAM,KAChB,IAAI,CAAC;AA+CV;;;GAGG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,aAAa,CAAC,CAAiB;IACvC,OAAO,CAAC,iBAAiB,CAAC,CAAiB;IAC3C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAAC,CAAwB;IACtD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,mBAAmB,CAA+C;IAE1E,OAAO,CAAC,QAAQ,CAAC,uCAAuC,CAAQ;IAChE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAK;IAEnC,eAAe;IACf,OAAO;IAEP;;;;OAIG;IACU,UAAU,CAAC,KAAK,GAAE,WAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkHnE;;;OAGG;IACI,wBAAwB,CAC7B,MAAM,EAAE,qBAAqB,GAAG,SAAS,GACxC,IAAI;IAUP;;;OAGG;IACI,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IA4C5C;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAoClC;;;OAGG;WACW,WAAW,IAAI,MAAM;IAOnC;;;OAGG;WACW,eAAe,IAAI,IAAI;IAarC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;;;;;OAOG;IACH,OAAO,CAAC,GAAG;IA2DX,2CAA2C;IACpC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAIzD,0CAA0C;IACnC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAIxD,4CAA4C;IACrC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAI1D,6CAA6C;IACtC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAI3D;;;;;OAKG;IACI,KAAK,CACV,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,cAAc,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI;IAMP;;;;;OAKG;IACI,IAAI,CACT,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,cAAc,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI;IAMP;;;;;OAKG;IACI,KAAK,CACV,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,cAAc,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI;IAMP;;;;;OAKG;IACI,KAAK,CACV,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,cAAc,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI;IAMP;;;;;OAKG;IACI,KAAK,CACV,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,cAAc,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI;IAMP;;;;OAIG;IACI,cAAc,CACnB,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI;CAUR;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,QAAuB,CAAC"}

package/dist/utils/internal/logger.js

@@ -79,15 +79,18 @@ function createWinstonConsoleFormat() {
  * Supports file logging, conditional console logging, and MCP notifications.
  */
 export class Logger {
+    static instance;
+    winstonLogger;
+    interactionLogger;
+    initialized = false;
+    mcpNotificationSender;
+    currentMcpLevel = "info";
+    currentWinstonLevel = "info";
+    MCP_NOTIFICATION_STACK_TRACE_MAX_LENGTH = 1024;
+    LOG_FILE_MAX_SIZE = 5 * 1024 * 1024; // 5MB
+    LOG_MAX_FILES = 5;
     /** @private */
-    constructor() {
-        this.initialized = false;
-        this.currentMcpLevel = "info";
-        this.currentWinstonLevel = "info";
-        this.MCP_NOTIFICATION_STACK_TRACE_MAX_LENGTH = 1024;
-        this.LOG_FILE_MAX_SIZE = 5 * 1024 * 1024; // 5MB
-        this.LOG_MAX_FILES = 5;
-    }
+    constructor() { }
     /**
      * Initializes the Winston logger instance.
      * Should be called once at application startup.
@@ -312,6 +315,8 @@ export class Logger {
         if (mcpLevelSeverity[level] > mcpLevelSeverity[this.currentMcpLevel]) {
             return; // Do not log if message level is less severe than currentMcpLevel
         }
+        // The `@opentelemetry/instrumentation-winston` package automatically injects
+        // the active trace_id and span_id into logs, so manual injection is no longer needed.
         const logData = { ...context };
         const winstonLevel = mcpToWinstonLevel[level];
         if (error) {
@@ -438,3 +443,4 @@ export class Logger {
  * Use this instance for all logging operations.
  */
 export const logger = Logger.getInstance();
+//# sourceMappingURL=logger.js.map

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

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

package/dist/utils/internal/performance.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Provides a utility for performance monitoring of tool execution.
+ * This module introduces a higher-order function to wrap tool logic, measure its
+ * execution time, and log a structured metrics event.
+ * @module src/utils/internal/performance
+ */
+import { RequestContext } from "./requestContext.js";
+/**
+ * A higher-order function that wraps a tool's core logic to measure its performance
+ * and log a structured metrics event upon completion.
+ *
+ * @template T The expected return type of the tool's logic function.
+ * @param toolLogicFn - The asynchronous tool logic function to be executed and measured.
+ * @param context - The request context for the operation, used for logging and tracing.
+ * @param inputPayload - The input payload to the tool for size calculation.
+ * @returns A promise that resolves with the result of the tool logic function.
+ * @throws Re-throws any error caught from the tool logic function after logging the failure.
+ */
+export declare function measureToolExecution<T>(toolLogicFn: () => Promise<T>, context: RequestContext & {
+    toolName: string;
+}, inputPayload: unknown): Promise<T>;
+//# sourceMappingURL=performance.d.ts.map

package/dist/utils/internal/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../../src/utils/internal/performance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkBrD;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,WAAW,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC7B,OAAO,EAAE,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC9C,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,CAAC,CAAC,CAsEZ"}

package/dist/utils/internal/performance.js

@@ -0,0 +1,104 @@
+/**
+ * @fileoverview Provides a utility for performance monitoring of tool execution.
+ * This module introduces a higher-order function to wrap tool logic, measure its
+ * execution time, and log a structured metrics event.
+ * @module src/utils/internal/performance
+ */
+import { SpanStatusCode, trace } from "@opentelemetry/api";
+import { ATTR_CODE_FUNCTION, ATTR_CODE_NAMESPACE, } from "../telemetry/semconv.js";
+import { config } from "../../config/index.js";
+import { McpError } from "../../types-global/errors.js";
+import { logger } from "./logger.js";
+/**
+ * Calculates the size of a payload in bytes.
+ * @param payload - The payload to measure.
+ * @returns The size in bytes.
+ * @private
+ */
+function getPayloadSize(payload) {
+    if (!payload)
+        return 0;
+    try {
+        const stringified = JSON.stringify(payload);
+        return Buffer.byteLength(stringified, "utf8");
+    }
+    catch {
+        return 0; // Could not stringify
+    }
+}
+/**
+ * A higher-order function that wraps a tool's core logic to measure its performance
+ * and log a structured metrics event upon completion.
+ *
+ * @template T The expected return type of the tool's logic function.
+ * @param toolLogicFn - The asynchronous tool logic function to be executed and measured.
+ * @param context - The request context for the operation, used for logging and tracing.
+ * @param inputPayload - The input payload to the tool for size calculation.
+ * @returns A promise that resolves with the result of the tool logic function.
+ * @throws Re-throws any error caught from the tool logic function after logging the failure.
+ */
+export async function measureToolExecution(toolLogicFn, context, inputPayload) {
+    const tracer = trace.getTracer(config.openTelemetry.serviceName, config.openTelemetry.serviceVersion);
+    const { toolName } = context;
+    return tracer.startActiveSpan(`tool_execution:${toolName}`, async (span) => {
+        span.setAttributes({
+            [ATTR_CODE_FUNCTION]: toolName,
+            [ATTR_CODE_NAMESPACE]: "mcp-tools",
+            "mcp.tool.input_bytes": getPayloadSize(inputPayload),
+        });
+        const startTime = process.hrtime.bigint();
+        let isSuccess = false;
+        let errorCode;
+        let outputPayload;
+        try {
+            const result = await toolLogicFn();
+            isSuccess = true;
+            outputPayload = result;
+            span.setStatus({ code: SpanStatusCode.OK });
+            span.setAttribute("mcp.tool.output_bytes", getPayloadSize(outputPayload));
+            return result;
+        }
+        catch (error) {
+            if (error instanceof McpError) {
+                errorCode = error.code;
+            }
+            else if (error instanceof Error) {
+                errorCode = "UNHANDLED_ERROR";
+            }
+            else {
+                errorCode = "UNKNOWN_ERROR";
+            }
+            if (error instanceof Error) {
+                span.recordException(error);
+            }
+            span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+        finally {
+            const endTime = process.hrtime.bigint();
+            const durationMs = Number(endTime - startTime) / 1_000_000;
+            span.setAttributes({
+                "mcp.tool.duration_ms": parseFloat(durationMs.toFixed(2)),
+                "mcp.tool.success": isSuccess,
+            });
+            if (errorCode) {
+                span.setAttribute("mcp.tool.error_code", errorCode);
+            }
+            span.end();
+            logger.info("Tool execution finished.", {
+                ...context,
+                metrics: {
+                    durationMs: parseFloat(durationMs.toFixed(2)),
+                    isSuccess,
+                    errorCode,
+                    inputBytes: getPayloadSize(inputPayload),
+                    outputBytes: getPayloadSize(outputPayload),
+                },
+            });
+        }
+    });
+}
+//# sourceMappingURL=performance.js.map

package/dist/utils/internal/performance.js.map

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

package/dist/utils/internal/requestContext.d.ts

@@ -81,3 +81,4 @@ export declare const requestContextService: {
      */
     createRequestContext(additionalContext?: Record<string, unknown>): RequestContext;
 };
+//# sourceMappingURL=requestContext.d.ts.map

package/dist/utils/internal/requestContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestContext.d.ts","sourceRoot":"","sources":["../../../src/utils/internal/requestContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sFAAsF;IACtF,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC,0EAA0E;IAC1E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AA6ED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;IA3EhC;;OAEG;YACW,aAAa;IAE3B;;;;;;OAMG;sBACe,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa;IAaxD;;;;;OAKG;iBACU,aAAa;IAI1B;;;;;;;;OAQG;6CAEkB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,cAAc;CA6B+C,CAAC"}

package/dist/utils/internal/requestContext.js

@@ -5,6 +5,7 @@
  * configuration and operational context structures.
  * @module src/utils/internal/requestContext
  */
+import { trace } from "@opentelemetry/api";
 import { generateUUID } from "../index.js";
 import { logger } from "./logger.js";
 /**
@@ -61,6 +62,15 @@ const requestContextServiceInstance = {
             timestamp,
             ...additionalContext,
         };
+        // --- OpenTelemetry Integration ---
+        // Automatically inject active trace and span IDs into the context for correlation.
+        const activeSpan = trace.getActiveSpan();
+        if (activeSpan) {
+            const spanContext = activeSpan.spanContext();
+            context.traceId = spanContext.traceId;
+            context.spanId = spanContext.spanId;
+        }
+        // --- End OpenTelemetry Integration ---
         return context;
     },
 };
@@ -70,3 +80,4 @@ const requestContextServiceInstance = {
  * which are essential for logging, tracing, and correlating operations.
  */
 export const requestContextService = requestContextServiceInstance;
+//# sourceMappingURL=requestContext.js.map

package/dist/utils/internal/requestContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestContext.js","sourceRoot":"","sources":["../../../src/utils/internal/requestContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAgDrC;;;GAGG;AACH,MAAM,6BAA6B,GAAG;IACpC;;OAEG;IACH,MAAM,EAAE,EAAmB;IAE3B;;;;;;OAMG;IACH,SAAS,CAAC,MAA8B;QACtC,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,MAAM;SACV,CAAC;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC;YAC3C,SAAS,EAAE,iCAAiC;YAC5C,cAAc,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE;SACnC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,6CAA6C,EAAE,UAAU,CAAC,CAAC;QACxE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;;OAQG;IACH,oBAAoB,CAClB,oBAA6C,EAAE;QAE/C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE3C,MAAM,OAAO,GAAmB;YAC9B,SAAS;YACT,SAAS;YACT,GAAG,iBAAiB;SACrB,CAAC;QAEF,oCAAoC;QACpC,mFAAmF;QACnF,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QACzC,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;YAC7C,OAAO,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;YACtC,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;QACtC,CAAC;QACD,wCAAwC;QAExC,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,6BAA6B,CAAC"}

package/dist/utils/metrics/index.d.ts

@@ -5,3 +5,4 @@
  * @module src/utils/metrics
  */
 export * from "./tokenCounter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/metrics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/metrics/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC"}

package/dist/utils/metrics/index.js

@@ -5,3 +5,4 @@
  * @module src/utils/metrics
  */
 export * from "./tokenCounter.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/metrics/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC"}

package/dist/utils/metrics/tokenCounter.d.ts

@@ -33,3 +33,4 @@ export declare function countTokens(text: string, context?: RequestContext): Pro
  * @throws {McpError} If tokenization fails.
  */
 export declare function countChatTokens(messages: ReadonlyArray<ChatCompletionMessageParam>, context?: RequestContext): Promise<number>;
+//# sourceMappingURL=tokenCounter.d.ts.map

package/dist/utils/metrics/tokenCounter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenCounter.d.ts","sourceRoot":"","sources":["../../../src/utils/metrics/tokenCounter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAG/E,OAAO,EAAwB,cAAc,EAAE,MAAM,aAAa,CAAC;AASnE;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,CAAC,0BAA0B,CAAC,EACnD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,CAyEjB"}

package/dist/utils/metrics/tokenCounter.js

@@ -108,3 +108,4 @@ export async function countChatTokens(messages, context) {
         errorCode: BaseErrorCode.INTERNAL_ERROR,
     });
 }
+//# sourceMappingURL=tokenCounter.js.map

package/dist/utils/metrics/tokenCounter.js.map

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

package/dist/utils/network/fetchWithTimeout.d.ts

@@ -19,3 +19,4 @@ export type FetchWithTimeoutOptions = Omit<RequestInit, "signal">;
  * @throws {McpError} If the request times out or another fetch-related error occurs.
  */
 export declare function fetchWithTimeout(url: string | URL, timeoutMs: number, context: RequestContext, options?: FetchWithTimeoutOptions): Promise<Response>;
+//# sourceMappingURL=fetchWithTimeout.d.ts.map

package/dist/utils/network/fetchWithTimeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchWithTimeout.d.ts","sourceRoot":"","sources":["../../../src/utils/network/fetchWithTimeout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAElE;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,QAAQ,CAAC,CA0FnB"}

package/dist/utils/network/fetchWithTimeout.js

@@ -26,6 +26,24 @@ export async function fetchWithTimeout(url, timeoutMs, context, options) {
             signal: controller.signal,
         });
         clearTimeout(timeoutId);
+        if (!response.ok) {
+            const errorBody = await response
+                .text()
+                .catch(() => "Could not read response body");
+            logger.error(`Fetch failed for ${urlString} with status ${response.status}.`, {
+                ...context,
+                statusCode: response.status,
+                statusText: response.statusText,
+                responseBody: errorBody,
+                errorSource: "FetchHttpError",
+            });
+            throw new McpError(BaseErrorCode.SERVICE_UNAVAILABLE, `Fetch failed for ${urlString}. Status: ${response.status}`, {
+                ...context,
+                statusCode: response.status,
+                statusText: response.statusText,
+                responseBody: errorBody,
+            });
+        }
         logger.debug(`Successfully fetched ${urlString}. Status: ${response.status}`, context);
         return response;
     }
@@ -57,3 +75,4 @@ export async function fetchWithTimeout(url, timeoutMs, context, options) {
         });
     }
 }
+//# sourceMappingURL=fetchWithTimeout.js.map

package/dist/utils/network/fetchWithTimeout.js.map

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

package/dist/utils/network/index.d.ts

@@ -4,3 +4,4 @@
  */
 export * from "./fetchWithTimeout.js";
 export type { FetchWithTimeoutOptions } from "./fetchWithTimeout.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/network/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/network/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,uBAAuB,CAAC;AACtC,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/utils/network/index.js

@@ -3,3 +3,4 @@
  * @module src/utils/network/index
  */
 export * from "./fetchWithTimeout.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/network/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/utils/parsing/dateParser.d.ts

@@ -16,7 +16,7 @@ import { RequestContext } from "../index.js";
  * @throws {McpError} If an unexpected error occurs during parsing.
  * @private
  */
-declare function parseDateString(text: string, context: RequestContext, refDate?: Date): Promise<Date | null>;
+export declare function parseDateString(text: string, context: RequestContext, refDate?: Date): Promise<Date | null>;
 /**
  * Parses a natural language date string and returns detailed parsing results.
  * Provides more information than just the Date object, including matched text and components.
@@ -28,7 +28,7 @@ declare function parseDateString(text: string, context: RequestContext, refDate?
  * @throws {McpError} If an unexpected error occurs during parsing.
  * @private
  */
-declare function parseDateStringDetailed(text: string, context: RequestContext, refDate?: Date): Promise<chrono.ParsedResult[]>;
+export declare function parseDateStringDetailed(text: string, context: RequestContext, refDate?: Date): Promise<chrono.ParsedResult[]>;
 /**
  * An object providing date parsing functionalities.
  *
@@ -70,4 +70,4 @@ export declare const dateParser: {
      */
     parseDate: typeof parseDateString;
 };
-export {};
+//# sourceMappingURL=dateParser.d.ts.map

package/dist/utils/parsing/dateParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateParser.d.ts","sourceRoot":"","sources":["../../../src/utils/parsing/dateParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAwB,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,IAAI,GACb,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CA0BtB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,IAAI,GACb,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAwBhC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,UAAU;IACrB;;;;;;;OAOG;;IAEH;;;;;;OAMG;;CAEJ,CAAC"}

package/dist/utils/parsing/dateParser.js

@@ -17,7 +17,7 @@ import { ErrorHandler, logger } from "../index.js";
  * @throws {McpError} If an unexpected error occurs during parsing.
  * @private
  */
-async function parseDateString(text, context, refDate) {
+export async function parseDateString(text, context, refDate) {
     const operation = "parseDateString";
     const logContext = { ...context, operation, inputText: text, refDate };
     logger.debug(`Attempting to parse date string: "${text}"`, logContext);
@@ -49,7 +49,7 @@ async function parseDateString(text, context, refDate) {
  * @throws {McpError} If an unexpected error occurs during parsing.
  * @private
  */
-async function parseDateStringDetailed(text, context, refDate) {
+export async function parseDateStringDetailed(text, context, refDate) {
     const operation = "parseDateStringDetailed";
     const logContext = { ...context, operation, inputText: text, refDate };
     logger.debug(`Attempting detailed parse of date string: "${text}"`, logContext);
@@ -105,3 +105,4 @@ export const dateParser = {
      */
     parseDate: parseDateString,
 };
+//# sourceMappingURL=dateParser.js.map

package/dist/utils/parsing/dateParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateParser.js","sourceRoot":"","sources":["../../../src/utils/parsing/dateParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,EAAkB,MAAM,aAAa,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,OAAuB,EACvB,OAAc;IAEd,MAAM,SAAS,GAAG,iBAAiB,CAAC;IACpC,MAAM,UAAU,GAAG,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvE,MAAM,CAAC,KAAK,CAAC,qCAAqC,IAAI,GAAG,EAAE,UAAU,CAAC,CAAC;IAEvE,OAAO,MAAM,YAAY,CAAC,QAAQ,CAChC,KAAK,IAAI,EAAE;QACT,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV,wBAAwB,IAAI,QAAQ,UAAU,CAAC,WAAW,EAAE,EAAE,EAC9D,UAAU,CACX,CAAC;YACF,OAAO,UAAU,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,CAAC,iCAAiC,IAAI,GAAG,EAAE,UAAU,CAAC,CAAC;YACrE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,EACD;QACE,SAAS;QACT,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QACxB,SAAS,EAAE,aAAa,CAAC,aAAa;KACvC,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAY,EACZ,OAAuB,EACvB,OAAc;IAEd,MAAM,SAAS,GAAG,yBAAyB,CAAC;IAC5C,MAAM,UAAU,GAAG,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvE,MAAM,CAAC,KAAK,CACV,8CAA8C,IAAI,GAAG,EACrD,UAAU,CACX,CAAC;IAEF,OAAO,MAAM,YAAY,CAAC,QAAQ,CAChC,KAAK,IAAI,EAAE;QACT,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,KAAK,CACV,sBAAsB,IAAI,iBAAiB,OAAO,CAAC,MAAM,YAAY,EACrE,UAAU,CACX,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC,EACD;QACE,SAAS;QACT,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QACxB,SAAS,EAAE,aAAa,CAAC,aAAa;KACvC,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;;;;;;;OAOG;IACH,KAAK,EAAE,uBAAuB;IAC9B;;;;;;OAMG;IACH,SAAS,EAAE,eAAe;CAC3B,CAAC"}

package/dist/utils/parsing/index.d.ts

@@ -6,3 +6,4 @@
  */
 export * from "./dateParser.js";
 export * from "./jsonParser.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/parsing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/parsing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/utils/parsing/index.js

@@ -6,3 +6,4 @@
  */
 export * from "./dateParser.js";
 export * from "./jsonParser.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/parsing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/utils/parsing/jsonParser.d.ts

@@ -56,7 +56,7 @@ export declare class JsonParser {
      * @returns The parsed JavaScript value.
      * @throws {McpError} If the string is empty after processing or if `partial-json` fails.
      */
-    parse<T = any>(jsonString: string, allowPartial?: number, context?: RequestContext): T;
+    parse<T = unknown>(jsonString: string, allowPartial?: number, context?: RequestContext): T;
 }
 /**
  * Singleton instance of the `JsonParser`.
@@ -80,3 +80,4 @@ export declare class JsonParser {
  * ```
  */
 export declare const jsonParser: JsonParser;
+//# sourceMappingURL=jsonParser.d.ts.map

package/dist/utils/parsing/jsonParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonParser.d.ts","sourceRoot":"","sources":["../../../src/utils/parsing/jsonParser.ts"],"names":[],"mappings":"AAWA,OAAO,EAAU,cAAc,EAAyB,MAAM,aAAa,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;CAAmB,CAAC;AAStC;;;;GAIG;AACH,qBAAa,UAAU;IACrB;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,CAAC,GAAG,OAAO,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAkB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,CAAC;CA8DL;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC"}