libretto 0.6.2 → 0.6.3

package/dist/cli/cli.js

@@ -1,62 +1,40 @@
+import { resolveAiSetupStatus } from "./core/ai-model.js";
 import { ensureLibrettoSetup } from "./core/context.js";
 import { createCLIApp } from "./router.js";
+import { warnIfInstalledSkillOutOfDate } from "./core/skill-version.js";
 function renderUsage(app) {
   return `${app.renderHelp()}
 
 Options:
   --session <name>        Use a named session (auto-generated for open/run if omitted)
 
-Examples:
-  libretto open https://linkedin.com
-
-  # ... manually log in ...
-  libretto save linkedin.com
-  # Next time you open linkedin.com, you'll be logged in automatically
-
-  libretto exec "await page.locator('button:has-text(\\"Sign in\\")').click()"
-  libretto exec "await page.fill('input[name=\\"email\\"]', 'test@example.com')"
-  libretto readonly-exec "return await page.title()" --session test1
-  libretto connect http://127.0.0.1:9222 --read-only --session test1
-  libretto run ./integration.ts --read-only --session test1
-  libretto status
-  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 my-session
-  libretto close
-  libretto close --all
-  libretto close --all --force
-
-  # Multiple sessions
-  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
-
-Available in readonly-exec:
-  page, state, snapshot, scrollBy, get
-
-Profiles:
-  Profiles are saved to .libretto/profiles/<domain>.json (git-ignored)
-  They persist cookies, localStorage, and session data across browser launches.
-  Local profiles are machine-local and are not shared with other users/environments.
-  Sessions can expire; if run fails auth, log in again and re-save the profile.
-
-Sessions:
-  Session state is stored in .libretto/sessions/<session>/state.json
-  CLI logs are stored in .libretto/sessions/<session>/logs.jsonl
-  Each session runs an isolated browser instance on a dynamic port.
-  Session mode is stored per session as read-only or write-access.
-  Use --read-only on open, connect, or run to create a read-only session.
-  Session mode is enforced by Libretto commands, not by raw CDP clients outside Libretto.
+Docs (agent-friendly): https://libretto.sh/docs
 `;
 }
+function printSetupAudit() {
+  warnIfInstalledSkillOutOfDate();
+  const status = resolveAiSetupStatus();
+  switch (status.kind) {
+    case "ready":
+      console.log(`\u2713 AI model: ${status.model}`);
+      break;
+    case "configured-missing-credentials":
+      console.log(
+        `\u2717 ${status.provider} configured (model: ${status.model}), but credentials are missing. Run \`npx libretto setup\` to repair.`
+      );
+      break;
+    case "invalid-config":
+      console.log(
+        `\u2717 AI config is invalid. Run \`npx libretto setup\` to reconfigure.`
+      );
+      break;
+    case "unconfigured":
+      console.log(
+        `\u2717 No AI model configured. Run \`npx libretto setup\` or \`npx libretto ai configure\` to set up.`
+      );
+      break;
+  }
+}
 function isRootHelpRequest(rawArgs) {
   if (rawArgs.length === 0) return true;
   if (rawArgs[0] === "--help" || rawArgs[0] === "-h") return true;
@@ -70,6 +48,7 @@ async function runLibrettoCLI() {
   try {
     if (isRootHelpRequest(rawArgs)) {
       console.log(renderUsage(app));
+      printSetupAudit();
       return;
     }
     const result = await app.run(rawArgs);

package/dist/cli/commands/browser.js

@@ -199,7 +199,11 @@ const sessionModeCommand = SimpleCLI.command({
   console.log(`Session "${ctx.session}" mode set to ${nextState.mode}.`);
 });
 const closeInput = SimpleCLI.input({
-  positionals: [],
+  positionals: [
+    SimpleCLI.positional("session", z.string().optional(), {
+      help: "Session name to close"
+    })
+  ],
   named: {
     session: sessionOption(),
     all: SimpleCLI.flag({
@@ -211,7 +215,7 @@ const closeInput = SimpleCLI.input({
   }
 }).refine(
   (input) => input.all || input.session,
-  `Usage: libretto close --session <name>
+  `Usage: libretto close <session>
 Usage: libretto close --all [--force]`
 );
 const closeCommand = SimpleCLI.command({

package/dist/cli/commands/deploy.js

@@ -32,27 +32,40 @@ async function postJson(apiUrl, apiKey, path, input = {}) {
 }
 async function pollDeployment(apiUrl, apiKey, deploymentId, pollIntervalMs, maxWaitMs) {
   const start = Date.now();
+  const workflowWaitMs = 6e4;
   let status = "building";
+  let workflows = null;
+  let readyAt = null;
   let deployment;
-  while (status === "building" && Date.now() - start < maxWaitMs) {
+  while (Date.now() - start < maxWaitMs) {
+    if (status !== "building" && status !== "ready") break;
+    if (status === "ready" && workflows?.length) break;
+    if (status === "ready" && readyAt && Date.now() - readyAt > workflowWaitMs) break;
     await new Promise((r) => setTimeout(r, pollIntervalMs));
-    const res = await postJson(apiUrl, apiKey, "/v1/deployments/get", {
+    const res = await postJson(apiUrl, apiKey, "/v1/deployments/sync", {
       id: deploymentId
     });
     const body = await res.json();
     if (res.status !== 200) {
       throw new Error(
-        `Failed to get deployment status (${res.status}): ${JSON.stringify(body)}`
+        `Failed to sync deployment status (${res.status}): ${JSON.stringify(body)}`
       );
     }
     status = body.json.status;
+    workflows = body.json.workflows;
     deployment = body.json;
+    if (status === "ready" && readyAt === null) readyAt = Date.now();
     process.stdout.write(".");
   }
   console.log();
   if (!deployment) {
     throw new Error("Deployment timed out before receiving a status update.");
   }
+  if (status === "ready" && !workflows?.length) {
+    throw new Error(
+      "Build completed but workflow discovery failed due to a server-side error. Please redeploy."
+    );
+  }
   return deployment;
 }
 const deployInput = SimpleCLI.input({

package/dist/cli/framework/simple-cli.js

@@ -762,14 +762,17 @@ function buildInputNormalizer(definition) {
         toKebabCase(key),
         key
       ].filter((candidate) => candidate.length > 0);
-      let value = void 0;
+      let found = false;
       for (const candidate of normalizedCandidates) {
         if (Object.prototype.hasOwnProperty.call(named, candidate)) {
-          value = named[candidate];
+          output[key] = named[candidate];
+          found = true;
           break;
         }
       }
-      output[key] = value;
+      if (!found && !Object.prototype.hasOwnProperty.call(output, key)) {
+        output[key] = void 0;
+      }
     }
     return output;
   };

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "libretto",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "AI-powered browser automation library and CLI built on Playwright",
   "license": "MIT",
+  "homepage": "https://libretto.sh",
   "repository": {
     "type": "git",
     "url": "https://github.com/saffron-health/libretto"

package/src/cli/cli.ts

@@ -1,5 +1,7 @@
+import { resolveAiSetupStatus } from "./core/ai-model.js";
 import { ensureLibrettoSetup } from "./core/context.js";
 import { createCLIApp } from "./router.js";
+import { warnIfInstalledSkillOutOfDate } from "./core/skill-version.js";
 
 function renderUsage(app: ReturnType<typeof createCLIApp>): string {
   return `${app.renderHelp()}
@@ -7,56 +9,34 @@ function renderUsage(app: ReturnType<typeof createCLIApp>): string {
 Options:
   --session <name>        Use a named session (auto-generated for open/run if omitted)
 
-Examples:
-  libretto open https://linkedin.com
-
-  # ... manually log in ...
-  libretto save linkedin.com
-  # Next time you open linkedin.com, you'll be logged in automatically
-
-  libretto exec "await page.locator('button:has-text(\\"Sign in\\")').click()"
-  libretto exec "await page.fill('input[name=\\"email\\"]', 'test@example.com')"
-  libretto readonly-exec "return await page.title()" --session test1
-  libretto connect http://127.0.0.1:9222 --read-only --session test1
-  libretto run ./integration.ts --read-only --session test1
-  libretto status
-  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 my-session
-  libretto close
-  libretto close --all
-  libretto close --all --force
-
-  # Multiple sessions
-  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
-
-Available in readonly-exec:
-  page, state, snapshot, scrollBy, get
+Docs (agent-friendly): https://libretto.sh/docs
+`;
+}
 
-Profiles:
-  Profiles are saved to .libretto/profiles/<domain>.json (git-ignored)
-  They persist cookies, localStorage, and session data across browser launches.
-  Local profiles are machine-local and are not shared with other users/environments.
-  Sessions can expire; if run fails auth, log in again and re-save the profile.
+function printSetupAudit(): void {
+  warnIfInstalledSkillOutOfDate();
 
-Sessions:
-  Session state is stored in .libretto/sessions/<session>/state.json
-  CLI logs are stored in .libretto/sessions/<session>/logs.jsonl
-  Each session runs an isolated browser instance on a dynamic port.
-  Session mode is stored per session as read-only or write-access.
-  Use --read-only on open, connect, or run to create a read-only session.
-  Session mode is enforced by Libretto commands, not by raw CDP clients outside Libretto.
-`;
+  const status = resolveAiSetupStatus();
+  switch (status.kind) {
+    case "ready":
+      console.log(`✓ AI model: ${status.model}`);
+      break;
+    case "configured-missing-credentials":
+      console.log(
+        `✗ ${status.provider} configured (model: ${status.model}), but credentials are missing. Run \`npx libretto setup\` to repair.`,
+      );
+      break;
+    case "invalid-config":
+      console.log(
+        `✗ AI config is invalid. Run \`npx libretto setup\` to reconfigure.`,
+      );
+      break;
+    case "unconfigured":
+      console.log(
+        `✗ No AI model configured. Run \`npx libretto setup\` or \`npx libretto ai configure\` to set up.`,
+      );
+      break;
+  }
 }
 
 function isRootHelpRequest(rawArgs: readonly string[]): boolean {
@@ -74,6 +54,7 @@ export async function runLibrettoCLI(): Promise<void> {
   try {
     if (isRootHelpRequest(rawArgs)) {
       console.log(renderUsage(app));
+      printSetupAudit();
       return;
     }
 

package/src/cli/commands/browser.ts

@@ -242,7 +242,11 @@ export const sessionModeCommand = SimpleCLI.command({
   });
 
 export const closeInput = SimpleCLI.input({
-  positionals: [],
+  positionals: [
+    SimpleCLI.positional("session", z.string().optional(), {
+      help: "Session name to close",
+    }),
+  ],
   named: {
     session: sessionOption(),
     all: SimpleCLI.flag({
@@ -254,7 +258,7 @@ export const closeInput = SimpleCLI.input({
   },
 }).refine(
   (input) => input.all || input.session,
-  `Usage: libretto close --session <name>\nUsage: libretto close --all [--force]`,
+  `Usage: libretto close <session>\nUsage: libretto close --all [--force]`,
 );
 
 export const closeCommand = SimpleCLI.command({

package/src/cli/commands/deploy.ts

@@ -60,23 +60,32 @@ async function pollDeployment(
   maxWaitMs: number,
 ): Promise<DeploymentResponse["json"]> {
   const start = Date.now();
+  const workflowWaitMs = 60_000;
   let status: DeploymentStatus = "building";
+  let workflows: string[] | null | undefined = null;
+  let readyAt: number | null = null;
   let deployment: DeploymentResponse["json"] | undefined;
 
-  while (status === "building" && Date.now() - start < maxWaitMs) {
+  while (Date.now() - start < maxWaitMs) {
+    if (status !== "building" && status !== "ready") break;
+    if (status === "ready" && workflows?.length) break;
+    if (status === "ready" && readyAt && Date.now() - readyAt > workflowWaitMs) break;
+
     await new Promise((r) => setTimeout(r, pollIntervalMs));
 
-    const res = await postJson(apiUrl, apiKey, "/v1/deployments/get", {
+    const res = await postJson(apiUrl, apiKey, "/v1/deployments/sync", {
       id: deploymentId,
     });
     const body = (await res.json()) as DeploymentResponse;
     if (res.status !== 200) {
       throw new Error(
-        `Failed to get deployment status (${res.status}): ${JSON.stringify(body)}`,
+        `Failed to sync deployment status (${res.status}): ${JSON.stringify(body)}`,
       );
     }
     status = body.json.status;
+    workflows = body.json.workflows;
     deployment = body.json;
+    if (status === "ready" && readyAt === null) readyAt = Date.now();
     process.stdout.write(".");
   }
   console.log();
@@ -85,6 +94,12 @@ async function pollDeployment(
     throw new Error("Deployment timed out before receiving a status update.");
   }
 
+  if (status === "ready" && !workflows?.length) {
+    throw new Error(
+      "Build completed but workflow discovery failed due to a server-side error. Please redeploy.",
+    );
+  }
+
   return deployment;
 }
 

package/src/cli/framework/simple-cli.ts

@@ -1265,14 +1265,17 @@ function buildInputNormalizer<
         key,
       ].filter((candidate) => candidate.length > 0);
 
-      let value: unknown = undefined;
+      let found = false;
       for (const candidate of normalizedCandidates) {
         if (Object.prototype.hasOwnProperty.call(named, candidate)) {
-          value = named[candidate];
+          output[key] = named[candidate];
+          found = true;
           break;
         }
       }
-      output[key] = value;
+      if (!found && !Object.prototype.hasOwnProperty.call(output, key)) {
+        output[key] = undefined;
+      }
     }
 
     return output as InputObjectFor<TPositionals, TNamed>;