# 2026-08-13：Core 运行契约与可观测性

# 目标

将单 Agent 运行从隐式会话参数和无关联事件，收敛为可追踪的 Core 契约。

# 变更

• 新增 RuntimeContext：runId、sessionId、userId、workspace、请求级属性；
• 新增 EventEnvelope：每个核心事件带 eventId、时间戳和运行上下文；
• 新增 AgentMiddleware：Agent、推理、行动、模型、system prompt、事件观察 Hook；
• AgentLoop、CLI、Web SSE、TraceStore 改为传递事件信封；
• 所有核心 SSE payload 附带 eventId、timestamp、runId、sessionId。

# 验证

• mvn -pl pi-agent-v1 test 编译通过；
• Mock SSE 冒烟确认同次运行事件共享 runId，工具开始/结束由 toolCallId 关联。

# 边界

• Middleware 目前是同步轻量 Hook，不引入 Harness/Reactor；
• 本次不实现多 Agent、分布式状态或沙箱。