packages/interaction/README.md

# interaction/ — the human-collaboration plane

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

The seams through which a human collaborates with a running agent — questions, approvals, permission presets, commands. These are **product** packages: real interfaces a person drives.

| Package | Role | ctx key |
|---|---|---|
| [`commands/`](commands/README.md) | Registers and dispatches human commands for interactive adapters. | `ctx.commands` |
| [`user-approval/`](user-approval/README.md) | Coordinates one-shot approval decisions. | `ctx.approval` |
| [`permission/`](permission/README.md) | Presents and persists user-facing permission presets. | `ctx.permission` |
| [`user-interaction/`](user-interaction/README.md) | Defines the provider-neutral human question/answer seam. | `ctx.userInteraction` |
| [`tool-ask-user/`](tool-ask-user/README.md) | Exposes human questions to the model. | (registers on `ctx.tools`) |

These packages integrate through existing agent and session contracts rather than changing the loop. Interactive applications provide the concrete command, approval, and question adapters; automation uses [`acp/`](../acp/README.md), and runnable demo bundles live under [`examples/`](../examples/README.md). The product [`dsh`](../../apps/cli/README.md) CLI composes these packages directly.
refactor(packages): dissolve ui/ and rename sdk/ to scaffold/ 2026-07-30 03:13:49 +08:00			`# interaction/ — the human-collaboration plane`
Document the package hierarchy and finalize the RFC 2026-06-20 23:25:33 +08:00
docs: translate remaining READMEs 2026-07-26 05:03:53 +08:00			`English \| [中文](README.zh.md)`

refactor(packages): dissolve ui/ and rename sdk/ to scaffold/ 2026-07-30 03:13:49 +08:00			`The seams through which a human collaborates with a running agent — questions, approvals, permission presets, commands. These are product packages: real interfaces a person drives.`
Document the package hierarchy and finalize the RFC 2026-06-20 23:25:33 +08:00
			`\| Package \| Role \| ctx key \|`
			`\|---\|---\|---\|`
docs: rescan rebased documentation hierarchy 2026-08-05 12:46:38 +08:00			\| [`commands/`](commands/README.md) \| Registers and dispatches human commands for interactive adapters. \| `ctx.commands` \|
			\| [`user-approval/`](user-approval/README.md) \| Coordinates one-shot approval decisions. \| `ctx.approval` \|
			\| [`permission/`](permission/README.md) \| Presents and persists user-facing permission presets. \| `ctx.permission` \|
			\| [`user-interaction/`](user-interaction/README.md) \| Defines the provider-neutral human question/answer seam. \| `ctx.userInteraction` \|
			\| [`tool-ask-user/`](tool-ask-user/README.md) \| Exposes human questions to the model. \| (registers on `ctx.tools`) \|
Document the package hierarchy and finalize the RFC 2026-06-20 23:25:33 +08:00
docs: rescan rebased documentation hierarchy 2026-08-05 12:46:38 +08:00			These packages integrate through existing agent and session contracts rather than changing the loop. Interactive applications provide the concrete command, approval, and question adapters; automation uses [`acp/`](../acp/README.md), and runnable demo bundles live under [`examples/`](../examples/README.md). The product [`dsh`](../../apps/cli/README.md) CLI composes these packages directly.