@deepseek-ai/dsh-tool-subagent-control 0.2.1-alpha.1 → 0.2.1-alpha.3

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 (10) hide show
  1. package/README.i18n.yaml +8 -8
  2. package/README.md +4 -5
  3. package/README.zh.md +4 -5
  4. package/lib/index.js +1 -1
  5. package/lib/types/index.js +2 -2
  6. package/locale/en.json +5 -0
  7. package/locale/list-agents/en.json +5 -0
  8. package/locale/list-agents/zh.json +5 -0
  9. package/locale/zh.json +6 -0
  10. package/package.json +27 -23
package/README.i18n.yaml CHANGED
@@ -24,11 +24,11 @@
24
24
  en: d80bb1df2eb740b7
25
25
  zh: e3203d9868a82910
26
26
  /deepseek-ai-dsh-tool-subagent-control/use-this-package/interrupt-agent:
27
- en: 01dd41fe11f294d7
28
- zh: f45a2e4073c0b206
27
+ en: af01696cc8deaf83
28
+ zh: 86e40bc28d5362b1
29
29
  /deepseek-ai-dsh-tool-subagent-control/use-this-package/list-agents:
30
- en: b777ad75f0eb7a59
31
- zh: 19275aba6573a917
30
+ en: 631c0a34dadcb8f8
31
+ zh: dbc536512cae070f
32
32
  /deepseek-ai-dsh-tool-subagent-control/understand-the-implementation:
33
33
  en: c5cdf01a78c990f2
34
34
  zh: 53c180d726ce4502
@@ -42,8 +42,8 @@
42
42
  en: 70e344022e6e535e
43
43
  zh: 355488590648a82e
44
44
  /deepseek-ai-dsh-tool-subagent-control/understand-the-implementation/source-map:
45
- en: 4baec67b26df21e4
46
- zh: 7582f996e269e7f8
45
+ en: 95f73146f8735ab1
46
+ zh: 9c67e064c4000613
47
47
  /deepseek-ai-dsh-tool-subagent-control/further-exploration:
48
48
  en: df2bf39d0ffffd43
49
49
  zh: 4cd02551f7433c90
@@ -54,8 +54,8 @@
54
54
  en: e4c7376d4f29dbd5
55
55
  zh: 6b7a9eaf69c9ea53
56
56
  /deepseek-ai-dsh-tool-subagent-control/model-experience/tool-schema/what-the-model-sees:
57
- en: a63be096ee9c4873
58
- zh: cd1bd116ccc66318
57
+ en: b32bc9bcb45a8c77
58
+ zh: 4bd3eba1e8612da7
59
59
  /deepseek-ai-dsh-tool-subagent-control/model-experience/tool-schema/token-effect:
60
60
  en: db207dc8d5860684
61
61
  zh: ad2663b4967fbca9
package/README.md CHANGED
@@ -37,7 +37,6 @@ Load the subagent service, a backend, the delegation tool, and this package. Add
37
37
  - name: '@deepseek-ai/dsh-tool-subagent'
38
38
  config:
39
39
  provider: spawn
40
- backgroundMode: continuable
41
40
  - name: '@deepseek-ai/dsh-tool-subagent-control'
42
41
  - name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
43
42
  ```
@@ -50,11 +49,11 @@ Sends a message to an Agent named by `agent_id`: any exact live Agent may target
50
49
 
51
50
  ### interrupt_agent
52
51
 
53
- Stops only the target's current turn: queued messages stay parked until a later `send_message`, descendants keep running, and the child stays available for follow-ups. The call returns when the stop request is accepted, not when the target is quiet; interrupting an already-finished agent is an accepted no-op, and self, sibling, stale, and non-ancestor callers get errored results.
52
+ External executions stop permanently and cannot receive follow-ups. Local targets stop only their current turn: queued messages stay parked until a later `send_message`, descendants keep running, and the child stays available for follow-ups. The call returns when the stop request is accepted, not when the target is quiet; interrupting an already-finished agent is an accepted no-op, and self, sibling, stale, and non-ancestor callers get errored results.
54
53
 
55
54
  ### list_agents
56
55
 
57
- Lists the continuable children below the calling agent: `children` (default) reads direct children from the parent catalog without opening child logs; `descendants` recursively reads child catalogs in stable pre-order, annotating each entry with its durable direct-parent session id and depth. Status comes from the live Agent registry — `running` or `inactive`. Readable one-shot children are omitted from output but their catalogs remain traversal nodes. Unknown modes and unreadable child catalogs, including one-shot children, appear as diagnostics only in `descendants` scope. Ordinary Session forks are not catalog entries, so neither those forks nor their descendants are listed from the source Session.
56
+ Lists the continuable children below the calling agent: `children` (default) reads direct children from the parent catalog without opening child logs; `descendants` recursively reads child catalogs in stable pre-order, annotating each entry with its durable direct-parent session id and depth. Status comes from the live Agent registry — `running` or `inactive`. External entries are omitted without reading a child Session. Readable one-shot children are omitted from output but their catalogs remain traversal nodes. Unknown modes and unreadable child catalogs, including one-shot children, appear as diagnostics only in `descendants` scope. Ordinary Session forks are not catalog entries, so neither those forks nor their descendants are listed from the source Session.
58
57
 
59
58
  -----
60
59
 
@@ -83,7 +82,7 @@ The tool forwards its execution signal, which owns admission only until inbox ac
83
82
  | File | Role |
84
83
  |---|---|
85
84
  | [`src/index.ts`](src/index.ts) | `send_message` and `interrupt_agent` registration |
86
- | [`src/list-agents.ts`](src/list-agents.ts) | `list_agents` registration: scopes, status refinement, projection |
85
+ | [`src/list-agents.ts`](src/list-agents.ts) | `list_agents` registration: direct-child discovery and status refinement |
87
86
 
88
87
  </details>
89
88
 
@@ -107,7 +106,7 @@ Read these pages when the package-level contract is not enough; they move from t
107
106
 
108
107
  #### What the model sees
109
108
 
110
- The generated [schemas](../../../docs/tool-catalog.md#deepseek-aidsh-tool-subagent-control): `send_message` takes `agent_id` and `message`; `interrupt_agent` takes `agent_id`; `list_agents` takes the optional `scope` enum.
109
+ The generated [schemas](../../../docs/tool-catalog.md#deepseek-aidsh-tool-subagent-control): `send_message` takes `agent_id` and `message`; `interrupt_agent` takes `agent_id`; `list_agents` takes no parameters.
111
110
 
112
111
  #### Token effect
113
112
 
package/README.zh.md CHANGED
@@ -37,7 +37,6 @@ kind: "package-reference"
37
37
  - name: '@deepseek-ai/dsh-tool-subagent'
38
38
  config:
39
39
  provider: spawn
40
- backgroundMode: continuable
41
40
  - name: '@deepseek-ai/dsh-tool-subagent-control'
42
41
  - name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
43
42
  ```
@@ -50,11 +49,11 @@ kind: "package-reference"
50
49
 
51
50
  ### interrupt_agent
52
51
 
53
- 只停止目标当前轮次：已排队消息保持暂停，直到之后调用 `send_message`；后代继续运行，子级仍可接受后续消息。调用在停止请求被接受后立即返回，不等待目标完全停稳；中断已结束的 agent 会被接受并按空操作处理，而自身、同级、陈旧及非祖先调用方会收到出错结果。
52
+ 外部执行会永久停止，不能接收后续消息。本地目标只停止当前轮次：已排队消息保持暂停，直到之后调用 `send_message`；后代继续运行，子级仍可接受后续消息。调用在停止请求被接受后立即返回，不等待目标完全停稳；中断已结束的 agent 会被接受并按空操作处理，而自身、同级、陈旧及非祖先调用方会收到出错结果。
54
53
 
55
54
  ### list_agents
56
55
 
57
- 列出调用方 agent 下方的可继续子级：`children`（默认）从父目录读取直接子级，不打开子日志；`descendants` 按稳定前序递归读取子级目录，并为每个条目标注其持久化直接父级会话 ID 与深度。状态来自在线 Agent 注册表——`running` 或 `inactive`。可读取的一次性子级不出现在输出中，但其目录仍是遍历节点。未知模式与无法读取的子级目录（包括一次性子级）仅在 `descendants` 作用域中以诊断信息呈现。普通 Session fork 不是目录条目，因此从源 Session 列表中既无法发现这些 fork，也无法发现其后代。
56
+ 列出调用方 agent 下方的可继续子级：`children`（默认）从父目录读取直接子级，不打开子日志；`descendants` 按稳定前序递归读取子级目录，并为每个条目标注其持久化直接父级会话 ID 与深度。状态来自在线 Agent 注册表——`running` 或 `inactive`。外部条目被省略，不读取子 Session。可读取的一次性子级不出现在输出中，但其目录仍是遍历节点。未知模式与无法读取的子级目录（包括一次性子级）仅在 `descendants` 作用域中以诊断信息呈现。普通 Session fork 不是目录条目，因此从源 Session 列表中既无法发现这些 fork，也无法发现其后代。
58
57
 
59
58
  -----
60
59
 
@@ -83,7 +82,7 @@ kind: "package-reference"
83
82
  | 文件 | 职责 |
84
83
  |---|---|
85
84
  | [`src/index.ts`](src/index.ts) | `send_message` 与 `interrupt_agent` 注册 |
86
- | [`src/list-agents.ts`](src/list-agents.ts) | `list_agents` 注册：作用域、状态细化、投影 |
85
+ | [`src/list-agents.ts`](src/list-agents.ts) | `list_agents` 注册：直接子级发现与状态细化 |
87
86
 
88
87
  </details>
89
88
 
@@ -107,7 +106,7 @@ kind: "package-reference"
107
106
 
108
107
  #### 模型看到什么
109
108
 
110
- 已生成的 [schema](../../../docs/tool-catalog.zh.md#deepseek-aidsh-tool-subagent-control)：`send_message` 接受 `agent_id` 与 `message`；`interrupt_agent` 接受 `agent_id`；`list_agents` 接受可选的 `scope` 枚举。
109
+ 已生成的 [schema](../../../docs/tool-catalog.zh.md#deepseek-aidsh-tool-subagent-control)：`send_message` 接受 `agent_id` 与 `message`；`interrupt_agent` 接受 `agent_id`；`list_agents` 不接受参数。
111
110
 
112
111
  #### Token 影响
113
112
 
package/lib/index.js CHANGED
@@ -60,7 +60,7 @@ function apply(ctx) {
60
60
  })));
61
61
  ctx.tools.register(defineTool({
62
62
  name: "interrupt_agent",
63
- description: "Ask a subagent to stop its current work. This call returns without waiting for it to stop. You can continue a direct child's conversation later with send_message. Subagents it started will keep running.",
63
+ description: "Ask a subagent to stop its current work. This call returns without waiting for it to stop. You can continue a local direct child's conversation later with send_message. External executions stop permanently and cannot receive follow-ups. Subagents it started will keep running.",
64
64
  parameters: { agent_id: {
65
65
  type: "string",
66
66
  required: true,
package/lib/types/index.js CHANGED
@@ -60,8 +60,8 @@ export function apply(ctx) {
60
60
  ctx.tools.register(defineTool({
61
61
  name: 'interrupt_agent',
62
62
  description: 'Ask a subagent to stop its current work. This call returns without waiting for it to stop. '
63
- + 'You can continue a direct child\'s conversation later with send_message. '
64
- + 'Subagents it started will keep running.',
63
+ + 'You can continue a local direct child\'s conversation later with send_message. '
64
+ + 'External executions stop permanently and cannot receive follow-ups. Subagents it started will keep running.',
65
65
  parameters: {
66
66
  agent_id: {
67
67
  type: 'string',
package/locale/en.json ADDED
@@ -0,0 +1,5 @@
1
+ {
2
+ "meta": {
3
+ "title": "tool-subagent-control"
4
+ }
5
+ }
package/locale/list-agents/en.json ADDED
@@ -0,0 +1,5 @@
1
+ {
2
+ "meta": {
3
+ "title": "tool-subagent-control/list-agents"
4
+ }
5
+ }
package/locale/list-agents/zh.json ADDED
@@ -0,0 +1,5 @@
1
+ {
2
+ "meta": {
3
+ "title": "子智能体列表工具"
4
+ }
5
+ }
package/locale/zh.json ADDED
@@ -0,0 +1,6 @@
1
+ {
2
+ "meta": {
3
+ "title": "子智能体控制工具",
4
+ "description": "让 AI 向子智能体发送消息或中断其运行。"
5
+ }
6
+ }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@deepseek-ai/dsh-tool-subagent-control",
3
3
  "description": "Globally named send_message, interrupt_agent, and list_agents tools over ctx.subagents continuations",
4
- "version": "0.2.1-alpha.1",
4
+ "version": "0.2.1-alpha.3",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -23,39 +23,43 @@
23
23
  "default": "./lib/types/list-agents.js"
24
24
  },
25
25
  "./src/*": "./src/*",
26
- "./package.json": "./package.json"
26
+ "./package.json": "./package.json",
27
+ "./locale/*.json": "./locale/*.json",
28
+ "./list-agents/locale/*.json": "./locale/list-agents/*.json"
27
29
  },
28
30
  "files": [
31
+ "locale/*.json",
32
+ "locale/list-agents/*.json",
29
33
  "lib/index.js",
30
34
  "lib/types/**/*.js",
31
35
  "lib/types/**/*.d.ts"
32
36
  ],
33
37
  "license": "MIT",
34
38
  "peerDependencies": {
35
- "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
36
- "@deepseek-ai/cordis": "~4.0.5-alpha.1",
37
- "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
38
- "@deepseek-ai/dsh-subagent": "0.2.1-alpha.1",
39
- "@deepseek-ai/dsh-tools": "0.2.1-alpha.1"
39
+ "@deepseek-ai/cordis": "~4.0.5-alpha.2",
40
+ "@deepseek-ai/dsh-llm": "0.2.1-alpha.3",
41
+ "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
42
+ "@deepseek-ai/dsh-subagent": "0.2.1-alpha.3",
43
+ "@deepseek-ai/dsh-tools": "0.2.1-alpha.3"
40
44
  },
41
45
  "devDependencies": {
42
- "@deepseek-ai/cordis": "~4.0.5-alpha.1",
43
- "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
44
- "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.1",
45
- "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.1",
46
- "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
47
- "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
48
- "@deepseek-ai/dsh-session-persistence": "0.2.1-alpha.1",
49
- "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.1",
50
- "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.1",
51
- "@deepseek-ai/dsh-session-query": "0.2.1-alpha.1",
52
- "@deepseek-ai/dsh-subagent": "0.2.1-alpha.1",
53
- "@deepseek-ai/dsh-subagent-fork-in-process": "0.2.1-alpha.1",
54
- "@deepseek-ai/dsh-subagent-spawn-in-process": "0.2.1-alpha.1",
55
- "@deepseek-ai/dsh-tools": "0.2.1-alpha.1"
46
+ "@deepseek-ai/cordis": "~4.0.5-alpha.2",
47
+ "@deepseek-ai/dsh-agent": "0.2.1-alpha.3",
48
+ "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.3",
49
+ "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.3",
50
+ "@deepseek-ai/dsh-llm": "0.2.1-alpha.3",
51
+ "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
52
+ "@deepseek-ai/dsh-session-persistence": "0.2.1-alpha.3",
53
+ "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.3",
54
+ "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.3",
55
+ "@deepseek-ai/dsh-session-query": "0.2.1-alpha.3",
56
+ "@deepseek-ai/dsh-subagent": "0.2.1-alpha.3",
57
+ "@deepseek-ai/dsh-subagent-fork-in-process": "0.2.1-alpha.3",
58
+ "@deepseek-ai/dsh-subagent-spawn-in-process": "0.2.1-alpha.3",
59
+ "@deepseek-ai/dsh-tools": "0.2.1-alpha.3"
56
60
  },
57
61
  "dependencies": {
58
- "@deepseek-ai/dsh-util-values": "0.2.1-alpha.1",
59
- "@deepseek-ai/dsh-brand": "0.2.1-alpha.1"
62
+ "@deepseek-ai/dsh-brand": "0.2.1-alpha.3",
63
+ "@deepseek-ai/dsh-util-values": "0.2.1-alpha.3"
60
64
  }
61
65
  }