explorbot 0.2.5 → 0.3.0

package/dist/src/utils/html-diff.js

@@ -2,6 +2,10 @@ import { parse, serialize } from 'parse5';
 import { TAILWIND_CLASS_PATTERNS, TRASH_HTML_CLASSES, minifyHtml } from "./html.js";
 import { isDynamicId, isGenericClass } from "./xpath.js";
 const IGNORED_PATHS = new Set(['html[1]', 'html[1]/head[1]', 'html[1]/body[1]']);
+const LIVE_REGION_ROLES = new Set(['alert', 'alertdialog', 'status', 'log']);
+const TEXT_LINE_PREFIX = 'TEXT:';
+const MESSAGE_MAX_LENGTH = 200;
+const MESSAGE_LIMIT = 8;
 /**
  * Get text content from an element node.
  */
@@ -141,7 +145,9 @@ export async function htmlDiff(originalHtml, modifiedHtml, htmlConfig) {
     const modifiedLines = flattenHtml(modifiedRoot);
     const similarity = calculateSimilarity(originalLines, modifiedLines);
     const { added, removed } = findDifferences(originalLines, modifiedLines);
-    const parts = await buildDiffParts(originalDocument, modifiedDocument);
+    const originalMap = collectElementMap(originalDocument);
+    const modifiedMap = collectElementMap(modifiedDocument);
+    const parts = await buildDiffParts(originalMap, modifiedMap);
     const structuralAdditions = parts.flatMap((p) => p.added.filter((a) => a.startsWith('ELEMENT:')));
     const allAdded = [...added, ...structuralAdditions];
     const totalChanges = allAdded.length + removed.length;
@@ -152,8 +158,63 @@ export async function htmlDiff(originalHtml, modifiedHtml, htmlConfig) {
         removed,
         similarity,
         summary,
+        messages: collectMessages(originalMap, modifiedMap, allAdded),
     };
 }
+/**
+ * Text the app announced while the page stayed the same: live region content first, then any other text that appeared.
+ */
+function collectMessages(originalMap, modifiedMap, added) {
+    const appearedText = added.filter((line) => line.startsWith(TEXT_LINE_PREFIX)).map((line) => line.slice(TEXT_LINE_PREFIX.length));
+    return limitMessages([...collectLiveRegionTexts(originalMap, modifiedMap), ...appearedText]);
+}
+/**
+ * Text the app announced across a navigation. Only live regions: everything else on a new page is its content, not a message.
+ */
+export function liveRegionMessages(originalHtml, modifiedHtml) {
+    const originalMap = collectElementMap(parseDocument(originalHtml));
+    const modifiedMap = collectElementMap(parseDocument(modifiedHtml));
+    return limitMessages(collectLiveRegionTexts(originalMap, modifiedMap));
+}
+function limitMessages(candidates) {
+    const messages = [];
+    for (const candidate of candidates) {
+        const text = candidate.replace(/\s+/g, ' ').trim().slice(0, MESSAGE_MAX_LENGTH);
+        if (!text)
+            continue;
+        if (messages.some((message) => message.includes(text)))
+            continue;
+        messages.push(text);
+        if (messages.length === MESSAGE_LIMIT)
+            break;
+    }
+    return messages;
+}
+function collectLiveRegionTexts(originalMap, modifiedMap) {
+    const texts = [];
+    for (const [path, element] of modifiedMap) {
+        if (!isLiveRegion(element))
+            continue;
+        const text = getTextContent(element).trim();
+        if (!text)
+            continue;
+        const previous = originalMap.get(path);
+        if (previous && getTextContent(previous).trim() === text)
+            continue;
+        texts.push(text);
+    }
+    return texts;
+}
+function isLiveRegion(element) {
+    if (element.tagName?.toLowerCase() === 'output')
+        return true;
+    const attrs = element.attrs ?? [];
+    const role = attrs.find((attr) => attr.name === 'role')?.value.toLowerCase();
+    if (role && LIVE_REGION_ROLES.has(role))
+        return true;
+    const live = attrs.find((attr) => attr.name === 'aria-live')?.value.toLowerCase();
+    return live === 'polite' || live === 'assertive';
+}
 /**
  * Parse HTML into a document, wrapping fragments with html/body for consistency.
  * Uses custom sanitization that removes iframes for diff purposes.
@@ -354,9 +415,7 @@ function findStableContainer(topLevelPath, originalMap, modifiedMap) {
     }
     return { path: 'html[1]/body[1]', selector: 'body' };
 }
-async function buildDiffParts(originalDocument, modifiedDocument) {
-    const originalMap = collectElementMap(originalDocument);
-    const modifiedMap = collectElementMap(modifiedDocument);
+async function buildDiffParts(originalMap, modifiedMap) {
     const addedPaths = [];
     const changedPaths = [];
     for (const [path, element] of modifiedMap.entries()) {
@@ -624,7 +683,7 @@ function flattenHtml(node) {
     function process(n) {
         if (n.type === 'text' && n.content) {
             if (n.content.length >= 5) {
-                lines.push(`TEXT:${n.content}`);
+                lines.push(`${TEXT_LINE_PREFIX}${n.content}`);
             }
             return;
         }
@@ -643,7 +702,7 @@ function flattenHtml(node) {
                 return;
             }
             if (n.content && n.content.length >= 5) {
-                lines.push(`TEXT:${n.content}`);
+                lines.push(`${TEXT_LINE_PREFIX}${n.content}`);
             }
             if (n.children) {
                 n.children.forEach((child) => process(child));

package/dist/src/utils/strings.d.ts

@@ -3,3 +3,5 @@ export declare function slugify(text: string): string;
 export declare function normalizeInlineText(text: string): string;
 export declare function sanitizeFilename(name: string): string;
 export declare function safeFilename(name: string, ext?: string, maxBytes?: number): string;
+export declare function truncate(text: string, max: number): string;
+export declare function compactErrorMessage(error: unknown): string;

package/dist/src/utils/strings.js

@@ -1,4 +1,5 @@
 import { createHash } from 'node:crypto';
+import stripAnsi from 'strip-ansi';
 export function truncateJson(input) {
     if (!input)
         return '';
@@ -36,3 +37,34 @@ export function safeFilename(name, ext = '', maxBytes = 240) {
     }
     return truncated + suffix + ext;
 }
+export function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max - 3)}...`;
+}
+const MAX_COMPACT_ERROR = 400;
+export function compactErrorMessage(error) {
+    let text = stripAnsi(String(error));
+    for (const strip of STRIP_STRATEGIES) {
+        text = strip(text);
+    }
+    return truncate(text, MAX_COMPACT_ERROR);
+}
+function stripCallLog(text) {
+    const CALL_LOG = 'Call log:';
+    const NOISE = ['attempting', 'retrying', 'waiting'];
+    const [headline, ...log] = text.split(CALL_LOG);
+    if (!log.length)
+        return text;
+    const lines = new Set();
+    for (const line of log.join(CALL_LOG).split('\n')) {
+        const cleaned = normalizeInlineText(line);
+        if (!cleaned)
+            continue;
+        if (NOISE.some((noise) => cleaned.includes(noise)))
+            continue;
+        lines.add(cleaned);
+    }
+    return [headline.trim(), ...lines].join(' ');
+}
+const STRIP_STRATEGIES = [stripCallLog];

package/dist/src/utils/url-matcher.d.ts

@@ -1,5 +1,6 @@
 export declare function isDynamicSegment(segment: string): boolean;
 export declare function hasDynamicUrlSegment(url: string): boolean;
+export declare function isSamePageFamily(urlA: string, urlB: string): boolean;
 export declare function generalizeSegment(segment: string): string;
 export declare function generalizeUrl(url: string): string;
 export declare function matchesUrl(pattern: string, path: string): boolean;

package/dist/src/utils/url-matcher.js

@@ -32,6 +32,23 @@ export function isDynamicSegment(segment) {
 export function hasDynamicUrlSegment(url) {
     return url.split('/').some((seg) => seg.length > 0 && isDynamicSegment(seg));
 }
+export function isSamePageFamily(urlA, urlB) {
+    const partsA = new URL(urlA, 'http://localhost').pathname.toLowerCase().split('/').filter(Boolean);
+    const partsB = new URL(urlB, 'http://localhost').pathname.toLowerCase().split('/').filter(Boolean);
+    if (partsA.length !== partsB.length)
+        return false;
+    let diffCount = 0;
+    for (let i = 0; i < partsA.length; i++) {
+        if (partsA[i] === partsB[i])
+            continue;
+        diffCount++;
+        if (diffCount > 1)
+            return false;
+        if (!isDynamicSegment(partsA[i]) || !isDynamicSegment(partsB[i]))
+            return false;
+    }
+    return true;
+}
 export function generalizeSegment(segment) {
     if (/^\d+$/.test(segment))
         return '\\d+';
@@ -111,6 +128,18 @@ export function matchesNavigationUrl(expected, current) {
     if (!expectedPath.includes('?')) {
         currentPath = currentPath.split('?')[0];
     }
-    const normalize = (value) => value.replace(/^\/+|\/+$/g, '').toLowerCase();
-    return normalize(expectedPath) === normalize(currentPath);
+    const normalize = (value) => value.replace(/^\/+|\/+$/g, '');
+    const expectedNormalized = normalize(expectedPath);
+    const currentNormalized = normalize(currentPath);
+    const expectedKey = expectedNormalized.toLowerCase();
+    const currentKey = currentNormalized.toLowerCase();
+    if (expectedKey === currentKey)
+        return true;
+    if (!currentKey.startsWith(`${expectedKey}/`))
+        return false;
+    const recordSegments = currentNormalized
+        .slice(expectedKey.length + 1)
+        .split('/')
+        .filter(Boolean);
+    return recordSegments.length > 0 && recordSegments.every(isDynamicSegment);
 }

package/docs/basics/getting-started.md

@@ -32,30 +32,53 @@ OPENROUTER_API_KEY=sk-...
 Then open `explorbot.config.js` and set your app's base URL — the host only, no path:
 
 ```javascript
-import { createOpenRouter } from '@openrouter/ai-sdk-provider';
-
-const openrouter = createOpenRouter({
-  apiKey: process.env.OPENROUTER_API_KEY,
-});
-
 export default {
   web: {
     url: 'http://localhost:3000',
   },
   ai: {
-    model: openrouter('openai/gpt-oss-20b:nitro'),
-    visionModel: openrouter('google/gemma-4-31b-it'),
-    agenticModel: openrouter('minimax/minimax-m2.5:nitro'),
+    model: 'openrouter/openai/gpt-oss-20b:nitro',
+    visionModel: 'openrouter/openai/gpt-5.6-luna',
+    agenticModel: 'openrouter/openai/gpt-5.6-luna',
   },
 };
 ```
 
+That shorthand — `'provider/model-id'` — uses a provider package Explorbot ships, so nothing extra is installed. Bundled providers:
+
+- `openai`
+- `anthropic`
+- `google`
+- `groq`
+- `mistral`
+- `openrouter`
+- `sambanova`
+
+The other style is explicit: install a Vercel AI SDK package (`npm i @ai-sdk/openai`) and build the client yourself. It works for the providers above too, and it is the only way to reach one that isn't bundled, a custom `baseURL`, or extra client options:
+
+```javascript
+import { createOpenAI } from '@ai-sdk/openai';
+
+const poolside = createOpenAI({
+  apiKey: process.env.POOLSIDE_API_KEY,
+  baseURL: 'https://inference.poolside.ai/v1',
+});
+
+export default {
+  ai: {
+    model: poolside('poolside/laguna-xs-2.1'),
+  },
+};
+```
+
+Both styles mix freely across the three keys. See [Providers](./providers.md).
+
 Explorbot uses three models. Pick each one for speed and cost:
 
 | Model | Config key | Used by | Pick |
 |-------|-----------|---------|------|
 | `model` | `ai.model` | Tester, Navigator, Researcher — they read HTML and ARIA on every step | a fast, cheap model (e.g. `openai/gpt-oss-20b:nitro`) |
-| `visionModel` | `ai.visionModel` | screenshot analysis | a vision model (e.g. `google/gemma-4-31b-it`) |
+| `visionModel` | `ai.visionModel` | screenshot analysis | a vision model (e.g. `openai/gpt-5.6-luna`) |
 | `agenticModel` | `ai.agenticModel` | Captain and Pilot — they read short action logs and make the big decisions | a smarter model (e.g. MiniMax 2.5, Grok Fast) |
 
 Captain and Pilot barely use tokens, so a smarter `agenticModel` improves results for almost no extra cost. OpenRouter is the simplest start — one key, many models. To use OpenAI, Anthropic, Groq, or others, see [Providers](./providers.md). For every config option, see [Configuration](../reference/configuration.md).

package/docs/basics/providers.md

@@ -2,6 +2,8 @@
 
 Explorbot connects to AI providers through the [Vercel AI SDK](https://sdk.vercel.ai/). Use any supported provider, and mix providers across different models.
 
+Every provider below is set up the classical way: install its package, import it, build the client. Explorbot bundles some of these packages — for those you can skip the install and name the model as `'provider/model-id'` instead. See [Getting Started](./getting-started.md#2-configure) for that list and the two styles side by side.
+
 > The `export default` config block inside each `<!-- START/END provider -->` marker is generated from [`models.json`](../../models.json). After editing that file, run `bunosh docs:sync`. Everything else — including the import blocks — is hand-written.
 
 ## Requirements
@@ -51,8 +53,8 @@ Set the recommended models in the exported config:
 export default {
   ai: {
     model: openrouter('openai/gpt-oss-20b:nitro'),
-    visionModel: openrouter('google/gemma-4-31b-it:nitro'),
-    agenticModel: openrouter('google/gemma-4-31b-it:nitro'),
+    visionModel: openrouter('openai/gpt-5.6-luna'),
+    agenticModel: openrouter('openai/gpt-5.6-luna'),
   },
 };
 ```
@@ -118,8 +120,8 @@ Set the recommended models in the exported config:
 ```javascript
 export default {
   ai: {
-    model: openai('gpt-5.4-nano'),
-    visionModel: openai('gpt-5.4-nano'),
+    model: openai('gpt-5-nano'),
+    visionModel: openai('gpt-5.6-luna'),
     agenticModel: openai('gpt-5.6-luna'),
   },
 };

package/docs/contributing/npm-package.md

@@ -6,7 +6,7 @@ Explorbot develops on Bun but ships to npm as a Node.js-compatible package. This
 
 - Bun (for development and running the build)
 - Node.js >= 24 (for verifying the build output)
-- npm account with publish access to `explorbot` package
+- npm account with publish access to `explorbot` and `prima-cli`, for publishing by hand; releases go out over OIDC (see [Trusted Publishing and Provenance](#trusted-publishing-and-provenance))
 
 ## How the Build Works
 
@@ -90,14 +90,16 @@ Key `package.json` fields:
     "boat/prima/src/**/*.ts",
     "boat/prima/bin/**/*.ts",
     "boat/prima/package.json",
+    "boat/prima/README.md",
     "rules/",
-    "assets/sample-files/"
+    "assets/sample-files/",
+    "models.json"
   ],
   "engines": { "node": ">=24.0.0" }
 }
 ```
 
-The package ships two commands: `explorbot`, and `prima` for the [prima boat](../reference/commands.md#prima-boat), so `npx -p explorbot prima <command>` works without a separate install.
+The package ships two commands, `explorbot` and `prima` for the [prima boat](../reference/commands.md#prima-boat). Prima is also mounted as a subcommand, so `npx explorbot prima <command>`, `npx -p explorbot prima <command>` and the standalone [`prima-cli`](#publishing-prima-cli) package all reach the same code.
 
 Explorbot is both a CLI (`bin`) and a library (`exports`). The `.` entry point is `src/index.ts`, a side-effect-free barrel that re-exports the public API (`ExplorBot`, `Plan`, `Test`, and their types). The `exports` conditions are ordered so each consumer gets the right entry: `types` (the emitted `.d.ts`) for type-checking, `bun` (the TypeScript source) under Bun, and `import` (the compiled JS) under Node.js. This is why the source `src/**` files ship alongside `dist/`.
 
@@ -127,6 +129,73 @@ npm version patch  # or minor, major
 npm publish
 ```
 
+## Publishing prima-cli
+
+Prima ships three ways, all the same code:
+
+| | |
+|---|---|
+| `npx prima-cli` | its own package |
+| `npx explorbot prima` | subcommand of the explorbot CLI |
+| `npx -p explorbot prima` | the `prima` bin explorbot installs |
+
+Prima is compiled into `dist/` by the same `tsc` run as everything else; only the packaging differs. `bun run build:prima` (`scripts/build-prima-npm.ts`) runs after `build:npm` and stages a second package:
+
+```
+dist-prima/
+├── package.json            # boat/prima/package.json + version and dependencies from the root manifest
+├── README.md               # boat/prima/README.md, the npm page
+└── dist/
+    ├── boat/prima/
+    ├── src/
+    ├── models.json
+    ├── rules/
+    └── assets/sample-files/
+```
+
+The `dist/` layout is copied, not flattened: `config.js` reads `../models.json`, `rules-loader.js` reads `../../rules`, and `tester.js` reads `../../assets/sample-files`. Dependencies are copied verbatim from the root manifest rather than pruned to prima's closure — pruning saves little next to playwright and codeceptjs, and breaks on the first moved import. Edit `boat/prima/package.json` for the package name, bin, keywords or engines.
+
+`publish-prima.yml` publishes it when a GitHub release is **published**, so a draft ships nothing. The version is the release tag with `prima-` and a leading `v` stripped: `0.2.6`, `v0.2.6` and `prima-v0.2.6` all publish `prima-cli@0.2.6`. A `prima-v*` tag is how prima ships on its own — `publish.yml` ignores it. A pre-release release, or a version containing `beta`, `alpha`, `pre` or `rc`, goes to the `beta` dist-tag.
+
+Before publishing, the workflow packs the staged package, installs the tarball into an empty directory and runs it there with an empty `HOME` — a real consumer install, which is what catches a missing file, dependency or asset. It skips a version already on the registry, so a failed run can be re-run.
+
+To check it locally:
+
+```bash
+bun run build:npm && bun run build:prima
+npm pack ./dist-prima --pack-destination /tmp
+cd $(mktemp -d) && npm init -y && npm install --ignore-scripts /tmp/prima-cli-*.tgz
+./node_modules/.bin/prima-cli --help
+```
+
+## Trusted Publishing and Provenance
+
+Both packages publish over OIDC, with no npm token in the repository. npm checks GitHub's identity token against a trusted publisher registered on the package, then attaches a provenance attestation. No `--provenance` flag is needed; trusted publishing does it.
+
+The workflows are already set up for this: `id-token: write`, `ubuntu-latest`, and `npm@latest` for the npm 11.5.1+ requirement. The rest is per package on npmjs.com, because a trusted publisher names one package and one workflow file — `explorbot`'s does not cover `prima-cli`. The package has to exist before it can be configured, which is why a new one is claimed with a manual publish first.
+
+On the package's **Settings** tab, under **Trusted Publisher**, choose **GitHub Actions**:
+
+| Field | `explorbot` | `prima-cli` |
+|---|---|---|
+| Organization or user | `testomatio` | `testomatio` |
+| Repository | `explorbot` | `explorbot` |
+| Workflow filename | `publish.yml` | `publish-prima.yml` |
+| Allowed actions | `npm publish` | `npm publish` |
+| Environment name | empty | empty |
+
+The workflow filename is a basename, and it is the field that differs — pointing `prima-cli` at `publish.yml` fails every release. Leave the environment empty unless the publish job gains an `environment:` key; a mismatch fails the publish.
+
+To check a publish was attested:
+
+```bash
+npm view <package>@<version> dist.attestations
+```
+
+A `slsa.dev/provenance/v1` predicate means it worked. Nothing printed means the version went out unattested. `npm audit signatures` checks an installed tree.
+
+Once no workflow needs a token, revoke the package's automation tokens and set its publishing access to require two-factor authentication and disallow tokens.
+
 ## Known Limitations
 
 - **Type declarations are transform-generated** - Declarations come from a transformed copy of the source (see [Type Declarations](#type-declarations)), not from `tsc --declaration` directly, because the mixin-based agents can't emit declarations as written. The published `.d.ts` types are exact; the workaround only concerns how they're produced.
@@ -135,4 +204,4 @@ npm publish
 
 The `test.yml` workflow verifies the npm build on every push. On Node.js 24 it runs `bun run build:npm`, then the Node smoke tests: `node --test tests/node/*.mjs`. The `publish.yml` workflow additionally checks `node dist/bin/explorbot-cli.js --help` before publishing.
 
-The `publish.yml` workflow publishes to npm when you push a version tag (`v*` or a bare `1.2.3`-style tag). It overwrites the package version from the tag; tags containing `beta`, `alpha`, `pre`, or `rc` publish to the `beta` dist-tag instead of `latest`.
+The `publish.yml` workflow publishes `explorbot` when you push a version tag (`v*` or a bare `1.2.3`-style tag). It overwrites the package version from the tag; tags containing `beta`, `alpha`, `pre`, or `rc` publish to the `beta` dist-tag instead of `latest`. `publish-prima.yml` publishes `prima-cli` when a GitHub release is published. Both go out over OIDC and with provenance — see [Publishing prima-cli](#publishing-prima-cli) and [Trusted Publishing and Provenance](#trusted-publishing-and-provenance).

package/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "explorbot",
-  "version": "0.2.5",
+  "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/src/action-result.ts

@@ -4,7 +4,7 @@ import { ConfigParser, type HtmlConfig, outputPath } from './config.ts';
 import type { Link, WebPageState } from './state-manager.ts';
 import { LARGE_ARIA_CHANGE_THRESHOLD, compactAriaSnapshot, diffAriaSnapshots } from './utils/aria.ts';
 import { TTLCache } from './utils/cache.ts';
-import { type HtmlDiffPart, type HtmlDiffResult, htmlDiff } from './utils/html-diff.ts';
+import { type HtmlDiffPart, type HtmlDiffResult, htmlDiff, liveRegionMessages } from './utils/html-diff.ts';
 import { extractHeadings, extractLinks, extractTargetedHtml, htmlCombinedSnapshot, htmlMinimalUISnapshot, htmlTextSnapshot, minifyHtml } from './utils/html.ts';
 import { createDebug } from './utils/logger.ts';
 import { slugify } from './utils/strings.ts';
@@ -27,6 +27,7 @@ interface ActionResultData extends WebPageState {
   h3?: string | undefined;
   h4?: string | undefined;
   browserLogs?: any[];
+  networkRequests?: NetworkCall[];
   iframeSnapshots?: Array<{ src: string; html: string; id?: string }>;
   ariaSnapshot?: string | null;
   ariaSnapshotFile?: string;
@@ -41,6 +42,9 @@ export interface PageDiff {
   currentUrl: string;
   ariaChanges?: string | null;
   ariaChangeCount?: number;
+  messages?: string[];
+  requests?: NetworkCall[];
+  consoleErrors?: string[];
   htmlParts?: HtmlDiffPart[];
   iframes?: string;
 }
@@ -66,6 +70,7 @@ export class ActionResult implements ActionResultData {
   public url = '';
   public fullUrl: string | undefined = undefined;
   public browserLogs: any[] = [];
+  public networkRequests: NetworkCall[] = [];
   public iframeSnapshots: Array<{ src: string; html: string; id?: string }> = [];
   public iframeURL: string | undefined = undefined;
   readonly screenshotFile: string | undefined = undefined;
@@ -91,6 +96,7 @@ export class ActionResult implements ActionResultData {
     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 ?? [];
@@ -508,23 +514,30 @@ export class ActionResult implements ActionResultData {
       return result;
     }
 
-    const urlChanged = previousState ? !this.isSameUrl({ url: previousState.url }) : true;
+    const pageDiff: PageDiff = {
+      urlChanged: previousState ? !this.isSameUrl({ url: previousState.url }) : true,
+      currentUrl: this.url,
+    };
+    result.pageDiff = pageDiff;
 
-    if (!previousState) {
-      result.pageDiff = {
-        urlChanged: true,
-        currentUrl: this.url,
-      };
-      return result;
+    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);
 
-    const pageDiff: PageDiff = {
-      urlChanged,
-      previousUrl: previousState.url,
-      currentUrl: this.url,
-    };
+    if (diff.messages.length > 0) {
+      pageDiff.messages = diff.messages;
+    }
 
     if (diff.ariaChanged) {
       pageDiff.ariaChanges = diff.ariaChanged;
@@ -552,11 +565,28 @@ export class ActionResult implements ActionResultData {
       }
     }
 
-    result.pageDiff = pageDiff;
     return result;
   }
+
+  private consoleErrors(): string[] {
+    const errors: string[] = [];
+
+    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;
@@ -584,6 +614,7 @@ function collapseHtmlParts(parts: HtmlDiffPart[]): HtmlDiffPart[] {
 
 export class Diff {
   private _htmlDiffResult: HtmlDiffResult | null = null;
+  private _messages: string[] = [];
   private _ariaDiffResult: string | null = null;
   private _ariaChangeCount = 0;
   private _isSameUrl: boolean;
@@ -636,19 +667,33 @@ export class Diff {
     return this._htmlDiffResult;
   }
 
+  get messages(): string[] {
+    return this._messages;
+  }
+
   async calculate(): Promise<void> {
     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;
   }
 }
 
+export interface NetworkCall {
+  method: string;
+  path: string;
+  status: number;
+}
+
 export interface FocusedElement {
   role: string;
   name: string;