Scheduler

The built-in scheduler tool waits for a model-selected duration. When the wait completes, the tool returns to the same turn and the model receives another inference opportunity with the elapsed wall-clock time.

This supports delayed checks without running a shell sleep command. Repeating behavior remains model-driven: after each wait, the model can inspect current state, finish, or call scheduler again.

Arguments

scheduler accepts one field:

• duration_ms: integer duration in milliseconds from 1 through 43200000, or 12 hours.

The tool is read-only. Each active wait is tracked as a schedule-* background job and appears in the TUI background-work panel with its remaining time. Focus the panel and press x or k to cancel the selected schedule. job_status can inspect schedules and job_kill can cancel them.

Activity and interruption

Queued user input and completed background work end the wait early. The pending activity is then handled by the active turn.

Interrupting the turn also ends the wait.

Process lifetime

A scheduled wait runs inside the active agent process, including a background worker while that worker remains active. It is not an operating-system cron service and does not survive application or worker process exit.