libretto 0.6.10 → 0.6.12

package/README.md

@@ -78,11 +78,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 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 --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
 ```
 
+`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

@@ -76,11 +76,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 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 --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
 ```
 
+`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,5 +1,6 @@
 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";
@@ -21,17 +22,17 @@ function printSetupAudit() {
       break;
     case "configured-missing-credentials":
       console.log(
-        `\u2717 ${status.provider} configured (model: ${status.model}), but credentials are missing. Run \`npx libretto setup\` to repair.`
+        `\u2717 ${status.provider} configured (model: ${status.model}), but credentials are missing. Run \`${librettoCommand("setup")}\` to repair.`
       );
       break;
     case "invalid-config":
       console.log(
-        `\u2717 AI config is invalid. Run \`npx libretto setup\` to reconfigure.`
+        `\u2717 AI config is invalid. Run \`${librettoCommand("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.`
+        `\u2717 No AI model configured. Run \`${librettoCommand("setup")}\` or \`${librettoCommand("ai configure")}\` to set up.`
       );
       break;
   }

package/dist/cli/commands/ai.js

@@ -6,6 +6,7 @@ import {
 } from "../core/config.js";
 import { LIBRETTO_CONFIG_PATH } from "../core/context.js";
 import { DEFAULT_SNAPSHOT_MODELS } from "../core/ai-model.js";
+import { librettoCommand } from "../../shared/package-manager.js";
 import { SimpleCLI } from "../framework/simple-cli.js";
 const PROVIDER_ALIASES = {
   claude: DEFAULT_SNAPSHOT_MODELS.anthropic,
@@ -33,7 +34,7 @@ function resolveModelFromInput(input) {
   return DEFAULT_SNAPSHOT_MODELS[normalized] ?? PROVIDER_ALIASES[normalized] ?? null;
 }
 function runAiConfigure(input, options = {}) {
-  const configureCommandName = options.configureCommandName ?? "npx libretto ai configure";
+  const configureCommandName = options.configureCommandName ?? librettoCommand("ai configure");
   const configPath = options.configPath ?? LIBRETTO_CONFIG_PATH;
   const presetArg = input.preset?.trim();
   if (!presetArg && !input.clear) {
@@ -96,7 +97,7 @@ const aiCommands = SimpleCLI.group({
           preset: input.preset
         },
         {
-          configureCommandName: `libretto ai configure`
+          configureCommandName: librettoCommand("ai configure")
         }
       );
     })

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 { 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");