libretto 0.5.6 → 0.6.0

package/dist/cli/commands/browser.js

@@ -5,9 +5,14 @@ import {
   runCloseAll as runCloseAllWithLogger,
   runConnect as runConnectWithLogger,
   runOpen,
+  runOpenWithProvider,
   runPages,
   runSave
 } from "../core/browser.js";
+import {
+  resolveProviderName,
+  getCloudProviderApi
+} from "../core/providers/index.js";
 import { readLibrettoConfig } from "../core/config.js";
 import { createLoggerForSession, withSessionLogger } from "../core/context.js";
 import {
@@ -65,6 +70,10 @@ const openInput = SimpleCLI.input({
     }),
     viewport: SimpleCLI.option(z.string().optional(), {
       help: "Viewport size as WIDTHxHEIGHT (e.g. 1920x1080)"
+    }),
+    provider: SimpleCLI.option(z.string().optional(), {
+      help: "Browser provider (local, kernel, browserbase)",
+      aliases: ["-p"]
     })
   }
 }).refine(
@@ -82,12 +91,28 @@ const openCommand = SimpleCLI.command({
 }).input(openInput).use(withAutoSession()).handle(async ({ input, ctx }) => {
   warnIfInstalledSkillOutOfDate();
   assertSessionAvailableForStart(ctx.session, ctx.logger);
-  const headed = input.headed || !input.headless;
-  const viewport = parseViewportArg(input.viewport);
-  await runOpen(input.url, headed, ctx.session, ctx.logger, {
-    viewport,
-    accessMode: resolveRequestedSessionMode(input.readOnly, input.writeAccess)
-  });
+  const providerName = resolveProviderName(input.provider);
+  if (providerName === "local") {
+    const headed = input.headed || !input.headless;
+    const viewport = parseViewportArg(input.viewport);
+    await runOpen(input.url, headed, ctx.session, ctx.logger, {
+      viewport,
+      accessMode: resolveRequestedSessionMode(
+        input.readOnly,
+        input.writeAccess
+      )
+    });
+  } else {
+    const provider = getCloudProviderApi(providerName);
+    await runOpenWithProvider(
+      input.url,
+      providerName,
+      provider,
+      ctx.session,
+      ctx.logger,
+      resolveRequestedSessionMode(input.readOnly, input.writeAccess)
+    );
+  }
 });
 const connectInput = SimpleCLI.input({
   positionals: [

package/dist/cli/commands/execution.js

@@ -25,6 +25,7 @@ import {
   wrapPageForActionLogging
 } from "../core/telemetry.js";
 import { readLibrettoConfig } from "../core/config.js";
+import { resolveProviderName, getCloudProviderApi } from "../core/providers/index.js";
 import { createReadonlyExecHelpers } from "../core/readonly-exec.js";
 import { SimpleCLI } from "../framework/simple-cli.js";
 import {
@@ -462,7 +463,9 @@ async function runIntegrationFromFile(args, logger) {
     visualize: args.visualize,
     authProfileDomain: args.authProfileDomain,
     viewport: args.viewport,
-    accessMode: args.accessMode
+    accessMode: args.accessMode,
+    cdpEndpoint: args.cdpEndpoint,
+    provider: args.provider
   });
   const worker = spawn(
     process.execPath,
@@ -625,6 +628,10 @@ const runInput = SimpleCLI.input({
     }),
     viewport: SimpleCLI.option(z.string().optional(), {
       help: "Viewport size as WIDTHxHEIGHT (e.g. 1920x1080)"
+    }),
+    provider: SimpleCLI.option(z.string().optional(), {
+      help: "Browser provider (local, kernel, browserbase)",
+      aliases: ["-p"]
     })
   }
 }).refine(
@@ -670,20 +677,52 @@ const runCommand = SimpleCLI.command({
     parseViewportArg(input.viewport),
     ctx.logger
   );
-  await runIntegrationFromFile(
-    {
-      integrationPath: input.integrationFile,
-      session: ctx.session,
-      params,
-      tsconfigPath: input.tsconfig,
-      headless: headlessMode ?? false,
-      visualize,
-      authProfileDomain: input.authProfile,
-      viewport,
-      accessMode: input.readOnly ? "read-only" : input.writeAccess ? "write-access" : readLibrettoConfig().sessionMode ?? "write-access"
-    },
-    ctx.logger
-  );
+  const providerName = resolveProviderName(input.provider);
+  let cdpEndpoint;
+  let providerInfo;
+  let provider;
+  if (providerName !== "local") {
+    provider = getCloudProviderApi(providerName);
+    console.log(
+      `Creating ${providerName} browser session (session: ${ctx.session})...`
+    );
+    const providerSession = await provider.createSession();
+    console.log(`Connecting to ${providerName} browser...`);
+    cdpEndpoint = providerSession.cdpEndpoint;
+    providerInfo = {
+      name: providerName,
+      sessionId: providerSession.sessionId
+    };
+  }
+  try {
+    await runIntegrationFromFile(
+      {
+        integrationPath: input.integrationFile,
+        session: ctx.session,
+        params,
+        tsconfigPath: input.tsconfig,
+        headless: cdpEndpoint ? true : headlessMode ?? false,
+        visualize,
+        authProfileDomain: input.authProfile,
+        viewport,
+        accessMode: input.readOnly ? "read-only" : input.writeAccess ? "write-access" : readLibrettoConfig().sessionMode ?? "write-access",
+        cdpEndpoint,
+        provider: providerInfo
+      },
+      ctx.logger
+    );
+  } finally {
+    if (provider && providerInfo) {
+      try {
+        await provider.closeSession(providerInfo.sessionId);
+      } catch (cleanupErr) {
+        console.error(
+          `Failed to clean up ${providerInfo.name} session ${providerInfo.sessionId}:`,
+          cleanupErr instanceof Error ? cleanupErr.message : cleanupErr
+        );
+      }
+    }
+  }
 });
 const resumeInput = SimpleCLI.input({
   positionals: [],

package/dist/cli/commands/setup.js

@@ -60,6 +60,14 @@ function promptUser(rl, question) {
     });
   });
 }
+function providerLabel(provider) {
+  const choice = PROVIDER_CHOICES.find((c) => c.provider === provider);
+  return choice?.label ?? provider;
+}
+function sourceEnvVar(source) {
+  if (source.startsWith("env:")) return source.slice(4);
+  return null;
+}
 function ensurePinnedDefaultModel(status) {
   if (status.source !== "config") {
     writeAiConfig(status.model);
@@ -68,17 +76,23 @@ function ensurePinnedDefaultModel(status) {
   return status;
 }
 function printHealthySummary(status) {
-  console.log(`  \u2713 Model: ${status.model}`);
-  console.log(`  Config: ${LIBRETTO_CONFIG_PATH}`);
+  const envVar = sourceEnvVar(status.source);
+  if (envVar) {
+    console.log(
+      `\u2713 Detected ${envVar}. Using ${providerLabel(status.provider)}.`
+    );
+  } else {
+    console.log(`\u2713 Using ${providerLabel(status.provider)} (${status.model}).`);
+  }
   console.log(
-    "  To change: npx libretto ai configure openai | anthropic | gemini | vertex"
+    "To change: npx libretto ai configure openai | anthropic | gemini | vertex"
   );
 }
 function printInvalidAiConfigWarning(status) {
   if (status.kind !== "invalid-config") return;
-  console.log("  ! Existing AI config is invalid:");
+  console.log("! Existing AI config is invalid:");
   for (const line of status.message.split("\n")) {
-    console.log(`    ${line}`);
+    console.log(`  ${line}`);
   }
 }
 function buildRepairPlan(status) {
@@ -98,49 +112,47 @@ function buildRepairPlan(status) {
   return { kind: "no-repair-needed" };
 }
 function formatMissingCredentialsMessage(plan) {
-  return [
-    `  \u2717 ${plan.provider} is configured (model: ${plan.model}), but ${plan.envVar} is not set.`
-  ].join("\n");
+  return `\u2717 ${plan.provider} is configured (model: ${plan.model}), but ${plan.envVar} is not set.`;
 }
 function printSnapshotApiStatus() {
   const status = resolveAiSetupStatus();
-  const envPath = join(REPO_ROOT, ".env");
-  console.log("\nSnapshot analysis:");
   console.log(
-    "  Libretto uses direct API calls for snapshot analysis when supported credentials are available."
+    "\nLibretto uses a sub-agent to analyze DOM snapshots. The model is determined by environment variables."
   );
-  console.log(`  Credentials are loaded from process env and ${envPath}.`);
   if (status.kind === "ready") {
-    const pinned = ensurePinnedDefaultModel(status);
-    printHealthySummary(pinned);
+    console.log();
+    printHealthySummary(status);
+    ensurePinnedDefaultModel(status);
     return true;
   }
   const plan = buildRepairPlan(status);
   if (plan.kind === "repair-missing-credentials") {
+    console.log();
     console.log(formatMissingCredentialsMessage(plan));
     console.log(
-      `    To fix: add ${plan.envVar} to .env, or run \`npx libretto setup\` interactively to repair.`
+      `  To fix: add ${plan.envVar} to .env, or run \`npx libretto setup\` interactively to repair.`
     );
     return false;
   }
   if (plan.kind === "repair-invalid-config") {
     printInvalidAiConfigWarning(status);
-    console.log("    Run `npx libretto setup` interactively to reconfigure.");
+    console.log("  Run `npx libretto setup` interactively to reconfigure.");
     return false;
   }
-  console.log("  \u2717 No snapshot API credentials detected.");
-  console.log("    Add one provider to .env:");
-  console.log("      OPENAI_API_KEY=...");
-  console.log("      ANTHROPIC_API_KEY=...");
-  console.log("      GEMINI_API_KEY=...  # or GOOGLE_GENERATIVE_AI_API_KEY");
+  console.log();
+  console.log("\u2717 No snapshot API credentials detected.");
+  console.log("  Add one provider to .env:");
+  console.log("    OPENAI_API_KEY=...");
+  console.log("    ANTHROPIC_API_KEY=...");
+  console.log("    GEMINI_API_KEY=...  # or GOOGLE_GENERATIVE_AI_API_KEY");
   console.log(
-    "      GOOGLE_CLOUD_PROJECT=...  # plus application default credentials for Vertex"
+    "    GOOGLE_CLOUD_PROJECT=...  # plus application default credentials for Vertex"
   );
   console.log(
-    "    Or run `npx libretto ai configure openai | anthropic | gemini | vertex` to set a specific model."
+    "  Or run `npx libretto ai configure openai | anthropic | gemini | vertex` to set a specific model."
   );
   console.log(
-    "    Run `npx libretto setup` interactively to set up credentials."
+    "  Run `npx libretto setup` interactively to set up credentials."
   );
   return false;
 }
@@ -157,42 +169,45 @@ function writeEnvVar(envVar, value, envPath) {
     );
     writeFileSync(envPath, updated);
     console.log(`
-  \u2713 Updated ${envVar} in ${envPath}`);
+\u2713 Updated ${envVar} in ${envPath}`);
   } else {
     const separator = envContent && !envContent.endsWith("\n") ? "\n" : "";
     appendFileSync(envPath, `${separator}${envLine}
 `);
     console.log(`
-  \u2713 Added ${envVar} to ${envPath}`);
+\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}
+${choice.label} selected.`);
+  console.log(`${choice.envHint}
 `);
-  const apiKeyValue = await promptUser(rl, `  Enter your ${choice.envVar}: `);
+  const apiKeyValue = await promptUser(rl, `Enter your ${choice.envVar}: `);
   if (!apiKeyValue) {
-    console.log("\n  No value entered. Skipping API key setup.");
+    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(`\u2713 Snapshot API ready: ${model}`);
+  console.log(
+    "To change: npx libretto ai configure openai | anthropic | gemini | vertex"
+  );
   return true;
 }
 async function promptProviderSelection(rl, envPath) {
   console.log(
-    "  Which API provider would you like to use for snapshot analysis?\n"
+    "Which model provider would you like to use for snapshot analysis?\n"
   );
   for (const choice of PROVIDER_CHOICES) {
-    console.log(`    ${choice.key}) ${choice.label}`);
+    console.log(`  ${choice.key}) ${choice.label}`);
   }
-  console.log("    s) Skip for now\n");
-  const answer = await promptUser(rl, "  Choice: ");
+  console.log("  s) Skip for now\n");
+  const answer = await promptUser(rl, "Choice: ");
   if (answer.toLowerCase() === "s" || !answer) {
     printSkipMessage();
     return false;
@@ -200,32 +215,33 @@ async function promptProviderSelection(rl, envPath) {
   const selected = PROVIDER_CHOICES.find((choice) => choice.key === answer);
   if (!selected) {
     console.log(`
-  Unknown choice "${answer}". Skipping API setup.`);
+Unknown choice "${answer}". Skipping API setup.`);
     return false;
   }
   return promptForCredential(rl, selected, envPath);
 }
 function printSkipMessage() {
   console.log(
-    "\n  Skipped. You can set up API credentials later by rerunning `npx libretto setup`."
+    "\nSkipped. You can set up API credentials later by rerunning `npx libretto setup`."
   );
-  console.log("  Or add credentials directly to your .env file:");
-  console.log("    OPENAI_API_KEY=...");
-  console.log("    ANTHROPIC_API_KEY=...");
-  console.log("    GEMINI_API_KEY=...");
+  console.log("Or add credentials directly to your .env file:");
+  console.log("  OPENAI_API_KEY=...");
+  console.log("  ANTHROPIC_API_KEY=...");
+  console.log("  GEMINI_API_KEY=...");
   console.log(
-    "    Or run `npx libretto ai configure openai | anthropic | gemini | vertex` to set a specific model."
+    "  Or run `npx libretto ai configure openai | anthropic | gemini | vertex` to set a specific model."
   );
 }
 async function runInteractiveApiSetup() {
   const status = resolveAiSetupStatus();
   const envPath = join(REPO_ROOT, ".env");
-  console.log("\nSnapshot analysis setup:");
-  console.log("  Libretto uses direct API calls for snapshot analysis.");
-  console.log(`  Credentials are loaded from process env and ${envPath}.`);
+  console.log(
+    "\nLibretto uses a sub-agent to analyze DOM snapshots. The model is determined by environment variables."
+  );
   if (status.kind === "ready") {
-    const pinned = ensurePinnedDefaultModel(status);
-    printHealthySummary(pinned);
+    console.log();
+    printHealthySummary(status);
+    ensurePinnedDefaultModel(status);
     return;
   }
   const plan = buildRepairPlan(status);
@@ -237,11 +253,11 @@ async function runInteractiveApiSetup() {
     if (plan.kind === "repair-missing-credentials") {
       console.log(formatMissingCredentialsMessage(plan));
       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("    s) Skip for now\n");
-      const answer = await promptUser(rl, "  Choice: ");
+      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("  s) Skip for now\n");
+      const answer = await promptUser(rl, "Choice: ");
       if (answer === "1") {
         const matchingChoice = PROVIDER_CHOICES.find(
           (c) => c.provider === plan.provider
@@ -261,28 +277,28 @@ async function runInteractiveApiSetup() {
     if (plan.kind === "repair-invalid-config") {
       printInvalidAiConfigWarning(status);
       console.log(
-        "\n  Would you like to reconfigure with a fresh provider selection?\n"
+        "\nWould you like to reconfigure with a fresh provider selection?\n"
       );
       await promptProviderSelection(rl, envPath);
       return;
     }
-    console.log("  \u2717 No snapshot API credentials detected.\n");
+    console.log("\u2717 No snapshot API credentials detected.\n");
     await promptProviderSelection(rl, envPath);
   } finally {
     rl.close();
   }
 }
 function installBrowsers() {
-  console.log("\nInstalling Playwright Chromium...");
+  console.log("Installing Playwright Chromium...");
   const result = spawnSync("npx", ["playwright", "install", "chromium"], {
     stdio: "inherit",
     shell: true
   });
   if (result.status === 0) {
-    console.log("  \u2713 Playwright Chromium installed");
+    console.log("\u2713 Playwright Chromium installed");
   } else {
     console.error(
-      "  \u2717 Failed to install Playwright Chromium. Run manually: npx playwright install chromium"
+      "\u2717 Failed to install Playwright Chromium. Run manually: npx playwright install chromium"
     );
   }
 }
@@ -306,16 +322,13 @@ function detectAgentDirs(root) {
 function copySkills() {
   const agentDirs = detectAgentDirs(REPO_ROOT);
   if (agentDirs.length === 0) {
-    console.log(
-      "\nSkills: No .agents/ or .claude/ directory found in repo root \u2014 skipping."
-    );
     return;
   }
   let skillsRoot;
   try {
     skillsRoot = getPackageSkillsRoot();
   } catch (e) {
-    console.error(`  \u2717 ${e instanceof Error ? e.message : String(e)}`);
+    console.error(`\u2717 ${e instanceof Error ? e.message : String(e)}`);
     return;
   }
   const skillNames = readdirSync(skillsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
@@ -330,7 +343,7 @@ function copySkills() {
       cpSync(sourceDir, skillDest, { recursive: true });
       const fileCount = readdirSync(skillDest).length;
       console.log(
-        `  \u2713 Copied ${fileCount} skill files to ${agentName}/skills/${skillName}/`
+        `\u2713 Copied ${fileCount} skill files to ${agentName}/skills/${skillName}/`
       );
     }
   }
@@ -347,12 +360,11 @@ const setupInput = SimpleCLI.input({
 const setupCommand = SimpleCLI.command({
   description: "Set up libretto in the current project"
 }).input(setupInput).handle(async ({ input }) => {
-  console.log("Setting up libretto...\n");
   ensureLibrettoSetup();
   if (!input.skipBrowsers) {
     installBrowsers();
   } else {
-    console.log("\nSkipping browser installation (--skip-browsers)");
+    console.log("Skipping browser installation (--skip-browsers)");
   }
   copySkills();
   if (process.stdin.isTTY) {
@@ -365,6 +377,8 @@ const setupCommand = SimpleCLI.command({
       );
     }
   }
+  console.log(`
+Config set up at ${LIBRETTO_CONFIG_PATH}`);
   console.log("\n\u2713 libretto setup complete");
 });
 export {

package/dist/cli/commands/status.js

@@ -45,7 +45,7 @@ function printOpenSessions(sessions) {
   }
   for (const session of sessions) {
     const statusLabel = session.status ? ` [${session.status}]` : "";
-    const endpoint = `http://127.0.0.1:${session.port}`;
+    const endpoint = session.provider ? `${session.provider.name} (${session.cdpEndpoint})` : `http://127.0.0.1:${session.port}`;
     console.log(`  ${session.session}${statusLabel} \u2014 ${endpoint}`);
   }
 }