变更摘要

本 PR 在 agent_hint 中新增 session_control 能力，用于表达会话生命周期控制意图。核心逻辑是在 motor/coordinator/domain/agent_hint.py 中新增 SessionControl 模型与解析函数，并提供 apply_session_control_autofill 将 pause / stop / compact / resume 等操作转换为面向 session 的 context_management 管理请求，同时保持 session_control 与 context_management 互斥；在请求分发链路中先执行自动填充，再解析并注入最小消息占位；在 OpenAI 请求校验中允许带 session_control 的空消息请求绕过非空校验。

主要改动

• 新增 SessionControl 模型与类型白名单：在 agent_hint.py 中新增 SessionControl 模型及 _SESSION_CONTROL_TYPES_ALLOWED（start / pause / stop / compact / resume）和 _SESSION_CONTROL_EDIT_TYPES 映射，非法 type 会触发校验失败或丢弃。
• 新增 apply_session_control_autofill 自动填充逻辑：将 agent_hint.session_control 的 pause / stop / compact / resume 分别转换为 session 目标的 offload / evict / evict / prefetch 管理请求；start 不注入任何上下文操作，且当 context_management 同时存在时保留后者并丢弃 session_control。
• 调整请求分发调用顺序：在 dispatch.py 中于 parse_agent_hint 之前调用 apply_session_control_autofill(request_json)，使自动填充的 context_management 对后续解析和消息注入可见。
• 放宽空消息请求校验：在 inference_server.py 的 _validate_openai_request 中，通过新增的 session_control_implies_manage_request 判断，允许 pause / stop / compact / resume 类型的空消息请求绕过非空校验，而 start 及冲突场景仍按原逻辑拒绝。
• 补充单元与接口测试：在 test_agent_hint.py 和 test_http_server.py 中新增针对 SessionControl 校验、自动填充、互斥冲突、非法类型丢弃、空消息校验绕过等场景的测试用例。

代码审查

我已逐一审查全部 5 个变更文件，并核对了关键符号的调用链与下游消费者。最终结论如下：

审查结论

发现 1 个 P1 问题：

• motor/coordinator/router/dispatch.py:371 — ensure_minimum_messages_for_session_edits 调用被 apply_session_control_autofill 直接替换（而非在其前插入），导致生产路径上不再注入默认消息。空 messages 的管理类请求（既有的 context_management manage_request + session target，以及新增的 session_control=stop/pause/compact/resume）会通过非空校验后，在下游 apply_chat_template 对空列表越界崩溃。全仓库 grep 确认该函数已无任何生产调用方，且 apply_session_control_autofill 的 docstring 与单测 test_session_control_autofill_then_minimum_messages_injection 均表明两者本应顺序执行。

各文件审查结果

总体风险判断

中高风险：本次变更引入了一个明确的功能回归——空 messages 的管理类请求（含既有 context_management 特性）将不再注入默认消息，触发下游越界崩溃，建议合入前恢复 ensure_minimum_messages_for_session_edits 调用并补充分发顺序测试。其余新增解析/校验逻辑自洽，未见独立缺陷。

⛔ 需要修改

/approve