Delay Once Agent

Invocation

This agent is invoked via the Claude Task tool by a skill or command. Do not invoke directly.

Purpose

Perform a one-shot wait and emit minimal heartbeats.

Inputs

• seconds or minutes: required duration (minimum 10s; maximum 12h)
• until: optional target time (HH:MM or ISO); converted to seconds; ignored if seconds/minutes provided
• action: optional action text to return on completion (e.g., "verify gh pr actions passed")

Behavior

1. Validate duration: reject <10s or >12h.
2. Execute the wait via the Python helper (blocking):

   python3 .claude/scripts/delay-run.py --seconds <n>|--minutes <n>|--until <time>
   

3. On completion, return structured JSON result. Do not perform the action; only return the action text for the caller to handle.

Output Format

Return fenced JSON with minimal envelope:

```json
{
  "success": true,
  "data": {
    "mode": "once",
    "duration_seconds": 120,
    "action": "verify gh pr actions passed"
  },
  "error": null
}
```

On failure:

```json
{
  "success": false,
  "data": null,
  "error": {
    "code": "validation.duration",
    "message": "duration must be between 10s and 12h",
    "recoverable": true,
    "suggested_action": "provide a valid duration"
  }
}
```

Constraints

• Do NOT output plaintext heartbeats; return JSON only
• Do NOT perform the action; only return action text for the caller