dsh-subagent-control 1.0.4 → 1.0.5

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.0.5
+
+- The `subagent_budget` tool says "not running" instead of "inactive", and its line now lists how
+  many subagents sit on each level (`levels 1:3 2:1`).
+- The `drain_subagents` description no longer claims a released child can never be woken again.
+  Drain drops the activation and gives the run back; the session stays continuable, so a later
+  message cold-resumes it.
+
 ## 1.0.4
 
 - The single optional `extras` row is split into four independent components, each with its own

package/README.md

@@ -100,6 +100,14 @@ A separate companion bundle, [`dsh-team-limits`](https://github.com/SpaceRelay/d
 raises the Agent Team limits (members, tasks, message bytes). It is a separate install on
 purpose: it overrides the shipped `agent-team` row, and that should never happen implicitly.
 
+A second companion bundle, [`dsh-human-wait`](https://github.com/SpaceRelay/dsh-subagent-control/tree/main/human-wait),
+stops the PTC `run_code` deadline from counting the time you spend answering a question, reviewing
+a plan or approving a request. PTC mode wraps the whole program — nested tool and approval waits
+included — in one 120 s wall clock, so a slow answer used to surface as
+`Error: code run failed (timeout): execution deadline reached (120000ms)`. With the bundle
+installed that wait no longer burns the budget (default cap 24 h, `-1` = unlimited) while a plain
+runaway program is still stopped at the normal budget.
+
 ### License
 
 MIT — see [LICENSE](./LICENSE). Issues and source live at
@@ -194,6 +202,8 @@ plugin_manager install_bundle target "dsh-subagent-control@1.0.0"
 
 另有一个独立的同伴包 [`dsh-team-limits`](https://github.com/SpaceRelay/dsh-subagent-control/tree/main/team-limits)，用来提高 Agent Team 的成员数、任务数与消息字节上限。**它刻意做成单独安装**：它覆盖的是宿主自带的 `agent-team` 行，这种事不该偷偷发生。
 
+还有一个独立的同伴包 [`dsh-human-wait`](https://github.com/SpaceRelay/dsh-subagent-control/tree/main/human-wait)，用来让 PTC 模式 `run_code` 的执行预算在「等你回答提问 / 审议计划 / 审批」期间暂停。PTC 会把整个程序——**包括嵌套的工具调用与审批等待**——包在一个 120 秒墙钟里，所以回答慢一点就会看到 `Error: code run failed (timeout): execution deadline reached (120000ms)`；装上之后这段等待不再计入预算（默认上限 24 小时，`-1` 表示不限），而普通的死循环程序仍会在原预算处被终止。**同样刻意做成单独安装**：它拦截的是宿主 `ptc-runtime` 的执行预算。
+
 ### 许可
 
 MIT，见 [LICENSE](./LICENSE)。源码与问题反馈：

package/components/budget/index.js

@@ -40,7 +40,7 @@ export function apply(ctx) {
     name: 'subagent_budget',
     description:
       'Report the delegation budget this agent is working with: the configured depth limit, ' +
-      'how deep the agents below it already go, and how many are running. ' +
+      'how deep the agents below it already go, how many sit on each level, and how many are running. ' +
       'Read-only; it never starts, stops or messages anything.',
     parameters: { type: 'object', additionalProperties: false, properties: {} },
     output: {
@@ -48,8 +48,11 @@ export function apply(ctx) {
       render: (_args, budget) => {
         const parts = []
         if (budget.maxDepth !== undefined) parts.push(`depth limit ${budget.maxDepth}`)
-        parts.push(`${budget.running} running`, `${budget.inactive} inactive`)
+        parts.push(`${budget.running} running`, `${budget.inactive} not running`)
         if (budget.deepest !== undefined) parts.push(`deepest ${budget.deepest}`)
+        if (budget.levels !== undefined && budget.levels.length > 0) {
+          parts.push(`levels ${budget.levels.map((level) => `${level.depth}:${level.count}`).join(' ')}`)
+        }
         return [{ type: 'text', text: parts.join(', ') }]
       },
     },

package/components/budget/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Delegation budget",
-    "description": "Read-only report of the delegation budget: depth limit, levels, running and inactive counts."
+    "description": "Read-only view of the delegation budget: depth limit, deepest level, agents per level, and running versus not-running counts."
   }
 }

package/components/budget/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "委派预算",
-    "description": "只读报告：深度上限、各层人数、最深一层、运行中与已停止的数量。规划扇出前先看一眼。"
+    "description": "只读查看委派预算：深度上限、最深一层、各层人数，以及运行中与未运行的数量。"
   }
 }

package/components/drain/index.js

@@ -2,8 +2,8 @@
  * Drain: stop and release direct children, freeing their run.
  *
  * interrupt_subagent only ends the current turn and keeps the activation, so a
- * stopped subagent stays in the catalog. Drain removes the run itself, which is
- * why a released child can never be woken with another message.
+ * stopped subagent stays resident. Drain drops the activation and gives the run
+ * back; the session itself stays continuable, so a later message cold-resumes it.
  */
 import { requireAgent } from '../shared.js'
 
@@ -24,9 +24,9 @@ export function apply(ctx) {
   ctx.tools.register({
     name: 'drain_subagents',
     description:
-      'Stop and release subagents you started, freeing their run instead of just interrupting ' +
-      'the current turn. Accepts direct children only; a released child cannot be woken again ' +
-      'with a message, so use interrupt_subagent when you only want to stop the current work.',
+      'Stop subagents you started without waiting for them to finish and free the run ' +
+      'they occupy. Direct children only; a later message still wakes a released child. ' +
+      'Use interrupt_subagent when you only want to stop the current work.',
     parameters: {
       type: 'object',
       additionalProperties: false,

package/components/drain/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Release subagents",
-    "description": "Stop and release direct children, freeing their run; a released agent cannot be woken again."
+    "description": "Stop direct children without waiting for them to finish and free the run they occupy; a later message can still wake them."
   }
 }

package/components/drain/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "释放子代理",
-    "description": "停止并释放直接子代理，真正腾出运行实例；释放后不能再唤醒，只想停当前回合请用 interrupt_subagent。"
+    "description": "不必等它跑完，立即停止直接子代理并腾出它占用的运行实例；之后发消息仍能把它重新唤醒。想只停当前回合请用 interrupt_subagent。"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-subagent-control",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Three tools — list_subagents, send_subagent_message, interrupt_subagent — that let any agent, including a team member, list, steer and stop the subagents it started.",
   "license": "MIT",
   "author": {