zan-browser 2.0.8 → 3.0.0

package/dist/session.js

@@ -1,69 +1,77 @@
 "use strict";
+// ─── Session — simplified ────────────────────────────────────────────────────
+// Creates the tool registry, wires up context, and delegates work to the Agent.
+// No longer contains interaction logic — that lives in individual tools.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Session = void 0;
 const interceptor_1 = require("./interceptor");
 const observer_1 = require("./observer");
+const registry_1 = require("./registry");
+const agent_1 = require("./agent/agent");
+// ─── Browser tools ───────────────────────────────────────────────────────────
+const click_1 = require("./tools/browser/click");
+const fill_1 = require("./tools/browser/fill");
+const scroll_1 = require("./tools/browser/scroll");
+const navigate_1 = require("./tools/browser/navigate");
+const wait_1 = require("./tools/browser/wait");
+const eval_js_1 = require("./tools/browser/eval_js");
+const screenshot_1 = require("./tools/browser/screenshot");
+// ─── Page tools ──────────────────────────────────────────────────────────────
+const observe_1 = require("./tools/page/observe");
+const scrape_1 = require("./tools/page/scrape");
+const extract_dom_1 = require("./tools/page/extract_dom");
+// ─── Network tools ──────────────────────────────────────────────────────────
+const web_search_1 = require("./tools/network/web_search");
+const fetch_url_1 = require("./tools/network/fetch_url");
+const download_file_1 = require("./tools/network/download_file");
+const read_network_logs_1 = require("./tools/network/read_network_logs");
 class Session {
     page;
     browserHandle;
     interceptor;
     observer;
-    ai;
+    registry;
+    ctx;
     defaultTimeout;
+    aiModel;
     viewerUrl;
-    constructor(page, browserHandle, ai, timeout = 30_000, viewerUrl) {
+    constructor(page, browserHandle, anthropicApiKey, timeout = 30_000, viewerUrl, aiModel) {
         this.page = page;
         this.browserHandle = browserHandle;
-        this.ai = ai;
         this.defaultTimeout = timeout;
         this.viewerUrl = viewerUrl;
+        this.aiModel = aiModel;
         this.interceptor = new interceptor_1.Interceptor(page);
         this.observer = new observer_1.Observer(page);
         // Start capturing traffic immediately — t=0
         this.interceptor.start();
+        // Build tool context
+        this.ctx = {
+            page,
+            observer: this.observer,
+            interceptor: this.interceptor,
+            anthropicApiKey,
+            aiModel,
+        };
+        // Register all tools
+        this.registry = new registry_1.ToolRegistry();
+        this.registerDefaultTools();
     }
-    // ─── Accessors for SmartNavigator ───────────────────────────────────────────
-    getPage() { return this.page; }
-    getInterceptor() { return this.interceptor; }
-    getObserver() { return this.observer; }
-    getAI() { return this.ai; }
     // ─── Navigation ───────────────────────────────────────────────────────────────
     async goto(url, options) {
         const timeout = options?.timeout ?? this.defaultTimeout;
-        await this.page.goto(url, {
-            waitUntil: "domcontentloaded",
-            timeout,
-        });
-        // Wait for network to go idle — catches XHR that SPAs fire after DOM is parsed.
+        await this.page.goto(url, { waitUntil: "domcontentloaded", timeout });
         try {
             await this.page.waitForNetworkIdle({ timeout: 8_000 });
         }
         catch {
-            // networkidle timed out — page likely has background polling, continue anyway
+            // networkidle timed out — page likely has background polling
         }
-        // Minimum 800ms after networkidle (or timeout) — some SPAs fire XHR slightly after idle
         await this.page.waitForTimeout(800);
     }
-    async wait(ms) {
-        await this.page.waitForTimeout(ms);
-    }
     get url() {
         return this.page.url();
     }
-    // ─── Observe — always first, before any action ────────────────────────────────
-    async observe() {
-        return this.observer.observe();
-    }
-    // ─── Form and autocomplete detection ────────────────────────────────────────
-    async detectForms() {
-        return this.observer.detectForms();
-    }
-    async detectAutocomplete() {
-        return this.observer.detectAutocomplete();
-    }
-    async detectErrors() {
-        return this.observer.detectErrors();
-    }
     // ─── Screenshot ────────────────────────────────────────────────────────────────
     async screenshot() {
         const result = await this.page.screenshot({ type: "jpeg", quality: 80, encoding: "base64" });
@@ -73,69 +81,6 @@ class Session {
             timestamp: Date.now(),
         };
     }
-    // ─── DOM text extraction — fallback when no useful XHR is captured ────────────
-    async extractPageContent() {
-        return await this.page.evaluate(() => {
-            const clone = document.body.cloneNode(true);
-            clone.querySelectorAll("script,style,nav,footer,header")
-                .forEach((el) => el.remove());
-            return clone.innerText
-                .split("\n")
-                .map((l) => l.trim())
-                .filter((l) => l.length > 0)
-                .join("\n")
-                .slice(0, 15000);
-        });
-    }
-    // ─── Interaction ──────────────────────────────────────────────────────────────
-    async clickById(elementId) {
-        // First try cached CSS selector (reliable)
-        const selector = this.observer.getSelector(elementId);
-        if (selector) {
-            try {
-                await this.page.click(selector);
-                return;
-            }
-            catch {
-                // Fall through to coordinate-based click
-            }
-        }
-        const coords = await this.observer.resolveElementId(elementId);
-        if (!coords)
-            throw new Error(`Element ${elementId} not found in DOM`);
-        await this.page.mouse.click(coords.x, coords.y);
-    }
-    async fillById(elementId, value) {
-        // First try cached CSS selector (reliable)
-        const selector = this.observer.getSelector(elementId);
-        if (selector) {
-            try {
-                await this.page.click(selector, { clickCount: 3 }); // select all
-                await this.page.keyboard.press("Backspace");
-                await this.page.type(selector, value, { delay: 80 });
-                return;
-            }
-            catch {
-                // Fall through to coordinate-based fill
-            }
-        }
-        const coords = await this.observer.resolveElementId(elementId);
-        if (!coords)
-            throw new Error(`Element ${elementId} not found in DOM`);
-        await this.page.mouse.click(coords.x, coords.y);
-        await this.page.keyboard.press("Control+a");
-        await this.page.keyboard.type(value, { delay: 80 });
-    }
-    // ─── Direct selector interaction (for autocomplete clicks) ──────────────────
-    async clickSelector(selector) {
-        const el = await this.page.waitForSelector(selector, { timeout: 3_000, visible: true });
-        if (el) {
-            await el.click();
-        }
-        else {
-            throw new Error(`Selector ${selector} not found`);
-        }
-    }
     // ─── Captured requests ────────────────────────────────────────────────────────
     getCapturedRequests() {
         return this.interceptor.getAll();
@@ -143,60 +88,23 @@ class Session {
     getUsefulRequests(minScore = 1) {
         return this.interceptor.getUseful(minScore);
     }
-    getActionTriggeredRequests() {
-        return this.interceptor.getActionTriggered();
-    }
-    onRequest(handler) {
-        this.interceptor.on("request", handler);
+    // ─── Agent — the main entry point ─────────────────────────────────────────────
+    async act(goal, config) {
+        const agent = new agent_1.AgentLoop(this.registry, this.ctx, this.aiModel);
+        return agent.run({
+            goal,
+            maxSteps: config?.maxSteps ?? 15,
+            seedValues: config?.seedValues,
+            onProgress: config?.onProgress,
+            ...config,
+        });
     }
-    hasSeedValueInResponses(seedValues) {
-        return this.interceptor.hasSeedValueInResponses(seedValues);
+    // ─── Registry access (for custom tools) ────────────────────────────────────────
+    getRegistry() {
+        return this.registry;
     }
-    markActionTimestamp() {
-        this.interceptor.markActionTimestamp();
-    }
-    // ─── act() — achieve a goal through multi-step navigation ────────────────────
-    async act(goal, maxSteps = 10, seedValues) {
-        const steps = [];
-        const history = [];
-        for (let i = 0; i < maxSteps; i++) {
-            const observation = await this.observe();
-            let action;
-            let usedScreenshot = false;
-            if (observation.elements.filter((e) => e.visible).length > 0) {
-                action = await this.ai.decideFromObservation(goal, observation, history, seedValues);
-            }
-            else {
-                const shot = await this.screenshot();
-                action = await this.ai.decideFromScreenshot(goal, shot.base64, history, seedValues);
-                usedScreenshot = true;
-            }
-            steps.push({ action, observeBefore: observation, usedScreenshot });
-            history.push(`Step ${i + 1}: ${action.type} — ${action.reason}`);
-            if (action.type === "done") {
-                return { success: true, steps, finalUrl: this.url, reason: action.reason };
-            }
-            if (action.type === "impossible") {
-                return { success: false, steps, finalUrl: this.url, reason: action.reason };
-            }
-            await this.executeAction(action);
-            await this.page.waitForTimeout(500);
-        }
-        return {
-            success: false,
-            steps,
-            finalUrl: this.url,
-            reason: `Reached max steps (${maxSteps}) without completing goal`,
-        };
-    }
-    // ─── findData() — navigate + capture requests until goal achieved ─────────────
-    async findData(goal, maxSteps = 15, seedValues) {
-        const actResult = await this.act(goal, maxSteps, seedValues);
-        const capturedRequests = this.interceptor.getUseful();
-        return {
-            ...actResult,
-            capturedRequests,
-        };
+    getToolContext() {
+        return this.ctx;
     }
     // ─── Cleanup ──────────────────────────────────────────────────────────────────
     async close() {
@@ -209,65 +117,25 @@ class Session {
         this.interceptor.stop();
         await this.browserHandle.close();
     }
-    // ─── Execute action ───────────────────────────────────────────────────────────
-    async executeAction(action) {
-        switch (action.type) {
-            case "click":
-                this.interceptor.markActionTimestamp();
-                await this.clickById(action.elementId).catch(() => {
-                    // If all resolution fails, log and continue
-                    console.warn(`[Session] Click failed for ${action.elementId}`);
-                });
-                break;
-            case "fill":
-                this.interceptor.markActionTimestamp();
-                await this.fillById(action.elementId, action.value).catch(() => {
-                    console.warn(`[Session] Fill failed for ${action.elementId}`);
-                });
-                break;
-            case "scroll":
-                this.interceptor.markActionTimestamp();
-                await this.page.evaluate(({ direction, amount }) => {
-                    window.scrollBy(0, direction === "down" ? amount : -amount);
-                }, { direction: action.direction, amount: action.amount ?? 300 }).catch(() => {
-                    // Execution context destroyed = page navigated mid-scroll
-                });
-                break;
-            case "navigate":
-                this.interceptor.markActionTimestamp();
-                try {
-                    await this.page.goto(action.url, { waitUntil: "domcontentloaded", timeout: this.defaultTimeout });
-                    // Wait for network idle like Session.goto() does
-                    try {
-                        await this.page.waitForNetworkIdle({ timeout: 8_000 });
-                    }
-                    catch { /* background polling — continue */ }
-                    await this.page.waitForTimeout(800);
-                }
-                catch (err) {
-                    console.warn(`[Session] Navigate failed for ${action.url}:`, err.message);
-                }
-                break;
-            case "wait":
-                await this.page.waitForTimeout(action.ms);
-                break;
-            case "eval_js":
-                try {
-                    await this.page.evaluate((jsCode) => {
-                        // eslint-disable-next-line no-new-func
-                        const fn = new Function(`return (${jsCode})`);
-                        return fn();
-                    }, action.code);
-                }
-                catch {
-                    // result not captured in the legacy act() path
-                }
-                break;
-            case "screenshot":
-                break;
-            default:
-                break;
-        }
+    // ─── Private ──────────────────────────────────────────────────────────────────
+    registerDefaultTools() {
+        // Browser
+        this.registry.register(new click_1.ClickTool());
+        this.registry.register(new fill_1.FillTool());
+        this.registry.register(new scroll_1.ScrollTool());
+        this.registry.register(new navigate_1.NavigateTool());
+        this.registry.register(new wait_1.WaitTool());
+        this.registry.register(new eval_js_1.EvalJsTool());
+        this.registry.register(new screenshot_1.ScreenshotTool());
+        // Page
+        this.registry.register(new observe_1.ObserveTool());
+        this.registry.register(new scrape_1.ScrapeTool());
+        this.registry.register(new extract_dom_1.ExtractDomTool());
+        // Network
+        this.registry.register(new web_search_1.WebSearchTool());
+        this.registry.register(new fetch_url_1.FetchUrlTool());
+        this.registry.register(new download_file_1.DownloadFileTool());
+        this.registry.register(new read_network_logs_1.ReadNetworkLogsTool());
     }
 }
 exports.Session = Session;

package/dist/session.js.map

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

package/dist/tools/base.d.ts

@@ -0,0 +1,37 @@
+import type { PageHandle } from "../browser-provider";
+import type { Observer } from "../observer";
+import type { Interceptor } from "../interceptor";
+export interface JSONSchema {
+    type: "object";
+    properties: Record<string, {
+        type: string;
+        description: string;
+        enum?: string[];
+        default?: unknown;
+    }>;
+    required: string[];
+}
+export interface ToolContext {
+    page?: PageHandle;
+    observer?: Observer;
+    interceptor?: Interceptor;
+    anthropicApiKey: string;
+    aiModel?: string;
+}
+export interface ToolResult {
+    success: boolean;
+    summary: string;
+    data?: unknown;
+    error?: string;
+}
+export interface Tool {
+    /** Unique name the LLM uses to invoke this tool (e.g. "click", "fetch_url") */
+    name: string;
+    /** One-line description shown in the system prompt */
+    description: string;
+    /** JSON Schema describing the parameters object */
+    inputSchema: JSONSchema;
+    /** Execute the tool. Params match inputSchema. */
+    execute(params: Record<string, unknown>, ctx: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/tools/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/tools/base.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIlD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAOD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,IAAI;IACnB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IAEpB,mDAAmD;IACnD,WAAW,EAAE,UAAU,CAAC;IAExB,kDAAkD;IAClD,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACjF"}

package/dist/tools/base.js

@@ -0,0 +1,6 @@
+"use strict";
+// ─── Tool abstraction ────────────────────────────────────────────────────────
+// Every capability the agent can invoke implements this interface.
+// Adding a new tool = one file + registry.register(). Zero changes elsewhere.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base.js.map

package/dist/tools/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/tools/base.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,mEAAmE;AACnE,8EAA8E"}

package/dist/tools/browser/click.d.ts

@@ -0,0 +1,8 @@
+import type { Tool, ToolContext, ToolResult, JSONSchema } from "../base";
+export declare class ClickTool implements Tool {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    execute(params: Record<string, unknown>, ctx: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=click.d.ts.map

package/dist/tools/browser/click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEzE,qBAAa,SAAU,YAAW,IAAI;IACpC,IAAI,SAAW;IACf,WAAW,SAA0E;IAErF,WAAW,EAAE,UAAU,CAMrB;IAEI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA6BtF"}

package/dist/tools/browser/click.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClickTool = void 0;
+class ClickTool {
+    name = "click";
+    description = "Click an interactive element by its ActionSpace ID (e.g. B1, L3, I2)";
+    inputSchema = {
+        type: "object",
+        properties: {
+            elementId: { type: "string", description: "Element ID from the current ActionSpace (e.g. B1, L3)" },
+        },
+        required: ["elementId"],
+    };
+    async execute(params, ctx) {
+        const { page, observer, interceptor } = ctx;
+        if (!page || !observer) {
+            return { success: false, summary: "click failed: no browser context", error: "missing page/observer" };
+        }
+        const elementId = String(params.elementId);
+        interceptor?.markActionTimestamp();
+        // Try cached CSS selector first (reliable)
+        const selector = observer.getSelector(elementId);
+        if (selector) {
+            try {
+                await page.click(selector);
+                return { success: true, summary: `Clicked ${elementId}` };
+            }
+            catch {
+                // Fall through to coordinate-based click
+            }
+        }
+        // Fallback: resolve to coordinates
+        const coords = await observer.resolveElementId(elementId);
+        if (!coords) {
+            return { success: false, summary: `click failed: element ${elementId} not found`, error: `Element ${elementId} not found in DOM` };
+        }
+        await page.mouse.click(coords.x, coords.y);
+        return { success: true, summary: `Clicked ${elementId} at (${coords.x}, ${coords.y})` };
+    }
+}
+exports.ClickTool = ClickTool;
+//# sourceMappingURL=click.js.map

package/dist/tools/browser/click.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.js","sourceRoot":"","sources":["../../../src/tools/browser/click.ts"],"names":[],"mappings":";;;AAEA,MAAa,SAAS;IACpB,IAAI,GAAG,OAAO,CAAC;IACf,WAAW,GAAG,sEAAsE,CAAC;IAErF,WAAW,GAAe;QACxB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;SACpG;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAA+B,EAAE,GAAgB;QAC7D,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;QAC5C,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,kCAAkC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QACzG,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3C,WAAW,EAAE,mBAAmB,EAAE,CAAC;QAEnC,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,SAAS,EAAE,EAAE,CAAC;YAC5D,CAAC;YAAC,MAAM,CAAC;gBACP,yCAAyC;YAC3C,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,yBAAyB,SAAS,YAAY,EAAE,KAAK,EAAE,WAAW,SAAS,mBAAmB,EAAE,CAAC;QACrI,CAAC;QAED,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,SAAS,QAAQ,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;IAC1F,CAAC;CACF;AAzCD,8BAyCC"}

package/dist/tools/browser/eval_js.d.ts

@@ -0,0 +1,8 @@
+import type { Tool, ToolContext, ToolResult, JSONSchema } from "../base";
+export declare class EvalJsTool implements Tool {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    execute(params: Record<string, unknown>, ctx: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=eval_js.d.ts.map

package/dist/tools/browser/eval_js.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval_js.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/eval_js.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKzE,qBAAa,UAAW,YAAW,IAAI;IACrC,IAAI,SAAa;IACjB,WAAW,SAAuJ;IAElK,WAAW,EAAE,UAAU,CAMrB;IAEI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAkCtF"}

package/dist/tools/browser/eval_js.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvalJsTool = void 0;
+const MAX_RESULT_LENGTH = 4000;
+const EVAL_TIMEOUT_MS = 5_000;
+class EvalJsTool {
+    name = "eval_js";
+    description = "Evaluate a JavaScript expression in the page context and return the result. Useful for extracting SSR data (window.__NEXT_DATA__, __NUXT__, etc.)";
+    inputSchema = {
+        type: "object",
+        properties: {
+            code: { type: "string", description: "JavaScript expression to evaluate (must return a value)" },
+        },
+        required: ["code"],
+    };
+    async execute(params, ctx) {
+        const { page } = ctx;
+        if (!page) {
+            return { success: false, summary: "eval_js failed: no browser context", error: "missing page" };
+        }
+        const code = String(params.code);
+        try {
+            const result = await Promise.race([
+                page.evaluate((jsCode) => {
+                    // eslint-disable-next-line no-new-func
+                    const fn = new Function(`return (${jsCode})`);
+                    return fn();
+                }, code),
+                new Promise((_, reject) => setTimeout(() => reject(new Error("eval_js timeout after 5s")), EVAL_TIMEOUT_MS)),
+            ]);
+            if (result === null || result === undefined) {
+                return { success: true, summary: "eval_js returned null/undefined", data: null };
+            }
+            const text = typeof result === "string"
+                ? result.slice(0, MAX_RESULT_LENGTH)
+                : JSON.stringify(result, null, 2).slice(0, MAX_RESULT_LENGTH);
+            return { success: true, summary: `eval_js result (${text.length} chars):\n${text}`, data: result };
+        }
+        catch (err) {
+            const msg = err.message;
+            return { success: false, summary: `eval_js error: ${msg}`, error: msg };
+        }
+    }
+}
+exports.EvalJsTool = EvalJsTool;
+//# sourceMappingURL=eval_js.js.map

package/dist/tools/browser/eval_js.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval_js.js","sourceRoot":"","sources":["../../../src/tools/browser/eval_js.ts"],"names":[],"mappings":";;;AAEA,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B,MAAa,UAAU;IACrB,IAAI,GAAG,SAAS,CAAC;IACjB,WAAW,GAAG,mJAAmJ,CAAC;IAElK,WAAW,GAAe;QACxB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yDAAyD,EAAE;SACjG;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAA+B,EAAE,GAAgB;QAC7D,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC;QACrB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,oCAAoC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QAClG,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAChC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAc,EAAE,EAAE;oBAC/B,uCAAuC;oBACvC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,WAAW,MAAM,GAAG,CAAC,CAAC;oBAC9C,OAAO,EAAE,EAAa,CAAC;gBACzB,CAAC,EAAE,IAAI,CAAC;gBACR,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC/B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,eAAe,CAAC,CACjF;aACF,CAAC,CAAC;YAEH,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,iCAAiC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACnF,CAAC;YAED,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ;gBACrC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC;gBACpC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;YAEhE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,IAAI,CAAC,MAAM,aAAa,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACrG,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAI,GAAa,CAAC,OAAO,CAAC;YACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;CACF;AA9CD,gCA8CC"}

package/dist/tools/browser/fill.d.ts

@@ -0,0 +1,8 @@
+import type { Tool, ToolContext, ToolResult, JSONSchema } from "../base";
+export declare class FillTool implements Tool {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    execute(params: Record<string, unknown>, ctx: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=fill.d.ts.map

package/dist/tools/browser/fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/fill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEzE,qBAAa,QAAS,YAAW,IAAI;IACnC,IAAI,SAAU;IACd,WAAW,SAAyE;IAEpF,WAAW,EAAE,UAAU,CAOrB;IAEI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAkCtF"}

package/dist/tools/browser/fill.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FillTool = void 0;
+class FillTool {
+    name = "fill";
+    description = "Clear and type text into an input or textarea by its ActionSpace ID";
+    inputSchema = {
+        type: "object",
+        properties: {
+            elementId: { type: "string", description: "Input element ID from the current ActionSpace (e.g. I1, T1)" },
+            value: { type: "string", description: "Text to type into the field" },
+        },
+        required: ["elementId", "value"],
+    };
+    async execute(params, ctx) {
+        const { page, observer, interceptor } = ctx;
+        if (!page || !observer) {
+            return { success: false, summary: "fill failed: no browser context", error: "missing page/observer" };
+        }
+        const elementId = String(params.elementId);
+        const value = String(params.value);
+        interceptor?.markActionTimestamp();
+        // Try cached CSS selector first
+        const selector = observer.getSelector(elementId);
+        if (selector) {
+            try {
+                await page.click(selector, { clickCount: 3 }); // select all
+                await page.keyboard.press("Backspace");
+                await page.type(selector, value, { delay: 80 });
+                return { success: true, summary: `Filled ${elementId} with "${value}"` };
+            }
+            catch {
+                // Fall through to coordinate-based fill
+            }
+        }
+        // Fallback: resolve to coordinates
+        const coords = await observer.resolveElementId(elementId);
+        if (!coords) {
+            return { success: false, summary: `fill failed: element ${elementId} not found`, error: `Element ${elementId} not found in DOM` };
+        }
+        await page.mouse.click(coords.x, coords.y);
+        await page.keyboard.press("Control+a");
+        await page.keyboard.type(value, { delay: 80 });
+        return { success: true, summary: `Filled ${elementId} with "${value}" at (${coords.x}, ${coords.y})` };
+    }
+}
+exports.FillTool = FillTool;
+//# sourceMappingURL=fill.js.map

package/dist/tools/browser/fill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.js","sourceRoot":"","sources":["../../../src/tools/browser/fill.ts"],"names":[],"mappings":";;;AAEA,MAAa,QAAQ;IACnB,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GAAG,qEAAqE,CAAC;IAEpF,WAAW,GAAe;QACxB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;YACzG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;SACtE;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;KACjC,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAA+B,EAAE,GAAgB;QAC7D,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;QAC5C,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,iCAAiC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QACxG,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,WAAW,EAAE,mBAAmB,EAAE,CAAC;QAEnC,gCAAgC;QAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa;gBAC5D,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBACvC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;gBAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,SAAS,UAAU,KAAK,GAAG,EAAE,CAAC;YAC3E,CAAC;YAAC,MAAM,CAAC;gBACP,wCAAwC;YAC1C,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,wBAAwB,SAAS,YAAY,EAAE,KAAK,EAAE,WAAW,SAAS,mBAAmB,EAAE,CAAC;QACpI,CAAC;QAED,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,SAAS,UAAU,KAAK,SAAS,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;IACzG,CAAC;CACF;AA/CD,4BA+CC"}

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

@@ -0,0 +1,8 @@
+import type { Tool, ToolContext, ToolResult, JSONSchema } from "../base";
+export declare class NavigateTool implements Tool {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    execute(params: Record<string, unknown>, ctx: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=navigate.d.ts.map