arise-browser 0.1.0

package/dist/src/server/routes/upload.d.ts

@@ -0,0 +1,3 @@
+import type { FastifyInstance } from "fastify";
+export declare function registerUploadRoute(app: FastifyInstance): void;
+//# sourceMappingURL=upload.d.ts.map

package/dist/src/server/routes/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../../src/server/routes/upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAC;AAW/D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,QAyCvD"}

package/dist/src/server/routes/upload.js

@@ -0,0 +1,38 @@
+import { getTabWriteConflict, sendRouteError, sendTabLocked } from "../route-utils.js";
+export function registerUploadRoute(app) {
+    app.post("/upload", async (request, reply) => {
+        const session = app.session;
+        const { ref, filePath, tabId, owner } = request.body || {};
+        if (!ref || !filePath) {
+            return reply.code(400).send({ error: "ref and filePath are required" });
+        }
+        const conflict = getTabWriteConflict(session, { tabId, owner });
+        if (conflict) {
+            return sendTabLocked(reply, conflict);
+        }
+        try {
+            const page = await session.getPageForTab(tabId);
+            if (!page || page.isClosed()) {
+                return reply.code(400).send({ error: "No active page" });
+            }
+            const target = `[aria-ref='${ref.replace(/['"\\]/g, "")}']`;
+            const fileInput = page.locator(target);
+            if ((await fileInput.count()) === 0) {
+                return reply.code(404).send({ error: "File input element not found" });
+            }
+            const inputMeta = await fileInput.first().evaluate((node) => ({
+                tagName: node.tagName.toLowerCase(),
+                inputType: node instanceof HTMLInputElement ? node.type.toLowerCase() : "",
+            }));
+            if (inputMeta.tagName !== "input" || inputMeta.inputType !== "file") {
+                return reply.code(400).send({ error: "Target element is not an <input type=\"file\">" });
+            }
+            await fileInput.setInputFiles(filePath);
+            return { success: true, ref, filePath, tabId };
+        }
+        catch (e) {
+            return sendRouteError(reply, e, "Upload failed");
+        }
+    });
+}
+//# sourceMappingURL=upload.js.map

package/dist/src/server/routes/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../../../src/server/routes/upload.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AASvF,MAAM,UAAU,mBAAmB,CAAC,GAAoB;IACtD,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,OAA6C,EAAE,KAAK,EAAE,EAAE;QACjF,MAAM,OAAO,GAAI,GAAW,CAAC,OAAyB,CAAC;QACvD,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,IAAI,EAAgB,CAAC;QAEzE,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;gBAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAC3D,CAAC;YAED,MAAM,MAAM,GAAG,cAAc,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC;YAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAEvC,IAAI,CAAC,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC;gBACrE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE;gBACnC,SAAS,EAAE,IAAI,YAAY,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;aAC3E,CAAC,CAAC,CAAC;YACJ,IAAI,SAAS,CAAC,OAAO,KAAK,OAAO,IAAI,SAAS,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;gBACpE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gDAAgD,EAAE,CAAC,CAAC;YAC3F,CAAC;YAED,MAAM,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,cAAc,CAAC,KAAK,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * AriseBrowser HTTP server — Fastify-based, Pinchtab-compatible API.
+ */
+import { type FastifyInstance } from "fastify";
+import type { AriseBrowserConfig, ServerConfig } from "../types/index.js";
+export declare function createServer(browserConfig: AriseBrowserConfig, serverConfig?: ServerConfig): Promise<FastifyInstance>;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/server/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAGxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAsB1E,wBAAsB,YAAY,CAChC,aAAa,EAAE,kBAAkB,EACjC,YAAY,GAAE,YAAiB,GAC9B,OAAO,CAAC,eAAe,CAAC,CA+C1B"}

package/dist/src/server/server.js

@@ -0,0 +1,69 @@
+/**
+ * AriseBrowser HTTP server — Fastify-based, Pinchtab-compatible API.
+ */
+import { randomUUID } from "node:crypto";
+import Fastify from "fastify";
+import { BrowserSession } from "../browser/browser-session.js";
+import { createLogger } from "../logger.js";
+import { registerHealthRoute } from "./routes/health.js";
+import { registerTabsRoute } from "./routes/tabs.js";
+import { registerNavigateRoute } from "./routes/navigate.js";
+import { registerSnapshotRoute } from "./routes/snapshot.js";
+import { registerActionRoute } from "./routes/action.js";
+import { registerActionsRoute } from "./routes/actions.js";
+import { registerTextRoute } from "./routes/text.js";
+import { registerPageModelRoute } from "./routes/page-model.js";
+import { registerScreenshotRoute } from "./routes/screenshot.js";
+import { registerPdfRoute } from "./routes/pdf.js";
+import { registerEvaluateRoute } from "./routes/evaluate.js";
+import { registerTabRoute } from "./routes/tab.js";
+import { registerTabLockRoute } from "./routes/tab-lock.js";
+import { registerCookiesRoute } from "./routes/cookies.js";
+import { registerUploadRoute } from "./routes/upload.js";
+import { registerDownloadRoute } from "./routes/download.js";
+import { registerRecordingRoutes } from "./routes/recording.js";
+import { authMiddleware } from "./middleware/auth.js";
+const logger = createLogger("server");
+export async function createServer(browserConfig, serverConfig = {}) {
+    const app = Fastify({ logger: false });
+    // Auth middleware
+    const token = serverConfig.token
+        || process.env.ARISE_BROWSER_TOKEN
+        || process.env.BRIDGE_TOKEN;
+    if (token) {
+        app.addHook("onRequest", authMiddleware(token));
+    }
+    else {
+        logger.warn("No auth token configured — all endpoints are unauthenticated. Set ARISE_BROWSER_TOKEN to enable auth.");
+    }
+    // Create and attach browser session
+    const session = BrowserSession.create(browserConfig, `server:${randomUUID()}`);
+    await session.ensureBrowser();
+    // Decorate with session reference
+    app.decorate("session", session);
+    // Register routes
+    registerHealthRoute(app);
+    registerTabsRoute(app);
+    registerNavigateRoute(app);
+    registerSnapshotRoute(app);
+    registerActionRoute(app);
+    registerActionsRoute(app);
+    registerTextRoute(app);
+    registerPageModelRoute(app);
+    registerScreenshotRoute(app);
+    registerPdfRoute(app);
+    registerEvaluateRoute(app);
+    registerTabRoute(app);
+    registerTabLockRoute(app);
+    registerCookiesRoute(app);
+    registerUploadRoute(app);
+    registerDownloadRoute(app);
+    registerRecordingRoutes(app);
+    // Cleanup on close
+    app.addHook("onClose", async () => {
+        logger.info("Shutting down browser session");
+        await session.close();
+    });
+    return app;
+}
+//# sourceMappingURL=server.js.map

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

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

package/dist/src/types/index.d.ts

@@ -0,0 +1,125 @@
+/**
+ * AriseBrowser public type definitions.
+ */
+export interface AriseBrowserConfig {
+    /** Connection mode:
+     * - 'standalone': Launch new Chromium (default)
+     * - 'cdp': Connect to existing browser via CDP
+     * - 'managed': Persistent browser profile
+     */
+    mode: "standalone" | "cdp" | "managed";
+    /** CDP endpoint URL (required for 'cdp' mode) */
+    cdpUrl?: string;
+    /** Run headless (standalone/managed mode, default true) */
+    headless?: boolean;
+    /** Profile directory (managed mode) */
+    profileDir?: string;
+    /** Viewport size */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Custom user agent */
+    userAgent?: string;
+    /** Apply safe stealth context options (default true) */
+    stealthHeaders?: boolean;
+    /** Virtual display mode (Linux server) */
+    virtualDisplay?: {
+        enabled: boolean;
+        display?: string;
+        screen?: string;
+        nekoPort?: number;
+        nekoPassword?: string;
+        nekoAdminPassword?: string;
+        chromeDebugPort?: number;
+        chromePath?: string;
+    };
+}
+export type ActionDict = Record<string, unknown>;
+export interface ActionResult {
+    success: boolean;
+    message: string;
+    details: Record<string, unknown>;
+}
+export interface TabInfo {
+    tab_id: string;
+    url: string;
+    title: string;
+    is_current: boolean;
+}
+export interface SessionRef {
+    getTabInfo(): Promise<TabInfo[]>;
+    switchToTab(tabId: string): Promise<boolean>;
+}
+export interface RecordedOperation {
+    type: string;
+    timestamp: string;
+    url?: string;
+    ref?: string;
+    text?: string;
+    role?: string;
+    value?: string;
+    tab_id?: string;
+    direction?: string;
+    amount?: number;
+    request_url?: string;
+    method?: string;
+    status?: number;
+    [key: string]: unknown;
+}
+export interface RecordingResult {
+    session_id: string;
+    operations: RecordedOperation[];
+    operations_count: number;
+    snapshots: Record<string, SnapshotRecord>;
+}
+export interface SnapshotRecord {
+    url: string;
+    snapshot_text?: string;
+    simple?: Record<string, unknown>;
+    captured_at: string;
+}
+export interface SnapshotResult {
+    snapshotText: string;
+    elements: Record<string, unknown>;
+    metadata?: {
+        refDebug?: {
+            weakmapHit?: number;
+            ariaRefHit?: number;
+            signatureHit?: number;
+            newRef?: number;
+            evicted?: number;
+        };
+        refCounterValue?: number;
+        totalMappedRefs?: number;
+    };
+}
+export interface ServerConfig {
+    port?: number;
+    host?: string;
+    token?: string;
+}
+export interface TabLock {
+    owner: string;
+    expiresAt: number;
+}
+export interface LearnData {
+    type: "browser_workflow";
+    task: string;
+    success: boolean;
+    source: string;
+    domain: string;
+    steps: LearnStep[];
+    metadata: {
+        duration_ms: number;
+        page_count: number;
+        recorded_at: string;
+    };
+}
+export interface LearnStep {
+    url: string;
+    action: string;
+    target?: string;
+    value?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

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

package/dist/src/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * AriseBrowser public type definitions.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/src/types/index.js.map

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

package/dist/src/virtual-display/manager.d.ts

@@ -0,0 +1,37 @@
+/**
+ * VirtualDisplayManager — manages Xvfb, PulseAudio, Openbox, Chrome, and Neko
+ * as child processes for Linux cloud server deployment.
+ *
+ * arise-browser is the single entry process; no supervisord needed.
+ */
+export interface VirtualDisplayConfig {
+    /** X11 display number (default ":99") */
+    display: string;
+    /** Screen resolution+depth (default "1920x1080x24") */
+    screen: string;
+    /** Neko HTTP/WS port (default 6090) */
+    nekoPort: number;
+    /** Neko user password (default "neko") */
+    nekoPassword: string;
+    /** Neko admin password (default "admin") */
+    nekoAdminPassword: string;
+    /** Chrome remote debugging port (default 9222) */
+    chromeDebugPort: number;
+    /** Path to Chrome binary (auto-detected if omitted) */
+    chromePath: string;
+}
+export declare class VirtualDisplayManager {
+    private _xvfb;
+    private _pulseaudio;
+    private _openbox;
+    private _chrome;
+    private _neko;
+    private _started;
+    private readonly _config;
+    constructor(config?: Partial<VirtualDisplayConfig>);
+    get config(): VirtualDisplayConfig;
+    isRunning(): boolean;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/src/virtual-display/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/virtual-display/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAmCD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;gBAEnC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAOlD,IAAI,MAAM,IAAI,oBAAoB,CAEjC;IAED,SAAS,IAAI,OAAO;IAId,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAiC5B"}

package/dist/src/virtual-display/manager.js

@@ -0,0 +1,229 @@
+/**
+ * VirtualDisplayManager — manages Xvfb, PulseAudio, Openbox, Chrome, and Neko
+ * as child processes for Linux cloud server deployment.
+ *
+ * arise-browser is the single entry process; no supervisord needed.
+ */
+import { existsSync } from "node:fs";
+import { resolve, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createLogger } from "../logger.js";
+import { ProcessRunner } from "./process-runner.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Find the package root by walking up from __dirname to find package.json.
+ * Works both in src/ (dev) and dist/ (compiled).
+ */
+function findPackageRoot() {
+    let dir = __dirname;
+    for (let i = 0; i < 5; i++) {
+        if (existsSync(join(dir, "package.json")))
+            return dir;
+        dir = dirname(dir);
+    }
+    // Fallback: assume 2 levels up from src/virtual-display or dist/src/virtual-display
+    return resolve(__dirname, "../..");
+}
+const DEFAULT_CONFIG = {
+    display: ":99",
+    screen: "1920x1080x24",
+    nekoPort: 6090,
+    nekoPassword: "neko",
+    nekoAdminPassword: "admin",
+    chromeDebugPort: 9222,
+    chromePath: "",
+};
+const CHROME_CANDIDATES = [
+    "/usr/bin/google-chrome-stable",
+    "/usr/bin/google-chrome",
+    "/usr/bin/chromium-browser",
+    "/usr/bin/chromium",
+];
+function findChrome() {
+    for (const candidate of CHROME_CANDIDATES) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    throw new Error(`Chrome not found. Tried: ${CHROME_CANDIDATES.join(", ")}. Install Chrome or set chromePath.`);
+}
+/** Resolve path to deploy/neko/ config files */
+function deployPath(filename) {
+    return resolve(findPackageRoot(), "deploy/neko", filename);
+}
+const log = createLogger("virtual-display");
+export class VirtualDisplayManager {
+    _xvfb = null;
+    _pulseaudio = null;
+    _openbox = null;
+    _chrome = null;
+    _neko = null;
+    _started = false;
+    _config;
+    constructor(config) {
+        this._config = { ...DEFAULT_CONFIG, ...config };
+        if (!this._config.chromePath) {
+            this._config.chromePath = findChrome();
+        }
+    }
+    get config() {
+        return { ...this._config };
+    }
+    isRunning() {
+        return this._started;
+    }
+    async start() {
+        if (this._started)
+            return;
+        const { display, screen, nekoPort, nekoPassword, nekoAdminPassword, chromeDebugPort, chromePath } = this._config;
+        // Extract display number: ":99" → "99", ":99.0" → "99"
+        const displayNum = display.replace(/^:/, "").split(".")[0];
+        const displayEnv = { DISPLAY: display };
+        log.info(`Starting virtual display environment (display=${display}, chrome=${chromePath}, neko=:${nekoPort})`);
+        try {
+            // 1. Xvfb
+            const xorgConf = deployPath("xorg.conf");
+            const xvfbArgs = [display, "-screen", "0", screen, "-nolisten", "tcp"];
+            if (existsSync(xorgConf)) {
+                xvfbArgs.push("-config", xorgConf);
+            }
+            this._xvfb = new ProcessRunner({
+                name: "xvfb",
+                command: "/usr/bin/Xvfb",
+                args: xvfbArgs,
+                readiness: {
+                    type: "file",
+                    target: `/tmp/.X11-unix/X${displayNum}`,
+                    timeoutMs: 10_000,
+                },
+            });
+            await this._xvfb.start();
+            // 2. PulseAudio
+            const pulseConf = deployPath("pulseaudio.pa");
+            this._pulseaudio = new ProcessRunner({
+                name: "pulseaudio",
+                command: "/usr/bin/pulseaudio",
+                args: [
+                    "--disallow-exit",
+                    "--disallow-module-loading",
+                    "-n",
+                    "-F",
+                    pulseConf,
+                    "--exit-idle-time=-1",
+                ],
+                readiness: {
+                    type: "file",
+                    target: "/tmp/pulseaudio.socket",
+                    timeoutMs: 10_000,
+                },
+            });
+            await this._pulseaudio.start();
+            // 3. Openbox
+            const openboxConf = deployPath("openbox.xml");
+            this._openbox = new ProcessRunner({
+                name: "openbox",
+                command: "/usr/bin/openbox",
+                args: existsSync(openboxConf)
+                    ? ["--config-file", openboxConf]
+                    : [],
+                env: displayEnv,
+            });
+            await this._openbox.start();
+            // Small delay for window manager to initialize
+            await new Promise((r) => setTimeout(r, 500));
+            // 4. Chrome
+            this._chrome = new ProcessRunner({
+                name: "chrome",
+                command: chromePath,
+                args: [
+                    `--remote-debugging-port=${chromeDebugPort}`,
+                    `--display=${display}`,
+                    "--window-position=0,0",
+                    "--no-first-run",
+                    "--start-maximized",
+                    "--bwsi",
+                    "--force-dark-mode",
+                    "--disable-file-system",
+                    "--disable-gpu",
+                    "--disable-software-rasterizer",
+                    "--disable-dev-shm-usage",
+                    "--no-sandbox",
+                    "--disable-setuid-sandbox",
+                ],
+                env: {
+                    ...displayEnv,
+                    PULSE_SERVER: "unix:/tmp/pulseaudio.socket",
+                },
+                readiness: {
+                    type: "http",
+                    target: `http://localhost:${chromeDebugPort}/json/version`,
+                    timeoutMs: 15_000,
+                },
+            });
+            await this._chrome.start();
+            // 5. Neko Server
+            this._neko = new ProcessRunner({
+                name: "neko",
+                command: "/usr/local/bin/neko",
+                args: ["serve", "--bind", `0.0.0.0:${nekoPort}`],
+                env: {
+                    ...displayEnv,
+                    PULSE_SERVER: "unix:/tmp/pulseaudio.socket",
+                    // Convert Xvfb format "1920x1080x24" → Neko format "1920x1080@30"
+                    NEKO_DESKTOP_SCREEN: screen.replace(/x\d+$/, "@30"),
+                    NEKO_MEMBER_PROVIDER: "multiuser",
+                    NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD: nekoAdminPassword,
+                    NEKO_MEMBER_MULTIUSER_USER_PASSWORD: nekoPassword,
+                    NEKO_SESSION_IMPLICIT_HOSTING: "true",
+                    NEKO_SESSION_MERCIFUL_RECONNECT: "true",
+                },
+                readiness: {
+                    type: "http",
+                    target: `http://localhost:${nekoPort}/health`,
+                    timeoutMs: 15_000,
+                    intervalMs: 500,
+                },
+            });
+            await this._neko.start();
+            this._started = true;
+            log.info("Virtual display environment started successfully");
+        }
+        catch (err) {
+            // Clean up any processes that started before the failure
+            log.error({ err }, "Failed to start virtual display environment, cleaning up");
+            this._started = true; // Allow stop() to run
+            await this.stop();
+            throw err;
+        }
+    }
+    async stop() {
+        if (!this._started)
+            return;
+        log.info("Stopping virtual display environment...");
+        // Stop in reverse order
+        const processes = [
+            this._neko,
+            this._chrome,
+            this._openbox,
+            this._pulseaudio,
+            this._xvfb,
+        ];
+        for (const proc of processes) {
+            if (proc) {
+                try {
+                    await proc.stop();
+                }
+                catch (err) {
+                    log.error({ err }, "Error stopping process");
+                }
+            }
+        }
+        this._neko = null;
+        this._chrome = null;
+        this._openbox = null;
+        this._pulseaudio = null;
+        this._xvfb = null;
+        this._started = false;
+        log.info("Virtual display environment stopped");
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/src/virtual-display/manager.js.map

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

package/dist/src/virtual-display/process-runner.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Child process runner with auto-restart, readiness detection,
+ * log integration, and graceful shutdown.
+ */
+export interface ReadinessCheck {
+    /** Wait for a file/socket to appear */
+    type: "file" | "http";
+    /** File path or HTTP URL */
+    target: string;
+    /** Max wait time in ms (default 10000) */
+    timeoutMs?: number;
+    /** Poll interval in ms (default 200) */
+    intervalMs?: number;
+}
+export interface ProcessRunnerConfig {
+    name: string;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    readiness?: ReadinessCheck;
+    maxRestarts?: number;
+    backoffMs?: number;
+    shutdownTimeoutMs?: number;
+}
+export declare class ProcessRunner {
+    private _process;
+    private _running;
+    private _restartCount;
+    private _intentionalStop;
+    private _restartScheduled;
+    private readonly _log;
+    private readonly _config;
+    constructor(config: ProcessRunnerConfig);
+    get running(): boolean;
+    get pid(): number | undefined;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private _spawn;
+    private _maybeRestart;
+    private _waitReady;
+    private _killProcess;
+}
+//# sourceMappingURL=process-runner.d.ts.map

package/dist/src/virtual-display/process-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-runner.d.ts","sourceRoot":"","sources":["../../../src/virtual-display/process-runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAElC,MAAM,EAAE,mBAAmB;IAKvC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAYb,MAAM;IAoDpB,OAAO,CAAC,aAAa;YA+BP,UAAU;YA0CV,YAAY;CAyC3B"}