external-subagent 0.5.1 → 0.5.2

package/README.md

@@ -16,7 +16,7 @@ independent axes:
 ## Status
 
 The package is published to the public npm registry as
-`external-subagent@0.5.1` for macOS arm64 and Linux x86_64. `os`/`cpu` in
+`external-subagent@0.5.2` for macOS arm64 and Linux x86_64. `os`/`cpu` in
 `package.json` are independent npm arrays, so npm admits any darwin/linux +
 arm64/x64 tuple at install time; the CLI then enforces the real support at
 first use — a host outside macOS/Linux is rejected with `UNSUPPORTED_PLATFORM`
@@ -70,7 +70,7 @@ acceptance matrix is recorded in
 
 ## Versioning
 
-The product version has a single source: `package.json` (`0.5.1`). The CLI
+The product version has a single source: `package.json` (`0.5.2`). The CLI
 constant (`cli/constants.mjs`), the daemon crates, and the native payload
 manifest all carry the same version, and `scripts/release/check-native-tarball.mjs`
 enforces payload/package agreement. The managed Codex plugin manifest
@@ -99,6 +99,34 @@ stale or missing binaries) and `postpack` runs the static tarball checks. A
 development checkout packs the same way (`npm pack` after `cargo` is
 available); see [docs/operations.md](docs/operations.md) for release checks.
 
+### Upgrade
+
+An in-place upgrade never kills a running task. `npm install` runs a
+postinstall reconcile that asks the daemon to drain and waits a bounded
+30 seconds for activation readiness; with active tasks it will time out on
+purpose rather than interrupt them.
+
+- **No active tasks**: `npm install -g external-subagent@<version>` is the
+  whole procedure — postinstall drains and activates automatically.
+- **Active tasks you are willing to interrupt**: stop first, then install and
+  reconcile explicitly:
+
+  ```
+  external-subagent stop
+  npm install -g external-subagent@<version>
+  external-subagent update
+  ```
+
+  Restarting the daemon also runs startup recovery, which settles and reaps
+  anything the drain would have waited for.
+- `external-subagent update --cancel-active --yes` asks the daemon to cancel
+  active tasks itself instead of waiting. It only settles tasks that are
+  still running; it is not a leftover-cleanup tool.
+
+Terminal tasks whose process state cannot be proven (runtime lost, orphaned
+group members) keep activation readiness false by design — the upgrade waits
+rather than reaping an unproven process group.
+
 ## Spawn profiles
 
 A spawn profile is a named JSON preset for the spawn inputs, stored as one

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.1';
+export const VERSION = '0.5.2';
 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/npm/native/darwin-arm64/payload.json

@@ -1,20 +1,20 @@
 {
   "schema_version": 1,
   "product": "external-subagent",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "platform": "darwin-arm64",
   "files": [
     {
       "name": "external-subagentd",
-      "bytes": 10075248,
+      "bytes": 10118624,
       "mode": "755",
-      "sha256": "eb0b1c4ffb4ab44678adf5aa39ee96f61cf09ebdb03b74da9e12cebad2b868f5"
+      "sha256": "d0effa783502353dc474ab4c961b35bbe82ba8cb2f1ccbdadae3aac7e68dec7a"
     },
     {
       "name": "external-subagent-mcp",
-      "bytes": 935888,
+      "bytes": 935760,
       "mode": "755",
-      "sha256": "1dce8a0c5566af2d9b4a12a39ad43c819bcb7f395a1a7c738389e5b0bbd24346"
+      "sha256": "76e52e11bf1d30553c26278f34f363005714f30012a7fca14df54cd025666461"
     }
   ]
 }

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

@@ -1,20 +1,20 @@
 {
   "schema_version": 1,
   "product": "external-subagent",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "platform": "linux-x64",
   "files": [
     {
       "name": "external-subagentd",
-      "bytes": 11452160,
+      "bytes": 11434656,
       "mode": "755",
-      "sha256": "c4f410496c2f9390288cb168e447127c9ee7ec0b47c591bcd84f25f688cad3af"
+      "sha256": "28b3bf99d7ea6e24747044620d6a6976849d434637e18372327848fcab3d202f"
     },
     {
       "name": "external-subagent-mcp",
-      "bytes": 1025360,
+      "bytes": 1025400,
       "mode": "755",
-      "sha256": "6553125c48dcd1a21554a6dd1181a7cb55d84f874118a1bd5136b5b29e916e60"
+      "sha256": "115d466e4480db0d0ebd45b2930e87b1510560e9cd4a2896bd8442318a967c19"
     }
   ]
 }

package/package.json

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