@deepseek-ai/dsh-subagent-dsh-sdk 0.2.1-alpha.2 → 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 (5) hide show
  1. package/README.i18n.yaml +6 -6
  2. package/README.md +4 -4
  3. package/README.zh.md +4 -4
  4. package/lib/index.js +1 -1
  5. package/package.json +30 -30
package/README.i18n.yaml CHANGED
@@ -18,8 +18,8 @@
18
18
  en: d6eb16d8fc690671
19
19
  zh: 5865ee3bed0b36ca
20
20
  /deepseek-ai-dsh-subagent-dsh-sdk/use-this-package/when-to-choose-it:
21
- en: 83a84f1d42a071da
22
- zh: 0dce8e7ea861f8c2
21
+ en: 8e24d667f376ae01
22
+ zh: 5b05c7dc46ebb040
23
23
  /deepseek-ai-dsh-subagent-dsh-sdk/use-this-package/configuration:
24
24
  en: 67cf17bbc985cad7
25
25
  zh: ea432ae524f4ade9
@@ -57,8 +57,8 @@
57
57
  en: 05e6180f1498fdf9
58
58
  zh: 2b05d2b97bfa67da
59
59
  /deepseek-ai-dsh-subagent-dsh-sdk/model-experience/child-agent-request/what-the-model-sees:
60
- en: df7729fa4e60d6f6
61
- zh: 458094fbb7a7ea07
60
+ en: b8e656d956ac5bd2
61
+ zh: 26fa79357d1ce452
62
62
  /deepseek-ai-dsh-subagent-dsh-sdk/model-experience/child-agent-request/token-effect:
63
63
  en: c0b78d334d5d0a9c
64
64
  zh: 71d1a375a6ab4109
@@ -78,8 +78,8 @@
78
78
  en: f5d5f97a153f7c70
79
79
  zh: 3d6bc05b9eadfbc2
80
80
  /deepseek-ai-dsh-subagent-dsh-sdk/known-limitations-and-deferred-work:
81
- en: 9158e90d1a521c05
82
- zh: 246ed0c694ead7ac
81
+ en: 8f43f79098cfeb37
82
+ zh: a5ded4086e3d8773
83
83
  /deepseek-ai-dsh-subagent-dsh-sdk/known-limitations-and-deferred-work/dev-note:
84
84
  en: 04a404ccea615ef3
85
85
  zh: df2d9d901d75f024
package/README.md CHANGED
@@ -29,9 +29,9 @@ Mount this provider when a delegation should run as a complete Harness runtime i
29
29
 
30
30
  ### When to choose it
31
31
 
32
- Choose this backend when the child must be a full harness peer — its own composition, session persistence, model route, and tools — rather than an agent that shares the parent's process. Choose an in-process backend when the child must share the parent's composition or honor parent-enforced non-route capabilities: this provider accepts agent route options but rejects structured output, depth caps, tool filters, and personas rather than silently omitting them.
32
+ Choose this backend when the child must be a full harness peer — its own composition, session persistence, model route, and tools — rather than an agent that shares the parent's process. Choose an in-process backend when the child must share the parent's composition or honor parent-enforced non-route capabilities: this provider accepts agent route options but rejects independent presets, structured output, and depth caps rather than silently omitting them.
33
33
 
34
- The provider advertises `agentOptions: true`, with `outputSchema`/`depthLimit`/`toolFilter`/`persona` false, and `inheritsParentContext: false`. Its immutable `agentRouteDefaults` publish the configured provider/model baseline to `dsh-tool-subagent` before model overrides and exact-route preflight; the backend applies the same configuration defaults during activation startup, including `maxTokens`. Agent route values cross the SDK wire as an explicit whitelist; the child remains a fresh runtime in another process, and the child process uses the selected effective directory while its Session retains the parent origin directory. `dsh-tool-subagent` deployments over this provider set `maxDepth: 'provider-managed'` — the child harness owns its own recursion budget.
34
+ The provider advertises `agentOptions: true`, with `agentPreset`/`outputSchema`/`depthLimit` false, and `inheritsParentContext: false`. Its immutable `agentRouteDefaults` publish the configured provider/model baseline to `dsh-tool-subagent` before model overrides and exact-route preflight; the backend applies the same configuration defaults during activation startup, including `maxTokens`. Agent route values cross the SDK wire as an explicit whitelist; the child remains a fresh runtime in another process, and the child process uses the selected effective directory while its Session retains the parent origin directory. `dsh-tool-subagent` deployments over this provider set `maxDepth: 'provider-managed'` — the child harness owns its own recursion budget.
35
35
 
36
36
  ### Configuration
37
37
 
@@ -137,7 +137,7 @@ Read these pages when the package-level contract is not enough. They move from t
137
137
 
138
138
  #### What the model sees
139
139
 
140
- The child runtime's model receives the standalone task as its user message plus that runtime's own configured system prompt, tools, and fresh session. It receives no parent conversation. A parent tool call may choose the child provider, model, and reasoning effort for this run; the selected route and any deployment-owned output cap are fixed for the new child process. Persona, tool filtering, depth enforcement, and structured output remain unsupported and are rejected instead of silently omitted.
140
+ The child runtime's model receives the standalone task as its user message plus that runtime's own configured system prompt, tools, and fresh session. It receives no parent conversation. A parent tool call may choose the child provider, model, and reasoning effort for this run; the selected route and any deployment-owned output cap are fixed for the new child process. Independent presets, depth enforcement, and structured output remain unsupported and are rejected instead of silently omitted.
141
141
 
142
142
  #### Token effect
143
143
 
@@ -169,7 +169,7 @@ Append-only; newly visible content follows the reusable request prefix and does
169
169
  These limits define when this backend is a poor fit or needs special operational care. They are current package constraints, not a general SDK comparison or a task backlog.
170
170
 
171
171
  - **A fresh runtime process per run** — no pooling; a harness runtime boots a full plugin tree, so per-run spawn cost is higher than the ACP backend's typical child.
172
- - **No non-route start-time capabilities** — the parent can select the child agent route but cannot enforce `outputSchema`, depth, tool filters, or persona inside the child process; configure the selected child profile and its ordered patches instead.
172
+ - **No non-route start-time capabilities** — the parent can select the child agent route but cannot enforce `agentPreset`, `outputSchema`, or depth inside the child process; configure the selected child profile and its ordered patches instead.
173
173
  - **The child's transcript stays in the child's own session root** — the parent log retains the external task identity and full result, while the streamed `session.event` channel is consumed for output extraction rather than transcript replication.
174
174
  - **Local child processes only** — the resolved working directory is a local path; a remote runtime would need its own backend.
175
175
 
package/README.zh.md CHANGED
@@ -29,9 +29,9 @@ kind: "package-reference"
29
29
 
30
30
  ### 何时选择
31
31
 
32
- 当子进程必须是完整的 harness 对等体——拥有自己的组合、会话持久化、模型路由与工具——而不是共享父进程的 agent 时，选择此后端。当子进程必须共享父级组合或遵守父级强制的非路由能力时，请选择进程内后端：本提供方接受 agent 路由选项，但会拒绝结构化输出、深度上限、工具过滤或 persona，而不是静默省略。
32
+ 当子进程必须是完整的 harness 对等体——拥有自己的组合、会话持久化、模型路由与工具——而不是共享父进程的 agent 时，选择此后端。当子进程必须共享父级组合或遵守父级强制的非路由能力时，请选择进程内后端：本提供方接受 agent 路由选项，但会拒绝独立 preset、结构化输出或深度上限，而不是静默省略。
33
33
 
34
- 提供方声明 `agentOptions: true`，同时保持 `outputSchema`/`depthLimit`/`toolFilter`/`persona` 为 false，并且 `inheritsParentContext: false`。不可变的 `agentRouteDefaults` 会在模型覆盖与确切路由预检前，把配置的 provider／model 基线公开给 `dsh-tool-subagent`；后端在 activation 启动时应用同一份配置默认值，包括 `maxTokens`。agent 路由值通过显式白名单跨越 SDK 协议；子进程仍是另一进程里的全新运行时，子进程使用所选有效目录，而其 Session 保留父级起始目录。基于本提供方的 `dsh-tool-subagent` 部署应设置 `maxDepth: 'provider-managed'`——子 harness 拥有自己的递归预算。
34
+ 提供方声明 `agentOptions: true`，同时保持 `agentPreset`/`outputSchema`/`depthLimit` 为 false，并且 `inheritsParentContext: false`。不可变的 `agentRouteDefaults` 会在模型覆盖与确切路由预检前，把配置的 provider／model 基线公开给 `dsh-tool-subagent`；后端在 activation 启动时应用同一份配置默认值，包括 `maxTokens`。agent 路由值通过显式白名单跨越 SDK 协议；子进程仍是另一进程里的全新运行时，子进程使用所选有效目录，而其 Session 保留父级起始目录。基于本提供方的 `dsh-tool-subagent` 部署应设置 `maxDepth: 'provider-managed'`——子 harness 拥有自己的递归预算。
35
35
 
36
36
  ### 配置
37
37
 
@@ -137,7 +137,7 @@ kind: "package-reference"
137
137
 
138
138
  #### 模型看到什么
139
139
 
140
- 子运行时的模型会收到作为用户消息的独立任务，以及该运行时自身配置的系统提示词、工具和全新会话。它不会收到父级对话。父级工具调用可以为本次运行选择子级提供方、模型与推理强度；所选路由和由部署控制的可选输出上限会固定到这个新子进程。persona、工具过滤、深度强制与结构化输出仍不受支持，并会被拒绝而不是静默省略。
140
+ 子运行时的模型会收到作为用户消息的独立任务，以及该运行时自身配置的系统提示词、工具和全新会话。它不会收到父级对话。父级工具调用可以为本次运行选择子级提供方、模型与推理强度；所选路由和由部署控制的可选输出上限会固定到这个新子进程。独立 preset、深度强制与结构化输出仍不受支持，并会被拒绝而不是静默省略。
141
141
 
142
142
  #### Token 影响
143
143
 
@@ -169,7 +169,7 @@ kind: "package-reference"
169
169
  这些限制说明本后端何时不合适，或何时需要特别的运维注意。它们是当前包约束，不是通用 SDK 对比或任务积压。
170
170
 
171
171
  - **每次运行都使用全新的运行时进程**——不使用进程池；harness 运行时需要启动完整的插件树，因此每次运行的 spawn 成本高于 ACP 后端通常使用的子进程。
172
- - **不支持路由之外的启动时能力**——父级可以选择子 agent 路由，但无法在子进程内强制执行 `outputSchema`、深度限制、工具过滤或 persona；应改为配置所选子 profile 及其有序 patch。
172
+ - **不支持路由之外的启动时能力**——父级可以选择子 agent 路由，但无法在子进程内强制执行 `agentPreset`、`outputSchema` 或深度限制；应改为配置所选子 profile 及其有序 patch。
173
173
  - **子任务转录保留在子进程自己的会话根目录中**——父日志保留外部任务身份与完整结果；流式 `session.event` 通道用于提取输出，不用于复制子任务转录。
174
174
  - **仅支持本地子进程**——解析出的工作目录是本地路径；远程运行时需要独立的后端。
175
175
 
package/lib/index.js CHANGED
@@ -334,7 +334,7 @@ function resolveSdkRoute(config, requested) {
334
334
  }
335
335
  /**
336
336
  * The SDK provider. It resolves Agent route options into the child runtime's
337
- * process-wide handshake; output schema, depth, tool filter, and persona stay
337
+ * process-wide handshake; output schema, depth, and independent preset selection stay
338
338
  * unsupported because their ownership does not cross this process boundary.
339
339
  */
340
340
  var SdkSubagentProvider = class {
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@deepseek-ai/dsh-subagent-dsh-sdk",
3
3
  "description": "Out-of-process SDK subagent backend: drives a child DeepSeek Harness runtime subprocess over stdio JSON-RPC through the TypeScript SDK client",
4
- "version": "0.2.1-alpha.2",
4
+ "version": "0.2.1-alpha.3",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -27,38 +27,38 @@
27
27
  ],
28
28
  "license": "MIT",
29
29
  "peerDependencies": {
30
- "@deepseek-ai/cordis": "~4.0.5-alpha.1",
31
- "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
32
- "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
33
- "@deepseek-ai/dsh-sdk-client": "0.2.1-alpha.2",
34
- "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
35
- "@deepseek-ai/dsh-subagent": "0.2.1-alpha.2",
36
- "@deepseek-ai/dsh-subprocess": "0.2.1-alpha.2"
30
+ "@deepseek-ai/cordis": "~4.0.5-alpha.2",
31
+ "@deepseek-ai/dsh-agent": "0.2.1-alpha.3",
32
+ "@deepseek-ai/dsh-llm": "0.2.1-alpha.3",
33
+ "@deepseek-ai/dsh-sdk-client": "0.2.1-alpha.3",
34
+ "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
35
+ "@deepseek-ai/dsh-subagent": "0.2.1-alpha.3",
36
+ "@deepseek-ai/dsh-subprocess": "0.2.1-alpha.3"
37
37
  },
38
38
  "dependencies": {
39
- "@deepseek-ai/dsh-brand": "0.2.1-alpha.2",
40
- "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
39
+ "@deepseek-ai/dsh-brand": "0.2.1-alpha.3",
40
+ "@deepseek-ai/schemastery": "~3.18.5-alpha.2"
41
41
  },
42
42
  "devDependencies": {
43
- "@deepseek-ai/cordis": "~4.0.5-alpha.1",
44
- "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
45
- "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
46
- "@deepseek-ai/dsh-agent-instructions": "0.2.1-alpha.2",
47
- "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.2",
48
- "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
49
- "@deepseek-ai/dsh-llm-deepseek": "0.2.1-alpha.2",
50
- "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.1-alpha.2",
51
- "@deepseek-ai/dsh-loader-smoke": "0.2.1-alpha.2",
52
- "@deepseek-ai/dsh-sdk-client": "0.2.1-alpha.2",
53
- "@deepseek-ai/dsh-sdk-protocol": "0.2.1-alpha.2",
54
- "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
55
- "@deepseek-ai/dsh-session-checkpoint-policy": "0.2.1-alpha.2",
56
- "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.2",
57
- "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2",
58
- "@deepseek-ai/dsh-skill-filesystem": "0.2.1-alpha.2",
59
- "@deepseek-ai/dsh-subagent": "0.2.1-alpha.2",
60
- "@deepseek-ai/dsh-subprocess": "0.2.1-alpha.2",
61
- "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.2",
62
- "@deepseek-ai/dsh-tool-subagent": "0.2.1-alpha.2"
43
+ "@deepseek-ai/cordis": "~4.0.5-alpha.2",
44
+ "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.2",
45
+ "@deepseek-ai/dsh-agent": "0.2.1-alpha.3",
46
+ "@deepseek-ai/dsh-agent-instructions": "0.2.1-alpha.3",
47
+ "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.3",
48
+ "@deepseek-ai/dsh-llm": "0.2.1-alpha.3",
49
+ "@deepseek-ai/dsh-llm-deepseek": "0.2.1-alpha.3",
50
+ "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.1-alpha.3",
51
+ "@deepseek-ai/dsh-loader-smoke": "0.2.1-alpha.3",
52
+ "@deepseek-ai/dsh-sdk-client": "0.2.1-alpha.3",
53
+ "@deepseek-ai/dsh-sdk-protocol": "0.2.1-alpha.3",
54
+ "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
55
+ "@deepseek-ai/dsh-session-checkpoint-policy": "0.2.1-alpha.3",
56
+ "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.3",
57
+ "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.3",
58
+ "@deepseek-ai/dsh-skill-filesystem": "0.2.1-alpha.3",
59
+ "@deepseek-ai/dsh-subagent": "0.2.1-alpha.3",
60
+ "@deepseek-ai/dsh-subprocess": "0.2.1-alpha.3",
61
+ "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.3",
62
+ "@deepseek-ai/dsh-tool-subagent": "0.2.1-alpha.3"
63
63
  }
64
64
  }