mcp-server-rocketchat-threads 1.0.0

package/dist/utils/error-handler.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * Centralized Error Handling Utilities
+ * Provides consistent error handling across all MCP tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorSuggestions = exports.ErrorCodes = void 0;
+exports.extractErrorMessage = extractErrorMessage;
+exports.extractErrorDetails = extractErrorDetails;
+exports.createErrorInfo = createErrorInfo;
+exports.httpStatusToErrorCode = httpStatusToErrorCode;
+exports.withErrorHandling = withErrorHandling;
+exports.isErrorInfo = isErrorInfo;
+exports.enrichErrorInfo = enrichErrorInfo;
+const client_js_1 = require("../api/client.js");
+/**
+ * Error codes used across the MCP server
+ */
+exports.ErrorCodes = {
+    API_ERROR: 'API_ERROR',
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    NOT_FOUND: 'NOT_FOUND',
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    RATE_LIMITED: 'RATE_LIMITED',
+    WRITE_DISABLED: 'WRITE_DISABLED',
+    ROOM_NOT_ALLOWED: 'ROOM_NOT_ALLOWED',
+    UNKNOWN_ERROR: 'UNKNOWN_ERROR'
+};
+/**
+ * Extract a meaningful error message from any error type
+ */
+function extractErrorMessage(error) {
+    if (error instanceof client_js_1.RocketChatApiError) {
+        return `${error.message} (Status: ${error.statusCode})`;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    return 'Unknown error occurred';
+}
+/**
+ * Extract error details (stack trace or additional info)
+ */
+function extractErrorDetails(error) {
+    if (error instanceof client_js_1.RocketChatApiError) {
+        try {
+            const body = JSON.parse(error.responseBody);
+            return body.error || body.message || error.responseBody;
+        }
+        catch {
+            return error.responseBody;
+        }
+    }
+    if (error instanceof Error && error.stack) {
+        // Only include stack in development
+        if (process.env.DEBUG === 'true') {
+            return error.stack;
+        }
+    }
+    return undefined;
+}
+/**
+ * Create an error info object from any error
+ */
+function createErrorInfo(code, defaultMessage, error) {
+    const message = error ? extractErrorMessage(error) : defaultMessage;
+    const details = error ? extractErrorDetails(error) : undefined;
+    return {
+        code,
+        message,
+        details
+    };
+}
+/**
+ * Map HTTP status codes to error codes
+ */
+function httpStatusToErrorCode(status) {
+    switch (status) {
+        case 400:
+            return exports.ErrorCodes.VALIDATION_ERROR;
+        case 401:
+        case 403:
+            return exports.ErrorCodes.PERMISSION_DENIED;
+        case 404:
+            return exports.ErrorCodes.NOT_FOUND;
+        case 429:
+            return exports.ErrorCodes.RATE_LIMITED;
+        default:
+            return exports.ErrorCodes.API_ERROR;
+    }
+}
+/**
+ * Wrapper for async handler functions with consistent error handling
+ * @param handler - The async handler function to wrap
+ * @param errorCode - Default error code to use
+ * @param errorMessage - Default error message
+ * @returns A wrapped function that catches errors and returns error results
+ */
+function withErrorHandling(handler, errorCode, errorMessage) {
+    return async (params) => {
+        try {
+            return await handler(params);
+        }
+        catch (error) {
+            return createErrorInfo(errorCode, errorMessage, error);
+        }
+    };
+}
+/**
+ * Helper to check if a result is an error info
+ */
+function isErrorInfo(result) {
+    return (typeof result === 'object' &&
+        result !== null &&
+        'code' in result &&
+        'message' in result &&
+        typeof result.code === 'string' &&
+        typeof result.message === 'string');
+}
+/**
+ * Standard suggestions for common errors
+ */
+exports.ErrorSuggestions = {
+    [exports.ErrorCodes.API_ERROR]: 'Check that the Rocket.Chat server is accessible and credentials are valid.',
+    [exports.ErrorCodes.VALIDATION_ERROR]: 'Review the input parameters and ensure they match the expected format.',
+    [exports.ErrorCodes.NOT_FOUND]: 'Verify that the resource exists and you have permission to access it.',
+    [exports.ErrorCodes.PERMISSION_DENIED]: 'Ensure you have the required permissions for this operation.',
+    [exports.ErrorCodes.RATE_LIMITED]: 'Too many requests. Please wait and try again.',
+    [exports.ErrorCodes.WRITE_DISABLED]: 'Set ROCKETCHAT_WRITE_ENABLED=true to enable write operations.',
+    [exports.ErrorCodes.ROOM_NOT_ALLOWED]: 'Check ROCKETCHAT_WRITE_ROOMS configuration for allowed rooms.',
+    [exports.ErrorCodes.UNKNOWN_ERROR]: 'An unexpected error occurred. Check the server logs for details.'
+};
+/**
+ * Add suggestion to error info based on error code
+ */
+function enrichErrorInfo(errorInfo) {
+    if (!errorInfo.suggestion && exports.ErrorSuggestions[errorInfo.code]) {
+        return {
+            ...errorInfo,
+            suggestion: exports.ErrorSuggestions[errorInfo.code]
+        };
+    }
+    return errorInfo;
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAiCH,kDAWC;AAKD,kDAgBC;AAKD,0CAaC;AAKD,sDAcC;AASD,8CAYC;AAKD,kCASC;AAmBD,0CAQC;AAlKD,gDAAsD;AAEtD;;GAEG;AACU,QAAA,UAAU,GAAG;IACtB,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,kBAAkB;IACpC,SAAS,EAAE,WAAW;IACtB,iBAAiB,EAAE,mBAAmB;IACtC,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,gBAAgB,EAAE,kBAAkB;IACpC,aAAa,EAAE,eAAe;CACxB,CAAC;AAcX;;GAEG;AACH,SAAgB,mBAAmB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,8BAAkB,EAAE,CAAC;QACtC,OAAO,GAAG,KAAK,CAAC,OAAO,aAAa,KAAK,CAAC,UAAU,GAAG,CAAC;IAC5D,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,OAAO,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,wBAAwB,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,8BAAkB,EAAE,CAAC;QACtC,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,YAAY,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC,YAAY,CAAC;QAC9B,CAAC;IACL,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QACxC,oCAAoC;QACpC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,KAAK,CAAC;QACvB,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAC3B,IAAe,EACf,cAAsB,EACtB,KAAe;IAEf,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;IACpE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/D,OAAO;QACH,IAAI;QACJ,OAAO;QACP,OAAO;KACV,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAc;IAChD,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,GAAG;YACJ,OAAO,kBAAU,CAAC,gBAAgB,CAAC;QACvC,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACJ,OAAO,kBAAU,CAAC,iBAAiB,CAAC;QACxC,KAAK,GAAG;YACJ,OAAO,kBAAU,CAAC,SAAS,CAAC;QAChC,KAAK,GAAG;YACJ,OAAO,kBAAU,CAAC,YAAY,CAAC;QACnC;YACI,OAAO,kBAAU,CAAC,SAAS,CAAC;IACpC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC7B,OAA8C,EAC9C,SAAoB,EACpB,YAAoB;IAEpB,OAAO,KAAK,EAAE,MAAe,EAAgC,EAAE;QAC3D,IAAI,CAAC;YACD,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,eAAe,CAAC,SAAS,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,MAAe;IACvC,OAAO,CACH,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,MAAM,IAAI,MAAM;QAChB,SAAS,IAAI,MAAM;QACnB,OAAQ,MAAoB,CAAC,IAAI,KAAK,QAAQ;QAC9C,OAAQ,MAAoB,CAAC,OAAO,KAAK,QAAQ,CACpD,CAAC;AACN,CAAC;AAED;;GAEG;AACU,QAAA,gBAAgB,GAA8B;IACvD,CAAC,kBAAU,CAAC,SAAS,CAAC,EAAE,4EAA4E;IACpG,CAAC,kBAAU,CAAC,gBAAgB,CAAC,EAAE,wEAAwE;IACvG,CAAC,kBAAU,CAAC,SAAS,CAAC,EAAE,uEAAuE;IAC/F,CAAC,kBAAU,CAAC,iBAAiB,CAAC,EAAE,8DAA8D;IAC9F,CAAC,kBAAU,CAAC,YAAY,CAAC,EAAE,+CAA+C;IAC1E,CAAC,kBAAU,CAAC,cAAc,CAAC,EAAE,+DAA+D;IAC5F,CAAC,kBAAU,CAAC,gBAAgB,CAAC,EAAE,+DAA+D;IAC9F,CAAC,kBAAU,CAAC,aAAa,CAAC,EAAE,kEAAkE;CACjG,CAAC;AAEF;;GAEG;AACH,SAAgB,eAAe,CAAC,SAAoB;IAChD,IAAI,CAAC,SAAS,CAAC,UAAU,IAAI,wBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,OAAO;YACH,GAAG,SAAS;YACZ,UAAU,EAAE,wBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC;SAC/C,CAAC;IACN,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Utils module - Common utilities
+ */
+export { LRUCache } from './cache.js';
+export { ErrorCodes, ErrorSuggestions, extractErrorMessage, extractErrorDetails, createErrorInfo, enrichErrorInfo, isErrorInfo } from './error-handler.js';
+export type { ErrorCode, ErrorInfo } from './error-handler.js';
+export { Logger, getLogger, resetLogger } from './logger.js';
+export type { LogLevel } from './logger.js';
+export { parseTimeExpression, toRocketChatTimestamp, formatDate, timeAgo } from './time-parser.js';
+export type { TimeRange } from './time-parser.js';
+export { TokenCounter } from './token-counter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EACH,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,WAAW,EACd,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACnG,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Utils module - Common utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenCounter = exports.timeAgo = exports.formatDate = exports.toRocketChatTimestamp = exports.parseTimeExpression = exports.resetLogger = exports.getLogger = exports.Logger = exports.isErrorInfo = exports.enrichErrorInfo = exports.createErrorInfo = exports.extractErrorDetails = exports.extractErrorMessage = exports.ErrorSuggestions = exports.ErrorCodes = exports.LRUCache = void 0;
+// Cache
+var cache_js_1 = require("./cache.js");
+Object.defineProperty(exports, "LRUCache", { enumerable: true, get: function () { return cache_js_1.LRUCache; } });
+// Error handler
+var error_handler_js_1 = require("./error-handler.js");
+Object.defineProperty(exports, "ErrorCodes", { enumerable: true, get: function () { return error_handler_js_1.ErrorCodes; } });
+Object.defineProperty(exports, "ErrorSuggestions", { enumerable: true, get: function () { return error_handler_js_1.ErrorSuggestions; } });
+Object.defineProperty(exports, "extractErrorMessage", { enumerable: true, get: function () { return error_handler_js_1.extractErrorMessage; } });
+Object.defineProperty(exports, "extractErrorDetails", { enumerable: true, get: function () { return error_handler_js_1.extractErrorDetails; } });
+Object.defineProperty(exports, "createErrorInfo", { enumerable: true, get: function () { return error_handler_js_1.createErrorInfo; } });
+Object.defineProperty(exports, "enrichErrorInfo", { enumerable: true, get: function () { return error_handler_js_1.enrichErrorInfo; } });
+Object.defineProperty(exports, "isErrorInfo", { enumerable: true, get: function () { return error_handler_js_1.isErrorInfo; } });
+// Logger
+var logger_js_1 = require("./logger.js");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_js_1.Logger; } });
+Object.defineProperty(exports, "getLogger", { enumerable: true, get: function () { return logger_js_1.getLogger; } });
+Object.defineProperty(exports, "resetLogger", { enumerable: true, get: function () { return logger_js_1.resetLogger; } });
+// Time parser
+var time_parser_js_1 = require("./time-parser.js");
+Object.defineProperty(exports, "parseTimeExpression", { enumerable: true, get: function () { return time_parser_js_1.parseTimeExpression; } });
+Object.defineProperty(exports, "toRocketChatTimestamp", { enumerable: true, get: function () { return time_parser_js_1.toRocketChatTimestamp; } });
+Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return time_parser_js_1.formatDate; } });
+Object.defineProperty(exports, "timeAgo", { enumerable: true, get: function () { return time_parser_js_1.timeAgo; } });
+// Token counter
+var token_counter_js_1 = require("./token-counter.js");
+Object.defineProperty(exports, "TokenCounter", { enumerable: true, get: function () { return token_counter_js_1.TokenCounter; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,QAAQ;AACR,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAEjB,gBAAgB;AAChB,uDAQ4B;AAPxB,8GAAA,UAAU,OAAA;AACV,oHAAA,gBAAgB,OAAA;AAChB,uHAAA,mBAAmB,OAAA;AACnB,uHAAA,mBAAmB,OAAA;AACnB,mHAAA,eAAe,OAAA;AACf,mHAAA,eAAe,OAAA;AACf,+GAAA,WAAW,OAAA;AAIf,SAAS;AACT,yCAA6D;AAApD,mGAAA,MAAM,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,wGAAA,WAAW,OAAA;AAGvC,cAAc;AACd,mDAAmG;AAA1F,qHAAA,mBAAmB,OAAA;AAAE,uHAAA,qBAAqB,OAAA;AAAE,4GAAA,UAAU,OAAA;AAAE,yGAAA,OAAO,OAAA;AAGxE,gBAAgB;AAChB,uDAAkD;AAAzC,gHAAA,YAAY,OAAA"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Simple Logger Utility
+ * Provides consistent logging with debug mode support
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Logger class with level filtering
+ */
+export declare class Logger {
+    private debugMode;
+    private context;
+    constructor(context?: string, debugMode?: boolean);
+    /**
+     * Log a debug message (only in debug mode)
+     */
+    debug(message: string, data?: unknown): void;
+    /**
+     * Log an info message
+     */
+    info(message: string, data?: unknown): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, data?: unknown): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, error?: unknown): void;
+    /**
+     * Internal log method
+     */
+    private log;
+    /**
+     * Format log entry for output
+     */
+    private formatEntry;
+    /**
+     * Create a child logger with a sub-context
+     */
+    child(subContext: string): Logger;
+}
+/**
+ * Get the default logger instance
+ */
+export declare function getLogger(context?: string): Logger;
+/**
+ * Reset the default logger (for testing)
+ */
+export declare function resetLogger(): void;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAU3D;;GAEG;AACH,qBAAa,MAAM;IACf,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAc,EAAE,SAAS,CAAC,EAAE,OAAO;IAKxD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM5C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAO7C;;OAEG;IACH,OAAO,CAAC,GAAG;IAuBX;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAGpC;AAKD;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/utils/logger.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Simple Logger Utility
+ * Provides consistent logging with debug mode support
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+exports.getLogger = getLogger;
+exports.resetLogger = resetLogger;
+/**
+ * Logger class with level filtering
+ */
+class Logger {
+    debugMode;
+    context;
+    constructor(context = 'MCP', debugMode) {
+        this.context = context;
+        this.debugMode = debugMode ?? process.env.DEBUG === 'true';
+    }
+    /**
+     * Log a debug message (only in debug mode)
+     */
+    debug(message, data) {
+        if (this.debugMode) {
+            this.log('debug', message, data);
+        }
+    }
+    /**
+     * Log an info message
+     */
+    info(message, data) {
+        this.log('info', message, data);
+    }
+    /**
+     * Log a warning message
+     */
+    warn(message, data) {
+        this.log('warn', message, data);
+    }
+    /**
+     * Log an error message
+     */
+    error(message, error) {
+        const data = error instanceof Error
+            ? { message: error.message, stack: error.stack }
+            : error;
+        this.log('error', message, data);
+    }
+    /**
+     * Internal log method
+     */
+    log(level, message, data) {
+        const entry = {
+            level,
+            message,
+            context: this.context,
+            timestamp: new Date().toISOString(),
+            data
+        };
+        const output = this.formatEntry(entry);
+        switch (level) {
+            case 'error':
+                console.error(output);
+                break;
+            case 'warn':
+                console.warn(output);
+                break;
+            default:
+                console.log(output);
+        }
+    }
+    /**
+     * Format log entry for output
+     */
+    formatEntry(entry) {
+        const parts = [
+            `[${entry.timestamp}]`,
+            `[${entry.level.toUpperCase()}]`,
+            `[${entry.context}]`,
+            entry.message
+        ];
+        if (entry.data !== undefined) {
+            parts.push('-');
+            parts.push(typeof entry.data === 'string'
+                ? entry.data
+                : JSON.stringify(entry.data));
+        }
+        return parts.join(' ');
+    }
+    /**
+     * Create a child logger with a sub-context
+     */
+    child(subContext) {
+        return new Logger(`${this.context}:${subContext}`, this.debugMode);
+    }
+}
+exports.Logger = Logger;
+// Default logger instance
+let defaultLogger = null;
+/**
+ * Get the default logger instance
+ */
+function getLogger(context) {
+    if (context) {
+        return new Logger(context);
+    }
+    if (!defaultLogger) {
+        defaultLogger = new Logger();
+    }
+    return defaultLogger;
+}
+/**
+ * Reset the default logger (for testing)
+ */
+function resetLogger() {
+    defaultLogger = null;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/time-parser.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Time expression parser
+ * Supports: 1d, 7d, 1w, 1m, ISO dates
+ */
+export interface TimeRange {
+    oldest: Date;
+    latest: Date;
+    start: Date;
+    end: Date;
+}
+/**
+ * Parse time expression to date range
+ *
+ * @param expr - Time expression: "1d", "7d", "1w", "1m", or ISO date
+ * @returns TimeRange with oldest and latest dates
+ *
+ * @example
+ * parseTimeExpression("1d")  // Today since midnight
+ * parseTimeExpression("7d")  // Last 7 days
+ * parseTimeExpression("1w")  // Last week (same as 7d)
+ * parseTimeExpression("1m")  // Last month
+ * parseTimeExpression("2024-01-01")  // Since specific date
+ */
+export declare function parseTimeExpression(expr: string): TimeRange;
+/**
+ * Convert Date to Rocket.Chat timestamp format
+ */
+export declare function toRocketChatTimestamp(date: Date): string;
+/**
+ * Format date for display
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Format relative time ago
+ */
+export declare function timeAgo(date: Date): string;
+//# sourceMappingURL=time-parser.d.ts.map

package/dist/utils/time-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-parser.d.ts","sourceRoot":"","sources":["../../src/utils/time-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;CACb;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAkD3D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAY1C"}

package/dist/utils/time-parser.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Time expression parser
+ * Supports: 1d, 7d, 1w, 1m, ISO dates
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTimeExpression = parseTimeExpression;
+exports.toRocketChatTimestamp = toRocketChatTimestamp;
+exports.formatDate = formatDate;
+exports.timeAgo = timeAgo;
+/**
+ * Parse time expression to date range
+ *
+ * @param expr - Time expression: "1d", "7d", "1w", "1m", or ISO date
+ * @returns TimeRange with oldest and latest dates
+ *
+ * @example
+ * parseTimeExpression("1d")  // Today since midnight
+ * parseTimeExpression("7d")  // Last 7 days
+ * parseTimeExpression("1w")  // Last week (same as 7d)
+ * parseTimeExpression("1m")  // Last month
+ * parseTimeExpression("2024-01-01")  // Since specific date
+ */
+function parseTimeExpression(expr) {
+    const now = new Date();
+    const startOfToday = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+    // Relative time: 1d, 7d, 1w, 1m
+    const relativeMatch = expr.match(/^(\d+)([dwm])$/);
+    if (relativeMatch) {
+        const num = parseInt(relativeMatch[1], 10);
+        const unit = relativeMatch[2];
+        let oldest;
+        switch (unit) {
+            case 'd':
+                oldest = new Date(startOfToday.getTime() - (num - 1) * 24 * 60 * 60 * 1000);
+                break;
+            case 'w':
+                oldest = new Date(startOfToday.getTime() - (num * 7 - 1) * 24 * 60 * 60 * 1000);
+                break;
+            case 'm':
+                oldest = new Date(startOfToday);
+                oldest.setMonth(oldest.getMonth() - num);
+                break;
+            default:
+                throw new Error(`Invalid time unit: ${unit}`);
+        }
+        return { oldest, latest: now, start: oldest, end: now };
+    }
+    // ISO date: 2024-01-01
+    const dateMatch = expr.match(/^(\d{4}-\d{2}-\d{2})$/);
+    if (dateMatch) {
+        const oldest = new Date(dateMatch[1]);
+        if (isNaN(oldest.getTime())) {
+            throw new Error(`Invalid date format: ${expr}`);
+        }
+        return { oldest, latest: now, start: oldest, end: now };
+    }
+    // Unix timestamp (10 digits)
+    const unixMatch = expr.match(/^(\d{10})$/);
+    if (unixMatch) {
+        const oldest = new Date(parseInt(unixMatch[1], 10) * 1000);
+        return { oldest, latest: now, start: oldest, end: now };
+    }
+    throw new Error(`Invalid time expression: "${expr}". ` +
+        `Use formats like "1d", "7d", "1w", "1m", or ISO date "2024-01-01"`);
+}
+/**
+ * Convert Date to Rocket.Chat timestamp format
+ */
+function toRocketChatTimestamp(date) {
+    return date.toISOString();
+}
+/**
+ * Format date for display
+ */
+function formatDate(date) {
+    return date.toISOString().replace('T', ' ').substring(0, 19);
+}
+/**
+ * Format relative time ago
+ */
+function timeAgo(date) {
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    const diffMins = Math.floor(diffMs / 60000);
+    const diffHours = Math.floor(diffMins / 60);
+    const diffDays = Math.floor(diffHours / 24);
+    if (diffMins < 1)
+        return 'just now';
+    if (diffMins < 60)
+        return `${diffMins}m ago`;
+    if (diffHours < 24)
+        return `${diffHours}h ago`;
+    if (diffDays < 7)
+        return `${diffDays}d ago`;
+    return formatDate(date);
+}
+//# sourceMappingURL=time-parser.js.map

package/dist/utils/time-parser.js.map

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

package/dist/utils/token-counter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Token counting utility for preventing response size overflow
+ * Estimates token count based on character length (rough approximation)
+ */
+export interface TruncateResult<T> {
+    items: T[];
+    truncated: boolean;
+    originalCount: number;
+}
+export declare class TokenCounter {
+    private static readonly CHARS_PER_TOKEN;
+    private static readonly MAX_RESPONSE_CHARS;
+    private static readonly SAFETY_BUFFER;
+    /**
+     * Estimate token count from text
+     */
+    static estimateTokens(text: string): number;
+    /**
+     * Check if text would exceed token limit
+     */
+    static wouldExceedLimit(text: string): boolean;
+    /**
+     * Get maximum safe character count
+     */
+    static getMaxSafeChars(): number;
+    /**
+     * Get safe limit for number of items based on average item size
+     */
+    static getSafeItemLimit(sampleItem: unknown, maxItems?: number): number;
+    /**
+     * Truncate array to fit within token limit
+     */
+    static truncateToFit<T>(items: T[], stringify?: (item: T) => string): TruncateResult<T>;
+    /**
+     * Truncate text to fit within limit
+     */
+    static truncateText(text: string, maxChars?: number): {
+        text: string;
+        truncated: boolean;
+    };
+}
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/utils/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../src/utils/token-counter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC7B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAK;IAG5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAGpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAQ;IAE7C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9C;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM;IAIhC;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAY,GAAG,MAAM;IAS5E;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,EAClB,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,GAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAuB,GAChD,cAAc,CAAC,CAAC,CAAC;IAyBpB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;CAU7F"}

package/dist/utils/token-counter.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Token counting utility for preventing response size overflow
+ * Estimates token count based on character length (rough approximation)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenCounter = void 0;
+class TokenCounter {
+    // Rough estimation: 1 token ≈ 4 characters
+    static CHARS_PER_TOKEN = 4;
+    // MCP response character limit (~25,000 tokens)
+    static MAX_RESPONSE_CHARS = 100000;
+    // Safety buffer to ensure we don't exceed limits
+    static SAFETY_BUFFER = 4000;
+    /**
+     * Estimate token count from text
+     */
+    static estimateTokens(text) {
+        return Math.ceil(text.length / this.CHARS_PER_TOKEN);
+    }
+    /**
+     * Check if text would exceed token limit
+     */
+    static wouldExceedLimit(text) {
+        return text.length > (this.MAX_RESPONSE_CHARS - this.SAFETY_BUFFER);
+    }
+    /**
+     * Get maximum safe character count
+     */
+    static getMaxSafeChars() {
+        return this.MAX_RESPONSE_CHARS - this.SAFETY_BUFFER;
+    }
+    /**
+     * Get safe limit for number of items based on average item size
+     */
+    static getSafeItemLimit(sampleItem, maxItems = 100) {
+        const sampleText = JSON.stringify(sampleItem);
+        const charsPerItem = sampleText.length;
+        const maxChars = this.MAX_RESPONSE_CHARS - this.SAFETY_BUFFER;
+        const safeItemCount = Math.floor(maxChars / charsPerItem);
+        return Math.min(safeItemCount, maxItems);
+    }
+    /**
+     * Truncate array to fit within token limit
+     */
+    static truncateToFit(items, stringify = JSON.stringify) {
+        const maxChars = this.MAX_RESPONSE_CHARS - this.SAFETY_BUFFER;
+        let totalSize = 0;
+        const safeItems = [];
+        for (const item of items) {
+            const itemSize = stringify(item).length;
+            if (totalSize + itemSize > maxChars) {
+                return {
+                    items: safeItems,
+                    truncated: true,
+                    originalCount: items.length
+                };
+            }
+            safeItems.push(item);
+            totalSize += itemSize;
+        }
+        return {
+            items: safeItems,
+            truncated: false,
+            originalCount: items.length
+        };
+    }
+    /**
+     * Truncate text to fit within limit
+     */
+    static truncateText(text, maxChars) {
+        const limit = maxChars || (this.MAX_RESPONSE_CHARS - this.SAFETY_BUFFER);
+        if (text.length <= limit) {
+            return { text, truncated: false };
+        }
+        const truncatedText = text.substring(0, limit - 20) + '... [truncated]';
+        return { text: truncatedText, truncated: true };
+    }
+}
+exports.TokenCounter = TokenCounter;
+//# sourceMappingURL=token-counter.js.map