devlens-mcp 0.4.1 → 0.5.2

package/dist/src/tools/navigation-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-tools.js","sourceRoot":"","sources":["../../../src/tools/navigation-tools.ts"],"names":[],"mappings":";;;AAwBA,oEAmDC;AA3ED,6BAAwB;AAGxB,2DAA8E;AAEjE,QAAA,qBAAqB,GAAG;IACnC,gBAAgB,EAAE;QAChB,WAAW,EACT,2GAA2G;QAC7G,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,GAAG,EAAE,OAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,CACP,uEAAuE,CACxE;SACJ,CAAC;KACH;IACD,eAAe,EAAE;QACf,WAAW,EACT,iHAAiH;QACnH,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC;KACzB;CACF,CAAC;AAEF,SAAgB,4BAA4B,CAC1C,aAA4B,EAC5B,WAAwB,EACxB,UAAuB;IAEvB,KAAK,UAAU,kBAAkB;QAC/B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;QAC/C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,GAAG,GAAkB;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC;QACF,OAAO,IAAA,6BAAc,EAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;IAED,OAAO;QACL,gBAAgB,EAAE,KAAK,EAAE,MAAuB,EAAE,EAAE;YAClD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;YAC/C,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjC,UAAU,EAAE,EAAE,CAAC;YAEf,MAAM,QAAQ,GAAG,MAAM,kBAAkB,EAAE,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,eAAe,MAAM,CAAC,GAAG,OAAO,QAAQ,EAAE;qBACjD;iBACF;aACF,CAAC;QACJ,CAAC;QAED,eAAe,EAAE,KAAK,IAAI,EAAE;YAC1B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;YAC/C,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,UAAU,EAAE,EAAE,CAAC;YAEf,MAAM,QAAQ,GAAG,MAAM,kBAAkB,EAAE,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,qBAAqB,QAAQ,EAAE;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"navigation-tools.js","sourceRoot":"","sources":["../../../src/tools/navigation-tools.ts"],"names":[],"mappings":";;;AAwBA,oEA8CC;AAtED,6BAAwB;AAGxB,2DAA0D;AAE7C,QAAA,qBAAqB,GAAG;IACnC,gBAAgB,EAAE;QAChB,WAAW,EACT,2GAA2G;QAC7G,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,GAAG,EAAE,OAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,CACP,uEAAuE,CACxE;SACJ,CAAC;KACH;IACD,eAAe,EAAE;QACf,WAAW,EACT,iHAAiH;QACnH,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC;KACzB;CACF,CAAC;AAEF,SAAgB,4BAA4B,CAC1C,aAA4B,EAC5B,WAAwB,EACxB,UAAuB;IAEvB,KAAK,UAAU,kBAAkB;QAC/B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;QAC/C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACnD,OAAO,IAAA,6BAAc,EAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO;QACL,gBAAgB,EAAE,KAAK,EAAE,MAAuB,EAAE,EAAE;YAClD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;YAC/C,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjC,UAAU,EAAE,EAAE,CAAC;YAEf,MAAM,QAAQ,GAAG,MAAM,kBAAkB,EAAE,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,eAAe,MAAM,CAAC,GAAG,OAAO,QAAQ,EAAE;qBACjD;iBACF;aACF,CAAC;QACJ,CAAC;QAED,eAAe,EAAE,KAAK,IAAI,EAAE;YAC1B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;YAC/C,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,UAAU,EAAE,EAAE,CAAC;YAEf,MAAM,QAAQ,GAAG,MAAM,kBAAkB,EAAE,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,qBAAqB,QAAQ,EAAE;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/tools/prototype-tools.d.ts

@@ -0,0 +1,102 @@
+import { z } from "zod";
+export declare const prototypeToolSchemas: {
+    devlens_check_prototype: {
+        description: string;
+        parameters: z.ZodObject<{
+            url: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+        }, {
+            url: string;
+        }>;
+    };
+    devlens_explore_prototype: {
+        description: string;
+        parameters: z.ZodObject<{
+            prototypeUrl: z.ZodString;
+            figmaUrl: z.ZodOptional<z.ZodString>;
+            maxScreens: z.ZodDefault<z.ZodNumber>;
+            captureDelay: z.ZodDefault<z.ZodNumber>;
+            viewportWidth: z.ZodDefault<z.ZodNumber>;
+            viewportHeight: z.ZodDefault<z.ZodNumber>;
+            scrollCapture: z.ZodDefault<z.ZodBoolean>;
+            extractDesignTokens: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            viewportWidth: number;
+            viewportHeight: number;
+            prototypeUrl: string;
+            maxScreens: number;
+            captureDelay: number;
+            scrollCapture: boolean;
+            extractDesignTokens: boolean;
+            figmaUrl?: string | undefined;
+        }, {
+            prototypeUrl: string;
+            figmaUrl?: string | undefined;
+            viewportWidth?: number | undefined;
+            viewportHeight?: number | undefined;
+            maxScreens?: number | undefined;
+            captureDelay?: number | undefined;
+            scrollCapture?: boolean | undefined;
+            extractDesignTokens?: boolean | undefined;
+        }>;
+    };
+    devlens_prototype_screen: {
+        description: string;
+        parameters: z.ZodObject<{
+            url: z.ZodString;
+            figmaUrl: z.ZodOptional<z.ZodString>;
+            viewportWidth: z.ZodDefault<z.ZodNumber>;
+            viewportHeight: z.ZodDefault<z.ZodNumber>;
+            scrollDepth: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            viewportWidth: number;
+            viewportHeight: number;
+            scrollDepth: number;
+            figmaUrl?: string | undefined;
+        }, {
+            url: string;
+            figmaUrl?: string | undefined;
+            viewportWidth?: number | undefined;
+            viewportHeight?: number | undefined;
+            scrollDepth?: number | undefined;
+        }>;
+    };
+};
+type ContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
+type ToolResult = {
+    content: ContentBlock[];
+    isError?: boolean;
+};
+export declare function createPrototypeToolHandlers(): {
+    devlens_check_prototype: (params: {
+        url: string;
+    }) => Promise<ToolResult>;
+    devlens_explore_prototype: (params: {
+        prototypeUrl: string;
+        figmaUrl?: string;
+        maxScreens: number;
+        captureDelay: number;
+        viewportWidth: number;
+        viewportHeight: number;
+        scrollCapture: boolean;
+        extractDesignTokens: boolean;
+    }) => Promise<ToolResult>;
+    devlens_prototype_screen: (params: {
+        url: string;
+        figmaUrl?: string;
+        viewportWidth: number;
+        viewportHeight: number;
+        scrollDepth: number;
+    }) => Promise<ToolResult>;
+};
+export {};
+//# sourceMappingURL=prototype-tools.d.ts.map

package/dist/src/tools/prototype-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prototype-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/prototype-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFhC,CAAC;AAEF,KAAK,YAAY,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjE,wBAAgB,2BAA2B;sCAKC;QACtC,GAAG,EAAE,MAAM,CAAC;KACb,KAAG,OAAO,CAAC,UAAU,CAAC;wCAiBmB;QACxC,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,OAAO,CAAC;QACvB,mBAAmB,EAAE,OAAO,CAAC;KAC9B,KAAG,OAAO,CAAC,UAAU,CAAC;uCAakB;QACvC,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;KACrB,KAAG,OAAO,CAAC,UAAU,CAAC;EAgF1B"}

package/dist/src/tools/prototype-tools.js

@@ -0,0 +1,391 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prototypeToolSchemas = void 0;
+exports.createPrototypeToolHandlers = createPrototypeToolHandlers;
+const zod_1 = require("zod");
+const url_parser_js_1 = require("../figma/url-parser.js");
+const figma_api_js_1 = require("../figma/figma-api.js");
+const figma_client_js_1 = require("../figma/figma-client.js");
+const browser_engine_js_1 = require("../prototype/browser-engine.js");
+const web_crawler_js_1 = require("../prototype/web-crawler.js");
+const figma_navigator_js_1 = require("../prototype/figma-navigator.js");
+const screen_analyzer_js_1 = require("../prototype/screen-analyzer.js");
+const flow_reporter_js_1 = require("../prototype/flow-reporter.js");
+exports.prototypeToolSchemas = {
+    devlens_check_prototype: {
+        description: "Smart prototype detection with bidirectional prompting. Give it ANY URL " +
+            "(Figma design, Figma prototype, or web prototype/mock) and it will: " +
+            "(1) detect the type, (2) summarise screens/flow, and " +
+            "(3) ask for the COMPLEMENTARY link. " +
+            "If given a Figma link it asks for the prototype/mock URL. " +
+            "If given a prototype URL it asks for the Figma design link. " +
+            "Having BOTH links enables near-100% build accuracy.",
+        parameters: zod_1.z.object({
+            url: zod_1.z
+                .string()
+                .describe("Any URL — Figma design link, Figma prototype link, or web prototype/mock URL"),
+        }),
+    },
+    devlens_explore_prototype: {
+        description: "Open a prototype in a headless browser, crawl every screen, " +
+            "capture high-res screenshots, extract colours/typography/components, " +
+            "and return a comprehensive flow report. Supports web-hosted prototypes " +
+            "(Vercel, Netlify, etc.) AND Figma prototypes. Optionally provide a Figma " +
+            "design URL alongside the prototype for enriched design-token extraction " +
+            "and near-100% build accuracy.",
+        parameters: zod_1.z.object({
+            prototypeUrl: zod_1.z
+                .string()
+                .describe("Prototype URL (web URL or Figma /proto/ link)"),
+            figmaUrl: zod_1.z
+                .string()
+                .optional()
+                .describe("Figma design URL for exact design specs. Strongly recommended for near-100% accuracy."),
+            maxScreens: zod_1.z
+                .number()
+                .default(15)
+                .describe("Maximum screens to explore (default: 15)"),
+            captureDelay: zod_1.z
+                .number()
+                .default(1500)
+                .describe("Wait ms after each navigation for transitions (default: 1500)"),
+            viewportWidth: zod_1.z
+                .number()
+                .default(390)
+                .describe("Viewport width in px (default: 390 — iPhone 14)"),
+            viewportHeight: zod_1.z
+                .number()
+                .default(844)
+                .describe("Viewport height in px (default: 844)"),
+            scrollCapture: zod_1.z
+                .boolean()
+                .default(true)
+                .describe("Capture additional scroll-position screenshots on long pages"),
+            extractDesignTokens: zod_1.z
+                .boolean()
+                .default(true)
+                .describe("Extract colour palette, typography, spacing patterns"),
+        }),
+    },
+    devlens_prototype_screen: {
+        description: "Deep-analyse a single prototype screen. Opens the URL in a headless " +
+            "browser at the specified viewport, scrolls to the given depth, and " +
+            "returns element-level detail (bounds, colours, text, nesting) for " +
+            "pixel-perfect implementation.",
+        parameters: zod_1.z.object({
+            url: zod_1.z
+                .string()
+                .describe("URL of the specific screen/route to analyse"),
+            figmaUrl: zod_1.z
+                .string()
+                .optional()
+                .describe("Figma design URL for exact specs of this screen"),
+            viewportWidth: zod_1.z.number().default(390),
+            viewportHeight: zod_1.z.number().default(844),
+            scrollDepth: zod_1.z
+                .number()
+                .default(5000)
+                .describe("How far to scroll in pixels (default: 5000)"),
+        }),
+    },
+};
+function createPrototypeToolHandlers() {
+    return {
+        /* ------------------------------------------------------------------ */
+        /*  devlens_check_prototype                                           */
+        /* ------------------------------------------------------------------ */
+        devlens_check_prototype: async (params) => {
+            const parsed = (0, url_parser_js_1.parsePrototypeUrl)(params.url);
+            if (parsed.type === "figma-design") {
+                return handleFigmaDesignCheck(params.url, parsed.fileKey);
+            }
+            if (parsed.type === "figma-proto") {
+                return handleFigmaProtoCheck(params.url, parsed.fileKey);
+            }
+            return handleWebPrototypeCheck(params.url);
+        },
+        /* ------------------------------------------------------------------ */
+        /*  devlens_explore_prototype                                         */
+        /* ------------------------------------------------------------------ */
+        devlens_explore_prototype: async (params) => {
+            const parsed = (0, url_parser_js_1.parsePrototypeUrl)(params.prototypeUrl);
+            if (parsed.type === "figma-proto") {
+                return exploreFigmaPrototype(params);
+            }
+            return exploreWebPrototype(params);
+        },
+        /* ------------------------------------------------------------------ */
+        /*  devlens_prototype_screen                                          */
+        /* ------------------------------------------------------------------ */
+        devlens_prototype_screen: async (params) => {
+            const engine = new browser_engine_js_1.BrowserEngine({
+                viewportWidth: params.viewportWidth,
+                viewportHeight: params.viewportHeight,
+            });
+            try {
+                await engine.launch();
+                await engine.navigate(params.url);
+                await engine.waitMs(1500);
+                const screenshot = await engine.screenshot();
+                const domMeta = await engine.extractDomMetadata();
+                const scrollHeight = await engine.getScrollHeight();
+                const analysis = await (0, screen_analyzer_js_1.analyzeScreen)(screenshot, domMeta, scrollHeight);
+                const scrollCaptures = [];
+                let scrolled = 0;
+                while (scrolled < params.scrollDepth) {
+                    await engine.scrollPage("down", 600);
+                    await engine.waitMs(300);
+                    scrolled = await engine.getScrollPosition();
+                    scrollCaptures.push(await engine.viewportScreenshot());
+                    if (scrollCaptures.length >= 8)
+                        break;
+                }
+                const content = [];
+                const lines = [
+                    `# Deep Screen Analysis: ${params.url}`,
+                    ``,
+                    `## Colours`,
+                    ...analysis.colorPalette.slice(0, 8).map((c) => `  ${c.hex} (${c.percentage.toFixed(1)}%)`),
+                    ``,
+                    `## Typography`,
+                    ...analysis.typography.map((t) => `  <${t.tag}> ${t.text}`),
+                    ``,
+                    `## Interactive Elements (${analysis.interactiveElements.length})`,
+                    ...analysis.interactiveElements.slice(0, 20).map((el) => `  [${el.tag}] "${el.text}" at (${el.bounds.x},${el.bounds.y}) ${el.bounds.width}x${el.bounds.height}${el.href ? ` -> ${el.href}` : ""}`),
+                    ``,
+                    `## Components`,
+                    ...analysis.components.map((c) => `  ${c.type} (${c.count}x): ${c.examples.join(", ")}`),
+                    ``,
+                    `## Navigation`,
+                    ...analysis.navigationElements.map((n) => `  ${n.text}${n.href ? ` -> ${n.href}` : ""}`),
+                    ``,
+                    `Scroll depth: ${scrollHeight}px`,
+                    `Sections: ${analysis.sectionCount}`,
+                ];
+                content.push({ type: "text", text: lines.join("\n") });
+                content.push({
+                    type: "image",
+                    data: screenshot.toString("base64"),
+                    mimeType: "image/png",
+                });
+                for (const cap of scrollCaptures.slice(0, 4)) {
+                    content.push({
+                        type: "image",
+                        data: cap.toString("base64"),
+                        mimeType: "image/png",
+                    });
+                }
+                return { content };
+            }
+            finally {
+                await engine.close();
+            }
+        },
+    };
+}
+/* ====================================================================== */
+/*  check_prototype handlers                                              */
+/* ====================================================================== */
+async function handleFigmaDesignCheck(url, fileKey) {
+    if (!fileKey) {
+        return errorResult("Could not extract Figma file key from URL.");
+    }
+    const token = process.env.FIGMA_TOKEN;
+    if (!token) {
+        return errorResult("FIGMA_TOKEN not set. Cannot check Figma file for prototype connections.");
+    }
+    try {
+        const fileData = await (0, figma_api_js_1.fetchFileDataFull)(fileKey, token, (0, figma_client_js_1.getFigmaClient)());
+        const flow = (0, figma_api_js_1.extractPrototypeFlows)(fileData);
+        const lines = [
+            `Figma design detected! File: ${fileData.name}`,
+            ``,
+        ];
+        if (flow.hasPrototype) {
+            lines.push(`PROTOTYPE CHECK: This file has prototype connections!`, `  - ${flow.screenCount} screens in the prototype flow`, `  - Starting frame: ${flow.startingNodeName || "unknown"}`, `  - Interactions: ${flow.connections.length} connections`, ``);
+            const triggers = new Map();
+            for (const c of flow.connections) {
+                triggers.set(c.trigger, (triggers.get(c.trigger) || 0) + 1);
+            }
+            const triggerSummary = [...triggers.entries()]
+                .map(([t, n]) => `${n} ${t.toLowerCase().replace("_", " ")}`)
+                .join(", ");
+            if (triggerSummary) {
+                lines.push(`  - Trigger types: ${triggerSummary}`, ``);
+            }
+        }
+        else {
+            lines.push(`PROTOTYPE CHECK: No prototype connections found in this file.`, ``);
+        }
+        lines.push(`ACTION NEEDED: Provide the prototype sharing link so I can explore`, `the full user flow. Ask the developer:`, `'Is there a prototype link for this design? (figma.com/proto/... or a web URL like Vercel/Netlify)'`, ``, `Without prototype: I can still extract static design specs.`, `With prototype: I'll understand the complete interaction flow for near-100% accuracy.`);
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to check Figma file: ${msg}`);
+    }
+}
+async function handleFigmaProtoCheck(url, fileKey) {
+    const lines = [`Figma prototype detected!`, ``];
+    if (fileKey && process.env.FIGMA_TOKEN) {
+        try {
+            const fileData = await (0, figma_api_js_1.fetchFileDataFull)(fileKey, process.env.FIGMA_TOKEN, (0, figma_client_js_1.getFigmaClient)());
+            const flow = (0, figma_api_js_1.extractPrototypeFlows)(fileData);
+            lines.push(`File: ${fileData.name}`, `Screens in flow: ${flow.screenCount}`, `Starting frame: ${flow.startingNodeName || "unknown"}`, `Connections: ${flow.connections.length}`, ``);
+        }
+        catch {
+            lines.push(`Could not fetch file details (token issue or permissions).`, ``);
+        }
+    }
+    lines.push(`ACTION NEEDED: Also provide the Figma DESIGN link (figma.com/design/...)`, `so I can extract exact design specs alongside the prototype flow.`, ``, `With design link: exact colours, spacing, typography, component structure.`, `Without: I'll explore the prototype visually but specs will be approximate.`);
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+}
+async function handleWebPrototypeCheck(url) {
+    const engine = new browser_engine_js_1.BrowserEngine();
+    try {
+        await engine.launch();
+        await engine.navigate(url);
+        await engine.waitMs(1500);
+        const domMeta = await engine.extractDomMetadata();
+        const links = await engine.extractLinks();
+        const uniquePaths = new Set(links.map((l) => {
+            try {
+                return new URL(l.href).pathname.replace(/\/+$/, "") || "/";
+            }
+            catch {
+                return "/";
+            }
+        }));
+        const lines = [
+            `Web prototype detected!`,
+            `URL: ${url}`,
+            `Title: ${domMeta.title || "(no title)"}`,
+            ``,
+            `Discovered ${uniquePaths.size} screens/routes:`,
+            ...[...uniquePaths].slice(0, 20).map((p) => `  - ${p}`),
+            ``,
+            `Page structure:`,
+            `  - Headings: ${domMeta.headings.length}`,
+            `  - Links: ${domMeta.links.length}`,
+            `  - Images: ${domMeta.images.length}`,
+            `  - Interactive elements: ${domMeta.interactiveElements.length}`,
+            ``,
+            `ACTION NEEDED: Provide the Figma design link so I can extract exact`,
+            `design specs. Ask the developer:`,
+            `'Is there a Figma file for this prototype? I need it for pixel-perfect specs`,
+            `(colors, spacing, typography, component structure).'`,
+            ``,
+            `Without Figma: I can explore the prototype and extract visual patterns.`,
+            `With Figma: I'll have exact design tokens + flow understanding = near-100% accuracy.`,
+        ];
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return errorResult(`Failed to probe web prototype: ${msg}`);
+    }
+    finally {
+        await engine.close();
+    }
+}
+/* ====================================================================== */
+/*  explore_prototype handlers                                            */
+/* ====================================================================== */
+async function exploreWebPrototype(params) {
+    const engine = new browser_engine_js_1.BrowserEngine({
+        viewportWidth: params.viewportWidth,
+        viewportHeight: params.viewportHeight,
+    });
+    try {
+        await engine.launch();
+        const crawler = new web_crawler_js_1.WebCrawler(engine, {
+            maxPages: params.maxScreens,
+            scrollCapture: params.scrollCapture,
+            captureDelay: params.captureDelay,
+            viewportWidth: params.viewportWidth,
+            viewportHeight: params.viewportHeight,
+        });
+        const crawlResults = await crawler.crawl(params.prototypeUrl);
+        const analyses = [];
+        for (const result of crawlResults) {
+            const scrollHeight = result.scrollCaptures.length > 0
+                ? result.scrollCaptures[result.scrollCaptures.length - 1].scrollY
+                : 0;
+            const analysis = await (0, screen_analyzer_js_1.analyzeScreen)(result.screenshot, result.domMetadata, scrollHeight);
+            analyses.push(analysis);
+        }
+        const report = (0, flow_reporter_js_1.buildWebFlowReport)(crawlResults, analyses, !params.figmaUrl);
+        const content = (0, flow_reporter_js_1.formatFlowReportContent)(report);
+        return { content };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return errorResult(`Web prototype exploration failed: ${msg}`);
+    }
+    finally {
+        await engine.close();
+    }
+}
+async function exploreFigmaPrototype(params) {
+    const parsed = (0, url_parser_js_1.parseFigmaUrl)(params.prototypeUrl);
+    if (!parsed?.fileKey) {
+        return errorResult("Could not extract file key from Figma prototype URL.");
+    }
+    const token = process.env.FIGMA_TOKEN;
+    if (!token) {
+        return errorResult("FIGMA_TOKEN not set. Required for Figma prototype exploration.");
+    }
+    const engine = new browser_engine_js_1.BrowserEngine({
+        viewportWidth: params.viewportWidth,
+        viewportHeight: params.viewportHeight,
+    });
+    try {
+        const fileData = await (0, figma_api_js_1.fetchFileDataFull)(parsed.fileKey, token, (0, figma_client_js_1.getFigmaClient)());
+        const flow = (0, figma_api_js_1.extractPrototypeFlows)(fileData);
+        if (!flow.hasPrototype) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "No prototype connections found in this Figma file. " +
+                            "Check that the file has prototype interactions set up.",
+                    }],
+            };
+        }
+        await engine.launch();
+        const navigator = new figma_navigator_js_1.FigmaNavigator(engine, {
+            maxScreens: params.maxScreens,
+            captureDelay: params.captureDelay,
+        });
+        const steps = await navigator.navigatePrototype(params.prototypeUrl, flow);
+        const analyses = [];
+        for (const step of steps) {
+            const emptyDom = {
+                title: step.screenName,
+                headings: [],
+                links: [],
+                images: [],
+                interactiveElements: [],
+                textContent: "",
+            };
+            const analysis = await (0, screen_analyzer_js_1.analyzeScreen)(step.screenshot, emptyDom, 0);
+            analyses.push(analysis);
+        }
+        const report = (0, flow_reporter_js_1.buildFigmaFlowReport)(steps, analyses, !params.figmaUrl);
+        const content = (0, flow_reporter_js_1.formatFlowReportContent)(report);
+        return { content };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return errorResult(`Figma prototype exploration failed: ${msg}`);
+    }
+    finally {
+        await engine.close();
+    }
+}
+function errorResult(message) {
+    return {
+        content: [{ type: "text", text: message }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=prototype-tools.js.map

package/dist/src/tools/prototype-tools.js.map

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

package/dist/src/tools/screenshot-tools.d.ts

@@ -1,7 +1,6 @@
 import { z } from "zod";
 import type { DeviceManager } from "../platform/device-manager.js";
 import type { RefRegistry } from "../snapshot/ref-registry.js";
-import { type Tolerances } from "../visual/property-comparator.js";
 export declare const screenshotToolSchemas: {
     devlens_screenshot: {
         description: string;
@@ -101,53 +100,6 @@ export declare const screenshotToolSchemas: {
             preprocessImageB?: boolean | undefined;
         }>;
     };
-    devlens_compare_properties: {
-        description: string;
-        parameters: z.ZodObject<{
-            figmaUrl: z.ZodOptional<z.ZodString>;
-            fileKey: z.ZodOptional<z.ZodString>;
-            nodeId: z.ZodOptional<z.ZodString>;
-            includeColors: z.ZodDefault<z.ZodBoolean>;
-            tolerances: z.ZodOptional<z.ZodObject<{
-                dimensions: z.ZodDefault<z.ZodNumber>;
-                fontSize: z.ZodDefault<z.ZodNumber>;
-                color: z.ZodDefault<z.ZodNumber>;
-                spacing: z.ZodDefault<z.ZodNumber>;
-            }, "strip", z.ZodTypeAny, {
-                color: number;
-                spacing: number;
-                dimensions: number;
-                fontSize: number;
-            }, {
-                color?: number | undefined;
-                spacing?: number | undefined;
-                dimensions?: number | undefined;
-                fontSize?: number | undefined;
-            }>>;
-        }, "strip", z.ZodTypeAny, {
-            includeColors: boolean;
-            figmaUrl?: string | undefined;
-            fileKey?: string | undefined;
-            nodeId?: string | undefined;
-            tolerances?: {
-                color: number;
-                spacing: number;
-                dimensions: number;
-                fontSize: number;
-            } | undefined;
-        }, {
-            figmaUrl?: string | undefined;
-            fileKey?: string | undefined;
-            nodeId?: string | undefined;
-            includeColors?: boolean | undefined;
-            tolerances?: {
-                color?: number | undefined;
-                spacing?: number | undefined;
-                dimensions?: number | undefined;
-                fontSize?: number | undefined;
-            } | undefined;
-        }>;
-    };
     devlens_compare_with_figma: {
         description: string;
         parameters: z.ZodObject<{
@@ -183,9 +135,11 @@ export declare const screenshotToolSchemas: {
             scale: number;
             resizeStrategy: "fit" | "scale" | "crop";
             preprocessReference: boolean;
-            excludeSystemBars: "ios" | "android" | "auto" | "none";
+            excludeSystemBars: "ios" | "android" | "none" | "auto";
             layoutReport: boolean;
             depth: "quick" | "standard" | "thorough";
+            fileKey?: string | undefined;
+            nodeId?: string | undefined;
             cropRef?: string | undefined;
             region?: {
                 width: number;
@@ -194,14 +148,14 @@ export declare const screenshotToolSchemas: {
                 y: number;
             } | undefined;
             figmaUrl?: string | undefined;
-            fileKey?: string | undefined;
-            nodeId?: string | undefined;
         }, {
             threshold?: number | undefined;
             scale?: number | undefined;
             resizeStrategy?: "fit" | "scale" | "crop" | undefined;
             preprocessReference?: boolean | undefined;
-            excludeSystemBars?: "ios" | "android" | "auto" | "none" | undefined;
+            excludeSystemBars?: "ios" | "android" | "none" | "auto" | undefined;
+            fileKey?: string | undefined;
+            nodeId?: string | undefined;
             cropRef?: string | undefined;
             region?: {
                 width: number;
@@ -210,8 +164,6 @@ export declare const screenshotToolSchemas: {
                 y: number;
             } | undefined;
             figmaUrl?: string | undefined;
-            fileKey?: string | undefined;
-            nodeId?: string | undefined;
             layoutReport?: boolean | undefined;
             depth?: "quick" | "standard" | "thorough" | undefined;
         }>;
@@ -313,25 +265,6 @@ export declare function createScreenshotToolHandlers(deviceManager: DeviceManage
         }[];
         isError: boolean;
     }>;
-    devlens_compare_properties: (params: {
-        figmaUrl?: string;
-        fileKey?: string;
-        nodeId?: string;
-        includeColors: boolean;
-        tolerances?: Partial<Tolerances>;
-    }) => Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-        isError: boolean;
-    } | {
-        content: {
-            type: "text";
-            text: string;
-        }[];
-        isError?: undefined;
-    }>;
     devlens_compare_with_figma: (params: {
         figmaUrl?: string;
         fileKey?: string;
@@ -365,7 +298,7 @@ export declare function createScreenshotToolHandlers(deviceManager: DeviceManage
     } | {
         content: {
             type: "text";
-            text: string;
+            text: string | undefined;
         }[];
         isError: boolean;
     }>;