@amalgm/browser 0.1.0

package/dist/src/runtime-selector.js

@@ -0,0 +1,78 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { coerceRuntimeLabel, 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 directories = [];
+    if (env.AMALGM_RUNTIME_STATE_DIR)
+        directories.push(env.AMALGM_RUNTIME_STATE_DIR);
+    const root = env.AMALGM_DIR;
+    const label = env.AMALGM_RUNTIME_LABEL || env.AMALGM_BRANCH;
+    // The runtimes/<label> grammar lives in @amalgm/core: the raw value is
+    // folded by the runtime label law, so junk can never name a directory.
+    if (root && label)
+        directories.push(runtimeStateDir(root, coerceRuntimeLabel(label)));
+    if (root)
+        directories.push(root);
+    return [...new Set(directories)].map((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

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

package/dist/src/service-options.d.ts

@@ -0,0 +1,19 @@
+import type { BrowserAuthorization, BrowserClock, BrowserDriver, BrowserEventSink, BrowserLogger, BrowserProfileDirectories, BrowserRegistry, BrowserRuntimeSelector } from './ports.js';
+import type { BrowserBackendKind, BrowserProfile, BrowserRuntimeContext } from './types.js';
+export interface BrowserServiceOptions {
+    registry: BrowserRegistry;
+    drivers: Record<BrowserBackendKind, BrowserDriver>;
+    runtimeSelector: BrowserRuntimeSelector;
+    eventSink: BrowserEventSink;
+    clock: BrowserClock;
+    logger: BrowserLogger;
+    authorization?: BrowserAuthorization;
+    profileDirectories?: BrowserProfileDirectories;
+    id?: (prefix: string) => string;
+}
+export interface CreateSessionInput {
+    id?: string;
+    profileId?: string;
+    profileKind?: BrowserProfile['kind'];
+    context?: BrowserRuntimeContext;
+}

package/dist/src/service-options.js

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

package/dist/src/service-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-options.js","sourceRoot":"","sources":["../../src/service-options.ts"],"names":[],"mappings":""}

package/dist/src/service.d.ts

@@ -0,0 +1,39 @@
+import type { BrowserServiceOptions, CreateSessionInput } from './service-options.js';
+import type { BrowserAction, BrowserActionResult, BrowserEventInput, BrowserProfile, BrowserProfileStatus, BrowserRuntimeContext, BrowserSession } from './types.js';
+export type { BrowserServiceOptions, CreateSessionInput } from './service-options.js';
+export declare class BrowserService {
+    readonly options: BrowserServiceOptions;
+    private readonly active;
+    private readonly opened;
+    private readonly profiles;
+    private readonly leases;
+    constructor(options: BrowserServiceOptions);
+    createSession(input?: CreateSessionInput): Promise<BrowserSession>;
+    getSession(id: string): BrowserSession;
+    listSessions(): BrowserSession[];
+    execute(sessionId: string, action: BrowserAction, context?: BrowserRuntimeContext): Promise<BrowserActionResult>;
+    cancel(sessionId: string): boolean;
+    publish(event: BrowserEventInput): Promise<void>;
+    closeSession(sessionId: string, context?: BrowserRuntimeContext): Promise<void>;
+    createProfile(input: {
+        id?: string;
+        name: string;
+        kind?: BrowserProfile['kind'];
+    }): BrowserProfile;
+    pruneSessions(maxAgeMs?: number): string[];
+    listProfiles(): BrowserProfile[];
+    getProfile(id: string): BrowserProfile;
+    updateProfile(id: string, patch: {
+        name?: string;
+        kind?: BrowserProfile['kind'];
+    }): BrowserProfile;
+    inspectProfile(id: string): BrowserProfileStatus;
+    deleteProfile(id: string): void;
+    pruneProfiles(maxAgeMs?: number): string[];
+    protected referencedProfileIds(): Set<string>;
+    private touchSession;
+    private findSession;
+    private now;
+    private generate;
+    private authorize;
+}

package/dist/src/service.js

@@ -0,0 +1,204 @@
+import { BrowserError, asBrowserError } from './errors.js';
+import { assertActionCapability, boundResult, safeOrigin, validateAction } from './action.js';
+import { newId, safeId } from './ids.js';
+import { BrowserProfileStore } from './profiles/service.js';
+import { BrowserSessionLeases } from './sessions/leases.js';
+import { staleSessionIds } from './sessions/prune.js';
+import { sanitizeEventText } from './events.js';
+export class BrowserService {
+    options;
+    active = new Map();
+    opened = new Set();
+    profiles;
+    leases;
+    constructor(options) {
+        this.options = options;
+        this.profiles = new BrowserProfileStore({
+            registry: options.registry,
+            ...(options.profileDirectories ? { directories: options.profileDirectories } : {}),
+            now: () => this.now(),
+            generate: () => this.generate('profile'),
+            publish: (profileId) => { void this.publish({ type: 'profile.updated', profileId }); },
+        });
+        this.leases = new BrowserSessionLeases(options.registry, options.clock);
+    }
+    async createSession(input = {}) {
+        const context = input.context || {};
+        await this.authorize('sessions.create', undefined, context);
+        const id = safeId(input.id || this.generate('session'));
+        const release = this.leases.acquire(id);
+        try {
+            const existing = this.findSession(id);
+            if (existing?.status === 'ready') {
+                if (!this.opened.has(id)) {
+                    await this.options.drivers[existing.backend].open({ session: existing, context });
+                    this.opened.add(id);
+                }
+                return this.getSession(id);
+            }
+            if (existing && ['creating', 'closing'].includes(existing.status)) {
+                throw new BrowserError('CONFLICT', `Session ${id} is ${existing.status}.`);
+            }
+            const profile = this.profiles.ensure(input.profileId || id, input.profileKind || 'ephemeral');
+            const backend = this.options.runtimeSelector.select(context);
+            const driver = this.options.drivers[backend];
+            const now = this.now();
+            let session = {
+                id,
+                ...(context.ownerId ? { ownerId: context.ownerId } : {}),
+                profileId: profile.id,
+                backend,
+                status: 'creating',
+                capabilities: [...driver.capabilities],
+                createdAt: now,
+                updatedAt: now,
+                lastActiveAt: now,
+            };
+            this.options.registry.putSession(session);
+            await this.publish({ type: 'session.created', sessionId: id, profileId: profile.id, backend });
+            try {
+                await driver.open({ session, context });
+                this.opened.add(id);
+                session = { ...session, status: 'ready', updatedAt: this.now(), lastActiveAt: this.now() };
+                this.options.registry.putSession(session);
+                await this.publish({ type: 'session.ready', sessionId: id, profileId: profile.id, backend });
+                return session;
+            }
+            catch (error) {
+                const failure = asBrowserError(error);
+                this.opened.delete(id);
+                session = { ...session, status: 'failed', error: failure.message, updatedAt: this.now() };
+                this.options.registry.putSession(session);
+                await this.publish({
+                    type: 'session.failed', sessionId: id, profileId: profile.id,
+                    error: sanitizeEventText(failure.message),
+                });
+                throw failure;
+            }
+        }
+        finally {
+            release();
+        }
+    }
+    getSession(id) {
+        const session = this.findSession(id);
+        if (!session)
+            throw new BrowserError('NOT_FOUND', `Browser session ${id} does not exist.`);
+        return session;
+    }
+    listSessions() {
+        return this.options.registry.snapshot().sessions;
+    }
+    async execute(sessionId, action, context = {}) {
+        const session = this.getSession(sessionId);
+        if (session.status !== 'ready')
+            throw new BrowserError('CONFLICT', `Session ${sessionId} is ${session.status}.`);
+        if (this.active.has(sessionId))
+            throw new BrowserError('CONFLICT', `Session ${sessionId} already has an active action.`);
+        await this.authorize(`actions.${action.type}`, sessionId, context);
+        if (action.type === 'close') {
+            await this.closeSession(sessionId, context);
+            return { type: 'ok' };
+        }
+        validateAction(action);
+        assertActionCapability(action, session.capabilities);
+        const releaseLease = this.leases.acquire(sessionId);
+        const controller = new AbortController();
+        const abort = () => controller.abort(context.signal?.reason);
+        context.signal?.addEventListener('abort', abort, { once: true });
+        this.active.set(sessionId, controller);
+        const operationContext = { ...context, signal: controller.signal };
+        try {
+            const result = await this.options.drivers[session.backend].execute({ session, context: operationContext }, action);
+            this.touchSession(session, result);
+            if (result.type === 'page' && result.url) {
+                await this.publish({ type: 'page.navigated', sessionId, profileId: session.profileId, origin: safeOrigin(result.url) });
+            }
+            return boundResult(result);
+        }
+        catch (error) {
+            throw asBrowserError(error);
+        }
+        finally {
+            context.signal?.removeEventListener('abort', abort);
+            this.active.delete(sessionId);
+            releaseLease();
+        }
+    }
+    cancel(sessionId) {
+        const controller = this.active.get(sessionId);
+        if (!controller)
+            return false;
+        controller.abort(new BrowserError('ABORTED', 'Browser operation was cancelled.'));
+        return true;
+    }
+    publish(event) {
+        return Promise.resolve(this.options.eventSink.publish({ ...event, version: 1, id: this.generate('event'), at: this.now() }));
+    }
+    async closeSession(sessionId, context = {}) {
+        const session = this.getSession(sessionId);
+        await this.authorize('sessions.close', sessionId, context);
+        const releaseLease = this.leases.acquire(sessionId);
+        this.cancel(sessionId);
+        this.opened.delete(sessionId);
+        const closing = { ...session, status: 'closing', updatedAt: this.now() };
+        this.options.registry.putSession(closing);
+        try {
+            await this.options.drivers[session.backend].close({ session: closing, context }).catch((error) => {
+                this.options.logger.warn('Browser driver close failed.', { sessionId, error: asBrowserError(error).message });
+            });
+            const closed = { ...closing, status: 'closed', updatedAt: this.now() };
+            this.options.registry.putSession(closed);
+            await this.publish({ type: 'session.closed', sessionId, profileId: session.profileId, backend: session.backend });
+        }
+        finally {
+            releaseLease();
+        }
+    }
+    createProfile(input) {
+        return this.profiles.create(input);
+    }
+    pruneSessions(maxAgeMs = 24 * 60 * 60_000) {
+        const removed = staleSessionIds(this.listSessions(), this.options.clock.now(), maxAgeMs);
+        for (const id of removed)
+            this.options.registry.deleteSession(id);
+        return removed;
+    }
+    listProfiles() { return this.profiles.list(); }
+    getProfile(id) { return this.profiles.get(id); }
+    updateProfile(id, patch) {
+        return this.profiles.update(id, patch);
+    }
+    inspectProfile(id) {
+        return this.profiles.inspect(id, this.listSessions(), this.referencedProfileIds());
+    }
+    deleteProfile(id) {
+        if (this.referencedProfileIds().has(id)) {
+            throw new BrowserError('CONFLICT', `Browser profile ${id} is still referenced.`);
+        }
+        this.profiles.delete(id, this.listSessions());
+    }
+    pruneProfiles(maxAgeMs = 7 * 24 * 60 * 60_000) {
+        return this.profiles.prune(maxAgeMs, this.referencedProfileIds(), this.listSessions());
+    }
+    referencedProfileIds() {
+        return new Set(this.listSessions().filter((value) => !['closed', 'failed'].includes(value.status)).map((value) => value.profileId));
+    }
+    touchSession(session, result) {
+        const now = this.now();
+        const updated = result.type === 'page'
+            ? { ...session, url: result.url, title: result.title, updatedAt: now, lastActiveAt: now }
+            : { ...session, updatedAt: now, lastActiveAt: now };
+        this.options.registry.putSession(updated);
+        this.profiles.touch(session.profileId);
+    }
+    findSession(id) {
+        return this.options.registry.snapshot().sessions.find((session) => session.id === safeId(id));
+    }
+    now() { return this.options.clock.now().toISOString(); }
+    generate(prefix) { return (this.options.id || newId)(prefix); }
+    authorize(operation, resourceId, context) {
+        return Promise.resolve(this.options.authorization?.authorize({ operation, ...(resourceId ? { resourceId } : {}), context }));
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/src/service.js.map

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

package/dist/src/sessions/leases.d.ts

@@ -0,0 +1,10 @@
+import { type BrowserClock, type BrowserRegistry } from '../ports.js';
+export declare class BrowserSessionLeases {
+    private readonly registry;
+    private readonly clock;
+    private readonly owner;
+    private readonly held;
+    constructor(registry: BrowserRegistry, clock: BrowserClock);
+    acquire(sessionId: string): () => void;
+    private release;
+}

package/dist/src/sessions/leases.js

@@ -0,0 +1,41 @@
+import { BrowserError } from '../errors.js';
+import { newId } from '../ids.js';
+import { supportsBrowserLeases } from '../ports.js';
+const LEASE_MS = 5 * 60_000;
+export class BrowserSessionLeases {
+    registry;
+    clock;
+    owner = newId('browser-service');
+    held = new Map();
+    constructor(registry, clock) {
+        this.registry = registry;
+        this.clock = clock;
+    }
+    acquire(sessionId) {
+        if (!supportsBrowserLeases(this.registry))
+            return () => { };
+        const nested = this.held.get(sessionId) || 0;
+        if (nested) {
+            this.held.set(sessionId, nested + 1);
+            return () => this.release(sessionId);
+        }
+        const leases = this.registry;
+        const expiresAt = new Date(this.clock.now().getTime() + LEASE_MS).toISOString();
+        if (!leases.acquireSessionLease(sessionId, this.owner, expiresAt)) {
+            throw new BrowserError('CONFLICT', `Session ${sessionId} is active in another Browser process.`);
+        }
+        this.held.set(sessionId, 1);
+        return () => this.release(sessionId);
+    }
+    release(sessionId) {
+        const count = this.held.get(sessionId) || 0;
+        if (count > 1) {
+            this.held.set(sessionId, count - 1);
+            return;
+        }
+        this.held.delete(sessionId);
+        if (supportsBrowserLeases(this.registry))
+            this.registry.releaseSessionLease(sessionId, this.owner);
+    }
+}
+//# sourceMappingURL=leases.js.map

package/dist/src/sessions/leases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leases.js","sourceRoot":"","sources":["../../../src/sessions/leases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAA2C,MAAM,aAAa,CAAC;AAE7F,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC;AAE5B,MAAM,OAAO,oBAAoB;IAIF;IAA4C;IAHxD,KAAK,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACjC,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD,YAA6B,QAAyB,EAAmB,KAAmB;QAA/D,aAAQ,GAAR,QAAQ,CAAiB;QAAmB,UAAK,GAAL,KAAK,CAAc;IAAG,CAAC;IAEhG,OAAO,CAAC,SAAiB;QACvB,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;YACrC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAChF,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,WAAW,SAAS,wCAAwC,CAAC,CAAC;QACnG,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAEO,OAAO,CAAC,SAAiB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5B,IAAI,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACrG,CAAC;CACF"}

package/dist/src/sessions/prune.d.ts

@@ -0,0 +1,2 @@
+import type { BrowserSession } from '../types.js';
+export declare function staleSessionIds(sessions: BrowserSession[], now: Date, maxAgeMs: number): string[];

package/dist/src/sessions/prune.js

@@ -0,0 +1,8 @@
+export function staleSessionIds(sessions, now, maxAgeMs) {
+    const cutoff = now.getTime() - maxAgeMs;
+    return sessions
+        .filter((session) => (session.status === 'closed' || session.status === 'failed')
+        && Date.parse(session.updatedAt) < cutoff)
+        .map((session) => session.id);
+}
+//# sourceMappingURL=prune.js.map

package/dist/src/sessions/prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.js","sourceRoot":"","sources":["../../../src/sessions/prune.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAC7B,QAA0B,EAC1B,GAAS,EACT,QAAgB;IAEhB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC;IACxC,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC;WAC5E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;SAC3C,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAClC,CAAC"}

package/dist/src/testing.d.ts

@@ -0,0 +1,18 @@
+import type { BrowserDriver, BrowserDriverSession } from './ports.js';
+import type { BrowserAction, BrowserActionResult, BrowserBackendKind, BrowserCapability } from './types.js';
+export { MemoryBrowserRegistry } from './registry.js';
+export declare class TestBrowserDriver implements BrowserDriver {
+    readonly kind: BrowserBackendKind;
+    readonly capabilities: readonly BrowserCapability[];
+    readonly handler: (action: BrowserAction) => BrowserActionResult | Promise<BrowserActionResult>;
+    readonly calls: Array<{
+        sessionId: string;
+        action: BrowserAction;
+    }>;
+    readonly opened: string[];
+    readonly closed: string[];
+    constructor(kind?: BrowserBackendKind, capabilities?: readonly BrowserCapability[], handler?: (action: BrowserAction) => BrowserActionResult | Promise<BrowserActionResult>);
+    open(input: BrowserDriverSession): Promise<void>;
+    execute(input: BrowserDriverSession, action: BrowserAction): Promise<BrowserActionResult>;
+    close(input: BrowserDriverSession): Promise<void>;
+}

package/dist/src/testing.js

@@ -0,0 +1,21 @@
+export { MemoryBrowserRegistry } from './registry.js';
+export class TestBrowserDriver {
+    kind;
+    capabilities;
+    handler;
+    calls = [];
+    opened = [];
+    closed = [];
+    constructor(kind = 'headless', capabilities = ['core', 'computer-use'], handler = () => ({ type: 'ok' })) {
+        this.kind = kind;
+        this.capabilities = capabilities;
+        this.handler = handler;
+    }
+    async open(input) { this.opened.push(input.session.id); }
+    async execute(input, action) {
+        this.calls.push({ sessionId: input.session.id, action });
+        return this.handler(action);
+    }
+    async close(input) { this.closed.push(input.session.id); }
+}
+//# sourceMappingURL=testing.js.map

package/dist/src/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/testing.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,OAAO,iBAAiB;IAMjB;IACA;IACA;IAPF,KAAK,GAAwD,EAAE,CAAC;IAChE,MAAM,GAAa,EAAE,CAAC;IACtB,MAAM,GAAa,EAAE,CAAC;IAE/B,YACW,OAA2B,UAAU,EACrC,eAA6C,CAAC,MAAM,EAAE,cAAc,CAAC,EACrE,UACP,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAHf,SAAI,GAAJ,IAAI,CAAiC;QACrC,iBAAY,GAAZ,YAAY,CAAyD;QACrE,YAAO,GAAP,OAAO,CACQ;IACvB,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,KAA2B,IAAmB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9F,KAAK,CAAC,OAAO,CAAC,KAA2B,EAAE,MAAqB;QAC9D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,KAA2B,IAAmB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;CAChG"}

package/dist/src/toolbox.d.ts

@@ -0,0 +1,3 @@
+export { browserToolboxManifest, type BrowserToolboxManifest } from './adapters/toolbox/manifest.js';
+export { resolveBrowserAlias } from './adapters/toolbox/aliases.js';
+export { createBrowserToolboxExecutor } from './adapters/toolbox/executor.js';

package/dist/src/toolbox.js

@@ -0,0 +1,4 @@
+export { browserToolboxManifest } from './adapters/toolbox/manifest.js';
+export { resolveBrowserAlias } from './adapters/toolbox/aliases.js';
+export { createBrowserToolboxExecutor } from './adapters/toolbox/executor.js';
+//# sourceMappingURL=toolbox.js.map

package/dist/src/toolbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbox.js","sourceRoot":"","sources":["../../src/toolbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAA+B,MAAM,gCAAgC,CAAC;AACrG,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC"}