@sudu-cli/fronted-preview-mcp 1.0.0-beta.2 → 1.0.0-beta.4

package/dist/serverManager.js

@@ -1,166 +1,241 @@
 import { spawn } from 'node:child_process';
 import * as net from 'node:net';
-let activeServer = null;
-function isPortAvailable(port) {
-    return new Promise((resolve) => {
-        const server = net.createServer();
-        server.once('error', () => resolve(false));
-        server.once('listening', () => {
-            server.close();
-            resolve(true);
+import { TIMEOUTS } from './constants.js';
+export class ServerManager {
+    static instance = null;
+    activeServer = null;
+    startLocks = new Map();
+    shutdownLock = null;
+    constructor() { }
+    static getInstance() {
+        if (!ServerManager.instance) {
+            ServerManager.instance = new ServerManager();
+        }
+        return ServerManager.instance;
+    }
+    static resetInstance() {
+        ServerManager.instance = null;
+    }
+    isPortAvailable(port) {
+        return new Promise((resolve) => {
+            const server = net.createServer();
+            server.once('error', () => resolve(false));
+            server.once('listening', () => {
+                server.close();
+                resolve(true);
+            });
+            server.listen(port, '127.0.0.1');
         });
-        server.listen(port, '127.0.0.1');
-    });
-}
-function waitForPort(port, timeoutMs = 30000) {
-    const start = Date.now();
-    return new Promise((resolve) => {
-        const check = async () => {
-            const available = await isPortAvailable(port);
-            if (!available) {
-                resolve(true); // port is in use = server is ready
-                return;
-            }
-            if (Date.now() - start > timeoutMs) {
-                resolve(false); // timeout
-                return;
+    }
+    waitForServerReady(port, timeoutMs = TIMEOUTS.SERVER_START_TIMEOUT) {
+        const start = Date.now();
+        return new Promise((resolve) => {
+            const check = async () => {
+                const available = await this.isPortAvailable(port);
+                if (!available) {
+                    resolve(true); // port is in use = server is ready
+                    return;
+                }
+                if (Date.now() - start > timeoutMs) {
+                    resolve(false); // timeout
+                    return;
+                }
+                setTimeout(check, TIMEOUTS.PORT_CHECK_INTERVAL);
+            };
+            check();
+        });
+    }
+    async startServer(projectDir, devCommand, port, timeoutMs = TIMEOUTS.SERVER_START_TIMEOUT) {
+        // Check if there's already a start in progress for this port
+        const existingLock = this.startLocks.get(port);
+        if (existingLock) {
+            return existingLock;
+        }
+        // Create the start operation with lock
+        const startPromise = this.doStartServer(projectDir, devCommand, port, timeoutMs);
+        this.startLocks.set(port, startPromise);
+        try {
+            const result = await startPromise;
+            return result;
+        }
+        finally {
+            this.startLocks.delete(port);
+        }
+    }
+    async doStartServer(projectDir, devCommand, port, timeoutMs) {
+        // Atomic check: if we have a running server on this port, return it
+        if (this.activeServer && this.activeServer.port === port) {
+            const isRunning = this.activeServer.process.exitCode === null;
+            if (isRunning) {
+                return {
+                    url: this.activeServer.url,
+                    port: this.activeServer.port,
+                    pid: this.activeServer.process.pid || 0,
+                    ready: true,
+                    startedAt: new Date(this.activeServer.startTime).toISOString(),
+                };
             }
-            setTimeout(check, 500);
-        };
-        check();
-    });
-}
-async function startServer(projectDir, devCommand, port) {
-    // If already running, return current status
-    if (activeServer) {
-        const isRunning = activeServer.process.exitCode === null;
-        if (isRunning) {
+            // Process died, clean up atomically
+            this.activeServer = null;
+        }
+        // Check if port is already in use (server running externally)
+        const portAvailable = await this.isPortAvailable(port);
+        if (!portAvailable) {
             return {
-                url: activeServer.url,
-                port: activeServer.port,
-                pid: activeServer.process.pid || 0,
+                url: `http://localhost:${port}`,
+                port,
+                pid: 0,
                 ready: true,
-                startedAt: new Date(activeServer.startTime).toISOString(),
+                startedAt: new Date().toISOString(),
             };
         }
-        // Process died, clean up
-        activeServer = null;
-    }
-    // Check if port is already in use (server running externally)
-    const portAvailable = await isPortAvailable(port);
-    if (!portAvailable) {
+        // Determine shell command
+        const isWin = process.platform === 'win32';
+        const shellCmd = isWin ? `cmd /c "${devCommand}"` : devCommand;
+        const child = spawn(shellCmd, [], {
+            cwd: projectDir,
+            shell: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        let urlConfirmed = false;
+        child.stdout?.on('data', (data) => {
+            const text = data.toString();
+            // Vite prints local URL on stdout
+            if (text.includes('Local:')) {
+                const urlMatch = text.match(/http:\/\/localhost:\d+/);
+                if (urlMatch) {
+                    urlConfirmed = true;
+                }
+            }
+        });
+        child.stderr?.on('data', (data) => {
+            // Some frameworks output to stderr
+        });
+        // Handle process errors
+        const errorPromise = new Promise((_, reject) => {
+            child.on('error', (err) => {
+                this.activeServer = null;
+                reject(new Error(`Failed to start dev server: ${err.message}`));
+            });
+        });
+        // Handle process exit
+        child.on('exit', (code) => {
+            if (this.activeServer?.process === child) {
+                this.activeServer = null;
+            }
+        });
+        // Wait for server to be ready with timeout
+        const ready = await Promise.race([
+            this.waitForServerReady(port, timeoutMs),
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`Timeout waiting for server on port ${port}`)), timeoutMs + TIMEOUTS.PORT_CHECK_INTERVAL)),
+            errorPromise.then(() => false)
+        ]);
+        if (!ready) {
+            // Kill the process if it didn't start in time
+            try {
+                child.kill();
+            }
+            catch {
+                // Ignore kill errors
+            }
+            throw new Error(`Dev server did not start within ${timeoutMs}ms on port ${port}`);
+        }
+        const url = `http://localhost:${port}`;
+        this.activeServer = {
+            process: child,
+            port,
+            url,
+            startTime: Date.now(),
+        };
         return {
-            url: `http://localhost:${port}`,
+            url,
             port,
-            pid: 0,
+            pid: child.pid || 0,
             ready: true,
             startedAt: new Date().toISOString(),
         };
     }
-    // Determine shell command
-    const isWin = process.platform === 'win32';
-    const shellCmd = isWin ? `cmd /c "${devCommand}"` : devCommand;
-    const child = spawn(shellCmd, [], {
-        cwd: projectDir,
-        shell: true,
-        stdio: ['ignore', 'pipe', 'pipe'],
-        windowsHide: true,
-    });
-    child.stdout?.on('data', (data) => {
-        // Optionally log or filter output
-        const text = data.toString();
-        // Vite prints local URL on stdout
-        if (text.includes('Local:')) {
-            const urlMatch = text.match(/http:\/\/localhost:\d+/);
-            if (urlMatch) {
-                // URL is confirmed
-            }
+    async stopServer() {
+        // If shutdown already in progress, return that promise
+        if (this.shutdownLock) {
+            return this.shutdownLock;
         }
-    });
-    child.stderr?.on('data', (data) => {
-        // Some frameworks output to stderr
-    });
-    child.on('error', (err) => {
-        activeServer = null;
-        throw new Error(`Failed to start dev server: ${err.message}`);
-    });
-    child.on('exit', (code) => {
-        if (activeServer?.process === child) {
-            activeServer = null;
+        const shutdownPromise = this.doStopServer();
+        this.shutdownLock = shutdownPromise;
+        try {
+            return await shutdownPromise;
+        }
+        finally {
+            this.shutdownLock = null;
         }
-    });
-    // Wait for port to be ready
-    const ready = await waitForPort(port, 30000);
-    if (!ready) {
-        // Kill the process if it didn't start in time
-        child.kill();
-        throw new Error(`Dev server did not start within 30 seconds on port ${port}`);
-    }
-    const url = `http://localhost:${port}`;
-    activeServer = {
-        process: child,
-        port,
-        url,
-        startTime: Date.now(),
-    };
-    return {
-        url,
-        port,
-        pid: child.pid || 0,
-        ready: true,
-        startedAt: new Date().toISOString(),
-    };
-}
-async function stopServer() {
-    if (!activeServer) {
-        return { success: true, message: 'No active dev server to stop.' };
     }
-    const child = activeServer.process;
-    const port = activeServer.port;
-    try {
-        // Try graceful shutdown first
-        const isWin = process.platform === 'win32';
-        if (isWin) {
-            spawn('taskkill', ['/pid', String(child.pid), '/f', '/t']);
+    async doStopServer() {
+        if (!this.activeServer) {
+            return { success: true, message: 'No active dev server to stop.' };
         }
-        else {
-            child.kill('SIGTERM');
+        const child = this.activeServer.process;
+        const port = this.activeServer.port;
+        try {
+            // Try graceful shutdown first
+            const isWin = process.platform === 'win32';
+            if (isWin) {
+                spawn('taskkill', ['/pid', String(child.pid), '/f', '/t']);
+            }
+            else {
+                child.kill('SIGTERM');
+            }
+            // Wait for process to exit with timeout
+            await Promise.race([
+                new Promise((resolve) => {
+                    child.on('exit', () => resolve());
+                }),
+                new Promise((resolve) => {
+                    setTimeout(() => {
+                        try {
+                            child.kill('SIGKILL');
+                        }
+                        catch { }
+                        resolve();
+                    }, TIMEOUTS.SERVER_STOP_TIMEOUT);
+                })
+            ]);
+            this.activeServer = null;
+            return {
+                success: true,
+                message: `Dev server on port ${port} stopped.`,
+            };
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            this.activeServer = null;
+            return {
+                success: false,
+                message: `Failed to stop dev server: ${errorMessage}`,
+            };
         }
-        // Wait for process to exit
-        await new Promise((resolve) => {
-            const timeout = setTimeout(() => {
-                child.kill('SIGKILL');
-                resolve();
-            }, 5000);
-            child.on('exit', () => {
-                clearTimeout(timeout);
-                resolve();
-            });
-        });
-        activeServer = null;
-        return {
-            success: true,
-            message: `Dev server on port ${port} stopped.`,
-        };
     }
-    catch (err) {
-        const errorMessage = err instanceof Error ? err.message : String(err);
+    getServerStatus() {
+        if (!this.activeServer)
+            return null;
         return {
-            success: false,
-            message: `Failed to stop dev server: ${errorMessage}`,
+            url: this.activeServer.url,
+            port: this.activeServer.port,
+            pid: this.activeServer.process.pid || 0,
+            ready: this.activeServer.process.exitCode === null,
+            startedAt: new Date(this.activeServer.startTime).toISOString(),
         };
     }
 }
-function getServerStatus() {
-    if (!activeServer)
-        return null;
-    return {
-        url: activeServer.url,
-        port: activeServer.port,
-        pid: activeServer.process.pid || 0,
-        ready: activeServer.process.exitCode === null,
-        startedAt: new Date(activeServer.startTime).toISOString(),
-    };
+// Backward compatibility exports
+const manager = ServerManager.getInstance();
+export async function startServer(projectDir, devCommand, port) {
+    return manager.startServer(projectDir, devCommand, port);
+}
+export async function stopServer() {
+    return manager.stopServer();
+}
+export function getServerStatus() {
+    return manager.getServerStatus();
 }
-export { startServer, stopServer, getServerStatus };
 //# sourceMappingURL=serverManager.js.map

package/dist/serverManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"serverManager.js","sourceRoot":"","sources":["../src/serverManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAIhC,IAAI,YAAY,GAKL,IAAI,CAAC;AAEhB,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,YAAoB,KAAK;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;YACvB,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,mCAAmC;gBAClD,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;gBACnC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU;gBAC1B,OAAO;YACT,CAAC;YACD,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC;QACF,KAAK,EAAE,CAAC;IACV,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,UAAkB,EAClB,UAAkB,EAClB,IAAY;IAEZ,4CAA4C;IAC5C,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC;QACzD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO;gBACL,GAAG,EAAE,YAAY,CAAC,GAAG;gBACrB,IAAI,EAAE,YAAY,CAAC,IAAI;gBACvB,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;gBAClC,KAAK,EAAE,IAAI;gBACX,SAAS,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;aAC1D,CAAC;QACJ,CAAC;QACD,yBAAyB;QACzB,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,8DAA8D;IAC9D,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;YACL,GAAG,EAAE,oBAAoB,IAAI,EAAE;YAC/B,IAAI;YACJ,GAAG,EAAE,CAAC;YACN,KAAK,EAAE,IAAI;YACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,UAAU,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;IAE/D,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE;QAChC,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QACxC,kCAAkC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7B,kCAAkC;QAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACtD,IAAI,QAAQ,EAAE,CAAC;gBACb,mBAAmB;YACrB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QACxC,mCAAmC;IACrC,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACxB,YAAY,GAAG,IAAI,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACxB,IAAI,YAAY,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YACpC,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,4BAA4B;IAC5B,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAE7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,8CAA8C;QAC9C,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sDAAsD,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,GAAG,GAAG,oBAAoB,IAAI,EAAE,CAAC;IACvC,YAAY,GAAG;QACb,OAAO,EAAE,KAAK;QACd,IAAI;QACJ,GAAG;QACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,OAAO;QACL,GAAG;QACH,IAAI;QACJ,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;QACnB,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,UAAU;IACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;IACrE,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC;IACnC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;IAE/B,IAAI,CAAC;QACH,8BAA8B;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;QAC3C,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;QAED,2BAA2B;QAC3B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACtB,OAAO,EAAE,CAAC;YACZ,CAAC,EAAE,IAAI,CAAC,CAAC;YACT,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;gBACpB,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,YAAY,GAAG,IAAI,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,sBAAsB,IAAI,WAAW;SAC/C,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,8BAA8B,YAAY,EAAE;SACtD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO;QACL,GAAG,EAAE,YAAY,CAAC,GAAG;QACrB,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;QAClC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,QAAQ,KAAK,IAAI;QAC7C,SAAS,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;KAC1D,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"serverManager.js","sourceRoot":"","sources":["../src/serverManager.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -28,3 +28,12 @@ export interface ToolContext {
     port?: number;
     cdpPort?: number;
 }
+export type MCPErrorCode = 'FRAMEWORK_NOT_DETECTED' | 'DEV_SERVER_START_FAILED' | 'CDP_CONNECTION_FAILED' | 'PAGE_NAVIGATION_FAILED' | 'TYPE_CHECK_FAILED' | 'CONFIG_NOT_FOUND' | 'INVALID_PROJECT_DIR' | 'PORT_IN_USE' | 'TIMEOUT' | 'UNKNOWN_ERROR';
+export interface MCPError {
+    code: MCPErrorCode;
+    message: string;
+    details?: unknown;
+    suggestion?: string;
+}
+export declare function createMCPError(code: MCPErrorCode, message: string, details?: unknown, suggestion?: string): MCPToolResponse;
+export declare function createMCPSuccess(data: unknown): MCPToolResponse;

package/dist/types.js

@@ -1,2 +1,22 @@
-export {};
+export function createMCPError(code, message, details, suggestion) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({ error: { code, message, details, suggestion } }, null, 2),
+            },
+        ],
+        isError: true,
+    };
+}
+export function createMCPSuccess(data) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAsDA,MAAM,UAAU,cAAc,CAC5B,IAAkB,EAClB,OAAe,EACf,OAAiB,EACjB,UAAmB;IAEnB,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;aACjF;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,7 @@
+export declare const VERSION = "1.0.0-beta.4";
+export declare const VERSION_MAJOR = 1;
+export declare const VERSION_MINOR = 0;
+export declare const VERSION_PATCH = 0;
+export declare const VERSION_PRERELEASE = "beta.4";
+export declare const VERSION_STRING = "1.0.0-beta.4";
+export declare const VERSION_SHORT = "1.0.0";

package/dist/version.js

@@ -0,0 +1,10 @@
+// Version management - single source of truth
+export const VERSION = '1.0.0-beta.4';
+export const VERSION_MAJOR = 1;
+export const VERSION_MINOR = 0;
+export const VERSION_PATCH = 0;
+export const VERSION_PRERELEASE = 'beta.4';
+// Formatted version strings
+export const VERSION_STRING = VERSION;
+export const VERSION_SHORT = `${VERSION_MAJOR}.${VERSION_MINOR}.${VERSION_PATCH}`;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,CAAC,MAAM,OAAO,GAAG,cAAc,CAAC;AACtC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C,4BAA4B;AAC5B,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,aAAa,IAAI,aAAa,IAAI,aAAa,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudu-cli/fronted-preview-mcp",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.4",
   "description": "MCP server for frontend project detection, dev server management, and preview workflow. Pairs with chrome-devtools-mcp for automated frontend checking.",
   "type": "module",
   "main": "dist/index.js",

package/templates/init/instructions.md

@@ -22,14 +22,6 @@
 3. **`auto_fix_loop`** — 自动检测和修复错误（可选）
 4. **汇总结果** — 告诉用户：错误类型、数量、修复建议
 
-## 元素分析与截图工作流
-
-当用户想"分析元素"、"截图"、"查看样式"时，按照以下步骤：
-
-1. **`pick_element`** — 拾取页面元素获取详细信息
-2. **`take_screenshot`** — 截图页面或特定元素
-3. **汇总结果** — 告诉用户：元素信息、样式、截图结果
-
 ## 工具快速参考
 
 | 工具 | 用途 | 优先使用场景 |
@@ -43,8 +35,6 @@
 | `check_page_errors` | 检测页面 console 错误和网络失败 | 检查页面是否有 JavaScript 错误 |
 | `get_typescript_diagnostics` | 检测 TypeScript 类型错误 | 检查代码类型错误和警告 |
 | `auto_fix_loop` | 自动检测和修复错误 | 自动修复所有检测到的错误 |
-| **元素分析工具** |  |  |
-| `pick_element` | 拾取页面元素获取详细信息 | 分析特定元素的信息和样式 |
 | **chrome-devtools** |  |  |
 | `chrome-devtools `navigate_page` | 打开 URL | 拿到 URL 后立即使用 |
 | `chrome-devtools `list_console_messages` | 检查 console 错误 | 页面加载完成后 |
@@ -57,4 +47,4 @@
 - `quick_preview` 已包含 framework 检测，不要再重复调 `get_project_info`
 - dev server 可以保持运行，不需要每次用完就关闭
 - 使用 `auto_fix_loop` 时需要 Chrome 运行在调试模式（--remote-debugging-port=9222）
-- `pick_element` 支持直接传入 CSS 选择器，或进入交互式拾取模式
+- 元素拾取和截图功能已委托给 `chrome-devtools-mcp`

package/templates/init/opencode.json

@@ -3,7 +3,7 @@
   "mcp": {
     "frontend-preview": {
       "type": "local",
-      "command": ["npx", "-y", "@sudu-cli/fronted-preview-mcp"]
+      "command": ["npx", "-y", "@sudu-cli/fronted-preview-mcp@latest"]
     },
     "chrome-devtools": {
       "type": "local",

package/dist/handlers/pickElement.d.ts

@@ -1,10 +0,0 @@
-import type { MCPToolResponse } from '../types.js';
-interface PickElementArgs {
-    projectDir?: string;
-    customPort?: number;
-    cdpPort?: number;
-    selector?: string;
-    waitForLoadMs?: number;
-}
-declare function handlePickElement(args: PickElementArgs): Promise<MCPToolResponse>;
-export { handlePickElement };