klaus-agent 0.1.1 → 0.2.1

package/README.md

@@ -2,7 +2,7 @@
 
 Universal agent framework SDK. Inject tools, skills, and systemPrompt to build your agent — no wrapper needed.
 
-通用 Agent 框架 SDK。注入 tools、skills、systemPrompt 即可构建 agent，无需再包一层。
+[中文文档](./README.zh-CN.md)
 
 ## Install
 
@@ -47,12 +47,11 @@ const messages = await agent.prompt("Say hello");
 
 Single package, 14 modules, zero wrappers. All capabilities are built-in and opt-in via config.
 
-单包架构，14 个模块，零包装层。所有能力内置，通过 config 按需启用。
-
 ```
 src/
 ├── core/           Agent + AgentLoop (nested dual-loop runtime)
-├── llm/            Provider abstraction + Anthropic implementation
+├── llm/            Provider registry + abstraction
+├── providers/      7 built-in providers (Anthropic, OpenAI, OpenAI Codex, Gemini, MiniMax, Kimi, Volcengine)
 ├── tools/          Tool executor (sequential/parallel) + MCP adapter
 ├── approval/       Queue-based approval system
 ├── session/        JSONL tree persistence with branching
@@ -106,19 +105,28 @@ await agent.dispose();
 
 ### LLM Provider
 
-Provider-agnostic abstraction. Built-in Anthropic provider with streaming, retry (3 attempts, exponential backoff), and extended thinking support.
+Provider-agnostic abstraction with 7 built-in providers and 3 protocol-compatible proxy modes. All providers support streaming, retry (3 attempts, exponential backoff), and extended thinking.
 
-```typescript
-import { registerProvider, resolveProvider } from "@klaus-ai/agent";
+Built-in providers: `anthropic`, `openai`, `openai-codex`, `google`, `minimax`, `kimi`, `volcengine`
 
-// Register a custom provider
-registerProvider("openai", (config) => new MyOpenAIProvider(config.apiKey));
+Protocol-compatible proxies: `openai-compatible`, `anthropic-compatible`, `gemini-compatible` — connect any compatible service by providing a `baseUrl`.
 
-// Use it
+```typescript
+// Use any built-in provider
 const agent = createAgent({
   model: { provider: "openai", model: "gpt-4", maxContextTokens: 128000 },
   ...
 });
+
+// Or connect a compatible service via proxy mode
+const agent2 = createAgent({
+  model: { provider: "openai-compatible", model: "my-model", maxContextTokens: 128000, baseUrl: "https://my-service/v1" },
+  ...
+});
+
+// Register a fully custom provider
+import { registerProvider } from "@klaus-ai/agent";
+registerProvider("my-provider", (config) => new MyProvider(config.apiKey, config.baseUrl));
 ```
 
 Provider interface: