control.flow.wait

Pause for a bounded delay (seconds or until an epoch) before continuing

Overview

Property	Value
Workflow type	Linear
Library	App-control
Version	1.0

Input Schema

Field	Type	Required	Default	Description
seconds	integer	No	—	Relative delay in seconds (default 0; capped at 86400)
until_epoch	integer	No	—	Absolute unix time to wait until (overrides 'seconds')

Output Schema

Field	Type	Required	Default	Description
seconds	integer	No	—	Relative delay echoed from input.
until_epoch	integer	No	—	Absolute wake time echoed from input.
wait_seconds	integer	No	—	Resolved bounded delay in seconds.
started_at_epoch	integer	No	—	Unix time when the wait was scheduled.
wake_at_epoch	integer	No	—	Unix time when the resume transition is due.
woke_at_epoch	integer	No	—	Unix time when the scheduled resume completed.
failure_reason	string	No	—	—
failure_type	string	No	—	—
failed_action	string	No	—	—
failed_at_state	string	No	—	—
failed_step	string	No	—	—
failed_layer	string	No	—	—
error	string	No	—	—
error_type	string	No	—	—

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	start	—
waiting	No	No	—	—	—
completed	No	Yes	Yes	—	—
failed	No	Yes	No	—	—

State Diagram

Transitions

From	Action	To	Description
pending	start	waiting	—
waiting	resume	completed	—
* (any state)	fail	failed	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "control.flow.wait",
  "initial_data": {
    "seconds": 123,
    "until_epoch": 123
  }
}