libretto 0.6.11 → 0.6.13

package/README.md

@@ -30,19 +30,14 @@ https://github.com/user-attachments/assets/9b9a0ab3-5133-4b20-b3be-459943349d18
 ```bash
 npm install libretto
 
-# First-time onboarding: install skill, download Chromium, and pin the default snapshot model
+# First-time onboarding: install skills and download Chromium
 npx libretto setup
 
 # Check workspace readiness at any time
 npx libretto status
-
-# Manually change the snapshot analysis model (advanced override)
-npx libretto ai configure <openai | anthropic | gemini | vertex>
 ```
 
-`setup` detects available provider credentials (e.g. `OPENAI_API_KEY`) and automatically pins the default model to `.libretto/config.json`. Re-running `setup` on a healthy workspace shows the current configuration instead of re-prompting. If credentials are missing for a previously configured provider, `setup` offers an interactive repair flow.
-
-Use `ai configure` when you want to explicitly switch providers or set a custom model string.
+`setup` creates the `.libretto/` directory, installs agent skills, and downloads Chromium unless you pass `--skip-browsers`.
 
 ## Use cases
 
@@ -78,11 +73,15 @@ You can also use Libretto directly from the command line. All commands accept `-
 
 ```bash
 npx libretto open <url>                    # launch browser and open a URL
-npx libretto snapshot --objective "..."    # capture PNG + HTML and analyze with an LLM
+npx libretto run ./integration.ts --headless # run a workflow and close on success
+npx libretto run ./integration.ts --headless --stay-open-on-success # keep a successful run inspectable
+npx libretto snapshot --session <name>     # capture a screenshot and compact accessibility tree
 npx libretto exec "<code>"                 # execute Playwright TypeScript against the open page
 npx libretto close                         # close the browser
 ```
 
+`run` sessions are inspectable through the same daemon-backed commands as `open` sessions. Successful runs close the browser by default; pass `--stay-open-on-success` to keep the browser open for `pages`, `snapshot`, and `exec`. Failed or paused workflows keep the browser open so you can inspect the exact page state before fixing or resuming the workflow.
+
 Run `npx libretto help` for the full list of commands.
 
 ## Configuration

package/README.template.md

@@ -28,19 +28,14 @@ https://github.com/user-attachments/assets/9b9a0ab3-5133-4b20-b3be-459943349d18
 ```bash
 npm install libretto
 
-# First-time onboarding: install skill, download Chromium, and pin the default snapshot model
+# First-time onboarding: install skills and download Chromium
 npx libretto setup
 
 # Check workspace readiness at any time
 npx libretto status
-
-# Manually change the snapshot analysis model (advanced override)
-npx libretto ai configure <openai | anthropic | gemini | vertex>
 ```
 
-`setup` detects available provider credentials (e.g. `OPENAI_API_KEY`) and automatically pins the default model to `.libretto/config.json`. Re-running `setup` on a healthy workspace shows the current configuration instead of re-prompting. If credentials are missing for a previously configured provider, `setup` offers an interactive repair flow.
-
-Use `ai configure` when you want to explicitly switch providers or set a custom model string.
+`setup` creates the `.libretto/` directory, installs agent skills, and downloads Chromium unless you pass `--skip-browsers`.
 
 ## Use cases
 
@@ -76,11 +71,15 @@ You can also use Libretto directly from the command line. All commands accept `-
 
 ```bash
 npx libretto open <url>                    # launch browser and open a URL
-npx libretto snapshot --objective "..."    # capture PNG + HTML and analyze with an LLM
+npx libretto run ./integration.ts --headless # run a workflow and close on success
+npx libretto run ./integration.ts --headless --stay-open-on-success # keep a successful run inspectable
+npx libretto snapshot --session <name>     # capture a screenshot and compact accessibility tree
 npx libretto exec "<code>"                 # execute Playwright TypeScript against the open page
 npx libretto close                         # close the browser
 ```
 
+`run` sessions are inspectable through the same daemon-backed commands as `open` sessions. Successful runs close the browser by default; pass `--stay-open-on-success` to keep the browser open for `pages`, `snapshot`, and `exec`. Failed or paused workflows keep the browser open so you can inspect the exact page state before fixing or resuming the workflow.
+
 Run `npx libretto help` for the full list of commands.
 
 ## Configuration

package/dist/cli/cli.js

@@ -1,4 +1,3 @@
-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";
@@ -14,27 +13,6 @@ 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;

package/dist/cli/commands/browser.js

@@ -9,12 +9,10 @@ import {
   runPages,
   runSave
 } from "../core/browser.js";
-import {
-  resolveProviderName,
-  getCloudProviderApi
-} from "../core/providers/index.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 {
   assertSessionAvailableForStart,
   setSessionMode,
@@ -25,6 +23,7 @@ import { SimpleCLI } from "../framework/simple-cli.js";
 import {
   sessionOption,
   withAutoSession,
+  withExperiments,
   withRequiredSession
 } from "./shared.js";
 function parseViewportArg(viewportArg) {
@@ -82,7 +81,7 @@ const openInput = SimpleCLI.input({
   }
 }).refine(
   (input) => Boolean(input.url),
-  `Usage: libretto open <url> [--headless] [--read-only|--write-access] [--auth-profile <domain>] [--viewport WxH] [--session <name>]`
+  `Usage: ${librettoCommand("open <url> [--headless] [--read-only|--write-access] [--auth-profile <domain>] [--viewport WxH] [--session <name>]")}`
 ).refine(
   (input) => !(input.headed && input.headless),
   "Cannot pass both --headed and --headless."
@@ -92,7 +91,7 @@ const openInput = SimpleCLI.input({
 );
 const openCommand = SimpleCLI.command({
   description: "Launch browser and open URL (headed by default). Automatically loads a saved auth profile for the URL's domain if one exists."
-}).input(openInput).use(withAutoSession()).handle(async ({ input, ctx }) => {
+}).input(openInput).use(withAutoSession()).use(withExperiments()).handle(async ({ input, ctx }) => {
   warnIfInstalledSkillOutOfDate();
   assertSessionAvailableForStart(ctx.session, ctx.logger);
   const providerName = resolveProviderName(input.provider);
@@ -105,17 +104,17 @@ const openCommand = SimpleCLI.command({
         input.readOnly,
         input.writeAccess
       ),
-      authProfileDomain: input.authProfile
+      authProfileDomain: input.authProfile,
+      experiments: ctx.experiments
     });
   } else {
-    const provider = getCloudProviderApi(providerName);
     await runOpenWithProvider(
       input.url,
       providerName,
-      provider,
       ctx.session,
       ctx.logger,
-      resolveRequestedSessionMode(input.readOnly, input.writeAccess)
+      resolveRequestedSessionMode(input.readOnly, input.writeAccess),
+      ctx.experiments
     );
   }
 });
@@ -138,20 +137,21 @@ const connectInput = SimpleCLI.input({
   }
 }).refine(
   (input) => Boolean(input.cdpUrl),
-  `Usage: libretto connect <cdp-url> [--read-only|--write-access] --session <name>`
+  `Usage: ${librettoCommand("connect <cdp-url> [--read-only|--write-access] --session <name>")}`
 ).refine(
   (input) => !(input.readOnly && input.writeAccess),
   "Cannot pass both --read-only and --write-access."
 );
 const connectCommand = SimpleCLI.command({
   description: "Connect to an existing Chrome DevTools Protocol (CDP) endpoint"
-}).input(connectInput).use(withAutoSession()).handle(async ({ input, ctx }) => {
+}).input(connectInput).use(withAutoSession()).use(withExperiments()).handle(async ({ input, ctx }) => {
   warnIfInstalledSkillOutOfDate();
   await runConnectWithLogger(
     input.cdpUrl,
     ctx.session,
     ctx.logger,
-    resolveRequestedSessionMode(input.readOnly, input.writeAccess)
+    resolveRequestedSessionMode(input.readOnly, input.writeAccess),
+    ctx.experiments
   );
 });
 const saveInput = SimpleCLI.input({
@@ -165,7 +165,7 @@ const saveInput = SimpleCLI.input({
   }
 }).refine(
   (input) => Boolean(input.urlOrDomain),
-  `Usage: libretto save <url|domain> --session <name>`
+  `Usage: ${librettoCommand("save <url|domain> --session <name>")}`
 );
 const saveCommand = SimpleCLI.command({
   description: "Save current browser session"
@@ -220,14 +220,14 @@ const closeInput = SimpleCLI.input({
   }
 }).refine(
   (input) => input.all || input.session,
-  `Usage: libretto close <session>
-Usage: libretto close --all [--force]`
+  `Usage: ${librettoCommand("close <session>")}
+Usage: ${librettoCommand("close --all [--force]")}`
 );
 const closeCommand = SimpleCLI.command({
   description: "Close the browser"
 }).input(closeInput).handle(async ({ input }) => {
   if (input.force && !input.all) {
-    throw new Error(`Usage: libretto close --all [--force]`);
+    throw new Error(`Usage: ${librettoCommand("close --all [--force]")}`);
   }
   if (input.all) {
     const logger2 = createLoggerForSession("cli");
@@ -246,11 +246,6 @@ const browserCommands = {
   "session-mode": sessionModeCommand,
   close: closeCommand
 };
-async function runClose(session) {
-  await withSessionLogger(session, async (logger) => {
-    await runCloseWithLogger(session, logger);
-  });
-}
 export {
   browserCommands,
   closeCommand,
@@ -262,7 +257,6 @@ export {
   pagesCommand,
   pagesInput,
   parseViewportArg,
-  runClose,
   saveCommand,
   saveInput,
   sessionModeCommand,