explorbot 0.2.4 → 0.3.0

package/dist/boat/prima/src/prima.js

@@ -4,28 +4,29 @@ import { createRequire } from 'node:module';
 import path from 'node:path';
 import { tool } from 'ai';
 import dedent from 'dedent';
-import { z } from 'zod';
 import * as playwright from 'playwright';
+import { z } from 'zod';
 import { ActionResult } from "../../../src/action-result.js";
+import { getPreviousResearch } from "../../../src/ai/researcher/cache.js";
 import { actionRule, locatorRule } from "../../../src/ai/rules.js";
-import { createAgentTools, createCodeceptJSTools } from "../../../src/ai/tools.js";
+import { createAgentTools, createCodeceptJSTools, createRefTools } from "../../../src/ai/tools.js";
 import { getAliveEndpoint, launchServer, listInstances, stopServer } from "../../../src/browser-server.js";
-import { listSites } from "../../../src/global-config.js";
-import { ConfigMissingError, ConfigParser, outputPath } from "../../../src/config.js";
+import { ConfigCommand } from "../../../src/commands/config-command.js";
+import { ConfigMissingError, ConfigParser, EXPLORBOT_ENV_VARS, outputPath } from "../../../src/config.js";
 import { ExplorBot } from "../../../src/explorbot.js";
+import { listSites } from "../../../src/global-config.js";
 import { Reporter } from "../../../src/reporter.js";
 import { Stats } from "../../../src/stats.js";
 import { Task, Test, TestResult } from "../../../src/test-plan.js";
-import { getPreviousResearch } from "../../../src/ai/researcher/cache.js";
 import { compactAriaSnapshot } from "../../../src/utils/aria.js";
-import { mdq } from "../../../src/utils/markdown-query.js";
 import { browserErrorMessage } from "../../../src/utils/browser-errors.js";
 import { pluralize } from "../../../src/utils/logger.js";
+import { mdq } from "../../../src/utils/markdown-query.js";
 import { safeFilename } from "../../../src/utils/strings.js";
 import { writeArtifacts } from "./envelope.js";
 import { isFunctionExpression, takePwValue, toCodeceptWrapper } from "./pw-parser.js";
-import { latestSessionFile, readSession, recordCommand, sessionFile, sessionsDir } from "./session-log.js";
 import { readDescriptors, selectDescriptor } from "./pw-registry.js";
+import { latestSessionFile, readSession, recordCommand, sessionFile, sessionsDir } from "./session-log.js";
 const TESTER_ONLY_TOOLS = ['learnExperience', 'askUser'];
 const ITERATIONS_PER_INSTRUCTION = 2;
 const MAX_INSTRUCTION_ITERATIONS = 24;
@@ -36,7 +37,7 @@ const AI_AGENT_NAME = 'prima';
 const CONNECT_TIMEOUT = 3000;
 const requireLib = createRequire(import.meta.url);
 const VOLATILE_COLUMNS = ['CSS', 'XPath', 'Coordinates', 'eidx'];
-const UNACCOUNTED = { open: 'never reported — the run ended with this instruction still open' };
+const UNACCOUNTED = { open: 'the run ended without confirming this one — the actions above are everything that ran' };
 function dropVolatileColumns(markdown) {
     return mdq(markdown)
         .query('table')
@@ -67,6 +68,7 @@ export class Prima {
     server = null;
     attached = null;
     session = null;
+    artifacts;
     constructor(options = {}) {
         this.options = options;
         this.bot = new ExplorBot({
@@ -80,6 +82,14 @@ export class Prima {
             reporter: { enabled: false },
         });
     }
+    static applyEnv() {
+        for (const { name } of EXPLORBOT_ENV_VARS) {
+            const value = process.env[name.replace('EXPLORBOT_', 'PRIMA_CLI_')];
+            if (!value)
+                continue;
+            process.env[name] = value;
+        }
+    }
     async start() {
         let discovery;
         if (!this.options.endpoint) {
@@ -134,7 +144,7 @@ export class Prima {
         const deps = { explorer: this.bot.getExplorer(), stateManager: this.bot.stateManager(), ai: provider };
         const ledger = instructions.map((text) => ({ text, status: 'open', proof: '' }));
         const descent = { markup: false };
-        const tools = { ...createCodeceptJSTools(deps, task), ...this.testerTools(deps), context: this.contextTool(descent), completed: this.completedTool(), blocked: this.blockedTool() };
+        const tools = { ...createCodeceptJSTools(deps, task), ...createRefTools(deps, task), ...this.testerTools(deps), context: this.contextTool(descent), completed: this.completedTool(), blocked: this.blockedTool() };
         conversation.addUserText(await this.instructionPrompt(instructions, await this.capturedResult(previousState)));
         const used = [];
         const trace = [];
@@ -208,18 +218,18 @@ export class Prima {
         }
         if (aiError)
             return this.failureEnvelope(command, aiError, previousState);
-        if (used.length && ledger.some((entry) => entry.status === 'open')) {
+        if (trace.length && ledger.some((entry) => entry.status === 'open')) {
             await this.settleLedger(conversation, provider, ledger, trace);
         }
         const unfinished = ledger.filter((entry) => entry.status !== 'done');
-        const steps = [...trace, ...ledger.filter((entry) => entry.status === 'open').map((entry) => ({ label: `unreported: ${entry.text}`, ok: false, proof: UNACCOUNTED.open }))];
+        const steps = [...trace, ...ledger.filter((entry) => entry.status === 'open').map((entry) => ({ label: entry.text, ok: false, unconfirmed: true, proof: UNACCOUNTED.open }))];
         if (failure && unfinished.length) {
             const envelope = await this.failureEnvelope(command, failure.message, previousState);
             envelope.steps = steps;
             envelope.stepFiles = this.statusDir();
             return envelope;
         }
-        if (!used.length && unfinished.length === ledger.length) {
+        if (!trace.length && unfinished.length === ledger.length) {
             const reason = ['No action was performed for these instructions on the current page.', narration].filter(Boolean).join(' ');
             return this.failureEnvelope(command, reason, previousState);
         }
@@ -230,10 +240,10 @@ export class Prima {
         // the step log already reports every action and what it changed
         envelope.used = undefined;
         envelope.changes = undefined;
-        const unmet = unfinished.map((entry) => `${entry.status}: ${entry.text}${entry.proof ? ` — ${entry.proof}` : ''}`);
-        if (unmet.length) {
+        const blocked = ledger.filter((entry) => entry.status === 'blocked');
+        if (blocked.length) {
             envelope.ok = false;
-            envelope.failure = { error: unmet.join('\n') };
+            envelope.failure = { error: blocked.map((entry) => `blocked: ${entry.text}${entry.proof ? ` — ${entry.proof}` : ''}`).join('\n') };
         }
         return envelope;
     }
@@ -281,7 +291,13 @@ export class Prima {
       instructions have moved it on, and something you confirmed earlier stays confirmed even if it is gone.
       completed() for those, blocked() for the ones the page could not do. Report every one — nothing else runs after this.
     `);
-        const invoked = await provider.invokeConversation(conversation, { completed: this.completedTool(), blocked: this.blockedTool() }, { maxToolRoundtrips: 2, toolChoice: 'required', agentName: AI_AGENT_NAME }).catch(() => null);
+        let settleError = null;
+        const invoked = await provider.invokeConversation(conversation, { completed: this.completedTool(), blocked: this.blockedTool() }, { maxToolRoundtrips: 2, toolChoice: 'required', agentName: AI_AGENT_NAME }).catch((error) => {
+            settleError = error;
+            return null;
+        });
+        if (settleError)
+            trace.push({ label: 'settling which instructions were satisfied', ok: false, proof: browserErrorMessage(settleError) });
         for (const execution of invoked?.toolExecutions || []) {
             this.applyLedgerReport(execution, ledger, trace);
         }
@@ -305,17 +321,32 @@ export class Prima {
         const outcomes = expected.length ? expected : [scenario];
         const test = new Test(scenario, 'normal', outcomes, previousState?.url || this.options.url || '');
         const tester = this.bot.agentTester();
-        const outcome = await tester.test(test);
+        await tester.test(test, { startOnCurrentPage: true });
         const notes = Object.values(test.notes || {});
-        const result = await this.capturedResult(this.bot.stateManager().getCurrentState());
-        const envelope = await this.reportEnvelope(command, result, previousState, { ok: outcome.success });
+        const result = await this.capturedResult(this.bot.stateManager().getCurrentState(), { screenshot: this.visionEnabled() });
+        const envelope = await this.reportEnvelope(command, result, previousState, {});
         const recorded = notes.filter((note) => !note.observation && !outcomes.includes(note.message));
         const failed = recorded.filter((note) => note.status === TestResult.FAILED);
         envelope.steps = failed.map((note) => ({ label: note.message, ok: false, proof: note.log || '' }));
         const routine = recorded.length - failed.length;
         if (routine)
             envelope.steps.push({ label: `${routine} further ${pluralize(routine, 'step')} ran without failing — prima status ${envelope.status} for the full log`, ok: true, proof: '' });
-        envelope.expectations = await this.bot.agentPilot().settleExpectations(test);
+        envelope.expectations = await this.bot.agentPilot().settleExpectations(test, result);
+        if (!result.screenshot || !this.visionEnabled()) {
+            envelope.warning = 'These outcomes were settled from the run log alone — no screenshot backed them. Set ai.visionModel, or check anything visual with prima ask.';
+        }
+        const unreached = envelope.expectations.filter((expectation) => expectation.status === 'failed');
+        const contradicted = envelope.expectations.filter((expectation) => expectation.status === 'contradiction');
+        envelope.ok = !unreached.length && !contradicted.length;
+        const problems = [...unreached.map((expectation) => `not reached: ${expectation.text}`), ...contradicted.map((expectation) => `the picture and the run disagree about: ${expectation.text}`)];
+        if (problems.length)
+            envelope.failure = { error: problems.join('\n') };
+        if (contradicted.length)
+            envelope.artifacts = this.artifacts;
+        if (!test.hasFinished || test.isSkipped) {
+            envelope.ok = false;
+            envelope.failure = { error: `the run did not complete, so it established nothing about the app: ${notes.at(-1)?.message || 'no steps were recorded'}` };
+        }
         const observations = notes.filter((note) => note.observation).map((note) => note.message);
         if (observations.length)
             envelope.answer = ['Page problems noticed while running, not step failures:', ...observations.map((line) => `- ${line}`)].join('\n');
@@ -338,7 +369,14 @@ export class Prima {
         const previousState = this.bot.stateManager().getCurrentState();
         const result = await this.capturedResult(previousState);
         const verification = await this.bot.agentNavigator().verifyState(assertion, result);
-        return this.reportEnvelope(command, result, previousState, { assertions: verification.results || [] });
+        const outcome = { assertions: verification.results || [] };
+        if (verification.inexpressible) {
+            const question = `Judging only from the screenshot, is this true of the page: "${assertion}"? Answer true, false or undetermined, and say what settles it.`;
+            const seen = await this.visionAnswer(question, await this.capturedResult(previousState, { screenshot: this.visionEnabled() }));
+            if (seen)
+                outcome.answer = `No assertion could express this claim, so it was judged from a screenshot instead.\n\n${seen}`;
+        }
+        return this.reportEnvelope(command, result, previousState, outcome);
     }
     async research(opts = {}) {
         const flags = [opts.data && '--data', opts.deep && '--deep', opts.fresh && '--fresh'].filter(Boolean);
@@ -398,27 +436,13 @@ export class Prima {
         }
         return stopped;
     }
-    async config() {
+    async config(json) {
         const [site] = listSites();
         if (site && !this.configBaseUrl())
             this.sessionUrl = site.url;
         const config = await this.loadConfig();
-        const named = (model) => {
-            if (typeof model === 'string')
-                return model;
-            return model?.modelId || model?.model || 'unknown';
-        };
-        const ai = config.ai || {};
-        const roles = [
-            ['model', ai.model],
-            ['agenticModel', ai.agenticModel],
-            ['visionModel', ai.visionModel],
-        ];
-        const lines = roles.filter(([, model]) => model).map(([role, model]) => `${role.padEnd(14)} ${named(model)}`);
-        lines.push(`config         ${ConfigParser.getInstance().getConfigPath() || 'built-in defaults'}`);
-        if (ai.langfuse?.enabled)
-            lines.push('telemetry      langfuse');
-        return lines.join('\n');
+        const parser = ConfigParser.getInstance();
+        return ConfigCommand.render(config, { configPath: parser.getConfigPath(), root: parser.getProjectRoot(), json });
     }
     record(envelope, durationMs) {
         if (!this.session)
@@ -706,6 +730,7 @@ export class Prima {
       <proof>
       An instruction is done only when a change on the page shows it. After each action read the reported change and decide which part of it proves the instruction.
       That part is what completed() takes as its proof. Do not restate the action as if it were the outcome.
+      How much of the page moved is not evidence of whether it happened — a change confined to one region proves an instruction as well as one that redraws everything.
       An instruction that only inspects the page is satisfied by what you can see, including seeing that something is absent — those need no action at all.
       </proof>
 
@@ -856,6 +881,8 @@ export class Prima {
     visionEnabled() {
         if (this.options.noVision)
             return false;
+        if (Stats.visionDisabled)
+            return false;
         return this.bot.getProvider().hasVision?.() === true;
     }
     async answer(question, result) {
@@ -964,7 +991,13 @@ export class Prima {
         if (!previousState)
             return 'no snapshot was captured before this command, so nothing could be compared';
         const toolResult = await result.toToolResult(ActionResult.fromState(previousState), code);
-        return toolResult.pageDiff?.ariaChanges || 'no change';
+        const pageDiff = toolResult.pageDiff;
+        if (!pageDiff?.urlChanged)
+            return pageDiff?.ariaChanges || 'no change';
+        const lines = [`left ${previousState.url} for ${result.url}`];
+        for (const message of pageDiff.messages ?? [])
+            lines.push(`- ${message}`);
+        return lines.join('\n');
     }
     async status(hash) {
         const dir = this.statusDir(hash);
@@ -976,7 +1009,6 @@ export class Prima {
             ok: true,
             command: `status ${hash}`,
             page: saved.page,
-            changes: saved.changes,
             instance: await this.instanceInfo(),
             artifacts: { aria: path.join(dir, 'aria.yml'), html: path.join(dir, 'page.html') },
         };
@@ -984,7 +1016,7 @@ export class Prima {
     async saveStatus(result) {
         const hash = this.statusHash();
         await this.writeSnapshot(result);
-        writeFileSync(path.join(this.statusDir(hash), 'status.json'), JSON.stringify({ page: this.pageBlock(result, null), changes: compactAriaSnapshot(result.ariaSnapshot, true) }), 'utf-8');
+        writeFileSync(path.join(this.statusDir(hash), 'status.json'), JSON.stringify({ page: this.pageBlock(result, null) }), 'utf-8');
         return hash;
     }
     async writeStepFiles(index, label, diff) {
@@ -1001,12 +1033,12 @@ export class Prima {
             writeFileSync(`${stem}.diff.yaml`, diff, 'utf-8');
     }
     async writeSnapshot(result) {
-        writeArtifacts(this.statusDir(), {
+        this.artifacts = writeArtifacts(this.statusDir(), {
             aria: result.ariaSnapshot,
             html: await result.combinedHtml(),
+            screenshot: result.screenshot,
             requests: this.bot.requestStore().getRequests(),
         });
-        return undefined;
     }
     statusHash() {
         this.hash ||= createHash('sha1')

package/dist/models.json

@@ -1,8 +1,8 @@
 {
   "openrouter": {
     "model": "openai/gpt-oss-20b:nitro",
-    "visionModel": "google/gemma-4-31b-it:nitro",
-    "agenticModel": "google/gemma-4-31b-it:nitro"
+    "visionModel": "openai/gpt-5.6-luna",
+    "agenticModel": "openai/gpt-5.6-luna"
   },
   "poolside": {
     "model": "poolside/laguna-xs-2.1"
@@ -13,8 +13,8 @@
     "agenticModel": "qwen/qwen3.6-27b"
   },
   "openai": {
-    "model": "gpt-5.4-nano",
-    "visionModel": "gpt-5.4-nano",
+    "model": "gpt-5-nano",
+    "visionModel": "gpt-5.6-luna",
     "agenticModel": "gpt-5.6-luna"
   },
   "anthropic": {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "explorbot",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "description": "CLI app built with React Ink, CodeceptJS, and Playwright",
   "license": "Elastic-2.0",
   "type": "module",
@@ -30,6 +30,7 @@
     "boat/prima/src/**/*.ts",
     "boat/prima/bin/**/*.ts",
     "boat/prima/package.json",
+    "boat/prima/README.md",
     "rules/",
     "assets/sample-files/",
     "models.json"
@@ -58,7 +59,8 @@
     "lint:fix": "biome lint --write .",
     "check": "biome check .",
     "check:fix": "biome check --write .",
-    "langfuse:export": "bun run .claude/skills/explorbot-debug/langfuse-export.ts"
+    "langfuse:export": "bun run .claude/skills/explorbot-debug/langfuse-export.ts",
+    "build:prima": "bun run scripts/build-prima-npm.ts"
   },
   "keywords": [
     "cli",
@@ -97,6 +99,7 @@
     "ai": "^7.0.2",
     "axe-core": "^4.11.1",
     "bash-tool": "^1.3.15",
+    "chalk": "^5.6.2",
     "cli-highlight": "^2.1.11",
     "codeceptjs": "4.0.0-rc.16",
     "commander": "^14.0.1",
@@ -121,6 +124,7 @@
     "parse5": "^8.0.0",
     "pixelmatch": "^7.2.0",
     "playwright": "^1.62",
+    "playwright-core": "^1.62",
     "pngjs": "^7.0.0",
     "react": "^19.1.1",
     "sambanova-ai-provider": "^1.2.2",

package/dist/src/action-result.d.ts

@@ -17,6 +17,7 @@ interface ActionResultData extends WebPageState {
     h3?: string | undefined;
     h4?: string | undefined;
     browserLogs?: any[];
+    networkRequests?: NetworkCall[];
     iframeSnapshots?: Array<{
         src: string;
         html: string;
@@ -34,6 +35,9 @@ export interface PageDiff {
     currentUrl: string;
     ariaChanges?: string | null;
     ariaChangeCount?: number;
+    messages?: string[];
+    requests?: NetworkCall[];
+    consoleErrors?: string[];
     htmlParts?: HtmlDiffPart[];
     iframes?: string;
 }
@@ -57,6 +61,7 @@ export declare class ActionResult implements ActionResultData {
     url: string;
     fullUrl: string | undefined;
     browserLogs: any[];
+    networkRequests: NetworkCall[];
     iframeSnapshots: Array<{
         src: string;
         html: string;
@@ -111,11 +116,13 @@ export declare class ActionResult implements ActionResultData {
     getStateHash(): string;
     diff(previousState: ActionResult | null): Promise<Diff>;
     toToolResult(previousState: ActionResult | null, locator: string): Promise<ToolResultMetadata>;
+    consoleErrors(): string[];
 }
 export declare class Diff {
     current: ActionResult;
     previous: ActionResult | null;
     _htmlDiffResult: HtmlDiffResult | null;
+    _messages: string[];
     _ariaDiffResult: string | null;
     _ariaChangeCount: number;
     _isSameUrl: boolean;
@@ -128,8 +135,14 @@ export declare class Diff {
     get ariaChanged(): string | null;
     get ariaChangeCount(): number;
     get htmlDiff(): HtmlDiffResult | null;
+    get messages(): string[];
     calculate(): Promise<void>;
 }
+export interface NetworkCall {
+    method: string;
+    path: string;
+    status: number;
+}
 export interface FocusedElement {
     role: string;
     name: string;

package/dist/src/action-result.js

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import { ConfigParser, outputPath } from "./config.js";
 import { LARGE_ARIA_CHANGE_THRESHOLD, compactAriaSnapshot, diffAriaSnapshots } from "./utils/aria.js";
 import { TTLCache } from "./utils/cache.js";
-import { htmlDiff } from "./utils/html-diff.js";
+import { htmlDiff, liveRegionMessages } from "./utils/html-diff.js";
 import { extractHeadings, extractLinks, extractTargetedHtml, htmlCombinedSnapshot, htmlMinimalUISnapshot, htmlTextSnapshot, minifyHtml } from "./utils/html.js";
 import { createDebug } from "./utils/logger.js";
 import { slugify } from "./utils/strings.js";
@@ -21,6 +21,7 @@ export class ActionResult {
     url = '';
     fullUrl = undefined;
     browserLogs = [];
+    networkRequests = [];
     iframeSnapshots = [];
     iframeURL = undefined;
     screenshotFile = undefined;
@@ -45,6 +46,7 @@ export class ActionResult {
         this.httpStatus = data.httpStatus;
         this.error = data.error ?? null;
         this.browserLogs = data.browserLogs ?? [];
+        this.networkRequests = data.networkRequests ?? [];
         this.iframeSnapshots = data.iframeSnapshots ?? [];
         this.iframeURL = data.iframeURL;
         this.notes = data.notes ?? [];
@@ -415,20 +417,25 @@ export class ActionResult {
         if (previousState?.id !== undefined && this.id === previousState.id) {
             return result;
         }
-        const urlChanged = previousState ? !this.isSameUrl({ url: previousState.url }) : true;
-        if (!previousState) {
-            result.pageDiff = {
-                urlChanged: true,
-                currentUrl: this.url,
-            };
-            return result;
-        }
-        const diff = await this.diff(previousState);
         const pageDiff = {
-            urlChanged,
-            previousUrl: previousState.url,
+            urlChanged: previousState ? !this.isSameUrl({ url: previousState.url }) : true,
             currentUrl: this.url,
         };
+        result.pageDiff = pageDiff;
+        if (this.networkRequests.length > 0) {
+            pageDiff.requests = this.networkRequests;
+        }
+        const consoleErrors = this.consoleErrors();
+        if (consoleErrors.length > 0) {
+            pageDiff.consoleErrors = consoleErrors;
+        }
+        if (!previousState)
+            return result;
+        pageDiff.previousUrl = previousState.url;
+        const diff = await this.diff(previousState);
+        if (diff.messages.length > 0) {
+            pageDiff.messages = diff.messages;
+        }
         if (diff.ariaChanged) {
             pageDiff.ariaChanges = diff.ariaChanged;
             pageDiff.ariaChangeCount = diff.ariaChangeCount;
@@ -452,10 +459,27 @@ export class ActionResult {
                 pageDiff.iframes = this.iframeSnapshots.map((snap) => `iframe src="${snap.src}":\n${snap.html}`).join('\n\n');
             }
         }
-        result.pageDiff = pageDiff;
         return result;
     }
+    consoleErrors() {
+        const errors = [];
+        for (const log of this.browserLogs) {
+            if ((log.type || log.level) !== 'error')
+                continue;
+            const text = String(log.text || log.message || log).trim();
+            if (!text)
+                continue;
+            if (errors.includes(text))
+                continue;
+            errors.push(text.slice(0, CONSOLE_ERROR_MAX_LENGTH));
+            if (errors.length === CONSOLE_ERROR_LIMIT)
+                break;
+        }
+        return errors;
+    }
 }
+const CONSOLE_ERROR_MAX_LENGTH = 300;
+const CONSOLE_ERROR_LIMIT = 3;
 const HTML_PARTS_TOTAL_BUDGET = 8000;
 const HTML_PARTS_COUNT_LIMIT = 8;
 const HTML_PART_SUBTREE_BUDGET = 2000;
@@ -482,6 +506,7 @@ export class Diff {
     current;
     previous;
     _htmlDiffResult = null;
+    _messages = [];
     _ariaDiffResult = null;
     _ariaChangeCount = 0;
     _isSameUrl;
@@ -524,12 +549,18 @@ export class Diff {
     get htmlDiff() {
         return this._htmlDiffResult;
     }
+    get messages() {
+        return this._messages;
+    }
     async calculate() {
         if (!this.previous)
             return;
-        if (this._isSameUrl) {
-            this._htmlDiffResult = await htmlDiff(this.previous.html, this.current.html, ConfigParser.getInstance().getConfig().html);
+        if (!this._isSameUrl) {
+            this._messages = liveRegionMessages(this.previous.html, this.current.html);
+            return;
         }
+        this._htmlDiffResult = await htmlDiff(this.previous.html, this.current.html, ConfigParser.getInstance().getConfig().html);
+        this._messages = this._htmlDiffResult.messages;
         const ariaDiff = diffAriaSnapshots(this.previous.ariaSnapshot, this.current.ariaSnapshot);
         this._ariaDiffResult = ariaDiff.text;
         this._ariaChangeCount = ariaDiff.count;

package/dist/src/action.d.ts

@@ -1,4 +1,4 @@
-import { ActionResult } from './action-result.js';
+import { ActionResult, type NetworkCall } from './action-result.js';
 import type { ExplorbotConfig } from './config.js';
 import type { PlaywrightRecorder } from './playwright-recorder.js';
 import type { StateManager } from './state-manager.js';
@@ -19,6 +19,8 @@ declare class Action {
     recorder?: PlaywrightRecorder;
     recovery: RecoveryRunner;
     mainDocumentStatus: number | undefined;
+    networkRequests: NetworkCall[];
+    baseOrigin: string;
     constructor(actor: CodeceptJS.I, stateManager: StateManager, recorder?: PlaywrightRecorder, recovery?: RecoveryRunner);
     saveScreenshot(): Promise<string | undefined>;
     capturePageState(opts?: {
@@ -31,7 +33,8 @@ declare class Action {
         codeBlock?: string;
     }): Promise<ActionResult>;
     captureMainDocumentStatus(): Promise<number | undefined>;
-    captureMainDocumentResponse(): () => void;
+    captureResponses(): () => void;
+    recordNetworkCall(request: any, status: number): void;
     /**
      * Capture HTML snapshots of all iframes on the page
      */