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

FlagTypeDefaultMeaning
<id>text—Job id Required.
--polltime500msPolling interval

Global options

Every command also accepts the global options (-o, --json, --dry-run, --overwrite, --progress, ...). See Global options.

Exit codes

CodeMeaning
0Success
1Processing failed
2Usage or parameter error
3Input missing or unreadable
8Cancelled
70Internal error (bug)

Common mistakes

  • Beat-based times (4b, 1/4) need a tempo: pass --bpm or write 4b@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"}}