Background Jobs

Tools

• yao_job_start, Start a command. background false (default) blocks until done and returns output_tail; background true returns job_id immediately.
• yao_job_list, List jobs. Supports --status filter and --limit/--offset pagination.
• yao_job_get, Get full details for a job (or daemon by ID).
• yao_job_output, Read process output (works for both job and daemon IDs).
• yao_job_wait, Block until a background job finishes or timeout expires. Jobs only, not daemons.
• yao_job_stop, Kill a running job.

Parameters

yao_job_start

Param	Required	Default	Description
command	yes	,	Shell command to execute
description	yes	,	Concise 5, 10 word summary
background	no	false	true returns immediately; false blocks until done
args	no	,	Additional arguments (rarely needed; prefer inline in command)
working_dir	no	workspace	Working directory
max_duration_ms	no	,	Kill the job after this many milliseconds

yao_job_list

Param	Default	Description
status	all	Filter: running, stopping, completed, failed, cancelled, all
limit	20	Max items per page
offset	0	Skip first N items

yao_job_output

Param	Required	Description
job_id	yes	Job or daemon ID
offset	no	Byte offset to read from (0 = beginning)