zan-browser 2.0.8 → 3.0.0

package/dist/tools/page/observe.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObserveTool = void 0;
+const perception_1 = require("../../perception");
+class ObserveTool {
+    name = "observe";
+    description = "Observe the current page: returns the ActionSpace (interactive elements, forms, errors, network summary)";
+    inputSchema = {
+        type: "object",
+        properties: {},
+        required: [],
+    };
+    async execute(_params, ctx) {
+        const { observer, interceptor } = ctx;
+        if (!observer) {
+            return { success: false, summary: "observe failed: no observer", error: "missing observer" };
+        }
+        const observation = await observer.observe();
+        const forms = await observer.detectForms();
+        const autocompleteItems = await observer.detectAutocomplete();
+        const errorMessages = await observer.detectErrors();
+        const capturedRequests = interceptor?.getAll() ?? [];
+        const perception = (0, perception_1.buildPerception)(observation, forms, autocompleteItems, errorMessages, capturedRequests);
+        const actionSpace = (0, perception_1.formatPerceptionForLLM)(perception);
+        return {
+            success: true,
+            summary: actionSpace,
+            data: {
+                perception,
+                observation,
+                hasVisibleElements: observation.elements.filter((e) => e.visible).length > 0,
+            },
+        };
+    }
+}
+exports.ObserveTool = ObserveTool;
+//# sourceMappingURL=observe.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observe.js","sourceRoot":"","sources":["../../../src/tools/page/observe.ts"],"names":[],"mappings":";;;AACA,iDAG0B;AAE1B,MAAa,WAAW;IACtB,IAAI,GAAG,SAAS,CAAC;IACjB,WAAW,GAAG,0GAA0G,CAAC;IAEzH,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,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;QACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,6BAA6B,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;QAC/F,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,iBAAiB,GAAG,MAAM,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QAC9D,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;QAEpD,MAAM,gBAAgB,GAAG,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAErD,MAAM,UAAU,GAAG,IAAA,4BAAe,EAChC,WAAW,EACX,KAAK,EACL,iBAAiB,EACjB,aAAa,EACb,gBAAgB,CACjB,CAAC;QAEF,MAAM,WAAW,GAAG,IAAA,mCAAsB,EAAC,UAAU,CAAC,CAAC;QAEvD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,WAAW;YACpB,IAAI,EAAE;gBACJ,UAAU;gBACV,WAAW;gBACX,kBAAkB,EAAE,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;aAC7E;SACF,CAAC;IACJ,CAAC;CACF;AA3CD,kCA2CC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.d.ts","sourceRoot":"","sources":["../../../src/tools/page/scrape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAMzE,qBAAa,UAAW,YAAW,IAAI;IACrC,IAAI,SAAY;IAChB,WAAW,SAAuI;IAElJ,WAAW,EAAE,UAAU,CAOrB;IAEI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAyDtF"}

package/dist/tools/page/scrape.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScrapeTool = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const FALLBACK_MODEL = "claude-haiku-4-5-20251001";
+const MAX_HTML_LENGTH = 12_000;
+class ScrapeTool {
+    name = "scrape";
+    description = "Extract structured data from the current page using CSS selectors or by sending visible HTML to Claude for intelligent extraction";
+    inputSchema = {
+        type: "object",
+        properties: {
+            selector: { type: "string", description: "CSS selector to extract from (optional — if omitted, extracts from full visible body)" },
+            prompt: { type: "string", description: "What data to extract, e.g. 'extract all product names and prices as JSON'" },
+        },
+        required: ["prompt"],
+    };
+    async execute(params, ctx) {
+        const { page } = ctx;
+        if (!page) {
+            return { success: false, summary: "scrape failed: no browser context", error: "missing page" };
+        }
+        const selector = params.selector ? String(params.selector) : "body";
+        const prompt = String(params.prompt);
+        // Extract clean HTML from the target element
+        const html = await page.evaluate((sel) => {
+            const el = document.querySelector(sel);
+            if (!el)
+                return "";
+            const clone = el.cloneNode(true);
+            clone.querySelectorAll("script, style, svg, noscript").forEach((n) => n.remove());
+            return clone.innerHTML.replace(/\s+/g, " ").trim();
+        }, selector);
+        if (!html) {
+            return { success: false, summary: `scrape failed: no content found for selector "${selector}"`, error: "empty result" };
+        }
+        const trimmedHtml = html.slice(0, MAX_HTML_LENGTH);
+        // Use Claude to extract structured data from the HTML
+        try {
+            const client = new sdk_1.default({ apiKey: ctx.anthropicApiKey });
+            const response = await client.messages.create({
+                model: ctx.aiModel ?? FALLBACK_MODEL,
+                max_tokens: 2000,
+                messages: [
+                    {
+                        role: "user",
+                        content: `Extract data from this HTML. ${prompt}\n\nHTML:\n${trimmedHtml}\n\nRespond ONLY with the extracted data as JSON. No explanation.`,
+                    },
+                ],
+            });
+            const text = response.content[0].type === "text" ? response.content[0].text : "{}";
+            let parsed;
+            try {
+                parsed = JSON.parse(text.replace(/```json\n?/g, "").replace(/```\n?/g, "").trim());
+            }
+            catch {
+                parsed = text;
+            }
+            return {
+                success: true,
+                summary: `Scraped data:\n${typeof parsed === "string" ? parsed : JSON.stringify(parsed, null, 2)}`.slice(0, 4000),
+                data: parsed,
+            };
+        }
+        catch (err) {
+            const msg = err.message;
+            return { success: false, summary: `scrape LLM extraction failed: ${msg}`, error: msg };
+        }
+    }
+}
+exports.ScrapeTool = ScrapeTool;
+//# sourceMappingURL=scrape.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.js","sourceRoot":"","sources":["../../../src/tools/page/scrape.ts"],"names":[],"mappings":";;;;;;AACA,4DAA0C;AAE1C,MAAM,cAAc,GAAG,2BAA2B,CAAC;AACnD,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,MAAa,UAAU;IACrB,IAAI,GAAG,QAAQ,CAAC;IAChB,WAAW,GAAG,mIAAmI,CAAC;IAElJ,WAAW,GAAe;QACxB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uFAAuF,EAAE;YAClI,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2EAA2E,EAAE;SACrH;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB,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,mCAAmC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QACjG,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAErC,6CAA6C;QAC7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAW,EAAE,EAAE;YAC/C,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,CAAC,EAAE;gBAAE,OAAO,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAgB,CAAC;YAChD,KAAK,CAAC,gBAAgB,CAAC,8BAA8B,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAClF,OAAO,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACrD,CAAC,EAAE,QAAQ,CAAC,CAAC;QAEb,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,iDAAiD,QAAQ,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QAC1H,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;QAEnD,sDAAsD;QACtD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,aAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC5C,KAAK,EAAE,GAAG,CAAC,OAAO,IAAI,cAAc;gBACpC,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE,gCAAgC,MAAM,cAAc,WAAW,mEAAmE;qBAC5I;iBACF;aACF,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YAEnF,IAAI,MAAe,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACrF,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,kBAAkB,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;gBACjH,IAAI,EAAE,MAAM;aACb,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,iCAAiC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACzF,CAAC;IACH,CAAC;CACF;AAtED,gCAsEC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zan-browser",
-  "version": "2.0.8",
+  "version": "3.0.0",
   "description": "AI-powered cloud browser library with observe-first, screenshot-as-fallback pattern",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",