@amalgm/browser 0.1.2-preview.35541635545 → 0.1.2-preview.37254096068

package/dist/src/chrome/cookie-observer.d.ts

@@ -0,0 +1,20 @@
+export interface ChromeCookieEvent {
+    removed: boolean;
+    cause: string;
+    cookie: {
+        name: string;
+        value: string;
+        domain: string;
+        path: string;
+        hostOnly: boolean;
+        expirationDate?: number;
+        httpOnly: boolean;
+        secure: boolean;
+        sameSite: string;
+        partitionKey?: {
+            topLevelSite: string;
+            hasCrossSiteAncestor?: boolean;
+        };
+    };
+}
+export declare function cookieObserverDirectory(root: string): string;

package/dist/src/chrome/cookie-observer.js

@@ -0,0 +1,44 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/** This function is the extension worker's sole source; emitted JS belongs to the profile. */
+function worker() {
+    const scope = globalThis;
+    const pending = new Map();
+    let observing = false;
+    scope.chrome.cookies.onChanged.addListener(event => {
+        if (event.removed && event.cause === 'overwrite')
+            return;
+        if (observing)
+            scope.amalgmCookieEvent(JSON.stringify(event));
+        else {
+            const cookie = event.cookie;
+            const key = JSON.stringify([cookie.domain, cookie.path, cookie.name, cookie.partitionKey]);
+            pending.set(key, event);
+        }
+    });
+    // Chrome reports a worker context before it runs this script, so the controller's bindings
+    // may arrive before or after it. Both sides call this; whichever comes second starts delivery
+    // once and announces it.
+    scope.amalgmObserveCookies = () => {
+        if (observing || !scope.amalgmCookiesObserving || !scope.amalgmCookieEvent)
+            return;
+        observing = true;
+        scope.amalgmCookiesObserving('');
+        for (const event of pending.values())
+            scope.amalgmCookieEvent(JSON.stringify(event));
+        pending.clear();
+    };
+    scope.amalgmObserveCookies();
+}
+export function cookieObserverDirectory(root) {
+    const directory = path.join(root, 'cookie-observer');
+    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    fs.writeFileSync(path.join(directory, 'manifest.json'), JSON.stringify({
+        manifest_version: 3, name: 'Amalgm account cookies', version: '1.0',
+        permissions: ['cookies'], host_permissions: ['<all_urls>'],
+        background: { service_worker: 'worker.js' },
+    }), { mode: 0o600 });
+    fs.writeFileSync(path.join(directory, 'worker.js'), `(${worker.toString()})();`, { mode: 0o600 });
+    return directory;
+}
+//# sourceMappingURL=cookie-observer.js.map

package/dist/src/chrome/cookie-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-observer.js","sourceRoot":"","sources":["../../../src/chrome/cookie-observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,8FAA8F;AAC9F,SAAS,MAAM;IACb,MAAM,KAAK,GAAG,UAKb,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IACrD,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;QACjD,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW;YAAE,OAAO;QACzD,IAAI,SAAS;YAAE,KAAK,CAAC,iBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;aAC1D,CAAC;YACJ,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;YAC3F,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IACH,2FAA2F;IAC3F,8FAA8F;IAC9F,yBAAyB;IACzB,KAAK,CAAC,oBAAoB,GAAG,GAAG,EAAE;QAChC,IAAI,SAAS,IAAI,CAAC,KAAK,CAAC,sBAAsB,IAAI,CAAC,KAAK,CAAC,iBAAiB;YAAE,OAAO;QACnF,SAAS,GAAG,IAAI,CAAC;QACjB,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACrF,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC,CAAC;IACF,KAAK,CAAC,oBAAoB,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACrD,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;QACrE,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,KAAK;QACnE,WAAW,EAAE,CAAC,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC,YAAY,CAAC;QAC1D,UAAU,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE;KAC5C,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,IAAI,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAClG,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/chrome/executable.d.ts

@@ -0,0 +1 @@
+export declare function findChrome(env?: NodeJS.ProcessEnv, home?: string, platform?: NodeJS.Platform): string;

package/dist/src/chrome/executable.js

@@ -0,0 +1,55 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { BrowserError } from '../errors.js';
+// The runtime's one Chrome. An explicit path wins; otherwise the first
+// installed Chromium-family browser, then agent-browser's Chrome for Testing.
+export function findChrome(env = process.env, home = os.homedir(), platform = process.platform) {
+    const explicit = env.AMALGM_BROWSER_EXECUTABLE_PATH || env.AGENT_BROWSER_EXECUTABLE_PATH;
+    if (explicit) {
+        if (fs.existsSync(explicit))
+            return explicit;
+        throw new BrowserError('PROCESS_FAILED', `Configured Chrome executable does not exist: ${explicit}`);
+    }
+    const found = [...installed(env, home, platform), ...downloaded(home, platform)]
+        .find((candidate) => fs.existsSync(candidate));
+    if (found)
+        return found;
+    throw new BrowserError('PROCESS_FAILED', 'Chrome was not found. Install Google Chrome, or run `npx agent-browser install` to download Chrome for Testing.');
+}
+function installed(env, home, platform) {
+    if (platform === 'darwin') {
+        const apps = [
+            'Google Chrome.app/Contents/MacOS/Google Chrome',
+            'Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
+            'Chromium.app/Contents/MacOS/Chromium',
+            'Brave Browser.app/Contents/MacOS/Brave Browser',
+        ];
+        return ['/Applications', path.join(home, 'Applications')]
+            .flatMap((directory) => apps.map((app) => path.join(directory, app)));
+    }
+    if (platform === 'win32') {
+        const roots = [env.PROGRAMFILES, env['PROGRAMFILES(X86)'], env.LOCALAPPDATA].filter(Boolean);
+        return roots.flatMap((root) => [
+            path.join(root, 'Google', 'Chrome', 'Application', 'chrome.exe'),
+            path.join(root, 'Chromium', 'Application', 'chrome.exe'),
+            path.join(root, 'BraveSoftware', 'Brave-Browser', 'Application', 'brave.exe'),
+        ]);
+    }
+    return ['google-chrome', 'google-chrome-stable', 'chromium', 'chromium-browser', 'brave-browser']
+        .flatMap((name) => ['/usr/bin', '/usr/local/bin', '/snap/bin'].map((directory) => path.join(directory, name)));
+}
+function downloaded(home, platform) {
+    const root = path.join(home, '.agent-browser', 'browsers');
+    const binary = platform === 'darwin'
+        ? [`chrome-mac-${os.arch() === 'arm64' ? 'arm64' : 'x64'}`,
+            'Google Chrome for Testing.app', 'Contents', 'MacOS', 'Google Chrome for Testing']
+        : platform === 'win32' ? ['chrome-win64', 'chrome.exe'] : ['chrome-linux64', 'chrome'];
+    try {
+        return fs.readdirSync(root).sort().reverse().map((version) => path.join(root, version, ...binary));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=executable.js.map

package/dist/src/chrome/executable.js.map

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

package/dist/src/chrome/flags.d.ts

@@ -0,0 +1,7 @@
+export declare function chromeArgs(input: {
+    userDataDir: string;
+    userAgent?: string | undefined;
+    platform?: NodeJS.Platform;
+    uid?: number | undefined;
+}): string[];
+export declare function desktopUserAgent(executable: string, platform?: NodeJS.Platform): string | undefined;

package/dist/src/chrome/flags.js

@@ -0,0 +1,59 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+// Headless Chrome that presents as the user's ordinary desktop Chrome, so
+// sign-in flows see a normal browser rather than an automation client.
+export function chromeArgs(input) {
+    const platform = input.platform || process.platform;
+    return [
+        '--headless=new',
+        '--remote-debugging-port=0',
+        '--remote-debugging-address=127.0.0.1',
+        '--enable-unsafe-extension-debugging',
+        `--user-data-dir=${input.userDataDir}`,
+        '--no-first-run',
+        '--no-default-browser-check',
+        '--disable-background-networking',
+        '--disable-backgrounding-occluded-windows',
+        '--disable-component-update',
+        '--disable-default-apps',
+        '--disable-hang-monitor',
+        '--disable-prompt-on-repost',
+        '--disable-sync',
+        '--disable-features=Translate',
+        '--disable-blink-features=AutomationControlled',
+        '--metrics-recording-only',
+        '--enable-unsafe-swiftshader',
+        '--window-size=1280,800',
+        ...(input.userAgent ? [`--user-agent=${input.userAgent}`] : []),
+        ...(platform === 'linux' && input.uid === 0 ? ['--no-sandbox', '--disable-dev-shm-usage'] : []),
+        'about:blank',
+    ];
+}
+export function desktopUserAgent(executable, platform = process.platform) {
+    const major = chromeMajorVersion(executable);
+    if (!major)
+        return undefined;
+    const system = platform === 'darwin' ? 'Macintosh; Intel Mac OS X 10_15_7'
+        : platform === 'win32' ? 'Windows NT 10.0; Win64; x64' : 'X11; Linux x86_64';
+    return `Mozilla/5.0 (${system}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${major}.0.0.0 Safari/537.36`;
+}
+function chromeMajorVersion(executable) {
+    try {
+        const printed = execFileSync(executable, ['--version'], { encoding: 'utf8', timeout: 5_000 });
+        const match = /(\d+)\.\d+\.\d+\.\d+/.exec(printed);
+        if (match)
+            return match[1];
+    }
+    catch { }
+    // Windows builds print nothing for --version; the install keeps a
+    // version-named directory beside chrome.exe instead.
+    try {
+        const sibling = fs.readdirSync(path.dirname(executable)).find((name) => /^\d+\.\d+\.\d+\.\d+$/.test(name));
+        return sibling?.split('.')[0];
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=flags.js.map

package/dist/src/chrome/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../../src/chrome/flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,0EAA0E;AAC1E,uEAAuE;AACvE,MAAM,UAAU,UAAU,CAAC,KAK1B;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACpD,OAAO;QACL,gBAAgB;QAChB,2BAA2B;QAC3B,sCAAsC;QACtC,qCAAqC;QACrC,mBAAmB,KAAK,CAAC,WAAW,EAAE;QACtC,gBAAgB;QAChB,4BAA4B;QAC5B,iCAAiC;QACjC,0CAA0C;QAC1C,4BAA4B;QAC5B,wBAAwB;QACxB,wBAAwB;QACxB,4BAA4B;QAC5B,gBAAgB;QAChB,8BAA8B;QAC9B,+CAA+C;QAC/C,0BAA0B;QAC1B,6BAA6B;QAC7B,wBAAwB;QACxB,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,gBAAgB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,aAAa;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,WAA4B,OAAO,CAAC,QAAQ;IAC/F,MAAM,KAAK,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,mCAAmC;QACxE,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAC/E,OAAO,gBAAgB,MAAM,mDAAmD,KAAK,sBAAsB,CAAC;AAC9G,CAAC;AAED,SAAS,kBAAkB,CAAC,UAAkB;IAC5C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9F,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,kEAAkE;IAClE,qDAAqD;IACrD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3G,OAAO,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;AAC/B,CAAC"}

package/dist/src/chrome/host.d.ts

@@ -0,0 +1,25 @@
+import { type BrowserNavigation } from '../cdp/navigation.js';
+import type { BrowserCookieCoordinator } from '../cookies/coordinator.js';
+import type { BrowserLogger } from '../ports.js';
+export declare class ChromeHost {
+    private readonly options;
+    private readonly targets;
+    private readonly relay;
+    private running;
+    private live;
+    constructor(options: {
+        root: string;
+        cookies: BrowserCookieCoordinator;
+        logger: BrowserLogger;
+        env?: NodeJS.ProcessEnv;
+    });
+    endpoint(sessionId: string): Promise<string>;
+    pageEndpoint(sessionId: string): Promise<string>;
+    release(sessionId: string): Promise<void>;
+    observeNavigation(sessionId: string, changed: (state: BrowserNavigation) => void, signal: AbortSignal): () => void;
+    close(): Promise<void>;
+    private ensure;
+    private start;
+    private exited;
+    private stop;
+}

package/dist/src/chrome/host.js

@@ -0,0 +1,137 @@
+import path from 'node:path';
+import { connectCdp } from '../cdp/client.js';
+import { observePageNavigation } from '../cdp/navigation.js';
+import { BrowserError } from '../errors.js';
+import { CHROME_COOKIE_ADAPTER_ID, ChromeCookieAdapter } from './cookie-adapter.js';
+import { findChrome } from './executable.js';
+import { launchChrome } from './launch.js';
+import { ChromeRelay } from './relay/server.js';
+import { SessionTargets } from './relay/targets.js';
+// The runtime's one Chrome. Every browser session drives it through its own
+// relay endpoint, and every session's tabs live in one browser context whose
+// cookies stay in sync with the account's cookie store. Chrome starts on
+// first use and restarts on next use if it dies.
+export class ChromeHost {
+    options;
+    targets = new SessionTargets();
+    relay = new ChromeRelay(this.targets, async () => {
+        const running = await this.ensure();
+        return { browserUrl: running.chrome.browserUrl };
+    });
+    running = null;
+    live = null;
+    constructor(options) {
+        this.options = options;
+    }
+    async endpoint(sessionId) {
+        await this.ensure();
+        await this.relay.listen();
+        return this.relay.endpoint(sessionId);
+    }
+    // The daemon's most recent page evaluation identifies its selected target,
+    // even when several pages have the same URL.
+    async pageEndpoint(sessionId) {
+        const running = await this.ensure();
+        const targetId = this.targets.active(sessionId);
+        if (!targetId)
+            throw new BrowserError('SURFACE_IDENTITY_FAILED', 'The browser session has no selected page.');
+        const endpoint = new URL(running.chrome.browserUrl);
+        endpoint.pathname = `/devtools/page/${encodeURIComponent(targetId)}`;
+        return endpoint.toString();
+    }
+    // agent-browser detaches from, but never closes, tabs it did not launch.
+    async release(sessionId) {
+        const ids = this.targets.release(sessionId);
+        const control = this.live?.control;
+        if (control)
+            await Promise.all(ids.map((targetId) => control.call('Target.closeTarget', { targetId }).catch(() => undefined)));
+    }
+    observeNavigation(sessionId, changed, signal) {
+        let page = new AbortController();
+        const select = (targetId) => {
+            page.abort();
+            page = new AbortController();
+            const lifetime = AbortSignal.any([signal, page.signal]);
+            if (!targetId || lifetime.aborted)
+                return;
+            void this.ensure().then((running) => {
+                const url = new URL(running.chrome.browserUrl);
+                url.pathname = `/devtools/page/${encodeURIComponent(targetId)}`;
+                return observePageNavigation(url.toString(), changed, lifetime);
+            }).catch(() => { if (!lifetime.aborted)
+                changed({ canGoBack: false, canGoForward: false }); });
+        };
+        const unsubscribe = this.targets.subscribe(sessionId, select);
+        const close = () => { unsubscribe(); page.abort(); signal.removeEventListener('abort', close); };
+        signal.addEventListener('abort', close, { once: true });
+        select(this.targets.active(sessionId));
+        return close;
+    }
+    async close() {
+        const pending = this.running;
+        this.running = null;
+        await this.relay.close();
+        const running = await pending?.catch(() => null);
+        if (!running)
+            return;
+        this.live = null;
+        await this.options.cookies.close(running.cookies.id).catch((error) => {
+            this.options.logger.warn('Final Chrome cookie sync failed.', { error: error.message });
+        });
+        this.stop(running);
+        await running.chrome.kill();
+    }
+    ensure() {
+        if (!this.running) {
+            const starting = this.start();
+            this.running = starting;
+            starting.catch(() => { if (this.running === starting)
+                this.running = null; });
+        }
+        return this.running;
+    }
+    async start() {
+        const chrome = await launchChrome({
+            executable: findChrome(this.options.env),
+            userDataDir: path.join(this.options.root, 'chrome'),
+        });
+        let control;
+        try {
+            control = await connectCdp(chrome.browserUrl);
+            const cookies = new ChromeCookieAdapter(control, {
+                root: this.options.root,
+                failed: () => {
+                    this.options.logger.warn('Chrome cookie observation failed; Chrome restarts on next use.');
+                    void chrome.kill();
+                },
+            });
+            const running = { chrome, control, cookies };
+            this.options.cookies.register(cookies);
+            await cookies.ready();
+            await this.options.cookies.sync(cookies.id);
+            this.live = running;
+            void chrome.exited.then(() => this.exited(running));
+            return running;
+        }
+        catch (error) {
+            this.options.cookies.unregister(CHROME_COOKIE_ADAPTER_ID);
+            control?.close();
+            await chrome.kill();
+            throw error;
+        }
+    }
+    exited(running) {
+        if (this.live !== running)
+            return;
+        this.live = null;
+        this.running = null;
+        this.stop(running);
+        this.options.logger.warn('Chrome exited; it restarts on next use.');
+    }
+    stop(running) {
+        this.options.cookies.unregister(running.cookies.id);
+        this.targets.clear();
+        running.control.close();
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/src/chrome/host.js.map

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

package/dist/src/chrome/launch.d.ts

@@ -0,0 +1,11 @@
+export interface ChromeProcess {
+    readonly pid: number;
+    readonly browserUrl: string;
+    readonly exited: Promise<void>;
+    kill(): Promise<void>;
+}
+export declare function launchChrome(input: {
+    executable: string;
+    userDataDir: string;
+    timeoutMs?: number;
+}): Promise<ChromeProcess>;

package/dist/src/chrome/launch.js

@@ -0,0 +1,105 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import Database from 'better-sqlite3';
+import { BrowserError } from '../errors.js';
+import { connectCdp, deadline } from '../cdp/client.js';
+import { chromeArgs, desktopUserAgent } from './flags.js';
+export async function launchChrome(input) {
+    fs.mkdirSync(input.userDataDir, { recursive: true, mode: 0o700 });
+    const release = claim(input.userDataDir);
+    try {
+        await closeOrphan(input.userDataDir);
+    }
+    catch (error) {
+        release();
+        throw error;
+    }
+    const portFile = path.join(input.userDataDir, 'DevToolsActivePort');
+    fs.rmSync(portFile, { force: true });
+    const child = spawn(input.executable, chromeArgs({
+        userDataDir: input.userDataDir,
+        userAgent: desktopUserAgent(input.executable),
+        uid: process.getuid?.(),
+    }), { stdio: ['ignore', 'ignore', 'pipe'] });
+    let stderr = '';
+    let ready;
+    let unavailable;
+    const listening = new Promise((resolve, reject) => { ready = resolve; unavailable = reject; });
+    child.stderr.on('data', (chunk) => {
+        stderr = (stderr + chunk.toString()).slice(-2_000);
+        const endpoint = /DevTools listening on (ws:\/\/127\.0\.0\.1:\d+\/devtools\/browser\/[\w-]+)/.exec(stderr)?.[1];
+        if (endpoint)
+            ready(endpoint);
+    });
+    const exited = new Promise((resolve) => {
+        const done = () => { release(); unavailable(new BrowserError('PROCESS_FAILED', 'Chrome exited before admission.')); resolve(); };
+        child.once('exit', done);
+        child.once('error', (error) => { stderr += error.message; done(); });
+    });
+    const killOnExit = () => { child.kill('SIGKILL'); };
+    process.once('exit', killOnExit);
+    void exited.then(() => process.removeListener('exit', killOnExit));
+    const kill = async () => {
+        if (child.exitCode !== null || child.signalCode !== null)
+            return;
+        child.kill('SIGTERM');
+        const forced = setTimeout(() => child.kill('SIGKILL'), 3_000);
+        await exited;
+        clearTimeout(forced);
+    };
+    try {
+        const browserUrl = await deadline(listening, input.timeoutMs || 20_000, 'Chrome start');
+        return { pid: child.pid, browserUrl, exited, kill };
+    }
+    catch {
+        await kill();
+        throw new BrowserError('PROCESS_FAILED', `Chrome did not start: ${stderr.trim().slice(-500) || 'no output'}`);
+    }
+}
+// SQLite supplies an OS-held lease (the same primitive as Shell installation
+// leases). It survives suspension, ends on process death, and cannot be stolen
+// by age or PID reuse. The lease file must never be removed.
+function claim(userDataDir) {
+    const database = new Database(`${userDataDir}.lease.sqlite`, { timeout: 0 });
+    try {
+        database.exec('BEGIN EXCLUSIVE');
+    }
+    catch (error) {
+        database.close();
+        if (error.code === 'SQLITE_BUSY') {
+            throw new BrowserError('CONFLICT', 'This browser profile already has a live owner.');
+        }
+        throw error;
+    }
+    return () => { if (database.open)
+        database.close(); };
+}
+function readPortFile(file) {
+    try {
+        const [port, browserPath] = fs.readFileSync(file, 'utf8').split(/\r?\n/);
+        return Number(port) > 0 && Number(port) <= 65_535 && /^\/devtools\/browser\/[\w-]+$/.test(browserPath || '')
+            ? `ws://127.0.0.1:${port}${browserPath}` : null;
+    }
+    catch {
+        return null;
+    }
+}
+// The old profile publishes an unguessable browser endpoint. After obtaining
+// the lease, retire that exact Chrome through CDP; never signal a reused PID.
+async function closeOrphan(userDataDir) {
+    const endpoint = readPortFile(path.join(userDataDir, 'DevToolsActivePort'));
+    if (!endpoint)
+        return;
+    const control = await connectCdp(endpoint, AbortSignal.timeout(2_000)).catch(() => null);
+    if (!control)
+        return;
+    try {
+        await control.call('Browser.close', {}, 2_000).catch(() => undefined);
+        await deadline(control.closed, 2_000, 'Previous Chrome shutdown');
+    }
+    finally {
+        control.close();
+    }
+}
+//# sourceMappingURL=launch.js.map

package/dist/src/chrome/launch.js.map

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

package/dist/src/chrome/relay/editing.d.ts

@@ -0,0 +1,2 @@
+/** CDP key events need explicit editor commands for native editing shortcuts. */
+export declare function editingCommands(params: Record<string, unknown>): string[] | undefined;

package/dist/src/chrome/relay/editing.js

@@ -0,0 +1,14 @@
+/** CDP key events need explicit editor commands for native editing shortcuts. */
+export function editingCommands(params) {
+    if (params.type !== 'keyDown' && params.type !== 'rawKeyDown')
+        return;
+    const modifiers = Number(params.modifiers || 0);
+    if (!(modifiers & (2 | 4)) || (modifiers & 1))
+        return;
+    const key = String(params.key || '').toLowerCase();
+    if (key === 'z')
+        return [modifiers & 8 ? 'redo' : 'undo'];
+    const command = { a: 'selectAll', c: 'copy', x: 'cut', y: 'redo' }[key];
+    return command ? [command] : undefined;
+}
+//# sourceMappingURL=editing.js.map

package/dist/src/chrome/relay/editing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editing.js","sourceRoot":"","sources":["../../../../src/chrome/relay/editing.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,MAA+B;IAC7D,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO;IACtE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QAAE,OAAO;IACtD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACnD,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAI,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAA6B,CAAC,GAAG,CAAC,CAAC;IACpG,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACzC,CAAC"}

package/dist/src/chrome/relay/server.d.ts

@@ -0,0 +1,18 @@
+import type { SessionTargets } from './targets.js';
+export interface RelayUpstream {
+    browserUrl: string;
+}
+export declare class ChromeRelay {
+    private readonly targets;
+    private readonly upstream;
+    private readonly server;
+    private readonly sockets;
+    private port;
+    private listening;
+    private closed;
+    constructor(targets: SessionTargets, upstream: () => Promise<RelayUpstream>);
+    listen(): Promise<void>;
+    endpoint(sessionId: string): string;
+    close(): Promise<void>;
+    private bridge;
+}