History

Dudu-0223 797c711e11 refactor(web): remove fetch approval policy		2026-08-25 14:25:12 +08:00
..
commands	docs: purge residual chain-of-thought leakage	2026-08-22 13:10:23 +08:00
permission-presets	release(dsh): 0.1.1-rc.2	2026-08-21 19:48:58 +08:00
tool-ask-user	refactor(interaction): move Approval and Question into UI owners	2026-08-23 16:28:17 +08:00
user-approval	refactor(web): remove fetch approval policy	2026-08-25 14:25:12 +08:00
user-questions	docs(client): align split ownership contracts	2026-08-23 16:28:20 +08:00
README.i18n.yaml	refactor(repo): retire top-level examples	2026-08-24 22:02:44 +08:00
README.md	refactor(repo): retire top-level examples	2026-08-24 22:02:44 +08:00
README.zh.md	refactor(repo): retire top-level examples	2026-08-24 22:02:44 +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.permissionPresets`
`user-questions/`	Defines the provider-neutral human question/answer seam.	`ctx.userQuestions`
`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/. The product dsh CLI composes these packages directly.

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