v0.6.22
Features
-
Page fallback recovery: Workflows now support a
recoveryActionoption that automatically handles nondeterministic UI blockers (popups, cookie banners, modals, overlays). When a supported Playwright Page or Locator action fails, Libretto invokes the recovery action and retries the original action once. The newcomputerUseRecoveryAction()andpopupRecoveryAction()helpers use an AI vision agent (OpenAI or Anthropic) to inspect the screen and dismiss blockers in configurable steps. -
Libretto Cloud pricing section: The website homepage now includes a Pricing section with Free, Pro, Team, and Enterprise tiers. Pricing links have been added to desktop and mobile navigation.
-
Provider benchmarking eval suite: A 27-case public website eval suite (
public-websites.eval.ts) has been added for comparing browser providers on live websites and anti-bot behavior. The eval CLI gains--repeat-countfor running suites multiple times with averaged aggregate metrics, bounded parallelism based on detected CPU count, recording URL collection, and per-result infra classification (clean-pass,anti-bot-failure,system-failure,ordinary-failure). -
Kernel provider recording support: The Kernel browser provider now accepts constructor options (
apiKey,headless,stealth,timeoutSeconds,enableRecording) instead of only reading from environment variables. WhenenableRecordingis enabled, the provider starts a Kernel replay session on creation and returns the recording URL alongside the live-view URL. Recording URLs are persisted in session state and printed after a run completes. -
Website benchmark results section: The marketing homepage now includes an interactive Benchmark Results section comparing Libretto cached workflow replay against Browser Use across Time, Cost, and Tokens tabs, sourced from the 27-case public website eval suite.
-
Brand kit page: A dedicated
/brand-kitpage provides downloadable logos, asciihedron animations, wordmarks, and social media assets (X, Reddit, Instagram, LinkedIn, OG image) across multiple formats (SVG, PNG, WebP, MP4, WebM).
Improvements
-
Workflow
recoveryActionin both call signatures: Theworkflow()function now acceptsrecoveryActionboth in the three-argument form (workflow(name, { input, output, recoveryAction }, handler)) and the new options-object form (workflow(name, { input, output, recoveryAction, handler })). -
Updated
workflow()signature guidance: Documentation across get-started, runtime reference, CLI reference, cloud hosting, and guides has been updated to show the currentworkflow(name, { input, output }, handler)signature with Zod schemas. The--paramsand--params-fileflags are now documented as being validated againstschemas.input. -
Docs navigation improvements: The Configuration page has been moved to
/docs/understand-libretto/configurationand added to the sidebar under "Understand Libretto." The Libretto Cloud Hosting overview no longer shows a beta warning callout. -
Blog JSON-LD structured data: Blog post pages now emit
BlogPosting,BreadcrumbList, andWebSitestructured data automatically from post metadata, keeping schema scripts out of markdown content. -
Fathom click tracking: The website now instruments key click targets (docs CTAs, prompt copy, demo booking, navigation links, social/community links, cloud/provider docs, FAQ toggles, and blog navigation) using a typed Fathom helper driven by
data-fathom-eventattributes. -
Homepage FAQ expanded: A new "Who is Libretto good for?" FAQ entry has been added, covering use cases such as customer portals, EHRs, payer sites, and legacy admin tools, and positioning Libretto relative to runtime browser agents.
-
README banner: The Libretto banner image is now displayed at the top of the root and npm package READMEs.
-
Public website benchmark documentation: A quickstart has been added to
evals/README.mdand a detailed reference (evals/references/public-website-benchmarks.md) covers benchmark design, agents, scoring, Cloud Run dispatch, artifact layout, and latest run numbers. -
Website title updated: The browser, Open Graph, and Twitter title has been updated to "Libretto | Turn website workflows into reliable APIs".