ferraus jobs wait
Block until a background job finishes, then return its result
Synopsis
ferraus jobs wait <id> [options]
What it does
Block until a background job finishes, then return its result
Examples
Block until the job finishes, then print its result
ferraus jobs wait 1760873452123-3f2a
Check every two seconds; print the job's result envelope as JSON
ferraus jobs wait 1760873452123-3f2a --poll 2s --json
Give up waiting after ten minutes (exit code 8)
ferraus jobs wait 1760873452123-3f2a --timeout 10m
Options
| Flag | Type | Default | Meaning |
|---|---|---|---|
<id> | text | — | Job id Required. |
--poll | time | 500ms | Polling interval |
Global options
Every command also accepts the global options (-o, --json, --dry-run, --overwrite, --progress, ...). See Global options.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Processing failed |
| 2 | Usage or parameter error |
| 3 | Input missing or unreadable |
| 8 | Cancelled |
| 70 | Internal error (bug) |
Common mistakes
- Beat-based times (
4b,1/4) need a tempo: pass--bpmor write4b@120.
For models
- MCP tool:
ferraus_jobs_wait - Schema:
ferraus schema jobs wait - Pipeline:
{ op: jobs wait, args: { ... } }(flag names with_instead of-) - fx stage: no
{"command": "jobs wait", "defaults": {"poll": "500ms"}}