@ticktockbent/charlotte 0.1.0

package/dist/tools/session.js

@@ -0,0 +1,372 @@
+import { z } from "zod";
+import { logger } from "../utils/logger.js";
+import { renderActivePage, formatPageResponse, handleToolError, } from "./tool-helpers.js";
+const CookieSchema = z.object({
+    name: z.string().describe("Cookie name"),
+    value: z.string().describe("Cookie value"),
+    domain: z.string().describe("Cookie domain"),
+    path: z.string().optional().describe("Cookie path (default: '/')"),
+    secure: z.boolean().optional().describe("Secure flag"),
+    httpOnly: z.boolean().optional().describe("HttpOnly flag"),
+    sameSite: z
+        .enum(["Strict", "Lax", "None"])
+        .optional()
+        .describe("SameSite attribute"),
+});
+export function registerSessionTools(server, deps) {
+    // ─── charlotte:set_cookies ───
+    server.registerTool("charlotte:set_cookies", {
+        description: "Set cookies on the active page. Cookies persist for subsequent navigations within matching domains.",
+        inputSchema: {
+            cookies: z
+                .array(CookieSchema)
+                .describe("Array of cookie objects to set"),
+        },
+    }, async ({ cookies }) => {
+        try {
+            await deps.browserManager.ensureConnected();
+            const page = deps.pageManager.getActivePage();
+            logger.info("Setting cookies", { count: cookies.length });
+            const puppeteerCookies = cookies.map((cookie) => ({
+                name: cookie.name,
+                value: cookie.value,
+                domain: cookie.domain,
+                path: cookie.path ?? "/",
+                secure: cookie.secure,
+                httpOnly: cookie.httpOnly,
+                sameSite: cookie.sameSite,
+            }));
+            await page.setCookie(...puppeteerCookies);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            cookies_set: cookies.length,
+                            details: cookies.map((c) => ({
+                                name: c.name,
+                                domain: c.domain,
+                                path: c.path ?? "/",
+                            })),
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ─── charlotte:set_headers ───
+    server.registerTool("charlotte:set_headers", {
+        description: "Set extra HTTP headers for subsequent requests. Headers persist for all navigations on the active page.",
+        inputSchema: {
+            headers: z
+                .record(z.string(), z.string())
+                .describe("Key-value header pairs (e.g. { 'Authorization': 'Bearer token' })"),
+        },
+    }, async ({ headers }) => {
+        try {
+            await deps.browserManager.ensureConnected();
+            const page = deps.pageManager.getActivePage();
+            logger.info("Setting extra HTTP headers", {
+                headerNames: Object.keys(headers),
+            });
+            await page.setExtraHTTPHeaders(headers);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            headers_set: Object.keys(headers),
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ─── charlotte:configure ───
+    server.registerTool("charlotte:configure", {
+        description: "Configure Charlotte runtime settings. Changes take effect immediately.",
+        inputSchema: {
+            snapshot_depth: z
+                .number()
+                .optional()
+                .describe("Ring buffer size for snapshots (default: 50, min: 5, max: 500)"),
+            auto_snapshot: z
+                .enum(["every_action", "observe_only", "manual"])
+                .optional()
+                .describe('"every_action" (default) — snapshot after every tool, "observe_only" — only on observe, "manual" — only with explicit snapshot: true'),
+        },
+    }, async ({ snapshot_depth, auto_snapshot }) => {
+        try {
+            logger.info("Configuring Charlotte", { snapshot_depth, auto_snapshot });
+            if (snapshot_depth !== undefined) {
+                deps.snapshotStore.setDepth(snapshot_depth);
+                deps.config.snapshotDepth = Math.max(5, Math.min(500, snapshot_depth));
+            }
+            if (auto_snapshot !== undefined) {
+                deps.config.autoSnapshot = auto_snapshot;
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            config: {
+                                snapshot_depth: deps.config.snapshotDepth,
+                                auto_snapshot: deps.config.autoSnapshot,
+                            },
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ─── charlotte:tabs ───
+    server.registerTool("charlotte:tabs", {
+        description: "List all open browser tabs with their URLs, titles, and active status.",
+        inputSchema: {},
+    }, async () => {
+        try {
+            await deps.browserManager.ensureConnected();
+            const tabs = await deps.pageManager.listTabs();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ tabs }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ─── charlotte:tab_open ───
+    server.registerTool("charlotte:tab_open", {
+        description: "Open a new browser tab. Optionally navigate to a URL. The new tab becomes the active tab.",
+        inputSchema: {
+            url: z
+                .string()
+                .optional()
+                .describe("URL to navigate to (default: blank page)"),
+        },
+    }, async ({ url }) => {
+        try {
+            await deps.browserManager.ensureConnected();
+            const tabId = await deps.pageManager.openTab(deps.browserManager, url);
+            logger.info("Opened new tab", { tabId, url });
+            const representation = await renderActivePage(deps, {
+                source: "action",
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            tab_id: tabId,
+                            ...representation,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ─── charlotte:tab_switch ───
+    server.registerTool("charlotte:tab_switch", {
+        description: "Switch to a different browser tab by its tab ID. Returns the page representation of the activated tab.",
+        inputSchema: {
+            tab_id: z.string().describe("ID of the tab to switch to"),
+        },
+    }, async ({ tab_id }) => {
+        try {
+            await deps.browserManager.ensureConnected();
+            await deps.pageManager.switchTab(tab_id);
+            logger.info("Switched to tab", { tab_id });
+            const representation = await renderActivePage(deps, {
+                source: "action",
+            });
+            return formatPageResponse(representation);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ─── charlotte:tab_close ───
+    server.registerTool("charlotte:tab_close", {
+        description: "Close a browser tab by its ID. If the closed tab was active, switches to the first remaining tab.",
+        inputSchema: {
+            tab_id: z.string().describe("ID of the tab to close"),
+        },
+    }, async ({ tab_id }) => {
+        try {
+            await deps.browserManager.ensureConnected();
+            await deps.pageManager.closeTab(tab_id);
+            logger.info("Closed tab", { tab_id });
+            const remainingTabs = await deps.pageManager.listTabs();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            closed: tab_id,
+                            remaining_tabs: remainingTabs,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ─── charlotte:viewport ───
+    const DEVICE_PRESETS = {
+        mobile: { width: 375, height: 667 },
+        tablet: { width: 768, height: 1024 },
+        desktop: { width: 1280, height: 720 },
+    };
+    server.registerTool("charlotte:viewport", {
+        description: "Change the browser viewport dimensions. Use a device preset or specify custom width/height. Returns page representation at the new viewport size.",
+        inputSchema: {
+            width: z
+                .number()
+                .optional()
+                .describe("Viewport width in pixels"),
+            height: z
+                .number()
+                .optional()
+                .describe("Viewport height in pixels"),
+            device: z
+                .enum(["mobile", "tablet", "desktop"])
+                .optional()
+                .describe('Device preset (overrides width/height). "mobile" = 375×667, "tablet" = 768×1024, "desktop" = 1280×720'),
+        },
+    }, async ({ width, height, device }) => {
+        try {
+            await deps.browserManager.ensureConnected();
+            const page = deps.pageManager.getActivePage();
+            let viewportWidth;
+            let viewportHeight;
+            if (device) {
+                const preset = DEVICE_PRESETS[device];
+                viewportWidth = preset.width;
+                viewportHeight = preset.height;
+            }
+            else if (width !== undefined && height !== undefined) {
+                viewportWidth = width;
+                viewportHeight = height;
+            }
+            else {
+                viewportWidth = width ?? 1280;
+                viewportHeight = height ?? 720;
+            }
+            logger.info("Setting viewport", {
+                width: viewportWidth,
+                height: viewportHeight,
+                device,
+            });
+            await page.setViewport({
+                width: viewportWidth,
+                height: viewportHeight,
+            });
+            const representation = await renderActivePage(deps, {
+                source: "action",
+            });
+            return formatPageResponse(representation);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    // ─── charlotte:network ───
+    const THROTTLE_PRESETS = {
+        "3g": {
+            offline: false,
+            downloadThroughput: (1.6 * 1024 * 1024) / 8,
+            uploadThroughput: (750 * 1024) / 8,
+            latency: 150,
+        },
+        "4g": {
+            offline: false,
+            downloadThroughput: (4 * 1024 * 1024) / 8,
+            uploadThroughput: (3 * 1024 * 1024) / 8,
+            latency: 20,
+        },
+        offline: {
+            offline: true,
+            downloadThroughput: 0,
+            uploadThroughput: 0,
+            latency: 0,
+        },
+        none: {
+            offline: false,
+            downloadThroughput: -1,
+            uploadThroughput: -1,
+            latency: 0,
+        },
+    };
+    server.registerTool("charlotte:network", {
+        description: "Configure network conditions for the active page. Set throttling presets, block URL patterns, or enable request logging.",
+        inputSchema: {
+            throttle: z
+                .enum(["3g", "4g", "offline", "none"])
+                .optional()
+                .describe('Network throttling preset. "3g" = slow, "4g" = fast mobile, "offline" = no network, "none" = disable throttling'),
+            block: z
+                .array(z.string())
+                .optional()
+                .describe("URL patterns to block (e.g. [\"*.ads.com\", \"tracking.js\"]). Pass empty array to clear."),
+        },
+    }, async ({ throttle, block }) => {
+        try {
+            await deps.browserManager.ensureConnected();
+            const page = deps.pageManager.getActivePage();
+            const session = await page.createCDPSession();
+            const appliedSettings = {};
+            if (throttle !== undefined) {
+                const preset = THROTTLE_PRESETS[throttle];
+                await session.send("Network.emulateNetworkConditions", preset);
+                appliedSettings.throttle = throttle;
+                logger.info("Applied network throttling", { throttle });
+            }
+            if (block !== undefined) {
+                await session.send("Network.setBlockedURLs", { urls: block });
+                appliedSettings.blocked_patterns = block;
+                logger.info("Set blocked URL patterns", {
+                    patternCount: block.length,
+                });
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            network: appliedSettings,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=session.js.map

package/dist/tools/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAClE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IACtD,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC1D,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,oBAAoB,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,IAAsB;IAEtB,gCAAgC;IAChC,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EACT,qGAAqG;QACvG,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;iBACP,KAAK,CAAC,YAAY,CAAC;iBACnB,QAAQ,CAAC,gCAAgC,CAAC;SAC9C;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YAE9C,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAE1D,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAChD,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,GAAG;gBACxB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAiD;aACnE,CAAC,CAAC,CAAC;YAEJ,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,gBAAgB,CAAC,CAAC;YAE1C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,OAAO,EAAE,IAAI;4BACb,WAAW,EAAE,OAAO,CAAC,MAAM;4BAC3B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gCAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;gCACZ,MAAM,EAAE,CAAC,CAAC,MAAM;gCAChB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,GAAG;6BACpB,CAAC,CAAC;yBACJ,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,gCAAgC;IAChC,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EACT,yGAAyG;QAC3G,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;iBACP,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;iBAC9B,QAAQ,CAAC,mEAAmE,CAAC;SACjF;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YAE9C,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;gBACxC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;aAClC,CAAC,CAAC;YAEH,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAExC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,OAAO,EAAE,IAAI;4BACb,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;yBAClC,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8BAA8B;IAC9B,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,wEAAwE;QAC1E,WAAW,EAAE;YACX,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,gEAAgE,CAAC;YAC7E,aAAa,EAAE,CAAC;iBACb,IAAI,CAAC,CAAC,cAAc,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;iBAChD,QAAQ,EAAE;iBACV,QAAQ,CACP,sIAAsI,CACvI;SACJ;KACF,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;YAExE,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;gBAC5C,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;YACzE,CAAC;YAED,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBAChC,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,aAAiC,CAAC;YAC/D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,OAAO,EAAE,IAAI;4BACb,MAAM,EAAE;gCACN,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;gCACzC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;6BACxC;yBACF,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,yBAAyB;IACzB,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EAAE,wEAAwE;QACrF,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;YAE5C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAE/C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;qBAC/B;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,6BAA6B;IAC7B,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EACT,2FAA2F;QAC7F,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,0CAA0C,CAAC;SACxD;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;YAE5C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;YACvE,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAE9C,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE;gBAClD,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,KAAK;4BACb,GAAG,cAAc;yBAClB,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,+BAA+B;IAC/B,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EACT,wGAAwG;QAC1G,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;SAC1D;KACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;YAE5C,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAE3C,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE;gBAClD,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;YAEH,OAAO,kBAAkB,CAAC,cAAc,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8BAA8B;IAC9B,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,mGAAmG;QACrG,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SACtD;KACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;YAE5C,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAEtC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAExD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,OAAO,EAAE,IAAI;4BACb,MAAM,EAAE,MAAM;4BACd,cAAc,EAAE,aAAa;yBAC9B,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,6BAA6B;IAE7B,MAAM,cAAc,GAAsD;QACxE,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;QACnC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QACpC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;KACtC,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EACT,mJAAmJ;QACrJ,WAAW,EAAE;YACX,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,0BAA0B,CAAC;YACvC,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2BAA2B,CAAC;YACxC,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;iBACrC,QAAQ,EAAE;iBACV,QAAQ,CACP,uGAAuG,CACxG;SACJ;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YAE9C,IAAI,aAAqB,CAAC;YAC1B,IAAI,cAAsB,CAAC;YAE3B,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;gBACtC,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC;gBAC7B,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;YACjC,CAAC;iBAAM,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvD,aAAa,GAAG,KAAK,CAAC;gBACtB,cAAc,GAAG,MAAM,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,KAAK,IAAI,IAAI,CAAC;gBAC9B,cAAc,GAAG,MAAM,IAAI,GAAG,CAAC;YACjC,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE;gBAC9B,KAAK,EAAE,aAAa;gBACpB,MAAM,EAAE,cAAc;gBACtB,MAAM;aACP,CAAC,CAAC;YAEH,MAAM,IAAI,CAAC,WAAW,CAAC;gBACrB,KAAK,EAAE,aAAa;gBACpB,MAAM,EAAE,cAAc;aACvB,CAAC,CAAC;YAEH,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE;gBAClD,MAAM,EAAE,QAAQ;aACjB,CAAC,CAAC;YAEH,OAAO,kBAAkB,CAAC,cAAc,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,4BAA4B;IAE5B,MAAM,gBAAgB,GAQlB;QACF,IAAI,EAAE;YACJ,OAAO,EAAE,KAAK;YACd,kBAAkB,EAAE,CAAC,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;YAC3C,gBAAgB,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YAClC,OAAO,EAAE,GAAG;SACb;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,KAAK;YACd,kBAAkB,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;YACzC,gBAAgB,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;YACvC,OAAO,EAAE,EAAE;SACZ;QACD,OAAO,EAAE;YACP,OAAO,EAAE,IAAI;YACb,kBAAkB,EAAE,CAAC;YACrB,gBAAgB,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;SACX;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,KAAK;YACd,kBAAkB,EAAE,CAAC,CAAC;YACtB,gBAAgB,EAAE,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;SACX;KACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,0HAA0H;QAC5H,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC;iBACR,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;iBACrC,QAAQ,EAAE;iBACV,QAAQ,CACP,iHAAiH,CAClH;YACH,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,2FAA2F,CAC5F;SACJ;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAE9C,MAAM,eAAe,GAGjB,EAAE,CAAC;YAEP,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBAC1C,MAAM,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,MAAM,CAAC,CAAC;gBAC/D,eAAe,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC1D,CAAC;YAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC9D,eAAe,CAAC,gBAAgB,GAAG,KAAK,CAAC;gBACzC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;oBACtC,YAAY,EAAE,KAAK,CAAC,MAAM;iBAC3B,CAAC,CAAC;YACL,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,OAAO,EAAE,IAAI;4BACb,OAAO,EAAE,eAAe;yBACzB,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/tool-helpers.d.ts

@@ -0,0 +1,89 @@
+import type { Page } from "puppeteer";
+import type { PageManager } from "../browser/page-manager.js";
+import type { BrowserManager } from "../browser/browser-manager.js";
+import type { RendererPipeline } from "../renderer/renderer-pipeline.js";
+import type { ElementIdGenerator } from "../renderer/element-id-generator.js";
+import type { SnapshotStore } from "../state/snapshot-store.js";
+import type { CharlotteConfig } from "../types/config.js";
+import type { DevModeState } from "../dev/dev-mode-state.js";
+import type { PageRepresentation, InteractiveElement } from "../types/page-representation.js";
+import type { DetailLevel } from "../renderer/renderer-pipeline.js";
+import { CharlotteError } from "../types/errors.js";
+export interface ToolDependencies {
+    browserManager: BrowserManager;
+    pageManager: PageManager;
+    rendererPipeline: RendererPipeline;
+    elementIdGenerator: ElementIdGenerator;
+    snapshotStore: SnapshotStore;
+    config: CharlotteConfig;
+    devModeState?: DevModeState;
+}
+export interface RenderOptions {
+    detail?: DetailLevel;
+    selector?: string;
+    includeStyles?: boolean;
+    /** Who triggered this render. Controls auto-snapshot behavior. */
+    source?: "observe" | "action" | "internal";
+    /** Force a snapshot regardless of auto_snapshot config. */
+    forceSnapshot?: boolean;
+}
+/**
+ * Render the active page, attach console/network errors, and optionally
+ * push a snapshot to the store.
+ */
+export declare function renderActivePage(deps: ToolDependencies, options?: RenderOptions): Promise<PageRepresentation>;
+/**
+ * Resolve an element ID to a Puppeteer ElementHandle via CDP backend node ID.
+ * If the ID is stale (not found after re-render), throws ELEMENT_NOT_FOUND
+ * with a findSimilar suggestion.
+ */
+export declare function resolveElement(deps: ToolDependencies, elementId: string): Promise<{
+    page: Page;
+    backendNodeId: number;
+}>;
+/**
+ * Render after an interaction action and attach a delta diff.
+ * Captures the pre-action snapshot (latest in store), renders post-action
+ * state, and computes a structural diff between them.
+ */
+export declare function renderAfterAction(deps: ToolDependencies): Promise<PageRepresentation>;
+/**
+ * Format a PageRepresentation as an MCP tool response.
+ */
+export declare function formatPageResponse(representation: PageRepresentation): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+/**
+ * Format an array of interactive elements as an MCP tool response.
+ */
+export declare function formatElementsResponse(elements: InteractiveElement[]): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+/**
+ * Format a CharlotteError as an MCP tool error response.
+ */
+export declare function formatErrorResponse(error: CharlotteError): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+/**
+ * Wrap a tool handler to catch CharlotteErrors and unexpected errors,
+ * returning consistent error responses.
+ */
+export declare function handleToolError(error: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+//# sourceMappingURL=tool-helpers.d.ts.map

package/dist/tools/tool-helpers.d.ts.map

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

package/dist/tools/tool-helpers.js

@@ -0,0 +1,127 @@
+import { CharlotteError, CharlotteErrorCode } from "../types/errors.js";
+import { diffRepresentations } from "../state/differ.js";
+/**
+ * Render the active page, attach console/network errors, and optionally
+ * push a snapshot to the store.
+ */
+export async function renderActivePage(deps, options = {}) {
+    const { detail = "summary", selector, includeStyles, source = "internal", forceSnapshot = false, } = options;
+    const page = deps.pageManager.getActivePage();
+    const representation = await deps.rendererPipeline.render(page, {
+        detail,
+        selector,
+        includeStyles,
+    });
+    // Attach collected errors from page manager
+    representation.errors = {
+        console: deps.pageManager.getConsoleErrors(),
+        network: deps.pageManager.getNetworkErrors(),
+    };
+    // Determine whether to push a snapshot.
+    // "internal" renders (e.g. resolveElement re-renders) never auto-snapshot.
+    const shouldSnapshot = forceSnapshot ||
+        (source !== "internal" &&
+            (deps.config.autoSnapshot === "every_action" ||
+                (deps.config.autoSnapshot === "observe_only" && source === "observe")));
+    if (shouldSnapshot) {
+        deps.snapshotStore.push(representation);
+    }
+    // Attach pending reload event from dev mode, if any
+    const pendingReloadEvent = deps.devModeState?.consumePendingReloadEvent();
+    if (pendingReloadEvent) {
+        representation.reload_event = pendingReloadEvent;
+    }
+    return representation;
+}
+/**
+ * Resolve an element ID to a Puppeteer ElementHandle via CDP backend node ID.
+ * If the ID is stale (not found after re-render), throws ELEMENT_NOT_FOUND
+ * with a findSimilar suggestion.
+ */
+export async function resolveElement(deps, elementId) {
+    const page = deps.pageManager.getActivePage();
+    // Step 1: Check current map
+    let backendNodeId = deps.elementIdGenerator.resolveId(elementId);
+    if (backendNodeId !== null) {
+        return { page, backendNodeId };
+    }
+    // Step 2: Re-render and check again (map was invalidated)
+    const freshRepresentation = await renderActivePage(deps, { detail: "minimal" });
+    backendNodeId = deps.elementIdGenerator.resolveId(elementId);
+    if (backendNodeId !== null) {
+        return { page, backendNodeId };
+    }
+    // Step 3: Element is genuinely gone — suggest similar
+    const similar = deps.elementIdGenerator.findSimilar(elementId, freshRepresentation.interactive);
+    const suggestion = similar
+        ? `Element '${elementId}' not found. Did you mean '${similar.id}' (${similar.type}: "${similar.label}")?`
+        : `Element '${elementId}' not found. Call charlotte:observe to get current page state.`;
+    throw new CharlotteError(CharlotteErrorCode.ELEMENT_NOT_FOUND, `Element '${elementId}' not found on page.`, suggestion);
+}
+/**
+ * Render after an interaction action and attach a delta diff.
+ * Captures the pre-action snapshot (latest in store), renders post-action
+ * state, and computes a structural diff between them.
+ */
+export async function renderAfterAction(deps) {
+    const preActionSnapshot = deps.snapshotStore.getLatest();
+    const representation = await renderActivePage(deps, { source: "action" });
+    // Compute delta if we have a pre-action snapshot to compare against
+    if (preActionSnapshot) {
+        const postSnapshotId = representation.snapshot_id;
+        representation.delta = diffRepresentations(preActionSnapshot.representation, representation, preActionSnapshot.id, postSnapshotId);
+    }
+    return representation;
+}
+/**
+ * Format a PageRepresentation as an MCP tool response.
+ */
+export function formatPageResponse(representation) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(representation, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * Format an array of interactive elements as an MCP tool response.
+ */
+export function formatElementsResponse(elements) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(elements, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * Format a CharlotteError as an MCP tool error response.
+ */
+export function formatErrorResponse(error) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(error.toResponse()),
+            },
+        ],
+        isError: true,
+    };
+}
+/**
+ * Wrap a tool handler to catch CharlotteErrors and unexpected errors,
+ * returning consistent error responses.
+ */
+export function handleToolError(error) {
+    if (error instanceof CharlotteError) {
+        return formatErrorResponse(error);
+    }
+    const sessionError = new CharlotteError(CharlotteErrorCode.SESSION_ERROR, `Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
+    return formatErrorResponse(sessionError);
+}
+//# sourceMappingURL=tool-helpers.js.map

package/dist/tools/tool-helpers.js.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,7 @@
+export type AutoSnapshotMode = "every_action" | "observe_only" | "manual";
+export interface CharlotteConfig {
+    snapshotDepth: number;
+    autoSnapshot: AutoSnapshotMode;
+}
+export declare function createDefaultConfig(): CharlotteConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,cAAc,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAED,wBAAgB,mBAAmB,IAAI,eAAe,CAKrD"}

package/dist/types/config.js

@@ -0,0 +1,7 @@
+export function createDefaultConfig() {
+    return {
+        snapshotDepth: 50,
+        autoSnapshot: "every_action",
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,aAAa,EAAE,EAAE;QACjB,YAAY,EAAE,cAAc;KAC7B,CAAC;AACJ,CAAC"}

package/dist/types/element-id.d.ts

@@ -0,0 +1,8 @@
+export declare const TYPE_PREFIX_MAP: Record<string, string>;
+export interface DOMPathSignature {
+    nearestLandmarkRole: string | null;
+    nearestLandmarkLabel: string | null;
+    nearestLabelledContainer: string | null;
+    siblingIndex: number;
+}
+//# sourceMappingURL=element-id.d.ts.map

package/dist/types/element-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-id.d.ts","sourceRoot":"","sources":["../../src/types/element-id.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiBlD,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;CACtB"}