@wudao-org/browser 0.0.0-stage → 0.4.20

package/dist/port.d.ts

@@ -0,0 +1,141 @@
+/** Options the runtime resolves BEFORE a launch (executable resolution order
+ *  and the honest-error contract live in runtime.ts, not here). */
+export interface BrowserLaunchOptions {
+    /** A fully resolved browser binary. Absent → the driver's own registry
+     *  lookup (for playwright: PLAYWRIGHT_BROWSERS_PATH-relative). */
+    readonly executablePath?: string;
+    /** v1 is headful by design — the whole point is a window the user can
+     *  watch (弧门: 看得见的浏览器). headless stays an option for the E2E lane. */
+    readonly headless?: boolean;
+    /** Extra env for the driver launch (PLAYWRIGHT_BROWSERS_PATH rides here). */
+    readonly env?: Readonly<Record<string, string>>;
+    /** ω99-114: the persistent profile dir the browser launches with
+     *  (chromium.launchPersistentContext's userDataDir). The runtime always
+     *  resolves an absolute path before launching; the default adapter is
+     *  fail-closed on its absence — there is NO silent fallback to an
+     *  ephemeral context (login state must survive process restarts, or not
+     *  promise persistence at all). */
+    readonly userDataDir?: string;
+    /** ω99-142: the directory page-initiated downloads are saved into (the
+     *  runtime resolves <home>/browser/page-downloads before launching; the
+     *  adapter mkdirs it and wires context.on("download") → saveAs). Absent →
+     *  the adapter wires NO download interception — the runtime always passes
+     *  it, so absence means a hand-rolled port, never the product path. */
+    readonly downloadsDir?: string;
+}
+/** One live browser process (default impl: one playwright Browser). */
+export interface BrowserHandle {
+    newPage(): Promise<PageHandle>;
+    close(): Promise<void>;
+    /** Best-effort SYNCHRONOUS kill for process-exit hooks — an async close()
+     *  cannot settle inside "exit". Absent → close() is the only recourse. */
+    kill?(): void;
+}
+/** ω99-142 — one COMPLETED page-initiated download (a page's export button
+ *  clicked by the model, saved to disk by the adapter's context.on("download")
+ *  interception). An in-flight save is deliberately NOT representable: the
+ *  manifest reports only files that actually landed (honest numbers). */
+export interface DownloadRecord {
+    /** The sanitized landed filename — timestamp-prefixed, safeSegment-verified
+     *  (the page-controlled suggestedFilename NEVER joins a path raw). */
+    readonly filename: string;
+    /** File size in bytes (stat after saveAs). */
+    readonly bytes: number;
+    /** The absolute path the file landed at. */
+    readonly path: string;
+}
+/** One controlled tab (default impl: one playwright Page). */
+export interface PageHandle {
+    /** The page's current URL — the runtime's navigation detector. */
+    url(): Promise<string>;
+    /** Navigate; resolves on domcontentloaded with the FINAL url (redirects
+     *  included). Throws on invalid/unreachable targets. */
+    goto(url: string): Promise<{
+        readonly finalUrl: string;
+    }>;
+    title(): Promise<string>;
+    /** Evaluate a page expression (the snapshot collector runs here). */
+    evaluate<T = unknown>(script: string): Promise<T>;
+    /** Click the element matching the selector (snapshot refs become
+     *  `[data-wudao-ref="eN"]` selectors). Short timeout — a miss is the stale
+     *  story, not a 30s hang. */
+    click(selector: string): Promise<void>;
+    /** ω99-139 — click at RAW viewport coordinates for the canvas/unref'd layer
+     *  of browser_click_xy. SPACE: CSS pixels, the same grid as the snapshot
+     *  bboxes (getBoundingClientRect) and browser_see's css-scale screenshot —
+     *  the driver dispatches at viewport coordinates, so no conversion happens
+     *  on either side of this seam. */
+    clickAt(x: number, y: number): Promise<void>;
+    /** ω99-141 — move the mouse to RAW viewport coordinates, then dispatch a
+     *  wheel with the given deltas — ONE gesture (move + wheel are inseparable:
+     *  the driver routes the wheel to the scrollable container under the
+     *  pointer, which is exactly what browser_scroll_xy needs and what
+     *  page-level window.scrollBy can never reach). SPACE: CSS pixels, the same
+     *  grid as the snapshot bboxes and clickAt; dx/dy are wheel deltas in the
+     *  same units (positive dy scrolls down). */
+    wheelAt(x: number, y: number, dx: number, dy: number): Promise<void>;
+    /** Type text into a form field (focus + replace). */
+    fill(selector: string, text: string): Promise<void>;
+    /** The page body's visible text. */
+    text(): Promise<string>;
+    /** Press a keyboard key at the page ("Enter" for submit). */
+    press(key: string): Promise<void>;
+    /** ω99-140 — type text KEYSTROKE BY KEYSTROKE into whatever element
+     *  currently holds focus (playwright's keyboard.type dispatches each key
+     *  to the focused element). The typing primitive for browser_type_xy's
+     *  miss layer: clickAt(x, y) lands the focus, typeText fills it — an
+     *  unref'd field (canvas, contenteditable) has no selector, so focus is
+     *  the only honest address. */
+    typeText(text: string): Promise<void>;
+    /** ω99-136 — PNG bytes of the page for the vision lane (canvas pages the
+     *  DOM snapshot is blind to). DEFAULT PIXEL SPACE: DEVICE pixels —
+     *  playwright captures via CDP, so a Retina tab (devicePixelRatio 2) yields
+     *  a PNG twice the CSS viewport in each dimension; snapshot bboxes
+     *  (snapshot.ts) are CSS pixels.
+     *  ω99-138 — `scale: "css"` captures at device-INDEPENDENT CSS pixels (the
+     *  DPR gap is normalized at the source), which makes CSS the canonical
+     *  coordinate space: a css-scale screenshot and the bbox table describe the
+     *  same grid, so no conversion ever has to happen downstream. The device
+     *  default stays (136 behavior, zero drift); browser_see asks for "css". */
+    screenshot(opts?: {
+        readonly scale?: "css" | "device";
+    }): Promise<Uint8Array>;
+    /** ω99-142 — the COMPLETED page-initiated downloads of this browser
+     *  session (context-level: any tab's export lands here; the surface rides
+     *  the page because the runtime is single-page). Completed saves only —
+     *  a save still in flight never appears (the manifest has no phantom
+     *  rows). Optional: the default adapter always provides it. */
+    downloads?(): Promise<readonly DownloadRecord[]>;
+    close(): Promise<void>;
+}
+/** The seam. Inject a Fake in every unit battery; the default is the
+ *  playwright-core adapter below. */
+export interface BrowserPort {
+    launch(opts: BrowserLaunchOptions): Promise<BrowserHandle>;
+}
+/** Timeouts the default adapter pins (playwright's 30s defaults would turn a
+ *  stale-ref miss into a half-minute hang; these keep failure honest and
+ *  quick). Exported for the E2E lane's expectations. */
+export declare const PORT_TIMEOUTS: {
+    /** Navigation budget (a slow first paint is fine to wait for). */
+    readonly gotoMs: 30000;
+    /** Element-action budget (click/fill — a miss means stale refs). */
+    readonly actionMs: 5000;
+};
+/** The default BrowserPort — playwright-core, loaded lazily. The dynamic
+ *  import is the ONLY reference to the driver in this package's static
+ *  graph; unit tests never reach it (they inject their own port). The
+ *  playwright objects are viewed through a minimal structural type so this
+ *  adapter survives driver typing churn (sync url(), evaluate overloads,
+ *  the launched-process optional).
+ *
+ *  ω99-114: launches via chromium.launchPersistentContext(userDataDir, …) —
+ *  one persistent profile per userDataDir, so cookies/logins survive
+ *  process restarts (the whole point of the login arc). The returned
+ *  BrowserContext (not a Browser) has pages()/newPage()/close() but NO
+ *  process handle, so this handle omits kill (BrowserHandle.kill is
+ *  optional): playwright's own SIGINT/SIGTERM/SIGHUP handling below is the
+ *  first line of process hygiene, and the runtime's exit hook degrades to
+ *  a close() attempt — recorded honestly, never faked. */
+export declare function createPlaywrightPort(): BrowserPort;
+//# sourceMappingURL=port.d.ts.map

package/dist/port.d.ts.map

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

package/dist/port.js

@@ -0,0 +1,145 @@
+// ω99-112 — the controlled-browser port: the injectable seam between the
+// wudao runtime and the browser driver. Everything above this file is driver
+// agnostic (tests inject a Fake port, zero real browser); playwright-core
+// itself is imported ONLY inside the default implementation's launch(), as a
+// dynamic import — importing this module costs nothing and the CLI's static
+// graph never pulls the ~9MB driver in until a browser is actually launched.
+//
+// PageHandle is deliberately playwright-shaped (a strict subset: goto/title/
+// evaluate/click/fill/text/press/close + url for stale-ref detection), so the
+// default adapter below is a one-liner per method and a second driver (CDP,
+// WebKit, …) can slot in without touching the runtime, the snapshot, or the
+// six model tools.
+// ω99-142 — the download seam: the adapter intercepts context-level
+// "download" events (a page export would otherwise vanish on close) and
+// saves them under sanitized names; PageHandle gains an OPTIONAL downloads()
+// for the manifest (the default adapter always provides it — absence marks a
+// hand-rolled port, never the product path).
+import { mkdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { safeSegment } from "./download.js";
+/** Timeouts the default adapter pins (playwright's 30s defaults would turn a
+ *  stale-ref miss into a half-minute hang; these keep failure honest and
+ *  quick). Exported for the E2E lane's expectations. */
+export const PORT_TIMEOUTS = {
+    /** Navigation budget (a slow first paint is fine to wait for). */
+    gotoMs: 30_000,
+    /** Element-action budget (click/fill — a miss means stale refs). */
+    actionMs: 5_000,
+};
+/** The default BrowserPort — playwright-core, loaded lazily. The dynamic
+ *  import is the ONLY reference to the driver in this package's static
+ *  graph; unit tests never reach it (they inject their own port). The
+ *  playwright objects are viewed through a minimal structural type so this
+ *  adapter survives driver typing churn (sync url(), evaluate overloads,
+ *  the launched-process optional).
+ *
+ *  ω99-114: launches via chromium.launchPersistentContext(userDataDir, …) —
+ *  one persistent profile per userDataDir, so cookies/logins survive
+ *  process restarts (the whole point of the login arc). The returned
+ *  BrowserContext (not a Browser) has pages()/newPage()/close() but NO
+ *  process handle, so this handle omits kill (BrowserHandle.kill is
+ *  optional): playwright's own SIGINT/SIGTERM/SIGHUP handling below is the
+ *  first line of process hygiene, and the runtime's exit hook degrades to
+ *  a close() attempt — recorded honestly, never faked. */
+export function createPlaywrightPort() {
+    return {
+        async launch(opts) {
+            // Fail-closed BEFORE the dynamic import: absent/empty userDataDir
+            // must refuse here (unit-testable without pulling the ~9MB driver —
+            // 红线 4), and must never silently fall back to an ephemeral context
+            // that would eat the login state on exit.
+            if (typeof opts.userDataDir !== "string" || opts.userDataDir === "") {
+                throw new Error("userDataDir is required: the controlled browser always launches with a persistent profile (no silent fallback to an ephemeral context).");
+            }
+            const userDataDir = opts.userDataDir;
+            const { chromium } = await import("playwright-core");
+            const context = (await chromium.launchPersistentContext(userDataDir, {
+                headless: opts.headless ?? false,
+                ...(opts.executablePath !== undefined ? { executablePath: opts.executablePath } : {}),
+                ...(opts.env !== undefined ? { env: { ...process.env, ...opts.env } } : {}),
+                // Playwright's own signal hygiene is the first line of "进程退出必收
+                // 窗"; our exit hook (runtime.ts) is the belt-and-braces second
+                // (degraded to close() — see the doc comment above).
+                handleSIGINT: true,
+                handleSIGTERM: true,
+                handleSIGHUP: true,
+            }));
+            // ω99-142 — a page-initiated download left unsaved is LOST when the
+            // context closes (playwright keeps it only in memory): intercept every
+            // download event, saveAs into the caller-resolved dir under a
+            // timestamp-prefixed SANITIZED name, and record COMPLETED saves for
+            // PageHandle.downloads() (the manifest reports landed files only).
+            const completed = [];
+            if (opts.downloadsDir !== undefined) {
+                const dir = opts.downloadsDir;
+                // Honest failure: a downloads dir we cannot create is a launch
+                // failure (the interception promise cannot be kept) — never a silent
+                // no-download posture (the exact bug this arc exists to close).
+                await mkdir(dir, { recursive: true });
+                const inflight = new Set(); // received-but-unsaved — invisible to the manifest by design
+                context.on("download", (d) => {
+                    inflight.add(d);
+                    void (async () => {
+                        // suggestedFilename is PAGE-CONTROLLED: safeSegment (download.ts)
+                        // or the "download.bin" fallback — the raw name never joins a path.
+                        const safeName = safeSegment(d.suggestedFilename()) ?? "download.bin";
+                        const filename = `${Date.now()}-${safeName}`; // timestamp prefix: same-name exports never overwrite
+                        const path = join(dir, filename);
+                        await d.saveAs(path);
+                        completed.push({ filename, bytes: (await stat(path)).size, path });
+                    })()
+                        .catch(() => undefined) // a failed save never enters the manifest (completed only — honest numbers)
+                        .finally(() => { inflight.delete(d); });
+                });
+            }
+            const adapt = (page) => ({
+                url: async () => page.url(),
+                async goto(url) {
+                    await page.goto(url, { waitUntil: "domcontentloaded", timeout: PORT_TIMEOUTS.gotoMs });
+                    return { finalUrl: page.url() };
+                },
+                title: () => page.title(),
+                evaluate: (script) => page.evaluate(script),
+                click: (selector) => page.click(selector, { timeout: PORT_TIMEOUTS.actionMs }),
+                // ω99-139: raw coordinate click (CSS pixels) — mouse passthrough.
+                clickAt: (x, y) => page.mouse.click(x, y),
+                // ω99-141: coordinate wheel — move the pointer FIRST, then wheel; the
+                // driver delivers the scroll to whatever container sits under (x, y).
+                wheelAt: async (x, y, dx, dy) => {
+                    await page.mouse.move(x, y);
+                    await page.mouse.wheel(dx, dy);
+                },
+                fill: (selector, text) => page.fill(selector, text, { timeout: PORT_TIMEOUTS.actionMs }),
+                text: () => page.innerText("body"),
+                press: (key) => page.keyboard.press(key),
+                // ω99-140: keystroke typing to the FOCUSED element — one-line
+                // passthrough (see PageHandle.typeText for the semantics).
+                typeText: (text) => page.keyboard.type(text),
+                // ω99-136: vision-lane passthrough — PNG bytes in the driver's device
+                // pixel space, straight from playwright (see PageHandle.screenshot).
+                // ω99-138: an explicit scale rides through verbatim; absent scale
+                // keeps the 136 bytes (playwright's device default) — zero drift.
+                screenshot: (opts) => page.screenshot({ type: "png", ...(opts?.scale !== undefined ? { scale: opts.scale } : {}) }),
+                close: () => page.close(),
+                // ω99-142: the manifest — one shared array per context (every page of
+                // this launch sees the same completed records; a COPY, never the live
+                // array). No downloadsDir → no method: the honest degradation.
+                ...(opts.downloadsDir !== undefined
+                    ? { downloads: async () => [...completed] }
+                    : {}),
+            });
+            return {
+                async newPage() {
+                    // launchPersistentContext spawns with one initial blank page —
+                    // adopt it instead of piling up tabs; newPage() only when the
+                    // initial page is gone (closed by a test or the idle reaper).
+                    const page = context.pages()[0] ?? (await context.newPage());
+                    return adapt(page);
+                },
+                close: () => context.close(),
+            };
+        },
+    };
+}
+//# sourceMappingURL=port.js.map

package/dist/port.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,92 @@
+import type { BrowserPort, PageHandle } from "./port.js";
+import type { ElementBbox } from "./snapshot.js";
+/** The idle reaper's window: 10 minutes of no tool calls → the page and the
+ *  browser close (no orphan windows after the model wanders off). */
+export declare const DEFAULT_IDLE_MS: number;
+export type BrowserState = "closed" | "launching" | "open";
+/** The last snapshot's ref→element mapping (see snapshot.ts). */
+export interface SnapshotRefEntry {
+    readonly selector: string;
+    readonly desc: string;
+    /** ω99-114: the input's type attribute when the collector saw one.
+     *  "password" arms the fail-closed typing gate in tools.ts (the model
+     *  never types passwords); undefined means unknown — NOT password — and
+     *  never blocks typing (fail-closed fires only on certain knowledge). */
+    readonly type?: string;
+    /** ω99-139: the element's viewport rect in CSS pixels when the collector
+     *  reported one (136's ElementBbox) — browser_click_xy's hit-test source.
+     *  Absent = geometry not collected, never guessed; it never gates click/type. */
+    readonly bbox?: ElementBbox;
+}
+export interface PageSnapshotRefs {
+    readonly url: string;
+    readonly refs: ReadonlyMap<string, SnapshotRefEntry>;
+}
+/** The executable resolution decision (pure; order pinned by tests):
+ *  env override → the downloaded/installed kernel → the driver's registry. */
+export type ExecutableResolution = {
+    readonly kind: "executable";
+    readonly path: string;
+} | {
+    readonly kind: "registry";
+};
+export declare function resolveExecutablePath(env: Record<string, string | undefined>, installed: string | null): ExecutableResolution;
+/** Honest launch failure (model-facing): what broke + the one-sentence way
+ *  out. Every launch-path failure surfaces THIS shape, never a raw stack. */
+export declare function browserLaunchError(reason: string): Error;
+export interface BrowserRuntimeOptions {
+    readonly port?: BrowserPort;
+    /** default ~/.wudao-desktop (the desktop app's data home). */
+    readonly homeDir?: string;
+    /** default () => process.env (read at LAUNCH time, not construction). */
+    readonly env?: () => Record<string, string | undefined>;
+    readonly idleMs?: number;
+    /** E2E lane may force headless; product default is headful (围观). */
+    readonly headless?: boolean;
+    /** ω99-114 persistent login profile: the userDataDir the browser launches
+     *  with, so cookies/logins survive process restarts (a site the user
+     *  logged into once in the visible window is still logged in next time).
+     *  Default <home>/browser/profile — the SAME root as the kernel download
+     *  (download.ts's browserRoot), never the user's daily browser profile.
+     *  Created lazily on first launch; construction stays zero-IO. Tests/E2E
+     *  may inject a temp dir. */
+    readonly userDataDir?: string;
+    /** default: ensureChromiumDownloaded (first-use download). */
+    readonly download?: (homeDir: string) => Promise<{
+        readonly executablePath: string;
+    }>;
+    /** default: installedExecutablePath (the ~/.wudao-desktop/browser probe). */
+    readonly resolveInstalled?: (homeDir: string) => Promise<string | null>;
+    /** default: node:fs/promises mkdir({recursive:true}). Injected as an
+     *  immediate no-op by fake-timer choreographies (a real-IO mkdir cannot
+     *  settle inside advanceTimersByTimeAsync, which yields only microtasks
+     *  and fake timers); the A-2 battery keeps the real default and asserts
+     *  the directory truly materializes. */
+    readonly profileMkdir?: (dir: string) => Promise<void>;
+    /** default: process.once("exit", fn); returns the unregister. */
+    readonly registerExitHook?: (fn: () => void) => () => void;
+    /** ω99-112 SEA degrade: the probe for the single-file desktop bundle.
+     *  Default: node:sea's isSea(). Under SEA the launch fails FAST with the
+     *  honest posture (the bundle ships playwright-core as an esbuild external
+     *  — its internal requires cannot bundle), instead of a module-not-found
+     *  stack or a silent hang. Terminal/dev mode is unaffected. */
+    readonly seaProbe?: () => boolean;
+}
+export interface BrowserRuntime {
+    state(): BrowserState;
+    /** Launch-if-needed (memoized) + reset the idle reaper. Rejects with the
+     *  honest browserLaunchError on any launch-path failure. */
+    openPage(): Promise<PageHandle>;
+    /** Reset the idle window (every tool call rides this). */
+    touch(): void;
+    /** Close page + browser, clear timers/hooks/snapshot. Idempotent. */
+    close(): Promise<void>;
+    /** Snapshot bookkeeping (the tools' ref store; navigation voids it). */
+    saveSnapshot(url: string, refs: ReadonlyMap<string, SnapshotRefEntry>): void;
+    currentSnapshot(): PageSnapshotRefs | null;
+    invalidateSnapshot(): void;
+    /** Void the snapshot when the page moved since it was taken. */
+    noteUrl(url: string): void;
+}
+export declare function createBrowserRuntime(opts?: BrowserRuntimeOptions): BrowserRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

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

package/dist/runtime.js

@@ -0,0 +1,188 @@
+// ω99-112 — the browser runtime: one controlled browser per session, with a
+// closed→launching→open state machine, launch-once memoization (concurrent
+// tool calls share one launch), a 10-minute idle reaper (every tool call
+// resets it; the visible window closes itself when the model stops using
+// it), a process-exit hook belt-and-braces over playwright's own signal
+// handling, and the snapshot ref store with navigation invalidation.
+// Construction is ZERO-IO: nothing spawns, nothing stats, nothing reads env
+// until the first openPage() — safe to build at every frontend boot seam.
+import { homedir } from "node:os";
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { createPlaywrightPort } from "./port.js";
+import { browserRoot, ensureChromiumDownloaded, installedExecutablePath } from "./download.js";
+/** The idle reaper's window: 10 minutes of no tool calls → the page and the
+ *  browser close (no orphan windows after the model wanders off). */
+export const DEFAULT_IDLE_MS = 10 * 60_000;
+export function resolveExecutablePath(env, installed) {
+    const fromEnv = (env["WUDAO_BROWSER_EXECUTABLE"] ?? "").trim();
+    if (fromEnv !== "")
+        return { kind: "executable", path: fromEnv };
+    if (installed !== null)
+        return { kind: "executable", path: installed };
+    return { kind: "registry" };
+}
+/** Honest launch failure (model-facing): what broke + the one-sentence way
+ *  out. Every launch-path failure surfaces THIS shape, never a raw stack. */
+export function browserLaunchError(reason) {
+    return new Error(`Browser launch failed (${reason}). The Chromium kernel auto-downloads to ~/.wudao-desktop/browser on first use; to prepare it manually, point WUDAO_BROWSER_EXECUTABLE at a local Chromium executable and retry.`);
+}
+const defaultRegisterExitHook = (fn) => {
+    process.once("exit", fn);
+    return () => process.removeListener("exit", fn);
+};
+/** node:sea's isSea, guarded for non-Node/runtimes without the module. */
+const defaultSeaProbe = () => {
+    try {
+        // node:sea exists on Node >= 22; isSea() is false everywhere except a
+        // single-executable application blob.
+        return process.getBuiltinModule?.("node:sea")?.isSea() === true;
+    }
+    catch {
+        return false;
+    }
+};
+export function createBrowserRuntime(opts = {}) {
+    const port = opts.port ?? createPlaywrightPort();
+    const homeDir = opts.homeDir ?? join(homedir(), ".wudao-desktop");
+    // ω99-114: the persistent login profile (string resolution only — the
+    // dir itself materializes on first launch, never at construction).
+    const userDataDir = opts.userDataDir ?? join(browserRoot(homeDir), "profile");
+    // ω99-142: where page-initiated downloads land — a sibling of the profile
+    // under the SAME browser root, deliberately independent of the kernel's
+    // scratch "downloads" dir (page exports never mix with kernel zips).
+    const downloadsDir = join(browserRoot(homeDir), "page-downloads");
+    const envRead = opts.env ?? (() => process.env);
+    const idleMs = opts.idleMs ?? DEFAULT_IDLE_MS;
+    const download = opts.download ?? ((home) => ensureChromiumDownloaded({ homeDir: home }));
+    const resolveInstalled = opts.resolveInstalled ?? ((home) => installedExecutablePath(home));
+    const profileMkdir = opts.profileMkdir ?? ((dir) => mkdir(dir, { recursive: true }));
+    const registerExitHook = opts.registerExitHook ?? defaultRegisterExitHook;
+    const seaProbe = opts.seaProbe ?? defaultSeaProbe;
+    let state = "closed";
+    let handle;
+    let page;
+    let inflight;
+    let idleTimer;
+    let unregisterExit;
+    let snapshot = null;
+    const disarmIdle = () => {
+        if (idleTimer !== undefined)
+            clearTimeout(idleTimer);
+        idleTimer = undefined;
+    };
+    const armIdle = () => {
+        disarmIdle();
+        idleTimer = setTimeout(() => { void closeInternal(); }, idleMs);
+        idleTimer?.unref?.();
+    };
+    const exitHook = () => {
+        // An async close cannot settle inside "exit" — the sync kill is the
+        // real reaper (playwright's own SIG* handling is the first line).
+        if (handle?.kill !== undefined)
+            handle.kill();
+        else
+            void handle?.close();
+    };
+    async function launch() {
+        // ω99-112 SEA degrade: inside the desktop single-file bundle the driver
+        // is an esbuild external (unbundleable internal requires) — fail fast
+        // with the honest posture, never a module stack or a hang.
+        if (seaProbe()) {
+            throw browserLaunchError("the desktop app bundle does not ship the browser driver yet — browser tools work in terminal/dev mode and arrive in a coming desktop release");
+        }
+        const env = envRead();
+        const installed = await resolveInstalled(homeDir).catch(() => null);
+        const resolution = resolveExecutablePath(env, installed);
+        let launchOpts;
+        if (resolution.kind === "executable") {
+            launchOpts = { executablePath: resolution.path, ...(opts.headless === true ? { headless: true } : {}) };
+        }
+        else {
+            // First use: try the download once; a user-managed registry kernel
+            // (PLAYWRIGHT_BROWSERS_PATH) stays the fallback when it fails.
+            let downloaded;
+            try {
+                downloaded = (await download(homeDir)).executablePath;
+            }
+            catch {
+                downloaded = undefined; // honest fallback below; a full failure surfaces there
+            }
+            launchOpts = {
+                ...(downloaded !== undefined ? { executablePath: downloaded } : { env: { PLAYWRIGHT_BROWSERS_PATH: browserRoot(homeDir) } }),
+                ...(opts.headless === true ? { headless: true } : {}),
+            };
+        }
+        try {
+            // ω99-114: materialize the persistent profile dir (idempotent; lazy —
+            // see BrowserRuntimeOptions.userDataDir). Its failure is a launch
+            // failure and surfaces the honest shape.
+            await profileMkdir(userDataDir);
+        }
+        catch (err) {
+            throw browserLaunchError(`could not create the persistent profile directory ${userDataDir} (${err instanceof Error ? err.message : String(err)})`);
+        }
+        try {
+            // ω99-142: downloadsDir rides every launch (the adapter's download
+            // interception seam — without it a page export vanishes on close).
+            handle = await port.launch({ ...launchOpts, userDataDir, downloadsDir });
+            page = await handle.newPage();
+        }
+        catch (err) {
+            handle = undefined;
+            page = undefined;
+            throw browserLaunchError(err instanceof Error ? err.message : String(err));
+        }
+        state = "open";
+        unregisterExit = registerExitHook(exitHook);
+        armIdle();
+        return page;
+    }
+    async function closeInternal() {
+        if (state === "closed" && handle === undefined && page === undefined)
+            return;
+        const p = page;
+        const h = handle;
+        page = undefined;
+        handle = undefined;
+        state = "closed";
+        snapshot = null;
+        disarmIdle();
+        if (unregisterExit !== undefined)
+            unregisterExit();
+        unregisterExit = undefined;
+        try {
+            await p?.close();
+        }
+        catch { /* best-effort */ }
+        try {
+            await h?.close();
+        }
+        catch { /* best-effort */ }
+    }
+    return {
+        state: () => state,
+        openPage() {
+            if (state === "open" && page !== undefined) {
+                armIdle();
+                return Promise.resolve(page);
+            }
+            if (inflight !== undefined)
+                return inflight;
+            state = "launching";
+            inflight = launch().then((p) => { inflight = undefined; return p; }, (err) => { inflight = undefined; state = "closed"; throw err; });
+            return inflight;
+        },
+        touch: () => { if (state === "open")
+            armIdle(); },
+        close: closeInternal,
+        saveSnapshot(url, refs) { snapshot = { url, refs }; },
+        currentSnapshot: () => snapshot,
+        invalidateSnapshot() { snapshot = null; },
+        noteUrl(url) {
+            if (snapshot !== null && snapshot.url !== url)
+                snapshot = null;
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,2EAA2E;AAC3E,yEAAyE;AACzE,yEAAyE;AACzE,wEAAwE;AACxE,qEAAqE;AACrE,4EAA4E;AAC5E,0EAA0E;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAM/F;qEACqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,MAAM,CAAC;AA6B3C,MAAM,UAAU,qBAAqB,CACnC,GAAuC,EACvC,SAAwB;IAExB,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACjE,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACvE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC;AAED;6EAC6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,IAAI,KAAK,CACd,0BAA0B,MAAM,kLAAkL,CACnN,CAAC;AACJ,CAAC;AAwDD,MAAM,uBAAuB,GAAG,CAAC,EAAc,EAAgB,EAAE;IAC/D,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzB,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,eAAe,GAAG,GAAY,EAAE;IACpC,IAAI,CAAC;QACH,sEAAsE;QACtE,sCAAsC;QACtC,OAAO,OAAO,CAAC,gBAAgB,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,OAA8B,EAAE;IACnE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,oBAAoB,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAClE,sEAAsE;IACtE,mEAAmE;IACnE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC;IAC9E,0EAA0E;IAC1E,wEAAwE;IACxE,qEAAqE;IACrE,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,wBAAwB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAClG,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;IACpG,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7F,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,uBAAuB,CAAC;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAe,CAAC;IAElD,IAAI,KAAK,GAAiB,QAAQ,CAAC;IACnC,IAAI,MAAiC,CAAC;IACtC,IAAI,IAA4B,CAAC;IACjC,IAAI,QAAyC,CAAC;IAC9C,IAAI,SAAoD,CAAC;IACzD,IAAI,cAAwC,CAAC;IAC7C,IAAI,QAAQ,GAA4B,IAAI,CAAC;IAE7C,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,IAAI,SAAS,KAAK,SAAS;YAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QACrD,SAAS,GAAG,SAAS,CAAC;IACxB,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,UAAU,EAAE,CAAC;QACb,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,KAAK,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAChE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;IACvB,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,oEAAoE;QACpE,kEAAkE;QAClE,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,EAAE,CAAC;;YACzC,KAAK,MAAM,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC,CAAC;IAEF,KAAK,UAAU,MAAM;QACnB,wEAAwE;QACxE,sEAAsE;QACtE,2DAA2D;QAC3D,IAAI,QAAQ,EAAE,EAAE,CAAC;YACf,MAAM,kBAAkB,CAAC,8IAA8I,CAAC,CAAC;QAC3K,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACzD,IAAI,UAAyF,CAAC;QAC9F,IAAI,UAAU,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACrC,UAAU,GAAG,EAAE,cAAc,EAAE,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1G,CAAC;aAAM,CAAC;YACN,mEAAmE;YACnE,+DAA+D;YAC/D,IAAI,UAA8B,CAAC;YACnC,IAAI,CAAC;gBACH,UAAU,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU,GAAG,SAAS,CAAC,CAAC,uDAAuD;YACjF,CAAC;YACD,UAAU,GAAG;gBACX,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,wBAAwB,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;gBAC5H,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,sEAAsE;YACtE,kEAAkE;YAClE,yCAAyC;YACzC,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,kBAAkB,CACtB,qDAAqD,WAAW,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CACzH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,mEAAmE;YACnE,mEAAmE;YACnE,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;YACzE,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,SAAS,CAAC;YACnB,IAAI,GAAG,SAAS,CAAC;YACjB,MAAM,kBAAkB,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7E,CAAC;QACD,KAAK,GAAG,MAAM,CAAC;QACf,cAAc,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,UAAU,aAAa;QAC1B,IAAI,KAAK,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QAC7E,MAAM,CAAC,GAAG,IAAI,CAAC;QACf,MAAM,CAAC,GAAG,MAAM,CAAC;QACjB,IAAI,GAAG,SAAS,CAAC;QACjB,MAAM,GAAG,SAAS,CAAC;QACnB,KAAK,GAAG,QAAQ,CAAC;QACjB,QAAQ,GAAG,IAAI,CAAC;QAChB,UAAU,EAAE,CAAC;QACb,IAAI,cAAc,KAAK,SAAS;YAAE,cAAc,EAAE,CAAC;QACnD,cAAc,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC;YAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACrD,IAAI,CAAC;YAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACvD,CAAC;IAED,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK;QAClB,QAAQ;YACN,IAAI,KAAK,KAAK,MAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC3C,OAAO,EAAE,CAAC;gBACV,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,QAAQ,CAAC;YAC5C,KAAK,GAAG,WAAW,CAAC;YACpB,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CACtB,CAAC,CAAC,EAAE,EAAE,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAC1C,CAAC,GAAG,EAAE,EAAE,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAChE,CAAC;YACF,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QACjD,KAAK,EAAE,aAAa;QACpB,YAAY,CAAC,GAAG,EAAE,IAAI,IAAI,QAAQ,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACrD,eAAe,EAAE,GAAG,EAAE,CAAC,QAAQ;QAC/B,kBAAkB,KAAK,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG;YACT,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,GAAG,KAAK,GAAG;gBAAE,QAAQ,GAAG,IAAI,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC"}