@amalgm/browser 0.1.0

package/dist/src/drivers/electron/native/surface/state.js

@@ -0,0 +1,45 @@
+export function validSurfaceId(value) {
+    return typeof value === 'string' && value.length > 0 && value.length <= 200;
+}
+export function normalizeBounds(bounds, owner) {
+    const x = finiteNumber(bounds?.x);
+    const y = finiteNumber(bounds?.y);
+    const width = finiteNumber(bounds?.width);
+    const height = finiteNumber(bounds?.height);
+    if (x === null || y === null || width === null || height === null)
+        return null;
+    const content = owner.getContentBounds();
+    const left = Math.max(0, Math.round(x));
+    const top = Math.max(0, Math.round(y));
+    const right = Math.min(content.width, Math.round(x + Math.max(0, width)));
+    const bottom = Math.min(content.height, Math.round(y + Math.max(0, height)));
+    return { x: left, y: top, width: Math.max(0, right - left), height: Math.max(0, bottom - top) };
+}
+export function stateFor(record) {
+    const contents = record.view.webContents;
+    const destroyed = contents.isDestroyed();
+    return {
+        surfaceId: record.surfaceId,
+        guestId: contents.id,
+        ready: record.ready && !destroyed,
+        url: destroyed ? '' : contents.getURL(),
+        title: record.title,
+        favicons: record.favicons,
+        isLoading: !destroyed && contents.isLoading(),
+        canGoBack: !destroyed && contents.navigationHistory.canGoBack(),
+        canGoForward: !destroyed && contents.navigationHistory.canGoForward(),
+        zoomFactor: record.zoomFactor,
+        findResult: record.findResult,
+        loadError: record.loadError,
+    };
+}
+export function withDeadline(promise, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error('Browser surface capture timed out')), timeoutMs);
+        promise.then((value) => { clearTimeout(timer); resolve(value); }, (error) => { clearTimeout(timer); reject(error); });
+    });
+}
+function finiteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+//# sourceMappingURL=state.js.map

package/dist/src/drivers/electron/native/surface/state.js.map

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

package/dist/src/drivers/electron/native/surface/types.d.ts

@@ -0,0 +1,39 @@
+import type { BaseWindow, BrowserWindow, Session, WebContents, WebContentsView } from 'electron';
+import type { BrowserSurfaceBounds, BrowserSurfaceState } from '../contracts.js';
+export type NativeBrowserSurface = {
+    contents: WebContents;
+    embedder: WebContents;
+    tabId: string;
+    isAutomation: boolean;
+};
+export type BrowserSurfaceControllerOptions = {
+    browserSession: Session;
+    cosmeticPreloadPath(): string | null;
+    isAllowedUrl(url: string): boolean;
+    onSurfaceCreated(surface: NativeBrowserSurface): void;
+    onAutomationChanged(contents: WebContents, isAutomation: boolean): void;
+};
+export type SurfaceRecord = {
+    surfaceId: string;
+    tabId: string;
+    view: WebContentsView;
+    owner: BrowserWindow;
+    embedder: WebContents;
+    isAutomation: boolean;
+    automationSessionId: string | null;
+    parkingWindow: BaseWindow | null;
+    parent: 'owner' | 'parking' | null;
+    bounds: BrowserSurfaceBounds;
+    requestedVisible: boolean;
+    displayScale: number;
+    zoomFactor: number;
+    ready: boolean;
+    title: string;
+    favicons: string[];
+    findResult: {
+        activeMatch: number;
+        matches: number;
+    };
+    loadError: BrowserSurfaceState['loadError'];
+    disposed: boolean;
+};

package/dist/src/drivers/electron/native/surface/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/drivers/electron/native/surface/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/drivers/electron/native/surface/types.ts"],"names":[],"mappings":""}

package/dist/src/drivers/electron/native/surface-controller.d.ts

@@ -0,0 +1,6 @@
+import type { BrowserSurfaceControllerOptions } from './surface/types.js';
+export type { BrowserSurfaceControllerOptions, NativeBrowserSurface } from './surface/types.js';
+export type BrowserSurfaceController = {
+    dispose(): void;
+};
+export declare function createBrowserSurfaceController(options: BrowserSurfaceControllerOptions): BrowserSurfaceController;

package/dist/src/drivers/electron/native/surface-controller.js

@@ -0,0 +1,138 @@
+import { ipcMain } from 'electron';
+import { BROWSER_IPC, } from './contracts.js';
+import { executeSurfaceCommand } from './surface/commands.js';
+import { createSurfaceRecord } from './surface/create.js';
+import { configureSurfaceEvents } from './surface/events.js';
+import { PARKED_VIEWPORT, SurfacePresentation } from './surface/presentation.js';
+import { normalizeBounds, stateFor, validSurfaceId, withDeadline } from './surface/state.js';
+const CAPTURE_TIMEOUT_MS = 300;
+export function createBrowserSurfaceController(options) {
+    const surfaces = new Map();
+    const ownerSurfaceIds = new Map();
+    const presentation = new SurfacePresentation();
+    const sendState = (record) => {
+        if (!record.embedder.isDestroyed())
+            record.embedder.send(BROWSER_IPC.surfaceState, stateFor(record));
+    };
+    const destroyRecord = (record, closeContents) => {
+        if (record.disposed)
+            return;
+        record.disposed = true;
+        surfaces.delete(record.surfaceId);
+        ownerSurfaceIds.get(record.embedder.id)?.delete(record.surfaceId);
+        presentation.detach(record);
+        presentation.destroyParking(record);
+        if (closeContents && !record.view.webContents.isDestroyed())
+            record.view.webContents.close();
+    };
+    const destroyOwned = (ownerId) => {
+        for (const id of [...(ownerSurfaceIds.get(ownerId) ?? [])]) {
+            const record = surfaces.get(id);
+            if (record)
+                destroyRecord(record, true);
+        }
+    };
+    const ownedSurface = (sender, surfaceId) => {
+        if (!validSurfaceId(surfaceId))
+            return null;
+        const record = surfaces.get(surfaceId);
+        return record && record.embedder.id === sender.id && !record.disposed ? record : null;
+    };
+    ipcMain.handle(BROWSER_IPC.surfaceCreate, async (event, request) => {
+        if (!request || !validSurfaceId(request.surfaceId))
+            return null;
+        const url = String(request.url || 'about:blank');
+        if (!options.isAllowedUrl(url))
+            return null;
+        const existing = surfaces.get(request.surfaceId);
+        if (existing)
+            return existing.embedder.id === event.sender.id ? stateFor(existing) : null;
+        const record = createSurfaceRecord(event.sender, request, options);
+        if (!record)
+            return null;
+        surfaces.set(record.surfaceId, record);
+        const owned = ownerSurfaceIds.get(event.sender.id) ?? new Set();
+        if (!ownerSurfaceIds.has(event.sender.id)) {
+            const ownerId = event.sender.id;
+            ownerSurfaceIds.set(ownerId, owned);
+            event.sender.on('did-start-navigation', (_event, _url, inPlace, mainFrame) => {
+                if (mainFrame && !inPlace)
+                    destroyOwned(ownerId);
+            });
+            event.sender.once('destroyed', () => { destroyOwned(ownerId); ownerSurfaceIds.delete(ownerId); });
+        }
+        owned.add(record.surfaceId);
+        options.onSurfaceCreated({
+            contents: record.view.webContents,
+            embedder: event.sender,
+            tabId: record.tabId,
+            isAutomation: record.isAutomation,
+        });
+        configureSurfaceEvents(record, presentation, () => sendState(record), () => destroyRecord(record, false));
+        void record.view.webContents.loadURL(url).catch(() => { });
+        return stateFor(record);
+    });
+    ipcMain.handle(BROWSER_IPC.surfaceUpdate, (event, request) => {
+        const record = request ? ownedSurface(event.sender, request.surfaceId) : null;
+        if (!record || record.owner.isDestroyed())
+            return false;
+        const bounds = normalizeBounds(request.bounds, record.owner);
+        if (!bounds)
+            return false;
+        const isAutomation = request.isAutomation === true;
+        if (record.isAutomation !== isAutomation) {
+            record.isAutomation = isAutomation;
+            options.onAutomationChanged(record.view.webContents, isAutomation);
+        }
+        record.bounds = bounds;
+        record.requestedVisible = request.visible === true;
+        record.displayScale = Math.max(0.1, Math.min(1, Number(request.scale) || 1));
+        presentation.apply(record);
+        return true;
+    });
+    ipcMain.handle(BROWSER_IPC.surfaceDestroy, (event, surfaceId) => {
+        const record = ownedSurface(event.sender, surfaceId);
+        if (!record)
+            return false;
+        destroyRecord(record, true);
+        return true;
+    });
+    ipcMain.handle(BROWSER_IPC.surfaceCommand, (event, request) => {
+        const record = request ? ownedSurface(event.sender, request.surfaceId) : null;
+        if (!record || record.view.webContents.isDestroyed())
+            return null;
+        const state = executeSurfaceCommand(record, request, presentation, options.isAllowedUrl);
+        sendState(record);
+        return state;
+    });
+    ipcMain.handle(BROWSER_IPC.surfaceCapture, async (event, surfaceId) => {
+        const record = ownedSurface(event.sender, surfaceId);
+        if (!record || record.view.webContents.isDestroyed())
+            return null;
+        try {
+            const image = await withDeadline(record.view.webContents.capturePage(), CAPTURE_TIMEOUT_MS);
+            if (image.isEmpty())
+                return null;
+            const size = image.getSize();
+            const targetWidth = Math.min(size.width, Math.max(1, record.bounds.width || PARKED_VIEWPORT.width));
+            const normalized = size.width > targetWidth ? image.resize({ width: targetWidth, quality: 'good' }) : image;
+            return `data:image/jpeg;base64,${normalized.toJPEG(78).toString('base64')}`;
+        }
+        catch {
+            return null;
+        }
+    });
+    return {
+        dispose() {
+            for (const record of [...surfaces.values()])
+                destroyRecord(record, true);
+            ownerSurfaceIds.clear();
+            ipcMain.removeHandler(BROWSER_IPC.surfaceCreate);
+            ipcMain.removeHandler(BROWSER_IPC.surfaceUpdate);
+            ipcMain.removeHandler(BROWSER_IPC.surfaceDestroy);
+            ipcMain.removeHandler(BROWSER_IPC.surfaceCommand);
+            ipcMain.removeHandler(BROWSER_IPC.surfaceCapture);
+        },
+    };
+}
+//# sourceMappingURL=surface-controller.js.map

package/dist/src/drivers/electron/native/surface-controller.js.map

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

package/dist/src/drivers/electron/policy.d.ts

@@ -0,0 +1,4 @@
+export declare function normalizeBrowserLocation(raw: string): string;
+export declare function browserNavigationPolicy(raw: string): 'allow' | 'external' | 'deny';
+export declare function safeDownloadName(value: string): string;
+export declare function permissionOrigin(url: string): string | null;

package/dist/src/drivers/electron/policy.js

@@ -0,0 +1,39 @@
+const WEB_PROTOCOLS = new Set(['http:', 'https:']);
+const EXTERNAL_PROTOCOLS = new Set(['mailto:', 'tel:', 'sms:']);
+export function normalizeBrowserLocation(raw) {
+    const value = raw.trim();
+    if (!value)
+        return 'about:blank';
+    if (/^[a-zA-Z][a-zA-Z\d+.-]*:/.test(value))
+        return value;
+    if (/^(localhost|\d{1,3}(?:\.\d{1,3}){3})(:\d+)?(?:\/|$)/i.test(value))
+        return `http://${value}`;
+    if (/^[^\s.]+\.[^\s]+/.test(value))
+        return `https://${value}`;
+    return `https://www.google.com/search?q=${encodeURIComponent(value)}`;
+}
+export function browserNavigationPolicy(raw) {
+    try {
+        const url = new URL(raw);
+        if (WEB_PROTOCOLS.has(url.protocol) || url.protocol === 'about:')
+            return 'allow';
+        if (EXTERNAL_PROTOCOLS.has(url.protocol))
+            return 'external';
+    }
+    catch { }
+    return 'deny';
+}
+export function safeDownloadName(value) {
+    const name = value.replace(/[\\/:*?"<>|\u0000-\u001f]/g, '_').replace(/^\.+/, '').trim();
+    return name.slice(0, 180) || 'download';
+}
+export function permissionOrigin(url) {
+    try {
+        const value = new URL(url);
+        return WEB_PROTOCOLS.has(value.protocol) ? value.origin : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/src/drivers/electron/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../../src/drivers/electron/policy.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AACnD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhE,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,KAAK;QAAE,OAAO,aAAa,CAAC;IACjC,IAAI,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,IAAI,sDAAsD,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,UAAU,KAAK,EAAE,CAAC;IACjG,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,WAAW,KAAK,EAAE,CAAC;IAC9D,OAAO,mCAAmC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC;QACjF,IAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,UAAU,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,UAAU,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,OAAO,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AAC1B,CAAC"}

package/dist/src/drivers/electron/session.d.ts

@@ -0,0 +1,4 @@
+export interface ElectronSessionModule<T> {
+    fromPartition(partition: string): T;
+}
+export declare function isolatedBrowserSession<T>(sessionModule: ElectronSessionModule<T>): T;

package/dist/src/drivers/electron/session.js

@@ -0,0 +1,5 @@
+import { BROWSER_SESSION_PARTITION } from './contracts.js';
+export function isolatedBrowserSession(sessionModule) {
+    return sessionModule.fromPartition(BROWSER_SESSION_PARTITION);
+}
+//# sourceMappingURL=session.js.map

package/dist/src/drivers/electron/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../src/drivers/electron/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAM3D,MAAM,UAAU,sBAAsB,CAAI,aAAuC;IAC/E,OAAO,aAAa,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;AAChE,CAAC"}

package/dist/src/drivers/headless/command.d.ts

@@ -0,0 +1,25 @@
+import type { ProcessLauncher } from '../../ports.js';
+export interface AgentBrowserCommandOptions {
+    root: string;
+    launcher: ProcessLauncher;
+    env?: NodeJS.ProcessEnv;
+    cdpEndpoint?: string | undefined;
+    headed?: boolean;
+}
+export declare class AgentBrowserCommand {
+    readonly options: AgentBrowserCommandOptions;
+    readonly env: NodeJS.ProcessEnv;
+    private readonly profiles;
+    constructor(options: AgentBrowserCommandOptions);
+    bind(sessionId: string, profileId: string): void;
+    release(sessionId: string): void;
+    private directory;
+    private baseArgs;
+    run(sessionId: string, command: string[], options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal | undefined;
+        stdin?: string;
+    }): Promise<unknown>;
+}
+export declare function unwrap(value: unknown): unknown;
+export declare function asText(value: unknown): string;

package/dist/src/drivers/headless/command.js

@@ -0,0 +1,114 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { BrowserError } from '../../errors.js';
+import { safeId } from '../../ids.js';
+import { ffmpegBinary, resolveAgentBrowser } from './executable.js';
+export class AgentBrowserCommand {
+    options;
+    env;
+    profiles = new Map();
+    constructor(options) {
+        this.options = options;
+        this.env = options.env || process.env;
+    }
+    bind(sessionId, profileId) { this.profiles.set(safeId(sessionId), safeId(profileId)); }
+    release(sessionId) { this.profiles.delete(safeId(sessionId)); }
+    directory(name) {
+        const target = path.join(this.options.root, name);
+        fs.mkdirSync(target, { recursive: true, mode: 0o700 });
+        return target;
+    }
+    baseArgs(sessionId) {
+        const profileId = this.profiles.get(safeId(sessionId)) || safeId(sessionId);
+        const args = [
+            '--session', safeId(sessionId),
+            '--profile', path.join(this.directory('profiles'), profileId),
+            '--screenshot-dir', this.directory('screenshots'),
+            '--max-output', '15000',
+            '--json',
+        ];
+        if (this.options.cdpEndpoint)
+            args.push('--cdp', this.options.cdpEndpoint);
+        if (this.options.headed && !this.options.cdpEndpoint)
+            args.push('--headed');
+        if (this.env.AMALGM_BROWSER_EXECUTABLE_PATH)
+            args.push('--executable-path', this.env.AMALGM_BROWSER_EXECUTABLE_PATH);
+        if (this.env.AMALGM_BROWSER_PROVIDER)
+            args.push('--provider', this.env.AMALGM_BROWSER_PROVIDER);
+        return args;
+    }
+    async run(sessionId, command, options = {}) {
+        const executable = resolveAgentBrowser(this.env);
+        const ffmpeg = ffmpegBinary(this.env);
+        const env = {
+            ...this.env,
+            AGENT_BROWSER_SOCKET_DIR: this.directory('sockets'),
+            PATH: ffmpeg === 'ffmpeg' ? this.env.PATH : `${path.dirname(ffmpeg)}${path.delimiter}${this.env.PATH || ''}`,
+        };
+        const result = await this.options.launcher.run({
+            command: executable.command,
+            args: [...executable.prefix, ...this.baseArgs(sessionId), ...command],
+            cwd: this.directory('process'),
+            env,
+            ...(options.stdin === undefined ? {} : { stdin: options.stdin }),
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+            timeoutMs: options.timeoutMs || 120_000,
+            outputLimit: 64_000,
+        });
+        if (result.code !== 0) {
+            throw new BrowserError('PROCESS_FAILED', sanitizeProcessError(result.stderr || result.stdout, result.code));
+        }
+        return parseEnvelope(result.stdout);
+    }
+}
+function parseEnvelope(stdout) {
+    const text = stdout.trim();
+    if (!text)
+        return {};
+    const lines = text.split(/\r?\n/);
+    for (let index = 0; index < lines.length; index += 1) {
+        const candidate = lines.slice(index).join('\n');
+        try {
+            const parsed = JSON.parse(candidate);
+            if (parsed.success === false)
+                throw new BrowserError('PROCESS_FAILED', parsed.error || 'agent-browser failed');
+            return parsed;
+        }
+        catch (error) {
+            if (error instanceof BrowserError)
+                throw error;
+        }
+    }
+    return { text: text.slice(0, 15_000) };
+}
+function sanitizeProcessError(value, code) {
+    const cleaned = value
+        .replace(/(authorization|cookie|token|secret|password)\s*[:=]\s*\S+/gi, '$1=[redacted]')
+        .trim()
+        .slice(0, 4_000);
+    return cleaned || `agent-browser exited with code ${code}`;
+}
+export function unwrap(value) {
+    if (!value || typeof value !== 'object')
+        return value;
+    const record = value;
+    if (record.data !== undefined)
+        return unwrap(record.data);
+    if (record.result !== undefined)
+        return record.result;
+    return value;
+}
+export function asText(value) {
+    const data = unwrap(value);
+    if (typeof data === 'string')
+        return data;
+    if (!data || typeof data !== 'object')
+        return String(data ?? '');
+    const record = data;
+    for (const key of ['snapshot', 'text', 'value', 'result', 'output', 'url', 'title']) {
+        if (typeof record[key] === 'string')
+            return record[key];
+    }
+    return JSON.stringify(data, null, 2);
+}
+//# sourceMappingURL=command.js.map

package/dist/src/drivers/headless/command.js.map

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

package/dist/src/drivers/headless/cookie-adapter.d.ts

@@ -0,0 +1,16 @@
+import type { BrowserCookie, BrowserCookieAdapter, BrowserCookieMutation } from '../../cookies/types.js';
+import { AgentBrowserCommand } from './command.js';
+export declare class HeadlessCookieAdapter implements BrowserCookieAdapter {
+    readonly id: string;
+    readonly sessionId: string;
+    readonly command: AgentBrowserCommand;
+    readonly supportsPartitionedCookies = false;
+    constructor(id: string, sessionId: string, command: AgentBrowserCommand);
+    read(signal?: AbortSignal): Promise<BrowserCookie[]>;
+    apply(input: {
+        upserts: BrowserCookie[];
+        deletes: BrowserCookieMutation['deletes'];
+        versionToken: string;
+        signal?: AbortSignal;
+    }): Promise<void>;
+}

package/dist/src/drivers/headless/cookie-adapter.js

@@ -0,0 +1,59 @@
+import { unwrap } from './command.js';
+export class HeadlessCookieAdapter {
+    id;
+    sessionId;
+    command;
+    supportsPartitionedCookies = false;
+    constructor(id, sessionId, command) {
+        this.id = id;
+        this.sessionId = sessionId;
+        this.command = command;
+    }
+    async read(signal) {
+        const raw = unwrap(await this.command.run(this.sessionId, ['cookies'], { signal, timeoutMs: 15_000 }));
+        const rows = Array.isArray(raw) ? raw : raw?.cookies;
+        return (Array.isArray(rows) ? rows : []).flatMap((value) => normalizeCliCookie(value));
+    }
+    async apply(input) {
+        for (const cookie of input.upserts) {
+            if (cookie.partitionKey)
+                continue;
+            await this.command.run(this.sessionId, ['cookies', 'set', cookie.name, cookie.value,
+                '--domain', cookie.domain,
+                '--path', cookie.path,
+                ...(cookie.secure ? ['--secure'] : []),
+                ...(cookie.httpOnly ? ['--httpOnly'] : []),
+                ...(cookie.sameSite ? ['--sameSite', cookie.sameSite] : []),
+                ...(cookie.expires ? ['--expires', String(cookie.expires)] : []),
+            ], { signal: input.signal, timeoutMs: 15_000 });
+        }
+        for (const cookie of input.deletes || []) {
+            if (cookie.partitionKey)
+                continue;
+            await this.command.run(this.sessionId, ['cookies', 'set', cookie.name, '',
+                '--domain', cookie.domain,
+                '--path', cookie.path,
+                '--expires', '1',
+            ], { signal: input.signal, timeoutMs: 15_000 });
+        }
+    }
+}
+function normalizeCliCookie(value) {
+    if (!value || typeof value !== 'object')
+        return [];
+    const row = value;
+    if (typeof row.name !== 'string' || typeof row.domain !== 'string')
+        return [];
+    return [{
+            name: row.name,
+            value: String(row.value || ''),
+            domain: row.domain,
+            path: typeof row.path === 'string' ? row.path : '/',
+            ...(typeof row.expires === 'number' ? { expires: row.expires } : {}),
+            ...(typeof row.httpOnly === 'boolean' ? { httpOnly: row.httpOnly } : {}),
+            ...(typeof row.secure === 'boolean' ? { secure: row.secure } : {}),
+            ...(row.sameSite === 'Strict' || row.sameSite === 'Lax' || row.sameSite === 'None'
+                ? { sameSite: row.sameSite } : {}),
+        }];
+}
+//# sourceMappingURL=cookie-adapter.js.map

package/dist/src/drivers/headless/cookie-adapter.js.map

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

package/dist/src/drivers/headless/driver.d.ts

@@ -0,0 +1,31 @@
+import { BrowserCookieCoordinator } from '../../cookies/coordinator.js';
+import type { BrowserDriver, BrowserDriverSession } from '../../ports.js';
+import type { BrowserAction, BrowserActionResult } from '../../types.js';
+import { AgentBrowserCommand } from './command.js';
+export declare class HeadlessBrowserDriver implements BrowserDriver {
+    readonly command: AgentBrowserCommand;
+    readonly root: string;
+    readonly cookies?: BrowserCookieCoordinator | undefined;
+    readonly kind: "headless";
+    readonly capabilities: readonly ["core", "computer-use", "recording", "auth", "full-page-capture", "live-login"];
+    private readonly evidence;
+    constructor(command: AgentBrowserCommand, root: string, cookies?: BrowserCookieCoordinator | undefined);
+    open(input: BrowserDriverSession): Promise<void>;
+    execute(input: BrowserDriverSession, action: BrowserAction): Promise<BrowserActionResult>;
+    private executeAction;
+    close(input: BrowserDriverSession): Promise<void>;
+    saveState(input: BrowserDriverSession): Promise<unknown>;
+    loadState(input: BrowserDriverSession, state: unknown): Promise<void>;
+    startScreencast(input: BrowserDriverSession, onFrame: (png: Buffer) => void): Promise<() => Promise<void>>;
+    private run;
+    private pageState;
+    private evaluate;
+    private screenshot;
+    private wait;
+    private tab;
+    private console;
+    private cua;
+    private drag;
+    private temporary;
+    private cookieAdapterId;
+}