start_timer
Begin a monotonic task timer using a required minimum duration in seconds, so agents can verify the user-requested minimum duration has elapsed.
Instructions
Start a timer at the beginning of a task with a user-requested minimum duration. Convert the duration to whole seconds, rounding up (30 minutes = 1800). Preserve timer_id and min_seconds in task context and summaries. Each call creates a new timer; reuse the existing timer for the same task, including after status questions and context compaction.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"min_seconds": "<min_seconds>"
},
"name": "start_timer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| min_seconds | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| timer_id | Yes | ||
| min_seconds | Yes | ||
| minimum_met | Yes | ||
| elapsed_seconds | Yes | ||
| remaining_seconds | Yes |