收口MCP提交为V4契约

docs/project/integrations/superagent-mcp/integration-guide.md

@@ -130,11 +130,9 @@ REST request
 5. 必要时调用 `th_hotel_list_message_conversation_tasks` 查询同一邮件会话下已有任务。
 6. 最终只在明确产出任务结果时调用 `th_hotel_submit_task_results`。
 
-写入工具里的 `source_message_id` 必须来自 AgentBus payload 的 `source.external_message_id`。SuperAgent 不需要传数据库层 provider/channel；TH Hotel 后端按系统酒店和外部消息 ID 匹配唯一 SourceMessage Inbox，真实 channel 可能是 `OUTLOOK`。
+写入工具里的 `source_message.source_message_id` 必须来自 AgentBus payload 的 `source.external_message_id`。SuperAgent 不需要传数据库层 `hotel_id` / provider / channel；TH Hotel 后端按系统酒店和外部消息 ID 匹配唯一 SourceMessage Inbox，真实 channel 可能是 `OUTLOOK`。
 
-M002 V3 后，写入工具优先接收结构化 `S10/S99` 或 `source_message + message_events[]` 业务根。`message_events[].source_event_index` 可以是 SuperAgent 内部事件 ID，例如 `E_CHILD_1`；MCP adapter 会在提交前按数组顺序映射为本系统一基数字索引，并校验跨事件关系是否悬空或重复。详细映射规则见 `submit-payload-mapping.md`。
-
-V3 业务根写入成功时，MCP tool result 会返回 `mapping_diagnostics.source_event_index_mapping[]`，用于联调排查原始事件 ID 到本系统索引的映射；该字段不是业务任务字段，不会写入 TH Hotel 业务 payload。
+M002 V4 后，写入工具只接收 V4 包级结构：`route_code + source_message + order_contexts[] + message_events[]`。旧 V2 `ai_task_results[]`、旧 V3 `case_candidates[]` / `unhandled_current_intents[]`、旧 V3 S10/S99 入口通知都会返回 `MCP_SUBMIT_V4_REQUIRED`，不会进入业务写入 Service。详细规则见 `submit-payload-mapping.md`。
 
 ## 9. 当前 checkpoint
 
@@ -150,6 +148,6 @@ checkpoint-superagent-mcp-embedded-endpoint
 - 5 个 MCP tools 均可通过 `tools/list` 发现。
 - 只读 tool 直接复用现有查询 Service。
 - 写入 tool 受 `MCP_ENABLE_SUBMIT_TASK_RESULTS` 开关控制。
-- 写入 tool 已提供 V3/P0.1 submit payload adapter 和提交前 schema validator。
+- 写入 tool 已提供 M002 V4-only submit payload adapter 和提交前 schema validator。
 - MCP endpoint 使用 Bearer Token 鉴权。
 - 文档不包含生产 Secret、真实客户数据、附件 URL 或原始邮件正文。