v2.46.0

新機能

• 外部API v1エンドポイントを追加しました。
  • チャット送信、発話、停止、ステータス取得、コマンド取得、イベント取得に対応しました。
  • /api/v1 は AITUBERKIT_API_KEY によるBearer認証に対応しました。
• API Consoleを刷新しました。
  • v1 APIと旧 /api/messages の両方を画面上から確認・実行できるようにしました。
  • Client ID、APIキー、リクエスト本文、実行コード、レスポンスを一画面で扱えるようにしました。
• 外部連携WebSocketをv2プロトコルに対応しました。
  • session.hello / session.ready、ack、ping/pong、cancel、request ID、接続状態管理に対応しました。
  • 既存のv1 legacy形式との互換も維持しています。

改善

• 外部連携WebSocketの接続先URLを設定化しました。
  • NEXT_PUBLIC_EXTERNAL_LINKAGE_URL で初期値を指定できます。
• 外部連携専用のWebSocket manager/storeを追加し、Realtime API用WebSocketとの責務を分離しました。
• 外部連携設定画面に、接続状態、プロトコル、ハートビート、再接続回数、最終エラー、リクエスト状態、再接続・中止操作を追加しました。
• Message Receiverがクライアント状態を定期送信し、停止コマンドを受け取れるようになりました。

バグ修正

• 外部連携のpayload type guardを修正し、不正なpayloadを安全に扱うようにしました。
• SpeakQueueの停止処理の重複を整理しました。
• CodeRabbitの指摘に対応し、外部API・外部連携まわりの実装を調整しました。

テスト

• 外部API v1エンドポイントのテストを追加しました。
• 外部連携v1/v2プロトコル、WebSocket store、WebSocket managerのテストを追加しました。
• chat handler、messages API、SpeakQueueまわりのテストを更新しました。

ドキュメント・翻訳

• WebSocket外部連携の改修計画ドキュメントを追加しました。
• 外部API操作、API Console、外部連携WebSocket状態表示に関する日本語翻訳を追加・更新しました。
• .env.example に NEXT_PUBLIC_EXTERNAL_LINKAGE_URL と AITUBERKIT_API_KEY を追加しました。