@cyanheads/git-mcp-server 2.2.3 → 2.3.1

package/dist/utils/internal/errorHandler.js

@@ -108,8 +108,9 @@ export class ErrorHandler {
         const errorName = getErrorName(error);
         const errorMessage = getErrorMessage(error);
         // Check if the error type has a direct mapping
-        if (errorName in ERROR_TYPE_MAPPINGS) {
-            return ERROR_TYPE_MAPPINGS[errorName];
+        const mappedError = ERROR_TYPE_MAPPINGS[errorName];
+        if (mappedError) {
+            return mappedError;
         }
         // Check for common error patterns
         for (const pattern of COMMON_ERROR_PATTERNS) {
@@ -140,7 +141,7 @@ export class ErrorHandler {
             // Create a new error to avoid mutating a readonly property
             const updatedError = new McpError(error.code, error.message, newDetails);
             // Log the error with sanitized input
-            logger.error(`Error ${operation}: ${updatedError.message}`, {
+            logger.error(`Error in ${operation}: ${updatedError.message}`, {
                 errorCode: updatedError.code,
                 requestId: context?.requestId,
                 input: input ? sanitizeInputForLogging(input) : undefined,
@@ -157,7 +158,7 @@ export class ErrorHandler {
         // Sanitize input for logging
         const sanitizedInput = input ? sanitizeInputForLogging(input) : undefined;
         // Log the error with consistent format
-        logger.error(`Error ${operation}`, {
+        logger.error(`Error in ${operation}: ${getErrorMessage(error)}`, {
             error: getErrorMessage(error), // Use helper function
             errorType: getErrorName(error),
             input: sanitizedInput,
@@ -176,7 +177,7 @@ export class ErrorHandler {
             transformedError = options.errorMapper(error);
         }
         else {
-            transformedError = new McpError(errorCode, `Error ${operation}: ${getErrorMessage(error)}`, // Use helper function
+            transformedError = new McpError(errorCode, `Error in ${operation}: ${getErrorMessage(error)}`, // Use helper function
             {
                 originalError: getErrorName(error),
                 ...context,
@@ -247,7 +248,7 @@ export class ErrorHandler {
         return {
             code: BaseErrorCode.UNKNOWN_ERROR,
             message: String(error),
-            details: { errorType: typeof error },
+            details: { errorType: "string" },
         };
     }
     /**
@@ -265,3 +266,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

@@ -0,0 +1,4 @@
+export * from "./errorHandler.js";
+export * from "./logger.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,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC"}

package/dist/utils/internal/index.js

@@ -1,3 +1,4 @@
 export * from "./errorHandler.js";
 export * from "./logger.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,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC"}

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

@@ -0,0 +1,55 @@
+/**
+ * Supported logging levels based on RFC 5424 Syslog severity levels used by MCP.
+ * emerg: 0, alert: 1, crit: 2, error: 3, warning: 4, notice: 5, info: 6, debug: 7
+ */
+export type McpLogLevel = "debug" | "info" | "notice" | "warning" | "error" | "crit" | "alert" | "emerg";
+export type McpNotificationSender = (level: McpLogLevel, data: Record<string, unknown>, loggerName?: string) => void;
+/**
+ * Singleton Logger wrapping Winston, adapted for MCP.
+ * Logs to files and optionally sends MCP notifications/message.
+ */
+export declare class Logger {
+    private static instance;
+    private winstonLogger?;
+    private initialized;
+    private mcpNotificationSender?;
+    private currentMcpLevel;
+    private currentWinstonLevel;
+    private constructor();
+    /**
+     * Initialize Winston logger for file transport. Must be called once at app start.
+     * Console transport is added conditionally.
+     * @param level Initial minimum level to log ('info' default).
+     */
+    initialize(level?: McpLogLevel): Promise<void>;
+    /**
+     * Sets the function used to send MCP 'notifications/message'.
+     */
+    setMcpNotificationSender(sender: McpNotificationSender | undefined): void;
+    /**
+     * Dynamically sets the minimum logging level.
+     */
+    setLevel(newLevel: McpLogLevel): void;
+    /** Get singleton instance. */
+    static getInstance(): Logger;
+    /**
+     * Resets the singleton instance for testing purposes.
+     * This should only be used in test environments.
+     */
+    static resetForTesting(): void;
+    /** Ensures the logger has been initialized. */
+    private ensureInitialized;
+    /** Centralized log processing */
+    private log;
+    debug(msg: string, context?: Record<string, unknown>): void;
+    info(msg: string, context?: Record<string, unknown>): void;
+    notice(msg: string, context?: Record<string, unknown>): void;
+    warning(msg: string, context?: Record<string, unknown>): void;
+    error(msg: string, err?: Error | Record<string, unknown>, context?: Record<string, unknown>): void;
+    crit(msg: string, err?: Error | Record<string, unknown>, context?: Record<string, unknown>): void;
+    alert(msg: string, err?: Error | Record<string, unknown>, context?: Record<string, unknown>): void;
+    emerg(msg: string, err?: Error | Record<string, unknown>, context?: Record<string, unknown>): void;
+    fatal(msg: string, err?: Error | Record<string, unknown>, context?: Record<string, unknown>): void;
+}
+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":"AAOA;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AA8BZ,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,KAChB,IAAI,CAAC;AAgEV;;;GAGG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,aAAa,CAAC,CAAiB;IACvC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAAC,CAAwB;IACtD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,mBAAmB,CAA+C;IAE1E,OAAO;IAEP;;;;OAIG;IACU,UAAU,CAAC,KAAK,GAAE,WAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwHnE;;OAEG;IACI,wBAAwB,CAC7B,MAAM,EAAE,qBAAqB,GAAG,SAAS,GACxC,IAAI;IAMP;;OAEG;IACI,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAkD5C,8BAA8B;WAChB,WAAW,IAAI,MAAM;IAOnC;;;OAGG;WACW,eAAe,IAAI,IAAI;IAKrC,+CAA+C;IAC/C,OAAO,CAAC,iBAAiB;IAWzB,iCAAiC;IACjC,OAAO,CAAC,GAAG;IA+CJ,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG3D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG1D,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG5D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG7D,KAAK,CACV,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;IAMA,IAAI,CACT,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;IAMA,KAAK,CACV,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;IAMA,KAAK,CACV,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;IAMA,KAAK,CACV,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;CAMR;AAGD,eAAO,MAAM,MAAM,QAAuB,CAAC"}

package/dist/utils/internal/logger.js

@@ -81,7 +81,7 @@ function createWinstonConsoleFormat() {
  * Singleton Logger wrapping Winston, adapted for MCP.
  * Logs to files and optionally sends MCP notifications/message.
  */
-class Logger {
+export class Logger {
     static instance;
     winstonLogger;
     initialized = false;
@@ -242,6 +242,14 @@ class Logger {
         }
         return Logger.instance;
     }
+    /**
+     * Resets the singleton instance for testing purposes.
+     * This should only be used in test environments.
+     */
+    static resetForTesting() {
+        // This allows tests to get a fresh instance for each run.
+        Logger.instance = new Logger();
+    }
     /** Ensures the logger has been initialized. */
     ensureInitialized() {
         if (!this.initialized || !this.winstonLogger) {
@@ -273,10 +281,13 @@ class Logger {
             if (context)
                 mcpDataPayload.context = context;
             if (error) {
-                mcpDataPayload.error = { message: error.message };
+                const errorPayload = {
+                    message: error.message,
+                };
                 if (this.currentMcpLevel === "debug" && error.stack) {
-                    mcpDataPayload.error.stack = error.stack.substring(0, 500);
+                    errorPayload.stack = error.stack.substring(0, 500);
                 }
+                mcpDataPayload.error = errorPayload;
             }
             try {
                 this.mcpNotificationSender(level, mcpDataPayload, config.mcpServerName);
@@ -324,9 +335,12 @@ class Logger {
         const combinedContext = err instanceof Error ? context : { ...(err || {}), ...(context || {}) };
         this.log("emerg", msg, combinedContext, errorObj);
     }
-    fatal(msg, context, error) {
-        this.log("emerg", msg, context, error);
+    fatal(msg, err, context) {
+        const errorObj = err instanceof Error ? err : undefined;
+        const combinedContext = err instanceof Error ? context : { ...(err || {}), ...(context || {}) };
+        this.log("emerg", msg, combinedContext, errorObj);
     }
 }
 // Export singleton instance
 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/requestContext.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Defines the structure for context information associated with a request or operation.
+ */
+export interface RequestContext {
+    /** Unique identifier generated for the request context instance. */
+    requestId: string;
+    /** ISO 8601 timestamp indicating when the context was created. */
+    timestamp: string;
+    /** Allows for additional, arbitrary key-value pairs for specific context needs. */
+    [key: string]: unknown;
+}
+/**
+ * Configuration interface for request context utilities
+ */
+export interface ContextConfig {
+    /** Custom configuration properties */
+    [key: string]: unknown;
+}
+/**
+ * Operation context with request data
+ */
+export interface OperationContext {
+    /** Request context data */
+    requestContext?: RequestContext;
+    /** Custom context properties */
+    [key: string]: unknown;
+}
+export declare const requestContextService: {
+    config: ContextConfig;
+    /**
+     * Configure service settings
+     * @param config New configuration
+     * @returns Updated configuration
+     */
+    configure(config: Partial<ContextConfig>): ContextConfig;
+    /**
+     * Get current configuration
+     * @returns Current configuration
+     */
+    getConfig(): ContextConfig;
+    /**
+     * Create a request context with unique ID and timestamp
+     * @param additionalContext Additional context properties
+     * @returns Request context object
+     */
+    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":"AAKA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gCAAgC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAoDD,eAAO,MAAM,qBAAqB;YAhDlB,aAAa;IAE3B;;;;OAIG;sBACe,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa;IAWxD;;;OAGG;iBACU,aAAa;IAI1B;;;;OAIG;6CAEkB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,cAAc;CAe+C,CAAC"}

package/dist/utils/internal/requestContext.js

@@ -48,3 +48,4 @@ export const requestContextService = requestContextServiceInstance;
 // Users should import and use `requestContextService` directly.
 // e.g., import { requestContextService } from './requestContext.js';
 // 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,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,wFAAwF;AACxF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiC3C,gDAAgD;AAChD,MAAM,6BAA6B,GAAG;IACpC,MAAM,EAAE,EAAmB;IAE3B;;;;OAIG;IACH,SAAS,CAAC,MAA8B;QACtC,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,MAAM;SACV,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE;YACnD,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAClB,oBAA6C,EAAE;QAE/C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC,CAAC,4BAA4B;QAC9D,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE3C,OAAO;YACL,SAAS;YACT,SAAS;YACT,GAAG,iBAAiB;SACrB,CAAC;IACJ,CAAC;IAED,6EAA6E;CAC9E,CAAC;AAEF,+BAA+B;AAC/B,MAAM,CAAC,MAAM,qBAAqB,GAAG,6BAA6B,CAAC;AAEnE,gEAAgE;AAChE,gEAAgE;AAChE,qEAAqE;AACrE,gDAAgD"}

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

@@ -0,0 +1,2 @@
+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,cAAc,mBAAmB,CAAC"}

package/dist/utils/metrics/index.js

@@ -1 +1,2 @@
 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,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,28 @@
+import { ChatCompletionMessageParam } from "openai/resources/chat/completions";
+import { RequestContext } from "../index.js";
+/**
+ * Calculates the number of tokens for a given text using the 'gpt-4o' tokenizer.
+ * Uses ErrorHandler for consistent error management.
+ *
+ * @param text - The input text to tokenize.
+ * @param context - Optional request context for logging and error handling.
+ * @returns The number of tokens.
+ * @throws {McpError} Throws an McpError if tokenization fails.
+ */
+export declare function countTokens(text: string, context?: RequestContext): Promise<number>;
+/**
+ * Calculates the number of tokens for chat messages using the ChatCompletionMessageParam structure
+ * and the 'gpt-4o' tokenizer, considering special tokens and message overhead.
+ * This implementation is based on OpenAI's guidelines for gpt-4/gpt-3.5-turbo models.
+ * Uses ErrorHandler for consistent error management.
+ *
+ * See: https://github.com/openai/openai-cookbook/blob/main/examples/How_to_count_tokens_with_tiktoken.ipynb
+ *
+ * @param messages - An array of chat messages in the `ChatCompletionMessageParam` format.
+ * @param context - Optional request context for logging and error handling.
+ * @returns The estimated number of tokens.
+ * @throws {McpError} Throws an McpError if tokenization fails.
+ */
+export declare function countChatTokens(messages: ReadonlyArray<ChatCompletionMessageParam>, // Use the complex type
+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,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAI/E,OAAO,EAAwB,cAAc,EAAE,MAAM,aAAa,CAAC;AAKnE;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,CAAC,0BAA0B,CAAC,EAAE,uBAAuB;AAC5E,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,CA2FjB"}

package/dist/utils/metrics/tokenCounter.js

@@ -126,3 +126,4 @@ context) {
         // Removed onErrorReturn
     });
 }
+//# 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/parsing/dateParser.d.ts

@@ -0,0 +1,25 @@
+import * as chrono from "chrono-node";
+import { RequestContext } from "../index.js";
+export declare const dateParser: {
+    /**
+     * Parses a natural language date string and returns detailed parsing results.
+     *
+     * @param text The natural language date string.
+     * @param context The request context for logging and error tracking.
+     * @param refDate Optional reference date for parsing relative dates. Defaults to now.
+     * @returns An array of chrono.ParsedResult objects, or an empty array if parsing fails.
+     * @throws McpError if parsing fails unexpectedly.
+     */
+    parse: (text: string, context: RequestContext, refDate?: Date) => Promise<chrono.ParsedResult[]>;
+    /**
+     * Parses a natural language date string into a Date object.
+     *
+     * @param text The natural language date string (e.g., "tomorrow", "in 5 days", "2024-01-15").
+     * @param context The request context for logging and error tracking.
+     * @param refDate Optional reference date for parsing relative dates. Defaults to now.
+     * @returns A Date object representing the parsed date, or null if parsing fails.
+     * @throws McpError if parsing fails unexpectedly.
+     */
+    parseDate: (text: string, context: RequestContext, refDate?: Date) => Promise<Date | null>;
+};
+//# 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,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAwB,cAAc,EAAE,MAAM,aAAa,CAAC;AAGnE,eAAO,MAAM,UAAU;IACrB;;;;;;;;OAQG;kBAEK,MAAM,WACH,cAAc,YACb,IAAI,KACb,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IA0BjC;;;;;;;;OAQG;sBAEK,MAAM,WACH,cAAc,YACb,IAAI,KACb,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;CA6BxB,CAAC"}

package/dist/utils/parsing/dateParser.js

@@ -2,61 +2,62 @@ import * as chrono from "chrono-node";
 // Import utils from the main barrel file (logger, ErrorHandler, RequestContext from ../internal/*)
 import { logger, ErrorHandler } from "../index.js";
 import { BaseErrorCode } from "../../types-global/errors.js"; // Corrected path
-/**
- * Parses a natural language date string into a Date object.
- *
- * @param text The natural language date string (e.g., "tomorrow", "in 5 days", "2024-01-15").
- * @param context The request context for logging and error tracking.
- * @param refDate Optional reference date for parsing relative dates. Defaults to now.
- * @returns A Date object representing the parsed date, or null if parsing fails.
- * @throws McpError if parsing fails unexpectedly.
- */
-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);
-    return await ErrorHandler.tryCatch(async () => {
-        const parsedDate = chrono.parseDate(text, refDate, { forwardDate: true });
-        if (parsedDate) {
-            logger.debug(`Successfully parsed "${text}" to ${parsedDate.toISOString()}`, logContext);
-            return parsedDate;
-        }
-        else {
-            logger.warning(`Failed to parse date string: "${text}"`, logContext);
-            return null;
-        }
-    }, {
-        operation,
-        context: logContext,
-        input: { text, refDate },
-        errorCode: BaseErrorCode.PARSING_ERROR,
-    });
-}
-/**
- * Parses a natural language date string and returns detailed parsing results.
- *
- * @param text The natural language date string.
- * @param context The request context for logging and error tracking.
- * @param refDate Optional reference date for parsing relative dates. Defaults to now.
- * @returns An array of chrono.ParsedResult objects, or an empty array if parsing fails.
- * @throws McpError if parsing fails unexpectedly.
- */
-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);
-    return await ErrorHandler.tryCatch(async () => {
-        const results = chrono.parse(text, refDate, { forwardDate: true });
-        logger.debug(`Detailed parse of "${text}" resulted in ${results.length} result(s)`, logContext);
-        return results;
-    }, {
-        operation,
-        context: logContext,
-        input: { text, refDate },
-        errorCode: BaseErrorCode.PARSING_ERROR,
-    });
-}
 export const dateParser = {
-    parse: parseDateStringDetailed,
-    parseDate: parseDateString,
+    /**
+     * Parses a natural language date string and returns detailed parsing results.
+     *
+     * @param text The natural language date string.
+     * @param context The request context for logging and error tracking.
+     * @param refDate Optional reference date for parsing relative dates. Defaults to now.
+     * @returns An array of chrono.ParsedResult objects, or an empty array if parsing fails.
+     * @throws McpError if parsing fails unexpectedly.
+     */
+    parse: async (text, context, refDate) => {
+        const operation = "parseDateStringDetailed";
+        const logContext = { ...context, operation, inputText: text, refDate };
+        logger.debug(`Attempting detailed parse of date string: "${text}"`, logContext);
+        return await ErrorHandler.tryCatch(async () => {
+            const results = chrono.parse(text, refDate, { forwardDate: true });
+            logger.debug(`Detailed parse of "${text}" resulted in ${results.length} result(s)`, logContext);
+            return results;
+        }, {
+            operation,
+            context: logContext,
+            input: { text, refDate },
+            errorCode: BaseErrorCode.PARSING_ERROR,
+        });
+    },
+    /**
+     * Parses a natural language date string into a Date object.
+     *
+     * @param text The natural language date string (e.g., "tomorrow", "in 5 days", "2024-01-15").
+     * @param context The request context for logging and error tracking.
+     * @param refDate Optional reference date for parsing relative dates. Defaults to now.
+     * @returns A Date object representing the parsed date, or null if parsing fails.
+     * @throws McpError if parsing fails unexpectedly.
+     */
+    parseDate: async (text, context, refDate) => {
+        const operation = "parseDateString";
+        const logContext = { ...context, operation, inputText: text, refDate };
+        logger.debug(`Attempting to parse date string: "${text}"`, logContext);
+        return await ErrorHandler.tryCatch(async () => {
+            const parsedDate = chrono.parseDate(text, refDate, {
+                forwardDate: true,
+            });
+            if (parsedDate) {
+                logger.debug(`Successfully parsed "${text}" to ${parsedDate.toISOString()}`, logContext);
+                return parsedDate;
+            }
+            else {
+                logger.warning(`Failed to parse date string: "${text}"`, logContext);
+                return null;
+            }
+        }, {
+            operation,
+            context: logContext,
+            input: { text, refDate },
+            errorCode: BaseErrorCode.PARSING_ERROR,
+        });
+    },
 };
+//# 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,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,mGAAmG;AACnG,OAAO,EAAE,MAAM,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC,CAAC,iBAAiB;AAE/E,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;;;;;;;;OAQG;IACH,KAAK,EAAE,KAAK,EACV,IAAY,EACZ,OAAuB,EACvB,OAAc,EACkB,EAAE;QAClC,MAAM,SAAS,GAAG,yBAAyB,CAAC;QAC5C,MAAM,UAAU,GAAG,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACvE,MAAM,CAAC,KAAK,CACV,8CAA8C,IAAI,GAAG,EACrD,UAAU,CACX,CAAC;QAEF,OAAO,MAAM,YAAY,CAAC,QAAQ,CAChC,KAAK,IAAI,EAAE;YACT,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,MAAM,CAAC,KAAK,CACV,sBAAsB,IAAI,iBAAiB,OAAO,CAAC,MAAM,YAAY,EACrE,UAAU,CACX,CAAC;YACF,OAAO,OAAO,CAAC;QACjB,CAAC,EACD;YACE,SAAS;YACT,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;YACxB,SAAS,EAAE,aAAa,CAAC,aAAa;SACvC,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,EAAE,KAAK,EACd,IAAY,EACZ,OAAuB,EACvB,OAAc,EACQ,EAAE;QACxB,MAAM,SAAS,GAAG,iBAAiB,CAAC;QACpC,MAAM,UAAU,GAAG,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,qCAAqC,IAAI,GAAG,EAAE,UAAU,CAAC,CAAC;QAEvE,OAAO,MAAM,YAAY,CAAC,QAAQ,CAChC,KAAK,IAAI,EAAE;YACT,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE;gBACjD,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;YACH,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CACV,wBAAwB,IAAI,QAAQ,UAAU,CAAC,WAAW,EAAE,EAAE,EAC9D,UAAU,CACX,CAAC;gBACF,OAAO,UAAU,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,OAAO,CAAC,iCAAiC,IAAI,GAAG,EAAE,UAAU,CAAC,CAAC;gBACrE,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC,EACD;YACE,SAAS;YACT,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;YACxB,SAAS,EAAE,aAAa,CAAC,aAAa;SACvC,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,3 @@
+export * from "./jsonParser.js";
+export * from "./dateParser.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,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/utils/parsing/index.js

@@ -1,2 +1,3 @@
 export * from "./jsonParser.js";
 export * from "./dateParser.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,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

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

@@ -0,0 +1,83 @@
+import { RequestContext } from "../index.js";
+/**
+ * Enum mirroring `partial-json`'s `Allow` constants. These specify
+ * what types of partial JSON structures are permissible during parsing.
+ * They can be combined using bitwise OR (e.g., `Allow.STR | Allow.OBJ`).
+ *
+ * The available properties are:
+ * - `STR`: Allow partial string.
+ * - `NUM`: Allow partial number.
+ * - `ARR`: Allow partial array.
+ * - `OBJ`: Allow partial object.
+ * - `NULL`: Allow partial null.
+ * - `BOOL`: Allow partial boolean.
+ * - `NAN`: Allow partial NaN. (Note: Standard JSON does not support NaN)
+ * - `INFINITY`: Allow partial Infinity. (Note: Standard JSON does not support Infinity)
+ * - `_INFINITY`: Allow partial -Infinity. (Note: Standard JSON does not support -Infinity)
+ * - `INF`: Allow both partial Infinity and -Infinity.
+ * - `SPECIAL`: Allow all special values (NaN, Infinity, -Infinity).
+ * - `ATOM`: Allow all atomic values (strings, numbers, booleans, null, special values).
+ * - `COLLECTION`: Allow all collection values (objects, arrays).
+ * - `ALL`: Allow all value types to be partial (default for `partial-json`'s parse).
+ * @see {@link https://github.com/promplate/partial-json-parser-js} for more details.
+ */
+export declare const Allow: {
+    STR: number;
+    NUM: number;
+    ARR: number;
+    OBJ: number;
+    NULL: number;
+    BOOL: number;
+    NAN: number;
+    INFINITY: number;
+    _INFINITY: number;
+    INF: number;
+    SPECIAL: number;
+    ATOM: number;
+    COLLECTION: number;
+    ALL: number;
+};
+/**
+ * Utility class for parsing potentially partial JSON strings.
+ * Wraps the 'partial-json' library for robust JSON parsing, handling
+ * incomplete structures and optional <think> blocks from LLMs.
+ */
+export declare class JsonParser {
+    /**
+     * Parses a JSON string, which may be partial or prefixed with a <think> block.
+     * If a <think> block is present, its content is logged, and parsing proceeds on the
+     * remainder. Uses 'partial-json' to handle incomplete JSON.
+     *
+     * @template T The expected type of the parsed JSON object. Defaults to `unknown`.
+     * @param jsonString - The JSON string to parse.
+     * @param allowPartial - Bitwise OR combination of `Allow` constants specifying permissible
+     *   partial JSON types. Defaults to `Allow.ALL`.
+     * @param context - Optional `RequestContext` for logging and error correlation.
+     * @returns The parsed JavaScript value.
+     * @throws {McpError} If the string is empty after processing or if `partial-json` fails.
+     */
+    parse<T = unknown>(jsonString: string, allowPartial?: number, context?: RequestContext): T;
+}
+/**
+ * Singleton instance of the `JsonParser`.
+ * Use this instance to parse JSON strings, with support for partial JSON and <think> blocks.
+ * @example
+ * ```typescript
+ * import { jsonParser, Allow, requestContextService } from './utils';
+ * const context = requestContextService.createRequestContext({ operation: 'TestJsonParsing' });
+ *
+ * const fullJson = '{"key": "value"}';
+ * const parsedFull = jsonParser.parse(fullJson, Allow.ALL, context);
+ * console.log(parsedFull); // Output: { key: 'value' }
+ *
+ * const partialObject = '<think>This is a thought.</think>{"key": "value", "arr": [1,';
+ * try {
+ *   const parsedPartial = jsonParser.parse(partialObject, undefined, context);
+ *   console.log(parsedPartial);
+ * } catch (e) {
+ *   console.error("Parsing partial object failed:", e);
+ * }
+ * ```
+ */
+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"}