zan-browser 2.0.8 → 3.0.1

package/dist/agent/agent.d.ts

@@ -0,0 +1,42 @@
+import type { ToolRegistry } from "../registry";
+import type { ToolContext, ToolResult } from "../tools/base";
+import type { SeedValue, CapturedRequest } from "../types";
+export interface AgentConfig {
+    goal: string;
+    seedValues?: SeedValue[];
+    maxSteps?: number;
+    model?: string;
+    onProgress?: (msg: string) => void;
+}
+export interface AgentStepRecord {
+    step: number;
+    toolName: string;
+    params: Record<string, unknown>;
+    result: ToolResult;
+    reasoning: string;
+}
+export interface AgentResult {
+    success: boolean;
+    steps: AgentStepRecord[];
+    finalUrl: string;
+    reason: string;
+    capturedRequests: CapturedRequest[];
+}
+export declare class AgentLoop {
+    private client;
+    private model;
+    private registry;
+    private ctx;
+    private conversation;
+    private systemPrompt;
+    constructor(registry: ToolRegistry, ctx: ToolContext, model?: string);
+    run(config: AgentConfig): Promise<AgentResult>;
+    private askLLM;
+    private parseDecision;
+    /** Fallback: extract params from flat action object (legacy format compat) */
+    private extractLegacyParams;
+    private getCurrentUrl;
+    private hasUsefulCaptures;
+    private buildResult;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAM3D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACrC;AAaD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,YAAY,CAAS;gBAG3B,QAAQ,EAAE,YAAY,EACtB,GAAG,EAAE,WAAW,EAChB,KAAK,CAAC,EAAE,MAAM;IAUV,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;YA4FtC,MAAM;IAkBpB,OAAO,CAAC,aAAa;IAyBrB,8EAA8E;IAC9E,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,WAAW;CASpB"}

package/dist/agent/agent.js

@@ -0,0 +1,163 @@
+"use strict";
+// ─── Agent Loop ──────────────────────────────────────────────────────────────
+// observe → LLM decides → registry.execute() → repeat
+// Replaces SmartNavigator. No hardcoded strategies — the LLM decides everything.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentLoop = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const conversation_1 = require("./conversation");
+const prompt_1 = require("./prompt");
+const FALLBACK_MODEL = "claude-haiku-4-5-20251001";
+// ─── Agent ───────────────────────────────────────────────────────────────────
+class AgentLoop {
+    client;
+    model;
+    registry;
+    ctx;
+    conversation;
+    systemPrompt;
+    constructor(registry, ctx, model) {
+        this.registry = registry;
+        this.ctx = ctx;
+        this.model = model ?? ctx.aiModel ?? FALLBACK_MODEL;
+        this.client = new sdk_1.default({ apiKey: ctx.anthropicApiKey });
+        this.conversation = new conversation_1.ConversationHistory();
+        this.systemPrompt = (0, prompt_1.buildSystemPrompt)(registry);
+    }
+    async run(config) {
+        const maxSteps = config.maxSteps ?? 15;
+        const progress = config.onProgress ?? (() => { });
+        const steps = [];
+        // Build the initial task message
+        const seedLines = config.seedValues?.length
+            ? `\nSeed values:\n${config.seedValues.map((s) => `  • ${s.paramName} (${s.description}): "${s.exampleValue}"`).join("\n")}`
+            : "";
+        // Detect if we're on a blank/empty page to guide the first action
+        const currentUrl = this.getCurrentUrl();
+        const isBlank = !currentUrl || currentUrl === "about:blank" || currentUrl === "unknown";
+        const firstActionHint = isBlank
+            ? "The browser is on a blank page. Use web_search to find the target URL, or navigate directly if the goal includes a URL."
+            : `The browser is on ${currentUrl}. Start by observing the page.`;
+        this.conversation.append("user", `NAVIGATION TASK\nGoal: ${config.goal}\nStep budget: ${maxSteps}${seedLines}\n\n${firstActionHint}`);
+        for (let i = 0; i < maxSteps; i++) {
+            progress(`Step ${i + 1}/${maxSteps}`);
+            // ── 1. Ask LLM what to do ──────────────────────────────────────────
+            const decision = await this.askLLM();
+            // ── 2. Terminal states ─────────────────────────────────────────────
+            if (decision.data_found && decision.tool_name !== "eval_js") {
+                progress("Agent signalled data_found — stopping");
+                return this.buildResult(true, steps, decision.reasoning);
+            }
+            if (decision.tool_name === "done") {
+                progress("Agent signalled done");
+                return this.buildResult(true, steps, decision.reasoning);
+            }
+            if (decision.tool_name === "impossible") {
+                progress(`Agent: impossible — ${decision.reasoning}`);
+                return this.buildResult(false, steps, decision.reasoning);
+            }
+            // ── 3. Execute the tool ────────────────────────────────────────────
+            const result = await this.registry.execute(decision.tool_name, decision.params, this.ctx);
+            steps.push({
+                step: i + 1,
+                toolName: decision.tool_name,
+                params: decision.params,
+                result,
+                reasoning: decision.reasoning,
+            });
+            progress(`Step ${i + 1}: ${decision.tool_name} → ${result.success ? "ok" : "error"}`);
+            // ── 4. Feed result back to conversation ────────────────────────────
+            // For screenshot tool, include the image in the message
+            if (decision.tool_name === "screenshot" && result.success && result.data) {
+                const screenshotData = result.data;
+                this.conversation.append("user", [
+                    {
+                        type: "image",
+                        source: { type: "base64", media_type: "image/jpeg", data: screenshotData.base64 },
+                    },
+                    { type: "text", text: `Screenshot captured. URL: ${this.getCurrentUrl()}\nDecide next action.` },
+                ]);
+            }
+            else {
+                const stepContext = `Tool: ${decision.tool_name}\nResult: ${result.summary}\nURL: ${this.getCurrentUrl()}`;
+                this.conversation.append("user", stepContext);
+            }
+            // ── 5. Post-execution data_found check (for eval_js) ──────────────
+            if (decision.data_found && decision.tool_name === "eval_js") {
+                progress("Agent signalled data_found via eval_js — stopping");
+                return this.buildResult(true, steps, decision.reasoning);
+            }
+        }
+        // Max steps exhausted
+        progress(`Completed ${maxSteps} steps`);
+        return this.buildResult(this.hasUsefulCaptures(), steps, `Reached max steps (${maxSteps})`);
+    }
+    // ─── Private: Ask LLM for next decision ────────────────────────────────────
+    async askLLM() {
+        const messages = this.conversation.toMessages();
+        const response = await this.client.messages.create({
+            model: this.model,
+            max_tokens: 800,
+            system: this.systemPrompt,
+            messages,
+        });
+        const text = response.content[0].type === "text" ? response.content[0].text : "{}";
+        // Store assistant response in conversation
+        this.conversation.append("assistant", text);
+        return this.parseDecision(text);
+    }
+    parseDecision(raw) {
+        try {
+            const cleaned = raw.replace(/```json\n?/g, "").replace(/```\n?/g, "").trim();
+            const obj = JSON.parse(cleaned);
+            return {
+                memory: obj.memory ?? "",
+                next_goal: obj.next_goal ?? "",
+                reasoning: obj.reasoning ?? String(obj.reason ?? ""),
+                data_found: obj.data_found === true,
+                tool_name: obj.tool_name ?? obj.type ?? "impossible",
+                params: obj.params ?? this.extractLegacyParams(obj),
+            };
+        }
+        catch {
+            return {
+                memory: "",
+                next_goal: "",
+                reasoning: `Failed to parse LLM response: ${raw.slice(0, 100)}`,
+                data_found: false,
+                tool_name: "impossible",
+                params: {},
+            };
+        }
+    }
+    /** Fallback: extract params from flat action object (legacy format compat) */
+    extractLegacyParams(obj) {
+        const params = {};
+        for (const key of ["elementId", "value", "direction", "amount", "ms", "url", "code", "query", "selector", "prompt"]) {
+            if (obj[key] !== undefined)
+                params[key] = obj[key];
+        }
+        return params;
+    }
+    // ─── Private: Helpers ──────────────────────────────────────────────────────
+    getCurrentUrl() {
+        return this.ctx.page?.url() ?? "unknown";
+    }
+    hasUsefulCaptures() {
+        return (this.ctx.interceptor?.getUseful(5).length ?? 0) > 0;
+    }
+    buildResult(success, steps, reason) {
+        return {
+            success,
+            steps,
+            finalUrl: this.getCurrentUrl(),
+            reason,
+            capturedRequests: this.ctx.interceptor?.getUseful(3) ?? [],
+        };
+    }
+}
+exports.AgentLoop = AgentLoop;
+//# sourceMappingURL=agent.js.map

package/dist/agent/agent.js.map

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

package/dist/agent/conversation.d.ts

@@ -0,0 +1,22 @@
+import type Anthropic from "@anthropic-ai/sdk";
+export interface ConversationMessage {
+    role: "user" | "assistant";
+    content: string | Anthropic.MessageParam["content"];
+}
+export declare class ConversationHistory {
+    private messages;
+    /** Append a message to the history. */
+    append(role: "user" | "assistant", content: string | Anthropic.MessageParam["content"]): void;
+    /** Return the pruned message list for the Anthropic API. */
+    toMessages(): Anthropic.MessageParam[];
+    /** Number of messages in history (before pruning). */
+    get length(): number;
+    /** Clear all history. */
+    clear(): void;
+    /**
+     * Keep the first message (task context, always preserved) +
+     * the last MAX_HISTORY_PAIRS user+assistant pairs.
+     */
+    private prune;
+}
+//# sourceMappingURL=conversation.d.ts.map

package/dist/agent/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/agent/conversation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAM/C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;CACrD;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAA6B;IAE7C,uCAAuC;IACvC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,IAAI;IAI7F,4DAA4D;IAC5D,UAAU,IAAI,SAAS,CAAC,YAAY,EAAE;IAQtC,sDAAsD;IACtD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,yBAAyB;IACzB,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,OAAO,CAAC,KAAK;CAQd"}

package/dist/agent/conversation.js

@@ -0,0 +1,47 @@
+"use strict";
+// ─── Multi-turn conversation history with sliding-window pruning ─────────────
+// Keeps the first message (task context) + last N pairs to stay within
+// the LLM context window. Mirrors the Notte pattern.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationHistory = void 0;
+// How many user+assistant pairs to keep beyond the first message.
+// 6 pairs = 12 messages + 1 initial = 13 messages max.
+const MAX_HISTORY_PAIRS = 6;
+class ConversationHistory {
+    messages = [];
+    /** Append a message to the history. */
+    append(role, content) {
+        this.messages.push({ role, content });
+    }
+    /** Return the pruned message list for the Anthropic API. */
+    toMessages() {
+        const pruned = this.prune();
+        return pruned.map((m) => ({
+            role: m.role,
+            content: m.content,
+        }));
+    }
+    /** Number of messages in history (before pruning). */
+    get length() {
+        return this.messages.length;
+    }
+    /** Clear all history. */
+    clear() {
+        this.messages = [];
+    }
+    /**
+     * Keep the first message (task context, always preserved) +
+     * the last MAX_HISTORY_PAIRS user+assistant pairs.
+     */
+    prune() {
+        const maxMessages = 1 + MAX_HISTORY_PAIRS * 2;
+        if (this.messages.length <= maxMessages)
+            return [...this.messages];
+        return [
+            this.messages[0],
+            ...this.messages.slice(-(MAX_HISTORY_PAIRS * 2)),
+        ];
+    }
+}
+exports.ConversationHistory = ConversationHistory;
+//# sourceMappingURL=conversation.js.map

package/dist/agent/conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../src/agent/conversation.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,uEAAuE;AACvE,qDAAqD;;;AAIrD,kEAAkE;AAClE,uDAAuD;AACvD,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAO5B,MAAa,mBAAmB;IACtB,QAAQ,GAA0B,EAAE,CAAC;IAE7C,uCAAuC;IACvC,MAAM,CAAC,IAA0B,EAAE,OAAmD;QACpF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,4DAA4D;IAC5D,UAAU;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAA6B,CAAC;IAClC,CAAC;IAED,sDAAsD;IACtD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,yBAAyB;IACzB,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACK,KAAK;QACX,MAAM,WAAW,GAAG,CAAC,GAAG,iBAAiB,GAAG,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,WAAW;YAAE,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnE,OAAO;YACL,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAChB,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;SACjD,CAAC;IACJ,CAAC;CACF;AAvCD,kDAuCC"}

package/dist/agent/prompt.d.ts

@@ -0,0 +1,3 @@
+import type { ToolRegistry } from "../registry";
+export declare function buildSystemPrompt(registry: ToolRegistry): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/agent/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/agent/prompt.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAoEhE"}

package/dist/agent/prompt.js

@@ -0,0 +1,77 @@
+"use strict";
+// ─── Dynamic system prompt generation ────────────────────────────────────────
+// Builds the system prompt from the registered tools + the observer's own
+// ActionSpace format description. Adding a new tool or changing the observer
+// ID scheme automatically updates the prompt — nothing is hardcoded.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSystemPrompt = buildSystemPrompt;
+const observer_1 = require("../observer");
+function buildSystemPrompt(registry) {
+    const toolsBlock = registry.generateToolsBlock();
+    const actionSpaceFormat = (0, observer_1.describeActionSpaceFormat)();
+    return `You are a browser navigation agent. Your mission is to discover APIs by navigating websites exactly like a real human user, triggering the network requests that return the data described in the navigation goal.
+
+You have access to tools that let you observe the page, interact with elements, inspect network traffic, search the web, and call APIs directly.
+
+─── ActionSpace Format ────────────────────────────────────────────────────────
+
+${actionSpaceFormat}
+
+─── XHR Scores ────────────────────────────────────────────────────────────────
+
+Use "read_network_logs" to inspect captured requests. Each is scored 0–100:
+
+  80–100  High-value data API — structured JSON, likely triggered by user action
+  50–79   Potentially useful — API-shaped URL, JSON content type
+  20–49   Low-signal — config, feature flags, initialization, analytics
+  0–19    Noise — tracking pixels, CDN assets, fonts, thumbnails
+
+The ↑ marker means the request fired within 2 seconds of your last action.
+
+─── ${toolsBlock} ────────────────────────────────────────────────────────────
+
+─── Response Format ───────────────────────────────────────────────────────────
+
+Respond ONLY with valid JSON. No markdown, no code fences, no extra text.
+
+{
+  "memory": "What I have tried, what worked, what failed, what I have ruled out",
+  "next_goal": "What the next action is specifically intended to achieve",
+  "reasoning": "Why I chose this tool over the other available alternatives",
+  "data_found": false,
+  "tool_name": "click",
+  "params": { "elementId": "B3" }
+}
+
+Special tool names for terminal states:
+- "done" — goal achieved, terminate (params: {})
+- "impossible" — goal cannot be achieved due to structural blocker (params: {})
+
+Set data_found to true ONLY when high-score XHRs (≥ 60) confirm that the data
+described in the goal has been captured. Setting data_found=true terminates the
+session immediately — set it only when you are certain.
+
+─── Rules ─────────────────────────────────────────────────────────────────────
+
+1.  On a new page with content, always observe first before interacting.
+    Exception: if the page is about:blank or empty, skip observe and use
+    "navigate" (if you know the URL) or "web_search" (if you don't) first.
+2.  One tool call per response. Never list multiple tools.
+3.  IDs reset every observation. Never reuse an ID from a prior step.
+4.  data_found: true means immediate termination. Set it only when certain.
+5.  Dismiss popups, cookie banners, and overlays before other interactions.
+6.  If a modal is open, interact with it or close it before anything else.
+7.  Use seed values verbatim when filling inputs — do not rephrase.
+8.  If the page shows errors or "no results", return "done" to allow retry.
+9.  Prefer clicking visible elements over direct URL navigation.
+10. If the page is still loading, use "wait" with 1500ms.
+11. Return "impossible" only for structural blockers: CAPTCHA, mandatory login.
+12. Use "web_search" when the target URL is unknown, the goal is vague, or
+    the page is about:blank. This should be your FIRST action when starting
+    without a loaded page — do not observe an empty page.
+13. Use "fetch_url" to call a discovered API directly if the URL is known.
+14. Use "read_network_logs" to check if useful data has already been captured.
+15. Use "eval_js" to extract SSR data (window.__NEXT_DATA__, etc.).
+16. Reason like a real user. Click what you can see. Do not invent element IDs.`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/agent/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/agent/prompt.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,0EAA0E;AAC1E,6EAA6E;AAC7E,qEAAqE;;AAKrE,8CAoEC;AAtED,0CAAwD;AAExD,SAAgB,iBAAiB,CAAC,QAAsB;IACtD,MAAM,UAAU,GAAG,QAAQ,CAAC,kBAAkB,EAAE,CAAC;IACjD,MAAM,iBAAiB,GAAG,IAAA,oCAAyB,GAAE,CAAC;IAEtD,OAAO;;;;;;EAMP,iBAAiB;;;;;;;;;;;;;MAab,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gFA4CgE,CAAC;AACjF,CAAC"}

package/dist/browser.d.ts

@@ -2,7 +2,6 @@ import type { BrowserConfig } from "./types";
 import { Session } from "./session";
 export declare class RensanBrowser {
     private config;
-    private ai;
     constructor(config: BrowserConfig);
     newSession(): Promise<Session>;
     private resolveProvider;

package/dist/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,SAAS,CAAC;AAEjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,EAAE,CAAW;gBAET,MAAM,EAAE,aAAa;IAO3B,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IA6CpC,OAAO,CAAC,eAAe;CAmBxB"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAM3B,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAkDpC,OAAO,CAAC,eAAe;CAgBxB"}

package/dist/browser.js

@@ -2,15 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RensanBrowser = void 0;
 const session_1 = require("./session");
-const ai_1 = require("./ai");
 const puppeteer_local_1 = require("./providers/puppeteer-local");
 const browserbase_1 = require("./providers/browserbase");
 class RensanBrowser {
     config;
-    ai;
     constructor(config) {
         this.config = config;
-        this.ai = new ai_1.AIClient(config.ai.apiKey, config.ai.model);
     }
     // Create a new browser session using the configured provider.
     // Provider selection: puppeteer-local (default for dev) → browserbase (production)
@@ -39,12 +36,10 @@ class RensanBrowser {
             });
         }
         else {
-            // ws-endpoint: use Browserbase provider with custom wsEndpoint
-            // For backwards compat — wraps Playwright connectOverCDP
+            // ws-endpoint: use Puppeteer local as fallback (connect via CDP)
             if (!this.config.session.wsEndpoint) {
                 throw new Error("BrowserConfig requires wsEndpoint when provider=ws-endpoint");
             }
-            // Use Puppeteer local as fallback for ws-endpoint (connect via CDP)
             const provider = new puppeteer_local_1.PuppeteerLocalProvider();
             browserHandle = await provider.launch({
                 viewport: viewport ?? { width: 1280, height: 800 },
@@ -53,11 +48,10 @@ class RensanBrowser {
             });
         }
         const page = await browserHandle.newPage();
-        return new session_1.Session(page, browserHandle, this.ai, timeout, browserHandle.viewerUrl);
+        return new session_1.Session(page, browserHandle, this.config.ai.apiKey, timeout, browserHandle.viewerUrl, this.config.ai.model);
     }
     // Determine which provider to use based on config + env
     resolveProvider() {
-        // Explicit env override
         const envProvider = process.env.BROWSER_PROVIDER;
         if (envProvider) {
             const valid = ["puppeteer-local", "browserbase", "ws-endpoint"];
@@ -68,12 +62,10 @@ class RensanBrowser {
                 return envProvider;
             }
         }
-        // Auto-detect from config
         if (this.config.session.browserbase)
             return "browserbase";
         if (this.config.session.wsEndpoint)
             return "ws-endpoint";
-        // Default: local Puppeteer
         return "puppeteer-local";
     }
 }

package/dist/browser.js.map

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

package/dist/index.d.ts

@@ -1,10 +1,27 @@
 export { RensanBrowser } from "./browser";
 export { Session } from "./session";
-export { SmartNavigator } from "./navigator";
+export { ToolRegistry } from "./registry";
+export { AgentLoop } from "./agent/agent";
+export type { Tool, ToolContext, ToolResult, JSONSchema } from "./tools/base";
+export type { AgentConfig, AgentResult, AgentStepRecord } from "./agent/agent";
+export type { ConversationMessage } from "./agent/conversation";
 export type { ObservedElement, ObserveResult, CapturedRequest, SeedValue, AgentAction, ActResult, FindDataResult, SessionConfig, AIConfig, BrowserConfig, Screenshot, ElementType, } from "./types";
 export type { PageHandle, BrowserHandle, BrowserProvider, ProviderType, } from "./browser-provider";
-export type { NavigationConfig, NavigationResult, NavigationStrategy, } from "./navigator";
 export type { Perception, StepContext, StepRecord, } from "./perception";
 export type { DetectedForm, AutocompleteItem, } from "./observer";
 export { isBlacklisted } from "./blacklist";
+export { ClickTool } from "./tools/browser/click";
+export { FillTool } from "./tools/browser/fill";
+export { ScrollTool } from "./tools/browser/scroll";
+export { NavigateTool } from "./tools/browser/navigate";
+export { WaitTool } from "./tools/browser/wait";
+export { EvalJsTool } from "./tools/browser/eval_js";
+export { ScreenshotTool } from "./tools/browser/screenshot";
+export { ObserveTool } from "./tools/page/observe";
+export { ScrapeTool } from "./tools/page/scrape";
+export { ExtractDomTool } from "./tools/page/extract_dom";
+export { WebSearchTool } from "./tools/network/web_search";
+export { FetchUrlTool } from "./tools/network/fetch_url";
+export { DownloadFileTool } from "./tools/network/download_file";
+export { ReadNetworkLogsTool } from "./tools/network/read_network_logs";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EACV,eAAe,EACf,aAAa,EACb,eAAe,EACf,SAAS,EACT,WAAW,EACX,SAAS,EACT,cAAc,EACd,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,UAAU,EACV,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG9E,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC/E,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,YAAY,EACV,eAAe,EACf,aAAa,EACb,eAAe,EACf,SAAS,EACT,WAAW,EACX,SAAS,EACT,cAAc,EACd,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,UAAU,EACV,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -1,12 +1,44 @@
 "use strict";
+// ─── Public API ──────────────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isBlacklisted = exports.SmartNavigator = exports.Session = exports.RensanBrowser = void 0;
+exports.ReadNetworkLogsTool = exports.DownloadFileTool = exports.FetchUrlTool = exports.WebSearchTool = exports.ExtractDomTool = exports.ScrapeTool = exports.ObserveTool = exports.ScreenshotTool = exports.EvalJsTool = exports.WaitTool = exports.NavigateTool = exports.ScrollTool = exports.FillTool = exports.ClickTool = exports.isBlacklisted = exports.AgentLoop = exports.ToolRegistry = exports.Session = exports.RensanBrowser = void 0;
 var browser_1 = require("./browser");
 Object.defineProperty(exports, "RensanBrowser", { enumerable: true, get: function () { return browser_1.RensanBrowser; } });
 var session_1 = require("./session");
 Object.defineProperty(exports, "Session", { enumerable: true, get: function () { return session_1.Session; } });
-var navigator_1 = require("./navigator");
-Object.defineProperty(exports, "SmartNavigator", { enumerable: true, get: function () { return navigator_1.SmartNavigator; } });
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return registry_1.ToolRegistry; } });
+var agent_1 = require("./agent/agent");
+Object.defineProperty(exports, "AgentLoop", { enumerable: true, get: function () { return agent_1.AgentLoop; } });
 var blacklist_1 = require("./blacklist");
 Object.defineProperty(exports, "isBlacklisted", { enumerable: true, get: function () { return blacklist_1.isBlacklisted; } });
+// ─── Individual tools (for custom registries) ───────────────────────────────
+var click_1 = require("./tools/browser/click");
+Object.defineProperty(exports, "ClickTool", { enumerable: true, get: function () { return click_1.ClickTool; } });
+var fill_1 = require("./tools/browser/fill");
+Object.defineProperty(exports, "FillTool", { enumerable: true, get: function () { return fill_1.FillTool; } });
+var scroll_1 = require("./tools/browser/scroll");
+Object.defineProperty(exports, "ScrollTool", { enumerable: true, get: function () { return scroll_1.ScrollTool; } });
+var navigate_1 = require("./tools/browser/navigate");
+Object.defineProperty(exports, "NavigateTool", { enumerable: true, get: function () { return navigate_1.NavigateTool; } });
+var wait_1 = require("./tools/browser/wait");
+Object.defineProperty(exports, "WaitTool", { enumerable: true, get: function () { return wait_1.WaitTool; } });
+var eval_js_1 = require("./tools/browser/eval_js");
+Object.defineProperty(exports, "EvalJsTool", { enumerable: true, get: function () { return eval_js_1.EvalJsTool; } });
+var screenshot_1 = require("./tools/browser/screenshot");
+Object.defineProperty(exports, "ScreenshotTool", { enumerable: true, get: function () { return screenshot_1.ScreenshotTool; } });
+var observe_1 = require("./tools/page/observe");
+Object.defineProperty(exports, "ObserveTool", { enumerable: true, get: function () { return observe_1.ObserveTool; } });
+var scrape_1 = require("./tools/page/scrape");
+Object.defineProperty(exports, "ScrapeTool", { enumerable: true, get: function () { return scrape_1.ScrapeTool; } });
+var extract_dom_1 = require("./tools/page/extract_dom");
+Object.defineProperty(exports, "ExtractDomTool", { enumerable: true, get: function () { return extract_dom_1.ExtractDomTool; } });
+var web_search_1 = require("./tools/network/web_search");
+Object.defineProperty(exports, "WebSearchTool", { enumerable: true, get: function () { return web_search_1.WebSearchTool; } });
+var fetch_url_1 = require("./tools/network/fetch_url");
+Object.defineProperty(exports, "FetchUrlTool", { enumerable: true, get: function () { return fetch_url_1.FetchUrlTool; } });
+var download_file_1 = require("./tools/network/download_file");
+Object.defineProperty(exports, "DownloadFileTool", { enumerable: true, get: function () { return download_file_1.DownloadFileTool; } });
+var read_network_logs_1 = require("./tools/network/read_network_logs");
+Object.defineProperty(exports, "ReadNetworkLogsTool", { enumerable: true, get: function () { return read_network_logs_1.ReadNetworkLogsTool; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AAmCvB,yCAA4C;AAAnC,0GAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,gFAAgF;;;AAEhF,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AACrB,uCAA0C;AAAjC,kGAAA,SAAS,OAAA;AA2ClB,yCAA4C;AAAnC,0GAAA,aAAa,OAAA;AAEtB,+EAA+E;AAC/E,+CAAkD;AAAzC,kGAAA,SAAS,OAAA;AAClB,6CAAgD;AAAvC,gGAAA,QAAQ,OAAA;AACjB,iDAAoD;AAA3C,oGAAA,UAAU,OAAA;AACnB,qDAAwD;AAA/C,wGAAA,YAAY,OAAA;AACrB,6CAAgD;AAAvC,gGAAA,QAAQ,OAAA;AACjB,mDAAqD;AAA5C,qGAAA,UAAU,OAAA;AACnB,yDAA4D;AAAnD,4GAAA,cAAc,OAAA;AACvB,gDAAmD;AAA1C,sGAAA,WAAW,OAAA;AACpB,8CAAiD;AAAxC,oGAAA,UAAU,OAAA;AACnB,wDAA0D;AAAjD,6GAAA,cAAc,OAAA;AACvB,yDAA2D;AAAlD,2GAAA,aAAa,OAAA;AACtB,uDAAyD;AAAhD,yGAAA,YAAY,OAAA;AACrB,+DAAiE;AAAxD,iHAAA,gBAAgB,OAAA;AACzB,uEAAwE;AAA/D,wHAAA,mBAAmB,OAAA"}

package/dist/observer.d.ts

@@ -1,5 +1,9 @@
 import type { PageHandle } from "./browser-provider";
-import type { ObserveResult } from "./types";
+import type { ObserveResult, ElementType } from "./types";
+export declare const PREFIX: Record<ElementType, string>;
+/** Generates the ActionSpace format description for LLM prompts.
+ *  Always in sync with how observe() actually assigns IDs and formats output. */
+export declare function describeActionSpaceFormat(): string;
 export interface DetectedForm {
     mainInput: string | null;
     submitButton: string | null;

package/dist/observer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../src/observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAmB,aAAa,EAAe,MAAM,SAAS,CAAC;AAgB3E,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,KAAK,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IACH,QAAQ,EAAE,QAAQ,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,QAAQ;IACnB,OAAO,CAAC,IAAI,CAAa;IAEzB,OAAO,CAAC,gBAAgB,CAAkC;gBAE9C,IAAI,EAAE,UAAU;IAKtB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAwRjE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAmC5E,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMrC,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA8CtC,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAwCjD,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAoCvC,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,uBAAuB;CAsIhC"}
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../src/observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAmB,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3E,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAS9C,CAAC;AAEF;iFACiF;AACjF,wBAAgB,yBAAyB,IAAI,MAAM,CAgBlD;AAID,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,KAAK,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IACH,QAAQ,EAAE,QAAQ,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,QAAQ;IACnB,OAAO,CAAC,IAAI,CAAa;IAEzB,OAAO,CAAC,gBAAgB,CAAkC;gBAE9C,IAAI,EAAE,UAAU;IAKtB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAwRjE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAmC5E,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMrC,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA8CtC,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAwCjD,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAoCvC,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,uBAAuB;CAsIhC"}