@bini-bar-labs/atomic-web-agent-core 1.0.0

package/dist/tools/get-page-screenshot.tool.js

@@ -0,0 +1,13 @@
+import { tool } from "langchain";
+import {} from "playwright";
+export function getPageScreenShotTool(page) {
+    return tool(async () => {
+        console.log("Taking screenshot...");
+        const screenshot = await page.screenshot({ type: "jpeg" });
+        return screenshot;
+    }, {
+        name: "GetPageScreenShot",
+        description: "Take a screenshot of the current page and return it as a JPEG image.",
+    });
+}
+//# sourceMappingURL=get-page-screenshot.tool.js.map

package/dist/tools/get-page-screenshot.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-page-screenshot.tool.js","sourceRoot":"","sources":["../../src/tools/get-page-screenshot.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAa,MAAM,YAAY,CAAC;AAEvC,MAAM,UAAU,qBAAqB,CAAC,IAAU;IAC9C,OAAO,IAAI,CACT,KAAK,IAAI,EAAE;QACT,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3D,OAAO,UAAU,CAAC;IACpB,CAAC,EACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,sEAAsE;KACzE,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/input-by-element-id.tool.d.ts

@@ -0,0 +1,18 @@
+import { type Page } from "playwright";
+import z from "zod";
+import { type ElementLocatorRegistry } from "./utils/element-registry.util.js";
+export declare const InputByElementIdToolSchema: z.ZodObject<{
+    elementId: z.ZodString;
+    text: z.ZodString;
+}, z.z.core.$strip>;
+export declare function inputByElementIdTool(_page: Page, elementRegistry: ElementLocatorRegistry): import("langchain").DynamicStructuredTool<z.ZodObject<{
+    elementId: z.ZodString;
+    text: z.ZodString;
+}, z.z.core.$strip>, {
+    elementId: string;
+    text: string;
+}, {
+    elementId: string;
+    text: string;
+}, string>;
+//# sourceMappingURL=input-by-element-id.tool.d.ts.map

package/dist/tools/input-by-element-id.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-by-element-id.tool.d.ts","sourceRoot":"","sources":["../../src/tools/input-by-element-id.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE/E,eAAO,MAAM,0BAA0B;;;mBAKrC,CAAC;AAEH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,EACX,eAAe,EAAE,sBAAsB;;;;;;;;;WAqCxC"}

package/dist/tools/input-by-element-id.tool.js

@@ -0,0 +1,39 @@
+import { tool } from "langchain";
+import {} from "playwright";
+import z from "zod";
+import {} from "./utils/element-registry.util.js";
+export const InputByElementIdToolSchema = z.object({
+    elementId: z
+        .string()
+        .describe("The element ID from the accessibility snapshot to input text into"),
+    text: z.string().describe("The text to input into the element"),
+});
+export function inputByElementIdTool(_page, elementRegistry) {
+    return tool(async ({ elementId, text }) => {
+        console.log(`Inputting text into element: ${elementId}`);
+        const locator = elementRegistry.get(elementId);
+        if (!locator) {
+            throw new Error(`Element ID "${elementId}" not found in registry. Please take a fresh DOM snapshot first using GetDOMSnapshot tool.`);
+        }
+        try {
+            // Check if element is editable
+            const isEditable = await locator.isEditable().catch(() => false);
+            if (!isEditable) {
+                throw new Error(`Element ${elementId} is not editable`);
+            }
+            await locator.fill(text, { timeout: 5000 });
+            return `Successfully filled element ${elementId} with text: "${text}"`;
+        }
+        catch (error) {
+            throw new Error(`Failed to input text into element ${elementId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }, {
+        name: "InputByElementId",
+        description: `Input text into an element using its ID from the accessibility snapshot.
+The element ID should come from the most recent GetDOMSnapshot result.
+This is the recommended way to fill form fields instead of using CSS selectors.
+Only works with editable elements like textboxes and search boxes.`,
+        schema: InputByElementIdToolSchema,
+    });
+}
+//# sourceMappingURL=input-by-element-id.tool.js.map

package/dist/tools/input-by-element-id.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-by-element-id.tool.js","sourceRoot":"","sources":["../../src/tools/input-by-element-id.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAa,MAAM,YAAY,CAAC;AACvC,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,EAA+B,MAAM,kCAAkC,CAAC;AAE/E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,mEAAmE,CAAC;IAChF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAChE,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAClC,KAAW,EACX,eAAuC;IAEvC,OAAO,IAAI,CACT,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE;QAC5B,OAAO,CAAC,GAAG,CAAC,gCAAgC,SAAS,EAAE,CAAC,CAAC;QAEzD,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,eAAe,SAAS,4FAA4F,CACrH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,+BAA+B;YAC/B,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;YACjE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,kBAAkB,CAAC,CAAC;YAC1D,CAAC;YAED,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,OAAO,+BAA+B,SAAS,gBAAgB,IAAI,GAAG,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,qCAAqC,SAAS,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5G,CAAC;QACJ,CAAC;IACH,CAAC,EACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE;;;mEAGgD;QAC7D,MAAM,EAAE,0BAA0B;KACnC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/input.tool.d.ts

@@ -0,0 +1,17 @@
+import { type Page } from "playwright";
+import z from "zod";
+export declare const InputBySelectorToolSchema: z.ZodObject<{
+    selector: z.ZodString;
+    text: z.ZodString;
+}, z.z.core.$strip>;
+export declare function inputTool(page: Page): import("langchain").DynamicStructuredTool<z.ZodObject<{
+    selector: z.ZodString;
+    text: z.ZodString;
+}, z.z.core.$strip>, {
+    selector: string;
+    text: string;
+}, {
+    selector: string;
+    text: string;
+}, void>;
+//# sourceMappingURL=input.tool.d.ts.map

package/dist/tools/input.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.tool.d.ts","sourceRoot":"","sources":["../../src/tools/input.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,eAAO,MAAM,yBAAyB;;;mBAGpC,CAAC;AAEH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI;;;;;;;;;SAmBnC"}

package/dist/tools/input.tool.js

@@ -0,0 +1,21 @@
+import { tool } from "langchain";
+import {} from "playwright";
+import { expect } from "playwright/test";
+import z from "zod";
+export const InputBySelectorToolSchema = z.object({
+    selector: z.string().describe("The CSS selector of the element to input"),
+    text: z.string().describe("The text to input into the element"),
+});
+export function inputTool(page) {
+    return tool(async ({ selector, text }) => {
+        console.log(`Inputting text into selector: ${selector} with text: ${text}`);
+        const element = page.locator(selector);
+        await expect(element, `Expected to find 1 element with selector ${selector}, got: ${await element.count()}`).toHaveCount(1);
+        return await element.fill(text, { timeout: 1000 });
+    }, {
+        name: "InputBySelector",
+        description: "Input text into an element with the given CSS selector",
+        schema: InputBySelectorToolSchema,
+    });
+}
+//# sourceMappingURL=input.tool.js.map

package/dist/tools/input.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.tool.js","sourceRoot":"","sources":["../../src/tools/input.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAa,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACzE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAChE,CAAC,CAAC;AAEH,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,OAAO,IAAI,CACT,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;QAC3B,OAAO,CAAC,GAAG,CACT,iCAAiC,QAAQ,eAAe,IAAI,EAAE,CAC/D,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,MAAM,CACV,OAAO,EACP,4CAA4C,QAAQ,UAAU,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,CACtF,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC,EACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,wDAAwD;QACrE,MAAM,EAAE,yBAAyB;KAClC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/navigate.tool.d.ts

@@ -0,0 +1,10 @@
+import { type Page } from "playwright";
+import z from "zod";
+export declare function navigateTool(page: Page): import("langchain").DynamicStructuredTool<z.ZodObject<{
+    url: z.ZodString;
+}, z.z.core.$strip>, {
+    url: string;
+}, {
+    url: string;
+}, import("playwright").Response | null>;
+//# sourceMappingURL=navigate.tool.d.ts.map

package/dist/tools/navigate.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.tool.d.ts","sourceRoot":"","sources":["../../src/tools/navigate.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI;;;;;;yCActC"}

package/dist/tools/navigate.tool.js

@@ -0,0 +1,16 @@
+import { tool } from "langchain";
+import {} from "playwright";
+import z from "zod";
+export function navigateTool(page) {
+    return tool(async ({ url }) => {
+        console.log(`Navigating to URL: ${url}`);
+        return await page.goto(url);
+    }, {
+        name: "NavigateToURL",
+        description: "Navigate to a specified URL",
+        schema: z.object({
+            url: z.string().url().describe("The URL to navigate to"),
+        }),
+    });
+}
+//# sourceMappingURL=navigate.tool.js.map

package/dist/tools/navigate.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.tool.js","sourceRoot":"","sources":["../../src/tools/navigate.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAa,MAAM,YAAY,CAAC;AACvC,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,OAAO,IAAI,CACT,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAChB,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;QACzC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC,EACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,6BAA6B;QAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SACzD,CAAC;KACH,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/print-to-console.tool.d.ts

@@ -0,0 +1,12 @@
+import z from "zod";
+export declare const PrintToConsoleToolSchema: z.ZodObject<{
+    message: z.ZodString;
+}, z.z.core.$strip>;
+export declare function printToConsoleTool(): import("langchain").DynamicStructuredTool<z.ZodObject<{
+    message: z.ZodString;
+}, z.z.core.$strip>, {
+    message: string;
+}, {
+    message: string;
+}, boolean>;
+//# sourceMappingURL=print-to-console.tool.d.ts.map

package/dist/tools/print-to-console.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-to-console.tool.d.ts","sourceRoot":"","sources":["../../src/tools/print-to-console.tool.ts"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,eAAO,MAAM,wBAAwB;;mBAEnC,CAAC;AAEH,wBAAgB,kBAAkB;;;;;;YAYjC"}

package/dist/tools/print-to-console.tool.js

@@ -0,0 +1,16 @@
+import { tool } from "langchain";
+import z from "zod";
+export const PrintToConsoleToolSchema = z.object({
+    message: z.string().describe("The message to print to the console"),
+});
+export function printToConsoleTool() {
+    return tool(({ message }) => {
+        console.log(`[AI]: ${message}`);
+        return true;
+    }, {
+        name: "PrintToConsole",
+        description: "Print a message to the console.",
+        schema: PrintToConsoleToolSchema,
+    });
+}
+//# sourceMappingURL=print-to-console.tool.js.map

package/dist/tools/print-to-console.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-to-console.tool.js","sourceRoot":"","sources":["../../src/tools/print-to-console.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CACpE,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CACT,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;QACd,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC,EACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,iCAAiC;QAC9C,MAAM,EAAE,wBAAwB;KACjC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/utils/accessibility-snapshot.util.d.ts

@@ -0,0 +1,34 @@
+import { type Page, type Locator } from "playwright";
+export interface ElementSnapshot {
+    id: string;
+    role: string;
+    name: string | undefined;
+    value: string | undefined;
+    visible: boolean;
+    inViewport: boolean;
+    editable: boolean;
+    disabled: boolean | undefined;
+    checked: boolean | undefined;
+    required: boolean | undefined;
+    masked: boolean | undefined;
+    bbox: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | undefined;
+    children: ElementSnapshot[] | undefined;
+}
+export interface PageSnapshot {
+    url: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    elements: ElementSnapshot[];
+}
+/**
+ * Generates an accessibility-based snapshot of the page with visual metadata
+ */
+export declare function generateAccessibilitySnapshot(page: Page, locatorMap: Map<string, Locator>): Promise<PageSnapshot>;
+//# sourceMappingURL=accessibility-snapshot.util.d.ts.map

package/dist/tools/utils/accessibility-snapshot.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility-snapshot.util.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/accessibility-snapshot.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,IAAI,EACA;QACE,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,GACD,SAAS,CAAC;IACd,QAAQ,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAsGD;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,YAAY,CAAC,CAsMvB"}

package/dist/tools/utils/accessibility-snapshot.util.js

@@ -0,0 +1,244 @@
+import {} from "playwright";
+let elementIdCounter = 0;
+/**
+ * Generates a stable synthetic ID for an element
+ */
+function generateElementId(role) {
+    return `${role}_${elementIdCounter++}`;
+}
+/**
+ * Enriches element data with visual and interaction metadata using XPath locator
+ */
+async function enrichElement(page, elementData, locatorMap) {
+    const id = generateElementId(elementData.role);
+    try {
+        // Locate element using XPath
+        const locator = page.locator(`xpath=${elementData.xpath}`);
+        // Check if element exists
+        const count = await locator.count();
+        if (count === 0) {
+            return null;
+        }
+        // Use first matching element
+        const element = locator.first();
+        // Store locator for later use
+        locatorMap.set(id, element);
+        // Get visibility state
+        const isVisible = await element.isVisible().catch(() => false);
+        if (!isVisible) {
+            return null; // Filter out hidden elements
+        }
+        // Get bounding box
+        const boundingBox = await element.boundingBox().catch(() => null);
+        // Check if in viewport (approximation based on bounding box)
+        const viewport = page.viewportSize() || { width: 1280, height: 800 };
+        const isInViewport = boundingBox
+            ? boundingBox.x >= 0 &&
+                boundingBox.y >= 0 &&
+                boundingBox.x + boundingBox.width <= viewport.width &&
+                boundingBox.y + boundingBox.height <= viewport.height
+            : false;
+        // Get editability state
+        const isEditable = await element.isEditable().catch(() => false);
+        // Build element snapshot
+        const snapshot = {
+            id,
+            role: elementData.role,
+            name: elementData.name || undefined,
+            value: elementData.value || undefined,
+            visible: isVisible,
+            inViewport: isInViewport,
+            editable: isEditable,
+            disabled: elementData.disabled ? true : undefined,
+            checked: elementData.checked ? true : undefined,
+            required: elementData.required ? true : undefined,
+            masked: elementData.type === "password" ? true : undefined,
+            bbox: boundingBox
+                ? {
+                    x: Math.round(boundingBox.x),
+                    y: Math.round(boundingBox.y),
+                    w: Math.round(boundingBox.width),
+                    h: Math.round(boundingBox.height),
+                }
+                : undefined,
+            children: undefined,
+        };
+        return snapshot;
+    }
+    catch (error) {
+        // If we can't enrich this element, skip it
+        console.warn(`Failed to enrich element ${elementData.role}:`, error);
+        return null;
+    }
+}
+/**
+ * Generates an accessibility-based snapshot of the page with visual metadata
+ */
+export async function generateAccessibilitySnapshot(page, locatorMap) {
+    // Reset counter for consistent IDs
+    elementIdCounter = 0;
+    // Clear previous locator map
+    locatorMap.clear();
+    // Extract all interactive elements with XPath locators
+    const elementsData = await page.evaluate(() => {
+        const results = [];
+        function getXPath(element) {
+            if (element.id) {
+                return `//*[@id="${element.id}"]`;
+            }
+            const parts = [];
+            let current = element;
+            while (current && current.nodeType === Node.ELEMENT_NODE) {
+                let index = 0;
+                let sibling = current.previousSibling;
+                while (sibling) {
+                    if (sibling.nodeType === Node.ELEMENT_NODE &&
+                        sibling.nodeName === current.nodeName) {
+                        index++;
+                    }
+                    sibling = sibling.previousSibling;
+                }
+                const tagName = current.nodeName.toLowerCase();
+                const position = index > 0 ? `[${index + 1}]` : "";
+                parts.unshift(`${tagName}${position}`);
+                current = current.parentElement;
+            }
+            return `/${parts.join("/")}`;
+        }
+        function inferRole(element) {
+            const tagName = element.tagName.toLowerCase();
+            const explicitRole = element.getAttribute("role");
+            if (explicitRole)
+                return explicitRole;
+            if (tagName === "button")
+                return "button";
+            if (tagName === "a")
+                return "link";
+            if (tagName === "input") {
+                const type = element.type;
+                if (type === "text" || type === "email" || type === "password")
+                    return "textbox";
+                if (type === "checkbox")
+                    return "checkbox";
+                if (type === "radio")
+                    return "radio";
+                if (type === "search")
+                    return "searchbox";
+                if (type === "submit")
+                    return "button";
+            }
+            if (tagName === "textarea")
+                return "textbox";
+            if (tagName === "select")
+                return "combobox";
+            if (tagName === "form")
+                return "form";
+            if (tagName === "nav")
+                return "navigation";
+            if (tagName === "main")
+                return "main";
+            if (tagName === "dialog")
+                return "dialog";
+            return "generic";
+        }
+        function getName(element) {
+            // Priority: aria-label > text content > placeholder > name attr
+            const ariaLabel = element.getAttribute("aria-label");
+            if (ariaLabel)
+                return ariaLabel.trim();
+            const placeholder = element.getAttribute("placeholder");
+            if (placeholder)
+                return placeholder.trim();
+            const nameAttr = element.getAttribute("name");
+            if (nameAttr)
+                return nameAttr.trim();
+            // For links and buttons, get text content
+            if (element instanceof HTMLButtonElement ||
+                element instanceof HTMLAnchorElement) {
+                return (element.textContent || "").trim().substring(0, 100);
+            }
+            // For inputs, use the value or label
+            if (element instanceof HTMLInputElement) {
+                const labels = document.querySelectorAll(`label[for="${element.id}"]`);
+                if (labels.length > 0) {
+                    return (labels[0].textContent || "").trim();
+                }
+            }
+            return "";
+        }
+        // Find all interactive elements
+        const selectors = [
+            "button",
+            "a[href]",
+            "input",
+            "textarea",
+            "select",
+            "[role='button']",
+            "[role='link']",
+            "[role='textbox']",
+            "[role='checkbox']",
+            "[role='radio']",
+            "[role='combobox']",
+            "[onclick]",
+        ];
+        const elements = document.querySelectorAll(selectors.join(", "));
+        elements.forEach((element) => {
+            const role = inferRole(element);
+            const name = getName(element);
+            const xpath = getXPath(element);
+            let value = "";
+            let checked = false;
+            let type = "";
+            if (element instanceof HTMLInputElement ||
+                element instanceof HTMLTextAreaElement) {
+                value = element.value;
+                type = element instanceof HTMLInputElement ? element.type : "textarea";
+            }
+            if (element instanceof HTMLInputElement && element.type === "checkbox") {
+                checked = element.checked;
+            }
+            const disabled = element instanceof HTMLButtonElement ||
+                element instanceof HTMLInputElement ||
+                element instanceof HTMLSelectElement ||
+                element instanceof HTMLTextAreaElement
+                ? element.disabled
+                : false;
+            const required = element instanceof HTMLInputElement ||
+                element instanceof HTMLSelectElement ||
+                element instanceof HTMLTextAreaElement
+                ? element.required
+                : false;
+            results.push({
+                xpath,
+                role,
+                name,
+                value,
+                disabled,
+                checked,
+                required,
+                tagName: element.tagName.toLowerCase(),
+                type,
+            });
+        });
+        return results;
+    });
+    // Get viewport size
+    const viewportSize = page.viewportSize() || { width: 1280, height: 800 };
+    // Enrich each element with visual metadata
+    const elements = [];
+    for (const elementData of elementsData) {
+        const enrichedElement = await enrichElement(page, elementData, locatorMap);
+        if (enrichedElement) {
+            elements.push(enrichedElement);
+        }
+    }
+    return {
+        url: page.url(),
+        viewport: {
+            width: viewportSize.width,
+            height: viewportSize.height,
+        },
+        elements,
+    };
+}
+//# sourceMappingURL=accessibility-snapshot.util.js.map

package/dist/tools/utils/accessibility-snapshot.util.js.map

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

package/dist/tools/utils/element-registry.util.d.ts

@@ -0,0 +1,39 @@
+import { type Locator } from "playwright";
+/**
+ * Registry for managing element ID to Playwright Locator mappings
+ * This is used to translate synthetic element IDs from the accessibility snapshot
+ * into actual Playwright locators for performing actions
+ */
+export declare class ElementLocatorRegistry {
+    private locatorMap;
+    constructor();
+    /**
+     * Gets the internal locator map (used by snapshot generation)
+     */
+    getMap(): Map<string, Locator>;
+    /**
+     * Gets a locator by its element ID
+     */
+    get(elementId: string): Locator | undefined;
+    /**
+     * Sets a locator for an element ID
+     */
+    set(elementId: string, locator: Locator): void;
+    /**
+     * Clears all element mappings
+     */
+    clear(): void;
+    /**
+     * Gets all element IDs
+     */
+    getAllIds(): string[];
+    /**
+     * Gets the number of registered elements
+     */
+    size(): number;
+    /**
+     * Checks if an element ID exists in the registry
+     */
+    has(elementId: string): boolean;
+}
+//# sourceMappingURL=element-registry.util.d.ts.map

package/dist/tools/utils/element-registry.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-registry.util.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/element-registry.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,UAAU,CAAuB;;IAMzC;;OAEG;IACH,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAI9B;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAI9C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAGhC"}

package/dist/tools/utils/element-registry.util.js

@@ -0,0 +1,55 @@
+import {} from "playwright";
+/**
+ * Registry for managing element ID to Playwright Locator mappings
+ * This is used to translate synthetic element IDs from the accessibility snapshot
+ * into actual Playwright locators for performing actions
+ */
+export class ElementLocatorRegistry {
+    locatorMap;
+    constructor() {
+        this.locatorMap = new Map();
+    }
+    /**
+     * Gets the internal locator map (used by snapshot generation)
+     */
+    getMap() {
+        return this.locatorMap;
+    }
+    /**
+     * Gets a locator by its element ID
+     */
+    get(elementId) {
+        return this.locatorMap.get(elementId);
+    }
+    /**
+     * Sets a locator for an element ID
+     */
+    set(elementId, locator) {
+        this.locatorMap.set(elementId, locator);
+    }
+    /**
+     * Clears all element mappings
+     */
+    clear() {
+        this.locatorMap.clear();
+    }
+    /**
+     * Gets all element IDs
+     */
+    getAllIds() {
+        return Array.from(this.locatorMap.keys());
+    }
+    /**
+     * Gets the number of registered elements
+     */
+    size() {
+        return this.locatorMap.size;
+    }
+    /**
+     * Checks if an element ID exists in the registry
+     */
+    has(elementId) {
+        return this.locatorMap.has(elementId);
+    }
+}
+//# sourceMappingURL=element-registry.util.js.map

package/dist/tools/utils/element-registry.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-registry.util.js","sourceRoot":"","sources":["../../../src/tools/utils/element-registry.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,YAAY,CAAC;AAE1C;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IACzB,UAAU,CAAuB;IAEzC;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB,EAAE,OAAgB;QACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/tools/utils/minimize-snapshot.util.d.ts

@@ -0,0 +1,2 @@
+export declare function minimizeSnapshot(htmlContent: string): string;
+//# sourceMappingURL=minimize-snapshot.util.d.ts.map

package/dist/tools/utils/minimize-snapshot.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimize-snapshot.util.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/minimize-snapshot.util.ts"],"names":[],"mappings":"AACA,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,UAoDnD"}