@west10tech/constructionwire-mcp 1.0.0

package/dist/services/logger.js

@@ -0,0 +1,224 @@
+/**
+ * Logger - Centralized logging service for constructionwire-mcp
+ * Provides structured logging with centralized log shipping capability
+ */
+import { LogBatcher } from './log-batcher.js';
+export class Logger {
+    constructor(config) {
+        this.batcher = null;
+        this.logLevelPriority = {
+            DEBUG: 0,
+            INFO: 1,
+            WARN: 2,
+            ERROR: 3,
+            FATAL: 4
+        };
+        this.config = config;
+        if (this.config.enableShipping && config.logShipper) {
+            this.batcher = new LogBatcher(config.logShipper);
+        }
+    }
+    /**
+     * Log a debug message
+     */
+    debug(action, message, metadata) {
+        this.log('DEBUG', action, message, metadata);
+    }
+    /**
+     * Log an info message
+     */
+    info(action, message, metadata) {
+        this.log('INFO', action, message, metadata);
+    }
+    /**
+     * Log a warning message
+     */
+    warn(action, message, metadata) {
+        this.log('WARN', action, message, metadata);
+    }
+    /**
+     * Log an error message
+     */
+    error(action, message, metadata) {
+        this.log('ERROR', action, message, metadata);
+    }
+    /**
+     * Log a fatal error message
+     */
+    fatal(action, message, metadata) {
+        this.log('FATAL', action, message, metadata);
+    }
+    /**
+     * Core logging method
+     */
+    log(level, action, message, metadata) {
+        // Check if this log level should be processed
+        if (this.logLevelPriority[level] < this.logLevelPriority[this.config.logLevel]) {
+            return;
+        }
+        const timestamp = new Date().toISOString();
+        const user = process.env.CORETEXT_USER || 'unknown';
+        const sessionId = this.batcher?.getSessionId() || `constructionwire-mcp-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+        const logEntry = {
+            timestamp,
+            sessionId,
+            user,
+            integration: '',
+            component: this.config.component,
+            level,
+            action,
+            message,
+            projectId: process.env.PROJECT_ID || '',
+            organizationId: process.env.ORGANIZATION_ID || '',
+            ...(metadata && { metadata })
+        };
+        // Always log to console (stderr) for MCP protocol compliance
+        if (this.config.enableConsole) {
+            const componentPrefix = `-${this.config.component.toUpperCase()}`;
+            console.error(`[${componentPrefix}] ${JSON.stringify(logEntry)}`);
+        }
+        // Send to centralized logging if enabled
+        if (this.config.enableShipping && this.batcher) {
+            // Create full log entry matching API specification
+            const fullLogEntry = {
+                timestamp,
+                sessionId,
+                user,
+                integration: '',
+                component: this.config.component,
+                action,
+                message,
+                projectId: process.env.PROJECT_ID || '',
+                organizationId: process.env.ORGANIZATION_ID || '',
+                ...(metadata && { metadata })
+            };
+            this.batcher.addStructuredLog(fullLogEntry);
+        }
+    }
+    /**
+     * Log HTTP request start
+     */
+    logRequestStart(method, url, metadata) {
+        this.debug('HTTP_REQUEST_START', `${method} ${url}`, {
+            method,
+            url,
+            ...metadata
+        });
+    }
+    /**
+     * Log HTTP request success
+     */
+    logRequestSuccess(method, url, status, duration, metadata) {
+        this.info('HTTP_REQUEST_SUCCESS', `${method} ${url} - ${status} (${duration}ms)`, {
+            method,
+            url,
+            status,
+            duration_ms: duration,
+            ...metadata
+        });
+    }
+    /**
+     * Log HTTP request error
+     */
+    logRequestError(method, url, error, duration, metadata) {
+        this.error('HTTP_REQUEST_ERROR', `${method} ${url} - ${error.message || error}`, {
+            method,
+            url,
+            error: error.message || String(error),
+            duration_ms: duration,
+            status: error.status || error.response?.status,
+            ...metadata
+        });
+    }
+    /**
+     * Log tool execution start
+     */
+    logToolStart(toolName, params) {
+        this.info(toolName, `Executing ${toolName}`, {
+            toolParams: params,
+            paramCount: Object.keys(params || {}).length,
+            executionId: `exec_${Date.now()}_${Math.random().toString(36).substring(2, 6)}`
+        });
+    }
+    /**
+     * Log tool execution success
+     */
+    logToolSuccess(toolName, duration, responseData, httpStatus) {
+        this.info(toolName, `${toolName} completed successfully`, {
+            duration_ms: duration,
+            responseData: this.truncateIfNeeded(responseData),
+            responseSize: responseData ? JSON.stringify(responseData).length : 0,
+            ...(httpStatus && { httpStatus })
+        });
+    }
+    /**
+     * Log tool execution error
+     */
+    logToolError(toolName, error, duration, params) {
+        this.error(toolName, `${toolName} failed`, {
+            duration_ms: duration,
+            errorDetails: {
+                message: error.message || String(error),
+                stack: error.stack,
+                code: error.code,
+                status: error.status || error.response?.status
+            },
+            toolParams: params,
+            errorType: error.constructor?.name || 'unknown'
+        });
+    }
+    /**
+     * Log authentication events
+     */
+    logAuthEvent(event, success, metadata) {
+        const level = success ? 'INFO' : 'ERROR';
+        this.log(level, 'AUTH_EVENT', `Authentication ${event}: ${success ? 'success' : 'failed'}`, {
+            event,
+            success,
+            ...metadata
+        });
+    }
+    /**
+     * Log rate limiting events
+     */
+    logRateLimit(action, delayMs, metadata) {
+        this.warn('RATE_LIMIT', `Rate limit applied: ${action}`, {
+            action,
+            delay_ms: delayMs,
+            ...metadata
+        });
+    }
+    /**
+     * Truncate large data objects to prevent oversized log entries
+     */
+    truncateIfNeeded(data, maxSize = 10000) {
+        if (!data)
+            return data;
+        const jsonString = JSON.stringify(data);
+        if (jsonString.length <= maxSize)
+            return data;
+        return {
+            _truncated: true,
+            _originalSize: jsonString.length,
+            _data: `[TRUNCATED - Original size: ${jsonString.length} chars]`
+        };
+    }
+    /**
+     * Get logger status
+     */
+    getStatus() {
+        return {
+            config: this.config,
+            ...(this.batcher && { batcherStatus: this.batcher.getBatchStatus() })
+        };
+    }
+    /**
+     * Shutdown logger and flush remaining logs
+     */
+    async shutdown() {
+        if (this.batcher) {
+            await this.batcher.shutdown();
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/services/logger.js.map

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

package/dist/services/progress-reporter.d.ts

@@ -0,0 +1,64 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { Logger } from './logger.js';
+import { RequestTracker } from './request-tracker.js';
+export interface ProgressUpdate {
+    progress: number;
+    total?: number;
+    message?: string;
+}
+export declare class ProgressReporter {
+    private server;
+    private logger;
+    private requestTracker;
+    private progressStates;
+    private minUpdateInterval;
+    constructor(server: Server, logger: Logger, requestTracker: RequestTracker);
+    /**
+     * Report progress for a given token
+     */
+    report(progressToken: string | number, update: ProgressUpdate): Promise<void>;
+    /**
+     * Report progress with percentage helper
+     */
+    reportPercentage(progressToken: string | number, percentage: number, message?: string): Promise<void>;
+    /**
+     * Report progress for multi-step operations
+     */
+    reportStep(progressToken: string | number, currentStep: number, totalSteps: number, message?: string): Promise<void>;
+    /**
+     * Report progress for batch operations
+     */
+    reportBatch(progressToken: string | number, processedItems: number, totalItems: number, itemType?: string): Promise<void>;
+    /**
+     * Clean up progress state for a token
+     */
+    cleanup(progressToken: string | number): void;
+    /**
+     * Clean up all progress states for completed requests
+     */
+    cleanupCompletedRequests(): void;
+    /**
+     * Create a progress callback function for use in async operations
+     */
+    createProgressCallback(progressToken: string | number): (update: ProgressUpdate) => Promise<void>;
+    /**
+     * Create a simple percentage-based progress callback
+     */
+    createPercentageCallback(progressToken: string | number): (percentage: number, message?: string) => Promise<void>;
+    /**
+     * Get statistics about progress reporting
+     */
+    getStats(): {
+        activeProgressTokens: number;
+        progressStates: Array<{
+            token: string | number;
+            lastProgress: number;
+            updateCount: number;
+        }>;
+    };
+    /**
+     * Shutdown and clean up
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=progress-reporter.d.ts.map

package/dist/services/progress-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-reporter.d.ts","sourceRoot":"","sources":["../../src/services/progress-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,iBAAiB,CAAe;gBAE5B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc;IAO1E;;OAEG;IACG,MAAM,CACV,aAAa,EAAE,MAAM,GAAG,MAAM,EAC9B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC;IA8EhB;;OAEG;IACG,gBAAgB,CACpB,aAAa,EAAE,MAAM,GAAG,MAAM,EAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;IACG,UAAU,CACd,aAAa,EAAE,MAAM,GAAG,MAAM,EAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACG,WAAW,CACf,aAAa,EAAE,MAAM,GAAG,MAAM,EAC9B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAgB,GACzB,OAAO,CAAC,IAAI,CAAC;IAShB;;OAEG;IACH,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAY7C;;OAEG;IACH,wBAAwB,IAAI,IAAI;IAkBhC;;OAEG;IACH,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC;IAMjG;;OAEG;IACH,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;IAMjH;;OAEG;IACH,QAAQ,IAAI;QACV,oBAAoB,EAAE,MAAM,CAAC;QAC7B,cAAc,EAAE,KAAK,CAAC;YACpB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;YACvB,YAAY,EAAE,MAAM,CAAC;YACrB,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;KACJ;IAaD;;OAEG;IACH,QAAQ,IAAI,IAAI;CAMjB"}

package/dist/services/progress-reporter.js

@@ -0,0 +1,192 @@
+export class ProgressReporter {
+    constructor(server, logger, requestTracker) {
+        this.minUpdateInterval = 100; // Minimum 100ms between updates
+        this.server = server;
+        this.logger = logger;
+        this.requestTracker = requestTracker;
+        this.progressStates = new Map();
+    }
+    /**
+     * Report progress for a given token
+     */
+    async report(progressToken, update) {
+        // Validate that the progress token is still active
+        if (!this.requestTracker.isProgressTokenActive(progressToken)) {
+            this.logger.debug('PROGRESS_TOKEN_INACTIVE', 'Progress token no longer active', {
+                progressToken,
+                progress: update.progress
+            });
+            return;
+        }
+        // Get or create progress state
+        const state = this.progressStates.get(progressToken);
+        const now = Date.now();
+        // Validate progress value increases
+        if (state && update.progress <= state.lastProgress) {
+            this.logger.warn('PROGRESS_NOT_INCREASING', 'Progress value must increase', {
+                progressToken,
+                lastProgress: state.lastProgress,
+                newProgress: update.progress
+            });
+            return;
+        }
+        // Check rate limiting
+        if (state && (now - state.lastUpdateTime) < this.minUpdateInterval) {
+            this.logger.debug('PROGRESS_RATE_LIMITED', 'Progress update rate limited', {
+                progressToken,
+                timeSinceLastUpdate: now - state.lastUpdateTime,
+                minInterval: this.minUpdateInterval
+            });
+            return;
+        }
+        try {
+            // Send progress notification
+            await this.server.notification({
+                method: "notifications/progress",
+                params: {
+                    progressToken,
+                    progress: update.progress,
+                    ...(update.total !== undefined && { total: update.total }),
+                    ...(update.message && { message: update.message })
+                }
+            });
+            // Update state
+            this.progressStates.set(progressToken, {
+                lastProgress: update.progress,
+                lastUpdateTime: now,
+                updateCount: (state?.updateCount ?? 0) + 1
+            });
+            // Get request context for better logging
+            const context = this.requestTracker.getRequestByProgressToken(progressToken);
+            this.logger.info('PROGRESS_REPORTED', 'Progress notification sent', {
+                progressToken,
+                progress: update.progress,
+                total: update.total,
+                hasMessage: !!update.message,
+                updateCount: (state?.updateCount ?? 0) + 1,
+                requestId: context?.requestId,
+                toolName: context?.toolName
+            });
+            // Clean up if progress is complete
+            if (update.total !== undefined && update.progress >= update.total) {
+                this.cleanup(progressToken);
+            }
+        }
+        catch (error) {
+            this.logger.error('PROGRESS_REPORT_ERROR', 'Failed to send progress notification', {
+                progressToken,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    /**
+     * Report progress with percentage helper
+     */
+    async reportPercentage(progressToken, percentage, message) {
+        if (percentage < 0 || percentage > 100) {
+            this.logger.warn('PROGRESS_PERCENTAGE_INVALID', 'Invalid percentage value', {
+                progressToken,
+                percentage
+            });
+            return;
+        }
+        await this.report(progressToken, {
+            progress: percentage,
+            total: 100,
+            message
+        });
+    }
+    /**
+     * Report progress for multi-step operations
+     */
+    async reportStep(progressToken, currentStep, totalSteps, message) {
+        await this.report(progressToken, {
+            progress: currentStep,
+            total: totalSteps,
+            message
+        });
+    }
+    /**
+     * Report progress for batch operations
+     */
+    async reportBatch(progressToken, processedItems, totalItems, itemType = 'items') {
+        const percentage = Math.round((processedItems / totalItems) * 100);
+        await this.report(progressToken, {
+            progress: processedItems,
+            total: totalItems,
+            message: `Processed ${processedItems} of ${totalItems} ${itemType} (${percentage}%)`
+        });
+    }
+    /**
+     * Clean up progress state for a token
+     */
+    cleanup(progressToken) {
+        const state = this.progressStates.get(progressToken);
+        if (state) {
+            this.logger.debug('PROGRESS_CLEANUP', 'Cleaning up progress state', {
+                progressToken,
+                finalProgress: state.lastProgress,
+                totalUpdates: state.updateCount
+            });
+            this.progressStates.delete(progressToken);
+        }
+    }
+    /**
+     * Clean up all progress states for completed requests
+     */
+    cleanupCompletedRequests() {
+        let cleanedCount = 0;
+        for (const [progressToken] of this.progressStates.entries()) {
+            if (!this.requestTracker.isProgressTokenActive(progressToken)) {
+                this.progressStates.delete(progressToken);
+                cleanedCount++;
+            }
+        }
+        if (cleanedCount > 0) {
+            this.logger.info('PROGRESS_CLEANUP_COMPLETED', 'Cleaned up inactive progress states', {
+                cleanedCount,
+                remainingStates: this.progressStates.size
+            });
+        }
+    }
+    /**
+     * Create a progress callback function for use in async operations
+     */
+    createProgressCallback(progressToken) {
+        return async (update) => {
+            await this.report(progressToken, update);
+        };
+    }
+    /**
+     * Create a simple percentage-based progress callback
+     */
+    createPercentageCallback(progressToken) {
+        return async (percentage, message) => {
+            await this.reportPercentage(progressToken, percentage, message);
+        };
+    }
+    /**
+     * Get statistics about progress reporting
+     */
+    getStats() {
+        const progressStates = Array.from(this.progressStates.entries()).map(([token, state]) => ({
+            token,
+            lastProgress: state.lastProgress,
+            updateCount: state.updateCount
+        }));
+        return {
+            activeProgressTokens: this.progressStates.size,
+            progressStates
+        };
+    }
+    /**
+     * Shutdown and clean up
+     */
+    shutdown() {
+        this.logger.info('PROGRESS_REPORTER_SHUTDOWN', 'Shutting down progress reporter', {
+            activeStates: this.progressStates.size
+        });
+        this.progressStates.clear();
+    }
+}
+//# sourceMappingURL=progress-reporter.js.map

package/dist/services/progress-reporter.js.map

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

package/dist/services/request-tracker.d.ts

@@ -0,0 +1,55 @@
+import { Logger } from './logger.js';
+export interface RequestContext {
+    requestId: string | number;
+    abortController: AbortController;
+    progressToken?: string | number;
+    startTime: number;
+    toolName?: string;
+}
+export declare class RequestTracker {
+    private activeRequests;
+    private progressTokens;
+    private logger;
+    constructor(logger: Logger);
+    /**
+     * Register a new request for tracking
+     */
+    registerRequest(requestId: string | number, progressToken?: string | number, toolName?: string): RequestContext;
+    /**
+     * Get request context by ID
+     */
+    getRequest(requestId: string | number): RequestContext | undefined;
+    /**
+     * Get request context by progress token
+     */
+    getRequestByProgressToken(progressToken: string | number): RequestContext | undefined;
+    /**
+     * Cancel a request
+     */
+    cancelRequest(requestId: string | number, reason?: string): boolean;
+    /**
+     * Clean up a completed or cancelled request
+     */
+    cleanup(requestId: string | number): void;
+    /**
+     * Check if a request is still active
+     */
+    isActive(requestId: string | number): boolean;
+    /**
+     * Check if a progress token is valid and active
+     */
+    isProgressTokenActive(progressToken: string | number): boolean;
+    /**
+     * Get all active request IDs
+     */
+    getActiveRequestIds(): (string | number)[];
+    /**
+     * Clean up old requests (called periodically)
+     */
+    cleanupStaleRequests(maxAgeMs?: number): number;
+    /**
+     * Shutdown and clean up all requests
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=request-tracker.d.ts.map

package/dist/services/request-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-tracker.d.ts","sourceRoot":"","sources":["../../src/services/request-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAM1B;;OAEG;IACH,eAAe,CACb,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,cAAc;IAmCjB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS;IAIlE;;OAEG;IACH,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS;IAQrF;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAuCnE;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAwBzC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAK7C;;OAEG;IACH,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAQ9D;;OAEG;IACH,mBAAmB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE;IAI1C;;OAEG;IACH,oBAAoB,CAAC,QAAQ,GAAE,MAAe,GAAG,MAAM;IAkCvD;;OAEG;IACH,QAAQ,IAAI,IAAI;CAgBjB"}