@nuanu-ai/agentbrowse 0.2.47 → 0.2.49

package/dist/sessions-backend.js

@@ -0,0 +1,126 @@
+import { buildAgentpaySessionSecretsCatalogUrl, buildAgentpayCompleteSessionUrl, buildAgentpayClaimSecretUrl, buildAgentpaySessionEventsUrl, buildAgentpaySessionSecretRequestUrl, buildAgentpaySessionSecretRequestsUrl, buildAgentpaySessionUrl, buildAgentpaySessionsUrl, resolveAgentpayGatewayConfig, } from './agentpay-gateway.js';
+export class AgentpayRequestError extends Error {
+    status;
+    payload;
+    constructor(message, options) {
+        super(message);
+        this.name = 'AgentpayRequestError';
+        this.status = options.status;
+        this.payload = options.payload;
+    }
+}
+async function requestJson(gateway, method, path, body, fetchImpl = fetch) {
+    const response = await fetchImpl(path, {
+        method,
+        headers: {
+            authorization: `Bearer ${gateway.apiKey}`,
+            ...(body === undefined ? {} : { 'content-type': 'application/json' }),
+        },
+        ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+    });
+    const rawText = await response.text();
+    const parsed = rawText.length > 0 ? JSON.parse(rawText) : null;
+    if (!response.ok) {
+        const message = parsed && typeof parsed === 'object' && typeof parsed.error === 'string'
+            ? parsed.error
+            : `AgentPay API request failed with HTTP ${response.status}`;
+        throw new AgentpayRequestError(message, {
+            status: response.status,
+            payload: parsed,
+        });
+    }
+    return parsed;
+}
+export async function createRemoteSession(input, options = {}) {
+    const gateway = resolveAgentpayGatewayConfig();
+    return requestJson(gateway, 'POST', buildAgentpaySessionsUrl(gateway.apiUrl), {
+        browser_session_id: input.browserSessionId,
+        entry_command: 'start-session',
+        ...(input.description ? { description: input.description } : {}),
+        ...(input.merchantName ? { merchant_name: input.merchantName } : {}),
+        ...(input.page ? { page: input.page } : {}),
+        ...(input.context ? { context: input.context } : {}),
+        ...(input.metadata ? { metadata: input.metadata } : {}),
+        ...(input.telemetry ? { telemetry: input.telemetry } : {}),
+        run: input.run,
+        step: input.step,
+    }, options.fetchImpl);
+}
+export async function getRemoteSession(sessionId, options = {}) {
+    const gateway = resolveAgentpayGatewayConfig();
+    return requestJson(gateway, 'GET', buildAgentpaySessionUrl(gateway.apiUrl, sessionId), undefined, options.fetchImpl);
+}
+export async function getRemoteSessionSecretCatalog(sessionId, host, options = {}) {
+    const gateway = resolveAgentpayGatewayConfig();
+    return requestJson(gateway, 'GET', `${buildAgentpaySessionSecretsCatalogUrl(gateway.apiUrl, sessionId)}?host=${encodeURIComponent(host)}`, undefined, options.fetchImpl);
+}
+export async function createRemoteSessionEvent(sessionId, input, options = {}) {
+    const gateway = resolveAgentpayGatewayConfig();
+    return requestJson(gateway, 'POST', buildAgentpaySessionEventsUrl(gateway.apiUrl, sessionId), {
+        client_event_id: input.clientEventId,
+        sequence_no: input.sequenceNo,
+        type: input.type,
+        command: input.command,
+        status: input.status,
+        summary: input.summary,
+        timestamp: input.timestamp,
+        ...(input.page ? { page: input.page } : {}),
+        ...(input.details ? { details: input.details } : {}),
+        ...(input.telemetry ? { telemetry: input.telemetry } : {}),
+        ...(input.run ? { run: input.run } : {}),
+        ...(input.step ? { step: input.step } : {}),
+    }, options.fetchImpl);
+}
+export async function completeRemoteSession(sessionId, input, options = {}) {
+    const gateway = resolveAgentpayGatewayConfig();
+    return requestJson(gateway, 'POST', buildAgentpayCompleteSessionUrl(gateway.apiUrl, sessionId), {
+        client_completion_id: input.clientCompletionId,
+        status: input.status,
+        command: input.command,
+        summary: input.summary,
+        timestamp: input.timestamp,
+        ...(input.page ? { page: input.page } : {}),
+        ...(input.details ? { details: input.details } : {}),
+        ...(input.telemetry ? { telemetry: input.telemetry } : {}),
+        run: input.run,
+        ...(input.step ? { step: input.step } : {}),
+    }, options.fetchImpl);
+}
+export async function createRemoteSecretRequest(sessionId, input, options = {}) {
+    const gateway = resolveAgentpayGatewayConfig();
+    return requestJson(gateway, 'POST', buildAgentpaySessionSecretRequestsUrl(gateway.apiUrl, sessionId), {
+        client_request_id: input.clientRequestId,
+        fill_ref: input.fillRef,
+        purpose: input.purpose,
+        merchant_name: input.merchantName,
+        ...(input.page ? { page: input.page } : {}),
+        secret_hint: {
+            ...(input.secretHint.storedSecretRef
+                ? { stored_secret_ref: input.secretHint.storedSecretRef }
+                : {}),
+            ...(input.secretHint.credentialKey
+                ? { credential_key: input.secretHint.credentialKey }
+                : {}),
+            ...(input.secretHint.credentialName
+                ? { credential_name: input.secretHint.credentialName }
+                : {}),
+            ...(input.secretHint.kind ? { kind: input.secretHint.kind } : {}),
+            ...(input.secretHint.host ? { host: input.secretHint.host } : {}),
+            ...(input.secretHint.scopeRef ? { scope_ref: input.secretHint.scopeRef } : {}),
+            ...(input.secretHint.fields ? { fields: input.secretHint.fields } : {}),
+        },
+        ...(input.telemetry ? { telemetry: input.telemetry } : {}),
+        ...(input.run ? { run: input.run } : {}),
+        ...(input.step ? { step: input.step } : {}),
+    }, options.fetchImpl);
+}
+export async function getRemoteSecretRequest(sessionId, requestId, options = {}) {
+    const gateway = resolveAgentpayGatewayConfig();
+    return requestJson(gateway, 'GET', buildAgentpaySessionSecretRequestUrl(gateway.apiUrl, sessionId, requestId), undefined, options.fetchImpl);
+}
+export async function claimRemoteSecret(sessionId, requestId, claimId, options = {}) {
+    const gateway = resolveAgentpayGatewayConfig();
+    return requestJson(gateway, 'POST', buildAgentpayClaimSecretUrl(gateway.apiUrl, sessionId, requestId), {
+        claim_id: claimId,
+    }, options.fetchImpl);
+}

package/dist/solver/browser-launcher.d.ts

@@ -1,4 +1,4 @@
-import type { Browser, Page } from 'puppeteer';
+import { type Browser, type Page } from 'puppeteer';
 import type { LaunchOptions, ProfileInfo } from './types.js';
 export type SolverSession = {
     browser: Browser;

package/dist/solver/browser-launcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-launcher.d.ts","sourceRoot":"","sources":["../../src/solver/browser-launcher.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAsB,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkBjF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC,CAAC;AAuBF,wBAAsB,YAAY,CAChC,OAAO,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,aAAa,CAAC,CAmExB;AAkUD,wBAAgB,wBAAwB,CACtC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,EAAE,CAGV"}
+{"version":3,"file":"browser-launcher.d.ts","sourceRoot":"","sources":["../../src/solver/browser-launcher.ts"],"names":[],"mappings":"AAIA,OAAO,EAA+B,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjF,OAAO,KAAK,EAAsB,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkBjF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC,CAAC;AAwBF,wBAAsB,YAAY,CAChC,OAAO,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,aAAa,CAAC,CAyDxB;AAkXD,wBAAgB,wBAAwB,CACtC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,EAAE,CAGV"}

package/dist/solver/browser-launcher.js

@@ -2,6 +2,7 @@ import { spawn } from 'node:child_process';
 import { existsSync, mkdirSync, readFileSync } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { connect as connectPuppeteer } from 'puppeteer';
 import puppeteerExtra from 'puppeteer-extra';
 import StealthPlugin from 'puppeteer-extra-plugin-stealth';
 import { buildTurnstileApiShimSource, isTurnstileApiRequest } from './turnstile-challenge.js';
@@ -16,6 +17,7 @@ const AUTO_CDP_PORT = 0;
 const CDP_DISCOVERY_TIMEOUT_MS = 30_000;
 const CDP_DISCOVERY_INTERVAL_MS = 500;
 const BROWSER_CLOSE_TIMEOUT_MS = 1_000;
+const EXTRA_PAGE_CLOSE_TIMEOUT_MS = 250;
 const INTERCEPTED_PAGES = new WeakSet();
 const LINUX_CI_CHROME_ARGS = [
     '--no-sandbox',
@@ -46,7 +48,7 @@ export async function launchSolver(profile, opts) {
         if (!cdpUrl) {
             throw buildCdpDiscoveryError(chromeProcess, opts?.cdpPort, profile.userDataDir);
         }
-        const browser = await enhancedPuppeteer.connect({ browserWSEndpoint: cdpUrl });
+        const browser = await connectToBrowser(cdpUrl, opts?.stealth);
         let page;
         if (opts?.url) {
             page = await createConfiguredPage(browser, fp);
@@ -55,18 +57,7 @@ export async function launchSolver(profile, opts) {
         else {
             page = await createConfiguredPage(browser, fp);
         }
-        // Close leftover blank tabs (if any).
-        const allPages = await browser.pages();
-        for (const p of allPages) {
-            if (p !== page) {
-                try {
-                    await p.close();
-                }
-                catch {
-                    /* already closed */
-                }
-            }
-        }
+        await closeLaunchLeftoverPages(browser, page);
         return {
             browser,
             page,
@@ -91,6 +82,12 @@ export async function launchSolver(profile, opts) {
         throw error;
     }
 }
+async function connectToBrowser(browserWSEndpoint, stealth) {
+    if (stealth === false) {
+        return connectPuppeteer({ browserWSEndpoint });
+    }
+    return enhancedPuppeteer.connect({ browserWSEndpoint });
+}
 async function discoverCdpUrl(options) {
     const deadline = Date.now() + CDP_DISCOVERY_TIMEOUT_MS;
     const activePortPath = path.join(options.userDataDir, 'DevToolsActivePort');
@@ -131,6 +128,35 @@ async function closeBrowserWithinTimeout(browser, timeoutMs) {
         clearTimeout(timeoutId);
     }
 }
+async function closeLaunchLeftoverPages(browser, activePage) {
+    const allPages = await browser.pages();
+    for (const candidate of allPages) {
+        if (candidate === activePage || !isCloseableLaunchLeftover(candidate.url())) {
+            continue;
+        }
+        await closePageWithinTimeout(candidate, EXTRA_PAGE_CLOSE_TIMEOUT_MS);
+    }
+}
+function isCloseableLaunchLeftover(url) {
+    const normalized = url.trim().toLowerCase();
+    return (normalized.length === 0 ||
+        normalized === 'about:blank' ||
+        normalized === 'chrome://newtab/' ||
+        normalized === 'chrome://new-tab-page/' ||
+        normalized === 'chrome://newtab');
+}
+async function closePageWithinTimeout(page, timeoutMs) {
+    let timeoutId;
+    await Promise.race([
+        page.close().catch(() => undefined),
+        new Promise((resolve) => {
+            timeoutId = setTimeout(resolve, timeoutMs);
+        }),
+    ]);
+    if (timeoutId) {
+        clearTimeout(timeoutId);
+    }
+}
 async function discoverCdpUrlOnPort(port) {
     try {
         const res = await fetch(`http://127.0.0.1:${port}/json/version`);

package/dist/solver/captcha-solver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"captcha-solver.d.ts","sourceRoot":"","sources":["../../src/solver/captcha-solver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpE,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAiBF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAMF;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAc;gBAEzB,MAAM,EAAE,mBAAmB;IAgBjC,KAAK,CACT,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;YAqBhB,UAAU;YAkBV,aAAa;YAOb,OAAO;CAsCtB"}
+{"version":3,"file":"captcha-solver.d.ts","sourceRoot":"","sources":["../../src/solver/captcha-solver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpE,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAiBF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAMF;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAc;gBAEzB,MAAM,EAAE,mBAAmB;IAgBjC,KAAK,CACT,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;YAqBhB,UAAU;YAkBV,aAAa;YAOb,OAAO;CAkDtB"}

package/dist/solver/captcha-solver.js

@@ -1,3 +1,4 @@
+import { tracedFetch } from '../command-api-tracing.js';
 const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
 const DEFAULT_TASK_POLL_MS = 5_000;
 const DEFAULT_TASK_TIMEOUT_MS = 120_000;
@@ -69,11 +70,17 @@ export class CaptchaSolver {
         }
         let response;
         try {
-            response = await fetch(url, {
+            response = await tracedFetch(url, {
                 method,
                 headers,
                 body: body !== undefined ? JSON.stringify(body) : undefined,
                 signal: AbortSignal.timeout(this.requestTimeoutMs),
+            }, {
+                spanName: method === 'POST' ? 'agentpay.captcha.tasks.create' : 'agentpay.captcha.tasks.get',
+                attributes: {
+                    'agentbrowse.api.system': 'agentpay',
+                    'agentbrowse.api.route': method === 'POST' ? '/tools/captcha/tasks' : '/tools/captcha/tasks/:taskId',
+                },
             });
         }
         catch (err) {

package/dist/solver/config.d.ts

@@ -5,7 +5,6 @@ export declare function getConfigPath(): string;
 export declare function ensureDirs(): void;
 export declare function readConfig(): SolverConfig;
 export declare function writeConfig(config: SolverConfig): void;
-export declare function applyDemoProxyBootstrap(): boolean;
 export declare function getProfileDir(profileName: string): string;
 export declare function getExistingProfileDir(profileName: string): string | null;
 export declare function getUserDataDir(profileName: string): string;

package/dist/solver/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/solver/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ/C,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,wBAAgB,UAAU,IAAI,YAAY,CAOzC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAGtD;AAED,wBAAgB,uBAAuB,IAAI,OAAO,CAuBjD;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxE;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/solver/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO/C,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,wBAAgB,UAAU,IAAI,YAAY,CAOzC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAGtD;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxE;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/solver/config.js

@@ -5,7 +5,6 @@ const AGENTPAY_DIR = path.join(os.homedir(), '.agentpay');
 const PRIMARY_DIR = path.join(AGENTPAY_DIR, 'agentbrowse');
 const PRIMARY_CONFIG_PATH = path.join(AGENTPAY_DIR, 'config.json');
 const PRIMARY_PROFILES_DIR = path.join(PRIMARY_DIR, 'profiles');
-const DEMO_PROXY_PLACEHOLDER = 'http://user:pass@31.98.19.10:6186/';
 export function getSolverDir() {
     return PRIMARY_DIR;
 }
@@ -31,27 +30,6 @@ export function writeConfig(config) {
     ensureDirs();
     fs.writeFileSync(PRIMARY_CONFIG_PATH, JSON.stringify(config, null, 2) + '\n', 'utf-8');
 }
-export function applyDemoProxyBootstrap() {
-    const existingProxy = readConfig().defaults?.proxy;
-    if (typeof existingProxy === 'string' && existingProxy.trim().length > 0) {
-        return false;
-    }
-    if (existingProxy &&
-        typeof existingProxy === 'object' &&
-        typeof existingProxy.server === 'string' &&
-        existingProxy.server.trim().length > 0) {
-        return false;
-    }
-    const current = readConfig();
-    writeConfig({
-        ...current,
-        defaults: {
-            ...current.defaults,
-            proxy: DEMO_PROXY_PLACEHOLDER,
-        },
-    });
-    return true;
-}
 export function getProfileDir(profileName) {
     return path.join(PRIMARY_PROFILES_DIR, profileName);
 }

package/dist/solver/types.d.ts

@@ -62,6 +62,7 @@ export type LaunchOptions = {
     url?: string;
     cdpPort?: number;
     executablePath?: string;
+    stealth?: boolean;
     windowSize?: {
         width: number;
         height: number;

package/dist/solver/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/solver/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,kBAAkB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,YAAY,CAAC;KACtB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,sBAAsB,CAAC;AACrE,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,UAAU,GAAG,cAAc,CAAC;AAEjF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/solver/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,kBAAkB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,YAAY,CAAC;KACtB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,sBAAsB,CAAC;AACrE,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,UAAU,GAAG,cAAc,CAAC;AAEjF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC"}

package/dist/workflow-session-completion.d.ts

@@ -0,0 +1,33 @@
+import { type StepCommand } from './run-store.js';
+import type { BrowseSession } from './session.js';
+import { type CompleteRemoteSessionResponse } from './sessions-backend.js';
+export type WorkflowSessionTerminalStatus = 'completed' | 'canceled' | 'error';
+export type WorkflowRunTerminalStatus = 'completed' | 'aborted' | 'failed';
+export type CompleteWorkflowSessionRemoteResult = {
+    success: true;
+    response: CompleteRemoteSessionResponse;
+    completedAt: string;
+    runId: string;
+    stepId: string | null;
+} | {
+    success: false;
+    error: 'workflow_session_unavailable' | 'workflow_run_unavailable' | 'workflow_step_unavailable' | 'backend_session_complete_failed';
+    reason: string;
+};
+export declare function formatUnknownWorkflowCompletionError(error: unknown): string;
+export declare function clearWorkflowState(session: BrowseSession): BrowseSession;
+export declare function completeWorkflowSessionRemote(params: {
+    session: BrowseSession;
+    stepId: string | undefined;
+    command: StepCommand;
+    terminalStatus: WorkflowSessionTerminalStatus;
+    runStatus: WorkflowRunTerminalStatus;
+    summary: string;
+    outcomeType: string;
+    message: string;
+    reason?: string;
+    details?: Record<string, unknown>;
+    allowMissingStep?: boolean;
+    fetchImpl?: typeof fetch;
+}): Promise<CompleteWorkflowSessionRemoteResult>;
+//# sourceMappingURL=workflow-session-completion.d.ts.map

package/dist/workflow-session-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-session-completion.d.ts","sourceRoot":"","sources":["../src/workflow-session-completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,6BAA6B,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAC/E,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3E,MAAM,MAAM,mCAAmC,GAC3C;IACE,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,6BAA6B,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EACD,8BAA8B,GAC9B,0BAA0B,GAC1B,2BAA2B,GAC3B,iCAAiC,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAe3E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAUxE;AAgBD,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,cAAc,EAAE,6BAA6B,CAAC;IAC9C,SAAS,EAAE,yBAAyB,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAkI/C"}

package/dist/workflow-session-completion.js

@@ -0,0 +1,156 @@
+import { loadRunRecord, loadStepRecord } from './run-store.js';
+import { completeRemoteSession, } from './sessions-backend.js';
+export function formatUnknownWorkflowCompletionError(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error && typeof error === 'object') {
+        try {
+            return JSON.stringify(error);
+        }
+        catch {
+            return Object.prototype.toString.call(error);
+        }
+    }
+    return String(error);
+}
+export function clearWorkflowState(session) {
+    const nextSession = { ...session };
+    delete nextSession.browserSessionId;
+    delete nextSession.activeRunId;
+    delete nextSession.intentSessionId;
+    delete nextSession.currentRequestId;
+    delete nextSession.lastKnownStatus;
+    delete nextSession.lastEventSeq;
+    delete nextSession.transientSecretCache;
+    return nextSession;
+}
+function currentPageSummary(session) {
+    const pageRef = session.runtime?.currentPageRef;
+    const page = pageRef ? session.runtime?.pages[pageRef] : undefined;
+    return {
+        ...(pageRef ? { pageRef } : {}),
+        ...(page?.url ? { url: page.url } : {}),
+        ...(page?.title ? { title: page.title } : {}),
+    };
+}
+export async function completeWorkflowSessionRemote(params) {
+    if (!params.session.intentSessionId) {
+        return {
+            success: false,
+            error: 'workflow_session_unavailable',
+            reason: 'No active workflow session is bound to this browser session.',
+        };
+    }
+    if (!params.session.activeRunId) {
+        return {
+            success: false,
+            error: 'workflow_run_unavailable',
+            reason: 'The active workflow session is missing its local run binding.',
+        };
+    }
+    if (!params.stepId && !params.allowMissingStep) {
+        return {
+            success: false,
+            error: 'workflow_step_unavailable',
+            reason: 'The terminal command step was not created locally before session completion.',
+        };
+    }
+    const run = loadRunRecord(params.session.activeRunId);
+    if (!run) {
+        return {
+            success: false,
+            error: 'workflow_run_unavailable',
+            reason: `Local run ${params.session.activeRunId} was not found.`,
+        };
+    }
+    const step = params.stepId ? loadStepRecord(run.runId, params.stepId) : null;
+    if (params.stepId && !step && !params.allowMissingStep) {
+        return {
+            success: false,
+            error: 'workflow_step_unavailable',
+            reason: `Local step ${params.stepId} was not found.`,
+        };
+    }
+    const completedAt = new Date().toISOString();
+    const page = currentPageSummary(params.session);
+    const clientCompletionId = step?.stepId ?? `${params.command}:${run.runId}:${params.terminalStatus}`;
+    try {
+        const response = await completeRemoteSession(params.session.intentSessionId, {
+            clientCompletionId,
+            status: params.terminalStatus,
+            command: params.command,
+            summary: params.summary,
+            timestamp: completedAt,
+            ...(page.pageRef || page.url || page.title
+                ? {
+                    page: {
+                        ...(page.pageRef ? { ref: page.pageRef } : {}),
+                        ...(page.url ? { url: page.url } : {}),
+                        ...(page.title ? { title: page.title } : {}),
+                    },
+                }
+                : {}),
+            ...(params.details ? { details: params.details } : {}),
+            run: {
+                id: run.runId,
+                trace_id: run.traceContext.traceId,
+                started_at: run.startedAt,
+                ended_at: completedAt,
+                source: run.source,
+                status: params.runStatus,
+                ...(run.profile ? { profile: run.profile } : {}),
+                ...(run.hostHints?.[0] ? { site_host: run.hostHints[0] } : {}),
+                protected_run: run.protectedRun,
+            },
+            ...(step
+                ? {
+                    step: {
+                        id: step.stepId,
+                        ordinal: step.ordinal,
+                        command: step.command,
+                        started_at: step.startedAt,
+                        ended_at: completedAt,
+                        span_id: step.otel.spanId,
+                        success: params.terminalStatus !== 'error',
+                        outcome_type: params.outcomeType,
+                        message: params.message,
+                        ...(params.reason ? { reason: params.reason } : {}),
+                        ...(step.refs?.pageRef
+                            ? { page_ref: step.refs.pageRef }
+                            : page.pageRef
+                                ? { page_ref: page.pageRef }
+                                : {}),
+                        ...(step.refs?.targetRef ? { target_ref: step.refs.targetRef } : {}),
+                        ...(step.refs?.surfaceRef ? { surface_ref: step.refs.surfaceRef } : {}),
+                        ...(step.refs?.fillRef ? { fill_ref: step.refs.fillRef } : {}),
+                        ...(step.beforeSnapshotId ? { before_snapshot_id: step.beforeSnapshotId } : {}),
+                        ...(step.afterSnapshotId ? { after_snapshot_id: step.afterSnapshotId } : {}),
+                        event_count: step.eventIds.length,
+                        child_span_count: step.childSpans?.length ?? 0,
+                        protected_step: step.protectedStep,
+                    },
+                }
+                : {}),
+        }, {
+            fetchImpl: params.fetchImpl,
+        });
+        return {
+            success: true,
+            response,
+            completedAt,
+            runId: run.runId,
+            stepId: step?.stepId ?? null,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: 'backend_session_complete_failed',
+            reason: formatUnknownWorkflowCompletionError(error),
+        };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuanu-ai/agentbrowse",
-  "version": "0.2.47",
+  "version": "0.2.49",
   "type": "module",
   "description": "Browser automation CLI for AI agents: control a CDP browser, observe UI surfaces, act on refs, extract data, capture screenshots, complete protected fills, and solve captchas",
   "keywords": [
@@ -41,8 +41,16 @@
     "node": ">=18.0.0"
   },
   "scripts": {
+    "build:config:dev": "node scripts/write-build-config.mjs https://durcottggsiesxxqzvbb.supabase.co/functions/v1/api",
+    "build:config:prod": "node scripts/write-build-config.mjs https://agents-api.mercuryo.io/functions/v1/api",
     "build": "node -e \"require('node:fs').rmSync('dist',{ recursive: true, force: true })\" && tsc -p tsconfig.build.json",
     "agentbrowse": "tsx src/index.ts",
+    "poc:browserql": "tsx poc/browserql-execution-layer/src/cli.ts",
+    "poc:browserql:check-types": "tsc --noEmit -p poc/browserql-execution-layer/tsconfig.json",
+    "poc:agentql": "tsx poc/agentql-semantic-grounding/src/cli.ts",
+    "poc:agentql:check-types": "tsc --noEmit -p poc/agentql-semantic-grounding/tsconfig.json",
+    "poc:skyvern": "tsx poc/skyvern-managed-agent/src/cli.ts",
+    "poc:skyvern:check-types": "tsc --noEmit -p poc/skyvern-managed-agent/tsconfig.json",
     "test": "pnpm run test:unit && pnpm run test:e2e",
     "test:unit": "vitest run --exclude \"src/__tests__/*.e2e.test.ts\"",
     "test:e2e": "vitest run --no-file-parallelism --maxWorkers=1 src/__tests__/observe-stagehand.e2e.test.ts src/__tests__/extract.e2e.test.ts src/__tests__/protected-fill.e2e.test.ts src/__tests__/runtime.e2e.test.ts",
@@ -63,6 +71,8 @@
   "devDependencies": {
     "@agentpay/config": "workspace:*",
     "@types/node": "^22.0.0",
+    "agentql": "^1.18.1",
+    "playwright": "^1.58.2",
     "tsx": "^4.19.0",
     "typescript": "5.9.2",
     "vitest": "^4.0.18"

package/dist/commands/create-intent.d.ts

@@ -1,6 +0,0 @@
-/**
- * browse create-intent <fillRef> <storedSecretRef> — Create or reuse a stored-secret access intent.
- */
-import type { BrowseSession } from '../session.js';
-export declare function createIntent(session: BrowseSession, fillRef: string, storedSecretRef: string): Promise<void>;
-//# sourceMappingURL=create-intent.d.ts.map

package/dist/commands/create-intent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-intent.d.ts","sourceRoot":"","sources":["../../src/commands/create-intent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAmBnD,wBAAsB,YAAY,CAChC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAqEf"}

package/dist/commands/create-intent.js

@@ -1,75 +0,0 @@
-/**
- * browse create-intent <fillRef> <storedSecretRef> — Create or reuse a stored-secret access intent.
- */
-import { outputFailure, outputJSON } from '../output.js';
-import { getFillableForm, saveSecretIntentSnapshot } from '../runtime-state.js';
-import { saveSession } from '../session.js';
-import { tryResolveCatalogHost } from '../secrets/catalog-sync.js';
-import { getSecretBackend } from '../secrets/backend.js';
-import { describeSecretIntentStatus, serializeSecretIntent } from '../secrets/intent-output.js';
-function deriveRequestedFieldKeys(fillableForm, storedSecret) {
-    if (storedSecret.fieldKeys && storedSecret.fieldKeys.length > 0) {
-        return [...storedSecret.fieldKeys];
-    }
-    return fillableForm.fields.map((field) => field.fieldKey);
-}
-export async function createIntent(session, fillRef, storedSecretRef) {
-    const fillableForm = getFillableForm(session, fillRef);
-    if (!fillableForm) {
-        return outputFailure({
-            error: 'unknown_fill_ref',
-            outcomeType: 'blocked',
-            message: 'Protected intent was not created because the requested fill reference is unknown.',
-            reason: 'The provided fillRef does not match any currently observed protected fill target.',
-            fillRef,
-        });
-    }
-    const storedSecret = fillableForm.storedSecretCandidates.find((candidate) => candidate.storedSecretRef === storedSecretRef);
-    if (!storedSecret) {
-        return outputFailure({
-            error: 'stored_secret_not_available_for_fill_ref',
-            outcomeType: 'blocked',
-            message: 'Protected intent was not created because this stored secret is not available for the requested fill target.',
-            reason: 'The provided storedSecretRef is not a candidate for the requested protected fill target.',
-            fillRef,
-            storedSecretRef,
-        });
-    }
-    const pageUrl = session.runtime?.pages?.[fillableForm.pageRef]?.url;
-    const host = tryResolveCatalogHost(pageUrl);
-    if (!host) {
-        return outputFailure({
-            error: 'secret_intent_host_resolution_failed',
-            outcomeType: 'blocked',
-            message: 'Protected intent was not created because AgentBrowse could not determine the current site host.',
-            reason: 'The current page URL did not resolve to a usable host for protected intent creation.',
-            fillRef,
-            storedSecretRef,
-        });
-    }
-    const result = await getSecretBackend().createOrReuseSecretIntent({
-        fillRef,
-        storedSecretRef,
-        host,
-        pageRef: fillableForm.pageRef,
-        scopeRef: fillableForm.scopeRef,
-        purpose: fillableForm.purpose,
-        secretKind: storedSecret.kind,
-        requestedFieldKeys: deriveRequestedFieldKeys(fillableForm, storedSecret),
-    });
-    const snapshot = saveSecretIntentSnapshot(session, result.intent);
-    saveSession(session);
-    const statusContract = describeSecretIntentStatus(snapshot.status);
-    const reasonPrefix = result.reused
-        ? 'AgentBrowse reused an existing intent for this fill target.'
-        : 'AgentBrowse created a new intent for this fill target.';
-    outputJSON({
-        success: true,
-        ...serializeSecretIntent(snapshot),
-        reused: result.reused,
-        ...(statusContract.outcomeType ? { outcomeType: statusContract.outcomeType } : {}),
-        message: statusContract.message,
-        reason: `${reasonPrefix} ${statusContract.reason}`,
-        ...(statusContract.nextAction ? { nextAction: statusContract.nextAction } : {}),
-    });
-}