libretto 0.4.4 → 0.5.0

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';

package/dist/shared/debug/pause.cjs

@@ -1,86 +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 pause_exports = {};
-__export(pause_exports, {
-  pause: () => pause
-});
-module.exports = __toCommonJS(pause_exports);
-var import_node_fs = require("node:fs");
-var import_promises = require("node:fs/promises");
-var import_context = require("../../cli/core/context.js");
-var import_pause_signals = require("../../cli/core/pause-signals.js");
-var import_session = require("../../cli/core/session.js");
-function isPidRunning(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function getRunningSessions() {
-  return (0, import_session.listSessionsWithStateFile)().filter((candidate) => {
-    const state = (0, import_session.readSessionState)(candidate);
-    return state !== null && isPidRunning(state.pid);
-  });
-}
-function throwMissingSessionError() {
-  const runningSessions = getRunningSessions();
-  const lines = ["pause(session) requires a non-empty session ID."];
-  if (runningSessions.length > 0) {
-    lines.push("", "Running sessions:");
-    for (const runningSession of runningSessions) {
-      lines.push(`  ${runningSession}`);
-    }
-  }
-  throw new Error(lines.join("\n"));
-}
-async function pause(session) {
-  if (process.env.NODE_ENV === "production") {
-    return;
-  }
-  if (typeof session !== "string" || session.trim().length === 0) {
-    throwMissingSessionError();
-  }
-  const signalPaths = (0, import_pause_signals.getPauseSignalPaths)(session);
-  const { pausedSignalPath, resumeSignalPath } = signalPaths;
-  await (0, import_promises.mkdir)((0, import_context.getSessionDir)(session), { recursive: true });
-  await (0, import_pause_signals.removeSignalIfExists)(resumeSignalPath);
-  const details = {
-    sessionName: session,
-    pausedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    url: "unknown"
-  };
-  await (0, import_promises.writeFile)(pausedSignalPath, JSON.stringify(details, null, 2), "utf8");
-  console.log(`[pause] Paused (session: ${session})`);
-  console.log("[pause] Waiting for resume signal...");
-  const RESUME_POLL_INTERVAL_MS = 250;
-  while (!(0, import_node_fs.existsSync)(resumeSignalPath)) {
-    await new Promise(
-      (resolve) => setTimeout(resolve, RESUME_POLL_INTERVAL_MS)
-    );
-  }
-  await (0, import_pause_signals.removeSignalIfExists)(resumeSignalPath);
-  await (0, import_pause_signals.removeSignalIfExists)(pausedSignalPath);
-  console.log("[pause] Resume signal received. Continuing workflow...");
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  pause
-});

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

@@ -1,12 +0,0 @@
-/**
- * Standalone pause function.
- *
- * - In production (`NODE_ENV === "production"`), returns immediately (no-op).
- * - Otherwise, writes a `.paused` signal file and polls for a `.resume` signal,
- *   using the same file-based mechanism as the CLI runner.
- *
- * Import directly: `import { pause } from "libretto";`
- */
-declare function pause(session: string): Promise<void>;
-
-export { pause };

package/dist/shared/instrumentation/errors.cjs

@@ -1,81 +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, {
-  enrichTimeoutError: () => enrichTimeoutError
-});
-module.exports = __toCommonJS(errors_exports);
-async function enrichTimeoutError(err, locator, page) {
-  const reasons = [];
-  try {
-    const visible = await locator.isVisible().catch(() => null);
-    if (visible === false) {
-      reasons.push("Element is not visible");
-    }
-    if (typeof locator.isInViewport === "function") {
-      const inViewport = await locator.isInViewport().catch(() => null);
-      if (inViewport === false) {
-        reasons.push("Element is outside of the viewport");
-      }
-    }
-    const enabled = await locator.isEnabled().catch(() => null);
-    if (enabled === false) {
-      reasons.push("Element is not enabled (disabled)");
-    }
-    if (reasons.length === 0) {
-      const box = await locator.boundingBox().catch(() => null);
-      if (box) {
-        const centerX = box.x + box.width / 2;
-        const centerY = box.y + box.height / 2;
-        const interceptInfo = await page.evaluate(
-          ({ x, y }) => {
-            const els = document.elementsFromPoint(x, y);
-            if (!els || els.length < 2) return null;
-            const topEl = els[0];
-            if (!topEl) return null;
-            const tag = topEl.tagName.toLowerCase();
-            const id = topEl.id ? `#${topEl.id}` : "";
-            const cls = topEl.className ? `.${String(topEl.className).split(/\s+/).slice(0, 2).join(".")}` : "";
-            const text = (topEl.textContent || "").trim().slice(0, 40);
-            return {
-              tag,
-              preview: `<${tag}${id}${cls}>${text ? ` "${text}"` : ""}`
-            };
-          },
-          { x: centerX, y: centerY }
-        ).catch(() => null);
-        if (interceptInfo) {
-          reasons.push(
-            `Element may be intercepted by ${interceptInfo.preview}`
-          );
-        }
-      }
-    }
-  } catch {
-  }
-  if (reasons.length > 0) {
-    const enrichment = `
-[libretto diagnostics] ${reasons.join("; ")}`;
-    err.message = (err.message || "") + enrichment;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  enrichTimeoutError
-});

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

@@ -1,12 +0,0 @@
-import { Locator, Page } from 'playwright';
-
-/**
- * Enrich a timeout error from a pointer action (click/dblclick/hover) with
- * diagnostic information about why the action may have failed.
- *
- * Mutates err.message in-place to append the enrichment.
- * Best-effort: if any probe fails, we skip that check silently.
- */
-declare function enrichTimeoutError(err: any, locator: Locator, page: Page): Promise<void>;
-
-export { enrichTimeoutError };

package/dist/shared/instrumentation/index.cjs

@@ -1,35 +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 instrumentation_exports = {};
-__export(instrumentation_exports, {
-  enrichTimeoutError: () => import_errors.enrichTimeoutError,
-  installInstrumentation: () => import_instrument.installInstrumentation,
-  instrumentContext: () => import_instrument.instrumentContext,
-  instrumentPage: () => import_instrument.instrumentPage
-});
-module.exports = __toCommonJS(instrumentation_exports);
-var import_instrument = require("./instrument.js");
-var import_errors = require("./errors.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  enrichTimeoutError,
-  installInstrumentation,
-  instrumentContext,
-  instrumentPage
-});

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

@@ -1,6 +0,0 @@
-export { InstrumentationOptions, InstrumentedPage, installInstrumentation, instrumentContext, instrumentPage } from './instrument.cjs';
-export { enrichTimeoutError } from './errors.cjs';
-import 'playwright';
-import '../logger/logger.cjs';
-import '../visualization/ghost-cursor.cjs';
-import '../visualization/highlight.cjs';

package/dist/shared/instrumentation/instrument.cjs

@@ -1,206 +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 instrument_exports = {};
-__export(instrument_exports, {
-  installInstrumentation: () => installInstrumentation,
-  instrumentContext: () => instrumentContext,
-  instrumentPage: () => instrumentPage
-});
-module.exports = __toCommonJS(instrument_exports);
-var import_ghost_cursor = require("../visualization/ghost-cursor.js");
-var import_highlight = require("../visualization/highlight.js");
-var import_errors = require("./errors.js");
-const LOCATOR_ACTIONS = [
-  "click",
-  "dblclick",
-  "hover",
-  "fill",
-  "type",
-  "press",
-  "check",
-  "uncheck",
-  "selectOption",
-  "focus"
-];
-const NAV_ACTIONS = ["goto", "reload", "goBack", "goForward"];
-const POINTER_ACTIONS = /* @__PURE__ */ new Set(["click", "dblclick", "hover"]);
-const pageQueues = /* @__PURE__ */ new WeakMap();
-function enqueue(page, fn) {
-  const prev = pageQueues.get(page) ?? Promise.resolve();
-  const next = prev.then(fn, fn);
-  pageQueues.set(page, next);
-  return next;
-}
-async function visualizeBeforeAction(page, box, actionName, highlightMs) {
-  if (!box) return;
-  await (0, import_ghost_cursor.ensureGhostCursor)(page);
-  await (0, import_highlight.ensureHighlightLayer)(page);
-  const centerX = box.x + box.width / 2;
-  const centerY = box.y + box.height / 2;
-  await (0, import_highlight.showHighlight)(page, {
-    box,
-    durationMs: highlightMs + 200
-    // keep visible a bit past the cursor arrival
-  });
-  const cursorPos = await (0, import_ghost_cursor.getGhostCursorPosition)(page);
-  if (cursorPos) {
-    await (0, import_ghost_cursor.moveGhostCursorWithDistance)(page, cursorPos, {
-      x: centerX,
-      y: centerY
-    });
-  } else {
-    await (0, import_ghost_cursor.moveGhostCursor)(page, { x: centerX, y: centerY, durationMs: 200 });
-  }
-  if (actionName === "click" || actionName === "dblclick") {
-    await (0, import_ghost_cursor.ghostClick)(page, { x: centerX, y: centerY });
-  }
-}
-async function visualizeAfterAction(page) {
-  await (0, import_highlight.clearHighlights)(page);
-}
-function wrapLocatorActions(locator, page, opts) {
-  for (const method of LOCATOR_ACTIONS) {
-    if (typeof locator[method] !== "function") continue;
-    const orig = locator[method].bind(locator);
-    locator[method] = async (...args) => {
-      if (opts.visualize) {
-        await enqueue(page, async () => {
-          try {
-            const box = await locator.boundingBox();
-            await visualizeBeforeAction(
-              page,
-              box,
-              method,
-              opts.highlightBeforeActionMs
-            );
-          } catch {
-          }
-        });
-      }
-      try {
-        const result = await orig(...args);
-        if (opts.visualize) {
-          enqueue(page, () => visualizeAfterAction(page));
-        }
-        return result;
-      } catch (err) {
-        if (opts.visualize) {
-          enqueue(page, () => visualizeAfterAction(page));
-        }
-        if (POINTER_ACTIONS.has(method) && isTimeoutError(err)) {
-          await (0, import_errors.enrichTimeoutError)(err, locator, page);
-        }
-        throw err;
-      }
-    };
-  }
-}
-function isTimeoutError(err) {
-  if (!err || typeof err.message !== "string") return false;
-  return err.message.includes("Timeout") || err.message.includes("timeout") || err.name === "TimeoutError";
-}
-const LOCATOR_FACTORIES = [
-  "locator",
-  "getByRole",
-  "getByText",
-  "getByLabel",
-  "getByPlaceholder",
-  "getByAltText",
-  "getByTitle",
-  "getByTestId"
-];
-async function installInstrumentation(page, options) {
-  if (page.__librettoInstrumented) return;
-  page.__librettoInstrumented = true;
-  const visualize = options?.visualize ?? false;
-  const highlightBeforeActionMs = options?.highlightBeforeActionMs ?? 350;
-  const mergedOpts = { ...options, visualize, highlightBeforeActionMs };
-  if (visualize) {
-    await (0, import_ghost_cursor.ensureGhostCursor)(page, options?.ghostCursor);
-    await (0, import_highlight.ensureHighlightLayer)(page, options?.highlight);
-  }
-  for (const method of LOCATOR_ACTIONS) {
-    if (typeof page[method] !== "function") continue;
-    const orig = page[method].bind(page);
-    page[method] = async (...args) => {
-      if (visualize && typeof args[0] === "string") {
-        await enqueue(page, async () => {
-          try {
-            const loc = page.locator(args[0]);
-            const box = await loc.boundingBox();
-            await visualizeBeforeAction(page, box, method, highlightBeforeActionMs);
-          } catch {
-          }
-        });
-      }
-      try {
-        const result = await orig(...args);
-        if (visualize) {
-          enqueue(page, () => visualizeAfterAction(page));
-        }
-        return result;
-      } catch (err) {
-        if (visualize) {
-          enqueue(page, () => visualizeAfterAction(page));
-        }
-        if (POINTER_ACTIONS.has(method) && isTimeoutError(err) && typeof args[0] === "string") {
-          await (0, import_errors.enrichTimeoutError)(err, page.locator(args[0]), page);
-        }
-        throw err;
-      }
-    };
-  }
-  for (const method of NAV_ACTIONS) {
-    if (typeof page[method] !== "function") continue;
-    const orig = page[method].bind(page);
-    page[method] = async (...args) => {
-      options?.logger?.info(`instrumentation:${method}`, {
-        url: typeof args[0] === "string" ? args[0] : page.url()
-      });
-      return orig(...args);
-    };
-  }
-  for (const factory of LOCATOR_FACTORIES) {
-    if (typeof page[factory] !== "function") continue;
-    const origFactory = page[factory].bind(page);
-    page[factory] = (...factoryArgs) => {
-      const locator = origFactory(...factoryArgs);
-      wrapLocatorActions(locator, page, mergedOpts);
-      return locator;
-    };
-  }
-}
-async function instrumentPage(page, options) {
-  await installInstrumentation(page, options);
-  return page;
-}
-async function instrumentContext(context, options) {
-  for (const page of context.pages()) {
-    await installInstrumentation(page, options);
-  }
-  context.on("page", async (page) => {
-    await installInstrumentation(page, options);
-  });
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  installInstrumentation,
-  instrumentContext,
-  instrumentPage
-});

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

@@ -1,32 +0,0 @@
-import { Page, BrowserContext } from 'playwright';
-import { MinimalLogger } from '../logger/logger.cjs';
-import { GhostCursorOptions } from '../visualization/ghost-cursor.cjs';
-import { HighlightOptions } from '../visualization/highlight.cjs';
-
-type InstrumentationOptions = {
-    visualize?: boolean;
-    logger?: MinimalLogger;
-    highlightBeforeActionMs?: number;
-    ghostCursor?: GhostCursorOptions;
-    highlight?: HighlightOptions;
-};
-type InstrumentedPage = Page & {
-    __librettoInstrumented: true;
-};
-/**
- * In-place patching of a Page object to add visualization and error enrichment.
- * Modifies the page directly (does not return a new object).
- */
-declare function installInstrumentation(page: Page, options?: InstrumentationOptions): Promise<void>;
-/**
- * Returns a new object that proxies to the page with instrumentation applied.
- * The original page is not modified.
- */
-declare function instrumentPage(page: Page, options?: InstrumentationOptions): Promise<InstrumentedPage>;
-/**
- * Install overlays on a page and auto-install on all future pages in the context.
- * Useful when connecting to an existing browser via CDP.
- */
-declare function instrumentContext(context: BrowserContext, options?: InstrumentationOptions): Promise<void>;
-
-export { type InstrumentationOptions, type InstrumentedPage, installInstrumentation, instrumentContext, instrumentPage };