Module session 

session

职责

运行时会话状态 — 持有一次 Agent 对话的完整内存上下文。

设计

Session 是 Agent loop 的核心数据载体：

• 消息历史 — Vec<Message> 累积对话上下文
• 运行状态 — SessionStatus 跟踪 idle/running/cancelled
• 用量累计 — 逐步累加 Usage，提供费用追踪
• 步数看护 — step_count + max_steps 防止无限循环
• 上下文窗口 — token 计数 + 预算状态，驱动压缩决策

不包含

• 持久化（属于 katu-app）
• 工具注册表 / Hook 注册表（由 Runner 注入）
• 系统 prompt 组装逻辑（属于 prompt 模块）

调用者

• katu-agent::runner (future) — Agent loop 核心循环
• katu-agent::stream_consumer — 消费结果写入 session
• katu-agent::tool_executor — 工具结果写入 session

Structs

Session

运行时会话 — 一次 Agent 对话的完整内存状态。

Enums

SessionStatus

会话运行状态。