refactor: replace overloaded surface terminology

packages/pty/tool-bash-persistent/src/invariant.ts

@@ -17,7 +17,7 @@ export const inject = ['invariants']
 /**
  * No runtime invariant: the adapter's private owner-to-shell cache has no
  * observable event or data relation. Lifecycle tests prove its cleanup without
- * adding a public surface solely for an invariant.
+ * adding a public API solely for an invariant.
  */
 const install: InvariantInstaller = () => {}
 

packages/pty/tool-pty/README.i18n.yaml

@@ -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/pty/tool-pty/README.md
-README.md: 417cf7bd0e7881f6ffefc47f5200164464b516f6
-README.zh.md: 72eb13957c62cbb08dcecce5971bb064d5085470
+README.md: f8b5d3c51ff2bb667fbf99a70c5babf50e5be5b6
+README.zh.md: 6e37d88c678e378b4b9caf228b0fafa4f632a011

packages/pty/tool-pty/README.md

@@ -68,4 +68,4 @@ Append-only; new results follow the reusable request prefix.
 ## Known Limitations and Deferred Work
 
 - No named key sequence, TUI, BEL, resize, auto-start, or cross-agent sharing schema is exposed.
-- Background mode requires both `@deepseek-ai/dsh-tasks` and its model-facing control surface.
+- Background mode requires both `@deepseek-ai/dsh-tasks` and its model-facing controller.

packages/pty/tool-pty/README.zh.md

@@ -68,4 +68,4 @@ spawn 会返回 id 和有界 MOTD。发送／读取会返回有界终端文本
 ## 已知限制与暂缓事项
 
 - 不公开具名按键序列、TUI、BEL、调整大小、自动启动或跨 agent 共享 schema。
-- 后台模式同时依赖 `@deepseek-ai/dsh-tasks` 及其面向模型的控制接口。
+- 后台模式同时依赖 `@deepseek-ai/dsh-tasks` 及其面向模型的控制器。

packages/pty/tool-pty/tests/tools.spec.ts

@@ -133,7 +133,7 @@ function text(result: { content: { type: string; text?: string }[] }): string {
   return result.content.filter(block => block.type === 'text').map(block => block.text).join('')
 }
 
-describe('tool-pty foreground surface', () => {
+describe('tool-pty foreground API', () => {
   it('registers exactly six schemas and drives the full owner-scoped lifecycle', async () => {
     const { ctx, agent } = await setup(false)
     expect(TOOL_NAMES.every(name => ctx.tools.get(name) !== undefined)).toBe(true)