deepseek-harness/packages/interaction
2026-08-09 11:33:14 +08:00
..
commands docs(i18n): standardize contract terminology 2026-08-09 11:33:14 +08:00
permission docs(agent-note): flip the regrouping note to implemented 2026-08-09 01:25:24 +08:00
tool-ask-user docs(i18n): reproofread updated Chinese documentation 2026-08-09 03:20:17 +08:00
user-approval docs: generate each subsystem's cordis surface into its own page; delete the flat catalogs 2026-08-09 01:31:57 +08:00
user-interaction docs(i18n): reproofread updated Chinese documentation 2026-08-09 03:20:17 +08:00
README.i18n.yaml docs(i18n): standardize contract terminology 2026-08-09 11:33:14 +08:00
README.md docs(subsystems): open core.md on agent creation/ownership and the Agent contract; enforce a complete folder index 2026-08-09 01:34:23 +08:00
README.zh.md docs(i18n): standardize contract terminology 2026-08-09 11:33:14 +08:00

interaction/ — the human-collaboration plane

English | 中文

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/ 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/.