libretto 0.6.7-experimental.0 → 0.6.8

package/README.md

@@ -5,6 +5,7 @@
 [![npm version](https://img.shields.io/npm/v/libretto)](https://www.npmjs.com/package/libretto)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![GitHub Discussions](https://img.shields.io/github/discussions/saffron-health/libretto)](https://github.com/saffron-health/libretto/discussions)
+[![Discord](https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white)](https://discord.gg/NYrG56hVDt)
 
 Libretto is a toolkit for building robust web integrations. It gives your coding agent a live browser and a token-efficient CLI to:
 
@@ -17,6 +18,13 @@ We at [Saffron Health](https://saffron.health) built Libretto to help us maintai
 
 https://github.com/user-attachments/assets/9b9a0ab3-5133-4b20-b3be-459943349d18
 
+### Quick Links
+
+- Website: [libretto.sh](https://libretto.sh)
+- Docs: [libretto.sh/docs](https://libretto.sh/docs)
+- Repository: [github.com/saffron-health/libretto](https://github.com/saffron-health/libretto)
+- Discord: [discord.gg/NYrG56hVDt](https://discord.gg/NYrG56hVDt)
+
 ## Installation
 
 ```bash
@@ -69,86 +77,29 @@ Agents can use Libretto to reproduce the failure, pause the workflow at any poin
 You can also use Libretto directly from the command line. All commands accept `--session <name>` to target a specific session.
 
 ```bash
-npx libretto setup                         # interactive first-run onboarding; run yourself, not through an agent
-npx libretto status                        # check AI config health and open sessions
-npx libretto open <url>                    # launch browser and open a URL (headed by default)
-npx libretto snapshot --objective "..." --context "..."  # capture PNG + HTML and analyze with an LLM
-npx libretto exec "<code>"                 # execute Playwright TypeScript against the open page (single quoted argument)
-echo "<code>" | npx libretto exec -        # intentionally read Playwright TypeScript from stdin
-npx libretto run <file>                    # run the file's default-exported workflow
-npx libretto resume                        # resume a paused workflow
-npx libretto pages                         # list open pages in the session
-npx libretto save <domain>                 # save browser session (cookies, localStorage) for reuse
+npx libretto open <url>                    # launch browser and open a URL
+npx libretto snapshot --objective "..."    # capture PNG + HTML and analyze with an LLM
+npx libretto exec "<code>"                 # execute Playwright TypeScript against the open page
 npx libretto close                         # close the browser
-npx libretto ai configure <provider>       # manually change snapshot analysis model
-npx libretto status                        # show AI config and open sessions
-```
-
-## Configuration
-
-All Libretto state lives in a `.libretto/` directory at your project root. Configuration is stored in `.libretto/config.json`.
-
-### Config file
-
-`.libretto/config.json` controls snapshot analysis and viewport settings:
-
-```json
-{
-  "version": 1,
-  "ai": {
-    "model": "openai/gpt-5.4",
-    "updatedAt": "2026-01-01T00:00:00.000Z"
-  },
-  "viewport": { "width": 1280, "height": 800 }
-}
-```
-
-The `ai` field configures which model Libretto uses for snapshot analysis — extracting selectors, identifying interactive elements, or diagnosing why a step failed. This keeps heavy visual context out of your coding agent's context window. Snapshot analysis is required.
-
-`npx libretto setup` automatically pins the default model for the first provider whose credentials it finds. To explicitly change the provider or model afterward:
-
-```bash
-npx libretto ai configure <openai | anthropic | gemini | vertex>
 ```
 
-To inspect the current configuration without changing anything:
-
-```bash
-npx libretto status
-```
-
-Provider credentials are read from environment variables or a `.env` file at your project root: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY` / `GOOGLE_GENERATIVE_AI_API_KEY`, or `GOOGLE_CLOUD_PROJECT` for Vertex.
-
-The `viewport` field sets the default browser viewport size. Both fields are optional.
+Run `npx libretto help` for the full list of commands.
 
-### Sessions
-
-Each Libretto session gets its own directory under `.libretto/sessions/<name>/` containing runtime state. Sessions are git-ignored.
-
-- `state.json` — session metadata (debug port, PID, status)
-- `logs.jsonl` — structured session logs
-- `network.jsonl` — captured network requests
-- `actions.jsonl` — recorded user actions
-- `snapshots/` — screenshot PNGs and HTML snapshots
-
-### Profiles
+## Configuration
 
-Profiles save browser sessions (cookies, localStorage) so you can reuse authenticated state across runs. They are stored in `.libretto/profiles/<domain>.json`, created via `npx libretto save <domain>`. Profiles are machine-local and git-ignored.
+All Libretto state lives in a `.libretto/` directory at your project root. See the [configuration docs](https://libretto.sh/docs/configuration) for details on config files, sessions, and profiles.
 
-## Community
+## Join the Community
 
-Have a question, idea, or want to share what you've built? Join the conversation on [GitHub Discussions](https://github.com/saffron-health/libretto/discussions).
+Join our Discord to connect with other developers, get help, and share what you've built:
 
-- **[Q&A](https://github.com/saffron-health/libretto/discussions/categories/q-a)** — Ask questions and get help
-- **[Ideas](https://github.com/saffron-health/libretto/discussions/categories/ideas)** — Suggest new features or improvements
-- **[Show and tell](https://github.com/saffron-health/libretto/discussions/categories/show-and-tell)** — Share your workflows and automations
-- **[General](https://github.com/saffron-health/libretto/discussions/categories/general)** — Chat about anything Libretto-related
+[![Discord](https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white)](https://discord.gg/NYrG56hVDt)
 
-Found a bug? Please [open an issue](https://github.com/saffron-health/libretto/issues/new).
+For longer-form threads, head to [GitHub Discussions](https://github.com/saffron-health/libretto/discussions). Found a bug? [Open an issue](https://github.com/saffron-health/libretto/issues/new).
 
-## Authors
+## License
 
-Maintained by the team at [Saffron Health](https://saffron.health).
+[MIT License](LICENSE) — use it freely in commercial and open-source projects.
 
 ## Development
 
@@ -173,3 +124,10 @@ Source layout:
 Run `pnpm sync:mirrors` after editing `README.template.md` or anything under `skills/libretto/`.
 
 To check that generated READMEs, skill mirrors, and skill version metadata are in sync without fixing them, run `pnpm check:mirrors`. To release, run `pnpm prepare-release`.
+
+---
+
+> [!NOTE]
+> This is an early-stage project under active development. APIs may change before version 1.0. We recommend pinning to specific versions in production.
+
+Built by the team at [Saffron Health](https://saffron.health).

package/README.template.md

@@ -3,6 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/libretto)](https://www.npmjs.com/package/libretto)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![GitHub Discussions](https://img.shields.io/github/discussions/saffron-health/libretto)](https://github.com/saffron-health/libretto/discussions)
+[![Discord](https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white)](https://discord.gg/NYrG56hVDt)
 
 Libretto is a toolkit for building robust web integrations. It gives your coding agent a live browser and a token-efficient CLI to:
 
@@ -15,6 +16,13 @@ We at [Saffron Health](https://saffron.health) built Libretto to help us maintai
 
 https://github.com/user-attachments/assets/9b9a0ab3-5133-4b20-b3be-459943349d18
 
+### Quick Links
+
+- Website: [libretto.sh](https://libretto.sh)
+- Docs: [libretto.sh/docs](https://libretto.sh/docs)
+- Repository: [github.com/saffron-health/libretto](https://github.com/saffron-health/libretto)
+- Discord: [discord.gg/NYrG56hVDt](https://discord.gg/NYrG56hVDt)
+
 ## Installation
 
 ```bash
@@ -67,86 +75,29 @@ Agents can use Libretto to reproduce the failure, pause the workflow at any poin
 You can also use Libretto directly from the command line. All commands accept `--session <name>` to target a specific session.
 
 ```bash
-npx libretto setup                         # interactive first-run onboarding; run yourself, not through an agent
-npx libretto status                        # check AI config health and open sessions
-npx libretto open <url>                    # launch browser and open a URL (headed by default)
-npx libretto snapshot --objective "..." --context "..."  # capture PNG + HTML and analyze with an LLM
-npx libretto exec "<code>"                 # execute Playwright TypeScript against the open page (single quoted argument)
-echo "<code>" | npx libretto exec -        # intentionally read Playwright TypeScript from stdin
-npx libretto run <file>                    # run the file's default-exported workflow
-npx libretto resume                        # resume a paused workflow
-npx libretto pages                         # list open pages in the session
-npx libretto save <domain>                 # save browser session (cookies, localStorage) for reuse
+npx libretto open <url>                    # launch browser and open a URL
+npx libretto snapshot --objective "..."    # capture PNG + HTML and analyze with an LLM
+npx libretto exec "<code>"                 # execute Playwright TypeScript against the open page
 npx libretto close                         # close the browser
-npx libretto ai configure <provider>       # manually change snapshot analysis model
-npx libretto status                        # show AI config and open sessions
-```
-
-## Configuration
-
-All Libretto state lives in a `.libretto/` directory at your project root. Configuration is stored in `.libretto/config.json`.
-
-### Config file
-
-`.libretto/config.json` controls snapshot analysis and viewport settings:
-
-```json
-{
-  "version": 1,
-  "ai": {
-    "model": "openai/gpt-5.4",
-    "updatedAt": "2026-01-01T00:00:00.000Z"
-  },
-  "viewport": { "width": 1280, "height": 800 }
-}
-```
-
-The `ai` field configures which model Libretto uses for snapshot analysis — extracting selectors, identifying interactive elements, or diagnosing why a step failed. This keeps heavy visual context out of your coding agent's context window. Snapshot analysis is required.
-
-`npx libretto setup` automatically pins the default model for the first provider whose credentials it finds. To explicitly change the provider or model afterward:
-
-```bash
-npx libretto ai configure <openai | anthropic | gemini | vertex>
 ```
 
-To inspect the current configuration without changing anything:
-
-```bash
-npx libretto status
-```
-
-Provider credentials are read from environment variables or a `.env` file at your project root: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY` / `GOOGLE_GENERATIVE_AI_API_KEY`, or `GOOGLE_CLOUD_PROJECT` for Vertex.
-
-The `viewport` field sets the default browser viewport size. Both fields are optional.
+Run `npx libretto help` for the full list of commands.
 
-### Sessions
-
-Each Libretto session gets its own directory under `.libretto/sessions/<name>/` containing runtime state. Sessions are git-ignored.
-
-- `state.json` — session metadata (debug port, PID, status)
-- `logs.jsonl` — structured session logs
-- `network.jsonl` — captured network requests
-- `actions.jsonl` — recorded user actions
-- `snapshots/` — screenshot PNGs and HTML snapshots
-
-### Profiles
+## Configuration
 
-Profiles save browser sessions (cookies, localStorage) so you can reuse authenticated state across runs. They are stored in `.libretto/profiles/<domain>.json`, created via `npx libretto save <domain>`. Profiles are machine-local and git-ignored.
+All Libretto state lives in a `.libretto/` directory at your project root. See the [configuration docs](https://libretto.sh/docs/configuration) for details on config files, sessions, and profiles.
 
-## Community
+## Join the Community
 
-Have a question, idea, or want to share what you've built? Join the conversation on [GitHub Discussions](https://github.com/saffron-health/libretto/discussions).
+Join our Discord to connect with other developers, get help, and share what you've built:
 
-- **[Q&A](https://github.com/saffron-health/libretto/discussions/categories/q-a)** — Ask questions and get help
-- **[Ideas](https://github.com/saffron-health/libretto/discussions/categories/ideas)** — Suggest new features or improvements
-- **[Show and tell](https://github.com/saffron-health/libretto/discussions/categories/show-and-tell)** — Share your workflows and automations
-- **[General](https://github.com/saffron-health/libretto/discussions/categories/general)** — Chat about anything Libretto-related
+[![Discord](https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white)](https://discord.gg/NYrG56hVDt)
 
-Found a bug? Please [open an issue](https://github.com/saffron-health/libretto/issues/new).
+For longer-form threads, head to [GitHub Discussions](https://github.com/saffron-health/libretto/discussions). Found a bug? [Open an issue](https://github.com/saffron-health/libretto/issues/new).
 
-## Authors
+## License
 
-Maintained by the team at [Saffron Health](https://saffron.health).
+[MIT License](LICENSE) — use it freely in commercial and open-source projects.
 
 ## Development
 
@@ -171,3 +122,10 @@ Source layout:
 Run `pnpm sync:mirrors` after editing `{{LIBRETTO_PATH_PREFIX}}README.template.md` or anything under `{{LIBRETTO_PATH_PREFIX}}skills/libretto/`.
 
 To check that generated READMEs, skill mirrors, and skill version metadata are in sync without fixing them, run `pnpm check:mirrors`. To release, run `pnpm prepare-release`.
+
+---
+
+> [!NOTE]
+> This is an early-stage project under active development. APIs may change before version 1.0. We recommend pinning to specific versions in production.
+
+Built by the team at [Saffron Health](https://saffron.health).

package/dist/cli/commands/setup.js

@@ -23,7 +23,8 @@ const PROVIDER_SDK_PACKAGES = {
   openai: "@ai-sdk/openai",
   anthropic: "@ai-sdk/anthropic",
   google: "@ai-sdk/google",
-  vertex: "@ai-sdk/google-vertex"
+  vertex: "@ai-sdk/google-vertex",
+  openrouter: "@ai-sdk/openai"
 };
 function detectPackageManager() {
   if (existsSync(join(REPO_ROOT, "pnpm-lock.yaml"))) return "pnpm";
@@ -102,6 +103,13 @@ const PROVIDER_CHOICES = [
     provider: "vertex",
     envVar: "GOOGLE_CLOUD_PROJECT",
     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(rl, question) {
@@ -136,7 +144,7 @@ function printHealthySummary(status) {
     console.log(`\u2713 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"
   );
 }
 function printInvalidAiConfigWarning(status) {
@@ -200,7 +208,7 @@ function printSnapshotApiStatus() {
     "    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."
@@ -245,7 +253,7 @@ function printSkipMessage() {
   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."
   );
 }
 async function runInteractiveApiSetup() {

package/dist/cli/commands/status.js

@@ -13,7 +13,7 @@ function printAiStatus(status) {
         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;
     case "configured-missing-credentials":

package/dist/cli/core/ai-model.js

@@ -1,16 +1,17 @@
-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
 } from "./resolve-model.js";
+import { loadEnv } from "../../shared/env/load-env.js";
+import { parseDotEnvAssignment } from "../../shared/env/load-env.js";
 const DEFAULT_SNAPSHOT_MODELS = {
   openai: "openai/gpt-5.4",
   anthropic: "anthropic/claude-sonnet-4-6",
   google: "google/gemini-3-flash-preview",
-  vertex: "vertex/gemini-2.5-flash"
+  vertex: "vertex/gemini-2.5-flash",
+  openrouter: "openrouter/free"
 };
 function detectProviderEnvVar(provider, env = process.env) {
   switch (provider) {
@@ -27,6 +28,8 @@ function detectProviderEnvVar(provider, env = process.env) {
       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;
   }
 }
 class SnapshotApiUnavailableError extends Error {
@@ -45,10 +48,12 @@ function providerSetupSentence(provider) {
       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() {
-  return "npx libretto ai configure openai | anthropic | gemini | vertex";
+  return "npx libretto ai configure openai | anthropic | gemini | vertex | openrouter";
 }
 function providerMissingCredentialSummary(provider) {
   switch (provider) {
@@ -60,12 +65,14 @@ function providerMissingCredentialSummary(provider) {
       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() {
   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(" ");
 }
@@ -77,72 +84,13 @@ function missingProviderSnapshotMessage(selection) {
     "For more info, run `npx libretto setup`."
   ].join(" ");
 }
-function readWorktreeEnvPath() {
-  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;
-  }
-}
-function loadSnapshotEnv() {
-  if (process.env.LIBRETTO_DISABLE_DOTENV?.trim() === "1") return;
-  const envPathCandidates = [
-    join(REPO_ROOT, ".env"),
-    readWorktreeEnvPath()
-  ].filter((value) => 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;
-    }
-  }
-}
-function parseDotEnvAssignment(line) {
-  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 };
-}
 function inferAutoSnapshotModel() {
   const providersInPriorityOrder = [
     "openai",
     "anthropic",
     "google",
-    "vertex"
+    "vertex",
+    "openrouter"
   ];
   for (const provider of providersInPriorityOrder) {
     const envVar = detectProviderEnvVar(provider);
@@ -156,7 +104,7 @@ function inferAutoSnapshotModel() {
   return null;
 }
 function resolveSnapshotApiModel(snapshotModel = readSnapshotModel()) {
-  loadSnapshotEnv();
+  loadEnv();
   if (snapshotModel) {
     const { provider } = parseModel(snapshotModel);
     return {
@@ -193,7 +141,7 @@ function readSnapshotModelSafely(configPath) {
   }
 }
 function resolveAiSetupStatus(configPath = LIBRETTO_CONFIG_PATH) {
-  loadSnapshotEnv();
+  loadEnv();
   const result = readSnapshotModelSafely(configPath);
   if (!result.ok) {
     return { kind: "invalid-config", message: result.message };
@@ -240,7 +188,6 @@ export {
   DEFAULT_SNAPSHOT_MODELS,
   SnapshotApiUnavailableError,
   isSnapshotApiUnavailableError,
-  loadSnapshotEnv,
   parseDotEnvAssignment,
   resolveAiSetupStatus,
   resolveSnapshotApiModel,

package/dist/cli/core/browser-daemon.js

@@ -0,0 +1,122 @@
+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";
+const config = JSON.parse(process.argv[2]);
+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);
+function childLog(level, event, data = {}) {
+  const entry = JSON.stringify({
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    id: Math.random().toString(36).slice(2, 10),
+    level,
+    scope: "libretto.child",
+    event,
+    data
+  });
+  appendFileSync(logFile, entry + "\n");
+}
+function logAction(entry) {
+  appendFileSync(actionsLogFile, JSON.stringify(entry) + "\n");
+}
+function logNetwork(entry) {
+  appendFileSync(networkLogFile, JSON.stringify(entry) + "\n");
+}
+const windowPositionArg = config.windowPosition ? `--window-position=${config.windowPosition.x},${config.windowPosition.y}` : void 0;
+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() {
+  const sessionStatePath = getSessionStatePath(config.session);
+  try {
+    await unlink(sessionStatePath);
+  } catch (err) {
+    if (err.code !== "ENOENT") throw err;
+  }
+}
+let shuttingDown = false;
+let wakeDaemon;
+const sleepPromise = new Promise((resolve) => {
+  wakeDaemon = resolve;
+});
+async function shutdown(reason, closeBrowser) {
+  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);
+});
+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.setDefaultTimeout(3e4);
+page.setDefaultNavigationTimeout(45e3);
+await installSessionTelemetry({
+  context,
+  initialPage: page,
+  includeUserDomActions: true,
+  logAction,
+  logNetwork
+});
+await page.goto(config.url);
+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
+});
+await sleepPromise;
+process.exit(0);