概念總覽

Sandbox 讓前端把使用者定義的任務（task），綁定一個已建置好的環境版本（environment version），在聊天室（chatroom）裡執行（run），再把日誌與產出物取回。

前端只跟一個面向對話：/private/module/sandbox（租戶 API）。建置與執行的雲端細節、位元組搬運，都由後端控制面處理，前端看不到、也不用管。

串接前先讀這幾頁：

• 架構：控制面與資料面：你呼叫哪些 API、哪些是後端系統對系統。
• 資源模型：environment / version / task / task version / binding / run 的關係圖。
• 狀態機與輪詢：所有狀態值與轉換；沒有 streaming，前端用輪詢。
• 內容、Digest 與下載：source_digest、輸入 JSON 限制、產出物下載用 capability token（不是 presigned URL）。
• Secret 與授權：secret binding、slot、borrower 授權。
• 限制與配額：分頁、輸入/腳本大小、逾時、每公司政策上限。
• 保留期：內容/映像/日誌各自的過期時鐘。

一頁看懂資料流

環境 Environment
   └─ 版本 Version（提供 source_digest → 建置 build → ready）
         └─ 任務版本 Task Version（綁定一個 ready 的環境版本 + 腳本）
               └─ 綁定 Binding（把已發布任務版本釘進某聊天室）
                     └─ 執行 Run（在聊天室提交；輪詢狀態；取產出物）

命名：本手冊的「Sandbox」指 TeamSync 後端的 sandbox 模組，與 Cloudflare 的「Sandbox SDK」無關。