chore(version): bump version to 1.0.0-beta.2

chore(deps-dev): bump the development-dependencies group with 6 updates

.gitignore

@@ -25,11 +25,15 @@ dist-ssr
 *.sw?
 .qoder
 
-
+# env files
-# 
 .env
+.env.*
 
 # Copied files for npm publish (generated by prepublishOnly)
 packages/page-agent/README.md
 packages/page-agent/README-zh.md
 packages/page-agent/LICENSE
+
+# extension
+.output
+.wxt

.vscode/settings.json

@@ -6,6 +6,7 @@
         "HITL",
         "innerhtml",
         "llms",
+        "npmmirror",
         "onwarn",
         "opensource",
         "qwen",

AGENTS.md

@@ -72,28 +72,14 @@ const pageInfo = await this.pageController.getPageInfo()
 3. **LLM Processing**: AI returns action plans (page-agent)
 4. **Indexed Operations**: PageAgent calls PageController by element index
 
-### IIFE Builds (`packages/page-agent/dist/iife/`)
-
-Two IIFE builds for script tag usage:
-
-| Build | File                 | Description                      |
-| ----- | -------------------- | -------------------------------- |
-| Demo  | `page-agent.demo.js` | Auto-init with built-in test API |
-| Full  | `page-agent.js`      | Exposes `PageAgent` class only   |
-
-Demo build supports query params (e.g., `?model=gpt-4&lang=en-US`).
-
-Build with `npm run build:iife --workspace=page-agent`.
-
 ## Key Files Reference
 
 ### Page Agent (`packages/page-agent/`)
 
 | File               | Description                                  |
-| ------------------------ | -------------------------------------------- |
+| ------------------ | -------------------------------------------- |
 | `src/PageAgent.ts` | ⭐ Main class with UI, extends PageAgentCore |
-| `src/entry-iife.ts`      | IIFE entry (exposes PageAgent class)         |
+| `src/demo.ts`      | IIFE demo entry (auto-init with demo API)    |
-| `src/entry-iife-demo.ts` | IIFE demo entry (auto-init with demo API)    |
 
 ### Core (`packages/core/`)
 

CONTRIBUTING.md

@@ -122,13 +122,13 @@ npm start
 - Start and serve a local `iife` script
 
     ```bash
-    npm run dev:iife # Serving IIFE with auto rebuild at http://localhost:5174/page-agent.js
+    npm run dev:demo # Serving IIFE with auto rebuild at http://localhost:5174/page-agent.demo.js
     ```
 
 - Add a new bookmark
 
     ```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.demo.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

@@ -37,7 +37,7 @@
 
 ```html
 <script
-    src="https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.demo.js"
+    src="https://registry.npmmirror.com/page-agent/1.0.0-beta.2/files/dist/iife/page-agent.demo.js"
     crossorigin="true"
 ></script>
 ```
@@ -45,9 +45,9 @@
 > ⚠️ **仅用于技术评估。** Demo 模型有速率限制和使用限制，生产环境请使用 NPM 方式。
 
 | 镜像   | URL                                                                                       |
-| ------ | ----------------------------------------------------------------------------------- |
+| ------ | ----------------------------------------------------------------------------------------- |
-| Global | https://cdn.jsdelivr.net/npm/page-agent/dist/iife/page-agent.demo.js                |
+| Global | https://cdn.jsdelivr.net/npm/page-agent@1.0.0-beta.2/dist/iife/page-agent.demo.js         |
-| China  | https://registry.npmmirror.com/page-agent/latest/files/dist/iife/page-agent.demo.js |
+| China  | https://registry.npmmirror.com/page-agent/1.0.0-beta.2/files/dist/iife/page-agent.demo.js |
 
 ### NPM 安装
 

README.md

@@ -37,7 +37,7 @@ Fastest way to try PageAgent:
 
 ```html
 <script
-    src="https://cdn.jsdelivr.net/npm/page-agent/dist/iife/page-agent.demo.js"
+    src="https://cdn.jsdelivr.net/npm/page-agent@1.0.0-beta.2/dist/iife/page-agent.demo.js"
     crossorigin="true"
 ></script>
 ```
@@ -45,9 +45,9 @@ Fastest way to try PageAgent:
 > ⚠️ **For technical evaluation only.** Demo model has rate limits and usage restrictions. Use NPM for production.
 
 | Mirrors | URL                                                                                       |
-| ------- | ----------------------------------------------------------------------------------- |
+| ------- | ----------------------------------------------------------------------------------------- |
-| Global  | https://cdn.jsdelivr.net/npm/page-agent/dist/iife/page-agent.demo.js                |
+| Global  | https://cdn.jsdelivr.net/npm/page-agent@1.0.0-beta.2/dist/iife/page-agent.demo.js         |
-| China   | https://registry.npmmirror.com/page-agent/latest/files/dist/iife/page-agent.demo.js |
+| China   | https://registry.npmmirror.com/page-agent/1.0.0-beta.2/files/dist/iife/page-agent.demo.js |
 
 ### NPM Installation
 

package-lock.json

@@ -1,12 +1,12 @@
 {
     "name": "root",
-	"version": "1.0.0-beta.1",
+    "version": "1.0.0-beta.2",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "root",
-			"version": "1.0.0-beta.1",
+            "version": "1.0.0-beta.2",
             "license": "MIT",
             "workspaces": [
                 "packages/page-controller",
@@ -22,21 +22,21 @@
                 "@eslint/js": "^9.39.2",
                 "@microsoft/api-extractor": "^7.55.2",
                 "@trivago/prettier-plugin-sort-imports": "^6.0.2",
-				"@types/node": "^25.0.7",
+                "@types/node": "^25.0.9",
                 "concurrently": "^9.2.1",
                 "dotenv": "^17.2.3",
                 "eslint": "^9.39.2",
                 "eslint-config-prettier": "^10.1.8",
-				"eslint-plugin-react-dom": "^2.5.7",
+                "eslint-plugin-react-dom": "^2.7.2",
                 "eslint-plugin-react-hooks": "^7.0.1",
                 "eslint-plugin-react-refresh": "^0.4.26",
-				"eslint-plugin-react-x": "^2.5.7",
+                "eslint-plugin-react-x": "^2.7.2",
                 "globals": "^17.0.0",
                 "husky": "^9.1.7",
                 "lint-staged": "^16.2.4",
-				"prettier": "^3.7.4",
+                "prettier": "^3.8.0",
                 "typescript": "^5.9.3",
-				"typescript-eslint": "^8.53.0",
+                "typescript-eslint": "^8.53.1",
                 "unplugin-dts": "^1.0.0-beta.6",
                 "vite": "^7.3.1",
                 "vite-plugin-css-injected-by-js": "^3.5.2"
@@ -1058,13 +1058,13 @@
             }
         },
         "node_modules/@eslint-react/ast": {
-			"version": "2.5.7",
+            "version": "2.7.2",
-			"resolved": "https://registry.npmjs.org/@eslint-react/ast/-/ast-2.5.7.tgz",
+            "resolved": "https://registry.npmjs.org/@eslint-react/ast/-/ast-2.7.2.tgz",
-			"integrity": "sha512-yQvKvyIzo9DPKFUOtFSEfpX0He763G1jFf/LQcIY9xoSOWP9pQ2X8ADNE6ZnmIc0L5zZLQ9nF/H0+MGh2NF3fA==",
+            "integrity": "sha512-RB8AVNjboN6/md9Da4rUG4WqxLT+DqUR+qXIR6iAD0+xxp6Dtihu541+lKLZ3GCstunbBcDwu7gdhSbz+BHSuQ==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@eslint-react/eff": "2.5.7",
+                "@eslint-react/eff": "2.7.2",
                 "@typescript-eslint/types": "^8.53.0",
                 "@typescript-eslint/typescript-estree": "^8.53.0",
                 "@typescript-eslint/utils": "^8.53.0",
@@ -1079,16 +1079,16 @@
             }
         },
         "node_modules/@eslint-react/core": {
-			"version": "2.5.7",
+            "version": "2.7.2",
-			"resolved": "https://registry.npmjs.org/@eslint-react/core/-/core-2.5.7.tgz",
+            "resolved": "https://registry.npmjs.org/@eslint-react/core/-/core-2.7.2.tgz",
-			"integrity": "sha512-LqY4YV4Z/uiymdy2OLXkjsEVnoDjoFsxJZI4GWsZ9aBgGWYAsuoKKUG0bdMLp1U9jwMaY0OY9bYgBB5R1ANkoQ==",
+            "integrity": "sha512-QOYh8OWwUGMYLhuvb8WcmoS2jYXb0SJbpX+Ozk+Ht2G9XGRAahl+8PDy/o2l2lLnFXv5JQGfLrN+m2WPTi104g==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@eslint-react/ast": "2.5.7",
+                "@eslint-react/ast": "2.7.2",
-				"@eslint-react/eff": "2.5.7",
+                "@eslint-react/eff": "2.7.2",
-				"@eslint-react/shared": "2.5.7",
+                "@eslint-react/shared": "2.7.2",
-				"@eslint-react/var": "2.5.7",
+                "@eslint-react/var": "2.7.2",
                 "@typescript-eslint/scope-manager": "^8.53.0",
                 "@typescript-eslint/types": "^8.53.0",
                 "@typescript-eslint/utils": "^8.53.0",
@@ -1104,9 +1104,9 @@
             }
         },
         "node_modules/@eslint-react/eff": {
-			"version": "2.5.7",
+            "version": "2.7.2",
-			"resolved": "https://registry.npmjs.org/@eslint-react/eff/-/eff-2.5.7.tgz",
+            "resolved": "https://registry.npmjs.org/@eslint-react/eff/-/eff-2.7.2.tgz",
-			"integrity": "sha512-oxd8eP+dykyOUmQUEItnOZhitlKyo9yFq8Ne0k9+CJeV0Pk1db1+lNcDWswWYoeb1IFEloqHo6y63fVxQXvJew==",
+            "integrity": "sha512-AzQGbidoI8g8izka/1H9xCKW56NR7xWGGPMccBCUZwbCoJZ4wyRKcE10E7ot7LwBv5kBoUQp3GJ9UXCcg/Er0w==",
             "dev": true,
             "license": "MIT",
             "engines": {
@@ -1114,16 +1114,16 @@
             }
         },
         "node_modules/@eslint-react/shared": {
-			"version": "2.5.7",
+            "version": "2.7.2",
-			"resolved": "https://registry.npmjs.org/@eslint-react/shared/-/shared-2.5.7.tgz",
+            "resolved": "https://registry.npmjs.org/@eslint-react/shared/-/shared-2.7.2.tgz",
-			"integrity": "sha512-ZjKO3rNDoLN2ZTn3PxmMcgoASPNiL3umK1BHQvYwCXqqnXlLEouu7sxK6htOvDu1NC+Dbwsqpu4JGUY7t0XQTw==",
+            "integrity": "sha512-U1H3dLaTj7kvEbyJyJEgn6xX3BmrCH1f9f+tg9gLWlN7askgWT5NF56wfX1l+jtwiEAZD/78W1TfICKkMnZDxQ==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@eslint-react/eff": "2.5.7",
+                "@eslint-react/eff": "2.7.2",
                 "@typescript-eslint/utils": "^8.53.0",
                 "ts-pattern": "^5.9.0",
-				"zod": "^4.3.5"
+                "zod": "^3.25.0 || ^4.0.0"
             },
             "engines": {
                 "node": ">=20.19.0"
@@ -1134,14 +1134,14 @@
             }
         },
         "node_modules/@eslint-react/var": {
-			"version": "2.5.7",
+            "version": "2.7.2",
-			"resolved": "https://registry.npmjs.org/@eslint-react/var/-/var-2.5.7.tgz",
+            "resolved": "https://registry.npmjs.org/@eslint-react/var/-/var-2.7.2.tgz",
-			"integrity": "sha512-VWoyZENbK+OV70s/sE9E6T4HD0WO6lsg2CnYjjpKBKBDOBW67SRdIlM7dUPKzqQKsj6p4yNh59eQ5iKaH82LLg==",
+            "integrity": "sha512-sPnXmikpzmAdIWh6lqqKm4Bu0ypKTCAQ7WxGuR5ejxtrA/HjQQuKMBIyPkBdjHWlF9ADdh9pKuo1j2RQwUWiqA==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@eslint-react/ast": "2.5.7",
+                "@eslint-react/ast": "2.7.2",
-				"@eslint-react/eff": "2.5.7",
+                "@eslint-react/eff": "2.7.2",
                 "@typescript-eslint/scope-manager": "^8.53.0",
                 "@typescript-eslint/types": "^8.53.0",
                 "@typescript-eslint/utils": "^8.53.0",
@@ -3547,9 +3547,9 @@
             "license": "MIT"
         },
         "node_modules/@types/node": {
-			"version": "25.0.7",
+            "version": "25.0.9",
-			"resolved": "https://registry.npmjs.org/@types/node/-/node-25.0.7.tgz",
+            "resolved": "https://registry.npmjs.org/@types/node/-/node-25.0.9.tgz",
-			"integrity": "sha512-C/er7DlIZgRJO7WtTdYovjIFzGsz0I95UlMyR9anTb4aCpBSRWe5Jc1/RvLKUfzmOxHPGjSE5+63HgLtndxU4w==",
+            "integrity": "sha512-/rpCXHlCWeqClNBwUhDcusJxXYDjZTyE8v5oTO7WbL8eij2nKhUeU89/6xgjU7N4/Vh3He0BtyhJdQbDyhiXAw==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
@@ -3577,17 +3577,17 @@
             }
         },
         "node_modules/@typescript-eslint/eslint-plugin": {
-			"version": "8.53.0",
+            "version": "8.53.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.53.0.tgz",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.53.1.tgz",
-			"integrity": "sha512-eEXsVvLPu8Z4PkFibtuFJLJOTAV/nPdgtSjkGoPpddpFk3/ym2oy97jynY6ic2m6+nc5M8SE1e9v/mHKsulcJg==",
+            "integrity": "sha512-cFYYFZ+oQFi6hUnBTbLRXfTJiaQtYE3t4O692agbBl+2Zy+eqSKWtPjhPXJu1G7j4RLjKgeJPDdq3EqOwmX5Ag==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
                 "@eslint-community/regexpp": "^4.12.2",
-				"@typescript-eslint/scope-manager": "8.53.0",
+                "@typescript-eslint/scope-manager": "8.53.1",
-				"@typescript-eslint/type-utils": "8.53.0",
+                "@typescript-eslint/type-utils": "8.53.1",
-				"@typescript-eslint/utils": "8.53.0",
+                "@typescript-eslint/utils": "8.53.1",
-				"@typescript-eslint/visitor-keys": "8.53.0",
+                "@typescript-eslint/visitor-keys": "8.53.1",
                 "ignore": "^7.0.5",
                 "natural-compare": "^1.4.0",
                 "ts-api-utils": "^2.4.0"
@@ -3600,7 +3600,7 @@
                 "url": "https://opencollective.com/typescript-eslint"
             },
             "peerDependencies": {
-				"@typescript-eslint/parser": "^8.53.0",
+                "@typescript-eslint/parser": "^8.53.1",
                 "eslint": "^8.57.0 || ^9.0.0",
                 "typescript": ">=4.8.4 <6.0.0"
             }
@@ -3616,16 +3616,16 @@
             }
         },
         "node_modules/@typescript-eslint/parser": {
-			"version": "8.53.0",
+            "version": "8.53.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.53.0.tgz",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.53.1.tgz",
-			"integrity": "sha512-npiaib8XzbjtzS2N4HlqPvlpxpmZ14FjSJrteZpPxGUaYPlvhzlzUZ4mZyABo0EFrOWnvyd0Xxroq//hKhtAWg==",
+            "integrity": "sha512-nm3cvFN9SqZGXjmw5bZ6cGmvJSyJPn0wU9gHAZZHDnZl2wF9PhHv78Xf06E0MaNk4zLVHL8hb2/c32XvyJOLQg==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@typescript-eslint/scope-manager": "8.53.0",
+                "@typescript-eslint/scope-manager": "8.53.1",
-				"@typescript-eslint/types": "8.53.0",
+                "@typescript-eslint/types": "8.53.1",
-				"@typescript-eslint/typescript-estree": "8.53.0",
+                "@typescript-eslint/typescript-estree": "8.53.1",
-				"@typescript-eslint/visitor-keys": "8.53.0",
+                "@typescript-eslint/visitor-keys": "8.53.1",
                 "debug": "^4.4.3"
             },
             "engines": {
@@ -3641,14 +3641,14 @@
             }
         },
         "node_modules/@typescript-eslint/project-service": {
-			"version": "8.53.0",
+            "version": "8.53.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.53.0.tgz",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.53.1.tgz",
-			"integrity": "sha512-Bl6Gdr7NqkqIP5yP9z1JU///Nmes4Eose6L1HwpuVHwScgDPPuEWbUVhvlZmb8hy0vX9syLk5EGNL700WcBlbg==",
+            "integrity": "sha512-WYC4FB5Ra0xidsmlPb+1SsnaSKPmS3gsjIARwbEkHkoWloQmuzcfypljaJcR78uyLA1h8sHdWWPHSLDI+MtNog==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@typescript-eslint/tsconfig-utils": "^8.53.0",
+                "@typescript-eslint/tsconfig-utils": "^8.53.1",
-				"@typescript-eslint/types": "^8.53.0",
+                "@typescript-eslint/types": "^8.53.1",
                 "debug": "^4.4.3"
             },
             "engines": {
@@ -3663,14 +3663,14 @@
             }
         },
         "node_modules/@typescript-eslint/scope-manager": {
-			"version": "8.53.0",
+            "version": "8.53.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.53.0.tgz",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.53.1.tgz",
-			"integrity": "sha512-kWNj3l01eOGSdVBnfAF2K1BTh06WS0Yet6JUgb9Cmkqaz3Jlu0fdVUjj9UI8gPidBWSMqDIglmEXifSgDT/D0g==",
+            "integrity": "sha512-Lu23yw1uJMFY8cUeq7JlrizAgeQvWugNQzJp8C3x8Eo5Jw5Q2ykMdiiTB9vBVOOUBysMzmRRmUfwFrZuI2C4SQ==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@typescript-eslint/types": "8.53.0",
+                "@typescript-eslint/types": "8.53.1",
-				"@typescript-eslint/visitor-keys": "8.53.0"
+                "@typescript-eslint/visitor-keys": "8.53.1"
             },
             "engines": {
                 "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -3681,9 +3681,9 @@
             }
         },
         "node_modules/@typescript-eslint/tsconfig-utils": {
-			"version": "8.53.0",
+            "version": "8.53.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.53.0.tgz",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.53.1.tgz",
-			"integrity": "sha512-K6Sc0R5GIG6dNoPdOooQ+KtvT5KCKAvTcY8h2rIuul19vxH5OTQk7ArKkd4yTzkw66WnNY0kPPzzcmWA+XRmiA==",
+            "integrity": "sha512-qfvLXS6F6b1y43pnf0pPbXJ+YoXIC7HKg0UGZ27uMIemKMKA6XH2DTxsEDdpdN29D+vHV07x/pnlPNVLhdhWiA==",
             "dev": true,
             "license": "MIT",
             "engines": {
@@ -3698,15 +3698,15 @@
             }
         },
         "node_modules/@typescript-eslint/type-utils": {
-			"version": "8.53.0",
+            "version": "8.53.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.53.0.tgz",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.53.1.tgz",
-			"integrity": "sha512-BBAUhlx7g4SmcLhn8cnbxoxtmS7hcq39xKCgiutL3oNx1TaIp+cny51s8ewnKMpVUKQUGb41RAUWZ9kxYdovuw==",
+            "integrity": "sha512-MOrdtNvyhy0rHyv0ENzub1d4wQYKb2NmIqG7qEqPWFW7Mpy2jzFC3pQ2yKDvirZB7jypm5uGjF2Qqs6OIqu47w==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@typescript-eslint/types": "8.53.0",
+                "@typescript-eslint/types": "8.53.1",
-				"@typescript-eslint/typescript-estree": "8.53.0",
+                "@typescript-eslint/typescript-estree": "8.53.1",
-				"@typescript-eslint/utils": "8.53.0",
+                "@typescript-eslint/utils": "8.53.1",
                 "debug": "^4.4.3",
                 "ts-api-utils": "^2.4.0"
             },
@@ -3723,9 +3723,9 @@
             }
         },
         "node_modules/@typescript-eslint/types": {
-			"version": "8.53.0",
+            "version": "8.53.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.53.0.tgz",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.53.1.tgz",
-			"integrity": "sha512-Bmh9KX31Vlxa13+PqPvt4RzKRN1XORYSLlAE+sO1i28NkisGbTtSLFVB3l7PWdHtR3E0mVMuC7JilWJ99m2HxQ==",
+            "integrity": "sha512-jr/swrr2aRmUAUjW5/zQHbMaui//vQlsZcJKijZf3M26bnmLj8LyZUpj8/Rd6uzaek06OWsqdofN/Thenm5O8A==",
             "dev": true,
             "license": "MIT",
             "engines": {
@@ -3737,16 +3737,16 @@
             }
         },
         "node_modules/@typescript-eslint/typescript-estree": {
-			"version": "8.53.0",
+            "version": "8.53.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.53.0.tgz",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.53.1.tgz",
-			"integrity": "sha512-pw0c0Gdo7Z4xOG987u3nJ8akL9093yEEKv8QTJ+Bhkghj1xyj8cgPaavlr9rq8h7+s6plUJ4QJYw2gCZodqmGw==",
+            "integrity": "sha512-RGlVipGhQAG4GxV1s34O91cxQ/vWiHJTDHbXRr0li2q/BGg3RR/7NM8QDWgkEgrwQYCvmJV9ichIwyoKCQ+DTg==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@typescript-eslint/project-service": "8.53.0",
+                "@typescript-eslint/project-service": "8.53.1",
-				"@typescript-eslint/tsconfig-utils": "8.53.0",
+                "@typescript-eslint/tsconfig-utils": "8.53.1",
-				"@typescript-eslint/types": "8.53.0",
+                "@typescript-eslint/types": "8.53.1",
-				"@typescript-eslint/visitor-keys": "8.53.0",
+                "@typescript-eslint/visitor-keys": "8.53.1",
                 "debug": "^4.4.3",
                 "minimatch": "^9.0.5",
                 "semver": "^7.7.3",
@@ -3791,16 +3791,16 @@
             }
         },
         "node_modules/@typescript-eslint/utils": {
-			"version": "8.53.0",
+            "version": "8.53.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.53.0.tgz",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.53.1.tgz",
-			"integrity": "sha512-XDY4mXTez3Z1iRDI5mbRhH4DFSt46oaIFsLg+Zn97+sYrXACziXSQcSelMybnVZ5pa1P6xYkPr5cMJyunM1ZDA==",
+            "integrity": "sha512-c4bMvGVWW4hv6JmDUEG7fSYlWOl3II2I4ylt0NM+seinYQlZMQIaKaXIIVJWt9Ofh6whrpM+EdDQXKXjNovvrg==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
                 "@eslint-community/eslint-utils": "^4.9.1",
-				"@typescript-eslint/scope-manager": "8.53.0",
+                "@typescript-eslint/scope-manager": "8.53.1",
-				"@typescript-eslint/types": "8.53.0",
+                "@typescript-eslint/types": "8.53.1",
-				"@typescript-eslint/typescript-estree": "8.53.0"
+                "@typescript-eslint/typescript-estree": "8.53.1"
             },
             "engines": {
                 "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -3815,13 +3815,13 @@
             }
         },
         "node_modules/@typescript-eslint/visitor-keys": {
-			"version": "8.53.0",
+            "version": "8.53.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.53.0.tgz",
+            "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.53.1.tgz",
-			"integrity": "sha512-LZ2NqIHFhvFwxG0qZeLL9DvdNAHPGCY5dIRwBhyYeU+LfLhcStE1ImjsuTG/WaVh3XysGaeLW8Rqq7cGkPCFvw==",
+            "integrity": "sha512-oy+wV7xDKFPRyNggmXuZQSBzvoLnpmJs+GhzRhPjrxl2b/jIlyjVokzm47CZCDUdXKr2zd7ZLodPfOBpOPyPlg==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@typescript-eslint/types": "8.53.0",
+                "@typescript-eslint/types": "8.53.1",
                 "eslint-visitor-keys": "^4.2.1"
             },
             "engines": {
@@ -4851,17 +4851,17 @@
             }
         },
         "node_modules/eslint-plugin-react-dom": {
-			"version": "2.5.7",
+            "version": "2.7.2",
-			"resolved": "https://registry.npmjs.org/eslint-plugin-react-dom/-/eslint-plugin-react-dom-2.5.7.tgz",
+            "resolved": "https://registry.npmjs.org/eslint-plugin-react-dom/-/eslint-plugin-react-dom-2.7.2.tgz",
-			"integrity": "sha512-KHCU7KRXeLYlrrXKtInpCqHzt+nYhIGpYIuMM4Q0FyGBOcswRS2Gv9PhN+yQqDI9PRBhnjCuRf+q2Y3ZrYWjsw==",
+            "integrity": "sha512-Qzd4HAFwsxvOJoAycLIRxziOTJwEZ6EGAA6jEFFBSD1BbFVnDlozMvOLp9/+GrZW3cE0FGmAS6QXnjuMf0QYLQ==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@eslint-react/ast": "2.5.7",
+                "@eslint-react/ast": "2.7.2",
-				"@eslint-react/core": "2.5.7",
+                "@eslint-react/core": "2.7.2",
-				"@eslint-react/eff": "2.5.7",
+                "@eslint-react/eff": "2.7.2",
-				"@eslint-react/shared": "2.5.7",
+                "@eslint-react/shared": "2.7.2",
-				"@eslint-react/var": "2.5.7",
+                "@eslint-react/var": "2.7.2",
                 "@typescript-eslint/scope-manager": "^8.53.0",
                 "@typescript-eslint/types": "^8.53.0",
                 "@typescript-eslint/utils": "^8.53.0",
@@ -4908,17 +4908,17 @@
             }
         },
         "node_modules/eslint-plugin-react-x": {
-			"version": "2.5.7",
+            "version": "2.7.2",
-			"resolved": "https://registry.npmjs.org/eslint-plugin-react-x/-/eslint-plugin-react-x-2.5.7.tgz",
+            "resolved": "https://registry.npmjs.org/eslint-plugin-react-x/-/eslint-plugin-react-x-2.7.2.tgz",
-			"integrity": "sha512-EU+h7eUHNg9ikLaGOa0Tjsc/o4FO2KdyT3M97TkQmaKc9tzpcy8nlPQp/czBMbUuxAgbj2495wzOvCZ0fEK4mw==",
+            "integrity": "sha512-0NbYqJhc3tZQVluaFMVCOg6HEFarlNNXe+DHa/JrLAR0PVb9AtJGk8FBEDdxaUZO8ph0sAekUNLB7gymftj4Dw==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@eslint-react/ast": "2.5.7",
+                "@eslint-react/ast": "2.7.2",
-				"@eslint-react/core": "2.5.7",
+                "@eslint-react/core": "2.7.2",
-				"@eslint-react/eff": "2.5.7",
+                "@eslint-react/eff": "2.7.2",
-				"@eslint-react/shared": "2.5.7",
+                "@eslint-react/shared": "2.7.2",
-				"@eslint-react/var": "2.5.7",
+                "@eslint-react/var": "2.7.2",
                 "@typescript-eslint/scope-manager": "^8.53.0",
                 "@typescript-eslint/type-utils": "^8.53.0",
                 "@typescript-eslint/types": "^8.53.0",
@@ -5301,12 +5301,12 @@
             "license": "ISC"
         },
         "node_modules/framer-motion": {
-			"version": "12.26.1",
+            "version": "12.27.1",
-			"resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.26.1.tgz",
+            "resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.27.1.tgz",
-			"integrity": "sha512-Uzc8wGldU4FpmGotthjjcj0SZhigcODjqvKT7lzVZHsmYkzQMFfMIv0vHQoXCeoe/Ahxqp4by4A6QbzFA/lblw==",
+            "integrity": "sha512-cEAqO69kcZt3gL0TGua8WTgRQfv4J57nqt1zxHtLKwYhAwA0x9kDS/JbMa1hJbwkGY74AGJKvZ9pX/IqWZtZWQ==",
             "license": "MIT",
             "dependencies": {
-				"motion-dom": "^12.24.11",
+                "motion-dom": "^12.27.1",
                 "motion-utils": "^12.24.10",
                 "tslib": "^2.4.0"
             },
@@ -6514,12 +6514,12 @@
             }
         },
         "node_modules/motion": {
-			"version": "12.26.1",
+            "version": "12.27.1",
-			"resolved": "https://registry.npmjs.org/motion/-/motion-12.26.1.tgz",
+            "resolved": "https://registry.npmjs.org/motion/-/motion-12.27.1.tgz",
-			"integrity": "sha512-IVhzx9HOQTiJ9ykthMOlZPnLwrkXziN5Q/yebsqBYlFJb2rHP8yhmKc8O/YUT9byPJlxOeqkzfNYCrVKZx8vqg==",
+            "integrity": "sha512-FAZTPDm1LccBdWSL46WLnEdTSHmdVx+fdWK8f61qBQn67MmFefXLXlrwy94rK2DDsd9A50Gj8H+LYCgQ/cQlFg==",
             "license": "MIT",
             "dependencies": {
-				"framer-motion": "^12.26.1",
+                "framer-motion": "^12.27.1",
                 "tslib": "^2.4.0"
             },
             "peerDependencies": {
@@ -6540,9 +6540,9 @@
             }
         },
         "node_modules/motion-dom": {
-			"version": "12.24.11",
+            "version": "12.27.1",
-			"resolved": "https://registry.npmjs.org/motion-dom/-/motion-dom-12.24.11.tgz",
+            "resolved": "https://registry.npmjs.org/motion-dom/-/motion-dom-12.27.1.tgz",
-			"integrity": "sha512-DlWOmsXMJrV8lzZyd+LKjG2CXULUs++bkq8GZ2Sr0R0RRhs30K2wtY+LKiTjhmJU3W61HK+rB0GLz6XmPvTA1A==",
+            "integrity": "sha512-V/53DA2nBqKl9O2PMJleSUb/G0dsMMeZplZwgIQf5+X0bxIu7Q1cTv6DrjvTTGYRm3+7Y5wMlRZ1wT61boU/bQ==",
             "license": "MIT",
             "dependencies": {
                 "motion-utils": "^12.24.10"
@@ -6862,9 +6862,9 @@
             }
         },
         "node_modules/prettier": {
-			"version": "3.7.4",
+            "version": "3.8.0",
-			"resolved": "https://registry.npmjs.org/prettier/-/prettier-3.7.4.tgz",
+            "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.8.0.tgz",
-			"integrity": "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA==",
+            "integrity": "sha512-yEPsovQfpxYfgWNhCfECjG5AQaO+K3dp6XERmOepyPDVqcJm+bjyCVO3pmU+nAPe0N5dDvekfGezt/EIiRe1TA==",
             "dev": true,
             "license": "MIT",
             "bin": {
@@ -6926,9 +6926,9 @@
             }
         },
         "node_modules/react-i18next": {
-			"version": "16.5.2",
+            "version": "16.5.3",
-			"resolved": "https://registry.npmjs.org/react-i18next/-/react-i18next-16.5.2.tgz",
+            "resolved": "https://registry.npmjs.org/react-i18next/-/react-i18next-16.5.3.tgz",
-			"integrity": "sha512-GG/SBVxx9dvrO1uCs8VYdKfOP8NEBUhNP+2VDQLCifRJ8DL1qPq296k2ACNGyZMDe7iyIlz/LMJTQOs8HXSRvw==",
+            "integrity": "sha512-fo+/NNch37zqxOzlBYrWMx0uy/yInPkRfjSuy4lqKdaecR17nvCHnEUt3QyzA8XjQ2B/0iW/5BhaHR3ZmukpGw==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
@@ -7165,9 +7165,9 @@
             }
         },
         "node_modules/simple-icons": {
-			"version": "16.5.0",
+            "version": "16.6.0",
-			"resolved": "https://registry.npmjs.org/simple-icons/-/simple-icons-16.5.0.tgz",
+            "resolved": "https://registry.npmjs.org/simple-icons/-/simple-icons-16.6.0.tgz",
-			"integrity": "sha512-72nn0oHADKx6Hknu7q6M0vfL8LiCUMKABOHane2+4xdqaFBSHfNNBjuZioihiqVQMz7IvVle4NKAM0IlXvl/9A==",
+            "integrity": "sha512-lzSVlAhflhwud7EprwSalbCpHKpculOfaAk1P+S3QajO1bHG5nqwI1VeGnn4rwaE4xSSSKDsOFFL0XfIDv5iIQ==",
             "funding": [
                 {
                     "type": "opencollective",
@@ -7568,16 +7568,16 @@
             }
         },
         "node_modules/typescript-eslint": {
-			"version": "8.53.0",
+            "version": "8.53.1",
-			"resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.53.0.tgz",
+            "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.53.1.tgz",
-			"integrity": "sha512-xHURCQNxZ1dsWn0sdOaOfCSQG0HKeqSj9OexIxrz6ypU6wHYOdX2I3D2b8s8wFSsSOYJb+6q283cLiLlkEsBYw==",
+            "integrity": "sha512-gB+EVQfP5RDElh9ittfXlhZJdjSU4jUSTyE2+ia8CYyNvet4ElfaLlAIqDvQV9JPknKx0jQH1racTYe/4LaLSg==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-				"@typescript-eslint/eslint-plugin": "8.53.0",
+                "@typescript-eslint/eslint-plugin": "8.53.1",
-				"@typescript-eslint/parser": "8.53.0",
+                "@typescript-eslint/parser": "8.53.1",
-				"@typescript-eslint/typescript-estree": "8.53.0",
+                "@typescript-eslint/typescript-estree": "8.53.1",
-				"@typescript-eslint/utils": "8.53.0"
+                "@typescript-eslint/utils": "8.53.1"
             },
             "engines": {
                 "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -8142,18 +8142,18 @@
         },
         "packages/core": {
             "name": "@page-agent/core",
-			"version": "1.0.0-beta.1",
+            "version": "1.0.0-beta.2",
             "license": "MIT",
             "dependencies": {
-				"@page-agent/llms": "1.0.0-beta.1",
+                "@page-agent/llms": "1.0.0-beta.2",
-				"@page-agent/page-controller": "1.0.0-beta.1",
+                "@page-agent/page-controller": "1.0.0-beta.2",
                 "chalk": "^5.6.2",
                 "zod": "^4.3.5"
             }
         },
         "packages/llms": {
             "name": "@page-agent/llms",
-			"version": "1.0.0-beta.1",
+            "version": "1.0.0-beta.2",
             "license": "MIT",
             "dependencies": {
                 "chalk": "^5.6.2",
@@ -8161,20 +8161,20 @@
             }
         },
         "packages/page-agent": {
-			"version": "1.0.0-beta.1",
+            "version": "1.0.0-beta.2",
             "license": "MIT",
             "dependencies": {
-				"@page-agent/core": "1.0.0-beta.1",
+                "@page-agent/core": "1.0.0-beta.2",
-				"@page-agent/llms": "1.0.0-beta.1",
+                "@page-agent/llms": "1.0.0-beta.2",
-				"@page-agent/page-controller": "1.0.0-beta.1",
+                "@page-agent/page-controller": "1.0.0-beta.2",
-				"@page-agent/ui": "1.0.0-beta.1",
+                "@page-agent/ui": "1.0.0-beta.2",
                 "chalk": "^5.6.2",
                 "zod": "^4.3.5"
             }
         },
         "packages/page-controller": {
             "name": "@page-agent/page-controller",
-			"version": "1.0.0-beta.1",
+            "version": "1.0.0-beta.2",
             "license": "MIT",
             "dependencies": {
                 "ai-motion": "^0.4.8"
@@ -8182,12 +8182,12 @@
         },
         "packages/ui": {
             "name": "@page-agent/ui",
-			"version": "1.0.0-beta.1",
+            "version": "1.0.0-beta.2",
             "license": "MIT"
         },
         "packages/website": {
             "name": "@page-agent/website",
-			"version": "1.0.0-beta.1",
+            "version": "1.0.0-beta.2",
             "dependencies": {
                 "@radix-ui/react-icons": "^1.3.2",
                 "@radix-ui/react-separator": "^1.1.8",
@@ -8197,10 +8197,10 @@
                 "class-variance-authority": "^0.7.1",
                 "clsx": "^2.1.1",
                 "lucide-react": "^0.562.0",
-				"motion": "^12.26.1",
+                "motion": "^12.27.1",
                 "next-themes": "^0.4.6",
                 "rough-notation": "^0.5.1",
-				"simple-icons": "^16.5.0",
+                "simple-icons": "^16.6.0",
                 "sonner": "^2.0.7",
                 "tailwind-merge": "^3.4.0"
             },
@@ -8213,7 +8213,7 @@
                 "i18next-browser-languagedetector": "^8.2.0",
                 "react": "^19.2.3",
                 "react-dom": "^19.2.3",
-				"react-i18next": "^16.5.2",
+                "react-i18next": "^16.5.3",
                 "tailwindcss": "^4.1.14",
                 "tw-animate-css": "^1.4.0",
                 "wouter": "^3.9.0"

package.json

@@ -1,7 +1,7 @@
 {
     "name": "root",
     "private": true,
-	"version": "1.0.0-beta.1",
+    "version": "1.0.0-beta.2",
     "type": "module",
     "workspaces": [
         "packages/page-controller",
@@ -29,7 +29,7 @@
         "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:iife": "npm run dev:iife --workspace=page-agent",
+        "dev:demo": "npm run dev:demo --workspace=page-agent",
         "version": "node scripts/sync-version.js",
         "lint": "eslint .",
         "prepare": "husky"
@@ -40,21 +40,21 @@
         "@eslint/js": "^9.39.2",
         "@microsoft/api-extractor": "^7.55.2",
         "@trivago/prettier-plugin-sort-imports": "^6.0.2",
-		"@types/node": "^25.0.7",
+        "@types/node": "^25.0.9",
         "concurrently": "^9.2.1",
         "dotenv": "^17.2.3",
         "eslint": "^9.39.2",
         "eslint-config-prettier": "^10.1.8",
-		"eslint-plugin-react-dom": "^2.5.7",
+        "eslint-plugin-react-dom": "^2.7.2",
         "eslint-plugin-react-hooks": "^7.0.1",
         "eslint-plugin-react-refresh": "^0.4.26",
-		"eslint-plugin-react-x": "^2.5.7",
+        "eslint-plugin-react-x": "^2.7.2",
         "globals": "^17.0.0",
         "husky": "^9.1.7",
         "lint-staged": "^16.2.4",
-		"prettier": "^3.7.4",
+        "prettier": "^3.8.0",
         "typescript": "^5.9.3",
-		"typescript-eslint": "^8.53.0",
+        "typescript-eslint": "^8.53.1",
         "unplugin-dts": "^1.0.0-beta.6",
         "vite": "^7.3.1",
         "vite-plugin-css-injected-by-js": "^3.5.2"

packages/core/package.json

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

packages/core/src/PageAgentCore.ts

@@ -2,7 +2,7 @@
  * Copyright (C) 2025 Alibaba Group Holding Limited
  * All rights reserved.
  */
-import { LLM, type Tool } from '@page-agent/llms'
+import { InvokeError, LLM, type Tool } from '@page-agent/llms'
 import type { PageController } from '@page-agent/page-controller'
 import chalk from 'chalk'
 import zod from 'zod'
@@ -107,7 +107,7 @@ export class PageAgentCore extends EventTarget {
 			this.#emitHistoryChange()
 		})
 		this.#llm.addEventListener('error', (e) => {
-			const { error } = (e as CustomEvent).detail
+			const error = (e as CustomEvent).detail.error as Error | InvokeError
 			const message = String(error)
 			this.emitActivity({ type: 'error', message })
 			// Also push to history for panel rendering
@@ -115,6 +115,7 @@ export class PageAgentCore extends EventTarget {
 				type: 'error',
 				errorType: 'error',
 				message,
+				rawResponse: (error as InvokeError).rawResponse,
 			})
 			this.#emitHistoryChange()
 		})
@@ -265,6 +266,7 @@ export class PageAgentCore extends EventTarget {
 					reflection,
 					action,
 					usage: result.usage,
+					rawResponse: result.rawResponse,
 				} as AgentStep)
 				this.#emitHistoryChange()
 

packages/core/src/types.ts

@@ -48,6 +48,8 @@ export interface AgentStep {
 		cachedTokens?: number
 		reasoningTokens?: number
 	}
+	/** Raw LLM response for debugging */
+	rawResponse?: unknown
 }
 
 /**
@@ -74,6 +76,7 @@ export interface ErrorEvent {
 	message: string
 	attempt?: number
 	maxAttempts?: number
+	rawResponse?: unknown
 }
 
 /**

packages/llms/package.json

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

packages/llms/src/OpenAIClient.ts

@@ -107,14 +107,23 @@ export class OpenAIClient implements LLMClient {
 			case 'length':
 				throw new InvokeError(
 					InvokeErrorType.CONTEXT_LENGTH,
-					'Response truncated: max tokens reached'
+					'Response truncated: max tokens reached',
+					undefined,
+					data
 				)
 			case 'content_filter':
-				throw new InvokeError(InvokeErrorType.CONTENT_FILTER, 'Content filtered by safety system')
+				throw new InvokeError(
+					InvokeErrorType.CONTENT_FILTER,
+					'Content filtered by safety system',
+					undefined,
+					data
+				)
 			default:
 				throw new InvokeError(
 					InvokeErrorType.UNKNOWN,
-					`Unexpected finish_reason: ${choice.finish_reason}`
+					`Unexpected finish_reason: ${choice.finish_reason}`,
+					undefined,
+					data
 				)
 		}
 
@@ -128,7 +137,8 @@ export class OpenAIClient implements LLMClient {
 			throw new InvokeError(
 				InvokeErrorType.NO_TOOL_CALL,
 				'No tool call found in response',
-				normalizedData
+				undefined,
+				data
 			)
 		}
 
@@ -137,7 +147,8 @@ export class OpenAIClient implements LLMClient {
 			throw new InvokeError(
 				InvokeErrorType.UNKNOWN,
 				`Tool "${toolCallName}" not found in tools`,
-				normalizedData
+				undefined,
+				data
 			)
 		}
 
@@ -147,7 +158,8 @@ export class OpenAIClient implements LLMClient {
 			throw new InvokeError(
 				InvokeErrorType.INVALID_TOOL_ARGS,
 				'No tool call arguments found',
-				normalizedData
+				undefined,
+				data
 			)
 		}
 
@@ -158,7 +170,8 @@ export class OpenAIClient implements LLMClient {
 			throw new InvokeError(
 				InvokeErrorType.INVALID_TOOL_ARGS,
 				'Failed to parse tool arguments as JSON',
-				error
+				error,
+				data
 			)
 		}
 
@@ -169,7 +182,8 @@ export class OpenAIClient implements LLMClient {
 			throw new InvokeError(
 				InvokeErrorType.INVALID_TOOL_ARGS,
 				'Tool arguments validation failed',
-				validation.error
+				validation.error,
+				data
 			)
 		}
 		const toolInput = validation.data
@@ -182,7 +196,8 @@ export class OpenAIClient implements LLMClient {
 			throw new InvokeError(
 				InvokeErrorType.TOOL_EXECUTION_ERROR,
 				`Tool execution failed: ${(e as Error).message}`,
-				e
+				e,
+				data
 			)
 		}
 

packages/llms/src/errors.ts

@@ -25,14 +25,18 @@ export class InvokeError extends Error {
 	type: InvokeErrorType
 	retryable: boolean
 	statusCode?: number
+	/* raw error (provided if this error is caused by another error) */
 	rawError?: unknown
+	/* raw response from the API (provided if this error is caused by an API calling) */
+	rawResponse?: unknown
 
-	constructor(type: InvokeErrorType, message: string, rawError?: unknown) {
+	constructor(type: InvokeErrorType, message: string, rawError?: unknown, rawResponse?: unknown) {
 		super(message)
 		this.name = 'InvokeError'
 		this.type = type
 		this.retryable = this.isRetryable(type)
 		this.rawError = rawError
+		this.rawResponse = rawResponse
 	}
 
 	private isRetryable(type: InvokeErrorType): boolean {

packages/llms/src/index.ts

@@ -3,7 +3,7 @@ import { DEFAULT_TEMPERATURE, LLM_MAX_RETRIES } from './constants'
 import { InvokeError } from './errors'
 import type { InvokeOptions, InvokeResult, LLMClient, LLMConfig, Message, Tool } from './types'
 
-export type { InvokeOptions, InvokeResult, LLMClient, LLMConfig, Message, Tool }
+export type { InvokeError, InvokeOptions, InvokeResult, LLMClient, LLMConfig, Message, Tool }
 
 export function parseLLMConfig(config: LLMConfig): Required<LLMConfig> {
 	// Runtime validation as defensive programming (types already guarantee these)

packages/page-agent/package.json

@@ -1,7 +1,7 @@
 {
     "name": "page-agent",
     "private": false,
-	"version": "1.0.0-beta.1",
+    "version": "1.0.0-beta.2",
     "type": "module",
     "main": "./dist/esm/page-agent.js",
     "module": "./dist/esm/page-agent.js",
@@ -46,9 +46,9 @@
     "dependencies": {
         "chalk": "^5.6.2",
         "zod": "^4.3.5",
-		"@page-agent/llms": "1.0.0-beta.1",
+        "@page-agent/llms": "1.0.0-beta.2",
-		"@page-agent/page-controller": "1.0.0-beta.1",
+        "@page-agent/page-controller": "1.0.0-beta.2",
-		"@page-agent/core": "1.0.0-beta.1",
+        "@page-agent/core": "1.0.0-beta.2",
-		"@page-agent/ui": "1.0.0-beta.1"
+        "@page-agent/ui": "1.0.0-beta.2"
     }
 }

packages/page-agent/src/demo.ts

@@ -41,6 +41,7 @@ setTimeout(() => {
 
 	// Create agent
 	window.pageAgent = new PageAgent(config)
+	window.pageAgent.panel.show()
 
 	console.log('🚀 page-agent.js initialized with config:', window.pageAgent.config)
 })

packages/page-controller/package.json

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

packages/ui/package.json

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

packages/website/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@page-agent/website",
     "private": true,
-	"version": "1.0.0-beta.1",
+    "version": "1.0.0-beta.2",
     "type": "module",
     "scripts": {
         "dev": "vite --host 0.0.0.0",
@@ -18,7 +18,7 @@
         "i18next-browser-languagedetector": "^8.2.0",
         "react": "^19.2.3",
         "react-dom": "^19.2.3",
-		"react-i18next": "^16.5.2",
+        "react-i18next": "^16.5.3",
         "tailwindcss": "^4.1.14",
         "tw-animate-css": "^1.4.0",
         "wouter": "^3.9.0"
@@ -32,10 +32,10 @@
         "class-variance-authority": "^0.7.1",
         "clsx": "^2.1.1",
         "lucide-react": "^0.562.0",
-		"motion": "^12.26.1",
+        "motion": "^12.27.1",
         "next-themes": "^0.4.6",
         "rough-notation": "^0.5.1",
-		"simple-icons": "^16.5.0",
+        "simple-icons": "^16.6.0",
         "sonner": "^2.0.7",
         "tailwind-merge": "^3.4.0"
     }

packages/website/src/constants.ts

@@ -1,7 +1,8 @@
 // Demo build (auto-init with demo LLM, for quick testing)
-export const CDN_DEMO_URL = 'https://cdn.jsdelivr.net/npm/page-agent/dist/iife/page-agent.demo.js'
+export const CDN_DEMO_URL =
+	'https://cdn.jsdelivr.net/npm/page-agent@1.0.0-beta.2/dist/iife/page-agent.demo.js'
 export const CDN_DEMO_CN_URL =
-	'https://registry.npmmirror.com/page-agent/latest/files/dist/iife/page-agent.demo.js'
+	'https://registry.npmmirror.com/page-agent/1.0.0-beta.2/files/dist/iife/page-agent.demo.js'
 
 // Demo LLM for website testing
 export const DEMO_MODEL = 'PAGE-AGENT-FREE-TESTING-RANDOM'

scripts/sync-version.js

@@ -9,6 +9,7 @@
 import chalk from 'chalk'
 import { existsSync, readFileSync, readdirSync, writeFileSync } from 'fs'
 import { dirname, join } from 'path'
+import { exit } from 'process'
 import { fileURLToPath } from 'url'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
@@ -17,17 +18,23 @@ const rootDir = join(__dirname, '..')
 // Parse arguments
 const versionArg = process.argv[2]
 
+if (!versionArg) {
+	console.log(chalk.yellow('⚠️  No version specified.\n'))
+	exit(1)
+}
+
 // Read root package.json
 const rootPkgPath = join(rootDir, 'package.json')
 const rootPkg = JSON.parse(readFileSync(rootPkgPath, 'utf-8'))
-const newVersion = versionArg || rootPkg.version
+const oldVersion = rootPkg.version
+const newVersion = versionArg
 
 console.log(chalk.cyan.bold('\n📦 Syncing version\n'))
 
 // Update root package.json if new version specified
 if (versionArg) {
 	rootPkg.version = newVersion
-	writeFileSync(rootPkgPath, JSON.stringify(rootPkg, null, '\t') + '\n')
+	writeFileSync(rootPkgPath, JSON.stringify(rootPkg, null, '    ') + '\n')
 	console.log(chalk.green('✓') + ` ${chalk.bold('root')} → ${chalk.yellow(newVersion)}`)
 } else {
 	console.log(chalk.dim('  root:') + ` ${chalk.yellow(newVersion)} ${chalk.dim('(source)')}`)
@@ -69,7 +76,6 @@ for (const pkg of packages) {
 	if (!existsSync(pkgPath)) continue
 
 	const pkgJson = JSON.parse(readFileSync(pkgPath, 'utf-8'))
-	const oldVersion = pkgJson.version
 	let pkgChanged = false
 
 	// Update package version
@@ -88,7 +94,7 @@ for (const pkg of packages) {
 		continue
 	}
 
-	writeFileSync(pkgPath, JSON.stringify(pkgJson, null, '\t') + '\n')
+	writeFileSync(pkgPath, JSON.stringify(pkgJson, null, '    ') + '\n')
 	console.log(
 		chalk.green('✓') +
 			` ${chalk.bold(pkgJson.name)}: ${chalk.dim(oldVersion)} → ${chalk.yellow(newVersion)}`
@@ -96,6 +102,31 @@ for (const pkg of packages) {
 	hasChanges = true
 }
 
+// Update CDN URLs in documentation and source files
+const CDN_DEMO_URL_OLD = `https://cdn.jsdelivr.net/npm/page-agent@${oldVersion}/dist/iife/page-agent.demo.js`
+const CDN_DEMO_URL_NEW = `https://cdn.jsdelivr.net/npm/page-agent@${newVersion}/dist/iife/page-agent.demo.js`
+const CDN_DEMO_CN_URL_OLD = `https://registry.npmmirror.com/page-agent/${oldVersion}/files/dist/iife/page-agent.demo.js`
+const CDN_DEMO_CN_URL_NEW = `https://registry.npmmirror.com/page-agent/${newVersion}/files/dist/iife/page-agent.demo.js`
+
+const filesToUpdateCdn = ['README.md', 'README-zh.md', 'packages/website/src/constants.ts']
+
+for (const relPath of filesToUpdateCdn) {
+	const filePath = join(rootDir, relPath)
+	if (!existsSync(filePath)) continue
+
+	let content = readFileSync(filePath, 'utf-8')
+	const original = content
+
+	content = content.replaceAll(CDN_DEMO_URL_OLD, CDN_DEMO_URL_NEW)
+	content = content.replaceAll(CDN_DEMO_CN_URL_OLD, CDN_DEMO_CN_URL_NEW)
+
+	if (content !== original) {
+		writeFileSync(filePath, content)
+		console.log(chalk.green('✓') + ` ${chalk.bold(relPath)}: CDN URLs updated`)
+		hasChanges = true
+	}
+}
+
 console.log(chalk.green.bold(`\n✓ Version synced: ${newVersion}\n`))
 
 // Show git commands hint