ストリーミングチャット（SSE）

POST /v1/chat/stream

Server-Sent Events で Minara のターンをストリーミングします。各 SSE イベントは、LLM デルタ、ツール呼び出し、ツール結果、または最終 Minara メッセージという中間ステップを示す JSON ペイロードです。

リクエスト本文

{ "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 イベントのデータには任意の 2 フィールドがあります。POST /v1/chat/interrupt でターンを停止した場合の interrupted: true と、注入には遅すぎたメッセージを列挙する pending_interjections: string[] です。クライアントは後者を通常のメッセージとして再送します。ヘッドレス呼び出しでは、任意の本文フィールド surface（"web" | "cli"、既定値 "web"）と prompt_mode（"full" | "minimal"、既定値 "full"）でシステムプロンプトを調整できます。cli はカスタム URI ワイヤープロトコルを省略し、minimal はリーンな骨格（アイデンティティ、スキル/ツール機構、基本 Markdown）をマウントして、スキルカタログ、日付、作業ディレクトリを保ったまま注入コンテキストから個人化を除去します。