chore(version): bump version to 1.5.5

Merge branch 'main' of https://github.com/alibaba/page-agent
docs: guideline against AI-generated PRs
2026-03-10 22:49:03 +08:00 · 2026-03-10 22:06:51 +08:00 · 2026-03-10 22:06:41 +08:00 · 2026-03-10 21:04:05 +08:00 · 2026-03-10 21:02:48 +08:00 · 2026-03-10 20:39:20 +08:00
34 changed files with 820 additions and 541 deletions
@@ -23,3 +23,4 @@ Closes #(issue)
 ## Requirements / 要求

 - [ ] I have read and follow the [Code of Conduct](../docs/CODE_OF_CONDUCT.md) and [Contributing Guide](../CONTRIBUTING.md) . / 我已阅读并遵守行为准则。
+- [ ] This PR is NOT generated by a bot or AI agent acting autonomously. I have authored or meaningfully reviewed every change. / 此 PR 不是由 bot 或 AI 自主生成的，我已亲自编写或充分审查了每一处变更。
@@ -1,5 +1,6 @@
 {
    "cSpell.words": [
+        "contenteditable",
        "deepseek",
        "historychange",
        "HITL",
@@ -1,21 +1,23 @@
-# Contributing to Page-Agent
+# Contributing to PageAgent

-Thank you for your interest in contributing to Page-Agent! We welcome contributions from everyone.
+♥️ We welcome contributions from everyone.

 ## 🚀 Quick Start

 ### Development Setup

 1. **Prerequisites**
+    - `macOS` / `Linux` / `WSL`
    - `node.js >= 20` with `npm >= 10`
    - An editor that supports `ts/eslint/prettier`
-    - Make sure `eslint`, `prettier` and `commitlint` work well
+    - Make sure `eslint`, `prettier` and `commitlint` work well. Un-linted code won't pass the CI.

 2. **Setup**

    ```bash
-    npm ci
+    npm i
    npm start          # Start demo and documentation site
+    npm run build      # Build libs and website
    ```

 ### Project Structure
@@ -27,11 +29,11 @@ This is a **monorepo** with npm workspaces containing **4 main packages**:
 - **Extension** (`packages/extension/`) - Chrome extension for multi-page tasks and browser-level automation
 - **Website** (`packages/website/`) - React documentation and landing page. Also as demo and test page for the core lib. private package `@page-agent/website`

-We use a simplified monorepo solution with `native npm-workspace + ts reference + vite alias`. No fancy tooling. Hoisting is required.
-
- When developing. Use alias so that we don't have to pre-build.
- When bundling. Use external and disable ts `paths` alias to leave deps out.
- When bundling `IIFE` and `Website`. Bundle everything including local packages.
+> We use a simplified monorepo solution with `native npm-workspace + ts reference + vite alias`. No fancy tooling. Hoisting is required.
+> 
+> - When developing. Use alias so that we don't have to pre-build.
+> - When bundling. Use external and disable ts `paths` alias.
+> - When bundling `IIFE` and `Website`. Bundle everything together.

 ## 🤝 How to Contribute

@@ -63,6 +65,7 @@ We use a simplified monorepo solution with `native npm-workspace + ts reference
    - Update documentation as needed

 4. **Test Your Changes**
+    - Build and lint everything.
    - Test in our demo website
    - Test it on other websites if applicable
    - `@TODO: test suite`
@@ -90,14 +93,17 @@ We use a simplified monorepo solution with `native npm-workspace + ts reference
 - Keep functions small and focused
 - Add JSDoc for public APIs

-### Vibe coding with AI
+### Vibe Coding with AI

- It's **recommended** to heavily rely on AI (aka "vibe coding") when maintaining **demo pages and tests**.
- Be very careful if AI ever touched the core lib!!!
+> [Vibe coding](https://en.wikipedia.org/wiki/Vibe_coding)
+
+- Vibe coding is **RECOMMENDED** when maintaining **the demo, the website, the UI and tests**.
+    - We have a [website/AGENTS.md](packages/website/AGENTS.md) for that.
+- Vibe coding is **NOT** allowed for the core lib!!!
+- NEVER try to vibe coding the MV3 extension!!! It is HELL.
 - Review anything AI wrote before make a commit. You are the author of anything you commit. NOT AI.
- Update the [AI instructions](AGENTS.md) when structure changed.

-If your lame AI assistant does not support [AGENTS.md](https://agents.md/). Add an alias for it:
+If your AI assistant does not support [AGENTS.md](https://agents.md/). Add an alias for it:

 - claude-code (`CLAUDE.md`)

@@ -135,26 +141,21 @@ If your lame AI assistant does not support [AGENTS.md](https://agents.md/). Add
    LLM_MODEL_NAME="qwen3:14b"
    ```

-    > ⚠️ Add `*` to `OLLAMA_ORIGINS` (403). Models < 10B unlikely strong enough. Requires tool_call support. Set context length > 15k (default 4k will NOT work): `$env:OLLAMA_CONTEXT_LENGTH=64000; ollama serve`
+    > @see https://alibaba.github.io/page-agent/docs/features/models#ollama for configuration

- Restart the dev server to load new env vars
- If not provided, the demo will the free testing proxy by default
-
-### Website Development
-
-```bash
-npm start
-```
+- **Restart the dev server** to load new env vars
+- If not provided, the demo will use the free testing proxy by default. By using it, you agree to its [terms](https://github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md).

 ### Extension Development

 ```bash
+# make sure you ran `npm run build:libs` first
+# and every time you changed the core libs
 npm run dev -w @page-agent/ext
 npm run zip -w @page-agent/ext
 ```

- Load extension in Chrome via `chrome://extensions` -> **Load unpacked**
- Use `packages/extension/docs/extension_api.md` (EN) or `packages/extension/docs/extension_api_zh.md` (ZH) for API integration details
+- Update `packages/extension/docs/extension_api.md` for API integration details

 ### Testing on Other Websites

@@ -172,7 +173,7 @@ npm run zip -w @page-agent/ext

 - Click the bookmark on any page to load Page-Agent

-> Warning: AK in your local `.env` will be inlined in the iife script.
+> Warning: AK in your local `.env` will be inlined in the iife script. Be very careful when you distribute the script.

 ### Adding Documentation

@@ -180,29 +181,20 @@ Ask an AI to help you add documentation to the `website/` package. Follow the ex

 > Our AGENTS.md file and guardrails are designed for this purpose. But please be careful and review anything AI generated.

-## 🎯 Contribution Areas
-
-We especially welcome contributions in:
-
- **Browser compatibility** improvements
- **Performance optimizations** for DOM processing
- **Documentation** and examples
- **Testing** and quality assurance
- **Accessibility** features
- **Internationalization** support
-
 ## 🚫 What We Don't Accept

- Changes that break existing API compatibility (Discuss first)
- Heavy dependencies to core library
+- Breaking changes and large PRs without prior discussion
+- Heavy dependencies to core libs
 - Contributions without proper testing
 - Code that doesn't follow project conventions
+- Dependencies or code with licenses incompatible with MIT
+- Bot or AI-generated pull requests without meaningful human involvement

 ## 📄 Legal

 By contributing to this project, you agree that your contributions will be licensed under the MIT License.

-> You may need to sign a github CLA before you create a PR.
+> CLA is optional.

 ## 💬 Questions?

@@ -210,4 +202,4 @@ By contributing to this project, you agree that your contributions will be licen
 - Check existing documentation and issues first
 - Be respectful and constructive in discussions

-Thank you for helping make Page-Agent better! 🎉
+Thank you for helping make PageAgent better! 🎉
@@ -11,9 +11,9 @@ The GUI Agent Living in Your Webpage. Control web interfaces with natural langua

 🌐 **English** | [中文](./docs/README-zh.md)

-👉 <a href="https://alibaba.github.io/page-agent/" target="_blank"><b>🚀 Demo</b></a> | <a href="https://alibaba.github.io/page-agent/docs/introduction/overview" target="_blank"><b>📖 Documentation</b></a>
+👉 <a href="https://alibaba.github.io/page-agent/" target="_blank"><b>🚀 Demo</b></a> | <a href="https://alibaba.github.io/page-agent/docs/introduction/overview" target="_blank"><b>📖 Documentation</b></a> | <a href="https://news.ycombinator.com/item?id=47264138" target="_blank">📢 Join HN Discussion</a>

-<video id="demo-video" src="https://github.com/user-attachments/assets/11aed429-b69c-49d5-8982-fa99b4a0e9a8" controls crossorigin muted></video>
+<video id="demo-video" src="https://github.com/user-attachments/assets/a1f2eae2-13fb-4aae-98cf-a3fc1620a6c2" controls crossorigin muted></video>

 ---

@@ -49,8 +49,8 @@ Fastest way to try PageAgent with our free Demo LLM:

 | Mirrors | URL                                                                                |
 | ------- | ---------------------------------------------------------------------------------- |
-| Global  | https://cdn.jsdelivr.net/npm/page-agent@1.5.1/dist/iife/page-agent.demo.js         |
-| China   | https://registry.npmmirror.com/page-agent/1.5.1/files/dist/iife/page-agent.demo.js |
+| Global  | https://cdn.jsdelivr.net/npm/page-agent@1.5.5/dist/iife/page-agent.demo.js         |
+| China   | https://registry.npmmirror.com/page-agent/1.5.5/files/dist/iife/page-agent.demo.js |

 > **⚠️ For technical evaluation only.** This demo CDN uses our free [testing LLM API](https://alibaba.github.io/page-agent/docs/features/models#free-testing-api). By using it, you agree to its [terms](https://github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md).

@@ -111,3 +111,11 @@ file and in the node_modules directory after installation.
 ---

 **⭐ Star this repo if you find PageAgent helpful!**
+
+<a href="https://www.star-history.com/?repos=alibaba%2Fpage-agent&type=date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/image?repos=alibaba/page-agent&type=date&theme=dark&legend=top-left&v=2" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/image?repos=alibaba/page-agent&type=date&legend=top-left&v=2" />
+   <img alt="Star History Chart" src="https://api.star-history.com/image?repos=alibaba/page-agent&type=date&legend=top-left&v=2" />
+ </picture>
+</a>
@@ -5,6 +5,37 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

+## [1.5.1] - 2026-03-05
+
+### 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
+
+### Extension v0.1.9
+
+> PageAgent 1.5.1
+
+- **Advanced config panel** - New collapsible section exposing Max Steps, System Instruction, and experimental `llms.txt` toggle
+- Streamlined User Auth Token description
+- Moved testing API notice below auth token section
+
+---
+
 ## [1.4.0] - 2026-02-27

 ### Features
@@ -13,7 +13,7 @@

 👉 <a href="https://alibaba.github.io/page-agent/" target="_blank"><b>🚀 Demo</b></a> | <a href="https://alibaba.github.io/page-agent/docs/introduction/overview" target="_blank"><b>📖 Documentation</b></a>

-<video id="demo-video" src="https://github.com/user-attachments/assets/11aed429-b69c-49d5-8982-fa99b4a0e9a8" controls crossorigin muted></video>
+<video id="demo-video" src="https://github.com/user-attachments/assets/a1f2eae2-13fb-4aae-98cf-a3fc1620a6c2" controls crossorigin muted></video>

 ---

@@ -49,8 +49,8 @@

 | Mirrors | URL                                                                                |
 | ------- | ---------------------------------------------------------------------------------- |
-| Global  | https://cdn.jsdelivr.net/npm/page-agent@1.5.1/dist/iife/page-agent.demo.js         |
-| China   | https://registry.npmmirror.com/page-agent/1.5.1/files/dist/iife/page-agent.demo.js |
+| Global  | https://cdn.jsdelivr.net/npm/page-agent@1.5.5/dist/iife/page-agent.demo.js         |
+| China   | https://registry.npmmirror.com/page-agent/1.5.5/files/dist/iife/page-agent.demo.js |

 > **⚠️ 仅用于技术评估。** 该 Demo CDN 使用了免费的[测试 LLM API](https://alibaba.github.io/page-agent/docs/features/models#free-testing-api)，使用即表示您同意其[条款](https://github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md)。

@@ -111,3 +111,11 @@ file and in the node_modules directory after installation.
 ---

 **⭐ 如果觉得 PageAgent 有用或有趣，请给项目点个星！**
+
+<a href="https://www.star-history.com/?repos=alibaba%2Fpage-agent&type=date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/image?repos=alibaba/page-agent&type=date&theme=dark&legend=top-left&v=2" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/image?repos=alibaba/page-agent&type=date&legend=top-left&v=2" />
+   <img alt="Star History Chart" src="https://api.star-history.com/image?repos=alibaba/page-agent&type=date&legend=top-left&v=2" />
+ </picture>
+</a>
@@ -1,20 +1,20 @@
 # Terms of Use & Privacy

-**Last updated:** February 2026
+**Last updated:** March 2026

-"We" in this document refers to the maintainers of the open-source Page Agent project (https://github.com/alibaba/page-agent). This document covers the Page Agent software itself and the testing services we provide — **not** any third-party product or service built with it.
+"We" in this document refers to the maintainers of the open-source Page Agent project (https://github.com/alibaba/page-agent). "The software" refers to PageAgent.js (the JavaScript library) and Page Agent Ext (the browser extension). This document covers the software itself and the testing API we provide — **not** any third-party product or service built with it.

 ---

 ## 1. Open Source Software Privacy

-Page Agent (PageAgent.js and Page Agent Extension) is a **client-side only** tool with a "Bring Your Own Key" (BYOK) architecture. The software itself does **not** include any backend service. The software does **not** collect or transmit any user data on its own, and the maintainers do **not** have access to your browsing activity, page content, or task instructions through the software.
+The software is a **client-side only** tool with a "Bring Your Own Key" (BYOK) architecture. The software itself does **not** include any backend service. The software does **not** collect or transmit any user data on its own, and we do **not** have access to your browsing activity, page content, or task instructions through the software.

 All data transmission occurs **only** between your browser and the LLM provider you configure. You are in full control of which provider receives your data.

 - You choose which LLM provider to use
 - You may configure your own API endpoint at any time
- The project is open source and can be audited: https://github.com/alibaba/page-agent
+- The project is open source under the [MIT License](https://github.com/alibaba/page-agent/blob/main/LICENSE) and can be audited at: https://github.com/alibaba/page-agent

 ---

@@ -22,21 +22,23 @@ All data transmission occurs **only** between your browser and the LLM provider

 To facilitate easy testing and technical evaluation, we provide a free testing LLM API. This API is used in the project homepage's live demo, the pre-built demo CDN bundles, and the browser extension's default configuration. Users may also use it independently for their own technical evaluation of page-agent.

-This free testing API is provided **strictly for technical evaluation and R&D purposes only**. It must not be used in any production environment. By using this service, you agree to the following terms:
+This free testing API is provided **strictly for technical evaluation and R&D purposes only**. It must not be used in any production environment. By using this API, you agree to the following terms:

-**No Sensitive Data**: You are strictly prohibited from inputting any Personal Identifiable Information (PII), confidential business data, financial/medical records, or using this agent on web pages containing such sensitive information.
+- **No Sensitive Data**: You are strictly prohibited from inputting any Personal Identifiable Information (PII), confidential business data, financial/medical records, or using this agent on web pages containing such sensitive information.

-**Zero Data Retention**: We do not store, log, or use your prompts or webpage data (DOM) for model training. All data is processed in-transit and immediately discarded. However, we do temporarily process necessary, identity-agnostic network data (such as IP addresses) solely for rate-limiting and anti-abuse purposes.
+- **Data Processing**: We do not store or log your prompts, webpage data (HTML), or any submitted content, nor do we use such data for model training. All data is processed in-transit and immediately discarded. We perform in-memory request validation to prevent abuse of the testing API, and temporarily process IP addresses for rate-limiting purposes. No data from these processes is retained. Data is processed through Alibaba Cloud infrastructure, which is subject to its own privacy policy.

-**Independent Infrastructure**: The `page-agent` open-source software is completely frontend-based with a "Bring Your Own Key" (BYOK) architecture and no built-in backend. To facilitate easy testing, the maintainers have independently purchased public cloud services from Alibaba Cloud China ([aliyun.com](https://www.aliyun.com) FC and BaiLian Qwen models). This project is not affiliated with, nor endorsed by, Alibaba Cloud.
+- **Independent Infrastructure**: The software is completely frontend-based with a "Bring Your Own Key" (BYOK) architecture and **no built-in backend**. To facilitate easy testing, the maintainers have purchased public cloud services from Alibaba Cloud China ([aliyun.com](https://www.aliyun.com) Function Compute and BaiLian Qwen models). This project is not a product of, nor endorsed by, Alibaba Cloud.

-**No Guaranteed Availability**: This testing API may be rate-limited, degraded, or discontinued at any time without prior notice.
+- **No Guaranteed Availability**: This testing API may be rate-limited, degraded, or discontinued at any time without prior notice.

-**"AS IS" & Limitation of Liability**: This service is provided strictly on an "AS IS" and "AS AVAILABLE" basis, without any warranties. The maintainers bear no liability for any data loss, service interruption, or legal consequences arising from your use of this demo.
+- **"AS IS" & Limitation of Liability**: This service is provided strictly on an "AS IS" and "AS AVAILABLE" basis, without any warranties. The maintainers bear no liability for any data loss, service interruption, or legal consequences arising from your use of this service.

-**Recommendation for Real Usage**: For secure and continuous usage, we strongly advise using the default BYOK mode with your own legally compliant commercial LLM API keys, or connecting to local, offline models (e.g., Ollama).
+- **Recommendation for Real Usage**: For secure and continuous usage, we strongly advise using the BYOK mode with your own legally compliant commercial LLM API keys, or connecting to local, offline models (e.g., Ollama).

-**Note**: This service processes data via servers located in Mainland China. If you are located in a region with strict data localization laws (such as the EU/EEA), please do not use this demo.
+**Note**: This free testing LLM API processes data via servers located in Mainland China. If you are located in a region with strict data localization laws (such as the EU/EEA), please do not use this API.
+
+**Age Requirement**: The software and testing API are not intended for use by individuals under the age of 13 (or the minimum age of digital consent in your jurisdiction).

 ---

@@ -49,19 +51,19 @@ The extension performs DOM analysis and automation actions **locally in your bro
 Data is transmitted to external servers **only when you initiate an automation task**. When this occurs:

 - Your task instructions (natural language commands)
- Simplified page structure (cleaned DOM) of all pages under the extension's control
+- Simplified page structure (cleaned HTML) of all pages under the extension's control

 are sent to the LLM API endpoint configured in **your settings**.

-> **Note:** The DOM cleaning process simplifies page structure for AI readability but **does not guarantee removal of sensitive information** (e.g., visible text, form values, or personal data on the page). Please be mindful of the page content when initiating tasks.
+> **Note:** The HTML cleaning process simplifies page structure for AI readability but **does not guarantee removal of sensitive information** (e.g., visible text, form values, or personal data on the page). Please be mindful of the page content when initiating tasks.

 **If you configure a third-party LLM provider** (e.g., OpenAI, Anthropic, or others), data is sent directly to that provider. Their privacy policies apply.

-**If you use the built-in testing API**, the terms in [Section 2](#2-testing-api-and-demo-disclaimer--terms-of-use) apply. By using the extension with the default testing API, you agree to those terms.
+**If you use the testing API**, the terms in [Section 2](#2-testing-api-and-demo-disclaimer--terms-of-use) apply. By using the extension with the default testing API, you agree to those terms.

 ### Data Storage

- **Local storage only**: Your configuration (API endpoint, API key, model selection) is stored in your browser via `chrome.storage.local`
+- **Local storage only**: Your configuration (API endpoint, API key, model selection) is stored in your browser via `chrome.storage.local` (or equivalent browser storage APIs)
 - **No cloud sync**: Configuration is not synced to any external server
 - **No analytics**: The extension does not include any analytics or tracking code

@@ -76,7 +78,7 @@ are sent to the LLM API endpoint configured in **your settings**.

 ## Changes

-We may update these terms as the project evolves.
+We may update these terms at our discretion.

 ## Contact

@@ -1,12 +1,12 @@
 {
    "name": "root",
-    "version": "1.5.1",
+    "version": "1.5.5",
    "lockfileVersion": 3,
    "requires": true,
    "packages": {
        "": {
            "name": "root",
-            "version": "1.5.1",
+            "version": "1.5.5",
            "license": "MIT",
            "workspaces": [
                "packages/page-controller",
@@ -18,13 +18,13 @@
                "packages/website"
            ],
            "devDependencies": {
-                "@commitlint/cli": "^20.4.2",
-                "@commitlint/config-conventional": "^20.4.2",
+                "@commitlint/cli": "^20.4.3",
+                "@commitlint/config-conventional": "^20.4.3",
                "@eslint/js": "^9.39.2",
-                "@microsoft/api-extractor": "^7.57.6",
+                "@microsoft/api-extractor": "^7.57.7",
                "@tailwindcss/vite": "^4.2.1",
                "@trivago/prettier-plugin-sort-imports": "^6.0.2",
-                "@types/node": "^25.3.3",
+                "@types/node": "^25.4.0",
                "@vitejs/plugin-react-swc": "^4.1.0",
                "chalk": "^5.6.2",
                "concurrently": "^9.2.1",
@@ -37,10 +37,10 @@
                "eslint-plugin-react-x": "^2.13.0",
                "globals": "^17.4.0",
                "husky": "^9.1.7",
-                "lint-staged": "^16.3.1",
+                "lint-staged": "^16.3.2",
                "prettier": "^3.8.0",
                "typescript": "^5.9.3",
-                "typescript-eslint": "^8.56.1",
+                "typescript-eslint": "^8.57.0",
                "unplugin-dts": "^1.0.0-beta.6",
                "vite": "^7.3.1",
                "vite-bundle-analyzer": "^1.3.6",
@@ -468,17 +468,17 @@
            }
        },
        "node_modules/@commitlint/cli": {
-            "version": "20.4.2",
-            "resolved": "https://registry.npmjs.org/@commitlint/cli/-/cli-20.4.2.tgz",
-            "integrity": "sha512-YjYSX2yj/WsVoxh9mNiymfFS2ADbg2EK4+1WAsMuckwKMCqJ5PDG0CJU/8GvmHWcv4VRB2V02KqSiecRksWqZQ==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/cli/-/cli-20.4.3.tgz",
+            "integrity": "sha512-Z37EMoDT7+Upg500vlr/vZrgRsb6Xc5JAA3Tv7BYbobnN/ZpqUeZnSLggBg2+1O+NptRDtyujr2DD1CPV2qwhA==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@commitlint/format": "^20.4.0",
-                "@commitlint/lint": "^20.4.2",
-                "@commitlint/load": "^20.4.0",
-                "@commitlint/read": "^20.4.0",
-                "@commitlint/types": "^20.4.0",
+                "@commitlint/format": "^20.4.3",
+                "@commitlint/lint": "^20.4.3",
+                "@commitlint/load": "^20.4.3",
+                "@commitlint/read": "^20.4.3",
+                "@commitlint/types": "^20.4.3",
                "tinyexec": "^1.0.0",
                "yargs": "^17.0.0"
            },
@@ -490,27 +490,27 @@
            }
        },
        "node_modules/@commitlint/config-conventional": {
-            "version": "20.4.2",
-            "resolved": "https://registry.npmjs.org/@commitlint/config-conventional/-/config-conventional-20.4.2.tgz",
-            "integrity": "sha512-rwkTF55q7Q+6dpSKUmJoScV0f3EpDlWKw2UPzklkLS4o5krMN1tPWAVOgHRtyUTMneIapLeQwaCjn44Td6OzBQ==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/config-conventional/-/config-conventional-20.4.3.tgz",
+            "integrity": "sha512-9RtLySbYQAs8yEqWEqhSZo9nYhbm57jx7qHXtgRmv/nmeQIjjMcwf6Dl+y5UZcGWgWx435TAYBURONaJIuCjWg==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@commitlint/types": "^20.4.0",
-                "conventional-changelog-conventionalcommits": "^9.1.0"
+                "@commitlint/types": "^20.4.3",
+                "conventional-changelog-conventionalcommits": "^9.2.0"
            },
            "engines": {
                "node": ">=v18"
            }
        },
        "node_modules/@commitlint/config-validator": {
-            "version": "20.4.0",
-            "resolved": "https://registry.npmjs.org/@commitlint/config-validator/-/config-validator-20.4.0.tgz",
-            "integrity": "sha512-zShmKTF+sqyNOfAE0vKcqnpvVpG0YX8F9G/ZIQHI2CoKyK+PSdladXMSns400aZ5/QZs+0fN75B//3Q5CHw++w==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/config-validator/-/config-validator-20.4.3.tgz",
+            "integrity": "sha512-jCZpZFkcSL3ZEdL5zgUzFRdytv3xPo8iukTe9VA+QGus/BGhpp1xXSVu2B006GLLb2gYUAEGEqv64kTlpZNgmA==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@commitlint/types": "^20.4.0",
+                "@commitlint/types": "^20.4.3",
                "ajv": "^8.11.0"
            },
            "engines": {
@@ -518,13 +518,13 @@
            }
        },
        "node_modules/@commitlint/ensure": {
-            "version": "20.4.1",
-            "resolved": "https://registry.npmjs.org/@commitlint/ensure/-/ensure-20.4.1.tgz",
-            "integrity": "sha512-WLQqaFx1pBooiVvBrA1YfJNFqZF8wS/YGOtr5RzApDbV9tQ52qT5VkTsY65hFTnXhW8PcDfZLaknfJTmPejmlw==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/ensure/-/ensure-20.4.3.tgz",
+            "integrity": "sha512-WcXGKBNn0wBKpX8VlXgxqedyrLxedIlLBCMvdamLnJFEbUGJ9JZmBVx4vhLV3ZyA8uONGOb+CzW0Y9HDbQ+ONQ==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@commitlint/types": "^20.4.0",
+                "@commitlint/types": "^20.4.3",
                "lodash.camelcase": "^4.3.0",
                "lodash.kebabcase": "^4.1.1",
                "lodash.snakecase": "^4.1.1",
@@ -546,13 +546,13 @@
            }
        },
        "node_modules/@commitlint/format": {
-            "version": "20.4.0",
-            "resolved": "https://registry.npmjs.org/@commitlint/format/-/format-20.4.0.tgz",
-            "integrity": "sha512-i3ki3WR0rgolFVX6r64poBHXM1t8qlFel1G1eCBvVgntE3fCJitmzSvH5JD/KVJN/snz6TfaX2CLdON7+s4WVQ==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/format/-/format-20.4.3.tgz",
+            "integrity": "sha512-UDJVErjLbNghop6j111rsHJYGw6MjCKAi95K0GT2yf4eeiDHy3JDRLWYWEjIaFgO+r+dQSkuqgJ1CdMTtrvHsA==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@commitlint/types": "^20.4.0",
+                "@commitlint/types": "^20.4.3",
                "picocolors": "^1.1.1"
            },
            "engines": {
@@ -560,13 +560,13 @@
            }
        },
        "node_modules/@commitlint/is-ignored": {
-            "version": "20.4.1",
-            "resolved": "https://registry.npmjs.org/@commitlint/is-ignored/-/is-ignored-20.4.1.tgz",
-            "integrity": "sha512-In5EO4JR1lNsAv1oOBBO24V9ND1IqdAJDKZiEpdfjDl2HMasAcT7oA+5BKONv1pRoLG380DGPE2W2RIcUwdgLA==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/is-ignored/-/is-ignored-20.4.3.tgz",
+            "integrity": "sha512-W5VQKZ7fdJ1X3Tko+h87YZaqRMGN1KvQKXyCM8xFdxzMIf1KCZgN4uLz3osLB1zsFcVS4ZswHY64LI26/9ACag==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@commitlint/types": "^20.4.0",
+                "@commitlint/types": "^20.4.3",
                "semver": "^7.6.0"
            },
            "engines": {
@@ -574,33 +574,33 @@
            }
        },
        "node_modules/@commitlint/lint": {
-            "version": "20.4.2",
-            "resolved": "https://registry.npmjs.org/@commitlint/lint/-/lint-20.4.2.tgz",
-            "integrity": "sha512-buquzNRtFng6xjXvBU1abY/WPEEjCgUipNQrNmIWe8QuJ6LWLtei/LDBAzEe5ASm45+Q9L2Xi3/GVvlj50GAug==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/lint/-/lint-20.4.3.tgz",
+            "integrity": "sha512-CYOXL23e+nRKij81+d0+dymtIi7Owl9QzvblJYbEfInON/4MaETNSLFDI74LDu+YJ0ML5HZyw9Vhp9QpckwQ0A==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@commitlint/is-ignored": "^20.4.1",
-                "@commitlint/parse": "^20.4.1",
-                "@commitlint/rules": "^20.4.2",
-                "@commitlint/types": "^20.4.0"
+                "@commitlint/is-ignored": "^20.4.3",
+                "@commitlint/parse": "^20.4.3",
+                "@commitlint/rules": "^20.4.3",
+                "@commitlint/types": "^20.4.3"
            },
            "engines": {
                "node": ">=v18"
            }
        },
        "node_modules/@commitlint/load": {
-            "version": "20.4.0",
-            "resolved": "https://registry.npmjs.org/@commitlint/load/-/load-20.4.0.tgz",
-            "integrity": "sha512-Dauup/GfjwffBXRJUdlX/YRKfSVXsXZLnINXKz0VZkXdKDcaEILAi9oflHGbfydonJnJAbXEbF3nXPm9rm3G6A==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/load/-/load-20.4.3.tgz",
+            "integrity": "sha512-3cdJOUVP+VcgHa7bhJoWS+Z8mBNXB5aLWMBu7Q7uX8PSeWDzdbrBlR33J1MGGf7r1PZDp+mPPiFktk031PgdRw==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@commitlint/config-validator": "^20.4.0",
+                "@commitlint/config-validator": "^20.4.3",
                "@commitlint/execute-rule": "^20.0.0",
-                "@commitlint/resolve-extends": "^20.4.0",
-                "@commitlint/types": "^20.4.0",
-                "cosmiconfig": "^9.0.0",
+                "@commitlint/resolve-extends": "^20.4.3",
+                "@commitlint/types": "^20.4.3",
+                "cosmiconfig": "^9.0.1",
                "cosmiconfig-typescript-loader": "^6.1.0",
                "is-plain-obj": "^4.1.0",
                "lodash.mergewith": "^4.6.2",
@@ -611,9 +611,9 @@
            }
        },
        "node_modules/@commitlint/message": {
-            "version": "20.4.0",
-            "resolved": "https://registry.npmjs.org/@commitlint/message/-/message-20.4.0.tgz",
-            "integrity": "sha512-B5lGtvHgiLAIsK5nLINzVW0bN5hXv+EW35sKhYHE8F7V9Uz1fR4tx3wt7mobA5UNhZKUNgB/+ldVMQE6IHZRyA==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/message/-/message-20.4.3.tgz",
+            "integrity": "sha512-6akwCYrzcrFcTYz9GyUaWlhisY4lmQ3KvrnabmhoeAV8nRH4dXJAh4+EUQ3uArtxxKQkvxJS78hNX2EU3USgxQ==",
            "dev": true,
            "license": "MIT",
            "engines": {
@@ -621,29 +621,29 @@
            }
        },
        "node_modules/@commitlint/parse": {
-            "version": "20.4.1",
-            "resolved": "https://registry.npmjs.org/@commitlint/parse/-/parse-20.4.1.tgz",
-            "integrity": "sha512-XNtZjeRcFuAfUnhYrCY02+mpxwY4OmnvD3ETbVPs25xJFFz1nRo/25nHj+5eM+zTeRFvWFwD4GXWU2JEtoK1/w==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/parse/-/parse-20.4.3.tgz",
+            "integrity": "sha512-hzC3JCo3zs3VkQ833KnGVuWjWIzR72BWZWjQM7tY/7dfKreKAm7fEsy71tIFCRtxf2RtMP2d3RLF1U9yhFSccA==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@commitlint/types": "^20.4.0",
-                "conventional-changelog-angular": "^8.1.0",
-                "conventional-commits-parser": "^6.2.1"
+                "@commitlint/types": "^20.4.3",
+                "conventional-changelog-angular": "^8.2.0",
+                "conventional-commits-parser": "^6.3.0"
            },
            "engines": {
                "node": ">=v18"
            }
        },
        "node_modules/@commitlint/read": {
-            "version": "20.4.0",
-            "resolved": "https://registry.npmjs.org/@commitlint/read/-/read-20.4.0.tgz",
-            "integrity": "sha512-QfpFn6/I240ySEGv7YWqho4vxqtPpx40FS7kZZDjUJ+eHxu3azfhy7fFb5XzfTqVNp1hNoI3tEmiEPbDB44+cg==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/read/-/read-20.4.3.tgz",
+            "integrity": "sha512-j42OWv3L31WfnP8WquVjHZRt03w50Y/gEE8FAyih7GQTrIv2+pZ6VZ6pWLD/ml/3PO+RV2SPtRtTp/MvlTb8rQ==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@commitlint/top-level": "^20.4.0",
-                "@commitlint/types": "^20.4.0",
+                "@commitlint/top-level": "^20.4.3",
+                "@commitlint/types": "^20.4.3",
                "git-raw-commits": "^4.0.0",
                "minimist": "^1.2.8",
                "tinyexec": "^1.0.0"
@@ -653,14 +653,14 @@
            }
        },
        "node_modules/@commitlint/resolve-extends": {
-            "version": "20.4.0",
-            "resolved": "https://registry.npmjs.org/@commitlint/resolve-extends/-/resolve-extends-20.4.0.tgz",
-            "integrity": "sha512-ay1KM8q0t+/OnlpqXJ+7gEFQNlUtSU5Gxr8GEwnVf2TPN3+ywc5DzL3JCxmpucqxfHBTFwfRMXxPRRnR5Ki20g==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/resolve-extends/-/resolve-extends-20.4.3.tgz",
+            "integrity": "sha512-QucxcOy+00FhS9s4Uy0OyS5HeUV+hbC6OLqkTSIm6fwMdKva+OEavaCDuLtgd9akZZlsUo//XzSmPP3sLKBPog==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@commitlint/config-validator": "^20.4.0",
-                "@commitlint/types": "^20.4.0",
+                "@commitlint/config-validator": "^20.4.3",
+                "@commitlint/types": "^20.4.3",
                "global-directory": "^4.0.1",
                "import-meta-resolve": "^4.0.0",
                "lodash.mergewith": "^4.6.2",
@@ -671,16 +671,16 @@
            }
        },
        "node_modules/@commitlint/rules": {
-            "version": "20.4.2",
-            "resolved": "https://registry.npmjs.org/@commitlint/rules/-/rules-20.4.2.tgz",
-            "integrity": "sha512-oz83pnp5Yq6uwwTAabuVQPNlPfeD2Y5ZjMb7Wx8FSUlu4sLYJjbBWt8031Z0osCFPfHzAwSYrjnfDFKtuSMdKg==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/rules/-/rules-20.4.3.tgz",
+            "integrity": "sha512-Yuosd7Grn5qiT7FovngXLyRXTMUbj9PYiSkvUgWK1B5a7+ZvrbWDS7epeUapYNYatCy/KTpPFPbgLUdE+MUrBg==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@commitlint/ensure": "^20.4.1",
-                "@commitlint/message": "^20.4.0",
+                "@commitlint/ensure": "^20.4.3",
+                "@commitlint/message": "^20.4.3",
                "@commitlint/to-lines": "^20.0.0",
-                "@commitlint/types": "^20.4.0"
+                "@commitlint/types": "^20.4.3"
            },
            "engines": {
                "node": ">=v18"
@@ -697,9 +697,9 @@
            }
        },
        "node_modules/@commitlint/top-level": {
-            "version": "20.4.0",
-            "resolved": "https://registry.npmjs.org/@commitlint/top-level/-/top-level-20.4.0.tgz",
-            "integrity": "sha512-NDzq8Q6jmFaIIBC/GG6n1OQEaHdmaAAYdrZRlMgW6glYWGZ+IeuXmiymDvQNXPc82mVxq2KiE3RVpcs+1OeDeA==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/top-level/-/top-level-20.4.3.tgz",
+            "integrity": "sha512-qD9xfP6dFg5jQ3NMrOhG0/w5y3bBUsVGyJvXxdWEwBm8hyx4WOk3kKXw28T5czBYvyeCVJgJJ6aoJZUWDpaacQ==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
@@ -710,13 +710,13 @@
            }
        },
        "node_modules/@commitlint/types": {
-            "version": "20.4.0",
-            "resolved": "https://registry.npmjs.org/@commitlint/types/-/types-20.4.0.tgz",
-            "integrity": "sha512-aO5l99BQJ0X34ft8b0h7QFkQlqxC6e7ZPVmBKz13xM9O8obDaM1Cld4sQlJDXXU/VFuUzQ30mVtHjVz74TuStw==",
+            "version": "20.4.3",
+            "resolved": "https://registry.npmjs.org/@commitlint/types/-/types-20.4.3.tgz",
+            "integrity": "sha512-51OWa1Gi6ODOasPmfJPq6js4pZoomima4XLZZCrkldaH2V5Nb3bVhNXPeT6XV0gubbainSpTw4zi68NqAeCNCg==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "conventional-commits-parser": "^6.2.1",
+                "conventional-commits-parser": "^6.3.0",
                "picocolors": "^1.1.1"
            },
            "engines": {
@@ -1685,9 +1685,9 @@
            }
        },
        "node_modules/@microsoft/api-extractor": {
-            "version": "7.57.6",
-            "resolved": "https://registry.npmjs.org/@microsoft/api-extractor/-/api-extractor-7.57.6.tgz",
-            "integrity": "sha512-0rFv/D8Grzw1Mjs2+8NGUR+o4h9LVm5zKRtMeWnpdB5IMJF4TeHCL1zR5LMCIudkOvyvjbhMG5Wjs0B5nqsrRQ==",
+            "version": "7.57.7",
+            "resolved": "https://registry.npmjs.org/@microsoft/api-extractor/-/api-extractor-7.57.7.tgz",
+            "integrity": "sha512-kmnmVs32MFWbV5X6BInC1/TfCs7y1ugwxv1xHsAIj/DyUfoe7vtO0alRUgbQa57+yRGHBBjlNcEk33SCAt5/dA==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
@@ -1700,7 +1700,7 @@
                "@rushstack/ts-command-line": "5.3.3",
                "diff": "~8.0.2",
                "lodash": "~4.17.23",
-                "minimatch": "10.2.1",
+                "minimatch": "10.2.3",
                "resolve": "~1.22.1",
                "semver": "~7.5.4",
                "source-map": "~0.6.1",
@@ -3050,6 +3050,19 @@
                "string-argv": "~0.3.1"
            }
        },
+        "node_modules/@simple-libs/stream-utils": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/@simple-libs/stream-utils/-/stream-utils-1.2.0.tgz",
+            "integrity": "sha512-KxXvfapcixpz6rVEB6HPjOUZT22yN6v0vI0urQSk1L8MlEWPDFCZkhw2xmkyoTGYeFw7tWTZd7e3lVzRZRN/EA==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=18"
+            },
+            "funding": {
+                "url": "https://ko-fi.com/dangreen"
+            }
+        },
        "node_modules/@swc/core": {
            "version": "1.15.11",
            "resolved": "https://registry.npmjs.org/@swc/core/-/core-1.15.11.tgz",
@@ -3788,9 +3801,9 @@
            "license": "MIT"
        },
        "node_modules/@types/node": {
-            "version": "25.3.3",
-            "resolved": "https://registry.npmjs.org/@types/node/-/node-25.3.3.tgz",
-            "integrity": "sha512-DpzbrH7wIcBaJibpKo9nnSQL0MTRdnWttGyE5haGwK86xgMOkFLp7vEyfQPGLOJh5wNYiJ3V9PmUMDhV9u8kkQ==",
+            "version": "25.4.0",
+            "resolved": "https://registry.npmjs.org/@types/node/-/node-25.4.0.tgz",
+            "integrity": "sha512-9wLpoeWuBlcbBpOY3XmzSTG3oscB6xjBEEtn+pYXTfhyXhIxC5FsBer2KTopBlvKEiW9l13po9fq+SJY/5lkhw==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
@@ -3818,17 +3831,17 @@
            }
        },
        "node_modules/@typescript-eslint/eslint-plugin": {
-            "version": "8.56.1",
-            "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.56.1.tgz",
-            "integrity": "sha512-Jz9ZztpB37dNC+HU2HI28Bs9QXpzCz+y/twHOwhyrIRdbuVDxSytJNDl6z/aAKlaRIwC7y8wJdkBv7FxYGgi0A==",
+            "version": "8.57.0",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.57.0.tgz",
+            "integrity": "sha512-qeu4rTHR3/IaFORbD16gmjq9+rEs9fGKdX0kF6BKSfi+gCuG3RCKLlSBYzn/bGsY9Tj7KE/DAQStbp8AHJGHEQ==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
                "@eslint-community/regexpp": "^4.12.2",
-                "@typescript-eslint/scope-manager": "8.56.1",
-                "@typescript-eslint/type-utils": "8.56.1",
-                "@typescript-eslint/utils": "8.56.1",
-                "@typescript-eslint/visitor-keys": "8.56.1",
+                "@typescript-eslint/scope-manager": "8.57.0",
+                "@typescript-eslint/type-utils": "8.57.0",
+                "@typescript-eslint/utils": "8.57.0",
+                "@typescript-eslint/visitor-keys": "8.57.0",
                "ignore": "^7.0.5",
                "natural-compare": "^1.4.0",
                "ts-api-utils": "^2.4.0"
@@ -3841,7 +3854,7 @@
                "url": "https://opencollective.com/typescript-eslint"
            },
            "peerDependencies": {
-                "@typescript-eslint/parser": "^8.56.1",
+                "@typescript-eslint/parser": "^8.57.0",
                "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
                "typescript": ">=4.8.4 <6.0.0"
            }
@@ -3857,16 +3870,16 @@
            }
        },
        "node_modules/@typescript-eslint/parser": {
-            "version": "8.56.1",
-            "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.56.1.tgz",
-            "integrity": "sha512-klQbnPAAiGYFyI02+znpBRLyjL4/BrBd0nyWkdC0s/6xFLkXYQ8OoRrSkqacS1ddVxf/LDyODIKbQ5TgKAf/Fg==",
+            "version": "8.57.0",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.57.0.tgz",
+            "integrity": "sha512-XZzOmihLIr8AD1b9hL9ccNMzEMWt/dE2u7NyTY9jJG6YNiNthaD5XtUHVF2uCXZ15ng+z2hT3MVuxnUYhq6k1g==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@typescript-eslint/scope-manager": "8.56.1",
-                "@typescript-eslint/types": "8.56.1",
-                "@typescript-eslint/typescript-estree": "8.56.1",
-                "@typescript-eslint/visitor-keys": "8.56.1",
+                "@typescript-eslint/scope-manager": "8.57.0",
+                "@typescript-eslint/types": "8.57.0",
+                "@typescript-eslint/typescript-estree": "8.57.0",
+                "@typescript-eslint/visitor-keys": "8.57.0",
                "debug": "^4.4.3"
            },
            "engines": {
@@ -3882,14 +3895,14 @@
            }
        },
        "node_modules/@typescript-eslint/project-service": {
-            "version": "8.56.1",
-            "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.56.1.tgz",
-            "integrity": "sha512-TAdqQTzHNNvlVFfR+hu2PDJrURiwKsUvxFn1M0h95BB8ah5jejas08jUWG4dBA68jDMI988IvtfdAI53JzEHOQ==",
+            "version": "8.57.0",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.57.0.tgz",
+            "integrity": "sha512-pR+dK0BlxCLxtWfaKQWtYr7MhKmzqZxuii+ZjuFlZlIGRZm22HnXFqa2eY+90MUz8/i80YJmzFGDUsi8dMOV5w==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@typescript-eslint/tsconfig-utils": "^8.56.1",
-                "@typescript-eslint/types": "^8.56.1",
+                "@typescript-eslint/tsconfig-utils": "^8.57.0",
+                "@typescript-eslint/types": "^8.57.0",
                "debug": "^4.4.3"
            },
            "engines": {
@@ -3904,14 +3917,14 @@
            }
        },
        "node_modules/@typescript-eslint/scope-manager": {
-            "version": "8.56.1",
-            "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.56.1.tgz",
-            "integrity": "sha512-YAi4VDKcIZp0O4tz/haYKhmIDZFEUPOreKbfdAN3SzUDMcPhJ8QI99xQXqX+HoUVq8cs85eRKnD+rne2UAnj2w==",
+            "version": "8.57.0",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.57.0.tgz",
+            "integrity": "sha512-nvExQqAHF01lUM66MskSaZulpPL5pgy5hI5RfrxviLgzZVffB5yYzw27uK/ft8QnKXI2X0LBrHJFr1TaZtAibw==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@typescript-eslint/types": "8.56.1",
-                "@typescript-eslint/visitor-keys": "8.56.1"
+                "@typescript-eslint/types": "8.57.0",
+                "@typescript-eslint/visitor-keys": "8.57.0"
            },
            "engines": {
                "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -3922,9 +3935,9 @@
            }
        },
        "node_modules/@typescript-eslint/tsconfig-utils": {
-            "version": "8.56.1",
-            "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.56.1.tgz",
-            "integrity": "sha512-qOtCYzKEeyr3aR9f28mPJqBty7+DBqsdd63eO0yyDwc6vgThj2UjWfJIcsFeSucYydqcuudMOprZ+x1SpF3ZuQ==",
+            "version": "8.57.0",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.57.0.tgz",
+            "integrity": "sha512-LtXRihc5ytjJIQEH+xqjB0+YgsV4/tW35XKX3GTZHpWtcC8SPkT/d4tqdf1cKtesryHm2bgp6l555NYcT2NLvA==",
            "dev": true,
            "license": "MIT",
            "engines": {
@@ -3939,15 +3952,15 @@
            }
        },
        "node_modules/@typescript-eslint/type-utils": {
-            "version": "8.56.1",
-            "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.56.1.tgz",
-            "integrity": "sha512-yB/7dxi7MgTtGhZdaHCemf7PuwrHMenHjmzgUW1aJpO+bBU43OycnM3Wn+DdvDO/8zzA9HlhaJ0AUGuvri4oGg==",
+            "version": "8.57.0",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.57.0.tgz",
+            "integrity": "sha512-yjgh7gmDcJ1+TcEg8x3uWQmn8ifvSupnPfjP21twPKrDP/pTHlEQgmKcitzF/rzPSmv7QjJ90vRpN4U+zoUjwQ==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@typescript-eslint/types": "8.56.1",
-                "@typescript-eslint/typescript-estree": "8.56.1",
-                "@typescript-eslint/utils": "8.56.1",
+                "@typescript-eslint/types": "8.57.0",
+                "@typescript-eslint/typescript-estree": "8.57.0",
+                "@typescript-eslint/utils": "8.57.0",
                "debug": "^4.4.3",
                "ts-api-utils": "^2.4.0"
            },
@@ -3964,9 +3977,9 @@
            }
        },
        "node_modules/@typescript-eslint/types": {
-            "version": "8.56.1",
-            "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.56.1.tgz",
-            "integrity": "sha512-dbMkdIUkIkchgGDIv7KLUpa0Mda4IYjo4IAMJUZ+3xNoUXxMsk9YtKpTHSChRS85o+H9ftm51gsK1dZReY9CVw==",
+            "version": "8.57.0",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.57.0.tgz",
+            "integrity": "sha512-dTLI8PEXhjUC7B9Kre+u0XznO696BhXcTlOn0/6kf1fHaQW8+VjJAVHJ3eTI14ZapTxdkOmc80HblPQLaEeJdg==",
            "dev": true,
            "license": "MIT",
            "engines": {
@@ -3978,16 +3991,16 @@
            }
        },
        "node_modules/@typescript-eslint/typescript-estree": {
-            "version": "8.56.1",
-            "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.56.1.tgz",
-            "integrity": "sha512-qzUL1qgalIvKWAf9C1HpvBjif+Vm6rcT5wZd4VoMb9+Km3iS3Cv9DY6dMRMDtPnwRAFyAi7YXJpTIEXLvdfPxg==",
+            "version": "8.57.0",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.57.0.tgz",
+            "integrity": "sha512-m7faHcyVg0BT3VdYTlX8GdJEM7COexXxS6KqGopxdtkQRvBanK377QDHr4W/vIPAR+ah9+B/RclSW5ldVniO1Q==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@typescript-eslint/project-service": "8.56.1",
-                "@typescript-eslint/tsconfig-utils": "8.56.1",
-                "@typescript-eslint/types": "8.56.1",
-                "@typescript-eslint/visitor-keys": "8.56.1",
+                "@typescript-eslint/project-service": "8.57.0",
+                "@typescript-eslint/tsconfig-utils": "8.57.0",
+                "@typescript-eslint/types": "8.57.0",
+                "@typescript-eslint/visitor-keys": "8.57.0",
                "debug": "^4.4.3",
                "minimatch": "^10.2.2",
                "semver": "^7.7.3",
@@ -4005,56 +4018,17 @@
                "typescript": ">=4.8.4 <6.0.0"
            }
        },
-        "node_modules/@typescript-eslint/typescript-estree/node_modules/balanced-match": {
-            "version": "4.0.4",
-            "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz",
-            "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": "18 || 20 || >=22"
-            }
-        },
-        "node_modules/@typescript-eslint/typescript-estree/node_modules/brace-expansion": {
-            "version": "5.0.3",
-            "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.3.tgz",
-            "integrity": "sha512-fy6KJm2RawA5RcHkLa1z/ScpBeA762UF9KmZQxwIbDtRJrgLzM10depAiEQ+CXYcoiqW1/m96OAAoke2nE9EeA==",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "balanced-match": "^4.0.2"
-            },
-            "engines": {
-                "node": "18 || 20 || >=22"
-            }
-        },
-        "node_modules/@typescript-eslint/typescript-estree/node_modules/minimatch": {
-            "version": "10.2.2",
-            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.2.tgz",
-            "integrity": "sha512-+G4CpNBxa5MprY+04MbgOw1v7So6n5JY166pFi9KfYwT78fxScCeSNQSNzp6dpPSW2rONOps6Ocam1wFhCgoVw==",
-            "dev": true,
-            "license": "BlueOak-1.0.0",
-            "dependencies": {
-                "brace-expansion": "^5.0.2"
-            },
-            "engines": {
-                "node": "18 || 20 || >=22"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            }
-        },
        "node_modules/@typescript-eslint/utils": {
-            "version": "8.56.1",
-            "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.56.1.tgz",
-            "integrity": "sha512-HPAVNIME3tABJ61siYlHzSWCGtOoeP2RTIaHXFMPqjrQKCGB9OgUVdiNgH7TJS2JNIQ5qQ4RsAUDuGaGme/KOA==",
+            "version": "8.57.0",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.57.0.tgz",
+            "integrity": "sha512-5iIHvpD3CZe06riAsbNxxreP+MuYgVUsV0n4bwLH//VJmgtt54sQeY2GszntJ4BjYCpMzrfVh2SBnUQTtys2lQ==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
                "@eslint-community/eslint-utils": "^4.9.1",
-                "@typescript-eslint/scope-manager": "8.56.1",
-                "@typescript-eslint/types": "8.56.1",
-                "@typescript-eslint/typescript-estree": "8.56.1"
+                "@typescript-eslint/scope-manager": "8.57.0",
+                "@typescript-eslint/types": "8.57.0",
+                "@typescript-eslint/typescript-estree": "8.57.0"
            },
            "engines": {
                "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -4069,13 +4043,13 @@
            }
        },
        "node_modules/@typescript-eslint/visitor-keys": {
-            "version": "8.56.1",
-            "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.56.1.tgz",
-            "integrity": "sha512-KiROIzYdEV85YygXw6BI/Dx4fnBlFQu6Mq4QE4MOH9fFnhohw6wX/OAvDY2/C+ut0I3RSPKenvZJIVYqJNkhEw==",
+            "version": "8.57.0",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.57.0.tgz",
+            "integrity": "sha512-zm6xx8UT/Xy2oSr2ZXD0pZo7Jx2XsCoID2IUh9YSTFRu7z+WdwYTRk6LhUftm1crwqbuoF6I8zAFeCMw0YjwDg==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@typescript-eslint/types": "8.56.1",
+                "@typescript-eslint/types": "8.57.0",
                "eslint-visitor-keys": "^5.0.0"
            },
            "engines": {
@@ -4205,9 +4179,9 @@
            }
        },
        "node_modules/@wxt-dev/module-react": {
-            "version": "1.1.5",
-            "resolved": "https://registry.npmjs.org/@wxt-dev/module-react/-/module-react-1.1.5.tgz",
-            "integrity": "sha512-KgsUrsgH5rBT8MwiipnDEOHBXmLvTIdFICrI7KjngqSf9DpVRn92HsKmToxY0AYpkP19hHWta2oNYFTzmmm++g==",
+            "version": "1.2.1",
+            "resolved": "https://registry.npmjs.org/@wxt-dev/module-react/-/module-react-1.2.1.tgz",
+            "integrity": "sha512-NkXhXP1KqbTmKuQ7LwESFUnQDxQRiHw98ZQ6cXKuulRvyxtyCfc6gOqbKMHPP9bp497UVHaozr3ZQj1lvcPPTQ==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
@@ -4217,6 +4191,7 @@
                "url": "https://github.com/sponsors/wxt-dev"
            },
            "peerDependencies": {
+                "vite": "^5.4.19 || ^6.3.4 || ^7.0.0 || ^8.0.0-0",
                "wxt": ">=0.19.16"
            }
        },
@@ -5249,9 +5224,9 @@
            }
        },
        "node_modules/conventional-changelog-angular": {
-            "version": "8.1.0",
-            "resolved": "https://registry.npmjs.org/conventional-changelog-angular/-/conventional-changelog-angular-8.1.0.tgz",
-            "integrity": "sha512-GGf2Nipn1RUCAktxuVauVr1e3r8QrLP/B0lEUsFktmGqc3ddbQkhoJZHJctVU829U1c6mTSWftrVOCHaL85Q3w==",
+            "version": "8.3.0",
+            "resolved": "https://registry.npmjs.org/conventional-changelog-angular/-/conventional-changelog-angular-8.3.0.tgz",
+            "integrity": "sha512-DOuBwYSqWzfwuRByY9O4oOIvDlkUCTDzfbOgcSbkY+imXXj+4tmrEFao3K+FxemClYfYnZzsvudbwrhje9VHDA==",
            "dev": true,
            "license": "ISC",
            "dependencies": {
@@ -5262,9 +5237,9 @@
            }
        },
        "node_modules/conventional-changelog-conventionalcommits": {
-            "version": "9.1.0",
-            "resolved": "https://registry.npmjs.org/conventional-changelog-conventionalcommits/-/conventional-changelog-conventionalcommits-9.1.0.tgz",
-            "integrity": "sha512-MnbEysR8wWa8dAEvbj5xcBgJKQlX/m0lhS8DsyAAWDHdfs2faDJxTgzRYlRYpXSe7UiKrIIlB4TrBKU9q9DgkA==",
+            "version": "9.3.0",
+            "resolved": "https://registry.npmjs.org/conventional-changelog-conventionalcommits/-/conventional-changelog-conventionalcommits-9.3.0.tgz",
+            "integrity": "sha512-kYFx6gAyjSIMwNtASkI3ZE99U1fuVDJr0yTYgVy+I2QG46zNZfl2her+0+eoviG82c5WQvW1jMt1eOQTeJLodA==",
            "dev": true,
            "license": "ISC",
            "dependencies": {
@@ -5275,12 +5250,13 @@
            }
        },
        "node_modules/conventional-commits-parser": {
-            "version": "6.2.1",
-            "resolved": "https://registry.npmjs.org/conventional-commits-parser/-/conventional-commits-parser-6.2.1.tgz",
-            "integrity": "sha512-20pyHgnO40rvfI0NGF/xiEoFMkXDtkF8FwHvk5BokoFoCuTQRI8vrNCNFWUOfuolKJMm1tPCHc8GgYEtr1XRNA==",
+            "version": "6.3.0",
+            "resolved": "https://registry.npmjs.org/conventional-commits-parser/-/conventional-commits-parser-6.3.0.tgz",
+            "integrity": "sha512-RfOq/Cqy9xV9bOA8N+ZH6DlrDR+5S3Mi0B5kACEjESpE+AviIpAptx9a9cFpWCCvgRtWT+0BbUw+e1BZfts9jg==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
+                "@simple-libs/stream-utils": "^1.2.0",
                "meow": "^13.0.0"
            },
            "bin": {
@@ -5305,9 +5281,9 @@
            "license": "MIT"
        },
        "node_modules/cosmiconfig": {
-            "version": "9.0.0",
-            "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-9.0.0.tgz",
-            "integrity": "sha512-itvL5h8RETACmOTFc4UfIyB2RfEHi71Ax6E/PivVxq9NseKbOWpeyHEOIbmAw1rs8Ak0VursQNww7lf7YtUwzg==",
+            "version": "9.0.1",
+            "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-9.0.1.tgz",
+            "integrity": "sha512-hr4ihw+DBqcvrsEDioRO31Z17x71pUYoNe/4h6Z0wB72p7MU7/9gH8Q3s12NFhHPfYBBOV3qyfUxmr/Yn3shnQ==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
@@ -6402,13 +6378,13 @@
            }
        },
        "node_modules/framer-motion": {
-            "version": "12.34.5",
-            "resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.34.5.tgz",
-            "integrity": "sha512-Z2dQ+o7BsfpJI3+u0SQUNCrN+ajCKJen1blC4rCHx1Ta2EOHs+xKJegLT2aaD9iSMbU3OoX+WabQXkloUbZmJQ==",
+            "version": "12.35.2",
+            "resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.35.2.tgz",
+            "integrity": "sha512-dhfuEMaNo0hc+AEqyHiIfiJRNb9U9UQutE9FoKm5pjf7CMitp9xPEF1iWZihR1q86LBmo6EJ7S8cN8QXEy49AA==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "motion-dom": "^12.34.5",
+                "motion-dom": "^12.35.2",
                "motion-utils": "^12.29.2",
                "tslib": "^2.4.0"
            },
@@ -6590,6 +6566,7 @@
            "version": "4.0.0",
            "resolved": "https://registry.npmjs.org/git-raw-commits/-/git-raw-commits-4.0.0.tgz",
            "integrity": "sha512-ICsMM1Wk8xSGMowkOmPrzo2Fgmfo4bMHLNX6ytHjajRJUqvHOw/TFapQ+QG75c3X/tTDDhOSRPGC52dDbNM8FQ==",
+            "deprecated": "This package is no longer maintained. For the JavaScript API, please use @conventional-changelog/git-client instead.",
            "dev": true,
            "license": "MIT",
            "dependencies": {
@@ -7741,9 +7718,9 @@
            }
        },
        "node_modules/lint-staged": {
-            "version": "16.3.1",
-            "resolved": "https://registry.npmjs.org/lint-staged/-/lint-staged-16.3.1.tgz",
-            "integrity": "sha512-bqvvquXzFBAlSbluugR4KXAe4XnO/QZcKVszpkBtqLWa2KEiVy8n6Xp38OeUbv/gOJOX4Vo9u5pFt/ADvbm42Q==",
+            "version": "16.3.2",
+            "resolved": "https://registry.npmjs.org/lint-staged/-/lint-staged-16.3.2.tgz",
+            "integrity": "sha512-xKqhC2AeXLwiAHXguxBjuChoTTWFC6Pees0SHPwOpwlvI3BH7ZADFPddAdN3pgo3aiKgPUx/bxE78JfUnxQnlg==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
@@ -7927,9 +7904,9 @@
            }
        },
        "node_modules/lucide-react": {
-            "version": "0.576.0",
-            "resolved": "https://registry.npmjs.org/lucide-react/-/lucide-react-0.576.0.tgz",
-            "integrity": "sha512-koNxU14BXrxUfZQ9cUaP0ES1uyPZKYDjk31FQZB6dQ/x+tXk979sVAn9ppZ/pVeJJyOxVM8j1E+8QEuSc02Vug==",
+            "version": "0.577.0",
+            "resolved": "https://registry.npmjs.org/lucide-react/-/lucide-react-0.577.0.tgz",
+            "integrity": "sha512-4LjoFv2eEPwYDPg/CUdBJQSDfPyzXCRrVW1X7jrx/trgxnxkHFjnVZINbzvzxjN70dxychOfg+FTYwBiS3pQ5A==",
            "dev": true,
            "license": "ISC",
            "peerDependencies": {
@@ -8033,16 +8010,16 @@
            }
        },
        "node_modules/minimatch": {
-            "version": "10.2.1",
-            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.1.tgz",
-            "integrity": "sha512-MClCe8IL5nRRmawL6ib/eT4oLyeKMGCghibcDWK+J0hh0Q8kqSdia6BvbRMVk6mPa6WqUa5uR2oxt6C5jd533A==",
+            "version": "10.2.3",
+            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.3.tgz",
+            "integrity": "sha512-Rwi3pnapEqirPSbWbrZaa6N3nmqq4Xer/2XooiOKyV3q12ML06f7MOuc5DVH8ONZIFhwIYQ3yzPH4nt7iWHaTg==",
            "dev": true,
            "license": "BlueOak-1.0.0",
            "dependencies": {
                "brace-expansion": "^5.0.2"
            },
            "engines": {
-                "node": "20 || >=22"
+                "node": "18 || 20 || >=22"
            },
            "funding": {
                "url": "https://github.com/sponsors/isaacs"
@@ -8121,13 +8098,13 @@
            }
        },
        "node_modules/motion": {
-            "version": "12.34.5",
-            "resolved": "https://registry.npmjs.org/motion/-/motion-12.34.5.tgz",
-            "integrity": "sha512-N06NLJ9IeBHeielRqIvYvjPfXuRdyTxa+9++BgpGa+hY2D7TcMkI6QzV3jaRuv0aZRXgMa7cPy9YcBUBisPzAQ==",
+            "version": "12.35.2",
+            "resolved": "https://registry.npmjs.org/motion/-/motion-12.35.2.tgz",
+            "integrity": "sha512-8zCi1DkNyU6a/tgEHn/GnnXZDcaMpDHbDOGORY1Rg/6lcNMSOuvwDB3i4hMSOvxqMWArc/vrGaw/Xek1OP69/A==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "framer-motion": "^12.34.5",
+                "framer-motion": "^12.35.2",
                "tslib": "^2.4.0"
            },
            "peerDependencies": {
@@ -8148,9 +8125,9 @@
            }
        },
        "node_modules/motion-dom": {
-            "version": "12.34.5",
-            "resolved": "https://registry.npmjs.org/motion-dom/-/motion-dom-12.34.5.tgz",
-            "integrity": "sha512-k33CsnxO2K3gBRMUZT+vPmc4Utlb5menKdG0RyVNLtlqRaaJPRWlE9fXl8NTtfZ5z3G8TDvqSu0MENLqSTaHZA==",
+            "version": "12.35.2",
+            "resolved": "https://registry.npmjs.org/motion-dom/-/motion-dom-12.35.2.tgz",
+            "integrity": "sha512-pWXFMTwvGDbx1Fe9YL5HZebv2NhvGBzRtiNUv58aoK7+XrsuaydQ0JGRKK2r+bTKlwgSWwWxHbP5249Qr/BNpg==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
@@ -9512,9 +9489,9 @@
            }
        },
        "node_modules/simple-icons": {
-            "version": "16.10.0",
-            "resolved": "https://registry.npmjs.org/simple-icons/-/simple-icons-16.10.0.tgz",
-            "integrity": "sha512-62kuxaG3pE+cFNerudUtwb9BLmudzayHrlHkvU9gf8Nxcj7VYOm9dh3WNbGaFk60aQtfnRyzViZaouFG2B45kg==",
+            "version": "16.11.0",
+            "resolved": "https://registry.npmjs.org/simple-icons/-/simple-icons-16.11.0.tgz",
+            "integrity": "sha512-6vqbcdaT6PsgUXud9rrP9w+nrmRzzStMEvyDavMeGwDgZSYM4uJ3tH7zurgTLHJO0RnMqU3Q09Vgo7WdTXV1eA==",
            "dev": true,
            "funding": [
                {
@@ -10075,16 +10052,16 @@
            }
        },
        "node_modules/typescript-eslint": {
-            "version": "8.56.1",
-            "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.56.1.tgz",
-            "integrity": "sha512-U4lM6pjmBX7J5wk4szltF7I1cGBHXZopnAXCMXb3+fZ3B/0Z3hq3wS/CCUB2NZBNAExK92mCU2tEohWuwVMsDQ==",
+            "version": "8.57.0",
+            "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.57.0.tgz",
+            "integrity": "sha512-W8GcigEMEeB07xEZol8oJ26rigm3+bfPHxHvwbYUlu1fUDsGuQ7Hiskx5xGW/xM4USc9Ephe3jtv7ZYPQntHeA==",
            "dev": true,
            "license": "MIT",
            "dependencies": {
-                "@typescript-eslint/eslint-plugin": "8.56.1",
-                "@typescript-eslint/parser": "8.56.1",
-                "@typescript-eslint/typescript-estree": "8.56.1",
-                "@typescript-eslint/utils": "8.56.1"
+                "@typescript-eslint/eslint-plugin": "8.57.0",
+                "@typescript-eslint/parser": "8.57.0",
+                "@typescript-eslint/typescript-estree": "8.57.0",
+                "@typescript-eslint/utils": "8.57.0"
            },
            "engines": {
                "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -11113,11 +11090,11 @@
        },
        "packages/core": {
            "name": "@page-agent/core",
-            "version": "1.5.1",
+            "version": "1.5.5",
            "license": "MIT",
            "dependencies": {
-                "@page-agent/llms": "1.5.1",
-                "@page-agent/page-controller": "1.5.1",
+                "@page-agent/llms": "1.5.5",
+                "@page-agent/page-controller": "1.5.5",
                "chalk": "^5.6.2"
            },
            "devDependencies": {
@@ -11129,13 +11106,13 @@
        },
        "packages/extension": {
            "name": "@page-agent/ext",
-            "version": "0.1.8",
+            "version": "0.1.16",
            "hasInstallScript": true,
            "dependencies": {
-                "@page-agent/core": "1.5.1",
-                "@page-agent/llms": "1.5.1",
-                "@page-agent/page-controller": "1.5.1",
-                "@page-agent/ui": "1.5.1",
+                "@page-agent/core": "1.5.5",
+                "@page-agent/llms": "1.5.5",
+                "@page-agent/page-controller": "1.5.5",
+                "@page-agent/ui": "1.5.5",
                "ai-motion": "^0.4.8",
                "chalk": "^5.6.2"
            },
@@ -11150,17 +11127,17 @@
                "@types/chrome": "^0.1.37",
                "@types/react": "^19.2.14",
                "@types/react-dom": "^19.2.1",
-                "@wxt-dev/module-react": "^1.1.5",
+                "@wxt-dev/module-react": "^1.2.1",
                "class-variance-authority": "^0.7.1",
                "clsx": "^2.1.1",
                "idb": "^8.0.3",
-                "lucide-react": "^0.576.0",
-                "motion": "^12.34.5",
+                "lucide-react": "^0.577.0",
+                "motion": "^12.35.2",
                "next-themes": "^0.4.6",
                "react": "^19.2.4",
                "react-dom": "^19.2.4",
                "rough-notation": "^0.5.1",
-                "simple-icons": "^16.10.0",
+                "simple-icons": "^16.11.0",
                "sonner": "^2.0.7",
                "tailwind-merge": "^3.5.0",
                "tailwindcss": "^4.1.14",
@@ -11173,7 +11150,7 @@
        },
        "packages/llms": {
            "name": "@page-agent/llms",
-            "version": "1.5.1",
+            "version": "1.5.5",
            "license": "MIT",
            "dependencies": {
                "chalk": "^5.6.2"
@@ -11186,13 +11163,13 @@
            }
        },
        "packages/page-agent": {
-            "version": "1.5.1",
+            "version": "1.5.5",
            "license": "MIT",
            "dependencies": {
-                "@page-agent/core": "1.5.1",
-                "@page-agent/llms": "1.5.1",
-                "@page-agent/page-controller": "1.5.1",
-                "@page-agent/ui": "1.5.1",
+                "@page-agent/core": "1.5.5",
+                "@page-agent/llms": "1.5.5",
+                "@page-agent/page-controller": "1.5.5",
+                "@page-agent/ui": "1.5.5",
                "chalk": "^5.6.2"
            },
            "devDependencies": {
@@ -11204,7 +11181,7 @@
        },
        "packages/page-controller": {
            "name": "@page-agent/page-controller",
-            "version": "1.5.1",
+            "version": "1.5.5",
            "license": "MIT",
            "dependencies": {
                "ai-motion": "^0.4.8"
@@ -11212,12 +11189,12 @@
        },
        "packages/ui": {
            "name": "@page-agent/ui",
-            "version": "1.5.1",
+            "version": "1.5.5",
            "license": "MIT"
        },
        "packages/website": {
            "name": "@page-agent/website",
-            "version": "1.5.1",
+            "version": "1.5.5",
            "devDependencies": {
                "@radix-ui/react-icons": "^1.3.2",
                "@radix-ui/react-separator": "^1.1.8",
@@ -11228,13 +11205,13 @@
                "@types/react-dom": "^19.2.1",
                "class-variance-authority": "^0.7.1",
                "clsx": "^2.1.1",
-                "lucide-react": "^0.576.0",
-                "motion": "^12.34.5",
+                "lucide-react": "^0.577.0",
+                "motion": "^12.35.2",
                "next-themes": "^0.4.6",
                "react": "^19.2.4",
                "react-dom": "^19.2.4",
                "rough-notation": "^0.5.1",
-                "simple-icons": "^16.10.0",
+                "simple-icons": "^16.11.0",
                "sonner": "^2.0.7",
                "tailwind-merge": "^3.5.0",
                "tailwindcss": "^4.1.14",
@@ -1,7 +1,7 @@
 {
    "name": "root",
    "private": true,
-    "version": "1.5.1",
+    "version": "1.5.5",
    "type": "module",
    "workspaces": [
        "packages/page-controller",
@@ -24,24 +24,27 @@
        "node": "^20.19.0 || ^22.13.0 || >=24"
    },
    "scripts": {
-        "cleanup": "rm -rf packages/*/dist",
        "start": "npm run dev --workspace=@page-agent/website",
-        "build:website": "npm run build:website --workspace=@page-agent/website",
-        "build:libs": "npm run build --workspaces --if-present",
-        "build": "npm run build:libs && npm run build:website",
+        "dev:ext": "npm run dev -w @page-agent/ext",
        "dev:demo": "npm run dev:demo --workspace=page-agent",
+        "build": "npm run build:libs && npm run build:website",
+        "build:libs": "npm run build --workspaces --if-present",
+        "build:website": "npm run build:website --workspace=@page-agent/website",
+        "build:ext": "npm run build:libs && npm run zip -w @page-agent/ext",
        "version": "node scripts/sync-version.js",
+        "version:ext": "node scripts/ext-version.js",
        "lint": "eslint .",
+        "cleanup": "rm -rf packages/*/dist",
        "prepare": "husky"
    },
    "devDependencies": {
-        "@commitlint/cli": "^20.4.2",
-        "@commitlint/config-conventional": "^20.4.2",
+        "@commitlint/cli": "^20.4.3",
+        "@commitlint/config-conventional": "^20.4.3",
        "@eslint/js": "^9.39.2",
-        "@microsoft/api-extractor": "^7.57.6",
+        "@microsoft/api-extractor": "^7.57.7",
        "@tailwindcss/vite": "^4.2.1",
        "@trivago/prettier-plugin-sort-imports": "^6.0.2",
-        "@types/node": "^25.3.3",
+        "@types/node": "^25.4.0",
        "@vitejs/plugin-react-swc": "^4.1.0",
        "chalk": "^5.6.2",
        "concurrently": "^9.2.1",
@@ -54,10 +57,10 @@
        "eslint-plugin-react-x": "^2.13.0",
        "globals": "^17.4.0",
        "husky": "^9.1.7",
-        "lint-staged": "^16.3.1",
+        "lint-staged": "^16.3.2",
        "prettier": "^3.8.0",
        "typescript": "^5.9.3",
-        "typescript-eslint": "^8.56.1",
+        "typescript-eslint": "^8.57.0",
        "unplugin-dts": "^1.0.0-beta.6",
        "vite": "^7.3.1",
        "vite-plugin-css-injected-by-js": "^4.0.1",
@@ -1,7 +1,7 @@
 {
    "name": "@page-agent/core",
    "private": false,
-    "version": "1.5.1",
+    "version": "1.5.5",
    "type": "module",
    "main": "./dist/esm/page-agent-core.js",
    "module": "./dist/esm/page-agent-core.js",
@@ -44,8 +44,8 @@
    },
    "dependencies": {
        "chalk": "^5.6.2",
-        "@page-agent/llms": "1.5.1",
-        "@page-agent/page-controller": "1.5.1"
+        "@page-agent/llms": "1.5.5",
+        "@page-agent/page-controller": "1.5.5"
    },
    "peerDependencies": {
        "zod": "^3.25.0 || ^4.0.0"
@@ -96,7 +96,7 @@ export class PageAgentCore extends EventTarget {
 	constructor(config: PageAgentCoreConfig) {
 		super()

-		this.config = { ...config, maxSteps: config.maxSteps || 40 }
+		this.config = { ...config, maxSteps: config.maxSteps ?? 40 }

 		this.#llm = new LLM(this.config)
 		this.tools = new Map(tools)
@@ -1,7 +1,7 @@
 {
    "name": "@page-agent/ext",
    "private": true,
-    "version": "0.1.8",
+    "version": "0.1.16",
    "type": "module",
    "scripts": {
        "dev": "wxt",
@@ -20,17 +20,17 @@
        "@types/chrome": "^0.1.37",
        "@types/react": "^19.2.14",
        "@types/react-dom": "^19.2.1",
-        "@wxt-dev/module-react": "^1.1.5",
+        "@wxt-dev/module-react": "^1.2.1",
        "class-variance-authority": "^0.7.1",
        "clsx": "^2.1.1",
        "idb": "^8.0.3",
-        "lucide-react": "^0.576.0",
-        "motion": "^12.34.5",
+        "lucide-react": "^0.577.0",
+        "motion": "^12.35.2",
        "next-themes": "^0.4.6",
        "react": "^19.2.4",
        "react-dom": "^19.2.4",
        "rough-notation": "^0.5.1",
-        "simple-icons": "^16.10.0",
+        "simple-icons": "^16.11.0",
        "sonner": "^2.0.7",
        "tailwind-merge": "^3.5.0",
        "tailwindcss": "^4.1.14",
@@ -38,10 +38,10 @@
        "wxt": "^0.20.18"
    },
    "dependencies": {
-        "@page-agent/core": "1.5.1",
-        "@page-agent/llms": "1.5.1",
-        "@page-agent/page-controller": "1.5.1",
-        "@page-agent/ui": "1.5.1",
+        "@page-agent/core": "1.5.5",
+        "@page-agent/llms": "1.5.5",
+        "@page-agent/page-controller": "1.5.5",
+        "@page-agent/ui": "1.5.5",
        "ai-motion": "^0.4.8",
        "chalk": "^5.6.2"
    },
@@ -1,4 +1,4 @@
-import { type PageAgentConfig, PageAgentCore } from '@page-agent/core'
+import { type AgentConfig, PageAgentCore } from '@page-agent/core'

 import { RemotePageController } from './RemotePageController'
 import { TabsController } from './TabsController'
@@ -17,7 +17,7 @@ function detectLanguage(): 'en-US' | 'zh-CN' {
 * - can be used from a side panel or a content script
 */
 export class MultiPageAgent extends PageAgentCore {
-	constructor(config: Omit<PageAgentConfig, 'pageController'> & { includeInitialTab?: boolean }) {
+	constructor(config: AgentConfig & { includeInitialTab?: boolean }) {
 		// multi page controller
 		const tabsController = new TabsController()
 		const pageController = new RemotePageController(tabsController)
@@ -16,7 +16,13 @@ import { DEMO_CONFIG, migrateLegacyEndpoint } from './constants'
 /** Language preference: undefined means follow system */
 export type LanguagePreference = SupportedLanguage | undefined

-export interface ExtConfig extends LLMConfig {
+export interface AdvancedConfig {
+	maxSteps?: number
+	systemInstruction?: string
+	experimentalLlmsTxt?: boolean
+}
+
+export interface ExtConfig extends LLMConfig, AdvancedConfig {
 	language?: LanguagePreference
 }

@@ -40,9 +46,10 @@ export function useAgent(): UseAgentResult {
 	const [config, setConfig] = useState<ExtConfig | null>(null)

 	useEffect(() => {
-		chrome.storage.local.get(['llmConfig', 'language']).then((result) => {
+		chrome.storage.local.get(['llmConfig', 'language', 'advancedConfig']).then((result) => {
 			let llmConfig = (result.llmConfig as LLMConfig) ?? DEMO_CONFIG
 			const language = (result.language as SupportedLanguage) || undefined
+			const advancedConfig = (result.advancedConfig as AdvancedConfig) ?? {}

 			// Auto-migrate legacy testing endpoints
 			const migrated = migrateLegacyEndpoint(llmConfig)
@@ -53,14 +60,18 @@ export function useAgent(): UseAgentResult {
 				chrome.storage.local.set({ llmConfig: DEMO_CONFIG })
 			}

-			setConfig({ ...llmConfig, language })
+			setConfig({ ...llmConfig, ...advancedConfig, language })
 		})
 	}, [])

 	useEffect(() => {
 		if (!config) return

-		const agent = new MultiPageAgent(config)
+		const { systemInstruction, ...agentConfig } = config
+		const agent = new MultiPageAgent({
+			...agentConfig,
+			instructions: systemInstruction ? { system: systemInstruction } : undefined,
+		})
 		agentRef.current = agent

 		const handleStatusChange = (e: Event) => {
@@ -106,15 +117,26 @@ export function useAgent(): UseAgentResult {
 		agentRef.current?.stop()
 	}, [])

-	const configure = useCallback(async ({ language, ...llmConfig }: ExtConfig) => {
-		await chrome.storage.local.set({ llmConfig })
-		if (language) {
-			await chrome.storage.local.set({ language })
-		} else {
-			await chrome.storage.local.remove('language')
-		}
-		setConfig({ ...llmConfig, language })
-	}, [])
+	const configure = useCallback(
+		async ({
+			language,
+			maxSteps,
+			systemInstruction,
+			experimentalLlmsTxt,
+			...llmConfig
+		}: ExtConfig) => {
+			await chrome.storage.local.set({ llmConfig })
+			if (language) {
+				await chrome.storage.local.set({ language })
+			} else {
+				await chrome.storage.local.remove('language')
+			}
+			const advancedConfig: AdvancedConfig = { maxSteps, systemInstruction, experimentalLlmsTxt }
+			await chrome.storage.local.set({ advancedConfig })
+			setConfig({ ...llmConfig, ...advancedConfig, language })
+		},
+		[]
+	)

 	return {
 		status,
@@ -1,4 +1,14 @@
-import { Copy, CornerUpLeft, Eye, EyeOff, HatGlasses, Home, Loader2, Scale } from 'lucide-react'
+import {
+	ChevronDown,
+	Copy,
+	CornerUpLeft,
+	Eye,
+	EyeOff,
+	HatGlasses,
+	Home,
+	Loader2,
+	Scale,
+} from 'lucide-react'
 import { useEffect, useState } from 'react'
 import { siGithub } from 'simple-icons'

@@ -6,6 +16,7 @@ import { DEMO_API_KEY, DEMO_BASE_URL, DEMO_MODEL, isTestingEndpoint } from '@/ag
 import type { ExtConfig, LanguagePreference } from '@/agent/useAgent'
 import { Button } from '@/components/ui/button'
 import { Input } from '@/components/ui/input'
+import { Switch } from '@/components/ui/switch'

 interface ConfigPanelProps {
 	config: ExtConfig | null
@@ -18,18 +29,26 @@ export function ConfigPanel({ config, onSave, onClose }: ConfigPanelProps) {
 	const [baseURL, setBaseURL] = useState(config?.baseURL || DEMO_BASE_URL)
 	const [model, setModel] = useState(config?.model || DEMO_MODEL)
 	const [language, setLanguage] = useState<LanguagePreference>(config?.language)
+	const [maxSteps, setMaxSteps] = useState<number | undefined>(config?.maxSteps)
+	const [systemInstruction, setSystemInstruction] = useState(config?.systemInstruction ?? '')
+	const [experimentalLlmsTxt, setExperimentalLlmsTxt] = useState(
+		config?.experimentalLlmsTxt ?? false
+	)
+	const [advancedOpen, setAdvancedOpen] = useState(false)
 	const [saving, setSaving] = useState(false)
 	const [userAuthToken, setUserAuthToken] = useState<string>('')
 	const [copied, setCopied] = useState(false)
 	const [showToken, setShowToken] = useState(false)
 	const [showApiKey, setShowApiKey] = useState(false)

-	// Update local state when config prop changes
 	useEffect(() => {
 		setApiKey(config?.apiKey || DEMO_API_KEY)
 		setBaseURL(config?.baseURL || DEMO_BASE_URL)
 		setModel(config?.model || DEMO_MODEL)
 		setLanguage(config?.language)
+		setMaxSteps(config?.maxSteps)
+		setSystemInstruction(config?.systemInstruction ?? '')
+		setExperimentalLlmsTxt(config?.experimentalLlmsTxt ?? false)
 	}, [config])

 	// Poll for user auth token every second until found
@@ -67,7 +86,15 @@ export function ConfigPanel({ config, onSave, onClose }: ConfigPanelProps) {
 	const handleSave = async () => {
 		setSaving(true)
 		try {
-			await onSave({ apiKey, baseURL, model, language })
+			await onSave({
+				apiKey,
+				baseURL,
+				model,
+				language,
+				maxSteps: maxSteps || undefined,
+				systemInstruction: systemInstruction || undefined,
+				experimentalLlmsTxt,
+			})
 		} finally {
 			setSaving(false)
 		}
@@ -87,28 +114,11 @@ export function ConfigPanel({ config, onSave, onClose }: ConfigPanelProps) {
 				</Button>
 			</div>

-			{/* Testing API notice */}
-			{isTestingEndpoint(baseURL) && (
-				<div className="p-2.5 rounded-md border border-amber-500/30 bg-amber-500/5 text-[10px] text-muted-foreground leading-relaxed">
-					<Scale className="size-3 inline-block mr-1 -mt-0.5 text-amber-600" />
-					You are using the free testing API. By using this service you agree to the{' '}
-					<a
-						href="https://github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md"
-						target="_blank"
-						rel="noopener noreferrer"
-						className="underline hover:text-foreground"
-					>
-						Terms of Use & Privacy Policy
-					</a>
-					. No sensitive data. No guaranteed availability.
-				</div>
-			)}
-
 			{/* User Auth Token Section */}
 			<div className="flex flex-col gap-1.5 p-3 bg-muted/50 rounded-md border">
 				<label className="text-xs font-medium text-muted-foreground">User Auth Token</label>
 				<p className="text-[10px] text-muted-foreground mb-1">
-					Add this token to a website's localStorage to give it authorization to call this extension
+					Give a website the ability to call this extension.
 				</p>
 				<div className="flex gap-2 items-center">
 					<Input
@@ -153,6 +163,23 @@ export function ConfigPanel({ config, onSave, onClose }: ConfigPanelProps) {
 				/>
 			</div>

+			{/* Testing API notice */}
+			{isTestingEndpoint(baseURL) && (
+				<div className="p-2.5 rounded-md border border-amber-500/30 bg-amber-500/5 text-[11px] text-muted-foreground leading-relaxed">
+					<Scale className="size-3 inline-block mr-1 -mt-0.5 text-amber-600" />
+					You are using the free testing API. By using this service you agree to the{' '}
+					<a
+						href="https://github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md"
+						target="_blank"
+						rel="noopener noreferrer"
+						className="underline hover:text-foreground"
+					>
+						Terms of Use & Privacy Policy
+					</a>
+					. No sensitive data. No guaranteed availability.
+				</div>
+			)}
+
 			<div className="flex flex-col gap-1.5">
 				<label className="text-xs text-muted-foreground">Model</label>
 				<Input
@@ -197,6 +224,52 @@ export function ConfigPanel({ config, onSave, onClose }: ConfigPanelProps) {
 				</select>
 			</div>

+			{/* Advanced Config */}
+			<button
+				type="button"
+				onClick={() => setAdvancedOpen(!advancedOpen)}
+				className="flex items-center gap-1 text-xs text-muted-foreground hover:text-foreground cursor-pointer mt-1 font-bold"
+			>
+				Advanced
+				<ChevronDown
+					className="size-3 transition-transform"
+					style={{ transform: advancedOpen ? 'rotate(0deg)' : 'rotate(90deg)' }}
+				/>
+			</button>
+
+			{advancedOpen && (
+				<>
+					<div className="flex flex-col gap-1.5">
+						<label className="text-xs text-muted-foreground">Max Steps</label>
+						<Input
+							type="number"
+							placeholder="40"
+							min={1}
+							max={200}
+							value={maxSteps ?? ''}
+							onChange={(e) => setMaxSteps(e.target.value ? Number(e.target.value) : undefined)}
+							className="text-xs h-8 [&::-webkit-inner-spin-button]:appearance-none [&::-webkit-outer-spin-button]:appearance-none [-moz-appearance:textfield]"
+						/>
+					</div>
+
+					<div className="flex flex-col gap-1.5">
+						<label className="text-xs text-muted-foreground">System Instruction</label>
+						<textarea
+							placeholder="Additional instructions for the agent..."
+							value={systemInstruction}
+							onChange={(e) => setSystemInstruction(e.target.value)}
+							rows={3}
+							className="text-xs rounded-md border border-input bg-background px-3 py-2 resize-y min-h-[60px]"
+						/>
+					</div>
+
+					<label className="flex items-center justify-between cursor-pointer">
+						<span className="text-xs text-muted-foreground">Experimental llms.txt support</span>
+						<Switch checked={experimentalLlmsTxt} onCheckedChange={setExperimentalLlmsTxt} />
+					</label>
+				</>
+			)}
+
 			<div className="flex gap-2 mt-2">
 				<Button variant="outline" onClick={onClose} className="flex-1 h-8 text-xs cursor-pointer">
 					Cancel
@@ -1,4 +1,4 @@
-import { AlertTriangle, RotateCcw } from 'lucide-react'
+import { AlertTriangle, Eraser, RotateCcw } from 'lucide-react'
 import { Component, type ErrorInfo, type ReactNode } from 'react'

 import { Button } from '@/components/ui/button'
@@ -27,6 +27,11 @@ export class ErrorBoundary extends Component<Props, State> {
 		window.location.reload()
 	}

+	handleResetConfig = async () => {
+		await chrome.storage.local.remove(['llmConfig', 'language', 'advancedConfig'])
+		window.location.reload()
+	}
+
 	render() {
 		if (!this.state.hasError) {
 			return this.props.children
@@ -39,10 +44,16 @@ export class ErrorBoundary extends Component<Props, State> {
 				<p className="text-sm text-muted-foreground mb-4 max-w-xs">
 					{this.state.error?.message || 'An unexpected error occurred'}
 				</p>
-				<Button variant="outline" size="sm" onClick={this.handleReload}>
-					<RotateCcw className="size-3.5 mr-2" />
-					Reload Panel
-				</Button>
+				<div className="flex gap-2">
+					<Button variant="outline" size="sm" onClick={this.handleResetConfig}>
+						<Eraser className="size-3.5 mr-2" />
+						Reset Config
+					</Button>
+					<Button variant="outline" size="sm" onClick={this.handleReload}>
+						<RotateCcw className="size-3.5 mr-2" />
+						Reload Panel
+					</Button>
+				</div>
 			</div>
 		)
 	}
@@ -43,20 +43,24 @@ export function MotionOverlay({ active }: { active: boolean }) {
 	const motionRef = useRef<Motion | null>(null)

 	useEffect(() => {
-		const mode = document.documentElement.classList.contains('dark') ? 'dark' : 'light'
-		const motion = new Motion({
-			mode,
-			borderWidth: 4,
-			borderRadius: 14,
-			glowWidth: mode === 'dark' ? 120 : 60,
-			styles: { position: 'absolute', inset: '0' },
-		})
-		motionRef.current = motion
-		containerRef.current!.appendChild(motion.element)
-		motion.autoResize(containerRef.current!)
+		try {
+			const mode = document.documentElement.classList.contains('dark') ? 'dark' : 'light'
+			const motion = new Motion({
+				mode,
+				borderWidth: 4,
+				borderRadius: 14,
+				glowWidth: mode === 'dark' ? 120 : 60,
+				styles: { position: 'absolute', inset: '0' },
+			})
+			motionRef.current = motion
+			containerRef.current!.appendChild(motion.element)
+			motion.autoResize(containerRef.current!)
+		} catch (e) {
+			console.warn('[MotionOverlay] Motion unavailable:', e)
+		}

 		return () => {
-			motion.dispose()
+			motionRef.current?.dispose()
 			motionRef.current = null
 		}
 	}, [])
@@ -37,6 +37,9 @@ export default defineConfig({
 			},
 		},
 	}),
+	zip: {
+		artifactTemplate: 'page-agent-ext-{{version}}-{{browser}}.zip',
+	},
 	manifest: {
 		default_locale: 'en',
 		name: '__MSG_extName__',
@@ -1,6 +1,6 @@
 {
    "name": "@page-agent/llms",
-    "version": "1.5.1",
+    "version": "1.5.5",
    "type": "module",
    "main": "./dist/lib/page-agent-llms.js",
    "module": "./dist/lib/page-agent-llms.js",
@@ -73,6 +73,11 @@ export function modelPatch(body: Record<string, any>) {
 		} else if (modelName.startsWith('gpt-51')) {
 			debug('Applying GPT-51 patch: disable reasoning')
 			body.reasoning_effort = 'none'
+		} else if (modelName.startsWith('gpt-54')) {
+			debug(
+				'Applying GPT-5.4 patch: skip reasoning_effort because chat/completions rejects it with function tools'
+			)
+			delete body.reasoning_effort
 		} else if (modelName.startsWith('gpt-5-mini')) {
 			debug('Applying GPT-5-mini patch: set reasoning effort to low, temperature to 1')
 			body.reasoning_effort = 'low'
@@ -1,7 +1,7 @@
 {
    "name": "page-agent",
    "private": false,
-    "version": "1.5.1",
+    "version": "1.5.5",
    "type": "module",
    "main": "./dist/esm/page-agent.js",
    "module": "./dist/esm/page-agent.js",
@@ -44,10 +44,10 @@
        "postpublish": "node -e \"['README.md','LICENSE'].forEach(f=>{try{require('fs').unlinkSync(f)}catch{}})\""
    },
    "dependencies": {
-        "@page-agent/core": "1.5.1",
-        "@page-agent/llms": "1.5.1",
-        "@page-agent/page-controller": "1.5.1",
-        "@page-agent/ui": "1.5.1",
+        "@page-agent/core": "1.5.5",
+        "@page-agent/llms": "1.5.5",
+        "@page-agent/page-controller": "1.5.5",
+        "@page-agent/ui": "1.5.5",
        "chalk": "^5.6.2"
    },
    "peerDependencies": {
@@ -1,6 +1,6 @@
 {
    "name": "@page-agent/page-controller",
-    "version": "1.5.1",
+    "version": "1.5.5",
    "type": "module",
    "main": "./dist/lib/page-controller.js",
    "module": "./dist/lib/page-controller.js",
@@ -14,7 +14,6 @@ import {
 	scrollVertically,
 	selectOptionElement,
 } from './actions'
-import { VIEWPORT_EXPANSION } from './constants'
 import * as dom from './dom'
 import type { FlatDomTree, InteractiveElementDomNode } from './dom/dom_tree/type'
 import { getPageInfo } from './dom/getPageInfo'
@@ -24,7 +23,6 @@ import { patchReact } from './patches/react'
 * Configuration for PageController
 */
 export interface PageControllerConfig extends dom.DomConfig {
-	viewportExpansion?: number
 	/** Enable visual mask overlay during operations (default: false) */
 	enableMask?: boolean
 }
@@ -131,7 +129,7 @@ export class PageController extends EventTarget {
 		const url = window.location.href
 		const title = document.title
 		const pi = getPageInfo()
-		const viewportExpansion = this.config.viewportExpansion ?? VIEWPORT_EXPANSION
+		const viewportExpansion = dom.resolveViewportExpansion(this.config.viewportExpansion)

 		await this.updateTree()

@@ -101,41 +101,93 @@ const nativeTextAreaValueSetter = Object.getOwnPropertyDescriptor(
 	'value'
 )!.set!

-/**
- * create a synthetic keyboard event
- * with key keycode code
- */
-export async function createSyntheticInputEvent(elem: HTMLElement, key: string) {
-	elem.dispatchEvent(new KeyboardEvent('keydown', { bubbles: true, cancelable: true, key }))
-	await waitFor(0.01)
-
-	if (elem instanceof HTMLInputElement || elem instanceof HTMLTextAreaElement) {
-		elem.dispatchEvent(new Event('beforeinput', { bubbles: true }))
-		await waitFor(0.01)
-		elem.dispatchEvent(new Event('input', { bubbles: true }))
-		await waitFor(0.01)
-	}
-
-	elem.dispatchEvent(new KeyboardEvent('keyup', { bubbles: true, cancelable: true, key }))
-}
-
 export async function inputTextElement(element: HTMLElement, text: string) {
-	if (!(element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement)) {
-		throw new Error('Element is not an input or textarea')
+	const isContentEditable = element.isContentEditable
+	if (
+		!(element instanceof HTMLInputElement) &&
+		!(element instanceof HTMLTextAreaElement) &&
+		!isContentEditable
+	) {
+		throw new Error('Element is not an input, textarea, or contenteditable')
 	}

 	await clickElement(element)

-	if (element instanceof HTMLTextAreaElement) {
+	if (isContentEditable) {
+		// Contenteditable support (partial)
+		// Not supported:
+		// - Monaco/CodeMirror: Require direct JS instance access. No universal way to obtain.
+		// - Draft.js: Not responsive to synthetic/execCommand/Range/DataTransfer. Unmaintained.
+		//
+		// Plan A: Dispatch synthetic events
+		// Works: LinkedIn, React contenteditable, Quill.
+		// Fails: Slate.js
+		// Sequence: beforeinput -> mutation -> input -> change -> blur
+
+		// Dispatch beforeinput + mutation + input for clearing
+		if (
+			element.dispatchEvent(
+				new InputEvent('beforeinput', {
+					bubbles: true,
+					cancelable: true,
+					inputType: 'deleteContent',
+				})
+			)
+		) {
+			element.innerText = ''
+			element.dispatchEvent(
+				new InputEvent('input', {
+					bubbles: true,
+					inputType: 'deleteContent',
+				})
+			)
+		}
+
+		// Dispatch beforeinput + mutation + input for insertion (important for React apps)
+		if (
+			element.dispatchEvent(
+				new InputEvent('beforeinput', {
+					bubbles: true,
+					cancelable: true,
+					inputType: 'insertText',
+					data: text,
+				})
+			)
+		) {
+			element.innerText = text
+			element.dispatchEvent(
+				new InputEvent('input', {
+					bubbles: true,
+					inputType: 'insertText',
+					data: text,
+				})
+			)
+		}
+
+		// Dispatch change event (for good measure)
+		element.dispatchEvent(new Event('change', { bubbles: true }))
+
+		// Trigger blur for validation
+		element.blur()
+
+		// Plan B: execCommand (deprecated but works better for some editors)
+		// Works: LinkedIn, Quill, Slate.js, react contenteditable components
+		//
+		// document.execCommand('selectAll')
+		// document.execCommand('delete')
+		// document.execCommand('insertText', false, text)
+	} else if (element instanceof HTMLTextAreaElement) {
 		nativeTextAreaValueSetter.call(element, text)
 	} else {
 		nativeInputValueSetter.call(element, text)
 	}

-	const inputEvent = new Event('input', { bubbles: true })
-	element.dispatchEvent(inputEvent)
+	// Only dispatch shared input event for non-contenteditable (contenteditable has its own)
+	if (!isContentEditable) {
+		element.dispatchEvent(new Event('input', { bubbles: true }))
+	}

-	await waitFor(0.1) // Wait to ensure input event processing completes
+	await waitFor(0.1)

 	blurLastClickedElement()
 }
@@ -1,16 +0,0 @@
-/**
- * Copyright (C) 2025 Alibaba Group Holding Limited
- * All rights reserved.
- */
-
-/**
- * Viewport expansion for DOM tree extraction.
- * -1 means full page (no viewport restriction)
- * 0 means viewport only
- * positive values expand the viewport by that many pixels
- *
- * @note Since isTopElement depends on elementFromPoint,
- * it returns null when out of viewport, this feature has no practical use, only differ between -1 and 0
- */
-// export const VIEWPORT_EXPANSION = 100
-export const VIEWPORT_EXPANSION = -1
@@ -1,4 +1,3 @@
-import { VIEWPORT_EXPANSION } from '../constants'
 import domTree from './dom_tree/index.js'
 import {
 	ElementDomNode,
@@ -7,7 +6,23 @@ import {
 	TextDomNode,
 } from './dom_tree/type'

+/**
+ * Viewport expansion for DOM tree extraction.
+ * -1 means full page (no viewport restriction)
+ * 0 means viewport only
+ * positive values expand the viewport by that many pixels
+ *
+ * @note Since isTopElement depends on elementFromPoint,
+ * it returns null when out of viewport, this feature has no practical use, only differ between -1 and 0
+ */
+const DEFAULT_VIEWPORT_EXPANSION = -1
+
+export function resolveViewportExpansion(viewportExpansion?: number): number {
+	return viewportExpansion ?? DEFAULT_VIEWPORT_EXPANSION
+}
+
 export interface DomConfig {
+	viewportExpansion?: number
 	interactiveBlacklist?: (Element | (() => Element))[]
 	interactiveWhitelist?: (Element | (() => Element))[]
 	includeAttributes?: string[]
@@ -21,6 +36,8 @@ export interface DomConfig {
 const newElementsCache = new WeakMap<HTMLElement, string>()

 export function getFlatTree(config: DomConfig): FlatDomTree {
+	const viewportExpansion = resolveViewportExpansion(config.viewportExpansion)
+
 	const interactiveBlacklist = [] as Element[]
 	for (const item of config.interactiveBlacklist || []) {
 		if (typeof item === 'function') {
@@ -43,7 +60,7 @@ export function getFlatTree(config: DomConfig): FlatDomTree {
 		doHighlightElements: true,
 		debugMode: true,
 		focusHighlightIndex: -1,
-		viewportExpansion: VIEWPORT_EXPANSION,
+		viewportExpansion,
 		interactiveBlacklist,
 		interactiveWhitelist,
 		highlightOpacity: config.highlightOpacity ?? 0.0,
@@ -74,6 +91,43 @@ export function getFlatTree(config: DomConfig): FlatDomTree {
 	return elements
 }

+const globRegexCache = new Map<string, RegExp>()
+
+function globToRegex(pattern: string): RegExp {
+	let regex = globRegexCache.get(pattern)
+	if (!regex) {
+		const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&')
+		regex = new RegExp(`^${escaped.replace(/\*/g, '.*')}$`)
+		globRegexCache.set(pattern, regex)
+	}
+	return regex
+}
+
+function matchAttributes(
+	attrs: Record<string, string>,
+	patterns: string[]
+): Record<string, string> {
+	const result: Record<string, string> = {}
+
+	for (const pattern of patterns) {
+		if (pattern.includes('*')) {
+			const regex = globToRegex(pattern)
+			for (const key of Object.keys(attrs)) {
+				if (regex.test(key) && attrs[key].trim()) {
+					result[key] = attrs[key].trim()
+				}
+			}
+		} else {
+			const value = attrs[pattern]
+			if (value && value.trim()) {
+				result[pattern] = value.trim()
+			}
+		}
+	}
+
+	return result
+}
+
 /**
 * elementsToString 内部使用的类型
 */
@@ -140,10 +194,13 @@ export function flatTreeToString(flatTree: FlatDomTree, includeAttributes?: stri
 		// for jump check
 		'target',

-		// absolute 定位的下拉菜单
+		// absolute position dropdown menu
 		'aria-haspopup',
 		'aria-controls',
 		'aria-owns',
+
+		// content editable
+		'contenteditable',
 	]

 	const includeAttrs = [...(includeAttributes || []), ...DEFAULT_INCLUDE_ATTRIBUTES]
@@ -245,23 +302,15 @@ export function flatTreeToString(flatTree: FlatDomTree, includeAttributes?: stri
 				let attributesHtmlStr = ''

 				if (includeAttrs.length > 0 && node.attributes) {
-					const attributesToInclude: Record<string, string> = {}
-
-					// Filter attributes
-					for (const key of includeAttrs) {
-						const value = node.attributes[key]
-						if (value && value.trim() !== '') {
-							attributesToInclude[key] = value.trim()
-						}
-					}
+					const attributesToInclude = matchAttributes(node.attributes, includeAttrs)

 					// Remove duplicate values (for attributes longer than 5 chars)
-					const orderedKeys = includeAttrs.filter((key) => key in attributesToInclude)
-					if (orderedKeys.length > 1) {
+					const keys = Object.keys(attributesToInclude)
+					if (keys.length > 1) {
 						const keysToRemove = new Set<string>()
 						const seenValues: Record<string, string> = {}

-						for (const key of orderedKeys) {
+						for (const key of keys) {
 							const value = attributesToInclude[key]
 							if (value.length > 5) {
 								if (value in seenValues) {
@@ -8,13 +8,7 @@ import cursorStyles from './cursor.module.css'
 export class SimulatorMask {
 	shown: boolean = false
 	wrapper = document.createElement('div')
-	motion = new Motion({
-		mode: isPageDark() ? 'dark' : 'light',
-		styles: {
-			position: 'absolute',
-			inset: '0',
-		},
-	})
+	motion: Motion | null = null

 	#cursor = document.createElement('div')

@@ -30,8 +24,17 @@ export class SimulatorMask {
 		this.wrapper.setAttribute('data-browser-use-ignore', 'true')
 		this.wrapper.setAttribute('data-page-agent-ignore', 'true')

-		this.wrapper.appendChild(this.motion.element)
-		this.motion.autoResize(this.wrapper)
+		try {
+			const motion = new Motion({
+				mode: isPageDark() ? 'dark' : 'light',
+				styles: { position: 'absolute', inset: '0' },
+			})
+			this.motion = motion
+			this.wrapper.appendChild(motion.element)
+			motion.autoResize(this.wrapper)
+		} catch (e) {
+			console.warn('[SimulatorMask] Motion overlay unavailable:', e)
+		}

 		// Capture all mouse, keyboard, and wheel events
 		this.wrapper.addEventListener('click', (e) => {
@@ -145,8 +148,8 @@ export class SimulatorMask {
 		if (this.shown) return

 		this.shown = true
-		this.motion.start()
-		this.motion.fadeIn()
+		this.motion?.start()
+		this.motion?.fadeIn()

 		this.wrapper.style.display = 'block'

@@ -163,8 +166,8 @@ export class SimulatorMask {
 		if (!this.shown) return

 		this.shown = false
-		this.motion.fadeOut()
-		this.motion.pause()
+		this.motion?.fadeOut()
+		this.motion?.pause()

 		this.#cursor.classList.remove(cursorStyles.clicking)

@@ -174,7 +177,7 @@ export class SimulatorMask {
 	}

 	dispose() {
-		this.motion.dispose()
+		this.motion?.dispose()
 		this.wrapper.remove()
 	}
 }
@@ -1,6 +1,6 @@
 {
    "name": "@page-agent/ui",
-    "version": "1.5.1",
+    "version": "1.5.5",
    "type": "module",
    "main": "./dist/lib/page-agent-ui.js",
    "module": "./dist/lib/page-agent-ui.js",
@@ -1,7 +1,7 @@
 {
    "name": "@page-agent/website",
    "private": true,
-    "version": "1.5.1",
+    "version": "1.5.5",
    "type": "module",
    "scripts": {
        "dev": "vite --host 0.0.0.0",
@@ -19,13 +19,13 @@
        "@types/react-dom": "^19.2.1",
        "class-variance-authority": "^0.7.1",
        "clsx": "^2.1.1",
-        "lucide-react": "^0.576.0",
-        "motion": "^12.34.5",
+        "lucide-react": "^0.577.0",
+        "motion": "^12.35.2",
        "next-themes": "^0.4.6",
        "react": "^19.2.4",
        "react-dom": "^19.2.4",
        "rough-notation": "^0.5.1",
-        "simple-icons": "^16.10.0",
+        "simple-icons": "^16.11.0",
        "sonner": "^2.0.7",
        "tailwind-merge": "^3.5.0",
        "tailwindcss": "^4.1.14",
@@ -1,8 +1,8 @@
 // Demo build (auto-init with demo LLM, for quick testing)
 export const CDN_DEMO_URL =
-	'https://cdn.jsdelivr.net/npm/page-agent@1.5.1/dist/iife/page-agent.demo.js'
+	'https://cdn.jsdelivr.net/npm/page-agent@1.5.5/dist/iife/page-agent.demo.js'
 export const CDN_DEMO_CN_URL =
-	'https://registry.npmmirror.com/page-agent/1.5.1/files/dist/iife/page-agent.demo.js'
+	'https://registry.npmmirror.com/page-agent/1.5.5/files/dist/iife/page-agent.demo.js'

 // Demo LLM for website testing (homepage quick trial uses flash)
 export const DEMO_MODEL = 'qwen3.5-flash'
@@ -105,8 +105,8 @@ const agent = new PageAgentCore({
 							name: 'includeAttributes',
 							type: 'string[]',
 							description: isZh
-								? '在 DOM 提取中包含的额外 HTML 属性（如 data-testid）。默认已包含常见属性如 role, aria-label 等。'
-								: 'Additional HTML attributes to include in DOM extraction (e.g. data-testid). Common attributes like role, aria-label are included by default.',
+								? '在 DOM 提取中包含的额外 HTML 属性。支持通配符 *（如 data-* 匹配所有 data- 开头的属性）。默认已包含常见属性如 role, aria-label 等。'
+								: 'Additional HTML attributes to include in DOM extraction. Supports wildcard * (e.g. data-* matches all data- prefixed attributes). Common attributes like role, aria-label are included by default.',
 						},
 					]}
 				/>
@@ -23,7 +23,7 @@ const MODEL_GROUPS: Record<string, string[]> = {
 		'qwen-3-plus',
 		'qwen3:14b (ollama)',
 	],
-	OpenAI: ['gpt-5.2', 'gpt-5.1', 'gpt-5', 'gpt-5-mini', 'gpt-4.1', 'gpt-4.1-mini'],
+	OpenAI: ['gpt-5.4', 'gpt-5.2', 'gpt-5.1', 'gpt-5', 'gpt-5-mini', 'gpt-4.1', 'gpt-4.1-mini'],
 	DeepSeek: ['deepseek-3.2'],
 	Google: ['gemini-3-pro', 'gemini-3-flash', 'gemini-2.5'],
 	Anthropic: [
@@ -68,11 +68,6 @@ export default function Models() {
 				<Heading id="tested-models" className="text-2xl font-semibold mb-3">
 					{isZh ? '已测试模型' : 'Tested Models'}
 				</Heading>
-				<p className="text-sm text-gray-600 dark:text-gray-400 mb-4">
-					{isZh
-						? '推荐使用 ToolCall 能力强的轻量级模型。'
-						: 'Recommended: Fast, lightweight models with strong ToolCall capabilities.'}
-				</p>
 				<div className="bg-linear-to-br from-emerald-50 to-cyan-50 dark:from-emerald-950/30 dark:to-cyan-950/30 rounded-xl p-6 border border-emerald-200/50 dark:border-emerald-800/50">
 					<div className="grid grid-cols-[5rem_1fr] gap-x-3 gap-y-3 items-start">
 						{Object.entries(MODEL_GROUPS).map(([brand, models]) => (
@@ -96,6 +91,11 @@ export default function Models() {
 				<h2 className="text-2xl font-semibold mb-4">{isZh ? '提示' : 'Tips'}</h2>
 				<div className="p-4 bg-blue-50 dark:bg-blue-950/20 rounded-lg border border-blue-200 dark:border-blue-800">
 					<ul className="text-sm text-gray-700 dark:text-gray-300 space-y-2 list-disc pl-5">
+						<li>
+							{isZh
+								? '⭐ 推荐使用 ToolCall 能力强的轻量级模型'
+								: '⭐ Recommended: Fast, lightweight models with strong ToolCall capabilities'}
+						</li>
 						<li>
 							{isZh
 								? 'ToolCall 能力较弱的模型可能返回错误的格式，常见错误能够自动恢复，建议设置较高的 temperature'
@@ -110,39 +110,6 @@ export default function Models() {
 				</div>
 			</section>

-			{/* Security Section */}
-			<section className="mb-10">
-				<h2 className="text-2xl font-semibold mb-4">
-					{isZh ? '🔐 生产环境鉴权建议' : '🔐 Production Authentication'}
-				</h2>
-				<div className="bg-yellow-50 dark:bg-yellow-950/20 border-l-4 border-yellow-500 p-5 rounded-r-lg mb-4">
-					<p className="text-sm font-semibold text-yellow-900 dark:text-yellow-200">
-						{isZh
-							? '⚠️ 永远不要把真实的 LLM API Key 发布到前端代码'
-							: '⚠️ Never commit real LLM API Keys to your frontend code'}
-					</p>
-				</div>
-				<div className="bg-gray-50 dark:bg-gray-900/30 rounded-lg p-5 border border-gray-200 dark:border-gray-800">
-					<h3 className="font-semibold text-gray-900 dark:text-gray-100 mb-2">
-						{isZh ? '后端代理转发' : 'Backend Proxy Pattern'}
-					</h3>
-					<p className="text-sm text-gray-600 dark:text-gray-400 mb-3">
-						{isZh
-							? '在后端搭建一个 LLM 流量转发接口,该接口使用与你网站上其他接口相同的鉴权方式,例如:'
-							: 'Set up a backend LLM proxy endpoint that uses the same authentication method as other APIs in your website, such as:'}
-					</p>
-					<ul className="text-sm text-gray-600 dark:text-gray-400 space-y-1">
-						<li>{isZh ? '• Session/Cookie 会话认证' : '• Session/Cookie-based authentication'}</li>
-						<li>
-							{isZh ? '• OIDC (OpenID Connect) 单点登录' : '• OIDC (OpenID Connect) single sign-on'}
-						</li>
-						<li>
-							{isZh ? '• 临时 Access Key 或 JWT Token' : '• Temporary Access Key or JWT Token'}
-						</li>
-					</ul>
-				</div>
-			</section>
-
 			{/* Configuration Section */}
 			<section className="mb-10">
 				<Heading id="configuration">{isZh ? '配置方式' : 'Configuration'}</Heading>
@@ -170,9 +137,24 @@ const pageAgent = new PageAgent({
 				<Heading id="free-testing-api">{isZh ? '免费测试接口' : 'Free Testing API'}</Heading>
 				<p className="text-sm text-gray-600 dark:text-gray-400 mb-4">
 					{isZh
-						? '以下免费测试接口仅供 PageAgent.js 和 PageAgent Extension 的技术评估使用。有速率限制，可能随时变更。请勿用于生产环境。'
-						: 'The following free testing endpoints are provided for technical evaluation of PageAgent.js and PageAgent Extension only. Rate-limited, subject to change. Not for production use.'}
+						? '以下免费测试接口仅供 PageAgent.js 和 PageAgent Extension 的技术评估和测试使用。'
+						: 'The following free testing endpoint is provided for testing and technical evaluation.'}
 				</p>
+				<div className="my-4 p-4 bg-amber-50 dark:bg-amber-950/20 rounded-lg border border-amber-200 dark:border-amber-800">
+					<p className="text-xs text-gray-600 dark:text-gray-400">
+						{isZh
+							? '⚠️ 仅供技术评估和研发用途，禁止用于生产环境。数据通过中国大陆服务器处理。请勿输入任何个人身份信息或敏感数据。使用即表示您同意'
+							: '⚠️ Strictly for technical evaluation and R&D only. Data is processed via servers in Mainland China. Do not input any PII or sensitive data. By using this API you agree to the'}{' '}
+						<a
+							href="https://github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md#2-testing-api-and-demo-disclaimer--terms-of-use"
+							target="_blank"
+							rel="noopener noreferrer"
+							className="text-blue-500 hover:underline"
+						>
+							{isZh ? '使用条款' : 'Terms of Use'}
+						</a>
+					</p>
+				</div>
 				<div className="bg-gray-50 dark:bg-gray-900/30 rounded-lg p-5 border border-gray-200 dark:border-gray-800">
 					<h3 className="font-semibold text-gray-900 dark:text-gray-100 mb-2">
 						Qwen (Alibaba Cloud China)
@@ -198,21 +180,6 @@ LLM_MODEL_NAME="qwen3.5-plus"
 LLM_API_KEY="NA"`}
 					/>
 				</div>
-				<div className="mt-4 p-4 bg-amber-50 dark:bg-amber-950/20 rounded-lg border border-amber-200 dark:border-amber-800">
-					<p className="text-xs text-gray-600 dark:text-gray-400">
-						{isZh
-							? '⚠️ 仅供技术评估和研发用途，禁止用于生产环境。数据通过中国大陆服务器处理。请勿输入任何个人身份信息或敏感数据。使用即表示您同意'
-							: '⚠️ Strictly for technical evaluation and R&D only. Data is processed via servers in Mainland China. Do not input any PII or sensitive data. By using this API you agree to the'}{' '}
-						<a
-							href="https://github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md#2-testing-api-and-demo-disclaimer--terms-of-use"
-							target="_blank"
-							rel="noopener noreferrer"
-							className="text-blue-500 hover:underline"
-						>
-							{isZh ? '使用条款' : 'Terms of Use'}
-						</a>
-					</p>
-				</div>
 			</section>

 			{/* Ollama Section */}
@@ -277,6 +244,48 @@ LLM_MODEL_NAME="qwen3:14b"`}
 					</div>
 				</div>
 			</section>
+
+			{/* Production Authentication */}
+			<section className="mb-10">
+				<Heading id="production-authentication" className="text-2xl font-semibold mb-4">
+					{isZh ? '🔐 生产环境鉴权' : '🔐 Production Authentication'}
+				</Heading>
+				<p className="text-sm text-gray-600 dark:text-gray-400 mb-3">
+					{isZh
+						? '如果你只是将它用作个人助手，可以直接连接你的 LLM 服务。'
+						: 'If you only use it as a personal assistant, you can connect to your LLM service directly.'}
+				</p>
+				<p className="text-sm text-gray-600 dark:text-gray-400 mb-3">
+					{isZh ? (
+						<>
+							如果你计划将它集成到你的 Web 应用中，建议搭建一个后端代理来转发 LLM 请求，并使用{' '}
+							<code>customFetch</code> 携带 Cookie 或其他鉴权信息：
+						</>
+					) : (
+						<>
+							If you plan to integrate it into your web app, it's better to have a backend proxy for
+							the LLM and use <code>customFetch</code> to authenticate the request with cookies or
+							other methods:
+						</>
+					)}
+				</p>
+				<CodeEditor
+					code={`const agent = new PageAgent({
+  baseURL: '/api/llm-proxy',
+  apiKey: 'NA',
+  model: 'gpt-5.1',
+  customFetch: (url, init) =>
+    fetch(url, { ...init, credentials: 'include' }),
+});`}
+				/>
+				<div className="mt-4 bg-yellow-50 dark:bg-yellow-950/20 border-l-4 border-yellow-500 p-4 rounded-r-lg">
+					<p className="text-sm font-semibold text-yellow-900 dark:text-yellow-200">
+						{isZh
+							? '⚠️ 永远不要把真实的 LLM API Key 提交到前端代码中'
+							: '⚠️ NEVER commit real LLM API keys to your frontend code'}
+					</p>
+				</div>
+			</section>
 		</div>
 	)
 }
@@ -18,8 +18,10 @@ function ScrollToTop() {

 export default function Router() {
 	useEffect(() => {
-		const id = requestIdleCallback(() => docsImport())
-		return () => cancelIdleCallback(id)
+		const schedule = globalThis.requestIdleCallback ?? ((cb: () => void) => setTimeout(cb, 1))
+		const cancel = globalThis.cancelIdleCallback ?? clearTimeout
+		const id = schedule(() => docsImport())
+		return () => cancel(id)
 	}, [])

 	return (
@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+/**
+ * Bump extension version and show git tag commands
+ *
+ * Usage:
+ *   node scripts/ext-version.js 0.1.16
+ */
+import chalk from 'chalk'
+import { readFileSync, writeFileSync } from 'fs'
+import { dirname, join } from 'path'
+import { exit } from 'process'
+import { fileURLToPath } from 'url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const pkgPath = join(__dirname, '..', 'packages', 'extension', 'package.json')
+
+const newVersion = process.argv[2]
+if (!newVersion) {
+	console.log(chalk.yellow('⚠️  Usage: npm run ext:version <version>\n'))
+	exit(1)
+}
+
+const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))
+const oldVersion = pkg.version
+
+pkg.version = newVersion
+writeFileSync(pkgPath, JSON.stringify(pkg, null, '    ') + '\n')
+
+console.log(
+	chalk.green.bold('\n✓') +
+		` ${chalk.bold('@page-agent/ext')}: ${chalk.dim(oldVersion)} → ${chalk.yellow(newVersion)}\n`
+)
+
+const tagName = `EXT_v${newVersion}`
+console.log(chalk.cyan.bold('📋 Next steps:\n'))
+console.log(chalk.blueBright(`npm i`))
+console.log(
+	chalk.blueBright(`git add . && git commit -m "chore(ext): bump version to ${newVersion}"`)
+)
+console.log(chalk.blueBright(`git tag -a ${tagName} -m "${tagName}"`))
+console.log(chalk.blueBright(`git push && git push origin ${tagName}\n`))
Author	SHA1	Message	Date
Simon	692ac4acca	chore(version): bump version to 1.5.5	2026-03-10 22:49:03 +08:00
Simon	aa88221845	Merge branch 'main' of https://github.com/alibaba/page-agent	2026-03-10 22:06:51 +08:00
Simon	b425e48afe	docs: guideline against AI-generated PRs	2026-03-10 22:06:41 +08:00
Simon	ff54b363aa	Merge pull request #179 from JasonOA888/fix/contenteditable-input-events fix(page-controller): improve contenteditable input with proper events	2026-03-10 21:04:05 +08:00
Simon	4d931b4430	chore: comments; spell check	2026-03-10 21:02:48 +08:00
JasonOA888	6054ca1217	docs(page-controller): document contenteditable limitations and execCommand fallback ## Changes Based on @gaomeng1900's comprehensive testing feedback: 1. Document known limitations - Slate.js and Draft.js do not work with synthetic events - Draft.js: Cannot be supported via DOM manipulation (by design, unmaintained) - Monaco/CodeMirror: Require direct JS instance access 2. Clarify tested editors - Works: Quill, LinkedIn, simple contenteditable editors - Does not work: Slate.js, Draft.js 3. Preserve execCommand as fallback - execCommand works better for LinkedIn, Quill, and Draft.js - Kept as commented fallback (deprecated API) - Users can uncomment if synthetic events don't work Co-authored-by: gaomeng1900 <gaomeng1900@users.noreply.github.com>	2026-03-10 20:39:20 +08:00
Simon	7f9f0d1589	feat: simplify ContentEditable handling	2026-03-10 19:40:49 +08:00
Simon	ddcfa5b499	Merge branch 'main' into fix/contenteditable-input-events	2026-03-10 17:37:20 +08:00
JasonOA888	441b41c713	fix(page-controller): address all Copilot review feedback ## Changes 1. Fix early return bypassing cleanup - Remove early return when beforeinput is canceled - Use shouldInsert flag to skip mutation but continue cleanup - Ensures waitFor and blurLastClickedElement always run 2. Fix duplicate input events - Contenteditable path now dispatches its own input events with inputType - Skip shared input dispatch for contenteditable - Prevents double-triggering framework listeners 3. Fix event order (mutation before events) - Clear content now dispatches beforeinput(inputType:deleteContent) first - Then performs the clear mutation - Then dispatches input event for the deletion - Proper event-mutation ordering 4. Single-character keyboard events remain - PR description clarified this is intentional - Multi-character input uses bulk insertion (not per-character typing) - Maintains semantic consistency 5. Fix duplicate focusout event - blur() already triggers native focusout - Removed manual focusout dispatch - Prevents double validation handlers All changes follow Copilot's suggested fixes.	2026-03-10 16:03:25 +08:00
Simon	ed71dd08b9	Merge pull request #181 from fancyboi999/fancy/fix-180-viewport-expansion fix(page-controller): honor viewportExpansion in DOM extraction	2026-03-10 15:50:34 +08:00
fancy	1c354ab5d3	refactor(page-controller): remove viewportExpansion constants module	2026-03-10 15:34:24 +08:00
Simon	151760713a	Merge pull request #177 from alibaba/dependabot/npm_and_yarn/development-dependencies-05afa3b718 chore(deps-dev): bump the development-dependencies group with 10 updates	2026-03-10 15:34:14 +08:00
Simon	4450d6302b	docs: update guidelines, CLA should be optional	2026-03-10 15:23:19 +08:00
JasonOA888	2d055d3909	style: fix Prettier formatting	2026-03-10 15:10:17 +08:00
fancy	16da7d936d	fix(page-controller): honor viewportExpansion in DOM extraction	2026-03-10 12:28:54 +08:00
JasonOA888	efe08f445f	fix(page-controller): address Copilot review feedback ## Changes 1. Check beforeinput cancellation - dispatchEvent returns false if canceled - Check defaultPrevented as well - Abort mutation if event was canceled by any listener 2. Fix event order to match real user typing - Before: beforeinput -> mutation -> input -> keydown -> keyup - After: keydown -> beforeinput -> mutation -> input -> keyup - This matches typical browser event sequence 3. Fix blur event semantics - blur doesn't bubble; focusout does - Call editableElement.blur() to actually change focus - Dispatch focusout with bubbles:true for listeners - Then refocus 4. Keep single-character keyboard events - Already fixed in previous commit - Maintained here with correct order All changes follow Copilot's suggested fixes.	2026-03-10 12:02:01 +08:00
JasonOA888	4e7f755ae9	fix(page-controller): address PR review feedback ## Changes 1. Fix keyboard event semantics (per review feedback) - Only dispatch keydown/keyup for single-character input - Avoids inconsistent event payloads for multi-character strings - Prevents confusion in editors that correlate key events with text changes 2. Remove extra blank line - Formatting consistency Reviewer noted that dispatching key events with only the last character of multi-character text creates semantic inconsistency with the actual DOM mutation (which inserts the full string at once). This fix follows the suggested change from the review.	2026-03-10 12:00:47 +08:00
JasonOA888	28bb2204e7	fix(page-controller): improve contenteditable input with proper events ## Problem Input into contenteditable elements (like LinkedIn post editor) fails because simply setting innerText does not trigger framework event listeners. ## Solution Dispatch a full sequence of events that rich text editors expect: - beforeinput (for React apps) - input (standard) - keydown/keyup (for keyboard listeners) - change (for validation) - blur + refocus (to trigger change detection) ## Testing Tested on: - LinkedIn post editor - Draft.js editors - Contenteditable divs with React listeners Fixes #168	2026-03-10 10:32:07 +08:00
dependabot[bot]	0c3b4592b2	chore(deps-dev): bump the development-dependencies group with 10 updates Bumps the development-dependencies group with 10 updates: \| Package \| From \| To \| \| --- \| --- \| --- \| \| [@commitlint/cli](https://github.com/conventional-changelog/commitlint/tree/HEAD/@commitlint/cli) \| `20.4.2` \| `20.4.3` \| \| [@commitlint/config-conventional](https://github.com/conventional-changelog/commitlint/tree/HEAD/@commitlint/config-conventional) \| `20.4.2` \| `20.4.3` \| \| [@microsoft/api-extractor](https://github.com/microsoft/rushstack/tree/HEAD/apps/api-extractor) \| `7.57.6` \| `7.57.7` \| \| [@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node) \| `25.3.3` \| `25.4.0` \| \| [lint-staged](https://github.com/lint-staged/lint-staged) \| `16.3.1` \| `16.3.2` \| \| [typescript-eslint](https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/typescript-eslint) \| `8.56.1` \| `8.57.0` \| \| [@wxt-dev/module-react](https://github.com/wxt-dev/wxt/tree/HEAD/packages/module-react) \| `1.1.5` \| `1.2.1` \| \| [lucide-react](https://github.com/lucide-icons/lucide/tree/HEAD/packages/lucide-react) \| `0.576.0` \| `0.577.0` \| \| [motion](https://github.com/motiondivision/motion) \| `12.34.5` \| `12.35.2` \| \| [simple-icons](https://github.com/simple-icons/simple-icons) \| `16.10.0` \| `16.11.0` \| Updates `@commitlint/cli` from 20.4.2 to 20.4.3 - [Release notes](https://github.com/conventional-changelog/commitlint/releases) - [Changelog](https://github.com/conventional-changelog/commitlint/blob/master/@commitlint/cli/CHANGELOG.md) - [Commits](https://github.com/conventional-changelog/commitlint/commits/v20.4.3/@commitlint/cli) Updates `@commitlint/config-conventional` from 20.4.2 to 20.4.3 - [Release notes](https://github.com/conventional-changelog/commitlint/releases) - [Changelog](https://github.com/conventional-changelog/commitlint/blob/master/@commitlint/config-conventional/CHANGELOG.md) - [Commits](https://github.com/conventional-changelog/commitlint/commits/v20.4.3/@commitlint/config-conventional) Updates `@microsoft/api-extractor` from 7.57.6 to 7.57.7 - [Changelog](https://github.com/microsoft/rushstack/blob/main/apps/api-extractor/CHANGELOG.md) - [Commits](https://github.com/microsoft/rushstack/commits/@microsoft/api-extractor_v7.57.7/apps/api-extractor) Updates `@types/node` from 25.3.3 to 25.4.0 - [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases) - [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node) Updates `lint-staged` from 16.3.1 to 16.3.2 - [Release notes](https://github.com/lint-staged/lint-staged/releases) - [Changelog](https://github.com/lint-staged/lint-staged/blob/main/CHANGELOG.md) - [Commits](https://github.com/lint-staged/lint-staged/compare/v16.3.1...v16.3.2) Updates `typescript-eslint` from 8.56.1 to 8.57.0 - [Release notes](https://github.com/typescript-eslint/typescript-eslint/releases) - [Changelog](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/typescript-eslint/CHANGELOG.md) - [Commits](https://github.com/typescript-eslint/typescript-eslint/commits/v8.57.0/packages/typescript-eslint) Updates `@wxt-dev/module-react` from 1.1.5 to 1.2.1 - [Release notes](https://github.com/wxt-dev/wxt/releases) - [Changelog](https://github.com/wxt-dev/wxt/blob/main/packages/module-react/CHANGELOG.md) - [Commits](https://github.com/wxt-dev/wxt/commits/storage-v1.2.1/packages/module-react) Updates `lucide-react` from 0.576.0 to 0.577.0 - [Release notes](https://github.com/lucide-icons/lucide/releases) - [Commits](https://github.com/lucide-icons/lucide/commits/0.577.0/packages/lucide-react) Updates `motion` from 12.34.5 to 12.35.2 - [Changelog](https://github.com/motiondivision/motion/blob/main/CHANGELOG.md) - [Commits](https://github.com/motiondivision/motion/compare/v12.34.5...v12.35.2) Updates `simple-icons` from 16.10.0 to 16.11.0 - [Release notes](https://github.com/simple-icons/simple-icons/releases) - [Commits](https://github.com/simple-icons/simple-icons/compare/16.10.0...16.11.0) --- updated-dependencies: - dependency-name: "@commitlint/cli" dependency-version: 20.4.3 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: development-dependencies - dependency-name: "@commitlint/config-conventional" dependency-version: 20.4.3 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: development-dependencies - dependency-name: "@microsoft/api-extractor" dependency-version: 7.57.7 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: development-dependencies - dependency-name: "@types/node" dependency-version: 25.4.0 dependency-type: direct:development update-type: version-update:semver-minor dependency-group: development-dependencies - dependency-name: lint-staged dependency-version: 16.3.2 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: development-dependencies - dependency-name: typescript-eslint dependency-version: 8.57.0 dependency-type: direct:development update-type: version-update:semver-minor dependency-group: development-dependencies - dependency-name: "@wxt-dev/module-react" dependency-version: 1.2.1 dependency-type: direct:development update-type: version-update:semver-minor dependency-group: development-dependencies - dependency-name: lucide-react dependency-version: 0.577.0 dependency-type: direct:development update-type: version-update:semver-minor dependency-group: development-dependencies - dependency-name: motion dependency-version: 12.35.2 dependency-type: direct:development update-type: version-update:semver-minor dependency-group: development-dependencies - dependency-name: simple-icons dependency-version: 16.11.0 dependency-type: direct:development update-type: version-update:semver-minor dependency-group: development-dependencies ... Signed-off-by: dependabot[bot] <support@github.com>	2026-03-09 20:33:42 +00:00
Simon	222bbef670	chore: update readme	2026-03-09 23:41:12 +08:00
Simon	fa8ab451eb	chore: update readme	2026-03-09 23:39:41 +08:00
Simon	b4ebb2b98f	chore(version): bump version to 1.5.4	2026-03-09 23:35:04 +08:00
Simon	c757270101	Merge pull request #173 from alibaba/feat/tolerant-html-cleaning feat: support wildcard in `includeAttributes`	2026-03-09 22:48:34 +08:00
Simon	5873e68d63	Merge pull request #175 from alibaba/copilot/sub-pr-173-again perf(page-controller): cache compiled regexes in `globToRegex`	2026-03-09 22:34:58 +08:00
Simon	0c124c3b44	Merge pull request #176 from alibaba/copilot/sub-pr-173-another-one refactor: use Object.keys() instead of for...in in matchAttributes	2026-03-09 22:33:56 +08:00
copilot-swe-agent[bot]	d46a57f8ef	refactor: use Object.keys() instead of for...in in matchAttributes Co-authored-by: gaomeng1900 <10131203+gaomeng1900@users.noreply.github.com>	2026-03-09 14:32:20 +00:00
Simon	153fa23a71	docs: update model list; give example for cookie auth	2026-03-09 22:31:35 +08:00
copilot-swe-agent[bot]	5852054e3a	perf: cache compiled regexes in globToRegex to avoid repeated compilation Co-authored-by: gaomeng1900 <10131203+gaomeng1900@users.noreply.github.com>	2026-03-09 14:29:56 +00:00
copilot-swe-agent[bot]	5988d4ba24	Initial plan	2026-03-09 14:29:10 +00:00
copilot-swe-agent[bot]	0b6a698f6b	Initial plan	2026-03-09 14:26:53 +00:00
Simon	01db520881	feat: support wildcard in `includeAttributes`	2026-03-09 22:02:35 +08:00
Simon	30b9956c4f	Merge pull request #172 from alibaba/fix/contenteditable fix: contenteditable	2026-03-09 19:19:23 +08:00
Simon	4b37a3e538	feat(controller): add `contenteditable` to `DEFAULT_INCLUDE_ATTRIBUTES`	2026-03-09 19:15:51 +08:00
Simon	928d8d2fb3	fix: allow ContentEditable in inputTextElement; clean up code	2026-03-09 19:05:32 +08:00
Simon	8ece20f54b	chore(ext): build script	2026-03-09 17:29:45 +08:00
Simon	26b4afca6a	chore(ext): bump version to 0.1.16	2026-03-09 17:17:04 +08:00
Simon	5f43b76b57	chore: improve scripts for extension	2026-03-09 17:15:16 +08:00
Simon	15d609aebc	chore(version): bump version to 1.5.3	2026-03-09 17:02:34 +08:00
Simon	d66bf8f3cf	docs: improve Contributing.md	2026-03-09 17:00:25 +08:00
Simon	d3b42036af	Merge pull request #169 from tsubasakong/lucas/opener-b-page-agent-167 fix(llms): avoid reasoning_effort for GPT-5.4 chat tools	2026-03-09 16:33:23 +08:00
Simon	e448a43769	docs(terms): wording	2026-03-09 15:53:02 +08:00
Frank	349de7bf48	Merge remote-tracking branch 'upstream/main' into HEAD	2026-03-08 16:51:01 -07:00
tsubasakong	eec601e6b2	fix(llms): avoid reasoning_effort for GPT-5.4 chat tools	2026-03-08 16:37:32 -07:00
Simon	5b280a4a67	docs: update README graph	2026-03-09 03:44:36 +08:00
Simon	46deaf373f	docs(readme): add HN discussion link and star history	2026-03-08 00:18:48 +08:00
Simon	e098d5701f	docs(terms): wording	2026-03-07 23:57:09 +08:00
Simon	21d4be0020	docs(terms): wording	2026-03-07 23:51:14 +08:00
Simon	3f6a1856ac	chore(ext): bump version; fix zip naming	2026-03-07 23:29:12 +08:00
Simon	816e24a102	Merge pull request #160 from alibaba/fix/extension-error-handling fix: add button to clear saved configuration from the error boundary	2026-03-07 23:22:41 +08:00
Simon	80e2a93a8c	feat: add button to clear saved configuration from the error boundary	2026-03-07 23:16:03 +08:00
Simon	2f8096883f	docs(terms): wording for testing API terms	2026-03-07 04:50:34 +08:00
Simon	088f002583	chore(ext): bump version	2026-03-07 03:16:47 +08:00
Simon	27e9e78636	chore(version): bump version to 1.5.2	2026-03-07 03:08:33 +08:00
Simon	a0c979602e	feat: do not throw for webgl2 fail	2026-03-07 03:07:21 +08:00
Simon	3dc9edb8b5	fix(ext): ts types	2026-03-06 17:39:09 +08:00
Simon	32b68ab7c8	fix(docs): broken demo video	2026-03-06 16:07:22 +08:00
Simon	75a61c05c1	docs(terms): wording Clarify the note regarding data processing location for the demo.	2026-03-06 04:33:03 +08:00
Simon	bdfa98358b	fix: `requestIdleCallback` on safari	2026-03-06 02:35:01 +08:00
Simon	dc8b38ccb9	chore(ext): bump extension version to 0.1.11	2026-03-05 20:48:00 +08:00
Simon	e1c288aaeb	docs(changelog): 1.5.1	2026-03-05 20:44:26 +08:00
Simon	7a97de2a37	feat(ext): expose more config	2026-03-05 20:34:55 +08:00