explorbot 0.0.1 → 0.1.0

package/dist/boat/api-tester/src/ai/curler-tools.js

@@ -260,4 +260,3 @@ export function createCurlerTools(apiClient, requestState, test, searchSpec) {
         }),
     };
 }
-//# sourceMappingURL=curler-tools.js.map

package/dist/boat/api-tester/src/ai/curler.js

@@ -268,4 +268,3 @@ export class Curler {
     `;
     }
 }
-//# sourceMappingURL=curler.js.map

package/dist/boat/api-tester/src/api-client.js

@@ -23,4 +23,3 @@ export class ApiClient extends BaseApiClient {
         await this.teardownHook(ctx);
     }
 }
-//# sourceMappingURL=api-client.js.map

package/dist/boat/api-tester/src/apibot.js

@@ -163,4 +163,3 @@ export class ApiBot {
         return `${sanitized.slice(0, 200)}.md`;
     }
 }
-//# sourceMappingURL=apibot.js.map

package/dist/boat/api-tester/src/cli.js

@@ -259,4 +259,3 @@ export default {
     });
     return cmd;
 }
-//# sourceMappingURL=cli.js.map

package/dist/boat/api-tester/src/config.js

@@ -156,4 +156,3 @@ export class ApibotConfigParser {
         return result;
     }
 }
-//# sourceMappingURL=config.js.map

package/dist/src/action-result.js

@@ -571,4 +571,3 @@ export class Diff {
         this._ariaDiffResult = diffAriaSnapshots(this.previous.ariaSnapshot, this.current.ariaSnapshot);
     }
 }
-//# sourceMappingURL=action-result.js.map

package/dist/src/action.js

@@ -50,7 +50,7 @@ class Action {
             return undefined;
         }
     }
-    async capturePageState({ includeScreenshot = false } = {}) {
+    async capturePageState({ includeScreenshot = false, ariaSnapshot: preCapuredAria } = {}) {
         try {
             const currentState = this.stateManager.getCurrentState();
             const stateHash = currentState?.hash || 'screenshot';
@@ -90,20 +90,23 @@ class Action {
             debugLog('Page:', { url, title, size: html.length, html: html.substring(0, 100) });
             // Capture iframe HTML snapshots
             const iframeSnapshots = await this.captureIframeSnapshots(html);
-            let ariaSnapshot = null;
+            let ariaSnapshot = preCapuredAria || null;
             let ariaSnapshotFile = undefined;
-            try {
-                const page = this.playwrightHelper.page;
-                const serializedSnapshot = await page.locator('body').ariaSnapshot();
+            if (!ariaSnapshot) {
+                try {
+                    const page = this.playwrightHelper.page;
+                    ariaSnapshot = await page.locator('body').ariaSnapshot();
+                }
+                catch (err) {
+                    debugLog('ARIA snapshot failed:', err instanceof Error ? `${err.message}\n${err.stack}` : err);
+                }
+            }
+            if (ariaSnapshot) {
                 const ariaFileName = `${stateHash}_${timestamp}.aria.yaml`;
                 const ariaPath = join(statesDir, ariaFileName);
-                fs.writeFileSync(ariaPath, serializedSnapshot, 'utf8');
-                ariaSnapshot = serializedSnapshot;
+                fs.writeFileSync(ariaPath, ariaSnapshot, 'utf8');
                 ariaSnapshotFile = ariaFileName;
             }
-            catch (err) {
-                debugLog('ARIA snapshot failed:', err instanceof Error ? `${err.message}\n${err.stack}` : err);
-            }
             const result = new ActionResult({
                 html,
                 title,
@@ -115,7 +118,7 @@ class Action {
                 iframeSnapshots,
                 ariaSnapshot,
                 ariaSnapshotFile,
-                iframeURL: frame?.url?.() || undefined,
+                iframeURL: frame ? frame.url?.() || 'iframe' : undefined,
             });
             this.stateManager.updateState(result);
             return result;
@@ -385,4 +388,3 @@ const unregisterStepLogger = () => {
     codeceptjs.event.dispatcher.off(codeceptjs.event.step.passed, stepLogger);
     codeceptjs.event.dispatcher.off(codeceptjs.event.step.failed, stepLogger);
 };
-//# sourceMappingURL=action.js.map

package/dist/src/activity.js

@@ -83,4 +83,3 @@ export const removeActivityListener = (listener) => {
     activity.removeListener(listener);
 };
 export default Activity;
-//# sourceMappingURL=activity.js.map

package/dist/src/ai/agent.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=agent.js.map

package/dist/src/ai/bosun.js

@@ -440,4 +440,3 @@ export class Bosun extends TaskAgent {
         return this.currentConversation;
     }
 }
-//# sourceMappingURL=bosun.js.map

package/dist/src/ai/captain/idle-mode.js

@@ -99,4 +99,3 @@ export function WithIdleMode(Base) {
         }
     };
 }
-//# sourceMappingURL=idle-mode.js.map

package/dist/src/ai/captain/mixin.js

@@ -8,4 +8,3 @@ export function resolveProjectRoot() {
         return null;
     return dirname(configPath);
 }
-//# sourceMappingURL=mixin.js.map

package/dist/src/ai/captain/test-mode.js

@@ -248,4 +248,3 @@ export function WithTestMode(Base) {
         }
     };
 }
-//# sourceMappingURL=test-mode.js.map

package/dist/src/ai/captain/web-mode.js

@@ -121,4 +121,3 @@ export function WithWebMode(Base) {
         }
     };
 }
-//# sourceMappingURL=web-mode.js.map

package/dist/src/ai/captain.js

@@ -439,4 +439,3 @@ export class Captain extends CaptainBase {
     }
 }
 export default Captain;
-//# sourceMappingURL=captain.js.map

package/dist/src/ai/conversation.js

@@ -173,4 +173,3 @@ export class Conversation {
         return executions;
     }
 }
-//# sourceMappingURL=conversation.js.map

package/dist/src/ai/experience-compactor.js

@@ -229,4 +229,3 @@ export class ExperienceCompactor {
     `;
     }
 }
-//# sourceMappingURL=experience-compactor.js.map

package/dist/src/ai/fisherman-tools.js

@@ -151,4 +151,3 @@ function extractKeyFields(body, result = {}, depth = 0) {
     }
     return result;
 }
-//# sourceMappingURL=fisherman-tools.js.map

package/dist/src/ai/fisherman.js

@@ -181,4 +181,3 @@ export class Fisherman {
     `;
     }
 }
-//# sourceMappingURL=fisherman.js.map

package/dist/src/ai/historian.js

@@ -381,4 +381,3 @@ export class Historian {
             .join('\n');
     }
 }
-//# sourceMappingURL=historian.js.map

package/dist/src/ai/navigator.js

@@ -490,4 +490,3 @@ class Navigator {
     }
 }
 export { Navigator };
-//# sourceMappingURL=navigator.js.map

package/dist/src/ai/pilot.js

@@ -681,4 +681,3 @@ export class Pilot {
     `;
     }
 }
-//# sourceMappingURL=pilot.js.map

package/dist/src/ai/planner/session-dedup.js

@@ -25,4 +25,3 @@ export function WithSessionDedup(Base) {
         }
     };
 }
-//# sourceMappingURL=session-dedup.js.map

package/dist/src/ai/planner/styles.js

@@ -12,4 +12,3 @@ export function getStyles() {
 export function getActiveStyle(iteration, override) {
     return RulesLoader.getActiveStyle(getStyles(), iteration, override);
 }
-//# sourceMappingURL=styles.js.map

package/dist/src/ai/planner/subpages.js

@@ -1,10 +1,11 @@
 import dedent from 'dedent';
 import { z } from 'zod';
+import { ConfigParser } from "../../config.js";
 import { normalizeUrl } from "../../state-manager.js";
 const planRegistry = new Map();
-export function registerPlan(url, plan, feature) {
+export function registerPlan(url, plan, feature, stateHash) {
     const key = buildKey(url, feature);
-    planRegistry.set(key, { plan, feature, url });
+    planRegistry.set(key, { plan, feature, url, stateHash });
 }
 export function getRegisteredPlan(url, feature) {
     return planRegistry.get(buildKey(url, feature));
@@ -26,7 +27,36 @@ function buildKey(url, feature) {
         return `${normalized}::${feature}`;
     return normalized;
 }
-function isTemplateMatch(urlA, urlB) {
+export function isDynamicSegment(segment) {
+    try {
+        const configRegex = ConfigParser.getInstance().getConfig().dynamicPageRegex;
+        if (configRegex)
+            return new RegExp(configRegex, 'i').test(segment);
+    }
+    catch {
+        /* config not loaded yet */
+    }
+    // numeric: /users/123
+    if (/^\d+$/.test(segment))
+        return true;
+    // UUID: /items/550e8400-e29b-41d4-a716-446655440000
+    if (/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(segment))
+        return true;
+    // ULID: /items/01ARZ3NDEKTSV4RRFFQ69G5FAV
+    if (/^[0-9A-HJKMNP-TV-Z]{26}$/.test(segment))
+        return true;
+    // hex ID (4+ chars): /suite/70dae98a
+    if (/^[a-f0-9]{4,}$/i.test(segment))
+        return true;
+    // hex-prefixed slug (8+ hex before dash): /suite/95ef0c94-mobile
+    if (/^[a-f0-9]{8,}-/i.test(segment))
+        return true;
+    // short mixed alphanumeric (digits + letters, ≤8 chars, no dash): /item/x7f2
+    if (segment.length <= 8 && !segment.includes('-') && /\d/.test(segment) && /[a-z]/i.test(segment))
+        return true;
+    return false;
+}
+export function isTemplateMatch(urlA, urlB) {
     const partsA = normalizeUrl(urlA).split('/');
     const partsB = normalizeUrl(urlB).split('/');
     if (partsA.length !== partsB.length)
@@ -38,12 +68,18 @@ function isTemplateMatch(urlA, urlB) {
         diffCount++;
         if (diffCount > 1)
             return false;
-        const isNumericOrShortId = /^\d+$|^[a-f0-9]{4,}$/i;
-        if (!isNumericOrShortId.test(partsA[i]) && !isNumericOrShortId.test(partsB[i]))
+        if (!isDynamicSegment(partsA[i]) && !isDynamicSegment(partsB[i]))
             return false;
     }
     return diffCount === 1;
 }
+export function getPlannedByStateHash(hash) {
+    for (const record of planRegistry.values()) {
+        if (record.stateHash === hash)
+            return record;
+    }
+    return null;
+}
 const SubPagePickSchema = z.object({
     url: z.string().nullable(),
     reason: z.string(),
@@ -58,7 +94,7 @@ export function WithSubPages(Base) {
                 const pagePath = normalizeUrl(page.url);
                 if (!pagePath.startsWith(currentPath) || pagePath === currentPath)
                     continue;
-                if (isPagePlanned(page.url))
+                if (this.findSimilarPlan(page.url))
                     continue;
                 if (candidates.some((c) => normalizeUrl(c.url) === pagePath))
                     continue;
@@ -115,4 +151,3 @@ export function WithSubPages(Base) {
         }
     };
 }
-//# sourceMappingURL=subpages.js.map

package/dist/src/ai/planner.js

@@ -14,7 +14,8 @@ import { mdq } from '../utils/markdown-query.js';
 import { Conversation } from "./conversation.js";
 import { getActiveStyle, getStyles } from "./planner/styles.js";
 import { WithSessionDedup } from "./planner/session-dedup.js";
-import { WithSubPages, getRegisteredPlan, registerPlan } from "./planner/subpages.js";
+import { WithSubPages, getPlannedByStateHash, getRegisteredPlan, registerPlan } from "./planner/subpages.js";
+import { findSimilarStateHash } from "./researcher/cache.js";
 import { hasFocusedSection } from "./researcher/focus.js";
 import { POSSIBLE_SECTIONS, Researcher } from "./researcher.js";
 import { fileUploadRule, protectionRule } from "./rules.js";
@@ -108,13 +109,24 @@ export class Planner extends PlannerBase {
         debugLog('Planning:', state?.url);
         if (!state)
             throw new Error('No state found');
-        if (!this.freshStart && !feature && !this.currentPlan && state.url) {
+        if (!feature && !this.currentPlan && state.url) {
             const similar = this.findSimilarPlan(state.url);
             if (similar) {
                 tag('info').log(`Similar page already planned: ${similar.url} (${similar.plan.tests.length} tests)`);
                 this.registerPlanInSession(similar.plan);
                 return similar.plan;
             }
+            const actionResult = ActionResult.fromState(state);
+            const combinedHtml = await actionResult.combinedHtml();
+            const similarHash = await findSimilarStateHash(combinedHtml);
+            if (similarHash) {
+                const planned = getPlannedByStateHash(similarHash);
+                if (planned) {
+                    tag('info').log(`Page content similar to already-planned: ${planned.url} — skipping`);
+                    this.registerPlanInSession(planned.plan);
+                    return planned.plan;
+                }
+            }
         }
         if (!this.freshStart && !this.currentPlan && state.url) {
             this.currentPlan = Planner.getCachedPlan(state.url);
@@ -185,7 +197,7 @@ export class Planner extends PlannerBase {
         tag('success').log(`Planning complete! ${this.currentPlan.tests.length} tests in plan: ${this.currentPlan.title}`);
         tag('info').log(`Planning style: ${this.lastStyleName} (available: ${availableStyles})`);
         if (state.url)
-            registerPlan(state.url, this.currentPlan, feature);
+            registerPlan(state.url, this.currentPlan, feature, state.hash);
         this.registerPlanInSession(this.currentPlan);
         return this.currentPlan;
     }
@@ -483,4 +495,3 @@ export class Planner extends PlannerBase {
         return conversation;
     }
 }
-//# sourceMappingURL=planner.js.map

package/dist/src/ai/provider.js

@@ -537,4 +537,3 @@ export class Provider {
     }
 }
 export { AiError, Provider as AIProvider };
-//# sourceMappingURL=provider.js.map

package/dist/src/ai/quartermaster.js

@@ -207,4 +207,3 @@ Focus on what would confuse a real user or caused the agent to make mistakes.`;
         return content;
     }
 }
-//# sourceMappingURL=quartermaster.js.map

package/dist/src/ai/researcher/cache.js

@@ -59,7 +59,7 @@ export function saveResearch(hash, text, combinedHtml) {
     }
     return researchFile;
 }
-export function findSimilarResearch(combinedHtml) {
+function findSimilarMatch(combinedHtml) {
     const statesDir = getStatesDir();
     if (!existsSync(statesDir))
         return Promise.resolve(null);
@@ -76,13 +76,8 @@ export function findSimilarResearch(combinedHtml) {
                 resolve(null);
                 return;
             }
-            debugLog(`Similar research found: ${matchHash} (${similarity}% similar)`);
-            const research = getCachedResearch(matchHash);
-            if (research) {
-                resolve(research);
-                return;
-            }
-            resolve(null);
+            debugLog(`Similar fingerprint found: ${matchHash} (${similarity}% similar)`);
+            resolve({ hash: matchHash, similarity });
         };
         worker.postMessage({
             html: combinedHtml,
@@ -92,4 +87,13 @@ export function findSimilarResearch(combinedHtml) {
         });
     });
 }
-//# sourceMappingURL=cache.js.map
+export async function findSimilarResearch(combinedHtml) {
+    const match = await findSimilarMatch(combinedHtml);
+    if (!match)
+        return null;
+    return getCachedResearch(match.hash) || null;
+}
+export async function findSimilarStateHash(combinedHtml) {
+    const match = await findSimilarMatch(combinedHtml);
+    return match?.hash || null;
+}

package/dist/src/ai/researcher/coordinates.js

@@ -115,9 +115,11 @@ export function WithCoordinates(Base) {
                 const text = aiResult.text || '';
                 const rows = mdq(text).query('table').toJson();
                 for (const row of rows) {
-                    const eidx = Number.parseInt(row.eidx, 10);
-                    if (Number.isNaN(eidx))
+                    let eidx = (row.eidx || '').trim();
+                    if (!eidx || eidx === '-')
                         continue;
+                    if (/^\d+$/.test(eidx))
+                        eidx = `e${eidx}`;
                     const val = (v) => (v && v !== '-' ? v : null);
                     elements.set(eidx, {
                         coordinates: val(row.Coordinates),
@@ -207,4 +209,3 @@ export function WithCoordinates(Base) {
         }
     };
 }
-//# sourceMappingURL=coordinates.js.map

package/dist/src/ai/researcher/deep-analysis.js

@@ -68,7 +68,7 @@ export function WithDeepAnalysis(Base) {
         From this UI research, identify elements that could reveal hidden UI when clicked
         (dropdown menus, popups, expandable panels, accordion sections, overflow menus, tab switches).
 
-        Available eidx numbers: ${eidxList}
+        Available eidx refs: ${eidxList}
 
         ${researchText}
 
@@ -76,7 +76,7 @@ export function WithDeepAnalysis(Base) {
         - Only pick elements that HIDE content until clicked (menus, dropdowns, accordions, tabs)
         - Skip regular links, data items, and navigation
         - For repeated elements (same expand button on every row), pick only the FIRST one
-        - Respond with comma-separated eidx numbers only, e.g.: 3, 7, 15
+        - Respond with comma-separated eidx refs only, e.g.: e3, e7, e15
       `;
             const model = this.provider.getModelForAgent('researcher');
             const textCall = this.provider.chat([{ role: 'user', content: textPrompt }], model, {
@@ -87,7 +87,7 @@ export function WithDeepAnalysis(Base) {
             const screenshot = this.actionResult?.screenshot;
             if (screenshot && this.provider.hasVision()) {
                 const visionPrompt = dedent `
-          This screenshot has interactive elements labeled with eidx numbers (solid bordered boxes with numbers).
+          This screenshot has interactive elements labeled with eidx refs (solid bordered boxes with labels).
           Identify elements that could reveal hidden UI when clicked.
 
           Look for: overflow/ellipsis menus, chevron dropdowns, hamburger menus,
@@ -96,30 +96,27 @@ export function WithDeepAnalysis(Base) {
           Rules:
           - For repeated icons (same icon on every list row), pick only the FIRST one
           - Skip regular text buttons, links, and navigation items
-          - Respond with comma-separated eidx numbers only, e.g.: 3, 7, 15
+          - Respond with comma-separated eidx refs only, e.g.: e3, e7, e15
         `;
                 visionCall = this.provider.processImage(visionPrompt, screenshot.toString('base64'));
             }
             const [textRes, visionRes] = await Promise.all([textCall, visionCall]);
             const eidxSet = new Set();
+            const parseRefs = (text) => {
+                if (!text)
+                    return [];
+                const matches = text.match(/e?\d+/g) || [];
+                const refs = matches.map((m) => (m.startsWith('e') ? m : `e${m}`));
+                return refs.filter((r) => allElements.has(r));
+            };
             for (const res of [textRes, visionRes]) {
-                if (!res?.text)
-                    continue;
-                const nums = res.text.match(/\d+/g)?.map(Number) || [];
-                for (const n of nums) {
-                    if (allElements.has(n))
-                        eidxSet.add(n);
+                for (const ref of parseRefs(res?.text)) {
+                    eidxSet.add(ref);
                 }
             }
-            const textNums = textRes?.text
-                ?.match(/\d+/g)
-                ?.map(Number)
-                .filter((n) => allElements.has(n)) || [];
-            const visionNums = visionRes?.text
-                ?.match(/\d+/g)
-                ?.map(Number)
-                .filter((n) => allElements.has(n)) || [];
-            debugLog(`Text model picked eidx: [${textNums.join(', ')}], Vision model picked eidx: [${visionNums.join(', ')}]`);
+            const textRefs = parseRefs(textRes?.text);
+            const visionRefs = parseRefs(visionRes?.text);
+            debugLog(`Text model picked eidx: [${textRefs.join(', ')}], Vision model picked eidx: [${visionRefs.join(', ')}]`);
             return [...eidxSet].map((eidx) => allElements.get(eidx));
         }
         _buildClickCommands(el) {
@@ -361,4 +358,3 @@ export function WithDeepAnalysis(Base) {
         }
     };
 }
-//# sourceMappingURL=deep-analysis.js.map

package/dist/src/ai/researcher/fingerprint-worker.js

@@ -43,4 +43,3 @@ self.onmessage = (event) => {
     const matched = bestSimilarity >= threshold;
     self.postMessage({ matchHash: matched ? bestHash : null, similarity: bestSimilarity });
 };
-//# sourceMappingURL=fingerprint-worker.js.map

package/dist/src/ai/researcher/focus.js

@@ -34,4 +34,3 @@ export function pickDefaultFocusedSection(sections) {
     const candidate = sections.find((s) => s.containerCss && !FOCUS_SKIP_SECTIONS.has(s.name.toLowerCase().replace(/^section:\s*/, '')));
     return candidate?.name || null;
 }
-//# sourceMappingURL=focus.js.map

package/dist/src/ai/researcher/locators.js

@@ -126,7 +126,7 @@ export function WithLocators(Base) {
                 for (const fixedSection of fixedSections) {
                     const originalSections = parseResearchSections(result.text);
                     const original = originalSections.find((s) => s.name === fixedSection.name);
-                    if (!original)
+                    if (!original || original.elements.length === 0)
                         continue;
                     if (fixedSection.containerCss && fixedSection.containerCss !== original.containerCss) {
                         debugLog(`Fixed container for "${fixedSection.name}": '${original.containerCss}' → '${fixedSection.containerCss}'`);
@@ -239,4 +239,3 @@ export function WithLocators(Base) {
         }
     };
 }
-//# sourceMappingURL=locators.js.map

package/dist/src/ai/researcher/mixin.js

@@ -1,3 +1,2 @@
 import { createDebug } from '../../utils/logger.js';
 export const debugLog = createDebug('explorbot:researcher');
-//# sourceMappingURL=mixin.js.map

package/dist/src/ai/researcher/parser.js

@@ -37,8 +37,9 @@ export function mapRowToElement(row) {
     const name = stripQuotes(colMap.element || '');
     if (!name)
         return null;
-    const eidxRaw = (colMap.eidx || '').trim();
-    const eidxNum = eidxRaw ? Number.parseInt(eidxRaw, 10) : Number.NaN;
+    let eidxRaw = (colMap.eidx || '').trim();
+    if (eidxRaw && /^\d+$/.test(eidxRaw))
+        eidxRaw = `e${eidxRaw}`;
     const aria = parseAriaLocator(colMap.aria || '-');
     return {
         name,
@@ -49,7 +50,7 @@ export function mapRowToElement(row) {
         coordinates: (colMap.coordinates || '-').trim() === '-' ? null : colMap.coordinates.trim(),
         color: (colMap.color || '-').trim() === '-' || (colMap.color || '').trim() === '' ? null : colMap.color.trim(),
         icon: (colMap.icon || '-').trim() === '-' || (colMap.icon || '').trim() === '' ? null : colMap.icon.trim(),
-        eidx: Number.isNaN(eidxNum) ? null : eidxNum,
+        eidx: eidxRaw && eidxRaw !== '-' ? eidxRaw : null,
     };
 }
 export function extractContainerFromBlockquote(sectionMarkdown) {
@@ -157,4 +158,3 @@ function formatSectionLine(s) {
         parts.push('**Focused**');
     return parts.join(' ');
 }
-//# sourceMappingURL=parser.js.map

package/dist/src/ai/researcher/research-result.js

@@ -62,6 +62,8 @@ export class ResearchResult {
         this.rebuildSectionInText(section);
     }
     rebuildSectionInText(section) {
+        if (section.elements.length === 0)
+            return;
         const newTable = rebuildSectionMarkdown(section);
         const escaped = section.name.replace(/"/g, '\\"');
         let sectionQuery = mdq(this.text).query(`section2(~"${escaped}")`);
@@ -107,4 +109,3 @@ export class ResearchResult {
         return [...ordered, ...rest];
     }
 }
-//# sourceMappingURL=research-result.js.map

package/dist/src/ai/researcher.js

@@ -98,9 +98,9 @@ export class Researcher extends ResearcherBase {
             setActivity(`${this.emoji} Researching...`, 'action');
             await this.ensureNavigated(state.url, screenshot && this.provider.hasVision());
             await this.hooksRunner.runBeforeHook('researcher', state.url);
-            const annotatedCount = await this.explorer.annotateElements();
-            debugLog(`Annotated ${annotatedCount} interactive elements with eidx`);
-            this.actionResult = await this.explorer.createAction().capturePageState({ includeScreenshot: screenshot && this.provider.hasVision() });
+            const { ariaSnapshot, elements: annotatedElements } = await this.explorer.annotateElements();
+            debugLog(`Annotated ${annotatedElements.length} interactive elements with eidx`);
+            this.actionResult = await this.explorer.createAction().capturePageState({ includeScreenshot: screenshot && this.provider.hasVision(), ariaSnapshot });
             if (isErrorPage(this.actionResult)) {
                 const recovered = await this.waitForPageLoad(screenshot);
                 if (!recovered) {
@@ -117,7 +117,7 @@ export class Researcher extends ResearcherBase {
             }
             debugLog('Researching web page:', this.actionResult.url);
             const combinedHtml = await this.actionResult.combinedHtml();
-            if (!deep) {
+            if (!deep && !force) {
                 const similar = await findSimilarResearch(combinedHtml);
                 if (similar) {
                     tag('info').log('Similar research found, reusing cached result');
@@ -325,9 +325,10 @@ export class Researcher extends ResearcherBase {
             return false;
         try {
             await withRetry(async () => {
-                await this.explorer.annotateElements();
+                const { ariaSnapshot } = await this.explorer.annotateElements();
                 this.actionResult = await this.explorer.createAction().capturePageState({
                     includeScreenshot: screenshot && this.provider.hasVision(),
+                    ariaSnapshot,
                 });
                 if (isErrorPage(this.actionResult))
                     throw new Error('Error page detected');
@@ -773,4 +774,3 @@ export class Researcher extends ResearcherBase {
         await action.execute(`I.pressKey('Escape')`);
     }
 }
-//# sourceMappingURL=researcher.js.map

package/dist/src/ai/rules.js

@@ -365,4 +365,3 @@ export const actionRule = dedent `
 
   </actions>
   `;
-//# sourceMappingURL=rules.js.map

package/dist/src/ai/task-agent.js

@@ -107,4 +107,3 @@ export class TaskAgent {
         this.recentToolCalls = [];
     }
 }
-//# sourceMappingURL=task-agent.js.map

package/dist/src/ai/tester.js

@@ -837,4 +837,3 @@ export class Tester extends TaskAgent {
         };
     }
 }
-//# sourceMappingURL=tester.js.map

package/dist/src/ai/tools.js

@@ -301,7 +301,11 @@ export function createCodeceptJSTools(explorer, task) {
                     const previousState = ActionResult.fromState(stateManager.getCurrentState());
                     const formLocator = codeLines[0] || 'form';
                     const action = explorer.createAction();
+                    const wasInIframe = await explorer.isInsideIframe();
                     await action.attempt(codeBlock, explanation);
+                    if (action.lastError && !wasInIframe && (await explorer.isInsideIframe())) {
+                        await explorer.switchToMainFrame();
+                    }
                     const toolResult = await ActionResult.fromState(stateManager.getCurrentState()).toToolResult(previousState, formLocator);
                     if (action.lastError) {
                         const message = action.lastError ? String(action.lastError) : 'Unknown error';
@@ -977,4 +981,3 @@ function getNotFoundSuggestion(errorMessage) {
     4. Prefer ARIA locators: { "role": "button", "text": "visible text" }
   `;
 }
-//# sourceMappingURL=tools.js.map

package/dist/src/api/api-client.js

@@ -88,4 +88,3 @@ export class ApiClient {
         resetRequestCounter();
     }
 }
-//# sourceMappingURL=api-client.js.map