@qlzt/dsh-subagent-spawn-in-process 0.2.1-alpha.2 → 0.2.1-rc.2

package/README.i18n.yaml

@@ -24,14 +24,14 @@
   en: 3f53b0d5f4037171
   zh: e0f2ac931cfbef95
 /deepseek-ai-dsh-subagent-spawn-in-process/use-this-package/what-a-delegation-does:
-  en: eabf1d0e66fde8fa
-  zh: d6de66797060bac5
+  en: 0c90404ed53cf451
+  zh: 161e38b7d7c10182
 /deepseek-ai-dsh-subagent-spawn-in-process/understand-the-implementation:
   en: 7f34637751939818
   zh: 2937553168e1aee5
 /deepseek-ai-dsh-subagent-spawn-in-process/understand-the-implementation/design-concept:
-  en: 67b871bbb7dcc803
-  zh: 79a8fec9117ef52a
+  en: a5b418fb260e2b9f
+  zh: 06dd949e350e9585
 /deepseek-ai-dsh-subagent-spawn-in-process/understand-the-implementation/source-map:
   en: b7c55a4bff3ae1f0
   zh: 9d0f514f433250c6
@@ -39,8 +39,8 @@
   en: 5f07f1044bf7c370
   zh: d31a485a3e333500
 /deepseek-ai-dsh-subagent-spawn-in-process/understand-the-implementation/ownership-and-scope:
-  en: 8af949dc29cb4a5c
-  zh: f4e4f9f9f4a4b7c9
+  en: 1288272d1eabfdc1
+  zh: 6efde7517f434179
 /deepseek-ai-dsh-subagent-spawn-in-process/further-exploration:
   en: c247efa590d8b78a
   zh: 999f8281df521384
@@ -51,14 +51,14 @@
   en: 05e6180f1498fdf9
   zh: 2b05d2b97bfa67da
 /deepseek-ai-dsh-subagent-spawn-in-process/model-experience/child-agent-request/what-the-model-sees:
-  en: 2035bdd8640e5a8a
-  zh: 5afa645d7dbe31a5
+  en: c9dfab9a4d363fed
+  zh: 6cb3b0914ccb73e2
 /deepseek-ai-dsh-subagent-spawn-in-process/model-experience/child-agent-request/token-effect:
-  en: e74d21e38e4a53a9
-  zh: 6a5e3ef5fe0f4f14
+  en: eb373a4b35a4b548
+  zh: 9537d0e466e8bcd9
 /deepseek-ai-dsh-subagent-spawn-in-process/model-experience/child-agent-request/kv-cache-effect:
-  en: 78d800b26fb3b0af
-  zh: 313169b62c29af1d
+  en: 6da85bad412c741e
+  zh: c9af9fd1b4e7eed2
 /deepseek-ai-dsh-subagent-spawn-in-process/model-experience/parent-tool-result-indirectly:
   en: 75d061c2151624a7
   zh: 71e58e020b60ff90
@@ -72,8 +72,8 @@
   en: f5d5f97a153f7c70
   zh: 3d6bc05b9eadfbc2
 /deepseek-ai-dsh-subagent-spawn-in-process/known-limitations-and-deferred-work:
-  en: 68720f2a663a4aad
-  zh: a472436c5cc2b801
+  en: 0c0b19dc1ccec027
+  zh: a7799c516dc3b034
 /deepseek-ai-dsh-subagent-spawn-in-process/known-limitations-and-deferred-work/dev-note:
   en: e67f633dc6fe7773
   zh: 3bb0c20c93f16f98

package/README.md

@@ -53,6 +53,8 @@ The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-a
 
 One tool call creates a background child and returns its session id immediately. The child works in its own session; the parent receives its final answer in a completion notice. The child can also send messages through `send_message`. A rejected start leaves no published child. Programmatic callers such as workflows can await the activation result directly.
 
+An explicit `agentPreset` selects the currently registered preset independently; omission joins the parent's active revision. Only spawn supports this choice. Persona and tools belong in the [preset definition](../../preset/agent-preset-registry/README.md). Cold resume follows the shared [child composition rules](../subagent/README.md#restoring-child-composition).
+
 -----
 
 <a id="understand-the-implementation"></a>
@@ -65,7 +67,7 @@ This section explains provider preparation and the activation lifecycle owned by
 
 ### Design concept
 
-This backend registers the provider and prepares a fresh child session. `dsh-subagent` owns activation depth checks, child creation, tool and persona setup, structured output, result collection, and disposal. The caller signal cancels unpublished creation; the published handle cancels and reaches quiescence through `dispose()`.
+This backend registers the provider and prepares a fresh child session. `dsh-subagent` owns activation depth checks, child creation, preset composition, structured output, result collection, and disposal. The caller signal cancels unpublished creation; the published handle cancels and reaches quiescence through `dispose()`.
 
 ### Source map
 
@@ -79,7 +81,7 @@ This backend registers the provider and prepares a fresh child session. `dsh-sub
 
 ### Ownership and scope
 
-The child gets a fresh flat registration scope: parent tool restrictions and authority are never imported, and the filter the tool applies is composition, not a parent-derived grant. The backend advertises all five start-time capabilities, including `agentOptions`, because it controls the child's creation window and can enforce each one.
+The child has its own registration scope below the inherited or independently selected preset. The parent's agent-local tool restrictions are not imported. The backend advertises `agentPreset` and `agentOptions` alongside its other start-time capabilities; the subagent manager applies them during child creation.
 
 </details>
 
@@ -104,15 +106,15 @@ Read these pages when the package-level contract is not enough; they move from t
 
 #### What the model sees
 
-The fresh child receives the task content verbatim as its only user message in a new empty conversation, with the parent provider, model, reasoning effort, output-token limit, and working directory by default. A configured persona shadows global prompt text in the child's scope; a tool filter removes named global tools from its schemas, executable lookup, and PTC mode SDK bindings while leaving independently registered guidance. No parent conversation message is included; the filter is composition, not an inherited authority grant.
+The fresh child receives the task content verbatim as its only user message in a new empty conversation, with the parent provider, model, reasoning effort, output-token limit, and working directory by default. The inherited or selected preset supplies tools and prompt sections. No parent conversation message is included.
 
 #### Token effect
 
-The child pays for a new independent context and history, and no parent-history token is duplicated. A persona changes the child's repeated prompt cost; a tool filter changes its schema or generated SDK cost.
+The child pays for a new independent context and history, and no parent-history token is duplicated. The preset's prompt and tools determine repeated prompt, schema, and generated SDK costs.
 
 #### KV Cache effect
 
-The child's request cache is independent of the parent's. Child history grows append-only, while persona, tool-filter, generated-SDK, provider, or model changes establish a different child prefix.
+The child's request cache is independent of the parent's. Child history grows append-only, while preset, generated-SDK, provider, or model changes establish a different child prefix.
 
 ### Parent tool result, indirectly
 
@@ -135,7 +137,7 @@ Append-only; newly visible content follows the reusable request prefix and does
 
 These limits define when the backend is the wrong choice; they are current package constraints.
 
-- **Fresh means no parent transcript** — the child inherits cwd, lineage, provider, model, reasoning effort, output-token limit, and explicitly configured persona or tool restrictions, but none of the parent's conversation; use the fork backend when completed-turn context is required.
+- **Fresh means no parent transcript** — the child inherits cwd, lineage, provider, model, reasoning effort, and output-token limit, but none of the parent's conversation; use the fork backend when completed-turn context is required.
 
 <a id="dev-note"></a>
 ### Dev Note

package/README.zh.md

@@ -53,6 +53,8 @@ kind: "package-reference"
 
 一次工具调用创建后台子 agent 并立即返回子会话 ID。子级在自己的会话中工作，父级通过完成通知收到其最终答案。子级也可以通过 `send_message` 发送消息。被拒绝的启动不会留下已发布的子 agent；工作流等程序调用方可以直接等待 activation 的结果。
 
+显式 `agentPreset` 独立选择当前注册的 preset；省略时加入父方的活跃代际。只有 spawn 支持此选择。persona 与工具放在 [preset 定义](../../preset/agent-preset-registry/README.zh.md)中。冷恢复遵守共享的[子级组装规则](../subagent/README.zh.md#restoring-child-composition)。
+
 -----
 
 <a id="understand-the-implementation"></a>
@@ -65,7 +67,7 @@ kind: "package-reference"
 
 ### 设计理念
 
-本后端注册提供方并准备全新子会话。`dsh-subagent` 拥有 activation 的深度检查、子 agent 创建、工具和 persona 设置、结构化输出、结果收集及资源释放；发布前的调用方信号取消创建，发布后的句柄通过 `dispose()` 取消并等待完全停稳。
+本后端注册提供方并准备全新子会话。`dsh-subagent` 拥有 activation 的深度检查、子 agent 创建、preset 组装、结构化输出、结果收集及资源释放；发布前的调用方信号取消创建，发布后的句柄通过 `dispose()` 取消并等待完全停稳。
 
 ### 源码地图
 
@@ -79,7 +81,7 @@ kind: "package-reference"
 
 ### 所有权与作用域
 
-子 agent 获得全新的扁平注册作用域：父级工具限制与权限绝不会被导入，工具所施加的过滤属于组合而非父级派生授权。后端声明包括 `agentOptions` 在内的全部五项启动时能力，因为它控制子 agent 的创建窗口，可以逐一强制执行。
+子级在继承或独立选择的 preset 之下拥有自身注册作用域，不导入父方的 Agent 局部工具限制。后端在其他启动时能力之外声明 `agentPreset` 和 `agentOptions`，由 subagent manager 在创建子级时应用。
 
 </details>
 
@@ -104,15 +106,15 @@ kind: "package-reference"
 
 #### 模型看到什么
 
-全新子 agent 逐字接收任务内容，作为新空对话中的唯一用户消息，默认使用父级提供方、模型、推理强度、输出 token 上限与工作目录。配置的 persona 会在子 agent 作用域中遮蔽全局提示词文本；工具过滤器会从其 schema、可执行工具查找与 PTC mode SDK 绑定中移除指定的全局工具，但保留独立注册的指导内容。不包含任何父级对话消息；过滤属于组合，而非继承的权限授予。
+全新子 agent 逐字接收任务内容，作为新空对话中的唯一用户消息，默认使用父级提供方、模型、推理强度、输出 token 上限与工作目录。继承或选定的 preset 提供工具和提示词片段。不包含任何父级对话消息。
 
 #### Token 影响
 
-子 agent 会为全新的独立上下文与历史消耗 token，不复制任何父级历史 token。persona 会改变该子 agent 反复使用的提示词成本；工具过滤器会改变其 schema 或生成 SDK 的成本。
+子 agent 会为全新的独立上下文与历史消耗 token，不复制任何父级历史 token。preset 的提示词和工具决定重复提示词、schema 和生成 SDK 的成本。
 
 #### KV Cache 影响
 
-子 agent 的请求缓存与父级相互独立。子 agent 历史仅追加；persona、工具过滤、生成 SDK、提供方或模型变化会建立不同的子 agent 前缀。
+子 agent 的请求缓存与父级相互独立。子 agent 历史仅追加；preset、生成 SDK、提供方或模型变化会建立不同的子 agent 前缀。
 
 ### 父级工具结果（间接）
 
@@ -135,7 +137,7 @@ kind: "package-reference"
 
 这些限制说明何时选择该后端是错误的；它们是当前包约束。
 
-- **全新表示不含父级 transcript（文本记录）**——子 agent 继承 cwd、谱系、提供方、模型、推理强度、输出 token 上限及显式配置的 persona/工具限制，但不继承父级的任何对话；需要已完成轮次上下文时，请使用 fork 后端。
+- **全新表示不含父级 transcript（文本记录）**——子 agent 继承 cwd、谱系、提供方、模型、推理强度及输出 token 上限，但不继承父级的任何对话；需要已完成轮次上下文时，请使用 fork 后端。
 
 <a id="dev-note"></a>
 ### 开发备注

package/lib/index.js

@@ -14,17 +14,15 @@ const Config = z.object({ providerName: z.string().default("spawn") });
 * The spawn provider. Supports every start-time capability: `depthLimit` (it
 * constructs the child, so it can enforce a recursion cap), `outputSchema`
 * (the scoped structured runtime), `agentOptions` (merged over the parent
-* route), and `toolFilter`/`persona` (scoped `restrict()` and a scoped
-* shadowing persona section, applied in the child's creation window).
+* route). The selected preset owns persona and tool composition.
 */
 var SpawnInProcessProvider = class {
 	name;
 	capabilities = {
 		agentOptions: true,
+		agentPreset: true,
 		outputSchema: true,
-		depthLimit: true,
-		toolFilter: true,
-		persona: true
+		depthLimit: true
 	};
 	inheritsParentContext = false;
 	constructor(name) {

package/locale/en.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "title": "subagent-spawn-in-process"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "新建子智能体后端",
+    "description": "在当前进程中新建子智能体，执行独立任务。"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qlzt/dsh-subagent-spawn-in-process",
   "description": "In-process spawn subagent backend: runs a fresh child agent on ctx.agents",
-  "version": "0.2.1-alpha.2",
+  "version": "0.2.1-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -19,37 +19,39 @@
       "default": "./lib/index.js"
     },
     "./src/*": "./src/*",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "files": [
+    "locale/*.json",
     "lib/index.js",
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@qlzt/dsh-subagent": "0.2.1-alpha.2",
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+    "@qlzt/dsh-subagent": "0.2.1-rc.2",
+    "@deepseek-ai/cordis": "~4.0.5"
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
+    "@deepseek-ai/schemastery": "~3.18.5"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-bash-local": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-subprocess-local": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-llm-deepseek": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-tool-bash": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-tool-subagent": "0.2.1-alpha.2",
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.2"
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.6",
+    "@deepseek-ai/dsh-agent": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-agent-loop": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-bash-local": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-subprocess-local": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-llm-deepseek": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-subagent": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-tool-bash": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-tool-subagent": "0.2.1-rc.2",
+    "@deepseek-ai/cordis": "~4.0.5",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-rc.2"
   },
   "dsh": {}
 }