libretto 0.6.7-experimental.0 → 0.6.8

package/src/cli/commands/setup.ts

@@ -27,6 +27,7 @@ const PROVIDER_SDK_PACKAGES: Record<Provider, string> = {
   anthropic: "@ai-sdk/anthropic",
   google: "@ai-sdk/google",
   vertex: "@ai-sdk/google-vertex",
+  openrouter: "@ai-sdk/openai",
 };
 
 function detectPackageManager(): string {
@@ -120,6 +121,13 @@ export const PROVIDER_CHOICES: ProviderChoice[] = [
     envHint:
       "Requires `gcloud auth application-default login` and a GCP project ID",
   },
+  {
+    key: "5",
+    label: "OpenRouter",
+    provider: "openrouter",
+    envVar: "OPENROUTER_API_KEY",
+    envHint: "Get your key at https://openrouter.ai/settings/keys",
+  },
 ];
 
 function promptUser(
@@ -169,7 +177,7 @@ function printHealthySummary(status: AiSetupStatus & { kind: "ready" }): void {
     console.log(`✓ Using ${providerLabel(status.provider)} (${status.model}).`);
   }
   console.log(
-    "To change: npx libretto ai configure openai | anthropic | gemini | vertex",
+    "To change: npx libretto ai configure openai | anthropic | gemini | vertex | openrouter",
   );
 }
 
@@ -267,7 +275,7 @@ function printSnapshotApiStatus(): boolean {
     "    GOOGLE_CLOUD_PROJECT=...  # plus application default credentials for Vertex",
   );
   console.log(
-    "  Or run `npx libretto ai configure openai | anthropic | gemini | vertex` to set a specific model.",
+    "  Or run `npx libretto ai configure openai | anthropic | gemini | vertex | openrouter` to set a specific model.",
   );
   console.log(
     "  Run `npx libretto setup` interactively to set up credentials.",
@@ -323,7 +331,7 @@ function printSkipMessage(): void {
   console.log("  ANTHROPIC_API_KEY=...");
   console.log("  GEMINI_API_KEY=...");
   console.log(
-    "  Or run `npx libretto ai configure openai | anthropic | gemini | vertex` to set a specific model.",
+    "  Or run `npx libretto ai configure openai | anthropic | gemini | vertex | openrouter` to set a specific model.",
   );
 }
 

package/src/cli/commands/status.ts

@@ -17,7 +17,7 @@ function printAiStatus(status: AiSetupStatus): void {
         console.log(`  Source: ${status.source}`);
       }
       console.log(
-        "  To change: npx libretto ai configure openai | anthropic | gemini | vertex",
+        "  To change: npx libretto ai configure openai | anthropic | gemini | vertex | openrouter",
       );
       break;
 

package/src/cli/core/ai-model.ts

@@ -1,12 +1,14 @@
-import { existsSync, readFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
 import { readSnapshotModel } from "./config.js";
-import { LIBRETTO_CONFIG_PATH, REPO_ROOT } from "./context.js";
+import { LIBRETTO_CONFIG_PATH } from "./context.js";
 import {
   hasProviderCredentials,
   parseModel,
   type Provider,
 } from "./resolve-model.js";
+import { loadEnv } from "../../shared/env/load-env.js";
+
+// Re-export so existing consumers (e.g. tests) don't break.
+export { parseDotEnvAssignment } from "../../shared/env/load-env.js";
 
 // ── Default models ──────────────────────────────────────────────────────────
 
@@ -15,6 +17,7 @@ export const DEFAULT_SNAPSHOT_MODELS = {
   anthropic: "anthropic/claude-sonnet-4-6",
   google: "google/gemini-3-flash-preview",
   vertex: "vertex/gemini-2.5-flash",
+  openrouter: "openrouter/free",
 } as const satisfies Record<Provider, string>;
 
 // ── Source detection ────────────────────────────────────────────────────────
@@ -42,6 +45,8 @@ function detectProviderEnvVar(
       if (env.GOOGLE_CLOUD_PROJECT?.trim()) return "GOOGLE_CLOUD_PROJECT";
       if (env.GCLOUD_PROJECT?.trim()) return "GCLOUD_PROJECT";
       return null;
+    case "openrouter":
+      return env.OPENROUTER_API_KEY?.trim() ? "OPENROUTER_API_KEY" : null;
   }
 }
 
@@ -70,11 +75,13 @@ function providerSetupSentence(provider: Provider): string {
       return "Add GEMINI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY to .env or as a shell environment variable.";
     case "vertex":
       return "Add GOOGLE_CLOUD_PROJECT or GCLOUD_PROJECT to .env or as a shell environment variable, and make sure application default credentials are configured.";
+    case "openrouter":
+      return "Add OPENROUTER_API_KEY to .env or as a shell environment variable.";
   }
 }
 
 function defaultModelCommandLine(): string {
-  return "npx libretto ai configure openai | anthropic | gemini | vertex";
+  return "npx libretto ai configure openai | anthropic | gemini | vertex | openrouter";
 }
 
 function providerMissingCredentialSummary(provider: Provider): string {
@@ -87,13 +94,15 @@ function providerMissingCredentialSummary(provider: Provider): string {
       return "GEMINI_API_KEY and GOOGLE_GENERATIVE_AI_API_KEY are missing";
     case "vertex":
       return "GOOGLE_CLOUD_PROJECT and GCLOUD_PROJECT are missing";
+    case "openrouter":
+      return "OPENROUTER_API_KEY is missing";
   }
 }
 
 function noSnapshotApiConfiguredMessage(): string {
   return [
     "Failed to analyze snapshot because no snapshot analyzer is configured.",
-    `Add OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY, or GOOGLE_CLOUD_PROJECT to .env or as a shell environment variable, or choose a default model with \`${defaultModelCommandLine()}\`.`,
+    `Add OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY, GOOGLE_CLOUD_PROJECT, or OPENROUTER_API_KEY to .env or as a shell environment variable, or choose a default model with \`${defaultModelCommandLine()}\`.`,
     "For more info, run `npx libretto setup`.",
   ].join(" ");
 }
@@ -112,88 +121,6 @@ function missingProviderSnapshotMessage(
   ].join(" ");
 }
 
-// ── Dotenv loading ──────────────────────────────────────────────────────────
-
-function readWorktreeEnvPath(): string | null {
-  const gitPath = join(REPO_ROOT, ".git");
-  if (!existsSync(gitPath)) return null;
-
-  try {
-    const gitPointer = readFileSync(gitPath, "utf-8").trim();
-    const match = gitPointer.match(/^gitdir:\s*(.+)$/i);
-    if (!match?.[1]) return null;
-    const worktreeGitDir = resolve(REPO_ROOT, match[1].trim());
-    const commonGitDir = resolve(worktreeGitDir, "..", "..");
-    return join(dirname(commonGitDir), ".env");
-  } catch {
-    return null;
-  }
-}
-
-export function loadSnapshotEnv(): void {
-  if (process.env.LIBRETTO_DISABLE_DOTENV?.trim() === "1") return;
-
-  const envPathCandidates = [
-    join(REPO_ROOT, ".env"),
-    readWorktreeEnvPath(),
-  ].filter((value): value is string => Boolean(value));
-
-  const envPath = envPathCandidates.find((candidate) => existsSync(candidate));
-  if (!envPath) return;
-
-  for (const line of readFileSync(envPath, "utf-8").split("\n")) {
-    const parsed = parseDotEnvAssignment(line);
-    if (!parsed) continue;
-    if (!(parsed.key in process.env)) {
-      process.env[parsed.key] = parsed.value;
-    }
-  }
-}
-
-export function parseDotEnvAssignment(
-  line: string,
-): { key: string; value: string } | null {
-  const trimmed = line.trim();
-  if (!trimmed || trimmed.startsWith("#")) return null;
-
-  const withoutExport = trimmed.startsWith("export ")
-    ? trimmed.slice("export ".length).trimStart()
-    : trimmed;
-  const eqIdx = withoutExport.indexOf("=");
-  if (eqIdx < 1) return null;
-
-  const key = withoutExport.slice(0, eqIdx).trim();
-  if (!key) return null;
-
-  const rawValue = withoutExport.slice(eqIdx + 1).trimStart();
-  if (!rawValue) {
-    return { key, value: "" };
-  }
-
-  if (rawValue.startsWith('"')) {
-    const closeIdx = rawValue.indexOf('"', 1);
-    if (closeIdx > 0) {
-      return { key, value: rawValue.slice(1, closeIdx) };
-    }
-    return { key, value: rawValue.slice(1) };
-  }
-
-  if (rawValue.startsWith("'")) {
-    const closeIdx = rawValue.indexOf("'", 1);
-    if (closeIdx > 0) {
-      return { key, value: rawValue.slice(1, closeIdx) };
-    }
-    return { key, value: rawValue.slice(1) };
-  }
-
-  const inlineCommentIndex = rawValue.search(/\s#/);
-  const value =
-    inlineCommentIndex >= 0
-      ? rawValue.slice(0, inlineCommentIndex).trimEnd()
-      : rawValue.trim();
-  return { key, value };
-}
-
 // ── Model resolution ────────────────────────────────────────────────────────
 
 function inferAutoSnapshotModel(): SnapshotApiModelSelection | null {
@@ -202,6 +129,7 @@ function inferAutoSnapshotModel(): SnapshotApiModelSelection | null {
     "anthropic",
     "google",
     "vertex",
+    "openrouter",
   ];
 
   for (const provider of providersInPriorityOrder) {
@@ -227,7 +155,7 @@ function inferAutoSnapshotModel(): SnapshotApiModelSelection | null {
 export function resolveSnapshotApiModel(
   snapshotModel: string | null = readSnapshotModel(),
 ): SnapshotApiModelSelection | null {
-  loadSnapshotEnv();
+  loadEnv();
 
   if (snapshotModel) {
     const { provider } = parseModel(snapshotModel);
@@ -318,7 +246,7 @@ function readSnapshotModelSafely(
 export function resolveAiSetupStatus(
   configPath: string = LIBRETTO_CONFIG_PATH,
 ): AiSetupStatus {
-  loadSnapshotEnv();
+  loadEnv();
 
   const result = readSnapshotModelSafely(configPath);
 

package/src/cli/core/browser-daemon.ts

@@ -0,0 +1,198 @@
+/**
+ * Browser daemon process.
+ *
+ * Launched as a detached child process by `runOpen()` in `browser.ts`.
+ * Receives configuration as a JSON string in `process.argv[2]`.
+ *
+ * Responsibilities:
+ * - Launch Chromium with the specified settings
+ * - Create a browser context and page
+ * - Install session telemetry (network/action logging)
+ * - Navigate to the requested URL
+ * - Stay alive until the browser disconnects or a signal is received
+ */
+
+import { chromium } from "playwright";
+import { mkdir, unlink } from "node:fs/promises";
+import { appendFileSync } from "node:fs";
+import { installSessionTelemetry } from "./session-telemetry.js";
+import {
+  getSessionDir,
+  getSessionLogsPath,
+  getSessionNetworkLogPath,
+  getSessionActionsLogPath,
+  getSessionStatePath,
+} from "./context.js";
+
+// ── Config schema ──────────────────────────────────────────────────────
+
+type DaemonConfig = {
+  port: number;
+  url: string;
+  session: string;
+  headed: boolean;
+  viewport: { width: number; height: number };
+  storageStatePath?: string;
+  windowPosition?: { x: number; y: number };
+};
+
+const config: DaemonConfig = JSON.parse(process.argv[2]);
+
+// ── Derived paths ──────────────────────────────────────────────────────
+
+const sessionDir = getSessionDir(config.session);
+await mkdir(sessionDir, { recursive: true });
+
+const logFile = getSessionLogsPath(config.session);
+const networkLogFile = getSessionNetworkLogPath(config.session);
+const actionsLogFile = getSessionActionsLogPath(config.session);
+
+type TelemetryEntry = Record<string, unknown>;
+
+function childLog(
+  level: string,
+  event: string,
+  data: Record<string, unknown> = {},
+): void {
+  const entry = JSON.stringify({
+    timestamp: new Date().toISOString(),
+    id: Math.random().toString(36).slice(2, 10),
+    level,
+    scope: "libretto.child",
+    event,
+    data,
+  });
+  appendFileSync(logFile, entry + "\n");
+}
+
+function logAction(entry: TelemetryEntry): void {
+  appendFileSync(actionsLogFile, JSON.stringify(entry) + "\n");
+}
+
+function logNetwork(entry: TelemetryEntry): void {
+  appendFileSync(networkLogFile, JSON.stringify(entry) + "\n");
+}
+
+// ── Launch browser ─────────────────────────────────────────────────────
+
+const windowPositionArg = config.windowPosition
+  ? `--window-position=${config.windowPosition.x},${config.windowPosition.y}`
+  : undefined;
+
+const launchArgs = [
+  "--disable-blink-features=AutomationControlled",
+  `--remote-debugging-port=${config.port}`,
+  "--remote-debugging-address=127.0.0.1",
+  "--no-focus-on-check",
+  ...(windowPositionArg ? [windowPositionArg] : []),
+];
+
+const browser = await chromium.launch({
+  headless: !config.headed,
+  args: launchArgs,
+});
+
+async function cleanupSessionState(): Promise<void> {
+  const sessionStatePath = getSessionStatePath(config.session);
+  try {
+    await unlink(sessionStatePath);
+  } catch (err) {
+    if ((err as NodeJS.ErrnoException).code !== "ENOENT") throw err;
+  }
+}
+
+let shuttingDown = false;
+let wakeDaemon: () => void;
+const sleepPromise = new Promise<void>((resolve) => {
+  wakeDaemon = resolve;
+});
+
+async function shutdown(
+  reason: string,
+  closeBrowser: boolean,
+): Promise<void> {
+  if (shuttingDown) return;
+  shuttingDown = true;
+  try {
+    childLog("info", reason, { port: config.port });
+    await cleanupSessionState();
+    if (closeBrowser) await browser.close();
+  } finally {
+    wakeDaemon();
+  }
+}
+
+browser.on("disconnected", () => {
+  void shutdown("browser-disconnected-exiting", false);
+});
+
+// ── Create context & page ──────────────────────────────────────────────
+
+const context = await browser.newContext({
+  ...(config.storageStatePath ? { storageState: config.storageStatePath } : {}),
+  viewport: {
+    width: config.viewport.width,
+    height: config.viewport.height,
+  },
+  userAgent:
+    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36",
+});
+
+const page = await context.newPage();
+
+// ── Page defaults & telemetry ──────────────────────────────────────────
+
+page.setDefaultTimeout(30000);
+page.setDefaultNavigationTimeout(45000);
+
+await installSessionTelemetry({
+  context,
+  initialPage: page,
+  includeUserDomActions: true,
+  logAction,
+  logNetwork,
+});
+
+// ── Navigate ───────────────────────────────────────────────────────────
+
+await page.goto(config.url);
+
+// ── Process lifecycle ──────────────────────────────────────────────────
+
+process.on("SIGTERM", () => {
+  void shutdown("child-sigterm", true);
+});
+
+process.on("SIGINT", () => {
+  void shutdown("child-sigint", true);
+});
+
+process.on("uncaughtException", (err) => {
+  childLog("error", "uncaught-exception", {
+    message: err.message,
+    stack: err.stack,
+  });
+  process.exit(1);
+});
+
+process.on("unhandledRejection", (reason) => {
+  childLog("warn", "unhandled-rejection", { reason: String(reason) });
+});
+
+process.on("exit", (code) => {
+  childLog("info", "child-exit", {
+    code,
+    pid: process.pid,
+    port: config.port,
+  });
+});
+
+childLog("info", "child-launched", {
+  port: config.port,
+  pid: process.pid,
+  session: config.session,
+});
+
+// Keep the daemon alive until the browser disconnects or a signal arrives.
+await sleepPromise;
+process.exit(0);

package/src/cli/core/browser.ts

@@ -5,27 +5,15 @@ import {
   type CDPSession,
   type Page,
 } from "playwright";
-import { openSync, existsSync, writeFileSync } from "node:fs";
-import { basename, dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { openSync, closeSync, existsSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { createRequire } from "node:module";
 import { createServer } from "node:net";
 import { spawn } from "node:child_process";
 import type { LoggerApi } from "../../shared/logger/index.js";
 import type { SessionAccessMode } from "../../shared/state/index.js";
-import {
-  filterSemanticClasses,
-  INTERACTIVE_ROLE_NAMES,
-  INTERACTIVE_TAG_NAMES,
-  isObfuscatedClass,
-  TEST_ATTRIBUTE_NAMES,
-  TRUSTED_ATTRIBUTE_NAMES,
-} from "../../shared/dom-semantics.js";
-import {
-  getSessionActionsLogPath,
-  getSessionNetworkLogPath,
-  PROFILES_DIR,
-} from "./context.js";
+import { PROFILES_DIR } from "./context.js";
 import { readLibrettoConfig } from "./config.js";
 import {
   assertSessionAvailableForStart,
@@ -39,7 +27,6 @@ import {
 } from "./session.js";
 import type { ProviderApi } from "./providers/types.js";
 import { getCloudProviderApi } from "./providers/index.js";
-import { installSessionTelemetry } from "./session-telemetry.js";
 
 const CLOSE_WAIT_MS = 1_500;
 const FORCE_CLOSE_WAIT_MS = 300;
@@ -434,8 +421,6 @@ export async function runOpen(
 
   const port = await pickFreePort();
   const runLogPath = logFileForSession(session);
-  const networkLogPath = getSessionNetworkLogPath(session);
-  const actionsLogPath = getSessionActionsLogPath(session);
 
   const browserMode = headed ? "headed" : "headless";
   const supportsSavedProfile =
@@ -459,178 +444,33 @@ export async function runOpen(
   }
   console.log(`Launching ${browserMode} browser (session: ${session})...`);
 
-  const escapedUrl = url.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
-  const storageStateCode = useProfile
-    ? `storageState: '${profilePath!
-        .replace(/\\/g, "\\\\")
-        .replace(/'/g, "\\'")}',`
-    : "";
-
-  const escapedLogPath = runLogPath.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
-  const escapedNetworkLogPath = networkLogPath
-    .replace(/\\/g, "\\\\")
-    .replace(/'/g, "\\'");
-  const escapedActionsLogPath = actionsLogPath
-    .replace(/\\/g, "\\\\")
-    .replace(/'/g, "\\'");
-  const windowPositionArg = windowPosition
-    ? `, '--window-position=${windowPosition.x},${windowPosition.y}'`
-    : "";
-  const windowBoundsSetupCode = windowPosition
-    ? `
-const requestedWindowBounds = { left: ${windowPosition.x}, top: ${windowPosition.y}, windowState: 'normal' };
-const pageCdp = await context.newCDPSession(page);
-let browserCdp;
-try {
-	const targetInfo = await pageCdp.send('Target.getTargetInfo');
-	const targetId = targetInfo?.targetInfo?.targetId;
-	browserCdp = await browser.newBrowserCDPSession();
-	const windowResult = await browserCdp.send(
-		'Browser.getWindowForTarget',
-		targetId ? { targetId } : {},
-	);
-	await browserCdp.send('Browser.setWindowBounds', {
-		windowId: windowResult.windowId,
-		bounds: requestedWindowBounds,
-	});
-	await new Promise((resolve) => setTimeout(resolve, 250));
-	const actualWindow = await browserCdp.send('Browser.getWindowBounds', {
-		windowId: windowResult.windowId,
-	});
-	childLog('info', 'window-bounds-set', {
-		windowId: windowResult.windowId,
-		requestedBounds: requestedWindowBounds,
-		actualBounds: actualWindow.bounds,
-	});
-} catch (error) {
-	childLog('warn', 'window-bounds-set-failed', {
-		requestedBounds: requestedWindowBounds,
-		message: error instanceof Error ? error.message : String(error),
-		stack: error instanceof Error ? error.stack : undefined,
-	});
-} finally {
-	await pageCdp.detach().catch(() => {});
-	if (browserCdp) {
-		await browserCdp.detach().catch(() => {});
-	}
-}
-`
-    : "";
-
-  const launcherCode = `
-import { chromium } from 'playwright';
-import { appendFileSync, mkdirSync } from 'node:fs';
-import { dirname } from 'node:path';
-
-const LOG_FILE = '${escapedLogPath}';
-const NETWORK_LOG = '${escapedNetworkLogPath}';
-const ACTIONS_LOG = '${escapedActionsLogPath}';
-mkdirSync(dirname(NETWORK_LOG), { recursive: true });
-
-// tsx/esbuild may emit __name() wrappers in Function#toString output.
-	const __name = (target, value) =>
-		Object.defineProperty(target, 'name', { value, configurable: true });
-
-	const TEST_ATTRIBUTE_NAMES = ${JSON.stringify([...TEST_ATTRIBUTE_NAMES])};
-	const TRUSTED_ATTRIBUTE_NAMES = ${JSON.stringify([...TRUSTED_ATTRIBUTE_NAMES])};
-	const INTERACTIVE_TAG_NAMES = ${JSON.stringify([...INTERACTIVE_TAG_NAMES])};
-	const INTERACTIVE_ROLE_NAMES = ${JSON.stringify([...INTERACTIVE_ROLE_NAMES])};
-	const filterSemanticClasses = ${filterSemanticClasses.toString()};
-	const isObfuscatedClass = ${isObfuscatedClass.toString()};
-
-	${installSessionTelemetry.toString()}
-
-	function logAction(entry) {
-		appendFileSync(ACTIONS_LOG, JSON.stringify(entry) + '\\n');
-	}
-
-function logNetwork(entry) {
-	appendFileSync(NETWORK_LOG, JSON.stringify(entry) + '\\n');
-}
-
-function childLog(level, event, data = {}) {
-	try {
-		const entry = JSON.stringify({
-			timestamp: new Date().toISOString(),
-			id: Math.random().toString(36).slice(2, 10),
-			level,
-			scope: 'libretto.child',
-			event,
-			data,
-		});
-		appendFileSync(LOG_FILE, entry + '\\n');
-	} catch {}
-}
-
-const browser = await chromium.launch({
-	headless: ${!headed},
-	args: ['--disable-blink-features=AutomationControlled', '--remote-debugging-port=${port}', '--remote-debugging-address=127.0.0.1', '--no-focus-on-check'${windowPositionArg}],
-});
-
-browser.on('disconnected', () => {
-	childLog('warn', 'browser-disconnected', { port: ${port} });
-});
-
-const context = await browser.newContext({
-	${storageStateCode}
-	viewport: { width: ${viewport.width}, height: ${viewport.height} },
-	userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36',
-});
-
-const page = await context.newPage();
-${windowBoundsSetupCode}
-page.setDefaultTimeout(30000);
-page.setDefaultNavigationTimeout(45000);
-
-await installSessionTelemetry({
-	context,
-	initialPage: page,
-	includeUserDomActions: true,
-	logAction,
-	logNetwork,
-});
-
-
-await page.goto('${escapedUrl}');
-
-process.on('SIGTERM', async () => {
-	childLog('info', 'child-sigterm');
-	await browser.close();
-	process.exit(0);
-});
-
-process.on('SIGINT', async () => {
-	childLog('info', 'child-sigint');
-	await browser.close();
-	process.exit(0);
-});
-
-process.on('uncaughtException', (err) => {
-	childLog('error', 'uncaught-exception', { message: err.message, stack: err.stack });
-	process.exit(1);
-});
-
-process.on('unhandledRejection', (reason) => {
-	childLog('warn', 'unhandled-rejection', { reason: String(reason) });
-});
-
-process.on('exit', (code) => {
-	childLog('info', 'child-exit', { code, pid: process.pid, port: ${port} });
-});
-
-childLog('info', 'child-launched', { port: ${port}, pid: process.pid, session: '${session}' });
-
-await new Promise(() => {});
-`;
+  const daemonEntryPath = fileURLToPath(
+    new URL("./browser-daemon.js", import.meta.url),
+  );
+  const require = createRequire(import.meta.url);
+  const tsxImportPath = pathToFileURL(require.resolve("tsx/esm")).href;
+  const daemonConfig = {
+    port,
+    url,
+    session,
+    headed,
+    viewport,
+    storageStatePath: useProfile ? profilePath : undefined,
+    windowPosition,
+  };
 
   const childStderrFd = openSync(runLogPath, "a");
 
-  const child = spawn("node", ["--input-type=module", "-e", launcherCode], {
-    detached: true,
-    stdio: ["ignore", "ignore", childStderrFd],
-    cwd: resolve(dirname(fileURLToPath(import.meta.url)), "../../.."),
-  });
+  const child = spawn(
+    process.execPath,
+    ["--import", tsxImportPath, daemonEntryPath, JSON.stringify(daemonConfig)],
+    {
+      detached: true,
+      stdio: ["ignore", "ignore", childStderrFd],
+    },
+  );
   child.unref();
+  closeSync(childStderrFd);
 
   logger.info("open-child-spawned", { pid: child.pid, port, session });
 

package/src/cli/core/config.ts

@@ -67,7 +67,7 @@ function invalidConfigError(configPath: string, detail?: string): Error {
       '  - "snapshotModel", "viewport", "windowPosition", and "sessionMode" are optional.',
       '  - "snapshotModel" must be a provider/model string like "openai/gpt-5.4" or "anthropic/claude-sonnet-4-6".',
       "Fix the file to match this shape, or delete it and rerun:",
-      `  npx libretto ai configure openai | anthropic | gemini | vertex`,
+      `  npx libretto ai configure openai | anthropic | gemini | vertex | openrouter`,
     ]
       .filter(Boolean)
       .join("\n"),