@ibm/ibmi-mcp-server 0.1.0

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/logging-helpers.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Provides centralized helper functions for common logging scenarios.
+ * This module standardizes how operations, successes, and errors are logged
+ * throughout the application, ensuring consistency and making future enhancements easier.
+ * @module src/utils/internal/logging-helpers
+ */
+import { RequestContext } from "./requestContext.js";
+interface OperationPayload {
+    [key: string]: unknown;
+}
+/**
+ * Logs the start of an operation.
+ * @param context - The request context for the operation.
+ * @param message - The log message describing the operation.
+ * @param payload - Additional structured data to include in the log.
+ */
+export declare function logOperationStart(context: RequestContext, message: string, payload?: OperationPayload): void;
+/**
+ * Logs the successful completion of an operation.
+ * @param context - The request context for the operation.
+ * @param message - The log message describing the success.
+ * @param payload - Additional structured data, like performance metrics.
+ */
+export declare function logOperationSuccess(context: RequestContext, message: string, payload?: OperationPayload): void;
+/**
+ * Logs a failed operation.
+ * @param context - The request context for the operation.
+ * @param message - The log message describing the error.
+ * @param error - The error object.
+ * @param payload - Additional structured data.
+ */
+export declare function logOperationError(context: RequestContext, message: string, error: unknown, payload?: OperationPayload): void;
+/**
+ * Logs a warning.
+ * @param context - The request context.
+ * @param message - The warning message.
+ * @param payload - Additional structured data.
+ */
+export declare function logWarning(context: RequestContext, message: string, payload?: OperationPayload): void;
+/**
+ * Logs a fatal error and terminates the process.
+ * This should be used for unrecoverable errors during critical phases like startup.
+ * @param context - The request context.
+ * @param message - The fatal error message.
+ * @param error - The error object.
+ */
+export declare function logFatal(context: RequestContext, message: string, error: unknown): void;
+export {};
+//# sourceMappingURL=logging-helpers.d.ts.map

package/dist/utils/internal/logging-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/internal/logging-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,UAAU,gBAAgB;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAGN;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,IAAI,CAMN"}

package/dist/utils/internal/logging-helpers.js

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Provides centralized helper functions for common logging scenarios.
+ * This module standardizes how operations, successes, and errors are logged
+ * throughout the application, ensuring consistency and making future enhancements easier.
+ * @module src/utils/internal/logging-helpers
+ */
+import { logger } from "./logger.js";
+/**
+ * Logs the start of an operation.
+ * @param context - The request context for the operation.
+ * @param message - The log message describing the operation.
+ * @param payload - Additional structured data to include in the log.
+ */
+export function logOperationStart(context, message, payload) {
+    logger.info({ ...context, ...payload }, message);
+}
+/**
+ * Logs the successful completion of an operation.
+ * @param context - The request context for the operation.
+ * @param message - The log message describing the success.
+ * @param payload - Additional structured data, like performance metrics.
+ */
+export function logOperationSuccess(context, message, payload) {
+    logger.info({ ...context, ...payload }, message);
+}
+/**
+ * Logs a failed operation.
+ * @param context - The request context for the operation.
+ * @param message - The log message describing the error.
+ * @param error - The error object.
+ * @param payload - Additional structured data.
+ */
+export function logOperationError(context, message, error, payload) {
+    const err = error instanceof Error ? error : new Error(String(error));
+    logger.error({ err, ...context, ...payload }, message);
+}
+/**
+ * Logs a warning.
+ * @param context - The request context.
+ * @param message - The warning message.
+ * @param payload - Additional structured data.
+ */
+export function logWarning(context, message, payload) {
+    logger.warning({ ...context, ...payload }, message);
+}
+/**
+ * Logs a fatal error and terminates the process.
+ * This should be used for unrecoverable errors during critical phases like startup.
+ * @param context - The request context.
+ * @param message - The fatal error message.
+ * @param error - The error object.
+ */
+export function logFatal(context, message, error) {
+    const err = error instanceof Error ? error : new Error(String(error));
+    // The logger's uncaughtException handler will exit, but we call fatal here for consistency.
+    logger.fatal({ err, ...context }, message);
+    // Ensure process exits if not already handled by uncaughtException handler
+    setTimeout(() => process.exit(1), 10);
+}
+//# sourceMappingURL=logging-helpers.js.map

package/dist/utils/internal/logging-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-helpers.js","sourceRoot":"","sources":["../../../src/utils/internal/logging-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOrC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAuB,EACvB,OAAe,EACf,OAA0B;IAE1B,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAuB,EACvB,OAAe,EACf,OAA0B;IAE1B,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAuB,EACvB,OAAe,EACf,KAAc,EACd,OAA0B;IAE1B,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,OAAuB,EACvB,OAAe,EACf,OAA0B;IAE1B,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAuB,EACvB,OAAe,EACf,KAAc;IAEd,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,4FAA4F;IAC5F,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3C,2EAA2E;IAC3E,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * @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
+ */
+/**
+ * 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 toolName - The name of the tool being executed.
+ * @param toolLogicFn - The asynchronous tool logic function to be executed and measured.
+ * @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>(toolName: string, toolLogicFn: () => Promise<T>, 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;AA6BH;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC7B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,CAAC,CAAC,CA4EZ"}

package/dist/utils/internal/performance.js

@@ -0,0 +1,110 @@
+/**
+ * @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 { getRequestContext } from "./asyncContext.js";
+import { logOperationSuccess } from "./logging-helpers.js";
+import { requestContextService } from "./requestContext.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 toolName - The name of the tool being executed.
+ * @param toolLogicFn - The asynchronous tool logic function to be executed and measured.
+ * @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(toolName, toolLogicFn, inputPayload) {
+    // Ensure a valid context exists for logging and tracing.
+    const context = getRequestContext() ??
+        requestContextService.createRequestContext({
+            operation: `measureToolExecution:${toolName}`,
+        });
+    const tracer = trace.getTracer(config.openTelemetry.serviceName, config.openTelemetry.serviceVersion);
+    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();
+            logOperationSuccess(context, "Tool execution finished.", {
+                performance: {
+                    toolName,
+                    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

@@ -0,0 +1,41 @@
+/**
+ * Defines the core structure for context information associated with a request or operation.
+ * This is fundamental for logging, tracing, and passing operational data.
+ */
+export interface RequestContext {
+    requestId: string;
+    timestamp: string;
+    [key: string]: unknown;
+}
+/**
+ * Options for creating a new RequestContext.
+ */
+export interface CreateRequestContextOptions {
+    /**
+     * An optional parent context. If provided, the new context will inherit the
+     * `requestId` and `traceId` from the parent, creating a logical link.
+     */
+    parentContext?: RequestContext | Record<string, unknown>;
+    /**
+     * Allows for arbitrary additional context information.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Creates a new {@link RequestContext} instance.
+ * Each context is assigned a unique `requestId` and a current `timestamp`.
+ * It automatically injects OpenTelemetry trace and span IDs if an active span exists.
+ * If a `parentContext` is provided, it inherits the `requestId` for continuity.
+ *
+ * @param options - An optional object containing a `parentContext` and other
+ *   key-value pairs to be included in the created request context.
+ * @returns A new `RequestContext` object.
+ */
+export declare function createRequestContext(options?: CreateRequestContextOptions): RequestContext;
+/**
+ * A service object for managing request context operations.
+ */
+export declare const requestContextService: {
+    createRequestContext: typeof createRequestContext;
+};
+//# 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":"AASA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,aAAa,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,cAAc,CAyBhB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;CAEjC,CAAC"}

package/dist/utils/internal/requestContext.js

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Utilities for creating and managing request contexts.
+ * A request context is an object carrying a unique ID, timestamp, and other
+ * relevant data for logging, tracing, and processing.
+ * @module src/utils/internal/requestContext
+ */
+import { trace } from "@opentelemetry/api";
+import { generateShortAlphanumericId } from "../security/idGenerator.js";
+/**
+ * Creates a new {@link RequestContext} instance.
+ * Each context is assigned a unique `requestId` and a current `timestamp`.
+ * It automatically injects OpenTelemetry trace and span IDs if an active span exists.
+ * If a `parentContext` is provided, it inherits the `requestId` for continuity.
+ *
+ * @param options - An optional object containing a `parentContext` and other
+ *   key-value pairs to be included in the created request context.
+ * @returns A new `RequestContext` object.
+ */
+export function createRequestContext(options = {}) {
+    const { parentContext, ...additionalContext } = options;
+    const baseRequestId = parentContext && typeof parentContext.requestId === "string"
+        ? parentContext.requestId
+        : generateShortAlphanumericId();
+    const context = {
+        requestId: baseRequestId,
+        timestamp: new Date().toISOString(),
+        ...additionalContext,
+    };
+    const activeSpan = trace.getActiveSpan();
+    if (activeSpan) {
+        const spanContext = activeSpan.spanContext();
+        context.traceId = spanContext.traceId;
+        context.spanId = spanContext.spanId;
+    }
+    else if (parentContext && typeof parentContext.traceId === "string") {
+        // Inherit traceId from parent if not in an active span
+        context.traceId = parentContext.traceId;
+    }
+    return context;
+}
+/**
+ * A service object for managing request context operations.
+ */
+export const requestContextService = {
+    createRequestContext,
+};
+//# 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;;;;;GAKG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AA2BzE;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAuC,EAAE;IAEzC,MAAM,EAAE,aAAa,EAAE,GAAG,iBAAiB,EAAE,GAAG,OAAO,CAAC;IAExD,MAAM,aAAa,GACjB,aAAa,IAAI,OAAO,aAAa,CAAC,SAAS,KAAK,QAAQ;QAC1D,CAAC,CAAC,aAAa,CAAC,SAAS;QACzB,CAAC,CAAC,2BAA2B,EAAE,CAAC;IAEpC,MAAM,OAAO,GAAmB;QAC9B,SAAS,EAAE,aAAa;QACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,iBAAiB;KACrB,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;IACzC,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAC7C,OAAO,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;QACtC,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IACtC,CAAC;SAAM,IAAI,aAAa,IAAI,OAAO,aAAa,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACtE,uDAAuD;QACvD,OAAO,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC;IAC1C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,oBAAoB;CACrB,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Barrel file for metrics-related utility modules.
+ * This file re-exports utilities for collecting and processing metrics,
+ * such as token counting.
+ * @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

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Barrel file for metrics-related utility modules.
+ * This file re-exports utilities for collecting and processing metrics,
+ * such as token counting.
+ * @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

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Provides utility functions for counting tokens in text and chat messages
+ * using the `tiktoken` library, specifically configured for 'gpt-4o' tokenization.
+ * These functions are essential for managing token limits and estimating costs
+ * when interacting with language models.
+ * @module src/utils/metrics/tokenCounter
+ */
+import { ChatCompletionMessageParam } from "openai/resources/chat/completions";
+import { RequestContext } from "../index.js";
+/**
+ * Calculates the number of tokens for a given text string using the
+ * tokenizer specified by `TOKENIZATION_MODEL`.
+ * Wraps tokenization in `ErrorHandler.tryCatch` for robust error management.
+ *
+ * @param text - The input text to tokenize.
+ * @param context - Optional request context for logging and error handling.
+ * @returns A promise that resolves with the number of tokens in the text.
+ * @throws {McpError} If tokenization fails.
+ */
+export declare function countTokens(text: string, context?: RequestContext): Promise<number>;
+/**
+ * Calculates the estimated number of tokens for an array of chat messages.
+ * Uses the tokenizer specified by `TOKENIZATION_MODEL` and accounts for
+ * special tokens and message overhead according to OpenAI's guidelines.
+ *
+ * For multi-part content, only text parts are currently tokenized.
+ *
+ * Reference: {@link https://github.com/openai/openai-cookbook/blob/main/examples/How_to_count_tokens_with_tiktoken.ipynb}
+ *
+ * @param messages - An array of chat messages.
+ * @param context - Optional request context for logging and error handling.
+ * @returns A promise that resolves with the estimated total number of tokens.
+ * @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,kBAAkB,CAAC;AASxE;;;;;;;;;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,CA6EjB"}

package/dist/utils/metrics/tokenCounter.js

@@ -0,0 +1,115 @@
+import { encoding_for_model } from "tiktoken";
+import { JsonRpcErrorCode } from "../../types-global/errors.js";
+import { ErrorHandler, logger } from "../index.js";
+/**
+ * The specific Tiktoken model used for all tokenization operations in this module.
+ * This ensures consistent token counting.
+ * @private
+ */
+const TOKENIZATION_MODEL = "gpt-4o";
+/**
+ * Calculates the number of tokens for a given text string using the
+ * tokenizer specified by `TOKENIZATION_MODEL`.
+ * Wraps tokenization in `ErrorHandler.tryCatch` for robust error management.
+ *
+ * @param text - The input text to tokenize.
+ * @param context - Optional request context for logging and error handling.
+ * @returns A promise that resolves with the number of tokens in the text.
+ * @throws {McpError} If tokenization fails.
+ */
+export async function countTokens(text, context) {
+    return ErrorHandler.tryCatch(() => {
+        let encoding = null;
+        try {
+            encoding = encoding_for_model(TOKENIZATION_MODEL);
+            const tokens = encoding.encode(text);
+            return tokens.length;
+        }
+        finally {
+            encoding?.free();
+        }
+    }, {
+        operation: "countTokens",
+        context: context,
+        input: { textSample: text.substring(0, 50) + "..." },
+        errorCode: JsonRpcErrorCode.InternalError,
+    });
+}
+/**
+ * Calculates the estimated number of tokens for an array of chat messages.
+ * Uses the tokenizer specified by `TOKENIZATION_MODEL` and accounts for
+ * special tokens and message overhead according to OpenAI's guidelines.
+ *
+ * For multi-part content, only text parts are currently tokenized.
+ *
+ * Reference: {@link https://github.com/openai/openai-cookbook/blob/main/examples/How_to_count_tokens_with_tiktoken.ipynb}
+ *
+ * @param messages - An array of chat messages.
+ * @param context - Optional request context for logging and error handling.
+ * @returns A promise that resolves with the estimated total number of tokens.
+ * @throws {McpError} If tokenization fails.
+ */
+export async function countChatTokens(messages, context) {
+    return ErrorHandler.tryCatch(() => {
+        let encoding = null;
+        let num_tokens = 0;
+        try {
+            encoding = encoding_for_model(TOKENIZATION_MODEL);
+            const tokens_per_message = 3; // For gpt-4o, gpt-4, gpt-3.5-turbo
+            const tokens_per_name = 1; // For gpt-4o, gpt-4, gpt-3.5-turbo
+            for (const message of messages) {
+                num_tokens += tokens_per_message;
+                num_tokens += encoding.encode(message.role).length;
+                if (typeof message.content === "string") {
+                    num_tokens += encoding.encode(message.content).length;
+                }
+                else if (Array.isArray(message.content)) {
+                    for (const part of message.content) {
+                        if (part.type === "text") {
+                            num_tokens += encoding.encode(part.text).length;
+                        }
+                        else {
+                            if (context) {
+                                logger.warning(context, `Non-text content part found (type: ${part.type}), token count contribution ignored.`);
+                            }
+                        }
+                    }
+                }
+                if ("name" in message && message.name) {
+                    num_tokens += tokens_per_name;
+                    num_tokens += encoding.encode(message.name).length;
+                }
+                if (message.role === "assistant" &&
+                    "tool_calls" in message &&
+                    message.tool_calls) {
+                    for (const tool_call of message.tool_calls) {
+                        if (tool_call.type === "function") {
+                            if (tool_call.function.name) {
+                                num_tokens += encoding.encode(tool_call.function.name).length;
+                            }
+                            if (tool_call.function.arguments) {
+                                num_tokens += encoding.encode(tool_call.function.arguments).length;
+                            }
+                        }
+                    }
+                }
+                if (message.role === "tool" &&
+                    "tool_call_id" in message &&
+                    message.tool_call_id) {
+                    num_tokens += encoding.encode(message.tool_call_id).length;
+                }
+            }
+            num_tokens += 3; // Every reply is primed with <|start|>assistant<|message|>
+            return num_tokens;
+        }
+        finally {
+            encoding?.free();
+        }
+    }, {
+        operation: "countChatTokens",
+        context: context,
+        input: { messageCount: messages.length },
+        errorCode: JsonRpcErrorCode.InternalError,
+    });
+}
+//# 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

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Provides a utility function to make fetch requests with a specified timeout.
+ * @module src/utils/network/fetchWithTimeout
+ */
+import type { RequestContext } from "../internal/requestContext.js";
+/**
+ * Options for the fetchWithTimeout utility.
+ * Extends standard RequestInit but omits 'signal' as it's handled internally.
+ */
+export type FetchWithTimeoutOptions = Omit<RequestInit, "signal">;
+/**
+ * Fetches a resource with a specified timeout.
+ *
+ * @param url - The URL to fetch.
+ * @param timeoutMs - The timeout duration in milliseconds.
+ * @param context - The request context for logging.
+ * @param options - Optional fetch options (RequestInit), excluding 'signal'.
+ * @returns A promise that resolves to the Response object.
+ * @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,oCAAoC,CAAC;AAGzE;;;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,CA6FnB"}