@trusty-squire/mcp 1.1.13 → 1.1.14-rc.2

package/dist/bot/identity-runtime.js

@@ -0,0 +1,141 @@
+// Step 3 of the multi-session browser broker migration: a Chrome lifetime
+// that outlives any single session's reference to it. Production still admits
+// exactly one session at a time (the exclusive profile lease in
+// session/lifecycle.ts is unchanged) — this only separates "who owns Chrome's
+// process lifetime" from "who is currently borrowing its tabs" so a later PR
+// can attach a second session without re-deriving that boundary.
+//
+// Generic over the launched handle (BrowserController in production, a fake
+// in tests) so this file never has to construct a real browser to be tested.
+export class IncompatibleIdentityRuntimeSettingsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "IncompatibleIdentityRuntimeSettingsError";
+    }
+}
+function defaultSettingsCompatible(live, requested) {
+    return JSON.stringify(live) === JSON.stringify(requested);
+}
+/** Owns one Chrome for one identity/profile. Launch is single-flight; tab
+ * acquisition and Chrome shutdown are deliberately separate operations so
+ * releasing a session never has to mean tearing the browser down. */
+export class IdentityRuntime {
+    handle = null;
+    settings = null;
+    pendingSettings = null;
+    epoch = 0;
+    launchPromise = null;
+    leaseCount = 0;
+    settingsCompatible;
+    constructor(opts = {}) {
+        this.settingsCompatible = opts.settingsCompatible ?? defaultSettingsCompatible;
+    }
+    currentEpoch() {
+        return this.epoch;
+    }
+    isLive() {
+        return this.handle !== null;
+    }
+    // True while some caller's launch() is in flight (single-flighted — see
+    // acquire()). Lets a caller that lost a synchronous race for the OS-level
+    // resource the launch itself protects (see session/lifecycle.ts's
+    // experimental-multisession fallback) tell "this identity is being (or
+    // already was) launched IN THIS PROCESS" from "busy for an unrelated
+    // reason" before deciding to join it.
+    isLaunching() {
+        return this.launchPromise !== null;
+    }
+    activeLeaseCount() {
+        return this.leaseCount;
+    }
+    // Detects a stale reference: true once the runtime has moved past the epoch
+    // a caller was handed at acquire time (a relaunch happened underneath it).
+    isEpochStale(epoch) {
+        return epoch !== this.epoch;
+    }
+    /**
+     * Acquires this identity's Chrome, launching it at most once for any number
+     * of concurrent callers. `launch` runs only for the caller that wins the
+     * single-flight race; every other concurrent caller (and every caller while
+     * a compatible instance is already live) awaits that one launch or reuses
+     * the live handle without relaunching.
+     *
+     * A request whose settings differ from the currently live (or in-flight)
+     * launch is rejected rather than silently applied to the shared context —
+     * the caller must forgetAfterShutdown() a live runtime before requesting
+     * different settings.
+     */
+    async acquire(settings, launch) {
+        const liveSettings = this.settings ?? this.pendingSettings;
+        if (liveSettings !== null && !this.settingsCompatible(liveSettings, settings)) {
+            throw new IncompatibleIdentityRuntimeSettingsError("IdentityRuntime.acquire: requested settings are incompatible with the live/in-flight " +
+                "identity. Refusing to mutate a shared browser context — call forgetAfterShutdown() " +
+                "after closing it, then acquire() again for a fresh identity.");
+        }
+        if (this.handle !== null) {
+            this.leaseCount += 1;
+            return {
+                handle: this.handle,
+                epoch: this.epoch,
+                reused: true,
+                releaseTabs: this.makeReleaseTabs(),
+            };
+        }
+        if (this.launchPromise === null) {
+            this.pendingSettings = settings;
+            this.launchPromise = launch(settings).finally(() => {
+                this.pendingSettings = null;
+            });
+        }
+        let handle;
+        try {
+            handle = await this.launchPromise;
+        }
+        finally {
+            this.launchPromise = null;
+        }
+        // Only the first continuation to resume after the shared launch settles
+        // records it as the live identity — every other concurrent waiter sees
+        // `this.handle !== null` below and joins as a reuse rather than
+        // double-counting the same launch as a second (re)launch.
+        const wonLaunch = this.handle === null;
+        if (wonLaunch) {
+            this.handle = handle;
+            this.settings = settings;
+            this.epoch += 1;
+        }
+        const resolvedHandle = this.handle;
+        if (resolvedHandle === null) {
+            throw new Error("IdentityRuntime: invariant violated — no live handle after acquire");
+        }
+        this.leaseCount += 1;
+        return {
+            handle: resolvedHandle,
+            epoch: this.epoch,
+            reused: !wonLaunch,
+            releaseTabs: this.makeReleaseTabs(),
+        };
+    }
+    makeReleaseTabs() {
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            this.leaseCount = Math.max(0, this.leaseCount - 1);
+        };
+    }
+    /**
+     * Forgets the current identity so the next acquire() launches fresh. Does
+     * NOT close Chrome — the caller closes the handle itself (its close()
+     * semantics, timeouts, and force-close fallbacks stay exactly where they
+     * are today) and calls this afterward, in a `finally`, regardless of
+     * outcome. Safe to call when nothing is live.
+     */
+    forgetAfterShutdown() {
+        this.handle = null;
+        this.settings = null;
+        this.leaseCount = 0;
+    }
+}
+//# sourceMappingURL=identity-runtime.js.map

package/dist/bot/identity-runtime.js.map

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

package/dist/bot/owned-pages.d.ts

@@ -0,0 +1,16 @@
+import type { Page } from "playwright";
+/** Session-local page ownership; context membership is never ownership proof. */
+export declare class OwnedPages {
+    private readonly onPopup;
+    private readonly owner;
+    private readonly pages;
+    constructor(onPopup: (page: Page) => void);
+    /** Only call for a known primary/recovery page, or a proven popup below. */
+    register(page: Page): void;
+    has(page: Page): boolean;
+    /** True only when a DIFFERENT registry has positively claimed the page. */
+    claimedByAnother(page: Page): boolean;
+    live(): Page[];
+    dispose(): void;
+}
+//# sourceMappingURL=owned-pages.d.ts.map

package/dist/bot/owned-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-pages.d.ts","sourceRoot":"","sources":["../../src/bot/owned-pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC,iFAAiF;AACjF,qBAAa,UAAU;IAIT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;gBAExB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI;IAE1D,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IA0B1B,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO;IAIxB,2EAA2E;IAC3E,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO;IAKrC,IAAI,IAAI,IAAI,EAAE;IAId,OAAO,IAAI,IAAI;CAGhB"}

package/dist/bot/owned-pages.js

@@ -0,0 +1,58 @@
+// Claims survive registry disposal while the Page is reachable: a different
+// controller must never acquire an old session's page by registering it again.
+const owners = new WeakMap();
+/** Session-local page ownership; context membership is never ownership proof. */
+export class OwnedPages {
+    onPopup;
+    owner = Symbol("browser-session");
+    pages = new Map();
+    constructor(onPopup) {
+        this.onPopup = onPopup;
+    }
+    /** Only call for a known primary/recovery page, or a proven popup below. */
+    register(page) {
+        const owner = owners.get(page);
+        if (owner !== undefined && owner !== this.owner) {
+            throw new Error("Browser page already belongs to another session");
+        }
+        if (page.isClosed() || this.pages.has(page))
+            return;
+        owners.set(page, this.owner);
+        // Playwright emits this on the opener using lineage captured when the
+        // target was created. Do not resolve page.opener() later: it can disappear
+        // when the opener closes. No event/proven opener means no assignment.
+        const popup = (child) => {
+            if (!this.has(page) || child.context() !== page.context())
+                return;
+            if (owners.has(child))
+                return; // duplicate/foreign attribution fails closed
+            this.register(child);
+            if (this.has(child))
+                this.onPopup(child);
+        };
+        const dispose = () => {
+            page.off("popup", popup);
+            page.off("close", dispose);
+            this.pages.delete(page);
+        };
+        this.pages.set(page, dispose);
+        page.on("popup", popup);
+        page.on("close", dispose);
+    }
+    has(page) {
+        return this.pages.has(page) && !page.isClosed();
+    }
+    /** True only when a DIFFERENT registry has positively claimed the page. */
+    claimedByAnother(page) {
+        const owner = owners.get(page);
+        return owner !== undefined && owner !== this.owner;
+    }
+    live() {
+        return [...this.pages.keys()].filter((page) => this.has(page));
+    }
+    dispose() {
+        for (const dispose of this.pages.values())
+            dispose();
+    }
+}
+//# sourceMappingURL=owned-pages.js.map

package/dist/bot/owned-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-pages.js","sourceRoot":"","sources":["../../src/bot/owned-pages.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,+EAA+E;AAC/E,MAAM,MAAM,GAAG,IAAI,OAAO,EAAgB,CAAC;AAE3C,iFAAiF;AACjF,MAAM,OAAO,UAAU;IAIQ;IAHZ,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAClC,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAErD,YAA6B,OAA6B;QAA7B,YAAO,GAAP,OAAO,CAAsB;IAAG,CAAC;IAE9D,4EAA4E;IAC5E,QAAQ,CAAC,IAAU;QACjB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QACpD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,sEAAsE;QACtE,2EAA2E;QAC3E,sEAAsE;QACtE,MAAM,KAAK,GAAG,CAAC,KAAW,EAAQ,EAAE;YAClC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,OAAO,EAAE;gBAAE,OAAO;YAClE,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,6CAA6C;YAC5E,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACrB,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,IAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClD,CAAC;IAED,2EAA2E;IAC3E,gBAAgB,CAAC,IAAU;QACzB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC;IACrD,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO;QACL,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,OAAO,EAAE,CAAC;IACvD,CAAC;CACF"}

package/dist/bot/page-driver.d.ts

@@ -0,0 +1,35 @@
+import type { BrowserContext, Page } from "playwright";
+import { OwnedPages } from "./owned-pages.js";
+/** One session's page lifetime; never launches or terminates a browser process. */
+export declare class PageDriver {
+    private readonly getContext;
+    private readonly humanize;
+    page: Page | null;
+    primaryPage: Page | null;
+    private openedTabs;
+    readonly ownedPages: OwnedPages;
+    private readonly documentSubscriptions;
+    private mainDocumentSequence;
+    private readonly mainDocumentIdentities;
+    private readonly trackedMainDocumentPages;
+    harnessAttachedPage: boolean;
+    oauthProductPage: Page | null;
+    oauthProviderPage: Page | null;
+    oauthProviderPageClosed: boolean;
+    constructor(getContext: () => BrowserContext | null, humanize: boolean);
+    private get context();
+    private sleep;
+    trackMainDocument(page: Page): void;
+    mainDocumentIdentity(): string;
+    trackOpenedTabs(page: Page): void;
+    currentUrl(): string;
+    recoverActivePage(): boolean;
+    armOpenedTabAdoption(): void;
+    adoptOpenedTab(graceMs?: number): Promise<string | null>;
+    private takeFollowableTab;
+    adoptLivePage(): boolean;
+    goto(url: string): Promise<void>;
+    reload(): Promise<void>;
+    disposeRegistrations(): void;
+}
+//# sourceMappingURL=page-driver.d.ts.map

package/dist/bot/page-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-driver.d.ts","sourceRoot":"","sources":["../../src/bot/page-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,mFAAmF;AACnF,qBAAa,UAAU;IA8CnB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IA9C3B,IAAI,EAAE,IAAI,GAAG,IAAI,CAAQ;IAMzB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAQhC,OAAO,CAAC,UAAU,CAAc;IAEhC,QAAQ,CAAC,UAAU,aAIhB;IAEH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA+B;IAErE,OAAO,CAAC,oBAAoB,CAAK;IAEjC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAA+B;IAEtE,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAuB;IAIhE,mBAAmB,UAAS;IAO5B,gBAAgB,EAAE,IAAI,GAAG,IAAI,CAAQ;IAErC,iBAAiB,EAAE,IAAI,GAAG,IAAI,CAAQ;IAEtC,uBAAuB,UAAS;gBAEb,UAAU,EAAE,MAAM,cAAc,GAAG,IAAI,EACvC,QAAQ,EAAE,OAAO;IAEpC,OAAO,KAAK,OAAO,GAElB;IACD,OAAO,CAAC,KAAK;IAIb,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IA4BnC,oBAAoB,IAAI,MAAM;IAS9B,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAOjC,UAAU,IAAI,MAAM;IAIpB,iBAAiB,IAAI,OAAO;IAS5B,oBAAoB,IAAI,IAAI;IAWtB,cAAc,CAAC,OAAO,SAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA8BzD,OAAO,CAAC,iBAAiB;IAiBzB,aAAa,IAAI,OAAO;IAmBlB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsGhC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ7B,oBAAoB,IAAI,IAAI;CAK7B"}

package/dist/bot/page-driver.js

@@ -0,0 +1,302 @@
+import { OwnedPages } from "./owned-pages.js";
+/** One session's page lifetime; never launches or terminates a browser process. */
+export class PageDriver {
+    getContext;
+    humanize;
+    page = null;
+    // The page start() configured with the controller's navigation/captcha
+    // handlers. OAuth may temporarily switch `this.page` to a popup, but session
+    // reuse must always restore this original page rather than adopting a popup
+    // whose lifecycle handlers were never installed.
+    primaryPage = null;
+    // Tabs the PAGE opened (target=_blank / window.open) since the operator armed
+    // adoption for an action, oldest first. A real user lands on the tab their
+    // click opened — an email magic-link button in Gmail is the case this exists
+    // for — so the operator has to follow it too. Reading the link's href instead
+    // is not an option: a single-use login token is sealed and must never be
+    // handed to the model as text.
+    openedTabs = [];
+    ownedPages = new OwnedPages((page) => {
+        this.trackMainDocument(page);
+        this.openedTabs.push(page);
+        if (this.openedTabs.length > 8)
+            this.openedTabs.splice(0, this.openedTabs.length - 8);
+    });
+    documentSubscriptions = new Map();
+    mainDocumentSequence = 0;
+    mainDocumentIdentities = new WeakMap();
+    trackedMainDocumentPages = new WeakSet();
+    // The replay harness owns this context so it can route the storefront from a
+    // HAR, then remove that route before checkout becomes live.
+    harnessAttachedPage = false;
+    // T6/T7 — OAuth handshake bookkeeping. Legacy startOAuth() adopts a
+    // popup window as the active page, so keep the product tab parked here
+    // until settleAfterOAuth() restores it. The operator's oauth_login action
+    // keeps the observed product page active for the click and opens a recovery
+    // tab before the provider can redirect or close either OAuth transport.
+    oauthProductPage = null;
+    oauthProviderPage = null;
+    oauthProviderPageClosed = false;
+    constructor(getContext, humanize) {
+        this.getContext = getContext;
+        this.humanize = humanize;
+    }
+    get context() {
+        return this.getContext();
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    trackMainDocument(page) {
+        if (page.isClosed() || this.trackedMainDocumentPages.has(page))
+            return;
+        this.trackedMainDocumentPages.add(page);
+        this.mainDocumentIdentities.set(page, ++this.mainDocumentSequence);
+        // A REPLACED main document advances the identity; a same-document History
+        // API navigation does not. Playwright emits `framenavigated` for both, so
+        // keying on it made every `history.replaceState` inside an SPA checkout
+        // retire every operator ref mid-form — the identity churned faster than a
+        // multi-field address block could be filled. `domcontentloaded` fires once
+        // per real main-frame document (playwright's client `Frame` gates it on
+        // `!this._parentFrame`), which is exactly the document-replacement signal.
+        // A same-document route change to a genuinely different logical page is
+        // still caught by the observation epoch's normalized origin+pathname fold
+        // (compactV2EpochDoc), which is the backstop this narrowing relies on.
+        const onDocument = () => {
+            this.mainDocumentIdentities.set(page, ++this.mainDocumentSequence);
+        };
+        const dispose = () => {
+            page.off("domcontentloaded", onDocument);
+            page.off("close", dispose);
+            this.documentSubscriptions.delete(page);
+            this.trackedMainDocumentPages.delete(page);
+        };
+        this.documentSubscriptions.set(page, dispose);
+        page.on("domcontentloaded", onDocument);
+        page.on("close", dispose);
+    }
+    mainDocumentIdentity() {
+        const page = this.page;
+        if (page === null)
+            return "none";
+        this.trackMainDocument(page);
+        return String(this.mainDocumentIdentities.get(page));
+    }
+    // Register only explicitly created primary/recovery pages. Popup enrollment
+    // follows their creation-time opener events, never context-wide page events.
+    trackOpenedTabs(page) {
+        this.ownedPages.register(page);
+        this.trackMainDocument(page);
+    }
+    // URL of the active page (the OAuth page mid-handshake, the product
+    // page otherwise). Cheap — no screenshot, unlike getState().
+    currentUrl() {
+        return this.page !== null ? this.page.url() : "";
+    }
+    recoverActivePage() {
+        return this.adoptLivePage();
+    }
+    // ───────────── new-tab adoption ─────────────
+    //
+    // Arm adoption immediately BEFORE an action that may open a tab. Anything
+    // already queued belonged to an earlier action and is not this action's to
+    // follow.
+    armOpenedTabAdoption() {
+        this.openedTabs.length = 0;
+    }
+    // Adopt the newest live tab opened since armOpenedTabAdoption() as the active
+    // page, so the next observe/act reads the tab the click actually opened.
+    // Returns the adopted URL, or null when the action opened no followable tab.
+    //
+    // `graceMs` covers the window between the click returning and Playwright
+    // delivering the context "page" event; a caller that has already waited for
+    // the page to settle passes 0 and just drains what arrived.
+    async adoptOpenedTab(graceMs = 0) {
+        const deadline = Date.now() + Math.max(0, graceMs);
+        let candidate = this.takeFollowableTab();
+        while (candidate === null && Date.now() < deadline) {
+            await this.sleep(50);
+            candidate = this.takeFollowableTab();
+        }
+        if (candidate === null)
+            return null;
+        this.openedTabs.length = 0;
+        // A window.open target starts at about:blank and is navigated a tick later.
+        // Adopting it while blank would report an empty page to the host, so wait
+        // (bounded) for the document it was opened for.
+        const blank = (url) => url === "" || url === "about:blank" || url === "about:srcdoc";
+        for (let i = 0; i < 40 && !candidate.isClosed() && blank(candidate.url()); i++) {
+            await this.sleep(50);
+        }
+        if (!this.ownedPages.has(candidate))
+            return null;
+        this.page = candidate;
+        this.trackMainDocument(candidate);
+        await candidate.bringToFront().catch(() => undefined);
+        await candidate
+            .waitForLoadState("domcontentloaded", { timeout: 15_000 })
+            .catch(() => undefined);
+        return candidate.isClosed() ? null : candidate.url();
+    }
+    // Newest owned popup the operator may follow. Explicit primary/recovery
+    // pages never enter the queue; the active page and OAuth transports retain
+    // their existing lifecycle handling.
+    takeFollowableTab() {
+        for (let i = this.openedTabs.length - 1; i >= 0; i--) {
+            const tab = this.openedTabs[i];
+            if (!this.ownedPages.has(tab))
+                continue;
+            if (tab === this.page ||
+                tab === this.primaryPage ||
+                tab === this.oauthProductPage ||
+                tab === this.oauthProviderPage) {
+                continue;
+            }
+            return tab;
+        }
+        return null;
+    }
+    adoptLivePage() {
+        if (this.page !== null && this.ownedPages.has(this.page))
+            return true;
+        if (this.context === null)
+            return false;
+        const pages = this.ownedPages.live();
+        if (pages.length === 0)
+            return false;
+        const product = this.oauthProductPage !== null && this.ownedPages.has(this.oauthProductPage)
+            ? this.oauthProductPage
+            : null;
+        const nonAuth = [...pages]
+            .reverse()
+            .find((p) => !/accounts\.google\.com|github\.com\/login|login\.microsoftonline\.com/i.test(p.url()));
+        this.page = nonAuth ?? product ?? pages[pages.length - 1] ?? null;
+        return this.page !== null;
+    }
+    async goto(url) {
+        if (!this.page)
+            throw new Error("Browser not started");
+        // Retry transient network/proxy drops. A residential SOCKS tunnel
+        // intermittently resets a connection mid-navigation (Chrome surfaces
+        // net::ERR_SOCKS_CONNECTION_FAILED / ERR_CONNECTION_RESET / ERR_NETWORK_
+        // CHANGED / ERR_TIMED_OUT), especially on heavy onboarding pages that
+        // open many subresource connections at once (algolia's dashboard_setup).
+        // The host is reachable on the next attempt — a single goto failure
+        // shouldn't fail the whole signup. Only retry these connection-level
+        // errors; HTTP statuses and selector/logic errors fall straight through.
+        // net::ERR_ABORTED — a navigation superseded by a redirect/JS-nav during
+        // the domcontentloaded wait. Usually transient (a redirect race on the
+        // first hit of an auth-gated portal — MEASURED 2026-06-11: defang's
+        // portal.defang.io aborted on the initial goto); a retry lands the
+        // settled page. Distinct from ERR_CONNECTION_ABORTED (a dropped socket).
+        const TRANSIENT_NET = /ERR_SOCKS_CONNECTION_FAILED|ERR_CONNECTION_(?:RESET|CLOSED|FAILED|ABORTED)|ERR_NETWORK_CHANGED|ERR_TIMED_OUT|ERR_NAME_NOT_RESOLVED|net::ERR_EMPTY_RESPONSE|net::ERR_ABORTED/i;
+        const MAX_GOTO_ATTEMPTS = 3;
+        const sameOriginPathAndSearch = (a, b) => {
+            try {
+                const left = new URL(a);
+                const right = new URL(b);
+                return (left.origin === right.origin &&
+                    left.pathname === right.pathname &&
+                    left.search === right.search);
+            }
+            catch {
+                return false;
+            }
+        };
+        const landedAuthGateForTarget = (landedRaw, targetRaw) => {
+            try {
+                const landed = new URL(landedRaw);
+                const target = new URL(targetRaw);
+                if (landed.origin !== target.origin)
+                    return false;
+                return /\/(?:sign[_-]?in|login|log[_-]?in|auth)(?:\/|$)/i.test(landed.pathname);
+            }
+            catch {
+                return false;
+            }
+        };
+        for (let attempt = 1;; attempt++) {
+            try {
+                await this.page.goto(url, { waitUntil: "domcontentloaded", timeout: 60000 });
+                // A SOCKS/connection drop does NOT always throw: Chrome resolves
+                // domcontentloaded on its own `chrome-error://chromewebdata/`
+                // interstitial and goto returns cleanly. The bot then ran the whole
+                // planner on a dead error page and gave up after one round (MEASURED
+                // 2026-06-11: galileo/lancedb landed on chrome-error with the app
+                // host as the title, never retried). Treat a chrome-error landing as
+                // the same transient class and retry it like a thrown net error.
+                const landed = this.page.url();
+                if (landed.startsWith("chrome-error://")) {
+                    if (attempt >= MAX_GOTO_ATTEMPTS) {
+                        throw new Error(`net::navigation landed on a Chrome error page for ${url} ` +
+                            `after ${attempt} attempts (transient proxy/host failure)`);
+                    }
+                    await this.sleep(1500 * attempt);
+                    continue;
+                }
+                break;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                // Some client-routed apps commit the address bar to the requested SPA
+                // route but never fire the lifecycle event Playwright is waiting for.
+                // Treat that as a successful navigation: callers immediately inspect
+                // the DOM and have their own element-level waits.
+                if (/Timeout \d+ms exceeded/i.test(msg)) {
+                    await this.sleep(500);
+                    if (sameOriginPathAndSearch(this.page.url(), url))
+                        break;
+                    if (landedAuthGateForTarget(this.page.url(), url))
+                        break;
+                    await this.page
+                        .waitForURL((landed) => sameOriginPathAndSearch(landed.toString(), url), {
+                        timeout: 5000,
+                    })
+                        .then(() => undefined)
+                        .catch(() => undefined);
+                    if (sameOriginPathAndSearch(this.page.url(), url))
+                        break;
+                    if (landedAuthGateForTarget(this.page.url(), url))
+                        break;
+                }
+                if (attempt >= MAX_GOTO_ATTEMPTS || !TRANSIENT_NET.test(msg))
+                    throw err;
+                // Linear backoff — give the tunnel a moment to recover a slot.
+                await this.sleep(1500 * attempt);
+            }
+        }
+        // Post-load dwell. Cloudflare/reCAPTCHA scoring runs JS that
+        // collects behavior signals over a window (typically 500-2000ms);
+        // landing on a page and immediately interacting reads as bot-like.
+        // The "dwell" gives the scoring window enough wall-clock to settle
+        // and also gives any deferred JS time to register event listeners
+        // we'll later fire.
+        if (this.humanize) {
+            await this.sleep(rand(800, 2000));
+        }
+    }
+    // Reload the current page. Used by the post-verify flow to make a SPA
+    // re-read a server-side state change (email verified) that the client
+    // hasn't picked up yet. Best-effort: a reload failure is non-fatal — the
+    // caller re-reads the page state regardless.
+    async reload() {
+        if (!this.page)
+            throw new Error("Browser not started");
+        try {
+            await this.page.reload({ waitUntil: "domcontentloaded", timeout: 20_000 });
+        }
+        catch {
+            // reload failed (slow SPA / transient) — caller re-inspects anyway
+        }
+    }
+    disposeRegistrations() {
+        this.ownedPages.dispose();
+        for (const dispose of this.documentSubscriptions.values())
+            dispose();
+        this.openedTabs.length = 0;
+    }
+}
+function rand(min, max) {
+    return Math.floor(min + Math.random() * (max - min + 1));
+}
+//# sourceMappingURL=page-driver.js.map

package/dist/bot/page-driver.js.map

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

package/dist/bot/provision-session.d.ts

@@ -102,6 +102,10 @@ export interface Observation {
         state: "in_progress";
         provider_page: "closed_or_detached";
         next_action: "operate_observe";
+    } | {
+        state: "awaiting_human";
+        reason: string;
+        next_action: "operate_observe";
     };
     needs_user?: NeedsUserLogin;
     user_email?: string;