Heartbeat Task
排程有邊界的自主工作循環 — Heddle 會醒來、工作，然後回報。
總覽
Heddle 可以依排程醒來、做有限工作、checkpoint 結果，並決定要 continue、pause、complete，或 escalate 給你。每個循環都有邊界，所以 agent 不會不受控地一直跑。
Heartbeat CLI 使用與瀏覽器 task workbench 相同的 server-backed scheduler model。它會連到既有 live control-plane server，或在需要時啟動 embedded server，因此 terminal command 與 browser control 共享 durable task record、run history、continuation state、model setting 與 step budget。
什麼是 heartbeat task？
Heartbeat task 是 durable local agent task，包含 instruction、schedule interval、optional model、optional step budget、continuation mode、checkpoint 與 saved run record。它適合 operator-controlled background work，例如程式碼庫整理、定期檢查、monitoring，或定期文件 cleanup。
Runner cycle
- 載入 durable task 與 prior checkpoint。
- 在可用時 resume prior transcript state。
- 讓 agent 在 configured budget 內做 bounded useful work。
- Checkpoint 新 state 並保存 run record。
- 回傳 decision：continue、pause、complete 或 escalate。
Continuation 與限制
Task 可以使用 operator-controlled continuation 或 agent-selected continuation。Blocked 或 paused task 必須明確 resume，而不是每次 manual run 都偷偷 unblock。新增 heartbeat task 只會保存 scheduler state；它不會安裝隱藏的 OS background service。當你希望 recurring execution 時，請用 heddle heartbeat start 保持 scheduler host 執行。
指令
heddle heartbeat start --every 30m --task "Check for safe maintenance work"
heddle heartbeat task add --id repo-gardener \
--task "Check for safe maintenance work" \
--every 1h
heddle heartbeat task list
heddle heartbeat task show repo-gardener
heddle heartbeat run --task repo-gardener
heddle heartbeat runs list --task repo-gardener
heddle heartbeat runs show latest --task repo-gardener