AgentSession、事件与消息队列

AgentSession 职责

AgentSession 管理消息历史、模型状态、工具、Compaction、Session 持久化和事件。prompt 等待一次代理运行，steer 和 followUp 在运行中安排不同时间的消息。

subscribe 返回取消订阅函数。服务关闭或用户离开时要取消监听并 abort 未完成任务。

• agent_start 和 agent_end 表示完整运行。
• turn_start 和 turn_end 表示一次模型与工具循环。
• message_update 提供流式文本和推理事件。
• tool_execution 事件提供开始、增量和结束。
• queue_update 展示 steering 与 follow-up 队列。

队列语义

steer 在当前 assistant turn 完成工具调用后进入下一次模型调用，followUp 在代理完全停止后执行。调用方应把状态显示给用户，防止看似丢失消息。

取消和超时后检查部分工具是否已经产生副作用。