external-subagent 0.6.3 → 0.6.4

package/cli/commands/agents.mjs

@@ -4,7 +4,7 @@ import { SUBAGENT_IDS } from '../config/schema.mjs';
 import path from 'node:path';
 import { CliError } from '../errors.mjs';
 
-const INPUT_FIELDS = new Set(['operation', 'subagent', 'through', 'workspace', 'home']);
+const INPUT_FIELDS = new Set(['operation', 'subagent', 'through', 'workspace', 'home', 'probe']);
 
 function validateInput(input) {
   if (!input || typeof input !== 'object' || Array.isArray(input)) throw new CliError('INVALID_ARGUMENT', 'subagents input must be an object', 2);
@@ -71,6 +71,14 @@ export function parseSubagentsArgs(args) {
   if (operation === 'probe') return parseProbeArgs(rest);
   if (operation === 'models') return parseModelsArgs(rest);
   if (operation === 'list' && rest.length !== 0) throw new CliError('INVALID_ARGUMENT', 'usage: subagents list', 2);
+  if (operation === 'status') {
+    // `subagents status [subagent] [--probe]`: --probe asks the daemon to
+    // refresh model-catalog evidence before projecting (bounded, no prompts).
+    const positional = rest.filter((arg) => arg !== '--probe');
+    if (rest.length - positional.length > 1) throw new CliError('INVALID_ARGUMENT', 'usage: subagents status [subagent] [--probe]', 2);
+    if (positional.length > 1) throw new CliError('INVALID_ARGUMENT', 'usage: subagents status [subagent] [--probe]', 2);
+    return { operation, ...(positional[0] ? { subagent: positional[0] } : {}), ...(rest.includes('--probe') ? { probe: true } : {}) };
+  }
   if (operation !== 'list' && rest.length > 1) throw new CliError('INVALID_ARGUMENT', `usage: subagents ${operation} [subagent]`, 2);
   return { operation, ...(rest[0] ? { subagent: rest[0] } : {}) };
 }
@@ -141,7 +149,7 @@ export async function subagentsCommand(paths, input = {}, options = {}) {
   }
   if (operation !== 'status') throw new CliError('INVALID_ARGUMENT', `unsupported subagents operation: ${operation}`, 2);
   if (typeof options.callDaemon !== 'function' || typeof options.socket !== 'string') throw new CliError('INTERNAL_ERROR', 'subagents status requires a daemon connection');
-  const status = await options.callDaemon(options.socket, 'status', {});
+  const status = await options.callDaemon(options.socket, input.probe === true ? 'status-refresh' : 'status', input.probe === true ? { probe: true } : {});
   const entries = status.subagents ?? status.agents;
   if (!Array.isArray(entries)) throw new CliError('PROTOCOL_ERROR', 'daemon status did not include subagent status');
   const subagents = entries.filter((entry) => input.subagent === undefined || (entry.subagent ?? entry.agent) === input.subagent).map(subagentView);

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.6.3';
+export const VERSION = '0.6.4';
 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 (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`;
+const DAEMON_HELP = `  config get [key] | config set <key> <value>\n  subagents list | subagents status [subagent] [--probe] | 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);

package/cli/rpc.mjs

@@ -38,7 +38,7 @@ export function waitTransportTimeoutMs(waitTime = 290) {
 
 export function daemonTransportTimeoutMs(command, params = {}) {
   if (command === 'wait') return waitTransportTimeoutMs(params.wait_time);
-  if (command === 'agent-probe' || command === 'agent-models') return AGENT_PROBE_TRANSPORT_TIMEOUT_MS;
+  if (command === 'agent-probe' || command === 'agent-models' || command === 'status-refresh') return AGENT_PROBE_TRANSPORT_TIMEOUT_MS;
   if (command === 'create' || command === 'spawn') return SPAWN_TRANSPORT_TIMEOUT_MS;
   return 6000;
 }
@@ -101,6 +101,9 @@ function rejectUnknownFields(command, input, allowed) {
 function methodFor(command, input) {
   switch (command) {
     case 'status': return { method: 'system_status' };
+    case 'status-refresh':
+      rejectUnknownFields('status-refresh', input, new Set(['probe']));
+      return { method: 'system_status_refresh', params: { probe: input.probe === true } };
     case 'drain': return { method: 'daemon_begin_drain', ...(input.cancel_active === true ? { params: { cancel_active: true } } : {}) };
     case 'drain-status': return { method: 'daemon_drain_status' };
     case 'drain-abort': return { method: 'daemon_abort_drain' };
@@ -240,7 +243,7 @@ function publicWaitBody(body) {
 
 export function projectDaemonResult(command, result) {
   switch (command) {
-    case 'status': return result.status;
+    case 'status': case 'status-refresh': return result.status;
     case 'drain': case 'drain-status': case 'drain-abort': case 'activate-ready': return result;
     case 'agent-probe': return { evidence: result.evidence, status: result.status };
     case 'agent-models': return result.catalog ?? result;

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

@@ -1,20 +1,20 @@
 {
   "schema_version": 1,
   "product": "external-subagent",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "platform": "darwin-arm64",
   "files": [
     {
       "name": "external-subagentd",
-      "bytes": 10454160,
+      "bytes": 10475760,
       "mode": "755",
-      "sha256": "8365dfc712e5cca2f3332dcab5db0e7b5eb905eb2e0e7dc231016b45c7275094"
+      "sha256": "36397c02758203261b0b5bd6b013e6351dda69a0b1b1f4cc62e00e8375defea5"
     },
     {
       "name": "external-subagent-mcp",
       "bytes": 935776,
       "mode": "755",
-      "sha256": "98e60f3a0ff2840318842232a6f7689326a1e7d75f487cbcb0878ddce7b64719"
+      "sha256": "1c3c44601eb14c550e3ea336a2d021e4287944501fdb11d6708c0ae4e1b876db"
     }
   ]
 }

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

@@ -1,20 +1,20 @@
 {
   "schema_version": 1,
   "product": "external-subagent",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "platform": "linux-x64",
   "files": [
     {
       "name": "external-subagentd",
-      "bytes": 12033072,
+      "bytes": 12086128,
       "mode": "755",
-      "sha256": "5d8f39b76e22c24c8f848f9c753b7ba4336e9ecb57b82ef25d511ed21039dce7"
+      "sha256": "f1626011054612a995f18d86e0249f25c464fe7ca36b4c3a3d5431382e90c76e"
     },
     {
       "name": "external-subagent-mcp",
-      "bytes": 1025520,
+      "bytes": 1025528,
       "mode": "755",
-      "sha256": "11999c141398a0009f33d740123d381ad4aae58c0a56fb2131629b378da96e89"
+      "sha256": "4d502cfd888b493ca3e01ed420e6cb4715d36b9067055359343aecd3765ddf97"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "external-subagent",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "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

@@ -115,6 +115,9 @@
           },
           "additionalProperties": false
         },
+        "models": {
+          "$ref": "#/properties/subagent_models_status"
+        },
         "local": {
           "$ref": "#/properties/subagent_scope_status"
         },
@@ -127,6 +130,45 @@
       },
       "additionalProperties": false
     },
+    "subagent_models_status": {
+      "type": "object",
+      "description": "Passive projection of recorded model-catalog evidence. Present only when discovery ever ran (status probe=true or an explicit models call); never discovered means the field is absent. Recorded evidence whose config revision no longer matches degrades to supported=false with reason stale_config_revision.",
+      "required": [
+        "supported",
+        "tokens",
+        "source",
+        "checked_at_ms"
+      ],
+      "properties": {
+        "supported": {
+          "type": "boolean"
+        },
+        "tokens": {
+          "type": "array",
+          "description": "Model selection tokens usable verbatim in spawn model (zcode provider/model, dsh provider:model, codex model id, agy bare slug). Empty when supported is false.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "source": {
+          "type": "string",
+          "description": "Evidence source label, e.g. zcode_session_create_settings, codex_app_server_model_list, dsh_acp_models_list, agy_models_list."
+        },
+        "version": {
+          "type": "string",
+          "description": "Runtime version observed at discovery time; omitted when unknown."
+        },
+        "checked_at_ms": {
+          "type": "integer",
+          "description": "Epoch milliseconds when the evidence was recorded."
+        },
+        "reason": {
+          "type": "string",
+          "description": "Bounded degradation reason (stale_config_revision, auth_required, model_catalog_empty, transport, ...); omitted on success."
+        }
+      },
+      "additionalProperties": false
+    },
     "subagent_scope_status": {
       "type": "object",
       "description": "Readiness conclusion only. Probe evidence (scope paths, version, checked_at_ms, reason) stays on the daemon RPC view for the CLI diagnose owner.",
@@ -553,7 +595,9 @@
       "additionalProperties": false,
       "properties": {
         "external_subagent_status": {
-          "input": [],
+          "input": [
+            "probe"
+          ],
           "output": [
             "mcp_version",
             "components",