explorbot 0.1.27 → 0.1.29

package/dist/src/ai/tools.js

@@ -4,13 +4,14 @@ 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";
 import { sectionContextRule } from "./rules.js";
 import { isInteractive } from "./task-agent.js";
 const debugLog = createDebug('explorbot:tools');
-export const CODECEPT_TOOLS = ['click', 'pressKey', 'form'];
+export const CODECEPT_TOOLS = ['click', 'hover', 'pressKey', 'form'];
 export const ASSERTION_TOOLS = ['verify'];
 export function createCodeceptJSTools(explorer, task) {
     const stateManager = explorer.getStateManager();
@@ -132,6 +133,71 @@ export function createCodeceptJSTools(explorer, task) {
                 }, action.lastError);
             },
         }),
+        hover: tool({
+            description: dedent `
+        Move the mouse cursor to an element to reveal hover-only controls.
+
+        Use this before clicking row actions, icon buttons, menus, or toolbars that appear only
+        when the user hovers a list item, table row, card, or tree node.
+
+        This tool ONLY accepts I.moveCursorTo(locator) commands. It does not click.
+        After hovering, use context(), see(), or click() the revealed control.
+      `,
+            inputSchema: z.object({
+                commands: z.array(z.string()).describe(dedent `
+          FALLBACK LOCATORS for ONE element to hover.
+          Order by reliability:
+          1. I.moveCursorTo(text, container)
+          2. I.moveCursorTo(ARIA, container)
+          3. I.moveCursorTo(CSS, container)
+          4. I.moveCursorTo(CSS) or I.moveCursorTo(XPath)
+        `),
+                explanation: z.string().describe('Why you are hovering this element'),
+            }),
+            execute: async ({ commands: rawCommands, explanation }) => {
+                const activeNote = task.startNote(explanation);
+                if (rawCommands.length === 0) {
+                    activeNote.commit(TestResult.FAILED);
+                    return failedToolResult('hover', 'No commands provided');
+                }
+                const invalidCommands = rawCommands.map((cmd) => cmd.trim()).filter((cmd) => cmd.startsWith('I.') && !cmd.startsWith('I.moveCursorTo'));
+                if (invalidCommands.length > 0) {
+                    activeNote.commit(TestResult.FAILED);
+                    return failedToolResult('hover', `Invalid commands: ${invalidCommands.join(', ')}. Hover tool only accepts I.moveCursorTo() commands.`, {
+                        suggestion: 'Use click() to click elements, or form() for typing/selecting.',
+                    });
+                }
+                const commands = rawCommands.map((cmd) => {
+                    const trimmed = cmd.trim();
+                    if (trimmed.startsWith('I.moveCursorTo'))
+                        return trimmed;
+                    return `I.moveCursorTo(${JSON.stringify(trimmed)})`;
+                });
+                const previousState = ActionResult.fromState(stateManager.getCurrentState());
+                const action = explorer.createAction();
+                const attempts = [];
+                for (const command of commands) {
+                    const success = await action.attempt(command, explanation, true);
+                    attempts.push({
+                        command,
+                        success,
+                        ...(action.lastError && { error: action.lastError.toString() }),
+                    });
+                    if (!success)
+                        continue;
+                    const toolResult = await ActionResult.fromState(stateManager.getCurrentState()).toToolResult(previousState, command);
+                    activeNote.commit(TestResult.PASSED);
+                    return successToolResult('hover', { ...toolResult, attempts, code: command }, action);
+                }
+                const toolResult = await ActionResult.fromState(stateManager.getCurrentState()).toToolResult(previousState, commands[0]);
+                activeNote.commit(TestResult.FAILED);
+                return failedToolResult('hover', 'All hover commands failed', {
+                    ...toolResult,
+                    attempts,
+                    suggestion: 'Use xpathCheck() to locate the row/card/tree node, or visualClick() if the hover target is only visually identifiable.',
+                }, action.lastError);
+            },
+        }),
         pressKey: tool({
             description: dedent `
         Press a keyboard key or key combination. Use this for special keys like Enter, Escape, Tab, Arrow keys, or key combinations with modifiers.
@@ -243,6 +309,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 +410,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 +444,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 +453,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}`);
                 }
@@ -401,6 +469,7 @@ export function createAgentTools({ explorer, researcher, navigator, experienceTr
         Check the page contents based on current page state and screenshot.
         This tool will trigger visual research to check the page contents on request.
         Use it to verify the actions were performed correctly and the page is in the expected state.
+        Input schema has exactly one field: request. Do not pass text, reason, assertion, or other fields.
 
         <example>
         request: "Check current state of the Login form"
@@ -415,8 +484,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 +499,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 +575,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 +588,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 +641,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 +681,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 +716,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 +749,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 +946,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

package/dist/src/explorbot.js

@@ -23,11 +23,12 @@ import { ConfigParser } from "./config.js";
 import { ExperienceTracker } from "./experience-tracker.js";
 import Explorer from "./explorer.js";
 import { KnowledgeTracker } from "./knowledge-tracker.js";
+import { Stats } from "./stats.js";
 import { Plan } from "./test-plan.js";
-import { parsePlansFromMarkdown } from "./utils/test-plan-markdown.js";
 import { setVerboseMode, tag } from "./utils/logger.js";
 import { relativeToCwd } from "./utils/next-steps.js";
 import { sanitizeFilename } from "./utils/strings.js";
+import { parsePlansFromMarkdown } from "./utils/test-plan-markdown.js";
 export class ExplorBot {
     configParser;
     explorer;
@@ -427,7 +428,11 @@ export class ExplorBot {
             tag('info').log(`Session report saved: ${relativeToCwd(filePath)}`);
             const reporter = this.explorer?.getReporter();
             if (reporter?.isEnabled()) {
-                await reporter.setRunDescription(markdown);
+                let description = markdown;
+                const modelsTable = Stats.modelsTable(this.provider.getConfiguredModels());
+                if (modelsTable)
+                    description = `${markdown}\n\n${modelsTable}`;
+                await reporter.setRunDescription(description);
             }
             this.lastReportedTestCount = tests.length;
         }