@sudu-cli/fronted-preview-mcp 1.0.0-beta.3 → 1.0.0-beta.5

package/dist/cdp/connectionManager.d.ts

@@ -0,0 +1,57 @@
+import { type Client } from 'chrome-remote-interface';
+export interface CDPConnectionConfig {
+    maxRetries: number;
+    retryDelayMs: number;
+    connectionTimeoutMs: number;
+    enableConnectionPooling: boolean;
+}
+export declare const DEFAULT_CDP_CONFIG: CDPConnectionConfig;
+export declare class CDPConnectionManager {
+    private static instance;
+    private pool;
+    private config;
+    private connecting;
+    private constructor();
+    static getInstance(config?: CDPConnectionConfig): CDPConnectionManager;
+    static resetInstance(): void;
+    getConnection(port: number): Promise<Client>;
+    private createConnectionWithRetry;
+    private createConnection;
+    private isConnectionHealthy;
+    releaseConnection(port: number): void;
+    closeConnection(port: number): Promise<void>;
+    closeAll(): Promise<void>;
+    private sleep;
+    getPoolStats(): Record<number, {
+        total: number;
+        inUse: number;
+    }>;
+}
+export interface CDPEventHandlers {
+    onLogEntryAdded?: (params: {
+        entry: LogEntry;
+    }) => void;
+    onNetworkResponseReceived?: (params: {
+        response: NetworkResponse;
+    }) => void;
+    onNetworkLoadingFailed?: (params: {
+        requestId: string;
+        errorText: string;
+    }) => void;
+    onPageLoadEventFired?: (params: {
+        timestamp: number;
+    }) => void;
+}
+export interface LogEntry {
+    level: 'log' | 'error' | 'warning' | 'info' | 'debug';
+    text: string;
+    url?: string;
+    lineNumber?: number;
+    columnNumber?: number;
+    stackTrace?: string;
+}
+export interface NetworkResponse {
+    url: string;
+    status: number;
+    requestMethod?: string;
+}

package/dist/cdp/connectionManager.js

@@ -0,0 +1,153 @@
+import CDP from 'chrome-remote-interface';
+export const DEFAULT_CDP_CONFIG = {
+    maxRetries: 3,
+    retryDelayMs: 1000,
+    connectionTimeoutMs: 10000,
+    enableConnectionPooling: true,
+};
+export class CDPConnectionManager {
+    static instance = null;
+    pool = new Map();
+    config;
+    connecting = new Map();
+    constructor(config = DEFAULT_CDP_CONFIG) {
+        this.config = config;
+    }
+    static getInstance(config) {
+        if (!CDPConnectionManager.instance) {
+            CDPConnectionManager.instance = new CDPConnectionManager(config);
+        }
+        return CDPConnectionManager.instance;
+    }
+    static resetInstance() {
+        CDPConnectionManager.instance = null;
+    }
+    async getConnection(port) {
+        // If pooling disabled, create new connection each time
+        if (!this.config.enableConnectionPooling) {
+            return this.createConnectionWithRetry(port);
+        }
+        // Check for available pooled connection
+        const pool = this.pool.get(port) || [];
+        const available = pool.find(c => !c.inUse && this.isConnectionHealthy(c.client));
+        if (available) {
+            available.inUse = true;
+            return available.client;
+        }
+        // Check if connection is already being created
+        const existing = this.connecting.get(port);
+        if (existing) {
+            return existing;
+        }
+        // Create new connection with retry
+        const connectionPromise = this.createConnectionWithRetry(port);
+        this.connecting.set(port, connectionPromise);
+        try {
+            const client = await connectionPromise;
+            return client;
+        }
+        finally {
+            this.connecting.delete(port);
+        }
+    }
+    async createConnectionWithRetry(port) {
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+            try {
+                const client = await this.createConnection(port);
+                return client;
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                if (attempt < this.config.maxRetries) {
+                    const delay = this.config.retryDelayMs * Math.pow(2, attempt);
+                    await this.sleep(delay);
+                }
+            }
+        }
+        throw new Error(`Failed to connect to Chrome DevTools Protocol on port ${port} after ${this.config.maxRetries + 1} attempts. ` +
+            `Last error: ${lastError?.message}. Ensure Chrome is running with --remote-debugging-port=${port}`);
+    }
+    async createConnection(port) {
+        const options = { port };
+        // Create connection with timeout
+        const connectionPromise = CDP(options);
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error(`CDP connection timeout after ${this.config.connectionTimeoutMs}ms`)), this.config.connectionTimeoutMs);
+        });
+        const client = await Promise.race([connectionPromise, timeoutPromise]);
+        // Verify connection is working
+        await client.send('Browser.getVersion');
+        return client;
+    }
+    isConnectionHealthy(client) {
+        try {
+            // Check if client is still connected
+            return client !== null && typeof client.close === 'function';
+        }
+        catch {
+            return false;
+        }
+    }
+    releaseConnection(port) {
+        const pool = this.pool.get(port);
+        if (!pool)
+            return;
+        const connection = pool.find(c => c.inUse);
+        if (connection) {
+            connection.inUse = false;
+        }
+    }
+    async closeConnection(port) {
+        const pool = this.pool.get(port);
+        if (!pool)
+            return;
+        for (const conn of pool) {
+            if (!conn.inUse) {
+                try {
+                    await conn.client.close();
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+        }
+        // Remove only non-in-use connections
+        const remaining = pool.filter(c => c.inUse);
+        if (remaining.length === 0) {
+            this.pool.delete(port);
+        }
+        else {
+            this.pool.set(port, remaining);
+        }
+    }
+    async closeAll() {
+        for (const [port, pool] of this.pool.entries()) {
+            for (const conn of pool) {
+                try {
+                    await conn.client.close();
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+        }
+        this.pool.clear();
+        this.connecting.clear();
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    // For testing/debugging
+    getPoolStats() {
+        const stats = {};
+        for (const [port, pool] of this.pool.entries()) {
+            stats[port] = {
+                total: pool.length,
+                inUse: pool.filter(c => c.inUse).length,
+            };
+        }
+        return stats;
+    }
+}
+//# sourceMappingURL=connectionManager.js.map

package/dist/cdp/connectionManager.js.map

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

package/dist/cli.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 import { main as runMcpServer } from './index.js';
+import { VERSION } from './version.js';
 async function showHelp() {
     console.log(`
-@sudu-cli/fronted-preview-mcp v1.0.0 — Frontend preview MCP server
+@sudu-cli/fronted-preview-mcp v${VERSION} — Frontend preview MCP server
 
 USAGE:
   fronted-preview-mcp               Start MCP server (stdio — used by opencode)

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,YAAY,CAAC;AAElD,KAAK,UAAU,QAAQ;IACrB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;CAwBb,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,GAAG;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;SAAM,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,QAAQ,EAAE,CAAC;IACnB,CAAC;SAAM,CAAC;QACN,2BAA2B;QAC3B,MAAM,YAAY,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,KAAK,UAAU,QAAQ;IACrB,OAAO,CAAC,GAAG,CAAC;iCACmB,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuBvC,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,GAAG;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;SAAM,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,QAAQ,EAAE,CAAC;IACnB,CAAC;SAAM,CAAC;QACN,2BAA2B;QAC3B,MAAM,YAAY,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,19 @@
+export declare const TIMEOUTS: {
+    readonly DEV_SERVER_START: 30000;
+    readonly DEV_SERVER_STOP: 5000;
+    readonly CDP_CONNECTION: 10000;
+    readonly CDP_CONNECTION_RETRY_DELAY: 1000;
+    readonly CDP_MAX_RETRIES: 3;
+    readonly PAGE_LOAD_DEFAULT: 3000;
+    readonly PAGE_LOAD_EXTRA: 1000;
+    readonly AUTO_FIX_ITERATION: 30000;
+    readonly AUTO_FIX_INITIAL_WAIT: 2000;
+    readonly AUTO_FIX_MAX_ITERATIONS: 3;
+    readonly AUTO_FIX_MAX_ITERATION_LIMIT: 10;
+    readonly AUTO_FIX_ITERATION_TIMEOUT_MIN: 1000;
+    readonly AUTO_FIX_ITERATION_TIMEOUT_MAX: 120000;
+    readonly SERVER_START_TIMEOUT: 30000;
+    readonly SERVER_STOP_TIMEOUT: 5000;
+    readonly PORT_CHECK_INTERVAL: 500;
+};
+export type TimeoutKey = keyof typeof TIMEOUTS;

package/dist/constants.js

@@ -0,0 +1,26 @@
+// Centralized timeout constants
+export const TIMEOUTS = {
+    // Dev server timeouts
+    DEV_SERVER_START: 30000,
+    DEV_SERVER_STOP: 5000,
+    // CDP connection timeouts
+    CDP_CONNECTION: 10000,
+    CDP_CONNECTION_RETRY_DELAY: 1000,
+    CDP_MAX_RETRIES: 3,
+    // Page load timeouts
+    PAGE_LOAD_DEFAULT: 3000,
+    PAGE_LOAD_EXTRA: 1000,
+    // Auto-fix loop timeouts
+    AUTO_FIX_ITERATION: 30000,
+    AUTO_FIX_INITIAL_WAIT: 2000,
+    AUTO_FIX_MAX_ITERATIONS: 3,
+    AUTO_FIX_MAX_ITERATION_LIMIT: 10,
+    AUTO_FIX_ITERATION_TIMEOUT_MIN: 1000,
+    AUTO_FIX_ITERATION_TIMEOUT_MAX: 120000,
+    // Server manager timeouts
+    SERVER_START_TIMEOUT: 30000,
+    SERVER_STOP_TIMEOUT: 5000,
+    // Port check interval
+    PORT_CHECK_INTERVAL: 500,
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,sBAAsB;IACtB,gBAAgB,EAAE,KAAK;IACvB,eAAe,EAAE,IAAI;IAErB,0BAA0B;IAC1B,cAAc,EAAE,KAAK;IACrB,0BAA0B,EAAE,IAAI;IAChC,eAAe,EAAE,CAAC;IAElB,qBAAqB;IACrB,iBAAiB,EAAE,IAAI;IACvB,eAAe,EAAE,IAAI;IAErB,yBAAyB;IACzB,kBAAkB,EAAE,KAAK;IACzB,qBAAqB,EAAE,IAAI;IAC3B,uBAAuB,EAAE,CAAC;IAC1B,4BAA4B,EAAE,EAAE;IAChC,8BAA8B,EAAE,IAAI;IACpC,8BAA8B,EAAE,MAAM;IAEtC,0BAA0B;IAC1B,oBAAoB,EAAE,KAAK;IAC3B,mBAAmB,EAAE,IAAI;IAEzB,sBAAsB;IACtB,mBAAmB,EAAE,GAAG;CAChB,CAAC"}

package/dist/detectors/frameworkDetector.js

@@ -74,18 +74,13 @@ async function detectFramework(projectDir) {
     const scripts = pkg.scripts || {};
     const projectName = pkg.name || path.basename(projectDir);
     const hasNodeModules = await fileExists(path.join(projectDir, 'node_modules'));
-    // Check each framework in priority order
+    // Priority 1: Check dependencies (most reliable - what actually runs)
     for (const cfg of FRAMEWORK_CONFIGS) {
-        // Check config files
-        for (const configFile of cfg.configFiles) {
-            const configPath = path.join(projectDir, configFile);
-            if (await fileExists(configPath)) {
-                // Read config to extract custom port
-                const content = await fs.readFile(configPath, 'utf-8');
-                const customPort = extractPortFromConfig(content);
+        for (const key of cfg.depKeys) {
+            if (allDeps[key]) {
                 return {
                     framework: cfg.framework,
-                    port: customPort ?? cfg.port,
+                    port: cfg.port,
                     devCommand: findDevCommand(scripts, cfg.framework),
                     devScript: findDevScriptName(scripts),
                     projectName,
@@ -94,12 +89,21 @@ async function detectFramework(projectDir) {
                 };
             }
         }
-        // Check dependencies
-        for (const key of cfg.depKeys) {
-            if (allDeps[key]) {
+    }
+    // Priority 2: Check config files as confirmation (but only if dependency also exists)
+    for (const cfg of FRAMEWORK_CONFIGS) {
+        const hasDep = cfg.depKeys.some(key => allDeps[key]);
+        if (!hasDep)
+            continue; // Skip config check if no matching dependency
+        for (const configFile of cfg.configFiles) {
+            const configPath = path.join(projectDir, configFile);
+            if (await fileExists(configPath)) {
+                // Read config to extract custom port
+                const content = await fs.readFile(configPath, 'utf-8');
+                const customPort = extractPortFromConfig(content);
                 return {
                     framework: cfg.framework,
-                    port: cfg.port,
+                    port: customPort ?? cfg.port,
                     devCommand: findDevCommand(scripts, cfg.framework),
                     devScript: findDevScriptName(scripts),
                     projectName,

package/dist/detectors/frameworkDetector.js.map

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

package/dist/handlers/autoFixLoop.d.ts

@@ -1,9 +1,25 @@
 import { ToolContext } from '../types.js';
+export interface FixStrategy {
+    errorType: 'typescript' | 'console' | 'network';
+    pattern: RegExp;
+    canFix(error: any): boolean;
+    fix(context: any, error: any): Promise<FixResult>;
+}
+export interface FixResult {
+    success: boolean;
+    message: string;
+    changes?: Array<{
+        file: string;
+        description: string;
+    }>;
+}
 export interface AutoFixOptions {
     maxIterations?: number;
     timeoutPerIteration?: number;
     stopOnSuccess?: boolean;
     targetErrors?: string[];
+    fixAction?: 'auto' | 'suggest' | 'none';
+    fixStrategies?: FixStrategy[];
 }
 export interface AutoFixResult {
     success: boolean;
@@ -12,6 +28,14 @@ export interface AutoFixResult {
     errorsRemaining: number;
     messages: string[];
     errors: string[];
+    fixesApplied: FixResult[];
+}
+export interface ConsoleError {
+    type: string;
+    message: string;
+    url?: string;
+    lineNumber?: number;
+    stackTrace?: string;
 }
 export declare function autoFixLoop(context: ToolContext, options?: AutoFixOptions): Promise<AutoFixResult>;
 export declare function handleAutoFixLoop(context: ToolContext, options?: AutoFixOptions): Promise<AutoFixResult>;

package/dist/handlers/autoFixLoop.js

@@ -1,14 +1,81 @@
 import { handleCheckPageErrors } from './checkPageErrors.js';
 import { handleGetTypeScriptDiagnostics } from './typescriptDiagnostics.js';
+import { TIMEOUTS } from '../constants.js';
+import { createFixContext, defaultFixStrategies } from '../strategies/index.js';
+import * as path from 'node:path';
+function parseCheckPageErrorsResponse(response) {
+    try {
+        const text = response.content[0]?.text || '{}';
+        const data = JSON.parse(text);
+        return {
+            errors: data.consoleMessages?.filter((m) => m.type === 'error') || [],
+            diagnostics: []
+        };
+    }
+    catch {
+        return { errors: [], diagnostics: [] };
+    }
+}
+function parseTSDiagnosticsResponse(response) {
+    try {
+        const text = response.content[0]?.text || '{}';
+        const data = JSON.parse(text);
+        return {
+            errors: [],
+            diagnostics: data.diagnostics || []
+        };
+    }
+    catch {
+        return { errors: [], diagnostics: [] };
+    }
+}
 export async function autoFixLoop(context, options = {}) {
-    const { maxIterations = 3, timeoutPerIteration = 30000, stopOnSuccess = true, targetErrors = [] } = options;
+    const { maxIterations = TIMEOUTS.AUTO_FIX_MAX_ITERATIONS, timeoutPerIteration = TIMEOUTS.AUTO_FIX_ITERATION, stopOnSuccess = true, targetErrors = [], fixAction = 'suggest', fixStrategies = [] } = options;
     const result = {
         success: false,
         iterations: 0,
         errorsFixed: 0,
         errorsRemaining: 0,
         messages: [],
-        errors: []
+        errors: [],
+        fixesApplied: []
+    };
+    // Use real fix strategies instead of stubs
+    const defaultStrategies = defaultFixStrategies;
+    const strategies = [...defaultStrategies, ...fixStrategies];
+    // Helper to find matching strategy
+    const findStrategy = (error) => {
+        const errorMsg = error.message || String(error);
+        return strategies.find(s => s.pattern.test(errorMsg) && s.canFix(error));
+    };
+    // Helper to apply fix strategies
+    const applyFixes = async (errors) => {
+        const fixes = [];
+        for (const error of errors) {
+            const strategy = findStrategy(error);
+            if (strategy && fixAction !== 'none') {
+                try {
+                    // Create fix context for ts-morph strategies
+                    const projectDir = context.projectDir || process.cwd();
+                    const tsConfigPath = path.resolve(projectDir, 'tsconfig.json');
+                    const fixContext = createFixContext(projectDir, tsConfigPath);
+                    const fixResult = await strategy.fix(fixContext, error);
+                    fixes.push(fixResult);
+                    if (fixResult.success) {
+                        result.messages.push(`✅ Fixed: ${fixResult.message}`);
+                        result.errorsFixed++;
+                    }
+                    else {
+                        result.messages.push(`💡 Suggestion: ${fixResult.message}`);
+                    }
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    result.errors.push(`Fix failed for "${error.message}": ${msg}`);
+                }
+            }
+        }
+        return fixes;
     };
     // Check initial state
     const initialConsoleErrors = await handleCheckPageErrors(context);
@@ -27,7 +94,7 @@ export async function autoFixLoop(context, options = {}) {
         result.messages.push(`=== Iteration ${iteration + 1} ===`);
         try {
             // Wait for any pending operations
-            await new Promise(resolve => setTimeout(resolve, 2000));
+            await new Promise(resolve => setTimeout(resolve, TIMEOUTS.AUTO_FIX_INITIAL_WAIT));
             // Check current state
             const currentErrors = await handleCheckPageErrors(context);
             const currentDiagnostics = await handleGetTypeScriptDiagnostics(context);
@@ -48,6 +115,16 @@ export async function autoFixLoop(context, options = {}) {
                 result.messages.push(`✅ All errors fixed after ${iteration + 1} iterations`);
                 break;
             }
+            // Apply fix strategies if we have errors and fixAction is not 'none'
+            if (currentErrorCount > 0 && fixAction !== 'none') {
+                result.messages.push(`Attempting fixes for ${currentErrorCount} errors...`);
+                const allErrors = [
+                    ...currentConsoleErrors.map(e => ({ ...e, _type: 'console' })),
+                    ...currentTsDiagnostics.map(d => ({ ...d, _type: 'typescript' }))
+                ];
+                const fixes = await applyFixes(allErrors);
+                result.fixesApplied.push(...fixes);
+            }
             // Log current state
             result.messages.push(`Current errors: ${currentErrorCount} (fixed: ${errorsFixed})`);
             if (currentConsoleErrors.length > 0) {
@@ -67,7 +144,7 @@ export async function autoFixLoop(context, options = {}) {
                 result.messages.push('No errors found, but continuing to next iteration');
             }
             // Wait before next iteration
-            await new Promise(resolve => setTimeout(resolve, timeoutPerIteration));
+            await new Promise(resolve => setTimeout(resolve, timeoutPerIteration ?? TIMEOUTS.AUTO_FIX_ITERATION));
         }
         catch (error) {
             const errorMessage = `Error in iteration ${iteration + 1}: ${error instanceof Error ? error.message : 'Unknown error'}`;

package/dist/handlers/autoFixLoop.js.map

@@ -1 +1 @@
-{"version":3,"file":"autoFixLoop.js","sourceRoot":"","sources":["../../src/handlers/autoFixLoop.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAkB5E,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAoB,EACpB,UAA0B,EAAE;IAE5B,MAAM,EACJ,aAAa,GAAG,CAAC,EACjB,mBAAmB,GAAG,KAAK,EAC3B,aAAa,GAAG,IAAI,EACpB,YAAY,GAAG,EAAE,EAClB,GAAG,OAAO,CAAC;IAEZ,MAAM,MAAM,GAAkB;QAC5B,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,eAAe,EAAE,CAAC;QAClB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,sBAAsB;IACtB,MAAM,oBAAoB,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAClE,MAAM,oBAAoB,GAAG,MAAM,8BAA8B,CAAC,OAAO,CAAC,CAAC;IAE3E,IAAI,oBAAoB,GAAG,CAAC,GAAI,oBAA4B,CAAC,MAAM,CAAC,CAAC;IACrE,IAAI,oBAAoB,GAAG,CAAC,GAAI,oBAA4B,CAAC,WAAW,CAAC,CAAC;IAE1E,6CAA6C;IAC7C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,oBAAoB,GAAG,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACzD,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAC5D,CAAC;QACF,oBAAoB,GAAG,oBAAoB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAC9D,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC;IACpF,MAAM,CAAC,eAAe,GAAG,iBAAiB,CAAC;IAE3C,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,aAAa,EAAE,SAAS,EAAE,EAAE,CAAC;QAC/D,MAAM,CAAC,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC;QAClC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC;QAE3D,IAAI,CAAC;YACH,kCAAkC;YAClC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YAExD,sBAAsB;YACtB,MAAM,aAAa,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAC3D,MAAM,kBAAkB,GAAG,MAAM,8BAA8B,CAAC,OAAO,CAAC,CAAC;YAEzE,sBAAsB;YACtB,oBAAoB,GAAG,CAAC,GAAI,aAAqB,CAAC,MAAM,CAAC,CAAC;YAC1D,oBAAoB,GAAG,CAAC,GAAI,kBAA0B,CAAC,WAAW,CAAC,CAAC;YAEpE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,oBAAoB,GAAG,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACzD,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAC5D,CAAC;gBACF,oBAAoB,GAAG,oBAAoB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAC9D,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CACjE,CAAC;YACJ,CAAC;YAED,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC;YACpF,MAAM,WAAW,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;YAE1D,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;YACjC,MAAM,CAAC,eAAe,GAAG,iBAAiB,CAAC;YAE3C,2BAA2B;YAC3B,IAAI,iBAAiB,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;gBAC7C,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,4BAA4B,SAAS,GAAG,CAAC,aAAa,CAAC,CAAC;gBAC7E,MAAM;YACR,CAAC;YAED,oBAAoB;YACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,iBAAiB,YAAY,WAAW,GAAG,CAAC,CAAC;YAErF,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBACxC,oBAAoB,CAAC,OAAO,CAAC,CAAC,KAAU,EAAE,EAAE;oBAC1C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;gBAC/D,CAAC,CAAC,CAAC;YACL,CAAC;YAED,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;gBAChD,oBAAoB,CAAC,OAAO,CAAC,CAAC,UAAe,EAAE,EAAE;oBAC/C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,OAAO,KAAK,UAAU,CAAC,QAAQ,GAAG,CAAC,CAAC;gBAC7E,CAAC,CAAC,CAAC;YACL,CAAC;YAED,2DAA2D;YAC3D,IAAI,iBAAiB,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;YAC5E,CAAC;YAED,6BAA6B;YAC7B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;QAEzE,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,YAAY,GAAG,sBAAsB,SAAS,GAAG,CAAC,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;YACxH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACnC,MAAM;QACR,CAAC;IACH,CAAC;IAED,cAAc;IACd,MAAM,kBAAkB,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,kBAAkB,GAAG,MAAM,8BAA8B,CAAC,OAAO,CAAC,CAAC;IAEzE,IAAI,eAAe,GAAI,kBAA0B,CAAC,MAAM,CAAC,MAAM,GAAI,kBAA0B,CAAC,WAAW,CAAC,MAAM,CAAC;IACjH,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,eAAe,GAAI,kBAA0B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAU,EAAE,EAAE,CACzE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAC5D,CAAC,MAAM,GAAI,kBAA0B,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,UAAe,EAAE,EAAE,CAC5E,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CACjE,CAAC,MAAM,CAAC;IACX,CAAC;IAED,MAAM,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,MAAM,CAAC,OAAO,GAAG,eAAe,KAAK,CAAC,CAAC;IAEvC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mBAAmB;AACnB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAoB,EACpB,OAAwB;IAExB,OAAO,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"autoFixLoop.js","sourceRoot":"","sources":["../../src/handlers/autoFixLoop.ts"],"names":[],"mappings":"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"}

package/dist/handlers/checkPageErrors.js

@@ -1,6 +1,7 @@
 import { detectFramework } from '../detectors/frameworkDetector.js';
 import { startServer } from '../serverManager.js';
-import CDP from 'chrome-remote-interface';
+import { createMCPError, createMCPSuccess } from '../types.js';
+import { CDPConnectionManager } from '../cdp/connectionManager.js';
 async function handleCheckPageErrors(args) {
     const projectDir = args.projectDir || process.cwd();
     const cdpPort = args.cdpPort || 9222;
@@ -10,59 +11,20 @@ async function handleCheckPageErrors(args) {
         // Step 1: Detect framework and start/get dev server
         const info = await detectFramework(projectDir);
         if (!info.devScript) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            error: 'No dev script found',
-                            availableScripts: Object.keys(info.npmScripts),
-                            projectDir,
-                        }, null, 2),
-                    },
-                ],
-                isError: true,
-            };
+            return createMCPError('FRAMEWORK_NOT_DETECTED', 'No dev script found', { availableScripts: Object.keys(info.npmScripts), projectDir }, 'Add a dev script to package.json (e.g., "dev": "vite")');
         }
         // Step 2: Start dev server (or reuse existing)
         const port = args.customPort || info.port;
         const command = `npm run ${info.devScript}`;
         const status = await startServer(projectDir, command, port);
         const pageUrl = status.url;
-        // Step 3: Connect to Chrome via CDP
-        const cdpOptions = { port: cdpPort };
+        // Step 3: Connect to Chrome via CDP with retry and pooling
+        let client = null;
         try {
-            client = await CDP(cdpOptions);
+            client = await CDPConnectionManager.getInstance().getConnection(cdpPort);
         }
         catch (cdpErr) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            error: `Failed to connect to Chrome DevTools Protocol on port ${cdpPort}. Ensure Chrome is running with --remote-debugging-port=${cdpPort}`,
-                            details: cdpErr instanceof Error ? cdpErr.message : String(cdpErr),
-                            pageUrl,
-                            suggestion: 'Start Chrome with: chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug',
-                        }, null, 2),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (!client) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            error: 'Failed to create CDP client',
-                            pageUrl,
-                        }, null, 2),
-                    },
-                ],
-                isError: true,
-            };
+            return createMCPError('CDP_CONNECTION_FAILED', `Failed to connect to Chrome DevTools Protocol on port ${cdpPort}`, { details: cdpErr instanceof Error ? cdpErr.message : String(cdpErr) }, 'Start Chrome with: chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug');
         }
         // Enable domains
         const { Page, Runtime, Network, Log } = client;
@@ -145,18 +107,17 @@ async function handleCheckPageErrors(args) {
                 },
             ],
         };
+        return createMCPSuccess(report);
     }
     catch (err) {
         const errorMessage = err instanceof Error ? err.message : String(err);
-        return {
-            content: [{ type: 'text', text: JSON.stringify({ error: errorMessage }, null, 2) }],
-            isError: true,
-        };
+        return createMCPError('UNKNOWN_ERROR', errorMessage);
     }
     finally {
         if (client) {
             try {
-                await client.close();
+                // Release connection back to pool instead of closing
+                CDPConnectionManager.getInstance().releaseConnection(cdpPort);
             }
             catch {
                 // Ignore cleanup errors