Yichen Jiang
b48c05d117
- `JobStart` is a union discriminated by `record`: `RecordingJobStart.run` receives `RecordingJob` (with `append`), `PlainJobStart.run` receives the plain `RunningJob`, and the registry builds the plain face without the method, so the former warn-and-drop path is unrepresentable. - Remove the duplicated JSDoc opener in the registry seam and correct the job-list slot comment (order 20 sits before the subagent catalog's 30). - Restore the `cordis-tool-round` session fixture whose only change was a re-recorded `createdAt`. - Update the 2026-08-08 job-display note's stale service-disposal and slot ordering facts; archive the superseded 2026-08-25 unified-task-list note and point its remaining inbound links at the archived snapshot.
description, kind
| description | kind |
|---|---|
| The jobs group map: background-job control — the registry contract, process-local storage, and the model-facing job tools — for users and maintainers navigating the group. | package-group |
jobs/ — background-job capability family
English | 中文
Summary
The jobs group is the background-work capability family: tools that run long work register it as a job, and the owning agent can read, wait on, list, and cancel it without blocking its own turn. Jobs belong to the agent session that started them, so one agent never sees another's work, and completion is delivered to the owning agent in-session instead of polled. The group splits into the registry contract (jobs), its process-local storage (jobs-local), and the model-facing control tools with completion notices (tool-jobs).
Table of Contents
Packages
| Package | Role | ctx key |
|---|---|---|
jobs |
Defines the background-job contract: ids, ownership, lifecycle, and completion listeners | ctx.jobs |
jobs-local |
Runs and stores jobs in this process, fenced per owner | registers on ctx.jobs |
tool-jobs |
Lets the model read, list, and kill jobs and delivers completion notices | registers on ctx.tools |
Related documentation
- Background task runtime subsystem — the job types, snapshot fields, and the
ctx.jobsAPI. - Generic long-running tool runtime Agent Note — the design behind the background-job runtime.
- job-registry seam Agent Note — the owner-fenced registry contract and its rationale.
Dev Note
Working context for maintainers — click to expand
None.