libretto 0.4.4 → 0.5.1

package/dist/runtime/network/index.cjs

@@ -1,28 +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 network_exports = {};
-__export(network_exports, {
-  pageRequest: () => import_network.pageRequest
-});
-module.exports = __toCommonJS(network_exports);
-var import_network = require("./network.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  pageRequest
-});

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

@@ -1,4 +0,0 @@
-export { PageRequestOptions, RequestConfig, pageRequest } from './network.cjs';
-import 'playwright';
-import 'zod';
-import '../../shared/logger/logger.cjs';

package/dist/runtime/network/network.cjs

@@ -1,91 +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 network_exports = {};
-__export(network_exports, {
-  pageRequest: () => pageRequest
-});
-module.exports = __toCommonJS(network_exports);
-async function pageRequest(page, config, options) {
-  const { url, method = "GET", headers = {}, body, bodyType = "json", responseType = "json" } = config;
-  const { logger, schema } = options ?? {};
-  const startTime = Date.now();
-  const fetchHeaders = { ...headers };
-  let fetchBody;
-  if (body !== void 0) {
-    if (bodyType === "form") {
-      fetchHeaders["Content-Type"] = "application/x-www-form-urlencoded";
-      if (typeof body === "string") {
-        fetchBody = body;
-      } else {
-        fetchBody = new URLSearchParams(
-          Object.entries(body).map(([k, v]) => [k, String(v)])
-        ).toString();
-      }
-    } else {
-      fetchHeaders["Content-Type"] = "application/json";
-      fetchBody = typeof body === "string" ? body : JSON.stringify(body);
-    }
-  }
-  const result = await page.evaluate(
-    async ({ url: url2, method: method2, headers: headers2, body: body2, responseType: responseType2 }) => {
-      const res = await fetch(url2, {
-        method: method2,
-        headers: headers2,
-        body: body2 ?? void 0
-      });
-      const status = res.status;
-      const ok = res.ok;
-      let data;
-      if (responseType2 === "json") {
-        data = await res.json();
-      } else {
-        data = await res.text();
-      }
-      return { status, ok, data };
-    },
-    { url, method, headers: fetchHeaders, body: fetchBody, responseType }
-  );
-  const duration = Date.now() - startTime;
-  if (!result.ok) {
-    logger?.warn("network:request:error", {
-      method,
-      url,
-      status: result.status,
-      duration,
-      body: typeof result.data === "string" ? result.data.slice(0, 500) : void 0
-    });
-    throw new Error(
-      `pageRequest failed: ${method} ${url} returned ${result.status}`
-    );
-  }
-  logger?.info("network:request", {
-    method,
-    url,
-    status: result.status,
-    duration
-  });
-  if (schema) {
-    return schema.parse(result.data);
-  }
-  return result.data;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  pageRequest
-});

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

@@ -1,28 +0,0 @@
-import { Page } from 'playwright';
-import z from 'zod';
-import { MinimalLogger } from '../../shared/logger/logger.cjs';
-
-type RequestConfig = {
-    url: string;
-    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
-    headers?: Record<string, string>;
-    body?: Record<string, any> | string;
-    /** How to serialize the body. Defaults to "json". */
-    bodyType?: "json" | "form";
-    /** How to parse the response. Defaults to "json". */
-    responseType?: "json" | "text" | "xml";
-};
-type PageRequestOptions<T extends z.ZodType | undefined = undefined> = {
-    logger?: MinimalLogger;
-    /** Optional Zod schema to validate the response body. */
-    schema?: T;
-};
-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 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.d.cts

@@ -1,13 +0,0 @@
-import { Page } from 'playwright';
-import { MinimalLogger } from '../../shared/logger/logger.cjs';
-import { LLMClient } from '../../shared/llm/types.cjs';
-import 'zod';
-
-/**
- * Executes a vision-based recovery agent to recover from browser automation failures.
- * 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?: MinimalLogger, llmClient?: LLMClient): Promise<void>;
-
-export { executeRecoveryAgent };

package/dist/runtime/recovery/errors.cjs

@@ -1,124 +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 errors_exports = {};
-__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, error, logContext, llmClient, knownErrors = [], logger) {
-  const log = logger ?? import_logger.defaultLogger;
-  let screenshot;
-  let domSnapshot;
-  try {
-    const cdpClient = await page.context().newCDPSession(page);
-    await cdpClient.send("Page.enable");
-    const { data } = await cdpClient.send("Page.captureScreenshot", {
-      format: "png"
-    });
-    screenshot = data;
-  } catch (screenshotError) {
-    log.warn(
-      "Failed to take screenshot via CDP for error detection, skipping LLM analysis",
-      { screenshotError, originalError: error }
-    );
-    throw error;
-  }
-  try {
-    const htmlContent = await page.content();
-    domSnapshot = htmlContent.length > 5e4 ? htmlContent.slice(0, 5e4) + "\n... [truncated]" : htmlContent;
-  } catch (domError) {
-    log.warn("Failed to capture DOM snapshot", {
-      domError: domError instanceof Error ? domError.message : String(domError)
-    });
-  }
-  const knownErrorsDescription = knownErrors.length > 0 ? `
-Known error patterns to look for:
-${knownErrors.map((e, i) => `${i + 1}. ID: "${e.id}" - Patterns: ${e.errorPatterns.join(", ")}`).join("\n")}
-` : "";
-  const prompt = `You are analyzing a screenshot and DOM of a web page to detect if an error occurred during a browser automation process.
-
-Context: ${logContext}
-
-${knownErrorsDescription}
-
-Analyze the screenshot and DOM snapshot to determine:
-1. Is there any error message, warning, or indication of failure visible on the page?
-2. If yes, does it match any of the known error patterns listed above?
-3. What is the exact error message or description of the problem?
-
-IMPORTANT:
-- Look carefully for error alerts, warning banners, error modals, red text, or any indication of failure
-- Check the DOM snapshot for error messages that may not be visible in the screenshot
-- If you see a known error pattern, use its exact ID in matchedKnownErrorId
-- If there's an error but it doesn't match any known pattern, set matchedKnownErrorId to null
-- If the page looks normal with no errors, set hasError to false
-
-${domSnapshot ? `<dom_snapshot>
-${domSnapshot}
-</dom_snapshot>` : ""}`;
-  const result = await llmClient.generateObjectFromMessages({
-    schema: detectSubmissionErrorSchema,
-    messages: [
-      {
-        role: "user",
-        content: [
-          { type: "text", text: prompt },
-          { type: "image", image: `data:image/png;base64,${screenshot}` }
-        ]
-      }
-    ],
-    temperature: 0
-  });
-  if (!result.hasError) {
-    log.info("No error detected by LLM", { result });
-  }
-  if (result.matchedKnownErrorId) {
-    const knownError = knownErrors.find(
-      (e) => e.id === result.matchedKnownErrorId
-    );
-    if (knownError) {
-      log.warn(logContext, {
-        error,
-        browserError: result.errorMessage,
-        knownErrorId: result.matchedKnownErrorId
-      });
-      return {
-        matched: true,
-        errorId: knownError.id,
-        message: knownError.userMessage
-      };
-    }
-  }
-  log.warn(logContext, {
-    error,
-    browserError: result.errorMessage
-  });
-  throw error;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  detectSubmissionError
-});

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

@@ -1,31 +0,0 @@
-import { Page } from 'playwright';
-import { MinimalLogger } from '../../shared/logger/logger.cjs';
-import { LLMClient } from '../../shared/llm/types.cjs';
-import 'zod';
-
-/**
- * Known error type for classifying submission errors.
- * errorPatterns are what the LLM should look for on screen.
- * userMessage is the friendly message returned when matched.
- */
-type KnownSubmissionError = {
-    id: string;
-    errorPatterns: string[];
-    userMessage: string;
-};
-type DetectedSubmissionError = {
-    matched: true;
-    errorId: string;
-    message: string;
-};
-/**
- * Uses screenshot + LLM vision to detect if an error occurred during a submission process.
- * Captures a screenshot via CDP (handles unresponsive pages), sends it to the LLM,
- * and checks against the provided known error patterns.
- *
- * @returns DetectedSubmissionError if a known error is matched
- * @throws The original error if no known error matches
- */
-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/index.cjs

@@ -1,34 +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 recovery_exports = {};
-__export(recovery_exports, {
-  attemptWithRecovery: () => import_recovery.attemptWithRecovery,
-  detectSubmissionError: () => import_errors.detectSubmissionError,
-  executeRecoveryAgent: () => import_agent.executeRecoveryAgent
-});
-module.exports = __toCommonJS(recovery_exports);
-var import_agent = require("./agent.js");
-var import_recovery = require("./recovery.js");
-var import_errors = require("./errors.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  attemptWithRecovery,
-  detectSubmissionError,
-  executeRecoveryAgent
-});

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

@@ -1,7 +0,0 @@
-export { executeRecoveryAgent } from './agent.cjs';
-export { attemptWithRecovery } from './recovery.cjs';
-export { DetectedSubmissionError, KnownSubmissionError, detectSubmissionError } from './errors.cjs';
-import 'playwright';
-import '../../shared/logger/logger.cjs';
-import '../../shared/llm/types.cjs';
-import 'zod';

package/dist/runtime/recovery/recovery.cjs

@@ -1,55 +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 recovery_exports = {};
-__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"))) {
-      log.warn("Page/browser has been closed, cannot recover", {
-        error: error.message
-      });
-      throw error;
-    }
-    if (!llmClient) {
-      throw error;
-    }
-    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.",
-      log,
-      llmClient
-    );
-    return await fn();
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  attemptWithRecovery
-});

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

@@ -1,12 +0,0 @@
-import { Page } from 'playwright';
-import { MinimalLogger } from '../../shared/logger/logger.cjs';
-import { LLMClient } from '../../shared/llm/types.cjs';
-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?: MinimalLogger, llmClient?: LLMClient): Promise<T>;
-
-export { attemptWithRecovery };

package/dist/shared/condense-dom/condense-dom.d.cts

@@ -1,34 +0,0 @@
-/**
- * DOM condensation — reduces serialized HTML for LLM consumption.
- *
- * All rules run unconditionally (no tiers). The function operates on
- * already-serialized HTML strings (the output of `page.content()`),
- * not a browser-side DOM walk or parsed DOM tree.
- *
- * Rules applied in order:
- *   1.  Noscript blocks — remove entirely
- *   2.  HTML comments — remove entirely
- *   3.  Script contents — hollow out, keep tags + useful attributes
- *   4.  Style contents — hollow out, keep tags + useful attributes
- *   5.  Embedded binary data — replace base64 data URIs
- *   6.  Attribute allowlist — keep trusted attrs, special-case class/style/URLs
- *   7.  SVG elements — collapse to single tag, extract title/desc
- *   8.  Inline style properties — keep only layout-relevant props
- *   9.  Non-semantic class names — filter or delete class values
- *  10.  (Cross-reference IDs — preserved, no action needed)
- *  11.  Framework-internal and SVG visual attributes — remove
- *  12.  Whitespace — collapse (preserve <pre> content)
- */
-type CondenseDomResult = {
-    /** The condensed HTML string. Valid, parseable HTML. */
-    html: string;
-    /** Character count of the input. */
-    originalLength: number;
-    /** Character count of the output. */
-    condensedLength: number;
-    /** Characters removed, keyed by rule name. */
-    reductions: Record<string, number>;
-};
-declare function condenseDom(html: string): CondenseDomResult;
-
-export { type CondenseDomResult, condenseDom };

package/dist/shared/config/config.cjs

@@ -1,44 +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 config_exports = {};
-__export(config_exports, {
-  isDebugMode: () => isDebugMode,
-  isDryRun: () => isDryRun,
-  shouldPauseBeforeMutation: () => shouldPauseBeforeMutation
-});
-module.exports = __toCommonJS(config_exports);
-function isDebugMode() {
-  return process.env.LIBRETTO_DEBUG === "true";
-}
-function isDryRun() {
-  const explicit = process.env.LIBRETTO_DRY_RUN;
-  if (explicit !== void 0) {
-    return explicit === "true";
-  }
-  return process.env.NODE_ENV === "development";
-}
-function shouldPauseBeforeMutation() {
-  return isDryRun() && isDebugMode();
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  isDebugMode,
-  isDryRun,
-  shouldPauseBeforeMutation
-});

package/dist/shared/config/config.d.cts

@@ -1,10 +0,0 @@
-/**
- * Runtime configuration for libretto.
- *
- * Values are derived from environment variables only.
- */
-declare function isDebugMode(): boolean;
-declare function isDryRun(): boolean;
-declare function shouldPauseBeforeMutation(): boolean;
-
-export { isDebugMode, isDryRun, shouldPauseBeforeMutation };

package/dist/shared/config/index.cjs

@@ -1,32 +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 config_exports = {};
-__export(config_exports, {
-  isDebugMode: () => import_config.isDebugMode,
-  isDryRun: () => import_config.isDryRun,
-  shouldPauseBeforeMutation: () => import_config.shouldPauseBeforeMutation
-});
-module.exports = __toCommonJS(config_exports);
-var import_config = require("./config.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  isDebugMode,
-  isDryRun,
-  shouldPauseBeforeMutation
-});

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

@@ -1 +0,0 @@
-export { isDebugMode, isDryRun, shouldPauseBeforeMutation } from './config.cjs';

package/dist/shared/debug/index.cjs

@@ -1,28 +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 debug_exports = {};
-__export(debug_exports, {
-  pause: () => import_pause.pause
-});
-module.exports = __toCommonJS(debug_exports);
-var import_pause = require("./pause.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  pause
-});

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

@@ -1 +0,0 @@
-export { pause } from './pause.cjs';