docs: reserve seam for complete capabilities

2026-08-09 15:34:32 +08:00
parent 27ac49e687
commit dda02250f5
966 changed files with 2166 additions and 2159 deletions
@@ -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
@@ -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

@@ -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（智能体循环）。

 ## 模型体验

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