libretto 0.2.0 → 0.2.2

package/dist/index.d.ts

@@ -1,7 +1,4 @@
-export { step } from './runtime/step/step.js';
-export { Runner, createRunner } from './runtime/step/runner.js';
-export { DebugBundle, RecoveryHandler, RunnerConfig, Step, StepContext, StepHandler, StepHistoryEntry, StepOptions } from './runtime/step/types.js';
-export { LogOptions, Logger, LoggerApi, LoggerSink } from './shared/logger/logger.js';
+export { LogOptions, Logger, LoggerApi, LoggerSink, MinimalLogger, defaultLogger } from './shared/logger/logger.js';
 export { createFileLogSink, jsonlConsoleSink, prettyConsoleSink } from './shared/logger/sinks.js';
 export { LLMClient, Message, MessageContentPart } from './shared/llm/types.js';
 export { SESSION_STATE_VERSION, SessionState, SessionStateFile, SessionStateFileSchema, SessionStatus, SessionStatusSchema, parseSessionStateContent, parseSessionStateData, serializeSessionState } from './shared/state/session-state.js';
@@ -18,5 +15,5 @@ export { GhostCursorOptions, ensureGhostCursor, ghostClick, hideGhostCursor, mov
 export { HighlightOptions, clearHighlights, ensureHighlightLayer, showHighlight } from './shared/visualization/highlight.js';
 export { BrowserSession, LaunchBrowserArgs, launchBrowser } from './shared/run/browser.js';
 export { LIBRETTO_WORKFLOW_BRAND, LibrettoAuthProfile, LibrettoWorkflow, LibrettoWorkflowContext, LibrettoWorkflowHandler, LibrettoWorkflowMetadata, workflow } from './shared/workflow/workflow.js';
-import 'playwright';
 import 'zod';
+import 'playwright';

package/dist/index.js

@@ -1,6 +1,4 @@
-import { step } from "./runtime/step/step.js";
-import { createRunner } from "./runtime/step/runner.js";
-import { Logger } from "./shared/logger/logger.js";
+import { Logger, defaultLogger } from "./shared/logger/logger.js";
 import {
   createFileLogSink,
   prettyConsoleSink,
@@ -76,8 +74,8 @@ export {
   attemptWithRecovery,
   clearHighlights,
   createFileLogSink,
-  createRunner,
   debugPause,
+  defaultLogger,
   detectSubmissionError,
   downloadAndSave,
   downloadViaClick,
@@ -105,6 +103,5 @@ export {
   serializeSessionState,
   shouldPauseBeforeMutation,
   showHighlight,
-  step,
   workflow
 };

package/dist/runtime/download/download.d.cts

@@ -1,5 +1,5 @@
 import { Page } from 'playwright';
-import { LoggerApi } from '../../shared/logger/logger.cjs';
+import { MinimalLogger } from '../../shared/logger/logger.cjs';
 
 type DownloadResult = {
     /** The raw file contents. */
@@ -8,7 +8,7 @@ type DownloadResult = {
     filename: string;
 };
 type DownloadViaClickOptions = {
-    logger?: LoggerApi;
+    logger?: MinimalLogger;
     /** Timeout in milliseconds for waiting on the download event. Defaults to 30 000. */
     timeout?: number;
 };

package/dist/runtime/download/download.d.ts

@@ -1,5 +1,5 @@
 import { Page } from 'playwright';
-import { LoggerApi } from '../../shared/logger/logger.js';
+import { MinimalLogger } from '../../shared/logger/logger.js';
 
 type DownloadResult = {
     /** The raw file contents. */
@@ -8,7 +8,7 @@ type DownloadResult = {
     filename: string;
 };
 type DownloadViaClickOptions = {
-    logger?: LoggerApi;
+    logger?: MinimalLogger;
     /** Timeout in milliseconds for waiting on the download event. Defaults to 30 000. */
     timeout?: number;
 };

package/dist/runtime/extract/extract.cjs

@@ -21,8 +21,9 @@ __export(extract_exports, {
   extractFromPage: () => extractFromPage
 });
 module.exports = __toCommonJS(extract_exports);
+var import_logger = require("../../shared/logger/logger.js");
 async function extractFromPage(options) {
-  const { page, instruction, schema, selector, logger, llmClient } = options;
+  const { page, instruction, schema, selector, logger = import_logger.defaultLogger, llmClient } = options;
   let screenshot;
   let domContent;
   if (selector) {

package/dist/runtime/extract/extract.d.cts

@@ -1,14 +1,14 @@
 import { Page } from 'playwright';
-import { ZodType, infer } from 'zod';
-import { LoggerApi } from '../../shared/logger/logger.cjs';
+import z from 'zod';
+import { MinimalLogger } from '../../shared/logger/logger.cjs';
 import { LLMClient } from '../../shared/llm/types.cjs';
 
-type ExtractOptions<T extends ZodType> = {
+type ExtractOptions<T extends z.ZodType> = {
     page: Page;
     instruction: string;
     schema: T;
     llmClient: LLMClient;
-    logger: LoggerApi;
+    logger?: MinimalLogger;
     /** Optional CSS selector to scope extraction to a specific element. */
     selector?: string;
 };
@@ -18,6 +18,6 @@ type ExtractOptions<T extends ZodType> = {
  * captures DOM content, and uses an LLM to extract structured data
  * matching the provided Zod schema.
  */
-declare function extractFromPage<T extends ZodType>(options: ExtractOptions<T>): Promise<infer<T>>;
+declare function extractFromPage<T extends z.ZodType>(options: ExtractOptions<T>): Promise<z.infer<T>>;
 
 export { type ExtractOptions, extractFromPage };

package/dist/runtime/extract/extract.d.ts

@@ -1,14 +1,14 @@
 import { Page } from 'playwright';
-import { ZodType, infer } from 'zod';
-import { LoggerApi } from '../../shared/logger/logger.js';
+import z from 'zod';
+import { MinimalLogger } from '../../shared/logger/logger.js';
 import { LLMClient } from '../../shared/llm/types.js';
 
-type ExtractOptions<T extends ZodType> = {
+type ExtractOptions<T extends z.ZodType> = {
     page: Page;
     instruction: string;
     schema: T;
     llmClient: LLMClient;
-    logger: LoggerApi;
+    logger?: MinimalLogger;
     /** Optional CSS selector to scope extraction to a specific element. */
     selector?: string;
 };
@@ -18,6 +18,6 @@ type ExtractOptions<T extends ZodType> = {
  * captures DOM content, and uses an LLM to extract structured data
  * matching the provided Zod schema.
  */
-declare function extractFromPage<T extends ZodType>(options: ExtractOptions<T>): Promise<infer<T>>;
+declare function extractFromPage<T extends z.ZodType>(options: ExtractOptions<T>): Promise<z.infer<T>>;
 
 export { type ExtractOptions, extractFromPage };

package/dist/runtime/extract/extract.js

@@ -1,5 +1,6 @@
+import { defaultLogger } from "../../shared/logger/logger.js";
 async function extractFromPage(options) {
-  const { page, instruction, schema, selector, logger, llmClient } = options;
+  const { page, instruction, schema, selector, logger = defaultLogger, llmClient } = options;
   let screenshot;
   let domContent;
   if (selector) {

package/dist/runtime/network/network.d.cts

@@ -1,6 +1,6 @@
 import { Page } from 'playwright';
-import { ZodType, infer } from 'zod';
-import { LoggerApi } from '../../shared/logger/logger.cjs';
+import z from 'zod';
+import { MinimalLogger } from '../../shared/logger/logger.cjs';
 
 type RequestConfig = {
     url: string;
@@ -12,17 +12,17 @@ type RequestConfig = {
     /** How to parse the response. Defaults to "json". */
     responseType?: "json" | "text" | "xml";
 };
-type PageRequestOptions<T extends ZodType | undefined = undefined> = {
-    logger?: LoggerApi;
+type PageRequestOptions<T extends z.ZodType | undefined = undefined> = {
+    logger?: MinimalLogger;
     /** Optional Zod schema to validate the response body. */
     schema?: T;
 };
-type PageRequestResult<T extends ZodType | undefined> = T extends ZodType ? infer<T> : any;
+type PageRequestResult<T extends z.ZodType | undefined> = T extends z.ZodType ? z.infer<T> : any;
 /**
  * Executes a fetch() call inside the browser context via page.evaluate().
  * Provides typed request config, automatic response parsing, optional Zod
  * validation, and logging.
  */
-declare function pageRequest<T extends ZodType | undefined = undefined>(page: Page, config: RequestConfig, options?: PageRequestOptions<T>): Promise<PageRequestResult<T>>;
+declare function pageRequest<T extends z.ZodType | undefined = undefined>(page: Page, config: RequestConfig, options?: PageRequestOptions<T>): Promise<PageRequestResult<T>>;
 
 export { type PageRequestOptions, type RequestConfig, pageRequest };

package/dist/runtime/network/network.d.ts

@@ -1,6 +1,6 @@
 import { Page } from 'playwright';
-import { ZodType, infer } from 'zod';
-import { LoggerApi } from '../../shared/logger/logger.js';
+import z from 'zod';
+import { MinimalLogger } from '../../shared/logger/logger.js';
 
 type RequestConfig = {
     url: string;
@@ -12,17 +12,17 @@ type RequestConfig = {
     /** How to parse the response. Defaults to "json". */
     responseType?: "json" | "text" | "xml";
 };
-type PageRequestOptions<T extends ZodType | undefined = undefined> = {
-    logger?: LoggerApi;
+type PageRequestOptions<T extends z.ZodType | undefined = undefined> = {
+    logger?: MinimalLogger;
     /** Optional Zod schema to validate the response body. */
     schema?: T;
 };
-type PageRequestResult<T extends ZodType | undefined> = T extends ZodType ? infer<T> : any;
+type PageRequestResult<T extends z.ZodType | undefined> = T extends z.ZodType ? z.infer<T> : any;
 /**
  * Executes a fetch() call inside the browser context via page.evaluate().
  * Provides typed request config, automatic response parsing, optional Zod
  * validation, and logging.
  */
-declare function pageRequest<T extends ZodType | undefined = undefined>(page: Page, config: RequestConfig, options?: PageRequestOptions<T>): Promise<PageRequestResult<T>>;
+declare function pageRequest<T extends z.ZodType | undefined = undefined>(page: Page, config: RequestConfig, options?: PageRequestOptions<T>): Promise<PageRequestResult<T>>;
 
 export { type PageRequestOptions, type RequestConfig, pageRequest };

package/dist/runtime/recovery/agent.cjs

@@ -21,6 +21,7 @@ __export(agent_exports, {
   executeRecoveryAgent: () => executeRecoveryAgent
 });
 module.exports = __toCommonJS(agent_exports);
+var import_logger = require("../../shared/logger/logger.js");
 var import_zod = require("zod");
 function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -53,7 +54,7 @@ const KEY_MAPPINGS = {
 function mapKeyName(key) {
   return KEY_MAPPINGS[key.toUpperCase()] ?? key;
 }
-async function executeBrowserAction(page, action, logger) {
+async function executeBrowserAction(page, action, logger = import_logger.defaultLogger) {
   switch (action.type) {
     case "click": {
       const { x, y, button = "left" } = action;
@@ -156,7 +157,11 @@ const recoveryActionSchema = import_zod.z.object({
   ])
 });
 async function executeRecoveryAgent(page, instruction, logger, llmClient) {
-  logger.info("Executing vision-based recovery agent", { instruction });
+  if (!llmClient) {
+    return;
+  }
+  const log = logger ?? import_logger.defaultLogger;
+  log.info("Executing vision-based recovery agent", { instruction });
   const viewport = page.viewportSize();
   if (!viewport) {
     throw new Error("Viewport size not found");
@@ -165,7 +170,7 @@ async function executeRecoveryAgent(page, instruction, logger, llmClient) {
   try {
     screenshot = (await page.screenshot({ fullPage: false, timeout: 1e4 })).toString("base64");
   } catch (screenshotError) {
-    logger.warn("Failed to take screenshot for recovery agent, skipping", {
+    log.warn("Failed to take screenshot for recovery agent, skipping", {
       screenshotError: screenshotError instanceof Error ? screenshotError.message : String(screenshotError)
     });
     throw new Error("Failed to take screenshot for recovery agent");
@@ -196,21 +201,21 @@ Analyze the screenshot and decide what action to take. If the task is complete o
       ],
       temperature: 0
     });
-    logger.info(`Recovery step ${step}/${maxSteps}`, {
+    log.info(`Recovery step ${step}/${maxSteps}`, {
       reasoning: result.reasoning,
       action: result.action
     });
     if (result.action.type === "done") {
-      logger.info("Recovery agent completed - no more actions needed");
+      log.info("Recovery agent completed - no more actions needed");
       break;
     }
-    await executeBrowserAction(page, result.action, logger);
+    await executeBrowserAction(page, result.action, log);
     await delay(2e3);
     screenshot = (await page.screenshot({ fullPage: false })).toString(
       "base64"
     );
   }
-  logger.info("Recovery agent execution completed");
+  log.info("Recovery agent execution completed");
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/runtime/recovery/agent.d.cts

@@ -1,5 +1,5 @@
 import { Page } from 'playwright';
-import { LoggerApi } from '../../shared/logger/logger.cjs';
+import { MinimalLogger } from '../../shared/logger/logger.cjs';
 import { LLMClient } from '../../shared/llm/types.cjs';
 import 'zod';
 
@@ -8,6 +8,6 @@ import 'zod';
  * Takes a screenshot, sends it to the LLM with the instruction, and executes
  * the LLM's suggested browser actions.
  */
-declare function executeRecoveryAgent(page: Page, instruction: string, logger: LoggerApi, llmClient: LLMClient): Promise<void>;
+declare function executeRecoveryAgent(page: Page, instruction: string, logger?: MinimalLogger, llmClient?: LLMClient): Promise<void>;
 
 export { executeRecoveryAgent };

package/dist/runtime/recovery/agent.d.ts

@@ -1,5 +1,5 @@
 import { Page } from 'playwright';
-import { LoggerApi } from '../../shared/logger/logger.js';
+import { MinimalLogger } from '../../shared/logger/logger.js';
 import { LLMClient } from '../../shared/llm/types.js';
 import 'zod';
 
@@ -8,6 +8,6 @@ import 'zod';
  * Takes a screenshot, sends it to the LLM with the instruction, and executes
  * the LLM's suggested browser actions.
  */
-declare function executeRecoveryAgent(page: Page, instruction: string, logger: LoggerApi, llmClient: LLMClient): Promise<void>;
+declare function executeRecoveryAgent(page: Page, instruction: string, logger?: MinimalLogger, llmClient?: LLMClient): Promise<void>;
 
 export { executeRecoveryAgent };

package/dist/runtime/recovery/agent.js

@@ -1,3 +1,4 @@
+import { defaultLogger } from "../../shared/logger/logger.js";
 function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -29,7 +30,7 @@ const KEY_MAPPINGS = {
 function mapKeyName(key) {
   return KEY_MAPPINGS[key.toUpperCase()] ?? key;
 }
-async function executeBrowserAction(page, action, logger) {
+async function executeBrowserAction(page, action, logger = defaultLogger) {
   switch (action.type) {
     case "click": {
       const { x, y, button = "left" } = action;
@@ -133,7 +134,11 @@ const recoveryActionSchema = z.object({
   ])
 });
 async function executeRecoveryAgent(page, instruction, logger, llmClient) {
-  logger.info("Executing vision-based recovery agent", { instruction });
+  if (!llmClient) {
+    return;
+  }
+  const log = logger ?? defaultLogger;
+  log.info("Executing vision-based recovery agent", { instruction });
   const viewport = page.viewportSize();
   if (!viewport) {
     throw new Error("Viewport size not found");
@@ -142,7 +147,7 @@ async function executeRecoveryAgent(page, instruction, logger, llmClient) {
   try {
     screenshot = (await page.screenshot({ fullPage: false, timeout: 1e4 })).toString("base64");
   } catch (screenshotError) {
-    logger.warn("Failed to take screenshot for recovery agent, skipping", {
+    log.warn("Failed to take screenshot for recovery agent, skipping", {
       screenshotError: screenshotError instanceof Error ? screenshotError.message : String(screenshotError)
     });
     throw new Error("Failed to take screenshot for recovery agent");
@@ -173,21 +178,21 @@ Analyze the screenshot and decide what action to take. If the task is complete o
       ],
       temperature: 0
     });
-    logger.info(`Recovery step ${step}/${maxSteps}`, {
+    log.info(`Recovery step ${step}/${maxSteps}`, {
       reasoning: result.reasoning,
       action: result.action
     });
     if (result.action.type === "done") {
-      logger.info("Recovery agent completed - no more actions needed");
+      log.info("Recovery agent completed - no more actions needed");
       break;
     }
-    await executeBrowserAction(page, result.action, logger);
+    await executeBrowserAction(page, result.action, log);
     await delay(2e3);
     screenshot = (await page.screenshot({ fullPage: false })).toString(
       "base64"
     );
   }
-  logger.info("Recovery agent execution completed");
+  log.info("Recovery agent execution completed");
 }
 export {
   executeRecoveryAgent

package/dist/runtime/recovery/errors.cjs

@@ -21,13 +21,15 @@ __export(errors_exports, {
   detectSubmissionError: () => detectSubmissionError
 });
 module.exports = __toCommonJS(errors_exports);
+var import_logger = require("../../shared/logger/logger.js");
 var import_zod = require("zod");
 const detectSubmissionErrorSchema = import_zod.z.object({
   hasError: import_zod.z.boolean().describe("Whether an error is visible on the page"),
   matchedKnownErrorId: import_zod.z.string().nullable().describe("The ID of the matched known error, or null if no match"),
   errorMessage: import_zod.z.string().nullable().describe("The error message visible on screen, or null if no error")
 });
-async function detectSubmissionError(page, logger, error, logContext, llmClient, knownErrors = []) {
+async function detectSubmissionError(page, error, logContext, llmClient, knownErrors = [], logger) {
+  const log = logger ?? import_logger.defaultLogger;
   let screenshot;
   let domSnapshot;
   try {
@@ -38,7 +40,7 @@ async function detectSubmissionError(page, logger, error, logContext, llmClient,
     });
     screenshot = data;
   } catch (screenshotError) {
-    logger.warn(
+    log.warn(
       "Failed to take screenshot via CDP for error detection, skipping LLM analysis",
       { screenshotError, originalError: error }
     );
@@ -48,7 +50,7 @@ async function detectSubmissionError(page, logger, error, logContext, llmClient,
     const htmlContent = await page.content();
     domSnapshot = htmlContent.length > 5e4 ? htmlContent.slice(0, 5e4) + "\n... [truncated]" : htmlContent;
   } catch (domError) {
-    logger.warn("Failed to capture DOM snapshot", {
+    log.warn("Failed to capture DOM snapshot", {
       domError: domError instanceof Error ? domError.message : String(domError)
     });
   }
@@ -91,14 +93,14 @@ ${domSnapshot}
     temperature: 0
   });
   if (!result.hasError) {
-    logger.info("No error detected by LLM", { result });
+    log.info("No error detected by LLM", { result });
   }
   if (result.matchedKnownErrorId) {
     const knownError = knownErrors.find(
       (e) => e.id === result.matchedKnownErrorId
     );
     if (knownError) {
-      logger.warn(logContext, {
+      log.warn(logContext, {
         error,
         browserError: result.errorMessage,
         knownErrorId: result.matchedKnownErrorId
@@ -110,7 +112,7 @@ ${domSnapshot}
       };
     }
   }
-  logger.warn(logContext, {
+  log.warn(logContext, {
     error,
     browserError: result.errorMessage
   });

package/dist/runtime/recovery/errors.d.cts

@@ -1,5 +1,5 @@
 import { Page } from 'playwright';
-import { LoggerApi } from '../../shared/logger/logger.cjs';
+import { MinimalLogger } from '../../shared/logger/logger.cjs';
 import { LLMClient } from '../../shared/llm/types.cjs';
 import 'zod';
 
@@ -26,6 +26,6 @@ type DetectedSubmissionError = {
  * @returns DetectedSubmissionError if a known error is matched
  * @throws The original error if no known error matches
  */
-declare function detectSubmissionError(page: Page, logger: LoggerApi, error: unknown, logContext: string, llmClient: LLMClient, knownErrors?: KnownSubmissionError[]): Promise<DetectedSubmissionError>;
+declare function detectSubmissionError(page: Page, error: unknown, logContext: string, llmClient: LLMClient, knownErrors?: KnownSubmissionError[], logger?: MinimalLogger): Promise<DetectedSubmissionError>;
 
 export { type DetectedSubmissionError, type KnownSubmissionError, detectSubmissionError };

package/dist/runtime/recovery/errors.d.ts

@@ -1,5 +1,5 @@
 import { Page } from 'playwright';
-import { LoggerApi } from '../../shared/logger/logger.js';
+import { MinimalLogger } from '../../shared/logger/logger.js';
 import { LLMClient } from '../../shared/llm/types.js';
 import 'zod';
 
@@ -26,6 +26,6 @@ type DetectedSubmissionError = {
  * @returns DetectedSubmissionError if a known error is matched
  * @throws The original error if no known error matches
  */
-declare function detectSubmissionError(page: Page, logger: LoggerApi, error: unknown, logContext: string, llmClient: LLMClient, knownErrors?: KnownSubmissionError[]): Promise<DetectedSubmissionError>;
+declare function detectSubmissionError(page: Page, error: unknown, logContext: string, llmClient: LLMClient, knownErrors?: KnownSubmissionError[], logger?: MinimalLogger): Promise<DetectedSubmissionError>;
 
 export { type DetectedSubmissionError, type KnownSubmissionError, detectSubmissionError };

package/dist/runtime/recovery/errors.js

@@ -1,10 +1,12 @@
+import { defaultLogger } from "../../shared/logger/logger.js";
 import { z } from "zod";
 const detectSubmissionErrorSchema = z.object({
   hasError: z.boolean().describe("Whether an error is visible on the page"),
   matchedKnownErrorId: z.string().nullable().describe("The ID of the matched known error, or null if no match"),
   errorMessage: z.string().nullable().describe("The error message visible on screen, or null if no error")
 });
-async function detectSubmissionError(page, logger, error, logContext, llmClient, knownErrors = []) {
+async function detectSubmissionError(page, error, logContext, llmClient, knownErrors = [], logger) {
+  const log = logger ?? defaultLogger;
   let screenshot;
   let domSnapshot;
   try {
@@ -15,7 +17,7 @@ async function detectSubmissionError(page, logger, error, logContext, llmClient,
     });
     screenshot = data;
   } catch (screenshotError) {
-    logger.warn(
+    log.warn(
       "Failed to take screenshot via CDP for error detection, skipping LLM analysis",
       { screenshotError, originalError: error }
     );
@@ -25,7 +27,7 @@ async function detectSubmissionError(page, logger, error, logContext, llmClient,
     const htmlContent = await page.content();
     domSnapshot = htmlContent.length > 5e4 ? htmlContent.slice(0, 5e4) + "\n... [truncated]" : htmlContent;
   } catch (domError) {
-    logger.warn("Failed to capture DOM snapshot", {
+    log.warn("Failed to capture DOM snapshot", {
       domError: domError instanceof Error ? domError.message : String(domError)
     });
   }
@@ -68,14 +70,14 @@ ${domSnapshot}
     temperature: 0
   });
   if (!result.hasError) {
-    logger.info("No error detected by LLM", { result });
+    log.info("No error detected by LLM", { result });
   }
   if (result.matchedKnownErrorId) {
     const knownError = knownErrors.find(
       (e) => e.id === result.matchedKnownErrorId
     );
     if (knownError) {
-      logger.warn(logContext, {
+      log.warn(logContext, {
         error,
         browserError: result.errorMessage,
         knownErrorId: result.matchedKnownErrorId
@@ -87,7 +89,7 @@ ${domSnapshot}
       };
     }
   }
-  logger.warn(logContext, {
+  log.warn(logContext, {
     error,
     browserError: result.errorMessage
   });

package/dist/runtime/recovery/recovery.cjs

@@ -21,13 +21,15 @@ __export(recovery_exports, {
   attemptWithRecovery: () => attemptWithRecovery
 });
 module.exports = __toCommonJS(recovery_exports);
+var import_logger = require("../../shared/logger/logger.js");
 var import_agent = require("./agent.js");
 async function attemptWithRecovery(page, fn, logger, llmClient) {
+  const log = logger ?? import_logger.defaultLogger;
   try {
     return await fn();
   } catch (error) {
     if (error instanceof Error && (error.message.includes("Target closed") || error.message.includes("browser has been closed") || error.message.includes("context or browser has been closed"))) {
-      logger.warn("Page/browser has been closed, cannot recover", {
+      log.warn("Page/browser has been closed, cannot recover", {
         error: error.message
       });
       throw error;
@@ -35,13 +37,13 @@ async function attemptWithRecovery(page, fn, logger, llmClient) {
     if (!llmClient) {
       throw error;
     }
-    logger.info("Action failed, attempting popup recovery", {
+    log.info("Action failed, attempting popup recovery", {
       error: error instanceof Error ? error.message : String(error)
     });
     await (0, import_agent.executeRecoveryAgent)(
       page,
       "Look at the page to see if there is a popup blocking the screen. If so, close the popup.",
-      logger,
+      log,
       llmClient
     );
     return await fn();

package/dist/runtime/recovery/recovery.d.cts

@@ -1,5 +1,5 @@
 import { Page } from 'playwright';
-import { LoggerApi } from '../../shared/logger/logger.cjs';
+import { MinimalLogger } from '../../shared/logger/logger.cjs';
 import { LLMClient } from '../../shared/llm/types.cjs';
 import 'zod';
 
@@ -7,6 +7,6 @@ import 'zod';
  * Attempts to execute a function, and if it fails, runs popup recovery
  * (if an LLM client is provided) and retries the function once.
  */
-declare function attemptWithRecovery<T>(page: Page, fn: () => Promise<T>, logger: LoggerApi, llmClient?: LLMClient): Promise<T>;
+declare function attemptWithRecovery<T>(page: Page, fn: () => Promise<T>, logger?: MinimalLogger, llmClient?: LLMClient): Promise<T>;
 
 export { attemptWithRecovery };

package/dist/runtime/recovery/recovery.d.ts

@@ -1,5 +1,5 @@
 import { Page } from 'playwright';
-import { LoggerApi } from '../../shared/logger/logger.js';
+import { MinimalLogger } from '../../shared/logger/logger.js';
 import { LLMClient } from '../../shared/llm/types.js';
 import 'zod';
 
@@ -7,6 +7,6 @@ import 'zod';
  * Attempts to execute a function, and if it fails, runs popup recovery
  * (if an LLM client is provided) and retries the function once.
  */
-declare function attemptWithRecovery<T>(page: Page, fn: () => Promise<T>, logger: LoggerApi, llmClient?: LLMClient): Promise<T>;
+declare function attemptWithRecovery<T>(page: Page, fn: () => Promise<T>, logger?: MinimalLogger, llmClient?: LLMClient): Promise<T>;
 
 export { attemptWithRecovery };

package/dist/runtime/recovery/recovery.js

@@ -1,10 +1,12 @@
+import { defaultLogger } from "../../shared/logger/logger.js";
 import { executeRecoveryAgent } from "./agent.js";
 async function attemptWithRecovery(page, fn, logger, llmClient) {
+  const log = logger ?? defaultLogger;
   try {
     return await fn();
   } catch (error) {
     if (error instanceof Error && (error.message.includes("Target closed") || error.message.includes("browser has been closed") || error.message.includes("context or browser has been closed"))) {
-      logger.warn("Page/browser has been closed, cannot recover", {
+      log.warn("Page/browser has been closed, cannot recover", {
         error: error.message
       });
       throw error;
@@ -12,13 +14,13 @@ async function attemptWithRecovery(page, fn, logger, llmClient) {
     if (!llmClient) {
       throw error;
     }
-    logger.info("Action failed, attempting popup recovery", {
+    log.info("Action failed, attempting popup recovery", {
       error: error instanceof Error ? error.message : String(error)
     });
     await executeRecoveryAgent(
       page,
       "Look at the page to see if there is a popup blocking the screen. If so, close the popup.",
-      logger,
+      log,
       llmClient
     );
     return await fn();

package/dist/shared/instrumentation/instrument.d.cts

@@ -1,11 +1,11 @@
 import { Page, BrowserContext } from 'playwright';
-import { LoggerApi } from '../logger/logger.cjs';
+import { MinimalLogger } from '../logger/logger.cjs';
 import { GhostCursorOptions } from '../visualization/ghost-cursor.cjs';
 import { HighlightOptions } from '../visualization/highlight.cjs';
 
 type InstrumentationOptions = {
     visualize?: boolean;
-    logger?: LoggerApi;
+    logger?: MinimalLogger;
     highlightBeforeActionMs?: number;
     ghostCursor?: GhostCursorOptions;
     highlight?: HighlightOptions;

package/dist/shared/instrumentation/instrument.d.ts

@@ -1,11 +1,11 @@
 import { Page, BrowserContext } from 'playwright';
-import { LoggerApi } from '../logger/logger.js';
+import { MinimalLogger } from '../logger/logger.js';
 import { GhostCursorOptions } from '../visualization/ghost-cursor.js';
 import { HighlightOptions } from '../visualization/highlight.js';
 
 type InstrumentationOptions = {
     visualize?: boolean;
-    logger?: LoggerApi;
+    logger?: MinimalLogger;
     highlightBeforeActionMs?: number;
     ghostCursor?: GhostCursorOptions;
     highlight?: HighlightOptions;