zan-browser 2.0.8 → 3.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/navigate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEzE,qBAAa,YAAa,YAAW,IAAI;IACvC,IAAI,SAAc;IAClB,WAAW,SAAiE;IAE5E,WAAW,EAAE,UAAU,CAMrB;IAEI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAwBtF"}

package/dist/tools/browser/navigate.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NavigateTool = void 0;
+class NavigateTool {
+    name = "navigate";
+    description = "Navigate the browser to a URL and wait for the page to load";
+    inputSchema = {
+        type: "object",
+        properties: {
+            url: { type: "string", description: "The URL to navigate to" },
+        },
+        required: ["url"],
+    };
+    async execute(params, ctx) {
+        const { page, interceptor } = ctx;
+        if (!page) {
+            return { success: false, summary: "navigate failed: no browser context", error: "missing page" };
+        }
+        const url = String(params.url);
+        interceptor?.markActionTimestamp();
+        try {
+            await page.goto(url, { waitUntil: "domcontentloaded", timeout: 15_000 });
+            // Wait for network to settle — catches XHR that SPAs fire after DOM is parsed
+            try {
+                await page.waitForNetworkIdle({ timeout: 8_000 });
+            }
+            catch {
+                // Background polling — continue
+            }
+            await page.waitForTimeout(800);
+            return { success: true, summary: `Navigated to ${url}` };
+        }
+        catch (err) {
+            const msg = err.message;
+            return { success: false, summary: `navigate failed: ${msg}`, error: msg };
+        }
+    }
+}
+exports.NavigateTool = NavigateTool;
+//# sourceMappingURL=navigate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.js","sourceRoot":"","sources":["../../../src/tools/browser/navigate.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IACvB,IAAI,GAAG,UAAU,CAAC;IAClB,WAAW,GAAG,6DAA6D,CAAC;IAE5E,WAAW,GAAe;QACxB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;SAC/D;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAA+B,EAAE,GAAgB;QAC7D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,qCAAqC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QACnG,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,WAAW,EAAE,mBAAmB,EAAE,CAAC;QAEnC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YACzE,8EAA8E;YAC9E,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;YACD,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAC/B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,GAAG,EAAE,EAAE,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAI,GAAa,CAAC,OAAO,CAAC;YACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC;CACF;AApCD,oCAoCC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEzE,qBAAa,cAAe,YAAW,IAAI;IACzC,IAAI,SAAgB;IACpB,WAAW,SAAwG;IAEnH,WAAW,EAAE,UAAU,CAIrB;IAEI,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAevF"}

package/dist/tools/browser/screenshot.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScreenshotTool = void 0;
+class ScreenshotTool {
+    name = "screenshot";
+    description = "Take a JPEG screenshot of the current page. Use only when ActionSpace observation is insufficient.";
+    inputSchema = {
+        type: "object",
+        properties: {},
+        required: [],
+    };
+    async execute(_params, ctx) {
+        const { page } = ctx;
+        if (!page) {
+            return { success: false, summary: "screenshot failed: no browser context", error: "missing page" };
+        }
+        const result = await page.screenshot({ type: "jpeg", quality: 80, encoding: "base64" });
+        const base64 = typeof result === "string" ? result : result.toString("base64");
+        return {
+            success: true,
+            summary: "Screenshot captured",
+            data: { base64, mimeType: "image/jpeg", timestamp: Date.now() },
+        };
+    }
+}
+exports.ScreenshotTool = ScreenshotTool;
+//# sourceMappingURL=screenshot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../../src/tools/browser/screenshot.ts"],"names":[],"mappings":";;;AAEA,MAAa,cAAc;IACzB,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,oGAAoG,CAAC;IAEnH,WAAW,GAAe;QACxB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,OAAgC,EAAE,GAAgB;QAC9D,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC;QACrB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,uCAAuC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QACrG,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxF,MAAM,MAAM,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE/E,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,qBAAqB;YAC9B,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE;SAChE,CAAC;IACJ,CAAC;CACF;AAzBD,wCAyBC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/scroll.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEzE,qBAAa,UAAW,YAAW,IAAI;IACrC,IAAI,SAAY;IAChB,WAAW,SAA4D;IAEvE,WAAW,EAAE,UAAU,CAOrB;IAEI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAuBtF"}

package/dist/tools/browser/scroll.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScrollTool = void 0;
+class ScrollTool {
+    name = "scroll";
+    description = "Scroll the page up or down by a given number of pixels";
+    inputSchema = {
+        type: "object",
+        properties: {
+            direction: { type: "string", description: "Scroll direction", enum: ["up", "down"] },
+            amount: { type: "number", description: "Pixels to scroll (default 300)", default: 300 },
+        },
+        required: ["direction"],
+    };
+    async execute(params, ctx) {
+        const { page, interceptor } = ctx;
+        if (!page) {
+            return { success: false, summary: "scroll failed: no browser context", error: "missing page" };
+        }
+        const direction = String(params.direction);
+        const amount = Number(params.amount) || 300;
+        interceptor?.markActionTimestamp();
+        try {
+            await page.evaluate(({ direction, amount }) => {
+                window.scrollBy(0, direction === "down" ? amount : -amount);
+            }, { direction, amount });
+            return { success: true, summary: `Scrolled ${direction} ${amount}px` };
+        }
+        catch {
+            // Execution context destroyed = page navigated mid-scroll
+            return { success: true, summary: `Scrolled ${direction} ${amount}px (page may have navigated)` };
+        }
+    }
+}
+exports.ScrollTool = ScrollTool;
+//# sourceMappingURL=scroll.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.js","sourceRoot":"","sources":["../../../src/tools/browser/scroll.ts"],"names":[],"mappings":";;;AAEA,MAAa,UAAU;IACrB,IAAI,GAAG,QAAQ,CAAC;IAChB,WAAW,GAAG,wDAAwD,CAAC;IAEvE,WAAW,GAAe;QACxB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;YACpF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE,OAAO,EAAE,GAAG,EAAE;SACxF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAA+B,EAAE,GAAgB;QAC7D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mCAAmC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QACjG,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAkB,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;QAC5C,WAAW,EAAE,mBAAmB,EAAE,CAAC;QAEnC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CACjB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAyC,EAAE,EAAE;gBAC/D,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC9D,CAAC,EACD,EAAE,SAAS,EAAE,MAAM,EAAE,CACtB,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,SAAS,IAAI,MAAM,IAAI,EAAE,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;YAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,SAAS,IAAI,MAAM,8BAA8B,EAAE,CAAC;QACnG,CAAC;IACH,CAAC;CACF;AApCD,gCAoCC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/wait.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,SAAmF;IAE9F,WAAW,EAAE,UAAU,CAMrB;IAEI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAYtF"}

package/dist/tools/browser/wait.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WaitTool = void 0;
+class WaitTool {
+    name = "wait";
+    description = "Wait for a specified number of milliseconds (useful when the page is loading)";
+    inputSchema = {
+        type: "object",
+        properties: {
+            ms: { type: "number", description: "Milliseconds to wait (default 1500)", default: 1500 },
+        },
+        required: [],
+    };
+    async execute(params, ctx) {
+        const { page } = ctx;
+        const ms = Math.min(Number(params.ms) || 1500, 10_000); // cap at 10s
+        if (page) {
+            await page.waitForTimeout(ms);
+        }
+        else {
+            await new Promise((r) => setTimeout(r, ms));
+        }
+        return { success: true, summary: `Waited ${ms}ms` };
+    }
+}
+exports.WaitTool = WaitTool;
+//# sourceMappingURL=wait.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../../src/tools/browser/wait.ts"],"names":[],"mappings":";;;AAEA,MAAa,QAAQ;IACnB,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GAAG,+EAA+E,CAAC;IAE9F,WAAW,GAAe;QACxB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE,OAAO,EAAE,IAAI,EAAE;SAC1F;QACD,QAAQ,EAAE,EAAE;KACb,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAA+B,EAAE,GAAgB;QAC7D,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC;QACrB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa;QAErE,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACtD,CAAC;CACF;AAxBD,4BAwBC"}

package/dist/tools/network/download_file.d.ts

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

package/dist/tools/network/download_file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download_file.d.ts","sourceRoot":"","sources":["../../../src/tools/network/download_file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKzE,qBAAa,gBAAiB,YAAW,IAAI;IAC3C,IAAI,SAAmB;IACvB,WAAW,SAA2G;IAEtH,WAAW,EAAE,UAAU,CAOrB;IAEI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAuDtF"}

package/dist/tools/network/download_file.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DownloadFileTool = void 0;
+const MAX_CONTENT_LENGTH = 10_000;
+const DOWNLOAD_TIMEOUT_MS = 30_000;
+class DownloadFileTool {
+    name = "download_file";
+    description = "Download an external file (CSV, JSON, XML) and return its parsed content. Does NOT require a browser.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            url: { type: "string", description: "URL of the file to download" },
+            format: { type: "string", description: "Expected file format", enum: ["json", "csv", "xml", "text"], default: "text" },
+        },
+        required: ["url"],
+    };
+    async execute(params, ctx) {
+        const url = String(params.url);
+        const format = String(params.format || "text");
+        try {
+            const response = await fetch(url, {
+                signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                return {
+                    success: false,
+                    summary: `download_file failed: HTTP ${response.status} ${response.statusText}`,
+                    error: `HTTP ${response.status}`,
+                };
+            }
+            const raw = await response.text();
+            let parsed = raw;
+            let summary;
+            switch (format) {
+                case "json":
+                    try {
+                        parsed = JSON.parse(raw);
+                        const jsonStr = JSON.stringify(parsed, null, 2).slice(0, MAX_CONTENT_LENGTH);
+                        summary = `Downloaded JSON (${raw.length} chars):\n${jsonStr}`;
+                    }
+                    catch {
+                        summary = `Downloaded file (not valid JSON, ${raw.length} chars):\n${raw.slice(0, MAX_CONTENT_LENGTH)}`;
+                    }
+                    break;
+                case "csv": {
+                    const lines = raw.split("\n").filter((l) => l.trim());
+                    const preview = lines.slice(0, 20).join("\n");
+                    summary = `Downloaded CSV (${lines.length} rows):\n${preview}`;
+                    parsed = { totalRows: lines.length, preview: lines.slice(0, 20) };
+                    break;
+                }
+                case "xml":
+                    summary = `Downloaded XML (${raw.length} chars):\n${raw.slice(0, MAX_CONTENT_LENGTH)}`;
+                    break;
+                default:
+                    summary = `Downloaded file (${raw.length} chars):\n${raw.slice(0, MAX_CONTENT_LENGTH)}`;
+                    break;
+            }
+            return { success: true, summary, data: parsed };
+        }
+        catch (err) {
+            const msg = err.message;
+            return { success: false, summary: `download_file failed: ${msg}`, error: msg };
+        }
+    }
+}
+exports.DownloadFileTool = DownloadFileTool;
+//# sourceMappingURL=download_file.js.map

package/dist/tools/network/download_file.js.map

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

package/dist/tools/network/fetch_url.d.ts

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

package/dist/tools/network/fetch_url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch_url.d.ts","sourceRoot":"","sources":["../../../src/tools/network/fetch_url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKzE,qBAAa,YAAa,YAAW,IAAI;IACvC,IAAI,SAAe;IACnB,WAAW,SAAyI;IAEpJ,WAAW,EAAE,UAAU,CASrB;IAEI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAkDtF"}

package/dist/tools/network/fetch_url.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FetchUrlTool = void 0;
+const MAX_BODY_LENGTH = 8_000;
+const FETCH_TIMEOUT_MS = 15_000;
+class FetchUrlTool {
+    name = "fetch_url";
+    description = "Make a direct HTTP request (GET/POST) with custom headers. Does NOT require a browser. Useful for calling discovered APIs directly.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            url: { type: "string", description: "URL to fetch" },
+            method: { type: "string", description: "HTTP method", enum: ["GET", "POST", "PUT", "PATCH", "DELETE"], default: "GET" },
+            headers: { type: "string", description: "JSON string of headers, e.g. '{\"Authorization\": \"Bearer token\"}'" },
+            body: { type: "string", description: "Request body (for POST/PUT/PATCH)" },
+        },
+        required: ["url"],
+    };
+    async execute(params, ctx) {
+        const url = String(params.url);
+        const method = String(params.method || "GET");
+        let headers = {};
+        if (params.headers) {
+            try {
+                headers = JSON.parse(String(params.headers));
+            }
+            catch {
+                return { success: false, summary: "fetch_url failed: invalid headers JSON", error: "invalid headers JSON" };
+            }
+        }
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: params.body ? String(params.body) : undefined,
+                signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            });
+            const contentType = response.headers.get("content-type") ?? "";
+            let body;
+            try {
+                body = await response.text();
+            }
+            catch {
+                body = "(could not read response body)";
+            }
+            const trimmed = body.slice(0, MAX_BODY_LENGTH);
+            const overflow = body.length > MAX_BODY_LENGTH ? `\n... truncated (${body.length} total chars)` : "";
+            return {
+                success: response.ok,
+                summary: `${method} ${url} → ${response.status} ${response.statusText} (${contentType})\n${trimmed}${overflow}`,
+                data: {
+                    status: response.status,
+                    statusText: response.statusText,
+                    contentType,
+                    body: trimmed,
+                    headers: Object.fromEntries(response.headers.entries()),
+                },
+                error: response.ok ? undefined : `HTTP ${response.status} ${response.statusText}`,
+            };
+        }
+        catch (err) {
+            const msg = err.message;
+            return { success: false, summary: `fetch_url failed: ${msg}`, error: msg };
+        }
+    }
+}
+exports.FetchUrlTool = FetchUrlTool;
+//# sourceMappingURL=fetch_url.js.map

package/dist/tools/network/fetch_url.js.map

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

package/dist/tools/network/read_network_logs.d.ts

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

package/dist/tools/network/read_network_logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read_network_logs.d.ts","sourceRoot":"","sources":["../../../src/tools/network/read_network_logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEzE,qBAAa,mBAAoB,YAAW,IAAI;IAC9C,IAAI,SAAuB;IAC3B,WAAW,SAAkH;IAE7H,WAAW,EAAE,UAAU,CAQrB;IAEI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAsDtF"}

package/dist/tools/network/read_network_logs.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadNetworkLogsTool = void 0;
+class ReadNetworkLogsTool {
+    name = "read_network_logs";
+    description = "Read captured XHR/fetch requests sorted by relevance score. Use to inspect what API calls the page has made.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            minScore: { type: "number", description: "Minimum relevance score filter (default 1)", default: 1 },
+            limit: { type: "number", description: "Max number of requests to return (default 15)", default: 15 },
+            showBodies: { type: "string", description: "Include response bodies in output", enum: ["true", "false"], default: "false" },
+        },
+        required: [],
+    };
+    async execute(params, ctx) {
+        const { interceptor } = ctx;
+        if (!interceptor) {
+            return { success: false, summary: "read_network_logs failed: no interceptor", error: "missing interceptor" };
+        }
+        const minScore = Number(params.minScore) || 1;
+        const limit = Math.min(Number(params.limit) || 15, 30);
+        const showBodies = String(params.showBodies) === "true";
+        const requests = interceptor.getUseful(minScore).slice(0, limit);
+        if (requests.length === 0) {
+            return {
+                success: true,
+                summary: `No XHR requests captured with score >= ${minScore}`,
+                data: [],
+            };
+        }
+        const lines = requests.map((r) => {
+            const marker = r.triggeredByAction ? " ↑" : "  ";
+            const kb = r.responseBody
+                ? ` ${(r.responseBody.length / 1024).toFixed(1)}KB`
+                : "";
+            const ct = r.contentType ? ` ${r.contentType.split(";")[0]}` : "";
+            let line = `[${r.score}]${marker} ${r.method} ${r.url}${ct}${kb}`;
+            if (showBodies && r.responseBody) {
+                const bodyPreview = r.responseBody.slice(0, 500);
+                line += `\n    Body: ${bodyPreview}${r.responseBody.length > 500 ? "..." : ""}`;
+            }
+            return line;
+        });
+        const total = interceptor.getAll().length;
+        const summary = `Captured XHR requests (${requests.length} shown, ${total} total):\n${lines.join("\n")}`;
+        return {
+            success: true,
+            summary,
+            data: requests.map((r) => ({
+                id: r.id,
+                method: r.method,
+                url: r.url,
+                status: r.status,
+                score: r.score,
+                contentType: r.contentType,
+                bodyLength: r.responseBody?.length ?? 0,
+                triggeredByAction: r.triggeredByAction,
+            })),
+        };
+    }
+}
+exports.ReadNetworkLogsTool = ReadNetworkLogsTool;
+//# sourceMappingURL=read_network_logs.js.map

package/dist/tools/network/read_network_logs.js.map

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

package/dist/tools/network/web_search.d.ts

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

package/dist/tools/network/web_search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web_search.d.ts","sourceRoot":"","sources":["../../../src/tools/network/web_search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKzE,qBAAa,aAAc,YAAW,IAAI;IACxC,IAAI,SAAgB;IACpB,WAAW,SAAoJ;IAE/J,WAAW,EAAE,UAAU,CAMrB;IAEI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA8CtF"}

package/dist/tools/network/web_search.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSearchTool = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const FALLBACK_MODEL = "claude-haiku-4-5-20251001";
+class WebSearchTool {
+    name = "web_search";
+    description = "Search the web for information before navigating. Useful when the goal is vague or the target site/URL is unknown. Does NOT require a browser.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Search query" },
+        },
+        required: ["query"],
+    };
+    async execute(params, ctx) {
+        const query = String(params.query);
+        try {
+            const client = new sdk_1.default({ apiKey: ctx.anthropicApiKey });
+            // The web_search tool type is supported by the API but may not be
+            // in older SDK type definitions — cast through unknown.
+            const response = await client.messages.create({
+                model: ctx.aiModel ?? FALLBACK_MODEL,
+                max_tokens: 1024,
+                tools: [{ type: "web_search_20250305" }],
+                messages: [
+                    { role: "user", content: `Search the web for: ${query}\n\nReturn the most relevant URLs and snippets.` },
+                ],
+            });
+            // Extract text and search result blocks from the response
+            const parts = [];
+            const urls = [];
+            for (const block of response.content) {
+                if (block.type === "text") {
+                    parts.push(block.text);
+                }
+                else if (block.type === "web_search_tool_result") {
+                    for (const item of block.content ?? []) {
+                        if (item.type === "web_search_result") {
+                            urls.push(item.url);
+                            parts.push(`- ${item.title}: ${item.url}\n  ${(item.page_content ?? item.encrypted_content ?? "").slice(0, 200)}`);
+                        }
+                    }
+                }
+            }
+            const summary = parts.join("\n\n").slice(0, 4000);
+            return {
+                success: true,
+                summary: `Web search results for "${query}":\n${summary}`,
+                data: { query, urls, resultCount: urls.length },
+            };
+        }
+        catch (err) {
+            const msg = err.message;
+            return { success: false, summary: `web_search failed: ${msg}`, error: msg };
+        }
+    }
+}
+exports.WebSearchTool = WebSearchTool;
+//# sourceMappingURL=web_search.js.map

package/dist/tools/network/web_search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web_search.js","sourceRoot":"","sources":["../../../src/tools/network/web_search.ts"],"names":[],"mappings":";;;;;;AACA,4DAA0C;AAE1C,MAAM,cAAc,GAAG,2BAA2B,CAAC;AAEnD,MAAa,aAAa;IACxB,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,gJAAgJ,CAAC;IAE/J,WAAW,GAAe;QACxB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;SACvD;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAA+B,EAAE,GAAgB;QAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEnC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,aAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;YAE9D,kEAAkE;YAClE,wDAAwD;YACxD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC5C,KAAK,EAAE,GAAG,CAAC,OAAO,IAAI,cAAc;gBACpC,UAAU,EAAE,IAAI;gBAChB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAS,CAAC;gBAC/C,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,KAAK,iDAAiD,EAAE;iBACzG;aACF,CAAC,CAAC;YAEH,0DAA0D;YAC1D,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAa,EAAE,CAAC;YAE1B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzB,CAAC;qBAAM,IAAK,KAAa,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;oBAC5D,KAAK,MAAM,IAAI,IAAK,KAAa,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;wBAChD,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;4BACtC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;4BACpB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;wBACrH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAElD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,2BAA2B,KAAK,OAAO,OAAO,EAAE;gBACzD,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE;aAChD,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAI,GAAa,CAAC,OAAO,CAAC;YACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,sBAAsB,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAC9E,CAAC;IACH,CAAC;CACF;AA1DD,sCA0DC"}

package/dist/tools/page/extract_dom.d.ts

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

package/dist/tools/page/extract_dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract_dom.d.ts","sourceRoot":"","sources":["../../../src/tools/page/extract_dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIzE,qBAAa,cAAe,YAAW,IAAI;IACzC,IAAI,SAAiB;IACrB,WAAW,SAAoJ;IAE/J,WAAW,EAAE,UAAU,CAIrB;IAEI,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAyBvF"}

package/dist/tools/page/extract_dom.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtractDomTool = void 0;
+const MAX_TEXT_LENGTH = 15_000;
+class ExtractDomTool {
+    name = "extract_dom";
+    description = "Extract the visible text content of the page (strips scripts, styles, nav, header, footer). Useful as a fallback when no XHR data is captured.";
+    inputSchema = {
+        type: "object",
+        properties: {},
+        required: [],
+    };
+    async execute(_params, ctx) {
+        const { page } = ctx;
+        if (!page) {
+            return { success: false, summary: "extract_dom failed: no browser context", error: "missing page" };
+        }
+        const text = await page.evaluate(() => {
+            const clone = document.body.cloneNode(true);
+            clone.querySelectorAll("script, style, nav, footer, header, svg, noscript")
+                .forEach((el) => el.remove());
+            return clone.innerText
+                .split("\n")
+                .map((l) => l.trim())
+                .filter((l) => l.length > 0)
+                .join("\n");
+        });
+        const trimmed = text.slice(0, MAX_TEXT_LENGTH);
+        return {
+            success: true,
+            summary: `Page text (${trimmed.length} chars):\n${trimmed}`,
+            data: trimmed,
+        };
+    }
+}
+exports.ExtractDomTool = ExtractDomTool;
+//# sourceMappingURL=extract_dom.js.map

package/dist/tools/page/extract_dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract_dom.js","sourceRoot":"","sources":["../../../src/tools/page/extract_dom.ts"],"names":[],"mappings":";;;AAEA,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,MAAa,cAAc;IACzB,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAAG,gJAAgJ,CAAC;IAE/J,WAAW,GAAe;QACxB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,OAAgC,EAAE,GAAgB;QAC9D,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC;QACrB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,wCAAwC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QACtG,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;YACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAgB,CAAC;YAC3D,KAAK,CAAC,gBAAgB,CAAC,mDAAmD,CAAC;iBACxE,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;YAChC,OAAO,KAAK,CAAC,SAAS;iBACnB,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;iBAC3B,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;QAE/C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,cAAc,OAAO,CAAC,MAAM,aAAa,OAAO,EAAE;YAC3D,IAAI,EAAE,OAAO;SACd,CAAC;IACJ,CAAC;CACF;AAnCD,wCAmCC"}

package/dist/tools/page/observe.d.ts

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

package/dist/tools/page/observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../../src/tools/page/observe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAMzE,qBAAa,WAAY,YAAW,IAAI;IACtC,IAAI,SAAa;IACjB,WAAW,SAA8G;IAEzH,WAAW,EAAE,UAAU,CAIrB;IAEI,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAiCvF"}