@deepseek-ai/dsh-tool-terminal 0.1.2-rc.1 → 0.1.5-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.i18n.yaml +2 -2
  2. package/README.md +1 -1
  3. package/README.zh.md +1 -1
  4. package/package.json +24 -23
package/README.i18n.yaml CHANGED
@@ -2,5 +2,5 @@
2
2
  # side as of the last confirmed-consistent state. Both languages carry equal authority;
3
3
  # after editing either side, bring the other along and re-record with:
4
4
  # pnpm run verify-translation-pairing --write packages/terminal/tool-terminal/README.md
5
- README.md: 0f06603a5bae317343833a790c6264da84eb5f78
6
- README.zh.md: f256314eda3b535627ec3dee01ed5a00d4ae97e5
5
+ README.md: 20fec33477d817e05cdd87228f6777ff5cb24f19
6
+ README.zh.md: a37ea38730f82f03c0e3bd06bc547706b48dea78
package/README.md CHANGED
@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
9
9
 
10
10
  ## Summary
11
11
 
12
- `dsh-tool-terminal` gives the model six tools over persistent terminal sessions: `terminal_open`, `terminal_send`, `terminal_read`, `terminal_signal`, `terminal_close`, and `terminal_list`. Every call is fenced to the exact agent that opened the session, so a model cannot operate another agent's terminal even if it learns the id. Sends run in the foreground (returning bounded output with a wait reason) or in the background through the jobs service (returning a job id collected with `job_output` and stopped with `job_kill`). Results are capped by `maxResultBytes` and stay in session history until compaction. A short guidance section tells the model to prefer one-shot tools unless a terminal's persistent state or interactive stdin is genuinely needed.
12
+ Use `dsh-tool-terminal` when an agent needs persistent terminal state or interactive input across calls. It can open, send to, read, signal, close, and list terminal sessions while preventing one agent from operating another agent's sessions. Sends may wait for bounded foreground output or return a background job id for later collection or interruption. `maxResultBytes` caps each result, which remains in session history until compaction. The model is guided to prefer one-shot tools for bounded work.
13
13
 
14
14
  ## Table of Contents
15
15
 
package/README.zh.md CHANGED
@@ -9,7 +9,7 @@ kind: "package-reference"
9
9
 
10
10
  ## 概述
11
11
 
12
- `dsh-tool-terminal` 基于持久终端会话为模型提供 6 个工具：`terminal_open`、`terminal_send`、`terminal_read`、`terminal_signal`、`terminal_close` 与 `terminal_list`。每次调用都被限制在打开该会话的那个确切 agent（智能体）内，因此即使模型获知另一个 agent 的 id，也无法操作其终端。发送可以前台运行（返回带等待原因的有界输出），也可以通过任务服务后台运行（返回 job id，用 `job_output` 收集、用 `job_kill` 停止）。结果受 `maxResultBytes` 限制，并保留在会话历史中直到压缩（compaction）。一段简短指引会告诉模型：除非确实需要终端的持久状态或交互式 stdin，否则优先使用单次工具。
12
+ 当 agent 需要跨调用保留终端状态或提供交互式输入时，使用 `dsh-tool-terminal`。它可以打开、发送、读取、传递信号、关闭和列出终端会话，同时防止一个 agent 操作其他 agent 的会话。发送可以等待有界的前台输出，也可以返回供后续收集或中断的后台 job id。`maxResultBytes` 限制每个结果的大小，而结果会保留在会话历史中直到压缩（compaction）。指引会让模型对有界工作优先使用单次工具。
13
13
 
14
14
  ## 目录
15
15
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@deepseek-ai/dsh-tool-terminal",
3
3
  "description": "Six model-facing persistent PTY tools with owner isolation and generic background-job integration",
4
- "version": "0.1.2-rc.1",
4
+ "version": "0.1.5-alpha.1",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -30,33 +30,34 @@
30
30
  "@deepseek-ai/schemastery": "^3.18.2"
31
31
  },
32
32
  "peerDependencies": {
33
- "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
34
- "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
35
- "@deepseek-ai/dsh-terminal": "^0.1.2-rc.1",
36
- "@deepseek-ai/dsh-output-retention": "^0.1.2-rc.1",
37
- "@deepseek-ai/dsh-system-prompt": "^0.1.2-rc.1",
38
- "@deepseek-ai/dsh-jobs": "^0.1.2-rc.1",
39
- "@deepseek-ai/dsh-tools": "^0.1.2-rc.1",
33
+ "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
34
+ "@deepseek-ai/dsh-agent": "^0.1.5-alpha.1",
35
+ "@deepseek-ai/dsh-terminal": "^0.1.5-alpha.1",
36
+ "@deepseek-ai/dsh-output-retention": "^0.1.5-alpha.1",
37
+ "@deepseek-ai/dsh-system-prompt": "^0.1.5-alpha.1",
38
+ "@deepseek-ai/dsh-jobs": "^0.1.5-alpha.1",
39
+ "@deepseek-ai/dsh-tools": "^0.1.5-alpha.1",
40
40
  "@deepseek-ai/cordis": "^4.0.2"
41
41
  },
42
42
  "devDependencies": {
43
43
  "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
44
- "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
45
- "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
46
- "@deepseek-ai/dsh-terminal": "^0.1.2-rc.1",
47
- "@deepseek-ai/dsh-terminal-bash": "^0.1.2-rc.1",
48
44
  "@deepseek-ai/cordis-plugin-include": "^1.0.7",
49
- "@deepseek-ai/dsh-sandbox": "^0.1.2-rc.1",
50
- "@deepseek-ai/dsh-sandbox-policy": "^0.1.2-rc.1",
51
- "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
52
- "@deepseek-ai/dsh-subprocess-local": "^0.1.2-rc.1",
53
- "@deepseek-ai/dsh-system-prompt": "^0.1.2-rc.1",
54
- "@deepseek-ai/dsh-jobs": "^0.1.2-rc.1",
55
- "@deepseek-ai/dsh-tool-jobs": "^0.1.2-rc.1",
56
- "@deepseek-ai/dsh-jobs-local": "^0.1.2-rc.1",
45
+ "@deepseek-ai/dsh-agent": "^0.1.5-alpha.1",
46
+ "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.5-alpha.1",
47
+ "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
48
+ "@deepseek-ai/dsh-terminal-bash": "^0.1.5-alpha.1",
49
+ "@deepseek-ai/dsh-terminal": "^0.1.5-alpha.1",
50
+ "@deepseek-ai/dsh-sandbox": "^0.1.5-alpha.1",
51
+ "@deepseek-ai/dsh-sandbox-policy": "^0.1.5-alpha.1",
52
+ "@deepseek-ai/dsh-output-retention": "^0.1.5-alpha.1",
53
+ "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
54
+ "@deepseek-ai/dsh-system-prompt": "^0.1.5-alpha.1",
55
+ "@deepseek-ai/dsh-subprocess-local": "^0.1.5-alpha.1",
56
+ "@deepseek-ai/dsh-jobs-local": "^0.1.5-alpha.1",
57
+ "@deepseek-ai/dsh-tool-jobs": "^0.1.5-alpha.1",
58
+ "@deepseek-ai/dsh-tools": "^0.1.5-alpha.1",
57
59
  "@deepseek-ai/cordis": "^4.0.2",
58
- "@deepseek-ai/dsh-output-retention": "^0.1.2-rc.1",
59
- "@deepseek-ai/dsh-session-projection": "^0.1.2-rc.1",
60
- "@deepseek-ai/dsh-tools": "^0.1.2-rc.1"
60
+ "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1",
61
+ "@deepseek-ai/dsh-jobs": "^0.1.5-alpha.1"
61
62
  }
62
63
  }