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

package/dist/src/interaction/typing.js

@@ -1,189 +0,0 @@
-/**
- * In-page typing — the scripts behind fill and press in attached mode.
- *
- * In the desktop app the agent and the user share one chromium window, and
- * synthesized keystrokes (CDP Input events) are routed by *window focus* —
- * an agent "typing" while the user's caret sits in the chat box lands the
- * text in the chat box (observed live). These scripts act inside the
- * session's page instead, through the same stamp-guarded transport as every
- * other command, so agent input physically cannot reach anything but the
- * page it was meant for.
- *
- * The boundary: page-level semantics work (value setting with real
- * input/change events, key handlers, Enter activating buttons and
- * submitting forms); OS-level editing defaults (Tab focus traversal,
- * arrow-key scrolling) are real-input territory — that is what the cua_*
- * verbs are for, and they stay focus-dependent by design.
- */
-/**
- * Set the focused field's value the way the page expects: through the
- * native prototype setter (so frameworks tracking the value descriptor —
- * React — see the change), followed by real input/change events.
- */
-export function setValueScript(text) {
-    return `(() => {
-    const el = document.activeElement;
-    if (!el || el === document.body) throw new Error('focus did not land on a field');
-    const text = ${JSON.stringify(String(text))};
-    if (el.isContentEditable) {
-      el.textContent = text;
-    } else {
-      const proto = el instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype
-        : el instanceof HTMLInputElement ? HTMLInputElement.prototype
-        : null;
-      if (!proto && !('value' in el)) {
-        throw new Error('focused element <' + el.tagName.toLowerCase() + '> is not fillable');
-      }
-      const setter = proto && Object.getOwnPropertyDescriptor(proto, 'value').set;
-      if (setter) setter.call(el, text); else el.value = text;
-    }
-    el.dispatchEvent(new InputEvent('input', { bubbles: true, data: text, inputType: 'insertReplacementText' }));
-    el.dispatchEvent(new Event('change', { bubbles: true }));
-    return true;
-  })()`;
-}
-/**
- * Insert text at the focused field/caret without using browser-window
- * keyboard focus. This is the attached-mode implementation for cua_type and
- * CLI keyboard typing: if the page did not focus an editable element, fail
- * closed instead of letting real keystrokes leak into Amalgm's own UI.
- */
-export function insertTextScript(text) {
-    return `(() => {
-    const el = document.activeElement;
-    if (!el || el === document.body || el === document.documentElement) {
-      throw new Error('focus did not land on an editable field');
-    }
-    const text = ${JSON.stringify(String(text))};
-    const inputEvent = (inputType, data = text) => new InputEvent('input', {
-      bubbles: true,
-      data,
-      inputType,
-    });
-
-    if (el.isContentEditable) {
-      const selection = window.getSelection();
-      if (selection && selection.rangeCount) {
-        const range = selection.getRangeAt(0);
-        range.deleteContents();
-        const node = document.createTextNode(text);
-        range.insertNode(node);
-        range.setStartAfter(node);
-        range.setEndAfter(node);
-        selection.removeAllRanges();
-        selection.addRange(range);
-      } else {
-        el.textContent = (el.textContent || '') + text;
-      }
-      el.dispatchEvent(inputEvent('insertText'));
-      return true;
-    }
-
-    const proto = el instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype
-      : el instanceof HTMLInputElement ? HTMLInputElement.prototype
-      : null;
-    if (!proto && !('value' in el)) {
-      throw new Error('focused element <' + el.tagName.toLowerCase() + '> is not editable');
-    }
-    const value = String(el.value || '');
-    const start = typeof el.selectionStart === 'number' ? el.selectionStart : value.length;
-    const end = typeof el.selectionEnd === 'number' ? el.selectionEnd : start;
-    const next = value.slice(0, start) + text + value.slice(end);
-    const setter = proto && Object.getOwnPropertyDescriptor(proto, 'value').set;
-    if (setter) setter.call(el, next); else el.value = next;
-    const caret = start + text.length;
-    if (typeof el.setSelectionRange === 'function') {
-      try { el.setSelectionRange(caret, caret); } catch {}
-    }
-    el.dispatchEvent(inputEvent('insertText'));
-    return true;
-  })()`;
-}
-/** "KeyA" for letters, "Digit1" for digits, the key's own name otherwise. */
-export function codeFor(key) {
-    if (/^[a-z]$/i.test(key))
-        return `Key${key.toUpperCase()}`;
-    if (/^[0-9]$/.test(key))
-        return `Digit${key}`;
-    if (key === ' ')
-        return 'Space';
-    return key;
-}
-/**
- * Dispatch a key combination ("Enter", "Escape", "Control+a") to the focused
- * element, mirroring the browser's own Enter defaults when no handler
- * prevents them: buttons and links activate, single-line form fields submit
- * their form (through requestSubmit, so submit handlers and validation run).
- */
-export function keyScript(combo) {
-    const parts = String(combo).split('+');
-    const key = parts.pop() || '';
-    const mods = parts.map((part) => part.toLowerCase());
-    const init = {
-        key,
-        code: codeFor(key),
-        bubbles: true,
-        cancelable: true,
-        ctrlKey: mods.includes('control') || mods.includes('ctrl'),
-        shiftKey: mods.includes('shift'),
-        altKey: mods.includes('alt') || mods.includes('option'),
-        metaKey: mods.includes('meta') || mods.includes('cmd') || mods.includes('command'),
-    };
-    return `(() => {
-    const el = document.activeElement || document.body;
-    const init = ${JSON.stringify(init)};
-    const isInput = el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement;
-    const isEditable = isInput || el.isContentEditable;
-    const inputEvent = (inputType, data = null) => new InputEvent('input', {
-      bubbles: true,
-      data,
-      inputType,
-    });
-    const setValue = (next, start, end = start) => {
-      const proto = el instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype
-        : el instanceof HTMLInputElement ? HTMLInputElement.prototype
-        : null;
-      const setter = proto && Object.getOwnPropertyDescriptor(proto, 'value').set;
-      if (setter) setter.call(el, next); else el.value = next;
-      if (typeof el.setSelectionRange === 'function') {
-        try { el.setSelectionRange(start, end); } catch {}
-      }
-    };
-    const proceed = el.dispatchEvent(new KeyboardEvent('keydown', init));
-    if (proceed) {
-      el.dispatchEvent(new KeyboardEvent('keypress', init));
-      if ((init.ctrlKey || init.metaKey) && init.key.toLowerCase() === 'a' && isEditable) {
-        if (isInput && typeof el.select === 'function') {
-          el.select();
-        } else {
-          const range = document.createRange();
-          range.selectNodeContents(el);
-          const selection = window.getSelection();
-          selection.removeAllRanges();
-          selection.addRange(range);
-        }
-      } else if ((init.key === 'Backspace' || init.key === 'Delete') && isInput) {
-        const value = String(el.value || '');
-        const selectionStart = typeof el.selectionStart === 'number' ? el.selectionStart : value.length;
-        const selectionEnd = typeof el.selectionEnd === 'number' ? el.selectionEnd : selectionStart;
-        let start = selectionStart;
-        let end = selectionEnd;
-        if (start === end && init.key === 'Backspace' && start > 0) start -= 1;
-        if (start === end && init.key === 'Delete' && end < value.length) end += 1;
-        if (start !== end) {
-          setValue(value.slice(0, start) + value.slice(end), start);
-          el.dispatchEvent(inputEvent(init.key === 'Backspace' ? 'deleteContentBackward' : 'deleteContentForward'));
-        }
-      } else if (init.key === 'Enter') {
-        if (el instanceof HTMLButtonElement || el instanceof HTMLAnchorElement) {
-          el.click();
-        } else if (el instanceof HTMLInputElement && el.form) {
-          if (el.form.requestSubmit) el.form.requestSubmit(); else el.form.submit();
-        }
-      }
-    }
-    el.dispatchEvent(new KeyboardEvent('keyup', init));
-    return true;
-  })()`;
-}
-//# sourceMappingURL=typing.js.map

package/dist/src/interaction/typing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"typing.js","sourceRoot":"","sources":["../../../src/interaction/typing.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO;;;mBAGU,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;;;;;;;;;;;;;;;;OAgBxC,CAAC;AACR,CAAC;AACD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO;;;;;mBAKU,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CxC,CAAC;AACR,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;IAC3D,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,GAAG,EAAE,CAAC;IAC9C,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,OAAO,CAAC;IAChC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG;QACX,GAAG;QACH,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;QAClB,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC1D,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAChC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACvD,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;KACnF,CAAC;IACF,OAAO;;mBAEU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqDhC,CAAC;AACR,CAAC"}

package/dist/src/profiles/directories.d.ts

@@ -1,9 +0,0 @@
-import type { BrowserProfileDirectories } from '../ports.js';
-export declare class LocalBrowserProfileDirectories implements BrowserProfileDirectories {
-    readonly root: string;
-    constructor(root: string);
-    pathFor(id: string): string;
-    lastTouchedAt(id: string): number;
-    isLocked(id: string): boolean;
-    remove(id: string): void;
-}

package/dist/src/profiles/directories.js

@@ -1,57 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { BrowserError } from '../errors.js';
-import { safeId } from '../ids.js';
-export class LocalBrowserProfileDirectories {
-    root;
-    constructor(root) {
-        this.root = root;
-        fs.mkdirSync(path.resolve(root), { recursive: true, mode: 0o700 });
-    }
-    pathFor(id) { return path.join(path.resolve(this.root), safeId(id)); }
-    lastTouchedAt(id) {
-        const profile = this.pathFor(id);
-        return [profile, 'Local State', 'Default', 'Default/Cookies', 'Default/Network/Cookies', 'Default/History']
-            .map((entry) => entry === profile ? entry : path.join(profile, entry))
-            .reduce((latest, candidate) => {
-            try {
-                return Math.max(latest, fs.statSync(candidate).mtimeMs);
-            }
-            catch {
-                return latest;
-            }
-        }, 0);
-    }
-    isLocked(id) {
-        const lock = path.join(this.pathFor(id), 'SingletonLock');
-        try {
-            const stat = fs.lstatSync(lock);
-            const value = stat.isSymbolicLink()
-                ? fs.readlinkSync(lock)
-                : fs.readFileSync(lock, 'utf8').slice(0, 256);
-            const pid = Number(value.match(/(?:^|[-\s])(\d+)(?:$|\s)/)?.[1] || 0);
-            if (pid) {
-                try {
-                    process.kill(pid, 0);
-                    return true;
-                }
-                catch (error) {
-                    if (error.code === 'EPERM')
-                        return true;
-                }
-            }
-            return !stat.isSymbolicLink() && Date.now() - stat.mtimeMs < 5 * 60_000;
-        }
-        catch {
-            return false;
-        }
-    }
-    remove(id) {
-        const target = this.pathFor(id);
-        if (path.dirname(target) !== path.resolve(this.root)) {
-            throw new BrowserError('INVALID_INPUT', `Unsafe Browser profile path: ${target}`);
-        }
-        fs.rmSync(target, { recursive: true, force: true });
-    }
-}
-//# sourceMappingURL=directories.js.map

package/dist/src/profiles/directories.js.map

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

package/dist/src/profiles/service.d.ts

@@ -1,30 +0,0 @@
-import type { BrowserProfileDirectories, BrowserRegistry } from '../ports.js';
-import type { BrowserProfile, BrowserProfileStatus, BrowserSession } from '../types.js';
-export interface BrowserProfileStoreOptions {
-    registry: BrowserRegistry;
-    directories?: BrowserProfileDirectories;
-    now(): string;
-    generate(): string;
-    publish(profileId: string): void;
-}
-export declare class BrowserProfileStore {
-    private readonly options;
-    constructor(options: BrowserProfileStoreOptions);
-    create(input: {
-        id?: string;
-        name: string;
-        kind?: BrowserProfile['kind'];
-    }): BrowserProfile;
-    list(): BrowserProfile[];
-    get(id: string): BrowserProfile;
-    update(id: string, patch: {
-        name?: string;
-        kind?: BrowserProfile['kind'];
-    }): BrowserProfile;
-    inspect(id: string, sessions: BrowserSession[], referenced: ReadonlySet<string>): BrowserProfileStatus;
-    delete(id: string, sessions: BrowserSession[]): void;
-    prune(maxAgeMs: number, referenced: ReadonlySet<string>, sessions: BrowserSession[]): string[];
-    ensure(idValue: string, kind: BrowserProfile['kind'], name?: string): BrowserProfile;
-    touch(id: string): void;
-    private find;
-}

package/dist/src/profiles/service.js

@@ -1,89 +0,0 @@
-import { BrowserError } from '../errors.js';
-import { safeId } from '../ids.js';
-export class BrowserProfileStore {
-    options;
-    constructor(options) {
-        this.options = options;
-    }
-    create(input) {
-        const id = safeId(input.id || this.options.generate());
-        if (this.find(id))
-            throw new BrowserError('CONFLICT', `Browser profile ${id} already exists.`);
-        return this.ensure(id, input.kind || 'durable', input.name);
-    }
-    list() { return this.options.registry.snapshot().profiles; }
-    get(id) {
-        const profile = this.find(id);
-        if (!profile)
-            throw new BrowserError('NOT_FOUND', `Browser profile ${id} does not exist.`);
-        return profile;
-    }
-    update(id, patch) {
-        const profile = this.get(id);
-        const updated = {
-            ...profile,
-            ...(patch.name !== undefined ? { name: patch.name.trim() || profile.name } : {}),
-            ...(patch.kind !== undefined ? { kind: patch.kind } : {}),
-            updatedAt: this.options.now(),
-        };
-        this.options.registry.putProfile(updated);
-        this.options.publish(updated.id);
-        return updated;
-    }
-    inspect(id, sessions, referenced) {
-        return {
-            profile: this.get(id),
-            live: sessions.some((session) => session.profileId === id && !isFinished(session)),
-            referenced: referenced.has(id),
-            locked: this.options.directories?.isLocked(id) || false,
-        };
-    }
-    delete(id, sessions) {
-        if (sessions.some((session) => session.profileId === id && !isFinished(session))) {
-            throw new BrowserError('CONFLICT', `Browser profile ${id} belongs to a live session.`);
-        }
-        if (this.options.directories?.isLocked(id)) {
-            throw new BrowserError('CONFLICT', `Browser profile ${id} has a live Chromium lock.`);
-        }
-        this.options.directories?.remove(id);
-        this.options.registry.deleteProfile(id);
-    }
-    prune(maxAgeMs, referenced, sessions) {
-        const cutoff = Date.parse(this.options.now()) - maxAgeMs;
-        const live = new Set(sessions.filter((session) => !isFinished(session)).map((session) => session.profileId));
-        const removed = this.list().filter((profile) => profile.kind === 'ephemeral'
-            && !live.has(profile.id)
-            && !referenced.has(profile.id)
-            && !this.options.directories?.isLocked(profile.id)
-            && Math.max(Date.parse(profile.lastUsedAt), this.options.directories?.lastTouchedAt(profile.id) || 0) < cutoff)
-            .map((profile) => profile.id);
-        for (const id of removed) {
-            this.options.directories?.remove(id);
-            this.options.registry.deleteProfile(id);
-        }
-        return removed;
-    }
-    ensure(idValue, kind, name = idValue) {
-        const id = safeId(idValue);
-        const existing = this.find(id);
-        if (existing)
-            return existing;
-        const now = this.options.now();
-        const profile = { id, name, kind, createdAt: now, updatedAt: now, lastUsedAt: now };
-        this.options.registry.putProfile(profile);
-        this.options.publish(id);
-        return profile;
-    }
-    touch(id) {
-        const profile = this.get(id);
-        const now = this.options.now();
-        this.options.registry.putProfile({ ...profile, updatedAt: now, lastUsedAt: now });
-    }
-    find(id) {
-        return this.list().find((profile) => profile.id === safeId(id));
-    }
-}
-function isFinished(session) {
-    return session.status === 'closed' || session.status === 'failed';
-}
-//# sourceMappingURL=service.js.map

package/dist/src/profiles/service.js.map

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

package/dist/src/runtime-selector.d.ts

@@ -1,12 +0,0 @@
-import type { BrowserRuntimeSelector } from './ports.js';
-import type { BrowserBackendKind, BrowserHostAdvertisement, BrowserRuntimeContext } from './types.js';
-export declare const ELECTRON_SURFACE_PROTOCOLS: readonly [5, 6];
-export declare function pidIsRunning(pid: number): boolean;
-export declare function bridgeFileCandidates(env?: NodeJS.ProcessEnv): string[];
-export declare function readHostAdvertisement(files?: string[]): BrowserHostAdvertisement | null;
-export declare class DefaultRuntimeSelector implements BrowserRuntimeSelector {
-    readonly advertisement: () => BrowserHostAdvertisement | null;
-    readonly env: NodeJS.ProcessEnv;
-    constructor(advertisement?: () => BrowserHostAdvertisement | null, env?: NodeJS.ProcessEnv);
-    select(context: BrowserRuntimeContext): BrowserBackendKind;
-}

package/dist/src/runtime-selector.js

@@ -1,72 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { runtimeBindingFromEnvironment, runtimeStateDir } from '@amalgm/core/identity';
-import { isLoopbackCdpUrl } from './drivers/electron/advertisement.js';
-import { BROWSER_SURFACE_PROTOCOLS } from './drivers/electron/contracts.js';
-export const ELECTRON_SURFACE_PROTOCOLS = BROWSER_SURFACE_PROTOCOLS;
-export function pidIsRunning(pid) {
-    if (!Number.isInteger(pid) || pid <= 0)
-        return false;
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (error) {
-        return error.code === 'EPERM';
-    }
-}
-export function bridgeFileCandidates(env = process.env) {
-    const binding = runtimeBindingFromEnvironment(env);
-    // The host supplies its reserved machine namespace. A shared user root is
-    // never a discovery fallback, and an unknown binding never selects main.
-    const directory = env.AMALGM_RUNTIME_STATE_DIR || (env.AMALGM_DIR && env.AMALGM_DEVICE_ID
-        ? runtimeStateDir(env.AMALGM_DIR, env.AMALGM_DEVICE_ID, binding.runtimeLabel) : null);
-    return directory ? [path.join(directory, 'electron-browser-bridge.json')] : [];
-}
-export function readHostAdvertisement(files = bridgeFileCandidates()) {
-    for (const file of files) {
-        try {
-            const raw = JSON.parse(fs.readFileSync(file, 'utf8'));
-            const cdp = raw.cdp;
-            const cdpUrl = typeof cdp?.url === 'string' ? cdp.url : raw.cdpUrl;
-            const protocol = Number.isInteger(raw.browserSurfaceProtocol) ? Number(raw.browserSurfaceProtocol) : 5;
-            const pid = Number(raw.pid);
-            if (typeof cdpUrl !== 'string' || !isLoopbackCdpUrl(cdpUrl) || !pidIsRunning(pid))
-                continue;
-            const declared = Array.isArray(raw.browserSurfaceTargetTypes)
-                ? raw.browserSurfaceTargetTypes
-                : [raw.browserSurfaceTargetType || 'webview'];
-            const targetTypes = declared.filter((value) => value === 'page' || value === 'webview');
-            return {
-                protocol, backend: 'electron', pid, cdpUrl, targetTypes, file,
-                ...(typeof raw.startedAt === 'string' ? { createdAt: raw.startedAt } : {}),
-            };
-        }
-        catch { }
-    }
-    return null;
-}
-export class DefaultRuntimeSelector {
-    advertisement;
-    env;
-    constructor(advertisement = readHostAdvertisement, env = process.env) {
-        this.advertisement = advertisement;
-        this.env = env;
-    }
-    select(context) {
-        const forced = String(this.env.AMALGM_BROWSER_BACKEND || '').toLowerCase();
-        if (['headless', 'cli', 'agent-browser', 'cdp'].includes(forced))
-            return 'headless';
-        if (['electron', 'visible', 'attached'].includes(forced))
-            return 'electron';
-        if (this.env.AMALGM_BROWSER_CDP_URL)
-            return 'headless';
-        if (context.clientKind !== 'desktop')
-            return 'headless';
-        const host = this.advertisement();
-        return host && ELECTRON_SURFACE_PROTOCOLS.includes(host.protocol)
-            ? 'electron'
-            : 'headless';
-    }
-}
-//# sourceMappingURL=runtime-selector.js.map

package/dist/src/runtime-selector.js.map

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

package/docs/HEADLESS_RUNTIME.md

@@ -1,58 +0,0 @@
-# Headless runtime
-
-Headless is the default for standalone SDK/CLI use, servers, automations,
-agents, and background jobs. It uses `agent-browser` behind `BrowserDriver`;
-the core service does not know its command-line arguments.
-
-## Process and executable selection
-
-Resolution prefers:
-
-1. `AMALGM_AGENT_BROWSER_BIN`
-2. the platform-native binary shipped by `agent-browser`
-3. the package's JavaScript wrapper
-4. an `agent-browser` executable on PATH
-
-When packaged in Electron, native binaries and ffmpeg are resolved from
-`app.asar.unpacked`. Every process uses an argv array with `shell: false`, a
-safe explicit cwd, bounded stdout/stderr, an operation timeout, cancellation,
-SIGTERM, and bounded SIGKILL escalation.
-
-## Configuration
-
-- `AMALGM_BROWSER_EXECUTABLE_PATH` — explicit Chromium executable
-- `AMALGM_BROWSER_PROVIDER` — external provider understood by agent-browser
-- `AMALGM_BROWSER_CDP_URL` — attach to an operator-owned CDP endpoint
-- `AMALGM_AGENT_BROWSER_BIN` — explicit agent-browser executable
-- `AMALGM_BROWSER_HEADED=1` — explicit standalone headed debug mode
-- `AMALGM_FFMPEG` — encoder override
-
-An explicit CDP endpoint remains a headless-driver session in the domain model;
-it does not opt into Electron surfaces. Ordinary background work never opens a
-headed window or steals focus.
-
-## Profiles and state
-
-Each session uses its assigned Browser profile directory. Durable profiles
-survive explicit reuse; ephemeral profiles are pruned only when not live,
-referenced, or physically Chromium-locked. Backend-local cookies remain in
-that profile. The trusted headless cookie adapter reconciles individual records
-through the encrypted logical jar without inspecting Electron.
-
-## Capture and input
-
-Accessibility snapshots create stable `@eN` references for ordinary DOM
-actions. Direct CDP resolves the session's actual target for screenshot,
-computer use, and recording—never the first or only page. Viewport screenshots
-are normalized to CSS pixels even when device pixel ratio exceeds one;
-full-page capture is height-bounded.
-
-Computer use supports screenshot, click, double click, move, scroll, type,
-keypress, and drag. Native CDP input is page-scoped. Use it for canvas, WebGL,
-image-only, or hostile custom controls; prefer snapshot references elsewhere.
-
-## Real verification
-
-`npm run test:real` launches the installed Chromium runtime and verifies
-navigation, snapshot, exact-target CDP capture, DPR normalization, page-scoped
-typing, and real page-only recording.

package/examples/custom-driver.ts

@@ -1,45 +0,0 @@
-import {
-  createBrowser,
-  BrowserError,
-  type BrowserAction,
-  type BrowserActionResult,
-  type BrowserDriver,
-  type BrowserDriverSession,
-} from '@amalgm/browser';
-
-class RemoteBrowserDriver implements BrowserDriver {
-  readonly kind = 'headless' as const;
-  readonly capabilities = ['core', 'computer-use'] as const;
-
-  constructor(readonly endpoint: string, readonly token: string) {}
-
-  async open(input: BrowserDriverSession): Promise<void> {
-    await this.request('/sessions', { session: input.session });
-  }
-
-  async execute(input: BrowserDriverSession, action: BrowserAction): Promise<BrowserActionResult> {
-    return this.request(`/sessions/${encodeURIComponent(input.session.id)}/actions`, { action }, input.context.signal);
-  }
-
-  async close(input: BrowserDriverSession): Promise<void> {
-    await this.request(`/sessions/${encodeURIComponent(input.session.id)}/close`, {});
-  }
-
-  private async request<T>(path: string, body: unknown, signal?: AbortSignal): Promise<T> {
-    const response = await fetch(new URL(path, this.endpoint), {
-      method: 'POST',
-      headers: { authorization: `Bearer ${this.token}`, 'content-type': 'application/json' },
-      body: JSON.stringify(body),
-      ...(signal ? { signal } : {}),
-    });
-    if (!response.ok) throw new BrowserError('PROCESS_FAILED', `Remote driver returned ${response.status}.`);
-    return response.json() as Promise<T>;
-  }
-}
-
-const browser = createBrowser({
-  headlessDriver: new RemoteBrowserDriver('https://browser-provider.example', 'token'),
-});
-
-const session = await browser.createSession({ id: 'remote-example' });
-await browser.execute(session.id, { type: 'open', url: 'https://example.com' });