external-subagent 0.5.5 → 0.6.0

package/cli/constants.mjs

@@ -12,7 +12,7 @@ const IS_DEBUG_VARIANT = process.env.EXTERNAL_SUBAGENT_VARIANT === 'debug';
 
 export const PRODUCT_NAME = IS_DEBUG_VARIANT ? 'external-subagent-debug' : 'external-subagent';
 export const PRODUCT_ID = IS_DEBUG_VARIANT ? 'external_subagent_debug' : 'external_subagent';
-export const VERSION = '0.5.5';
+export const VERSION = '0.6.0';
 export const LAUNCH_AGENT_LABEL = IS_DEBUG_VARIANT ? 'com.external-subagent-debug.daemon' : 'com.external-subagent.daemon';
 export const DAEMON_BIN_NAME = IS_DEBUG_VARIANT ? 'external-subagent-debugd' : 'external-subagentd';
 export const MCP_BIN_NAME = IS_DEBUG_VARIANT ? 'external-subagent-debug-mcp' : 'external-subagent-mcp';

package/cli/main.mjs

@@ -24,7 +24,7 @@ import { parseProfileArgs, parseSpawnArgs, prepareSpawnInput, profileCommand } f
 const SUPPORTED_PLATFORMS = new Set(['darwin', 'linux', 'win32']);
 
 const HELP = `external-subagent ${VERSION}\n\nUsage: external-subagent <command> [options]\n\nCommands:\n  help, version               Show basic product information\n  init [--dry-run] [--resume] [--skip-service-start]\n                             Install the standalone daemon service only; bind a\n                             host afterwards with install-plugin or install-mcp\n  install-plugin [codex|zcode|dsh] [--dry-run|--uninstall] [--codex-home <path>]\n                             [--profile <name> [--dsh-home <path>]]\n                             Install or remove the managed host plugin (MCP + skill);\n                             the host defaults to codex, --codex-home is codex-only,\n                             --profile/--dsh-home are dsh-only (the dsh host appends\n                             one managed mcp-client entry to the profile's\n                             cordis.patch.yml under $DSH_HOME/profiles)\n  install-mcp [--dry-run|--uninstall] [--codex-home <path>]\n                             Install or remove the direct Codex MCP TOML binding\n  status, diagnose            Inspect local service and runtime state\n  start, stop                 Bootstrap or boot out the daemon service\n  profile list | profile show <name>\n                             Inspect global spawn profiles (profiles/*.json);\n                             invalid files are reported as path-based warnings,\n                             and warned or duplicate files are excluded from the\n                             available name set\n  backup --output <dir>       Back up retained product data\n  restore --input <dir>       Verify and restore product data\n  uninstall                   Release Codex/ZCode/DSH bindings; remove service registration; retain data\n  purge --yes                 Explicitly delete new product data\n`;
-const DAEMON_HELP = `  config get [key] | config set <key> <value>\n  subagents list | subagents status [subagent] | subagents probe/models [subagent]\n  create/spawn [--profile <name>], wait, list, send, respond, cancel, result, close, observe\n                             Daemon calls accept --json '<object>' or JSON stdin\n                             list JSON requires repository (workspace is an alias)\n                             observe JSON requires only agent_id\n`;
+const DAEMON_HELP = `  config get [key] | config set <key> <value>\n  subagents list | subagents status [subagent] | subagents probe/models [subagent]\n  create/spawn [--profile <name>], wait (one agent_id or a JSON array of up to 16), list, send, respond, cancel, result, close, observe\n                             Daemon calls accept --json '<object>' or JSON stdin\n                             list JSON requires repository (workspace is an alias)\n                             observe JSON requires only agent_id\n`;
 
 function structuredInput(args, parser) {
   return args.length > 0 && !args[0].startsWith('--') ? parser(args) : parseDaemonInput(args);
@@ -308,7 +308,7 @@ async function diagnose(paths, args) {
         query_request_id: snapshot.__request_id ?? null,
         identifiers_complete: Boolean(snapshot.task?.turn_id || (Array.isArray(snapshot.pending_requests) && snapshot.pending_requests.some((request) => request.request_id))),
         pending_request_count: Array.isArray(snapshot.pending_requests) ? snapshot.pending_requests.length : null,
-        result_available: snapshot.result_available ?? false,
+        result_available: snapshot.result_available ?? (snapshot.result != null),
         observed_at_ms: Date.now(),
       };
     } catch (error) {

package/cli/rpc.mjs

@@ -119,6 +119,26 @@ function methodFor(command, input) {
     };
     case 'wait': {
       rejectUnknownFields('wait', input, new Set(['agent_id', 'wait_time', 'message_id']));
+      // agent_id accepts a scalar (historical shape) or a list of ids; the
+      // daemon's untagged WaitTarget mirrors the caller's form.
+      if (Array.isArray(input.agent_id)) {
+        if (input.agent_id.length === 0) {
+          throw new CliError('INVALID_ARGUMENT', 'wait agent_id list must contain at least one id', 2);
+        }
+        if (input.agent_id.length > 16) {
+          throw new CliError('INVALID_ARGUMENT', 'wait agent_id list supports at most 16 ids', 2);
+        }
+        if (input.message_id !== undefined && input.message_id !== null) {
+          throw new CliError('INVALID_ARGUMENT', 'wait message_id is only supported with a single agent_id', 2);
+        }
+        return {
+          method: 'task_wait',
+          params: {
+            agent_id: input.agent_id.map((id) => daemonTaskId(id)),
+            wait_time: input.wait_time ?? 290,
+          },
+        };
+      }
       return {
         method: 'task_wait',
         params: {
@@ -189,12 +209,12 @@ function publicTask(task) {
 }
 
 // The wait response carries only the task lifecycle header: admission
-// provenance never changes after spawn, so wait does not repeat it.
+// provenance and the session id never change after spawn, so wait does not
+// repeat them.
 function publicTaskHeader(task) {
   return {
     agent_id: publicTaskId(task.agent_id),
     status: task.status,
-    session_id: task.session_id ?? null,
   };
 }
 
@@ -207,11 +227,17 @@ function publicResult(result) {
     offset: result.offset,
     total_bytes: result.total_bytes,
     next_offset: result.next_offset ?? null,
-    complete: result.complete,
     reason_code: result.reason_code ?? null,
+    failure_message: result.failure_message ?? null,
   };
 }
 
+// One per-agent wait body: identical in scalar and list mode.
+function publicWaitBody(body) {
+  const { result: taskResult, task, activity, kind: _kind, ...rest } = body;
+  return { ...rest, task: publicTaskHeader(task), activity, result: publicResult(taskResult) };
+}
+
 export function projectDaemonResult(command, result) {
   switch (command) {
     case 'status': return result.status;
@@ -221,8 +247,25 @@ export function projectDaemonResult(command, result) {
     case 'create': case 'spawn':
       return { agent_id: publicTaskId(result.task.agent_id), status: result.task.status, session_id: result.task.session_id ?? null };
     case 'wait': {
-      const { result: taskResult, task, activity, kind: _kind, ...rest } = result;
-      return { ...rest, task: publicTaskHeader(task), activity, result: publicResult(taskResult) };
+      // List-mode response: kind=task_wait_many with a FLAT keyed object —
+      // one key per distinct id carrying the wait body, plus an `error` key
+      // collecting duplicated/unknown ids. Rekey by public numeric id.
+      if (result.kind === 'task_wait_many') {
+        const projected = {};
+        const { error, kind: _kind, ...bodies } = result;
+        for (const [id, body] of Object.entries(bodies)) {
+          projected[publicTaskId(id)] = publicWaitBody(body);
+        }
+        if (error && typeof error === 'object') {
+          const errorProjected = {};
+          for (const [id, marker] of Object.entries(error)) {
+            errorProjected[publicTaskId(id)] = marker;
+          }
+          projected.error = errorProjected;
+        }
+        return projected;
+      }
+      return publicWaitBody(result);
     }
     case 'list': return { tasks: result.tasks.map(publicTask), next_cursor: result.next_cursor ?? null };
     case 'send': return { message_id: result.message_id, disposition: result.disposition };

package/npm/native/darwin-arm64/payload.json

@@ -1,20 +1,20 @@
 {
   "schema_version": 1,
   "product": "external-subagent",
-  "version": "0.5.5",
+  "version": "0.6.0",
   "platform": "darwin-arm64",
   "files": [
     {
       "name": "external-subagentd",
-      "bytes": 10169696,
+      "bytes": 10454384,
       "mode": "755",
-      "sha256": "2a253cc82755453ce7e56a625871f7fc2144d853f37dda1498daa18d0800dfc0"
+      "sha256": "3c3363a340d30718a7cb50801467eab8be7e70856b3c6f8925f6c7e87243b3ce"
     },
     {
       "name": "external-subagent-mcp",
       "bytes": 935776,
       "mode": "755",
-      "sha256": "f941106af0c3135087a1122d3e6075223996ab09831768a1a495facb91ca6ad7"
+      "sha256": "037d6041c379290284dadba0631b4f1e706a49e3315ef476952168f0ed3477ef"
     }
   ]
 }

package/npm/native/linux-x64/payload.json

@@ -1,20 +1,20 @@
 {
   "schema_version": 1,
   "product": "external-subagent",
-  "version": "0.5.5",
+  "version": "0.6.0",
   "platform": "linux-x64",
   "files": [
     {
       "name": "external-subagentd",
-      "bytes": 11488752,
+      "bytes": 12008336,
       "mode": "755",
-      "sha256": "d960dc25d6f4ac77027f81575b91428bb521c8f75b5b39f30e148b15707f1ebb"
+      "sha256": "d2f9599c6982ff3900cdc9516ed9bc7ab3b8d7c23012b1ac44f63a79a4f5878e"
     },
     {
       "name": "external-subagent-mcp",
-      "bytes": 1025512,
+      "bytes": 1025520,
       "mode": "755",
-      "sha256": "44717d7bada5ed71066f93348fa26f74391475fa147c816c3574a91b3ad65f22"
+      "sha256": "5a84607f0e2abe6afc679b7ea39207d50c06084fbcc4f54444f8f55168bc2492"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "external-subagent",
-  "version": "0.5.5",
+  "version": "0.6.0",
   "description": "Manage bounded ZCode, DeepSeek Harness (DSH), Codex, and Google Antigravity (agy) subagent tasks through a local MCP service for any local host (Codex, ZCode, or a custom MCP client)",
   "type": "module",
   "license": "MIT",

package/schema/external-subagent-public-api.json

@@ -104,12 +104,18 @@
     },
     "wait": {
       "type": "object",
-      "description": "Wait up to 290 seconds by default. Returns early only when an actionable pending request exists (permission requests need allow/deny; user-input requests carry the full embedded question and need answer with non-empty content) or the terminal result is available; ordinary progress, message receipts, already-responded and unsupported requests never wake it, and its timeout still returns timed_out=true. When the final result is embedded with complete=true no further result call is needed; a partial page directs you to external_subagent_result with next_offset. A failed terminal result also carries failure_message: usually the daemon's bounded single-line JSON failure detail, but an early fail_claim row may be plain text, so treat it as an opaque bounded string and attempt JSON parsing defensively (null when the task has no persisted detail or the outcome is not a failure). Read failure_message before falling back to daemon logs or sqlite. The pending_requests projection stays capped at 100 records while the wake decision scans the full pending set, and the request that woke the wait is always part of the returned projection so its request_id can be answered directly. activity carries the text tail incrementally: each wait returns only the text appended since the previous wait (an empty tail means nothing new), every byte is delivered by wait at most once, and latest_text_truncated flags the case where undelivered bytes rolled out of the bounded window so this response degraded to the whole window (on the terminal response, bytes repeating the embedded result page verbatim are stripped so they are not shipped twice), tool calls started in the last 60 seconds, and telemetry status; activity also exposes last_activity_age_ms (null before any activity) and model_request_active; additionally in_flight_tool_count counts tracked in-flight tool calls (scheduled or started without a matching result, error or permission resolution; 0 when there is no snapshot or the adapter has no per-call lifecycle tracking, such as codex) and oldest_in_flight_tool_age_ms is the age since the oldest tracked in-flight call first appeared (null when none is tracked); use external_subagent_observe only when these liveness signals suggest a meaningless loop or a stuck command, to inspect recent tool-call detail.",
+      "description": "agent_id accepts one agent id (number) or a list of 1..=16 ids. A single id returns the single wait object described below. A list blocks until every listed agent is terminal OR any one of them raises an actionable pending request, then returns a FLAT object: one key per distinct agent id carrying that agent's ordinary wait object (a repeated id is awaited once like any other), plus one \"error\" key mapping problematic ids to markers - duplicated for ids repeated in the input and unknown_agent for ids that do not exist; the remaining ids are still awaited normally. Recommended parallel pattern: spawn every subagent first, then call wait once with all ids. In list mode message_id is not supported (pass it only with a scalar id), every element carries message_receipt=null, and each element's timed_out flag follows the same shared deadline. Wait up to 290 seconds by default. Returns early only when an actionable pending request exists (permission requests need allow/deny; user-input requests carry the full embedded question and need answer with non-empty content) or the terminal result is available; ordinary progress, message receipts, already-responded and unsupported requests never wake it, and its timeout still returns timed_out=true. When the embedded result page carries next_offset=null it is the whole final result and no further result call is needed; otherwise continue reading with external_subagent_result from next_offset. A failed terminal result also carries failure_message: usually the daemon's bounded single-line JSON failure detail, but an early fail_claim row may be plain text, so treat it as an opaque bounded string and attempt JSON parsing defensively (null when the task has no persisted detail or the outcome is not a failure). Read failure_message before falling back to daemon logs or sqlite. The pending_requests projection stays capped at 100 records while the wake decision scans the full pending set, and the request that woke the wait is always part of the returned projection so its request_id can be answered directly. activity carries the text tail incrementally: each wait returns only the text appended since the previous wait (an empty tail means nothing new), every byte is delivered by wait at most once, and latest_text_truncated flags the case where undelivered bytes rolled out of the bounded window so this response degraded to the whole window (on the terminal response, bytes repeating the embedded result page verbatim are stripped so they are not shipped twice), tool calls started in the last 60 seconds, and telemetry status; activity also exposes last_activity_age_ms (null before any activity) and model_request_active; additionally in_flight_tool_count counts tracked in-flight tool calls (scheduled or started without a matching result, error or permission resolution; 0 when there is no snapshot or the adapter has no per-call lifecycle tracking, such as codex) and oldest_in_flight_tool_age_ms is the age since the oldest tracked in-flight call first appeared (null when none is tracked); use external_subagent_observe only when these liveness signals suggest a meaningless loop or a stuck command, to inspect recent tool-call detail.Wait up to 290 seconds by default. Returns early only when an actionable pending request exists (permission requests need allow/deny; user-input requests carry the full embedded question and need answer with non-empty content) or the terminal result is available; ordinary progress, message receipts, already-responded and unsupported requests never wake it, and its timeout still returns timed_out=true. When the embedded result page carries next_offset=null it is the whole final result and no further result call is needed; otherwise continue reading with external_subagent_result from next_offset. A failed terminal result also carries failure_message: usually the daemon's bounded single-line JSON failure detail, but an early fail_claim row may be plain text, so treat it as an opaque bounded string and attempt JSON parsing defensively (null when the task has no persisted detail or the outcome is not a failure). Read failure_message before falling back to daemon logs or sqlite. The pending_requests projection stays capped at 100 records while the wake decision scans the full pending set, and the request that woke the wait is always part of the returned projection so its request_id can be answered directly. activity carries the text tail incrementally: each wait returns only the text appended since the previous wait (an empty tail means nothing new), every byte is delivered by wait at most once, and latest_text_truncated flags the case where undelivered bytes rolled out of the bounded window so this response degraded to the whole window (on the terminal response, bytes repeating the embedded result page verbatim are stripped so they are not shipped twice), tool calls started in the last 60 seconds, and telemetry status; activity also exposes last_activity_age_ms (null before any activity) and model_request_active; additionally in_flight_tool_count counts tracked in-flight tool calls (scheduled or started without a matching result, error or permission resolution; 0 when there is no snapshot or the adapter has no per-call lifecycle tracking, such as codex) and oldest_in_flight_tool_age_ms is the age since the oldest tracked in-flight call first appeared (null when none is tracked); use external_subagent_observe only when these liveness signals suggest a meaningless loop or a stuck command, to inspect recent tool-call detail.",
       "required": ["agent_id"],
       "properties": {
-        "agent_id": { "type": "integer", "minimum": 10000000, "maximum": 99999999 },
+        "agent_id": {
+          "anyOf": [
+            { "type": "integer", "minimum": 10000000, "maximum": 99999999 },
+            { "type": "array", "minItems": 1, "maxItems": 16, "items": { "type": "integer", "minimum": 10000000, "maximum": 99999999 } }
+          ],
+          "description": "One agent id (scalar response) or a list of 1..=16 ids awaited together (response is an object keyed by agent id, each value the ordinary wait output or {\"error\":\"duplicated\"}/{\"error\":\"unknown_agent\"})."
+        },
         "wait_time": { "type": "integer", "minimum": 0, "maximum": 299, "default": 290 }
-        ,"message_id": { "type": ["string", "null"] }
+        ,"message_id": { "type": ["string", "null"], "description": "Only supported with a scalar agent_id." }
       },
       "additionalProperties": false
     },
@@ -135,7 +141,7 @@
     },
     "result_projection": {
       "type": "object",
-      "required": ["outcome", "final_text", "partial", "offset", "total_bytes", "next_offset", "complete", "reason_code"],
+      "required": ["outcome", "final_text", "partial", "offset", "total_bytes", "next_offset", "reason_code", "failure_message"],
       "properties": {
         "outcome": { "enum": ["COMPLETED", "FAILED", "CANCELLED", "TIMED_OUT", "RUNTIME_LOST", "RESULT_INVALID"] },
         "final_text": { "type": "string" },
@@ -143,8 +149,8 @@
         "offset": { "type": "integer", "minimum": 0 },
         "total_bytes": { "type": "integer", "minimum": 0 },
         "next_offset": { "type": ["integer", "null"], "minimum": 0 },
-        "complete": { "type": "boolean" },
-        "reason_code": { "type": ["string", "null"] }
+        "reason_code": { "type": ["string", "null"] },
+        "failure_message": { "type": ["string", "null"] }
       },
       "additionalProperties": false
     },
@@ -185,7 +191,7 @@
       "properties": {
         "external_subagent_status": { "input": [], "output": ["mcp_version", "components", "capabilities", "subagents"] },
         "external_subagent_spawn": { "input": ["profile", "subagent", "repository", "permission_mode", "prompt", "model", "effort", "write_manifest"], "output": ["agent_id", "status", "session_id", "instruction"], "idempotent": false },
-        "external_subagent_wait": { "input": ["agent_id", "wait_time", "message_id"], "output": ["task", "pending_requests", "result_available", "activity", "result", "instruction", "timed_out", "message_receipt"] },
+        "external_subagent_wait": { "input": ["agent_id", "wait_time", "message_id"], "output": ["task", "pending_requests", "activity", "result", "timed_out", "message_receipt"], "output_many": ["<agent_id> keys", "error"], "agent_id_forms": "scalar or array of 1..=16", "parallel_note": "spawn all subagents first, then wait once with the full id list" },
         "external_subagent_observe": { "input": ["agent_id"], "output": ["tools", "reasoning", "coverage"], "idempotent": true },
         "external_subagent_list": { "input": ["subagent", "repository", "phase", "outcome", "cursor", "limit"], "output": ["tasks", "next_cursor"] },
         "external_subagent_send": { "input": ["agent_id", "message_id", "mode", "content"], "required": ["agent_id", "mode", "content"], "mode": ["queue", "steer"], "output": ["message_id", "disposition"] },