dsh-plugin-subagent-director 0.3.0 → 0.4.0-beta.1

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 本项目的所有显著变更都会记录在此文件中。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## [0.4.0-beta.1] - 2026-08-30
+
+### 新增
+
+- **纯编排模式（`/orchestrate`）**（PR #3，@WinterSold1er）：`/orchestrate on|off` 命令（无参数默认 on），开启后注入「纯编排者」系统提示——主代理只允许通过 `subagent_role` 委派、禁止亲自读/写/执行，角色清单从 `subagent-director.roles` 动态渲染（无硬编码 role id），未配置角色时提示先配置；`sessionProjections` 服务缺失时命令返回明确错误而非假装成功。
+
+### 修复
+
+- **真实 cordis 探针发现的隐性 bug**（issue #5）：cordis 的 `ctx.effect(fn)` 契约是「立即执行 fn、以返回值为 disposer」，原先包在 effect 里的 `fiber.dispose()` 清理块会把 `/orchestrate` 命令与 projection 的 `ctx.inject` 子 fiber **在创建瞬间卸载**——真实宿主上命令从未注册成功过（既有测试全基于 fake，未覆盖该契约）；子 fiber 本就随父 fiber 生命周期自动卸载，清理块已移除，并由新增的真实 cordis 探针测试永久钉住；
+- **开发/测试环境对齐真实宿主 0.1.1 线**（issue #5）：devDeps 与 peer ranges 由 `0.1.0-rc.6/rc.8` 升至 `^0.1.1-rc.2`（新增 `dsh-session-projection` peer）；projection 注册改用真实类型契约（`SessionEventMap` / `SessionProjectionStateMap` / `SessionProjectionMap` 声明合并 + 类型化 `register`），契约形状漂移现在在 typecheck 期暴露，而不是运行期被 `snapshot()` 静默跳过；
+- 顶层 `inject` 移除 `'commands'`（非 dsh-base 装配上主条目会永久 PENDING、核心委派功能全失效）；命令 handler 增加 `invocation.agent.session` 可选链守卫；
+- 移除未使用的 `@deepseek-ai/dsh-client-schema-form` 依赖（源码零引用，且其 0.1.0 线 peer 链与 0.1.1 线冲突）。
+
+### 测试
+
+- 单元/集成测试由 197 增至 233：`/orchestrate` 功能与接线用例、handler 守卫用例，以及**真实 cordis `Context` + 真实 `SessionProjectionRegistry` 集成探针**（无 commands 服务时主条目正常激活、核心服务缺失时保持 PENDING、commands 后到时命令经真实 `ctx.inject` 子 fiber 响应式注册、projection 经真实 `snapshot()` 驱动 on→off 折叠）。
+
+### 已知取舍
+
+- 用过 `/orchestrate` 的会话在未挂载本插件的 boot（卸载后、其他 profile）中无法加载：上游暂无第三方事件注册 / `ignorable` 写入 API，已在 README FAQ 与 issue #6 记录。
+
 ## [0.3.0] - 2026-08-29
 
 ### 新增

package/README.md

@@ -55,7 +55,7 @@ dsh plugin --profile <name> add dsh-plugin-subagent-director
   name: dsh-plugin-subagent-director
   config:
     subagentProvider: spawn      # 传输：spawn（无父上下文）/ fork（继承父历史）
-    toolName: subagent_role      # 模型可见工具名
+    toolName: subagent_role      # 本插件注册的模型可见工具名（不是内置 subagent）
     enableRunInBackground: true
     backgroundMode: one-shot     # one-shot 或 continuable
     maxDepth: 3
@@ -124,6 +124,27 @@ subagent_role({ role: "code-reviewer", model: "deepseek-chat", prompt: "..." })
 `role` 参数支持用角色 id 或显示名引用：未命中 id 时会按 `displayName` 精确匹配
 （多个同名角色取定义顺序第一个并提示）；建议始终用 id，见系统提示中的 Delegate 行。
 
+> **`subagent_role` 与内置 `subagent` 是两个不同的工具。** 本插件注册的是
+> `subagent_role`（工具名由 `toolName` 配置，默认 `subagent_role`）；DSH 基础
+> bundle 另有内置的 `subagent` / `subagent_fork`，两者在同一次请求的工具清单里
+> **并存**。只有走 `subagent_role` 才会应用角色 persona 与 `toolFilter`；模型改用
+> 内置 `subagent` 时这两项不生效（`applyDefaultRoute` 开启时默认模型仍会生效）。
+> 因此需要角色语义时，请在提示里明确要求调用 `subagent_role`。
+
+### 纯编排模式（`/orchestrate`）
+
+```text
+/orchestrate        # 等价于 /orchestrate on
+/orchestrate on     # 进入纯编排模式
+/orchestrate off    # 退出
+```
+
+打开后会注入一段「纯编排者」系统提示：主代理只允许通过委派工具派活，角色清单
+从当前 `subagent-director.roles` 动态渲染（无硬编码 role id），未配置角色时提示
+先去配置。该模式依赖宿主的 `commands` 与 `sessionProjections` 服务：标准 profile
+（dsh-base）都会提供二者；`sessionProjections` 缺失时命令返回明确错误而不是假装
+成功，`commands` 缺失时命令不注册，插件其余功能不受影响。
+
 ## 术语
 
 - **subagentProvider（传输）**：`spawn` / `fork` / `acp`——子代理跑在哪条传输链路上；
@@ -135,7 +156,7 @@ subagent_role({ role: "code-reviewer", model: "deepseek-chat", prompt: "..." })
 
 ```bash
 npm install
-npm test          # vitest（129 用例）
+npm test          # vitest（233 用例）
 npm run typecheck
 npm run build     # host(tsc) + client(rolldown bundle)
 ```
@@ -150,6 +171,14 @@ DSH 的 Web API 只向白名单内的 settings 命名空间开放读写。本插
 `defaultProvider`/`defaultModel` 且未关闭 `applyDefaultRoute` 时，所有未显式
 指定模型的子代理（含内置工具发起的）都会使用该默认模型。
 
+**用过 `/orchestrate` 的会话，卸载插件后还能打开吗？**
+不能。`/orchestrate` 会在会话日志写入 `orchestrate/change` 事件，而宿主的持久化
+加载校验遇到「未知且未标记 ignorable」的事件类型时会拒绝加载整个日志（避免误解
+日志语义）。插件挂载时会动态注册该事件类型，正常使用不受影响；但在未挂载本插件
+的环境（卸载后、其他 profile）中，这些会话将无法打开。上游暂未提供第三方事件
+类型的官方注册或 `ignorable` 写入 API，此为已知取舍，详见
+[issue #6](https://github.com/SeverusZh/dsh-plugin-subagent-director/issues/6)。
+
 **新供应商/API 会自动出现吗？**
 会。设置页订阅了供应商与设置变更事件，在 Models 页新增供应商/API key 后，下拉列表自动刷新，无需重启。
 

package/lib/config.d.ts

@@ -27,7 +27,17 @@ export interface DirectorConfig {
      * Default 'spawn'.
      */
     subagentProvider?: string;
-    /** Model-facing tool name, default 'subagent_role'. Each loaded instance must use a distinct name. */
+    /**
+     * Model-facing tool name for THIS plugin's delegation tool, default
+     * 'subagent_role'. Each loaded instance must use a distinct name.
+     *
+     * Not the same tool as DSH's built-in `subagent` / `subagent_fork`: those are
+     * registered by the base bundle and coexist with this one in the same request
+     * tool catalog. Only calls that go through this name apply role persona and
+     * role `toolFilter`; a model that picks the built-in `subagent` instead gets
+     * neither (the default model route still applies when `applyDefaultRoute` is
+     * on — see below).
+     */
     toolName?: string;
     /** Expose `run_in_background` (default true). Disabled instances omit the argument. */
     enableRunInBackground?: boolean;

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,sGAAsG;IACtG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,uFAAuF;IACvF,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAEvC;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,qDAAqD;AACrD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;GAQjB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,uFAAuF;IACvF,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAEvC;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,qDAAqD;AACrD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;GAQjB,CAAC"}

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAiDzC,qDAAqD;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC;IAC7C,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAChD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IACxE,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACjF,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAC7C,CAAC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,CAAC,MAAM,0BAA0B,CAAC;AA2DzC,qDAAqD;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC;IAC7C,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAChD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IACxE,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACjF,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAC7C,CAAC,CAAC"}

package/lib/index.d.ts

@@ -8,7 +8,10 @@
  * Dependency posture: tools/subagents/llm/settings are required through inject
  * (both web and headless bundles mount the settings service); systemPrompt
  * remains optional and is acquired lazily so its absence does not block the
- * rest. The webServer-dependent HTTP bridge lives in the separate
+ * rest. The /orchestrate command's `commands` dependency likewise stays
+ * optional — acquired reactively (ctx.inject child fiber) in orchestrate.ts,
+ * so hosts without a command registry lose only that command. The
+ * webServer-dependent HTTP bridge lives in the separate
  * \`subagent-director-bridge\` entry (src/bridge-entry.ts).
  *
  * Background modes: 'one-shot' defaults calls to foreground and runs background
@@ -22,6 +25,7 @@ export { Config } from './config.js';
 export type { DirectorConfig } from './config.js';
 export { assertDelegationCapabilities, buildSubagentRequest, createDelegationParameters, createDelegationOutputSchema, createDelegationTool, DELEGATION_TOOL_PREFIX, resolveDelegationMode, renderDelegationResult, type DelegationToolArgs, type DelegationResult, type DelegationRoute, type DelegationModeDecision, type SubagentRequestParts, } from './delegation-tool.js';
 export { applyGuidance, renderRolesGuidance, GUIDANCE_SECTION_ORDER, GUIDANCE_SECTION_NAME } from './guidance.js';
+export { applyOrchestrate, renderOrchestratorPrompt, renderOrchestratorRoles, buildOrchestratorFrame, ORCHESTRATE_SECTION_NAME, ORCHESTRATE_SECTION_ORDER, ORCHESTRATE_PROJECTION_KEY, ORCHESTRATE_EVENT_TYPE, ORCHESTRATE_VALID_MODES, type OrchestrateMode, } from './orchestrate.js';
 export { CLOSE_SUBAGENT_TOOL_NAME, createCloseSubagentTool } from './close-tool.js';
 export { SUBAGENT_DIRECTOR_SETTINGS_NAMESPACE, SettingsSchema, validateDirectorSettings, installDirectorSettings, type RoleTemplate, type SubagentDirectorSettings, } from './settings.js';
 export declare const name = "subagent-director";

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAUnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAClH,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,EACL,oCAAoC,EACpC,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,wBAAwB,GAC9B,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,IAAI,sBAAsB,CAAC;AAExC,eAAO,MAAM,MAAM,UAA4C,CAAC;AAEhE,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,aAAa,EAAE,cAAc,QAgE/E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAWnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAClH,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,EACL,oCAAoC,EACpC,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,wBAAwB,GAC9B,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,IAAI,sBAAsB,CAAC;AAExC,eAAO,MAAM,MAAM,UAA4C,CAAC;AAEhE,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,aAAa,EAAE,cAAc,QAmE/E"}

package/lib/index.js

@@ -3,10 +3,12 @@ import { createDelegationTool } from './delegation-tool.js';
 import { CLOSE_SUBAGENT_TOOL_NAME, createCloseSubagentTool } from './close-tool.js';
 import { applyDefaultRouteSeam } from './default-route.js';
 import { applyGuidance } from './guidance.js';
+import { applyOrchestrate } from './orchestrate.js';
 import { createSettingsSnapshot, installDirectorSettings } from './settings.js';
 export { Config } from './config.js';
 export { assertDelegationCapabilities, buildSubagentRequest, createDelegationParameters, createDelegationOutputSchema, createDelegationTool, DELEGATION_TOOL_PREFIX, resolveDelegationMode, renderDelegationResult, } from './delegation-tool.js';
 export { applyGuidance, renderRolesGuidance, GUIDANCE_SECTION_ORDER, GUIDANCE_SECTION_NAME } from './guidance.js';
+export { applyOrchestrate, renderOrchestratorPrompt, renderOrchestratorRoles, buildOrchestratorFrame, ORCHESTRATE_SECTION_NAME, ORCHESTRATE_SECTION_ORDER, ORCHESTRATE_PROJECTION_KEY, ORCHESTRATE_EVENT_TYPE, ORCHESTRATE_VALID_MODES, } from './orchestrate.js';
 export { CLOSE_SUBAGENT_TOOL_NAME, createCloseSubagentTool } from './close-tool.js';
 export { SUBAGENT_DIRECTOR_SETTINGS_NAMESPACE, SettingsSchema, validateDirectorSettings, installDirectorSettings, } from './settings.js';
 export const name = 'subagent-director';
@@ -35,6 +37,8 @@ export function apply(ctx, config) {
     }
     // ---- role guidance ----------------------------------------------------
     applyGuidance(ctx, getSettings, toolName);
+    // ---- orchestrate command + projection + prompt section ----------------
+    applyOrchestrate(ctx, getSettings, toolName);
     // ---- close_subagent tool ----------------------------------------------
     // Provider-independent (drain is a global subagents operation), so it
     // registers at mount time like the control tools; on a deployment without

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/orchestrate.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Orchestrate command for Subagent Director (merged from the standalone
+ * `orchestrate` plugin).
+ *
+ * Adds a `/orchestrate on|off` slash command that flips a per-session
+ * projection and, when on, injects a pure-orchestrator system-prompt section.
+ * The orchestrator delegates exclusively through the subagent-director
+ * delegation tool, whose model-facing name is `config.toolName` (default
+ * `subagent_role`) and is threaded in here as `toolName`.
+ *
+ * Naming caveat (observed on a live 0.1.1-rc.x web host): the assembled tool catalog
+ * contains BOTH this plugin's `subagent_role` and the base bundle's built-in
+ * `subagent` / `subagent_fork`. They are distinct tools, not two names for one
+ * wire entry. The prompt below names `toolName` explicitly precisely because a
+ * model that reaches for the built-in `subagent` bypasses role persona and role
+ * toolFilter.
+ *
+ * The role list rendered into the prompt is derived dynamically from the live
+ * plugin settings (`subagent-director.roles`) — the same source `guidance.ts`
+ * reads — so it never hard-codes role ids and stays correct when the operator
+ * reconfigures roles. When no roles are configured the prompt tells the user
+ * to configure them rather than silently emitting an empty section.
+ *
+ * Service posture mirrors `guidance.ts`: `commands` and `sessionProjections` are
+ * acquired reactively through `ctx.inject` (so the `/orchestrate` command and the
+ * projection register as soon as the host service is ready, even if it mounts
+ * slightly after `apply`), while `systemPrompt` is still read lazily via
+ * `ctx.get`. A host that never provides `sessionProjections` degrades to an
+ * honest error from the command handler rather than a silent no-op.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { SubagentDirectorSettings } from './settings.js';
+/** Stable system-prompt section name. */
+export declare const ORCHESTRATE_SECTION_NAME = "orchestrate-mode";
+/** Prompt order: sits low (55) so the orchestrator contract is near the top. */
+export declare const ORCHESTRATE_SECTION_ORDER = 55;
+/** Per-session projection key holding the orchestrator on/off state. */
+export declare const ORCHESTRATE_PROJECTION_KEY = "orchestrate";
+/** Session event type emitted when the mode changes. */
+export declare const ORCHESTRATE_EVENT_TYPE = "orchestrate/change";
+/** Accepted mode values. */
+export declare const ORCHESTRATE_VALID_MODES: readonly ['on', 'off'];
+export type OrchestrateMode = (typeof ORCHESTRATE_VALID_MODES)[number];
+interface OrchestrateState {
+    mode: OrchestrateMode;
+}
+declare module '@deepseek-ai/dsh-session/types' {
+    interface SessionEventMap {
+        'orchestrate/change': {
+            mode: OrchestrateMode;
+        };
+    }
+}
+declare module '@deepseek-ai/dsh-session-projection/types' {
+    interface SessionProjectionStateMap {
+        /** /orchestrate mode state, folded from `orchestrate/change` events. */
+        orchestrate: OrchestrateState;
+    }
+    interface SessionProjectionMap {
+        /** Client-visible wire payload of the orchestrate projection unit. */
+        orchestrate: {
+            mode: OrchestrateMode;
+        };
+    }
+}
+/**
+ * Build the data-independent framing of the orchestrator prompt for a given
+ * delegation tool name. The role list is appended separately by
+ * {@link renderOrchestratorRoles}.
+ * @param toolName - the configured model-facing delegation tool name.
+ */
+export declare function buildOrchestratorFrame(toolName: string): string;
+/**
+ * Render the role list portion of the orchestrator prompt from the live
+ * settings. Returns a "configure roles first" notice when no roles exist so
+ * the operator is told what to do instead of receiving a blank contract.
+ * @param settings - current resolved settings snapshot.
+ * @param toolName - the configured model-facing delegation tool name.
+ */
+export declare function renderOrchestratorRoles(settings: SubagentDirectorSettings, toolName: string): string;
+/**
+ * Assemble the full orchestrator prompt (framing + dynamic role list).
+ * @param settings - current resolved settings snapshot.
+ * @param toolName - the configured model-facing delegation tool name.
+ */
+export declare function renderOrchestratorPrompt(settings: SubagentDirectorSettings, toolName: string): string;
+/**
+ * Wire the `/orchestrate` command, its session projection, and the
+ * orchestrator prompt section into the host. Each host-plane service is
+ * acquired lazily and guarded, so a missing service degrades to a no-op.
+ * @param ctx - plugin context.
+ * @param getSettings - returns the current settings snapshot.
+ * @param toolName - the configured model-facing delegation tool name.
+ */
+export declare function applyOrchestrate(ctx: Context, getSettings: () => SubagentDirectorSettings, toolName: string): void;
+export {};
+//# sourceMappingURL=orchestrate.d.ts.map

package/lib/orchestrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../src/orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE9D,yCAAyC;AACzC,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAE3D,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,wEAAwE;AACxE,eAAO,MAAM,0BAA0B,gBAAgB,CAAC;AAExD,wDAAwD;AACxD,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D,4BAA4B;AAC5B,eAAO,MAAM,uBAAuB,YAAI,IAAI,EAAE,KAAK,CAAU,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,UAAU,gBAAgB;IACxB,IAAI,EAAE,eAAe,CAAC;CACvB;AAYD,OAAO,QAAQ,gCAAgC,CAAC;IAC9C,UAAU,eAAe;QACvB,oBAAoB,EAAE;YAAE,IAAI,EAAE,eAAe,CAAA;SAAE,CAAC;KACjD;CACF;AAED,OAAO,QAAQ,2CAA2C,CAAC;IACzD,UAAU,yBAAyB;QACjC,wEAAwE;QACxE,WAAW,EAAE,gBAAgB,CAAC;KAC/B;IACD,UAAU,oBAAoB;QAC5B,sEAAsE;QACtE,WAAW,EAAE;YAAE,IAAI,EAAE,eAAe,CAAA;SAAE,CAAC;KACxC;CACF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAepG;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUrG;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,MAAM,wBAAwB,EAC3C,QAAQ,EAAE,MAAM,GACf,IAAI,CAuNN"}

package/lib/orchestrate.js

@@ -0,0 +1,277 @@
+import { z } from 'zod';
+import { KNOWN_SESSION_EVENT_TYPES } from '@deepseek-ai/dsh-session';
+/** Stable system-prompt section name. */
+export const ORCHESTRATE_SECTION_NAME = 'orchestrate-mode';
+/** Prompt order: sits low (55) so the orchestrator contract is near the top. */
+export const ORCHESTRATE_SECTION_ORDER = 55;
+/** Per-session projection key holding the orchestrator on/off state. */
+export const ORCHESTRATE_PROJECTION_KEY = 'orchestrate';
+/** Session event type emitted when the mode changes. */
+export const ORCHESTRATE_EVENT_TYPE = 'orchestrate/change';
+/** Accepted mode values. */
+export const ORCHESTRATE_VALID_MODES = ['on', 'off'];
+/**
+ * Build the data-independent framing of the orchestrator prompt for a given
+ * delegation tool name. The role list is appended separately by
+ * {@link renderOrchestratorRoles}.
+ * @param toolName - the configured model-facing delegation tool name.
+ */
+export function buildOrchestratorFrame(toolName) {
+    return `You are a PURE ORCHESTRATOR. Your only action is to call the \`${toolName}\` tool (provided by the subagent-director plugin) to delegate work. You must NEVER read, write, edit, grep, find, or execute anything yourself.
+
+The subagent-director plugin supplies its role templates from settings (subagent-director.roles) and the guidance section 'subagent-director:roles'. Delegate exactly one task per call:
+
+    ${toolName}({ role: '<role-id>', prompt: '<self-contained task>', description: '<what this delegation produces>' })`;
+}
+/**
+ * Render the role list portion of the orchestrator prompt from the live
+ * settings. Returns a "configure roles first" notice when no roles exist so
+ * the operator is told what to do instead of receiving a blank contract.
+ * @param settings - current resolved settings snapshot.
+ * @param toolName - the configured model-facing delegation tool name.
+ */
+export function renderOrchestratorRoles(settings, toolName) {
+    const roles = settings.roles ?? {};
+    const entries = Object.entries(roles).filter(([, role]) => role !== undefined);
+    if (entries.length === 0) {
+        return 'No Subagent Director roles are configured yet. Configure `subagent-director.roles` (settings.yaml or the settings panel) before entering orchestrator mode — the orchestrator can only delegate to defined roles.';
+    }
+    const lines = [
+        `Delegate work by calling the \`${toolName}\` tool with a role id from the list below. Reference roles by their id (shown), never by display name, and never invent a role id that is not listed:`,
+    ];
+    for (const [id, role] of entries) {
+        lines.push(`- ${role.displayName || id}: ${role.description}`);
+        lines.push(`    ${toolName}({ role: "${id}", prompt: "..." })`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Assemble the full orchestrator prompt (framing + dynamic role list).
+ * @param settings - current resolved settings snapshot.
+ * @param toolName - the configured model-facing delegation tool name.
+ */
+export function renderOrchestratorPrompt(settings, toolName) {
+    return `${buildOrchestratorFrame(toolName)}\n\n${renderOrchestratorRoles(settings, toolName)}\n\nOrchestration rules:
+1. Only dispatch. Forbid doing the work yourself.
+2. Independent tasks -> dispatch them in parallel (multiple ${toolName} calls in one turn).
+3. Dependent / relay tasks -> wait for the prior subagent to finish, then dispatch the next stage.
+4. Every subagent prompt must be self-contained: goal, constraints, output format, acceptance criteria. Subagents receive NO parent context.
+5. If the user's request names a specific role, dispatch to that role id. If a display name is given, map it to its id. If no role is named, dispatch to the role whose display name indicates coordination (e.g. contains 协调 / Orchestrator / Coordinator); when no such role exists, dispatch to the first configured role and let it decompose and coordinate.
+6. Unclear dependencies or missing information -> ask the USER, never guess.
+7. For independent fan-out you may set run_in_background: true and collect results later; for relay steps set run_in_background: false so you wait for the result before dispatching the next stage.
+8. Finish only when every subagent has completed. Then output a summary report: who produced what, and remaining todos.`;
+}
+/**
+ * Wire the `/orchestrate` command, its session projection, and the
+ * orchestrator prompt section into the host. Each host-plane service is
+ * acquired lazily and guarded, so a missing service degrades to a no-op.
+ * @param ctx - plugin context.
+ * @param getSettings - returns the current settings snapshot.
+ * @param toolName - the configured model-facing delegation tool name.
+ */
+export function applyOrchestrate(ctx, getSettings, toolName) {
+    // Register our event type on the shared KNOWN set so session logs carrying
+    // `orchestrate/change` load in any boot that mounts this plugin.
+    // The shared set is a mutable Set at runtime; its exported type is
+    // ReadonlySet, so we widen to Set<string> for the add call.
+    try {
+        KNOWN_SESSION_EVENT_TYPES.add(ORCHESTRATE_EVENT_TYPE);
+    }
+    catch (err) {
+        ctx.logger.warn('[orchestrate] could not register event type:', err?.message);
+    }
+    // Resolve sessionProjections *reactively*. At plugin apply time the host
+    // may not have mounted the sessionProjections service yet — that is the P0
+    // timing root cause: a one-shot `ctx.get` here returned undefined and
+    // silently no-op'd the projection registration, so /orchestrate never
+    // injected. Instead we register the projection the moment the service becomes
+    // available via ctx.inject, and keep `projections` in a closure so the
+    // command handler and prompt section observe it once it resolves. If the
+    // service is genuinely absent the handler (and the apply-time fallback)
+    // surface an honest error instead of a silent no-op.
+    let projections = undefined;
+    const missing = () => ctx.logger.warn('[orchestrate] sessionProjections service is missing on this host — the /orchestrate command will NOT take effect (no projection registered, orchestrator prompt will not inject). Provide the dsh-session-projection sessionProjections service to enable orchestrator mode.');
+    const registerProjection = (sp) => {
+        if (projections !== undefined)
+            return; // idempotent: inject may re-fire
+        projections = sp;
+        sp.register({
+            key: ORCHESTRATE_PROJECTION_KEY,
+            stateVersion: 1,
+            // Real @deepseek-ai/dsh-session-projection contract (SessionProjectionRegistry):
+            // `stateSchema` validates host state (persisted-cache restore path); a
+            // client-visible unit MUST declare `wire: { viewSchema, view }` or
+            // `snapshot()` SKIPS it entirely (`if (def.wire === undefined) continue`),
+            // so `snapshot().values['orchestrate']` is never populated and the prompt
+            // section always reads undefined → no injection. The prior `schema` + bare
+            // `view` made this a host-only unit — the actual root cause of the
+            // on==off byte-identical system prompts. Fix: declare both correctly.
+            stateSchema: z.object({ mode: z.enum(ORCHESTRATE_VALID_MODES) }),
+            init: () => ({ mode: 'off' }),
+            apply: (state, event) => {
+                if (!event || event.type !== ORCHESTRATE_EVENT_TYPE)
+                    return state;
+                const mode = event.data.mode;
+                if (!ORCHESTRATE_VALID_MODES.includes(mode) || state.mode === mode)
+                    return state;
+                return { mode };
+            },
+            wire: {
+                viewSchema: z.object({ mode: z.enum(ORCHESTRATE_VALID_MODES) }),
+                view: (state) => ({ mode: state.mode }),
+            },
+        });
+        ctx.logger.info('[orchestrate] host active (command + projection + prompt section)');
+    };
+    const spNow = ctx.get('sessionProjections');
+    if (spNow !== undefined) {
+        registerProjection(spNow);
+    }
+    else {
+        // Reactive path: register once the host mounts sessionProjections. The
+        // child fiber's callback only runs when the dependency is present, so
+        // this also covers the "ready slightly later" case that the one-shot get
+        // missed. If the service never appears, the handler below returns an
+        // honest error — no silent no-op.
+        //
+        // The child fiber is owned by this plugin's fiber lifecycle (its
+        // registration effect lives on the parent fiber), so it unloads
+        // automatically with the plugin. Do NOT wrap it in ctx.effect: cordis
+        // effects run their callback immediately and treat the return value as
+        // the disposer, so `ctx.effect(() => fiber.dispose())` would unload the
+        // child at birth — pinned by the real-cordis probe in
+        // test/orchestrate-cordis.test.ts.
+        ctx.inject(['sessionProjections'], (injectedCtx) => {
+            registerProjection(injectedCtx.get('sessionProjections'));
+        });
+    }
+    // Register the `/orchestrate` slash command *reactively* through a
+    // `ctx.inject` child fiber (the dsh-plan-mode precedent). `commands` is NOT a
+    // required entry-inject: standard profiles mount it via dsh-base (so the
+    // child fiber activates immediately there), but non-dsh-base assemblies (ACP
+    // hosts, UI-less demo spines, custom harnesses) may never provide it, and a
+    // required inject would leave the whole main entry PENDING on those hosts —
+    // the core delegation features would never load. The child-fiber shape also
+    // recovers from a host that mounts `commands` slightly after `apply`. The
+    // handler reads `projections` from the closure, so command availability and
+    // projection availability are decoupled: the handler still refuses honestly
+    // (with a warning) if the projection service never came up.
+    // The child fiber is owned by this plugin's fiber lifecycle and unloads
+    // with the plugin — never wrap it in ctx.effect (cordis effects run their
+    // callback immediately and treat the return value as the disposer, so
+    // `ctx.effect(() => fiber.dispose())` would unload the child at birth;
+    // pinned by the real-cordis probe in test/orchestrate-cordis.test.ts).
+    ctx.inject(['commands'], (injectedCtx) => {
+        const commands = injectedCtx.get('commands');
+        commands.register({
+            name: 'orchestrate',
+            description: 'Enter pure-orchestrator mode — delegate all work to the subagent-director team. No args defaults to "on".',
+            input: { hint: 'on|off (no args = on)' },
+            handler: (invocation) => {
+                const mode = (invocation.rawInput || '').trim().toLowerCase() || 'on';
+                if (!ORCHESTRATE_VALID_MODES.includes(mode)) {
+                    return { kind: 'error', text: `Invalid: "${invocation.rawInput}". Valid: on|off` };
+                }
+                // Without sessionProjections the projection is never registered, so
+                // /orchestrate cannot take effect. Refuse with an honest message
+                // instead of falsely reporting success (P0 silent-degradation fix).
+                if (projections === undefined) {
+                    // Service never became available (truly absent host): refuse with an
+                    // honest message and warn, instead of falsely reporting success (P0
+                    // silent-degradation fix).
+                    missing();
+                    return {
+                        kind: 'error',
+                        text: `Orchestrator mode "${mode}" was NOT applied: the sessionProjections service is missing on this host, so /orchestrate has no effect and the orchestrator prompt will not inject. ` +
+                            `Provide the dsh-session-projection sessionProjections service to enable orchestrator mode.`,
+                    };
+                }
+                const session = invocation?.agent?.session;
+                if (session === undefined || typeof session.append !== 'function') {
+                    return {
+                        kind: 'error',
+                        text: `Orchestrator mode "${mode}" was NOT applied: this command invocation carries no agent session to append the mode change to.`,
+                    };
+                }
+                session.append(ORCHESTRATE_EVENT_TYPE, { mode });
+                return { kind: 'success', text: mode === 'off' ? 'Orchestrator mode: off' : 'Orchestrator mode: on' };
+            },
+        });
+    });
+    const systemPrompt = ctx.get('systemPrompt');
+    if (systemPrompt !== undefined) {
+        systemPrompt.section({
+            name: ORCHESTRATE_SECTION_NAME,
+            order: ORCHESTRATE_SECTION_ORDER,
+            text: (context) => {
+                // Root-cause note (P0 render-time silent no-op, sibling of C1):
+                // @deepseek-ai/dsh-session-projection's read face keys its per-session
+                // watermark cache by the SESSION OBJECT via a WeakMap and folds
+                // `session.events` (see cellFor/buildCell in the package's lib/index.js).
+                // A snapshot therefore reads the mode ONLY from the live Session object
+                // whose `.events` log carries the `orchestrate/change` event that the
+                // /orchestrate command appended. If the assembly context hands a
+                // DIFFERENT session reference (e.g. a request wrapper instead of the
+                // agent's own session), the cell is rebuilt from an empty log and
+                // silently returns 'off', dropping the section. We must hand the
+                // canonical session object — and try every session reference the
+                // context exposes so a stray wrapper reference cannot downgrade us.
+                const sessionCandidates = [];
+                if (context?.agent?.session)
+                    sessionCandidates.push(context.agent.session);
+                if (context?.session && context.session !== context?.agent?.session) {
+                    sessionCandidates.push(context.session);
+                }
+                if (sessionCandidates.length === 0) {
+                    // No resolvable session — cannot read the projection. Warn instead of
+                    // silently dropping (P0 honest-degradation; do not return '' silently).
+                    ctx.logger.warn('[orchestrate] system-prompt section invoked without a resolvable session (both context.agent.session and context.session are absent) — orchestrator-mode section skipped. Possible cause: the assembly context shape differs from the dsh-agent AssembleContext contract.');
+                    return '';
+                }
+                // P0 missing-service path: the service never mounted. The apply-time
+                // missing() already emitted the loud warning, so only the section is
+                // skipped here (no per-assembly re-warning).
+                if (projections === undefined)
+                    return '';
+                let resolvedMode;
+                let sawError = false;
+                for (const candidate of sessionCandidates) {
+                    try {
+                        const snap = projections.snapshot(candidate);
+                        const value = snap?.values?.[ORCHESTRATE_PROJECTION_KEY];
+                        if (value && typeof value.mode === 'string') {
+                            const m = value.mode;
+                            // 'on' wins immediately; otherwise remember the first known value.
+                            if (m === 'on') {
+                                resolvedMode = 'on';
+                                break;
+                            }
+                            if (resolvedMode === undefined)
+                                resolvedMode = m;
+                        }
+                    }
+                    catch (err) {
+                        // Surface instead of silently dropping (D1). The most likely cause
+                        // is a session-identity mismatch: this candidate is not the object
+                        // the /orchestrate command wrote the orchestrate/change event to.
+                        sawError = true;
+                        ctx.logger.warn('[orchestrate] could not read orchestrator mode from projection for a candidate session (session identity may not match the session /orchestrate on wrote to):', err?.message);
+                    }
+                }
+                if (resolvedMode === undefined) {
+                    // Could not resolve any mode from any candidate session. Warn with the
+                    // likely cause; do NOT silently pretend 'off'.
+                    if (!sawError) {
+                        ctx.logger.warn('[orchestrate] orchestrator mode could not be resolved from any candidate session — orchestrator-mode section skipped. Possible cause: the assembly context session identity does not match the session the /orchestrate command wrote the orchestrate/change event to (the projection cache is keyed by the live Session object, per @deepseek-ai/dsh-session-projection).');
+                    }
+                    return '';
+                }
+                // Legitimate off: no section, no warning (intended behavior).
+                if (resolvedMode === 'off')
+                    return '';
+                return renderOrchestratorPrompt(getSettings(), toolName);
+            },
+        });
+    }
+}
+//# sourceMappingURL=orchestrate.js.map

package/lib/orchestrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrate.js","sourceRoot":"","sources":["../src/orchestrate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-subagent-director",
-  "version": "0.3.0",
+  "version": "0.4.0-beta.1",
   "description": "Subagent Director: choose an LLM provider/model for each subagent (call args > role binding > plugin default > inherit parent) and plan main-agent/subagent responsibilities with role templates, plus a settings UI.",
   "type": "module",
   "main": "lib/index.js",
@@ -65,23 +65,27 @@
     "model",
     "role-template"
   ],
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
   "license": "MIT",
   "peerDependencies": {
     "react": "^18.2.0",
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-subagent": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-schema-form": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-host-apiproxy": "^0.1.0-rc.6"
+    "@deepseek-ai/dsh-agent": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-subagent": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-host-apiproxy": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-session-projection": "^0.1.1-rc.2"
   },
   "devDependencies": {
     "react": "^18.2.0",
@@ -90,21 +94,22 @@
     "@types/react": "^18.3.1",
     "@types/react-dom": "^18.3.1",
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-subagent": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-agent": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-subagent": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-schema-form": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-host-apiproxy": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-host-apiproxy": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-session-projection": "^0.1.1-rc.2",
     "rolldown": "^1.2.4",
     "@types/node": "^26.2.0",
     "typescript": "^7.0.2",