Cron Add 強化與結構定義對齊
Context
近期的閘道日誌顯示重複的cron.add 失敗，原因是參數無效（缺少 sessionTarget、wakeMode、payload，以及格式錯誤的 schedule）。 19. 這表示至少有一個客戶端（很可能是代理工具呼叫路徑）正在送出被包裝或僅部分指定的工作負載。 20. 另外，TypeScript 中的 cron 提供者列舉、閘道結構、CLI 旗標與 UI 表單型別之間存在漂移，且 cron.status 在 UI 上也有不一致（UI 期望 jobCount，而閘道回傳 jobs）。
目標
- 透過正規化常見的包裝負載並推斷遺漏的
kind欄位，停止cron.addINVALID_REQUEST 垃圾訊息。 - 在 Gateway 閘道器結構定義、cron 型別、CLI 文件與 UI 表單之間對齊 cron provider 清單。
- 讓代理程式 cron 工具的結構定義更明確，使 LLM 能產生正確的工作負載。
- 修正 Control UI 中 cron 狀態的工作數量顯示。
-
- 新增測試以涵蓋正規化與工具行為。
非目標
- 變更 cron 排程語意或工作執行行為。
- 新增新的排程種類或 cron 表達式解析。
- 除必要的欄位修正外，不對 cron 的 UI／UX 進行全面改造。
22. 發現事項（目前的缺口）
- Gateway 閘道器中的
CronPayloadSchema排除了signal與imessage，但 TS 型別包含它們。 - Control UI 的 CronStatus 期望
jobCount，但 Gateway 閘道器回傳jobs。 - 代理程式 cron 工具的結構定義允許任意的
job物件，導致可能出現格式錯誤的輸入。 - Gateway 閘道器對
cron.add進行嚴格驗證且沒有正規化，因此被包裝的負載會失敗。
23. 變更內容
cron.add與cron.update現在會正規化常見的包裝形狀，並推斷遺漏的kind欄位。- 代理程式 cron 工具的結構定義已與 Gateway 閘道器結構定義對齊，降低無效負載的發生。
- Provider 列舉值已在 Gateway 閘道器、CLI、UI 與 macOS 選擇器之間完成對齊。
- Control UI 使用 Gateway 閘道器的
jobs計數欄位來顯示狀態。
目前行為
- 正規化： 被包裝的
data／job負載會被解包；在安全的情況下會推斷schedule.kind與payload.kind。 - 預設值： 當缺少時，會為
wakeMode與sessionTarget套用安全的預設值。 - Providers： Discord／Slack／Signal／iMessage 現在會一致地在 CLI／UI 中呈現。
驗證
- 監看 Gateway 閘道器日誌，確認
cron.addINVALID_REQUEST 錯誤減少。 - 重新整理後，確認 Control UI 的 cron 狀態顯示工作數量。
可選後續事項
- Control UI 手動冒煙測試：為每個 provider 新增一個 cron 工作，並驗證狀態中的工作數量。
開放問題
cron.add是否應接受用戶端明確提供的state（目前在結構定義中被禁止）？- 是否應允許
webchat作為明確的傳遞 provider（目前在傳遞解析中被過濾）？