libretto 0.4.2 → 0.5.0

package/dist/shared/debug/pause.d.ts

@@ -1,7 +1,3 @@
-/**
- * Called by the CLI runtime to make the session name available to `pause()`.
- */
-declare function setSessionForPause(session: string): void;
 /**
  * Standalone pause function.
  *
@@ -11,6 +7,6 @@ declare function setSessionForPause(session: string): void;
  *
  * Import directly: `import { pause } from "libretto";`
  */
-declare function pause(): Promise<void>;
+declare function pause(session: string): Promise<void>;
 
-export { pause, setSessionForPause };
+export { pause };

package/dist/shared/debug/pause.js

@@ -1,32 +1,40 @@
 import { existsSync } from "node:fs";
 import { mkdir, writeFile } from "node:fs/promises";
-let _sessionName;
-function setSessionForPause(session) {
-  _sessionName = session;
-}
-function getSessionFromProcessArgs() {
-  const rawPayload = process.argv[2];
-  if (!rawPayload) return void 0;
+import { getSessionDir } from "../../cli/core/context.js";
+import { getPauseSignalPaths, removeSignalIfExists } from "../../cli/core/pause-signals.js";
+import { listSessionsWithStateFile, readSessionState } from "../../cli/core/session.js";
+function isPidRunning(pid) {
   try {
-    const parsed = JSON.parse(rawPayload);
-    return typeof parsed.session === "string" ? parsed.session : void 0;
+    process.kill(pid, 0);
+    return true;
   } catch {
-    return void 0;
+    return false;
   }
 }
-function resolveSession() {
-  return _sessionName ?? getSessionFromProcessArgs();
+function getRunningSessions() {
+  return listSessionsWithStateFile().filter((candidate) => {
+    const state = readSessionState(candidate);
+    return state !== null && isPidRunning(state.pid);
+  });
+}
+function throwMissingSessionError() {
+  const runningSessions = getRunningSessions();
+  const lines = ["pause(session) requires a non-empty session ID."];
+  if (runningSessions.length > 0) {
+    lines.push("", "Running sessions:");
+    for (const runningSession of runningSessions) {
+      lines.push(`  ${runningSession}`);
+    }
+  }
+  throw new Error(lines.join("\n"));
 }
-async function pause() {
+async function pause(session) {
   if (process.env.NODE_ENV === "production") {
     return;
   }
-  const session = resolveSession();
-  if (!session) {
-    return;
+  if (typeof session !== "string" || session.trim().length === 0) {
+    throwMissingSessionError();
   }
-  const { getPauseSignalPaths, removeSignalIfExists } = await import("../../cli/core/pause-signals.js");
-  const { getSessionDir } = await import("../../cli/core/context.js");
   const signalPaths = getPauseSignalPaths(session);
   const { pausedSignalPath, resumeSignalPath } = signalPaths;
   await mkdir(getSessionDir(session), { recursive: true });
@@ -50,6 +58,5 @@ async function pause() {
   console.log("[pause] Resume signal received. Continuing workflow...");
 }
 export {
-  pause,
-  setSessionForPause
+  pause
 };

package/dist/shared/llm/client.js

@@ -26,7 +26,7 @@ function parseModel(model) {
   const slashIndex = model.indexOf("/");
   if (slashIndex === -1) {
     throw new Error(
-      `Invalid model string "${model}". Expected format: "provider/model-id" (for example "openai/gpt-5.4", "anthropic/claude-sonnet-4-6", "google/gemini-2.5-pro", or "vertex/gemini-2.5-pro").`
+      `Invalid model string "${model}". Expected format: "provider/model-id" (for example "openai/gpt-5.4", "anthropic/claude-sonnet-4-6", "google/gemini-3-flash-preview", or "vertex/gemini-2.5-pro").`
     );
   }
   const providerInput = model.slice(0, slashIndex).toLowerCase();
@@ -54,14 +54,14 @@ function hasProviderCredentials(provider, env = process.env) {
 function missingProviderCredentialsMessage(provider) {
   switch (provider) {
     case "google":
-      return "Missing Gemini API key. Set GEMINI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY.";
+      return "Gemini API key is missing. Set GEMINI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY.";
     case "vertex":
-      return "Missing Vertex AI project. Set GOOGLE_CLOUD_PROJECT (or GCLOUD_PROJECT) and ensure application default credentials are configured.";
+      return "Vertex AI project is missing. Set GOOGLE_CLOUD_PROJECT (or GCLOUD_PROJECT) and ensure application default credentials are configured.";
     case "anthropic": {
-      return "Missing Anthropic API key. Set ANTHROPIC_API_KEY.";
+      return "Anthropic API key is missing. Set ANTHROPIC_API_KEY.";
     }
     case "openai": {
-      return "Missing OpenAI API key. Set OPENAI_API_KEY.";
+      return "OpenAI API key is missing. Set OPENAI_API_KEY.";
     }
   }
 }

package/dist/shared/paths/paths.js

@@ -1,5 +1,6 @@
 import { mkdirSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { resolveLibrettoRepoRoot } from "./repo-root.js";
 const LIBRETTO_DIRNAME = ".libretto";
 const LIBRETTO_SESSIONS_DIRNAME = "sessions";
 const SESSION_STATE_FILENAME = "state.json";
@@ -8,7 +9,7 @@ const RUNNER_LOG_FILENAME = "logs.jsonl";
 const PAUSED_SIGNAL_SUFFIX = "paused";
 const RESUME_SIGNAL_SUFFIX = "resume";
 function getLibrettoRoot(cwd = process.cwd()) {
-  return join(cwd, LIBRETTO_DIRNAME);
+  return join(resolveLibrettoRepoRoot(cwd), LIBRETTO_DIRNAME);
 }
 function getLibrettoSessionsDir(cwd = process.cwd()) {
   return join(getLibrettoRoot(cwd), LIBRETTO_SESSIONS_DIRNAME);

package/dist/shared/paths/repo-root.d.ts

@@ -0,0 +1,3 @@
+declare function resolveLibrettoRepoRoot(cwd?: string): string;
+
+export { resolveLibrettoRepoRoot };

package/dist/shared/paths/repo-root.js

@@ -0,0 +1,24 @@
+import { spawnSync } from "node:child_process";
+import { resolve } from "node:path";
+const repoRootCache = /* @__PURE__ */ new Map();
+function resolveLibrettoRepoRoot(cwd = process.cwd()) {
+  const override = process.env.LIBRETTO_REPO_ROOT?.trim();
+  if (override) {
+    return resolve(override);
+  }
+  const normalizedCwd = resolve(cwd);
+  const cached = repoRootCache.get(normalizedCwd);
+  if (cached) {
+    return cached;
+  }
+  const result = spawnSync("git", ["rev-parse", "--show-toplevel"], {
+    cwd: normalizedCwd,
+    encoding: "utf-8"
+  });
+  const repoRoot = result.status === 0 && result.stdout ? result.stdout.trim() : normalizedCwd;
+  repoRootCache.set(normalizedCwd, repoRoot);
+  return repoRoot;
+}
+export {
+  resolveLibrettoRepoRoot
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libretto",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "AI-powered browser automation library and CLI built on Playwright",
   "license": "MIT",
   "repository": {
@@ -14,24 +14,24 @@
   },
   "files": [
     "dist",
+    "src",
+    "scripts",
     "skills/libretto"
   ],
+  "types": "./dist/index.d.ts",
   "bin": {
-    "libretto": "./dist/cli/index.js",
-    "libretto-cli": "./dist/cli/index.js"
+    "libretto": "./dist/cli/index.js"
   },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "default": "./dist/index.js"
     }
   },
   "scripts": {
-    "postinstall": "playwright install chromium",
-    "build": "pnpm run build:runtime && pnpm run build:cli",
-    "build:runtime": "tsup --config tsup.config.ts",
-    "build:cli": "tsup --config tsup.cli.config.ts",
+    "postinstall": "node scripts/postinstall.mjs",
+    "build": "tsup --config tsup.config.ts",
     "type-check": "tsc --noEmit",
     "test": "pnpm run build && vitest run",
     "eval": "pnpm run build && vitest run --config vitest.evals.config.ts",

package/scripts/postinstall.mjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+import { cpSync, existsSync, mkdirSync, readdirSync, rmSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageRoot = join(__dirname, "..");
+
+// Install Playwright Chromium
+spawnSync("npx", ["playwright", "install", "chromium"], {
+  stdio: "inherit",
+  shell: true,
+});
+
+const installCwd = process.env.INIT_CWD?.trim() || null;
+if (!installCwd) {
+  console.warn(
+    "libretto: automatic skill install failed because INIT_CWD is not set. Run `npx skills add saffron-health/libretto` to add the skills manually.",
+  );
+  process.exit(0);
+}
+
+// Resolve the consuming project's repo root from the original install cwd,
+// not pnpm's content-addressable store path.
+const gitResult = spawnSync("git", ["rev-parse", "--show-toplevel"], {
+  cwd: installCwd,
+  encoding: "utf-8",
+  stdio: ["pipe", "pipe", "pipe"],
+});
+const repoRoot = gitResult.status === 0 && gitResult.stdout
+  ? gitResult.stdout.trim()
+  : installCwd;
+
+// Sync skills to any agent dirs at repo root
+const sourceDir = join(packageRoot, "skills", "libretto");
+if (!existsSync(sourceDir)) process.exit(0);
+
+const agentDirNames = [".agents", ".claude"];
+for (const name of agentDirNames) {
+  const agentDir = join(repoRoot, name);
+  if (!existsSync(agentDir)) continue;
+  const dest = join(agentDir, "skills", "libretto");
+  if (existsSync(dest)) rmSync(dest, { recursive: true });
+  mkdirSync(dirname(dest), { recursive: true });
+  cpSync(sourceDir, dest, { recursive: true });
+  const count = readdirSync(dest).length;
+  console.log(`libretto: synced ${count} skill files to ${dest}`);
+}