nexus-prime 7.9.5 → 7.9.6

package/dist/agents/adapters/mcp/async-gate.d.ts

@@ -41,6 +41,8 @@ export interface AsyncGateOpts {
     maxSyncMs?: number;
     /** Human-readable hint for estimated duration */
     etaMs?: number;
+    /** Return the async receipt before starting work. Use for cold paths that may block synchronously. */
+    alwaysQueue?: boolean;
 }
 type HandlerFn = () => Promise<{
     content: Array<{

package/dist/agents/adapters/mcp/async-gate.js

@@ -33,10 +33,7 @@ class AsyncGate {
             etaMs: opts.etaMs,
         };
         this.enqueueJob(job);
-        // Race: handler vs deadline
-        let syncResolved = false;
-        const deadline = new Promise((resolve) => setTimeout(() => resolve(null), maxSyncMs));
-        const work = (async () => {
+        const startWork = () => (async () => {
             job.status = 'running';
             job.stage = 'executing';
             job.startedAt = Date.now();
@@ -64,6 +61,18 @@ class AsyncGate {
                 };
             }
         })();
+        if (opts.alwaysQueue) {
+            setImmediate(() => {
+                startWork().catch(() => { });
+            });
+            return { queued: true, runId, etaMs: opts.etaMs };
+        }
+        // Race: handler vs deadline. Note: this only protects paths that yield
+        // quickly. Cold synchronous work should set alwaysQueue so the receipt is
+        // returned before the heavy section starts.
+        let syncResolved = false;
+        const deadline = new Promise((resolve) => setTimeout(() => resolve(null), maxSyncMs));
+        const work = startWork();
         // Suppress unhandled rejection: deadline may win while work is still in flight.
         work.catch(() => { });
         const winner = await Promise.race([

package/dist/agents/adapters/mcp/dispatch.js

@@ -124,7 +124,13 @@ export async function dispatchMcpToolCall(hctx, request, args, ctx) {
             const gated = await withAsyncGate(async () => {
                 const r = await runHandlers();
                 return r ?? { content: [{ type: 'text', text: `Tool ${toolName} returned no result` }] };
-            }, { tool: toolName, args, maxSyncMs: 2000, etaMs: TOOL_ETA_MS[toolName] });
+            }, {
+                tool: toolName,
+                args,
+                maxSyncMs: 2000,
+                etaMs: TOOL_ETA_MS[toolName],
+                alwaysQueue: toolName === 'nexus_orchestrate',
+            });
             if ('queued' in gated && gated.queued) {
                 // Persist orchestration run record for durable stage tracking
                 if (toolName === 'nexus_orchestrate') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-prime",
-  "version": "7.9.5",
+  "version": "7.9.6",
   "description": "Local-first MCP control plane for coding agents with bootstrap-orchestrate execution, memory fabric, token budgeting, and worktree-backed swarms",
   "type": "module",
   "main": "dist/index.js",