cbrowser 19.2.3 → 19.3.1

package/dist/mcp-tools/base/artifact-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/base/artifact-tools.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAU7C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuD7D"}
+{"version":3,"file":"artifact-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/base/artifact-tools.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAuB7C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoE7D"}

package/dist/mcp-tools/base/artifact-tools.js

@@ -14,8 +14,22 @@ import { z } from "zod";
 import { readFileSync, existsSync, statSync } from "node:fs";
 import { join, basename, extname } from "node:path";
 import { artifactDir } from "../../artifact-store.js";
+import { fitImageForInline } from "../inline-image.js";
+import { MAX_RESPONSE_SIZE } from "../screenshot-utils.js";
 /** Largest artifact returned inline. Base64 adds a third on top of this. */
 const MAX_BYTES = 3_500_000;
+/**
+ * Base64 budget for an image this tool returns by default.
+ *
+ * The comment above says it: hosts truncate a tool result near 150k chars. That
+ * holds for a view's callServerTool too. A 1280x800 attention heatmap PNG is
+ * ~666k chars of base64, so the attention view asked for it, the host cut it,
+ * and the panel showed no image -- while the tool result it rendered from
+ * carried a perfectly good inline preview it never reads (Alexa, 2026-10-09:
+ * "the attention analysis image doesn't load inline again"). Images over this
+ * are fitted (JPEG quality ladder, then downscale) unless `full: true`.
+ */
+const VIEW_IMAGE_BUDGET = MAX_RESPONSE_SIZE - 10_000;
 const MIME = {
     ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg",
     ".gif": "image/gif", ".webp": "image/webp",
@@ -26,6 +40,7 @@ export function registerArtifactTools(server) {
         description: "Fetch a generated image artifact (heatmap, diff, capture frame) as inline image data. Called by interactive views to display images the widget sandbox cannot load by URL; not usually needed directly.",
         inputSchema: {
             file: z.string().describe("Artifact filename as returned by the producing tool, e.g. 'heatmap-abc123.png'"),
+            full: z.boolean().optional().describe("Return the original bytes even when they exceed the host's ~150k-char result cap (a host may then truncate the result). Default false: a larger still image comes back as a JPEG fitted under the cap."),
         },
         annotations: {
             title: "Fetch Artifact",
@@ -37,7 +52,7 @@ export function registerArtifactTools(server) {
         // Hidden from the model's tool list: it exists for views to call, and an
         // agent reaching for it directly would be fetching bytes it cannot use.
         _meta: { ui: { visibility: ["app"] } },
-    }, async ({ file }) => {
+    }, async ({ file, full }) => {
         // basename strips any directory component, so a traversal attempt
         // resolves to a plain name inside the artifact dir rather than escaping it.
         // The name is then re-validated, because basename alone would happily
@@ -66,10 +81,22 @@ export function registerArtifactTools(server) {
                 isError: true,
             };
         }
+        const bytes = readFileSync(path);
+        const base64 = bytes.toString("base64");
+        // Animated GIFs are never re-encoded: a JPEG would keep one frame.
+        if (full !== true && ext !== ".gif" && base64.length > VIEW_IMAGE_BUDGET) {
+            const fitted = await fitImageForInline(bytes, VIEW_IMAGE_BUDGET).catch(() => null);
+            if (fitted) {
+                return {
+                    content: [{ type: "image", data: fitted.data, mimeType: fitted.mimeType }],
+                    _meta: { fitted: { width: fitted.width, height: fitted.height, sourceWidth: fitted.sourceWidth, sourceHeight: fitted.sourceHeight, quality: fitted.quality, originalBase64Chars: base64.length } },
+                };
+            }
+        }
         return {
             content: [{
                     type: "image",
-                    data: readFileSync(path).toString("base64"),
+                    data: base64,
                     mimeType: MIME[ext],
                 }],
         };

package/dist/mcp-tools/base/artifact-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-tools.js","sourceRoot":"","sources":["../../../src/mcp-tools/base/artifact-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"artifact-tools.js","sourceRoot":"","sources":["../../../src/mcp-tools/base/artifact-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,4EAA4E;AAC5E,MAAM,SAAS,GAAG,SAAS,CAAC;AAE5B;;;;;;;;;;GAUG;AACH,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,MAAM,CAAC;AAErD,MAAM,IAAI,GAA2B;IACnC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY;IAChE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY;CAC3C,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE;QACpC,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,yMAAyM;QACtN,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;YAC3G,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wMAAwM,CAAC;SAChP;QACD,WAAW,EAAE;YACX,KAAK,EAAE,gBAAgB;YACvB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;QACD,yEAAyE;QACzE,wEAAwE;QACxE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE;KACvC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QACxB,kEAAkE;QAClE,4EAA4E;QAC5E,sEAAsE;QACtE,yCAAyC;QACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,EAAE,CAAC;gBACtF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,qBAAqB,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;gBACzF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;QACjC,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BAC7C,KAAK,EAAE,eAAe,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB;yBAC5G,CAAC,EAAE,CAAC;gBACL,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxC,mEAAmE;QACnE,IAAI,IAAI,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;YACzE,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACnF,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACnF,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE;iBACnM,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,OAAgB;oBACtB,IAAI,EAAE,MAAM;oBACZ,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAW;iBAC9B,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp-tools/base/index.js

@@ -78,8 +78,8 @@ export function registerBaseTools(server, context) {
     registerSessionTools(server, context);
     // Healing (1)
     registerHealingTools(server, context);
-    // Visual Testing (6) - no browser context needed
-    registerVisualTestingTools(server);
+    // Visual Testing (6) - attention_analysis can analyze a live session by token
+    registerVisualTestingTools(server, context);
     // Testing (5) - no browser context needed
     registerTestingTools(server);
     // Bug Analysis (2)

package/dist/mcp-tools/base/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-tools/base/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-tools/base/index.ts"],"names":[],"mappings":"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"}

package/dist/mcp-tools/base/visual-testing-tools.d.ts

@@ -5,7 +5,7 @@
  * @license MIT
  */
 import type { ContentBlock } from "../screenshot-utils.js";
-import type { McpServer } from "../types.js";
+import type { McpServer, ToolRegistrationContext } from "../types.js";
 /**
  * attention_analysis's result: the JSON, then the heatmap as an image block.
  *
@@ -25,5 +25,5 @@ export declare function assembleAttentionContent(data: Record<string, unknown>,
 /**
  * Register visual testing tools (6 tools: visual_baseline, visual_regression, cross_browser_test, cross_browser_diff, responsive_test, ab_comparison)
  */
-export declare function registerVisualTestingTools(server: McpServer): void;
+export declare function registerVisualTestingTools(server: McpServer, context?: ToolRegistrationContext): void;
 //# sourceMappingURL=visual-testing-tools.d.ts.map

package/dist/mcp-tools/base/visual-testing-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visual-testing-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/base/visual-testing-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA8B3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAU7C;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC,CAOzB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA64BlE"}
+{"version":3,"file":"visual-testing-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/base/visual-testing-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAmE3D,OAAO,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAUtE;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC,CAOzB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,IAAI,CA69BrG"}

package/dist/mcp-tools/base/visual-testing-tools.js

@@ -9,6 +9,39 @@ import { getDefaultConfig } from "../../config.js";
 import { resolveValuesForPersona } from "../../values/persona-values.js";
 import { writeArtifact } from "../../artifact-store.js";
 import { buildContentWithPreviews } from "../inline-image.js";
+/**
+ * Scroll a page for an attention measurement, and say how to put it back.
+ *
+ * Shared by attention_analysis and attention_compare so the two cannot drift:
+ * scrolling happens BEFORE the screenshot and the DOM read, both of which are
+ * taken in the viewport, so the heatmap and element coordinates describe the
+ * same band of the page. The page clamps an over-large offset; what applied is
+ * reported, not what was asked. `restore` returns a caller's session to the
+ * scroll position it had. (2026-10-09)
+ */
+async function scrollForAnalysis(page, scrollY) {
+    const original = await page.evaluate(() => window.scrollY).catch(() => 0);
+    let scroll;
+    if (scrollY !== undefined) {
+        // behavior "instant" overrides a page's CSS scroll-behavior: smooth.
+        // Without it the scroll ANIMATES: the position read back is where the page
+        // still was (cbrowser.ai: asked 2000, reported 0), and the screenshot can
+        // land mid-scroll. (Live check, 2026-10-09)
+        const applied = await page.evaluate((y) => {
+            window.scrollTo({ top: y, left: 0, behavior: "instant" });
+            return { applied: Math.round(window.scrollY), max: Math.max(0, Math.round(document.documentElement.scrollHeight - window.innerHeight)) };
+        }, scrollY);
+        // Lazy content and sticky headers settle on scroll.
+        await new Promise((r) => setTimeout(r, 500));
+        scroll = { requested: scrollY, applied: applied.applied, maxScrollY: applied.max };
+    }
+    return {
+        ...(scroll ? { scroll } : {}),
+        restore: async () => {
+            await page.evaluate((y) => window.scrollTo({ top: y, left: 0, behavior: "instant" }), original).catch(() => { });
+        },
+    };
+}
 /**
  * Resolve a persona before anything is measured, or return the tool's refusal.
  *
@@ -61,7 +94,7 @@ export async function assembleAttentionContent(data, heatmapPng, fullResolution)
 /**
  * Register visual testing tools (6 tools: visual_baseline, visual_regression, cross_browser_test, cross_browser_diff, responsive_test, ab_comparison)
  */
-export function registerVisualTestingTools(server) {
+export function registerVisualTestingTools(server, context) {
     server.registerTool("visual_baseline", {
         title: "Capture Visual Baseline",
         description: "Capture a visual baseline using Wasserstein barycenter. Takes multiple screenshots, rejects outliers, computes optimal consensus reference with adaptive threshold. Robust to dynamic content, animations, and timing variations.",
@@ -446,7 +479,9 @@ export function registerVisualTestingTools(server) {
         title: "Attention Saliency Analysis",
         description: "Analyze where a persona's attention goes on a page. Two-layer model: (1) visual saliency via W₂ on CIE-Lab (what POPS), (2) DOM semantic analysis (what MATTERS — CTAs, headings, forms, nav). Blended 35/65 so a gray search bar a power-user prioritizes outweighs a flashy banner they ignore. Returns attention metrics, a quality score, and the heatmap overlay: inline as a JPEG preview sized to fit the result (described in heatmapPreview), with the full-resolution PNG at heatmapUrl / artifact_fetch({ file: heatmapFile }).",
         inputSchema: {
-            url: z.string().describe("URL to analyze"),
+            url: z.string().optional().describe("URL to analyze. Optional with _browserToken: omit it to analyze the session's current page as it stands (logged in, mid-flow); pass it to navigate that session first. Required without a token."),
+            _browserToken: z.string().optional().describe("Browser session token from a previous tool call (navigate, click, fill...). Analyzes that live session instead of a fresh browser, so authenticated and mid-flow states can be measured. The session keeps its viewport (device is ignored), and its scroll position and animation state are restored afterwards."),
+            scrollY: z.number().min(0).optional().describe("Vertical scroll offset in CSS pixels to analyze at. The screenshot, heatmap and DOM coordinates are all taken in the viewport at this offset. Clamped to the page's maximum scroll; the applied value is reported in `scroll`."),
             persona: z.string().optional().default("first-timer").describe("Persona name"),
             goal: z.string().optional().describe("Task goal — elements matching this goal get boosted attention (e.g., 'find pricing', 'sign up for an account')"),
             cellSize: z.number().optional().default(4).describe("Saliency grid cell size in pixels (smaller = finer heatmap, default: 4)"),
@@ -465,36 +500,56 @@ export function registerVisualTestingTools(server) {
         // Declares the attention view. The heatmap is the finding here, and a JSON
         // list of scores is a lossy description of where a persona actually looks.
         _meta: { ui: { resourceUri: "ui://cbrowser/attention" } },
-    }, async ({ url, persona: requestedPersona, goal, cellSize, heatmap, device, useValues, freezeAnimations: doFreeze }) => {
+    }, async ({ url, persona: requestedPersona, goal, cellSize, heatmap, device, useValues, freezeAnimations: doFreeze, _browserToken, scrollY }) => {
+        const refuse = (error) => ({ isError: true, content: [{ type: "text", text: JSON.stringify({ error }, null, 2) }] });
+        if (!url && !_browserToken)
+            return refuse("attention_analysis needs a url, or a _browserToken to analyze that session's current page.");
+        if (_browserToken && !context?.getBrowserByToken)
+            return refuse("This server does not support browser session tokens; pass a url instead.");
         const resolved = await resolveOrRefuse(requestedPersona);
         if (!resolved.ok)
             return resolved.result;
         const persona = resolved.name;
         const { CBrowser } = await import("../../browser.js");
-        const browser = new CBrowser({
-            headless: true,
-            // The CONFIGURED viewport, not a hardcoded 1920x1080.
-            //
-            // Every other tool renders at the configured default (1280x800) and
-            // this one alone rendered at 1920x1080, so an attention run and a
-            // cognitive_effort run were measuring DIFFERENT rendered pages while
-            // reporting coordinates as if they shared a space. The tell was
-            // attention regions coming back at x=1312 against a config that says
-            // the viewport is 1280 wide -- impossible unless the page was wider.
-            // (2026-08-02)
-            ...(device ? { device: device.toLowerCase() } : {
-                viewportWidth: getDefaultConfig().viewportWidth,
-                viewportHeight: getDefaultConfig().viewportHeight,
-            }),
-        });
+        // A session is the caller's: analyze it, leave it as found (scroll,
+        // animation state), never close it. A fresh browser is ours to close.
+        let sessionToken;
+        const browser = _browserToken
+            ? await (async () => { const r = await context.getBrowserByToken(_browserToken); sessionToken = r.token; return r.browser; })()
+            : new CBrowser({
+                headless: true,
+                // The CONFIGURED viewport, not a hardcoded 1920x1080.
+                //
+                // Every other tool renders at the configured default (1280x800) and
+                // this one alone rendered at 1920x1080, so an attention run and a
+                // cognitive_effort run were measuring DIFFERENT rendered pages while
+                // reporting coordinates as if they shared a space. The tell was
+                // attention regions coming back at x=1312 against a config that says
+                // the viewport is 1280 wide -- impossible unless the page was wider.
+                // (2026-08-02)
+                ...(device ? { device: device.toLowerCase() } : {
+                    viewportWidth: getDefaultConfig().viewportWidth,
+                    viewportHeight: getDefaultConfig().viewportHeight,
+                }),
+            });
         const { join } = await import("path");
         const { tmpdir } = await import("os");
         const { unlinkSync } = await import("fs");
+        const ownsBrowser = !_browserToken;
+        let restoreSession;
         try {
-            await browser.launch();
-            await browser.navigate(url);
-            await new Promise(r => setTimeout(r, 2000));
+            if (ownsBrowser)
+                await browser.launch();
+            if (url) {
+                await browser.navigate(url);
+                await new Promise(r => setTimeout(r, 2000));
+            }
             const page = await browser.getPage();
+            const pageUrl = url ?? page.url();
+            const viewport = page.viewportSize?.() ?? null;
+            const { scroll, restore: restoreScroll } = await scrollForAnalysis(page, scrollY);
+            if (!ownsBrowser)
+                restoreSession = restoreScroll;
             // Freeze BEFORE the screenshot, which is the only moment that matters:
             // the saliency layer reads the image, so anything still moving when the
             // shutter opens is in the measurement.
@@ -506,6 +561,30 @@ export function registerVisualTestingTools(server) {
                     animationState = await doFreezeAnimations(page);
                 }
                 catch { /* a failed freeze is reported below, never fatal */ }
+                if (!ownsBrowser) {
+                    // The freeze stylesheet and reduced-motion emulation would outlive
+                    // this call in the caller's session; undo both with the scroll.
+                    const restoreBefore = restoreSession;
+                    restoreSession = async () => {
+                        await restoreBefore?.();
+                        await page.evaluate(() => {
+                            for (const st of Array.from(document.querySelectorAll("style"))) {
+                                if ((st.textContent ?? "").includes("cbrowser-freeze-animations"))
+                                    st.remove();
+                            }
+                            try {
+                                for (const a of document.getAnimations?.() ?? []) {
+                                    try {
+                                        a.play();
+                                    }
+                                    catch { /* not resumable */ }
+                                }
+                            }
+                            catch { /* older engines */ }
+                        }).catch(() => { });
+                        await page.emulateMedia?.({ reducedMotion: null }).catch(() => { });
+                    };
+                }
             }
             // Measured either way. On a live run it says how much motion the number
             // was taken through; on a frozen run a non-zero value means the freeze
@@ -517,7 +596,7 @@ export function registerVisualTestingTools(server) {
             // attention model. This was the only inline copy of the collect+DPR-scale
             // dance; it now shares one implementation with visual_cognitive_story and
             // journey_heatmap_gif, so the scaling cannot drift between the three.
-            const { computeAttentionQuality, extractPageElementsForAttention, collectDomAttentionElements } = await import("../../visual/attention-quality.js");
+            const { computeAttentionQuality, extractPageElementsForAttention, collectDomAttentionElements, MIN_DISTINCT_ELEMENTS } = await import("../../visual/attention-quality.js");
             const rawElements = await extractPageElementsForAttention(page);
             const dpr = await page.evaluate(() => window.devicePixelRatio).catch(() => 1);
             const pageElements = rawElements.map(el => ({
@@ -538,9 +617,12 @@ export function registerVisualTestingTools(server) {
             let relevanceScores;
             let relevanceSource;
             let relevanceReasoning;
+            // Method AND provenance: whether this call judged, or replayed a
+            // cached judgement (and how old it is). See relevanceProvenance.
+            let relevanceFields = {};
             if (domAttentionElements.length > 0) {
                 try {
-                    const { judgeRelevance } = await import("../../visual/llm-relevance.js");
+                    const { judgeRelevance, relevanceProvenance } = await import("../../visual/llm-relevance.js");
                     const { getAnthropicApiKey } = await import("../../cognitive/index.js");
                     const { getActiveTier } = await import("../tier-gate.js");
                     const { tierHasAccess } = await import("../tool-categories.js");
@@ -559,6 +641,7 @@ export function registerVisualTestingTools(server) {
                     relevanceScores = judged.scores;
                     relevanceSource = judged.source;
                     relevanceReasoning = judged.reasoning;
+                    relevanceFields = relevanceProvenance(judged);
                 }
                 catch { /* keyword path inside buildSemanticMap remains the floor */ }
             }
@@ -616,9 +699,16 @@ export function registerVisualTestingTools(server) {
             // only ever annotated, never rewritten: the narrative carries the "why"
             // the metrics don't.
             let narrativeReconciliation;
+            // What the narrative was computed over versus what the metrics were:
+            // N candidates judged by the LLM, M elements the hotspots sampled.
+            let reasoningScope;
             try {
-                const { reconcileAttentionNarrative } = await import("../../visual/narrative-reconcile.js");
+                const { reconcileAttentionNarrative, describeReasoningScope } = await import("../../visual/narrative-reconcile.js");
                 narrativeReconciliation = reconcileAttentionNarrative(relevanceReasoning, attentionQuality);
+                if (relevanceReasoning) {
+                    const sampled = attentionQuality?.sampledElements;
+                    reasoningScope = describeReasoningScope(domAttentionElements.length, sampled, MIN_DISTINCT_ELEMENTS);
+                }
             }
             catch { /* annotation only; never block the result on it */ }
             const data = {
@@ -627,9 +717,14 @@ export function registerVisualTestingTools(server) {
                 // Stated, because two tools silently rendering at different sizes is
                 // exactly what made these coordinates incomparable with a CTC run.
                 // A reader can now check instead of assuming they match.
-                renderedViewport: device
-                    ? `device: ${device.toLowerCase()}`
-                    : `${getDefaultConfig().viewportWidth}x${getDefaultConfig().viewportHeight}`,
+                renderedViewport: !ownsBrowser
+                    ? (viewport ? `${viewport.width}x${viewport.height} (session)` : "session viewport")
+                    : device
+                        ? `device: ${device.toLowerCase()}`
+                        : `${getDefaultConfig().viewportWidth}x${getDefaultConfig().viewportHeight}`,
+                url: pageUrl,
+                ...(scroll ? { scroll } : {}),
+                ...(sessionToken ? { _browserToken: sessionToken, ...(device ? { deviceIgnored: "device does not apply to an existing session; its own viewport was used" } : {}) } : {}),
                 coordinateSpace: "CSS pixels in the rendered viewport above — compare only against runs reporting the same renderedViewport",
                 // What actually ran, not what was asked for. A freeze that silently
                 // failed would produce exactly the variance it was asked to remove,
@@ -654,6 +749,9 @@ export function registerVisualTestingTools(server) {
                 // with no stated reason is one the caller cannot argue with, which
                 // was the point of leaving keyword matching.
                 ...(relevanceReasoning ? { attentionReasoning: relevanceReasoning } : {}),
+                // Beside the narrative, so it cannot be read as describing the
+                // measured targets: it was computed over a different, larger set.
+                ...(reasoningScope ? { attentionReasoningScope: reasoningScope } : {}),
                 // Only present when a checkable claim in the narrative actually
                 // contradicts a computed metric. Silent otherwise — a spurious
                 // "these disagree" on a narrative that was fine is its own defect.
@@ -664,7 +762,8 @@ export function registerVisualTestingTools(server) {
                         note: narrativeReconciliation.reconciliationNote,
                     },
                 } : {}),
-                ...(relevanceSource ? { relevanceMethod: relevanceSource } : {}),
+                // relevanceMethod, relevanceCached, and the cache age when replayed.
+                ...(relevanceSource ? relevanceFields : {}),
                 // These two lines used to read as a contradiction — "Scattered
                 // attention (overwhelmed)" printed directly above "Attention
                 // concentrated on few areas". The numbers were never wrong; the
@@ -757,7 +856,7 @@ export function registerVisualTestingTools(server) {
                             apiKey: getSessionApiKey(),
                             imageUrl: publicUrl,
                             toolName: "attention_analysis",
-                            targetUrl: url,
+                            targetUrl: pageUrl,
                             persona,
                             metadata: { entropy: result.entropy, concentration: result.concentration, alignmentScore: result.alignmentScore },
                         });
@@ -775,16 +874,21 @@ export function registerVisualTestingTools(server) {
             return { content: await assembleAttentionContent(data, heatmapPng, heatmapFullResolution) };
         }
         finally {
-            await browser.close();
+            if (ownsBrowser)
+                await browser.close();
+            else
+                await restoreSession?.();
         }
     });
     server.registerTool("attention_compare", {
         title: "Compare Persona Attention",
         description: "Compare attention patterns between two personas on the same page. Shows where they look differently and the Wasserstein divergence between their saliency maps. The comparison map comes back inline as a JPEG preview sized to fit the result (described in comparisonHeatmapPreview), with the full-resolution PNG at comparisonHeatmapUrl / artifact_fetch({ file: comparisonHeatmapFile }).",
         inputSchema: {
-            url: z.string().describe("URL to analyze"),
+            url: z.string().optional().describe("URL to analyze. Optional with _browserToken: omit it to compare on the session's current page as it stands (logged in, mid-flow); pass it to navigate that session first. Required without a token."),
             personaA: z.string().describe("First persona"),
             personaB: z.string().describe("Second persona"),
+            _browserToken: z.string().optional().describe("Browser session token from a previous tool call. Compares on that live session instead of a fresh browser; the session keeps its viewport, is never closed, and its scroll position is restored afterwards."),
+            scrollY: z.number().min(0).optional().describe("Vertical scroll offset in CSS pixels to compare at. Both personas are measured on the same screenshot at this offset. Clamped to the page's maximum scroll; the applied value is reported in `scroll`."),
         },
         annotations: {
             title: "Compare Persona Attention",
@@ -793,7 +897,12 @@ export function registerVisualTestingTools(server) {
             idempotentHint: true,
             openWorldHint: true,
         },
-    }, async ({ url, personaA: requestedA, personaB: requestedB }) => {
+    }, async ({ url, personaA: requestedA, personaB: requestedB, _browserToken, scrollY }) => {
+        const refuse = (error) => ({ isError: true, content: [{ type: "text", text: JSON.stringify({ error }, null, 2) }] });
+        if (!url && !_browserToken)
+            return refuse("attention_compare needs a url, or a _browserToken to compare on that session's current page.");
+        if (_browserToken && !context?.getBrowserByToken)
+            return refuse("This server does not support browser session tokens; pass a url instead.");
         // Both refused before measuring: an unknown name compared as "maximally
         // different" from power-user, more than the extreme real pair. (2026-10-09)
         const resolvedA = await resolveOrRefuse(requestedA);
@@ -809,19 +918,34 @@ export function registerVisualTestingTools(server) {
         // attention runs, so rendering at a size no other tool uses meant its
         // comparison was internally consistent and incomparable with everything
         // else that reports attention coordinates. (2026-08-02)
-        const browser = new CBrowser({
-            headless: true,
-            viewportWidth: getDefaultConfig().viewportWidth,
-            viewportHeight: getDefaultConfig().viewportHeight,
-        });
+        // A session is the caller's: compare on it, leave its scroll as found,
+        // never close it. A fresh browser is ours to close. (2026-10-09)
+        let sessionToken;
+        const browser = _browserToken
+            ? await (async () => { const r = await context.getBrowserByToken(_browserToken); sessionToken = r.token; return r.browser; })()
+            : new CBrowser({
+                headless: true,
+                viewportWidth: getDefaultConfig().viewportWidth,
+                viewportHeight: getDefaultConfig().viewportHeight,
+            });
+        const ownsBrowser = !_browserToken;
+        let restoreSession;
         const { join } = await import("path");
         const { tmpdir } = await import("os");
         const { unlinkSync } = await import("fs");
         try {
-            await browser.launch();
-            await browser.navigate(url);
-            await new Promise(r => setTimeout(r, 2000));
+            if (ownsBrowser)
+                await browser.launch();
+            if (url) {
+                await browser.navigate(url);
+                await new Promise(r => setTimeout(r, 2000));
+            }
             const page = await browser.getPage();
+            const pageUrl = url ?? page.url();
+            const viewport = page.viewportSize?.() ?? null;
+            const { scroll, restore: restoreScroll } = await scrollForAnalysis(page, scrollY);
+            if (!ownsBrowser)
+                restoreSession = restoreScroll;
             const screenshotPath = join(tmpdir(), `attn-cmp-${Date.now()}.png`);
             await page.screenshot({ path: screenshotPath, fullPage: false });
             // Extract DOM elements for semantic attention layer
@@ -837,6 +961,12 @@ export function registerVisualTestingTools(server) {
             const { compareAttention } = await import("../../visual/attention-transport.js");
             const result = await compareAttention(screenshotPath, personaA, personaB, 4, domEls);
             const responseData = {
+                url: pageUrl,
+                renderedViewport: !ownsBrowser
+                    ? (viewport ? `${viewport.width}x${viewport.height} (session)` : "session viewport")
+                    : `${getDefaultConfig().viewportWidth}x${getDefaultConfig().viewportHeight}`,
+                ...(scroll ? { scroll } : {}),
+                ...(sessionToken ? { _browserToken: sessionToken } : {}),
                 personaA: {
                     name: personaA,
                     ...(resolvedA.resolvedFrom ? { resolvedFrom: resolvedA.resolvedFrom } : {}),
@@ -901,7 +1031,10 @@ export function registerVisualTestingTools(server) {
             return { content };
         }
         finally {
-            await browser.close();
+            if (ownsBrowser)
+                await browser.close();
+            else
+                await restoreSession?.();
         }
     });
 }