@mseep/mcp-agent-social 1.1.0

package/dist/index.js

@@ -0,0 +1,186 @@
+// ABOUTME: Main entry point for the MCP Agent Social Media Server
+// ABOUTME: Initializes and starts the MCP server with social media tools
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ApiClient } from './api-client.js';
+import { ENV_KEYS, config, validateConfig, version } from './config.js';
+import { hooksManager } from './hooks/index.js';
+import { HttpMcpServer } from './http-server.js';
+import { logger } from './logger.js';
+import { metrics } from './metrics.js';
+import { registerPrompts } from './prompts/index.js';
+import { registerResources } from './resources/index.js';
+import { registerRoots } from './roots/index.js';
+import { SessionManager } from './session-manager.js';
+import { registerTools } from './tools/index.js';
+// Initialize shared components
+const sessionManager = new SessionManager();
+const apiClient = new ApiClient();
+// Server instances
+let mcpServer = null;
+let httpServer = null;
+// Store cleanup interval globally for shutdown
+let cleanupInterval = null;
+let keepAliveInterval = null;
+async function main() {
+    try {
+        // Log startup information
+        logger.info('MCP Server starting', {
+            nodeVersion: process.version,
+            platform: process.platform,
+            pid: process.pid,
+            logLevel: process.env[ENV_KEYS.LOG_LEVEL] || 'INFO',
+        });
+        validateConfig();
+        // Log configuration (without sensitive data)
+        logger.info(`Starting MCP server for team: ${config.teamName}`);
+        logger.debug('Configuration loaded', {
+            baseUrl: config.socialApiBaseUrl,
+            teamName: config.teamName,
+            timeout: config.apiTimeout,
+            logLevel: config.logLevel,
+        });
+        // Determine transport mode
+        const transportMode = process.env[ENV_KEYS.MCP_TRANSPORT] || 'stdio';
+        if (transportMode === 'http') {
+            // HTTP mode
+            const httpPort = Number.parseInt(process.env[ENV_KEYS.MCP_HTTP_PORT] || '3000', 10);
+            const httpHost = process.env[ENV_KEYS.MCP_HTTP_HOST] || 'localhost';
+            logger.info('Starting in HTTP mode', { port: httpPort, host: httpHost });
+            httpServer = new HttpMcpServer(sessionManager, apiClient, {
+                port: httpPort,
+                host: httpHost,
+                enableJsonResponse: process.env[ENV_KEYS.MCP_ENABLE_JSON] === 'true',
+                corsOrigin: process.env[ENV_KEYS.MCP_CORS_ORIGIN] || '*',
+            });
+            await httpServer.start();
+        }
+        else {
+            // Stdio mode (default)
+            logger.info('Starting in stdio mode');
+            mcpServer = new McpServer({
+                name: 'mcp-agent-social',
+                version,
+            });
+            const transport = new StdioServerTransport();
+            // Register all capabilities
+            registerTools(mcpServer, { sessionManager, apiClient, hooksManager });
+            registerResources(mcpServer, { apiClient, sessionManager, hooksManager });
+            registerPrompts(mcpServer, { apiClient, sessionManager, hooksManager });
+            registerRoots(mcpServer, { apiClient, sessionManager, hooksManager });
+            // Connect to transport
+            logger.debug('Connecting server to transport');
+            await mcpServer.connect(transport);
+            logger.info('Server connected successfully');
+        }
+        // The transport itself doesn't expose error handlers, but we can handle stdio events
+        process.stdin.on('error', (error) => {
+            logger.error('Stdin error', { error: error.message, stack: error.stack });
+            shutdown('STDIN_ERROR');
+        });
+        process.stdout.on('error', (error) => {
+            logger.error('Stdout error', { error: error.message, stack: error.stack });
+            shutdown('STDOUT_ERROR');
+        });
+        process.stdin.on('close', () => {
+            logger.warn('Stdin closed unexpectedly');
+            shutdown('STDIN_CLOSE');
+        });
+        process.stdin.on('end', () => {
+            logger.warn('Stdin ended');
+            shutdown('STDIN_END');
+        });
+        logger.info('MCP Agent Social Server running', {
+            toolsCount: 3,
+            resourcesCount: 6,
+            promptsCount: 8,
+            rootsEnabled: true,
+            hooksCount: hooksManager.getAllHooks().length,
+            transport: 'stdio',
+        });
+        // Set up graceful shutdown
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        // Handle uncaught errors to prevent sudden crashes
+        process.on('uncaughtException', (error) => {
+            // Prevent infinite loops when logging EPIPE errors
+            if (error instanceof Error && 'code' in error && error.code === 'EPIPE') {
+                // Don't try to log EPIPE errors - just shutdown silently
+                shutdown('UNCAUGHT_EXCEPTION');
+                return;
+            }
+            logger.error('Uncaught exception', { error: error.message, stack: error.stack });
+            shutdown('UNCAUGHT_EXCEPTION');
+        });
+        process.on('unhandledRejection', (reason, promise) => {
+            // Prevent infinite loops when rejection is due to EPIPE errors
+            if (reason instanceof Error && 'code' in reason && reason.code === 'EPIPE') {
+                // Don't try to log EPIPE-related rejections - just shutdown silently
+                shutdown('UNHANDLED_REJECTION');
+                return;
+            }
+            logger.error('Unhandled rejection', { reason, promise });
+            shutdown('UNHANDLED_REJECTION');
+        });
+        // Set up periodic session cleanup (every 30 minutes)
+        cleanupInterval = setInterval(async () => {
+            const removed = await sessionManager.cleanupOldSessions(3600000); // 1 hour
+            if (removed > 0) {
+                logger.info(`Cleaned up ${removed} old sessions`);
+            }
+        }, 1800000); // 30 minutes
+        // Set up keepalive to prevent connection timeout
+        keepAliveInterval = setInterval(() => {
+            logger.debug('Keepalive ping', { uptime: process.uptime() });
+        }, 30000); // Every 30 seconds
+    }
+    catch (error) {
+        logger.error('Failed to start server', {
+            error: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : undefined,
+        });
+        process.exit(1);
+    }
+}
+async function shutdown(signal) {
+    logger.serverShutdown(signal);
+    logger.warn(`Received ${signal}, shutting down gracefully...`);
+    // Clear intervals
+    if (cleanupInterval) {
+        clearInterval(cleanupInterval);
+    }
+    if (keepAliveInterval) {
+        clearInterval(keepAliveInterval);
+    }
+    // Shutdown metrics collector
+    metrics.shutdown();
+    // Clean up sessions
+    const sessionCount = sessionManager.getSessionCount();
+    if (sessionCount > 0) {
+        logger.info(`Cleaning up ${sessionCount} active sessions...`);
+        await sessionManager.clearAllSessions();
+    }
+    // Close server
+    try {
+        if (httpServer) {
+            await httpServer.stop();
+            logger.info('HTTP server closed successfully');
+        }
+        else if (mcpServer) {
+            await mcpServer.close();
+            logger.info('MCP server closed successfully');
+        }
+    }
+    catch (error) {
+        logger.error('Error closing server', { error });
+    }
+    // Exit with appropriate code
+    const exitCode = signal === 'UNCAUGHT_EXCEPTION' || signal === 'UNHANDLED_REJECTION' ? 1 : 0;
+    process.exit(exitCode);
+}
+main().catch((error) => {
+    // Write to stderr to avoid polluting JSON-RPC stream in stdio mode
+    process.stderr.write(`Unhandled error: ${error}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,44 @@
+export declare enum LogLevel {
+    SILENT = -1,
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
+export interface LogContext {
+    tool?: string;
+    sessionId?: string;
+    agentName?: string;
+    requestId?: string;
+    [key: string]: unknown;
+}
+export declare class Logger {
+    private static instance;
+    private logLevel;
+    private startTime;
+    private isStdioMode;
+    private logFile;
+    private instanceId;
+    private constructor();
+    static getInstance(): Logger;
+    private parseLogLevel;
+    private formatMessage;
+    private log;
+    error(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    debug(message: string, context?: LogContext): void;
+    toolStart(toolName: string, args: unknown, context?: LogContext): void;
+    toolSuccess(toolName: string, duration: number, context?: LogContext): void;
+    toolError(toolName: string, error: Error, duration: number, context?: LogContext): void;
+    sessionCreated(sessionId: string, agentName: string): void;
+    sessionDeleted(sessionId: string, agentName?: string): void;
+    sessionValidationFailed(sessionId: string, reason: string): void;
+    apiRequest(method: string, url: string, context?: LogContext): void;
+    apiResponse(method: string, url: string, status: number, duration: number, context?: LogContext): void;
+    apiError(method: string, url: string, error: Error, context?: LogContext): void;
+    performance(operation: string, duration: number, context?: LogContext): void;
+    serverShutdown(reason: string, context?: LogContext): void;
+}
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAQA,oBAAY,QAAQ;IAClB,MAAM,KAAK;IACX,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO;IAkCP,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,aAAa;IAkCrB,OAAO,CAAC,GAAG;IAoDX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAKlD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAQtE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAS3E,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAYvF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI1D,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3D,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAShE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IASnE,WAAW,CACT,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,UAAU,GACnB,IAAI;IAaP,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAW/E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAY5E,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;CAgC3D;AAGD,eAAO,MAAM,MAAM,QAAuB,CAAC"}

package/dist/logger.js

@@ -0,0 +1,281 @@
+// ABOUTME: Enhanced logging utility for the MCP Agent Social Media Server
+// ABOUTME: Provides structured logging with levels, context, and performance tracking
+import { appendFileSync, existsSync, writeFileSync } from 'node:fs';
+import { mkdirSync } from 'node:fs';
+import { basename, dirname } from 'node:path';
+import { ENV_KEYS } from './config.js';
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["SILENT"] = -1] = "SILENT";
+    LogLevel[LogLevel["ERROR"] = 0] = "ERROR";
+    LogLevel[LogLevel["WARN"] = 1] = "WARN";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["DEBUG"] = 3] = "DEBUG";
+})(LogLevel || (LogLevel = {}));
+export class Logger {
+    static instance;
+    logLevel;
+    startTime;
+    isStdioMode;
+    logFile;
+    instanceId;
+    constructor() {
+        this.logLevel = this.parseLogLevel(process.env[ENV_KEYS.LOG_LEVEL] || 'INFO');
+        this.startTime = Date.now();
+        this.isStdioMode = process.env[ENV_KEYS.MCP_TRANSPORT] !== 'http';
+        this.logFile = process.env.LOG_FILE || null;
+        // Create instance identifier from current working directory + process ID
+        const dirName = basename(process.cwd()) || 'unknown';
+        this.instanceId = `${dirName}:${process.pid}`;
+        // Initialize log file if specified
+        if (this.logFile) {
+            try {
+                // Ensure directory exists
+                const logDir = dirname(this.logFile);
+                if (!existsSync(logDir)) {
+                    mkdirSync(logDir, { recursive: true });
+                }
+                // Write startup banner to log file
+                const banner = `\n=== MCP Agent Social Server [${this.instanceId}] Started at ${new Date().toISOString()} ===\n`;
+                if (existsSync(this.logFile)) {
+                    appendFileSync(this.logFile, banner);
+                }
+                else {
+                    writeFileSync(this.logFile, banner);
+                }
+            }
+            catch (error) {
+                // If file logging fails, continue without it but log to stderr
+                process.stderr.write(`Failed to initialize log file ${this.logFile}: ${error}\n`);
+                this.logFile = null;
+            }
+        }
+    }
+    static getInstance() {
+        if (!Logger.instance) {
+            Logger.instance = new Logger();
+        }
+        return Logger.instance;
+    }
+    parseLogLevel(level) {
+        switch (level.toUpperCase()) {
+            case 'SILENT':
+                return LogLevel.SILENT;
+            case 'ERROR':
+                return LogLevel.ERROR;
+            case 'WARN':
+                return LogLevel.WARN;
+            case 'INFO':
+                return LogLevel.INFO;
+            case 'DEBUG':
+                return LogLevel.DEBUG;
+            default:
+                return LogLevel.INFO;
+        }
+    }
+    formatMessage(level, message, context) {
+        const timestamp = new Date().toISOString();
+        const uptime = Math.floor((Date.now() - this.startTime) / 1000);
+        let contextStr = '';
+        if (context) {
+            try {
+                contextStr = ` ${JSON.stringify(context)}`;
+            }
+            catch (error) {
+                // Handle circular references or other JSON serialization errors
+                contextStr = ` ${JSON.stringify({
+                    ...context,
+                    _jsonError: error instanceof Error ? error.message : 'Unknown JSON error',
+                }, (_key, value) => {
+                    if (typeof value === 'object' && value !== null) {
+                        // Simple circular reference detection
+                        if (typeof value.toString === 'function' &&
+                            value.toString().includes('[object Object]')) {
+                            return '[Object]';
+                        }
+                    }
+                    return value;
+                })}`;
+            }
+        }
+        return `[${timestamp}] [${level}] [${this.instanceId}] [uptime:${uptime}s] ${message}${contextStr}`;
+    }
+    log(level, levelStr, message, context) {
+        if (level <= this.logLevel) {
+            const formattedMessage = this.formatMessage(levelStr, message, context);
+            // Always write to file if configured
+            if (this.logFile) {
+                try {
+                    appendFileSync(this.logFile, `${formattedMessage}\n`);
+                }
+                catch (error) {
+                    // If file logging fails, try stderr but don't create infinite loops
+                    try {
+                        process.stderr.write(`File logging failed: ${error}\n`);
+                    }
+                    catch (_stderrError) {
+                        // If both file and stderr fail, silently continue - avoid infinite loops
+                        // This prevents EPIPE cascades when stdio is completely broken
+                    }
+                }
+            }
+            try {
+                if (this.isStdioMode) {
+                    // In stdio mode, write to stderr to avoid polluting JSON-RPC stream
+                    process.stderr.write(`${formattedMessage}\n`);
+                }
+                else {
+                    // In HTTP mode, use console logging
+                    if (level === LogLevel.ERROR) {
+                        console.error(formattedMessage);
+                    }
+                    else {
+                        console.log(formattedMessage);
+                    }
+                }
+            }
+            catch (error) {
+                // Completely ignore EPIPE errors to prevent infinite loops
+                // These happen when stdout/stderr are closed (e.g., when Claude Desktop disconnects)
+                if (error instanceof Error && 'code' in error && error.code === 'EPIPE') {
+                    // Silent fail on EPIPE - don't try to log this error as it creates infinite loops
+                    return;
+                }
+                // Only rethrow non-EPIPE errors, but also protect against infinite loops
+                if (this.logFile) {
+                    try {
+                        appendFileSync(this.logFile, `Logger stdio error: ${error}\n`);
+                    }
+                    catch (_fileError) {
+                        // If both stdio and file fail, we're in a bad state - just return
+                        return;
+                    }
+                }
+            }
+        }
+    }
+    error(message, context) {
+        this.log(LogLevel.ERROR, 'ERROR', message, context);
+    }
+    warn(message, context) {
+        this.log(LogLevel.WARN, 'WARN', message, context);
+    }
+    info(message, context) {
+        this.log(LogLevel.INFO, 'INFO', message, context);
+    }
+    debug(message, context) {
+        this.log(LogLevel.DEBUG, 'DEBUG', message, context);
+    }
+    // Tool-specific logging helpers
+    toolStart(toolName, args, context) {
+        this.info(`Tool ${toolName} started`, {
+            tool: toolName,
+            args: args,
+            ...context,
+        });
+    }
+    toolSuccess(toolName, duration, context) {
+        this.info(`Tool ${toolName} completed`, {
+            tool: toolName,
+            duration: `${duration}ms`,
+            status: 'success',
+            ...context,
+        });
+    }
+    toolError(toolName, error, duration, context) {
+        this.error(`Tool ${toolName} failed`, {
+            tool: toolName,
+            duration: `${duration}ms`,
+            status: 'error',
+            error: error.message,
+            stack: error.stack,
+            ...context,
+        });
+    }
+    // Session-specific logging
+    sessionCreated(sessionId, agentName) {
+        this.info('Session created', { sessionId, agentName, event: 'session_created' });
+    }
+    sessionDeleted(sessionId, agentName) {
+        this.info('Session deleted', { sessionId, agentName, event: 'session_deleted' });
+    }
+    sessionValidationFailed(sessionId, reason) {
+        this.warn('Session validation failed', {
+            sessionId,
+            reason,
+            event: 'session_validation_failed',
+        });
+    }
+    // API-specific logging
+    apiRequest(method, url, context) {
+        this.debug(`API request: ${method} ${url}`, {
+            method,
+            url,
+            event: 'api_request',
+            ...context,
+        });
+    }
+    apiResponse(method, url, status, duration, context) {
+        const logMethod = status >= 400 ? this.warn.bind(this) : this.debug.bind(this);
+        logMethod(`API response: ${method} ${url} - ${status}`, {
+            method,
+            url,
+            status,
+            duration: `${duration}ms`,
+            event: 'api_response',
+            ...context,
+        });
+    }
+    apiError(method, url, error, context) {
+        this.error(`API error: ${method} ${url}`, {
+            method,
+            url,
+            error: error.message,
+            event: 'api_error',
+            ...context,
+        });
+    }
+    // Performance logging
+    performance(operation, duration, context) {
+        const logMethod = duration > 1000 ? this.warn.bind(this) : this.info.bind(this);
+        logMethod(`Performance: ${operation}`, {
+            operation,
+            duration: `${duration}ms`,
+            slow: duration > 1000,
+            ...context,
+        });
+    }
+    // Shutdown/death logging
+    serverShutdown(reason, context) {
+        const shutdownMessage = `=== SERVER SHUTDOWN: ${reason} at ${new Date().toISOString()} ===`;
+        // Always write shutdown to file if configured, even if log level is low
+        if (this.logFile) {
+            try {
+                appendFileSync(this.logFile, `${shutdownMessage}\n`);
+                if (context) {
+                    appendFileSync(this.logFile, `Context: ${JSON.stringify(context)}\n`);
+                }
+                appendFileSync(this.logFile, `Uptime: ${Math.floor((Date.now() - this.startTime) / 1000)}s\n\n`);
+            }
+            catch (error) {
+                // Even if file logging fails, try to write to stderr but avoid infinite loops
+                try {
+                    process.stderr.write(`File logging failed during shutdown: ${error}\n`);
+                }
+                catch (_stderrError) {
+                    // If both fail during shutdown, we can't do much - just continue
+                }
+            }
+        }
+        // Also log normally
+        this.error(`Server shutting down: ${reason}`, {
+            reason,
+            uptime: Math.floor((Date.now() - this.startTime) / 1000),
+            timestamp: new Date().toISOString(),
+            ...context,
+        });
+    }
+}
+// Export singleton instance
+export const logger = Logger.getInstance();
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/metrics.d.ts

@@ -0,0 +1,47 @@
+export interface Metric {
+    name: string;
+    value: number;
+    timestamp: Date;
+    tags?: Record<string, string>;
+}
+export interface OperationMetrics {
+    count: number;
+    totalDuration: number;
+    minDuration: number;
+    maxDuration: number;
+    averageDuration: number;
+    lastDuration: number;
+    errors: number;
+}
+export declare class MetricsCollector {
+    private static instance;
+    private metrics;
+    private startTime;
+    private sessionCount;
+    private activeOperations;
+    private cleanupInterval;
+    private readonly OPERATION_TIMEOUT;
+    private constructor();
+    static getInstance(): MetricsCollector;
+    startOperation(operationName: string): string;
+    endOperation(operationId: string, success?: boolean): void;
+    private cleanupStaleOperations;
+    private recordOperation;
+    incrementSessionCount(): void;
+    decrementSessionCount(): void;
+    getSessionCount(): number;
+    getOperationMetrics(operationName: string): OperationMetrics | undefined;
+    getAllMetrics(): Record<string, OperationMetrics>;
+    getSystemMetrics(): {
+        uptime: number;
+        memoryUsage: ReturnType<typeof process.memoryUsage>;
+        sessionCount: number;
+        activeOperations: number;
+    };
+    getSummary(): string;
+    reset(): void;
+    shutdown(): void;
+}
+export declare const metrics: MetricsCollector;
+export declare function withMetrics<T>(operationName: string, operation: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAC1C,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiB;IAEnD,OAAO;IAcP,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAQtC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAO7C,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,IAAI;IAevD,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,eAAe;IAiCvB,qBAAqB,IAAI,IAAI;IAI7B,qBAAqB,IAAI,IAAI;IAI7B,eAAe,IAAI,MAAM;IAKzB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAKxE,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IASjD,gBAAgB,IAAI;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC;QACpD,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IAUD,UAAU,IAAI,MAAM;IAyBpB,KAAK,IAAI,IAAI;IAiBb,QAAQ,IAAI,IAAI;CAMjB;AAGD,eAAO,MAAM,OAAO,kBAAiC,CAAC;AAGtD,wBAAsB,WAAW,CAAC,CAAC,EACjC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC,CAUZ"}