模組 03 · 契約測試版 · 核心已由 repository 驗證
Relay
Relay 以穩定排序與可安全重試的傳送機制，承載使用者與 agent 之間的對話。
第一條完整訊息
最短的完整接入路徑只有三份文件：
- 了解 Relay 核心概念。
- 簽發 host token。
- 傳送可安全重試的訊息。 完成後，即使網路中斷使 client 無法確認第一次請求的結果，也能安全重送而不產生重複訊息。
依任務繼續閱讀
- 建構功能：即時恢復、Channel 與權限、附件、搜尋與 Webhook
- 營運：限制與錯誤、資料生命週期與稽核與部署
- 參考資料：SDK 與 Widget及 HTTP 操作索引
各介面的成熟度
| 介面 | 目前狀態 |
|---|---|
| 排序、tenant 隔離與 nonce 冪等 | 已由 repository 驗證的不變式 |
| REST 與 WebSocket 契約 | 契約測試版 |
| TypeScript SDK 成品 | 公開測試版：@tonetify/relay@0.1.0-beta.1 |
| 部署 | 自架參考實作，尚無公開映像檔或服務目標 |
模組負責
- Channel、member、message、reply 與 reaction primitives
- Database-backed per-channel sequence
- Nonce idempotency 與 tenant isolation
Host 負責
- 轉換成 Relay user 之前的 business identity
- Business workflow 與 authorization decision
- Conversation 以外的所有 product truth
Invariant
same channel + same nonce = same messageREST 與 WebSocket send 共用同一條寫入路徑，套用相同的 membership 檢查、sequence 分配、validation 與 nonce 行為。