libretto 0.6.2 → 0.6.4

package/dist/cli/cli.js

@@ -1,62 +1,40 @@
+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) {
   return `${app.renderHelp()}
 
 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
-
-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.
-
-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.
+Docs (agent-friendly): https://libretto.sh/docs
 `;
 }
+function printSetupAudit() {
+  warnIfInstalledSkillOutOfDate();
+  const status = resolveAiSetupStatus();
+  switch (status.kind) {
+    case "ready":
+      console.log(`\u2713 Snapshot model: ${status.model}`);
+      break;
+    case "configured-missing-credentials":
+      console.log(
+        `\u2717 ${status.provider} configured (model: ${status.model}), but credentials are missing. Run \`npx libretto setup\` to repair.`
+      );
+      break;
+    case "invalid-config":
+      console.log(
+        `\u2717 AI config is invalid. Run \`npx libretto setup\` to reconfigure.`
+      );
+      break;
+    case "unconfigured":
+      console.log(
+        `\u2717 No AI model configured. Run \`npx libretto setup\` or \`npx libretto ai configure\` to set up.`
+      );
+      break;
+  }
+}
 function isRootHelpRequest(rawArgs) {
   if (rawArgs.length === 0) return true;
   if (rawArgs[0] === "--help" || rawArgs[0] === "-h") return true;
@@ -70,6 +48,7 @@ async function runLibrettoCLI() {
   try {
     if (isRootHelpRequest(rawArgs)) {
       console.log(renderUsage(app));
+      printSetupAudit();
       return;
     }
     const result = await app.run(rawArgs);

package/dist/cli/commands/ai.js

@@ -1,8 +1,8 @@
 import { z } from "zod";
 import {
-  readAiConfig,
-  writeAiConfig,
-  clearAiConfig
+  readSnapshotModel,
+  writeSnapshotModel,
+  clearSnapshotModel
 } from "../core/config.js";
 import { LIBRETTO_CONFIG_PATH } from "../core/context.js";
 import { DEFAULT_SNAPSHOT_MODELS } from "../core/ai-model.js";
@@ -21,10 +21,9 @@ const CONFIGURE_PROVIDERS = [
 function formatConfigureProviders(separator = " | ") {
   return CONFIGURE_PROVIDERS.join(separator);
 }
-function printAiConfig(config, configPath) {
-  console.log(`Model: ${config.model}`);
+function printSnapshotModelConfig(model, configPath) {
+  console.log(`Snapshot model: ${model}`);
   console.log(`Config file: ${configPath}`);
-  console.log(`Updated at: ${config.updatedAt}`);
 }
 function resolveModelFromInput(input) {
   const trimmed = input.trim();
@@ -38,25 +37,25 @@ function runAiConfigure(input, options = {}) {
   const configPath = options.configPath ?? LIBRETTO_CONFIG_PATH;
   const presetArg = input.preset?.trim();
   if (!presetArg && !input.clear) {
-    const config2 = readAiConfig(configPath);
-    if (!config2) {
+    const model2 = readSnapshotModel(configPath);
+    if (!model2) {
       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(config2, configPath);
+    printSnapshotModelConfig(model2, 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;
   }
@@ -71,9 +70,9 @@ function runAiConfigure(input, options = {}) {
       `Invalid provider or model. Use one of: ${formatConfigureProviders()}, or a full model string like "openai/gpt-4o".`
     );
   }
-  const config = writeAiConfig(model, configPath);
-  console.log("AI config saved.");
-  printAiConfig(config, configPath);
+  writeSnapshotModel(model, configPath);
+  console.log("Snapshot model saved.");
+  printSnapshotModelConfig(model, configPath);
 }
 const aiConfigureInput = SimpleCLI.input({
   positionals: [

package/dist/cli/commands/browser.js

@@ -199,7 +199,11 @@ const sessionModeCommand = SimpleCLI.command({
   console.log(`Session "${ctx.session}" mode set to ${nextState.mode}.`);
 });
 const closeInput = SimpleCLI.input({
-  positionals: [],
+  positionals: [
+    SimpleCLI.positional("session", z.string().optional(), {
+      help: "Session name to close"
+    })
+  ],
   named: {
     session: sessionOption(),
     all: SimpleCLI.flag({
@@ -211,7 +215,7 @@ const closeInput = SimpleCLI.input({
   }
 }).refine(
   (input) => input.all || input.session,
-  `Usage: libretto close --session <name>
+  `Usage: libretto close <session>
 Usage: libretto close --all [--force]`
 );
 const closeCommand = SimpleCLI.command({

package/dist/cli/commands/deploy.js

@@ -32,27 +32,40 @@ async function postJson(apiUrl, apiKey, path, input = {}) {
 }
 async function pollDeployment(apiUrl, apiKey, deploymentId, pollIntervalMs, maxWaitMs) {
   const start = Date.now();
+  const workflowWaitMs = 6e4;
   let status = "building";
+  let workflows = null;
+  let readyAt = null;
   let deployment;
-  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();
     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();
   if (!deployment) {
     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;
 }
 const deployInput = SimpleCLI.input({

package/dist/cli/commands/setup.js

@@ -1,17 +1,14 @@
 import { createInterface } from "node:readline";
 import {
-  appendFileSync,
   cpSync,
   existsSync,
   readdirSync,
-  readFileSync,
-  rmSync,
-  writeFileSync
+  rmSync
 } 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,
@@ -19,7 +16,6 @@ import {
 } from "../core/context.js";
 import {
   DEFAULT_SNAPSHOT_MODELS,
-  loadSnapshotEnv,
   resolveAiSetupStatus
 } from "../core/ai-model.js";
 import { SimpleCLI } from "../framework/simple-cli.js";
@@ -70,7 +66,7 @@ function sourceEnvVar(source) {
 }
 function ensurePinnedDefaultModel(status) {
   if (status.source !== "config") {
-    writeAiConfig(status.model);
+    writeSnapshotModel(status.model);
     return { ...status, source: "config" };
   }
   return status;
@@ -103,7 +99,7 @@ function buildRepairPlan(status) {
       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") {
@@ -156,50 +152,7 @@ function printSnapshotApiStatus() {
   );
   return false;
 }
-function writeEnvVar(envVar, value, envPath) {
-  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(`
-\u2713 Updated ${envVar} in ${envPath}`);
-  } else {
-    const separator = envContent && !envContent.endsWith("\n") ? "\n" : "";
-    appendFileSync(envPath, `${separator}${envLine}
-`);
-    console.log(`
-\u2713 Added ${envVar} to ${envPath}`);
-  }
-  process.env[envVar] = value;
-}
-async function promptForCredential(rl, choice, envPath, modelOverride) {
-  console.log(`
-${choice.label} selected.`);
-  console.log(`${choice.envHint}
-`);
-  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(`\u2713 Snapshot API ready: ${model}`);
-  console.log(
-    "To change: npx libretto ai configure openai | anthropic | gemini | vertex"
-  );
-  return true;
-}
-async function promptProviderSelection(rl, envPath) {
+async function promptProviderSelection(rl) {
   console.log(
     "Which model provider would you like to use for snapshot analysis?\n"
   );
@@ -218,7 +171,14 @@ async function promptProviderSelection(rl, envPath) {
 Unknown choice "${answer}". Skipping API setup.`);
     return false;
   }
-  return promptForCredential(rl, selected, envPath);
+  const model = DEFAULT_SNAPSHOT_MODELS[selected.provider];
+  writeSnapshotModel(model);
+  console.log(`
+\u2713 ${selected.label} selected (model: ${model}).`);
+  console.log(`
+Add ${selected.envVar} to your .env file:`);
+  console.log(`  ${selected.envHint}`);
+  return true;
 }
 function printSkipMessage() {
   console.log(
@@ -234,7 +194,6 @@ function printSkipMessage() {
 }
 async function runInteractiveApiSetup() {
   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."
   );
@@ -252,23 +211,15 @@ async function runInteractiveApiSetup() {
   try {
     if (plan.kind === "repair-missing-credentials") {
       console.log(formatMissingCredentialsMessage(plan));
+      console.log(`
+Add ${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;
       }
       printSkipMessage();
@@ -279,11 +230,11 @@ async function runInteractiveApiSetup() {
       console.log(
         "\nWould you like to reconfigure with a fresh provider selection?\n"
       );
-      await promptProviderSelection(rl, envPath);
+      await promptProviderSelection(rl);
       return;
     }
     console.log("\u2717 No snapshot API credentials detected.\n");
-    await promptProviderSelection(rl, envPath);
+    await promptProviderSelection(rl);
   } finally {
     rl.close();
   }

package/dist/cli/commands/snapshot.js

@@ -7,7 +7,7 @@ import { readSessionState } from "../core/session.js";
 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 };
 function generateSnapshotRunId() {
@@ -187,8 +187,8 @@ async function captureScreenshot(session, logger, pageId) {
 async function runSnapshot(session, logger, pageId, objective, context) {
   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,
     logger,
@@ -206,7 +206,7 @@ async function runSnapshot(session, logger, pageId, objective, context) {
     htmlPath,
     condensedHtmlPath
   };
-  await runApiInterpret(interpretArgs, logger, configuredAi);
+  await runApiInterpret(interpretArgs, logger, snapshotModel);
 }
 const snapshotInput = SimpleCLI.input({
   positionals: [],

package/dist/cli/commands/status.js

@@ -6,7 +6,7 @@ function printAiStatus(status) {
   console.log("AI configuration:");
   switch (status.kind) {
     case "ready":
-      console.log(`  \u2713 Model: ${status.model}`);
+      console.log(`  \u2713 Snapshot model: ${status.model}`);
       if (status.source === "config") {
         console.log(`  Config: ${LIBRETTO_CONFIG_PATH}`);
       } else {

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

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
-import { readAiConfig } from "./config.js";
+import { readSnapshotModel } from "./config.js";
 import { LIBRETTO_CONFIG_PATH, REPO_ROOT } from "./context.js";
 import {
   hasProviderCredentials,
@@ -155,20 +155,20 @@ function inferAutoSnapshotModel() {
   }
   return null;
 }
-function resolveSnapshotApiModel(config = readAiConfig()) {
+function resolveSnapshotApiModel(snapshotModel = readSnapshotModel()) {
   loadSnapshotEnv();
-  if (config?.model) {
-    const { provider } = parseModel(config.model);
+  if (snapshotModel) {
+    const { provider } = parseModel(snapshotModel);
     return {
-      model: config.model,
+      model: snapshotModel,
       provider,
       source: "config"
     };
   }
   return inferAutoSnapshotModel();
 }
-function resolveSnapshotApiModelOrThrow(config = readAiConfig()) {
-  const selection = resolveSnapshotApiModel(config);
+function resolveSnapshotApiModelOrThrow(snapshotModel = readSnapshotModel()) {
+  const selection = resolveSnapshotApiModel(snapshotModel);
   if (!selection) {
     throw new SnapshotApiUnavailableError(noSnapshotApiConfiguredMessage());
   }
@@ -182,9 +182,9 @@ function resolveSnapshotApiModelOrThrow(config = readAiConfig()) {
 function isSnapshotApiUnavailableError(error) {
   return error instanceof SnapshotApiUnavailableError;
 }
-function readAiConfigSafely(configPath) {
+function readSnapshotModelSafely(configPath) {
   try {
-    return { ok: true, config: readAiConfig(configPath) };
+    return { ok: true, model: readSnapshotModel(configPath) };
   } catch (err) {
     return {
       ok: false,
@@ -194,14 +194,14 @@ function readAiConfigSafely(configPath) {
 }
 function resolveAiSetupStatus(configPath = LIBRETTO_CONFIG_PATH) {
   loadSnapshotEnv();
-  const configResult = readAiConfigSafely(configPath);
-  if (!configResult.ok) {
-    return { kind: "invalid-config", message: configResult.message };
+  const result = readSnapshotModelSafely(configPath);
+  if (!result.ok) {
+    return { kind: "invalid-config", message: result.message };
   }
-  if (configResult.config) {
+  if (result.model) {
     let selection;
     try {
-      selection = resolveSnapshotApiModel(configResult.config);
+      selection = resolveSnapshotApiModel(result.model);
     } catch (err) {
       return {
         kind: "invalid-config",

package/dist/cli/core/api-snapshot-analyzer.js

@@ -7,10 +7,10 @@ import {
   getMimeType,
   readFileAsBase64
 } from "./snapshot-analyzer.js";
-import { readAiConfig } from "./config.js";
+import { readSnapshotModel } from "./config.js";
 import { resolveSnapshotApiModelOrThrow } from "./ai-model.js";
-async function runApiInterpret(args, logger, configuredAi = readAiConfig()) {
-  const selection = resolveSnapshotApiModelOrThrow(configuredAi);
+async function runApiInterpret(args, logger, snapshotModel = readSnapshotModel()) {
+  const selection = resolveSnapshotApiModelOrThrow(snapshotModel);
   logger.info("api-interpret-start", {
     objective: args.objective,
     pngPath: args.pngPath,

package/dist/cli/core/config.js

@@ -4,10 +4,6 @@ import { z } from "zod";
 import { SessionAccessModeSchema } from "../../shared/state/index.js";
 import { LIBRETTO_CONFIG_PATH } from "./context.js";
 const CURRENT_CONFIG_VERSION = 1;
-const AiConfigSchema = z.object({
-  model: z.string().min(1),
-  updatedAt: z.string()
-});
 const ViewportConfigSchema = z.object({
   width: z.number().int().min(1),
   height: z.number().int().min(1)
@@ -18,7 +14,7 @@ const WindowPositionConfigSchema = z.object({
 });
 const LibrettoConfigSchema = z.object({
   version: z.literal(CURRENT_CONFIG_VERSION),
-  ai: AiConfigSchema.optional(),
+  snapshotModel: z.string().min(1).optional(),
   viewport: ViewportConfigSchema.optional(),
   windowPosition: WindowPositionConfigSchema.optional(),
   provider: z.string().optional(),
@@ -31,10 +27,7 @@ function formatExpectedConfigExample() {
   return JSON.stringify(
     {
       version: CURRENT_CONFIG_VERSION,
-      ai: {
-        model: "openai/gpt-5.4",
-        updatedAt: "2026-01-01T00:00:00.000Z"
-      },
+      snapshotModel: "openai/gpt-5.4",
       viewport: {
         width: 1280,
         height: 800
@@ -52,14 +45,14 @@ function formatExpectedConfigExample() {
 function invalidConfigError(configPath, detail) {
   return new Error(
     [
-      `AI config is invalid at ${configPath}.`,
+      `Config is invalid at ${configPath}.`,
       detail ? `Problems:
 ${detail}` : null,
       "Expected config example:",
       formatExpectedConfigExample(),
       "Notes:",
-      '  - "ai", "viewport", "windowPosition", and "sessionMode" are optional.',
-      '  - "ai.model" must be a provider/model string like "openai/gpt-5.4" or "anthropic/claude-sonnet-4-6".',
+      '  - "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`
     ].filter(Boolean).join("\n")
@@ -93,34 +86,30 @@ function writeLibrettoConfig(config, configPath = LIBRETTO_CONFIG_PATH) {
   writeFileSync(configPath, JSON.stringify(parsed, null, 2), "utf-8");
   return parsed;
 }
-function readAiConfig(configPath = LIBRETTO_CONFIG_PATH) {
-  return readLibrettoConfig(configPath).ai ?? null;
+function readSnapshotModel(configPath = LIBRETTO_CONFIG_PATH) {
+  return readLibrettoConfig(configPath).snapshotModel ?? null;
 }
-function writeAiConfig(model, configPath = LIBRETTO_CONFIG_PATH) {
+function writeSnapshotModel(model, configPath = LIBRETTO_CONFIG_PATH) {
   let librettoConfig;
   try {
     librettoConfig = readLibrettoConfig(configPath);
   } catch {
     librettoConfig = { version: CURRENT_CONFIG_VERSION };
   }
-  const ai = AiConfigSchema.parse({
-    model,
-    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-  });
   writeLibrettoConfig(
     {
       ...librettoConfig,
       version: CURRENT_CONFIG_VERSION,
-      ai
+      snapshotModel: model
     },
     configPath
   );
-  return ai;
+  return model;
 }
-function clearAiConfig(configPath = LIBRETTO_CONFIG_PATH) {
+function clearSnapshotModel(configPath = LIBRETTO_CONFIG_PATH) {
   const librettoConfig = readLibrettoConfig(configPath);
-  if (!librettoConfig.ai) return false;
-  const { ai: _ai, ...rest } = librettoConfig;
+  if (!librettoConfig.snapshotModel) return false;
+  const { snapshotModel: _, ...rest } = librettoConfig;
   writeLibrettoConfig(
     {
       ...rest
@@ -130,14 +119,13 @@ function clearAiConfig(configPath = LIBRETTO_CONFIG_PATH) {
   return true;
 }
 export {
-  AiConfigSchema,
   CURRENT_CONFIG_VERSION,
   LibrettoConfigSchema,
   ViewportConfigSchema,
   WindowPositionConfigSchema,
-  clearAiConfig,
-  readAiConfig,
+  clearSnapshotModel,
   readLibrettoConfig,
-  writeAiConfig,
-  writeLibrettoConfig
+  readSnapshotModel,
+  writeLibrettoConfig,
+  writeSnapshotModel
 };

package/dist/cli/framework/simple-cli.js

@@ -762,14 +762,17 @@ function buildInputNormalizer(definition) {
         toKebabCase(key),
         key
       ].filter((candidate) => candidate.length > 0);
-      let value = void 0;
+      let found = false;
       for (const candidate of normalizedCandidates) {
         if (Object.prototype.hasOwnProperty.call(named, candidate)) {
-          value = named[candidate];
+          output[key] = named[candidate];
+          found = true;
           break;
         }
       }
-      output[key] = value;
+      if (!found && !Object.prototype.hasOwnProperty.call(output, key)) {
+        output[key] = void 0;
+      }
     }
     return output;
   };

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "libretto",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "AI-powered browser automation library and CLI built on Playwright",
   "license": "MIT",
+  "homepage": "https://libretto.sh",
   "repository": {
     "type": "git",
     "url": "https://github.com/saffron-health/libretto"

package/skills/libretto/SKILL.md

@@ -4,7 +4,7 @@ description: "Browser automation CLI for building, maintaining, and running brow
 license: MIT
 metadata:
   author: saffron-health
-  version: "0.6.2"
+  version: "0.6.4"
 ---
 
 ## How Libretto Works