libretto 0.2.0 → 0.2.1

package/dist/shared/llm/types.d.cts

@@ -1,4 +1,4 @@
-import { ZodType, infer } from 'zod';
+import z from 'zod';
 
 type MessageContentPart = {
     type: "text";
@@ -19,16 +19,16 @@ type Message = {
  * recovery agents, and error detection.
  */
 interface LLMClient {
-    generateObject<T extends ZodType>(opts: {
+    generateObject<T extends z.ZodType>(opts: {
         prompt: string;
         schema: T;
         temperature?: number;
-    }): Promise<infer<T>>;
-    generateObjectFromMessages<T extends ZodType>(opts: {
+    }): Promise<z.infer<T>>;
+    generateObjectFromMessages<T extends z.ZodType>(opts: {
         messages: Message[];
         schema: T;
         temperature?: number;
-    }): Promise<infer<T>>;
+    }): Promise<z.infer<T>>;
 }
 
 export type { LLMClient, Message, MessageContentPart };

package/dist/shared/llm/types.d.ts

@@ -1,4 +1,4 @@
-import { ZodType, infer } from 'zod';
+import z from 'zod';
 
 type MessageContentPart = {
     type: "text";
@@ -19,16 +19,16 @@ type Message = {
  * recovery agents, and error detection.
  */
 interface LLMClient {
-    generateObject<T extends ZodType>(opts: {
+    generateObject<T extends z.ZodType>(opts: {
         prompt: string;
         schema: T;
         temperature?: number;
-    }): Promise<infer<T>>;
-    generateObjectFromMessages<T extends ZodType>(opts: {
+    }): Promise<z.infer<T>>;
+    generateObjectFromMessages<T extends z.ZodType>(opts: {
         messages: Message[];
         schema: T;
         temperature?: number;
-    }): Promise<infer<T>>;
+    }): Promise<z.infer<T>>;
 }
 
 export type { LLMClient, Message, MessageContentPart };

package/dist/shared/logger/index.cjs

@@ -20,6 +20,7 @@ var logger_exports = {};
 __export(logger_exports, {
   Logger: () => import_logger.Logger,
   createFileLogSink: () => import_sinks.createFileLogSink,
+  defaultLogger: () => import_logger.defaultLogger,
   jsonlConsoleSink: () => import_sinks.jsonlConsoleSink,
   prettyConsoleSink: () => import_sinks.prettyConsoleSink
 });
@@ -30,6 +31,7 @@ var import_sinks = require("./sinks.js");
 0 && (module.exports = {
   Logger,
   createFileLogSink,
+  defaultLogger,
   jsonlConsoleSink,
   prettyConsoleSink
 });

package/dist/shared/logger/index.d.cts

@@ -1,2 +1,2 @@
-export { LogOptions, Logger, LoggerApi, LoggerSink } from './logger.cjs';
+export { LogOptions, Logger, LoggerApi, LoggerSink, MinimalLogger, defaultLogger } from './logger.cjs';
 export { createFileLogSink, jsonlConsoleSink, prettyConsoleSink } from './sinks.cjs';

package/dist/shared/logger/index.d.ts

@@ -1,2 +1,2 @@
-export { LogOptions, Logger, LoggerApi, LoggerSink } from './logger.js';
+export { LogOptions, Logger, LoggerApi, LoggerSink, MinimalLogger, defaultLogger } from './logger.js';
 export { createFileLogSink, jsonlConsoleSink, prettyConsoleSink } from './sinks.js';

package/dist/shared/logger/index.js

@@ -1,4 +1,4 @@
-import { Logger } from "./logger.js";
+import { Logger, defaultLogger } from "./logger.js";
 import {
   createFileLogSink,
   prettyConsoleSink,
@@ -7,6 +7,7 @@ import {
 export {
   Logger,
   createFileLogSink,
+  defaultLogger,
   jsonlConsoleSink,
   prettyConsoleSink
 };

package/dist/shared/logger/logger.cjs

@@ -18,12 +18,24 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var logger_exports = {};
 __export(logger_exports, {
-  Logger: () => Logger
+  Logger: () => Logger,
+  defaultLogger: () => defaultLogger
 });
 module.exports = __toCommonJS(logger_exports);
 function generateId() {
   return Math.random().toString(36).substring(2, 15);
 }
+const defaultLogger = {
+  info(event, data) {
+    console.log(`[INFO] ${event}`, data ?? "");
+  },
+  warn(event, data) {
+    console.warn(`[WARN] ${event}`, data ?? "");
+  },
+  error(event, data) {
+    console.error(`[ERROR] ${event}`, data ?? "");
+  }
+};
 const sinkLifecycleState = /* @__PURE__ */ new WeakMap();
 function getSinkLifecycleState(sink) {
   const existingState = sinkLifecycleState.get(sink);
@@ -196,5 +208,6 @@ class Logger {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  Logger
+  Logger,
+  defaultLogger
 });

package/dist/shared/logger/logger.d.cts

@@ -1,6 +1,18 @@
 type LogOptions = {
     timestamp?: Date;
 };
+/**
+ * Minimal logger interface accepted by public-facing runtime functions.
+ * Any logger with info/warn/error methods satisfies this — no need to
+ * implement withScope, withContext, flush, etc.
+ */
+type MinimalLogger = {
+    info: (event: string, data?: Record<string, any>) => void;
+    warn: (event: string, data?: any) => void;
+    error: (event: string, data?: any) => any;
+};
+/** Default console logger used when callers omit the logger option. */
+declare const defaultLogger: MinimalLogger;
 type LoggerApi = {
     log: (event: string, data?: Record<string, any>, options?: LogOptions) => void;
     /**
@@ -67,4 +79,4 @@ declare class Logger implements LoggerApi {
     close(): Promise<void>;
 }
 
-export { type LogOptions, Logger, type LoggerApi, type LoggerSink };
+export { type LogOptions, Logger, type LoggerApi, type LoggerSink, type MinimalLogger, defaultLogger };

package/dist/shared/logger/logger.d.ts

@@ -1,6 +1,18 @@
 type LogOptions = {
     timestamp?: Date;
 };
+/**
+ * Minimal logger interface accepted by public-facing runtime functions.
+ * Any logger with info/warn/error methods satisfies this — no need to
+ * implement withScope, withContext, flush, etc.
+ */
+type MinimalLogger = {
+    info: (event: string, data?: Record<string, any>) => void;
+    warn: (event: string, data?: any) => void;
+    error: (event: string, data?: any) => any;
+};
+/** Default console logger used when callers omit the logger option. */
+declare const defaultLogger: MinimalLogger;
 type LoggerApi = {
     log: (event: string, data?: Record<string, any>, options?: LogOptions) => void;
     /**
@@ -67,4 +79,4 @@ declare class Logger implements LoggerApi {
     close(): Promise<void>;
 }
 
-export { type LogOptions, Logger, type LoggerApi, type LoggerSink };
+export { type LogOptions, Logger, type LoggerApi, type LoggerSink, type MinimalLogger, defaultLogger };

package/dist/shared/logger/logger.js

@@ -1,6 +1,17 @@
 function generateId() {
   return Math.random().toString(36).substring(2, 15);
 }
+const defaultLogger = {
+  info(event, data) {
+    console.log(`[INFO] ${event}`, data ?? "");
+  },
+  warn(event, data) {
+    console.warn(`[WARN] ${event}`, data ?? "");
+  },
+  error(event, data) {
+    console.error(`[ERROR] ${event}`, data ?? "");
+  }
+};
 const sinkLifecycleState = /* @__PURE__ */ new WeakMap();
 function getSinkLifecycleState(sink) {
   const existingState = sinkLifecycleState.get(sink);
@@ -172,5 +183,6 @@ class Logger {
   }
 }
 export {
-  Logger
+  Logger,
+  defaultLogger
 };

package/dist/shared/state/session-state.d.cts

@@ -15,14 +15,14 @@ declare const SessionStateFileSchema: z.ZodObject<{
     pid: number;
     session: string;
     startedAt: string;
-    status?: "completed" | "failed" | "paused" | "active" | "exited" | undefined;
+    status?: "active" | "paused" | "completed" | "failed" | "exited" | undefined;
 }, {
     version: 1;
     port: number;
     pid: number;
     session: string;
     startedAt: string;
-    status?: "completed" | "failed" | "paused" | "active" | "exited" | undefined;
+    status?: "active" | "paused" | "completed" | "failed" | "exited" | undefined;
 }>;
 type SessionStatus = z.infer<typeof SessionStatusSchema>;
 type SessionStateFile = z.infer<typeof SessionStateFileSchema>;

package/dist/shared/state/session-state.d.ts

@@ -15,14 +15,14 @@ declare const SessionStateFileSchema: z.ZodObject<{
     pid: number;
     session: string;
     startedAt: string;
-    status?: "completed" | "failed" | "paused" | "active" | "exited" | undefined;
+    status?: "active" | "paused" | "completed" | "failed" | "exited" | undefined;
 }, {
     version: 1;
     port: number;
     pid: number;
     session: string;
     startedAt: string;
-    status?: "completed" | "failed" | "paused" | "active" | "exited" | undefined;
+    status?: "active" | "paused" | "completed" | "failed" | "exited" | undefined;
 }>;
 type SessionStatus = z.infer<typeof SessionStatusSchema>;
 type SessionStateFile = z.infer<typeof SessionStateFileSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libretto",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "AI-powered browser automation library and CLI built on Playwright",
   "license": "MIT",
   "repository": {
@@ -25,11 +25,6 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
-    "./step": {
-      "types": "./dist/runtime/step/index.d.ts",
-      "import": "./dist/runtime/step/index.js",
-      "require": "./dist/runtime/step/index.cjs"
-    },
     "./logger": {
       "types": "./dist/shared/logger/index.d.ts",
       "import": "./dist/shared/logger/index.js",
@@ -98,7 +93,7 @@
     "build:cli": "tsup --config tsup.cli.config.ts",
     "type-check": "tsc --noEmit",
     "dev": "tsx src/cli/index.ts",
-    "test": "vitest run",
+    "test": "pnpm run build && vitest run",
     "test:watch": "vitest"
   },
   "peerDependencies": {
@@ -108,9 +103,15 @@
     "zod": ">=3.0.0"
   },
   "peerDependenciesMeta": {
-    "@ai-sdk/anthropic": { "optional": true },
-    "@ai-sdk/google-vertex": { "optional": true },
-    "@ai-sdk/openai": { "optional": true }
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/google-vertex": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.53",
@@ -118,6 +119,7 @@
     "@ai-sdk/openai": "^3.0.39",
     "@types/node": "^25.3.3",
     "@types/yargs": "^17.0.33",
+    "openai": "^6.27.0",
     "tsup": "^8.0.0",
     "tsx": "^4.19.2",
     "typescript": "^5.7.0",

package/dist/runtime/step/index.cjs

@@ -1,31 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var step_exports = {};
-__export(step_exports, {
-  createRunner: () => import_runner.createRunner,
-  step: () => import_step.step
-});
-module.exports = __toCommonJS(step_exports);
-var import_step = require("./step.js");
-var import_runner = require("./runner.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createRunner,
-  step
-});

package/dist/runtime/step/index.d.cts

@@ -1,7 +0,0 @@
-export { step } from './step.cjs';
-export { Runner, createRunner } from './runner.cjs';
-export { DebugBundle, RecoveryHandler, RunnerConfig, Step, StepContext, StepHandler, StepHistoryEntry, StepOptions } from './types.cjs';
-import 'playwright';
-import '../../shared/logger/logger.cjs';
-import '../../shared/llm/types.cjs';
-import 'zod';

package/dist/runtime/step/index.d.ts

@@ -1,7 +0,0 @@
-export { step } from './step.js';
-export { Runner, createRunner } from './runner.js';
-export { DebugBundle, RecoveryHandler, RunnerConfig, Step, StepContext, StepHandler, StepHistoryEntry, StepOptions } from './types.js';
-import 'playwright';
-import '../../shared/logger/logger.js';
-import '../../shared/llm/types.js';
-import 'zod';

package/dist/runtime/step/index.js

@@ -1,6 +0,0 @@
-import { step } from "./step.js";
-import { createRunner } from "./runner.js";
-export {
-  createRunner,
-  step
-};

package/dist/runtime/step/runner.cjs

@@ -1,208 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var runner_exports = {};
-__export(runner_exports, {
-  createRunner: () => createRunner
-});
-module.exports = __toCommonJS(runner_exports);
-var import_node_fs = require("node:fs");
-var import_node_path = require("node:path");
-var import_logger = require("../../shared/logger/logger.js");
-var import_sinks = require("../../shared/logger/sinks.js");
-var import_config = require("../../shared/config/config.js");
-var import_pause = require("../../shared/debug/pause.js");
-var import_recovery = require("../recovery/recovery.js");
-var import_paths = require("../../shared/paths/paths.js");
-function createRunner(config = {}) {
-  const {
-    llmClient,
-    dryRun: dryRunOption,
-    debug: debugOption,
-    sessionName = "libretto",
-    logDir: configuredLogDir
-  } = config;
-  const dryRun = dryRunOption ?? (0, import_config.isDryRun)();
-  const debug = debugOption ?? false;
-  const logDir = configuredLogDir ?? (0, import_paths.ensureLibrettoRunnerLogDir)(sessionName);
-  return {
-    run: async (page, steps) => {
-      (0, import_node_fs.mkdirSync)(logDir, { recursive: true });
-      const logPath = (0, import_paths.getRunnerLogPathForDir)(logDir);
-      const logger = new import_logger.Logger().withSink((0, import_sinks.createFileLogSink)({ filePath: logPath })).withSink(import_sinks.prettyConsoleSink);
-      const stepHistory = [];
-      logger.info("runner:start", {
-        totalSteps: steps.length,
-        dryRun,
-        debug,
-        logDir
-      });
-      for (const step of steps) {
-        const stepLogger = logger.withScope(`step:${step.name}`);
-        const startTime = Date.now();
-        if (dryRun && step.options.dryRun !== "execute") {
-          if (step.options.dryRun === "skip") {
-            stepLogger.info("skipped (dry-run)");
-            stepHistory.push({
-              name: step.name,
-              status: "skipped",
-              duration: 0
-            });
-            continue;
-          }
-          if (step.options.dryRun === "simulate" && step.options.simulate) {
-            stepLogger.info("simulating (dry-run)");
-            try {
-              await step.options.simulate({ logger: stepLogger });
-            } catch (simError) {
-              stepLogger.warn("simulate failed", { error: simError });
-            }
-            stepHistory.push({
-              name: step.name,
-              status: "simulated",
-              duration: Date.now() - startTime
-            });
-            continue;
-          }
-          stepLogger.info("skipped (dry-run, no simulate fn)");
-          stepHistory.push({
-            name: step.name,
-            status: "skipped",
-            duration: 0
-          });
-          continue;
-        }
-        await captureScreenshot(page, (0, import_node_path.join)(logDir, `${step.name}-start.png`), stepLogger);
-        stepLogger.info("start");
-        try {
-          await (0, import_recovery.attemptWithRecovery)(
-            page,
-            () => step.handler({ page, logger: stepLogger, config: { dryRun, debug, logDir } }),
-            stepLogger,
-            llmClient
-          );
-          stepHistory.push({
-            name: step.name,
-            status: "completed",
-            duration: Date.now() - startTime
-          });
-          stepLogger.info("end", { status: "completed", duration: Date.now() - startTime });
-        } catch (firstError) {
-          let recovered = false;
-          const customRecovery = step.options.recovery ?? {};
-          for (const [recoveryName, recoveryHandler] of Object.entries(customRecovery)) {
-            try {
-              stepLogger.info(`trying custom recovery: ${recoveryName}`);
-              await recoveryHandler({ page, logger: stepLogger });
-              await step.handler({ page, logger: stepLogger, config: { dryRun, debug, logDir } });
-              recovered = true;
-              stepHistory.push({
-                name: step.name,
-                status: "completed",
-                duration: Date.now() - startTime
-              });
-              stepLogger.info("end", {
-                status: "completed",
-                recoveredBy: recoveryName,
-                duration: Date.now() - startTime
-              });
-              break;
-            } catch {
-              stepLogger.warn(`custom recovery "${recoveryName}" failed`);
-            }
-          }
-          if (!recovered) {
-            stepHistory.push({
-              name: step.name,
-              status: "failed",
-              duration: Date.now() - startTime
-            });
-            const bundle = await generateDebugBundle(
-              page,
-              step.name,
-              firstError,
-              logDir,
-              logPath,
-              stepHistory,
-              stepLogger
-            );
-            stepLogger.info("step:debug-bundle", { path: bundle.bundlePath });
-            if (debug) {
-              await (0, import_pause.debugPause)({
-                page,
-                session: sessionName
-              });
-            }
-            throw firstError;
-          }
-        }
-        await captureScreenshot(page, (0, import_node_path.join)(logDir, `${step.name}-end.png`), stepLogger);
-      }
-      logger.info("runner:complete", {
-        totalSteps: steps.length,
-        completed: stepHistory.filter((s) => s.status === "completed").length,
-        skipped: stepHistory.filter((s) => s.status === "skipped").length,
-        simulated: stepHistory.filter((s) => s.status === "simulated").length
-      });
-      await logger.close();
-    }
-  };
-}
-async function captureScreenshot(page, filePath, logger) {
-  try {
-    const buffer = await page.screenshot({ fullPage: false, timeout: 5e3 });
-    (0, import_node_fs.writeFileSync)(filePath, buffer);
-  } catch (err) {
-    logger.warn("Failed to capture screenshot", {
-      path: filePath,
-      error: err instanceof Error ? err.message : String(err)
-    });
-  }
-}
-async function generateDebugBundle(page, stepName, error, logDir, logPath, stepHistory, logger) {
-  const screenshotPath = (0, import_node_path.join)(logDir, `${stepName}-error.png`);
-  const domPath = (0, import_node_path.join)(logDir, `${stepName}-error.html`);
-  const bundlePath = (0, import_node_path.join)(logDir, `${stepName}-debug-bundle.json`);
-  await captureScreenshot(page, screenshotPath, logger);
-  try {
-    const html = await page.content();
-    (0, import_node_fs.writeFileSync)(domPath, html);
-  } catch (domErr) {
-    logger.warn("Failed to capture DOM for debug bundle", {
-      error: domErr instanceof Error ? domErr.message : String(domErr)
-    });
-  }
-  const pageUrl = page.isClosed() ? "" : page.url();
-  const bundle = {
-    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    step: stepName,
-    error: error instanceof Error ? error.message : String(error),
-    stacktrace: error instanceof Error ? error.stack ?? "" : "",
-    screenshotPath,
-    domPath,
-    logPath,
-    stepHistory,
-    pageUrl
-  };
-  (0, import_node_fs.writeFileSync)(bundlePath, JSON.stringify(bundle, null, 2));
-  return { bundlePath };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createRunner
-});

package/dist/runtime/step/runner.d.cts

@@ -1,16 +0,0 @@
-import { Page } from 'playwright';
-import { Step, RunnerConfig } from './types.cjs';
-import '../../shared/logger/logger.cjs';
-import '../../shared/llm/types.cjs';
-import 'zod';
-
-type Runner = {
-    run: (page: Page, steps: Step[]) => Promise<void>;
-};
-/**
- * Creates a step runner that executes a sequence of steps with logging,
- * recovery, dry-run support, and debug bundle generation.
- */
-declare function createRunner(config?: RunnerConfig): Runner;
-
-export { type Runner, createRunner };

package/dist/runtime/step/runner.d.ts

@@ -1,16 +0,0 @@
-import { Page } from 'playwright';
-import { Step, RunnerConfig } from './types.js';
-import '../../shared/logger/logger.js';
-import '../../shared/llm/types.js';
-import 'zod';
-
-type Runner = {
-    run: (page: Page, steps: Step[]) => Promise<void>;
-};
-/**
- * Creates a step runner that executes a sequence of steps with logging,
- * recovery, dry-run support, and debug bundle generation.
- */
-declare function createRunner(config?: RunnerConfig): Runner;
-
-export { type Runner, createRunner };