import type { Server } from "node:http"; import express from "express"; import { loadConfig } from "../config/config.js"; import { createSubsystemLogger } from "../logging/subsystem.js"; import { resolveBrowserConfig } from "./config.js"; import { ensureBrowserControlAuth, resolveBrowserControlAuth } from "./control-auth.js"; import { isPwAiLoaded } from "./pw-ai-state.js"; import { registerBrowserRoutes } from "./routes/index.js"; import type { BrowserRouteRegistrar } from "./routes/types.js"; import { type BrowserServerState, createBrowserRouteContext } from "./server-context.js"; import { ensureExtensionRelayForProfiles, stopKnownBrowserProfiles } from "./server-lifecycle.js"; import { installBrowserAuthMiddleware, installBrowserCommonMiddleware, } from "./server-middleware.js"; let state: BrowserServerState | null = null; const log = createSubsystemLogger("browser"); const logServer = log.child("server"); export async function startBrowserControlServerFromConfig(): Promise { if (state) { return state; } const cfg = loadConfig(); const resolved = resolveBrowserConfig(cfg.browser, cfg); if (!resolved.enabled) { return null; } let browserAuth = resolveBrowserControlAuth(cfg); let browserAuthBootstrapFailed = false; try { const ensured = await ensureBrowserControlAuth({ cfg }); browserAuth = ensured.auth; if (ensured.generatedToken) { logServer.info("No browser auth configured; generated gateway.auth.token automatically."); } } catch (err) { logServer.warn(`failed to auto-configure browser auth: ${String(err)}`); browserAuthBootstrapFailed = true; } // Fail closed: if auth bootstrap failed and no explicit auth is available, // do not start the browser control HTTP server. if (browserAuthBootstrapFailed && !browserAuth.token && !browserAuth.password) { logServer.error( "browser control startup aborted: authentication bootstrap failed and no fallback auth is configured.", ); return null; } const app = express(); installBrowserCommonMiddleware(app); installBrowserAuthMiddleware(app, browserAuth); const ctx = createBrowserRouteContext({ getState: () => state, refreshConfigFromDisk: true, }); registerBrowserRoutes(app as unknown as BrowserRouteRegistrar, ctx); const port = resolved.controlPort; const server = await new Promise((resolve, reject) => { const s = app.listen(port, "127.0.0.1", () => resolve(s)); s.once("error", reject); }).catch((err) => { logServer.error(`openclaw browser server failed to bind 127.0.0.1:${port}: ${String(err)}`); return null; }); if (!server) { return null; } state = { server, port, resolved, profiles: new Map(), }; await ensureExtensionRelayForProfiles({ resolved, onWarn: (message) => logServer.warn(message), }); const authMode = browserAuth.token ? "token" : browserAuth.password ? "password" : "off"; logServer.info(`Browser control listening on http://127.0.0.1:${port}/ (auth=${authMode})`); return state; } export async function stopBrowserControlServer(): Promise { const current = state; if (!current) { return; } await stopKnownBrowserProfiles({ getState: () => state, onWarn: (message) => logServer.warn(message), }); if (current.server) { await new Promise((resolve) => { current.server?.close(() => resolve()); }); } state = null; // Optional: avoid importing heavy Playwright bridge when this process never used it. if (isPwAiLoaded()) { try { const mod = await import("./pw-ai.js"); await mod.closePlaywrightBrowserConnection(); } catch { // ignore } } }