v1.5.2

alibaba/page-agentv1.5.2Mar 5, 2026by gaomeng1900

AI Summary

A major update introducing breaking changes to attribute naming, config structure, and Zod versions, alongside experimental llms.txt support and various performance improvements.

Key Highlights

DOM ignore attribute renamed
Config types restructured
Zod v3/v4 dual support
Experimental llms.txt support

Breaking Changes

Renamed DOM ignore attribute from data-browser-use-ignore to data-page-agent-ignore
Config types restructured (PageAgentConfig split into AgentConfig + PageAgentCoreConfig)
Zod v3/v4 dual support introduced

New Features

Experimental llms.txt support

Full Release Notes

### Breaking Changes

- **`data-browser-use-ignore` → `data-page-agent-ignore`** - DOM ignore attribute renamed to match the project identity
- **Config types restructured** - `PageAgentConfig` split into `AgentConfig` + `PageAgentCoreConfig`; config definitions moved from `config/index.ts` to `types.ts`
- **Zod v3/v4 dual support** - Libraries now accept both `zod@^3.25` and `zod@^4.0` as peer dependencies

### Features

- **Experimental `llms.txt` support** - Agent can fetch and include a site's `llms.txt` in context. Enable via `experimentalLlmsTxt: true`

### Improvements

- Default `maxSteps` changed from 20 to 40 for better for complex tasks out of the box
- Added 400ms wait between agent steps for page reactions
- Increased click wait time (100ms → 200ms) for more reliable interactions
- Removed debug `console.log` statements from scroll actions
- Reset observations on new task start
- Improved logging across packages