Jobs

nika.jobs owns the remote job lifecycle.

Submit and keep the identity

const { job_id } = await nika.jobs.submit(
  'release.nika.yaml',
  { channel: 'stable' },
)

await database.runs.insert({ jobId: job_id })

Persist job_id before opening a stream. Polling, reconnects, cancellation, artifacts and support tools all share it.

Choose waiting or streaming

Poll to terminal
Stream events

const job = await nika.jobs.run('release.nika.yaml')
console.log(job.status, job.exit_code)

const { job_id } = await nika.jobs.submit('release.nika.yaml')
for await (const event of nika.jobs.stream(job_id)) {
  render(event)
}

run() applies the configured poll interval, timeout and backoff. stream() uses SSE and ends only on a terminal event.

Cancel work, not just the request

await nika.jobs.cancel(job_id)
const final = await nika.jobs.status(job_id)

Aborting a fetch stops the caller waiting. jobs.cancel() asks the service to cancel the job. Product interfaces often need both actions.

Lifecycle

REMOTE JOB · PREVIEW STATE MACHINE

Continue

SSE streaming

Reconnect without inventing terminal state.

Artifacts

Collect the job’s outputs.

Errors

Handle job failure and cancellation separately.

Method index

Scan the complete namespace.

Overview

Start

Project · live

Local API · live

Runtime · live

Remote API · preview

Operations

Reference

Submit and keep the identity

Choose waiting or streaming

Cancel work, not just the request

Lifecycle

Continue

SSE streaming

Artifacts

Errors

Method index

​Submit and keep the identity

​Choose waiting or streaming

​Cancel work, not just the request

​Lifecycle

​Continue

SSE streaming

Artifacts

Errors

Method index

Submit and keep the identity

Choose waiting or streaming

Cancel work, not just the request

Lifecycle

Continue