libretto 0.6.2 → 0.6.4

package/skills/libretto/references/configuration-file-reference.md

@@ -19,7 +19,7 @@ Libretto reads workspace config from `.libretto/config.json`.
 
 ## Supported Settings
 
-- `ai.model` selects the configured analysis model for `snapshot`.
+- `snapshotModel` selects the configured analysis model for `snapshot`.
 - `viewport` is an optional top-level setting used by `open` and `run` when you do not pass `--viewport`.
 - Viewport precedence is: CLI `--viewport`, then `.libretto/config.json`, then the default `1366x768`.
 - `sessionMode` sets the default session access mode for new sessions created by `open`, `connect`, and `run`. Must be `"read-only"` or `"write-access"`. When omitted, defaults to `"write-access"`. Pass `--read-only` or `--write-access` to `open`, `connect`, or `run` to override when creating a session.
@@ -29,10 +29,7 @@ Example:
 ```json
 {
   "version": 1,
-  "ai": {
-    "model": "openai/gpt-5.4",
-    "updatedAt": "2026-01-01T00:00:00.000Z"
-  },
+  "snapshotModel": "openai/gpt-5.4",
   "viewport": {
     "width": 1280,
     "height": 800
@@ -47,7 +44,7 @@ Example:
 npx libretto setup                                         # first-time onboarding, auto-pins default model
 npx libretto status                                        # inspect AI config and open sessions
 npx libretto ai configure openai                           # explicitly change provider/model
-npx libretto open https://app.example.com --viewport 1440x900
+npx libretto open https://example.com --viewport 1440x900
 npx libretto run ./integration.ts --viewport 1440x900
 ```
 

package/skills/libretto-readonly/SKILL.md

@@ -4,7 +4,7 @@ description: "Read-only Libretto workflow for diagnosing live browser state with
 license: MIT
 metadata:
   author: saffron-health
-  version: "0.6.2"
+  version: "0.6.4"
 ---
 
 ## How Libretto Read-Only Works

package/src/cli/cli.ts

@@ -1,5 +1,7 @@
+import { resolveAiSetupStatus } from "./core/ai-model.js";
 import { ensureLibrettoSetup } from "./core/context.js";
 import { createCLIApp } from "./router.js";
+import { warnIfInstalledSkillOutOfDate } from "./core/skill-version.js";
 
 function renderUsage(app: ReturnType<typeof createCLIApp>): string {
   return `${app.renderHelp()}
@@ -7,56 +9,34 @@ function renderUsage(app: ReturnType<typeof createCLIApp>): string {
 Options:
   --session <name>        Use a named session (auto-generated for open/run if omitted)
 
-Examples:
-  libretto open https://linkedin.com
-
-  # ... manually log in ...
-  libretto save linkedin.com
-  # Next time you open linkedin.com, you'll be logged in automatically
-
-  libretto exec "await page.locator('button:has-text(\\"Sign in\\")').click()"
-  libretto exec "await page.fill('input[name=\\"email\\"]', 'test@example.com')"
-  libretto readonly-exec "return await page.title()" --session test1
-  libretto connect http://127.0.0.1:9222 --read-only --session test1
-  libretto run ./integration.ts --read-only --session test1
-  libretto status
-  libretto ai configure openai
-  libretto ai configure anthropic
-  libretto ai configure gemini
-  libretto ai configure vertex
-  libretto ai configure openai/gpt-4o
-  libretto snapshot
-  libretto snapshot --objective "Find the submit button" --context "Submitting a referral form, already filled in patient details"
-  libretto resume --session my-session
-  libretto close
-  libretto close --all
-  libretto close --all --force
-
-  # Multiple sessions
-  libretto open https://site1.com --session test1
-  libretto open https://site2.com --session test2
-  libretto exec "return await page.title()" --session test1
-
-Available in exec:
-  page, context, state, browser, networkLog, actionLog
-
-Available in readonly-exec:
-  page, state, snapshot, scrollBy, get
+Docs (agent-friendly): https://libretto.sh/docs
+`;
+}
 
-Profiles:
-  Profiles are saved to .libretto/profiles/<domain>.json (git-ignored)
-  They persist cookies, localStorage, and session data across browser launches.
-  Local profiles are machine-local and are not shared with other users/environments.
-  Sessions can expire; if run fails auth, log in again and re-save the profile.
+function printSetupAudit(): void {
+  warnIfInstalledSkillOutOfDate();
 
-Sessions:
-  Session state is stored in .libretto/sessions/<session>/state.json
-  CLI logs are stored in .libretto/sessions/<session>/logs.jsonl
-  Each session runs an isolated browser instance on a dynamic port.
-  Session mode is stored per session as read-only or write-access.
-  Use --read-only on open, connect, or run to create a read-only session.
-  Session mode is enforced by Libretto commands, not by raw CDP clients outside Libretto.
-`;
+  const status = resolveAiSetupStatus();
+  switch (status.kind) {
+    case "ready":
+      console.log(`✓ Snapshot model: ${status.model}`);
+      break;
+    case "configured-missing-credentials":
+      console.log(
+        `✗ ${status.provider} configured (model: ${status.model}), but credentials are missing. Run \`npx libretto setup\` to repair.`,
+      );
+      break;
+    case "invalid-config":
+      console.log(
+        `✗ AI config is invalid. Run \`npx libretto setup\` to reconfigure.`,
+      );
+      break;
+    case "unconfigured":
+      console.log(
+        `✗ No AI model configured. Run \`npx libretto setup\` or \`npx libretto ai configure\` to set up.`,
+      );
+      break;
+  }
 }
 
 function isRootHelpRequest(rawArgs: readonly string[]): boolean {
@@ -74,6 +54,7 @@ export async function runLibrettoCLI(): Promise<void> {
   try {
     if (isRootHelpRequest(rawArgs)) {
       console.log(renderUsage(app));
+      printSetupAudit();
       return;
     }
 

package/src/cli/commands/ai.ts

@@ -1,10 +1,9 @@
 import { z } from "zod";
 import {
   CURRENT_CONFIG_VERSION,
-  readAiConfig,
-  writeAiConfig,
-  clearAiConfig,
-  type AiConfig,
+  readSnapshotModel,
+  writeSnapshotModel,
+  clearSnapshotModel,
 } from "../core/config.js";
 import { LIBRETTO_CONFIG_PATH } from "../core/context.js";
 import { DEFAULT_SNAPSHOT_MODELS } from "../core/ai-model.js";
@@ -27,10 +26,9 @@ function formatConfigureProviders(separator = " | "): string {
   return CONFIGURE_PROVIDERS.join(separator);
 }
 
-function printAiConfig(config: AiConfig, configPath: string): void {
-  console.log(`Model: ${config.model}`);
+function printSnapshotModelConfig(model: string, configPath: string): void {
+  console.log(`Snapshot model: ${model}`);
   console.log(`Config file: ${configPath}`);
-  console.log(`Updated at: ${config.updatedAt}`);
 }
 
 /**
@@ -71,26 +69,26 @@ export function runAiConfigure(
   const presetArg = input.preset?.trim();
 
   if (!presetArg && !input.clear) {
-    const config = readAiConfig(configPath);
-    if (!config) {
+    const model = readSnapshotModel(configPath);
+    if (!model) {
       console.log(
-        `No AI config set. Choose a default model: ${configureCommandName} ${formatConfigureProviders()}`,
+        `No snapshot model set. Choose a default model: ${configureCommandName} ${formatConfigureProviders()}`,
       );
       console.log(
         "Provider credentials still come from your shell or .env file.",
       );
       return;
     }
-    printAiConfig(config, configPath);
+    printSnapshotModelConfig(model, configPath);
     return;
   }
 
   if (input.clear) {
-    const removed = clearAiConfig(configPath);
+    const removed = clearSnapshotModel(configPath);
     if (removed) {
-      console.log(`Cleared AI config: ${configPath}`);
+      console.log(`Cleared snapshot model config: ${configPath}`);
     } else {
-      console.log("No AI config was set.");
+      console.log("No snapshot model was set.");
     }
     return;
   }
@@ -107,9 +105,9 @@ export function runAiConfigure(
     );
   }
 
-  const config = writeAiConfig(model, configPath);
-  console.log("AI config saved.");
-  printAiConfig(config, configPath);
+  writeSnapshotModel(model, configPath);
+  console.log("Snapshot model saved.");
+  printSnapshotModelConfig(model, configPath);
 }
 
 export const aiConfigureInput = SimpleCLI.input({

package/src/cli/commands/browser.ts

@@ -242,7 +242,11 @@ export const sessionModeCommand = SimpleCLI.command({
   });
 
 export const closeInput = SimpleCLI.input({
-  positionals: [],
+  positionals: [
+    SimpleCLI.positional("session", z.string().optional(), {
+      help: "Session name to close",
+    }),
+  ],
   named: {
     session: sessionOption(),
     all: SimpleCLI.flag({
@@ -254,7 +258,7 @@ export const closeInput = SimpleCLI.input({
   },
 }).refine(
   (input) => input.all || input.session,
-  `Usage: libretto close --session <name>\nUsage: libretto close --all [--force]`,
+  `Usage: libretto close <session>\nUsage: libretto close --all [--force]`,
 );
 
 export const closeCommand = SimpleCLI.command({

package/src/cli/commands/deploy.ts

@@ -60,23 +60,32 @@ async function pollDeployment(
   maxWaitMs: number,
 ): Promise<DeploymentResponse["json"]> {
   const start = Date.now();
+  const workflowWaitMs = 60_000;
   let status: DeploymentStatus = "building";
+  let workflows: string[] | null | undefined = null;
+  let readyAt: number | null = null;
   let deployment: DeploymentResponse["json"] | undefined;
 
-  while (status === "building" && Date.now() - start < maxWaitMs) {
+  while (Date.now() - start < maxWaitMs) {
+    if (status !== "building" && status !== "ready") break;
+    if (status === "ready" && workflows?.length) break;
+    if (status === "ready" && readyAt && Date.now() - readyAt > workflowWaitMs) break;
+
     await new Promise((r) => setTimeout(r, pollIntervalMs));
 
-    const res = await postJson(apiUrl, apiKey, "/v1/deployments/get", {
+    const res = await postJson(apiUrl, apiKey, "/v1/deployments/sync", {
       id: deploymentId,
     });
     const body = (await res.json()) as DeploymentResponse;
     if (res.status !== 200) {
       throw new Error(
-        `Failed to get deployment status (${res.status}): ${JSON.stringify(body)}`,
+        `Failed to sync deployment status (${res.status}): ${JSON.stringify(body)}`,
       );
     }
     status = body.json.status;
+    workflows = body.json.workflows;
     deployment = body.json;
+    if (status === "ready" && readyAt === null) readyAt = Date.now();
     process.stdout.write(".");
   }
   console.log();
@@ -85,6 +94,12 @@ async function pollDeployment(
     throw new Error("Deployment timed out before receiving a status update.");
   }
 
+  if (status === "ready" && !workflows?.length) {
+    throw new Error(
+      "Build completed but workflow discovery failed due to a server-side error. Please redeploy.",
+    );
+  }
+
   return deployment;
 }
 

package/src/cli/commands/setup.ts

@@ -1,17 +1,14 @@
 import { createInterface } from "node:readline";
 import {
-  appendFileSync,
   cpSync,
   existsSync,
   readdirSync,
-  readFileSync,
   rmSync,
-  writeFileSync,
 } from "node:fs";
 import { spawnSync } from "node:child_process";
 import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { writeAiConfig } from "../core/config.js";
+import { writeSnapshotModel } from "../core/config.js";
 import {
   ensureLibrettoSetup,
   LIBRETTO_CONFIG_PATH,
@@ -20,7 +17,6 @@ import {
 import {
   type AiSetupStatus,
   DEFAULT_SNAPSHOT_MODELS,
-  loadSnapshotEnv,
   resolveAiSetupStatus,
 } from "../core/ai-model.js";
 import type { Provider } from "../core/resolve-model.js";
@@ -97,7 +93,7 @@ function ensurePinnedDefaultModel(
   status: AiSetupStatus & { kind: "ready" },
 ): AiSetupStatus & { kind: "ready" } {
   if (status.source !== "config") {
-    writeAiConfig(status.model);
+    writeSnapshotModel(status.model);
     return { ...status, source: "config" as const };
   }
   return status;
@@ -127,10 +123,7 @@ function printInvalidAiConfigWarning(status: AiSetupStatus): void {
 
 // ── Repair plan helpers (exported for testing) ──────────────────────────────
 
-export type RepairChoice =
-  | "enter-matching-credential"
-  | "switch-provider"
-  | "skip";
+export type RepairChoice = "switch-provider" | "skip";
 
 export type RepairPlan =
   | {
@@ -155,7 +148,7 @@ export function buildRepairPlan(status: AiSetupStatus): RepairPlan {
       provider: status.provider,
       model: status.model,
       envVar: choice?.envVar ?? `${status.provider.toUpperCase()}_API_KEY`,
-      choices: ["enter-matching-credential", "switch-provider", "skip"],
+      choices: ["switch-provider", "skip"],
     };
   }
   if (status.kind === "invalid-config") {
@@ -223,72 +216,13 @@ function printSnapshotApiStatus(): boolean {
 }
 
 /**
- * Write an env var to the .env file and update process.env.
- */
-function writeEnvVar(envVar: string, value: string, envPath: string): void {
-  let envContent = "";
-  if (existsSync(envPath)) {
-    envContent = readFileSync(envPath, "utf-8");
-  }
-
-  const envLine = `${envVar}=${value}`;
-  if (envContent.includes(`${envVar}=`)) {
-    const updated = envContent.replace(
-      new RegExp(`^${envVar}=.*$`, "m"),
-      () => envLine,
-    );
-    writeFileSync(envPath, updated);
-    console.log(`\n✓ Updated ${envVar} in ${envPath}`);
-  } else {
-    const separator = envContent && !envContent.endsWith("\n") ? "\n" : "";
-    appendFileSync(envPath, `${separator}${envLine}\n`);
-    console.log(`\n✓ Added ${envVar} to ${envPath}`);
-  }
-
-  process.env[envVar] = value;
-}
-
-/**
- * Prompt the user to enter a credential for a specific provider and pin its model.
- * When modelOverride is provided (e.g. during repair), preserves the existing model
- * instead of resetting to the provider default.
- * Returns true if credential was entered successfully.
- */
-async function promptForCredential(
-  rl: ReturnType<typeof createInterface>,
-  choice: ProviderChoice,
-  envPath: string,
-  modelOverride?: string,
-): Promise<boolean> {
-  console.log(`\n${choice.label} selected.`);
-  console.log(`${choice.envHint}\n`);
-
-  const apiKeyValue = await promptUser(rl, `Enter your ${choice.envVar}: `);
-
-  if (!apiKeyValue) {
-    console.log("\nNo value entered. Skipping API key setup.");
-    return false;
-  }
-
-  writeEnvVar(choice.envVar, apiKeyValue, envPath);
-  loadSnapshotEnv();
-
-  const model = modelOverride ?? DEFAULT_SNAPSHOT_MODELS[choice.provider];
-  writeAiConfig(model);
-  console.log(`✓ Snapshot API ready: ${model}`);
-  console.log(
-    "To change: npx libretto ai configure openai | anthropic | gemini | vertex",
-  );
-  return true;
-}
-
-/**
- * Run the full provider selection menu and credential entry.
+ * Run the full provider selection menu.
+ * Pins the selected provider's default model to config and prints
+ * instructions for the user to add the credential to .env themselves.
  * Returns true if a provider was successfully configured.
  */
 async function promptProviderSelection(
   rl: ReturnType<typeof createInterface>,
-  envPath: string,
 ): Promise<boolean> {
   console.log(
     "Which model provider would you like to use for snapshot analysis?\n",
@@ -311,7 +245,12 @@ async function promptProviderSelection(
     return false;
   }
 
-  return promptForCredential(rl, selected, envPath);
+  const model = DEFAULT_SNAPSHOT_MODELS[selected.provider];
+  writeSnapshotModel(model);
+  console.log(`\n✓ ${selected.label} selected (model: ${model}).`);
+  console.log(`\nAdd ${selected.envVar} to your .env file:`);
+  console.log(`  ${selected.envHint}`);
+  return true;
 }
 
 function printSkipMessage(): void {
@@ -329,7 +268,6 @@ function printSkipMessage(): void {
 
 async function runInteractiveApiSetup(): Promise<void> {
   const status = resolveAiSetupStatus();
-  const envPath = join(REPO_ROOT, ".env");
 
   console.log(
     "\nLibretto uses a sub-agent to analyze DOM snapshots. The model is determined by environment variables.",
@@ -353,26 +291,16 @@ async function runInteractiveApiSetup(): Promise<void> {
     // ── Repair: configured provider with missing credentials ──
     if (plan.kind === "repair-missing-credentials") {
       console.log(formatMissingCredentialsMessage(plan));
+      console.log(`\nAdd ${plan.envVar} to your .env file to fix this.`);
       console.log("");
-      console.log("How would you like to fix this?\n");
-      console.log(`  1) Enter ${plan.envVar}`);
-      console.log("  2) Switch to a different provider");
+      console.log("Or switch to a different provider:\n");
+      console.log("  1) Switch to a different provider");
       console.log("  s) Skip for now\n");
 
       const answer = await promptUser(rl, "Choice: ");
 
       if (answer === "1") {
-        const matchingChoice = PROVIDER_CHOICES.find(
-          (c) => c.provider === plan.provider,
-        );
-        if (matchingChoice) {
-          await promptForCredential(rl, matchingChoice, envPath, plan.model);
-        }
-        return;
-      }
-
-      if (answer === "2") {
-        await promptProviderSelection(rl, envPath);
+        await promptProviderSelection(rl);
         return;
       }
 
@@ -387,13 +315,13 @@ async function runInteractiveApiSetup(): Promise<void> {
       console.log(
         "\nWould you like to reconfigure with a fresh provider selection?\n",
       );
-      await promptProviderSelection(rl, envPath);
+      await promptProviderSelection(rl);
       return;
     }
 
     // ── Unconfigured: standard first-run flow ──
     console.log("✗ No snapshot API credentials detected.\n");
-    await promptProviderSelection(rl, envPath);
+    await promptProviderSelection(rl);
   } finally {
     rl.close();
   }

package/src/cli/commands/snapshot.ts

@@ -12,7 +12,7 @@ import {
 import { SimpleCLI } from "../framework/simple-cli.js";
 import { pageOption, sessionOption, withRequiredSession } from "./shared.js";
 import { runApiInterpret } from "../core/api-snapshot-analyzer.js";
-import { readAiConfig } from "../core/config.js";
+import { readSnapshotModel } from "../core/config.js";
 import { resolveSnapshotApiModelOrThrow } from "../core/ai-model.js";
 
 const FALLBACK_SNAPSHOT_VIEWPORT = { width: 1280, height: 800 } as const;
@@ -256,8 +256,8 @@ async function runSnapshot(
   const normalizedObjective = objective.trim();
   const normalizedContext = context.trim();
 
-  const configuredAi = readAiConfig();
-  resolveSnapshotApiModelOrThrow(configuredAi);
+  const snapshotModel = readSnapshotModel();
+  resolveSnapshotApiModelOrThrow(snapshotModel);
 
   const { pngPath, htmlPath, condensedHtmlPath } = await captureScreenshot(
     session,
@@ -283,7 +283,7 @@ async function runSnapshot(
   // The legacy CLI-agent path (spawning codex/claude/gemini as a subprocess) is preserved
   // in snapshot-analyzer.ts — to switch back, replace this call with:
   //   await runInterpret(interpretArgs, logger);
-  await runApiInterpret(interpretArgs, logger, configuredAi);
+  await runApiInterpret(interpretArgs, logger, snapshotModel);
 }
 
 export const snapshotInput = SimpleCLI.input({

package/src/cli/commands/status.ts

@@ -10,7 +10,7 @@ function printAiStatus(status: AiSetupStatus): void {
 
   switch (status.kind) {
     case "ready":
-      console.log(`  ✓ Model: ${status.model}`);
+      console.log(`  ✓ Snapshot model: ${status.model}`);
       if (status.source === "config") {
         console.log(`  Config: ${LIBRETTO_CONFIG_PATH}`);
       } else {

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

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
-import { type AiConfig, readAiConfig } from "./config.js";
+import { readSnapshotModel } from "./config.js";
 import { LIBRETTO_CONFIG_PATH, REPO_ROOT } from "./context.js";
 import {
   hasProviderCredentials,
@@ -221,18 +221,18 @@ function inferAutoSnapshotModel(): SnapshotApiModelSelection | null {
  * Resolve which API model to use for snapshot analysis.
  *
  * Priority:
- * 1. Model from .libretto/config.json ai.model field (set via `ai configure`)
+ * 1. snapshotModel from .libretto/config.json (set via `ai configure`)
  * 2. Auto-detect from available API credentials in env
  */
 export function resolveSnapshotApiModel(
-  config: AiConfig | null = readAiConfig(),
+  snapshotModel: string | null = readSnapshotModel(),
 ): SnapshotApiModelSelection | null {
   loadSnapshotEnv();
 
-  if (config?.model) {
-    const { provider } = parseModel(config.model);
+  if (snapshotModel) {
+    const { provider } = parseModel(snapshotModel);
     return {
-      model: config.model,
+      model: snapshotModel,
       provider,
       source: "config",
     };
@@ -242,9 +242,9 @@ export function resolveSnapshotApiModel(
 }
 
 export function resolveSnapshotApiModelOrThrow(
-  config: AiConfig | null = readAiConfig(),
+  snapshotModel: string | null = readSnapshotModel(),
 ): SnapshotApiModelSelection {
-  const selection = resolveSnapshotApiModel(config);
+  const selection = resolveSnapshotApiModel(snapshotModel);
   if (!selection) {
     throw new SnapshotApiUnavailableError(noSnapshotApiConfiguredMessage());
   }
@@ -288,14 +288,14 @@ export type AiSetupStatus =
   | { kind: "unconfigured" };
 
 /**
- * Read AI config without throwing on invalid files.
- * Returns the config or an error message.
+ * Read snapshot model without throwing on invalid files.
+ * Returns the model string or an error message.
  */
-function readAiConfigSafely(
+function readSnapshotModelSafely(
   configPath: string,
-): { ok: true; config: AiConfig | null } | { ok: false; message: string } {
+): { ok: true; model: string | null } | { ok: false; message: string } {
   try {
-    return { ok: true, config: readAiConfig(configPath) };
+    return { ok: true, model: readSnapshotModel(configPath) };
   } catch (err) {
     return {
       ok: false,
@@ -312,25 +312,25 @@ function readAiConfigSafely(
  * that the throwing APIs collapse into errors.
  *
  * 1. If config read throws → `invalid-config`.
- * 2. If config has an `ai` block → check credentials for that provider.
- * 3. If no config or no `ai` block → auto-detect from env via existing resolver.
+ * 2. If config has a `snapshotModel` → check credentials for that provider.
+ * 3. If no `snapshotModel` → auto-detect from env via existing resolver.
  */
 export function resolveAiSetupStatus(
   configPath: string = LIBRETTO_CONFIG_PATH,
 ): AiSetupStatus {
   loadSnapshotEnv();
 
-  const configResult = readAiConfigSafely(configPath);
+  const result = readSnapshotModelSafely(configPath);
 
-  if (!configResult.ok) {
-    return { kind: "invalid-config", message: configResult.message };
+  if (!result.ok) {
+    return { kind: "invalid-config", message: result.message };
   }
 
-  // Config exists with an ai block — use it directly to check credentials
-  if (configResult.config) {
+  // Config has a snapshotModel — use it directly to check credentials
+  if (result.model) {
     let selection: SnapshotApiModelSelection | null;
     try {
-      selection = resolveSnapshotApiModel(configResult.config);
+      selection = resolveSnapshotApiModel(result.model);
     } catch (err) {
       return {
         kind: "invalid-config",
@@ -356,7 +356,7 @@ export function resolveAiSetupStatus(
     };
   }
 
-  // No ai config — fall back to env auto-detect via existing resolver
+  // No snapshotModel — fall back to env auto-detect via existing resolver
   const envSelection = resolveSnapshotApiModel(null);
   if (envSelection && hasProviderCredentials(envSelection.provider)) {
     return {

package/src/cli/core/api-snapshot-analyzer.ts

@@ -18,15 +18,15 @@ import {
   type InterpretResult,
   type InterpretArgs,
 } from "./snapshot-analyzer.js";
-import { readAiConfig, type AiConfig } from "./config.js";
+import { readSnapshotModel } from "./config.js";
 import { resolveSnapshotApiModelOrThrow } from "./ai-model.js";
 
 export async function runApiInterpret(
   args: InterpretArgs,
   logger: LoggerApi,
-  configuredAi: AiConfig | null = readAiConfig(),
+  snapshotModel: string | null = readSnapshotModel(),
 ): Promise<void> {
-  const selection = resolveSnapshotApiModelOrThrow(configuredAi);
+  const selection = resolveSnapshotApiModelOrThrow(snapshotModel);
 
   logger.info("api-interpret-start", {
     objective: args.objective,