Coder/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: reserve seam for complete capabilities

Browse Source
This commit is contained in:
Turtle
2026-08-09 15:34:32 +08:00
parent 27ac49e687
commit dda02250f5
966 changed files with 2166 additions and 2159 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
packages/interaction/README.i18n.yaml
View File

@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/interaction/README.md
README.md: a72cd48bb1d3ec15b1116d576fac86619df59528
README.zh.md: 03fab9c4ce4479b3ab82f372f14f4d4208d7de04
README.md: 8fe77ae845390359e2c1e3302400c08828a186a1
README.zh.md: 68e13be7c55e64305bbe0b87ede8d37e55a7cd36

2
packages/interaction/README.md
View File

@@ -2,7 +2,7 @@
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.
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 |
|---|---|---|

2
packages/interaction/README.zh.md
View File

@@ -2,7 +2,7 @@
[English](README.md) | 中文
人与运行中的 agent（智能体）协作所经由的各个 seam——提问、审批、权限预设、命令。这些是**产品**包（package）：由用户直接操作的真实接口。
人与运行中的 agent（智能体）协作所经由的服务与插件——提问、审批、权限预设、命令。这些是**产品**包（package）：由用户直接操作的真实接口。
| 包 | 职责 | ctx 键 |
|---|---|---|

4
packages/interaction/tool-ask-user/README.i18n.yaml
View File

@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/interaction/tool-ask-user/README.md
README.md: 7af356263ea6582a081e7c6de22fd317ca8b96df
README.zh.md: 5e5e8f2a8208c003c68ce1f3992c0bd34f2cb552
README.md: bb0af4286d6d0626596202d57e55fd818b92f44b
README.zh.md: 1a8c7ceec56a0d5a4ed25793b306d2b5d9e8a526

2
packages/interaction/tool-ask-user/README.md
View File

@@ -19,7 +19,7 @@ The tool calls `ctx.userInteraction.ask()` and returns canonical `{ answers: [{
## Role
This is the consumer package for the user-interaction seam. It does not render UI and does not know how input is collected; it only translates model arguments into `AskUserQuestionRequest` and returns the human answer to the agent loop.
This is the Consumer package for the user-interaction seam. It does not render UI and does not know how input is collected; it only translates model arguments into `AskUserQuestionRequest` and returns the human answer to the agent loop.
## Model Experience

2
packages/interaction/tool-ask-user/README.zh.md
View File

@@ -19,7 +19,7 @@
## 职责
此包是用户交互 seam 的消费方。它不渲染 UI，也不了解输入的收集方式；它只将模型参数转换为 `AskUserQuestionRequest`，并把用户回答返回给 agent loop（智能体循环）。
此包是用户交互 seam 的 Consumer 包。它不渲染 UI，也不了解输入的收集方式；它只将模型参数转换为 `AskUserQuestionRequest`，并把用户回答返回给 agent loop（智能体循环）。
## 模型体验

2
packages/interaction/tool-ask-user/src/index.ts
View File

@@ -1,5 +1,5 @@
/**
* Model-facing `ask_user_question` tool over the `ctx.userInteraction` seam.
* Model-facing Consumer of the `ctx.userInteraction` capability seam.
* The tool pauses until a UI provider returns a human answer, then feeds that
* answer back into the agent loop as an ordinary tool result.
*

2
packages/interaction/user-approval/src/index.ts
View File

@@ -1,5 +1,5 @@
/**
* Approval request, cancellation, audit, and per-session policy seam. Missing
* Service Definition for the approval capability seam, covering requests, cancellation, audit, and per-session policy. Missing
* answerers fail closed; grants apply only to the requested action.
* @module @deepseek-ai/dsh-user-approval
*/

4
packages/interaction/user-interaction/README.i18n.yaml
View File

@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/interaction/user-interaction/README.md
README.md: cba015e782623b3a5adf018303823577a0b96774
README.zh.md: acfacd1cef8150d6995d5c6285b5a331310fb89b
README.md: cf000dd59754dfe2f14395c33384bad5bda76910
README.zh.md: 67167649e29afe99667ab6c863127d27d4bceb48

4
packages/interaction/user-interaction/README.md
View File

@@ -2,7 +2,7 @@
English | [中文](README.zh.md)
Abstract user-interaction seam. It owns `ctx.userInteraction`, the service a model-facing tool or permission plugin uses when it needs to pause work and ask the human for a decision.
User-interaction Service Definition. It owns `ctx.userInteraction`, the service a model-facing tool or permission plugin uses when it needs to pause work and ask the human for a decision.
## Service: `UserInteractionService` (ctx key: `userInteraction`)
@@ -30,7 +30,7 @@ When a request carries an agent, `ask()` authenticates its exact identity throug
## Role
This is the interface package. Model-facing consumers such as `@deepseek-ai/dsh-tool-ask-user` depend on this seam; the Web host runtime provides the shipped interactive implementation. The loop stays unchanged: a tool call awaits a promise, and the tool result resumes the normal agent loop.
This is the Service Definition package. Consumers such as `@deepseek-ai/dsh-tool-ask-user` depend on this service; the Web host runtime supplies the shipped Service provider. The loop stays unchanged: a tool call awaits a promise, and the tool result resumes the normal agent loop.
## Model Experience

4
packages/interaction/user-interaction/README.zh.md
View File

@@ -2,7 +2,7 @@
[English](README.md) | 中文
抽象用户交互 seam。它定义 `ctx.userInteraction`，供面向模型的工具或权限插件在需要暂停工作并询问人类决定时使用。
用户交互 Service Definition。它定义 `ctx.userInteraction`，供面向模型的工具或权限插件在需要暂停工作并询问人类决定时使用。
## 服务：`UserInteractionService`（ctx 键：`userInteraction`）
@@ -30,7 +30,7 @@
## 职责
这是接口包。`@deepseek-ai/dsh-tool-ask-user` 等面向模型的消费方依赖此 seam；Web 宿主运行时提供随产品交付的交互式实现。循环保持不变：工具调用等待 Promise，工具结果随后恢复正常的 agent loop（智能体循环）。
这是 Service Definition 包。`@deepseek-ai/dsh-tool-ask-user` 等 Consumer 依赖此服务；Web 宿主运行时提供随产品交付的 Service provider。循环保持不变：工具调用等待 Promise，工具结果随后恢复正常的 agent loop（智能体循环）。
## 模型体验

2
packages/interaction/user-interaction/src/index.ts
View File

@@ -1,5 +1,5 @@
/**
* User-interaction seam (`ctx.userInteraction`): a UI-backed service for
* Service Definition for the user-interaction capability seam (`ctx.userInteraction`): a UI-backed service for
* pausing an agent tool call until the human answers a question. The model-
* facing tool lives in `@deepseek-ai/dsh-tool-ask-user`; UI packages provide
* the single active provider.