external-subagent 0.6.5 → 0.6.6

package/README.md

@@ -159,11 +159,16 @@ from the available set.
 | `permission_mode` | `build`, `edit`, `plan`, or `yolo`; defaults to `build` when unset |
 | `developer_instructions` | Free-form instructions, delivered as described below |
 
-`--profile` cannot be combined with `--subagent`, `--model`, `--effort`, or
-`--permission_mode`; put those in the profile JSON or omit `profile`. Fields
+`--profile` cannot be combined with `--subagent`, `--model`, `--effort`,
+`--developer-instructions`, or `--permission-mode`; put those in the profile
+JSON or omit `profile`. Fields
 left out of the profile fall back to the same defaults as an unprofiled
-spawn. `developer_instructions` rides the codex runtime's native
-`developerInstructions` channel when the effective subagent is `codex`; every
+spawn. `developer_instructions` is also accepted as a per-spawn parameter
+(`--developer-instructions` on the CLI, `developer_instructions` in the MCP
+and daemon RPC spawn inputs) with identical delivery semantics; the codex
+runtime's native
+`developerInstructions` channel carries it when the effective subagent is
+`codex`; every
 other subagent receives it silently concatenated in front of the prompt:
 
 ```

package/cli/commands/tasks.mjs

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import { CliError } from '../errors.mjs';
 import { profilesDir } from '../paths.mjs';
 
-const SPAWN_FIELDS = new Set(['profile', 'subagent', 'repository', 'permission_mode', 'prompt', 'model', 'effort', 'write_manifest']);
+const SPAWN_FIELDS = new Set(['profile', 'subagent', 'repository', 'permission_mode', 'prompt', 'model', 'effort', 'developer_instructions', 'write_manifest']);
 const FLAG_FIELDS = new Map([
   ['--profile', 'profile'],
   ['--subagent', 'subagent'],
@@ -11,9 +11,10 @@ const FLAG_FIELDS = new Map([
   ['--permission-mode', 'permission_mode'],
   ['--model', 'model'],
   ['--effort', 'effort'],
+  ['--developer-instructions', 'developer_instructions'],
 ]);
 
-const PROFILE_MUTEX_ERROR = 'profile cannot be combined with subagent, permission_mode, model, or effort; specify these in the profile JSON or omit profile';
+const PROFILE_MUTEX_ERROR = 'profile cannot be combined with subagent, permission_mode, model, effort, or developer_instructions; specify these in the profile JSON or omit profile';
 
 function flagValue(args, option) {
   const value = args.shift();
@@ -38,7 +39,7 @@ export function parseSpawnArgs(args) {
     input[field] = flagValue(remaining, option);
   }
   if (Object.hasOwn(input, 'profile')) {
-    if (Object.hasOwn(input, 'subagent') || Object.hasOwn(input, 'permission_mode') || Object.hasOwn(input, 'model') || Object.hasOwn(input, 'effort')) {
+    if (Object.hasOwn(input, 'subagent') || Object.hasOwn(input, 'permission_mode') || Object.hasOwn(input, 'model') || Object.hasOwn(input, 'effort') || Object.hasOwn(input, 'developer_instructions')) {
       throw new CliError('INVALID_ARGUMENT', PROFILE_MUTEX_ERROR, 2);
     }
   }
@@ -59,7 +60,7 @@ export function prepareSpawnInput(input) {
     throw new CliError('INVALID_ARGUMENT', 'profile must be a non-empty string', 2);
   }
   if (input.profile !== undefined) {
-    if (input.subagent !== undefined || input.permission_mode !== undefined || input.model !== undefined || input.effort !== undefined) {
+    if (input.subagent !== undefined || input.permission_mode !== undefined || input.model !== undefined || input.effort !== undefined || input.developer_instructions !== undefined) {
       throw new CliError('INVALID_ARGUMENT', PROFILE_MUTEX_ERROR, 2);
     }
   }
@@ -81,6 +82,15 @@ export function prepareSpawnInput(input) {
   if (input.effort !== undefined && (typeof input.effort !== 'string' || input.effort.length === 0)) {
     throw new CliError('INVALID_ARGUMENT', 'effort must be a non-empty string', 2);
   }
+  // Mirrors the daemon's spawn-parameter normalization: null is rejected on
+  // the wire, an empty/whitespace-only string stays accepted here (the daemon
+  // treats it as "not provided").
+  if (Object.prototype.hasOwnProperty.call(input, 'developer_instructions') && input.developer_instructions === null) {
+    throw new CliError('INVALID_ARGUMENT', 'developer_instructions must be omitted or a non-null string', 2);
+  }
+  if (input.developer_instructions !== undefined && typeof input.developer_instructions !== 'string') {
+    throw new CliError('INVALID_ARGUMENT', 'developer_instructions must be a string', 2);
+  }
   return { ...input };
 }
 

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.5';
+export const VERSION = '0.6.6';
 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/rpc.mjs

@@ -66,7 +66,7 @@ function readJsonInput(args) {
 function requestId() { return `cli-${process.pid}-${crypto.randomUUID()}`; }
 
 function manifest(input) {
-  const allowed = new Set(['profile', 'subagent', 'repository', 'permission_mode', 'prompt', 'model', 'effort', 'write_manifest']);
+  const allowed = new Set(['profile', 'subagent', 'repository', 'permission_mode', 'prompt', 'model', 'effort', 'developer_instructions', 'write_manifest']);
   for (const key of Object.keys(input)) {
     if (!allowed.has(key)) throw new CliError('INVALID_ARGUMENT', `spawn contains unsupported field: ${key}`, 2);
   }
@@ -74,6 +74,7 @@ function manifest(input) {
   if (input.subagent !== undefined && (typeof input.subagent !== 'string' || input.subagent.length === 0)) throw new CliError('INVALID_ARGUMENT', 'subagent must be a non-empty string', 2);
   if (input.model !== undefined && (typeof input.model !== 'string' || input.model.length === 0)) throw new CliError('INVALID_ARGUMENT', 'model must be a non-empty string', 2);
   if (input.effort !== undefined && (typeof input.effort !== 'string' || input.effort.length === 0)) throw new CliError('INVALID_ARGUMENT', 'effort must be a non-empty string', 2);
+  if (input.developer_instructions !== undefined && (typeof input.developer_instructions !== 'string')) throw new CliError('INVALID_ARGUMENT', 'developer_instructions must be a string', 2);
   if (typeof input.repository !== 'string' || input.repository.length === 0 || typeof input.prompt !== 'string' || input.prompt.length === 0) throw new CliError('INVALID_ARGUMENT', 'create requires non-empty repository and prompt strings', 2);
   if (input.permission_mode !== undefined && (typeof input.permission_mode !== 'string' || input.permission_mode.length === 0)) throw new CliError('INVALID_ARGUMENT', 'permission_mode must be a non-empty string', 2);
   if (input.write_manifest !== undefined && (!Array.isArray(input.write_manifest) || input.write_manifest.some((value) => typeof value !== 'string' || value.length === 0))) throw new CliError('INVALID_ARGUMENT', 'write_manifest must contain non-empty strings', 2);
@@ -117,6 +118,7 @@ function methodFor(command, input) {
         ...(input.subagent !== undefined ? { subagent: input.subagent } : {}),
         ...(input.model !== undefined ? { model: input.model } : {}),
         ...(input.effort !== undefined ? { effort: input.effort } : {}),
+        ...(input.developer_instructions !== undefined ? { developer_instructions: input.developer_instructions } : {}),
         manifest: manifest(input),
       },
     };

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

@@ -1,20 +1,20 @@
 {
   "schema_version": 1,
   "product": "external-subagent",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "platform": "darwin-arm64",
   "files": [
     {
       "name": "external-subagentd",
-      "bytes": 10503712,
+      "bytes": 10499872,
       "mode": "755",
-      "sha256": "1a9516144d5eeda7d88383278f3a60ac8cedc8f374e5829d46462426a2fb4854"
+      "sha256": "0e0818026b3e67b4fc4f70c3afb5c04c876cc49cc0cf90727ad6e37ec897e916"
     },
     {
       "name": "external-subagent-mcp",
       "bytes": 935776,
       "mode": "755",
-      "sha256": "23ffb90714a6574f313cd9fc79d8e25aa5b35c6f5020e53992229320168cdf78"
+      "sha256": "2162051fd153973fcdbada5dfbcc64f2faf46fc1b68043354fec86eb5b8c2050"
     }
   ]
 }

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

@@ -1,20 +1,20 @@
 {
   "schema_version": 1,
   "product": "external-subagent",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "platform": "linux-x64",
   "files": [
     {
       "name": "external-subagentd",
-      "bytes": 12083304,
+      "bytes": 12082480,
       "mode": "755",
-      "sha256": "68212a7873f8428d1cbe18137e689655b0402a92b9fc5f0710e5712766d24e4c"
+      "sha256": "4f7dd7d42b910990cd48424da9bfbcbbbdfa694ee1deca24ac00634cbe8895e6"
     },
     {
       "name": "external-subagent-mcp",
-      "bytes": 1025456,
+      "bytes": 1025544,
       "mode": "755",
-      "sha256": "7a95f5dea50ed52dc2167c1885ca887edae5ecfc188c4535e2d223d835374268"
+      "sha256": "f27f18ed61abe278bdb878f5b7f9a4b5d66be4995c9f147a66ea4cf5c086bd39"
     }
   ]
 }

package/package.json

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

@@ -198,7 +198,7 @@
         "profile": {
           "type": "string",
           "minLength": 1,
-          "description": "Profile name referencing a JSON preset in profiles/*.json. Mutually exclusive with subagent, permission_mode, model, and effort."
+          "description": "Profile name referencing a JSON preset in profiles/*.json. Mutually exclusive with subagent, permission_mode, model, effort, and developer_instructions."
         },
         "subagent": {
           "type": "string",
@@ -229,6 +229,11 @@
           "pattern": "^[a-z0-9_]+$",
           "description": "Reasoning-effort token: 1..24 bytes of [a-z0-9_]. codex admits only low, medium, high or xhigh; agy admits only low, medium, high or max; zcode and dsh pass the bounded token through. Omission keeps the runtime default."
         },
+        "developer_instructions": {
+          "type": "string",
+          "maxLength": 1048576,
+          "description": "Per-task developer instructions (at most 1 MiB). codex routes them through the native developerInstructions channel on thread/start (prompt stays verbatim); every other subagent splices them as a 'Developer Instructions:' prefix block ahead of the prompt. A trimmed-empty string means not provided (no admission effect). Mutually exclusive with profile: profiles carry their own developer_instructions. The spliced prompt stays under the shared 256 KiB prompt bound, which rejects the spawn before task creation; oversized developer_instructions are themselves rejected with validation before any task."
+        },
         "write_manifest": {
           "type": "array",
           "items": {
@@ -614,6 +619,7 @@
             "prompt",
             "model",
             "effort",
+            "developer_instructions",
             "write_manifest"
           ],
           "output": [