Skip to main content

Jobs and streaming

Long-running work returns a job_id. Use jobs APIs to poll status, stream tokens, cancel, resume, or send follow-up input.

Lifecycle

SDK patterns

// Fire (async)
const { job_id } = await auvy.receptors.fire(receptorId, { message: 'Go' }, { async: true })

// Wait
const done = await auvy.jobs.wait(job_id)

// Stream
for await (const chunk of auvy.jobs.stream(job_id)) {
  process.stdout.write(chunk.text ?? '')
}
Deep dive: SDK jobs and streaming · Jobs API.

Errors and retries

See Errors and limits for HTTP status codes, rate limits, and retry guidance.