@superblocksteam/gateway 2.0.0-SNAPSHOT.1d4c72c0ab174c21

package/dist/capture/browser-contract.js

@@ -0,0 +1,34 @@
+/** The host drives its own embedded browser; no driver MCP is involved. */
+export const HOST_BROWSER_TOOLS_COWORK = "cowork_embedded";
+/**
+ * Nobody looked, rather than nobody found one. The setup-time config scan
+ * behind {@link CaptureMode} can lie, so only a transport that knows which
+ * client is connected may say anything more definite than this.
+ */
+export const HOST_BROWSER_TOOLS_UNKNOWN = "unknown";
+export const MUST_NOT_CLOSE_UNTIL = "the Superblocks task is done (status ready, or the user no longer needs the browser session)";
+export const NEEDS_BROWSER_DRIVER_CODE = "needs_browser_driver";
+export const NEEDS_BROWSER_DRIVER_MESSAGE = "No browser driver is available for live-canvas capture or IdP step-up. Add a host browser MCP (@playwright/mcp) and re-run mcp setup. Gateway Chromium cannot complete IdP. Config on disk can lie if a listed server fails to start.";
+export function buildBrowserDriverContract(input) {
+    return {
+        captureMode: input.captureMode,
+        canvas: {
+            editUrl: input.editUrl,
+            openWhileBuilding: "claude_cowork_side_panel_only",
+        },
+        driver: {
+            ...(input.isolated ? { isolated: true } : {}),
+            mustNotCloseUntil: MUST_NOT_CLOSE_UNTIL,
+        },
+        hostBrowserTools: input.hostBrowserTools ?? HOST_BROWSER_TOOLS_UNKNOWN,
+        uiOrigin: { navigate: input.uiOrigin },
+    };
+}
+export function needsBrowserDriverError() {
+    return {
+        code: NEEDS_BROWSER_DRIVER_CODE,
+        kind: "error",
+        message: NEEDS_BROWSER_DRIVER_MESSAGE,
+    };
+}
+//# sourceMappingURL=browser-contract.js.map

package/dist/capture/browser-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-contract.js","sourceRoot":"","sources":["../../src/capture/browser-contract.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAA0B,CAAC;AAEpE;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAkB,CAAC;AAM7D,MAAM,CAAC,MAAM,oBAAoB,GAC/B,8FAA8F,CAAC;AAEjG,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAC;AAEhE,MAAM,CAAC,MAAM,4BAA4B,GACvC,uOAAuO,CAAC;AAsB1O,MAAM,UAAU,0BAA0B,CAAC,KAM1C;IACC,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE;YACN,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,iBAAiB,EAAE,+BAA+B;SACnD;QACD,MAAM,EAAE;YACN,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,iBAAiB,EAAE,oBAAoB;SACxC;QACD,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,0BAA0B;QACtE,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB;IAKrC,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,4BAA4B;KACtC,CAAC;AACJ,CAAC"}

package/dist/capture/browser-instructions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Numbered MUSTs for host browser drivers. Appended to MCP server
+ * instructions so a model that already has Playwright MCP (or agent-browser)
+ * opens the edit URL mid-build only in Cowork's side panel and never pastes
+ * tokens into evaluate.
+ *
+ * Detecting that this turn actually has those tools is ENG-5858's sibling
+ * concern; these lines only steer when the tools exist.
+ */
+export declare const BROWSER_DRIVER_INSTRUCTIONS = "Browser capture (MUST):\n1. Prefer host browser tools (Playwright MCP, chrome-devtools, agent-browser) over opening Superblocks URLs yourself. Honor the structured \"browser\" field on start_app / get_app / idp_step_up; do not paraphrase it into a different URL.\n2. When canvas.openWhileBuilding is \"claude_cowork_side_panel_only\", open canvas.editUrl while status is \"building\" only for a Claude Cowork task whose built-in browser is available, and use its embedded side panel. Every other host MUST NOT open it mid-build because that can steal the live-edit turn.\n3. NEVER paste tokens, JWTs, or API keys into browser evaluate or fill. Tokens are not in tool JSON; do not invent them.\n4. Playwright MCP MUST NOT use --isolated for Superblocks IdP. Cookies must survive the session.\n5. MUST NOT call browser_close until the Superblocks task is done (see driver.mustNotCloseUntil).\n6. agent-browser MUST always pass --profile and a stable --session for the same Superblocks origin.\n7. Claude-in-Chrome is not a mid-turn canvas. Do not use it to screenshot the live Vite app while a Gateway turn is held.";

package/dist/capture/browser-instructions.js

@@ -0,0 +1,18 @@
+/**
+ * Numbered MUSTs for host browser drivers. Appended to MCP server
+ * instructions so a model that already has Playwright MCP (or agent-browser)
+ * opens the edit URL mid-build only in Cowork's side panel and never pastes
+ * tokens into evaluate.
+ *
+ * Detecting that this turn actually has those tools is ENG-5858's sibling
+ * concern; these lines only steer when the tools exist.
+ */
+export const BROWSER_DRIVER_INSTRUCTIONS = `Browser capture (MUST):
+1. Prefer host browser tools (Playwright MCP, chrome-devtools, agent-browser) over opening Superblocks URLs yourself. Honor the structured "browser" field on start_app / get_app / idp_step_up; do not paraphrase it into a different URL.
+2. When canvas.openWhileBuilding is "claude_cowork_side_panel_only", open canvas.editUrl while status is "building" only for a Claude Cowork task whose built-in browser is available, and use its embedded side panel. Every other host MUST NOT open it mid-build because that can steal the live-edit turn.
+3. NEVER paste tokens, JWTs, or API keys into browser evaluate or fill. Tokens are not in tool JSON; do not invent them.
+4. Playwright MCP MUST NOT use --isolated for Superblocks IdP. Cookies must survive the session.
+5. MUST NOT call browser_close until the Superblocks task is done (see driver.mustNotCloseUntil).
+6. agent-browser MUST always pass --profile and a stable --session for the same Superblocks origin.
+7. Claude-in-Chrome is not a mid-turn canvas. Do not use it to screenshot the live Vite app while a Gateway turn is held.`;
+//# sourceMappingURL=browser-instructions.js.map

package/dist/capture/browser-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-instructions.js","sourceRoot":"","sources":["../../src/capture/browser-instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;0HAO+E,CAAC"}

package/dist/capture/capture-library-probe.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Stderr probe for live-library capture when canvas execute is unhealthy.
+ * Used to tell CORS / 401 / pending-abort apart from Clark testApi. Do not
+ * log tokens. Success (v3/execute POST 200) stays quiet. CORS preflight is
+ * not execute.
+ */
+export type CaptureParentEvent = {
+    type: string;
+};
+export type CaptureExecuteProbe = {
+    failure?: string;
+    method: string;
+    path: string;
+    pending?: boolean;
+    status?: number;
+};
+export type CaptureProbeInput = {
+    agentUrl?: string;
+    consoleText: string[];
+    execute: CaptureExecuteProbe[];
+    pageErrors: string[];
+    parentEvents: CaptureParentEvent[];
+    paintInnerText: string;
+    paintKind: string;
+};
+export type CaptureProbeSummary = {
+    agentHost?: string;
+    console: string[];
+    execute: CaptureExecuteProbe[];
+    pageErrors: string[];
+    paint: {
+        innerText: string;
+        kind: string;
+    };
+    parent: string[];
+    unanswered: string[];
+};
+export declare function isLibraryExecuteUrl(url: string): boolean;
+export declare function redactCaptureUrl(url: string): string;
+export declare function redactCaptureSecrets(text: string): string;
+export declare function executeStillInFlight(execute: CaptureExecuteProbe[]): boolean;
+export declare function shouldKeepCaptureConsole(text: string): boolean;
+export declare function summarizeCaptureProbe(input: CaptureProbeInput): CaptureProbeSummary;
+export type CaptureProbeCollector = {
+    consoleText: string[];
+    execute: CaptureExecuteProbe[];
+    pageErrors: string[];
+};
+type ProbePage = {
+    on: (event: string, handler: (arg: unknown) => void) => void;
+};
+export declare function attachLibraryCaptureProbe(page: ProbePage, collector: CaptureProbeCollector): void;
+export declare function shouldLogCaptureProbe(summary: CaptureProbeSummary): boolean;
+export declare function logCaptureProbe(summary: CaptureProbeSummary): void;
+export {};

package/dist/capture/capture-library-probe.js

@@ -0,0 +1,177 @@
+/**
+ * Stderr probe for live-library capture when canvas execute is unhealthy.
+ * Used to tell CORS / 401 / pending-abort apart from Clark testApi. Do not
+ * log tokens. Success (v3/execute POST 200) stays quiet. CORS preflight is
+ * not execute.
+ */
+const ANSWERED_PARENT_TYPES = new Set([
+    "authenticate-api-request",
+    "sb-editor-request-bootstrap",
+    "sb-ready",
+]);
+const CONSOLE_KEEP = /api-store|no active agent|failed to execute|authenticate|failed to fetch|cors|net::err/i;
+export function isLibraryExecuteUrl(url) {
+    try {
+        const path = new URL(url).pathname;
+        return /\/v[23]\/execute(?:\/stream)?\/?$/.test(path);
+    }
+    catch {
+        return false;
+    }
+}
+function isLibraryExecuteProbe(method, url) {
+    return method.toUpperCase() === "POST" && isLibraryExecuteUrl(url);
+}
+export function redactCaptureUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return `${parsed.origin}${parsed.pathname}`;
+    }
+    catch {
+        return url;
+    }
+}
+export function redactCaptureSecrets(text) {
+    return text
+        .replace(/Bearer\s+\S+/gi, "Bearer [redacted]")
+        .replace(/eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9._-]+/g, "[redacted-jwt]");
+}
+export function executeStillInFlight(execute) {
+    return execute.some((row) => row.status === undefined && row.failure === undefined);
+}
+function clip(text) {
+    const collapsed = text.replace(/\s+/g, " ").trim();
+    if (collapsed.length <= 240) {
+        return collapsed;
+    }
+    return `${collapsed.slice(0, 237)}...`;
+}
+export function shouldKeepCaptureConsole(text) {
+    return CONSOLE_KEEP.test(text);
+}
+export function summarizeCaptureProbe(input) {
+    const parent = input.parentEvents.map((event) => event.type);
+    const unanswered = parent.filter((type) => !ANSWERED_PARENT_TYPES.has(type));
+    let agentHost;
+    if (input.agentUrl) {
+        try {
+            agentHost = new URL(input.agentUrl).hostname;
+        }
+        catch {
+            agentHost = undefined;
+        }
+    }
+    return {
+        ...(agentHost ? { agentHost } : {}),
+        console: input.consoleText
+            .filter(shouldKeepCaptureConsole)
+            .map((text) => clip(redactCaptureSecrets(text))),
+        execute: input.execute.map((row) => ({
+            ...(row.failure ? { failure: row.failure } : {}),
+            method: row.method,
+            path: row.path,
+            ...(row.status === undefined && row.failure === undefined
+                ? { pending: true }
+                : {}),
+            ...(row.status !== undefined ? { status: row.status } : {}),
+        })),
+        pageErrors: input.pageErrors.map((text) => clip(redactCaptureSecrets(text))),
+        paint: {
+            innerText: clip(input.paintInnerText),
+            kind: input.paintKind,
+        },
+        parent,
+        unanswered,
+    };
+}
+function upsertExecute(collector, row) {
+    const open = collector.execute.find((existing) => existing.method === row.method &&
+        existing.path === row.path &&
+        existing.status === undefined &&
+        existing.failure === undefined);
+    if (open) {
+        if (row.status !== undefined) {
+            open.status = row.status;
+        }
+        if (row.failure !== undefined) {
+            open.failure = row.failure;
+        }
+        if (!open.method) {
+            open.method = row.method;
+        }
+        return;
+    }
+    collector.execute.push({
+        method: row.method,
+        path: row.path,
+        ...(row.failure ? { failure: row.failure } : {}),
+        ...(row.status !== undefined ? { status: row.status } : {}),
+    });
+}
+export function attachLibraryCaptureProbe(page, collector) {
+    page.on("request", (arg) => {
+        const request = arg;
+        const url = request.url();
+        const method = request.method();
+        if (!isLibraryExecuteProbe(method, url)) {
+            return;
+        }
+        collector.execute.push({
+            method,
+            path: redactCaptureUrl(url),
+        });
+    });
+    page.on("response", (arg) => {
+        const response = arg;
+        const url = response.url();
+        const method = response.request?.().method() ?? "POST";
+        if (!isLibraryExecuteProbe(method, url)) {
+            return;
+        }
+        upsertExecute(collector, {
+            method,
+            path: redactCaptureUrl(url),
+            status: response.status(),
+        });
+    });
+    page.on("requestfailed", (arg) => {
+        const request = arg;
+        const url = request.url();
+        const method = request.method();
+        if (!isLibraryExecuteProbe(method, url)) {
+            return;
+        }
+        const failed = request.failure?.();
+        upsertExecute(collector, {
+            failure: failed?.errorText ?? "requestfailed",
+            method,
+            path: redactCaptureUrl(url),
+        });
+    });
+    page.on("console", (arg) => {
+        const message = arg;
+        const text = message.text();
+        if (message.type() === "error" || shouldKeepCaptureConsole(text)) {
+            collector.consoleText.push(text);
+        }
+    });
+    page.on("pageerror", (arg) => {
+        collector.pageErrors.push(arg instanceof Error ? arg.message : String(arg));
+    });
+}
+export function shouldLogCaptureProbe(summary) {
+    if (summary.pageErrors.length > 0) {
+        return true;
+    }
+    if (summary.execute.length === 0) {
+        return /\bloading\b/i.test(summary.paint.innerText);
+    }
+    return summary.execute.some((row) => row.pending === true || row.failure !== undefined || row.status !== 200);
+}
+export function logCaptureProbe(summary) {
+    if (!shouldLogCaptureProbe(summary)) {
+        return;
+    }
+    console.error("gateway live canvas capture probe", summary);
+}
+//# sourceMappingURL=capture-library-probe.js.map

package/dist/capture/capture-library-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-library-probe.js","sourceRoot":"","sources":["../../src/capture/capture-library-probe.ts"],"names":[],"mappings":"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"}

package/dist/capture/capture-library.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Headless capture of the live library iframe (pitcherURL) for MCP image
+ * content. Top-level goto + mock parent, never the Superblocks edit URL.
+ *
+ * Best-effort: callers must succeed with URLs alone when this returns
+ * undefined. Output is capped like preview capture.
+ */
+import { type CaptureParentEvent } from "./capture-library-probe.js";
+import { type LibraryPaint } from "./classify-library-paint.js";
+import { type LibraryParentPayload } from "./library-parent-script.js";
+export type LibraryScreenshot = {
+    dataBase64: string;
+    mimeType: "image/jpeg";
+};
+export type CaptureLibraryScreenshotInput = LibraryParentPayload & {
+    iframeBaseUrl: string;
+    timeoutMs?: number;
+};
+export type LibraryPaintElement = {
+    innerText?: string;
+    querySelectorAll: (selector: string) => ArrayLike<LibraryPaintElement>;
+};
+export type LibraryPaintView = {
+    document: {
+        body?: LibraryPaintElement | null;
+        documentElement?: LibraryPaintElement | null;
+    };
+    getComputedStyle: (element: LibraryPaintElement) => {
+        backgroundColor: string;
+        color: string;
+    };
+};
+/**
+ * Runs inside Playwright's page.evaluate. Keep this function self-contained
+ * (Playwright serializes only this body). Default `view` is the browser
+ * globalThis; tests pass a fake page so Node tsc does not need DOM libs.
+ */
+export declare function readLibraryPaintInPage(view?: LibraryPaintView): LibraryPaint;
+/**
+ * Runs inside Playwright's page.evaluate. Keep self-contained: Playwright
+ * serializes only this body. Default `view` is the browser globalThis.
+ */
+export declare function readLibraryCaptureParentEvents(view?: {
+    __sbGatewayCaptureEvents?: unknown;
+}): CaptureParentEvent[];
+/**
+ * Captures a JPEG of the live Vite canvas via Playwright when available.
+ * Soft-fails when Chromium is missing, the URL is the edit chrome, or the
+ * page never becomes ready.
+ */
+export type CaptureLibraryScreenshot = (input: CaptureLibraryScreenshotInput) => Promise<LibraryScreenshot | undefined>;
+export declare function captureLibraryScreenshotWithPlaywright(input: CaptureLibraryScreenshotInput): Promise<LibraryScreenshot | undefined>;

package/dist/capture/capture-library.js

@@ -0,0 +1,249 @@
+/**
+ * Headless capture of the live library iframe (pitcherURL) for MCP image
+ * content. Top-level goto + mock parent, never the Superblocks edit URL.
+ *
+ * Best-effort: callers must succeed with URLs alone when this returns
+ * undefined. Output is capped like preview capture.
+ */
+import { PREVIEW_SCREENSHOT_MAX_BYTES } from "../preview/capture-screenshot.js";
+import { attachLibraryCaptureProbe, executeStillInFlight, logCaptureProbe, summarizeCaptureProbe, } from "./capture-library-probe.js";
+import { classifyLibraryPaint, } from "./classify-library-paint.js";
+import { buildLibraryParentScript, } from "./library-parent-script.js";
+const APP_PAINT_SETTLE_MS = 2_500;
+const DEFAULT_CAPTURE_TIMEOUT_MS = 15_000;
+const EXECUTE_POLL_MS = 250;
+const POST_EXECUTE_PAINT_MS = 500;
+const SCREENSHOT_RESERVE_MS = 1_000;
+function isEditorChromeUrl(url) {
+    try {
+        return /\/code-mode\/applications\/edit\//.test(new URL(url).pathname);
+    }
+    catch {
+        return true;
+    }
+}
+function libraryCaptureUrl(iframeBaseUrl) {
+    let url;
+    try {
+        url = new URL(iframeBaseUrl);
+    }
+    catch {
+        return undefined;
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        return undefined;
+    }
+    if (isEditorChromeUrl(url.toString())) {
+        return undefined;
+    }
+    url.searchParams.set("app_mode", "EDIT");
+    return url.toString();
+}
+/**
+ * Runs inside Playwright's page.evaluate. Keep this function self-contained
+ * (Playwright serializes only this body). Default `view` is the browser
+ * globalThis; tests pass a fake page so Node tsc does not need DOM libs.
+ */
+export function readLibraryPaintInPage(view) {
+    const page = view ?? globalThis;
+    const innerText = page.document.body?.innerText ?? "";
+    const samples = [];
+    const roots = [];
+    if (page.document.documentElement) {
+        roots.push(page.document.documentElement);
+    }
+    if (page.document.body) {
+        roots.push(page.document.body, ...Array.from(page.document.body.querySelectorAll("*")).slice(0, 40));
+    }
+    for (const element of roots) {
+        const style = page.getComputedStyle(element);
+        for (const color of [style.backgroundColor, style.color]) {
+            const match = /rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)/.exec(color);
+            if (match) {
+                samples.push({
+                    b: Number(match[3]),
+                    g: Number(match[2]),
+                    r: Number(match[1]),
+                });
+            }
+        }
+    }
+    return { innerText, samples };
+}
+/**
+ * Runs inside Playwright's page.evaluate. Keep self-contained: Playwright
+ * serializes only this body. Default `view` is the browser globalThis.
+ */
+export function readLibraryCaptureParentEvents(view) {
+    const page = view ?? globalThis;
+    const events = page.__sbGatewayCaptureEvents;
+    if (!Array.isArray(events)) {
+        return [];
+    }
+    const recorded = [];
+    for (const event of events) {
+        if (event &&
+            typeof event === "object" &&
+            typeof event.type === "string") {
+            recorded.push({ type: event.type });
+        }
+    }
+    return recorded;
+}
+export async function captureLibraryScreenshotWithPlaywright(input) {
+    const target = libraryCaptureUrl(input.iframeBaseUrl);
+    if (!target) {
+        console.warn("gateway library screenshot skipped: not a library URL", {
+            url: input.iframeBaseUrl,
+        });
+        return undefined;
+    }
+    let chromium;
+    try {
+        const mod = (await import(
+        /* webpackIgnore: true */ "playwright"));
+        chromium = mod.chromium;
+    }
+    catch (error) {
+        console.warn("gateway library screenshot: playwright unavailable", {
+            message: error instanceof Error ? error.message : String(error),
+        });
+        return undefined;
+    }
+    const timeoutMs = input.timeoutMs ?? DEFAULT_CAPTURE_TIMEOUT_MS;
+    let browser;
+    let cancelled = false;
+    let timedOut = false;
+    let probeLogged = false;
+    const collector = {
+        consoleText: [],
+        execute: [],
+        pageErrors: [],
+    };
+    let parentEvents = [];
+    let paintInnerText = "";
+    let paintKind = "unknown";
+    const emitProbeOnce = () => {
+        if (probeLogged) {
+            return;
+        }
+        probeLogged = true;
+        logCaptureProbe(summarizeCaptureProbe({
+            agentUrl: input.bootstrapData.agentUrls?.[0],
+            consoleText: collector.consoleText,
+            execute: collector.execute,
+            pageErrors: collector.pageErrors,
+            parentEvents,
+            paintInnerText,
+            paintKind,
+        }));
+    };
+    const capture = (async () => {
+        const startedAt = Date.now();
+        try {
+            const launched = await chromium.launch({ headless: true });
+            browser = launched;
+            if (cancelled) {
+                await launched.close().catch(() => undefined);
+                return undefined;
+            }
+            const page = await browser.newPage();
+            attachLibraryCaptureProbe(page, collector);
+            await page.addInitScript({
+                content: buildLibraryParentScript({
+                    bootstrapData: input.bootstrapData,
+                    initData: input.initData,
+                }),
+            });
+            await page.setViewportSize({ height: 800, width: 1280 });
+            await page.goto(target, {
+                timeout: timeoutMs,
+                waitUntil: "domcontentloaded",
+            });
+            await page
+                .locator("body > *")
+                .first()
+                .waitFor({ state: "visible", timeout: timeoutMs })
+                .catch(() => undefined);
+            await page.waitForTimeout(APP_PAINT_SETTLE_MS);
+            // Home's first paint is often "Loading first order..." with v3/execute
+            // still in flight. Closing Chromium after the settle aborts that fetch,
+            // which is why the probe showed POST with no status. Wait out the
+            // request (or the capture budget) before photographing.
+            const waitUntil = startedAt + timeoutMs - SCREENSHOT_RESERVE_MS;
+            while (!cancelled &&
+                Date.now() < waitUntil &&
+                executeStillInFlight(collector.execute)) {
+                await page.waitForTimeout(EXECUTE_POLL_MS);
+            }
+            if (collector.execute.length > 0 &&
+                !executeStillInFlight(collector.execute)) {
+                await page.waitForTimeout(POST_EXECUTE_PAINT_MS);
+            }
+            const paint = (await page.evaluate(readLibraryPaintInPage));
+            parentEvents = (await page.evaluate(readLibraryCaptureParentEvents));
+            paintInnerText = paint.innerText;
+            const verdict = classifyLibraryPaint(paint);
+            paintKind = verdict.kind === "skip" ? verdict.reason : verdict.kind;
+            emitProbeOnce();
+            if (verdict.kind === "skip") {
+                console.error(`gateway live canvas skipped: ${verdict.reason}`, {
+                    url: target,
+                });
+                return undefined;
+            }
+            let quality = 80;
+            let buffer = await page.screenshot({ quality, type: "jpeg" });
+            while (buffer.byteLength > PREVIEW_SCREENSHOT_MAX_BYTES && quality > 30) {
+                quality -= 10;
+                buffer = await page.screenshot({ quality, type: "jpeg" });
+            }
+            if (buffer.byteLength > PREVIEW_SCREENSHOT_MAX_BYTES) {
+                console.warn("gateway library screenshot exceeds size cap; skipping", {
+                    bytes: buffer.byteLength,
+                });
+                return undefined;
+            }
+            return {
+                dataBase64: buffer.toString("base64"),
+                mimeType: "image/jpeg",
+            };
+        }
+        catch (error) {
+            emitProbeOnce();
+            if (timedOut) {
+                return undefined;
+            }
+            console.warn("gateway library screenshot failed", {
+                message: error instanceof Error ? error.message : String(error),
+                url: target,
+            });
+            return undefined;
+        }
+    })();
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            timedOut = true;
+            cancelled = true;
+            emitProbeOnce();
+            console.error("gateway live canvas skipped: capture_timeout", {
+                timeoutMs,
+                url: target,
+            });
+            resolve(undefined);
+        }, timeoutMs);
+    });
+    try {
+        return await Promise.race([capture, timeout]);
+    }
+    finally {
+        cancelled = true;
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+        emitProbeOnce();
+        await browser?.close().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=capture-library.js.map

package/dist/capture/capture-library.js.map

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

package/dist/capture/classify-library-paint.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Preview sign-in copy is a failed live-library capture: the JPEG looks like
+ * a real page but is the auth wall. A white/empty canvas is returned as
+ * bytes so the agent can see it; screenshotBase64 now travels in MCP JSON.
+ */
+export type LibraryPaintSample = {
+    b: number;
+    g: number;
+    r: number;
+};
+export type LibraryPaint = {
+    innerText: string;
+    samples: ReadonlyArray<LibraryPaintSample>;
+};
+export type LibraryPaintVerdict = {
+    kind: "ok";
+} | {
+    kind: "skip";
+    reason: "preview_sign_in";
+};
+export declare function classifyLibraryPaint(paint: LibraryPaint): LibraryPaintVerdict;