@amalgm/browser 0.1.0

package/dist/src/adapters/http/openapi.js

@@ -0,0 +1,78 @@
+import { browserActionDescriptors } from '../actions.js';
+const response = (description) => ({ responses: { 200: { description } } });
+const post = (description) => ({ post: response(description) });
+export function browserOpenApi() {
+    const actionPaths = Object.fromEntries(browserActionDescriptors.map((action) => [
+        `/v1/sessions/{sessionId}/actions/${action.name}`,
+        {
+            post: {
+                summary: action.description,
+                requestBody: jsonBody(action.inputSchema),
+                responses: { 200: { description: 'Browser result' } },
+            },
+        },
+    ]));
+    return {
+        openapi: '3.1.0',
+        info: { title: 'Amalgm Browser API', version: '1.0.0' },
+        servers: [{ url: 'http://127.0.0.1' }],
+        components: { securitySchemes: { bearer: { type: 'http', scheme: 'bearer' } } },
+        security: [{ bearer: [] }],
+        paths: {
+            '/v1/health': { get: { security: [], ...response('Health') } },
+            '/v1/openapi.json': { get: response('OpenAPI document') },
+            '/v1/capabilities': { get: response('Driver capabilities') },
+            '/v1/events': { get: response('Browser event stream') },
+            '/v1/sessions': {
+                get: response('Sessions'),
+                post: { responses: { 201: { description: 'Created session' } } },
+            },
+            '/v1/sessions/prune': post('Pruned sessions'),
+            '/v1/sessions/{sessionId}': {
+                get: response('Session'), delete: response('Closed session'),
+            },
+            '/v1/sessions/{sessionId}/cancel': post('Cancellation status'),
+            '/v1/profiles': {
+                get: response('Profiles'),
+                post: { responses: { 201: { description: 'Created profile' } } },
+            },
+            '/v1/profiles/prune': post('Pruned profiles'),
+            '/v1/profiles/{profileId}': {
+                get: response('Profile status'), patch: response('Updated profile'), delete: response('Deleted profile'),
+            },
+            '/v1/auth/bundles': {
+                get: response('Sanitized auth bundles'),
+                post: { responses: { 201: { description: 'Saved auth bundle' } } },
+            },
+            '/v1/auth/bundles/import': {
+                post: { responses: { 201: { description: 'Imported encrypted auth resource' } } },
+            },
+            '/v1/auth/bundles/{bundleId}': {
+                get: response('Sanitized auth bundle'), delete: response('Deleted auth bundle'),
+            },
+            '/v1/auth/bundles/{bundleId}/load': post('Loaded auth bundle'),
+            '/v1/auth/bundles/{bundleId}/export': post('Encrypted auth resource'),
+            '/v1/auth/login-sessions': {
+                get: response('Login sessions'),
+                post: { responses: { 201: { description: 'Created login handoff' } } },
+            },
+            '/v1/auth/login-sessions/{loginId}': { get: response('Login session') },
+            '/v1/auth/login-sessions/{loginId}/activate': post('Activated login session'),
+            '/v1/auth/login-sessions/{loginId}/input': post('Live login input result'),
+            '/v1/auth/login-sessions/{loginId}/complete': post('Completed login session'),
+            '/v1/auth/login-sessions/{loginId}/cancel': post('Cancelled login session'),
+            '/v1/recordings': {
+                get: response('Recordings and active status'),
+                post: { responses: { 201: { description: 'Started recording' } } },
+            },
+            '/v1/recordings/{recordingId}': { get: response('Recording') },
+            '/v1/recordings/{recordingId}/stop': post('Stopped recording'),
+            '/v1/recordings/{recordingId}/cancel': post('Force-stopped recording'),
+            ...actionPaths,
+        },
+    };
+}
+function jsonBody(schema) {
+    return { required: true, content: { 'application/json': { schema } } };
+}
+//# sourceMappingURL=openapi.js.map

package/dist/src/adapters/http/openapi.js.map

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

package/dist/src/adapters/http/profile-routes.d.ts

@@ -0,0 +1,2 @@
+import type { RouteContext } from './types.js';
+export declare function routeProfiles(context: RouteContext): Promise<boolean>;

package/dist/src/adapters/http/profile-routes.js

@@ -0,0 +1,42 @@
+export async function routeProfiles(context) {
+    const [resource, id] = context.path;
+    if (resource !== 'profiles')
+        return false;
+    if (!id && context.method === 'GET') {
+        context.json(200, { profiles: context.browser.listProfiles() });
+        return true;
+    }
+    if (!id && context.method === 'POST') {
+        const body = await context.body();
+        context.json(201, { profile: context.browser.createProfile({
+                ...(typeof body.id === 'string' ? { id: body.id } : {}),
+                name: typeof body.name === 'string' ? body.name : String(body.id || 'profile'),
+                kind: 'durable',
+            }) });
+        return true;
+    }
+    if (id === 'prune' && context.method === 'POST') {
+        const body = await context.body();
+        context.json(200, { removed: context.browser.pruneProfiles(Number(body.maxAgeMs) || undefined) });
+        return true;
+    }
+    if (id && context.method === 'GET') {
+        context.json(200, { status: context.browser.inspectProfile(id) });
+        return true;
+    }
+    if (id && context.method === 'PATCH') {
+        const body = await context.body();
+        context.json(200, { profile: context.browser.updateProfile(id, {
+                ...(typeof body.name === 'string' ? { name: body.name } : {}),
+                ...(body.kind === 'durable' || body.kind === 'ephemeral' ? { kind: body.kind } : {}),
+            }) });
+        return true;
+    }
+    if (id && context.method === 'DELETE') {
+        context.browser.deleteProfile(id);
+        context.json(200, { deleted: id });
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=profile-routes.js.map

package/dist/src/adapters/http/profile-routes.js.map

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

package/dist/src/adapters/http/recording-routes.d.ts

@@ -0,0 +1,2 @@
+import type { RouteContext } from './types.js';
+export declare function routeRecordings(context: RouteContext): Promise<boolean>;

package/dist/src/adapters/http/recording-routes.js

@@ -0,0 +1,41 @@
+import { BrowserError } from '../../errors.js';
+export async function routeRecordings(context) {
+    const [resource, id, action] = context.path;
+    if (resource !== 'recordings')
+        return false;
+    if (!id && context.method === 'GET') {
+        context.json(200, {
+            recordings: context.browser.recordings.list(), active: context.browser.recordings.activeRecordings(),
+        });
+        return true;
+    }
+    if (!id && context.method === 'POST') {
+        const body = await context.body();
+        if (typeof body.sessionId !== 'string')
+            throw new BrowserError('INVALID_INPUT', 'sessionId is required.');
+        context.json(201, { recording: await context.browser.recordings.start({
+                sessionId: body.sessionId,
+                ...(typeof body.name === 'string' ? { name: body.name } : {}),
+                ...(typeof body.fps === 'number' ? { fps: body.fps } : {}),
+                context: { clientKind: 'rest', signal: context.signal },
+            }) });
+        return true;
+    }
+    if (id && !action && context.method === 'GET') {
+        context.json(200, { recording: context.browser.recordings.get(id) });
+        return true;
+    }
+    if (id && action === 'stop' && context.method === 'POST') {
+        const recording = context.browser.recordings.get(id);
+        context.json(200, { recording: await context.browser.recordings.stop(recording.sessionId) });
+        return true;
+    }
+    if (id && action === 'cancel' && context.method === 'POST') {
+        const recording = context.browser.recordings.get(id);
+        await context.browser.recordings.forceStop(recording.sessionId);
+        context.json(200, { recording: context.browser.recordings.get(id) });
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=recording-routes.js.map

package/dist/src/adapters/http/recording-routes.js.map

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

package/dist/src/adapters/http/request.d.ts

@@ -0,0 +1,4 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export declare function readJson(request: IncomingMessage, limit: number): Promise<Record<string, unknown>>;
+export declare function sendJson(response: ServerResponse, status: number, value: unknown, limit: number): void;
+export declare function isLoopbackBindHost(host: string): boolean;

package/dist/src/adapters/http/request.js

@@ -0,0 +1,44 @@
+import { LOOPBACK_ORIGIN_HOSTNAMES } from '@amalgm/core/transport';
+import { BrowserError } from '../../errors.js';
+export async function readJson(request, limit) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of request) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += buffer.length;
+        if (size > limit)
+            throw new BrowserError('INVALID_INPUT', `Request body exceeds ${limit} bytes.`);
+        chunks.push(buffer);
+    }
+    if (!size)
+        return {};
+    try {
+        const value = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            throw new Error();
+        return value;
+    }
+    catch {
+        throw new BrowserError('INVALID_INPUT', 'Request body must be a JSON object.');
+    }
+}
+export function sendJson(response, status, value, limit) {
+    let body = JSON.stringify(value);
+    if (Buffer.byteLength(body) > limit) {
+        status = 413;
+        body = JSON.stringify({ error: { code: 'OUTPUT_TOO_LARGE', message: `Response exceeds ${limit} bytes.` } });
+    }
+    response.writeHead(status, {
+        'content-type': 'application/json; charset=utf-8',
+        'content-length': Buffer.byteLength(body),
+        'cache-control': 'no-store',
+    });
+    response.end(body);
+}
+// Bind addresses are unbracketed, so the bind-oriented notion is derived
+// from @amalgm/core's origin-oriented loopback list in this ONE place.
+const LOOPBACK_BIND_HOSTS = [...new Set(LOOPBACK_ORIGIN_HOSTNAMES.map((host) => host.replace(/^\[(.+)\]$/, '$1')))];
+export function isLoopbackBindHost(host) {
+    return LOOPBACK_BIND_HOSTS.includes(host);
+}
+//# sourceMappingURL=request.js.map

package/dist/src/adapters/http/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../../src/adapters/http/request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB,EAAE,KAAa;IACpE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC;QACtB,IAAI,IAAI,GAAG,KAAK;YAAE,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,wBAAwB,KAAK,SAAS,CAAC,CAAC;QAClG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAY,CAAC;QAC5E,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,EAAE,CAAC;QACnF,OAAO,KAAgC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,qCAAqC,CAAC,CAAC;IAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAwB,EAAE,MAAc,EAAE,KAAc,EAAE,KAAa;IAC9F,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,CAAC;QACb,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,oBAAoB,KAAK,SAAS,EAAE,EAAE,CAAC,CAAC;IAC9G,CAAC;IACD,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE;QACzB,cAAc,EAAE,iCAAiC;QACjD,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;QACzC,eAAe,EAAE,UAAU;KAC5B,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,yEAAyE;AACzE,uEAAuE;AACvE,MAAM,mBAAmB,GAAsB,CAAC,GAAG,IAAI,GAAG,CACxD,yBAAyB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAC1E,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/src/adapters/http/server.d.ts

@@ -0,0 +1,2 @@
+import type { BrowserHttpOptions, BrowserHttpServer } from './types.js';
+export declare function createBrowserHttpServer(options: BrowserHttpOptions): BrowserHttpServer;

package/dist/src/adapters/http/server.js

@@ -0,0 +1,114 @@
+import crypto from 'node:crypto';
+import http from 'node:http';
+import { guardBearerRequest, headerValue, safeTokenEqual } from '@amalgm/core/transport';
+import { asBrowserError, BrowserError, redactBrowserSecrets } from '../../errors.js';
+import { BrowserEventBus } from '../../events.js';
+import { routeAuth } from './auth-routes.js';
+import { streamBrowserEvents } from './events.js';
+import { routeInternalCookies } from './internal-routes.js';
+import { browserOpenApi } from './openapi.js';
+import { routeProfiles } from './profile-routes.js';
+import { readJson, isLoopbackBindHost, sendJson } from './request.js';
+import { routeRecordings } from './recording-routes.js';
+import { routeSessions } from './session-routes.js';
+export function createBrowserHttpServer(options) {
+    if (!options.token)
+        throw new BrowserError('INVALID_INPUT', 'REST server requires a bearer token.');
+    const bodyLimit = options.bodyLimitBytes || 512_000;
+    const outputLimit = options.outputLimitBytes || 2_000_000;
+    const timeoutMs = options.requestTimeoutMs || 120_000;
+    const events = options.events || (options.browser.options.eventSink instanceof BrowserEventBus
+        ? options.browser.options.eventSink : new BrowserEventBus());
+    const server = http.createServer((request, response) => {
+        void dispatch(request, response).catch((error) => respondError(response, error, outputLimit));
+    });
+    async function dispatch(request, response) {
+        const url = new URL(request.url || '/', 'http://localhost');
+        if (url.pathname === '/v1/health') {
+            sendJson(response, 200, { ok: true, version: 1 }, outputLimit);
+            return;
+        }
+        const verdict = guardBearerRequest({ headers: request.headers, expectedToken: options.token, timingSafeEqual });
+        if (!verdict.ok) {
+            response.writeHead(verdict.status, verdict.headers);
+            response.end(verdict.body);
+            return;
+        }
+        if (url.pathname === '/v1/openapi.json') {
+            sendJson(response, 200, browserOpenApi(), outputLimit);
+            return;
+        }
+        if (url.pathname === '/v1/events' && request.method === 'GET') {
+            streamBrowserEvents(events, request, response, request.headers['last-event-id']);
+            return;
+        }
+        if (url.pathname.startsWith('/internal/v1/')) {
+            if (!options.adapterToken || !safeTokenEqual(headerValue(request.headers, 'x-browser-adapter-token'), options.adapterToken, timingSafeEqual)) {
+                sendJson(response, 401, { error: { code: 'AUTHORIZATION_DENIED', message: 'Browser adapter credential required.' } }, outputLimit);
+                return;
+            }
+            const context = routeContext(request, response, url.pathname.slice('/internal/v1/'.length), url);
+            if (await routeInternalCookies(context))
+                return;
+            sendJson(response, 404, { error: { code: 'NOT_FOUND', message: 'Route not found.' } }, outputLimit);
+            return;
+        }
+        if (url.pathname === '/v1/capabilities' && request.method === 'GET') {
+            sendJson(response, 200, { drivers: Object.fromEntries(Object.entries(options.browser.options.drivers).map(([key, value]) => [key, value.capabilities])) }, outputLimit);
+            return;
+        }
+        if (!url.pathname.startsWith('/v1/')) {
+            sendJson(response, 404, { error: { code: 'NOT_FOUND', message: 'Route not found.' } }, outputLimit);
+            return;
+        }
+        const context = routeContext(request, response, url.pathname.slice(4), url);
+        if (await routeSessions(context) || await routeProfiles(context) || await routeAuth(context) || await routeRecordings(context))
+            return;
+        sendJson(response, 404, { error: { code: 'NOT_FOUND', message: 'Route not found.' } }, outputLimit);
+    }
+    function routeContext(request, response, rawPath, url) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(new BrowserError('TIMEOUT', 'HTTP request timed out.')), timeoutMs);
+        request.once('close', () => { clearTimeout(timer); if (!request.complete)
+            controller.abort(); });
+        return {
+            browser: options.browser,
+            method: request.method || 'GET',
+            path: rawPath.split('/').filter(Boolean).map(decodeURIComponent),
+            url,
+            signal: controller.signal,
+            body: () => readJson(request, bodyLimit),
+            json(status, value) { clearTimeout(timer); sendJson(response, status, value, outputLimit); },
+        };
+    }
+    return {
+        server, browser: options.browser,
+        listen(port = 0, host = '127.0.0.1') {
+            return new Promise((resolve, reject) => {
+                if (!isLoopbackBindHost(host) && !options.allowRemote) {
+                    reject(new BrowserError('AUTHORIZATION_DENIED', 'Non-loopback bind requires allowRemote.'));
+                    return;
+                }
+                server.once('error', reject);
+                server.listen(port, host, () => { server.removeListener('error', reject); resolve(server.address()); });
+            });
+        },
+        close() { return new Promise((resolve, reject) => { if (!server.listening)
+            return resolve(); server.close((error) => error ? reject(error) : resolve()); }); },
+    };
+}
+function respondError(response, error, limit) {
+    if (response.headersSent) {
+        response.destroy(error instanceof Error ? error : undefined);
+        return;
+    }
+    const normalized = asBrowserError(error);
+    const status = normalized.code === 'NOT_FOUND' ? 404 : normalized.code === 'AUTHORIZATION_DENIED' ? 403
+        : normalized.code === 'CONFLICT' ? 409 : normalized.code === 'TIMEOUT' ? 504 : normalized.code === 'INVALID_INPUT' ? 400 : 500;
+    sendJson(response, status, { error: { code: normalized.code, message: redactBrowserSecrets(normalized.message) } }, limit);
+}
+// The compare law lives in @amalgm/core; node:crypto is injected here.
+function timingSafeEqual(left, right) {
+    return crypto.timingSafeEqual(left, right);
+}
+//# sourceMappingURL=server.js.map

package/dist/src/adapters/http/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../src/adapters/http/server.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,UAAU,uBAAuB,CAAC,OAA2B;IACjE,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,sCAAsC,CAAC,CAAC;IACpG,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC;IACpD,MAAM,WAAW,GAAG,OAAO,CAAC,gBAAgB,IAAI,SAAS,CAAC;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,YAAY,eAAe;QAC5F,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QACrD,KAAK,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,KAAK,UAAU,QAAQ,CAAC,OAA6B,EAAE,QAA6B;QAClF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAC5D,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC9G,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;QAChH,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC7G,IAAI,GAAG,CAAC,QAAQ,KAAK,kBAAkB,EAAE,CAAC;YAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,WAAW,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC5G,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC9D,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,eAAe,CAAuB,CAAC,CAAC;YAAC,OAAO;QACjH,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,yBAAyB,CAAC,EAAE,OAAO,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE,CAAC;gBAC7I,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,sCAAsC,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;gBAAC,OAAO;YAC7I,CAAC;YACD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;YACjG,IAAI,MAAM,oBAAoB,CAAC,OAAO,CAAC;gBAAE,OAAO;YAChD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;YAAC,OAAO;QAC9G,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,KAAK,kBAAkB,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACpE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;YAAC,OAAO;QAClL,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACtJ,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5E,IAAI,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,MAAM,eAAe,CAAC,OAAO,CAAC;YAAE,OAAO;QACvI,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;IACtG,CAAC;IAED,SAAS,YAAY,CAAC,OAA6B,EAAE,QAA6B,EAAE,OAAe,EAAE,GAAQ;QAC3G,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACpH,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACjG,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;YAC/B,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC;YAChE,GAAG;YACH,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;YACxC,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;SAC7F,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO;QAChC,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,WAAW;YAAI,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC5E,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;oBACtD,MAAM,CAAC,IAAI,YAAY,CAAC,sBAAsB,EAAE,yCAAyC,CAAC,CAAC,CAAC;oBAAC,OAAO;gBACtG,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvJ,CAAC,CAAC,CAAC;QAAC,CAAC;QACL,KAAK,KAAK,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAC/J,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,QAA6B,EAAE,KAAc,EAAE,KAAa;IAChF,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IACnG,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,KAAK,sBAAsB,CAAC,CAAC,CAAC,GAAG;QACrG,CAAC,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACjI,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,oBAAoB,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;AAC7H,CAAC;AACD,uEAAuE;AACvE,SAAS,eAAe,CAAC,IAAgB,EAAE,KAAiB;IAC1D,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC"}

package/dist/src/adapters/http/session-routes.d.ts

@@ -0,0 +1,2 @@
+import type { RouteContext } from './types.js';
+export declare function routeSessions(context: RouteContext): Promise<boolean>;

package/dist/src/adapters/http/session-routes.js

@@ -0,0 +1,54 @@
+import { BrowserError } from '../../errors.js';
+import { BROWSER_ACTIONS } from '../actions.js';
+import { executeProductAction } from '../execute.js';
+export async function routeSessions(context) {
+    const [resource, id, child, action] = context.path;
+    if (resource !== 'sessions')
+        return false;
+    if (!id && context.method === 'GET') {
+        context.json(200, { sessions: context.browser.listSessions() });
+        return true;
+    }
+    if (!id && context.method === 'POST') {
+        const body = await context.body();
+        const session = await context.browser.createSession({
+            ...(typeof body.id === 'string' ? { id: body.id } : {}),
+            ...(typeof body.profileId === 'string' ? { profileId: body.profileId } : {}),
+            context: { clientKind: 'rest', signal: context.signal },
+        });
+        context.json(201, { session });
+        return true;
+    }
+    if (!id)
+        return false;
+    if (id === 'prune' && context.method === 'POST') {
+        const body = await context.body();
+        context.json(200, { removed: context.browser.pruneSessions(Number(body.maxAgeMs) || undefined) });
+        return true;
+    }
+    if (!child && context.method === 'GET') {
+        context.json(200, { session: context.browser.getSession(id) });
+        return true;
+    }
+    if (!child && context.method === 'DELETE') {
+        await context.browser.closeSession(id, { clientKind: 'rest', signal: context.signal });
+        context.json(200, { session: context.browser.getSession(id) });
+        return true;
+    }
+    if (child === 'actions' && action && context.method === 'POST') {
+        if (!BROWSER_ACTIONS.includes(action))
+            throw new BrowserError('NOT_FOUND', `Unknown Browser action ${action}.`);
+        const body = await context.body();
+        const result = await executeProductAction(context.browser, action, { ...body, session: id }, {
+            clientKind: 'rest', signal: context.signal,
+        });
+        context.json(200, { result });
+        return true;
+    }
+    if (child === 'cancel' && context.method === 'POST') {
+        context.json(200, { cancelled: context.browser.cancel(id) });
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=session-routes.js.map

package/dist/src/adapters/http/session-routes.js.map

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

package/dist/src/adapters/http/types.d.ts

@@ -0,0 +1,29 @@
+import type http from 'node:http';
+import type { AddressInfo } from 'node:net';
+import type { BrowserEventBus } from '../../events.js';
+import type { BrowserProductService } from '../../product-service.js';
+export interface BrowserHttpOptions {
+    browser: BrowserProductService;
+    token: string;
+    adapterToken?: string;
+    bodyLimitBytes?: number;
+    outputLimitBytes?: number;
+    requestTimeoutMs?: number;
+    allowRemote?: boolean;
+    events?: BrowserEventBus;
+}
+export interface BrowserHttpServer {
+    server: http.Server;
+    browser: BrowserProductService;
+    listen(port?: number, host?: string): Promise<AddressInfo>;
+    close(): Promise<void>;
+}
+export interface RouteContext {
+    browser: BrowserProductService;
+    method: string;
+    path: string[];
+    url: URL;
+    signal: AbortSignal;
+    body(): Promise<Record<string, unknown>>;
+    json(status: number, value: unknown): void;
+}

package/dist/src/adapters/http/types.js

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

package/dist/src/adapters/http/types.js.map

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

package/dist/src/adapters/mcp/server.d.ts

@@ -0,0 +1,3 @@
+import type { BrowserProductService } from '../../product-service.js';
+import type { BrowserMcpServer } from './types.js';
+export declare function createBrowserMcpServer(browser: BrowserProductService): BrowserMcpServer;

package/dist/src/adapters/mcp/server.js

@@ -0,0 +1,74 @@
+import readline from 'node:readline';
+import { asBrowserError, redactBrowserSecrets } from '../../errors.js';
+import { createBrowserMcpTools } from './tools.js';
+export function createBrowserMcpServer(browser) {
+    const tools = createBrowserMcpTools(browser);
+    const byName = new Map(tools.map((tool) => [tool.name, tool]));
+    const active = new Map();
+    async function handle(message) {
+        if (message.method === 'initialize')
+            return {
+                protocolVersion: message.params?.protocolVersion || '2024-11-05',
+                capabilities: { tools: { listChanged: false } },
+                serverInfo: { name: 'amalgm-browser', version: '0.1.0' },
+            };
+        if (message.method === 'ping')
+            return {};
+        if (message.method === 'tools/list')
+            return { tools: tools.map(({ handler: _handler, ...tool }) => tool) };
+        if (message.method === 'tools/call') {
+            const tool = typeof message.params?.name === 'string' ? byName.get(message.params.name) : undefined;
+            if (!tool)
+                throw Object.assign(new Error(`Unknown Browser tool: ${String(message.params?.name)}`), { rpcCode: -32602 });
+            const args = message.params?.arguments;
+            const key = requestKey(message.id);
+            const controller = new AbortController();
+            if (key)
+                active.set(key, controller);
+            try {
+                return await tool.handler(args && typeof args === 'object' ? args : {}, controller.signal);
+            }
+            finally {
+                if (key)
+                    active.delete(key);
+            }
+        }
+        if (message.method === 'notifications/cancelled') {
+            active.get(requestKey(message.params?.requestId) || '')?.abort();
+            return undefined;
+        }
+        if (message.method?.startsWith('notifications/'))
+            return undefined;
+        throw Object.assign(new Error(`Method not found: ${message.method}`), { rpcCode: -32601 });
+    }
+    async function start(input = process.stdin, output = process.stdout) {
+        const lines = readline.createInterface({ input, crlfDelay: Infinity });
+        lines.on('line', (line) => { void respond(line, output); });
+        return async () => lines.close();
+    }
+    async function respond(line, output) {
+        let request;
+        try {
+            request = JSON.parse(line);
+            const result = await handle(request);
+            if (request.id !== undefined && result !== undefined) {
+                output.write(`${JSON.stringify({ jsonrpc: '2.0', id: request.id, result })}\n`);
+            }
+        }
+        catch (error) {
+            if (request?.id === undefined)
+                return;
+            const normalized = asBrowserError(error);
+            const rpcCode = typeof error === 'object' && error && 'rpcCode' in error ? Number(error.rpcCode) : -32603;
+            output.write(`${JSON.stringify({
+                jsonrpc: '2.0', id: request.id,
+                error: { code: rpcCode, message: redactBrowserSecrets(normalized.message), data: { code: normalized.code } },
+            })}\n`);
+        }
+    }
+    return { tools, handle, start };
+}
+function requestKey(value) {
+    return typeof value === 'string' || typeof value === 'number' ? String(value) : null;
+}
+//# sourceMappingURL=server.js.map

package/dist/src/adapters/mcp/server.js.map

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

package/dist/src/adapters/mcp/tools.d.ts

@@ -0,0 +1,3 @@
+import type { BrowserProductService } from '../../product-service.js';
+import type { BrowserMcpTool } from './types.js';
+export declare function createBrowserMcpTools(browser: BrowserProductService): BrowserMcpTool[];

package/dist/src/adapters/mcp/tools.js

@@ -0,0 +1,45 @@
+import { redactBrowserSecrets } from '../../errors.js';
+import { browserActionDescriptors } from '../actions.js';
+import { executeProductAction } from '../execute.js';
+export function createBrowserMcpTools(browser) {
+    return browserActionDescriptors.map((descriptor) => ({
+        name: `browser_${descriptor.name}`,
+        description: descriptor.description,
+        inputSchema: descriptor.inputSchema,
+        async handler(input, signal) {
+            const value = await executeProductAction(browser, descriptor.name, input, {
+                clientKind: 'mcp', ...(signal ? { signal } : {}),
+            });
+            return mcpResult(value);
+        },
+    }));
+}
+function mcpResult(value) {
+    const result = value;
+    if (result?.type === 'capture') {
+        return {
+            content: [
+                { type: 'image', data: result.capture.base64, mimeType: result.capture.mimeType },
+                { type: 'text', text: `Browser screenshot (${result.capture.bytes} bytes, CSS-pixel coordinates)` },
+            ],
+            structuredContent: { type: 'capture', bytes: result.capture.bytes, coordinateSpace: result.capture.coordinateSpace },
+        };
+    }
+    const sanitized = sanitize(value);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(sanitized, null, 2).slice(0, 15_000) }],
+        structuredContent: sanitized,
+    };
+}
+function sanitize(value) {
+    if (Array.isArray(value))
+        return value.map(sanitize);
+    if (typeof value === 'string')
+        return redactBrowserSecrets(value, 15_000);
+    if (!value || typeof value !== 'object')
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .filter(([key]) => !/(cookie|token|secret|ciphertext|authorization|localStorage|sessionStorage)/i.test(key))
+        .map(([key, child]) => [key, sanitize(child)]));
+}
+//# sourceMappingURL=tools.js.map