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

package/CHANGELOG.md

@@ -1,7 +1,46 @@
-# Changelog
-
+# Changelog
+
 本项目的所有显著变更都会记录在此文件中。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## [0.3.0] - 2026-08-28
+
+### 新增
+
+- **`close_subagent` 模型可见工具**：主代理可按需释放「已完成但仍驻留」的
+  continuable 子代理（内部调用 DSH 核心 `drainContinuableChildren`，与
+  `send_message`/`interrupt_agent` 构成完整生命周期闭环；非驻留目标是安全
+  no-op）——[issue #1](https://github.com/SeverusZh/dsh-plugin-subagent-director/issues/1)；
+- **子代理会话页「终止可持续状态」按钮**：打开 continuable 子代理会话时，
+  会话标题操作区显示释放按钮（确认后经 `/subagent-director` 桥释放该子代理，
+  父代理不在线时给出明确提示）；
+- **可观测性打通**：composer 下方实际运行供应商/模型读数不再依赖尚未填充的
+  assistant provenance 字段，改为读取子代理会话的 `request/header` 记录
+  （`subagentModel` 桥端点），快照内已有 provenance 时仍走零请求快速路径，
+  读不到时优雅降级——移除 README「暂不可用」标注。
+
+### 修复
+
+- 未配置 `toolFilter` 的角色被 dsh-settings 物化为 `{allow:[],deny:[]}` 后
+  清空子代理全部工具（tools=0、「只执行一步」假象）：空 filter 视为未配置，
+  schema 层不再物化空对象（`hasToolFilter` + `.default(undefined)`）——
+  [issue #2](https://github.com/SeverusZh/dsh-plugin-subagent-director/issues/2)。
+
+### 兼容性
+
+- `@deepseek-ai/dsh-subagent` peer 依赖下限提升至 `^0.1.0-rc.8`
+  （`drainContinuableChildren` 所在版本线）。
+
+### 测试
+
+- 单元测试由 150 增至 178：空 toolFilter 语义、close_subagent 工具、
+  桥接 `subagentClose`/`subagentModel` 端点、可观测性数据源合并。
+
+### 文档
+
+- README：新增「释放可持续子代理」特性、更新可观测性描述（中英双语）。
+
+[0.3.0]: https://github.com/SeverusZh/dsh-plugin-subagent-director/releases/tag/v0.3.0
+
 ## [0.2.0] - 2026-08-17
 
 ### 新增
@@ -30,24 +69,24 @@
 - 新增设计文档与实现计划（`docs/superpowers/`）。
 
 ## [0.1.0] - 2026-08-14
-
-首个公开发布版本。
-
-### 新增
-
-- 四级模型路由解析链（单次调用参数 > 角色绑定 > 插件默认 > 继承主代理），字段级覆盖、未配置零侵入；
-- `subagent_role` 模型可见委派工具：`role`/`provider`/`model`/`reasoningEffort` 可选参数，前景/one-shot 后台/continuable 后台三种执行路线；
-- 角色模板：命名角色携带职责描述、persona 与可选模型绑定，写入 settings 命名空间 `subagent-director`；
-- 主代理角色清单指引（系统提示段落，无角色时不注入）；
-- 设置界面「子代理导演」：默认模型配置 + 角色卡片增删改（中英双语）；
-- 子代理实际运行模型读数（composer dock，零额外请求）；
-- 设置命名空间桥接条目 `subagent-director-bridge`：自注册 `/subagent-director` HTTP 路由，绕开 Web API 的 settings 白名单限制；
-- 129 个单元测试（路由解析、schema 校验、桥接信封、client 纯逻辑）。
-
-### 文档
-
-- README（中英双语）：安装、配置示例、角色模板、FAQ；
-- MIT License。
-
+
+首个公开发布版本。
+
+### 新增
+
+- 四级模型路由解析链（单次调用参数 > 角色绑定 > 插件默认 > 继承主代理），字段级覆盖、未配置零侵入；
+- `subagent_role` 模型可见委派工具：`role`/`provider`/`model`/`reasoningEffort` 可选参数，前景/one-shot 后台/continuable 后台三种执行路线；
+- 角色模板：命名角色携带职责描述、persona 与可选模型绑定，写入 settings 命名空间 `subagent-director`；
+- 主代理角色清单指引（系统提示段落，无角色时不注入）；
+- 设置界面「子代理导演」：默认模型配置 + 角色卡片增删改（中英双语）；
+- 子代理实际运行模型读数（composer dock，零额外请求）；
+- 设置命名空间桥接条目 `subagent-director-bridge`：自注册 `/subagent-director` HTTP 路由，绕开 Web API 的 settings 白名单限制；
+- 129 个单元测试（路由解析、schema 校验、桥接信封、client 纯逻辑）。
+
+### 文档
+
+- README（中英双语）：安装、配置示例、角色模板、FAQ；
+- MIT License。
+
 [0.1.0]: https://github.com/SeverusZh/dsh-plugin-subagent-director/releases/tag/v0.1.0
 [0.2.0]: https://github.com/SeverusZh/dsh-plugin-subagent-director/releases/tag/v0.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Subagent Director contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Subagent Director contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,19 +1,20 @@
-# 🎬 Subagent Director（子代理导演）
-
-> 为 DeepSeek Harness 的 subagent 指定 LLM 供应商与模型，并用「角色模板」规划主代理与子代理的分工。
-
-<p align="center">
-  <img alt="npm version" src="https://img.shields.io/npm/v/dsh-plugin-subagent-director?label=npm">
-  <img alt="license" src="https://img.shields.io/npm/l/dsh-plugin-subagent-director">
-  <img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-0.1.0--rc.x-blue">
-</p>
-
+# 🎬 Subagent Director（子代理导演）
+
+> 为 DeepSeek Harness 的 subagent 指定 LLM 供应商与模型，并用「角色模板」规划主代理与子代理的分工。
+
+<p align="center">
+  <img alt="npm version" src="https://img.shields.io/npm/v/dsh-plugin-subagent-director?label=npm">
+  <img alt="license" src="https://img.shields.io/npm/l/dsh-plugin-subagent-director">
+  <img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-0.1.0--rc.6-blue">
+  <img alt="Awesome DSH Plugin" src="https://awesome-dsh-plugin.com/badge.svg">
+</p>
+
 [English](#english) · [特性](#特性) · [快速开始](#快速开始) · [角色模板](#角色模板) · [术语](#术语) · [开发](#开发) · [FAQ](#faq)
-
----
-
-## 特性
-
+
+---
+
+## 特性
+
 - **供应商与模型选择** —— 为 subagent 配置默认 LLM 供应商（route）与模型；每次委派也可以由模型显式指定；
 - **默认模型兜底** —— 配置 `defaultProvider`/`defaultModel` 后，即使模型调用内置
   `subagent`/`subagent_fork` 工具，未显式指定模型的子代理也会自动使用该模型
@@ -22,20 +23,24 @@
 - **角色按显示名引用** —— `role` 参数未命中 id 时按 `displayName` 精确匹配（重名
   取定义顺序第一个并提示），模型按显示名也能命中模板；
 - **角色模板** —— 定义「代码审查员」「翻译员」等角色：职责描述（给主代理看）+ persona（注入子代理）+ 可选模型绑定；
-- **四级回退链** —— 单次调用参数 > 角色绑定 > 插件默认 > 继承主代理（未配置时零侵入）；
-- **主代理指引** —— 系统提示自动注入角色清单，主代理知道何时委派给谁；
-- **设置界面** —— DSH 设置面板内可视化配置（默认模型 + 角色卡片增删改）；
-- **continuable 后台** —— 返回可续聊子代理 id，配合 send_message 持续委派；
-- **可观测性** —— 打开子代理会话时，composer 下方显示其实际运行的供应商/模型。⚠️ 该功能暂不可用，正在开发中；
-
-## 快速开始
-
-### 安装
-
-```bash
-dsh plugin --profile <name> add dsh-plugin-subagent-director
-```
-
+- **四级回退链** —— 单次调用参数 > 角色绑定 > 插件默认 > 继承主代理（未配置时零侵入）；
+- **主代理指引** —— 系统提示自动注入角色清单，主代理知道何时委派给谁；
+- **设置界面** —— DSH 设置面板内可视化配置（默认模型 + 角色卡片增删改）；
+- **continuable 后台** —— 返回可续聊子代理 id，配合 send_message 持续委派；
+- **释放可持续子代理** —— 模型可见工具 `close_subagent(subagent_id)` 与子代理会话
+  页的「终止可持续状态」按钮，主动释放已完成但仍驻留的 continuable 子代理
+  （内部调用 DSH 核心 `drainContinuableChildren`）；
+- **可观测性** —— 打开子代理会话时，composer 下方显示其实际运行的供应商/模型
+  （从会话 `request/header` 记录读取真实路由；读不到时优雅降级）；
+
+## 快速开始
+
+### 安装
+
+```bash
+dsh plugin --profile <name> add dsh-plugin-subagent-director
+```
+
 或本地开发时以 `dsh plugin --profile <name> add link:<绝对路径>` 挂载本地 checkout
 （配置示例见下）。
 
@@ -106,9 +111,9 @@ subagent-director:
       description: 中英互译技术文档、代码注释与沟通内容，保留术语准确性与语气
       persona: 你是专业翻译。术语统一、句式自然、保留原文意图；专有名词与技术缩写保持原文，拿不准的术语标注出来。
 ```
-
-### 使用
-
+
+### 使用
+
 对话中委派（主代理会看到角色清单指引，自动选择工具与角色）：
 
 ```text
@@ -118,51 +123,52 @@ subagent_role({ role: "code-reviewer", model: "deepseek-chat", prompt: "..." })
 
 `role` 参数支持用角色 id 或显示名引用：未命中 id 时会按 `displayName` 精确匹配
 （多个同名角色取定义顺序第一个并提示）；建议始终用 id，见系统提示中的 Delegate 行。
-
-## 术语
-
-- **subagentProvider（传输）**：`spawn` / `fork` / `acp`——子代理跑在哪条传输链路上；
-- **provider（LLM route）**：`deepseek-official`、pi-ai route——模型请求实际发给哪个供应商。
-
-两者是**两套命名空间**，配置时不要混淆。
-
-## 开发
-
-```bash
-npm install
-npm test          # vitest（129 用例）
-npm run typecheck
-npm run build     # host(tsc) + client(rolldown bundle)
-```
-
+
+## 术语
+
+- **subagentProvider（传输）**：`spawn` / `fork` / `acp`——子代理跑在哪条传输链路上；
+- **provider（LLM route）**：`deepseek-official`、pi-ai route——模型请求实际发给哪个供应商。
+
+两者是**两套命名空间**，配置时不要混淆。
+
+## 开发
+
+```bash
+npm install
+npm test          # vitest（129 用例）
+npm run typecheck
+npm run build     # host(tsc) + client(rolldown bundle)
+```
+
 ## FAQ
-
-**为什么需要两个插件条目？**
-DSH 的 Web API 只向白名单内的 settings 命名空间开放读写。本插件通过自注册的 `/subagent-director` HTTP 路由桥接自己的命名空间，而该路由依赖的 webServer 服务只能经 cordis `inject` 获取，因此拆成独立的 `subagent-director-bridge` 条目（无 Web 的 headless 场景它会自动不激活，主条目不受影响）。
-
+
+**为什么需要两个插件条目？**
+DSH 的 Web API 只向白名单内的 settings 命名空间开放读写。本插件通过自注册的 `/subagent-director` HTTP 路由桥接自己的命名空间，而该路由依赖的 webServer 服务只能经 cordis `inject` 获取，因此拆成独立的 `subagent-director-bridge` 条目（无 Web 的 headless 场景它会自动不激活，主条目不受影响）。
+
 **未配置任何角色时行为如何？**
 未配置任何角色且未配置默认模型时与未安装本插件完全一致（零侵入）。配置了
 `defaultProvider`/`defaultModel` 且未关闭 `applyDefaultRoute` 时，所有未显式
 指定模型的子代理（含内置工具发起的）都会使用该默认模型。
-
-**新供应商/API 会自动出现吗？**
-会。设置页订阅了供应商与设置变更事件，在 Models 页新增供应商/API key 后，下拉列表自动刷新，无需重启。
-
-## License
-
-[MIT](./LICENSE) © Subagent Director contributors
-
----
-
-## English
-
-**Subagent Director** is an out-of-tree DeepSeek Harness plugin that lets you choose an LLM provider and model for subagents, and plan main-agent/subagent responsibilities through role templates.
-
-- **Provider/model selection** — a configurable default route plus optional per-call `provider`/`model` arguments on the `subagent_role` tool;
-- **Role templates** — named roles carrying a description, a persona, and an optional model binding;
-- **Four-layer resolution** — call args > role binding > plugin default > inherit from the parent agent (zero intrusion when unconfigured);
-- **Settings UI** — manage defaults and role cards in the DSH settings panel;
-- **Continuable background** — durable subagent ids with send_message follow-ups;
-- **Observability** — the addressed subagent’s actual provider/model shown under the composer. ⚠️ Not yet available — under development.
-
+
+**新供应商/API 会自动出现吗？**
+会。设置页订阅了供应商与设置变更事件，在 Models 页新增供应商/API key 后，下拉列表自动刷新，无需重启。
+
+## License
+
+[MIT](./LICENSE) © Subagent Director contributors
+
+---
+
+## English
+
+**Subagent Director** is an out-of-tree DeepSeek Harness plugin that lets you choose an LLM provider and model for subagents, and plan main-agent/subagent responsibilities through role templates.
+
+- **Provider/model selection** — a configurable default route plus optional per-call `provider`/`model` arguments on the `subagent_role` tool;
+- **Role templates** — named roles carrying a description, a persona, and an optional model binding;
+- **Four-layer resolution** — call args > role binding > plugin default > inherit from the parent agent (zero intrusion when unconfigured);
+- **Settings UI** — manage defaults and role cards in the DSH settings panel;
+- **Continuable background** — durable subagent ids with send_message follow-ups;
+- **Release continuable children** — a model-facing `close_subagent(subagent_id)` tool plus a "Release subagent" button in the subagent session header, freeing resident children through the core `drainContinuableChildren` API;
+- **Observability** — the addressed subagent’s actual provider/model shown under the composer, read from the session’s `request/header` records (graceful degradation when no run is recorded yet).
+
 **Install** — `dsh plugin --profile <name> add dsh-plugin-subagent-director` mounts the main and bridge entries automatically from the package's bundle patch (`cordis.patch.yml`); optionally override the main entry's config in your profile's cordis.patch.yml (see the Chinese section above). License: MIT.

package/cordis.patch.yml

@@ -1,12 +1,12 @@
-# dsh-plugin-subagent-director bundle patch.
-#
-# Adds the plugin's two entries: the main entry and the settings bridge that
-# exposes the `subagent-director` settings namespace to the Web UI.
-# Install: dsh plugin --profile <name> add dsh-plugin-subagent-director
-# Restart `dsh --profile <name>` after installing.
-- insert:
-    - id: subagent-director
-      name: dsh-plugin-subagent-director
-- insert:
-    - id: subagent-director-bridge
+# dsh-plugin-subagent-director bundle patch.
+#
+# Adds the plugin's two entries: the main entry and the settings bridge that
+# exposes the `subagent-director` settings namespace to the Web UI.
+# Install: dsh plugin --profile <name> add dsh-plugin-subagent-director
+# Restart `dsh --profile <name>` after installing.
+- insert:
+    - id: subagent-director
+      name: dsh-plugin-subagent-director
+- insert:
+    - id: subagent-director-bridge
       name: dsh-plugin-subagent-director/bridge

package/lib/bridge-contract.d.ts

@@ -17,6 +17,10 @@ export declare const SUBAGENT_DIRECTOR_RPC_CHANNEL = "/subagent-director";
 export declare const SUBAGENT_DIRECTOR_RPC_VIEW = "settingsView";
 /** Endpoint that applies one path-op mutation. */
 export declare const SUBAGENT_DIRECTOR_RPC_MUTATE = "settingsMutate";
+/** Endpoint that releases one resident continuable child of a live parent. */
+export declare const SUBAGENT_DIRECTOR_RPC_CLOSE = "subagentClose";
+/** Endpoint that returns the actual provider/model of one child session. */
+export declare const SUBAGENT_DIRECTOR_RPC_MODEL = "subagentModel";
 /** Successful settingsView bridge response. */
 export interface DirectorViewSuccess {
     writable: boolean;
@@ -38,4 +42,21 @@ export type SettingsPathOpViewLike = {
     op: 'unset';
     path: string[];
 };
+/** Request payload for the subagentClose bridge endpoint. */
+export interface DirectorCloseRequest {
+    parentSessionId: string;
+    childSessionId: string;
+}
+/** Request payload for the subagentModel bridge endpoint. */
+export interface DirectorModelRequest {
+    sessionId: string;
+}
+/** Successful subagentModel bridge response. */
+export type DirectorModelSuccess = {
+    found: true;
+    provider: string;
+    model: string;
+} | {
+    found: false;
+};
 //# sourceMappingURL=bridge-contract.d.ts.map

package/lib/bridge-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-contract.d.ts","sourceRoot":"","sources":["../src/bridge-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAEhF,mEAAmE;AACnE,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAClE,gEAAgE;AAChE,eAAO,MAAM,0BAA0B,iBAAiB,CAAC;AACzD,kDAAkD;AAClD,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,qFAAqF;IACrF,IAAI,EAAE,qBAAqB,GAAG,SAAS,CAAC;CACzC;AAED,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,sBAAsB,EAAE,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,gFAAgF;AAChF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC"}
+{"version":3,"file":"bridge-contract.d.ts","sourceRoot":"","sources":["../src/bridge-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAEhF,mEAAmE;AACnE,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAClE,gEAAgE;AAChE,eAAO,MAAM,0BAA0B,iBAAiB,CAAC;AACzD,kDAAkD;AAClD,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAC7D,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAC3D,4EAA4E;AAC5E,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAE3D,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,qFAAqF;IACrF,IAAI,EAAE,qBAAqB,GAAG,SAAS,CAAC;CACzC;AAED,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,sBAAsB,EAAE,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,gFAAgF;AAChF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpC,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,MAAM,oBAAoB,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC"}

package/lib/bridge-contract.js

@@ -4,4 +4,8 @@ export const SUBAGENT_DIRECTOR_RPC_CHANNEL = '/subagent-director';
 export const SUBAGENT_DIRECTOR_RPC_VIEW = 'settingsView';
 /** Endpoint that applies one path-op mutation. */
 export const SUBAGENT_DIRECTOR_RPC_MUTATE = 'settingsMutate';
+/** Endpoint that releases one resident continuable child of a live parent. */
+export const SUBAGENT_DIRECTOR_RPC_CLOSE = 'subagentClose';
+/** Endpoint that returns the actual provider/model of one child session. */
+export const SUBAGENT_DIRECTOR_RPC_MODEL = 'subagentModel';
 //# sourceMappingURL=bridge-contract.js.map

package/lib/bridge-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-contract.js","sourceRoot":"","sources":["../src/bridge-contract.ts"],"names":[],"mappings":"AAcA,mEAAmE;AACnE,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC;AAClE,gEAAgE;AAChE,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC;AACzD,kDAAkD;AAClD,MAAM,CAAC,MAAM,4BAA4B,GAAG,gBAAgB,CAAC"}
+{"version":3,"file":"bridge-contract.js","sourceRoot":"","sources":["../src/bridge-contract.ts"],"names":[],"mappings":"AAcA,mEAAmE;AACnE,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC;AAClE,gEAAgE;AAChE,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC;AACzD,kDAAkD;AAClD,MAAM,CAAC,MAAM,4BAA4B,GAAG,gBAAgB,CAAC;AAC7D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,2BAA2B,GAAG,eAAe,CAAC;AAC3D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,2BAA2B,GAAG,eAAe,CAAC"}

package/lib/bridge-entry.d.ts

@@ -22,7 +22,11 @@
 import type { Context } from '@deepseek-ai/cordis';
 /** Cordis plugin name for the bridge entry. */
 export declare const name = "subagent-director-bridge";
-/** Required services: webServer (route owner) and settings (data seam). */
+/** Required services: webServer (route owner), settings (data seam), and the
+ * agent/subagent services backing the subagentClose endpoint (drain needs the
+ * exact live parent Agent). agents/subagents are dsh-base-level services that
+ * every profile mounts; headless profiles never activate this entry because
+ * webServer is absent. */
 export declare const inject: string[];
 /** Register the settings bridge route; dispose on unload. */
 export declare function apply(ctx: Context): void;

package/lib/bridge-entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-entry.d.ts","sourceRoot":"","sources":["../src/bridge-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,+CAA+C;AAC/C,eAAO,MAAM,IAAI,6BAA6B,CAAC;AAE/C,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAA4B,CAAC;AAEhD,6DAA6D;AAC7D,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAExC"}
+{"version":3,"file":"bridge-entry.d.ts","sourceRoot":"","sources":["../src/bridge-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,+CAA+C;AAC/C,eAAO,MAAM,IAAI,6BAA6B,CAAC;AAE/C;;;;0BAI0B;AAC1B,eAAO,MAAM,MAAM,UAAmD,CAAC;AAEvE,6DAA6D;AAC7D,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAExC"}

package/lib/bridge-entry.js

@@ -1,8 +1,12 @@
 import { installDirectorRemoteBridge } from './remote.js';
 /** Cordis plugin name for the bridge entry. */
 export const name = 'subagent-director-bridge';
-/** Required services: webServer (route owner) and settings (data seam). */
-export const inject = ['webServer', 'settings'];
+/** Required services: webServer (route owner), settings (data seam), and the
+ * agent/subagent services backing the subagentClose endpoint (drain needs the
+ * exact live parent Agent). agents/subagents are dsh-base-level services that
+ * every profile mounts; headless profiles never activate this entry because
+ * webServer is absent. */
+export const inject = ['webServer', 'settings', 'agents', 'subagents'];
 /** Register the settings bridge route; dispose on unload. */
 export function apply(ctx) {
     installDirectorRemoteBridge(ctx);

package/lib/bridge-entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-entry.js","sourceRoot":"","sources":["../src/bridge-entry.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,+CAA+C;AAC/C,MAAM,CAAC,MAAM,IAAI,GAAG,0BAA0B,CAAC;AAE/C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAEhD,6DAA6D;AAC7D,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,2BAA2B,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"bridge-entry.js","sourceRoot":"","sources":["../src/bridge-entry.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,+CAA+C;AAC/C,MAAM,CAAC,MAAM,IAAI,GAAG,0BAA0B,CAAC;AAE/C;;;;0BAI0B;AAC1B,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAEvE,6DAA6D;AAC7D,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,2BAA2B,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC"}

package/lib/client/SubagentCloseAction.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Subagent Director — "release sustained state" header action (issue #1).
+ *
+ * Contributes one button to the `conversation.session.header.actions` seat
+ * (the additive per-session control row beside the session title). It renders
+ * only while the CURRENT session is a continuable subagent child
+ * (snapshot.subagent.address.mode === 'continuable') and otherwise returns
+ * null, so ordinary sessions and one-shot children see nothing.
+ *
+ * Clicking asks the Host bridge's `subagentClose` endpoint to
+ * drainContinuableChildren under the address's durable parent authority; on
+ * success the button turns into a settled label (the child's handle is
+ * released), on failure a short inline error shows the core message.
+ *
+ * The seat is a list slot declared by ui-conversation; the framework session
+ * standard kit supplies `useSession`/`sessionId` (dsh-client-runtime merge),
+ * the registration injects the RPC caller.
+ */
+import type { ClientConnectionRpc } from '@deepseek-ai/dsh-client-connection/client';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/** Business face injected by the registration (client/index.ts). */
+export interface SubagentCloseActionInjected {
+    /** Generic RPC caller for the /subagent-director bridge channel. */
+    rpc: ClientConnectionRpc;
+}
+/** Full props: framework session kit + injected RPC + locale seat. */
+export type SubagentCloseActionProps = PropsRuntime<'conversation.session.header.actions'> & InjectFace<SubagentCloseActionInjected> & PropsLocale<typeof NS>;
+/** Locale namespace shared with the settings page (registered in index apply). */
+export declare const NS: 'settings.subagentDirector';
+/** Render the release-sustained-state button for a continuable child, or nothing. */
+export declare function SubagentCloseAction({ useSession, sessionId, rpc, t, }: SubagentCloseActionProps): React.JSX.Element | null;
+//# sourceMappingURL=SubagentCloseAction.d.ts.map

package/lib/client/SubagentCloseAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubagentCloseAction.d.ts","sourceRoot":"","sources":["../../src/client/SubagentCloseAction.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAErF,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAS9F,oEAAoE;AACpE,MAAM,WAAW,2BAA2B;IAC1C,oEAAoE;IACpE,GAAG,EAAE,mBAAmB,CAAC;CAC1B;AAED,sEAAsE;AACtE,MAAM,MAAM,wBAAwB,GAAG,YAAY,CAAC,qCAAqC,CAAC,GACxF,UAAU,CAAC,2BAA2B,CAAC,GACvC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;AAEzB,kFAAkF;AAClF,eAAO,MAAM,EAAE,EAAG,2BAAoC,CAAC;AAiCvD,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,EAClC,UAAU,EACV,SAAS,EACT,GAAG,EACH,CAAC,GACF,EAAE,wBAAwB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAiErD"}

package/lib/client/SubagentCloseAction.js

@@ -0,0 +1,99 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Subagent Director — "release sustained state" header action (issue #1).
+ *
+ * Contributes one button to the `conversation.session.header.actions` seat
+ * (the additive per-session control row beside the session title). It renders
+ * only while the CURRENT session is a continuable subagent child
+ * (snapshot.subagent.address.mode === 'continuable') and otherwise returns
+ * null, so ordinary sessions and one-shot children see nothing.
+ *
+ * Clicking asks the Host bridge's `subagentClose` endpoint to
+ * drainContinuableChildren under the address's durable parent authority; on
+ * success the button turns into a settled label (the child's handle is
+ * released), on failure a short inline error shows the core message.
+ *
+ * The seat is a list slot declared by ui-conversation; the framework session
+ * standard kit supplies `useSession`/`sessionId` (dsh-client-runtime merge),
+ * the registration injects the RPC caller.
+ */
+import { useEffect, useState } from 'react';
+import { SUBAGENT_DIRECTOR_RPC_CHANNEL, SUBAGENT_DIRECTOR_RPC_CLOSE, } from '../bridge-contract.js';
+import { isContinuableChild } from './subagent-model.js';
+import { dangerButtonStyle, token } from './ui.js';
+/** Locale namespace shared with the settings page (registered in index apply). */
+export const NS = 'settings.subagentDirector';
+/** Inline styling using the shared token surface (no CSS pipeline; M2 deviation). */
+const style = {
+    wrap: {
+        display: 'inline-flex',
+        alignItems: 'center',
+        gap: 8,
+    },
+    button: {
+        ...dangerButtonStyle,
+        height: 24,
+        fontSize: 12,
+        padding: '0 10px',
+    },
+    settled: {
+        color: token.labelTertiary,
+        fontSize: 12,
+        lineHeight: '16px',
+    },
+    error: {
+        color: token.danger,
+        fontSize: 12,
+        lineHeight: '16px',
+        maxWidth: 260,
+        overflow: 'hidden',
+        textOverflow: 'ellipsis',
+        whiteSpace: 'nowrap',
+    },
+};
+/** Render the release-sustained-state button for a continuable child, or nothing. */
+export function SubagentCloseAction({ useSession, sessionId, rpc, t, }) {
+    const session = useSession((s) => s);
+    const [state, setState] = useState('idle');
+    const [error, setError] = useState(null);
+    // Reset the outcome when the user switches to another session.
+    useEffect(() => {
+        setState('idle');
+        setError(null);
+    }, [sessionId]);
+    if (!isContinuableChild(session))
+        return null;
+    const address = session.subagent.address;
+    const onClose = async () => {
+        if (state === 'closing')
+            return;
+        setState('closing');
+        setError(null);
+        try {
+            const result = await rpc.call(SUBAGENT_DIRECTOR_RPC_CHANNEL, SUBAGENT_DIRECTOR_RPC_CLOSE, {
+                parentSessionId: address.parentSessionId,
+                childSessionId: address.childSessionId,
+            });
+            if (result.ok) {
+                setState('closed');
+            }
+            else {
+                setState('failed');
+                setError(result.error.message);
+            }
+        }
+        catch {
+            setState('failed');
+        }
+    };
+    if (state === 'closed') {
+        return (_jsx("div", { style: style.wrap, role: "status", children: _jsx("span", { style: style.settled, children: t('closedSubagent') }) }));
+    }
+    return (_jsxs("div", { style: style.wrap, children: [_jsx("button", { type: "button", style: style.button, disabled: state === 'closing', onClick: () => {
+                    const confirmed = typeof window === 'undefined' ||
+                        window.confirm(t('confirmCloseContinuable', { id: address.childSessionId }));
+                    if (confirmed)
+                        void onClose();
+                }, title: t('closeContinuableTitle', { id: address.childSessionId }), children: state === 'closing' ? t('closingContinuable') : t('closeContinuable') }), state === 'failed' && (_jsx("span", { style: style.error, role: "alert", children: t('closeFailed', { message: error ?? '' }) }))] }));
+}
+//# sourceMappingURL=SubagentCloseAction.js.map

package/lib/client/SubagentCloseAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubagentCloseAction.js","sourceRoot":"","sources":["../../src/client/SubagentCloseAction.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAI5C,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAanD,kFAAkF;AAClF,MAAM,CAAC,MAAM,EAAE,GAAG,2BAAoC,CAAC;AAIvD,qFAAqF;AACrF,MAAM,KAAK,GAA2C;IACpD,IAAI,EAAE;QACJ,OAAO,EAAE,aAAa;QACtB,UAAU,EAAE,QAAQ;QACpB,GAAG,EAAE,CAAC;KACP;IACD,MAAM,EAAE;QACN,GAAG,iBAAiB;QACpB,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,QAAQ;KAClB;IACD,OAAO,EAAE;QACP,KAAK,EAAE,KAAK,CAAC,aAAa;QAC1B,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,MAAM;KACnB;IACD,KAAK,EAAE;QACL,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,MAAM;QAClB,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,UAAU;QACxB,UAAU,EAAE,QAAQ;KACrB;CACF,CAAC;AAEF,qFAAqF;AACrF,MAAM,UAAU,mBAAmB,CAAC,EAClC,UAAU,EACV,SAAS,EACT,GAAG,EACH,CAAC,GACwB;IACzB,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAuB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAc,MAAM,CAAC,CAAC;IACxD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAExD,+DAA+D;IAC/D,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAQ,CAAC,QAAS,CAAC,OAAO,CAAC;IAE3C,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACxC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO;QAChC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE,2BAA2B,EAAE;gBACxF,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,cAAc,EAAE,OAAO,CAAC,cAAc;aACvC,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACnB,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,CACL,cAAK,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAC,QAAQ,YACnC,eAAM,KAAK,EAAE,KAAK,CAAC,OAAO,YAAG,CAAC,CAAC,gBAAgB,CAAC,GAAQ,GACpD,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,eAAK,KAAK,EAAE,KAAK,CAAC,IAAI,aACpB,iBACE,IAAI,EAAC,QAAQ,EACb,KAAK,EAAE,KAAK,CAAC,MAAM,EACnB,QAAQ,EAAE,KAAK,KAAK,SAAS,EAC7B,OAAO,EAAE,GAAG,EAAE;oBACZ,MAAM,SAAS,GACb,OAAO,MAAM,KAAK,WAAW;wBAC7B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;oBAC/E,IAAI,SAAS;wBAAE,KAAK,OAAO,EAAE,CAAC;gBAChC,CAAC,EACD,KAAK,EAAE,CAAC,CAAC,uBAAuB,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,YAEhE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAC/D,EACR,KAAK,KAAK,QAAQ,IAAI,CACrB,eAAM,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAC,OAAO,YACnC,CAAC,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC,GACtC,CACR,IACG,CACP,CAAC;AACJ,CAAC"}