libretto 0.6.12 → 0.6.13

package/dist/cli/core/config.js

@@ -3,7 +3,6 @@ import { dirname } from "node:path";
 import { z } from "zod";
 import { SessionAccessModeSchema } from "../../shared/state/index.js";
 import { LIBRETTO_CONFIG_PATH } from "./context.js";
-import { librettoCommand } from "../../shared/package-manager.js";
 const CURRENT_CONFIG_VERSION = 1;
 const ViewportConfigSchema = z.object({
   width: z.number().int().min(1),
@@ -29,7 +28,6 @@ function formatExpectedConfigExample() {
   return JSON.stringify(
     {
       version: CURRENT_CONFIG_VERSION,
-      snapshotModel: "openai/gpt-5.4",
       viewport: {
         width: 1280,
         height: 800
@@ -53,10 +51,9 @@ ${detail}` : null,
       "Expected config example:",
       formatExpectedConfigExample(),
       "Notes:",
-      '  - "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:",
-      `  ${librettoCommand("ai configure openai | anthropic | gemini | vertex | openrouter")}`
+      '  - "viewport", "windowPosition", and "sessionMode" are optional.',
+      '  - "snapshotModel" is deprecated and ignored by snapshot.',
+      "Fix the file to match this shape, or delete it and rerun setup."
     ].filter(Boolean).join("\n")
   );
 }

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

@@ -31,7 +31,7 @@ import {
 } from "../browser.js";
 import { handlePages } from "./pages.js";
 import { handleExec, handleReadonlyExec } from "./exec.js";
-import { handleCompactSnapshot, handleSnapshot } from "./snapshot.js";
+import { handleCompactSnapshot } from "./snapshot.js";
 import { librettoCommand } from "../../../shared/package-manager.js";
 import { snapshot } from "../../../shared/snapshot/capture-snapshot.js";
 import { diffSnapshots } from "../../../shared/snapshot/diff-snapshots.js";
@@ -170,9 +170,7 @@ class BrowserDaemon {
         error: err instanceof Error ? err.message : String(err)
       });
     }
-    if (experiments["compact-snapshot-format"]) {
-      await context.addInitScript(installPageStabilityWaiter);
-    }
+    await context.addInitScript(installPageStabilityWaiter);
     const socketPath = getDaemonSocketPath(session);
     const daemon = new BrowserDaemon(
       session,
@@ -188,19 +186,15 @@ class BrowserDaemon {
       wrapPageForActionLogging(p, session);
       daemon.trackPage(p);
     }
-    if (experiments["compact-snapshot-format"]) {
-      await Promise.all(
-        initialPages.map(
-          (initialPage) => daemon.installCompactSnapshotWaiter(initialPage)
-        )
-      );
-    }
+    await Promise.all(
+      initialPages.map(
+        (initialPage) => daemon.installCompactSnapshotWaiter(initialPage)
+      )
+    );
     context.on("page", (newPage) => {
       wrapPageForActionLogging(newPage, session);
       daemon.trackPage(newPage);
-      if (experiments["compact-snapshot-format"]) {
-        void daemon.installCompactSnapshotWaiter(newPage);
-      }
+      void daemon.installCompactSnapshotWaiter(newPage);
     });
     if (navigateUrl) {
       await page.goto(navigateUrl);
@@ -465,38 +459,23 @@ class BrowserDaemon {
     };
   }
   async runSnapshot(args) {
-    if (args.mode === "compact") {
-      if (!this.experiments["compact-snapshot-format"]) {
-        throw new Error(
-          `The compact-snapshot-format experiment is not enabled for session "${this.session}". Close and reopen the session after running ${librettoCommand("experiments enable compact-snapshot-format")}.`
-        );
-      }
-      const targetPage = this.resolveTargetPage(args.pageId);
-      const result = await this.withRequestTimeout(
-        () => handleCompactSnapshot(
-          targetPage,
-          this.session,
-          this.logger,
-          {
-            pageId: args.pageId,
-            cachedSnapshot: this.latestCompactSnapshotByPage.get(targetPage),
-            useCachedSnapshot: args.useCachedSnapshot
-          }
-        )
-      );
-      if (!args.useCachedSnapshot) {
-        this.latestCompactSnapshotByPage.set(targetPage, result.snapshot);
-      }
-      return result;
-    }
-    return this.withRequestTimeout(
-      () => handleSnapshot(
-        this.resolveTargetPage(args.pageId),
+    const targetPage = this.resolveTargetPage(args.pageId);
+    const result = await this.withRequestTimeout(
+      () => handleCompactSnapshot(
+        targetPage,
         this.session,
         this.logger,
-        args.pageId
+        {
+          pageId: args.pageId,
+          cachedSnapshot: this.latestCompactSnapshotByPage.get(targetPage),
+          useCachedSnapshot: args.useCachedSnapshot
+        }
       )
     );
+    if (!args.useCachedSnapshot) {
+      this.latestCompactSnapshotByPage.set(targetPage, result.snapshot);
+    }
+    return result;
   }
   async withRequestTimeout(operation) {
     let timerId;
@@ -513,25 +492,7 @@ class BrowserDaemon {
     }
   }
   async runExec(args) {
-    if (this.experiments["compact-snapshot-format"]) {
-      return this.runCompactExec(args);
-    }
-    try {
-      const data = await this.withRequestTimeout(
-        () => handleExec(
-          this.resolveTargetPage(args.pageId),
-          args.code,
-          this.context,
-          this.browser,
-          this.execState,
-          this.session,
-          args.visualize
-        )
-      );
-      return { ok: true, data };
-    } catch (error) {
-      return this.createExecErrorResult(error);
-    }
+    return this.runCompactExec(args);
   }
   async runCompactExec(args) {
     let targetPage;
@@ -606,17 +567,17 @@ class BrowserDaemon {
       context: this.context,
       logger: this.logger,
       onLog: (event) => {
-        this.broadcast("workflowOutput", event);
+        void this.broadcast("workflowOutput", event);
       },
       onOutcome: (outcome) => {
         if (outcome.state === "paused") {
-          this.broadcast("workflowPaused", {
+          void this.broadcast("workflowPaused", {
             pausedAt: outcome.pausedAt,
             url: outcome.url
           });
           return;
         }
-        this.broadcast(
+        void this.broadcast(
           "workflowFinished",
           outcome.result === "completed" ? { result: "completed", completedAt: outcome.completedAt } : {
             result: "failed",

package/dist/cli/core/daemon/snapshot.js

@@ -1,4 +1,4 @@
-import { mkdirSync, writeFileSync } from "node:fs";
+import { mkdirSync } from "node:fs";
 import { getSessionSnapshotRunDir } from "../context.js";
 import {
   snapshot
@@ -13,32 +13,6 @@ import {
   forceSnapshotViewport
 } from "../../commands/snapshot.js";
 const RENDER_SETTLE_TIMEOUT_MS = 1e4;
-async function handleSnapshot(targetPage, session, logger, pageId) {
-  const screenshot = await captureSnapshotScreenshot(
-    targetPage,
-    session,
-    logger,
-    pageId
-  );
-  const htmlPath = `${getSessionSnapshotRunDir(
-    session,
-    screenshot.snapshotRunId
-  )}/page.html`;
-  const htmlContent = await targetPage.content();
-  writeFileSync(htmlPath, htmlContent);
-  logger.info("screenshot-success", {
-    session,
-    pageUrl: screenshot.pageUrl,
-    title: screenshot.title,
-    pngPath: screenshot.pngPath,
-    htmlPath,
-    snapshotRunId: screenshot.snapshotRunId
-  });
-  return {
-    ...screenshot,
-    htmlPath
-  };
-}
 async function handleCompactSnapshot(targetPage, session, logger, options = {}) {
   if (options.useCachedSnapshot) {
     if (!options.cachedSnapshot) {
@@ -147,6 +121,5 @@ async function captureSnapshotScreenshot(targetPage, session, logger, pageId) {
   };
 }
 export {
-  handleCompactSnapshot,
-  handleSnapshot
+  handleCompactSnapshot
 };

package/dist/cli/core/experiments.js

@@ -2,34 +2,7 @@ import {
   readLibrettoConfig,
   writeLibrettoConfig
 } from "./config.js";
-const EXPERIMENTS = {
-  "compact-snapshot-format": {
-    title: "Compact snapshot format",
-    oneSentenceDescription: "Use compact accessibility snapshots and exec page-change diffs without an AI sub-agent.",
-    docs: [
-      "Compact snapshot format changes how agents should use snapshot and exec after the experiment is enabled.",
-      "",
-      "Compared with the skill's documented behavior:",
-      "  - Run libretto snapshot --session <name> without --objective or --context.",
-      "  - Snapshot output is a screenshot path plus a compact accessibility tree; it does not use the PNG + HTML + AI analysis path.",
-      "  - Run libretto snapshot <ref> --session <name> to inspect a subtree from the latest full compact snapshot.",
-      "  - Run libretto exec normally; after successful mutations, Libretto prints page-change diffs from compact snapshots without AI analysis.",
-      "  - If a session was already open before enabling the experiment, close and reopen it before relying on this behavior.",
-      "",
-      "Full compact snapshot:",
-      "  libretto snapshot --session <name>",
-      "",
-      "Cached subtree snapshot:",
-      "  libretto snapshot <ref> --session <name>",
-      "",
-      "Run an unscoped snapshot before using refs. Subtree snapshots capture a fresh screenshot but reuse the latest cached tree.",
-      "",
-      "Notes:",
-      "  - Use ref forms printed in the tree, such as l16. Numeric-suffix aliases such as e16 also match l16."
-    ].join("\n"),
-    defaultValue: false
-  }
-};
+const EXPERIMENTS = {};
 function isExperimentName(name) {
   return Object.hasOwn(EXPERIMENTS, name);
 }

package/dist/cli/index.js

@@ -1,8 +1,6 @@
 #!/usr/bin/env node
 import { runLibrettoCLI } from "./cli.js";
-import { runClose } from "./commands/browser.js";
 void runLibrettoCLI();
 export {
-  runClose,
   runLibrettoCLI
 };

package/dist/cli/router.js

@@ -1,4 +1,3 @@
-import { aiCommands } from "./commands/ai.js";
 import { authCommands } from "./commands/auth.js";
 import { billingCommands } from "./commands/billing.js";
 import { browserCommands } from "./commands/browser.js";
@@ -15,7 +14,6 @@ const cliRoutes = {
   deploy: deployCommand,
   experiments: experimentsCommand,
   ...executionCommands,
-  ai: aiCommands,
   auth: authCommands,
   billing: billingCommands,
   setup: setupCommand,

package/dist/shared/instrumentation/instrument.js

@@ -82,12 +82,12 @@ function wrapLocatorActions(locator, page, opts) {
       try {
         const result = await orig(...args);
         if (opts.visualize) {
-          enqueue(page, () => visualizeAfterAction(page));
+          void enqueue(page, () => visualizeAfterAction(page));
         }
         return result;
       } catch (err) {
         if (opts.visualize) {
-          enqueue(page, () => visualizeAfterAction(page));
+          void enqueue(page, () => visualizeAfterAction(page));
         }
         if (POINTER_ACTIONS.has(method) && isTimeoutError(err)) {
           await enrichTimeoutError(err, locator, page);
@@ -226,12 +226,12 @@ async function installInstrumentation(page, options) {
       try {
         const result = await orig(...args);
         if (visualize) {
-          enqueue(page, () => visualizeAfterAction(page));
+          void enqueue(page, () => visualizeAfterAction(page));
         }
         return result;
       } catch (err) {
         if (visualize) {
-          enqueue(page, () => visualizeAfterAction(page));
+          void enqueue(page, () => visualizeAfterAction(page));
         }
         if (POINTER_ACTIONS.has(method) && isTimeoutError(err) && typeof args[0] === "string") {
           await enrichTimeoutError(err, page.locator(args[0]), page);

package/docs/releasing.md

@@ -24,7 +24,7 @@ This repo does not publish from local machines and does not push directly to `ma
 
 GitHub Actions needs these repository secrets:
 
-- `OPENAI_API_KEY`: used by the existing test suite during the release workflow.
+- `OPENAI_API_KEY`: used by the existing test suite during the release workflow and by the eval workflow's default `openai/gpt-5.5` model.
 
 The release workflow uses a GitHub Actions environment named `release`. Create that environment in the repository settings (no required reviewers — access is controlled by branch protection on `main` instead).
 
@@ -69,7 +69,7 @@ The root `scripts/prepare-release.sh` script does the following:
 6. Commits the version bump.
 7. Pushes the branch and opens a PR to `main` with the `release` label.
 
-Release PRs also run the eval workflow. That workflow compares the current eval score against the latest successful `main` baseline and fails if the score drifts by more than 5 percentage points in either direction.
+Release PRs also run the eval workflow. That workflow records score, duration, token, cost, and tool-call metrics for review. Scores are informational: low scores do not fail the workflow, but setup/runtime failures and zero completed records do.
 
 ## Merge behavior
 
@@ -89,11 +89,13 @@ This makes the workflow safe to re-run after partial failures. For example, if n
 
 `.github/workflows/evals.yml` now runs automatically for release PRs and for qualifying pushes to `main`.
 
-- On `main`, it records the current eval summary as the baseline artifact for future release PRs.
-- On release PRs, it runs evals again and compares the overall score against the latest successful `main` baseline.
-- If the score moves outside a `+/-5%` window, the eval job fails and flags the release PR.
+- It runs `pnpm evals --no-auth --output <runner-temp>/eval-run` so CI only runs cases that do not require local auth profiles.
+- It validates and renders the CI report with `pnpm evals summary <runner-temp>/eval-run`.
+- It writes a GitHub step summary and a sticky PR comment with aggregate score, duration, token, cost, and tool-call metrics.
+- It uploads summary files and per-case result records from the run output directory. Raw transcripts and local profile files are not uploaded.
+- It fails when the eval runner crashes, required setup is missing, result records are malformed, or zero completed records are produced.
 
-If no successful baseline artifact exists yet, the release PR eval job reports that and skips the comparison for that run.
+There is no baseline comparison gate yet. Add one only after the eval records and metrics are stable enough to compare reliably.
 
 ## Changelog behavior
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libretto",
-  "version": "0.6.12",
+  "version": "0.6.13",
   "description": "AI-powered browser automation library and CLI built on Playwright",
   "license": "MIT",
   "homepage": "https://libretto.sh",
@@ -37,6 +37,7 @@
     "sync-skills": "pnpm run sync:mirrors",
     "check:skills": "pnpm run check:mirrors",
     "build": "tsup --config tsup.config.ts",
+    "lint": "lintcn lint --tsconfig tsconfig.json",
     "type-check": "tsc --noEmit",
     "test": "turbo run test:vitest --filter=libretto --log-order=grouped",
     "test:vitest": "vitest run",

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.12"
+  version: "0.6.13"
 ---
 
 ## How Libretto Works
@@ -34,10 +34,12 @@ Full documentation is published at [libretto.sh](https://libretto.sh). Available
 
 ## Setup
 
-- Use `npx libretto setup` for first-time workspace onboarding. It installs Chromium, syncs skills, and pins the default snapshot model to `.libretto/config.json` when provider credentials are available.
-- Re-running `setup` on a healthy workspace shows the current configuration. If credentials are missing for a configured provider, it offers an interactive repair flow.
-- Use `npx libretto status` to inspect AI configuration health and open sessions without triggering setup.
-- Use `npx libretto ai configure openai|anthropic|gemini|vertex` to explicitly change the snapshot model or provider (advanced override).
+- Use `npx libretto setup` for first-time workspace onboarding. It installs Chromium and syncs skills.
+- Use `npx libretto status` to inspect open sessions without triggering setup.
+
+## Experiments
+
+- Use `npx libretto experiments` to list internal feature flags and `npx libretto experiments describe <name>` for usage notes when an experiment is enabled.
 
 ## Working Rules
 
@@ -95,20 +97,15 @@ npx libretto session-mode --session my-session
 ### `snapshot`
 
 - Use `snapshot` as the primary page observation tool.
-- Always provide both `--objective` and `--context`.
-- A single snapshot objective can include multiple questions or analysis tasks.
+- Run `snapshot` without `--objective` or `--context`; the command prints a screenshot path and compact accessibility tree for the current page.
+- Run `snapshot <ref>` to inspect a subtree from the latest full snapshot. Use ref forms printed in the tree, such as `l16`; numeric-suffix aliases such as `e16` also match `l16`.
+- Run an unscoped snapshot before using refs. Subtree snapshots capture a fresh screenshot but reuse the latest cached tree.
 - Use it before guessing at selectors, after workflow failures, and whenever the visible page state is unclear.
-- When analysis is involved, expect it to take time. Use a timeout of at least 2 minutes for shell-wrapped calls.
 
 ```bash
-npx libretto snapshot \
-  --objective "Find the sign-in form and submit button" \
-  --context "I just opened the login page and need the email field, password field, and submit button."
-npx libretto snapshot \
-  --session debug-example \
-  --page <page-id> \
-  --objective "Explain why the table is empty" \
-  --context "I opened the referrals page, applied filters, and expected rows to appear."
+npx libretto snapshot --session debug-example
+npx libretto snapshot <ref> --session debug-example
+npx libretto snapshot --session debug-example --page <page-id>
 ```
 
 ### `exec`
@@ -120,6 +117,7 @@ npx libretto snapshot \
 - Let failures throw. Do not hide `exec` failures with `try/catch` or `.catch()`.
 - Do not run multiple `exec` commands in parallel.
 - Do not use `exec` in read-only diagnosis flows. Use `readonly-exec` from the `libretto-readonly` skill for those sessions.
+- After successful mutations, `exec` prints page-change diffs from compact snapshots.
 
 ```bash
 npx libretto exec "return await page.url()"
@@ -227,7 +225,7 @@ Key fields: `ts` (ISO timestamp), `method` (HTTP method, e.g. `GET`, `POST`), `u
 Assistant: I'll inspect the real site first if needed, but before I finish I'll create `target-workflow.ts` so the task produces reusable automation code.
 Assistant: [Runs `npx libretto open https://target.example.com --headed`]
 Assistant: [Reads `references/site-security-review.md` before choosing between passive network inspection, direct browser fetch calls, and Playwright-first automation]
-Assistant: [Runs `npx libretto snapshot --objective "Find the next required action" --context "We are starting the workflow from the landing page and need the first meaningful step."`]
+Assistant: [Runs `npx libretto snapshot --session <session>`]
 Assistant: [Uses `snapshot` and `exec` as needed to understand the site and decide the implementation path]
 Assistant: [Reads `references/code-generation-rules.md` before writing production workflow code]
 Assistant: I found the working path. I'll now create the workflow file and verify it.
@@ -247,7 +245,7 @@ To watch it yourself in a browser, run: npx libretto run ./target-workflow.ts --
 Assistant: I'll reproduce the failure first so we can inspect the exact browser state it leaves behind.
 Assistant: [Runs `npx libretto run ./integration.ts --session debug-flow --headed`]
 Assistant: The workflow failed and Libretto kept the browser open. I'll inspect the page state before changing code.
-Assistant: [Runs `npx libretto snapshot --session debug-flow --objective "Find the blocking error or broken selector target" --context "The workflow just failed after trying to continue from the review step, and I need to identify the visible blocker on the current page."`]
+Assistant: [Runs `npx libretto snapshot --session debug-flow`]
 Assistant: [Runs `npx libretto exec --session debug-flow "...focused inspection or prototype..."`]
 Assistant: [Reads `references/code-generation-rules.md` before patching the workflow file]
 Assistant: I found the issue. I'll patch the workflow code and verify.
@@ -261,7 +259,7 @@ To watch it yourself in a browser, run: npx libretto run ./integration.ts --head
 
 ## References
 
-- Read `references/configuration-file-reference.md` when you need to inspect or change `.libretto/config.json` for snapshot model selection or viewport defaults.
+- Read `references/configuration-file-reference.md` when you need to inspect or change `.libretto/config.json` for viewport or session defaults.
 - Read `references/site-security-review.md` before reviewing the site's security posture and deciding whether to lead with network requests, passive interception, or Playwright DOM automation on a new site.
 - Read `references/code-generation-rules.md` before writing or editing production workflow files.
 - Read `references/auth-profiles.md` when auth-profile behavior is relevant.

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

@@ -1,10 +1,9 @@
 # Configuration File Reference
 
-Use this reference when you need to inspect or change the workspace configuration that powers `snapshot` analysis and default viewport behavior.
+Use this reference when you need to inspect or change workspace configuration for default browser behavior.
 
 ## When to Use This
 
-- You want to confirm which AI model `snapshot` will use.
 - You want to understand where Libretto stores workspace-level settings.
 - You want a persistent default viewport for `open` or `run`.
 
@@ -12,14 +11,12 @@ Use this reference when you need to inspect or change the workspace configuratio
 
 Libretto reads workspace config from `.libretto/config.json`.
 
-- The file is created by `npx libretto setup` during first-time onboarding (auto-pins the default model for the detected provider) or by `npx libretto ai configure ...` for explicit overrides.
-- API credentials come from your shell environment or a `.env` file **at the repository root** (next to your `.git` directory). The config file stores the selected model, not the secret itself. Set `LIBRETTO_DISABLE_DOTENV=1` to skip `.env` loading (useful in CI).
-- Use `npx libretto status` to inspect the current AI configuration and open sessions without changing anything.
+- The file is created by `npx libretto setup` during first-time onboarding.
+- Use `npx libretto status` to inspect open sessions without changing anything.
 - For first-time setup instructions, follow the main `SKILL.md` flow instead of expanding this reference.
 
 ## Supported Settings
 
-- `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,7 +26,6 @@ Example:
 ```json
 {
   "version": 1,
-  "snapshotModel": "openai/gpt-5.4",
   "viewport": {
     "width": 1280,
     "height": 800
@@ -41,9 +37,8 @@ Example:
 ## Common Commands
 
 ```bash
-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 setup                                         # first-time onboarding
+npx libretto status                                        # inspect open sessions
 npx libretto open https://example.com --viewport 1440x900
 npx libretto run ./integration.ts --viewport 1440x900
 ```
@@ -51,5 +46,4 @@ npx libretto run ./integration.ts --viewport 1440x900
 ## Notes
 
 - If you want a persistent default viewport for the workspace, add `viewport` to `.libretto/config.json` instead of repeating `--viewport` on every command.
-- If `snapshot` analysis is not configured yet, run `npx libretto setup` to auto-configure, or see the main `SKILL.md` flow.
-- Run `npx libretto status` at any time to check which model is active and whether credentials are present.
+- Run `npx libretto status` at any time to check open sessions.

package/skills/libretto/references/pages-and-page-targeting.md

@@ -19,7 +19,7 @@ Use this reference when a Libretto session has multiple open pages and you need
 ```bash
 npx libretto pages --session debug-flow
 npx libretto exec --session debug-flow --page <page-id> "return await page.url()"
-npx libretto snapshot --session debug-flow --page <page-id> --objective "Find the active form"
+npx libretto snapshot --session debug-flow --page <page-id>
 ```
 
 ## Notes

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.12"
+  version: "0.6.13"
 ---
 
 ## How Libretto Read-Only Works
@@ -49,14 +49,7 @@ npx libretto pages --session failed-job-debug
 ### `snapshot`
 
 - Use `snapshot` as the first high-level observation tool.
-- Always provide both `--objective` and `--context`.
-
-```bash
-npx libretto snapshot \
-  --session failed-job-debug \
-  --objective "Identify the visible failure state and likely blocking UI condition" \
-  --context "The workflow already failed and the preserved browser must remain read-only."
-```
+- Run `snapshot <ref>` to inspect a subtree from the latest full snapshot.
 
 ### `readonly-exec`
 

package/src/cli/cli.ts

@@ -1,6 +1,4 @@
-import { resolveAiSetupStatus } from "./core/ai-model.js";
 import { ensureLibrettoSetup } from "./core/context.js";
-import { librettoCommand } from "../shared/package-manager.js";
 import { createCLIApp } from "./router.js";
 import { warnIfInstalledSkillOutOfDate } from "./core/skill-version.js";
 import { loadEnv } from "../shared/env/load-env.js";
@@ -17,28 +15,6 @@ Docs (agent-friendly): https://libretto.sh/docs
 
 function printSetupAudit(): void {
   warnIfInstalledSkillOutOfDate();
-
-  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 \`${librettoCommand("setup")}\` to repair.`,
-      );
-      break;
-    case "invalid-config":
-      console.log(
-        `✗ AI config is invalid. Run \`${librettoCommand("setup")}\` to reconfigure.`,
-      );
-      break;
-    case "unconfigured":
-      console.log(
-        `✗ No AI model configured. Run \`${librettoCommand("setup")}\` or \`${librettoCommand("ai configure")}\` to set up.`,
-      );
-      break;
-  }
 }
 
 function isRootHelpRequest(rawArgs: readonly string[]): boolean {

package/src/cli/commands/browser.ts

@@ -11,7 +11,7 @@ import {
 } from "../core/browser.js";
 import { resolveProviderName } from "../core/providers/index.js";
 import { readLibrettoConfig } from "../core/config.js";
-import { createLoggerForSession, withSessionLogger } from "../core/context.js";
+import { createLoggerForSession } from "../core/context.js";
 import { librettoCommand } from "../../shared/package-manager.js";
 import {
   type SessionAccessMode,
@@ -295,9 +295,3 @@ export const browserCommands = {
   "session-mode": sessionModeCommand,
   close: closeCommand,
 };
-
-export async function runClose(session: string): Promise<void> {
-  await withSessionLogger(session, async (logger) => {
-    await runCloseWithLogger(session, logger);
-  });
-}