> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nika.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# Jobs
> Submit, poll, stream, cancel and settle remote workflow jobs through the preview namespace.
export const RemoteContract = () => Preview surface. The root package types the intended
workflow HTTP and SSE API. The reference engine does not ship a compatible
workflow service today. Do not point it at the stable resident firer or
nika model serve.
;
`nika.jobs` owns the remote job lifecycle.
## Submit and keep the identity
```ts theme={"system"}
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
```ts theme={"system"}
const job = await nika.jobs.run('release.nika.yaml')
console.log(job.status, job.exit_code)
```
```ts theme={"system"}
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
```ts theme={"system"}
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