packages/tasks/README.md

# tasks/ — background-task capability family

English | [中文](README.zh.md)

This family gives long-running tools one owner-isolated background-task protocol for observation, cancellation, waiting, and completion notices.

| Package | Role | ctx key |
|---|---|---|
| [`tasks/`](tasks/README.md) | Defines the task registry and lifecycle contract | `ctx.tasks` |
| [`tasks-local/`](tasks-local/README.md) | Implements the process-local task registry | registers on `ctx.tasks` |
| [`tool-tasks/`](tool-tasks/README.md) | Exposes task control and completion notices to the model | registers on `ctx.tools` |

See the [background-task runtime](../../.agents/notes/implemented/architecture/2026-06-20-generic-long-running-tool-runtime.md) and [task-registry](../../.agents/notes/implemented/architecture/2026-07-26-task-registry-seam.md) decisions.

The subsystem reference — the id scheme, the owner-fenced contract, snapshots — is [docs/subsystems/tasks.md](../../docs/subsystems/tasks.md); design in the [background-task runtime](../../.agents/notes/implemented/architecture/2026-06-20-generic-long-running-tool-runtime.md) and [task-registry contract](../../.agents/notes/implemented/architecture/2026-07-26-task-registry-seam.md) Agent Notes.
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`# tasks/ — background-task capability family`
feat(tasks): background task runtime, generic task_* control tools, bash/subagent producers 2026-07-09 21:22:54 +08:00
docs: translate remaining READMEs 2026-07-26 05:03:53 +08:00			`English \| [中文](README.zh.md)`

docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`This family gives long-running tools one owner-isolated background-task protocol for observation, cancellation, waiting, and completion notices.`
feat(tasks): background task runtime, generic task_* control tools, bash/subagent producers 2026-07-09 21:22:54 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`\| Package \| Role \| ctx key \|`
feat(tasks): background task runtime, generic task_* control tools, bash/subagent producers 2026-07-09 21:22:54 +08:00			`\|---\|---\|---\|`
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			\| [`tasks/`](tasks/README.md) \| Defines the task registry and lifecycle contract \| `ctx.tasks` \|
			\| [`tasks-local/`](tasks-local/README.md) \| Implements the process-local task registry \| registers on `ctx.tasks` \|
			\| [`tool-tasks/`](tool-tasks/README.md) \| Exposes task control and completion notices to the model \| registers on `ctx.tools` \|
feat(tasks): background task runtime, generic task_* control tools, bash/subagent producers 2026-07-09 21:22:54 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`See the [background-task runtime](../../.agents/notes/implemented/architecture/2026-06-20-generic-long-running-tool-runtime.md) and [task-registry](../../.agents/notes/implemented/architecture/2026-07-26-task-registry-seam.md) decisions.`
docs: anchor each subsystem page to its package group; make group READMEs thin tables 2026-08-02 05:54:15 +08:00
docs: reserve seam for complete capabilities 2026-08-09 15:34:32 +08:00			`The subsystem reference — the id scheme, the owner-fenced contract, snapshots — is [docs/subsystems/tasks.md](../../docs/subsystems/tasks.md); design in the [background-task runtime](../../.agents/notes/implemented/architecture/2026-06-20-generic-long-running-tool-runtime.md) and [task-registry contract](../../.agents/notes/implemented/architecture/2026-07-26-task-registry-seam.md) Agent Notes.`