libretto 0.6.8 → 0.6.9

package/dist/cli/commands/execution.js

@@ -687,6 +687,15 @@ const runCommand = SimpleCLI.command({
       `Creating ${providerName} browser session (session: ${ctx.session})...`
     );
     const providerSession = await provider.createSession();
+    ctx.logger.info("run-provider-session-created", {
+      provider: providerName,
+      sessionId: providerSession.sessionId,
+      cdpEndpoint: providerSession.cdpEndpoint,
+      liveViewUrl: providerSession.liveViewUrl
+    });
+    if (providerSession.liveViewUrl) {
+      console.log(`View live session: ${providerSession.liveViewUrl}`);
+    }
     console.log(`Connecting to ${providerName} browser...`);
     cdpEndpoint = providerSession.cdpEndpoint;
     providerInfo = {
@@ -714,7 +723,10 @@ const runCommand = SimpleCLI.command({
   } finally {
     if (provider && providerInfo) {
       try {
-        await provider.closeSession(providerInfo.sessionId);
+        const result = await provider.closeSession(providerInfo.sessionId);
+        if (result.replayUrl) {
+          console.log(`View recording: ${result.replayUrl}`);
+        }
       } catch (cleanupErr) {
         console.error(
           `Failed to clean up ${providerInfo.name} session ${providerInfo.sessionId}:`,

package/dist/cli/core/browser.js

@@ -431,8 +431,12 @@ async function runOpenWithProvider(rawUrl, providerName, provider, session, logg
   logger.info("open-provider-session-created", {
     provider: providerName,
     sessionId: providerSession.sessionId,
-    cdpEndpoint: providerSession.cdpEndpoint
+    cdpEndpoint: providerSession.cdpEndpoint,
+    liveViewUrl: providerSession.liveViewUrl
   });
+  if (providerSession.liveViewUrl) {
+    console.log(`View live session: ${providerSession.liveViewUrl}`);
+  }
   console.log(`Connecting to ${providerName} browser...`);
   let browser = null;
   try {
@@ -572,6 +576,7 @@ async function runClose(session, logger) {
     console.log(`No browser running for session "${session}".`);
     return;
   }
+  let replayUrl;
   if (state.provider) {
     logger.info("close-provider", {
       session,
@@ -580,7 +585,8 @@ async function runClose(session, logger) {
     });
     try {
       const provider = getCloudProviderApi(state.provider.name);
-      await provider.closeSession(state.provider.sessionId);
+      const result = await provider.closeSession(state.provider.sessionId);
+      replayUrl = result.replayUrl;
     } catch (err) {
       logger.warn("close-provider-error", {
         session,
@@ -601,8 +607,11 @@ async function runClose(session, logger) {
     }
   }
   clearSessionState(session, logger);
-  logger.info("close-success", { session });
+  logger.info("close-success", { session, replayUrl });
   console.log(`Browser closed (session: ${session}).`);
+  if (replayUrl) {
+    console.log(`View recording: ${replayUrl}`);
+  }
 }
 function waitForCloseSignalWindow(ms) {
   return new Promise((r) => setTimeout(r, ms));
@@ -671,6 +680,7 @@ async function runCloseAll(logger, options) {
     return;
   }
   const failedProviderSessions = /* @__PURE__ */ new Set();
+  const replayUrls = [];
   for (const target of closable) {
     if (target.provider) {
       logger.info("close-all-provider", {
@@ -680,7 +690,13 @@ async function runCloseAll(logger, options) {
       });
       try {
         const provider = getCloudProviderApi(target.provider.name);
-        await provider.closeSession(target.provider.sessionId);
+        const result = await provider.closeSession(target.provider.sessionId);
+        if (result.replayUrl) {
+          replayUrls.push({
+            session: target.session,
+            replayUrl: result.replayUrl
+          });
+        }
       } catch (err) {
         logger.warn("close-all-provider-error", {
           session: target.session,
@@ -781,6 +797,9 @@ async function runCloseAll(logger, options) {
   if (forceKilled > 0) {
     console.log(`Force-killed ${forceKilled} session(s).`);
   }
+  for (const { session, replayUrl } of replayUrls) {
+    console.log(`View recording (${session}): ${replayUrl}`);
+  }
 }
 async function runConnect(cdpUrl, session, logger, accessMode = "write-access") {
   logger.info("connect-start", { cdpUrl, session, accessMode });

package/dist/cli/core/providers/browserbase.js

@@ -45,6 +45,7 @@ function createBrowserbaseProvider() {
           `Browserbase API error closing session ${sessionId} (${resp.status}): ${body}`
         );
       }
+      return {};
     }
   };
 }

package/dist/cli/core/providers/kernel.js

@@ -38,6 +38,7 @@ function createKernelProvider() {
           `Kernel API error closing session ${sessionId} (${resp.status}): ${body}`
         );
       }
+      return {};
     }
   };
 }

package/dist/cli/core/providers/libretto-cloud.js

@@ -34,7 +34,8 @@ function createLibrettoCloudProvider() {
       const { json } = await resp.json();
       return {
         sessionId: json.session_id,
-        cdpEndpoint: json.cdp_url
+        cdpEndpoint: json.cdp_url,
+        liveViewUrl: json.live_view_url ?? void 0
       };
     },
     async closeSession(sessionId) {
@@ -52,6 +53,8 @@ function createLibrettoCloudProvider() {
           `Libretto Cloud API error closing session ${sessionId} (${resp.status}): ${body}`
         );
       }
+      const { json } = await resp.json();
+      return { replayUrl: json.replay_url ?? void 0 };
     }
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libretto",
-  "version": "0.6.8",
+  "version": "0.6.9",
   "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.8"
+  version: "0.6.9"
 ---
 
 ## 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.8"
+  version: "0.6.9"
 ---
 
 ## How Libretto Read-Only Works

package/src/cli/commands/execution.ts

@@ -882,6 +882,15 @@ export const runCommand = SimpleCLI.command({
         `Creating ${providerName} browser session (session: ${ctx.session})...`,
       );
       const providerSession = await provider.createSession();
+      ctx.logger.info("run-provider-session-created", {
+        provider: providerName,
+        sessionId: providerSession.sessionId,
+        cdpEndpoint: providerSession.cdpEndpoint,
+        liveViewUrl: providerSession.liveViewUrl,
+      });
+      if (providerSession.liveViewUrl) {
+        console.log(`View live session: ${providerSession.liveViewUrl}`);
+      }
       console.log(`Connecting to ${providerName} browser...`);
       cdpEndpoint = providerSession.cdpEndpoint;
       providerInfo = {
@@ -910,7 +919,10 @@ export const runCommand = SimpleCLI.command({
     } finally {
       if (provider && providerInfo) {
         try {
-          await provider.closeSession(providerInfo.sessionId);
+          const result = await provider.closeSession(providerInfo.sessionId);
+          if (result.replayUrl) {
+            console.log(`View recording: ${result.replayUrl}`);
+          }
         } catch (cleanupErr) {
           console.error(
             `Failed to clean up ${providerInfo.name} session ${providerInfo.sessionId}:`,

package/src/cli/core/browser.ts

@@ -590,8 +590,13 @@ export async function runOpenWithProvider(
     provider: providerName,
     sessionId: providerSession.sessionId,
     cdpEndpoint: providerSession.cdpEndpoint,
+    liveViewUrl: providerSession.liveViewUrl,
   });
 
+  if (providerSession.liveViewUrl) {
+    console.log(`View live session: ${providerSession.liveViewUrl}`);
+  }
+
   console.log(`Connecting to ${providerName} browser...`);
 
   let browser: Browser | null = null;
@@ -763,6 +768,7 @@ export async function runClose(
     return;
   }
 
+  let replayUrl: string | undefined;
   if (state.provider) {
     // Cloud provider session — close via provider API, no local pid to kill
     logger.info("close-provider", {
@@ -772,7 +778,8 @@ export async function runClose(
     });
     try {
       const provider = getCloudProviderApi(state.provider.name);
-      await provider.closeSession(state.provider.sessionId);
+      const result = await provider.closeSession(state.provider.sessionId);
+      replayUrl = result.replayUrl;
     } catch (err) {
       logger.warn("close-provider-error", {
         session,
@@ -797,8 +804,11 @@ export async function runClose(
   }
 
   clearSessionState(session, logger);
-  logger.info("close-success", { session });
+  logger.info("close-success", { session, replayUrl });
   console.log(`Browser closed (session: ${session}).`);
+  if (replayUrl) {
+    console.log(`View recording: ${replayUrl}`);
+  }
 }
 
 type ClosableSession = {
@@ -900,6 +910,7 @@ export async function runCloseAll(
 
   // Close provider sessions via their APIs
   const failedProviderSessions = new Set<string>();
+  const replayUrls: Array<{ session: string; replayUrl: string }> = [];
   for (const target of closable) {
     if (target.provider) {
       logger.info("close-all-provider", {
@@ -909,7 +920,13 @@ export async function runCloseAll(
       });
       try {
         const provider = getCloudProviderApi(target.provider.name);
-        await provider.closeSession(target.provider.sessionId);
+        const result = await provider.closeSession(target.provider.sessionId);
+        if (result.replayUrl) {
+          replayUrls.push({
+            session: target.session,
+            replayUrl: result.replayUrl,
+          });
+        }
       } catch (err) {
         logger.warn("close-all-provider-error", {
           session: target.session,
@@ -1020,6 +1037,9 @@ export async function runCloseAll(
   if (forceKilled > 0) {
     console.log(`Force-killed ${forceKilled} session(s).`);
   }
+  for (const { session, replayUrl } of replayUrls) {
+    console.log(`View recording (${session}): ${replayUrl}`);
+  }
 }
 
 export async function runConnect(

package/src/cli/core/providers/browserbase.ts

@@ -52,6 +52,7 @@ export function createBrowserbaseProvider(): ProviderApi {
           `Browserbase API error closing session ${sessionId} (${resp.status}): ${body}`,
         );
       }
+      return {};
     },
   };
 }

package/src/cli/core/providers/kernel.ts

@@ -44,6 +44,7 @@ export function createKernelProvider(): ProviderApi {
           `Kernel API error closing session ${sessionId} (${resp.status}): ${body}`,
         );
       }
+      return {};
     },
   };
 }

package/src/cli/core/providers/libretto-cloud.ts

@@ -37,11 +37,17 @@ export function createLibrettoCloudProvider(): ProviderApi {
         );
       }
       const { json } = (await resp.json()) as {
-        json: { session_id: string; cdp_url: string };
+        json: {
+          session_id: string;
+          cdp_url: string;
+          live_view_url: string | null;
+          recording_url: string | null;
+        };
       };
       return {
         sessionId: json.session_id,
         cdpEndpoint: json.cdp_url,
+        liveViewUrl: json.live_view_url ?? undefined,
       };
     },
     async closeSession(sessionId) {
@@ -59,6 +65,10 @@ export function createLibrettoCloudProvider(): ProviderApi {
           `Libretto Cloud API error closing session ${sessionId} (${resp.status}): ${body}`,
         );
       }
+      const { json } = (await resp.json()) as {
+        json: { replay_url: string | null };
+      };
+      return { replayUrl: json.replay_url ?? undefined };
     },
   };
 }

package/src/cli/core/providers/types.ts

@@ -1,9 +1,20 @@
 export type ProviderSession = {
   sessionId: string; // remote session id for cleanup
   cdpEndpoint: string; // CDP WebSocket URL
+  // Provider-hosted URL for watching the session live while it's running.
+  // Only libretto-cloud surfaces this today; direct-SDK providers leave it
+  // undefined.
+  liveViewUrl?: string;
+};
+
+export type ProviderCloseResult = {
+  // Provider-hosted URL for playback of the session recording, surfaced on
+  // successful close. Undefined when the provider didn't capture a
+  // recording or doesn't return one on close.
+  replayUrl?: string;
 };
 
 export type ProviderApi = {
   createSession(): Promise<ProviderSession>;
-  closeSession(sessionId: string): Promise<void>;
+  closeSession(sessionId: string): Promise<ProviderCloseResult>;
 };