libretto 0.6.5 → 0.6.7-experimental.0

package/dist/cli/commands/setup.js

@@ -330,7 +330,7 @@ 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."
+      "\n\u26A0\uFE0F 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:"

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,48 @@
+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 withoutExport = line.startsWith("export ") ? line.slice("export ".length).trimStart() : line;
+    const eqIndex = withoutExport.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = withoutExport.slice(0, eqIndex).trim();
+    let value = withoutExport.slice(eqIndex + 1).trim();
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      value = value.slice(1, -1);
+    } else {
+      const commentIndex = value.search(/\s#/);
+      if (commentIndex >= 0) {
+        value = value.slice(0, commentIndex).trimEnd();
+      }
+    }
+    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.5",
+  "version": "0.6.7-experimental.0",
   "description": "AI-powered browser automation library and CLI built on Playwright",
   "license": "MIT",
   "homepage": "https://libretto.sh",

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.4"
+  version: "0.6.6"
 ---
 
 ## How Libretto Works

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.4"
+  version: "0.6.6"
 ---
 
 ## How Libretto Read-Only Works

package/src/cli/commands/setup.ts

@@ -431,7 +431,7 @@ function copySkills(): void {
 
   if (agentDirs.length === 0) {
     console.log(
-      "\n⚠ No .agents/ or .claude/ directory found. Libretto skills were not installed.",
+      "\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:",

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,70 @@
+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 withoutExport = line.startsWith("export ")
+      ? line.slice("export ".length).trimStart()
+      : line;
+    const eqIndex = withoutExport.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = withoutExport.slice(0, eqIndex).trim();
+    let value = withoutExport.slice(eqIndex + 1).trim();
+    // Strip matching quotes
+    if (
+      (value.startsWith('"') && value.endsWith('"')) ||
+      (value.startsWith("'") && value.endsWith("'"))
+    ) {
+      value = value.slice(1, -1);
+    } else {
+      // Strip inline comments from unquoted values
+      const commentIndex = value.search(/\s#/);
+      if (commentIndex >= 0) {
+        value = value.slice(0, commentIndex).trimEnd();
+      }
+    }
+    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;
+}