feat(gateway): chat.documents 解析 + 修两处静默吞掉（design/24 S3-B）

- REST（同步 + stream:true）与 WS 两条入口同形解析 documents：只收服务端存储名（形态 + 真实存在 + 嗅探 MIME + 本地 URL + 大小），客户端谎报 mime/url/size 一律被服务端覆盖 ⇒ 不重开 SSRF 面（有「真实可命中 URL，命中次数 0」的用例钉住）。

- 拒绝口径对齐 S1：超过 5 条 → 400 too_many_documents（且先于任何 FS 访问）；形态非法/穿越/不存在 → 404 document_not_found。

- 挂载：一回合一条 RoleUser 消息，文档部件追加其后（纯附件回合不塞空文本块，空文本会被 provider 拒）。

- 修 S2 移交的两处静默吞掉：session_transcript 用 history.DecodeDocument 把 h.Document 还原为部件（坏列带来源 WARN 不静默、也不卡会话）；session_tail 的 messagesEmpty 计入 ContentTypeDocument（纯附件不再被判空回合）。

- 拆文件/拆函数（AGENTS：文件≤500 行、函数≤80 行）：new chat_documents.go（rest.go 原 499/500 行塞不下）、handleChat 尾段 54 行原样搬成 submitChatTurn（handleChat 90→40 行），ws_hub 增 documents 依赖（与既有 envResolver 同接法）。

- 主会话独立验收（隔离 worktree = 当前 HEAD + 仅 B 的文件 ⇒ 正是 A+B 合流态）：build/vet 绿、全树 59 包 0 FAIL、13 条新用例 PASS、linux/darwin 交叉编译绿；变异独立复现（摘掉条数上限判定 ⇒ 红）。

- 主会话补的测试钉子：TestMaxChatDocumentsMatchesDesign —— 原条数用例是用常量自身算输入条数的，改常量它照样绿（实测 5→1000 全包仍绿）；补钉后改 10 时新钉子红、旧用例仍绿。

internal/services/gateway/ws_hub.go

@@ -62,12 +62,16 @@ type hub struct {
 	// envResolver 解析每个回合的角色（design/22 §4.5）；它与 server 的解析器
 	// 同源，使 WS 路径与 REST 路径不会分叉。
 	envResolver turnEnvResolver
-	log         *slog.Logger
-	upgrader    websocket.Upgrader
-	origins     map[string]bool
-	allowAll    bool
-	cancel      context.CancelFunc
-	streamSeq   atomic.Uint64
+	// documents 解析回合携带的文档引用（design/24 §6.1）；同样与 server 的
+	// 解析器同源，使 WS 帧与 REST 的文档校验口径一致。为 nil 时带附件的回合
+	// 被明确拒绝（见 resolveDocuments），绝不静默丢弃。
+	documents documentResolver
+	log       *slog.Logger
+	upgrader  websocket.Upgrader
+	origins   map[string]bool
+	allowAll  bool
+	cancel    context.CancelFunc
+	streamSeq atomic.Uint64
 }
 
 // newHub 构建一个绑定到 server 依赖的 hub。
@@ -83,6 +87,7 @@ func newHub(s *Server) *hub {
 		streaming:   s.streaming,
 		history:     s.history,
 		envResolver: s.envResolver,
+		documents:   s.resolveChatDocuments,
 		log:         s.log,
 		origins:     origins,
 		allowAll:    allowAll,