From b72a9a8c1ccd77076fd4daa9152d1dc8d248a9d9 Mon Sep 17 00:00:00 2001
From: worldmozara <worldmozara@163.com>
Date: Tue, 14 Jul 2026 17:45:47 +0800
Subject: [PATCH] docs: document agent package in CLAUDE.md

---
 CLAUDE.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 92d4975..446f384 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -50,6 +50,13 @@ TOML load/store (`ConfigStore`): `[providers]` tagged union presets, `[database]
 
 Async SQLAlchemy + aiosqlite. `MemoryStore`: schema init, default local user, sessions, messages stored as msgspec chat message JSON.
 
+### Agent (`agent/`)
+
+- **`ChatClient`** Protocol for `chat_completions`.
+- **`@tool` / `ToolRegistry`**: decorator infers JSON Schema from type hints; execute tools by name.
+- **`run_chat_loop`**: multi-round tool loop, yields `AgentEvent` stream.
+- **`ChatAgent`**: wrapper with optional `MemoryStore` bind (load/append messages).
+
 ### Composition utility: `Forward` descriptor
 
 `utils/components.py` — `Forward[T]` / `forward()` for attribute forwarding on composed objects.