chore(version): bump version to 0.0.19

fix: panel language not found
fix: rm maxTokens from api
2026-01-10 23:35:02 +08:00 · 2026-01-10 23:33:36 +08:00 · 2026-01-10 23:27:08 +08:00 · 2026-01-10 19:27:27 +08:00 · 2026-01-10 19:25:56 +08:00 · 2026-01-10 19:23:02 +08:00
26 changed files with 454 additions and 440 deletions
@@ -57,7 +57,7 @@ const DEMO_BASE_URL = 'https://hwcxiuzfylggtcktqgij.supabase.co/functions/v1/llm
 const DEMO_API_KEY = 'PAGE-AGENT-FREE-TESTING-RANDOM'

 const agent = new PageAgent({
-	modelName: DEMO_MODEL,
+	model: DEMO_MODEL,
 	baseURL: DEMO_BASE_URL,
 	apiKey: DEMO_API_KEY,
 	language: 'zh-CN',
@@ -57,7 +57,7 @@ const DEMO_BASE_URL = 'https://hwcxiuzfylggtcktqgij.supabase.co/functions/v1/llm
 const DEMO_API_KEY = 'PAGE-AGENT-FREE-TESTING-RANDOM'

 const agent = new PageAgent({
-	modelName: DEMO_MODEL,
+	model: DEMO_MODEL,
 	baseURL: DEMO_BASE_URL,
 	apiKey: DEMO_API_KEY,
 	language: 'en-US',
@@ -1,12 +1,12 @@
 {
 	"name": "root",
-	"version": "0.0.18",
+	"version": "0.0.19",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "root",
-			"version": "0.0.18",
+			"version": "0.0.19",
 			"license": "MIT",
 			"workspaces": [
 				"packages/page-controller",
@@ -16,26 +16,26 @@
 				"packages/website"
 			],
 			"devDependencies": {
-				"@commitlint/cli": "^20.2.0",
-				"@commitlint/config-conventional": "^20.2.0",
+				"@commitlint/cli": "^20.3.0",
+				"@commitlint/config-conventional": "^20.3.0",
 				"@eslint/js": "^9.39.2",
 				"@microsoft/api-extractor": "^7.55.2",
-				"@trivago/prettier-plugin-sort-imports": "^6.0.0",
+				"@trivago/prettier-plugin-sort-imports": "^6.0.1",
 				"@types/node": "^25.0.3",
 				"concurrently": "^9.2.1",
 				"dotenv": "^17.2.3",
 				"eslint": "^9.39.2",
 				"eslint-config-prettier": "^10.1.8",
-				"eslint-plugin-react-dom": "^2.3.13",
+				"eslint-plugin-react-dom": "^2.5.1",
 				"eslint-plugin-react-hooks": "^7.0.1",
 				"eslint-plugin-react-refresh": "^0.4.26",
-				"eslint-plugin-react-x": "^2.3.13",
+				"eslint-plugin-react-x": "^2.5.1",
 				"globals": "^16.4.0",
 				"husky": "^9.1.7",
 				"lint-staged": "^16.2.4",
 				"prettier": "^3.7.4",
 				"typescript": "^5.9.3",
-				"typescript-eslint": "^8.50.1",
+				"typescript-eslint": "^8.52.0",
 				"unplugin-dts": "^1.0.0-beta.6",
 				"vite": "^7.3.0",
 				"vite-plugin-css-injected-by-js": "^3.5.2"
@@ -76,7 +76,6 @@
 			"integrity": "sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"@babel/code-frame": "^7.27.1",
 				"@babel/generator": "^7.28.5",
@@ -317,15 +316,15 @@
 			}
 		},
 		"node_modules/@commitlint/cli": {
-			"version": "20.2.0",
-			"resolved": "https://registry.npmjs.org/@commitlint/cli/-/cli-20.2.0.tgz",
-			"integrity": "sha512-l37HkrPZ2DZy26rKiTUvdq/LZtlMcxz+PeLv9dzK9NzoFGuJdOQyYU7IEkEQj0pO++uYue89wzOpZ0hcTtoqUA==",
+			"version": "20.3.0",
+			"resolved": "https://registry.npmjs.org/@commitlint/cli/-/cli-20.3.0.tgz",
+			"integrity": "sha512-HXO8YVfqdBK+MnlX2zqNrv6waGYPs6Ysjm5W2Y0GMagWXwiIKx7C8dcIX9ca+QdHq4WA0lcMnZLQ0pzQh1piZg==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
 				"@commitlint/format": "^20.2.0",
-				"@commitlint/lint": "^20.2.0",
-				"@commitlint/load": "^20.2.0",
+				"@commitlint/lint": "^20.3.0",
+				"@commitlint/load": "^20.3.0",
 				"@commitlint/read": "^20.2.0",
 				"@commitlint/types": "^20.2.0",
 				"tinyexec": "^1.0.0",
@@ -339,9 +338,9 @@
 			}
 		},
 		"node_modules/@commitlint/config-conventional": {
-			"version": "20.2.0",
-			"resolved": "https://registry.npmjs.org/@commitlint/config-conventional/-/config-conventional-20.2.0.tgz",
-			"integrity": "sha512-MsRac+yNIbTB4Q/psstKK4/ciVzACHicSwz+04Sxve+4DW+PiJeTjU0JnS4m/oOnulrXYN+yBPlKaBSGemRfgQ==",
+			"version": "20.3.0",
+			"resolved": "https://registry.npmjs.org/@commitlint/config-conventional/-/config-conventional-20.3.0.tgz",
+			"integrity": "sha512-g1OXVl6E2v0xF1Ru2RpxQ+Vfy7XUcUsCmLKzGUrhFLS4hSNykje0QSy6djBtzOiOBQCepBrmIlqx/gRlzrSh5A==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
@@ -423,15 +422,15 @@
 			}
 		},
 		"node_modules/@commitlint/lint": {
-			"version": "20.2.0",
-			"resolved": "https://registry.npmjs.org/@commitlint/lint/-/lint-20.2.0.tgz",
-			"integrity": "sha512-cQEEB+jlmyQbyiji/kmh8pUJSDeUmPiWq23kFV0EtW3eM+uAaMLMuoTMajbrtWYWQpPzOMDjYltQ8jxHeHgITg==",
+			"version": "20.3.0",
+			"resolved": "https://registry.npmjs.org/@commitlint/lint/-/lint-20.3.0.tgz",
+			"integrity": "sha512-X19HOGU5nRo6i9DIY0kG0mhgtvpn1UGO1D6aLX1ILLyeqSM5yJyMcrRqNj8SLgeSeUDODhLY9QYsBIG0LdNHkA==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
 				"@commitlint/is-ignored": "^20.2.0",
 				"@commitlint/parse": "^20.2.0",
-				"@commitlint/rules": "^20.2.0",
+				"@commitlint/rules": "^20.3.0",
 				"@commitlint/types": "^20.2.0"
 			},
 			"engines": {
@@ -439,9 +438,9 @@
 			}
 		},
 		"node_modules/@commitlint/load": {
-			"version": "20.2.0",
-			"resolved": "https://registry.npmjs.org/@commitlint/load/-/load-20.2.0.tgz",
-			"integrity": "sha512-iAK2GaBM8sPFTSwtagI67HrLKHIUxQc2BgpgNc/UMNme6LfmtHpIxQoN1TbP+X1iz58jq32HL1GbrFTCzcMi6g==",
+			"version": "20.3.0",
+			"resolved": "https://registry.npmjs.org/@commitlint/load/-/load-20.3.0.tgz",
+			"integrity": "sha512-amkdVZTXp5R65bsRXRSCwoNXbJHR2aAIY/RGFkoyd63t8UEwqEgT3f0MgeLqYw4hwXyq+TYXKdaW133E29pnGQ==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
@@ -521,9 +520,9 @@
 			}
 		},
 		"node_modules/@commitlint/rules": {
-			"version": "20.2.0",
-			"resolved": "https://registry.npmjs.org/@commitlint/rules/-/rules-20.2.0.tgz",
-			"integrity": "sha512-27rHGpeAjnYl/A+qUUiYDa7Yn1WIjof/dFJjYW4gA1Ug+LUGa1P0AexzGZ5NBxTbAlmDgaxSZkLLxtLVqtg8PQ==",
+			"version": "20.3.0",
+			"resolved": "https://registry.npmjs.org/@commitlint/rules/-/rules-20.3.0.tgz",
+			"integrity": "sha512-TGgXN/qBEhbzVD13crE1l7YSMJRrbPbUL0OBZALbUM5ER36RZmiZRu2ud2W/AA7HO9YLBRbyx6YVi2t/2Be0yQ==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
@@ -1016,9 +1015,9 @@
 			}
 		},
 		"node_modules/@eslint-community/eslint-utils": {
-			"version": "4.9.0",
-			"resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz",
-			"integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==",
+			"version": "4.9.1",
+			"resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.1.tgz",
+			"integrity": "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
@@ -1058,16 +1057,16 @@
 			}
 		},
 		"node_modules/@eslint-react/ast": {
-			"version": "2.3.13",
-			"resolved": "https://registry.npmjs.org/@eslint-react/ast/-/ast-2.3.13.tgz",
-			"integrity": "sha512-OP2rOhHYLx2nfd9uA9uACKZJN9z9rX9uuAMx4PjT75JNOdYr1GgqWQZcYCepyJ+gmVNCyiXcLXuyhavqxCSM8Q==",
+			"version": "2.5.1",
+			"resolved": "https://registry.npmjs.org/@eslint-react/ast/-/ast-2.5.1.tgz",
+			"integrity": "sha512-l+pEb3kS/RhFN+8ZOhL5+P5+Yj7iw+ta7+abUBNH+5PMyiixlnAJlJ7Wy+rsTGxjUJtzEff3CzSr06V7qwJuwQ==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@eslint-react/eff": "2.3.13",
-				"@typescript-eslint/types": "^8.49.0",
-				"@typescript-eslint/typescript-estree": "^8.49.0",
-				"@typescript-eslint/utils": "^8.49.0",
+				"@eslint-react/eff": "2.5.1",
+				"@typescript-eslint/types": "^8.51.0",
+				"@typescript-eslint/typescript-estree": "^8.51.0",
+				"@typescript-eslint/utils": "^8.51.0",
 				"string-ts": "^2.3.1"
 			},
 			"engines": {
@@ -1079,19 +1078,19 @@
 			}
 		},
 		"node_modules/@eslint-react/core": {
-			"version": "2.3.13",
-			"resolved": "https://registry.npmjs.org/@eslint-react/core/-/core-2.3.13.tgz",
-			"integrity": "sha512-4bWBE+1kApuxJKIrLJH2FuFtCbM4fXfDs6Ou8MNamGoX6hdynlntssvaMZTd/lk/L8dt01H/3btr7xBX4+4BNA==",
+			"version": "2.5.1",
+			"resolved": "https://registry.npmjs.org/@eslint-react/core/-/core-2.5.1.tgz",
+			"integrity": "sha512-48YQYhjHga0TAv7FI0uGGT+X3SITec89fJLKSTqIEa7jTLpXTV56B+B/V/IcfZ0s8I0lNVEmtHFTXaibAxmfyw==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@eslint-react/ast": "2.3.13",
-				"@eslint-react/eff": "2.3.13",
-				"@eslint-react/shared": "2.3.13",
-				"@eslint-react/var": "2.3.13",
-				"@typescript-eslint/scope-manager": "^8.49.0",
-				"@typescript-eslint/types": "^8.49.0",
-				"@typescript-eslint/utils": "^8.49.0",
+				"@eslint-react/ast": "2.5.1",
+				"@eslint-react/eff": "2.5.1",
+				"@eslint-react/shared": "2.5.1",
+				"@eslint-react/var": "2.5.1",
+				"@typescript-eslint/scope-manager": "^8.51.0",
+				"@typescript-eslint/types": "^8.51.0",
+				"@typescript-eslint/utils": "^8.51.0",
 				"birecord": "^0.1.1",
 				"ts-pattern": "^5.9.0"
 			},
@@ -1104,9 +1103,9 @@
 			}
 		},
 		"node_modules/@eslint-react/eff": {
-			"version": "2.3.13",
-			"resolved": "https://registry.npmjs.org/@eslint-react/eff/-/eff-2.3.13.tgz",
-			"integrity": "sha512-byXsssozwh3VaiqcOonAKQgLXgpMVNSxBWFjdfbNhW7+NttorSt950qtiw+P7A9JoRab1OuGYk4MDY5UVBno8Q==",
+			"version": "2.5.1",
+			"resolved": "https://registry.npmjs.org/@eslint-react/eff/-/eff-2.5.1.tgz",
+			"integrity": "sha512-henDz7sTB67Q+YPb+Kiy0UpD7eHLvDtB2nOrRtHLTatS/LFr7wVr4J2muQPkPzY9KFF8pv811nrwW58FuDphPg==",
 			"dev": true,
 			"license": "MIT",
 			"engines": {
@@ -1114,16 +1113,16 @@
 			}
 		},
 		"node_modules/@eslint-react/shared": {
-			"version": "2.3.13",
-			"resolved": "https://registry.npmjs.org/@eslint-react/shared/-/shared-2.3.13.tgz",
-			"integrity": "sha512-ESE7dVeOXtem3K6BD6k2wJaFt35kPtTT9SWCL99LFk7pym4OEGoMxPcyB2R7PMWiVudwl63BmiOgQOdaFYPONg==",
+			"version": "2.5.1",
+			"resolved": "https://registry.npmjs.org/@eslint-react/shared/-/shared-2.5.1.tgz",
+			"integrity": "sha512-JSTnpZdBu57ZvrJkBwUZXgkBW8iPiQfSiQMYHEjVFR2NHWFgcOd9qYJLX7mJLrdcw/j+GgRQeOAGok0a0xcxGA==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@eslint-react/eff": "2.3.13",
-				"@typescript-eslint/utils": "^8.49.0",
+				"@eslint-react/eff": "2.5.1",
+				"@typescript-eslint/utils": "^8.51.0",
 				"ts-pattern": "^5.9.0",
-				"zod": "^4.1.13"
+				"zod": "^4.3.5"
 			},
 			"engines": {
 				"node": ">=20.19.0"
@@ -1134,17 +1133,17 @@
 			}
 		},
 		"node_modules/@eslint-react/var": {
-			"version": "2.3.13",
-			"resolved": "https://registry.npmjs.org/@eslint-react/var/-/var-2.3.13.tgz",
-			"integrity": "sha512-BozBfUZkzzobD6x/M8XERAnZQ3UvZPsD49zTGFKKU9M/bgsM78HwzxAPLkiu88W55v3sO/Kqf8fQTXT4VEeZ/g==",
+			"version": "2.5.1",
+			"resolved": "https://registry.npmjs.org/@eslint-react/var/-/var-2.5.1.tgz",
+			"integrity": "sha512-O3rbdK8pHKZ4NYPD39Zq7zhWu76dvhyeroqG8nQzf667F/FdHGpGhsCPJOeIU5L/ooYO/3/Qz2vJD1pB5JeROQ==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@eslint-react/ast": "2.3.13",
-				"@eslint-react/eff": "2.3.13",
-				"@typescript-eslint/scope-manager": "^8.49.0",
-				"@typescript-eslint/types": "^8.49.0",
-				"@typescript-eslint/utils": "^8.49.0",
+				"@eslint-react/ast": "2.5.1",
+				"@eslint-react/eff": "2.5.1",
+				"@typescript-eslint/scope-manager": "^8.51.0",
+				"@typescript-eslint/types": "^8.51.0",
+				"@typescript-eslint/utils": "^8.51.0",
 				"ts-pattern": "^5.9.0"
 			},
 			"engines": {
@@ -3459,9 +3458,9 @@
 			}
 		},
 		"node_modules/@trivago/prettier-plugin-sort-imports": {
-			"version": "6.0.0",
-			"resolved": "https://registry.npmjs.org/@trivago/prettier-plugin-sort-imports/-/prettier-plugin-sort-imports-6.0.0.tgz",
-			"integrity": "sha512-Xarx55ow0R8oC7ViL5fPmDsg1EBa1dVhyZFVbFXNtPPJyW2w9bJADIla8YFSaNG9N06XfcklA9O9vmw4noNxkQ==",
+			"version": "6.0.1",
+			"resolved": "https://registry.npmjs.org/@trivago/prettier-plugin-sort-imports/-/prettier-plugin-sort-imports-6.0.1.tgz",
+			"integrity": "sha512-6B13DCWDfAfh4AEJ43gRgeCSAQmlKG5LHqHzHc0lbUwgBy0rX7o41US+46Fd4XiXBx+JDGEz3NBadCbUls0dUQ==",
 			"dev": true,
 			"license": "Apache-2.0",
 			"dependencies": {
@@ -3562,7 +3561,6 @@
 			"integrity": "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"undici-types": "~7.16.0"
 			}
@@ -3573,7 +3571,6 @@
 			"integrity": "sha512-MWtvHrGZLFttgeEj28VXHxpmwYbor/ATPYbBfSFZEIRK0ecCFLl2Qo55z52Hss+UV9CRN7trSeq1zbgx7YDWWg==",
 			"devOptional": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"csstype": "^3.2.2"
 			}
@@ -3584,26 +3581,25 @@
 			"integrity": "sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ==",
 			"devOptional": true,
 			"license": "MIT",
-			"peer": true,
 			"peerDependencies": {
 				"@types/react": "^19.2.0"
 			}
 		},
 		"node_modules/@typescript-eslint/eslint-plugin": {
-			"version": "8.50.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.50.1.tgz",
-			"integrity": "sha512-PKhLGDq3JAg0Jk/aK890knnqduuI/Qj+udH7wCf0217IGi4gt+acgCyPVe79qoT+qKUvHMDQkwJeKW9fwl8Cyw==",
+			"version": "8.52.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.52.0.tgz",
+			"integrity": "sha512-okqtOgqu2qmZJ5iN4TWlgfF171dZmx2FzdOv2K/ixL2LZWDStL8+JgQerI2sa8eAEfoydG9+0V96m7V+P8yE1Q==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@eslint-community/regexpp": "^4.10.0",
-				"@typescript-eslint/scope-manager": "8.50.1",
-				"@typescript-eslint/type-utils": "8.50.1",
-				"@typescript-eslint/utils": "8.50.1",
-				"@typescript-eslint/visitor-keys": "8.50.1",
-				"ignore": "^7.0.0",
+				"@eslint-community/regexpp": "^4.12.2",
+				"@typescript-eslint/scope-manager": "8.52.0",
+				"@typescript-eslint/type-utils": "8.52.0",
+				"@typescript-eslint/utils": "8.52.0",
+				"@typescript-eslint/visitor-keys": "8.52.0",
+				"ignore": "^7.0.5",
 				"natural-compare": "^1.4.0",
-				"ts-api-utils": "^2.1.0"
+				"ts-api-utils": "^2.4.0"
 			},
 			"engines": {
 				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -3613,7 +3609,7 @@
 				"url": "https://opencollective.com/typescript-eslint"
 			},
 			"peerDependencies": {
-				"@typescript-eslint/parser": "^8.50.1",
+				"@typescript-eslint/parser": "^8.52.0",
 				"eslint": "^8.57.0 || ^9.0.0",
 				"typescript": ">=4.8.4 <6.0.0"
 			}
@@ -3629,18 +3625,17 @@
 			}
 		},
 		"node_modules/@typescript-eslint/parser": {
-			"version": "8.50.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.50.1.tgz",
-			"integrity": "sha512-hM5faZwg7aVNa819m/5r7D0h0c9yC4DUlWAOvHAtISdFTc8xB86VmX5Xqabrama3wIPJ/q9RbGS1worb6JfnMg==",
+			"version": "8.52.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.52.0.tgz",
+			"integrity": "sha512-iIACsx8pxRnguSYhHiMn2PvhvfpopO9FXHyn1mG5txZIsAaB6F0KwbFnUQN3KCiG3Jcuad/Cao2FAs1Wp7vAyg==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
-				"@typescript-eslint/scope-manager": "8.50.1",
-				"@typescript-eslint/types": "8.50.1",
-				"@typescript-eslint/typescript-estree": "8.50.1",
-				"@typescript-eslint/visitor-keys": "8.50.1",
-				"debug": "^4.3.4"
+				"@typescript-eslint/scope-manager": "8.52.0",
+				"@typescript-eslint/types": "8.52.0",
+				"@typescript-eslint/typescript-estree": "8.52.0",
+				"@typescript-eslint/visitor-keys": "8.52.0",
+				"debug": "^4.4.3"
 			},
 			"engines": {
 				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -3655,15 +3650,15 @@
 			}
 		},
 		"node_modules/@typescript-eslint/project-service": {
-			"version": "8.50.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.50.1.tgz",
-			"integrity": "sha512-E1ur1MCVf+YiP89+o4Les/oBAVzmSbeRB0MQLfSlYtbWU17HPxZ6Bhs5iYmKZRALvEuBoXIZMOIRRc/P++Ortg==",
+			"version": "8.52.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.52.0.tgz",
+			"integrity": "sha512-xD0MfdSdEmeFa3OmVqonHi+Cciab96ls1UhIF/qX/O/gPu5KXD0bY9lu33jj04fjzrXHcuvjBcBC+D3SNSadaw==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@typescript-eslint/tsconfig-utils": "^8.50.1",
-				"@typescript-eslint/types": "^8.50.1",
-				"debug": "^4.3.4"
+				"@typescript-eslint/tsconfig-utils": "^8.52.0",
+				"@typescript-eslint/types": "^8.52.0",
+				"debug": "^4.4.3"
 			},
 			"engines": {
 				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -3677,14 +3672,14 @@
 			}
 		},
 		"node_modules/@typescript-eslint/scope-manager": {
-			"version": "8.50.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.50.1.tgz",
-			"integrity": "sha512-mfRx06Myt3T4vuoHaKi8ZWNTPdzKPNBhiblze5N50//TSHOAQQevl/aolqA/BcqqbJ88GUnLqjjcBc8EWdBcVw==",
+			"version": "8.52.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.52.0.tgz",
+			"integrity": "sha512-ixxqmmCcc1Nf8S0mS0TkJ/3LKcC8mruYJPOU6Ia2F/zUUR4pApW7LzrpU3JmtePbRUTes9bEqRc1Gg4iyRnDzA==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@typescript-eslint/types": "8.50.1",
-				"@typescript-eslint/visitor-keys": "8.50.1"
+				"@typescript-eslint/types": "8.52.0",
+				"@typescript-eslint/visitor-keys": "8.52.0"
 			},
 			"engines": {
 				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -3695,9 +3690,9 @@
 			}
 		},
 		"node_modules/@typescript-eslint/tsconfig-utils": {
-			"version": "8.50.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.50.1.tgz",
-			"integrity": "sha512-ooHmotT/lCWLXi55G4mvaUF60aJa012QzvLK0Y+Mp4WdSt17QhMhWOaBWeGTFVkb2gDgBe19Cxy1elPXylslDw==",
+			"version": "8.52.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.52.0.tgz",
+			"integrity": "sha512-jl+8fzr/SdzdxWJznq5nvoI7qn2tNYV/ZBAEcaFMVXf+K6jmXvAFrgo/+5rxgnL152f//pDEAYAhhBAZGrVfwg==",
 			"dev": true,
 			"license": "MIT",
 			"engines": {
@@ -3712,17 +3707,17 @@
 			}
 		},
 		"node_modules/@typescript-eslint/type-utils": {
-			"version": "8.50.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.50.1.tgz",
-			"integrity": "sha512-7J3bf022QZE42tYMO6SL+6lTPKFk/WphhRPe9Tw/el+cEwzLz1Jjz2PX3GtGQVxooLDKeMVmMt7fWpYRdG5Etg==",
+			"version": "8.52.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.52.0.tgz",
+			"integrity": "sha512-JD3wKBRWglYRQkAtsyGz1AewDu3mTc7NtRjR/ceTyGoPqmdS5oCdx/oZMWD5Zuqmo6/MpsYs0wp6axNt88/2EQ==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@typescript-eslint/types": "8.50.1",
-				"@typescript-eslint/typescript-estree": "8.50.1",
-				"@typescript-eslint/utils": "8.50.1",
-				"debug": "^4.3.4",
-				"ts-api-utils": "^2.1.0"
+				"@typescript-eslint/types": "8.52.0",
+				"@typescript-eslint/typescript-estree": "8.52.0",
+				"@typescript-eslint/utils": "8.52.0",
+				"debug": "^4.4.3",
+				"ts-api-utils": "^2.4.0"
 			},
 			"engines": {
 				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -3737,9 +3732,9 @@
 			}
 		},
 		"node_modules/@typescript-eslint/types": {
-			"version": "8.50.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.50.1.tgz",
-			"integrity": "sha512-v5lFIS2feTkNyMhd7AucE/9j/4V9v5iIbpVRncjk/K0sQ6Sb+Np9fgYS/63n6nwqahHQvbmujeBL7mp07Q9mlA==",
+			"version": "8.52.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.52.0.tgz",
+			"integrity": "sha512-LWQV1V4q9V4cT4H5JCIx3481iIFxH1UkVk+ZkGGAV1ZGcjGI9IoFOfg3O6ywz8QqCDEp7Inlg6kovMofsNRaGg==",
 			"dev": true,
 			"license": "MIT",
 			"engines": {
@@ -3751,21 +3746,21 @@
 			}
 		},
 		"node_modules/@typescript-eslint/typescript-estree": {
-			"version": "8.50.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.50.1.tgz",
-			"integrity": "sha512-woHPdW+0gj53aM+cxchymJCrh0cyS7BTIdcDxWUNsclr9VDkOSbqC13juHzxOmQ22dDkMZEpZB+3X1WpUvzgVQ==",
+			"version": "8.52.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.52.0.tgz",
+			"integrity": "sha512-XP3LClsCc0FsTK5/frGjolyADTh3QmsLp6nKd476xNI9CsSsLnmn4f0jrzNoAulmxlmNIpeXuHYeEQv61Q6qeQ==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@typescript-eslint/project-service": "8.50.1",
-				"@typescript-eslint/tsconfig-utils": "8.50.1",
-				"@typescript-eslint/types": "8.50.1",
-				"@typescript-eslint/visitor-keys": "8.50.1",
-				"debug": "^4.3.4",
-				"minimatch": "^9.0.4",
-				"semver": "^7.6.0",
+				"@typescript-eslint/project-service": "8.52.0",
+				"@typescript-eslint/tsconfig-utils": "8.52.0",
+				"@typescript-eslint/types": "8.52.0",
+				"@typescript-eslint/visitor-keys": "8.52.0",
+				"debug": "^4.4.3",
+				"minimatch": "^9.0.5",
+				"semver": "^7.7.3",
 				"tinyglobby": "^0.2.15",
-				"ts-api-utils": "^2.1.0"
+				"ts-api-utils": "^2.4.0"
 			},
 			"engines": {
 				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -3805,16 +3800,16 @@
 			}
 		},
 		"node_modules/@typescript-eslint/utils": {
-			"version": "8.50.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.50.1.tgz",
-			"integrity": "sha512-lCLp8H1T9T7gPbEuJSnHwnSuO9mDf8mfK/Nion5mZmiEaQD9sWf9W4dfeFqRyqRjF06/kBuTmAqcs9sewM2NbQ==",
+			"version": "8.52.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.52.0.tgz",
+			"integrity": "sha512-wYndVMWkweqHpEpwPhwqE2lnD2DxC6WVLupU/DOt/0/v+/+iQbbzO3jOHjmBMnhu0DgLULvOaU4h4pwHYi2oRQ==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@eslint-community/eslint-utils": "^4.7.0",
-				"@typescript-eslint/scope-manager": "8.50.1",
-				"@typescript-eslint/types": "8.50.1",
-				"@typescript-eslint/typescript-estree": "8.50.1"
+				"@eslint-community/eslint-utils": "^4.9.1",
+				"@typescript-eslint/scope-manager": "8.52.0",
+				"@typescript-eslint/types": "8.52.0",
+				"@typescript-eslint/typescript-estree": "8.52.0"
 			},
 			"engines": {
 				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -3829,13 +3824,13 @@
 			}
 		},
 		"node_modules/@typescript-eslint/visitor-keys": {
-			"version": "8.50.1",
-			"resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.50.1.tgz",
-			"integrity": "sha512-IrDKrw7pCRUR94zeuCSUWQ+w8JEf5ZX5jl/e6AHGSLi1/zIr0lgutfn/7JpfCey+urpgQEdrZVYzCaVVKiTwhQ==",
+			"version": "8.52.0",
+			"resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.52.0.tgz",
+			"integrity": "sha512-ink3/Zofus34nmBsPjow63FP5M7IGff0RKAgqR6+CFpdk22M7aLwC9gOcLGYqr7MczLPzZVERW9hRog3O4n1sQ==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@typescript-eslint/types": "8.50.1",
+				"@typescript-eslint/types": "8.52.0",
 				"eslint-visitor-keys": "^4.2.1"
 			},
 			"engines": {
@@ -3898,7 +3893,6 @@
 			"integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"bin": {
 				"acorn": "bin/acorn"
 			},
@@ -4096,7 +4090,6 @@
 				}
 			],
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"baseline-browser-mapping": "^2.8.25",
 				"caniuse-lite": "^1.0.30001754",
@@ -4519,7 +4512,6 @@
 			"integrity": "sha512-itvL5h8RETACmOTFc4UfIyB2RfEHi71Ax6E/PivVxq9NseKbOWpeyHEOIbmAw1rs8Ak0VursQNww7lf7YtUwzg==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"env-paths": "^2.2.1",
 				"import-fresh": "^3.3.0",
@@ -4733,7 +4725,6 @@
 			"dev": true,
 			"hasInstallScript": true,
 			"license": "MIT",
-			"peer": true,
 			"bin": {
 				"esbuild": "bin/esbuild"
 			},
@@ -4798,7 +4789,6 @@
 			"integrity": "sha512-LEyamqS7W5HB3ujJyvi0HQK/dtVINZvd5mAAp9eT5S/ujByGjiZLCzPcHVzuXbpJDJF/cxwHlfceVUDZ2lnSTw==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"@eslint-community/eslint-utils": "^4.8.0",
 				"@eslint-community/regexpp": "^4.12.1",
@@ -4870,20 +4860,20 @@
 			}
 		},
 		"node_modules/eslint-plugin-react-dom": {
-			"version": "2.3.13",
-			"resolved": "https://registry.npmjs.org/eslint-plugin-react-dom/-/eslint-plugin-react-dom-2.3.13.tgz",
-			"integrity": "sha512-O9jglTOnnuyfJcSxjeVc8lqIp5kuS9/0MLLCHlOTH8ZjIifHHxUr6GZ2fd4la9y0FsoEYXEO7DBIMjWx2vCwjg==",
+			"version": "2.5.1",
+			"resolved": "https://registry.npmjs.org/eslint-plugin-react-dom/-/eslint-plugin-react-dom-2.5.1.tgz",
+			"integrity": "sha512-7x3k0bQwtTOSxjReH11buYL6aSMopBzSaWr2bU/LPOuy1dDxvqE6HC2Y6QPEyZjLJ1ppUSKwRmcX85uiF0jHAA==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@eslint-react/ast": "2.3.13",
-				"@eslint-react/core": "2.3.13",
-				"@eslint-react/eff": "2.3.13",
-				"@eslint-react/shared": "2.3.13",
-				"@eslint-react/var": "2.3.13",
-				"@typescript-eslint/scope-manager": "^8.49.0",
-				"@typescript-eslint/types": "^8.49.0",
-				"@typescript-eslint/utils": "^8.49.0",
+				"@eslint-react/ast": "2.5.1",
+				"@eslint-react/core": "2.5.1",
+				"@eslint-react/eff": "2.5.1",
+				"@eslint-react/shared": "2.5.1",
+				"@eslint-react/var": "2.5.1",
+				"@typescript-eslint/scope-manager": "^8.51.0",
+				"@typescript-eslint/types": "^8.51.0",
+				"@typescript-eslint/utils": "^8.51.0",
 				"compare-versions": "^6.1.1",
 				"string-ts": "^2.3.1",
 				"ts-pattern": "^5.9.0"
@@ -4927,25 +4917,25 @@
 			}
 		},
 		"node_modules/eslint-plugin-react-x": {
-			"version": "2.3.13",
-			"resolved": "https://registry.npmjs.org/eslint-plugin-react-x/-/eslint-plugin-react-x-2.3.13.tgz",
-			"integrity": "sha512-+m+V/5VLMxgx0VsFUUyflMNLQG0WFYspsfv0XJFqx7me3A2b3P20QatNDHQCYswz0PRbRFqinTPukPRhZh68ag==",
+			"version": "2.5.1",
+			"resolved": "https://registry.npmjs.org/eslint-plugin-react-x/-/eslint-plugin-react-x-2.5.1.tgz",
+			"integrity": "sha512-w3KtEG8M7sFRh/psUmep3H+i2O/5Nn9wI8GXjlqzwp8zLb4ax66Ue+1oecLTzY/0j/M1xRfB3hzk5oio54RwLA==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@eslint-react/ast": "2.3.13",
-				"@eslint-react/core": "2.3.13",
-				"@eslint-react/eff": "2.3.13",
-				"@eslint-react/shared": "2.3.13",
-				"@eslint-react/var": "2.3.13",
-				"@typescript-eslint/scope-manager": "^8.49.0",
-				"@typescript-eslint/type-utils": "^8.49.0",
-				"@typescript-eslint/types": "^8.49.0",
-				"@typescript-eslint/utils": "^8.49.0",
+				"@eslint-react/ast": "2.5.1",
+				"@eslint-react/core": "2.5.1",
+				"@eslint-react/eff": "2.5.1",
+				"@eslint-react/shared": "2.5.1",
+				"@eslint-react/var": "2.5.1",
+				"@typescript-eslint/scope-manager": "^8.51.0",
+				"@typescript-eslint/type-utils": "^8.51.0",
+				"@typescript-eslint/types": "^8.51.0",
+				"@typescript-eslint/utils": "^8.51.0",
 				"compare-versions": "^6.1.1",
 				"is-immutable-type": "^5.0.1",
 				"string-ts": "^2.3.1",
-				"ts-api-utils": "^2.1.0",
+				"ts-api-utils": "^2.4.0",
 				"ts-pattern": "^5.9.0"
 			},
 			"engines": {
@@ -5320,13 +5310,13 @@
 			"license": "ISC"
 		},
 		"node_modules/framer-motion": {
-			"version": "12.23.26",
-			"resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.23.26.tgz",
-			"integrity": "sha512-cPcIhgR42xBn1Uj+PzOyheMtZ73H927+uWPDVhUMqxy8UHt6Okavb6xIz9J/phFUHUj0OncR6UvMfJTXoc/LKA==",
+			"version": "12.24.0",
+			"resolved": "https://registry.npmjs.org/framer-motion/-/framer-motion-12.24.0.tgz",
+			"integrity": "sha512-ggTMRkIDPc76lHmM+dRT1MmVfFV6t/y+jkWjWuzR7FG5xRvnAAl/5wFPjzSkLE8Nu5E5uIQRCNxmIXtWJVo6XQ==",
 			"license": "MIT",
 			"dependencies": {
-				"motion-dom": "^12.23.23",
-				"motion-utils": "^12.23.6",
+				"motion-dom": "^12.24.0",
+				"motion-utils": "^12.23.28",
 				"tslib": "^2.4.0"
 			},
 			"peerDependencies": {
@@ -5572,7 +5562,6 @@
 				}
 			],
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"@babel/runtime": "^7.28.4"
 			},
@@ -6534,12 +6523,12 @@
 			}
 		},
 		"node_modules/motion": {
-			"version": "12.23.26",
-			"resolved": "https://registry.npmjs.org/motion/-/motion-12.23.26.tgz",
-			"integrity": "sha512-Ll8XhVxY8LXMVYTCfme27WH2GjBrCIzY4+ndr5QKxsK+YwCtOi2B/oBi5jcIbik5doXuWT/4KKDOVAZJkeY5VQ==",
+			"version": "12.24.0",
+			"resolved": "https://registry.npmjs.org/motion/-/motion-12.24.0.tgz",
+			"integrity": "sha512-FAnpl/DhCFct3p+T2hCjAY95w+3EggUk3b8Ql4jQ6mmdRbEaGD1000goqWeEYVoD7mqx9H0As9ORmRADD4LQAw==",
 			"license": "MIT",
 			"dependencies": {
-				"framer-motion": "^12.23.26",
+				"framer-motion": "^12.24.0",
 				"tslib": "^2.4.0"
 			},
 			"peerDependencies": {
@@ -6560,18 +6549,18 @@
 			}
 		},
 		"node_modules/motion-dom": {
-			"version": "12.23.23",
-			"resolved": "https://registry.npmjs.org/motion-dom/-/motion-dom-12.23.23.tgz",
-			"integrity": "sha512-n5yolOs0TQQBRUFImrRfs/+6X4p3Q4n1dUEqt/H58Vx7OW6RF+foWEgmTVDhIWJIMXOuNNL0apKH2S16en9eiA==",
+			"version": "12.24.0",
+			"resolved": "https://registry.npmjs.org/motion-dom/-/motion-dom-12.24.0.tgz",
+			"integrity": "sha512-RD2kZkFd/GH4fITI8IJvypGgn0vIu5vkrJaXIAkYqORGs5P0CKDHKNvswmoY1H+tbUAOPSh6VtUqoAmc/3Gvig==",
 			"license": "MIT",
 			"dependencies": {
-				"motion-utils": "^12.23.6"
+				"motion-utils": "^12.23.28"
 			}
 		},
 		"node_modules/motion-utils": {
-			"version": "12.23.6",
-			"resolved": "https://registry.npmjs.org/motion-utils/-/motion-utils-12.23.6.tgz",
-			"integrity": "sha512-eAWoPgr4eFEOFfg2WjIsMoqJTW6Z8MTUCgn/GZ3VRpClWBdnbjryiA3ZSNLyxCTmCQx4RmYX6jX1iWHbenUPNQ==",
+			"version": "12.23.28",
+			"resolved": "https://registry.npmjs.org/motion-utils/-/motion-utils-12.23.28.tgz",
+			"integrity": "sha512-0W6cWd5Okoyf8jmessVK3spOmbyE0yTdNKujHctHH9XdAE4QDuZ1/LjSXC68rrhsJU+TkzXURC5OdSWh9ibOwQ==",
 			"license": "MIT"
 		},
 		"node_modules/ms": {
@@ -6887,7 +6876,6 @@
 			"integrity": "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"bin": {
 				"prettier": "bin/prettier.cjs"
 			},
@@ -6930,7 +6918,6 @@
 			"resolved": "https://registry.npmjs.org/react/-/react-19.2.3.tgz",
 			"integrity": "sha512-Ku/hhYbVjOQnXDZFv2+RibmLFGwFdeeKHFcOTlrt7xplBnya5OGn/hIRDsqDiSUcfORsDC7MPxwork8jBwsIWA==",
 			"license": "MIT",
-			"peer": true,
 			"engines": {
 				"node": ">=0.10.0"
 			}
@@ -6940,7 +6927,6 @@
 			"resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.3.tgz",
 			"integrity": "sha512-yELu4WmLPw5Mr/lmeEpox5rw3RETacE++JgHqQzd2dg+YbJuat3jH4ingc+WPZhxaoFzdv9y33G+F7Nl5O0GBg==",
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"scheduler": "^0.27.0"
 			},
@@ -6949,13 +6935,13 @@
 			}
 		},
 		"node_modules/react-i18next": {
-			"version": "16.5.0",
-			"resolved": "https://registry.npmjs.org/react-i18next/-/react-i18next-16.5.0.tgz",
-			"integrity": "sha512-IMpPTyCTKxEj8klCrLKUTIUa8uYTd851+jcu2fJuUB9Agkk9Qq8asw4omyeHVnOXHrLgQJGTm5zTvn8HpaPiqw==",
+			"version": "16.5.1",
+			"resolved": "https://registry.npmjs.org/react-i18next/-/react-i18next-16.5.1.tgz",
+			"integrity": "sha512-Hks6UIRZWW4c+qDAnx1csVsCGYeIR4MoBGQgJ+NUoNnO6qLxXuf8zu0xdcinyXUORgGzCdRsexxO1Xzv3sTdnw==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@babel/runtime": "^7.27.6",
+				"@babel/runtime": "^7.28.4",
 				"html-parse-stringify": "^3.0.1",
 				"use-sync-external-store": "^1.6.0"
 			},
@@ -7067,7 +7053,6 @@
 			"integrity": "sha512-w8GmOxZfBmKknvdXU1sdM9NHcoQejwF/4mNgj2JuEEdRaHwwF12K7e9eXn1nLZ07ad+du76mkVsyeb2rKGllsA==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"@types/estree": "1.0.8"
 			},
@@ -7189,9 +7174,9 @@
 			}
 		},
 		"node_modules/simple-icons": {
-			"version": "16.2.0",
-			"resolved": "https://registry.npmjs.org/simple-icons/-/simple-icons-16.2.0.tgz",
-			"integrity": "sha512-SCV4cAX8O2M2WQ3QJm+3k4QdcUIJiBiwKNViQiOwPjWbFWgypzelviW+Bp0A2ij6r/DIEZpTTDcLgD/BE4aexQ==",
+			"version": "16.4.0",
+			"resolved": "https://registry.npmjs.org/simple-icons/-/simple-icons-16.4.0.tgz",
+			"integrity": "sha512-8CKtCvx1Zq3L0CBsR4RR1MjGCXkXbzdspwl2yCxs8oWkstbzj2+DatRKDee/tuj3Ffd/2CDzwEky9RgG2yggew==",
 			"funding": [
 				{
 					"type": "opencollective",
@@ -7462,7 +7447,6 @@
 			"integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"engines": {
 				"node": ">=12"
 			},
@@ -7494,9 +7478,9 @@
 			}
 		},
 		"node_modules/ts-api-utils": {
-			"version": "2.1.0",
-			"resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.1.0.tgz",
-			"integrity": "sha512-CUgTZL1irw8u29bzrOD/nH85jqyc74D6SshFgujOIA7osm2Rz7dYH77agkx7H4FBNxDq7Cjf+IjaX/8zwFW+ZQ==",
+			"version": "2.4.0",
+			"resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.4.0.tgz",
+			"integrity": "sha512-3TaVTaAv2gTiMB35i3FiGJaRfwb3Pyn/j3m/bfAvGe8FB7CF6u+LMYqYlDh7reQf7UNvoTvdfAqHGmPGOSsPmA==",
 			"dev": true,
 			"license": "MIT",
 			"engines": {
@@ -7584,7 +7568,6 @@
 			"integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
 			"dev": true,
 			"license": "Apache-2.0",
-			"peer": true,
 			"bin": {
 				"tsc": "bin/tsc",
 				"tsserver": "bin/tsserver"
@@ -7594,16 +7577,16 @@
 			}
 		},
 		"node_modules/typescript-eslint": {
-			"version": "8.50.1",
-			"resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.50.1.tgz",
-			"integrity": "sha512-ytTHO+SoYSbhAH9CrYnMhiLx8To6PSSvqnvXyPUgPETCvB6eBKmTI9w6XMPS3HsBRGkwTVBX+urA8dYQx6bHfQ==",
+			"version": "8.52.0",
+			"resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.52.0.tgz",
+			"integrity": "sha512-atlQQJ2YkO4pfTVQmQ+wvYQwexPDOIgo+RaVcD7gHgzy/IQA+XTyuxNM9M9TVXvttkF7koBHmcwisKdOAf2EcA==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
-				"@typescript-eslint/eslint-plugin": "8.50.1",
-				"@typescript-eslint/parser": "8.50.1",
-				"@typescript-eslint/typescript-estree": "8.50.1",
-				"@typescript-eslint/utils": "8.50.1"
+				"@typescript-eslint/eslint-plugin": "8.52.0",
+				"@typescript-eslint/parser": "8.52.0",
+				"@typescript-eslint/typescript-estree": "8.52.0",
+				"@typescript-eslint/utils": "8.52.0"
 			},
 			"engines": {
 				"node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -7794,7 +7777,6 @@
 			"integrity": "sha512-dZwN5L1VlUBewiP6H9s2+B3e3Jg96D0vzN+Ry73sOefebhYr9f94wwkMNN/9ouoU8pV1BqA1d1zGk8928cx0rg==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"dependencies": {
 				"esbuild": "^0.27.0",
 				"fdir": "^6.5.0",
@@ -7898,7 +7880,6 @@
 			"integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
 			"dev": true,
 			"license": "MIT",
-			"peer": true,
 			"engines": {
 				"node": ">=12"
 			},
@@ -8138,11 +8119,10 @@
 			}
 		},
 		"node_modules/zod": {
-			"version": "4.2.1",
-			"resolved": "https://registry.npmjs.org/zod/-/zod-4.2.1.tgz",
-			"integrity": "sha512-0wZ1IRqGGhMP76gLqz8EyfBXKk0J2qo2+H3fi4mcUP/KtTocoX08nmIAHl1Z2kJIZbZee8KOpBCSNPRgauucjw==",
+			"version": "4.3.5",
+			"resolved": "https://registry.npmjs.org/zod/-/zod-4.3.5.tgz",
+			"integrity": "sha512-k7Nwx6vuWx1IJ9Bjuf4Zt1PEllcwe7cls3VNzm4CQ1/hgtFUK2bRNG3rvnpPUhFjmqJKAKtjV576KnUkHocg/g==",
 			"license": "MIT",
-			"peer": true,
 			"funding": {
 				"url": "https://github.com/sponsors/colinhacks"
 			}
@@ -8162,32 +8142,32 @@
 		},
 		"packages/llms": {
 			"name": "@page-agent/llms",
-			"version": "0.0.18",
+			"version": "0.0.19",
 			"license": "MIT",
 			"dependencies": {
 				"chalk": "^5.6.2",
-				"zod": "^4.2.1"
+				"zod": "^4.3.5"
 			}
 		},
 		"packages/page-agent": {
-			"version": "0.0.18",
+			"version": "0.0.19",
 			"license": "MIT",
 			"dependencies": {
-				"@page-agent/llms": "0.0.18",
-				"@page-agent/page-controller": "0.0.18",
-				"@page-agent/ui": "0.0.18",
+				"@page-agent/llms": "0.0.19",
+				"@page-agent/page-controller": "0.0.19",
+				"@page-agent/ui": "0.0.19",
 				"chalk": "^5.6.2",
-				"zod": "^4.2.1"
+				"zod": "^4.3.5"
 			}
 		},
 		"packages/page-controller": {
 			"name": "@page-agent/page-controller",
-			"version": "0.0.18",
+			"version": "0.0.19",
 			"license": "MIT"
 		},
 		"packages/ui": {
 			"name": "@page-agent/ui",
-			"version": "0.0.18",
+			"version": "0.0.19",
 			"license": "MIT",
 			"dependencies": {
 				"ai-motion": "^0.4.7"
@@ -8195,7 +8175,7 @@
 		},
 		"packages/website": {
 			"name": "@page-agent/website",
-			"version": "0.0.18",
+			"version": "0.0.19",
 			"dependencies": {
 				"@radix-ui/react-icons": "^1.3.2",
 				"@radix-ui/react-separator": "^1.1.8",
@@ -8205,10 +8185,10 @@
 				"class-variance-authority": "^0.7.1",
 				"clsx": "^2.1.1",
 				"lucide-react": "^0.562.0",
-				"motion": "^12.23.26",
+				"motion": "^12.24.0",
 				"next-themes": "^0.4.6",
 				"rough-notation": "^0.5.1",
-				"simple-icons": "^16.2.0",
+				"simple-icons": "^16.4.0",
 				"sonner": "^2.0.7",
 				"tailwind-merge": "^3.4.0"
 			},
@@ -8221,7 +8201,7 @@
 				"i18next-browser-languagedetector": "^8.2.0",
 				"react": "^19.2.3",
 				"react-dom": "^19.2.3",
-				"react-i18next": "^16.5.0",
+				"react-i18next": "^16.5.1",
 				"tailwindcss": "^4.1.14",
 				"tw-animate-css": "^1.4.0",
 				"wouter": "^3.9.0"
@@ -1,7 +1,7 @@
 {
 	"name": "root",
 	"private": true,
-	"version": "0.0.18",
+	"version": "0.0.19",
 	"type": "module",
 	"workspaces": [
 		"packages/page-controller",
@@ -34,26 +34,26 @@
 		"prepare": "husky"
 	},
 	"devDependencies": {
-		"@commitlint/cli": "^20.2.0",
-		"@commitlint/config-conventional": "^20.2.0",
+		"@commitlint/cli": "^20.3.0",
+		"@commitlint/config-conventional": "^20.3.0",
 		"@eslint/js": "^9.39.2",
 		"@microsoft/api-extractor": "^7.55.2",
-		"@trivago/prettier-plugin-sort-imports": "^6.0.0",
+		"@trivago/prettier-plugin-sort-imports": "^6.0.1",
 		"@types/node": "^25.0.3",
 		"concurrently": "^9.2.1",
 		"dotenv": "^17.2.3",
 		"eslint": "^9.39.2",
 		"eslint-config-prettier": "^10.1.8",
-		"eslint-plugin-react-dom": "^2.3.13",
+		"eslint-plugin-react-dom": "^2.5.1",
 		"eslint-plugin-react-hooks": "^7.0.1",
 		"eslint-plugin-react-refresh": "^0.4.26",
-		"eslint-plugin-react-x": "^2.3.13",
+		"eslint-plugin-react-x": "^2.5.1",
 		"globals": "^16.4.0",
 		"husky": "^9.1.7",
 		"lint-staged": "^16.2.4",
 		"prettier": "^3.7.4",
 		"typescript": "^5.9.3",
-		"typescript-eslint": "^8.50.1",
+		"typescript-eslint": "^8.52.0",
 		"unplugin-dts": "^1.0.0-beta.6",
 		"vite": "^7.3.0",
 		"vite-plugin-css-injected-by-js": "^3.5.2"
@@ -1,6 +1,6 @@
 {
 	"name": "@page-agent/llms",
-	"version": "0.0.18",
+	"version": "0.0.19",
 	"type": "module",
 	"main": "./dist/lib/page-agent-llms.js",
 	"module": "./dist/lib/page-agent-llms.js",
@@ -38,6 +38,6 @@
 	},
 	"dependencies": {
 		"chalk": "^5.6.2",
-		"zod": "^4.2.1"
+		"zod": "^4.3.5"
 	}
 }
@@ -38,7 +38,6 @@ export class OpenAIClient implements LLMClient {
 					modelPatch({
 						model: this.config.model,
 						temperature: this.config.temperature,
-						max_tokens: this.config.maxTokens,
 						messages,

 						tools: openaiTools,
@@ -35,7 +35,6 @@ export class OpenAIClient implements LLMClient {
 					modelPatch({
 						model: this.config.model,
 						temperature: this.config.temperature,
-						max_tokens: this.config.maxTokens,
 						messages,

 						tools: openaiTools,
@@ -18,4 +18,3 @@ export const DEFAULT_BASE_URL: string =

 export const LLM_MAX_RETRIES = 2
 export const DEFAULT_TEMPERATURE = 0.7 // higher randomness helps auto-recovery
-export const DEFAULT_MAX_TOKENS = 16000
@@ -35,7 +35,6 @@ import { OpenAIClient } from './OpenAILenientClient'
 import {
 	DEFAULT_API_KEY,
 	DEFAULT_BASE_URL,
-	DEFAULT_MAX_TOKENS,
 	DEFAULT_MODEL_NAME,
 	DEFAULT_TEMPERATURE,
 	LLM_MAX_RETRIES,
@@ -69,7 +68,6 @@ export function parseLLMConfig(config: LLMConfig): Required<LLMConfig> {
 		apiKey: config.apiKey ?? DEFAULT_API_KEY,
 		model: config.model ?? DEFAULT_MODEL_NAME,
 		temperature: config.temperature ?? DEFAULT_TEMPERATURE,
-		maxTokens: config.maxTokens ?? DEFAULT_MAX_TOKENS,
 		maxRetries: config.maxRetries ?? LLM_MAX_RETRIES,
 		customFetch: (config.customFetch ?? fetch).bind(globalThis), // fetch will be illegal unless bound
 	}
@@ -73,7 +73,6 @@ export interface LLMConfig {
 	model?: string

 	temperature?: number
-	maxTokens?: number
 	maxRetries?: number

 	/**
@@ -1,7 +1,7 @@
 {
 	"name": "page-agent",
 	"private": false,
-	"version": "0.0.18",
+	"version": "0.0.19",
 	"type": "module",
 	"main": "./dist/esm/page-agent.js",
 	"module": "./dist/esm/page-agent.js",
@@ -45,9 +45,9 @@
 	},
 	"dependencies": {
 		"chalk": "^5.6.2",
-		"zod": "^4.2.1",
-		"@page-agent/llms": "0.0.18",
-		"@page-agent/page-controller": "0.0.18",
-		"@page-agent/ui": "0.0.18"
+		"zod": "^4.3.5",
+		"@page-agent/llms": "0.0.19",
+		"@page-agent/page-controller": "0.0.19",
+		"@page-agent/ui": "0.0.19"
 	}
 }
@@ -361,25 +361,49 @@ export class PageAgent extends EventTarget {
 		return systemPrompt
 	}

+	/**
+	 * Get instructions from config and format as XML block
+	 */
+	async #getInstructions(): Promise<string> {
+		const { instructions } = this.config
+		if (!instructions) return ''
+
+		const systemInstructions = instructions.system?.trim()
+		const url = await this.pageController.getCurrentUrl()
+		let pageInstructions: string | undefined
+
+		if (instructions.getPageInstructions) {
+			try {
+				pageInstructions = instructions.getPageInstructions(url)?.trim()
+			} catch (error) {
+				console.error(
+					chalk.red('[PageAgent] Failed to execute getPageInstructions callback:'),
+					error
+				)
+			}
+		}
+		if (!systemInstructions && !pageInstructions) return ''
+
+		let result = '<instructions>\n'
+
+		if (systemInstructions) {
+			result += `<system_instructions>\n${systemInstructions}\n</system_instructions>\n`
+		}
+
+		if (pageInstructions) {
+			result += `<page_instructions>\n${pageInstructions}\n</page_instructions>\n`
+		}
+
+		result += '</instructions>\n\n'
+
+		return result
+	}
+
 	async #assembleUserPrompt(): Promise<string> {
 		let prompt = ''

-		// <agent_history>
-		//  - <step_>
-
-		prompt += '<agent_history>\n'
-
-		this.history.forEach((history, index) => {
-			prompt += `<step_${index + 1}>
-				Evaluation of Previous Step: ${history.brain.evaluation_previous_goal}
-				Memory: ${history.brain.memory}
-				Next Goal: ${history.brain.next_goal}
-				Action Results: ${history.action.output}
-				</step_${index + 1}>
-			`
-		})
-
-		prompt += '</agent_history>\n\n'
+		// <instructions> (optional)
+		prompt += await this.#getInstructions()

 		// <agent_state>
 		//  - <user_request>
@@ -397,6 +421,23 @@ export class PageAgent extends EventTarget {
 			</agent_state>
 		`

+		// <agent_history>
+		//  - <step_>
+
+		prompt += '\n<agent_history>\n'
+
+		this.history.forEach((history, index) => {
+			prompt += `<step_${index + 1}>
+				Evaluation of Previous Step: ${history.brain.evaluation_previous_goal}
+				Memory: ${history.brain.memory}
+				Next Goal: ${history.brain.next_goal}
+				Action Results: ${history.action.output}
+				</step_${index + 1}>
+			`
+		})
+
+		prompt += '</agent_history>\n\n'
+
 		// <browser_state>

 		prompt += await this.#getBrowserState()
@@ -42,6 +42,24 @@ export interface AgentConfig {
 	 */
 	customTools?: Record<string, PageAgentTool | null>

+	/**
+	 * Instructions to guide the agent's behavior
+	 */
+	instructions?: {
+		/**
+		 * Global system-level instructions, applied to all tasks
+		 */
+		system?: string
+
+		/**
+		 * Dynamic page-level instructions callback
+		 * Called before each step to get instructions for the current page
+		 * @param url - Current page URL (window.location.href)
+		 * @returns Instructions string, or undefined/null to skip
+		 */
+		getPageInstructions?: (url: string) => string | undefined | null
+	}
+
 	// lifecycle hooks
 	// @todo: use event instead of hooks

@@ -1,6 +1,6 @@
 {
 	"name": "@page-agent/page-controller",
-	"version": "0.0.18",
+	"version": "0.0.19",
 	"type": "module",
 	"main": "./dist/lib/page-controller.js",
 	"module": "./dist/lib/page-controller.js",
@@ -1,6 +1,6 @@
 {
 	"name": "@page-agent/ui",
-	"version": "0.0.18",
+	"version": "0.0.19",
 	"type": "module",
 	"main": "./dist/lib/page-agent-ui.js",
 	"module": "./dist/lib/page-agent-ui.js",
@@ -12,7 +12,7 @@ export class I18n {

 	constructor(language: SupportedLanguage = 'en-US') {
 		this.language = language in locales ? language : 'en-US'
-		this.translations = locales[language]
+		this.translations = locales[this.language]
 	}

 	// 类型安全的翻译方法
@@ -1,7 +1,7 @@
 {
 	"name": "@page-agent/website",
 	"private": true,
-	"version": "0.0.18",
+	"version": "0.0.19",
 	"type": "module",
 	"scripts": {
 		"dev": "vite",
@@ -18,7 +18,7 @@
 		"i18next-browser-languagedetector": "^8.2.0",
 		"react": "^19.2.3",
 		"react-dom": "^19.2.3",
-		"react-i18next": "^16.5.0",
+		"react-i18next": "^16.5.1",
 		"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.23.26",
+		"motion": "^12.24.0",
 		"next-themes": "^0.4.6",
 		"rough-notation": "^0.5.1",
-		"simple-icons": "^16.2.0",
+		"simple-icons": "^16.4.0",
 		"sonner": "^2.0.7",
 		"tailwind-merge": "^3.4.0"
 	}
@@ -34,7 +34,7 @@ export default function DocsLayout({ children }: DocsLayoutProps) {
 			items: [
 				{ title: t('nav.model_integration'), path: '/docs/features/model-integration' },
 				{ title: t('nav.custom_tools'), path: '/docs/features/custom-tools' },
-				{ title: t('nav.knowledge_injection'), path: '/docs/features/knowledge-injection' },
+				{ title: t('nav.knowledge_injection'), path: '/docs/features/custom-instructions' },
 				{ title: t('nav.security_permissions'), path: '/docs/features/security-permissions' },
 				{ title: t('nav.data_masking'), path: '/docs/features/data-masking' },
 			],
@@ -0,0 +1,135 @@
+import { useTranslation } from 'react-i18next'
+
+import CodeEditor from '@/components/CodeEditor'
+
+export default function Instructions() {
+	const { i18n } = useTranslation()
+	const isZh = i18n.language === 'zh-CN'
+
+	return (
+		<div>
+			<h1 className="text-4xl font-bold mb-6">{isZh ? '知识注入' : 'Instructions'}</h1>
+
+			<p className="text-xl text-gray-600 dark:text-gray-300 mb-8 leading-relaxed">
+				{isZh
+					? '通过 instructions 配置，为 AI 注入系统级指导和页面级上下文，让它更好地理解你的业务场景。'
+					: 'Use the instructions config to inject system-level directives and page-specific context, helping the AI better understand your application.'}
+			</p>
+
+			{/* System Instructions */}
+			<section className="mb-12">
+				<h2 className="text-3xl font-bold mb-6">
+					{isZh ? '系统级指导 (System Instructions)' : 'System Instructions'}
+				</h2>
+
+				<p className="text-gray-600 dark:text-gray-300 mb-6">
+					{isZh
+						? '全局提示词，应用于所有任务。定义 AI 的角色、工作风格和行为边界。'
+						: "Global directives applied to all tasks. Define the AI's role, working style, and behavioral boundaries."}
+				</p>
+
+				<CodeEditor
+					className="mb-6"
+					code={`const agent = new PageAgent({
+  // ...other config
+  instructions: {
+    system: \`
+You are a professional e-commerce assistant.
+
+Guidelines:
+- Always confirm before submitting orders
+- Double-check prices and quantities
+- Report errors immediately instead of retrying blindly
+\`
+  }
+})`}
+				/>
+			</section>
+
+			{/* Page Instructions */}
+			<section className="mb-12">
+				<h2 className="text-3xl font-bold mb-6">
+					{isZh ? '页面级指导 (Page Instructions)' : 'Page Instructions'}
+				</h2>
+
+				<p className="text-gray-600 dark:text-gray-300 mb-6">
+					{isZh
+						? '动态回调函数，在每个 step 执行前调用，根据当前页面 URL 返回特定提示词。适用于为不同页面提供针对性的操作引导。'
+						: 'A dynamic callback invoked before each step. Returns page-specific instructions based on the current URL. Useful for providing targeted guidance on different pages.'}
+				</p>
+
+				<CodeEditor
+					className="mb-6"
+					code={`const agent = new PageAgent({
+  // ...other config
+  instructions: {
+    system: 'You are an order management assistant.',
+
+    getPageInstructions: (url) => {
+      if (url.includes('/checkout')) {
+        return \`
+This is the checkout page.
+- Verify shipping address before proceeding
+- Check if any discounts are applied
+- Confirm the total amount with the user
+\`
+      }
+
+      if (url.includes('/products')) {
+        return \`
+This is the product listing page.
+- Use filters to narrow down search results
+- Check stock availability before adding to cart
+\`
+      }
+
+      return undefined // No special instructions for other pages
+    }
+  }
+})`}
+				/>
+			</section>
+
+			{/* How It Works */}
+			<section className="mb-12">
+				<h2 className="text-3xl font-bold mb-6">{isZh ? '工作原理' : 'How It Works'}</h2>
+
+				<p className="text-gray-600 dark:text-gray-300 mb-4">
+					{isZh
+						? '在每个执行步骤之前，page-agent 会将 instructions 拼接到用户提示词中：'
+						: 'Before each execution step, page-agent prepends the instructions to the user prompt:'}
+				</p>
+
+				<CodeEditor
+					language="xml"
+					className="mb-6"
+					code={`<instructions>
+<system_instructions>
+You are a professional e-commerce assistant.
+...
+</system_instructions>
+<page_instructions>
+This is the checkout page.
+...
+</page_instructions>
+</instructions>
+
+<!-- followed by agent state, history, and browser state -->`}
+				/>
+
+				<ul className="list-disc list-inside space-y-2 text-gray-600 dark:text-gray-400">
+					<li>
+						{isZh
+							? '如果 system 为空，则不输出 <system_instructions> 标签'
+							: 'If system is empty, the <system_instructions> tag is omitted'}
+					</li>
+					<li>
+						{isZh
+							? '如果 getPageInstructions 返回空值，则不输出 <page_instructions> 标签'
+							: 'If getPageInstructions returns empty, the <page_instructions> tag is omitted'}
+					</li>
+				</ul>
+			</section>
+		</div>
+	)
+}
@@ -1,162 +0,0 @@
-import BetaNotice from '@/components/BetaNotice'
-import CodeEditor from '@/components/CodeEditor'
-
-export default function KnowledgeInjection() {
-	return (
-		<div>
-			<h1 className="text-4xl font-bold mb-6">知识库注入</h1>
-
-			<BetaNotice />
-
-			<p className="text-xl text-gray-600 dark:text-gray-300 mb-8 leading-relaxed">
-				通过多层次的知识注入，让 AI 深度理解你的业务场景和应用逻辑，实现更精准的自动化操作。
-			</p>
-
-			{/* Custom Instruction */}
-			<section className="mb-12">
-				<h2 className="text-3xl font-bold mb-6">Instruction - 系统指令</h2>
-
-				<div className="p-6 bg-purple-50 dark:bg-purple-900/20 rounded-lg mb-6">
-					<h3 className="text-xl font-semibold mb-3 text-purple-900 dark:text-purple-300">
-						🎯 系统级指令
-					</h3>
-					<p className="text-gray-600 dark:text-gray-300 mb-4">
-						为 AI 设定全局行为准则和工作风格。
-					</p>
-					<ul className="list-disc list-inside space-y-2 text-gray-500 dark:text-gray-400">
-						<li>定义 AI 的工作风格和交互方式</li>
-						<li>设置安全边界和操作限制</li>
-						<li>指定错误处理和异常情况的应对策略</li>
-						<li>配置输出格式和反馈机制</li>
-					</ul>
-				</div>
-
-				<CodeEditor
-					className="mb-6"
-					code={`// 构造函数中设置系统指令
-const pageAgent = new PageAgent({
-  instruction: \`
-# 角色定义
-你是专业的电商运营助手。
-
-# 工作风格
- 谨慎：操作前确认
- 准确：确保正确性
- 高效：优化流程
-
-# 错误处理
-遇到错误时暂停并报告。
-\`
-});`}
-				/>
-			</section>
-
-			{/* App Knowledge */}
-			<section className="mb-12">
-				<h2 className="text-3xl font-bold mb-6">App Knowledge - 应用知识</h2>
-
-				<div className="p-6 bg-blue-50 dark:bg-blue-900/20 rounded-lg mb-6">
-					<h3 className="text-xl font-semibold mb-3 text-blue-900 dark:text-blue-300">
-						� 业务领域知识
-					</h3>
-					<p className="text-gray-600 dark:text-gray-300 mb-4">
-						注入应用的核心业务知识，包括产品介绍、操作流程、术语定义等，让 AI 理解业务上下文。
-					</p>
-					<div className="grid md:grid-cols-2 gap-4">
-						<div className="space-y-2">
-							<h4 className="font-semibold text-blue-800 dark:text-blue-200">产品知识</h4>
-							<ul className="list-disc list-inside text-sm text-gray-500 dark:text-gray-400 space-y-1">
-								<li>产品功能和特性介绍</li>
-								<li>用户角色和权限体系</li>
-								<li>业务规则和约束条件</li>
-							</ul>
-						</div>
-						<div className="space-y-2">
-							<h4 className="font-semibold text-blue-800 dark:text-blue-200">操作指南</h4>
-							<ul className="list-disc list-inside text-sm text-gray-500 dark:text-gray-400 space-y-1">
-								<li>标准操作流程定义</li>
-								<li>异常情况处理方案</li>
-								<li>术语和概念解释</li>
-							</ul>
-						</div>
-					</div>
-				</div>
-
-				<CodeEditor
-					className="mb-6"
-					code={`// 应用知识
-pageAgent.knowledge.setAppKnowledge(\`
-# 产品介绍
-电商管理系统：面向中小企业的一站式解决方案。
-
-# 操作流程
-## 商品上架
-1. 进入商品管理页面 2. 点击新增商品 3. 填写基本信息 4. 设置库存 5. 提交审核
-
-# 术语解释
- SKU：库存量单位
- SPU：标准产品单位
- 运费模板：物流费用计算规则
-
-# 业务规则
- 库存为0时自动下架
- VIP会员享9.5折
-\`);`}
-				/>
-			</section>
-
-			{/* Page Knowledge */}
-			<section className="mb-12">
-				<h2 className="text-3xl font-bold mb-6">Page Knowledge - 页面知识</h2>
-
-				<div className="p-6 bg-green-50 dark:bg-green-900/20 rounded-lg mb-6">
-					<h3 className="text-xl font-semibold mb-3 text-green-900 dark:text-green-300">
-						📄 页面级精准指导
-					</h3>
-					<p className="text-gray-600 dark:text-gray-300 mb-4">
-						为特定页面提供精确的操作指导和元素说明，让 AI 准确理解页面结构和交互逻辑。
-					</p>
-					<div className="grid md:grid-cols-3 gap-4">
-						<div className="space-y-2">
-							<h4 className="font-semibold text-green-800 dark:text-green-200">元素标注</h4>
-							<p className="text-sm text-gray-500 dark:text-gray-400">为页面元素添加语义化描述</p>
-						</div>
-						<div className="space-y-2">
-							<h4 className="font-semibold text-green-800 dark:text-green-200">交互说明</h4>
-							<p className="text-sm text-gray-500 dark:text-gray-400">
-								定义元素的交互行为和预期结果
-							</p>
-						</div>
-						<div className="space-y-2">
-							<h4 className="font-semibold text-green-800 dark:text-green-200">页面逻辑</h4>
-							<p className="text-sm text-gray-500 dark:text-gray-400">
-								说明页面的业务逻辑和状态变化
-							</p>
-						</div>
-					</div>
-				</div>
-
-				<CodeEditor
-					className="mb-6"
-					code={`// 页面知识库
-// 添加页面知识
-pageAgent.knowledge.addPageKnowledge("/products", \`
-商品列表页面，包含搜索、筛选、批量操作功能。
-#add-product-btn：新增商品按钮
-.product-item：商品列表项
-#search-input：搜索框，最少2个字符
-\`);
-
-pageAgent.knowledge.addPageKnowledge("/orders/*", \`
-订单详情页面。
-.order-status：订单状态标签
-#update-status-btn：状态更新按钮
-\`);
-
-// 移除页面知识
-pageAgent.knowledge.removePageKnowledge("/products");`}
-				/>
-			</section>
-		</div>
-	)
-}
@@ -16,7 +16,6 @@ interface LLMConfig {
 	apiKey?: string
 	model?: string
 	temperature?: number
-	maxTokens?: number
 	maxRetries?: number

 	/**
@@ -55,7 +55,7 @@ const DEMO_BASE_URL = 'https://hwcxiuzfylggtcktqgij.supabase.co/functions/v1/llm
 const DEMO_API_KEY = 'PAGE-AGENT-FREE-TESTING-RANDOM'

 const agent = new PageAgent({
-  modelName: DEMO_MODEL,
+  model: DEMO_MODEL,
  baseURL: DEMO_BASE_URL,
  apiKey: DEMO_API_KEY,
  language: 'zh-CN'
@@ -29,7 +29,7 @@ export default {
 		limitations: 'Limitations',
 		model_integration: 'Model Integration',
 		custom_tools: 'Custom Tools',
-		knowledge_injection: 'Knowledge Injection',
+		knowledge_injection: 'Instructions',
 		security_permissions: 'Security & Permissions',
 		data_masking: 'Data Masking',
 		cdn_setup: 'CDN Setup',
@@ -28,7 +28,7 @@ export default {
 		limitations: '使用限制',
 		model_integration: '模型接入',
 		custom_tools: '自定义工具',
-		knowledge_injection: '知识库注入',
+		knowledge_injection: '知识注入',
 		security_permissions: '安全与权限',
 		data_masking: '数据脱敏',
 		cdn_setup: 'CDN 引入',
@@ -64,6 +64,15 @@ export default function HomePage() {
 				interactiveBlacklist: [document.getElementById('root')!],
 				language: i18n.language as any,

+				instructions: {
+					system: 'You are a helpful assistant on PageAgent website.',
+					getPageInstructions: (url) => {
+						const hint = url.includes('page-agent') ? 'This is PageAgent demo page.' : undefined
+						console.log('[instructions] getPageInstructions:', url, '->', hint)
+						return hint
+					},
+				},
+
 				// experimentalScriptExecutionTool: true,

 				// testing server
@@ -2,10 +2,10 @@ import { Route, Switch } from 'wouter'

 import DocsLayout from './components/DocsLayout'
 import Header from './components/Header'
+import Instructions from './docs/features/custom-instructions/page'
 // Features pages
 import CustomTools from './docs/features/custom-tools/page'
 import DataMasking from './docs/features/data-masking/page'
-import KnowledgeInjection from './docs/features/knowledge-injection/page'
 import ModelIntegration from './docs/features/model-integration/page'
 import SecurityPermissions from './docs/features/security-permissions/page'
 import BestPractices from './docs/integration/best-practices/page'
@@ -80,11 +80,11 @@ export default function Router() {
 				</div>
 			</Route>

-			<Route path="/docs/features/knowledge-injection">
+			<Route path="/docs/features/custom-instructions">
 				<div className="min-h-screen bg-white dark:bg-gray-900">
 					<Header />
 					<DocsLayout>
-						<KnowledgeInjection />
+						<Instructions />
 					</DocsLayout>
 				</div>
 			</Route>
Author	SHA1	Message	Date
Simon	f5900bd096	chore(version): bump version to 0.0.19	2026-01-10 23:35:02 +08:00
Simon	09772d79bd	fix: panel language not found	2026-01-10 23:33:36 +08:00
Simon	bfa6a5347e	fix: rm maxTokens from api	2026-01-10 23:27:08 +08:00
Simon	da5cf44012	Merge pull request #97 from alibaba/feat/instructions feat: custom instructions	2026-01-10 19:27:27 +08:00
Simon	1666c08e58	refactor: rename `instructions` to `custom-instructions`	2026-01-10 19:25:56 +08:00
Simon	0c0c76fdd8	feat: wrap user callback in try catch Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>	2026-01-10 19:23:02 +08:00
Simon	6b0b1218ac	chore: cleanup	2026-01-10 19:23:01 +08:00
Simon	d70f652285	chore(website): add instructions for PageAgent demo page	2026-01-10 19:08:50 +08:00
Simon	c3c01b63fb	docs: upgrade docs for custom instructions	2026-01-10 19:02:18 +08:00
Simon	463d010c24	feat(agent): add instructions api	2026-01-10 18:44:09 +08:00
Simon	4e52f17b9f	feat(agent): mv <agent_state> in front of <agent_history>	2026-01-10 17:44:08 +08:00
Simon	5237edfcca	Merge branch 'main' of https://github.com/alibaba/page-agent	2026-01-07 19:58:56 +08:00
Simon	79dcf9d9e4	docs: fix api doc, should be `model` instead of `modelName`	2026-01-07 19:58:43 +08:00
Simon	09544205ed	Merge pull request #91 from alibaba/dependabot/npm_and_yarn/production-dependencies-d50d67c463 chore(deps): bump the production-dependencies group across 1 directory with 3 updates	2026-01-07 19:28:54 +08:00
Simon	2c74c3170a	Merge pull request #92 from alibaba/dependabot/npm_and_yarn/development-dependencies-f82d5f2ef0 chore(deps-dev): bump the development-dependencies group across 1 directory with 7 updates	2026-01-07 19:28:40 +08:00
dependabot[bot]	9cee8f4174	chore(deps-dev): bump the development-dependencies group across 1 directory with 7 updates Bumps the development-dependencies group with 7 updates in the / directory: \| Package \| From \| To \| \| --- \| --- \| --- \| \| [@commitlint/cli](https://github.com/conventional-changelog/commitlint/tree/HEAD/@commitlint/cli) \| `20.2.0` \| `20.3.0` \| \| [@commitlint/config-conventional](https://github.com/conventional-changelog/commitlint/tree/HEAD/@commitlint/config-conventional) \| `20.2.0` \| `20.3.0` \| \| [@trivago/prettier-plugin-sort-imports](https://github.com/trivago/prettier-plugin-sort-imports) \| `6.0.0` \| `6.0.1` \| \| [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/HEAD/packages/plugins/eslint-plugin-react-dom) \| `2.3.13` \| `2.5.1` \| \| [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/HEAD/packages/plugins/eslint-plugin-react-x) \| `2.3.13` \| `2.5.1` \| \| [typescript-eslint](https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/typescript-eslint) \| `8.50.1` \| `8.52.0` \| \| [react-i18next](https://github.com/i18next/react-i18next) \| `16.5.0` \| `16.5.1` \| Updates `@commitlint/cli` from 20.2.0 to 20.3.0 - [Release notes](https://github.com/conventional-changelog/commitlint/releases) - [Changelog](https://github.com/conventional-changelog/commitlint/blob/master/@commitlint/cli/CHANGELOG.md) - [Commits](https://github.com/conventional-changelog/commitlint/commits/v20.3.0/@commitlint/cli) Updates `@commitlint/config-conventional` from 20.2.0 to 20.3.0 - [Release notes](https://github.com/conventional-changelog/commitlint/releases) - [Changelog](https://github.com/conventional-changelog/commitlint/blob/master/@commitlint/config-conventional/CHANGELOG.md) - [Commits](https://github.com/conventional-changelog/commitlint/commits/v20.3.0/@commitlint/config-conventional) Updates `@trivago/prettier-plugin-sort-imports` from 6.0.0 to 6.0.1 - [Release notes](https://github.com/trivago/prettier-plugin-sort-imports/releases) - [Changelog](https://github.com/trivago/prettier-plugin-sort-imports/blob/main/CHANGELOG.md) - [Commits](https://github.com/trivago/prettier-plugin-sort-imports/compare/v6.0.0...v6.0.1) Updates `eslint-plugin-react-dom` from 2.3.13 to 2.5.1 - [Release notes](https://github.com/Rel1cx/eslint-react/releases) - [Changelog](https://github.com/Rel1cx/eslint-react/blob/main/CHANGELOG.md) - [Commits](https://github.com/Rel1cx/eslint-react/commits/v2.5.1/packages/plugins/eslint-plugin-react-dom) Updates `eslint-plugin-react-x` from 2.3.13 to 2.5.1 - [Release notes](https://github.com/Rel1cx/eslint-react/releases) - [Changelog](https://github.com/Rel1cx/eslint-react/blob/main/CHANGELOG.md) - [Commits](https://github.com/Rel1cx/eslint-react/commits/v2.5.1/packages/plugins/eslint-plugin-react-x) Updates `typescript-eslint` from 8.50.1 to 8.52.0 - [Release notes](https://github.com/typescript-eslint/typescript-eslint/releases) - [Changelog](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/typescript-eslint/CHANGELOG.md) - [Commits](https://github.com/typescript-eslint/typescript-eslint/commits/v8.52.0/packages/typescript-eslint) Updates `react-i18next` from 16.5.0 to 16.5.1 - [Changelog](https://github.com/i18next/react-i18next/blob/master/CHANGELOG.md) - [Commits](https://github.com/i18next/react-i18next/compare/v16.5.0...v16.5.1) --- updated-dependencies: - dependency-name: "@commitlint/cli" dependency-version: 20.3.0 dependency-type: direct:development update-type: version-update:semver-minor dependency-group: development-dependencies - dependency-name: "@commitlint/config-conventional" dependency-version: 20.3.0 dependency-type: direct:development update-type: version-update:semver-minor dependency-group: development-dependencies - dependency-name: "@trivago/prettier-plugin-sort-imports" dependency-version: 6.0.1 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: development-dependencies - dependency-name: eslint-plugin-react-dom dependency-version: 2.5.1 dependency-type: direct:development update-type: version-update:semver-minor dependency-group: development-dependencies - dependency-name: eslint-plugin-react-x dependency-version: 2.5.1 dependency-type: direct:development update-type: version-update:semver-minor dependency-group: development-dependencies - dependency-name: typescript-eslint dependency-version: 8.52.0 dependency-type: direct:development update-type: version-update:semver-minor dependency-group: development-dependencies - dependency-name: react-i18next dependency-version: 16.5.1 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: development-dependencies ... Signed-off-by: dependabot[bot] <support@github.com>	2026-01-05 19:38:18 +00:00
dependabot[bot]	d05b43cf50	chore(deps): bump the production-dependencies group across 1 directory with 3 updates Bumps the production-dependencies group with 3 updates in the / directory: [zod](https://github.com/colinhacks/zod), [motion](https://github.com/motiondivision/motion) and [simple-icons](https://github.com/simple-icons/simple-icons). Updates `zod` from 4.2.1 to 4.3.5 - [Release notes](https://github.com/colinhacks/zod/releases) - [Commits](https://github.com/colinhacks/zod/compare/v4.2.1...v4.3.5) Updates `motion` from 12.23.26 to 12.24.0 - [Changelog](https://github.com/motiondivision/motion/blob/main/CHANGELOG.md) - [Commits](https://github.com/motiondivision/motion/compare/v12.23.26...v12.24.0) Updates `simple-icons` from 16.2.0 to 16.4.0 - [Release notes](https://github.com/simple-icons/simple-icons/releases) - [Commits](https://github.com/simple-icons/simple-icons/compare/16.2.0...16.4.0) --- updated-dependencies: - dependency-name: zod dependency-version: 4.3.5 dependency-type: direct:production update-type: version-update:semver-minor dependency-group: production-dependencies - dependency-name: motion dependency-version: 12.24.0 dependency-type: direct:production update-type: version-update:semver-minor dependency-group: production-dependencies - dependency-name: simple-icons dependency-version: 16.4.0 dependency-type: direct:production update-type: version-update:semver-minor dependency-group: production-dependencies ... Signed-off-by: dependabot[bot] <support@github.com>	2026-01-05 19:37:33 +00:00