chore(version): bump version to 0.0.15

AGENTS.md

@@ -9,6 +9,7 @@ This is a **monorepo** with npm workspaces containing **two main packages**:
 
 And other internal packages:
 
+- **LLMs** (`packages/llms/`) - LLM client with reflection-before-action mental model.
 - **Page Controller** (`packages/page-controller/`) - DOM operations and element interactions. Independent of LLM.
 - **UI** (`packages/ui/`) - Panel, SimulatorMask, and i18n. Decoupled from PageAgent.
 
@@ -37,8 +38,7 @@ packages/
 ├── page-agent/              # npm: "page-agent" ⭐ MAIN
 │   ├── src/
 │   │   ├── PageAgent.ts     # Main AI agent class
-│   │   ├── tools/           # LLM tool definitions
-│   │   └── llms/            # LLM integration
+│   │   └── tools/           # LLM tool definitions
 │   ├── vite.config.js       # Library build (ES + UMD)
 │   └── package.json
 ├── website/                 # npm: "@page-agent/website" (private) ⭐ MAIN
@@ -47,6 +47,11 @@ packages/
 │
 │   # ...internal packages below...
 │
+├── llms/                    # npm: "@page-agent/llms"
+│   └── src/                 # LLM client (reflection-before-action model)
+│       ├── index.ts
+│       ├── types.ts         # MacroToolInput, AgentBrain, LLMConfig
+│       └── OpenAI*.ts       # OpenAI-compatible clients
 ├── page-controller/         # npm: "@page-agent/page-controller"
 │   └── src/                 # DOM operations
 │       ├── PageController.ts
@@ -66,6 +71,7 @@ packages/
     // internal deps (topological order)
     "packages/page-controller",
     "packages/ui",
+    "packages/llms",
     "packages/page-agent",
     "packages/website"
 ],
@@ -74,7 +80,8 @@ packages/
 ### Module Boundaries (Critical)
 
 - **Website** (`packages/website/`): CAN import from `page-agent` for demos. Alias `@/` → `website/src/`
-- **Page Agent** (`packages/page-agent/`): The core lib. Imports from `@page-agent/page-controller` and `@page-agent/ui`.
+- **Page Agent** (`packages/page-agent/`): The core lib. Imports from `@page-agent/llms`, `@page-agent/page-controller` and `@page-agent/ui`.
+- **LLMs** (`packages/llms/`): LLM client with MacroToolInput contract. No dependency on page-agent.
 - **UI** (`packages/ui/`): Panel, Mask, i18n. No dependency on page-agent.
 - **Page Controller** (`packages/page-controller/`): Pure DOM operations. No LLM or UI dependency.
 
@@ -130,9 +137,17 @@ Query params configure `PageAgentConfig` automatically in `src/entry.ts`.
 | `src/PageAgent.ts` | ⭐ Main AI agent class orchestrating tools and LLM |
 | `src/umd.ts` | CDN/UMD entry point with auto-initialization |
 | `src/tools/` | Tool definitions that call PageController methods |
-| `src/llms/` | LLM integration and communication layer |
 | `vite.config.js` | Library build configuration (ES + UMD) |
 
+### LLMs (`packages/llms/`)
+
+| File | Description |
+|------|-------------|
+| `src/index.ts` | ⭐ LLM class with retry logic |
+| `src/types.ts` | MacroToolInput, AgentBrain, LLMConfig definitions |
+| `src/OpenAILenientClient.ts` | OpenAI-compatible client with lenient parsing |
+| `src/utils.ts` | Zod-to-OpenAI conversion, model patches |
+
 ### Page Controller (`packages/page-controller/`)
 
 | File | Description |

README-zh.md

@@ -73,6 +73,7 @@ PageAgent adopts a simplified monorepo structure:
 ```
 packages/
 ├── page-agent/          # AI agent (npm: page-agent)
+├── llms/                # LLM 客户端 (npm: @page-agent/llms)
 ├── page-controller/     # DOM 操作 (npm: @page-agent/page-controller)
 ├── ui/                  # 面板 & 蒙层 & 模拟鼠标 (npm: @page-agent/ui)
 └── website/             # 文档站点

README.md

@@ -73,6 +73,7 @@ PageAgent adopts a simplified monorepo structure:
 ```
 packages/
 ├── page-agent/          # AI agent (npm: page-agent)
+├── llms/                # LLM client (npm: @page-agent/llms)
 ├── page-controller/     # DOM operations (npm: @page-agent/page-controller)
 ├── ui/                  # Panel & Mask & Mouse Animation (npm: @page-agent/ui)
 └── website/             # Demo & Documentation site

package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "root",
-	"version": "0.0.14",
+	"version": "0.0.15",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "root",
-			"version": "0.0.14",
+			"version": "0.0.15",
 			"license": "MIT",
 			"workspaces": [
 				"packages/page-controller",
@@ -7190,7 +7190,7 @@
 		},
 		"packages/llms": {
 			"name": "@page-agent/llms",
-			"version": "0.0.14",
+			"version": "0.0.15",
 			"license": "MIT",
 			"dependencies": {
 				"chalk": "^5.6.2",
@@ -7198,24 +7198,24 @@
 			}
 		},
 		"packages/page-agent": {
-			"version": "0.0.14",
+			"version": "0.0.15",
 			"license": "MIT",
 			"dependencies": {
-				"@page-agent/llms": "0.0.14",
-				"@page-agent/page-controller": "0.0.14",
-				"@page-agent/ui": "0.0.14",
+				"@page-agent/llms": "0.0.15",
+				"@page-agent/page-controller": "0.0.15",
+				"@page-agent/ui": "0.0.15",
 				"chalk": "^5.6.2",
 				"zod": "^4.2.0"
 			}
 		},
 		"packages/page-controller": {
 			"name": "@page-agent/page-controller",
-			"version": "0.0.14",
+			"version": "0.0.15",
 			"license": "MIT"
 		},
 		"packages/ui": {
 			"name": "@page-agent/ui",
-			"version": "0.0.14",
+			"version": "0.0.15",
 			"license": "MIT",
 			"dependencies": {
 				"ai-motion": "^0.4.7"
@@ -7223,7 +7223,7 @@
 		},
 		"packages/website": {
 			"name": "@page-agent/website",
-			"version": "0.0.14",
+			"version": "0.0.15",
 			"devDependencies": {
 				"@tailwindcss/vite": "^4.1.18",
 				"@types/react": "^19.2.2",

package.json

@@ -1,7 +1,7 @@
 {
 	"name": "root",
 	"private": true,
-	"version": "0.0.14",
+	"version": "0.0.15",
 	"type": "module",
 	"workspaces": [
 		"packages/page-controller",

packages/llms/package.json

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

packages/page-agent/package.json

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

packages/page-controller/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@page-agent/page-controller",
-	"version": "0.0.14",
+	"version": "0.0.15",
 	"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": "0.0.14",
+	"version": "0.0.15",
 	"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": "0.0.14",
+	"version": "0.0.15",
 	"type": "module",
 	"scripts": {
 		"dev": "vite",