nexus-prime 7.9.0 → 7.9.1

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

@@ -15,6 +15,7 @@ export type AsyncJobStatus = 'pending' | 'running' | 'completed' | 'failed';
 export interface AsyncJob {
     runId: string;
     tool: string;
+    args?: Record<string, unknown>;
     status: AsyncJobStatus;
     stage: string;
     progress: number;
@@ -29,10 +30,13 @@ export interface AsyncJob {
     };
     error?: string;
     etaMs?: number;
+    lifecycleReportedAt?: number;
 }
 export interface AsyncGateOpts {
     /** Tool name — for job metadata */
     tool: string;
+    /** Original tool args, used when a poll observes final lifecycle state. */
+    args?: Record<string, unknown>;
     /** If handler resolves within this window, return inline. Default: 2000ms */
     maxSyncMs?: number;
     /** Human-readable hint for estimated duration */
@@ -67,6 +71,7 @@ declare class AsyncGate {
         }>;
     };
     updateStage(runId: string, stage: string, progress: number): void;
+    markLifecycleReported(runId: string): void;
     /** Return jobs that have been running longer than their stale threshold. */
     getStaleJobs(now: number, defaultStaleMs: number, etaMultiplier: number): AsyncJob[];
     /** Mark a running job as failed (watchdog reap). */

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

@@ -25,6 +25,7 @@ class AsyncGate {
         const job = {
             runId,
             tool: opts.tool,
+            args: opts.args,
             status: 'pending',
             stage: 'queued',
             progress: 0,
@@ -55,8 +56,12 @@ class AsyncGate {
                 job.error = err instanceof Error ? err.message : String(err);
                 job.completedAt = Date.now();
                 nexusEventBus.emit('async_gate.failed', { runId, tool: opts.tool, error: job.error });
-                // Do not rethrow — if deadline already won there is no downstream catcher;
-                // job state is updated so polls return the error correctly.
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `❌ Run ${runId} failed\nTool: ${opts.tool}\nError: ${job.error ?? 'unknown'}`,
+                        }],
+                };
             }
         })();
         // Suppress unhandled rejection: deadline may win while work is still in flight.
@@ -118,6 +123,11 @@ class AsyncGate {
             job.progress = Math.min(99, progress);
         }
     }
+    markLifecycleReported(runId) {
+        const job = this.jobs.get(runId);
+        if (job)
+            job.lifecycleReportedAt = Date.now();
+    }
     /** Return jobs that have been running longer than their stale threshold. */
     getStaleJobs(now, defaultStaleMs, etaMultiplier) {
         const stale = [];

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

@@ -26,6 +26,23 @@ const SLOW_TOOLS = new Set([
     'nexus_ghost_pass',
     'nexus_spawn_workers',
     'nexus_optimize_tokens',
+    'nexus_search',
+    'nexus_assemble_context',
+    'nexus_graph_query',
+    'nexus_session_search',
+    'nexus_memory_export',
+    'nexus_memory_backup',
+    'nexus_memory_import',
+    'nexus_memory_hygiene',
+    'nexus_memory_audit',
+    'nexus_pattern_search',
+    'nexus_knowledge_provenance',
+    'nexus_rag_ingest_collection',
+    'nexus_workflow_run',
+    'nexus_automation_run',
+    'nexus_doctor',
+    'nexus_autofix',
+    'nexus_hypertune_max',
 ]);
 /** Estimated wall-clock duration for each slow tool (ms). */
 const TOOL_ETA_MS = {
@@ -34,6 +51,23 @@ const TOOL_ETA_MS = {
     nexus_ghost_pass: 45_000,
     nexus_spawn_workers: 30_000,
     nexus_optimize_tokens: 10_000,
+    nexus_search: 20_000,
+    nexus_assemble_context: 20_000,
+    nexus_graph_query: 30_000,
+    nexus_session_search: 20_000,
+    nexus_memory_export: 20_000,
+    nexus_memory_backup: 30_000,
+    nexus_memory_import: 30_000,
+    nexus_memory_hygiene: 30_000,
+    nexus_memory_audit: 30_000,
+    nexus_pattern_search: 20_000,
+    nexus_knowledge_provenance: 20_000,
+    nexus_rag_ingest_collection: 45_000,
+    nexus_workflow_run: 45_000,
+    nexus_automation_run: 45_000,
+    nexus_doctor: 20_000,
+    nexus_autofix: 45_000,
+    nexus_hypertune_max: 45_000,
 };
 /**
  * Route a tool call to the appropriate handler group.
@@ -90,7 +124,7 @@ 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, maxSyncMs: 2000, etaMs: TOOL_ETA_MS[toolName] });
+            }, { tool: toolName, args, maxSyncMs: 2000, etaMs: TOOL_ETA_MS[toolName] });
             if ('queued' in gated && gated.queued) {
                 // Persist orchestration run record for durable stage tracking
                 if (toolName === 'nexus_orchestrate') {

package/dist/agents/adapters/mcp/handlers/runtime.js

@@ -4,10 +4,11 @@
  * federation_status, run_status.
  * Extracted from mcp.ts (Phase 3 split).
  */
-import { formatBullets, formatJsonDetails, } from '../helpers.js';
+import { formatBullets, formatJsonDetails, buildAutoMemorySummary, } from '../helpers.js';
 import { nexusEventBus } from '../../../../engines/event-bus.js';
 import { getSharedLicenseManager, snapshotPCU, formatPCUStatus } from '../../../../licensing/index.js';
 import { TokenAnalyticsEngine } from '../../../../engines/token-analytics.js';
+import * as path from 'path';
 import { requireRuntime } from '../util/require-runtime.js';
 import { getAsyncGate } from '../async-gate.js';
 import { getRun as getOrchRun } from '../../../../engines/orchestrator/store.js';
@@ -231,6 +232,37 @@ export async function handleRuntimeGroup(toolName, hctx, request, args, ctx) {
             // Check async gate first (fast in-memory jobs from withAsyncGate)
             const asyncJob = getAsyncGate().getJob(runId);
             if (asyncJob) {
+                if (!asyncJob.lifecycleReportedAt
+                    && (asyncJob.status === 'completed' || asyncJob.status === 'failed')) {
+                    if (asyncJob.status === 'completed') {
+                        hctx.telemetry.observeSuccessfulToolCall(asyncJob.tool, asyncJob.args ?? {});
+                    }
+                    const shouldPersistSuccess = [
+                        'nexus_orchestrate',
+                        'nexus_plan_execution',
+                        'nexus_session_dna',
+                        'nexus_ghost_pass',
+                        'nexus_mindkit_check',
+                    ].includes(asyncJob.tool);
+                    try {
+                        if (asyncJob.tool !== 'nexus_store_memory' && (asyncJob.status === 'failed' || shouldPersistSuccess)) {
+                            const workspace = hctx.getWorkspace(asyncJob.args ?? {});
+                            const repoName = workspace.repoName || path.basename(workspace.repoRoot || '');
+                            const summary = asyncJob.status === 'completed'
+                                ? `MCP ${asyncJob.tool} completed asynchronously. ${buildAutoMemorySummary(asyncJob.tool, asyncJob.args ?? {})}`
+                                : `MCP ${asyncJob.tool} failed asynchronously: ${asyncJob.error ?? 'unknown failure'}. ${buildAutoMemorySummary(asyncJob.tool, asyncJob.args ?? {})}`;
+                            hctx.nexusRef.storeMemory(summary.slice(0, 1200), asyncJob.status === 'completed' ? 0.55 : 0.72, [
+                                '#mcp-result',
+                                '#auto',
+                                `#tool:${asyncJob.tool}`,
+                                ...(repoName ? [`repo:${repoName}`, `#repo:${repoName}`] : []),
+                                ...(asyncJob.status === 'completed' ? ['#workspace'] : ['#failure-mode', '#runtime-result', '#inbox']),
+                            ]);
+                        }
+                    }
+                    catch { /* best-effort lifecycle memory */ }
+                    getAsyncGate().markLifecycleReported(runId);
+                }
                 if (fmt === 'nxl')
                     return nxlResult(asyncJob);
                 return getAsyncGate().formatStatus(runId);

package/dist/agents/adapters/mcp/runHandler.d.ts

@@ -7,7 +7,7 @@
  *   3. Transient retries   — SQLite-busy / cold runtime → one retry with backoff.
  *
  * Per-client timeouts (AI Lead refinement):
- *   Codex 90 s · Claude Code 60 s · Cursor 30 s · default 25 s
+ *   Codex 90 s · Claude Code 60 s · Cursor 30 s · MCP clients 60 s · default 60 s
  *
  * Types and `envelopeToMcpResponse` are canonical in ./envelope.ts;
  * re-exported from here for backward compatibility.
@@ -16,6 +16,7 @@ import type { RunHandlerOptions } from './envelope.js';
 import type { HandlerEnvelope } from './envelope.js';
 export type { HandlerErrorCode, HandlerEnvelope, RunHandlerOptions } from './envelope.js';
 export { envelopeToMcpResponse } from './envelope.js';
+export declare function resolveHandlerTimeoutForTest(opts?: RunHandlerOptions): number;
 /**
  * Run a handler function with timeout, retry, and structured envelope.
  *

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

@@ -7,7 +7,7 @@
  *   3. Transient retries   — SQLite-busy / cold runtime → one retry with backoff.
  *
  * Per-client timeouts (AI Lead refinement):
- *   Codex 90 s · Claude Code 60 s · Cursor 30 s · default 25 s
+ *   Codex 90 s · Claude Code 60 s · Cursor 30 s · MCP clients 60 s · default 60 s
  *
  * Types and `envelopeToMcpResponse` are canonical in ./envelope.ts;
  * re-exported from here for backward compatibility.
@@ -20,16 +20,25 @@ const CLIENT_TIMEOUTS = {
     'codex': 90_000,
     'claude-code': 60_000,
     'cursor': 30_000,
+    'openclaw': 90_000,
+    'opencode': 90_000,
+    'windsurf': 90_000,
+    'antigravity': 90_000,
+    'mcp': 60_000,
 };
-const DEFAULT_TIMEOUT = 25_000;
+const DEFAULT_TIMEOUT = 60_000;
 function resolveTimeout(opts) {
     if (opts.timeoutMs !== undefined)
         return opts.timeoutMs;
-    if (opts.callerName && opts.callerName in CLIENT_TIMEOUTS) {
-        return CLIENT_TIMEOUTS[opts.callerName];
+    const callerName = String(opts.callerName ?? '').trim().toLowerCase();
+    if (callerName && callerName in CLIENT_TIMEOUTS) {
+        return CLIENT_TIMEOUTS[callerName];
     }
     return DEFAULT_TIMEOUT;
 }
+export function resolveHandlerTimeoutForTest(opts = {}) {
+    return resolveTimeout(opts);
+}
 // ─── Error classification ─────────────────────────────────────────────────────
 function classifyError(err) {
     const msg = err instanceof Error ? err.message : String(err);

package/dist/agents/adapters/mcp.d.ts

@@ -59,6 +59,8 @@ export declare class MCPAdapter implements Adapter {
         }>;
     }>;
     private executeToolRequest;
+    private parseAsyncReceipt;
+    private maybeStoreToolOutcomeMemory;
     private buildHandlerCtx;
     private handleToolCall;
     /**

package/dist/agents/adapters/mcp.js

@@ -818,6 +818,7 @@ export class MCPAdapter {
         const result = envelopeToMcpResponse(envelope);
         const durationMs = Date.now() - startTimeMs;
         const resultPreview = envelope.ok ? buildResultPreview(result) : null;
+        const asyncReceipt = envelope.ok ? this.parseAsyncReceipt(result) : null;
         nexusEventBus.emit('mcp.call.complete', {
             callId,
             serverName: 'nexus-prime',
@@ -830,27 +831,71 @@ export class MCPAdapter {
                 ? { result: resultPreview }
                 : { error: envelope.error.message }),
         });
-        this.telemetry.observeSuccessfulToolCall(toolName, args);
-        // Surface meaningful tool calls on the SSE feed without persisting them as memories.
-        // Previously a low-priority memory was auto-stored on every non-read-only tool call,
-        // which polluted recall with audit-log entries like "nexus_store_memory: priority=0.85,
-        // tags=...". Recall now stays focused on user-stored knowledge.
-        if (this.nexusRef && !isReadOnlyMcpTool(toolName)) {
+        if (envelope.ok && !asyncReceipt?.queued) {
+            this.telemetry.observeSuccessfulToolCall(toolName, args);
+        }
+        // Surface meaningful tool calls on the SSE feed; persist only high-signal outcomes.
+        if (this.nexusRef) {
             const repoRoot = this.nexusRef.getWorkspaceContext?.()?.repoRoot ?? '';
             const repoName = repoRoot ? path.basename(repoRoot) : '';
-            try {
-                nexusEventBus.emit('memory.snapshot', {
-                    kind: 'tool-invocation',
-                    toolName,
-                    repo: repoName,
-                    summary: buildAutoMemorySummary(toolName, args),
-                });
+            if (!isReadOnlyMcpTool(toolName)) {
+                try {
+                    nexusEventBus.emit('memory.snapshot', {
+                        kind: 'tool-invocation',
+                        toolName,
+                        repo: repoName,
+                        summary: buildAutoMemorySummary(toolName, args),
+                    });
+                }
+                catch { /* best-effort */ }
             }
-            catch { /* best-effort */ }
+            this.maybeStoreToolOutcomeMemory(toolName, args, envelope, durationMs, repoName, asyncReceipt);
         }
         const decorated = this.decorateLifecycleResponse(toolName, result);
         return this.injectMemoryContext(toolName, args, decorated);
     }
+    parseAsyncReceipt(result) {
+        const text = result.content?.[0]?.text;
+        if (!text)
+            return null;
+        try {
+            const parsed = JSON.parse(String(text).split('\n\n')[0] ?? '{}');
+            return parsed && typeof parsed === 'object' && parsed.queued === true ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    maybeStoreToolOutcomeMemory(toolName, args, envelope, durationMs, repoName, asyncReceipt) {
+        if (!this.nexusRef || toolName === 'nexus_store_memory')
+            return;
+        if (asyncReceipt?.queued)
+            return;
+        const shouldPersistSuccess = [
+            'nexus_orchestrate',
+            'nexus_plan_execution',
+            'nexus_session_dna',
+            'nexus_ghost_pass',
+            'nexus_mindkit_check',
+        ].includes(toolName);
+        if (envelope.ok && !shouldPersistSuccess)
+            return;
+        const error = envelope.error;
+        const summary = envelope.ok
+            ? `MCP ${toolName} completed in ${durationMs}ms. ${buildAutoMemorySummary(toolName, args)}`
+            : `MCP ${toolName} failed after ${durationMs}ms: ${error?.code ?? 'error'} ${error?.message ?? 'unknown failure'}. ${buildAutoMemorySummary(toolName, args)}`;
+        const tags = [
+            '#mcp-result',
+            '#auto',
+            `#tool:${toolName}`,
+            ...(repoName ? [`repo:${repoName}`, `#repo:${repoName}`] : []),
+            ...(envelope.ok ? ['#workspace'] : ['#failure-mode', '#runtime-result', '#inbox']),
+        ];
+        try {
+            this.nexusRef.storeMemory(summary.slice(0, 1200), envelope.ok ? 0.55 : 0.72, tags);
+        }
+        catch { /* best-effort */ }
+    }
     buildHandlerCtx(args = {}) {
         // eslint-disable-next-line @typescript-eslint/no-this-alias
         const self = this;

package/dist/dashboard/app/main.js

@@ -27,6 +27,24 @@ import { mount as mountRuntimeBadges } from './widgets/runtime-badge.js';
 
 const $ = id => document.getElementById(id);
 const esc = s => s==null?'':String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
+let memoryReloadTimer = null;
+
+function _memoryApiUrl() {
+    return S.workspace?.repoName ? '/api/memory?repo='+encodeURIComponent(S.workspace.repoName) : '/api/memory';
+}
+
+function _refreshMemorySoon() {
+    bustCache(_memoryApiUrl());
+    bustCache('/api/memory');
+    bustCache('/api/memory/health');
+    bustCache('/api/dashboard/surface/memory');
+    if (S.tab !== 'memory') return;
+    clearTimeout(memoryReloadTimer);
+    memoryReloadTimer = setTimeout(() => {
+        memoryReloadTimer = null;
+        Memory.load();
+    }, 150);
+}
 
 /* ─────────────────── Router ─────────────────── */
 navRegister('board',      Board.load);
@@ -53,15 +71,19 @@ setOnEvent(evt => {
         Board.render();
         _renderTicker();
     }
-    // Refresh tool health tile on any tool invocation event (board always refreshes)
-    if (String(evt.type||'') === 'tool.invocation' && tab === 'board') {
-        Board.loadToolHealth();
+    // Refresh tool health tile on tool lifecycle events.
+    if (['tool.invocation', 'mcp.handler.complete', 'mcp.handler.failed'].includes(String(evt.type||''))) {
+        bustCache('/api/runtime/tool-health');
+        bustCache('/api/dashboard/surface/operate');
+        if (tab === 'board') {
+            Board.loadToolHealth();
+        }
     }
     if (tab === 'workforce' && ['synapse','operative','mission'].includes(evt.category)) {
         Workforce.render();
     }
     if (tab === 'memory' && evt.category === 'memory') {
-        Memory.render();
+        _refreshMemorySoon();
     }
     if (tab === 'governance' && evt.category === 'darwin') {
         Governance.load();

package/dist/dashboard/server.d.ts

@@ -64,6 +64,8 @@ export declare class DashboardServer {
     private readJsonIfExists;
     private fileExists;
     private collectUsageSnapshot;
+    private normalizeDashboardRepoToken;
+    private dashboardMemoryMatchesRepoName;
     private listDashboardMemories;
     private listCrossProjectMemories;
     private listCrossProjectProjects;

package/dist/dashboard/server.js

@@ -762,6 +762,35 @@ export class DashboardServer {
             latestRun: null,
         };
     }
+    normalizeDashboardRepoToken(value) {
+        return String(value ?? '').trim().replace(/^#/, '').toLowerCase();
+    }
+    dashboardMemoryMatchesRepoName(memory, repoName) {
+        const expected = this.normalizeDashboardRepoToken(repoName);
+        if (!expected)
+            return true;
+        const tags = Array.isArray(memory.tags) ? memory.tags : [];
+        const provenance = memory.provenance ?? {};
+        const candidates = [
+            ...tags,
+            ...(Array.isArray(provenance.tags) ? provenance.tags : []),
+            ...(Array.isArray(provenance.containerTags) ? provenance.containerTags : []),
+            provenance.repoName,
+            provenance.repoId,
+            provenance.workspaceId,
+            provenance.projectId,
+        ];
+        return candidates.some((candidate) => {
+            const token = this.normalizeDashboardRepoToken(candidate);
+            if (!token)
+                return false;
+            if (token === expected)
+                return true;
+            if (token === `repo:${expected}`)
+                return true;
+            return token.startsWith('repo:') && token.slice(5) === expected;
+        });
+    }
     listDashboardMemories(options = {}) {
         const limit = Math.max(1, Number(options.limit || 40));
         const raw = this.getMemory()?.listSnapshots(Math.min(limit * 3, 200), {
@@ -769,21 +798,20 @@ export class DashboardServer {
             tag: options.tag,
             linkedType: options.linkedType,
             recencyMs: options.recencyMs,
+            state: options.includeHidden || options.lane === 'inbox' ? undefined : 'active',
             lane: options.lane,
             repoId: options.repoId,
             workspaceId: options.workspaceId,
             projectId: options.projectId,
             includeHidden: options.includeHidden,
         }) ?? [];
-        return raw
+        const visible = raw
             .filter((memory) => {
             const tags = Array.isArray(memory.tags) ? memory.tags : [];
             if (!options.includeHidden && tags.includes('#system-hidden'))
                 return false;
             if (!options.includeHidden && tags.includes('#auto') && Number(memory.priority ?? 0) < 0.4)
                 return false;
-            if (options.repoName && !tags.some((t) => t === `repo:${options.repoName}`))
-                return false;
             if (tags.includes('#quarantine') && options.lane !== 'inbox')
                 return false;
             if (!options.showPhantom && (tags.includes('#phantom-learning') || tags.includes('#swarm')))
@@ -793,8 +821,11 @@ export class DashboardServer {
             if (!options.includeHidden && (tags.includes('#hidden') || tags.includes('#repo-profile') || tags.includes('#system-hidden')))
                 return false;
             return true;
-        })
-            .slice(0, limit);
+        });
+        const scoped = options.repoName
+            ? visible.filter((memory) => this.dashboardMemoryMatchesRepoName(memory, options.repoName))
+            : visible;
+        return (options.repoName && scoped.length === 0 ? visible : scoped).slice(0, limit);
     }
     listCrossProjectMemories(options) {
         const memory = this.getMemory();

package/dist/index.d.ts

@@ -281,3 +281,10 @@ export declare class NexusPrime {
     private getDefaultCapabilities;
 }
 export declare const createNexusPrime: (config?: Partial<NexusConfig>) => NexusPrime;
+export { GhostPass, PhantomOrchestrator, PhantomWorker } from './phantom/index.js';
+export type { GhostReport, WorkerTask, WorkerResult, MergeDecision } from './phantom/index.js';
+export { MemoryEngine, createMemoryEngine } from './engines/memory.js';
+export { SessionDNAManager } from './engines/session-dna.js';
+export type { SessionDNA } from './engines/session-dna.js';
+export { GithubBridge, getSharedGithubBridge } from './engines/github-bridge.js';
+export type { GithubPromotionInput, GithubPromotionResult } from './engines/github-bridge.js';

package/dist/index.js

@@ -1193,3 +1193,8 @@ function detectCurrentClient() {
     }
     return null;
 }
+// Public API surface for sibling packages (e.g., @nexus-prime/finishit)
+export { GhostPass, PhantomOrchestrator, PhantomWorker } from './phantom/index.js';
+export { MemoryEngine, createMemoryEngine } from './engines/memory.js';
+export { SessionDNAManager } from './engines/session-dna.js';
+export { GithubBridge, getSharedGithubBridge } from './engines/github-bridge.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-prime",
-  "version": "7.9.0",
+  "version": "7.9.1",
   "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",