流式聊天（SSE）

POST /v1/chat/stream

通過 Server-Sent Events 流式執行 Minara 輪次。每個 SSE 事件都是描述中間步驟的 JSON 負載：LLM 增量、工具調用、工具結果或最終 Minara 消息。

請求體

{ "message": "analyze BTC momentum" }

響應體

text/event-stream — see the SSE envelope defined in `apps/agent/src/gateway/api.ts`.

說明

除 message 外，所有字段均為可選字段。只有在使用 resume: true 繼續已結束的服務供應商連線故障輪次時，才可省略 message。session_id 用於繼續現有會話；省略它會建立新會話（此時 session_kind 選擇介面類型，默認為 "chat"）。retry: true 會取代會話的最新輪次，而不是疊加重複輪次。resume: true 必須提供現有 session_id；它會保留已完成的工具結果，從最近的持久化邊界繼續執行，並且不會新增可見的使用者消息列。

輪次中途引導事件：通過 POST /v1/chat/interject 排隊的消息注入正在運行的輪次時，會發出 user_interjection 事件（{ "message": "...", "ts_ms": 1747000000000 }）。最終 done 事件數據有兩個可選字段：輪次由 POST /v1/chat/interrupt 停止時為 interrupted: true；pending_interjections: string[] 列出到達過晚而未能注入的消息，客戶端應將其作為普通消息重新發送。無頭調用方可選擇提示詞變體：可選請求體字段 surface（"web" | "cli"，默認 "web"）和 prompt_mode（"full" | "minimal"，默認 "full"）會調整系統提示詞。cli 會省略自定義 URI 線協議；minimal 會掛載精簡骨架（身份、技能/工具機制和基礎 Markdown），並從注入上下文中移除個性化信息，同時保留技能目錄、日期和工作目錄。