explorbot 0.1.27 → 0.1.28

package/dist/src/ai/tester.js

@@ -4,13 +4,13 @@ import { tool } from 'ai';
 import dedent from 'dedent';
 import { z } from 'zod';
 import { ActionResult } from "../action-result.js";
-import { setActivity } from "../activity.js";
+import { clearActivity, setActivity } from "../activity.js";
 import { ConfigParser } from "../config.js";
 import { Observability } from "../observability.js";
 import { Stats } from "../stats.js";
 import { TestResult } from "../test-plan.js";
 import { detectFocusArea, extractFocusedElement } from "../utils/aria.js";
-import { ErrorPageError } from "../utils/error-page.js";
+import { ErrorPageError, isErrorPage } from "../utils/error-page.js";
 import { HooksRunner } from "../utils/hooks-runner.js";
 import { createDebug, tag } from "../utils/logger.js";
 import { loop } from "../utils/loop.js";
@@ -107,18 +107,13 @@ export class Tester extends TaskAgent {
         const offFailedRequest = requestStore?.onFailedRequest((r) => {
             task.addNote(`Network error: ${r.method} ${r.path} → ${r.status}`, TestResult.FAILED);
         });
-        const page = this.explorer.playwrightHelper?.page;
-        const onPageError = (err) => {
-            task.addNote(`Console error: ${err.message}`, TestResult.FAILED);
-        };
-        const onConsoleMessage = (msg) => {
-            if (msg.type() !== 'error')
-                return;
-            task.addNote(`Console error: ${msg.text()}`, TestResult.FAILED);
-        };
-        page?.on('pageerror', onPageError);
-        page?.on('console', onConsoleMessage);
         const initialState = ActionResult.fromState(state);
+        if (isErrorPage(initialState)) {
+            task.start();
+            await this.explorer.startTest(task);
+            offFailedRequest?.();
+            return await this.abortStartedTestOnErrorPage(task, initialState);
+        }
         const conversation = this.provider.startConversation(this.getSystemMessage(), 'tester');
         conversation.markLastMessageCacheable();
         this.currentConversation = conversation;
@@ -140,17 +135,15 @@ export class Tester extends TaskAgent {
                 startUrl: task.startUrl,
                 expected: task.expected,
             },
-        }, async () => this.runTestSession(task, initialState, conversation, { offFailedRequest, page, onPageError, onConsoleMessage }));
+        }, async () => this.runTestSession(task, initialState, conversation, { offFailedRequest }));
     }
     async runTestSession(task, initialState, conversation, handlers) {
-        const { offFailedRequest, page, onPageError, onConsoleMessage } = handlers;
+        const { offFailedRequest } = handlers;
         if (this.pilot) {
             try {
                 const plan = await this.pilot.planTest(task, initialState);
                 if (task.hasFinished) {
                     offFailedRequest?.();
-                    page?.off('pageerror', onPageError);
-                    page?.off('console', onConsoleMessage);
                     return { success: task.isSuccessful };
                 }
                 if (plan) {
@@ -163,19 +156,36 @@ export class Tester extends TaskAgent {
                 task.addNote(`Planning failed: ${message}`, TestResult.FAILED);
                 task.finish(TestResult.FAILED);
                 offFailedRequest?.();
-                page?.off('pageerror', onPageError);
-                page?.off('console', onConsoleMessage);
                 return { success: false };
             }
         }
         debugLog('Starting test execution with tools');
-        task.start();
-        await this.explorer.startTest(task);
+        if (!(await this.explorer.startTest(task))) {
+            offFailedRequest?.();
+            await this.cleanupStartedTest(task);
+            return { success: task.isSuccessful };
+        }
         debugLog(`Navigating to ${task.startUrl}`);
-        await this.explorer.visit(task.startUrl);
+        try {
+            await this.explorer.visit(task.startUrl);
+        }
+        catch (error) {
+            const result = await this.handleLoopError(task, error);
+            if (result === 'stop') {
+                offFailedRequest?.();
+                await this.cleanupStartedTest(task);
+                return { success: task.isSuccessful };
+            }
+        }
         const startState = this.explorer.getStateManager().getCurrentState();
-        if (startState)
+        if (startState) {
             task.addUrlNote(startState);
+            const startActionResult = ActionResult.fromState(startState);
+            if (isErrorPage(startActionResult)) {
+                offFailedRequest?.();
+                return await this.abortStartedTestOnErrorPage(task, startActionResult);
+            }
+        }
         const currentUrl = startState?.url || task.startUrl || '';
         await this.hooksRunner.runBeforeHook('tester', currentUrl);
         const offStateChange = this.explorer.getStateManager().onStateChange((event) => {
@@ -195,6 +205,12 @@ export class Tester extends TaskAgent {
             shouldContinue = false;
             await loop(async ({ stop, pause, iteration, userInput }) => {
                 debugLog('iteration', iteration);
+                if (!(await this.explorer.ensurePageAvailable())) {
+                    task.addNote('Browser page is unavailable');
+                    task.finish(TestResult.FAILED);
+                    stop();
+                    return;
+                }
                 const currentState = this.getCurrentState();
                 const tools = {
                     ...codeceptjsTools,
@@ -327,20 +343,15 @@ export class Tester extends TaskAgent {
                     }
                     : undefined,
                 catch: async ({ error, stop }) => {
-                    tag('error').log(`Test execution error: ${error}`);
-                    const message = error instanceof Error ? error.message : String(error);
-                    if (!task.hasFinished) {
-                        task.addNote(`Execution error: ${message}`);
-                    }
-                    if (error instanceof Error && error.name === 'AbortError') {
+                    const result = await this.handleLoopError(task, error);
+                    if (result === 'stop')
                         stop();
-                        return;
-                    }
-                    conversation.addUserText(`Previous AI call failed: ${message}. Take a different approach on the next step.`);
                 },
             });
             if (task.hasFinished)
                 break;
+            if (!(await this.explorer.ensurePageAvailable()))
+                break;
             const finalState = this.getCurrentState();
             const wantsContinue = await this.pilot.finalReview(task, finalState, conversation, this.navigator);
             if (!wantsContinue || task.hasFinished)
@@ -366,14 +377,8 @@ export class Tester extends TaskAgent {
         await this.getQuartermaster().analyzeSession(task, initialState, conversation);
         offStateChange();
         offFailedRequest?.();
-        page?.off('pageerror', onPageError);
-        page?.off('console', onConsoleMessage);
         await this.finishTest(task);
-        await this.explorer.stopTest(task, {
-            startUrl: task.startUrl,
-            style: task.style,
-            sessionName: task.sessionName,
-        });
+        await this.explorer.stopTest(task, this.buildStopTestMeta(task));
         return {
             success: task.isSuccessful,
             ...task,
@@ -607,6 +612,26 @@ export class Tester extends TaskAgent {
             tag('warning').log(`Test with no result: ${task.scenario}`);
         }
     }
+    async abortStartedTestOnErrorPage(task, actionResult) {
+        const error = new ErrorPageError(actionResult.url || task.startUrl || '', actionResult.title, actionResult.httpStatus);
+        tag('warning').log(error.message);
+        task.addNote(error.message, TestResult.FAILED, actionResult.screenshotFile, actionResult.fullUrl || actionResult.url);
+        task.finish(TestResult.FAILED);
+        this.finishTest(task);
+        await this.explorer.stopTest(task, this.buildStopTestMeta(task));
+        clearActivity(true);
+        return { success: false };
+    }
+    buildStopTestMeta(task) {
+        const meta = {
+            startUrl: task.startUrl,
+        };
+        if (task.style)
+            meta.style = task.style;
+        if (task.sessionName)
+            meta.sessionName = task.sessionName;
+        return meta;
+    }
     getSystemMessage() {
         return dedent `
     <role>
@@ -991,4 +1016,31 @@ export class Tester extends TaskAgent {
             }),
         };
     }
+    async handleLoopError(task, error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (!task.hasFinished)
+            task.addNote(`Execution error: ${message}`);
+        const result = await this.explorer.handleExecutionError(error);
+        tag('info').log(`Browser supervisor: ${result.action} - ${result.message}`);
+        task.addNote(result.message);
+        if (result.action === 'stop') {
+            task.finish(TestResult.FAILED);
+            return 'stop';
+        }
+        if (result.recovered) {
+            this.resetFailureCount();
+            this.previousUrl = null;
+            this.previousStateHash = null;
+        }
+        this.currentConversation?.addUserText(result.message);
+        return 'continue';
+    }
+    async cleanupStartedTest(task) {
+        await this.finishTest(task);
+        await this.explorer.stopTest(task, {
+            startUrl: task.startUrl,
+            style: task.style,
+            sessionName: task.sessionName,
+        });
+    }
 }

package/dist/src/ai/tools.js

@@ -4,6 +4,7 @@ import { z } from 'zod';
 import { ActionResult } from "../action-result.js";
 import { TestResult } from '../test-plan.js';
 import { extractFocusedElement } from "../utils/aria.js";
+import { isFatalBrowserError } from "../utils/browser-errors.js";
 import { createDebug, tag } from '../utils/logger.js';
 import { pause } from '../utils/loop.js';
 import { WebElement } from "../utils/web-element.js";
@@ -243,6 +244,7 @@ export function createCodeceptJSTools(explorer, task) {
                     });
                 }
                 catch (error) {
+                    throwIfFatalBrowserError(error);
                     activeNote.commit(TestResult.FAILED);
                     const errorMessage = error instanceof Error ? error.toString() : 'Unknown error occurred';
                     return failedToolResult('pressKey', `PressKey tool failed: ${errorMessage}`);
@@ -343,6 +345,7 @@ export function createCodeceptJSTools(explorer, task) {
                     }, action);
                 }
                 catch (error) {
+                    throwIfFatalBrowserError(error);
                     activeNote.commit(TestResult.FAILED);
                     const errorMessage = error instanceof Error ? error.toString() : 'Unknown error occurred';
                     return failedToolResult('form', `Form tool failed: ${errorMessage}`);
@@ -376,8 +379,7 @@ export function createSpecialContextTools(explorer, context) {
                         });
                     }
                     await explorer.switchToMainFrame();
-                    const action = explorer.createAction();
-                    const nextState = await action.capturePageState();
+                    const nextState = await explorer.capturePageState();
                     const toolResult = await nextState.toToolResult(previousState, 'I.switchTo()');
                     return successToolResult('exitIframe', {
                         ...toolResult,
@@ -386,6 +388,7 @@ export function createSpecialContextTools(explorer, context) {
                     });
                 }
                 catch (error) {
+                    throwIfFatalBrowserError(error);
                     const errorMessage = error instanceof Error ? error.toString() : 'Unknown error occurred';
                     return failedToolResult('exitIframe', `Failed to exit iframe: ${errorMessage}`);
                 }
@@ -415,8 +418,7 @@ export function createAgentTools({ explorer, researcher, navigator, experienceTr
                     return failedToolResult('see', 'Vision tools are disabled for this session. Use context() to get fresh ARIA snapshot and analyze page state from ARIA data.');
                 }
                 try {
-                    const action = explorer.createAction();
-                    const actionResult = await action.caputrePageWithScreenshot();
+                    const actionResult = await explorer.capturePageWithScreenshot();
                     if (!actionResult.screenshot) {
                         return failedToolResult('see', 'Failed to capture screenshot for analysis');
                     }
@@ -431,6 +433,7 @@ export function createAgentTools({ explorer, researcher, navigator, experienceTr
                     });
                 }
                 catch (error) {
+                    throwIfFatalBrowserError(error);
                     const errorMessage = error instanceof Error ? error.toString() : 'Unknown error occurred';
                     visionDisabled = true;
                     tag('warning').log('⚠️ Vision model is not available. Visual checks are disabled for this session.');
@@ -506,8 +509,7 @@ export function createAgentTools({ explorer, researcher, navigator, experienceTr
                             suggestion: verifications[assertion] ? 'This verification already passed. Call finish() to complete the test.' : 'This verification already failed. Perform actions to change the page state, then try again.',
                         });
                     }
-                    const action = explorer.createAction();
-                    const actionResult = await action.capturePageState();
+                    const actionResult = await explorer.capturePageState();
                     const result = await navigator.verifyState(assertion, actionResult);
                     if (result.verified) {
                         return successToolResult('verify', {
@@ -520,6 +522,7 @@ export function createAgentTools({ explorer, researcher, navigator, experienceTr
                     });
                 }
                 catch (error) {
+                    throwIfFatalBrowserError(error);
                     const errorMessage = error instanceof Error ? error.toString() : 'Unknown error occurred';
                     return failedToolResult('verify', `Verify tool failed: ${errorMessage}`, {
                         error: errorMessage,
@@ -572,6 +575,7 @@ export function createAgentTools({ explorer, researcher, navigator, experienceTr
                     });
                 }
                 catch (error) {
+                    throwIfFatalBrowserError(error);
                     const errorMessage = error instanceof Error ? error.toString() : 'Unknown error occurred';
                     return failedToolResult('research', `Research tool failed: ${errorMessage}`, {
                         error: errorMessage,
@@ -611,6 +615,7 @@ export function createAgentTools({ explorer, researcher, navigator, experienceTr
                     });
                 }
                 catch (error) {
+                    throwIfFatalBrowserError(error);
                     const errorMessage = error instanceof Error ? error.toString() : 'Unknown error occurred';
                     return failedToolResult('interact', `Interact tool failed: ${errorMessage}`, {
                         error: errorMessage,
@@ -645,7 +650,7 @@ export function createAgentTools({ explorer, researcher, navigator, experienceTr
                     }
                     const previousState = ActionResult.fromState(currentState);
                     const action = explorer.createAction();
-                    const actionResult = await action.caputrePageWithScreenshot();
+                    const actionResult = await explorer.capturePageWithScreenshot();
                     if (!actionResult.screenshot) {
                         return failedToolResult('visualClick', 'Failed to capture screenshot for visual analysis');
                     }
@@ -678,6 +683,7 @@ export function createAgentTools({ explorer, researcher, navigator, experienceTr
                     });
                 }
                 catch (error) {
+                    throwIfFatalBrowserError(error);
                     const errorMessage = error instanceof Error ? error.toString() : 'Unknown error occurred';
                     visionDisabled = true;
                     tag('warning').log('⚠️ Vision model is not available. Visual clicks are disabled for this session.');
@@ -874,6 +880,10 @@ function cap(text, max) {
         return text;
     return `${text.slice(0, max)}\n[...truncated; ${text.length - max} chars omitted...]`;
 }
+function throwIfFatalBrowserError(error) {
+    if (isFatalBrowserError(error))
+        throw error;
+}
 function transformContainsCommand(command) {
     if (!command.includes(':contains('))
         return command;

package/dist/src/commands/explore-command.js

@@ -5,7 +5,7 @@ import { normalizeUrl } from '../state-manager.js';
 import { Stats } from '../stats.js';
 import { TestResult } from '../test-plan.js';
 import { getCliName } from "../utils/cli-name.js";
-import { ErrorPageError } from "../utils/error-page.js";
+import { ErrorPageError, getStateErrorPageError } from "../utils/error-page.js";
 import { tag } from '../utils/logger.js';
 import { printNextSteps, relativeToCwd } from "../utils/next-steps.js";
 import { safeFilename } from "../utils/strings.js";
@@ -53,6 +53,11 @@ export class ExploreCommand extends BaseCommand {
         Stats.mode ??= 'explore';
         Stats.focus ??= feature;
         const mainUrl = this.getCurrentPageUrl();
+        const error = getStateErrorPageError(this.explorBot.getExplorer().getStateManager().getCurrentState());
+        if (error) {
+            tag('warning').log(error.message);
+            return;
+        }
         if (cfg.enabled) {
             await this.runReuseMode(mainUrl, feature, cfg);
         }

package/dist/src/components/LogPane.js

@@ -94,6 +94,7 @@ const LogPane = React.memo(({ verboseMode }) => {
             case 'step':
                 return { color: 'cyan', dimColor: true };
             case 'multiline':
+            case 'details':
                 return { color: 'gray', dimColor: true };
             case 'html':
                 return { color: 'gray' };
@@ -113,14 +114,14 @@ const LogPane = React.memo(({ verboseMode }) => {
             return null;
         }
         const styles = getLogStyles(log.type);
-        if (log.type === 'multiline') {
+        if (log.type === 'multiline' || log.type === 'details') {
             const cleaned = stripAnsi(dedent(log.content));
             const parsed = parseMarkdownToTerminal(cleaned);
             const lines = parsed.split('\n');
             const maxLines = log.maxLines || 16;
-            const truncated = lines.length > maxLines ? `${lines.slice(0, maxLines).join('\n')}\n... (${lines.length - maxLines} more lines)` : parsed;
+            const content = log.type === 'details' ? parsed : lines.length > maxLines ? `${lines.slice(0, maxLines).join('\n')}\n... (${lines.length - maxLines} more lines)` : parsed;
             return (React.createElement(Box, { key: index, borderStyle: "classic", borderLeft: false, borderRight: false, marginY: 1, padding: 1, borderColor: "dim", overflow: "hidden" },
-                React.createElement(Text, { color: "gray", dimColor: true }, truncated)));
+                React.createElement(Text, { color: "gray", dimColor: true }, content)));
         }
         if (log.type === 'html') {
             // Convert HTML to markdown, then render as multiline