@creatoria/miniapp-mcp 0.1.0

package/dist/core/session.js

@@ -0,0 +1,306 @@
+/**
+ * Session management for MCP connections
+ * Each session maintains isolated state for miniProgram instances and elements
+ */
+import { join } from 'path';
+import { createLogger } from './logger.js';
+import { createOutputManager } from './output.js';
+import { generateAndSaveReports } from './report-generator.js';
+const DEFAULT_SESSION_TIMEOUT = 30 * 60 * 1000; // 30 minutes
+const DEFAULT_OUTPUT_DIR = '.mcp-artifacts';
+export class SessionStore {
+    sessions = new Map();
+    sessionTimeout;
+    outputDir;
+    loggerConfig;
+    enableSessionReport;
+    cleanupInterval;
+    constructor(config = {}) {
+        this.sessionTimeout = config.sessionTimeout || DEFAULT_SESSION_TIMEOUT;
+        this.outputDir = config.outputDir || DEFAULT_OUTPUT_DIR;
+        this.loggerConfig = config.loggerConfig;
+        this.enableSessionReport = config.enableSessionReport || false;
+        // Start periodic cleanup of timed-out sessions
+        this.startCleanupTimer();
+    }
+    /**
+     * Get session by ID
+     */
+    get(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session && this.isSessionExpired(session)) {
+            console.error(`Session ${sessionId} has expired, cleaning up...`);
+            // Remove from map immediately (synchronous)
+            this.sessions.delete(sessionId);
+            // Fire-and-forget cleanup of resources (async operation)
+            void this.cleanupSessionResources(session, sessionId).catch((error) => {
+                console.error(`Failed to cleanup expired session ${sessionId}:`, error);
+            });
+            return undefined;
+        }
+        return session;
+    }
+    /**
+     * Set session state
+     */
+    set(sessionId, state) {
+        this.sessions.set(sessionId, state);
+    }
+    /**
+     * Cleanup session resources (internal helper)
+     *
+     * @throws AggregateError if cleanup operations fail
+     */
+    async cleanupSessionResources(session, sessionId) {
+        const errors = [];
+        // F3: Generate session reports before cleanup (fire-and-forget)
+        if (session.reportData) {
+            try {
+                await generateAndSaveReports(session);
+                console.error(`Session reports generated for ${sessionId}`);
+            }
+            catch (error) {
+                // Don't add to errors - report generation failure shouldn't block cleanup
+                console.error(`Failed to generate session reports for ${sessionId}:`, error);
+            }
+        }
+        // Issue #5: Dispose logger after report generation (to capture report logs)
+        if (session.logger?.dispose) {
+            try {
+                await session.logger.dispose();
+                console.error(`Logger disposed for session ${sessionId}`);
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                errors.push(new Error(`Failed to dispose logger: ${err.message}`));
+                console.error(`Failed to dispose logger for session ${sessionId}:`, error);
+            }
+        }
+        // Clean up miniProgram instance (async operation)
+        if (session.miniProgram) {
+            try {
+                if (typeof session.miniProgram.disconnect === 'function') {
+                    await session.miniProgram.disconnect();
+                }
+                console.error(`Disconnected miniProgram for session ${sessionId}`);
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                errors.push(new Error(`Failed to disconnect miniProgram: ${err.message}`));
+                console.error(`Failed to disconnect miniProgram for session ${sessionId}:`, error);
+            }
+        }
+        // Clean up IDE process (async operation - wait for exit)
+        const ideProcess = session.ideProcess;
+        if (ideProcess) {
+            try {
+                if (typeof ideProcess.kill === 'function') {
+                    // Wait for process to actually exit (only if once method exists)
+                    if (typeof ideProcess.once === 'function') {
+                        await new Promise((resolve, reject) => {
+                            const timeout = setTimeout(() => {
+                                reject(new Error('IDE process did not exit within 5 seconds'));
+                            }, 5000);
+                            ideProcess.once('exit', () => {
+                                clearTimeout(timeout);
+                                resolve();
+                            });
+                            ideProcess.kill();
+                        });
+                    }
+                    else {
+                        // For test mocks or processes without event emitter
+                        ideProcess.kill();
+                    }
+                }
+                console.error(`Killed IDE process for session ${sessionId}`);
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                errors.push(new Error(`Failed to kill IDE process: ${err.message}`));
+                console.error(`Failed to kill IDE process for session ${sessionId}:`, error);
+            }
+        }
+        // Clear element cache (sync operation)
+        try {
+            session.elements.clear();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            errors.push(new Error(`Failed to clear element cache: ${err.message}`));
+        }
+        // If there were any errors, throw AggregateError
+        if (errors.length > 0) {
+            console.error(`Session ${sessionId} cleanup completed with ${errors.length} error(s)`);
+            throw new AggregateError(errors, `Session cleanup had ${errors.length} error(s)`);
+        }
+        console.error(`Session ${sessionId} cleaned up successfully`);
+    }
+    /**
+     * Delete session and cleanup resources
+     *
+     * Properly cleans up all async resources:
+     * - Disconnects from miniProgram
+     * - Kills IDE process and waits for exit
+     * - Clears element cache
+     *
+     * @throws AggregateError if cleanup operations fail
+     */
+    async delete(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            this.sessions.delete(sessionId);
+            return;
+        }
+        // Remove from session map first
+        this.sessions.delete(sessionId);
+        // Cleanup resources
+        await this.cleanupSessionResources(session, sessionId);
+    }
+    /**
+     * Check if session exists
+     */
+    has(sessionId) {
+        return this.sessions.has(sessionId);
+    }
+    /**
+     * Dispose all sessions
+     *
+     * Async method to properly cleanup all resources
+     */
+    async dispose() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        // Delete all sessions in parallel
+        const deletions = Array.from(this.sessions.keys()).map((sessionId) => this.delete(sessionId).catch((error) => {
+            console.error(`Failed to delete session ${sessionId} during dispose:`, error);
+        }));
+        await Promise.all(deletions);
+        console.error('All sessions disposed');
+    }
+    /**
+     * Get or create session
+     */
+    getOrCreate(sessionId, config) {
+        let session = this.get(sessionId);
+        if (!session) {
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const outputDir = join(this.outputDir, `${sessionId}-${timestamp}`);
+            const now = new Date();
+            session = {
+                sessionId,
+                pages: [],
+                elements: new Map(),
+                outputDir,
+                createdAt: now,
+                lastActivity: now,
+                config,
+                logger: createLogger(sessionId, this.loggerConfig),
+                loggerConfig: this.loggerConfig,
+                outputManager: createOutputManager(outputDir),
+                // F3: Initialize report data if enabled
+                reportData: this.enableSessionReport
+                    ? {
+                        toolCalls: [],
+                        startTime: now,
+                    }
+                    : undefined,
+            };
+            this.set(sessionId, session);
+            console.error(`Created new session: ${sessionId}`);
+        }
+        return session;
+    }
+    /**
+     * Update session activity timestamp
+     */
+    updateActivity(sessionId) {
+        const session = this.get(sessionId);
+        if (session) {
+            session.lastActivity = new Date();
+        }
+    }
+    /**
+     * Check if session has expired
+     */
+    isSessionExpired(session) {
+        const now = Date.now();
+        const lastActivity = session.lastActivity.getTime();
+        return now - lastActivity > this.sessionTimeout;
+    }
+    /**
+     * Cleanup expired sessions periodically
+     */
+    startCleanupTimer() {
+        // Check every 5 minutes
+        this.cleanupInterval = setInterval(async () => {
+            const expiredSessions = [];
+            for (const [sessionId, session] of this.sessions.entries()) {
+                if (this.isSessionExpired(session)) {
+                    expiredSessions.push(sessionId);
+                }
+            }
+            if (expiredSessions.length > 0) {
+                console.error(`Cleaning up ${expiredSessions.length} expired sessions`);
+                // Delete expired sessions in parallel with error handling
+                const deletions = expiredSessions.map((sessionId) => this.delete(sessionId).catch((error) => {
+                    console.error(`Failed to delete expired session ${sessionId}:`, error);
+                }));
+                await Promise.all(deletions);
+            }
+        }, 5 * 60 * 1000); // 5 minutes
+        // Don't block process exit
+        this.cleanupInterval.unref();
+    }
+    /**
+     * Get session metrics for monitoring
+     */
+    getMetrics() {
+        const sessions = Array.from(this.sessions.values());
+        let oldestSession;
+        let totalElements = 0;
+        if (sessions.length > 0) {
+            const oldest = sessions.reduce((prev, curr) => prev.createdAt < curr.createdAt ? prev : curr);
+            oldestSession = {
+                sessionId: oldest.sessionId,
+                age: Date.now() - oldest.createdAt.getTime(),
+            };
+        }
+        for (const session of sessions) {
+            totalElements += session.elements.size;
+        }
+        return {
+            totalSessions: this.sessions.size,
+            activeSessions: sessions.filter((s) => !this.isSessionExpired(s)).length,
+            oldestSession,
+            totalElements,
+        };
+    }
+    /**
+     * Get all session IDs
+     */
+    getAllSessionIds() {
+        return Array.from(this.sessions.keys());
+    }
+    /**
+     * Clear expired sessions manually
+     */
+    async cleanupExpired() {
+        const expiredSessions = [];
+        for (const [sessionId, session] of this.sessions.entries()) {
+            if (this.isSessionExpired(session)) {
+                expiredSessions.push(sessionId);
+            }
+        }
+        // Delete all expired sessions in parallel
+        await Promise.all(expiredSessions.map((sessionId) => this.delete(sessionId).catch((error) => {
+            console.error(`Failed to delete expired session ${sessionId}:`, error);
+        })));
+        return expiredSessions.length;
+    }
+}
+// Note: sessionStore should be created in server.ts with proper configuration
+// This allows outputDir and other options to be configured via ServerConfig
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

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

package/dist/core/timeout.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Timeout utilities for protecting async operations
+ */
+/**
+ * Wraps a promise with timeout protection
+ *
+ * @param promise - The promise to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param operation - Description of the operation for error messages
+ * @returns The promise result or throws TimeoutError
+ *
+ * @example
+ * ```typescript
+ * const result = await withTimeout(
+ *   page.$(selector),
+ *   5000,
+ *   'Query element'
+ * )
+ * ```
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, operation: string): Promise<T>;
+/**
+ * Default timeout values for different operations
+ */
+export declare const DEFAULT_TIMEOUTS: {
+    /** Default timeout for most operations (30 seconds) */
+    readonly default: 30000;
+    /** Timeout for evaluate operations (5 seconds) */
+    readonly evaluate: 5000;
+    /** Timeout for launch operations (60 seconds) */
+    readonly launch: 60000;
+    /** Timeout for connect operations (30 seconds) */
+    readonly connect: 30000;
+    /** Timeout for screenshot operations (10 seconds) */
+    readonly screenshot: 10000;
+    /** Timeout for waitFor operations (30 seconds) */
+    readonly waitFor: 30000;
+    /** Timeout for element queries (10 seconds) */
+    readonly query: 10000;
+};
+/**
+ * Get timeout value with fallback chain:
+ * 1. Operation-specific timeout from config
+ * 2. Global timeout from config
+ * 3. Operation-specific default
+ * 4. Global default (30s)
+ */
+export declare function getTimeout(configTimeout: number | undefined, operationDefault: number): number;
+//# sourceMappingURL=timeout.d.ts.map

package/dist/core/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../src/core/timeout.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,uDAAuD;;IAEvD,kDAAkD;;IAElD,iDAAiD;;IAEjD,kDAAkD;;IAElD,qDAAqD;;IAErD,kDAAkD;;IAElD,+CAA+C;;CAEvC,CAAA;AAEV;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAE9F"}

package/dist/core/timeout.js

@@ -0,0 +1,67 @@
+/**
+ * Timeout utilities for protecting async operations
+ */
+/**
+ * Wraps a promise with timeout protection
+ *
+ * @param promise - The promise to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param operation - Description of the operation for error messages
+ * @returns The promise result or throws TimeoutError
+ *
+ * @example
+ * ```typescript
+ * const result = await withTimeout(
+ *   page.$(selector),
+ *   5000,
+ *   'Query element'
+ * )
+ * ```
+ */
+export async function withTimeout(promise, timeoutMs, operation) {
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new Error(`${operation} timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+    });
+    try {
+        const result = await Promise.race([promise, timeoutPromise]);
+        clearTimeout(timeoutId);
+        return result;
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        throw error;
+    }
+}
+/**
+ * Default timeout values for different operations
+ */
+export const DEFAULT_TIMEOUTS = {
+    /** Default timeout for most operations (30 seconds) */
+    default: 30000,
+    /** Timeout for evaluate operations (5 seconds) */
+    evaluate: 5000,
+    /** Timeout for launch operations (60 seconds) */
+    launch: 60000,
+    /** Timeout for connect operations (30 seconds) */
+    connect: 30000,
+    /** Timeout for screenshot operations (10 seconds) */
+    screenshot: 10000,
+    /** Timeout for waitFor operations (30 seconds) */
+    waitFor: 30000,
+    /** Timeout for element queries (10 seconds) */
+    query: 10000,
+};
+/**
+ * Get timeout value with fallback chain:
+ * 1. Operation-specific timeout from config
+ * 2. Global timeout from config
+ * 3. Operation-specific default
+ * 4. Global default (30s)
+ */
+export function getTimeout(configTimeout, operationDefault) {
+    return configTimeout ?? operationDefault ?? DEFAULT_TIMEOUTS.default;
+}
+//# sourceMappingURL=timeout.js.map

package/dist/core/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/core/timeout.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,SAAiB,EACjB,SAAiB;IAEjB,IAAI,SAAyB,CAAA;IAE7B,MAAM,cAAc,GAAG,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAClD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,SAAS,oBAAoB,SAAS,IAAI,CAAC,CAAC,CAAA;QAClE,CAAC,EAAE,SAAS,CAAC,CAAA;IACf,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAA;QAC5D,YAAY,CAAC,SAAU,CAAC,CAAA;QACxB,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,CAAC,SAAU,CAAC,CAAA;QACxB,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,uDAAuD;IACvD,OAAO,EAAE,KAAK;IACd,kDAAkD;IAClD,QAAQ,EAAE,IAAI;IACd,iDAAiD;IACjD,MAAM,EAAE,KAAK;IACb,kDAAkD;IAClD,OAAO,EAAE,KAAK;IACd,qDAAqD;IACrD,UAAU,EAAE,KAAK;IACjB,kDAAkD;IAClD,OAAO,EAAE,KAAK;IACd,+CAA+C;IAC/C,KAAK,EAAE,KAAK;CACJ,CAAA;AAEV;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,aAAiC,EAAE,gBAAwB;IACpF,OAAO,aAAa,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,OAAO,CAAA;AACtE,CAAC"}

package/dist/core/tool-logger.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Tool call logger wrapper for automatic logging
+ */
+import type { Logger } from '../types.js';
+import type { SessionState } from '../types.js';
+/**
+ * Tool logger wrapper for automatic START/END/ERROR logging
+ */
+export declare class ToolLogger {
+    private logger;
+    private config?;
+    private capturing;
+    constructor(logger: Logger, config?: import("../types.js").LoggerConfig | undefined);
+    /**
+     * Wrap a tool handler with automatic logging
+     *
+     * @param toolName - Name of the tool (e.g., "page_query")
+     * @param handler - Original tool handler function
+     * @returns Wrapped handler with automatic logging
+     */
+    wrap<TArgs, TResult>(toolName: string, handler: (session: SessionState, args: TArgs) => Promise<TResult>): (session: SessionState, args: TArgs) => Promise<TResult>;
+    /**
+     * Check if a key name matches sensitive patterns (Issue #3)
+     */
+    private isSensitiveKey;
+    /**
+     * Sanitize arguments for logging (remove sensitive data, limit size)
+     * Issue #3: Enhanced with deep recursion and pattern matching
+     */
+    private sanitizeArgs;
+    /**
+     * Sanitize result for logging (limit size, remove large objects)
+     * Issue #3: Use same deep sanitization as args
+     */
+    private sanitizeResult;
+    /**
+     * Capture failure snapshot when tool call fails (F2 feature)
+     *
+     * Creates a failure directory with:
+     * - snapshot.json: Page data
+     * - snapshot.png: Screenshot
+     * - error-context.json: Error details + tool context
+     *
+     * @param context Failure context
+     * @returns Relative path to the failure directory (for F3 reporting)
+     */
+    private captureFailureSnapshot;
+    /**
+     * Record a tool call to session report data (F3 feature)
+     *
+     * Adds a tool call record to the session's reportData. Implements
+     * memory protection by limiting to MAX_TOOL_CALL_RECORDS with FIFO eviction.
+     *
+     * @param session Session state
+     * @param record Tool call record to add
+     */
+    private recordToolCall;
+    /**
+     * Sanitize error message to remove sensitive information (F3-S1)
+     *
+     * Removes:
+     * - File paths (Unix, Linux, Windows)
+     * - API keys and tokens (32+ character alphanumeric strings)
+     * - Stack trace locations
+     *
+     * @param message Raw error message
+     * @returns Sanitized error message with placeholders
+     */
+    private sanitizeErrorMessage;
+    /**
+     * Sanitize stack trace to remove sensitive file paths (Issue #P2)
+     *
+     * Removes:
+     * - Absolute user paths (/Users/<username>/, /home/<username>/)
+     * - Windows paths (C:\Users\<username>\)
+     * - Environment-specific paths
+     *
+     * @param stack Raw stack trace
+     * @returns Sanitized stack trace with placeholders
+     */
+    private sanitizeStackTrace;
+}
+//# sourceMappingURL=tool-logger.d.ts.map

package/dist/core/tool-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-logger.d.ts","sourceRoot":"","sources":["../../src/core/tool-logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,aAAa,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AA4C/C;;GAEG;AACH,qBAAa,UAAU;IAInB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM,CAAC;IAJjB,OAAO,CAAC,SAAS,CAAQ;gBAGf,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,aAAa,EAAE,YAAY,YAAA;IAGrD;;;;;;OAMG;IACH,IAAI,CAAC,KAAK,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,GAChE,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC;IAgF3D;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAoEpB;;;OAGG;IACH,OAAO,CAAC,cAAc;IA0EtB;;;;;;;;;;OAUG;YACW,sBAAsB;IAqGpC;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IA6BtB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,kBAAkB;CAqB3B"}