katu_agent/lib.rs
1//! # katu-agent
2//!
3//! ## 职责
4//! Agent loop 实现 — 消费 LLM 流式响应，驱动工具执行，产出 AgentEvent。
5//!
6//! ## 模块
7//! - `error` — 统一错误类型 (`AgentError`)
8//! - `retry` — 重试策略配置 (`RetryConfig`)
9//! - `instance` — Agent 运行实例 (`AgentInstance`, `InstanceBuilder`, `RunConfig`)
10//! - `prompt` — 模块化 prompt 构建系统
11//! - `runner` — Agent loop 核心驱动器 (`Runner`, `RunOutcome`)
12//! - `session` — 会话状态管理 (`Session`)
13//! - `stream_consumer` — 将 `StreamEvent` 流累积为 `AssistantMessage` + 实时发射 `AgentEvent`
14//! - `tool_executor` — 工具批量执行与权限管线
15//!
16//! ## 依赖
17//! - `katu-core` — 类型定义 (StreamEvent, AgentEvent, Message, Tool...)
18//! - `katu-llm` — LLM 抽象层 (Provider, ModelRef, LlmRequest)
19
20pub mod compaction;
21pub mod error;
22pub(crate) mod event_sender;
23pub mod instance;
24pub mod prompt;
25pub mod retry;
26pub mod runner;
27pub mod session;
28pub mod stream_consumer;
29pub mod tool_executor;