@superblocksteam/gateway 2.0.155-next.0

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":"AAAA;;;;;GAKG;AAEH,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,0BAA0B;IAC1B,6BAA6B;IAC7B,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,YAAY,GAChB,yFAAyF,CAAC;AAkC5F,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QACnC,OAAO,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAc,EAAE,GAAW;IACxD,OAAO,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,IAAI;SACR,OAAO,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;SAC9C,OAAO,CAAC,qCAAqC,EAAE,gBAAgB,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,OAAO,OAAO,CAAC,IAAI,CACjB,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,CAC/D,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,IAAY;IACxB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,SAAS,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAwB;IAExB,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,IAAI,SAA6B,CAAC;IAClC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO;QACL,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,KAAK,CAAC,WAAW;aACvB,MAAM,CAAC,wBAAwB,CAAC;aAChC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACnC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;gBACvD,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;gBACnB,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,CAAC,CAAC;QACH,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACxC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CACjC;QACD,KAAK,EAAE;YACL,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC;YACrC,IAAI,EAAE,KAAK,CAAC,SAAS;SACtB;QACD,MAAM;QACN,UAAU;KACX,CAAC;AACJ,CAAC;AA6BD,SAAS,aAAa,CACpB,SAAgC,EAChC,GAAwB;IAExB,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CACjC,CAAC,QAAQ,EAAE,EAAE,CACX,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM;QAC9B,QAAQ,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI;QAC1B,QAAQ,CAAC,MAAM,KAAK,SAAS;QAC7B,QAAQ,CAAC,OAAO,KAAK,SAAS,CACjC,CAAC;IACF,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC3B,CAAC;QACD,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC3B,CAAC;QACD,OAAO;IACT,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,IAAe,EACf,SAAgC;IAEhC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;QACzB,MAAM,OAAO,GAAG,GAAmB,CAAC;QACpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;YACrB,MAAM;YACN,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAG,GAAoB,CAAC;QACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,MAAM,CAAC;QACvD,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QACD,aAAa,CAAC,SAAS,EAAE;YACvB,MAAM;YACN,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC;YAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE;QAC/B,MAAM,OAAO,GAAG,GAAmB,CAAC;QACpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACnC,aAAa,CAAC,SAAS,EAAE;YACvB,OAAO,EAAE,MAAM,EAAE,SAAS,IAAI,eAAe;YAC7C,MAAM;YACN,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;QACzB,MAAM,OAAO,GAAG,GAAmB,CAAC;QACpC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;YACjE,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;QAC3B,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CACzB,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,OAAO,KAAK,IAAI,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC"}

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":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GAGtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oBAAoB,GAErB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,wBAAwB,GAEzB,MAAM,4BAA4B,CAAC;AAYpC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAClC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAC1C,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAqCpC,SAAS,iBAAiB,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,OAAO,mCAAmC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,aAAqB;IAC9C,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAkBD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAuB;IAC5D,MAAM,IAAI,GAAG,IAAI,IAAK,UAA0C,CAAC;IACjE,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC;IACtD,MAAM,OAAO,GAA0C,EAAE,CAAC;IAC1D,MAAM,KAAK,GAA0B,EAAE,CAAC;IACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,QAAQ,CAAC,IAAI,EAClB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CACrE,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,yCAAyC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpE,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC;oBACX,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACnB,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACnB,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,IAE9C;IACC,MAAM,IAAI,GACR,IAAI,IAAK,UAAgE,CAAC;IAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,wBAAwB,CAAC;IAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IACE,KAAK;YACL,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,EACtD,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAG,KAA0B,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAWD,MAAM,CAAC,KAAK,UAAU,sCAAsC,CAC1D,KAAoC;IAEpC,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,uDAAuD,EAAE;YACpE,GAAG,EAAE,KAAK,CAAC,aAAa;SACzB,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,QAA4B,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM;QACvB,yBAAyB,CAAC,YAAY,CACvC,CAEA,CAAC;QACF,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,oDAAoD,EAAE;YACjE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,0BAA0B,CAAC;IAChE,IAAI,OAAsE,CAAC;IAC3E,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,MAAM,SAAS,GAA0B;QACvC,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,EAAE;KACf,CAAC;IACF,IAAI,YAAY,GAAyB,EAAE,CAAC;IAC5C,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,SAAS,GAAG,SAAS,CAAC;IAE1B,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,WAAW,GAAG,IAAI,CAAC;QACnB,eAAe,CACb,qBAAqB,CAAC;YACpB,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YAC5C,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,YAAY;YACZ,cAAc;YACd,SAAS;SACV,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,KAAK,IAA4C,EAAE;QAClE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,OAAO,GAAG,QAAQ,CAAC;YACnB,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC9C,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;YACrC,yBAAyB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC3C,MAAM,IAAI,CAAC,aAAa,CAAC;gBACvB,OAAO,EAAE,wBAAwB,CAAC;oBAChC,aAAa,EAAE,KAAK,CAAC,aAAa;oBAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACzB,CAAC;aACH,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;gBACtB,OAAO,EAAE,SAAS;gBAClB,SAAS,EAAE,kBAAkB;aAC9B,CAAC,CAAC;YACH,MAAM,IAAI;iBACP,OAAO,CAAC,UAAU,CAAC;iBACnB,KAAK,EAAE;iBACP,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;iBACjD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC1B,MAAM,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;YAC/C,uEAAuE;YACvE,wEAAwE;YACxE,kEAAkE;YAClE,wDAAwD;YACxD,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,qBAAqB,CAAC;YAChE,OACE,CAAC,SAAS;gBACV,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACtB,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,EACvC,CAAC;gBACD,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;YAC7C,CAAC;YACD,IACE,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBAC5B,CAAC,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,EACxC,CAAC;gBACD,MAAM,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;YACnD,CAAC;YAED,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAChC,sBAAsB,CACvB,CAAiB,CAAC;YACnB,YAAY,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CACjC,8BAA8B,CAC/B,CAAyB,CAAC;YAC3B,cAAc,GAAG,KAAK,CAAC,SAAS,CAAC;YACjC,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC5C,SAAS,GAAG,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACpE,aAAa,EAAE,CAAC;YAChB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC5B,OAAO,CAAC,KAAK,CAAC,gCAAgC,OAAO,CAAC,MAAM,EAAE,EAAE;oBAC9D,GAAG,EAAE,MAAM;iBACZ,CAAC,CAAC;gBACH,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,IAAI,OAAO,GAAG,EAAE,CAAC;YACjB,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9D,OAAO,MAAM,CAAC,UAAU,GAAG,4BAA4B,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;gBACxE,OAAO,IAAI,EAAE,CAAC;gBACd,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,IAAI,MAAM,CAAC,UAAU,GAAG,4BAA4B,EAAE,CAAC;gBACrD,OAAO,CAAC,IAAI,CAAC,uDAAuD,EAAE;oBACpE,KAAK,EAAE,MAAM,CAAC,UAAU;iBACzB,CAAC,CAAC;gBACH,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,OAAO;gBACL,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACrC,QAAQ,EAAE,YAAY;aACvB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,aAAa,EAAE,CAAC;YAChB,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,mCAAmC,EAAE;gBAChD,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC/D,GAAG,EAAE,MAAM;aACZ,CAAC,CAAC;YACH,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,KAAgD,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;QACjD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS,GAAG,IAAI,CAAC;YACjB,aAAa,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,8CAA8C,EAAE;gBAC5D,SAAS;gBACT,GAAG,EAAE,MAAM;aACZ,CAAC,CAAC;YACH,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,CAAC;YAAS,CAAC;QACT,SAAS,GAAG,IAAI,CAAC;QACjB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,aAAa,EAAE,CAAC;QAChB,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

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;

package/dist/capture/classify-library-paint.js

@@ -0,0 +1,13 @@
+/**
+ * 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.
+ */
+const SIGN_IN_COPY = /\b(?:sign[\s-]?in|log[\s-]?in|continue with google|continue with github)\b/i;
+export function classifyLibraryPaint(paint) {
+    if (SIGN_IN_COPY.test(paint.innerText)) {
+        return { kind: "skip", reason: "preview_sign_in" };
+    }
+    return { kind: "ok" };
+}
+//# sourceMappingURL=classify-library-paint.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"classify-library-paint.js","sourceRoot":"","sources":["../../src/capture/classify-library-paint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,MAAM,YAAY,GAChB,6EAA6E,CAAC;AAEhF,MAAM,UAAU,oBAAoB,CAAC,KAAmB;IACtD,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/capture/host-mcp-scan.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Setup-time scan of an MCP client config for known host browser drivers.
+ *
+ * Gateway cannot see other MCP servers at tool-call time. This only inspects
+ * what is on disk (or about to be written). Config can lie: the server may
+ * fail to start or `npx` may miss PATH.
+ */
+export type HostBrowserMcpScan = {
+    found: boolean;
+    isolated: boolean;
+};
+/**
+ * Walks `mcpServers` (Claude Code, Cursor, Desktop). Superblocks Gateway is
+ * skipped so a self-scan cannot count as a host browser.
+ */
+export declare function scanHostBrowserMcp(config: unknown): HostBrowserMcpScan;

package/dist/capture/host-mcp-scan.js

@@ -0,0 +1,64 @@
+/**
+ * Setup-time scan of an MCP client config for known host browser drivers.
+ *
+ * Gateway cannot see other MCP servers at tool-call time. This only inspects
+ * what is on disk (or about to be written). Config can lie: the server may
+ * fail to start or `npx` may miss PATH.
+ */
+const HOST_BROWSER_MARKERS = [
+    "@playwright/mcp",
+    "agent-browser",
+    "chrome-devtools-mcp",
+    "puppeteer",
+];
+function tokensOf(entry) {
+    if (!entry || typeof entry !== "object") {
+        return [];
+    }
+    const record = entry;
+    const tokens = [];
+    if (typeof record.command === "string") {
+        tokens.push(record.command);
+    }
+    if (Array.isArray(record.args)) {
+        for (const arg of record.args) {
+            if (typeof arg === "string") {
+                tokens.push(arg);
+            }
+        }
+    }
+    return tokens;
+}
+function isHostBrowserDriver(tokens) {
+    return tokens.some((token) => HOST_BROWSER_MARKERS.some((marker) => token.includes(marker)));
+}
+/**
+ * Walks `mcpServers` (Claude Code, Cursor, Desktop). Superblocks Gateway is
+ * skipped so a self-scan cannot count as a host browser.
+ */
+export function scanHostBrowserMcp(config) {
+    if (!config || typeof config !== "object") {
+        return { found: false, isolated: false };
+    }
+    const mcpServers = config.mcpServers;
+    if (!mcpServers || typeof mcpServers !== "object") {
+        return { found: false, isolated: false };
+    }
+    let found = false;
+    let isolated = false;
+    for (const [name, entry] of Object.entries(mcpServers)) {
+        if (name === "superblocks") {
+            continue;
+        }
+        const tokens = tokensOf(entry);
+        if (!isHostBrowserDriver(tokens)) {
+            continue;
+        }
+        found = true;
+        if (tokens.includes("--isolated")) {
+            isolated = true;
+        }
+    }
+    return { found, isolated };
+}
+//# sourceMappingURL=host-mcp-scan.js.map

package/dist/capture/host-mcp-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-mcp-scan.js","sourceRoot":"","sources":["../../src/capture/host-mcp-scan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,oBAAoB,GAAG;IAC3B,iBAAiB;IACjB,eAAe;IACf,qBAAqB;IACrB,WAAW;CACH,CAAC;AAOX,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAgB;IAC3C,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3B,oBAAoB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAC9D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAe;IAChD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC3C,CAAC;IACD,MAAM,UAAU,GAAI,MAAmC,CAAC,UAAU,CAAC;IACnE,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CACxC,UAAqC,CACtC,EAAE,CAAC;QACF,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QACD,KAAK,GAAG,IAAI,CAAC;QACb,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAClC,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * Page source that makes a top-level pitcherURL visit look like the Code Mode
+ * iframe: mock `window.parent`, answer `sb-ready` / bootstrap / API auth in
+ * page JS so the host driver never sees the scoped JWT.
+ *
+ * Source text rather than a function handed to `addInitScript` because
+ * Playwright serializes functions and can drag bundler helpers (`__name`)
+ * into the page. Same rule as `buildEmbedHandshakeScript`.
+ */
+export type LibraryParentInitData = {
+    appId: string;
+    devServerAuthorization: string;
+    peerId: string;
+    userId?: string;
+    windowOriginUrl?: string;
+};
+export type LibraryParentBootstrapData = {
+    accessToken: string;
+    agents?: unknown[];
+    agentUrls?: string[];
+    appId: string;
+    featureFlags?: Record<string, unknown>;
+    orgId?: string;
+    profiles?: unknown;
+    token: string;
+    userEmail?: string;
+    userId: string;
+    windowOriginUrl?: string;
+};
+export type LibraryParentPayload = {
+    bootstrapData: LibraryParentBootstrapData;
+    initData: LibraryParentInitData;
+};
+export declare function buildLibraryParentScript(payload: LibraryParentPayload): string;