@praveen-palanisamy/agent-browser-runtime 0.1.0

package/dist/cli.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * agent-browser-runtime (ABR) CLI
+ *
+ *   agent-browser-runtime serve  --strategies ./dist/strategies.js
+ *   agent-browser-runtime health [--url http://localhost:8080]
+ *   agent-browser-runtime probe  --platform <id> --session ./session.json [--url … --token … | --local --strategies …]
+ *   agent-browser-runtime post   --platform <id> --session ./session.json --text "…" [--media url,…] [--link url]
+ *                                [--url … --token … | --local --strategies …] [--session-out file] [--out file]
+ *
+ * `serve` loads a CommonJS/ESM module whose default export (or `strategies`
+ * export) is an array of WebPostStrategy instances, then starts the runner
+ * using environment configuration (see service/config.ts).
+ *
+ * `probe` / `post` talk to a running runner by default. With `--local` they
+ * run in-process against local Chromium instead (used by the GitHub Action
+ * and for one-off jobs), which requires `--strategies`.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadStrategies = loadStrategies;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const node_url_1 = require("node:url");
+const attribution_1 = require("./attribution");
+const runner_client_1 = require("./client/runner-client");
+const poster_1 = require("./core/poster");
+const stores_1 = require("./core/stores");
+const playwright_1 = require("./providers/playwright");
+const service_1 = require("./service");
+function parse(argv) {
+    const [cmd = 'help', ...rest] = argv;
+    const flags = {};
+    for (let i = 0; i < rest.length; i++) {
+        const a = rest[i];
+        if (!a.startsWith('--'))
+            continue;
+        const key = a.slice(2);
+        const next = rest[i + 1];
+        if (next && !next.startsWith('--')) {
+            flags[key] = next;
+            i++;
+        }
+        else {
+            flags[key] = true;
+        }
+    }
+    return { cmd, flags };
+}
+// tsc (CommonJS output) would rewrite a literal `import()` into `require()`,
+// which cannot load ESM modules. Keep a real dynamic import for those.
+const dynamicImport = new Function('u', 'return import(u)');
+async function loadStrategies(spec) {
+    const abs = node_path_1.default.resolve(process.cwd(), spec);
+    let mod;
+    try {
+        mod = require(abs);
+    }
+    catch (err) {
+        if (err.code !== 'ERR_REQUIRE_ESM')
+            throw err;
+        mod = await dynamicImport((0, node_url_1.pathToFileURL)(abs).href);
+    }
+    const value = Array.isArray(mod) ? mod : (mod.default ?? mod.strategies);
+    const list = typeof value === 'function' ? await value() : value;
+    if (!Array.isArray(list) || list.length === 0) {
+        throw new Error(`${spec} must export a non-empty WebPostStrategy[] (default or "strategies")`);
+    }
+    return list;
+}
+function usage() {
+    console.log(`${attribution_1.PROJECT.name} v${(0, attribution_1.packageVersion)()} — ${attribution_1.PROJECT.repository}
+
+Commands
+  serve   --strategies <module>            start the runner HTTP service (env-configured)
+  health  [--url <runner>] [--token <t>]   check a running runner
+  probe   --platform <id> --session <file> is the stored session still authenticated?
+  post    --platform <id> --session <file> --text <t> [--media a,b] [--link url]
+                                           run one job with the stored session
+
+Target (probe/post)
+  --url <runner> --token <t>               call a running runner (default; env AGENT_RUNNER_URL/_TOKEN)
+  --local --strategies <module>            run in-process with local Chromium instead
+  --session-out <file>                     write the refreshed session state here
+  --out <file>                             write the JSON result here (also printed)
+  --workspace <id> --account <id>          job identity (default: cli)
+
+Environment (serve): AGENT_RUNNER_TOKEN, AGENT_RUNNER_PUBLIC_URL, PORT,
+  AGENT_RUNNER_JOB_PROVIDER, AGENT_RUNNER_CAPTURE_PROVIDER (local|steel|kernel),
+  STEEL_API_URL, STEEL_API_KEY, KERNEL_API_KEY, AGENT_RUNNER_CAPTURE_TTL_MS, AGENT_RUNNER_PACING`);
+}
+function readJob(str) {
+    const file = str('session');
+    const platform = str('platform');
+    if (!file || !platform) {
+        throw new Error('--platform and --session are required');
+    }
+    return {
+        platform,
+        session: JSON.parse((0, node_fs_1.readFileSync)(file, 'utf8')),
+        workspaceId: str('workspace', 'cli'),
+        accountId: str('account', 'cli'),
+        sessionOut: str('session-out'),
+        out: str('out'),
+    };
+}
+function readContent(str) {
+    const file = str('content');
+    if (file) {
+        return JSON.parse((0, node_fs_1.readFileSync)(file, 'utf8'));
+    }
+    const text = str('text');
+    if (!text)
+        throw new Error('--text (or --content <file.json>) is required');
+    const media = str('media');
+    return {
+        text,
+        mediaUrls: media ? media.split(',').filter(Boolean) : undefined,
+        link: str('link'),
+    };
+}
+function emit(job, result) {
+    const { refreshedSession, ...rest } = result;
+    if (refreshedSession && job.sessionOut) {
+        (0, node_fs_1.writeFileSync)(job.sessionOut, JSON.stringify(refreshedSession), 'utf8');
+    }
+    const printable = {
+        ...rest,
+        refreshedSession: refreshedSession
+            ? job.sessionOut
+                ? `<written to ${job.sessionOut}>`
+                : '<omitted>'
+            : undefined,
+    };
+    const text = JSON.stringify(printable, null, 2);
+    if (job.out)
+        (0, node_fs_1.writeFileSync)(job.out, text, 'utf8');
+    console.log(text);
+}
+async function localPoster(job, strategiesSpec, pacing) {
+    if (!strategiesSpec) {
+        throw new Error('--local requires --strategies <module>');
+    }
+    const key = { workspaceId: job.workspaceId, accountId: job.accountId };
+    const store = new stores_1.InMemorySessionStore([[key, job.session]]);
+    const poster = new poster_1.AgentPoster(new playwright_1.LocalBrowserSessionProvider(), store, {
+        pacing,
+    });
+    for (const s of await loadStrategies(strategiesSpec))
+        poster.register(s);
+    return { poster, store };
+}
+function refreshedFrom(store, job) {
+    const key = { workspaceId: job.workspaceId, accountId: job.accountId };
+    const state = store.peek(key);
+    return state && state !== job.session ? state : undefined;
+}
+async function main() {
+    const { cmd, flags } = parse(process.argv.slice(2));
+    const str = (k, fallback) => typeof flags[k] === 'string' ? flags[k] : fallback;
+    if (cmd === 'version' || flags.version === true) {
+        console.log((0, attribution_1.packageVersion)());
+        return;
+    }
+    if (cmd === 'serve') {
+        const spec = str('strategies');
+        if (!spec)
+            throw new Error('--strategies <module> is required');
+        (0, service_1.startRunner)({ strategies: await loadStrategies(spec) });
+        return;
+    }
+    if (cmd !== 'health' && cmd !== 'probe' && cmd !== 'post') {
+        usage();
+        if (cmd !== 'help')
+            process.exitCode = 1;
+        return;
+    }
+    const local = flags.local === true;
+    const pacing = process.env.AGENT_RUNNER_PACING !== 'false';
+    if (cmd === 'health') {
+        const client = new runner_client_1.AgentRunnerClient({
+            baseUrl: str('url', process.env.AGENT_RUNNER_URL || 'http://localhost:8080'),
+            token: str('token', process.env.AGENT_RUNNER_TOKEN || ''),
+        });
+        console.log(JSON.stringify(await client.health(), null, 2));
+        return;
+    }
+    const job = readJob(str);
+    const ident = {
+        workspaceId: job.workspaceId,
+        accountId: job.accountId,
+        platform: job.platform,
+    };
+    if (local) {
+        const { poster, store } = await localPoster(job, str('strategies'), pacing);
+        if (cmd === 'probe') {
+            const res = await poster.probe(ident);
+            emit(job, { ...res, refreshedSession: refreshedFrom(store, job) });
+            if (!res.authenticated)
+                process.exitCode = 2;
+            return;
+        }
+        const res = await poster.post({
+            ...ident,
+            content: readContent(str),
+        });
+        emit(job, { ...res, refreshedSession: refreshedFrom(store, job) });
+        if (!res.ok)
+            process.exitCode = res.uncertain ? 3 : 2;
+        return;
+    }
+    const client = new runner_client_1.AgentRunnerClient({
+        baseUrl: str('url', process.env.AGENT_RUNNER_URL || 'http://localhost:8080'),
+        token: str('token', process.env.AGENT_RUNNER_TOKEN || ''),
+    });
+    if (cmd === 'probe') {
+        const res = await client.probe({ ...ident, session: job.session });
+        emit(job, res);
+        if (!res.authenticated)
+            process.exitCode = 2;
+        return;
+    }
+    const res = await client.post({
+        ...ident,
+        jobId: str('job-id', `cli-${Date.now()}`),
+        session: job.session,
+        content: readContent(str),
+    });
+    emit(job, res);
+    if (!res.ok)
+        process.exitCode = res.uncertain ? 3 : 2;
+}
+if (require.main === module) {
+    main().catch((err) => {
+        console.error(err instanceof Error ? err.message : err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Playwright-free entry point for orchestrators (serverless functions,
+ * queue workers) that call a running agent runner over HTTP.
+ */
+export type { AgentPostContent, AgentPostFailureStage, AgentPostResult, AgentPostVerification, AgentSessionState, StorageState, } from '../core/types';
+export type { PlatformId } from '../platform';
+export * from '../protocol';
+export { AgentRunnerClient, type AgentRunnerClientOptions, AgentRunnerError, } from './runner-client';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Playwright-free entry point for orchestrators (serverless functions,
+ * queue workers) that call a running agent runner over HTTP.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRunnerError = exports.AgentRunnerClient = void 0;
+__exportStar(require("../protocol"), exports);
+var runner_client_1 = require("./runner-client");
+Object.defineProperty(exports, "AgentRunnerClient", { enumerable: true, get: function () { return runner_client_1.AgentRunnerClient; } });
+Object.defineProperty(exports, "AgentRunnerError", { enumerable: true, get: function () { return runner_client_1.AgentRunnerError; } });
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAWH,8CAA4B;AAC5B,iDAIyB;AAHvB,kHAAA,iBAAiB,OAAA;AAEjB,iHAAA,gBAAgB,OAAA"}

package/dist/client/runner-client.d.ts

@@ -0,0 +1,41 @@
+/**
+ * HTTP client for the agent runner service, for orchestrators such as
+ * serverless functions or queue workers.
+ *
+ * Deliberately free of Playwright imports so it can be bundled anywhere.
+ * Auth is a shared bearer token (`AGENT_RUNNER_TOKEN`) kept in a secret
+ * manager on both sides.
+ */
+import { type RunnerCaptureFinishRequest, type RunnerCaptureFinishResponse, type RunnerCaptureStartRequest, type RunnerCaptureStartResponse, type RunnerPostRequest, type RunnerPostResponse, type RunnerProbeRequest, type RunnerProbeResponse } from '../protocol';
+export type AgentRunnerClientOptions = {
+    baseUrl: string;
+    token: string;
+    /** Per-request timeout; posting with media can take a while. */
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+};
+export declare class AgentRunnerError extends Error {
+    readonly status: number;
+    readonly transient: boolean;
+    constructor(message: string, status: number, transient: boolean);
+}
+export declare class AgentRunnerClient {
+    private opts;
+    private readonly fetchImpl;
+    private readonly baseUrl;
+    constructor(opts: AgentRunnerClientOptions);
+    static isConfigured(env: {
+        AGENT_RUNNER_URL?: string;
+        AGENT_RUNNER_TOKEN?: string;
+    }): boolean;
+    post(req: RunnerPostRequest): Promise<RunnerPostResponse>;
+    probe(req: RunnerProbeRequest): Promise<RunnerProbeResponse>;
+    captureStart(req: RunnerCaptureStartRequest): Promise<RunnerCaptureStartResponse>;
+    captureFinish(req: RunnerCaptureFinishRequest): Promise<RunnerCaptureFinishResponse>;
+    captureCancel(req: RunnerCaptureFinishRequest): Promise<{
+        ok: true;
+    }>;
+    health(): Promise<boolean>;
+    private call;
+}
+//# sourceMappingURL=runner-client.d.ts.map

package/dist/client/runner-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-client.d.ts","sourceRoot":"","sources":["../../src/client/runner-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,KAAK;IAGvC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO;IAH7B,YACE,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,OAAO,EAI5B;CACF;AAED,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,IAAI;IAHxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,YAAoB,IAAI,EAAE,wBAAwB,EAGjD;IAED,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,GAAG,OAAO,CAEV;IAED,IAAI,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAExD;IAED,KAAK,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAE3D;IAED,YAAY,CACV,GAAG,EAAE,yBAAyB,GAC7B,OAAO,CAAC,0BAA0B,CAAC,CAKrC;IAED,aAAa,CACX,GAAG,EAAE,0BAA0B,GAC9B,OAAO,CAAC,2BAA2B,CAAC,CAKtC;IAED,aAAa,CAAC,GAAG,EAAE,0BAA0B,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,CAAC,CAEpE;IAEK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAS/B;YAEa,IAAI;CAwCnB"}

package/dist/client/runner-client.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * HTTP client for the agent runner service, for orchestrators such as
+ * serverless functions or queue workers.
+ *
+ * Deliberately free of Playwright imports so it can be bundled anywhere.
+ * Auth is a shared bearer token (`AGENT_RUNNER_TOKEN`) kept in a secret
+ * manager on both sides.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRunnerClient = exports.AgentRunnerError = void 0;
+const protocol_1 = require("../protocol");
+class AgentRunnerError extends Error {
+    status;
+    transient;
+    constructor(message, status, transient) {
+        super(message);
+        this.status = status;
+        this.transient = transient;
+        this.name = 'AgentRunnerError';
+    }
+}
+exports.AgentRunnerError = AgentRunnerError;
+class AgentRunnerClient {
+    opts;
+    fetchImpl;
+    baseUrl;
+    constructor(opts) {
+        this.opts = opts;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, '');
+    }
+    static isConfigured(env) {
+        return Boolean(env.AGENT_RUNNER_URL && env.AGENT_RUNNER_TOKEN);
+    }
+    post(req) {
+        return this.call(protocol_1.RUNNER_ROUTES.post, req);
+    }
+    probe(req) {
+        return this.call(protocol_1.RUNNER_ROUTES.probe, req);
+    }
+    captureStart(req) {
+        return this.call(protocol_1.RUNNER_ROUTES.captureStart, req);
+    }
+    captureFinish(req) {
+        return this.call(protocol_1.RUNNER_ROUTES.captureFinish, req);
+    }
+    captureCancel(req) {
+        return this.call(protocol_1.RUNNER_ROUTES.captureCancel, req);
+    }
+    async health() {
+        try {
+            const res = await this.fetchImpl(`${this.baseUrl}${protocol_1.RUNNER_ROUTES.health}`);
+            return res.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    async call(path, body) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.opts.timeoutMs ?? 180_000);
+        let res;
+        try {
+            res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.opts.token}`,
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        catch (e) {
+            throw new AgentRunnerError(e instanceof Error
+                ? `Agent runner unreachable: ${e.message}`
+                : 'Agent runner unreachable', 0, true);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const text = await res.text();
+        if (!res.ok) {
+            let message = text || `Agent runner error ${res.status}`;
+            try {
+                message = JSON.parse(text).error || message;
+            }
+            catch {
+                // plain text body
+            }
+            throw new AgentRunnerError(message, res.status, res.status >= 500);
+        }
+        return JSON.parse(text);
+    }
+}
+exports.AgentRunnerClient = AgentRunnerClient;
+//# sourceMappingURL=runner-client.js.map

package/dist/client/runner-client.js.map

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

package/dist/core/capture.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Interactive session capture.
+ *
+ * The user signs in to the platform inside a live-view browser we control
+ * (Steel live view in production, a headed local Chromium in development).
+ * When they are done, we probe authentication and export `storageState`.
+ * Passwords never pass through the runtime; only the resulting cookies do.
+ *
+ * Captures are stateful (a browser stays open while the user types), so the
+ * manager keeps them in memory keyed by an unguessable capture id and
+ * expires them after `ttlMs`.
+ */
+import type { PlatformId } from '../platform';
+import type { AgentSessionState, SessionProvider, WebPostStrategy } from './types';
+export type CaptureStart = {
+    captureId: string;
+    /** Provider live view URL (absolute). Undefined for headless providers. */
+    liveViewUrl?: string;
+    expiresAt: string;
+};
+export type CaptureFinish = {
+    ok: true;
+    state: AgentSessionState;
+} | {
+    ok: false;
+    error: string;
+    notAuthenticated?: boolean;
+};
+export declare class SessionCaptureManager {
+    private provider;
+    private opts;
+    private active;
+    private strategies;
+    constructor(provider: SessionProvider, opts?: {
+        ttlMs?: number;
+    });
+    register(strategy: WebPostStrategy): this;
+    get size(): number;
+    start(input: {
+        platform: PlatformId;
+        userAgent?: string;
+    }): Promise<CaptureStart>;
+    /** Probe auth and export cookies; always releases the browser. */
+    finish(captureId: string): Promise<CaptureFinish>;
+    cancel(captureId: string): Promise<void>;
+    /** Live view URL for an active capture (used by the runner's proxy). */
+    liveViewUrlFor(captureId: string): string | undefined;
+    disposeAll(): Promise<void>;
+}
+//# sourceMappingURL=capture.d.ts.map

package/dist/core/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/core/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAEV,iBAAiB,EACjB,eAAe,EACf,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAS7D,qBAAa,qBAAqB;IAK9B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,IAAI;IALd,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,UAAU,CAA0C;IAE5D,YACU,QAAQ,EAAE,eAAe,EACzB,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,EACnC;IAEJ,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAGxC;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,KAAK,CAAC,KAAK,EAAE;QACjB,QAAQ,EAAE,UAAU,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuCxB;IAED,kEAAkE;IAC5D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAsCtD;IAEK,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7C;IAED,wEAAwE;IACxE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpD;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhC;CACF"}

package/dist/core/capture.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * Interactive session capture.
+ *
+ * The user signs in to the platform inside a live-view browser we control
+ * (Steel live view in production, a headed local Chromium in development).
+ * When they are done, we probe authentication and export `storageState`.
+ * Passwords never pass through the runtime; only the resulting cookies do.
+ *
+ * Captures are stateful (a browser stays open while the user types), so the
+ * manager keeps them in memory keyed by an unguessable capture id and
+ * expires them after `ttlMs`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionCaptureManager = void 0;
+const node_crypto_1 = require("node:crypto");
+class SessionCaptureManager {
+    provider;
+    opts;
+    active = new Map();
+    strategies = new Map();
+    constructor(provider, opts = {}) {
+        this.provider = provider;
+        this.opts = opts;
+    }
+    register(strategy) {
+        this.strategies.set(strategy.platform, strategy);
+        return this;
+    }
+    get size() {
+        return this.active.size;
+    }
+    async start(input) {
+        const strategy = this.strategies.get(input.platform);
+        if (!strategy) {
+            throw new Error(`No agentic strategy registered for ${input.platform}`);
+        }
+        const handle = await this.provider.acquire({
+            platform: input.platform,
+            interactive: true,
+            state: input.userAgent
+                ? {
+                    platform: input.platform,
+                    storageState: { cookies: [], origins: [] },
+                    userAgent: input.userAgent,
+                    capturedAt: new Date().toISOString(),
+                }
+                : undefined,
+        });
+        const page = await handle.context.newPage();
+        await page
+            .goto(strategy.loginUrl, { waitUntil: 'domcontentloaded' })
+            .catch(() => undefined);
+        const captureId = (0, node_crypto_1.randomBytes)(24).toString('base64url');
+        const ttl = this.opts.ttlMs ?? 20 * 60_000;
+        const expiresAt = Date.now() + ttl;
+        const timer = setTimeout(() => {
+            this.cancel(captureId).catch(() => undefined);
+        }, ttl);
+        this.active.set(captureId, {
+            platform: input.platform,
+            handle,
+            expiresAt,
+            timer,
+        });
+        return {
+            captureId,
+            liveViewUrl: handle.liveViewUrl,
+            expiresAt: new Date(expiresAt).toISOString(),
+        };
+    }
+    /** Probe auth and export cookies; always releases the browser. */
+    async finish(captureId) {
+        const entry = this.active.get(captureId);
+        if (!entry) {
+            return { ok: false, error: 'Capture not found or expired' };
+        }
+        this.active.delete(captureId);
+        clearTimeout(entry.timer);
+        const strategy = this.strategies.get(entry.platform);
+        try {
+            if (!strategy ||
+                !(await strategy.isAuthenticated(entry.handle.context))) {
+                return {
+                    ok: false,
+                    notAuthenticated: true,
+                    error: 'Sign-in not detected yet — finish signing in and try again',
+                };
+            }
+            const storageState = await entry.handle.exportState();
+            const authCookieExpiry = storageState.cookies
+                .map((c) => c.expires)
+                .filter((e) => e > 0)
+                .sort((a, b) => a - b)[0];
+            return {
+                ok: true,
+                state: {
+                    platform: entry.platform,
+                    storageState,
+                    capturedAt: new Date().toISOString(),
+                    expiresHint: authCookieExpiry
+                        ? new Date(authCookieExpiry * 1000).toISOString()
+                        : undefined,
+                },
+            };
+        }
+        finally {
+            await entry.handle.dispose();
+        }
+    }
+    async cancel(captureId) {
+        const entry = this.active.get(captureId);
+        if (!entry) {
+            return;
+        }
+        this.active.delete(captureId);
+        clearTimeout(entry.timer);
+        await entry.handle.dispose();
+    }
+    /** Live view URL for an active capture (used by the runner's proxy). */
+    liveViewUrlFor(captureId) {
+        return this.active.get(captureId)?.handle.liveViewUrl;
+    }
+    async disposeAll() {
+        await Promise.all([...this.active.keys()].map((id) => this.cancel(id)));
+    }
+}
+exports.SessionCaptureManager = SessionCaptureManager;
+//# sourceMappingURL=capture.js.map

package/dist/core/capture.js.map

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