ai-browser 0.2.3 → 0.2.5

package/dist/agent/content-budget.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tool-aware content budget system for formatting MCP results for LLM consumption.
+ * Prioritizes aiMarkdown/aiSummary fields from the MCP enrichment layer.
+ */
+export declare function getToolBudget(toolName: string): number;
+/**
+ * Format MCP tool result for LLM consumption.
+ * Priority: aiMarkdown > aiSummary > raw JSON, all within budget.
+ */
+export declare function formatToolResult(rawText: string, toolName: string): string;
+//# sourceMappingURL=content-budget.d.ts.map

package/dist/agent/content-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-budget.d.ts","sourceRoot":"","sources":["../../src/agent/content-budget.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwDH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA6B1E"}

package/dist/agent/content-budget.js

@@ -0,0 +1,129 @@
+/**
+ * Tool-aware content budget system for formatting MCP results for LLM consumption.
+ * Prioritizes aiMarkdown/aiSummary fields from the MCP enrichment layer.
+ */
+/** Budget limits by tool category (in characters) */
+const TOOL_BUDGETS = {
+    // Navigation/action tools — concise results
+    navigate: 2000,
+    click: 2000,
+    type_text: 2000,
+    press_key: 2000,
+    scroll: 2000,
+    go_back: 2000,
+    select_option: 2000,
+    hover: 2000,
+    set_value: 2000,
+    wait: 2000,
+    wait_for_stable: 2000,
+    handle_dialog: 2000,
+    upload_file: 2000,
+    switch_tab: 2000,
+    close_tab: 2000,
+    create_tab: 2000,
+    create_session: 2000,
+    close_session: 2000,
+    // Content extraction tools — need more space
+    get_page_content: 6000,
+    execute_javascript: 4000,
+    get_network_logs: 4000,
+    get_console_logs: 4000,
+    // Page info tools — moderate space
+    get_page_info: 4000,
+    find_element: 3000,
+    list_tabs: 3000,
+    screenshot: 2000,
+    get_dialog_info: 3000,
+    get_downloads: 3000,
+    // Task tools
+    list_task_templates: 3000,
+    run_task_template: 2000,
+    get_task_run: 4000,
+    list_task_runs: 3000,
+    cancel_task_run: 2000,
+    get_artifact: 6000,
+    get_runtime_profile: 2000,
+    // Composite tools
+    fill_form: 4000,
+    click_and_wait: 4000,
+    navigate_and_extract: 6000,
+};
+const DEFAULT_BUDGET = 4000;
+const SAFETY_MAX = 8000;
+export function getToolBudget(toolName) {
+    return TOOL_BUDGETS[toolName] ?? DEFAULT_BUDGET;
+}
+/**
+ * Format MCP tool result for LLM consumption.
+ * Priority: aiMarkdown > aiSummary > raw JSON, all within budget.
+ */
+export function formatToolResult(rawText, toolName) {
+    const budget = getToolBudget(toolName);
+    try {
+        const data = JSON.parse(rawText);
+        // Priority 1: Use aiMarkdown if available and within budget
+        if (typeof data.aiMarkdown === 'string' && data.aiMarkdown.length > 0) {
+            const md = data.aiMarkdown;
+            if (md.length <= budget)
+                return md;
+            // Over budget — try aiSummary as fallback
+            if (typeof data.aiSummary === 'string' && data.aiSummary.length > 0) {
+                return truncate(data.aiSummary, budget);
+            }
+            // Truncate aiMarkdown as last resort
+            return truncate(md, budget);
+        }
+        // Priority 2: Use aiSummary if available
+        if (typeof data.aiSummary === 'string' && data.aiSummary.length > 0) {
+            return truncate(data.aiSummary, budget);
+        }
+        // Priority 3: Tool-specific formatting for legacy/non-enriched responses
+        const formatted = formatLegacy(data, toolName);
+        return truncate(formatted, SAFETY_MAX);
+    }
+    catch {
+        return truncate(rawText, SAFETY_MAX);
+    }
+}
+function formatLegacy(data, toolName) {
+    if (toolName === 'get_page_info' && data?.elements) {
+        const summary = {
+            page: data.page,
+            elementCount: data.elements.length,
+            elements: data.elements.slice(0, 30).map((e) => ({
+                id: e.id,
+                type: e.type,
+                label: e.label,
+            })),
+            intents: data.intents,
+        };
+        if (data.stability)
+            summary.stability = data.stability;
+        if (data.pendingDialog)
+            summary.pendingDialog = data.pendingDialog;
+        if (data.elements.length > 30) {
+            summary.note = `显示前30个元素，共${data.elements.length}个`;
+        }
+        return JSON.stringify(summary, null, 2);
+    }
+    if (toolName === 'get_page_content') {
+        let md = `# ${data.title || ''}\n\n`;
+        const sections = Array.isArray(data.sections) ? data.sections : [];
+        for (const s of sections) {
+            const stars = s.attention >= 0.7 ? '***'
+                : s.attention >= 0.4 ? '**'
+                    : '*';
+            md += `[${stars}] ${s.text}\n\n`;
+        }
+        if (sections.length === 0)
+            md += '(未提取到内容)\n';
+        return md;
+    }
+    return JSON.stringify(data);
+}
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    return text.slice(0, max) + `\n...(已截断，共${text.length}字符)`;
+}
+//# sourceMappingURL=content-budget.js.map

package/dist/agent/content-budget.js.map

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

package/dist/agent/conversation-manager.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Manages conversation history with compression to prevent token explosion.
+ * Keeps system prompt + recent messages intact, compresses older tool results.
+ */
+import type { ChatCompletionMessageParam } from 'openai/resources/chat/completions.js';
+export interface ConversationManagerOptions {
+    maxMessages?: number;
+    compressThreshold?: number;
+    keepRecent?: number;
+}
+export declare class ConversationManager {
+    private messages;
+    private maxMessages;
+    private compressThreshold;
+    private keepRecent;
+    constructor(options?: ConversationManagerOptions);
+    /**
+     * Initialize with system prompt and optional initial messages.
+     * - Merges any system-role messages into the main system prompt (avoids mid-conversation system messages)
+     * - Strips trailing orphaned tool_calls without matching tool results
+     */
+    init(systemPrompt: string, initialMessages: ChatCompletionMessageParam[], userTask: string): void;
+    /**
+     * Add a message to the conversation.
+     */
+    push(message: ChatCompletionMessageParam): void;
+    /**
+     * Get all messages for LLM consumption.
+     */
+    getMessages(): ChatCompletionMessageParam[];
+    /**
+     * Get current message count.
+     */
+    get length(): number;
+    /**
+     * Estimate total token count (~4 chars per token).
+     */
+    estimateTokens(): number;
+    /**
+     * Compress older messages to stay within bounds.
+     * Strategy: keep system prompt (index 0) + keepRecent most recent messages.
+     * Middle messages get compressed: tool results become one-line summaries,
+     * consecutive tool_call + tool_result pairs become grouped summaries.
+     */
+    private compress;
+    private compressMessages;
+}
+//# sourceMappingURL=conversation-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-manager.d.ts","sourceRoot":"","sources":["../../src/agent/conversation-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,CAAC,EAAE,0BAA0B;IAMhD;;;;OAIG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,0BAA0B,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAwCjG;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI;IAO/C;;OAEG;IACH,WAAW,IAAI,0BAA0B,EAAE;IAI3C;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,cAAc,IAAI,MAAM;IAgBxB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,gBAAgB;CAyCzB"}

package/dist/agent/conversation-manager.js

@@ -0,0 +1,157 @@
+const DEFAULT_MAX_MESSAGES = 40;
+const DEFAULT_COMPRESS_THRESHOLD = 30;
+const DEFAULT_KEEP_RECENT = 20;
+const CHARS_PER_TOKEN = 4; // rough heuristic
+export class ConversationManager {
+    messages = [];
+    maxMessages;
+    compressThreshold;
+    keepRecent;
+    constructor(options) {
+        this.maxMessages = options?.maxMessages ?? DEFAULT_MAX_MESSAGES;
+        this.compressThreshold = options?.compressThreshold ?? DEFAULT_COMPRESS_THRESHOLD;
+        this.keepRecent = options?.keepRecent ?? DEFAULT_KEEP_RECENT;
+    }
+    /**
+     * Initialize with system prompt and optional initial messages.
+     * - Merges any system-role messages into the main system prompt (avoids mid-conversation system messages)
+     * - Strips trailing orphaned tool_calls without matching tool results
+     */
+    init(systemPrompt, initialMessages, userTask) {
+        const extraSystemParts = [];
+        const filtered = [];
+        for (const msg of initialMessages) {
+            if (msg.role === 'system') {
+                if (typeof msg.content === 'string')
+                    extraSystemParts.push(msg.content);
+            }
+            else {
+                filtered.push(msg);
+            }
+        }
+        // Strip trailing assistant message with tool_calls if no matching tool results follow
+        while (filtered.length > 0) {
+            const last = filtered[filtered.length - 1];
+            if (last.role === 'assistant' && 'tool_calls' in last && last.tool_calls?.length) {
+                filtered.pop();
+            }
+            else if (last.role === 'tool') {
+                // Check if there's a matching assistant tool_calls before this tool message
+                const hasMatchingAssistant = filtered.some((m, idx) => idx < filtered.length - 1 && m.role === 'assistant' && 'tool_calls' in m);
+                if (!hasMatchingAssistant)
+                    filtered.pop();
+                else
+                    break;
+            }
+            else {
+                break;
+            }
+        }
+        const fullSystem = extraSystemParts.length > 0
+            ? systemPrompt + '\n\n' + extraSystemParts.join('\n\n')
+            : systemPrompt;
+        this.messages = [
+            { role: 'system', content: fullSystem },
+            ...filtered,
+            { role: 'user', content: userTask },
+        ];
+    }
+    /**
+     * Add a message to the conversation.
+     */
+    push(message) {
+        this.messages.push(message);
+        if (this.messages.length > this.compressThreshold) {
+            this.compress();
+        }
+    }
+    /**
+     * Get all messages for LLM consumption.
+     */
+    getMessages() {
+        return this.messages;
+    }
+    /**
+     * Get current message count.
+     */
+    get length() {
+        return this.messages.length;
+    }
+    /**
+     * Estimate total token count (~4 chars per token).
+     */
+    estimateTokens() {
+        let chars = 0;
+        for (const msg of this.messages) {
+            if (typeof msg.content === 'string') {
+                chars += msg.content.length;
+            }
+            else if (Array.isArray(msg.content)) {
+                for (const part of msg.content) {
+                    if ('text' in part && typeof part.text === 'string') {
+                        chars += part.text.length;
+                    }
+                }
+            }
+        }
+        return Math.ceil(chars / CHARS_PER_TOKEN);
+    }
+    /**
+     * Compress older messages to stay within bounds.
+     * Strategy: keep system prompt (index 0) + keepRecent most recent messages.
+     * Middle messages get compressed: tool results become one-line summaries,
+     * consecutive tool_call + tool_result pairs become grouped summaries.
+     */
+    compress() {
+        if (this.messages.length <= this.keepRecent + 1)
+            return;
+        const systemMsg = this.messages[0]; // always keep system prompt
+        const recentStart = this.messages.length - this.keepRecent;
+        const middleMessages = this.messages.slice(1, recentStart);
+        const recentMessages = this.messages.slice(recentStart);
+        // Compress middle messages into a summary
+        const summary = this.compressMessages(middleMessages);
+        this.messages = [
+            systemMsg,
+            { role: 'user', content: `[对话历史摘要] ${summary}` },
+            ...recentMessages,
+        ];
+    }
+    compressMessages(messages) {
+        const parts = [];
+        let i = 0;
+        while (i < messages.length) {
+            const msg = messages[i];
+            if (msg.role === 'assistant' && 'tool_calls' in msg && msg.tool_calls) {
+                // Group assistant tool_calls with their tool results
+                const toolNames = msg.tool_calls.map((tc) => tc.function?.name || 'unknown');
+                const thinking = typeof msg.content === 'string' && msg.content ? msg.content : '';
+                // Collect subsequent tool results
+                const results = [];
+                let j = i + 1;
+                while (j < messages.length && messages[j].role === 'tool') {
+                    const rawContent = messages[j].content;
+                    const content = typeof rawContent === 'string' ? rawContent : '';
+                    results.push(content.slice(0, 80));
+                    j++;
+                }
+                const thinkPart = thinking ? `思考:"${thinking.slice(0, 60)}" ` : '';
+                parts.push(`${thinkPart}调用 ${toolNames.join(',')} → ${results.join('; ').slice(0, 120)}`);
+                i = j;
+                continue;
+            }
+            if (msg.role === 'user' && typeof msg.content === 'string') {
+                parts.push(`用户: ${msg.content.slice(0, 80)}`);
+            }
+            else if (msg.role === 'system' && typeof msg.content === 'string') {
+                parts.push(`系统: ${msg.content.slice(0, 60)}`);
+            }
+            else if (msg.role === 'assistant' && typeof msg.content === 'string') {
+                parts.push(`助手: ${msg.content.slice(0, 80)}`);
+            }
+            i++;
+        }
+        return parts.join(' | ');
+    }
+}
+//# sourceMappingURL=conversation-manager.js.map

package/dist/agent/conversation-manager.js.map

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

package/dist/agent/error-recovery.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Smart error recovery strategies based on error type.
+ */
+export type RecoveryAction = {
+    type: 'retry';
+    delayMs: number;
+} | {
+    type: 'inject_hint';
+    message: string;
+} | {
+    type: 'abort';
+    reason: string;
+};
+interface ErrorContext {
+    errorCode?: string;
+    errorMessage: string;
+    toolName: string;
+    consecutiveErrors: number;
+}
+/**
+ * Determine recovery action based on error context.
+ */
+export declare function determineRecovery(ctx: ErrorContext): RecoveryAction;
+/**
+ * Extract errorCode from MCP tool result text.
+ */
+export declare function extractErrorCode(rawText: string): string | undefined;
+export {};
+//# sourceMappingURL=error-recovery.d.ts.map

package/dist/agent/error-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-recovery.d.ts","sourceRoot":"","sources":["../../src/agent/error-recovery.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,UAAU,YAAY;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,cAAc,CAqDnE;AAQD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOpE"}

package/dist/agent/error-recovery.js

@@ -0,0 +1,72 @@
+/**
+ * Smart error recovery strategies based on error type.
+ */
+const MAX_RETRY_DELAY = 16000;
+/**
+ * Determine recovery action based on error context.
+ */
+export function determineRecovery(ctx) {
+    const { errorCode, errorMessage, consecutiveErrors } = ctx;
+    // Fatal errors — abort immediately
+    if (errorCode === 'PAGE_CRASHED' || errorCode === 'SESSION_NOT_FOUND') {
+        return { type: 'abort', reason: `不可恢复的错误: ${errorMessage}` };
+    }
+    // Element not found — hint to refresh
+    if (errorCode === 'ELEMENT_NOT_FOUND') {
+        return {
+            type: 'inject_hint',
+            message: '元素未找到，ID 可能已过期。请调用 get_page_info 刷新元素列表后重试。',
+        };
+    }
+    // Navigation timeout — exponential backoff + hint
+    if (errorCode === 'NAVIGATION_TIMEOUT') {
+        const delay = Math.min(2000 * Math.pow(2, consecutiveErrors - 1), MAX_RETRY_DELAY);
+        if (consecutiveErrors >= 3) {
+            return {
+                type: 'inject_hint',
+                message: '导航多次超时。页面可能已部分加载，请尝试 wait_for_stable 或直接用 get_page_info 检查当前页面状态。',
+            };
+        }
+        return { type: 'retry', delayMs: delay };
+    }
+    // Execution error — hint
+    if (errorCode === 'EXECUTION_ERROR') {
+        return {
+            type: 'inject_hint',
+            message: 'JavaScript 执行失败。请检查脚本语法，确保使用 return 返回数据。',
+        };
+    }
+    // Invalid parameter — hint
+    if (errorCode === 'INVALID_PARAMETER') {
+        return {
+            type: 'inject_hint',
+            message: `参数错误: ${errorMessage}。请检查参数后重试。`,
+        };
+    }
+    // LLM API errors — exponential backoff
+    if (isLLMError(errorMessage)) {
+        const delay = Math.min(2000 * Math.pow(2, consecutiveErrors - 1), MAX_RETRY_DELAY);
+        return { type: 'retry', delayMs: delay };
+    }
+    // Default: exponential backoff for unknown errors
+    const delay = Math.min(2000 * Math.pow(2, consecutiveErrors - 1), MAX_RETRY_DELAY);
+    return { type: 'retry', delayMs: delay };
+}
+function isLLMError(message) {
+    const patterns = ['ECONNREFUSED', 'ETIMEDOUT', 'rate limit', '429', '500', '502', '503'];
+    const lower = message.toLowerCase();
+    return patterns.some(p => lower.includes(p.toLowerCase()));
+}
+/**
+ * Extract errorCode from MCP tool result text.
+ */
+export function extractErrorCode(rawText) {
+    try {
+        const data = JSON.parse(rawText);
+        return data.errorCode || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=error-recovery.js.map

package/dist/agent/error-recovery.js.map

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

package/dist/agent/page-state-cache.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Caches page element state per session to compute diffs between get_page_info calls.
+ * When the page hasn't changed much, returns only added/removed/changed elements.
+ */
+export interface PageDiff {
+    isNewPage: boolean;
+    added: any[];
+    removed: string[];
+    changed: any[];
+    unchangedCount: number;
+}
+export declare class PageStateCache {
+    private snapshots;
+    /**
+     * Update cache and compute diff for a session.
+     * Returns null if this is the first call or a new page (caller should use full list).
+     */
+    update(sessionId: string, elements: any[], url: string): PageDiff;
+    clear(sessionId: string): void;
+    private hasChanged;
+}
+//# sourceMappingURL=page-state-cache.d.ts.map

package/dist/agent/page-state-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-state-cache.d.ts","sourceRoot":"","sources":["../../src/agent/page-state-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,GAAG,EAAE,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AASD,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAmC;IAEpD;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ;IAuDjE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,UAAU;CAQnB"}

package/dist/agent/page-state-cache.js

@@ -0,0 +1,71 @@
+/**
+ * Caches page element state per session to compute diffs between get_page_info calls.
+ * When the page hasn't changed much, returns only added/removed/changed elements.
+ */
+const FULL_REFRESH_THRESHOLD = 0.5; // >50% change → return full list
+export class PageStateCache {
+    snapshots = new Map();
+    /**
+     * Update cache and compute diff for a session.
+     * Returns null if this is the first call or a new page (caller should use full list).
+     */
+    update(sessionId, elements, url) {
+        const prev = this.snapshots.get(sessionId);
+        const currentMap = new Map();
+        for (const el of elements) {
+            if (el?.id)
+                currentMap.set(el.id, el);
+        }
+        // Store new snapshot
+        this.snapshots.set(sessionId, { url, elementMap: currentMap });
+        // No previous snapshot → new page
+        if (!prev) {
+            return { isNewPage: true, added: elements, removed: [], changed: [], unchangedCount: 0 };
+        }
+        // URL changed → new page
+        if (prev.url !== url) {
+            return { isNewPage: true, added: elements, removed: [], changed: [], unchangedCount: 0 };
+        }
+        // Compute diff
+        const added = [];
+        const changed = [];
+        const removed = [];
+        let unchangedCount = 0;
+        // Find added and changed
+        for (const [id, el] of currentMap) {
+            const prevEl = prev.elementMap.get(id);
+            if (!prevEl) {
+                added.push(el);
+            }
+            else if (this.hasChanged(prevEl, el)) {
+                changed.push(el);
+            }
+            else {
+                unchangedCount++;
+            }
+        }
+        // Find removed
+        for (const id of prev.elementMap.keys()) {
+            if (!currentMap.has(id)) {
+                removed.push(id);
+            }
+        }
+        // If too many changes, treat as new page
+        const totalPrev = prev.elementMap.size;
+        const changedCount = added.length + removed.length + changed.length;
+        if (totalPrev > 0 && changedCount / totalPrev > FULL_REFRESH_THRESHOLD) {
+            return { isNewPage: true, added: elements, removed: [], changed: [], unchangedCount: 0 };
+        }
+        return { isNewPage: false, added, removed, changed, unchangedCount };
+    }
+    clear(sessionId) {
+        this.snapshots.delete(sessionId);
+    }
+    hasChanged(prev, curr) {
+        // Compare key properties that matter for interaction
+        return (prev.label !== curr.label ||
+            prev.type !== curr.type ||
+            JSON.stringify(prev.state) !== JSON.stringify(curr.state));
+    }
+}
+//# sourceMappingURL=page-state-cache.js.map

package/dist/agent/page-state-cache.js.map

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

package/dist/agent/progress-estimator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Heuristic progress estimator based on tool call patterns.
+ * Maps tool usage sequences to approximate task completion phases.
+ */
+export interface ProgressInfo {
+    phase: 'navigating' | 'observing' | 'acting' | 'extracting' | 'completing';
+    percent: number;
+    stepsRemaining: number | null;
+}
+export declare class ProgressEstimator {
+    private history;
+    private maxIterations;
+    constructor(maxIterations?: number);
+    record(toolName: string): ProgressInfo;
+    estimate(): ProgressInfo;
+}
+//# sourceMappingURL=progress-estimator.d.ts.map

package/dist/agent/progress-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-estimator.d.ts","sourceRoot":"","sources":["../../src/agent/progress-estimator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,CAAC;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AA6BD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,aAAa,CAAS;gBAElB,aAAa,SAAK;IAI9B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAKtC,QAAQ,IAAI,YAAY;CAiCzB"}