autokap 1.1.3 → 1.1.5

package/dist/agent-action-recovery.js

@@ -1,370 +0,0 @@
-/**
- * Action recovery, guard inference, and login detection utilities for the capture agent.
- * Extracted from agent.ts — these are pure functions with no closure dependencies.
- */
-import { urlsRoughlyMatch, buildClickGuardSignature, } from './agent-url-utils.js';
-// -- Constants --
-export const META_ACTIONS = new Set(['note', 'begin_subgoal', 'focus', 'capture', 'analyze_screenshot']);
-export const BOOTSTRAP_ACTIONS = new Set(['wait']);
-const REPEAT_GUARD_ACTIONS = new Set([
-    'tap',
-    'press_key',
-]);
-export const REPLAYABLE_ACTIONS = [
-    'navigate_to', 'tap', 'type', 'scroll',
-    'press_key', 'wait',
-];
-const LOGIN_URL_RE = /\b(login|log-in|signin|sign-in|auth|session|connexion|connect)\b/i;
-const LOGIN_FIELD_RE = /\b(password|mot de passe|passcode|otp|verification.?code)\b/i;
-const LOGIN_CLICK_RE = /\b(login|log-in|signin|sign-in|auth|session|connexion|connect|password|mot de passe|passcode|otp|verification.?code|email|e-mail)\b/i;
-const AUTH_SUBMIT_RE = /\b(continue|next|submit|verify|unlock|access|enter|continuer|suivant|soumettre|verifier|v[eé]rifier|acc[eé]der|entrer)\b/i;
-const HARD_GIVE_UP_RE = /\b(5xx|500\b|404\b|page not found|not found|http error|server error|js crash|javascript crash|browser crashed|connection refused|dns|net::|ssl|certificate|blank page|white page|no content|infinite spinner)\b/i;
-const RECOVERABLE_GIVE_UP_RE = /\b(verification|ready_to_capture|dialog|modal|overlay|gallery|editor|route|navigation|assistant|conversation|wrong page|duplicate capture|capture target)\b/i;
-// -- Internal helpers --
-export function isNoEffectAction(action) {
-    return (action.success === false
-        || action.stateChanged === false
-        || action.outcome === 'No visible state change detected after the action.');
-}
-export function isBootstrapStabilizationAction(action) {
-    if (BOOTSTRAP_ACTIONS.has(action.action))
-        return true;
-    return action.action === 'press_key' && String(action.params.key || '').toLowerCase() === 'escape';
-}
-export function hasMeaningfulBrowserAction(actionHistory) {
-    return actionHistory.some((action) => !META_ACTIONS.has(action.action) && !isBootstrapStabilizationAction(action));
-}
-export function buildRecoveryActionSignature(action) {
-    const parts = [action.action];
-    if (typeof action.params.nodeId === 'string' && action.params.nodeId.trim()) {
-        parts.push(`nodeId:${action.params.nodeId.trim()}`);
-    }
-    else if (typeof action.params.selector === 'string' && action.params.selector.trim()) {
-        parts.push(`selector:${action.params.selector.trim()}`);
-    }
-    else if (action.params.index !== undefined) {
-        parts.push(`index:${String(action.params.index)}`);
-    }
-    else if (typeof action.params.url === 'string' && action.params.url.trim()) {
-        parts.push(`url:${action.params.url.trim().slice(0, 160)}`);
-    }
-    else if (action.params.x !== undefined && action.params.y !== undefined) {
-        parts.push(`xy:${String(action.params.x)},${String(action.params.y)}`);
-    }
-    if (typeof action.params.text === 'string' && action.params.text.trim()) {
-        parts.push(`text:${action.params.text.trim().slice(0, 80)}`);
-    }
-    if (typeof action.params.key === 'string' && action.params.key.trim()) {
-        parts.push(`key:${action.params.key.trim()}`);
-    }
-    return parts.join('|');
-}
-function getMeaningfulBrowserActions(actionHistory) {
-    return actionHistory.filter(action => !META_ACTIONS.has(action.action) && !isBootstrapStabilizationAction(action));
-}
-function countDistinctActionSignatures(actionHistory) {
-    return new Set(getMeaningfulBrowserActions(actionHistory).map(action => buildRecoveryActionSignature(action))).size;
-}
-// -- Login detection --
-export function isExplicitLoginAction(action) {
-    if (action.action === 'navigate_to' && typeof action.params.url === 'string' && LOGIN_URL_RE.test(action.params.url)) {
-        return true;
-    }
-    if ((action.action === 'type_text' || action.action === 'type') && typeof action.params.selector === 'string' && LOGIN_FIELD_RE.test(action.params.selector)) {
-        return true;
-    }
-    if ((action.action === 'type_text' || action.action === 'type') && typeof action.params.text === 'string' && /\{\{credential\./i.test(action.params.text)) {
-        return true;
-    }
-    if (action.action === 'click' || action.action === 'tap') {
-        const haystack = [
-            action.params.selector,
-            action.params.elementLabel,
-            action.params.href,
-            action.params.nodeId,
-        ]
-            .filter((value) => typeof value === 'string')
-            .join(' ');
-        if (LOGIN_CLICK_RE.test(haystack)) {
-            return true;
-        }
-    }
-    return false;
-}
-export function hasRecentExplicitLoginAction(previousActions) {
-    return previousActions.slice(-3).some(isExplicitLoginAction);
-}
-export function isLoginAction(action, previousActions = []) {
-    if (isExplicitLoginAction(action)) {
-        return true;
-    }
-    if (action.action === 'click' || action.action === 'tap') {
-        const haystack = [
-            action.params.selector,
-            action.params.elementLabel,
-            action.params.href,
-            action.params.nodeId,
-        ]
-            .filter((value) => typeof value === 'string')
-            .join(' ');
-        if (AUTH_SUBMIT_RE.test(haystack) && hasRecentExplicitLoginAction(previousActions)) {
-            return true;
-        }
-    }
-    if (action.action === 'press_key'
-        && action.params.key === 'Enter'
-        && hasRecentExplicitLoginAction(previousActions)) {
-        return true;
-    }
-    return false;
-}
-export function compactReplayActions(recordedActions, params = {}) {
-    let replayable = recordedActions.filter(a => REPLAYABLE_ACTIONS.includes(a.action));
-    if (params.ignoreRecordedViewport) {
-        replayable = replayable.filter((action) => action.action !== 'resize_viewport');
-    }
-    if (params.isAuthenticated) {
-        const authAwareReplayable = replayable;
-        replayable = authAwareReplayable.filter((action, index) => !isLoginAction(action, authAwareReplayable.slice(0, index)));
-    }
-    let startIndex = 0;
-    while (startIndex < replayable.length) {
-        const action = replayable[startIndex];
-        if (action.action === 'wait') {
-            startIndex += 1;
-            continue;
-        }
-        if (action.action === 'dismiss_overlays') {
-            startIndex += 1;
-            continue;
-        }
-        if (action.action === 'resize_viewport'
-            && params.currentViewport
-            && Number(action.params.width) === params.currentViewport.width
-            && Number(action.params.height) === params.currentViewport.height) {
-            startIndex += 1;
-            continue;
-        }
-        if (action.action === 'navigate_to'
-            && typeof action.params.url === 'string'
-            && (urlsRoughlyMatch(action.params.url, params.currentUrl)
-                || urlsRoughlyMatch(action.params.url, params.targetUrl))) {
-            startIndex += 1;
-            continue;
-        }
-        break;
-    }
-    return replayable.slice(startIndex);
-}
-// -- Recovery --
-export function countRecentNoEffectActions(actionHistory) {
-    let count = 0;
-    for (let index = actionHistory.length - 1; index >= 0; index -= 1) {
-        const action = actionHistory[index];
-        if (META_ACTIONS.has(action.action))
-            continue;
-        if (isNoEffectAction(action)) {
-            count += 1;
-            continue;
-        }
-        break;
-    }
-    return count;
-}
-export function shouldTriggerRecovery(actionHistory) {
-    const browserActions = actionHistory.filter(a => !META_ACTIONS.has(a.action));
-    if (browserActions.length < 2)
-        return false;
-    if (!hasMeaningfulBrowserAction(browserActions))
-        return false;
-    const last = browserActions[browserActions.length - 1];
-    const previous = browserActions[browserActions.length - 2];
-    const sameFailureSignature = !last.success
-        && !previous.success
-        && buildRecoveryActionSignature(last) === buildRecoveryActionSignature(previous)
-        && String(last.error || '').slice(0, 120) === String(previous.error || '').slice(0, 120);
-    if (browserActions.length >= 4) {
-        const [a, b, c, d] = browserActions.slice(-4);
-        const sigA = buildRecoveryActionSignature(a);
-        const sigB = buildRecoveryActionSignature(b);
-        const sigC = buildRecoveryActionSignature(c);
-        const sigD = buildRecoveryActionSignature(d);
-        if ([a, b, c, d].every(isNoEffectAction)
-            && sigA === sigC
-            && sigB === sigD
-            && sigA !== sigB) {
-            return true;
-        }
-    }
-    return sameFailureSignature || countRecentNoEffectActions(actionHistory) >= 2;
-}
-// -- Guard inference --
-export function inferPrematureGiveUpCorrection(params) {
-    const reason = params.reason.trim();
-    const lastVerificationFailure = params.lastVerificationFailure?.trim();
-    if (HARD_GIVE_UP_RE.test(reason) || (lastVerificationFailure && HARD_GIVE_UP_RE.test(lastVerificationFailure))) {
-        return null;
-    }
-    const recentCaptureFailures = params.actionHistory
-        .filter(a => a.action === 'ready_to_capture' && !a.success && a.error)
-        .slice(-6);
-    if (recentCaptureFailures.length >= 3) {
-        const distinctReasons = new Set(recentCaptureFailures.map(a => (a.error || '').replace(/^Verification failed:\s*/i, '').trim().slice(0, 120)));
-        if (distinctReasons.size >= 2 && distinctReasons.size <= 3) {
-            return null;
-        }
-    }
-    if (countRecentNoEffectActions(params.actionHistory) >= 8) {
-        return null;
-    }
-    if (lastVerificationFailure && RECOVERABLE_GIVE_UP_RE.test(lastVerificationFailure)) {
-        return `Do not give up yet. The last verification failure is still recoverable: ${lastVerificationFailure}. Try a materially different navigation or repair step first.`;
-    }
-    const hasTriedSearch = params.actionHistory.some(a => a.action === 'search_text');
-    const hasTriedNavigate = params.actionHistory.some(a => a.action === 'navigate_to');
-    if (!hasTriedSearch && !hasTriedNavigate) {
-        return 'Do not give up yet. You have not tried search_text or navigate_to. Use search_text to find the element by text, or navigate_to to go directly to the target URL.';
-    }
-    const meaningfulActions = getMeaningfulBrowserActions(params.actionHistory);
-    const distinctActionCount = countDistinctActionSignatures(params.actionHistory);
-    const hasTriedEnoughStrategies = meaningfulActions.length >= 4 && distinctActionCount >= 3;
-    const nearingBudget = params.iteration >= Math.max(6, params.maxIterations - 2);
-    if (!hasTriedEnoughStrategies && !nearingBudget) {
-        return 'Do not give up yet. You have not tried enough materially different actions. Change strategy before giving up.';
-    }
-    if (/click.*no effect|no.*effect.*click|clicking.*no/i.test(reason) && !hasTriedNavigate) {
-        return 'Clicking has no effect, but you have not tried navigate_to. Use navigate_to to go directly to the target URL instead of clicking.';
-    }
-    if (RECOVERABLE_GIVE_UP_RE.test(reason) && !nearingBudget) {
-        return 'Do not give up yet. The current issue still looks recoverable. Try a different navigation, search, or repair approach first.';
-    }
-    return null;
-}
-function normalizeSearchLoopQuery(value) {
-    return typeof value === 'string'
-        ? value.trim().toLowerCase().replace(/\s+/g, ' ')
-        : '';
-}
-function getTrailingSearchScrollActions(actionHistory) {
-    const trailing = [];
-    for (let index = actionHistory.length - 1; index >= 0; index -= 1) {
-        const action = actionHistory[index];
-        if (META_ACTIONS.has(action.action))
-            continue;
-        if (action.action !== 'search_text' && action.action !== 'scroll')
-            break;
-        trailing.unshift(action);
-    }
-    return trailing;
-}
-export function inferSearchScrollLoopGuard(params) {
-    if (params.action !== 'search_text' && params.action !== 'scroll')
-        return null;
-    const candidate = {
-        iteration: 0,
-        action: params.action,
-        params: params.args,
-        success: params.action === 'scroll',
-        stateChanged: params.action === 'scroll',
-    };
-    const trailingLoopActions = [...getTrailingSearchScrollActions(params.actionHistory), candidate];
-    if (trailingLoopActions.length < 4)
-        return null;
-    if (!trailingLoopActions.every((action) => action.action === 'search_text' || action.action === 'scroll')) {
-        return null;
-    }
-    const repeatedQueries = new Map();
-    for (const action of trailingLoopActions) {
-        if (action.action !== 'search_text')
-            continue;
-        const query = normalizeSearchLoopQuery(action.params.query);
-        if (!query)
-            continue;
-        repeatedQueries.set(query, (repeatedQueries.get(query) ?? 0) + 1);
-    }
-    const repeatedQueryEntry = Array.from(repeatedQueries.entries())
-        .sort((a, b) => b[1] - a[1])[0];
-    if (!repeatedQueryEntry || repeatedQueryEntry[1] < 2)
-        return null;
-    const [repeatedQuery, repeatedCount] = repeatedQueryEntry;
-    if (params.action === 'search_text') {
-        const candidateQuery = normalizeSearchLoopQuery(params.args.query);
-        if (candidateQuery !== repeatedQuery || repeatedCount < 3)
-            return null;
-        return `BLOCKED: You have already searched for "${repeatedQuery}" repeatedly and only scrolled around without interacting. Stop looping on the same query. Try a different search term, navigate_to the target page, or interact with a concrete result instead.`;
-    }
-    return `BLOCKED: You are stuck in a search_text/scroll loop around "${repeatedQuery}" without acting on a result. Stop scrolling blindly. Try a different query, navigate_to the correct page, or interact with a specific matching control.`;
-}
-export function inferRepeatedActionGuard(params) {
-    if (params.action === 'navigate_to' && typeof params.args.url === 'string' && params.currentUrl) {
-        const targetUrl = params.args.url.replace(/\/$/, '');
-        const recentNavigations = params.actionHistory
-            .filter(a => !META_ACTIONS.has(a.action) && a.success !== false)
-            .slice(-5);
-        if (urlsRoughlyMatch(params.currentUrl, targetUrl)) {
-            return 'WARNING: You are already on this URL. No navigation needed. Focus on interacting with the current page instead.';
-        }
-        const recentAllActions = params.actionHistory
-            .filter(a => !META_ACTIONS.has(a.action))
-            .slice(-4);
-        const hasRecentNoEffect = recentAllActions.some(a => isNoEffectAction(a));
-        if (!hasRecentNoEffect) {
-            const recentUrls = recentNavigations
-                .filter(a => typeof a.params.href === 'string' || typeof a.params.url === 'string')
-                .slice(-3)
-                .map(a => String(a.params.href || a.params.url || '').replace(/\/$/, ''));
-            const wasRecentlyOnTarget = recentUrls.some(url => urlsRoughlyMatch(url, targetUrl));
-            if (wasRecentlyOnTarget && !urlsRoughlyMatch(params.currentUrl, targetUrl)) {
-                return `WARNING: You just navigated away from ${targetUrl} — going back suggests you are confused about the goal. Re-read the <task>/<goal> and <variant_manifest> carefully. If you need a modal, open it from the current page instead of navigating back.`;
-            }
-        }
-    }
-    if (!REPEAT_GUARD_ACTIONS.has(params.action))
-        return null;
-    const recentBrowserActions = params.actionHistory
-        .filter(action => !META_ACTIONS.has(action.action))
-        .slice(-2);
-    if (recentBrowserActions.length < 2)
-        return null;
-    const candidateSignature = buildRecoveryActionSignature({
-        iteration: 0,
-        action: params.action,
-        params: params.args,
-        success: false,
-    });
-    const candidateClickSignature = params.action === 'click'
-        ? buildClickGuardSignature(params.args, params.currentUrl)
-        : null;
-    const repeatedNoEffect = recentBrowserActions.every(action => isNoEffectAction(action)
-        && (candidateClickSignature && action.action === 'click'
-            ? buildClickGuardSignature(action.params, params.currentUrl) === candidateClickSignature
-            : buildRecoveryActionSignature(action) === candidateSignature));
-    if (repeatedNoEffect) {
-        return 'BLOCKED: The previous attempts on this same target had no effect. Try a different control, search_text, scrolling, or a repair step instead of repeating it.';
-    }
-    const recentInteractions = params.actionHistory
-        .filter(action => REPEAT_GUARD_ACTIONS.has(action.action)
-        && !META_ACTIONS.has(action.action)
-        && !(typeof action.error === 'string' && action.error.startsWith('BLOCKED:')))
-        .slice(-4);
-    if (recentInteractions.length >= 4 && recentInteractions.every(a => isNoEffectAction(a))) {
-        return 'BLOCKED: The last 4 interaction actions all failed or had no visible effect. You are stuck. Step back and reconsider: verify the current URL, check if you are on the right page, try navigate_to to reach the correct page, or call give_up if this capture is impossible.';
-    }
-    if (params.action === 'click') {
-        const sig = buildClickGuardSignature(params.args, params.currentUrl);
-        if (sig) {
-            const candidateTarget = String((typeof params.args.elementLabel === 'string' && params.args.elementLabel.trim())
-                ? params.args.elementLabel
-                : params.args.selector ?? params.args.index ?? 'this target');
-            const recentClicks = params.actionHistory
-                .filter(a => a.action === 'click' && !META_ACTIONS.has(a.action))
-                .slice(-6);
-            const sameTargetCount = recentClicks.filter(a => buildClickGuardSignature(a.params, params.currentUrl) === sig).length;
-            if (sameTargetCount >= 3) {
-                return `BLOCKED: You have clicked "${candidateTarget}" ${sameTargetCount} times recently without progress. This is likely a toggle/multi-select control. Press Escape to close any open dropdown, then look for a DIFFERENT button (e.g., an edit/settings icon) to achieve your goal.`;
-            }
-        }
-    }
-    return null;
-}
-//# sourceMappingURL=agent-action-recovery.js.map

package/dist/agent-message-utils.d.ts

@@ -1,21 +0,0 @@
-/**
- * Message compression and conversation history utilities for the capture agent.
- * Extracted from agent.ts — these are pure functions with no closure dependencies.
- */
-import type { ChatCompletionMessageParam } from 'openai/resources/chat/completions';
-/**
- * Remove old screenshots from the conversation history, keeping only the most recent ones.
- * Replaces image_url parts with a compact text placeholder.
- */
-export declare function compressOldScreenshots(messages: ChatCompletionMessageParam[], keepRecentImages?: number): void;
-/**
- * Strip <page_dom>...</page_dom> blocks from old user messages to reduce token count.
- * Keeps the DOM in the most recent `keepRecentWithDom` user messages intact.
- */
-export declare function compressOldDomBlocks(messages: ChatCompletionMessageParam[], keepRecentWithDom?: number, preservedPrefixMessages?: number): void;
-/**
- * Trim the conversation thread to avoid context window overflow.
- * Always preserves the first `preservedPrefixMessages` entries, then the last maxMessages messages.
- * Also compresses old screenshots and DOM blocks to save tokens.
- */
-export declare function trimConversationHistory(messages: ChatCompletionMessageParam[], maxMessages?: number, preservedPrefixMessages?: number): void;

package/dist/agent-message-utils.js

@@ -1,77 +0,0 @@
-/**
- * Message compression and conversation history utilities for the capture agent.
- * Extracted from agent.ts — these are pure functions with no closure dependencies.
- */
-/**
- * Remove old screenshots from the conversation history, keeping only the most recent ones.
- * Replaces image_url parts with a compact text placeholder.
- */
-export function compressOldScreenshots(messages, keepRecentImages = 3) {
-    let imageCount = 0;
-    for (let i = messages.length - 1; i >= 1; i--) {
-        const msg = messages[i];
-        if (msg.role !== 'user' || !Array.isArray(msg.content))
-            continue;
-        const content = msg.content;
-        const hasImage = content.some(p => p.type === 'image_url');
-        if (!hasImage)
-            continue;
-        imageCount++;
-        if (imageCount <= keepRecentImages)
-            continue;
-        msg.content = content.map(p => p.type === 'image_url'
-            ? { type: 'text', text: '[screenshot removed — older context]' }
-            : p);
-    }
-}
-/**
- * Strip <page_dom>...</page_dom> blocks from old user messages to reduce token count.
- * Keeps the DOM in the most recent `keepRecentWithDom` user messages intact.
- */
-export function compressOldDomBlocks(messages, keepRecentWithDom = 6, preservedPrefixMessages = 1) {
-    const PAGE_DOM_RE = /<page_dom>[\s\S]*?<\/page_dom>/g;
-    const PLACEHOLDER = '<page_dom>[older context — see current iteration for latest DOM]</page_dom>';
-    let domMessageCount = 0;
-    for (let i = messages.length - 1; i >= preservedPrefixMessages; i--) {
-        const msg = messages[i];
-        if (msg.role !== 'user')
-            continue;
-        const contentArr = Array.isArray(msg.content) ? msg.content : null;
-        const hasDom = contentArr
-            ? contentArr.some(p => typeof p === 'object' && 'text' in p && typeof p.text === 'string' && PAGE_DOM_RE.test(p.text))
-            : typeof msg.content === 'string' && PAGE_DOM_RE.test(msg.content);
-        PAGE_DOM_RE.lastIndex = 0;
-        if (!hasDom)
-            continue;
-        domMessageCount++;
-        if (domMessageCount <= keepRecentWithDom)
-            continue;
-        if (contentArr) {
-            for (const part of contentArr) {
-                if (typeof part === 'object' && 'text' in part && typeof part.text === 'string') {
-                    PAGE_DOM_RE.lastIndex = 0;
-                    part.text = part.text.replace(PAGE_DOM_RE, PLACEHOLDER);
-                }
-            }
-        }
-        else if (typeof msg.content === 'string') {
-            PAGE_DOM_RE.lastIndex = 0;
-            msg.content = msg.content.replace(PAGE_DOM_RE, PLACEHOLDER);
-        }
-    }
-}
-/**
- * Trim the conversation thread to avoid context window overflow.
- * Always preserves the first `preservedPrefixMessages` entries, then the last maxMessages messages.
- * Also compresses old screenshots and DOM blocks to save tokens.
- */
-export function trimConversationHistory(messages, maxMessages = 48, preservedPrefixMessages = 1) {
-    compressOldScreenshots(messages, 1);
-    compressOldDomBlocks(messages, 6, preservedPrefixMessages);
-    if (messages.length <= maxMessages + preservedPrefixMessages)
-        return;
-    const preservedPrefix = messages.slice(0, preservedPrefixMessages);
-    const recent = messages.slice(-(maxMessages));
-    messages.splice(0, messages.length, ...preservedPrefix, ...recent);
-}
-//# sourceMappingURL=agent-message-utils.js.map

package/dist/agent-url-utils.d.ts

@@ -1,30 +0,0 @@
-/**
- * URL matching, click guard, and verification cache utilities for the capture agent.
- * Extracted from agent.ts — these are pure functions with no closure dependencies.
- */
-import type { VerificationResult, VariantCaptureManifest } from './types.js';
-import type { BrowserVerificationBundle } from './browser.js';
-export declare function urlsRoughlyMatch(expectedUrl: string | undefined, currentUrl: string | undefined): boolean;
-export declare function normalizeStrictComparableUrl(value: string): string;
-export declare function urlsStrictlyMatch(expectedUrl: string | undefined, currentUrl: string | undefined): boolean;
-export declare function normalizeGuardPageUrl(value: unknown): string;
-export declare function buildClickGuardAnchor(params: Record<string, unknown>): string | null;
-export declare function buildClickGuardSignature(params: Record<string, unknown>, currentUrl?: string): string | null;
-export declare function buildVerificationCacheKey(config: {
-    prompt: string;
-    variantManifest?: VariantCaptureManifest | null;
-    currentLang?: string | null;
-    currentTheme?: string | null;
-    captureCursor?: {
-        targetId?: string;
-    } | null;
-}, bundle: BrowserVerificationBundle): string;
-export declare function cloneVerificationResult(result: VerificationResult): VerificationResult;
-export declare function summarizeVariantManifestForPlanner(manifest: VariantCaptureManifest | undefined): string;
-export declare function buildPageStateFingerprint(pageState: {
-    simplifiedDOM?: string | null;
-    interactiveElements: Array<unknown>;
-    scrollInfo?: {
-        scrollY?: number;
-    } | null;
-}, currentUrl: string): string;

package/dist/agent-url-utils.js

@@ -1,138 +0,0 @@
-/**
- * URL matching, click guard, and verification cache utilities for the capture agent.
- * Extracted from agent.ts — these are pure functions with no closure dependencies.
- */
-import { createHash } from 'crypto';
-// -- URL matching --
-export function urlsRoughlyMatch(expectedUrl, currentUrl) {
-    if (!expectedUrl || !currentUrl)
-        return false;
-    try {
-        const expected = new URL(expectedUrl);
-        const current = new URL(currentUrl);
-        if (expected.origin !== current.origin)
-            return false;
-        const expectedPath = expected.pathname || '/';
-        const currentPath = current.pathname || '/';
-        if (currentPath === expectedPath)
-            return true;
-        if (currentPath.startsWith(expectedPath) && (expectedPath.endsWith('/') || currentPath[expectedPath.length] === '/')) {
-            return true;
-        }
-        return false;
-    }
-    catch {
-        return currentUrl === expectedUrl;
-    }
-}
-export function normalizeStrictComparableUrl(value) {
-    const parsed = new URL(value);
-    const normalizedPath = parsed.pathname.replace(/\/+$/, '') || '/';
-    const searchEntries = Array.from(parsed.searchParams.entries()).sort(([aKey, aValue], [bKey, bValue]) => {
-        if (aKey === bKey)
-            return aValue.localeCompare(bValue);
-        return aKey.localeCompare(bKey);
-    });
-    const normalizedSearch = searchEntries.length > 0
-        ? `?${new URLSearchParams(searchEntries).toString()}`
-        : '';
-    return `${parsed.origin}${normalizedPath}${normalizedSearch}`;
-}
-export function urlsStrictlyMatch(expectedUrl, currentUrl) {
-    if (!expectedUrl || !currentUrl)
-        return false;
-    try {
-        return normalizeStrictComparableUrl(expectedUrl) === normalizeStrictComparableUrl(currentUrl);
-    }
-    catch {
-        return currentUrl.trim().replace(/\/+$/, '') === expectedUrl.trim().replace(/\/+$/, '');
-    }
-}
-export function normalizeGuardPageUrl(value) {
-    if (typeof value !== 'string' || value.trim().length === 0)
-        return '';
-    try {
-        const parsed = new URL(value);
-        return `${parsed.origin}${parsed.pathname}`.replace(/\/$/, '') || parsed.origin;
-    }
-    catch {
-        return value.trim().replace(/\/$/, '');
-    }
-}
-// -- Click guards --
-export function buildClickGuardAnchor(params) {
-    const parts = [];
-    if (typeof params.selector === 'string' && params.selector.trim()) {
-        parts.push(`selector:${params.selector.trim()}`);
-    }
-    if (params.index !== undefined) {
-        parts.push(`index:${String(params.index)}`);
-    }
-    if (typeof params.elementLabel === 'string' && params.elementLabel.trim()) {
-        parts.push(`label:${params.elementLabel.trim().toLowerCase()}`);
-    }
-    if (typeof params.href === 'string' && params.href.trim()) {
-        parts.push(`href:${normalizeGuardPageUrl(params.href)}`);
-    }
-    return parts.length > 0 ? parts.join('|') : null;
-}
-export function buildClickGuardSignature(params, currentUrl) {
-    const anchor = buildClickGuardAnchor(params);
-    if (!anchor)
-        return null;
-    const pageKey = normalizeGuardPageUrl(params.preActionUrl ?? params.postActionUrl ?? currentUrl);
-    return `click|${pageKey}|${anchor}`;
-}
-// -- Verification cache --
-export function buildVerificationCacheKey(config, bundle) {
-    const promptHash = createHash('sha1').update(config.prompt).digest('hex').slice(0, 12);
-    return [
-        bundle.coherenceKey,
-        config.variantManifest?.currentPageId ?? 'main',
-        config.currentLang ?? 'default-lang',
-        config.currentTheme ?? 'default-theme',
-        config.captureCursor?.targetId ?? 'default-target',
-        promptHash,
-    ].join('|');
-}
-export function cloneVerificationResult(result) {
-    return {
-        ...result,
-        usage: result.usage.map(u => ({ ...u })),
-    };
-}
-export function summarizeVariantManifestForPlanner(manifest) {
-    if (!manifest)
-        return '';
-    const parts = [
-        `expected=${manifest.expectedPageIds.join(',') || 'main'}`,
-        `current=${manifest.currentPageId ?? 'main'}`,
-        manifest.currentPageIdentity ? `identity=${manifest.currentPageIdentity.summary}` : '',
-        `completed=${manifest.completedPages.join(',') || 'none'}`,
-        `remaining=${manifest.remainingPages.join(',') || 'none'}`,
-        manifest.lastCheckpointId ? `checkpoint=${manifest.lastCheckpointId}` : '',
-    ];
-    if (manifest.captureStatuses) {
-        parts.push(`statuses=${Object.entries(manifest.captureStatuses)
-            .slice(0, 6)
-            .map(([pageId, status]) => `${pageId}:${status}`)
-            .join('|') || 'none'}`);
-    }
-    if (manifest.previousValidatedCaptures.length > 0) {
-        parts.push(`validated=${manifest.previousValidatedCaptures
-            .slice(-3)
-            .map((capture) => `${capture.pageId}${capture.identity ? `[${capture.identity.summary}]` : ''}:${capture.assessment.slice(0, 80)}`)
-            .join(' | ')}`);
-    }
-    return parts.join('; ');
-}
-// -- Page state fingerprint --
-export function buildPageStateFingerprint(pageState, currentUrl) {
-    return createHash('sha1')
-        .update(pageState.simplifiedDOM || '')
-        .update(String(pageState.interactiveElements.length))
-        .update(String(pageState.scrollInfo?.scrollY ?? 0))
-        .update(currentUrl)
-        .digest('hex');
-}
-//# sourceMappingURL=agent-url-utils.js.map