libretto 0.6.4 → 0.6.6

package/dist/cli/commands/setup.js

@@ -19,6 +19,61 @@ import {
   resolveAiSetupStatus
 } from "../core/ai-model.js";
 import { SimpleCLI } from "../framework/simple-cli.js";
+const PROVIDER_SDK_PACKAGES = {
+  openai: "@ai-sdk/openai",
+  anthropic: "@ai-sdk/anthropic",
+  google: "@ai-sdk/google",
+  vertex: "@ai-sdk/google-vertex"
+};
+function detectPackageManager() {
+  if (existsSync(join(REPO_ROOT, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync(join(REPO_ROOT, "yarn.lock"))) return "yarn";
+  if (existsSync(join(REPO_ROOT, "bun.lockb"))) return "bun";
+  return "npm";
+}
+function installCommand(pkgManager) {
+  switch (pkgManager) {
+    case "yarn":
+      return "yarn add";
+    case "bun":
+      return "bun add";
+    case "pnpm":
+      return "pnpm add";
+    default:
+      return "npm install";
+  }
+}
+function isSdkInstalled(sdkPackage) {
+  try {
+    const result = spawnSync("node", ["-e", `require.resolve("${sdkPackage}")`], {
+      cwd: REPO_ROOT,
+      stdio: "pipe"
+    });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+function installSdkIfNeeded(provider) {
+  const sdkPackage = PROVIDER_SDK_PACKAGES[provider];
+  if (isSdkInstalled(sdkPackage)) return;
+  const pkgManager = detectPackageManager();
+  const cmd = installCommand(pkgManager);
+  console.log(`
+Installing ${sdkPackage}...`);
+  const result = spawnSync(cmd, [sdkPackage], {
+    cwd: REPO_ROOT,
+    stdio: "inherit",
+    shell: true
+  });
+  if (result.status === 0) {
+    console.log(`\u2713 Installed ${sdkPackage}`);
+  } else {
+    console.error(
+      `\u2717 Failed to install ${sdkPackage}. Install it manually: ${cmd} ${sdkPackage}`
+    );
+  }
+}
 const PROVIDER_CHOICES = [
   {
     key: "1",
@@ -178,6 +233,7 @@ Unknown choice "${answer}". Skipping API setup.`);
   console.log(`
 Add ${selected.envVar} to your .env file:`);
   console.log(`  ${selected.envHint}`);
+  installSdkIfNeeded(selected.provider);
   return true;
 }
 function printSkipMessage() {
@@ -273,6 +329,13 @@ function detectAgentDirs(root) {
 function copySkills() {
   const agentDirs = detectAgentDirs(REPO_ROOT);
   if (agentDirs.length === 0) {
+    console.log(
+      "\n\u26A0 No .agents/ or .claude/ directory found. Libretto skills were not installed."
+    );
+    console.log(
+      "  Create one of these directories in your repo root and rerun `npx libretto setup` to install skills:"
+    );
+    console.log(`    mkdir ${join(REPO_ROOT, ".claude")}`);
     return;
   }
   let skillsRoot;

package/dist/cli/workers/run-integration-runtime.js

@@ -3,6 +3,7 @@ import { writeFile } from "node:fs/promises";
 import { cwd } from "node:process";
 import { isAbsolute, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
+import { loadProjectEnv } from "../../shared/env/load-env.js";
 import {
   getDefaultWorkflowFromModuleExports,
   getWorkflowsFromModuleExports,
@@ -126,6 +127,10 @@ async function installHeadedWorkflowVisualization(args) {
 async function runIntegrationInternal(args, options) {
   const { logger } = options;
   const absolutePath = getAbsoluteIntegrationPath(args.integrationPath);
+  const envPath = loadProjectEnv(absolutePath);
+  if (envPath) {
+    logger.info("loaded-env", { path: envPath });
+  }
   const workflow = await loadDefaultWorkflow(absolutePath);
   const signalPaths = getPauseSignalPaths(args.session);
   await removeSignalIfExists(signalPaths.pausedSignalPath);

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { attemptWithRecovery } from './runtime/recovery/recovery.js';
 export { DetectedSubmissionError, KnownSubmissionError, detectSubmissionError } from './runtime/recovery/errors.js';
 export { ExtractOptions, extractFromPage } from './runtime/extract/extract.js';
 export { PageRequestOptions, RequestConfig, pageRequest } from './runtime/network/network.js';
-export { DownloadResult, DownloadViaClickOptions, SaveDownloadOptions, downloadAndSave, downloadViaClick } from './runtime/download/download.js';
+export { DownloadResult, DownloadViaClickOptions, downloadViaClick } from './runtime/download/download.js';
 export { pause } from './shared/debug/pause.js';
 export { InstrumentationOptions, InstrumentedPage, installInstrumentation, instrumentContext, instrumentPage } from './shared/instrumentation/instrument.js';
 export { GhostCursorOptions, ensureGhostCursor, ghostClick, hideGhostCursor, moveGhostCursor } from './shared/visualization/ghost-cursor.js';

package/dist/index.js

@@ -29,8 +29,7 @@ import {
   pageRequest
 } from "./runtime/network/network.js";
 import {
-  downloadViaClick,
-  downloadAndSave
+  downloadViaClick
 } from "./runtime/download/download.js";
 import { pause } from "./shared/debug/pause.js";
 import {
@@ -88,7 +87,6 @@ export {
   createFileLogSink,
   defaultLogger,
   detectSubmissionError,
-  downloadAndSave,
   downloadViaClick,
   ensureGhostCursor,
   ensureHighlightLayer,

package/dist/runtime/download/download.d.ts

@@ -20,16 +20,5 @@ type DownloadViaClickOptions = {
  * never missed.
  */
 declare function downloadViaClick(page: Page, selector: string, options?: DownloadViaClickOptions): Promise<DownloadResult>;
-type SaveDownloadOptions = DownloadViaClickOptions & {
-    /** Absolute or relative path to save the file to. When omitted the suggested filename is used in the current working directory. */
-    savePath?: string;
-};
-/**
- * Convenience wrapper around {@link downloadViaClick} that also writes the
- * downloaded file to disk.
- */
-declare function downloadAndSave(page: Page, selector: string, options?: SaveDownloadOptions): Promise<DownloadResult & {
-    savedTo: string;
-}>;
 
-export { type DownloadResult, type DownloadViaClickOptions, type SaveDownloadOptions, downloadAndSave, downloadViaClick };
+export { type DownloadResult, type DownloadViaClickOptions, downloadViaClick };

package/dist/runtime/download/download.js

@@ -1,5 +1,3 @@
-import { writeFile } from "node:fs/promises";
-import { resolve } from "node:path";
 async function downloadViaClick(page, selector, options) {
   const { logger, timeout = 3e4 } = options ?? {};
   const startTime = Date.now();
@@ -27,23 +25,6 @@ async function downloadViaClick(page, selector, options) {
   });
   return { buffer, filename };
 }
-async function downloadAndSave(page, selector, options) {
-  const { savePath, ...downloadOpts } = options ?? {};
-  const { buffer, filename } = await downloadViaClick(
-    page,
-    selector,
-    downloadOpts
-  );
-  const dest = resolve(savePath ?? filename);
-  await writeFile(dest, buffer);
-  options?.logger?.info("download:saved", {
-    filename,
-    savedTo: dest,
-    size: buffer.length
-  });
-  return { buffer, filename, savedTo: dest };
-}
 export {
-  downloadAndSave,
   downloadViaClick
 };

package/dist/runtime/download/index.d.ts

@@ -1,3 +1,3 @@
-export { DownloadResult, DownloadViaClickOptions, SaveDownloadOptions, downloadAndSave, downloadViaClick } from './download.js';
+export { DownloadResult, DownloadViaClickOptions, downloadViaClick } from './download.js';
 import 'playwright';
 import '../../shared/logger/logger.js';

package/dist/runtime/download/index.js

@@ -1,8 +1,6 @@
 import {
-  downloadViaClick,
-  downloadAndSave
+  downloadViaClick
 } from "./download.js";
 export {
-  downloadAndSave,
   downloadViaClick
 };

package/dist/shared/env/load-env.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Load the nearest `.env` file above `scriptPath`.
+ * Existing `process.env` values are never overridden.
+ * Returns the path of the loaded `.env`, or `null` if none was found.
+ */
+declare function loadProjectEnv(scriptPath: string): string | null;
+
+export { loadProjectEnv };

package/dist/shared/env/load-env.js

@@ -0,0 +1,42 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+function findNearestEnv(startDir) {
+  let dir = startDir;
+  while (true) {
+    const envPath = join(dir, ".env");
+    if (existsSync(envPath)) return envPath;
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function parseEnvFile(content) {
+  const vars = {};
+  for (const raw of content.split("\n")) {
+    const line = raw.trim();
+    if (!line || line.startsWith("#")) continue;
+    const eqIndex = line.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = line.slice(0, eqIndex).trim();
+    let value = line.slice(eqIndex + 1).trim();
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      value = value.slice(1, -1);
+    }
+    vars[key] = value;
+  }
+  return vars;
+}
+function loadProjectEnv(scriptPath) {
+  const envPath = findNearestEnv(dirname(scriptPath));
+  if (!envPath) return null;
+  const vars = parseEnvFile(readFileSync(envPath, "utf8"));
+  for (const [key, value] of Object.entries(vars)) {
+    if (process.env[key] === void 0) {
+      process.env[key] = value;
+    }
+  }
+  return envPath;
+}
+export {
+  loadProjectEnv
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libretto",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "description": "AI-powered browser automation library and CLI built on Playwright",
   "license": "MIT",
   "homepage": "https://libretto.sh",

package/src/cli/commands/setup.ts

@@ -22,6 +22,66 @@ import {
 import type { Provider } from "../core/resolve-model.js";
 import { SimpleCLI } from "../framework/simple-cli.js";
 
+const PROVIDER_SDK_PACKAGES: Record<Provider, string> = {
+  openai: "@ai-sdk/openai",
+  anthropic: "@ai-sdk/anthropic",
+  google: "@ai-sdk/google",
+  vertex: "@ai-sdk/google-vertex",
+};
+
+function detectPackageManager(): string {
+  if (existsSync(join(REPO_ROOT, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync(join(REPO_ROOT, "yarn.lock"))) return "yarn";
+  if (existsSync(join(REPO_ROOT, "bun.lockb"))) return "bun";
+  return "npm";
+}
+
+function installCommand(pkgManager: string): string {
+  switch (pkgManager) {
+    case "yarn":
+      return "yarn add";
+    case "bun":
+      return "bun add";
+    case "pnpm":
+      return "pnpm add";
+    default:
+      return "npm install";
+  }
+}
+
+function isSdkInstalled(sdkPackage: string): boolean {
+  try {
+    const result = spawnSync("node", ["-e", `require.resolve("${sdkPackage}")`], {
+      cwd: REPO_ROOT,
+      stdio: "pipe",
+    });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+
+function installSdkIfNeeded(provider: Provider): void {
+  const sdkPackage = PROVIDER_SDK_PACKAGES[provider];
+  if (isSdkInstalled(sdkPackage)) return;
+
+  const pkgManager = detectPackageManager();
+  const cmd = installCommand(pkgManager);
+  console.log(`\nInstalling ${sdkPackage}...`);
+  const result = spawnSync(cmd, [sdkPackage], {
+    cwd: REPO_ROOT,
+    stdio: "inherit",
+    shell: true,
+  });
+  if (result.status === 0) {
+    console.log(`✓ Installed ${sdkPackage}`);
+  } else {
+    console.error(
+      `✗ Failed to install ${sdkPackage}. Install it manually: ${cmd} ${sdkPackage}`,
+    );
+  }
+}
+
 export type ProviderChoice = {
   key: string;
   label: string;
@@ -250,6 +310,7 @@ async function promptProviderSelection(
   console.log(`\n✓ ${selected.label} selected (model: ${model}).`);
   console.log(`\nAdd ${selected.envVar} to your .env file:`);
   console.log(`  ${selected.envHint}`);
+  installSdkIfNeeded(selected.provider);
   return true;
 }
 
@@ -369,6 +430,13 @@ function copySkills(): void {
   const agentDirs = detectAgentDirs(REPO_ROOT);
 
   if (agentDirs.length === 0) {
+    console.log(
+      "\n⚠ No .agents/ or .claude/ directory found. Libretto skills were not installed.",
+    );
+    console.log(
+      "  Create one of these directories in your repo root and rerun `npx libretto setup` to install skills:",
+    );
+    console.log(`    mkdir ${join(REPO_ROOT, ".claude")}`);
     return;
   }
 

package/src/cli/workers/run-integration-runtime.ts

@@ -4,6 +4,7 @@ import { mkdir, writeFile } from "node:fs/promises";
 import { cwd } from "node:process";
 import { isAbsolute, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
+import { loadProjectEnv } from "../../shared/env/load-env.js";
 import {
   getDefaultWorkflowFromModuleExports,
   getWorkflowsFromModuleExports,
@@ -194,6 +195,12 @@ async function runIntegrationInternal(
 ): Promise<RunIntegrationOutcome> {
   const { logger } = options;
   const absolutePath = getAbsoluteIntegrationPath(args.integrationPath);
+
+  const envPath = loadProjectEnv(absolutePath);
+  if (envPath) {
+    logger.info("loaded-env", { path: envPath });
+  }
+
   const workflow = await loadDefaultWorkflow(absolutePath);
   const signalPaths = getPauseSignalPaths(args.session);
   await removeSignalIfExists(signalPaths.pausedSignalPath);

package/src/index.ts

@@ -53,10 +53,8 @@ export {
 // Download helpers
 export {
   downloadViaClick,
-  downloadAndSave,
   type DownloadResult,
   type DownloadViaClickOptions,
-  type SaveDownloadOptions,
 } from "./runtime/download/download.js";
 
 // Debug / Pause

package/src/runtime/download/download.ts

@@ -1,5 +1,3 @@
-import { writeFile } from "node:fs/promises";
-import { resolve } from "node:path";
 import type { Page, Download } from "playwright";
 import type { MinimalLogger } from "../../shared/logger/logger.js";
 
@@ -70,35 +68,3 @@ export async function downloadViaClick(
   return { buffer, filename };
 }
 
-export type SaveDownloadOptions = DownloadViaClickOptions & {
-  /** Absolute or relative path to save the file to. When omitted the suggested filename is used in the current working directory. */
-  savePath?: string;
-};
-
-/**
- * Convenience wrapper around {@link downloadViaClick} that also writes the
- * downloaded file to disk.
- */
-export async function downloadAndSave(
-  page: Page,
-  selector: string,
-  options?: SaveDownloadOptions,
-): Promise<DownloadResult & { savedTo: string }> {
-  const { savePath, ...downloadOpts } = options ?? {};
-  const { buffer, filename } = await downloadViaClick(
-    page,
-    selector,
-    downloadOpts,
-  );
-
-  const dest = resolve(savePath ?? filename);
-  await writeFile(dest, buffer);
-
-  options?.logger?.info("download:saved", {
-    filename,
-    savedTo: dest,
-    size: buffer.length,
-  });
-
-  return { buffer, filename, savedTo: dest };
-}

package/src/runtime/download/index.ts

@@ -1,7 +1,5 @@
 export {
   downloadViaClick,
-  downloadAndSave,
   type DownloadResult,
   type DownloadViaClickOptions,
-  type SaveDownloadOptions,
 } from "./download.js";

package/src/shared/env/load-env.ts

@@ -0,0 +1,61 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+
+/**
+ * Walk up from `startDir` until a `.env` file is found.
+ * Returns the full path to the `.env`, or `null` if the filesystem root is reached.
+ */
+function findNearestEnv(startDir: string): string | null {
+  let dir = startDir;
+  while (true) {
+    const envPath = join(dir, ".env");
+    if (existsSync(envPath)) return envPath;
+    const parent = dirname(dir);
+    if (parent === dir) return null; // filesystem root
+    dir = parent;
+  }
+}
+
+/**
+ * Parse a `.env` file into key-value pairs.
+ * Handles KEY=VALUE, KEY="VALUE", KEY='VALUE', comments (#), and blank lines.
+ * Does not support multiline values or variable interpolation.
+ */
+function parseEnvFile(content: string): Record<string, string> {
+  const vars: Record<string, string> = {};
+  for (const raw of content.split("\n")) {
+    const line = raw.trim();
+    if (!line || line.startsWith("#")) continue;
+    const eqIndex = line.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = line.slice(0, eqIndex).trim();
+    let value = line.slice(eqIndex + 1).trim();
+    // Strip matching quotes
+    if (
+      (value.startsWith('"') && value.endsWith('"')) ||
+      (value.startsWith("'") && value.endsWith("'"))
+    ) {
+      value = value.slice(1, -1);
+    }
+    vars[key] = value;
+  }
+  return vars;
+}
+
+/**
+ * Load the nearest `.env` file above `scriptPath`.
+ * Existing `process.env` values are never overridden.
+ * Returns the path of the loaded `.env`, or `null` if none was found.
+ */
+export function loadProjectEnv(scriptPath: string): string | null {
+  const envPath = findNearestEnv(dirname(scriptPath));
+  if (!envPath) return null;
+
+  const vars = parseEnvFile(readFileSync(envPath, "utf8"));
+  for (const [key, value] of Object.entries(vars)) {
+    if (process.env[key] === undefined) {
+      process.env[key] = value;
+    }
+  }
+  return envPath;
+}