libretto 0.4.4 → 0.5.0

package/dist/cli/cli.js

@@ -16,30 +16,30 @@ Options:
                           Built-in sessions: default, dev-server, browser-agent
 
 Examples:
-  libretto-cli open https://linkedin.com
+  libretto open https://linkedin.com
 
   # ... manually log in ...
-  libretto-cli save linkedin.com
+  libretto save linkedin.com
   # Next time you open linkedin.com, you'll be logged in automatically
 
-  libretto-cli exec "await page.locator('button:has-text(\\"Sign in\\")').click()"
-  libretto-cli exec "await page.fill('input[name=\\"email\\"]', 'test@example.com')"
-  libretto-cli ai configure openai
-  libretto-cli ai configure anthropic
-  libretto-cli ai configure gemini
-  libretto-cli ai configure vertex
-  libretto-cli ai configure openai/gpt-4o
-  libretto-cli snapshot
-  libretto-cli snapshot --objective "Find the submit button" --context "Submitting a referral form, already filled in patient details"
-  libretto-cli resume --session default
-  libretto-cli close
-  libretto-cli close --all
-  libretto-cli close --all --force
+  libretto exec "await page.locator('button:has-text(\\"Sign in\\")').click()"
+  libretto exec "await page.fill('input[name=\\"email\\"]', 'test@example.com')"
+  libretto ai configure openai
+  libretto ai configure anthropic
+  libretto ai configure gemini
+  libretto ai configure vertex
+  libretto ai configure openai/gpt-4o
+  libretto snapshot
+  libretto snapshot --objective "Find the submit button" --context "Submitting a referral form, already filled in patient details"
+  libretto resume --session default
+  libretto close
+  libretto close --all
+  libretto close --all --force
 
   # Multiple sessions
-  libretto-cli open https://site1.com --session test1
-  libretto-cli open https://site2.com --session test2
-  libretto-cli exec "return await page.title()" --session test1
+  libretto open https://site1.com --session test1
+  libretto open https://site2.com --session test2
+  libretto exec "return await page.title()" --session test1
 
 Available in exec:
   page, context, state, browser, networkLog, actionLog
@@ -93,7 +93,8 @@ function validateLegacySessionArg(rawArgs) {
   if (value === void 0) return;
   if (value === null) {
     throw new Error(
-      "Usage: libretto-cli <command> [--session <name>]\nMissing or invalid --session value."
+      `Usage: libretto <command> [--session <name>]
+Missing or invalid --session value.`
     );
   }
   validateSessionName(value);

package/dist/cli/commands/ai.js

@@ -23,7 +23,7 @@ const aiCommands = SimpleCLI.group({
           preset: input.preset
         },
         {
-          configureCommandName: "libretto-cli ai configure"
+          configureCommandName: `libretto ai configure`
         }
       );
     })

package/dist/cli/commands/browser.js

@@ -47,7 +47,7 @@ const openInput = SimpleCLI.input({
   }
 }).refine(
   (input) => Boolean(input.url),
-  "Usage: libretto-cli open <url> [--headless] [--viewport WxH] [--session <name>]"
+  `Usage: libretto open <url> [--headless] [--viewport WxH] [--session <name>]`
 ).refine(
   (input) => !(input.headed && input.headless),
   "Cannot pass both --headed and --headless."
@@ -73,7 +73,7 @@ const saveInput = SimpleCLI.input({
   }
 }).refine(
   (input) => Boolean(input.urlOrDomain),
-  "Usage: libretto-cli save <url|domain> [--session <name>]"
+  `Usage: libretto save <url|domain> [--session <name>]`
 );
 function createSaveCommand(logger) {
   return SimpleCLI.command({
@@ -108,7 +108,7 @@ function createCloseCommand(logger) {
     description: "Close the browser"
   }).input(closeInput).use(resolveSessionMiddleware).handle(async ({ input, ctx }) => {
     if (input.force && !input.all) {
-      throw new Error("Usage: libretto-cli close --all [--force]");
+      throw new Error(`Usage: libretto close --all [--force]`);
     }
     if (input.all) {
       await runCloseAllWithLogger(logger, { force: input.force });

package/dist/cli/commands/execution.js

@@ -292,7 +292,7 @@ async function runResume(session, logger, sessionState) {
   } = getPauseSignalPaths(session);
   if (!existsSync(pausedSignalPath)) {
     throw new Error(
-      `Session "${session}" is not paused. Run "libretto-cli run ... --session ${session}" and call pause("${session}") first.`
+      `Session "${session}" is not paused. Run "libretto run ... --session ${session}" and call pause("${session}") first.`
     );
   }
   if (!isProcessRunning(sessionState.pid)) {
@@ -414,7 +414,7 @@ const execInput = SimpleCLI.input({
   }
 }).refine(
   (input) => input.codeParts.length > 0,
-  "Usage: libretto-cli exec <code> [--session <name>] [--visualize]"
+  `Usage: libretto exec <code> [--session <name>] [--visualize]`
 );
 function createExecCommand(logger) {
   return SimpleCLI.command({
@@ -429,7 +429,7 @@ function createExecCommand(logger) {
     );
   });
 }
-const runUsage = "Usage: libretto-cli run <integrationFile> <integrationExport> [--params <json> | --params-file <path>] [--tsconfig <path>] [--headed|--headless]";
+const runUsage = `Usage: libretto run <integrationFile> <integrationExport> [--params <json> | --params-file <path>] [--tsconfig <path>] [--headed|--headless]`;
 const runInput = SimpleCLI.input({
   positionals: [
     SimpleCLI.positional("integrationFile", z.string().optional(), {

package/dist/cli/commands/logs.js

@@ -26,7 +26,7 @@ async function resolvePageId(session, pageId) {
   const foundPage = pages.find((page) => page.id === pageId);
   if (!foundPage) {
     throw new Error(
-      `Page "${pageId}" was not found in session "${session}". Run "libretto-cli pages --session ${session}" to list ids.`
+      `Page "${pageId}" was not found in session "${session}". Run "libretto pages --session ${session}" to list ids.`
     );
   }
   return pageId;

package/dist/cli/core/browser.js

@@ -142,9 +142,14 @@ async function connect(session, logger, timeoutMs = 1e4, options) {
       port: state.port,
       pid: state.pid
     });
-    clearSessionState(session, logger);
+    if (!isPidRunning(state.pid)) {
+      clearSessionState(session, logger);
+      throw new Error(
+        `No browser running for session "${session}". Run 'libretto open <url> --session ${session}' first.`
+      );
+    }
     throw new Error(
-      `No browser running for session "${session}". Run 'libretto-cli open <url> --session ${session}' first.`
+      `Could not connect to the browser for session "${session}" at http://127.0.0.1:${state.port}, but the session process (pid ${state.pid}) is still running. Try the command again, or close and reopen the session if it stays stuck.`
     );
   }
   const contexts = browser.contexts();
@@ -170,14 +175,14 @@ async function connect(session, logger, timeoutMs = 1e4, options) {
   }
   if (options?.requireSinglePage && !options.pageId && pages.length > 1) {
     throw new Error(
-      `Multiple pages are open in session "${session}". Pass --page <id> to target a page (run "libretto-cli pages --session ${session}" to list ids).`
+      `Multiple pages are open in session "${session}". Pass --page <id> to target a page (run "libretto pages --session ${session}" to list ids).`
     );
   }
   const pageRefs = await resolvePageReferences(pages);
   const pageRef = options?.pageId ? pageRefs.find((ref) => ref.id === options.pageId) ?? null : pageRefs[pageRefs.length - 1];
   if (!pageRef) {
     throw new Error(
-      `Page "${options?.pageId}" was not found in session "${session}". Run "libretto-cli pages --session ${session}" to list ids.`
+      `Page "${options?.pageId}" was not found in session "${session}". Run "libretto pages --session ${session}" to list ids.`
     );
   }
   const page = pageRef.page;
@@ -293,7 +298,7 @@ function childLog(level, event, data = {}) {
 			timestamp: new Date().toISOString(),
 			id: Math.random().toString(36).slice(2, 10),
 			level,
-			scope: 'libretto-cli.child',
+			scope: 'libretto.child',
 			event,
 			data,
 		});
@@ -606,7 +611,7 @@ async function runCloseAll(logger, options) {
       [
         `Failed to close ${survivors.length} session(s) gracefully: ${formatSessionList(survivors)}.`,
         `Closed ${closed} session(s).`,
-        "Retry with: libretto-cli close --all --force"
+        `Retry with: libretto close --all --force`
       ].join("\n")
     );
   }

package/dist/cli/core/context.js

@@ -1,23 +1,9 @@
 import { Logger, createFileLogSink } from "../../shared/logger/index.js";
-import { spawnSync } from "node:child_process";
-import { cwd } from "node:process";
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { join } from "node:path";
+import { resolveLibrettoRepoRoot } from "../../shared/paths/repo-root.js";
 import { validateSessionName } from "./session.js";
-function getRepoRoot() {
-  const override = process.env.LIBRETTO_REPO_ROOT?.trim();
-  if (override) {
-    return resolve(override);
-  }
-  const result = spawnSync("git", ["rev-parse", "--show-toplevel"], {
-    encoding: "utf-8"
-  });
-  if (result.status === 0 && result.stdout) {
-    return result.stdout.trim();
-  }
-  return cwd();
-}
-const REPO_ROOT = getRepoRoot();
+const REPO_ROOT = resolveLibrettoRepoRoot();
 const LIBRETTO_CONFIG_DIR = join(REPO_ROOT, ".libretto");
 const LIBRETTO_CONFIG_PATH = join(LIBRETTO_CONFIG_DIR, "config.json");
 const PROFILES_DIR = join(LIBRETTO_CONFIG_DIR, "profiles");
@@ -63,7 +49,7 @@ function createLoggerForSession(session) {
   const sessionDir = getSessionDir(session);
   mkdirSync(sessionDir, { recursive: true });
   const logFilePath = getSessionLogsPath(session);
-  return new Logger(["libretto-cli"], [createFileLogSink({ filePath: logFilePath })]);
+  return new Logger(["libretto"], [createFileLogSink({ filePath: logFilePath })]);
 }
 async function closeLogger(logger) {
   if (!logger) return;

package/dist/cli/core/session.js

@@ -93,7 +93,7 @@ function throwSessionNotFoundError(session) {
   }
   lines.push("");
   lines.push("Start one with:");
-  lines.push(`  libretto-cli open <url> --session ${session}`);
+  lines.push(`  libretto open <url> --session ${session}`);
   throw new Error(lines.join("\n"));
 }
 function assertSessionStateExistsOrThrow(session) {
@@ -161,7 +161,7 @@ function assertSessionAvailableForStart(session, logger) {
   }
   const endpoint = `http://127.0.0.1:${existingState.port}`;
   throw new Error(
-    `Session "${session}" is already open and connected to ${endpoint} (pid ${existingState.pid}). Create a new session or close the current one with: libretto-cli close --session ${session}`
+    `Session "${session}" is already open and connected to ${endpoint} (pid ${existingState.pid}). Create a new session or close the current one with: libretto close --session ${session}`
   );
 }
 export {

package/dist/cli/core/snapshot-analyzer.js

@@ -76,7 +76,7 @@ ${stripAnsi(result.stderr).trim() || stripAnsi(result.stdout).trim() || "No erro
 }
 class CodexUserCodingAgent extends UserCodingAgent {
   async analyzeSnapshot(prompt, pngPath, logger) {
-    const tempDir = mkdtempSync(join(tmpdir(), "libretto-cli-analyzer-"));
+    const tempDir = mkdtempSync(join(tmpdir(), "libretto-analyzer-"));
     const outputPath = join(
       tempDir,
       `snapshot-analyzer-${Date.now()}-${Math.random().toString(36).slice(2)}.json`
@@ -171,7 +171,7 @@ async function runExternalCommand(command, args, logger, stdinText) {
       if (error.code === "ENOENT") {
         reject(
           new Error(
-            `Command not found: ${command}. Configure AI with 'libretto-cli ai configure'.`
+            `Command not found: ${command}. Configure AI with 'libretto ai configure'.`
           )
         );
         return;

package/dist/cli/router.js

@@ -17,7 +17,7 @@ function buildCLIRoutes(logger) {
   };
 }
 function createCLIApp(logger) {
-  return SimpleCLI.define("libretto-cli", buildCLIRoutes(logger), {
+  return SimpleCLI.define("libretto", buildCLIRoutes(logger), {
     globalNamed: {
       session: sessionOption()
     }

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

@@ -77,9 +77,9 @@ function getMissingLocalAuthProfileError(args) {
     `Local auth profile not found for domain "${normalizedDomain}".`,
     `Expected profile file: ${args.profilePath}`,
     "To create it:",
-    `  1. libretto-cli open https://${normalizedDomain} --headed --session ${args.session}`,
+    `  1. libretto open https://${normalizedDomain} --headed --session ${args.session}`,
     "  2. Log in manually in the browser window.",
-    `  3. libretto-cli save ${normalizedDomain} --session ${args.session}`
+    `  3. libretto save ${normalizedDomain} --session ${args.session}`
   ].join("\n");
 }
 function getAbsoluteIntegrationPath(integrationPath) {

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.4",
+  "version": "0.5.0",
   "description": "AI-powered browser automation library and CLI built on Playwright",
   "license": "MIT",
   "repository": {
@@ -14,25 +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": "node scripts/postinstall.mjs",
-    "build": "pnpm run build:runtime && pnpm run build:cli",
-    "build:runtime": "tsup --config tsup.config.ts",
-    "build:cli": "tsup --config tsup.cli.config.ts",
+    "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

@@ -14,15 +14,24 @@ spawnSync("npx", ["playwright", "install", "chromium"], {
   shell: true,
 });
 
-// Find git repo root
+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()
-  : null;
-if (!repoRoot) process.exit(0);
+  : installCwd;
 
 // Sync skills to any agent dirs at repo root
 const sourceDir = join(packageRoot, "skills", "libretto");