@tangle-network/browser-agent-driver 0.6.0

package/dist/runner/overrides.js

@@ -0,0 +1,385 @@
+/**
+ * Override producers — post-decision action overrides for the runner pipeline.
+ */
+import { getVisibleLinkRecommendation, isFirstPartyContentHub, } from './search-guidance.js';
+import { findElementForRef, findLinkRefByExactText, findLinkRefContainingText, requiresSearchWorkflowEvidence, requiresPressReleaseLikeContent, looksLikeSearchResultsPage, } from './utils.js';
+/**
+ * Build the ordered list of override producers for the post-decision pipeline.
+ * Each producer wraps one of the existing choose* functions and returns a scored
+ * OverrideCandidate, or undefined if the override does not apply.
+ */
+export function buildOverrideProducers() {
+    return [
+        // 1. Search query correction (score 50)
+        (ctx) => {
+            const result = chooseSearchQueryOverride(ctx.state, ctx.goal, ctx.action);
+            if (!result)
+                return undefined;
+            return {
+                name: 'searchQueryOverride',
+                action: { action: 'type', selector: result.selector, text: result.query },
+                expectedEffect: `The search box should contain the exact task query "${result.query}".`,
+                feedback: result.feedback,
+                score: 50,
+                reasoningTag: 'POLICY OVERRIDE',
+            };
+        },
+        // 2. News tab override (score 40)
+        (ctx) => {
+            const result = chooseSearchResultsNewsTabOverride(ctx.state, ctx.goal, ctx.action);
+            if (!result)
+                return undefined;
+            return {
+                name: 'newsTabOverride',
+                action: { action: 'click', selector: result.ref },
+                expectedEffect: 'The search results page should switch to the News tab or news-filtered results.',
+                feedback: result.feedback,
+                score: 40,
+                reasoningTag: 'POLICY OVERRIDE',
+            };
+        },
+        // 3. News releases hub override (score 38)
+        (ctx) => {
+            const result = chooseNewsReleasesHubOverride(ctx.state, ctx.goal, ctx.action);
+            if (!result)
+                return undefined;
+            return {
+                name: 'newsReleasesHubOverride',
+                action: { action: 'click', selector: result.ref },
+                expectedEffect: 'The browser should open the News Releases hub page where the site-specific release search is available.',
+                feedback: result.feedback,
+                score: 38,
+                reasoningTag: 'POLICY OVERRIDE',
+            };
+        },
+        // 4. Visible news release result override (score 36)
+        (ctx) => {
+            const result = chooseVisibleNewsReleaseResultOverride(ctx.state, ctx.goal, ctx.action);
+            if (!result)
+                return undefined;
+            return {
+                name: 'visibleNewsReleaseResultOverride',
+                action: { action: 'click', selector: result.ref },
+                expectedEffect: 'The matching visible release result should open directly from the News Releases hub.',
+                feedback: result.feedback,
+                score: 36,
+                reasoningTag: 'POLICY OVERRIDE',
+            };
+        },
+        // 5. Visible search result override (score 34)
+        (ctx) => {
+            const result = chooseVisibleSearchResultOverride(ctx.state, ctx.goal, ctx.allowedDomains, ctx.action);
+            if (!result)
+                return undefined;
+            return {
+                name: 'visibleSearchResultOverride',
+                action: { action: 'click', selector: result.ref },
+                expectedEffect: 'The strongest visible search result should open directly.',
+                feedback: result.feedback,
+                score: 34,
+                reasoningTag: 'POLICY OVERRIDE',
+            };
+        },
+        // 6. Visible link override (score = match.score * 3)
+        (ctx) => {
+            const result = chooseVisibleLinkOverride(ctx.state, ctx.action, ctx.visibleLinkMatch);
+            if (!result)
+                return undefined;
+            return {
+                name: 'visibleLinkOverride',
+                action: { action: 'click', selector: result.ref },
+                expectedEffect: 'URL should change',
+                feedback: result.feedback,
+                score: (ctx.visibleLinkMatch?.score ?? 10) * 3,
+                reasoningTag: 'POLICY OVERRIDE',
+            };
+        },
+        // 7. Scout link override (score = confidence * 30)
+        (ctx) => {
+            const result = chooseScoutLinkOverride(ctx.state, ctx.action, ctx.scoutLinkRecommendation);
+            if (!result)
+                return undefined;
+            return {
+                name: 'scoutLinkOverride',
+                action: { action: 'click', selector: result.ref },
+                expectedEffect: 'URL should change',
+                feedback: result.feedback,
+                score: (ctx.scoutLinkRecommendation?.confidence ?? 0.7) * 30,
+                reasoningTag: 'SCOUT OVERRIDE',
+            };
+        },
+        // 8. Branch link override (score = confidence * 28)
+        (ctx) => {
+            const result = chooseBranchLinkOverride(ctx.state, ctx.action, ctx.branchLinkRecommendation);
+            if (!result)
+                return undefined;
+            return {
+                name: 'branchLinkOverride',
+                action: { action: 'click', selector: result.ref },
+                expectedEffect: 'URL should change',
+                feedback: result.feedback,
+                score: (ctx.branchLinkRecommendation?.confidence ?? 0.72) * 28,
+                reasoningTag: 'BRANCH OVERRIDE',
+            };
+        },
+        // 9. AI Tangle partner completion (score 100 — terminal, highest)
+        (ctx) => {
+            if (!ctx.aiTanglePartnerCompletion)
+                return undefined;
+            if (ctx.action.action === 'complete' || ctx.action.action === 'abort')
+                return undefined;
+            return {
+                name: 'aiTanglePartnerCompletion',
+                action: { action: 'complete', result: ctx.aiTanglePartnerCompletion.result },
+                expectedEffect: 'Run should terminate after verifying the partner template page.',
+                feedback: ctx.aiTanglePartnerCompletion.feedback,
+                score: 100,
+                reasoningTag: 'POLICY OVERRIDE',
+            };
+        },
+        // 10. AI Tangle output completion (score 95 — terminal)
+        (ctx) => {
+            if (!ctx.aiTangleOutputCompletion)
+                return undefined;
+            if (ctx.action.action === 'complete' || ctx.action.action === 'abort')
+                return undefined;
+            return {
+                name: 'aiTangleOutputCompletion',
+                action: { action: 'complete', result: ctx.aiTangleOutputCompletion.result },
+                expectedEffect: 'Run should terminate with a verified visible output state.',
+                feedback: ctx.aiTangleOutputCompletion.feedback,
+                score: 95,
+                reasoningTag: 'POLICY OVERRIDE',
+            };
+        },
+        // 11. Expandable list gate (score 20 — lowest)
+        (ctx) => {
+            const result = chooseExpandableListCompletionOverride(ctx.state, ctx.goal, ctx.action);
+            if (!result)
+                return undefined;
+            return {
+                name: 'expandableListGate',
+                action: { action: 'click', selector: result.ref },
+                expectedEffect: 'The remaining list items should become visible.',
+                feedback: result.feedback,
+                score: 20,
+                reasoningTag: 'POLICY OVERRIDE',
+            };
+        },
+    ];
+}
+export function chooseVisibleLinkOverride(state, action, recommendation) {
+    if (!recommendation || recommendation.score < 10)
+        return undefined;
+    if (!isFirstPartyContentHub(state))
+        return undefined;
+    if (!isContentHubDetourAction(state, action))
+        return undefined;
+    if (action.action === 'click' && action.selector === recommendation.ref)
+        return undefined;
+    if (isStructuralHubAction(state, action))
+        return undefined;
+    return {
+        ref: recommendation.ref,
+        feedback: `A high-confidence first-party link is already visible on this page. Do not search again; click ${recommendation.ref} (${recommendation.text}) instead.`,
+    };
+}
+export function chooseScoutLinkOverride(state, action, recommendation) {
+    if (!recommendation || recommendation.confidence < 0.7)
+        return undefined;
+    if (action.action === 'click' && action.selector === recommendation.ref)
+        return undefined;
+    if (!isSearchAction(state, action) && !isContentHubDetourAction(state, action) && !isCandidateClick(state, action)) {
+        return undefined;
+    }
+    return {
+        ref: recommendation.ref,
+        feedback: `Scout recommendation: click ${recommendation.ref} (${recommendation.text}) instead. ${recommendation.reasoning}`,
+    };
+}
+export function chooseBranchLinkOverride(state, action, recommendation) {
+    if (!recommendation || recommendation.confidence < 0.72)
+        return undefined;
+    if (action.action === 'click' && action.selector === recommendation.ref)
+        return undefined;
+    if (!isSearchAction(state, action) && !isContentHubDetourAction(state, action) && !isCandidateClick(state, action)) {
+        return undefined;
+    }
+    return {
+        ref: recommendation.ref,
+        feedback: `Bounded branch preview recommends ${recommendation.ref} (${recommendation.text}) instead. ${recommendation.reasoning}`,
+    };
+}
+export function buildScoutLinkRecommendationText(recommendation) {
+    return [
+        'SCOUT RECOMMENDATION:',
+        `Prefer clicking ${recommendation.ref} (${recommendation.text}).`,
+        `Scout confidence: ${recommendation.confidence.toFixed(2)}.`,
+        `Scout reasoning: ${recommendation.reasoning}`,
+    ].join('\n');
+}
+export function buildBranchLinkRecommendationText(recommendation) {
+    return [
+        'BOUNDED BRANCH RECOMMENDATION:',
+        `Prefer clicking ${recommendation.ref} (${recommendation.text}).`,
+        `Branch confidence: ${recommendation.confidence.toFixed(2)}.`,
+        `Branch reasoning: ${recommendation.reasoning}`,
+    ].join('\n');
+}
+export function chooseSearchResultsNewsTabOverride(state, goal, action) {
+    if (!requiresPressReleaseLikeContent(goal))
+        return undefined;
+    if (!looksLikeSearchResultsPage(state))
+        return undefined;
+    const newsTabRef = findLinkRefByExactText(state.snapshot, 'News');
+    if (!newsTabRef)
+        return undefined;
+    if (action.action === 'click' && action.selector === newsTabRef)
+        return undefined;
+    if (!isCandidateClick(state, action) && !isSearchAction(state, action))
+        return undefined;
+    return {
+        ref: newsTabRef,
+        feedback: 'For press/news-release tasks on site search results, switch to the visible News tab before opening generic results or topic pages.',
+    };
+}
+export function chooseSearchQueryOverride(state, goal, action) {
+    if (action.action !== 'type' || !action.selector.startsWith('@'))
+        return undefined;
+    if (!requiresSearchWorkflowEvidence(goal))
+        return undefined;
+    const element = findElementForRef(state.snapshot, action.selector)?.toLowerCase() ?? '';
+    if (!element.includes('searchbox'))
+        return undefined;
+    const explicitQuery = Array.from(goal.matchAll(/"([^"]{3,})"/g))
+        .map((match) => match[1]?.trim())
+        .find(Boolean);
+    if (!explicitQuery)
+        return undefined;
+    if (action.text.trim() === explicitQuery)
+        return undefined;
+    return {
+        selector: action.selector,
+        query: explicitQuery,
+        feedback: `Use the exact task query "${explicitQuery}" in the site search box instead of reformulating it.`,
+    };
+}
+export function chooseNewsReleasesHubOverride(state, goal, action) {
+    if (!requiresSearchWorkflowEvidence(goal) || !requiresPressReleaseLikeContent(goal))
+        return undefined;
+    if (!/\/news-events\/?$/.test(state.url.toLowerCase()))
+        return undefined;
+    const hubRef = findLinkRefContainingText(state.snapshot, 'All news releases');
+    if (!hubRef)
+        return undefined;
+    if (action.action === 'click' && action.selector === hubRef)
+        return undefined;
+    if (!isCandidateClick(state, action))
+        return undefined;
+    return {
+        ref: hubRef,
+        feedback: 'Open the dedicated News Releases hub before choosing an article so the site-specific release search can prove the first related press release.',
+    };
+}
+export function chooseVisibleNewsReleaseResultOverride(state, goal, action) {
+    if (!requiresSearchWorkflowEvidence(goal) || !requiresPressReleaseLikeContent(goal))
+        return undefined;
+    if (!state.url.toLowerCase().includes('/news-events/news-releases'))
+        return undefined;
+    const explicitQuery = Array.from(goal.matchAll(/"([^"]{3,})"/g))
+        .map((match) => match[1]?.trim().toLowerCase())
+        .find(Boolean);
+    if (!explicitQuery)
+        return undefined;
+    if (!state.snapshot.toLowerCase().includes(`[value="${explicitQuery}"]`))
+        return undefined;
+    const recommendation = getVisibleLinkRecommendation(state, goal, ['www.nih.gov']);
+    if (!recommendation || recommendation.score < 6)
+        return undefined;
+    if (/all news releases/i.test(recommendation.text))
+        return undefined;
+    if (action.action === 'click' && action.selector === recommendation.ref)
+        return undefined;
+    const shouldOverride = isSearchAction(state, action)
+        || action.action === 'press'
+        || isCandidateClick(state, action);
+    if (!shouldOverride)
+        return undefined;
+    return {
+        ref: recommendation.ref,
+        feedback: `A matching news release is already visible for the exact query "${explicitQuery}". Click the visible release instead of re-submitting the search.`,
+    };
+}
+export function chooseVisibleSearchResultOverride(state, goal, allowedDomains, action) {
+    if (!looksLikeSearchResultsPage(state))
+        return undefined;
+    const recommendation = getVisibleLinkRecommendation(state, goal, allowedDomains);
+    if (!recommendation || recommendation.score < 10)
+        return undefined;
+    if (action.action === 'click' && action.selector === recommendation.ref)
+        return undefined;
+    const candidateClick = isCandidateClick(state, action);
+    if (!candidateClick && !isSearchAction(state, action))
+        return undefined;
+    const targetText = candidateClick && action.action === 'click'
+        ? (findElementForRef(state.snapshot, action.selector) ?? '').toLowerCase()
+        : '';
+    const lowerGoal = goal.toLowerCase();
+    const wantsProductSearch = lowerGoal.includes('top result')
+        || lowerGoal.includes('product search')
+        || (lowerGoal.includes('review') && lowerGoal.includes('summary'));
+    const chosenLooksDistracting = /\bcustomer services\b|\breviews policy\b|\bhelp\b|\bshopping with us\b/.test(targetText);
+    if (!wantsProductSearch && !chosenLooksDistracting)
+        return undefined;
+    return {
+        ref: recommendation.ref,
+        feedback: `A stronger visible search result is already present. Click ${recommendation.ref} (${recommendation.text}) instead of the lower-signal search/help link you chose.`,
+    };
+}
+export function chooseExpandableListCompletionOverride(state, goal, action) {
+    if (action.action !== 'complete')
+        return undefined;
+    if (!/\blist\b|\bcategories\b|\bcategory\b/.test(goal.toLowerCase()))
+        return undefined;
+    const lines = state.snapshot.split('\n');
+    const topicIndex = lines.findIndex((line) => /\btopic\b/i.test(line));
+    if (topicIndex === -1)
+        return undefined;
+    const window = lines.slice(topicIndex, Math.min(lines.length, topicIndex + 12)).join('\n');
+    const match = window.match(/- link "SHOW MORE \((\d+)\)" \[ref=([^\]]+)\]/i);
+    if (!match)
+        return undefined;
+    return {
+        ref: `@${match[2]}`,
+        feedback: `The requested category list is not fully visible yet. Expand SHOW MORE (${match[1]}) before completing.`,
+    };
+}
+function isCandidateClick(state, action) {
+    return (action.action === 'click'
+        && action.selector.startsWith('@')
+        && !!findElementForRef(state.snapshot, action.selector));
+}
+function isSearchAction(state, action) {
+    if (!('selector' in action) || !action.selector?.startsWith('@'))
+        return false;
+    const element = findElementForRef(state.snapshot, action.selector)?.toLowerCase() ?? '';
+    return element.includes('searchbox') || element.includes('search');
+}
+function isContentHubDetourAction(state, action) {
+    if (isSearchAction(state, action))
+        return true;
+    if (!('selector' in action) || !action.selector?.startsWith('@'))
+        return false;
+    const element = findElementForRef(state.snapshot, action.selector)?.toLowerCase() ?? '';
+    if (!element)
+        return false;
+    return (/\b(all news releases|all releases|news releases)\b/.test(element)
+        || /\bsearch\b/.test(element));
+}
+function isStructuralHubAction(state, action) {
+    if (!('selector' in action) || !action.selector?.startsWith('@'))
+        return false;
+    const element = findElementForRef(state.snapshot, action.selector)?.toLowerCase() ?? '';
+    return /\b(all news releases|all releases)\b/.test(element);
+}
+//# sourceMappingURL=overrides.js.map

package/dist/runner/overrides.js.map

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

package/dist/runner/page-analysis.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Page analysis — AI Tangle detection and vision escalation logic.
+ */
+import type { AgentConfig, PageState, Scenario, Turn } from '../types.js';
+export declare function detectAiTangleVerifiedOutputState(state: PageState, goal: string): {
+    result: string;
+    feedback: string;
+} | undefined;
+export declare function detectAiTanglePartnerTemplateVisibleState(state: PageState, goal: string): {
+    result: string;
+    feedback: string;
+} | undefined;
+export declare function shouldEscalateVision(input: {
+    config: AgentConfig;
+    state: PageState;
+    turns: Turn[];
+    scenario: Scenario;
+    currentTurn: number;
+    maxTurns: number;
+    supervisorSignalSeverity: 'none' | 'soft' | 'hard';
+    extraContext: string;
+}): boolean;
+//# sourceMappingURL=page-analysis.d.ts.map

package/dist/runner/page-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-analysis.d.ts","sourceRoot":"","sources":["../../src/runner/page-analysis.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAE1E,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,GACX;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAkClD;AAED,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,GACX;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAsClD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACnD,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAwBV"}

package/dist/runner/page-analysis.js

@@ -0,0 +1,91 @@
+/**
+ * Page analysis — AI Tangle detection and vision escalation logic.
+ */
+export function detectAiTangleVerifiedOutputState(state, goal) {
+    const goalLower = goal.toLowerCase();
+    const urlLower = state.url.toLowerCase();
+    const snapshotLower = state.snapshot.toLowerCase();
+    const requiresVerifiedOutput = goalLower.includes('verified visible output state')
+        || goalLower.includes('reach a verified output state')
+        || goalLower.includes('usable output');
+    if (!requiresVerifiedOutput)
+        return undefined;
+    if (!urlLower.includes('ai.tangle.tools/chat/'))
+        return undefined;
+    const hasWorkspaceTabs = snapshotLower.includes('code') && snapshotLower.includes('preview');
+    const hasOutputSurface = hasWorkspaceTabs
+        || snapshotLower.includes('fresh start')
+        || snapshotLower.includes('waiting for files')
+        || snapshotLower.includes('fork');
+    if (!hasOutputSurface)
+        return undefined;
+    const visibleCues = [];
+    if (hasWorkspaceTabs)
+        visibleCues.push('Code/Preview workspace is visible');
+    if (snapshotLower.includes('fresh start'))
+        visibleCues.push('"Fresh start" output placeholder is visible');
+    if (snapshotLower.includes('waiting for files'))
+        visibleCues.push('"Waiting for files" status is visible');
+    if (snapshotLower.includes('fork'))
+        visibleCues.push('a visible Fork control confirms chat output is present');
+    const evidence = [`URL: ${state.url}`, ...visibleCues].join('; ');
+    return {
+        result: `Reached a verified Blueprint output workspace. ${evidence}`,
+        feedback: `The main goal is already satisfied: a Blueprint chat workspace with visible output is on screen (${evidence}). Do not open menus or settings. Complete now.`,
+    };
+}
+export function detectAiTanglePartnerTemplateVisibleState(state, goal) {
+    const goalLower = goal.toLowerCase();
+    const urlLower = state.url.toLowerCase();
+    const snapshot = state.snapshot;
+    const snapshotLower = snapshot.toLowerCase();
+    const requiresVisibilityOnly = goalLower.includes('templates are visible')
+        || goalLower.includes('verify coinbase templates are visible')
+        || goalLower.includes('verify templates are visible');
+    if (!requiresVisibilityOnly)
+        return undefined;
+    if (!urlLower.includes('ai.tangle.tools/partner/'))
+        return undefined;
+    const templateButtons = Array.from(snapshot.matchAll(/- button "([^"]*View [^"]+ templates[^"]*)" \[ref=([^\]]+)\]/g)).map((match) => ({ text: match[1]?.trim() ?? '', ref: match[2]?.trim() ?? '' }));
+    const partnerHeadingMatch = snapshot.match(/- heading "([^"]*Coinbase[^"]*)" \[ref=([^\]]+)\]/i);
+    const hasPartnerHeading = Boolean(partnerHeadingMatch);
+    if (!hasPartnerHeading || templateButtons.length < 3)
+        return undefined;
+    const visibleTemplateEvidence = templateButtons
+        .slice(0, 5)
+        .map((button) => `"${button.text}" [ref=${button.ref}]`)
+        .join('; ');
+    const headingText = partnerHeadingMatch?.[1]?.trim() ?? 'Coinbase';
+    const result = `Verified Coinbase templates are visible on the partner page. ` +
+        `URL: ${state.url}; heading: "${headingText}"; visible template buttons: ${visibleTemplateEvidence}.`;
+    return {
+        result,
+        feedback: `The goal is already satisfied on the current partner page: Coinbase template buttons are visibly present under the Coinbase heading. ` +
+            `Do not open a template, submit a run, or chase extra actionability proof. Complete now with the visible evidence only.`,
+    };
+}
+export function shouldEscalateVision(input) {
+    const strategy = input.config.visionStrategy ?? (input.config.vision !== false ? 'always' : 'never');
+    if (strategy === 'never')
+        return false;
+    if (strategy === 'always')
+        return true;
+    const pageText = `${input.state.url}\n${input.state.title}\n${input.state.snapshot}`.toLowerCase();
+    const recentTurns = input.turns.slice(-2);
+    const recentError = recentTurns.some((turn) => Boolean(turn.error || turn.verificationFailure));
+    const searchLike = /\bsearch\b|\bsearch results\b/.test(pageText);
+    const modalLike = /\bdialog\b|\bmodal\b|\boverlay\b|\bmenu\b/.test(pageText);
+    const constrainedTask = Array.isArray(input.scenario.allowedDomains) && input.scenario.allowedDomains.length > 0;
+    const lowTurns = input.maxTurns - input.currentTurn <= 2;
+    const visibleRecommendation = input.extraContext.includes('VISIBLE LINK RECOMMENDATION');
+    const repeatedLocation = recentTurns.length >= 2 &&
+        recentTurns.every((turn) => turn.state.url === input.state.url);
+    const stalledSearch = searchLike && (repeatedLocation || recentError || input.currentTurn >= 6);
+    return recentError
+        || modalLike
+        || lowTurns
+        || input.supervisorSignalSeverity !== 'none'
+        || stalledSearch
+        || (constrainedTask && searchLike && !visibleRecommendation && recentError);
+}
+//# sourceMappingURL=page-analysis.js.map

package/dist/runner/page-analysis.js.map

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

package/dist/runner/runner.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Agent Runner — the main loop with verification, stuck detection, and recovery
+ *
+ * Loop: observe -> decide -> execute -> verify -> recover (if needed)
+ *
+ * Key improvements over simple observe-decide-execute:
+ * - Post-action verification: checks expectedEffect after each action
+ * - Stuck detection: tracks URL + snapshot hash across turns
+ * - Recovery strategies: auto-triggered on failure patterns
+ * - Plan tracking: detects when the agent repeats the same step
+ */
+import type { Driver } from '../drivers/types.js';
+import type { Scenario, AgentConfig, AgentResult, Turn } from '../types.js';
+import type { ProjectStore } from '../memory/project-store.js';
+export interface RunnerOptions {
+    driver: Driver;
+    config?: AgentConfig;
+    /** Called after each turn */
+    onTurn?: (turn: Turn) => void;
+    /** Called when a first-time phase timing is observed */
+    onPhaseTiming?: (phase: 'navigate' | 'observe' | 'decide' | 'execute', durationMs: number) => void;
+    /** Reference trajectory to inject into brain context */
+    referenceTrajectory?: string;
+    /** Project memory store — enables knowledge + selector persistence */
+    projectStore?: ProjectStore;
+}
+export declare class AgentRunner {
+    private driver;
+    private brain;
+    private config;
+    private onTurn?;
+    private onPhaseTiming?;
+    private referenceTrajectory?;
+    private projectStore?;
+    private knowledge?;
+    private selectorCache?;
+    constructor(options: RunnerOptions);
+    run(scenario: Scenario): Promise<AgentResult>;
+    private selectFollowUpActions;
+    /** Persist knowledge and selector cache to disk */
+    private saveMemory;
+    /**
+     * Verify that an action had the expected effect.
+     *
+     * Uses a lightweight re-observe to check the page state after an action.
+     * IMPORTANT: This calls observe() which resets the refMap. The runner
+     * always calls observe() again at the start of the next turn, so this is safe.
+     *
+     * Checks common patterns:
+     * - "URL should contain X" -> check page URL
+     * - "element should be visible" -> check snapshot
+     * - "text should appear" -> check snapshot
+     * - Generic text match -> check if text appears in snapshot
+     */
+    private verifyEffect;
+    private buildSearchResultsScoutFeedback;
+    private buildVisibleLinkScoutRecommendation;
+    private buildBranchLinkRecommendation;
+    private filterScoutCandidatesByAllowedDomains;
+    private inspectDisallowedSearchClick;
+    private enforceAllowedDomainBoundary;
+    private attachDecisionScreenshot;
+}
+/** Convenience function */
+export declare function runAgent(driver: Driver, scenario: Scenario, options?: Omit<RunnerOptions, 'driver'>): Promise<AgentResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAuC,MAAM,aAAa,CAAC;AAIjH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAkC/D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC9B,wDAAwD;IACxD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACnG,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAuB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAqF;IAC3G,OAAO,CAAC,mBAAmB,CAAC,CAAS;IACrC,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,SAAS,CAAC,CAAe;IACjC,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAE1B,OAAO,EAAE,aAAa;IAU5B,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;IA8lCnD,OAAO,CAAC,qBAAqB;IA2B7B,mDAAmD;IACnD,OAAO,CAAC,UAAU;IAWlB;;;;;;;;;;;;OAYG;YACW,YAAY;YA2EZ,+BAA+B;YAgE/B,mCAAmC;YAwCnC,6BAA6B;YAwC7B,qCAAqC;YAoBrC,4BAA4B;YA4B5B,4BAA4B;YAkC5B,wBAAwB;CASvC;AAED,2BAA2B;AAC3B,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GACtC,OAAO,CAAC,WAAW,CAAC,CAGtB"}