History

Turtle a27efdef36 docs: make technical prose concrete		2026-08-10 16:34:20 +08:00
..
commands	fix(client): consume typed business session events	2026-08-09 18:42:25 +08:00
permission	docs: make technical prose concrete	2026-08-10 16:34:20 +08:00
tool-ask-user	docs: reserve seam for complete capabilities	2026-08-09 17:26:57 +08:00
user-approval	docs: purge chain-of-thought leakage from prose	2026-08-09 21:10:59 +08:00
user-interaction	docs: make technical prose concrete	2026-08-10 16:34:20 +08:00
README.i18n.yaml	docs: reserve seam for complete capabilities	2026-08-09 17:26:57 +08:00
README.md	docs: reserve seam for complete capabilities	2026-08-09 17:26:57 +08:00
README.zh.md	docs: reserve seam for complete capabilities	2026-08-09 17:26:57 +08:00

README.md

interaction/ — the human-collaboration plane

English | 中文

The services and plugins 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/`	Registers and dispatches human commands for interactive adapters.	`ctx.commands`
`user-approval/`	Coordinates one-shot approval decisions.	`ctx.approval`
`permission/`	Presents and persists user-facing permission presets.	`ctx.permission`
`user-interaction/`	Defines the provider-neutral human question/answer seam.	`ctx.userInteraction`
`tool-ask-user/`	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/, and runnable demo bundles live under examples/. The product dsh CLI composes these packages directly.

The subsystem references: approval.md, permission.md, user-interaction.md, and commands.md. The automation-only ACP transport is acp/, the SDK's JSON-RPC server half scaffold/server, and the shared bin boot glue boot/.