@deepseek-ai/dsh-experimental-agent-team-profile 0.1.5-alpha.2
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.
- package/LICENSE +21 -0
- package/README.i18n.yaml +6 -0
- package/README.md +106 -0
- package/README.zh.md +106 -0
- package/cordis.patch.yml +37 -0
- package/lib/index.js +1 -0
- package/lib/types/index.d.ts +8 -0
- package/package.json +48 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 DeepSeek
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.i18n.yaml
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
|
|
2
|
+
# side as of the last confirmed-consistent state. Both languages carry equal authority;
|
|
3
|
+
# after editing either side, bring the other along and re-record with:
|
|
4
|
+
# pnpm run verify-translation-pairing --write packages/experimental/agent-team-profile/README.md
|
|
5
|
+
README.md: 16bf341224b590b799c9bc2f17ddd4815346598a
|
|
6
|
+
README.zh.md: 1e987933207a004abbfc2b96ac2efcfba6531ff5
|
package/README.md
ADDED
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "Published experimental Agent Teams profile layer over dsh-base with Team-scoped coordination tools and one-shot delegation."
|
|
3
|
+
kind: "package-bundle"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# @deepseek-ai/dsh-experimental-agent-team-profile
|
|
7
|
+
|
|
8
|
+
English | [中文](README.zh.md)
|
|
9
|
+
|
|
10
|
+
## Summary
|
|
11
|
+
|
|
12
|
+
`dsh-experimental-agent-team-profile` is a published experimental profile layer that enables [Agent Teams](../agent-team/README.md) over `@deepseek-ai/dsh-base`. Its patch inserts the Team domain and Team-scoped tools, disables the overlapping global continuable-child controls, and keeps the ordinary fresh and fork delegation tools as one-shot operations. Add it explicitly to an initialized profile; no shipped profile enables it by default.
|
|
13
|
+
|
|
14
|
+
## Table of Contents
|
|
15
|
+
|
|
16
|
+
- [Use this package](#use-this-package)
|
|
17
|
+
- [Understand the implementation](#understand-the-implementation)
|
|
18
|
+
- [Further Exploration](#further-exploration)
|
|
19
|
+
- [Model Experience](#model-experience)
|
|
20
|
+
- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
|
|
21
|
+
- [Dev Note](#dev-note)
|
|
22
|
+
|
|
23
|
+
-----
|
|
24
|
+
|
|
25
|
+
<a id="use-this-package"></a>
|
|
26
|
+
## Use this package
|
|
27
|
+
|
|
28
|
+
### Install into a profile
|
|
29
|
+
|
|
30
|
+
Add the package to an initialized profile, then run a task that asks the Lead to delegate work:
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
dsh plugin --profile headless add @deepseek-ai/dsh-experimental-agent-team-profile
|
|
34
|
+
dsh --profile headless "Use Agent Teams to split this task between two teammates, wait, and summarize."
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
The profile must already contain `@deepseek-ai/dsh-base`, whose Subagent services and provider rows this layer consumes. Removing the package with `dsh plugin --profile <name> remove @deepseek-ai/dsh-experimental-agent-team-profile` removes the bundle from the profile's ordered layer list.
|
|
38
|
+
|
|
39
|
+
### What you get
|
|
40
|
+
|
|
41
|
+
The layer adds the Agent Teams domain and its scoped creation, roster, messaging, interruption, waiting, and task-board tools. It disables the global continuable-child control rows whose tool names overlap with Team controls, while leaving `subagent` and `subagent_fork` available as one-shot delegation tools.
|
|
42
|
+
|
|
43
|
+
-----
|
|
44
|
+
|
|
45
|
+
<a id="understand-the-implementation"></a>
|
|
46
|
+
## Understand the implementation
|
|
47
|
+
|
|
48
|
+
<details>
|
|
49
|
+
<summary>Implementation internals — click to expand</summary>
|
|
50
|
+
|
|
51
|
+
The package's runtime content is [`cordis.patch.yml`](cordis.patch.yml). Applied after `dsh-base`, the patch disables `tool-subagent-control` and `tool-subagent-list-agents`; sets the fresh and fork Subagent rows to `one-shot`; and inserts the Team service and tool rows with explicit providers and limits.
|
|
52
|
+
|
|
53
|
+
| File | Role |
|
|
54
|
+
|---|---|
|
|
55
|
+
| [`cordis.patch.yml`](cordis.patch.yml) | Ordered patch over `dsh-base` |
|
|
56
|
+
| [`src/index.ts`](src/index.ts) | Empty module entry; the patch is the runtime content |
|
|
57
|
+
| — | No runtime invariant companion is published; the package carries only a static profile patch. The Team domain and tool packages own the mutable relationships it activates. |
|
|
58
|
+
|
|
59
|
+
</details>
|
|
60
|
+
|
|
61
|
+
-----
|
|
62
|
+
|
|
63
|
+
<a id="further-exploration"></a>
|
|
64
|
+
## Further Exploration
|
|
65
|
+
|
|
66
|
+
- [Experimental packages](../README.md) — incubation status and publication policy.
|
|
67
|
+
- [Agent Teams service](../agent-team/README.md) — durable roster, messaging, and task-board behavior.
|
|
68
|
+
- [Agent Teams tools](../tool-agent-team/README.md) — the Team-scoped model tool surface.
|
|
69
|
+
- [Base bundle](../../bundle/base/README.md) — the profile layer this patch extends.
|
|
70
|
+
|
|
71
|
+
-----
|
|
72
|
+
|
|
73
|
+
<a id="model-experience"></a>
|
|
74
|
+
## Model Experience
|
|
75
|
+
|
|
76
|
+
### Team policy and tools
|
|
77
|
+
|
|
78
|
+
#### What the model sees
|
|
79
|
+
|
|
80
|
+
The Team policy and schemas belong to [`@deepseek-ai/dsh-experimental-tool-agent-team`](../tool-agent-team/README.md). This bundle changes composition only: Team-scoped `list_agents`, `send_message`, and `interrupt_agent` replace the disabled global continuable-child controls. `subagent` and `subagent_fork` remain available as one-shot delegation tools, whose children do not receive the continuable-child `report` tool.
|
|
81
|
+
|
|
82
|
+
#### Token effect
|
|
83
|
+
|
|
84
|
+
The bundle adds the Team policy and tool schemas described by `dsh-tool-team`; it adds no prompt text of its own.
|
|
85
|
+
|
|
86
|
+
#### KV Cache effect
|
|
87
|
+
|
|
88
|
+
The bundle's composition is prefix-stable while its patch, Team identity, and configured tool schemas remain unchanged.
|
|
89
|
+
|
|
90
|
+
## Known Limitations and Deferred Work
|
|
91
|
+
|
|
92
|
+
<a id="known-limitations-and-deferred-work"></a>
|
|
93
|
+
|
|
94
|
+
- **Opt-in only** — the package is public, but no shipped CLI, Web, SDK, ACP, or Python profile enables it.
|
|
95
|
+
- **Shared checkout** — every teammate observes the same working directory; this bundle adds no worktree isolation or filesystem locking.
|
|
96
|
+
- **Base profile required** — the patch depends on row ids and Subagent providers supplied by `dsh-base`; it is not a standalone profile.
|
|
97
|
+
|
|
98
|
+
<a id="dev-note"></a>
|
|
99
|
+
### Dev Note
|
|
100
|
+
|
|
101
|
+
<details>
|
|
102
|
+
<summary>Working context for maintainers — click to expand</summary>
|
|
103
|
+
|
|
104
|
+
None.
|
|
105
|
+
|
|
106
|
+
</details>
|
package/README.zh.md
ADDED
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "叠加在 dsh-base 上公开发布的实验性 Agent Teams profile 层,提供 Team-scoped 协作工具并保留一次性 delegation。"
|
|
3
|
+
kind: "package-bundle"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# @deepseek-ai/dsh-experimental-agent-team-profile
|
|
7
|
+
|
|
8
|
+
[English](README.md) | 中文
|
|
9
|
+
|
|
10
|
+
## 概述
|
|
11
|
+
|
|
12
|
+
`dsh-experimental-agent-team-profile` 是在 `@deepseek-ai/dsh-base` 之上启用 [Agent Teams](../agent-team/README.zh.md) 的公开实验性 profile 层。它的 patch 会插入 Team domain 与 Team-scoped 工具、禁用名称重叠的全局 continuable-child control,并保留普通的一次性 fresh 与 fork delegation 工具。必须将本包显式添加到已初始化的 profile;随附 profile 默认都不会启用它。
|
|
13
|
+
|
|
14
|
+
## 目录
|
|
15
|
+
|
|
16
|
+
- [使用本包](#use-this-package)
|
|
17
|
+
- [理解实现](#understand-the-implementation)
|
|
18
|
+
- [进一步探索](#further-exploration)
|
|
19
|
+
- [模型体验](#model-experience)
|
|
20
|
+
- [已知限制与延期工作](#known-limitations-and-deferred-work)
|
|
21
|
+
- [开发备注](#dev-note)
|
|
22
|
+
|
|
23
|
+
-----
|
|
24
|
+
|
|
25
|
+
<a id="use-this-package"></a>
|
|
26
|
+
## 使用本包
|
|
27
|
+
|
|
28
|
+
### 安装到 profile
|
|
29
|
+
|
|
30
|
+
将本包添加到已初始化的 profile,然后运行一个要求 Lead 委派工作的任务:
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
dsh plugin --profile headless add @deepseek-ai/dsh-experimental-agent-team-profile
|
|
34
|
+
dsh --profile headless "Use Agent Teams to split this task between two teammates, wait, and summarize."
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
profile 必须已经包含 `@deepseek-ai/dsh-base`,本层会使用其中的 Subagent service 与 provider 配置行。执行 `dsh plugin --profile <name> remove @deepseek-ai/dsh-experimental-agent-team-profile` 移除本包时,bundle 也会从 profile 的有序层列表中移除。
|
|
38
|
+
|
|
39
|
+
### 获得的功能
|
|
40
|
+
|
|
41
|
+
本层会添加 Agent Teams domain,以及 Team-scoped 创建、roster、消息、interrupt、等待与任务板工具。它会禁用工具名与 Team control 重叠的全局 continuable-child control 行,同时保留 `subagent` 与 `subagent_fork` 作为一次性 delegation 工具。
|
|
42
|
+
|
|
43
|
+
-----
|
|
44
|
+
|
|
45
|
+
<a id="understand-the-implementation"></a>
|
|
46
|
+
## 理解实现
|
|
47
|
+
|
|
48
|
+
<details>
|
|
49
|
+
<summary>实现细节——点击展开</summary>
|
|
50
|
+
|
|
51
|
+
本包的运行时内容是 [`cordis.patch.yml`](cordis.patch.yml)。在 `dsh-base` 之后应用时,patch 会禁用 `tool-subagent-control` 与 `tool-subagent-list-agents`,把 fresh 与 fork Subagent 行设置为 `one-shot`,并以显式 provider 和限制插入 Team service 与工具行。
|
|
52
|
+
|
|
53
|
+
| 文件 | 职责 |
|
|
54
|
+
|---|---|
|
|
55
|
+
| [`cordis.patch.yml`](cordis.patch.yml) | 叠加在 `dsh-base` 之上的有序 patch |
|
|
56
|
+
| [`src/index.ts`](src/index.ts) | 空模块入口;patch 是运行时内容 |
|
|
57
|
+
| — | 不发布运行时不变式伴生入口;本包是静态 bundle,不持有可独立观察的运行时关系。 |
|
|
58
|
+
|
|
59
|
+
</details>
|
|
60
|
+
|
|
61
|
+
-----
|
|
62
|
+
|
|
63
|
+
<a id="further-exploration"></a>
|
|
64
|
+
## 进一步探索
|
|
65
|
+
|
|
66
|
+
- [实验性包](../README.zh.md)——孵化状态与发布规则。
|
|
67
|
+
- [Agent Teams service](../agent-team/README.zh.md)——持久 roster、消息与任务板行为。
|
|
68
|
+
- [Agent Teams 工具](../tool-agent-team/README.zh.md)——Team-scoped 模型工具表层。
|
|
69
|
+
- [Base bundle](../../bundle/base/README.zh.md)——本 patch 扩展的 profile 层。
|
|
70
|
+
|
|
71
|
+
-----
|
|
72
|
+
|
|
73
|
+
<a id="model-experience"></a>
|
|
74
|
+
## 模型体验
|
|
75
|
+
|
|
76
|
+
### Team 策略与工具
|
|
77
|
+
|
|
78
|
+
#### 模型会看到什么
|
|
79
|
+
|
|
80
|
+
Team 策略与 schema 由 [`@deepseek-ai/dsh-experimental-tool-agent-team`](../tool-agent-team/README.zh.md) 所有。本 bundle 只改变 composition:Team-scoped `list_agents`、`send_message` 与 `interrupt_agent` 会替代已禁用的全局 continuable-child control。`subagent` 与 `subagent_fork` 仍作为一次性 delegation 工具可用,其子 agent 不会获得 continuable-child `report` 工具。
|
|
81
|
+
|
|
82
|
+
#### Token 影响
|
|
83
|
+
|
|
84
|
+
本 bundle 会加入 `dsh-tool-team` 描述的 Team 策略与工具 schema;它自身不增加提示词文本。
|
|
85
|
+
|
|
86
|
+
#### KV Cache 影响
|
|
87
|
+
|
|
88
|
+
只要 bundle patch、Team identity 与配置的工具 schema 不变,本 bundle 的 composition 就保持前缀稳定。
|
|
89
|
+
|
|
90
|
+
## 已知限制与延期工作
|
|
91
|
+
|
|
92
|
+
<a id="known-limitations-and-deferred-work"></a>
|
|
93
|
+
|
|
94
|
+
- **仅显式启用**——本包公开发布,但随附 CLI、Web、SDK、ACP 与 Python profile 都不会启用它。
|
|
95
|
+
- **共享 checkout**——所有 teammate 都观察同一个工作目录;本 bundle 不提供 worktree 隔离或文件系统锁。
|
|
96
|
+
- **需要 base profile**——本 patch 依赖 `dsh-base` 提供的配置行 id 与 Subagent provider;它不是独立 profile。
|
|
97
|
+
|
|
98
|
+
<a id="dev-note"></a>
|
|
99
|
+
### 开发备注
|
|
100
|
+
|
|
101
|
+
<details>
|
|
102
|
+
<summary>维护者的工作上下文——点击展开</summary>
|
|
103
|
+
|
|
104
|
+
无。
|
|
105
|
+
|
|
106
|
+
</details>
|
package/cordis.patch.yml
ADDED
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# Experimental Agent Teams profile layer. Apply after dsh-base so these replacements
|
|
2
|
+
# remove the global continuable-child controls before the scoped Team tools
|
|
3
|
+
# register the overlapping list_agents, send_message, and interrupt_agent names.
|
|
4
|
+
|
|
5
|
+
- id: tool-subagent-control
|
|
6
|
+
disabled: true
|
|
7
|
+
|
|
8
|
+
- id: tool-subagent-list-agents
|
|
9
|
+
disabled: true
|
|
10
|
+
|
|
11
|
+
- id: tool-subagent
|
|
12
|
+
config:
|
|
13
|
+
provider: spawn
|
|
14
|
+
toolName: subagent
|
|
15
|
+
backgroundMode: one-shot
|
|
16
|
+
|
|
17
|
+
- id: tool-subagent-fork
|
|
18
|
+
config:
|
|
19
|
+
provider: fork
|
|
20
|
+
toolName: subagent_fork
|
|
21
|
+
backgroundMode: one-shot
|
|
22
|
+
|
|
23
|
+
- insert:
|
|
24
|
+
- id: agent-team
|
|
25
|
+
name: '@deepseek-ai/dsh-experimental-agent-team'
|
|
26
|
+
config:
|
|
27
|
+
maxMembers: 8
|
|
28
|
+
maxTasks: 256
|
|
29
|
+
maxPendingMessagesPerMember: 64
|
|
30
|
+
maxMessageBytes: 65536
|
|
31
|
+
disposalTimeoutMs: 5000
|
|
32
|
+
|
|
33
|
+
- id: tool-agent-team
|
|
34
|
+
name: '@deepseek-ai/dsh-experimental-tool-agent-team'
|
|
35
|
+
config:
|
|
36
|
+
freshProvider: spawn
|
|
37
|
+
forkProvider: fork
|
package/lib/index.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @deepseek-ai/dsh-experimental-agent-team-profile — experimental Agent Teams profile bundle.
|
|
3
|
+
* The package's runtime content is its `dsh.bundle.patch` document; this
|
|
4
|
+
* module exports no runtime API.
|
|
5
|
+
* @module @deepseek-ai/dsh-experimental-agent-team-profile
|
|
6
|
+
*/
|
|
7
|
+
export {};
|
|
8
|
+
//# sourceMappingURL=index.d.ts.map
|
package/package.json
ADDED
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@deepseek-ai/dsh-experimental-agent-team-profile",
|
|
3
|
+
"description": "Experimental profile bundle enabling Agent Teams over dsh-base",
|
|
4
|
+
"version": "0.1.5-alpha.2",
|
|
5
|
+
"publishConfig": {
|
|
6
|
+
"access": "public"
|
|
7
|
+
},
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
|
|
11
|
+
"directory": "packages/experimental/agent-team-profile"
|
|
12
|
+
},
|
|
13
|
+
"type": "module",
|
|
14
|
+
"main": "lib/index.js",
|
|
15
|
+
"types": "lib/types/index.d.ts",
|
|
16
|
+
"exports": {
|
|
17
|
+
".": {
|
|
18
|
+
"types": "./lib/types/index.d.ts",
|
|
19
|
+
"default": "./lib/index.js"
|
|
20
|
+
},
|
|
21
|
+
"./cordis.patch.yml": "./cordis.patch.yml",
|
|
22
|
+
"./src/*": "./src/*",
|
|
23
|
+
"./package.json": "./package.json"
|
|
24
|
+
},
|
|
25
|
+
"files": [
|
|
26
|
+
"lib/index.js",
|
|
27
|
+
"cordis.patch.yml",
|
|
28
|
+
"lib/types/**/*.d.ts"
|
|
29
|
+
],
|
|
30
|
+
"license": "MIT",
|
|
31
|
+
"dsh": {
|
|
32
|
+
"bundle": {
|
|
33
|
+
"patch": "./cordis.patch.yml"
|
|
34
|
+
}
|
|
35
|
+
},
|
|
36
|
+
"dependencies": {
|
|
37
|
+
"@deepseek-ai/dsh-experimental-agent-team": "^0.1.5-alpha.2",
|
|
38
|
+
"@deepseek-ai/dsh-experimental-tool-agent-team": "^0.1.5-alpha.2"
|
|
39
|
+
},
|
|
40
|
+
"peerDependencies": {
|
|
41
|
+
"@deepseek-ai/cordis": "^4.0.2"
|
|
42
|
+
},
|
|
43
|
+
"devDependencies": {
|
|
44
|
+
"js-yaml": "^4.2.0",
|
|
45
|
+
"@deepseek-ai/cordis-plugin-include": "^1.0.7",
|
|
46
|
+
"@deepseek-ai/cordis": "^4.0.2"
|
|
47
|
+
}
|
|
48
|
+
}
|