@vzn/vx 0.0.67 → 0.0.68

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.67",
+  "version": "0.0.68",
   "description": "An open, extensible monorepo task runner.",
   "type": "module",
   "exports": {
@@ -17,10 +17,10 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@vzn/vx-linux-x64": "0.0.67",
-    "@vzn/vx-linux-arm64": "0.0.67",
-    "@vzn/vx-darwin-x64": "0.0.67",
-    "@vzn/vx-darwin-arm64": "0.0.67"
+    "@vzn/vx-linux-x64": "0.0.68",
+    "@vzn/vx-linux-arm64": "0.0.68",
+    "@vzn/vx-darwin-x64": "0.0.68",
+    "@vzn/vx-darwin-arm64": "0.0.68"
   },
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "^0.0.76"

package/src/exec/executor.ts

@@ -190,7 +190,8 @@ export interface TaskExecutor {
   /**
    * How many tasks this executor runs at once. Its tasks then occupy a pool
    * of this size instead of the local worker slots, so a remote pool is not
-   * throttled by the local CPU count. Absent = the local pool.
+   * throttled by the local CPU count. A positive integer; anything else
+   * is refused when the executor is resolved. Absent = the local pool.
    */
   readonly capacity?: number
   /** Per-task opt-out at placement time. Absent = accepts every task it is offered. */

package/src/orchestrator/plugin-host.ts

@@ -419,6 +419,13 @@ export async function resolveExecutors(
     if (typeof executor.name !== 'string' || executor.name.length === 0) {
       throw new UserError(`plugin '${plugin.name}' returned an executor with no name`)
     }
+    // The pool's room is `active < capacity`: 0 or NaN parks its tasks for good.
+    const capacity: unknown = executor.capacity
+    if (capacity !== undefined && !(Number.isInteger(capacity) && (capacity as number) > 0)) {
+      throw new UserError(
+        `plugin '${plugin.name}' returned executor '${executor.name}' with capacity ${typeof capacity === 'number' ? String(capacity) : JSON.stringify(capacity)}: it must be a positive integer`,
+      )
+    }
     executorPlugin.set(executor, plugin.name)
     executors.push(executor)
   }