From 1ab23e181f8f96aa0adb06b19b130dca10426d93 Mon Sep 17 00:00:00 2001 From: Simon <10131203+gaomeng1900@users.noreply.github.com> Date: Sat, 17 Jan 2026 01:23:23 +0800 Subject: [PATCH] chore: clean up --- packages/llms/README.md | 41 -------------------------------------- packages/website/README.md | 1 - 2 files changed, 42 deletions(-) delete mode 100644 packages/llms/README.md delete mode 100644 packages/website/README.md diff --git a/packages/llms/README.md b/packages/llms/README.md deleted file mode 100644 index 261c456..0000000 --- a/packages/llms/README.md +++ /dev/null @@ -1,41 +0,0 @@ -# @page-agent/llms - -LLM client with a **reflection-before-action** mental model for page-agent. - -## Why This Package Exists - -The LLM module and the agent logic are inherently coupled. This package exists not to decouple them, but to **define the interface contract** between the LLM and the agent. - -The core abstraction is the `MacroToolInput` — a structured output format that **forces the model to reflect before acting**. - -## The Reflection-Before-Action Model - -Every tool call must first output its reasoning state before the actual action: - -```typescript -interface MacroToolInput { - // Reflection (mandatory before any action) - evaluation_previous_goal?: string // How well did the previous action work? - memory?: string // Key information to remember - next_goal?: string // What to accomplish next - - // Action (the actual operation) - action: Record -} -``` - -This design ensures that: - -1. **The model evaluates its previous action** before deciding the next step -2. **Working memory is explicitly maintained** across conversation turns -3. **Goals are clearly stated**, making the agent's reasoning transparent and debuggable - -## Key Components - -| Export | Description | -|--------|-------------| -| `LLM` | Main LLM client class with retry logic | -| `MacroToolInput` | The reflection-before-action input schema | -| `AgentBrain` | Agent's thinking state (eval, memory, goal) | -| `LLMConfig` | Configuration for LLM connection | -| `parseLLMConfig` | Parse and apply defaults to config | diff --git a/packages/website/README.md b/packages/website/README.md deleted file mode 100644 index 1709929..0000000 --- a/packages/website/README.md +++ /dev/null @@ -1 +0,0 @@ -# Landing Page & Docs