@ticktockbent/charlotte 0.1.0

package/dist/dev/file-watcher.js

@@ -0,0 +1,78 @@
+import { watch } from "chokidar";
+import * as path from "node:path";
+import { logger } from "../utils/logger.js";
+const DEFAULT_DEBOUNCE_MS = 300;
+export class FileWatcher {
+    watcher = null;
+    pendingChanges = new Set();
+    debounceTimer = null;
+    directoryPath = null;
+    onFilesChanged = null;
+    debounceMs = DEFAULT_DEBOUNCE_MS;
+    async start(options) {
+        // Stop any existing watcher first
+        if (this.watcher) {
+            await this.stop();
+        }
+        this.directoryPath = path.resolve(options.directoryPath);
+        this.onFilesChanged = options.onFilesChanged;
+        this.debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+        this.watcher = watch(this.directoryPath, {
+            ignoreInitial: true,
+            ignored: ["**/node_modules/**", "**/.git/**"],
+            usePolling: options.usePolling ?? false,
+            interval: options.usePolling ? 100 : undefined,
+        });
+        const handleFileEvent = (filePath) => {
+            const relativePath = path.relative(this.directoryPath, filePath);
+            this.pendingChanges.add(relativePath);
+            // Clear existing debounce timer and set a new one
+            if (this.debounceTimer) {
+                clearTimeout(this.debounceTimer);
+            }
+            this.debounceTimer = setTimeout(() => {
+                this.flushPendingChanges();
+            }, this.debounceMs);
+        };
+        this.watcher.on("change", handleFileEvent);
+        this.watcher.on("add", handleFileEvent);
+        this.watcher.on("unlink", handleFileEvent);
+        // Wait for the watcher to be ready before resolving
+        await new Promise((resolve, reject) => {
+            this.watcher.on("ready", resolve);
+            this.watcher.on("error", reject);
+        });
+        logger.info("File watcher started", {
+            directory: this.directoryPath,
+            debounceMs: this.debounceMs,
+        });
+    }
+    async stop() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+        }
+        this.pendingChanges.clear();
+        this.directoryPath = null;
+        this.onFilesChanged = null;
+        logger.info("File watcher stopped");
+    }
+    isWatching() {
+        return this.watcher !== null;
+    }
+    flushPendingChanges() {
+        if (this.pendingChanges.size === 0 || !this.onFilesChanged) {
+            return;
+        }
+        const changedFiles = [...this.pendingChanges];
+        this.pendingChanges.clear();
+        this.debounceTimer = null;
+        logger.debug("File changes detected", { files: changedFiles });
+        this.onFilesChanged(changedFiles);
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/dev/file-watcher.js.map

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

package/dist/dev/static-server.d.ts

@@ -0,0 +1,18 @@
+export interface StaticServerOptions {
+    directoryPath: string;
+    port?: number;
+}
+export interface StaticServerInfo {
+    url: string;
+    port: number;
+    directoryPath: string;
+}
+export declare class StaticServer {
+    private httpServer;
+    private serverInfo;
+    start(options: StaticServerOptions): Promise<StaticServerInfo>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+    getInfo(): StaticServerInfo | null;
+}
+//# sourceMappingURL=static-server.d.ts.map

package/dist/dev/static-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-server.d.ts","sourceRoot":"","sources":["../../src/dev/static-server.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,UAAU,CAAiC;IAE7C,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+C9D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,SAAS,IAAI,OAAO;IAIpB,OAAO,IAAI,gBAAgB,GAAG,IAAI;CAGnC"}

package/dist/dev/static-server.js

@@ -0,0 +1,73 @@
+import express from "express";
+import * as path from "node:path";
+import { logger } from "../utils/logger.js";
+export class StaticServer {
+    httpServer = null;
+    serverInfo = null;
+    async start(options) {
+        // Stop any existing server first
+        if (this.httpServer) {
+            await this.stop();
+        }
+        const absoluteDirectoryPath = path.resolve(options.directoryPath);
+        const app = express();
+        app.use(express.static(absoluteDirectoryPath));
+        const listenPort = options.port ?? 0;
+        return new Promise((resolve, reject) => {
+            const server = app.listen(listenPort, () => {
+                const address = server.address();
+                if (!address || typeof address === "string") {
+                    reject(new Error("Failed to get server address"));
+                    return;
+                }
+                const assignedPort = address.port;
+                const info = {
+                    url: `http://localhost:${assignedPort}`,
+                    port: assignedPort,
+                    directoryPath: absoluteDirectoryPath,
+                };
+                this.httpServer = server;
+                this.serverInfo = info;
+                logger.info("Static server started", {
+                    url: info.url,
+                    directory: info.directoryPath,
+                });
+                resolve(info);
+            });
+            server.on("error", (error) => {
+                if (error.code === "EADDRINUSE") {
+                    reject(new Error(`Port ${listenPort} is already in use`));
+                }
+                else {
+                    reject(error);
+                }
+            });
+        });
+    }
+    async stop() {
+        if (!this.httpServer) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            this.httpServer.close((error) => {
+                if (error) {
+                    logger.warn("Error closing static server", error);
+                    reject(error);
+                }
+                else {
+                    logger.info("Static server stopped");
+                    resolve();
+                }
+                this.httpServer = null;
+                this.serverInfo = null;
+            });
+        });
+    }
+    isRunning() {
+        return this.httpServer !== null;
+    }
+    getInfo() {
+        return this.serverInfo;
+    }
+}
+//# sourceMappingURL=static-server.js.map

package/dist/dev/static-server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { BrowserManager } from "./browser/browser-manager.js";
+import { PageManager } from "./browser/page-manager.js";
+import { CDPSessionManager } from "./browser/cdp-session.js";
+import { RendererPipeline } from "./renderer/renderer-pipeline.js";
+import { ElementIdGenerator } from "./renderer/element-id-generator.js";
+import { SnapshotStore } from "./state/snapshot-store.js";
+import { createDefaultConfig } from "./types/config.js";
+import { createServer } from "./server.js";
+import { DevModeState } from "./dev/dev-mode-state.js";
+import { logger } from "./utils/logger.js";
+async function main() {
+    logger.info("Charlotte starting");
+    // Initialize browser
+    const browserManager = new BrowserManager();
+    await browserManager.launch();
+    // Initialize page management
+    const pageManager = new PageManager();
+    // Open a default tab
+    await pageManager.openTab(browserManager);
+    // Initialize renderer pipeline
+    const cdpSessionManager = new CDPSessionManager();
+    const elementIdGenerator = new ElementIdGenerator();
+    const rendererPipeline = new RendererPipeline(cdpSessionManager, elementIdGenerator);
+    // Initialize state management
+    const config = createDefaultConfig();
+    const snapshotStore = new SnapshotStore(config.snapshotDepth);
+    // Initialize dev mode state
+    const devModeState = new DevModeState();
+    // Create and configure MCP server
+    const mcpServer = createServer({
+        browserManager,
+        pageManager,
+        rendererPipeline,
+        elementIdGenerator,
+        snapshotStore,
+        config,
+        devModeState,
+    });
+    // Connect stdio transport
+    const transport = new StdioServerTransport();
+    await mcpServer.connect(transport);
+    logger.info("Charlotte MCP server running on stdio");
+    // Graceful shutdown
+    const shutdown = async () => {
+        logger.info("Shutting down");
+        await devModeState.stopAll();
+        await mcpServer.close();
+        await browserManager.close();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+main().catch((error) => {
+    logger.error("Fatal error", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAElC,qBAAqB;IACrB,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;IAC5C,MAAM,cAAc,CAAC,MAAM,EAAE,CAAC;IAE9B,6BAA6B;IAC7B,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IAEtC,qBAAqB;IACrB,MAAM,WAAW,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAE1C,+BAA+B;IAC/B,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAClD,MAAM,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACpD,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAC3C,iBAAiB,EACjB,kBAAkB,CACnB,CAAC;IAEF,8BAA8B;IAC9B,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAC;IACrC,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAE9D,4BAA4B;IAC5B,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IAExC,kCAAkC;IAClC,MAAM,SAAS,GAAG,YAAY,CAAC;QAC7B,cAAc;QACd,WAAW;QACX,gBAAgB;QAChB,kBAAkB;QAClB,aAAa;QACb,MAAM;QACN,YAAY;KACb,CAAC,CAAC;IAEH,0BAA0B;IAC1B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEnC,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAErD,oBAAoB;IACpB,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7B,MAAM,YAAY,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/renderer/accessibility-extractor.d.ts

@@ -0,0 +1,19 @@
+import type { CDPSession } from "puppeteer";
+export interface ParsedAXNode {
+    nodeId: string;
+    role: string;
+    name: string;
+    description: string;
+    value: string | null;
+    properties: Record<string, unknown>;
+    backendDOMNodeId: number | null;
+    children: ParsedAXNode[];
+    parent: ParsedAXNode | null;
+}
+export declare function isLandmarkRole(role: string): boolean;
+export declare function isHeadingRole(role: string): boolean;
+export declare function isInteractiveRole(role: string): boolean;
+export declare class AccessibilityExtractor {
+    extract(session: CDPSession): Promise<ParsedAXNode[]>;
+}
+//# sourceMappingURL=accessibility-extractor.d.ts.map

package/dist/renderer/accessibility-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility-extractor.d.ts","sourceRoot":"","sources":["../../src/renderer/accessibility-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7B;AAkCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AA2BD,qBAAa,sBAAsB;IAC3B,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAkG5D"}

package/dist/renderer/accessibility-extractor.js

@@ -0,0 +1,138 @@
+import { logger } from "../utils/logger.js";
+const LANDMARK_ROLES = new Set([
+    "banner",
+    "navigation",
+    "main",
+    "complementary",
+    "contentinfo",
+    "form",
+    "region",
+    "search",
+]);
+const HEADING_ROLE = "heading";
+const INTERACTIVE_ROLES = new Set([
+    "button",
+    "link",
+    "textbox",
+    "combobox",
+    "listbox",
+    "checkbox",
+    "radio",
+    "switch",
+    "slider",
+    "spinbutton",
+    "searchbox",
+    "menuitem",
+    "menuitemcheckbox",
+    "menuitemradio",
+    "tab",
+    "treeitem",
+]);
+export function isLandmarkRole(role) {
+    return LANDMARK_ROLES.has(role);
+}
+export function isHeadingRole(role) {
+    return role === HEADING_ROLE;
+}
+export function isInteractiveRole(role) {
+    return INTERACTIVE_ROLES.has(role);
+}
+function extractProperties(rawProperties) {
+    const properties = {};
+    if (!rawProperties)
+        return properties;
+    for (const prop of rawProperties) {
+        properties[prop.name] = prop.value.value;
+    }
+    return properties;
+}
+export class AccessibilityExtractor {
+    async extract(session) {
+        logger.debug("Extracting accessibility tree");
+        const result = await session.send("Accessibility.getFullAXTree");
+        const rawNodes = result.nodes;
+        if (!rawNodes || rawNodes.length === 0) {
+            logger.warn("Empty accessibility tree returned");
+            return [];
+        }
+        logger.debug(`Got ${rawNodes.length} AX nodes`);
+        // Build lookup map
+        const nodeMap = new Map();
+        const childToParent = new Map();
+        // Track which raw nodes are ignored, so we can reparent their children
+        const rawNodeMap = new Map();
+        for (const raw of rawNodes) {
+            rawNodeMap.set(raw.nodeId, raw);
+        }
+        // For ignored nodes, find the nearest non-ignored ancestor
+        function findNonIgnoredParent(nodeId) {
+            let currentId = nodeId;
+            while (true) {
+                const rawNode = rawNodeMap.get(currentId);
+                if (!rawNode?.parentId)
+                    return undefined;
+                const parentRaw = rawNodeMap.get(rawNode.parentId);
+                if (!parentRaw)
+                    return undefined;
+                if (!parentRaw.ignored)
+                    return parentRaw.nodeId;
+                currentId = rawNode.parentId;
+            }
+        }
+        // First pass: create ParsedAXNode for each non-ignored node
+        for (const raw of rawNodes) {
+            if (raw.ignored) {
+                // Reparent children of ignored nodes to the nearest non-ignored ancestor
+                if (raw.childIds) {
+                    const nonIgnoredParentId = findNonIgnoredParent(raw.nodeId);
+                    for (const childId of raw.childIds) {
+                        if (nonIgnoredParentId) {
+                            childToParent.set(childId, nonIgnoredParentId);
+                        }
+                    }
+                }
+                continue;
+            }
+            const role = raw.role?.value ?? "none";
+            const name = raw.name?.value ?? "";
+            const description = raw.description?.value ?? "";
+            const rawValue = raw.value?.value;
+            const value = rawValue !== undefined && rawValue !== null
+                ? String(rawValue)
+                : null;
+            const parsed = {
+                nodeId: raw.nodeId,
+                role,
+                name,
+                description,
+                value,
+                properties: extractProperties(raw.properties),
+                backendDOMNodeId: raw.backendDOMNodeId ?? null,
+                children: [],
+                parent: null,
+            };
+            nodeMap.set(raw.nodeId, parsed);
+            if (raw.childIds) {
+                for (const childId of raw.childIds) {
+                    childToParent.set(childId, raw.nodeId);
+                }
+            }
+        }
+        // Second pass: link parent-child relationships
+        const rootNodes = [];
+        for (const [nodeId, node] of nodeMap) {
+            const parentId = childToParent.get(nodeId);
+            if (parentId && nodeMap.has(parentId)) {
+                const parentNode = nodeMap.get(parentId);
+                node.parent = parentNode;
+                parentNode.children.push(node);
+            }
+            else {
+                rootNodes.push(node);
+            }
+        }
+        logger.debug(`Reconstructed tree with ${rootNodes.length} root node(s)`);
+        return rootNodes;
+    }
+}
+//# sourceMappingURL=accessibility-extractor.js.map

package/dist/renderer/accessibility-extractor.js.map

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

package/dist/renderer/content-extractor.d.ts

@@ -0,0 +1,6 @@
+import type { ParsedAXNode } from "./accessibility-extractor.js";
+export declare class ContentExtractor {
+    extractSummary(rootNodes: ParsedAXNode[]): string;
+    extractFullContent(rootNodes: ParsedAXNode[]): string;
+}
+//# sourceMappingURL=content-extractor.d.ts.map

package/dist/renderer/content-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-extractor.d.ts","sourceRoot":"","sources":["../../src/renderer/content-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAmGjE,qBAAa,gBAAgB;IAC3B,cAAc,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM;IAqCjD,kBAAkB,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM;CAsBtD"}

package/dist/renderer/content-extractor.js

@@ -0,0 +1,150 @@
+import { isLandmarkRole } from "./accessibility-extractor.js";
+function createEmptyCounts(role, label) {
+    return {
+        role,
+        label,
+        headings: 0,
+        links: 0,
+        buttons: 0,
+        inputs: 0,
+        images: 0,
+        lists: 0,
+        tables: 0,
+        forms: 0,
+        paragraphs: 0,
+    };
+}
+function countElements(node, counts) {
+    switch (node.role) {
+        case "heading":
+            counts.headings++;
+            break;
+        case "link":
+            counts.links++;
+            break;
+        case "button":
+            counts.buttons++;
+            break;
+        case "textbox":
+        case "searchbox":
+        case "combobox":
+        case "listbox":
+        case "checkbox":
+        case "radio":
+        case "slider":
+        case "spinbutton":
+        case "switch":
+            counts.inputs++;
+            break;
+        case "img":
+        case "image":
+            counts.images++;
+            break;
+        case "list":
+            counts.lists++;
+            break;
+        case "table":
+            counts.tables++;
+            break;
+        case "form":
+            counts.forms++;
+            break;
+        case "paragraph":
+            counts.paragraphs++;
+            break;
+    }
+    for (const child of node.children) {
+        // Don't recurse into nested landmarks — they get their own counts
+        if (!isLandmarkRole(child.role)) {
+            countElements(child, counts);
+        }
+    }
+}
+function formatCounts(counts) {
+    const parts = [];
+    if (counts.headings > 0)
+        parts.push(`${counts.headings} headings`);
+    if (counts.paragraphs > 0)
+        parts.push(`${counts.paragraphs} paragraphs`);
+    if (counts.links > 0)
+        parts.push(`${counts.links} links`);
+    if (counts.buttons > 0)
+        parts.push(`${counts.buttons} buttons`);
+    if (counts.inputs > 0)
+        parts.push(`${counts.inputs} inputs`);
+    if (counts.forms > 0)
+        parts.push(`${counts.forms} forms`);
+    if (counts.images > 0)
+        parts.push(`${counts.images} images`);
+    if (counts.lists > 0)
+        parts.push(`${counts.lists} lists`);
+    if (counts.tables > 0)
+        parts.push(`${counts.tables} tables`);
+    const label = counts.label || counts.role;
+    if (parts.length === 0)
+        return `${label}: empty`;
+    return `${label}: ${parts.join(", ")}`;
+}
+export class ContentExtractor {
+    extractSummary(rootNodes) {
+        const landmarkSummaries = [];
+        const topLevelCounts = createEmptyCounts("page", "page");
+        const findLandmarks = (node) => {
+            if (isLandmarkRole(node.role)) {
+                const counts = createEmptyCounts(node.role, node.name || node.role);
+                countElements(node, counts);
+                landmarkSummaries.push(formatCounts(counts));
+                // Don't recurse into landmark children here — countElements
+                // already skips nested landmarks, which get found by continued traversal
+            }
+            // Always recurse into children to find landmarks at any depth
+            for (const child of node.children) {
+                findLandmarks(child);
+            }
+        };
+        for (const root of rootNodes) {
+            findLandmarks(root);
+            // Count non-landmark content at root level (for fallback summary)
+            if (!isLandmarkRole(root.role)) {
+                countElements(root, topLevelCounts);
+            }
+        }
+        // If we have landmark summaries, use those
+        if (landmarkSummaries.length > 0) {
+            return landmarkSummaries.join("; ");
+        }
+        // Fallback: summarize the whole page
+        return formatCounts(topLevelCounts);
+    }
+    extractFullContent(rootNodes) {
+        const textParts = [];
+        const traverse = (node) => {
+            // Include text from nodes that represent content
+            if (node.role === "StaticText" || node.role === "text") {
+                if (node.name)
+                    textParts.push(node.name);
+            }
+            else if (node.name && isContentRole(node.role)) {
+                textParts.push(node.name);
+            }
+            for (const child of node.children) {
+                traverse(child);
+            }
+        };
+        for (const root of rootNodes) {
+            traverse(root);
+        }
+        return textParts.join("\n");
+    }
+}
+function isContentRole(role) {
+    return (role === "heading" ||
+        role === "paragraph" ||
+        role === "listitem" ||
+        role === "cell" ||
+        role === "label" ||
+        role === "legend" ||
+        role === "caption" ||
+        role === "blockquote");
+}
+//# sourceMappingURL=content-extractor.js.map

package/dist/renderer/content-extractor.js.map

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

package/dist/renderer/dom-path.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedAXNode } from "./accessibility-extractor.js";
+import type { DOMPathSignature } from "../types/element-id.js";
+export declare function computeDOMPathSignature(node: ParsedAXNode): DOMPathSignature;
+//# sourceMappingURL=dom-path.d.ts.map

package/dist/renderer/dom-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-path.d.ts","sourceRoot":"","sources":["../../src/renderer/dom-path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,gBAAgB,CAqC5E"}

package/dist/renderer/dom-path.js

@@ -0,0 +1,34 @@
+import { isLandmarkRole } from "./accessibility-extractor.js";
+export function computeDOMPathSignature(node) {
+    let nearestLandmarkRole = null;
+    let nearestLandmarkLabel = null;
+    let nearestLabelledContainer = null;
+    // Walk ancestors to find nearest landmark and nearest labelled container
+    let ancestor = node.parent;
+    while (ancestor) {
+        if (!nearestLabelledContainer && ancestor.name) {
+            nearestLabelledContainer = ancestor.name;
+        }
+        if (!nearestLandmarkRole && isLandmarkRole(ancestor.role)) {
+            nearestLandmarkRole = ancestor.role;
+            nearestLandmarkLabel = ancestor.name || null;
+            break; // Landmark is more specific, stop here
+        }
+        ancestor = ancestor.parent;
+    }
+    // Compute sibling index: position among siblings with the same role
+    let siblingIndex = 0;
+    if (node.parent) {
+        const sameRoleSiblings = node.parent.children.filter((child) => child.role === node.role);
+        siblingIndex = sameRoleSiblings.indexOf(node);
+        if (siblingIndex === -1)
+            siblingIndex = 0;
+    }
+    return {
+        nearestLandmarkRole,
+        nearestLandmarkLabel,
+        nearestLabelledContainer,
+        siblingIndex,
+    };
+}
+//# sourceMappingURL=dom-path.js.map

package/dist/renderer/dom-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-path.js","sourceRoot":"","sources":["../../src/renderer/dom-path.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,MAAM,UAAU,uBAAuB,CAAC,IAAkB;IACxD,IAAI,mBAAmB,GAAkB,IAAI,CAAC;IAC9C,IAAI,oBAAoB,GAAkB,IAAI,CAAC;IAC/C,IAAI,wBAAwB,GAAkB,IAAI,CAAC;IAEnD,yEAAyE;IACzE,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,OAAO,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,wBAAwB,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC/C,wBAAwB,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,mBAAmB,IAAI,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC;YACpC,oBAAoB,GAAG,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC;YAC7C,MAAM,CAAC,uCAAuC;QAChD,CAAC;QAED,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,oEAAoE;IACpE,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAClD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CACpC,CAAC;QACF,YAAY,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,YAAY,KAAK,CAAC,CAAC;YAAE,YAAY,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO;QACL,mBAAmB;QACnB,oBAAoB;QACpB,wBAAwB;QACxB,YAAY;KACb,CAAC;AACJ,CAAC"}