webpeel 0.19.4 → 0.20.0

package/dist/mcp/handlers/see.js

@@ -0,0 +1,75 @@
+/**
+ * handleSee — take a screenshot, optionally with design analysis or comparison.
+ */
+import { textResult, safeStringify, timeout } from './types.js';
+export const handleSee = async (args, _ctx) => {
+    const url = args['url'];
+    if (!url || typeof url !== 'string')
+        throw new Error('url is required');
+    if (url.length > 2048)
+        throw new Error('URL too long (max 2048 characters)');
+    const mode = args['mode'] || 'screenshot';
+    const compareUrl = args['compare_url'];
+    const fullPage = args['full_page'] || false;
+    const viewportArg = args['viewport'];
+    // Resolve viewport dimensions
+    let width = 1280;
+    let height = 720;
+    if (viewportArg && typeof viewportArg === 'object' && !Array.isArray(viewportArg)) {
+        const vp = viewportArg;
+        width = vp.width ?? 1280;
+        height = vp.height ?? 720;
+    }
+    else if (viewportArg === 'mobile') {
+        width = 390;
+        height = 844;
+    }
+    else if (viewportArg === 'tablet') {
+        width = 768;
+        height = 1024;
+    }
+    // Secondary object check (handles smart router viewport object)
+    if (args['viewport'] && typeof args['viewport'] === 'object') {
+        const vp = args['viewport'];
+        if (vp.width)
+            width = vp.width;
+        if (vp.height)
+            height = vp.height;
+    }
+    if (mode === 'design') {
+        const { browserDesignAnalysis } = await import('../../core/fetcher.js');
+        const result = await Promise.race([
+            browserDesignAnalysis(url, { width, height }),
+            timeout(90000, 'Design analysis'),
+        ]);
+        return textResult(safeStringify({ url: result.finalUrl, mode: 'design', analysis: result.analysis }));
+    }
+    if (mode === 'compare' && compareUrl) {
+        const { browserDiff } = await import('../../core/fetcher.js');
+        const diff = await Promise.race([
+            browserDiff(url, compareUrl, { width, height, fullPage }),
+            timeout(90000, 'Design compare'),
+        ]);
+        return textResult(safeStringify({
+            url,
+            compare_url: compareUrl,
+            mode: 'compare',
+            diffPixels: diff.diffPixels,
+            totalPixels: diff.totalPixels,
+            diffPercent: diff.diffPercent,
+            screenshot: diff.diffBuffer.toString('base64'),
+        }));
+    }
+    // Default: screenshot
+    const { takeScreenshot } = await import('../../core/screenshot.js');
+    const result = await Promise.race([
+        takeScreenshot(url, { fullPage, width, height, format: 'png' }),
+        timeout(60000, 'Screenshot'),
+    ]);
+    return textResult(safeStringify({
+        url: result.url,
+        mode: 'screenshot',
+        screenshot: result.screenshot,
+        format: result.format,
+    }));
+};

package/dist/mcp/handlers/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared types for MCP handlers.
+ * Both the standalone MCP server and HTTP MCP route import from here.
+ */
+export interface McpToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    } | {
+        type: 'image';
+        data: string;
+        mimeType: string;
+    }>;
+    isError?: boolean;
+}
+export interface McpContext {
+    accountId?: string;
+    /** pg.Pool passed by the HTTP route for webpeel_watch */
+    pool?: unknown;
+}
+export type McpHandler = (args: Record<string, unknown>, ctx?: McpContext) => Promise<McpToolResult>;
+/** Wrap a JSON-serialized string in a text content block. */
+export declare function textResult(text: string): McpToolResult;
+/** Wrap an error message in a text content block with isError=true. */
+export declare function errorResult(message: string): McpToolResult;
+/** Safely JSON-stringify any value; falls back to String() on error. */
+export declare function safeStringify(obj: unknown): string;
+/** Generic timeout promise. */
+export declare function timeout<T>(ms: number, label: string): Promise<T>;

package/dist/mcp/handlers/types.js

@@ -0,0 +1,28 @@
+/**
+ * Shared types for MCP handlers.
+ * Both the standalone MCP server and HTTP MCP route import from here.
+ */
+/** Wrap a JSON-serialized string in a text content block. */
+export function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+/** Wrap an error message in a text content block with isError=true. */
+export function errorResult(message) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
+        isError: true,
+    };
+}
+/** Safely JSON-stringify any value; falls back to String() on error. */
+export function safeStringify(obj) {
+    try {
+        return JSON.stringify(obj, null, 2);
+    }
+    catch {
+        return String(obj);
+    }
+}
+/** Generic timeout promise. */
+export function timeout(ms, label) {
+    return new Promise((_, reject) => setTimeout(() => reject(new Error(`${label} timed out after ${ms / 1000}s`)), ms));
+}

package/dist/mcp/server.d.ts

@@ -1,8 +1,7 @@
 #!/usr/bin/env node
 /**
- * MCP Server for WebPeel
- * 7 consolidated tools (1 meta + 6 specific) with full backward compatibility.
- * All 20 legacy tool names still work — they're just routed to the new handlers.
+ * MCP Server for WebPeel — stdio transport.
+ * Thin wrapper: imports from the shared handler registry in ./handlers/.
+ * All tool logic lives in src/mcp/handlers/*.ts.
  */
 export {};
-//# sourceMappingURL=server.d.ts.map