chore(version): bump version to 0.2.4

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -58,4 +58,4 @@ body:
         - label: I have read the Code of Conduct. / 我已阅读行为准则。
           required: true
     validations:
-      required: true
+      required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -44,4 +44,4 @@ body:
         - label: I have read the CODE_OF_CONDUCT.md and CONTRIBUTING.md. / 我已阅读行为准则。
           required: true
     validations:
-      required: true
+      required: true

.github/workflows/release.yml

@@ -6,7 +6,7 @@ on:
       - 'v*'
 
 permissions:
-  id-token: write  # Required for OIDC
+  id-token: write # Required for OIDC
   contents: read
 
 jobs:
@@ -24,7 +24,7 @@ jobs:
       # Ensure npm 11.5.1 or later is installed
       - name: Update npm
         run: npm install -g npm@latest
-        
+
       - name: Install dependencies
         run: npm ci
 
@@ -32,4 +32,4 @@ jobs:
         run: npm run build:libs
 
       - name: Publish all public packages
-        run: npm publish --workspaces --access public
+        run: npm publish --workspaces --access public

.vscode/extensions.json

@@ -1,3 +1,3 @@
 {
-	"recommendations": ["dbaeumer.vscode-eslint", "prettier.prettier-vscode"]
+    "recommendations": ["dbaeumer.vscode-eslint", "prettier.prettier-vscode"]
 }

.vscode/settings.json

@@ -1,29 +1,29 @@
 {
-	"editor.fontLigatures": true,
+    "editor.fontLigatures": true,
-	"cSpell.words": [
+    "cSpell.words": [
-		"deepseek",
+        "deepseek",
-		"HITL",
+        "HITL",
-		"innerhtml",
+        "innerhtml",
-		"llms",
+        "llms",
-		"onwarn",
+        "onwarn",
-		"opensource",
+        "opensource",
-		"qwen",
+        "qwen",
-		"retryable",
+        "retryable",
-		"shadcn",
+        "shadcn",
-		"wouter"
+        "wouter"
-	],
+    ],
-	"markdownlint.config": {
+    "markdownlint.config": {
-		// "comment": "Relaxed rules",
+        // "comment": "Relaxed rules",
-		"default": true,
+        "default": true,
-		"whitespace": false,
+        "whitespace": false,
-		"line_length": false,
+        "line_length": false,
-		"ul-indent": false,
+        "ul-indent": false,
-		"no-inline-html": false,
+        "no-inline-html": false,
-		"no-bare-urls": false,
+        "no-bare-urls": false,
-		"fenced-code-language": false,
+        "fenced-code-language": false,
-		"first-line-h1": false,
+        "first-line-h1": false,
-		"block-spacing": false,
+        "block-spacing": false,
-		"blanks-around-lists": false,
+        "blanks-around-lists": false,
-		"ol-prefix": false
+        "ol-prefix": false
-	}
+    }
 }

CONTRIBUTING.md

@@ -7,16 +7,16 @@ Thank you for your interest in contributing to Page-Agent! We welcome contributi
 ### Development Setup
 
 1. **Prerequisites**
-   - `node.js >= 20` with `npm >= 10`
+    - `node.js >= 20` with `npm >= 10`
-   - An editor that supports `ts/eslint/prettier`
+    - An editor that supports `ts/eslint/prettier`
-   - Make sure `eslint`, `prettier` and `commitlint` work well
+    - Make sure `eslint`, `prettier` and `commitlint` work well
 
 2. **Setup**
 
-   ```bash
+    ```bash
-   npm ci
+    npm ci
-   npm start          # Start demo and documentation site
+    npm start          # Start demo and documentation site
-   ```
+    ```
 
 ### Project Structure
 
@@ -44,39 +44,39 @@ We use a simplified monorepo solution with `native npm-workspace + ts reference
 
 1. **Fork and Clone**
 
-   ```bash
+    ```bash
-   git clone https://github.com/your-username/page-agent.git
+    git clone https://github.com/your-username/page-agent.git
-   cd page-agent
+    cd page-agent
-   ```
+    ```
 
 2. **Create Feature Branch**
 
-   ```bash
+    ```bash
-   git checkout -b feat/your-feature-name
+    git checkout -b feat/your-feature-name
-   ```
+    ```
 
 3. **Make Changes**
-   - Follow existing code style and patterns
+    - Follow existing code style and patterns
-   - Add tests for new functionality
+    - Add tests for new functionality
-   - Update documentation as needed
+    - Update documentation as needed
 
 4. **Test Your Changes**
-   - Test in our demo website
+    - Test in our demo website
-   - Test it on other websites if applicable
+    - Test it on other websites if applicable
-   - `@TODO: test suite`
+    - `@TODO: test suite`
 
 5. **Commit and Push**
 
-   ```bash
+    ```bash
-   git add .
+    git add .
-   git commit -m "feat: add awesome feature"
+    git commit -m "feat: add awesome feature"
-   git push origin feat/your-feature-name
+    git push origin feat/your-feature-name
-   ```
+    ```
 
 6. **Create Pull Request**
-   - Provide clear description of changes
+    - Provide clear description of changes
-   - Link related issues
+    - Link related issues
-   - Include screenshots for UI changes
+    - Include screenshots for UI changes
 
 ## 📝 Code Style
 
@@ -101,11 +101,11 @@ We use a simplified monorepo solution with `native npm-workspace + ts reference
 
 - Create a `.env` file in the repo root with your LLM API config
 
-  ```env
+    ```env
-  LLM_MODEL_NAME=gpt-5.2
+    LLM_MODEL_NAME=gpt-5.2
-  LLM_API_KEY=your-api-key
+    LLM_API_KEY=your-api-key
-  LLM_BASE_URL=https://api.your-llm-provider.com/v1
+    LLM_BASE_URL=https://api.your-llm-provider.com/v1
-  ```
+    ```
 
 - Restart the dev server to load new env vars
 - If not provided, the demo will the free testing proxy by default
@@ -120,15 +120,15 @@ npm start
 
 - Start and serve a local `iife` script
 
-  ```bash
+    ```bash
-  npm run dev:iife # Serving IIFE with auto rebuild at http://localhost:5174/page-agent.js
+    npm run dev:iife # Serving IIFE with auto rebuild at http://localhost:5174/page-agent.js
-  ```
+    ```
 
 - Add a new bookmark
 
-  ```javascript
+    ```javascript
-  javascript:(function(){var s=document.createElement('script');s.src=`http://localhost:5174/page-agent.js?t=${Math.random()}`;s.onload=()=>console.log(%27PageAgent ready!%27);document.head.appendChild(s);})();
+    javascript:(function(){var s=document.createElement('script');s.src=`http://localhost:5174/page-agent.js?t=${Math.random()}`;s.onload=()=>console.log(%27PageAgent ready!%27);document.head.appendChild(s);})();
-  ```
+    ```
 
 - Click the bookmark on any page to load Page-Agent
 

README-zh.md

@@ -1,8 +1,11 @@
 # PageAgent 🤖🪄
 
-![banner](https://img.alicdn.com/imgextra/i1/O1CN01RY0Wvh26ATVeDIX7v_!!6000000007621-0-tps-1672-512.jpg)
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://img.alicdn.com/imgextra/i4/O1CN01qKig1P1FnhpFKNdi6_!!6000000000532-2-tps-1280-256.png">
+  <img alt="Page Agent Banner" src="https://img.alicdn.com/imgextra/i1/O1CN01NCMKXj1Gn4tkFTsxf_!!6000000000666-2-tps-1280-256.png">
+</picture>
 
-[![npm version](https://badge.fury.io/js/page-agent.svg)](https://badge.fury.io/js/page-agent) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/) [![Downloads](https://img.shields.io/npm/dt/page-agent.svg)](https://www.npmjs.com/package/page-agent) [![Bundle Size](https://img.shields.io/bundlephobia/minzip/page-agent)](https://bundlephobia.com/package/page-agent) [![GitHub stars](https://img.shields.io/github/stars/alibaba/page-agent.svg)](https://github.com/alibaba/page-agent)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/) [![Downloads](https://img.shields.io/npm/dt/page-agent.svg)](https://www.npmjs.com/package/page-agent) [![Bundle Size](https://img.shields.io/bundlephobia/minzip/page-agent)](https://bundlephobia.com/package/page-agent) [![GitHub stars](https://img.shields.io/github/stars/alibaba/page-agent.svg)](https://github.com/alibaba/page-agent)
 
 纯 JS 实现的 GUI agent。使用自然语言操作你的 Web 应用。无须后端、客户端、浏览器插件。
 
@@ -10,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/141bbb01-8022-4d1f-919d-9efc9a1dc1cf" width="640" crossorigin muted autoplay loop></video>
+<video id="demo-video" src="https://github.com/user-attachments/assets/34d8444d-cbfb-44a3-a24e-fd5c167bb0bf" controls crossorigin muted></video>
 
 ---
 
@@ -28,22 +31,25 @@
 
 ## 🚀 快速开始
 
-### 快速体验 (Demo CDN)
+### 快速体验 (With Testing LLM)
 
 最快的体验方式：
 
 ```html
-<script src="https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.demo.js" crossorigin="true"></script>
+<script
+    src="https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.demo.js"
+    crossorigin="true"
+></script>
 ```
 
 > ⚠️ **仅用于技术评估。** Demo 模型有速率限制和使用限制，生产环境请使用 NPM 方式。
 
-| 位置   | URL                                                                                     |
+| Mirrors | URL                                                                                 |
-| ------ | --------------------------------------------------------------------------------------- |
+| ------- | ----------------------------------------------------------------------------------- |
-| 全球   | https://cdn.jsdelivr.net/npm/@page-agent/cdn/dist/page-agent.demo.js                    |
+| Global  | https://cdn.jsdelivr.net/npm/@page-agent/cdn/dist/page-agent.demo.js                |
-| 中国   | https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.demo.js     |
+| China   | https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.demo.js |
 
-### NPM 安装（推荐）
+### NPM 安装
 
 ```bash
 npm install page-agent
@@ -53,35 +59,16 @@ npm install page-agent
 import { PageAgent } from 'page-agent'
 
 const agent = new PageAgent({
-	model: 'deepseek-chat',
+    model: 'deepseek-chat',
-	baseURL: 'https://api.deepseek.com',
+    baseURL: 'https://api.deepseek.com',
-	apiKey: 'YOUR_API_KEY',
+    apiKey: 'YOUR_API_KEY',
-	language: 'zh-CN',
+    language: 'zh-CN',
 })
 
 await agent.execute('点击登录按钮')
 ```
 
-### CDN 引入
+适用于无法使用 NPM 的环境，我们也提供了 IIFE 构建的 CDN 方式。[@see CDN Usage](https://alibaba.github.io/page-agent/#/docs/integration/cdn-setup)
-
-适用于无法使用 NPM 的环境，用法与 NPM 一致：
-
-```html
-<script src="https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.js" crossorigin="true"></script>
-<script>
-const agent = new PageAgent({
-	model: 'deepseek-chat',
-	baseURL: 'https://api.deepseek.com',
-	apiKey: 'YOUR_API_KEY',
-})
-await agent.execute('点击登录按钮')
-</script>
-```
-
-| 位置   | URL                                                                                 |
-| ------ | ----------------------------------------------------------------------------------- |
-| 全球   | https://cdn.jsdelivr.net/npm/@page-agent/cdn/dist/page-agent.js                     |
-| 中国   | https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.js      |
 
 ## 🏗️ 架构设计
 
@@ -101,28 +88,19 @@ packages/
 
 欢迎社区贡献！以下是参与方式：
 
-### 开发环境
+1. Fork 并 clone。`git clone https://github.com/alibaba/page-agent.git && cd page-agent`
+2. 安装依赖: `npm install`
+3. 启动开发: `npm start`
 
-1. Fork 项目仓库
+更多详情请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
-2. Clone or fork: `git clone https://github.com/alibaba/page-agent.git && cd page-agent`
-3. 安装依赖: `npm install`
-4. 启动开发: `npm start`
 
-### 贡献指南
+请在贡献前阅读我们的[行为准则](CODE_OF_CONDUCT.md)。
-
-请在贡献前阅读我们的[行为准则](CODE_OF_CONDUCT.md)和[贡献指南](CONTRIBUTING.md)。
 
 ## 👏 致谢
 
-本项目基于以下优秀项目构建：
+本项目基于 **[`browser-use`](https://github.com/browser-use/browser-use)** 的优秀工作构建。
 
-- **[browser-use](https://github.com/browser-use/browser-use)**
+`PageAgent` 专为**客户端网页增强**设计，不是服务端自动化工具。
-
-PageAgent 专为**客户端网页增强**设计，不是服务端自动化工具。
-
-## 📄 许可证
-
-MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。
 
 ```
 DOM processing components and prompt are derived from browser-use:
@@ -141,6 +119,10 @@ Third-party dependencies and their licenses can be found in the package.json
 file and in the node_modules directory after installation.
 ```
 
+## 📄 许可证
+
+[MIT License](LICENSE)
+
 ---
 
 **⭐ 如果觉得 PageAgent 有用或有趣，请给项目点个星！**

README.md

@@ -1,8 +1,11 @@
 # PageAgent 🤖🪄
 
-![banner](https://img.alicdn.com/imgextra/i3/O1CN01MyVCS21EoKkIHUT1s_!!6000000000398-49-tps-1280-353.webp)
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://img.alicdn.com/imgextra/i4/O1CN01qKig1P1FnhpFKNdi6_!!6000000000532-2-tps-1280-256.png">
+  <img alt="Page Agent Banner" src="https://img.alicdn.com/imgextra/i1/O1CN01NCMKXj1Gn4tkFTsxf_!!6000000000666-2-tps-1280-256.png">
+</picture>
 
-[![npm version](https://badge.fury.io/js/page-agent.svg)](https://badge.fury.io/js/page-agent) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/) [![Downloads](https://img.shields.io/npm/dt/page-agent.svg)](https://www.npmjs.com/package/page-agent) [![Bundle Size](https://img.shields.io/bundlephobia/minzip/page-agent)](https://bundlephobia.com/package/page-agent) [![GitHub stars](https://img.shields.io/github/stars/alibaba/page-agent.svg)](https://github.com/alibaba/page-agent)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/) [![Downloads](https://img.shields.io/npm/dt/page-agent.svg)](https://www.npmjs.com/package/page-agent) [![Bundle Size](https://img.shields.io/bundlephobia/minzip/page-agent)](https://bundlephobia.com/package/page-agent) [![GitHub stars](https://img.shields.io/github/stars/alibaba/page-agent.svg)](https://github.com/alibaba/page-agent)
 
 The GUI Agent Living in Your Webpage. Control web interfaces with natural language.
 
@@ -10,7 +13,7 @@ The GUI Agent Living in Your Webpage. Control web interfaces with natural langua
 
 👉 <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/de8d1964-8bde-494f-a52f-2975469557a5" width="640" crossorigin muted autoplay loop></video>
+<video id="demo-video" src="https://github.com/user-attachments/assets/34d8444d-cbfb-44a3-a24e-fd5c167bb0bf" controls crossorigin muted></video>
 
 ---
 
@@ -28,22 +31,25 @@ The GUI Agent Living in Your Webpage. Control web interfaces with natural langua
 
 ## 🚀 Quick Start
 
-### Quick Try (Demo CDN)
+### Quick Try (With Testing LLM)
 
 Fastest way to try PageAgent:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/@page-agent/cdn/dist/page-agent.demo.js" crossorigin="true"></script>
+<script
+    src="https://cdn.jsdelivr.net/npm/@page-agent/cdn/dist/page-agent.demo.js"
+    crossorigin="true"
+></script>
 ```
 
 > ⚠️ **For technical evaluation only.** Demo model has rate limits and usage restrictions. Use NPM for production.
 
-| Location | URL                                                                                     |
+| Mirrors | URL                                                                                 |
-| -------- | --------------------------------------------------------------------------------------- |
+| ------- | ----------------------------------------------------------------------------------- |
-| Global   | https://cdn.jsdelivr.net/npm/@page-agent/cdn/dist/page-agent.demo.js                    |
+| Global  | https://cdn.jsdelivr.net/npm/@page-agent/cdn/dist/page-agent.demo.js                |
-| China    | https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.demo.js     |
+| China   | https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.demo.js |
 
-### NPM Installation (Recommended)
+### NPM Installation
 
 ```bash
 npm install page-agent
@@ -53,35 +59,16 @@ npm install page-agent
 import { PageAgent } from 'page-agent'
 
 const agent = new PageAgent({
-	model: 'deepseek-chat',
+    model: 'deepseek-chat',
-	baseURL: 'https://api.deepseek.com',
+    baseURL: 'https://api.deepseek.com',
-	apiKey: 'YOUR_API_KEY',
+    apiKey: 'YOUR_API_KEY',
-	language: 'en-US',
+    language: 'en-US',
 })
 
 await agent.execute('Click the login button')
 ```
 
-### CDN Build
+For environments where NPM is not available. We do offer a IIFE build via CDN. [@see CDN Usage](https://alibaba.github.io/page-agent/#/docs/integration/cdn-setup)
-
-For environments where NPM is not available. Usage is identical to NPM:
-
-```html
-<script src="https://cdn.jsdelivr.net/npm/@page-agent/cdn/dist/page-agent.js" crossorigin="true"></script>
-<script>
-const agent = new PageAgent({
-	model: 'deepseek-chat',
-	baseURL: 'https://api.deepseek.com',
-	apiKey: 'YOUR_API_KEY',
-})
-await agent.execute('Click the login button')
-</script>
-```
-
-| Location | URL                                                                                 |
-| -------- | ----------------------------------------------------------------------------------- |
-| Global   | https://cdn.jsdelivr.net/npm/@page-agent/cdn/dist/page-agent.js                     |
-| China    | https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.js      |
 
 ## 🏗️ Structure
 
@@ -101,28 +88,19 @@ packages/
 
 We welcome contributions from the community! Here's how to get started:
 
-### Setup
+1. Fork and clone. `git clone https://github.com/alibaba/page-agent.git && cd page-agent`
+2. Install dependencies: `npm install`
+3. Start development: `npm start`
 
-1. Fork the repository
+More details in [CONTRIBUTING.md](CONTRIBUTING.md).
-2. Clone your fork: `git clone https://github.com/alibaba/page-agent.git && cd page-agent`
-3. Install dependencies: `npm install`
-4. Start development: `npm start`
 
-### Contributing Guidelines
+Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before contributing.
-
-Please read our [Code of Conduct](CODE_OF_CONDUCT.md) and [Contributing Guide](CONTRIBUTING.md) before contributing.
 
 ## 👏 Acknowledgments
 
-This project builds upon the excellent work of:
+This project builds upon the excellent work of **[`browser-use`](https://github.com/browser-use/browser-use)**.
 
-- **[browser-use](https://github.com/browser-use/browser-use)**
+`PageAgent` is designed for **client-side web enhancement**, not server-side automation.
-
-PageAgent is designed for **client-side web enhancement**, not server-side automation.
-
-## 📄 License
-
-MIT License - see the [LICENSE](LICENSE) file for details.
 
 ```
 DOM processing components and prompt are derived from browser-use:
@@ -141,6 +119,10 @@ Third-party dependencies and their licenses can be found in the package.json
 file and in the node_modules directory after installation.
 ```
 
+## 📄 License
+
+[MIT License](LICENSE)
+
 ---
 
 **⭐ Star this repo if you find PageAgent helpful!**

package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "root",
-	"version": "0.2.2",
+	"version": "0.2.4",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "root",
-			"version": "0.2.2",
+			"version": "0.2.4",
 			"license": "MIT",
 			"workspaces": [
 				"packages/page-controller",
@@ -8133,15 +8133,15 @@
 		},
 		"packages/cdn": {
 			"name": "@page-agent/cdn",
-			"version": "0.2.2",
+			"version": "0.2.4",
 			"license": "MIT",
 			"dependencies": {
-				"page-agent": "0.2.2"
+				"page-agent": "0.2.4"
 			}
 		},
 		"packages/llms": {
 			"name": "@page-agent/llms",
-			"version": "0.2.2",
+			"version": "0.2.4",
 			"license": "MIT",
 			"dependencies": {
 				"chalk": "^5.6.2",
@@ -8149,19 +8149,19 @@
 			}
 		},
 		"packages/page-agent": {
-			"version": "0.2.2",
+			"version": "0.2.4",
 			"license": "MIT",
 			"dependencies": {
-				"@page-agent/llms": "0.2.2",
+				"@page-agent/llms": "0.2.4",
-				"@page-agent/page-controller": "0.2.2",
+				"@page-agent/page-controller": "0.2.4",
-				"@page-agent/ui": "0.2.2",
+				"@page-agent/ui": "0.2.4",
 				"chalk": "^5.6.2",
 				"zod": "^4.3.5"
 			}
 		},
 		"packages/page-controller": {
 			"name": "@page-agent/page-controller",
-			"version": "0.2.2",
+			"version": "0.2.4",
 			"license": "MIT",
 			"dependencies": {
 				"ai-motion": "^0.4.8"
@@ -8169,12 +8169,12 @@
 		},
 		"packages/ui": {
 			"name": "@page-agent/ui",
-			"version": "0.2.2",
+			"version": "0.2.4",
 			"license": "MIT"
 		},
 		"packages/website": {
 			"name": "@page-agent/website",
-			"version": "0.2.2",
+			"version": "0.2.4",
 			"dependencies": {
 				"@radix-ui/react-icons": "^1.3.2",
 				"@radix-ui/react-separator": "^1.1.8",

package.json

@@ -1,7 +1,7 @@
 {
 	"name": "root",
 	"private": true,
-	"version": "0.2.2",
+	"version": "0.2.4",
 	"type": "module",
 	"workspaces": [
 		"packages/page-controller",
@@ -102,6 +102,22 @@
 			".css$"
 		],
 		"importOrderSeparation": true,
-		"importOrderSortSpecifiers": true
+		"importOrderSortSpecifiers": true,
+		"overrides": [
+			{
+				"files": "*.md",
+				"options": {
+					"useTabs": false,
+					"tabWidth": 4
+				}
+			},
+			{
+				"files": "*.json",
+				"options": {
+					"useTabs": false,
+					"tabWidth": 4
+				}
+			}
+		]
 	}
 }

packages/cdn/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@page-agent/cdn",
 	"private": false,
-	"version": "0.2.2",
+	"version": "0.2.4",
 	"type": "module",
 	"files": [
 		"dist/"
@@ -18,6 +18,6 @@
 		"build": "vite build && vite build --mode demo"
 	},
 	"dependencies": {
-		"page-agent": "0.2.2"
+		"page-agent": "0.2.4"
 	}
 }

packages/llms/README.md

@@ -1,41 +0,0 @@
-# @page-agent/llms
-
-LLM client with a **reflection-before-action** mental model for page-agent.
-
-## Why This Package Exists
-
-The LLM module and the agent logic are inherently coupled. This package exists not to decouple them, but to **define the interface contract** between the LLM and the agent.
-
-The core abstraction is the `MacroToolInput` — a structured output format that **forces the model to reflect before acting**.
-
-## The Reflection-Before-Action Model
-
-Every tool call must first output its reasoning state before the actual action:
-
-```typescript
-interface MacroToolInput {
-  // Reflection (mandatory before any action)
-  evaluation_previous_goal?: string  // How well did the previous action work?
-  memory?: string                     // Key information to remember
-  next_goal?: string                  // What to accomplish next
-
-  // Action (the actual operation)
-  action: Record<string, any>
-}
-```
-
-This design ensures that:
-
-1. **The model evaluates its previous action** before deciding the next step
-2. **Working memory is explicitly maintained** across conversation turns
-3. **Goals are clearly stated**, making the agent's reasoning transparent and debuggable
-
-## Key Components
-
-| Export | Description |
-|--------|-------------|
-| `LLM` | Main LLM client class with retry logic |
-| `MacroToolInput` | The reflection-before-action input schema |
-| `AgentBrain` | Agent's thinking state (eval, memory, goal) |
-| `LLMConfig` | Configuration for LLM connection |
-| `parseLLMConfig` | Parse and apply defaults to config |

packages/llms/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@page-agent/llms",
-	"version": "0.2.2",
+	"version": "0.2.4",
 	"type": "module",
 	"main": "./dist/lib/page-agent-llms.js",
 	"module": "./dist/lib/page-agent-llms.js",

packages/llms/tsconfig.dts.json

@@ -1,10 +1,9 @@
 {
-	"extends": "./tsconfig.json",
+    "extends": "./tsconfig.json",
-	"compilerOptions": {
+    "compilerOptions": {
-		// @workaround DTS bug
+        // @workaround DTS bug
-		// dts do not work with monorepo path mapping
+        // dts do not work with monorepo path mapping
-		// disable path mapping for it
+        // disable path mapping for it
-		"paths": {}
+        "paths": {}
-	}
+    }
 }
-

packages/llms/tsconfig.json

@@ -1,13 +1,12 @@
 {
-	"extends": "../../tsconfig.base.json",
+    "extends": "../../tsconfig.base.json",
-	"compilerOptions": {
+    "compilerOptions": {
-		"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
+        "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
-		"noEmit": false,
+        "noEmit": false,
-		"allowImportingTsExtensions": false,
+        "allowImportingTsExtensions": false,
-		"baseUrl": ".",
+        "baseUrl": ".",
-		"outDir": "dist"
+        "outDir": "dist"
-	},
+    },
-	"include": ["**/*.ts"],
+    "include": ["**/*.ts"],
-	"exclude": ["dist", "node_modules"]
+    "exclude": ["dist", "node_modules"]
 }
-

packages/page-agent/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "page-agent",
 	"private": false,
-	"version": "0.2.2",
+	"version": "0.2.4",
 	"type": "module",
 	"main": "./dist/esm/page-agent.js",
 	"module": "./dist/esm/page-agent.js",
@@ -45,8 +45,8 @@
 	"dependencies": {
 		"chalk": "^5.6.2",
 		"zod": "^4.3.5",
-		"@page-agent/llms": "0.2.2",
+		"@page-agent/llms": "0.2.4",
-		"@page-agent/page-controller": "0.2.2",
+		"@page-agent/page-controller": "0.2.4",
-		"@page-agent/ui": "0.2.2"
+		"@page-agent/ui": "0.2.4"
 	}
 }

packages/page-agent/src/PageAgent.ts

@@ -90,9 +90,6 @@ export interface UserTakeoverEvent {
  */
 export type HistoryEvent = AgentStep | ObservationEvent | UserTakeoverEvent
 
-/** @deprecated Use AgentStep instead */
-export type AgentHistory = AgentStep
-
 export interface ExecutionResult {
 	success: boolean
 	data: string

packages/page-agent/src/config/index.ts

@@ -108,14 +108,14 @@ export interface AgentConfig {
 	 * @note PageAgent will try to detect new pages and decide if it's caused by an action. But not very reliable.
 	 * @todo remove `this` binding, pass agent as explicit parameter instead
 	 */
-	onNewPageOpen?: (this: PageAgent, url: string) => Promise<void> | void
+	// onNewPageOpen?: (this: PageAgent, url: string) => Promise<void> | void
 
 	/**
 	 * TODO: @unimplemented
 	 * try to navigate to a new page instead of opening a new tab/window.
 	 * @note will unload the current page when a action tries to open a new page. so that things keep in the same tab/window.
 	 */
-	experimentalPreventNewPage?: boolean
+	// experimentalPreventNewPage?: boolean
 }
 
 export type PageAgentConfig = LLMConfig & AgentConfig & PageControllerConfig

packages/page-agent/src/prompts/.prettierignore

@@ -0,0 +1 @@
+system_prompt.md

packages/page-agent/tsconfig.dts.json

@@ -1,9 +1,9 @@
 {
-	"extends": "./tsconfig.json",
+    "extends": "./tsconfig.json",
-	"compilerOptions": {
+    "compilerOptions": {
-		// @workaround DTS bug
+        // @workaround DTS bug
-		// dts do not work with monorepo path mapping
+        // dts do not work with monorepo path mapping
-		// disable path mapping for it
+        // disable path mapping for it
-		"paths": {}
+        "paths": {}
-	}
+    }
 }

packages/page-agent/tsconfig.json

@@ -1,24 +1,24 @@
 {
-	"extends": "../../tsconfig.base.json",
+    "extends": "../../tsconfig.base.json",
-	"compilerOptions": {
+    "compilerOptions": {
-		"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
+        "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
-		"noEmit": false,
+        "noEmit": false,
-		"allowImportingTsExtensions": false,
+        "allowImportingTsExtensions": false,
-		"baseUrl": ".",
+        "baseUrl": ".",
-		"outDir": "dist",
+        "outDir": "dist",
-		"paths": {
+        "paths": {
-			//
+            //
-			"@page-agent/llms": ["../llms/src/index.ts"],
+            "@page-agent/llms": ["../llms/src/index.ts"],
-			"@page-agent/page-controller": ["../page-controller/src/PageController.ts"],
+            "@page-agent/page-controller": ["../page-controller/src/PageController.ts"],
-			"@page-agent/ui": ["../ui/src/index.ts"]
+            "@page-agent/ui": ["../ui/src/index.ts"]
-		}
+        }
-	},
+    },
-	"include": ["**/*.ts"],
+    "include": ["**/*.ts"],
-	"exclude": ["dist", "node_modules"],
+    "exclude": ["dist", "node_modules"],
-	"references": [
+    "references": [
-		//
+        //
-		{ "path": "../llms" },
+        { "path": "../llms" },
-		{ "path": "../page-controller" },
+        { "path": "../page-controller" },
-		{ "path": "../ui" }
+        { "path": "../ui" }
-	]
+    ]
 }

packages/page-controller/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@page-agent/page-controller",
-	"version": "0.2.2",
+	"version": "0.2.4",
 	"type": "module",
 	"main": "./dist/lib/page-controller.js",
 	"module": "./dist/lib/page-controller.js",

packages/page-controller/tsconfig.dts.json

@@ -1,9 +1,9 @@
 {
-	"extends": "./tsconfig.json",
+    "extends": "./tsconfig.json",
-	"compilerOptions": {
+    "compilerOptions": {
-		// @workaround DTS bug
+        // @workaround DTS bug
-		// dts do not work with monorepo path mapping
+        // dts do not work with monorepo path mapping
-		// disable path mapping for it
+        // disable path mapping for it
-		"paths": {}
+        "paths": {}
-	}
+    }
 }

packages/page-controller/tsconfig.json

@@ -1,12 +1,12 @@
 {
-	"extends": "../../tsconfig.base.json",
+    "extends": "../../tsconfig.base.json",
-	"compilerOptions": {
+    "compilerOptions": {
-		"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
+        "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
-		"noEmit": false,
+        "noEmit": false,
-		"allowImportingTsExtensions": false,
+        "allowImportingTsExtensions": false,
-		"baseUrl": ".",
+        "baseUrl": ".",
-		"outDir": "dist"
+        "outDir": "dist"
-	},
+    },
-	"include": ["**/*.ts", "**/*.js"],
+    "include": ["**/*.ts", "**/*.js"],
-	"exclude": ["dist", "node_modules"]
+    "exclude": ["dist", "node_modules"]
 }

packages/ui/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@page-agent/ui",
-	"version": "0.2.2",
+	"version": "0.2.4",
 	"type": "module",
 	"main": "./dist/lib/page-agent-ui.js",
 	"module": "./dist/lib/page-agent-ui.js",

packages/ui/src/motion-css/readme

@@ -2,4 +2,4 @@ This is the CSS implementation of ai-motion.
 
 Easy to use but Terrible performance. Causing full screen glitching in some browsers.
 
-Use it only in a small area.
+Use it only in a small area.

packages/ui/tsconfig.dts.json

@@ -1,10 +1,9 @@
 {
-	"extends": "./tsconfig.json",
+    "extends": "./tsconfig.json",
-	"compilerOptions": {
+    "compilerOptions": {
-		// @workaround DTS bug
+        // @workaround DTS bug
-		// dts do not work with monorepo path mapping
+        // dts do not work with monorepo path mapping
-		// disable path mapping for it
+        // disable path mapping for it
-		"paths": {}
+        "paths": {}
-	}
+    }
 }
-

packages/ui/tsconfig.json

@@ -1,13 +1,12 @@
 {
-	"extends": "../../tsconfig.base.json",
+    "extends": "../../tsconfig.base.json",
-	"compilerOptions": {
+    "compilerOptions": {
-		"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
+        "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
-		"noEmit": false,
+        "noEmit": false,
-		"allowImportingTsExtensions": false,
+        "allowImportingTsExtensions": false,
-		"baseUrl": ".",
+        "baseUrl": ".",
-		"outDir": "dist"
+        "outDir": "dist"
-	},
+    },
-	"include": ["**/*.ts", "**/*.js"],
+    "include": ["**/*.ts", "**/*.js"],
-	"exclude": ["dist", "node_modules"]
+    "exclude": ["dist", "node_modules"]
 }
-

packages/website/README.md

@@ -1 +0,0 @@
-# Landing Page & Docs

packages/website/components.json

@@ -1,24 +1,24 @@
 {
-  "$schema": "https://ui.shadcn.com/schema.json",
+    "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "new-york",
+    "style": "new-york",
-  "rsc": false,
+    "rsc": false,
-  "tsx": true,
+    "tsx": true,
-  "tailwind": {
+    "tailwind": {
-    "config": "",
+        "config": "",
-    "css": "src/index.css",
+        "css": "src/index.css",
-    "baseColor": "neutral",
+        "baseColor": "neutral",
-    "cssVariables": true,
+        "cssVariables": true,
-    "prefix": ""
+        "prefix": ""
-  },
+    },
-  "iconLibrary": "lucide",
+    "iconLibrary": "lucide",
-  "aliases": {
+    "aliases": {
-    "components": "@/components",
+        "components": "@/components",
-    "utils": "@/lib/utils",
+        "utils": "@/lib/utils",
-    "ui": "@/components/ui",
+        "ui": "@/components/ui",
-    "lib": "@/lib",
+        "lib": "@/lib",
-    "hooks": "@/hooks"
+        "hooks": "@/hooks"
-  },
+    },
-  "registries": {
+    "registries": {
-    "@magicui": "https://magicui.design/r/{name}.json"
+        "@magicui": "https://magicui.design/r/{name}.json"
-  }
+    }
 }

packages/website/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@page-agent/website",
 	"private": true,
-	"version": "0.2.2",
+	"version": "0.2.4",
 	"type": "module",
 	"scripts": {
 		"dev": "vite --host 0.0.0.0",

packages/website/src/components/Header.tsx

@@ -22,7 +22,7 @@ export default function Header() {
 					<div className="flex items-center justify-between gap-2">
 						{/* Logo */}
 						<Link
-							href="/"
+							href="~/"
 							className="flex items-center gap-2 sm:gap-3 group shrink-0"
 							aria-label={t('header.logo_alt')}
 							onClick={() => setMobileMenuOpen(false)}
@@ -55,7 +55,7 @@ export default function Header() {
 							aria-label="Mobile navigation"
 						>
 							<Link
-								href="/docs/introduction/overview"
+								href="~/docs/introduction/overview"
 								className="p-2 rounded-lg text-gray-600 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-800 hover:text-blue-600 dark:hover:text-blue-400 transition-colors duration-200 shrink-0"
 								aria-label={t('header.nav_docs')}
 							>
@@ -89,7 +89,7 @@ export default function Header() {
 								{import.meta.env.VERSION}
 							</span>
 							<Link
-								href="/docs/introduction/overview"
+								href="~/docs/introduction/overview"
 								className="flex items-center gap-1.5 text-gray-600 dark:text-gray-300 hover:text-blue-600 dark:hover:text-blue-400 transition-colors duration-200"
 							>
 								<BookOpen className="w-4 h-4" />
@@ -137,7 +137,7 @@ export default function Header() {
 							role="navigation"
 						>
 							<Link
-								href="/docs/introduction/overview"
+								href="~/docs/introduction/overview"
 								className="flex items-center gap-2 px-3 py-2 rounded-lg text-gray-600 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-800 hover:text-blue-600 dark:hover:text-blue-400 transition-colors duration-200"
 								onClick={() => setMobileMenuOpen(false)}
 							>

packages/website/src/i18n/README.md

@@ -28,9 +28,9 @@ pages/i18n/
 import { useTranslation } from 'react-i18next'
 
 function MyComponent() {
-  const { t } = useTranslation('common') // 指定命名空间
+    const { t } = useTranslation('common') // 指定命名空间
-  
+
-  return <h1>{t('header.nav_docs')}</h1>
+    return <h1>{t('header.nav_docs')}</h1>
 }
 ```
 
@@ -71,4 +71,3 @@ t('common:header.nav_docs')
 - [ ] 文档页翻译（`docs.json`）
 - [ ] DocsLayout 导航结构国际化
 - [ ] 404 页面国际化
-

packages/website/src/pages/Home.tsx

@@ -103,7 +103,7 @@ export default function HomePage() {
 			{/* Hero Section */}
 			<main id="main-content">
 				<section
-					className="relative px-6 py-22 lg:py-28 overflow-hidden"
+					className="relative px-6 py-22 pb-18 lg:py-28 overflow-hidden"
 					aria-labelledby="hero-heading"
 				>
 					<div className="max-w-7xl mx-auto text-center">

packages/website/src/pages/docs/Layout.tsx

@@ -24,38 +24,38 @@ export default function DocsLayout({ children }: DocsLayoutProps) {
 		{
 			title: t('nav.introduction'),
 			items: [
-				{ title: t('nav.overview'), path: '/docs/introduction/overview' },
+				{ title: t('nav.overview'), path: '/introduction/overview' },
-				{ title: t('nav.quick_start'), path: '/docs/introduction/quick-start' },
+				{ title: t('nav.quick_start'), path: '/introduction/quick-start' },
-				{ title: t('nav.limitations'), path: '/docs/introduction/limitations' },
+				{ title: t('nav.limitations'), path: '/introduction/limitations' },
 			],
 		},
 		{
 			title: t('nav.features'),
 			items: [
-				{ title: t('nav.models'), path: '/docs/features/models' },
+				{ title: t('nav.models'), path: '/features/models' },
-				{ title: t('nav.custom_tools'), path: '/docs/features/custom-tools' },
+				{ title: t('nav.custom_tools'), path: '/features/custom-tools' },
-				{ title: t('nav.knowledge_injection'), path: '/docs/features/custom-instructions' },
+				{ title: t('nav.knowledge_injection'), path: '/features/custom-instructions' },
-				{ title: t('nav.data_masking'), path: '/docs/features/data-masking' },
+				{ title: t('nav.data_masking'), path: '/features/data-masking' },
 			],
 		},
 		{
 			title: t('nav.integration'),
 			items: [
-				{ title: t('nav.configuration'), path: '/docs/integration/configuration' },
+				{ title: t('nav.configuration'), path: '/integration/configuration' },
-				{ title: t('nav.third_party_agent'), path: '/docs/integration/third-party-agent' },
+				{ title: t('nav.third_party_agent'), path: '/integration/third-party-agent' },
-				{ title: t('nav.cdn_setup'), path: '/docs/integration/cdn-setup' },
+				{ title: t('nav.cdn_setup'), path: '/integration/cdn-setup' },
 				{
 					title: '🚧 ' + t('nav.security_permissions'),
-					path: '/docs/integration/security-permissions',
+					path: '/integration/security-permissions',
 				},
-				{ title: '🚧 ' + t('nav.best_practices'), path: '/docs/integration/best-practices' },
+				{ title: '🚧 ' + t('nav.best_practices'), path: '/integration/best-practices' },
 			],
 		},
 	]
 
 	return (
 		<div className="max-w-7xl mx-auto px-6 py-8 overflow-x-auto">
-			<div className="flex gap-8 min-w-[900px]">
+			<div className="flex gap-8 min-w-225">
 				{/* Sidebar */}
 				<aside className="w-64 shrink-0" role="complementary" aria-label="文档导航">
 					<div className="sticky">

packages/website/src/pages/docs/index.tsx

@@ -0,0 +1,110 @@
+import { Suspense } from 'react'
+import { Route, Switch } from 'wouter'
+
+import Header from '../../components/Header'
+import DocsLayout from './Layout'
+import Instructions from './features/custom-instructions/page'
+// Features
+import CustomTools from './features/custom-tools/page'
+import DataMasking from './features/data-masking/page'
+import Models from './features/models/page'
+import BestPractices from './integration/best-practices/page'
+// Integration
+import CdnSetup from './integration/cdn-setup/page'
+import Configuration from './integration/configuration/page'
+import SecurityPermissions from './integration/security-permissions/page'
+import ThirdPartyAgent from './integration/third-party-agent/page'
+import Limitations from './introduction/limitations/page'
+// Introduction
+import Overview from './introduction/overview/page'
+import QuickStart from './introduction/quick-start/page'
+
+function DocsPage({ children }: { children: React.ReactNode }) {
+	return (
+		<div className="min-h-screen bg-white dark:bg-gray-900">
+			<Header />
+			<DocsLayout>
+				<Suspense>{children}</Suspense>
+			</DocsLayout>
+		</div>
+	)
+}
+
+export default function DocsRouter() {
+	return (
+		<Switch>
+			{/* Introduction */}
+			<Route path="/introduction/overview">
+				<DocsPage>
+					<Overview />
+				</DocsPage>
+			</Route>
+			<Route path="/introduction/quick-start">
+				<DocsPage>
+					<QuickStart />
+				</DocsPage>
+			</Route>
+			<Route path="/introduction/limitations">
+				<DocsPage>
+					<Limitations />
+				</DocsPage>
+			</Route>
+
+			{/* Features */}
+			<Route path="/features/custom-tools">
+				<DocsPage>
+					<CustomTools />
+				</DocsPage>
+			</Route>
+			<Route path="/features/data-masking">
+				<DocsPage>
+					<DataMasking />
+				</DocsPage>
+			</Route>
+			<Route path="/features/custom-instructions">
+				<DocsPage>
+					<Instructions />
+				</DocsPage>
+			</Route>
+			<Route path="/features/models">
+				<DocsPage>
+					<Models />
+				</DocsPage>
+			</Route>
+
+			{/* Integration */}
+			<Route path="/integration/cdn-setup">
+				<DocsPage>
+					<CdnSetup />
+				</DocsPage>
+			</Route>
+			<Route path="/integration/security-permissions">
+				<DocsPage>
+					<SecurityPermissions />
+				</DocsPage>
+			</Route>
+			<Route path="/integration/configuration">
+				<DocsPage>
+					<Configuration />
+				</DocsPage>
+			</Route>
+			<Route path="/integration/best-practices">
+				<DocsPage>
+					<BestPractices />
+				</DocsPage>
+			</Route>
+			<Route path="/integration/third-party-agent">
+				<DocsPage>
+					<ThirdPartyAgent />
+				</DocsPage>
+			</Route>
+
+			{/* Default redirect or 404 */}
+			<Route path="/docs">
+				<DocsPage>
+					<Overview />
+				</DocsPage>
+			</Route>
+		</Switch>
+	)
+}

packages/website/src/pages/docs/integration/configuration/page.tsx

@@ -28,15 +28,17 @@ export default function Configuration() {
 					className="mb-4"
 					language="typescript"
 					code={`interface LLMConfig {
-  baseURL?: string
+  baseURL: string
-  apiKey?: string
+  apiKey: string
-  model?: string
+  model: string
+
   temperature?: number
   maxRetries?: number
 
   /**
    * Custom fetch function for LLM API requests.
    * Use this to customize headers, credentials, proxy, etc.
+   * The response should follow OpenAI API format.
    */
   customFetch?: typeof globalThis.fetch
 }`}
@@ -71,12 +73,12 @@ export default function Configuration() {
     getPageInstructions?: (url: string) => string | undefined | null
   }
 
-  // Lifecycle hooks
+  // Lifecycle hooks (with \`this\` bound to PageAgent instance)
-  onBeforeStep?: (stepCnt: number) => Promise<void> | void
+  onBeforeStep?: (this: PageAgent, stepCnt: number) => Promise<void> | void
-  onAfterStep?: (stepCnt: number, history: AgentHistory[]) => Promise<void> | void
+  onAfterStep?: (this: PageAgent, stepCnt: number, history: HistoryEvent[]) => Promise<void> | void
-  onBeforeTask?: () => Promise<void> | void
+  onBeforeTask?: (this: PageAgent) => Promise<void> | void
-  onAfterTask?: (result: ExecutionResult) => Promise<void> | void
+  onAfterTask?: (this: PageAgent, result: ExecutionResult) => Promise<void> | void
-  onDispose?: (reason?: string) => void
+  onDispose?: (this: PageAgent, reason?: string) => void
 
   /**
    * Transform page content before sending to LLM.
@@ -103,7 +105,7 @@ export default function Configuration() {
 				<CodeEditor
 					className="mb-4"
 					language="typescript"
-					code={`interface PageControllerConfig {
+					code={`interface DomConfig {
   /** Elements to exclude from interaction */
   interactiveBlacklist?: (Element | (() => Element))[]
 
@@ -118,15 +120,13 @@ export default function Configuration() {
 
   /** Highlight label opacity (0-1) */
   highlightLabelOpacity?: number
+}
 
-  /** Viewport expansion in pixels (-1 for full page) */
+interface PageControllerConfig extends DomConfig {
+  /** Viewport expansion in pixels */
   viewportExpansion?: number
 
-  /**
+  /** Enable visual mask overlay during operations (default: false) */
-   * Enable visual mask overlay during automation.
-   * Blocks user interaction while agent is running.
-   * Default: false for PageController, true for PageAgent.
-   */
   enableMask?: boolean
 }`}
 				/>

packages/website/src/pages/docs/introduction/overview/page.tsx

@@ -22,13 +22,6 @@ export default function Overview() {
 
 				{/* Status Badges */}
 				<div className="flex flex-wrap gap-2 items-center">
-					<a
-						href="https://www.npmjs.com/package/page-agent"
-						target="_blank"
-						rel="noopener noreferrer"
-					>
-						<img src="https://badge.fury.io/js/page-agent.svg" alt="npm version" />
-					</a>
 					<a href="https://opensource.org/licenses/MIT" target="_blank" rel="noopener noreferrer">
 						<img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT License" />
 					</a>

packages/website/src/router.tsx

@@ -1,37 +1,9 @@
 import { Suspense, lazy } from 'react'
 import { Route, Switch } from 'wouter'
 
-import Header from './components/Header'
-import DocsLayout from './pages/docs/Layout'
-
 // Lazy load pages
 const HomePage = lazy(() => import('./pages/Home'))
-// Introduction
+const DocsPages = lazy(() => import('./pages/docs/index'))
-const Overview = lazy(() => import('./pages/docs/introduction/overview/page'))
-const QuickStart = lazy(() => import('./pages/docs/introduction/quick-start/page'))
-const Limitations = lazy(() => import('./pages/docs/introduction/limitations/page'))
-// Features
-const CustomTools = lazy(() => import('./pages/docs/features/custom-tools/page'))
-const DataMasking = lazy(() => import('./pages/docs/features/data-masking/page'))
-const Instructions = lazy(() => import('./pages/docs/features/custom-instructions/page'))
-const Models = lazy(() => import('./pages/docs/features/models/page'))
-// Integration
-const CdnSetup = lazy(() => import('./pages/docs/integration/cdn-setup/page'))
-const SecurityPermissions = lazy(() => import('./pages/docs/integration/security-permissions/page'))
-const Configuration = lazy(() => import('./pages/docs/integration/configuration/page'))
-const BestPractices = lazy(() => import('./pages/docs/integration/best-practices/page'))
-const ThirdPartyAgent = lazy(() => import('./pages/docs/integration/third-party-agent/page'))
-
-function DocsPage({ children }: { children: React.ReactNode }) {
-	return (
-		<div className="min-h-screen bg-white dark:bg-gray-900">
-			<Header />
-			<DocsLayout>
-				<Suspense>{children}</Suspense>
-			</DocsLayout>
-		</div>
-	)
-}
 
 export default function Router() {
 	return (
@@ -42,70 +14,9 @@ export default function Router() {
 					<HomePage />
 				</Route>
 
-				{/* Introduction */}
+				{/* All docs pages */}
-				<Route path="/docs/introduction/overview">
+				<Route path="/docs" nest>
-					<DocsPage>
+					<DocsPages />
-						<Overview />
-					</DocsPage>
-				</Route>
-				<Route path="/docs/introduction/quick-start">
-					<DocsPage>
-						<QuickStart />
-					</DocsPage>
-				</Route>
-				<Route path="/docs/introduction/limitations">
-					<DocsPage>
-						<Limitations />
-					</DocsPage>
-				</Route>
-
-				{/* Features */}
-				<Route path="/docs/features/custom-tools">
-					<DocsPage>
-						<CustomTools />
-					</DocsPage>
-				</Route>
-				<Route path="/docs/features/data-masking">
-					<DocsPage>
-						<DataMasking />
-					</DocsPage>
-				</Route>
-				<Route path="/docs/features/custom-instructions">
-					<DocsPage>
-						<Instructions />
-					</DocsPage>
-				</Route>
-				<Route path="/docs/features/models">
-					<DocsPage>
-						<Models />
-					</DocsPage>
-				</Route>
-
-				{/* Integration */}
-				<Route path="/docs/integration/cdn-setup">
-					<DocsPage>
-						<CdnSetup />
-					</DocsPage>
-				</Route>
-				<Route path="/docs/integration/security-permissions">
-					<DocsPage>
-						<SecurityPermissions />
-					</DocsPage>
-				</Route>
-				<Route path="/docs/integration/configuration">
-					<DocsPage>
-						<Configuration />
-					</DocsPage>
-				</Route>
-				<Route path="/docs/integration/best-practices">
-					<DocsPage>
-						<BestPractices />
-					</DocsPage>
-				</Route>
-				<Route path="/docs/integration/third-party-agent">
-					<DocsPage>
-						<ThirdPartyAgent />
-					</DocsPage>
 				</Route>
 
 				{/* 404 */}

packages/website/tsconfig.json

@@ -1,29 +1,29 @@
 {
-	"extends": "../../tsconfig.base.json",
+    "extends": "../../tsconfig.base.json",
-	"compilerOptions": {
+    "compilerOptions": {
-		"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
+        "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
-		"noEmit": false,
+        "noEmit": false,
-		"allowImportingTsExtensions": false,
+        "allowImportingTsExtensions": false,
-		"baseUrl": ".",
+        "baseUrl": ".",
-		"outDir": "dist",
+        "outDir": "dist",
-		"paths": {
+        "paths": {
-			// Self root
+            // Self root
-			"@/*": ["src/*"],
+            "@/*": ["src/*"],
 
-			// Simplified monorepo solution (raw npm workspace with hoisting)
+            // Simplified monorepo solution (raw npm workspace with hoisting)
-			"page-agent": ["../page-agent/src/PageAgent.ts"],
+            "page-agent": ["../page-agent/src/PageAgent.ts"],
-			"@page-agent/llms": ["../llms/src/index.ts"],
+            "@page-agent/llms": ["../llms/src/index.ts"],
-			"@page-agent/page-controller": ["../page-controller/src/PageController.ts"],
+            "@page-agent/page-controller": ["../page-controller/src/PageController.ts"],
-			"@page-agent/ui": ["../ui/src/index.ts"]
+            "@page-agent/ui": ["../ui/src/index.ts"]
-		}
+        }
-	},
+    },
-	"include": ["**/*.ts", "**/*.tsx"],
+    "include": ["**/*.ts", "**/*.tsx"],
-	"exclude": ["dist", "node_modules"],
+    "exclude": ["dist", "node_modules"],
-	"references": [
+    "references": [
-		//
+        //
-		{ "path": "../llms" },
+        { "path": "../llms" },
-		{ "path": "../page-agent" },
+        { "path": "../page-agent" },
-		{ "path": "../page-controller" },
+        { "path": "../page-controller" },
-		{ "path": "../ui" }
+        { "path": "../ui" }
-	]
+    ]
 }

tsconfig.base.json

@@ -1,47 +1,47 @@
 {
-	"compilerOptions": {
+    "compilerOptions": {
-		"composite": true,
+        "composite": true,
-		"target": "ES2024",
+        "target": "ES2024",
-		"useDefineForClassFields": true,
+        "useDefineForClassFields": true,
-		"lib": ["ES2024", "DOM", "DOM.Iterable"],
+        "lib": ["ES2024", "DOM", "DOM.Iterable"],
-		"module": "ESNext",
+        "module": "ESNext",
-		"skipLibCheck": true,
+        "skipLibCheck": true,
-		"allowJs": true,
+        "allowJs": true,
 
-		// "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
+        // "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
-		// "baseUrl": "src",
+        // "baseUrl": "src",
-		"baseUrl": ".",
+        "baseUrl": ".",
-		"outDir": "dist",
+        "outDir": "dist",
-		// "incremental": true,
+        // "incremental": true,
 
-		/* Bundler mode */
+        /* Bundler mode */
-		"moduleResolution": "bundler",
+        "moduleResolution": "bundler",
-		"verbatimModuleSyntax": false,
+        "verbatimModuleSyntax": false,
-		"noEmit": true,
+        "noEmit": true,
-		"jsx": "react-jsx",
+        "jsx": "react-jsx",
-		"allowImportingTsExtensions": true,
+        "allowImportingTsExtensions": true,
 
-		/* Linting */
+        /* Linting */
-		"strict": true,
+        "strict": true,
-		"noUnusedLocals": false,
+        "noUnusedLocals": false,
-		"noUnusedParameters": false,
+        "noUnusedParameters": false,
-		"erasableSyntaxOnly": true,
+        "erasableSyntaxOnly": true,
-		"noFallthroughCasesInSwitch": true,
+        "noFallthroughCasesInSwitch": true,
-		"noUncheckedSideEffectImports": true
+        "noUncheckedSideEffectImports": true
 
-		// "paths": {
+        // "paths": {
-		// 	// Simplified monorepo solution (raw npm workspace with hoisting)
+        // 	// Simplified monorepo solution (raw npm workspace with hoisting)
-		// 	"@page-agent/page-controller": ["./packages/page-controller/src/PageController.ts"],
+        // 	"@page-agent/page-controller": ["./packages/page-controller/src/PageController.ts"],
-		// 	"page-agent": ["./packages/page-agent/src/PageAgent.ts"]
+        // 	"page-agent": ["./packages/page-agent/src/PageAgent.ts"]
-		// }
+        // }
-	}
+    }
-	// "references": [
+    // "references": [
-	// 	{ "path": "./packages/page-controller" },
+    // 	{ "path": "./packages/page-controller" },
-	// 	{ "path": "./packages/page-agent" },
+    // 	{ "path": "./packages/page-agent" },
-	// 	{ "path": "./packages/website" }
+    // 	{ "path": "./packages/website" }
-	// ],
+    // ],
-	// "include": ["packages/*/src/**/*.ts", "packages/*/src/**/*.tsx"],
+    // "include": ["packages/*/src/**/*.ts", "packages/*/src/**/*.tsx"],
-	// "exclude": ["node_modules", "dist", "packages/*/dist"]
+    // "exclude": ["node_modules", "dist", "packages/*/dist"]
-	// "files": ["env.d.ts"]
+    // "files": ["env.d.ts"]
-	// "files": []
+    // "files": []
 }

tsconfig.json

@@ -1,12 +1,12 @@
 {
-	"extends": "./tsconfig.base.json",
+    "extends": "./tsconfig.base.json",
-	"references": [
+    "references": [
-		{ "path": "./packages/page-controller" },
+        { "path": "./packages/page-controller" },
-		{ "path": "./packages/ui" },
+        { "path": "./packages/ui" },
-		{ "path": "./packages/llms" },
+        { "path": "./packages/llms" },
-		{ "path": "./packages/page-agent" },
+        { "path": "./packages/page-agent" },
-		{ "path": "./packages/website" }
+        { "path": "./packages/website" }
-	],
+    ],
-	"include": ["packages/*/src/**/*.ts", "packages/*/src/**/*.tsx"],
+    "include": ["packages/*/src/**/*.ts", "packages/*/src/**/*.tsx"],
-	"exclude": ["node_modules", "dist", "packages/*/dist"]
+    "exclude": ["node_modules", "dist", "packages/*/dist"]
 }