nexus-agents 2.76.0 → 2.77.0

package/dist/{chunk-TMOGKDC2.js → chunk-CPPZCNAS.js}

@@ -89,6 +89,7 @@ import {
   getOutcomesFile
 } from "./chunk-I7ORMAO7.js";
 import {
+  getNexusDataDir,
   nexusDataPath
 } from "./chunk-GOT7OAL5.js";
 
@@ -159,6 +160,11 @@ async function withProgressHeartbeat(toolName, notifier, operation, intervalMs =
   }
 }
 
+// src/mcp/middleware/tool-wrapper.ts
+import { randomUUID } from "crypto";
+import { appendFileSync, existsSync, mkdirSync } from "fs";
+import { dirname, join } from "path";
+
 // src/mcp/middleware/rate-limiter.ts
 var DEFAULT_REFILL_INTERVAL_MS = CACHE_TIMEOUTS.rateLimitRefillMs;
 var RateLimiter = class {
@@ -1353,23 +1359,102 @@ function toSdkCallback(handler) {
   };
 }
 var MCP_SDK_DEFAULT_REQUEST_TIMEOUT_MS = 6e4;
+var TIMEOUT_MISMATCH_TELEMETRY_REL_PATH = "mcp-telemetry/timeout-mismatch-events.jsonl";
+function appendTimeoutMismatchEvent(event) {
+  try {
+    const path3 = join(getNexusDataDir(), TIMEOUT_MISMATCH_TELEMETRY_REL_PATH);
+    const dir = dirname(path3);
+    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+    appendFileSync(path3, JSON.stringify(event) + "\n", "utf-8");
+  } catch (err2) {
+    wrapperLogger.debug("Best-effort timeout-mismatch event recording failed", {
+      error: getErrorMessage(err2)
+    });
+  }
+}
+function extractErrorCategoryFromResult(result) {
+  const envelope = result._meta?.["nexus-agents/error"];
+  if (envelope !== null && typeof envelope === "object" && "errorCategory" in envelope) {
+    const cat = envelope.errorCategory;
+    if (typeof cat === "string") return cat;
+  }
+  return void 0;
+}
+function extractErrorMessageFromResult(result) {
+  const first = result.content[0];
+  if (first?.type === "text" && typeof first.text === "string") {
+    return first.text.slice(0, 500);
+  }
+  return void 0;
+}
+function buildMismatchEvent(ctx, eventId, t0, outcome) {
+  const t1 = Date.now();
+  return {
+    eventId,
+    toolName: ctx.toolName,
+    configuredTimeoutMs: ctx.configuredTimeoutMs,
+    mcpSdkDefaultMs: MCP_SDK_DEFAULT_REQUEST_TIMEOUT_MS,
+    startedAt: new Date(t0).toISOString(),
+    endedAt: new Date(t1).toISOString(),
+    durationMs: t1 - t0,
+    outcome: outcome.outcome,
+    ...outcome.errorCategory !== void 0 ? { errorCategory: outcome.errorCategory } : {},
+    ...outcome.errorMessage !== void 0 ? { errorMessage: outcome.errorMessage } : {}
+  };
+}
+function classifyResult(result) {
+  if (result.isError !== true) return { outcome: "success" };
+  const errorCategory = extractErrorCategoryFromResult(result);
+  const errorMessage = extractErrorMessageFromResult(result);
+  return {
+    outcome: "error",
+    ...errorCategory !== void 0 ? { errorCategory } : {},
+    ...errorMessage !== void 0 ? { errorMessage } : {}
+  };
+}
+async function runMismatchedCall(ctx) {
+  const eventId = randomUUID();
+  const t0 = Date.now();
+  ctx.log.warn(
+    "MCP tool budget exceeds client default and no progressToken received \u2014 request likely to be killed by client before server-side deadline",
+    {
+      tool: ctx.toolName,
+      eventId,
+      configuredTimeoutMs: ctx.configuredTimeoutMs,
+      mcpSdkDefaultMs: MCP_SDK_DEFAULT_REQUEST_TIMEOUT_MS,
+      remediation: "Client should pass `onprogress` and `resetTimeoutOnProgress: true` when calling, or extend `options.timeout`. See docs/architecture/MCP_PROTOCOL.md."
+    }
+  );
+  try {
+    const result = await runWithContexts(ctx.handler, ctx.args, ctx.progressCtx, ctx.signal);
+    appendTimeoutMismatchEvent(buildMismatchEvent(ctx, eventId, t0, classifyResult(result)));
+    return result;
+  } catch (err2) {
+    appendTimeoutMismatchEvent(
+      buildMismatchEvent(ctx, eventId, t0, {
+        outcome: "error",
+        errorMessage: getErrorMessage(err2).slice(0, 500)
+      })
+    );
+    throw err2;
+  }
+}
 function toSdkCallbackWithBudgetCheck(handler, toolName, configuredTimeoutMs, logger12) {
   const log = logger12 ?? wrapperLogger;
   return (args, extra) => {
     const progressCtx = extractProgressContext(extra);
     const signal = extra?.signal;
-    if (configuredTimeoutMs > MCP_SDK_DEFAULT_REQUEST_TIMEOUT_MS && progressCtx === void 0) {
-      log.warn(
-        "MCP tool budget exceeds client default and no progressToken received \u2014 request likely to be killed by client before server-side deadline",
-        {
-          tool: toolName,
-          configuredTimeoutMs,
-          mcpSdkDefaultMs: MCP_SDK_DEFAULT_REQUEST_TIMEOUT_MS,
-          remediation: "Client should pass `onprogress` and `resetTimeoutOnProgress: true` when calling, or extend `options.timeout`. See docs/architecture/MCP_PROTOCOL.md."
-        }
-      );
-    }
-    return runWithContexts(handler, args, progressCtx, signal);
+    const isMismatch = configuredTimeoutMs > MCP_SDK_DEFAULT_REQUEST_TIMEOUT_MS && progressCtx === void 0;
+    if (!isMismatch) return runWithContexts(handler, args, progressCtx, signal);
+    return runMismatchedCall({
+      log,
+      handler,
+      args,
+      progressCtx,
+      signal,
+      toolName,
+      configuredTimeoutMs
+    });
   };
 }
 
@@ -2739,7 +2824,7 @@ async function createAutoAdapter(config = {}) {
 }
 
 // src/agents/collaboration/event-bus-helpers.ts
-import { randomUUID } from "crypto";
+import { randomUUID as randomUUID2 } from "crypto";
 var DEFAULT_MAX_HISTORY_SIZE = 1e3;
 var MAX_SUBSCRIPTIONS = 500;
 var MAX_TOPIC_PATTERN_LENGTH = 200;
@@ -2760,10 +2845,10 @@ function topicMatchesPattern(topic, regex) {
   return regex.test(topic);
 }
 function generateEventId() {
-  return `evt-${String(getTimeProvider().now())}-${randomUUID().slice(0, 8)}`;
+  return `evt-${String(getTimeProvider().now())}-${randomUUID2().slice(0, 8)}`;
 }
 function generateSubscriptionId() {
-  return `sub-${String(getTimeProvider().now())}-${randomUUID().slice(0, 8)}`;
+  return `sub-${String(getTimeProvider().now())}-${randomUUID2().slice(0, 8)}`;
 }
 function applyHistoryFilters(history, filter) {
   let result = history;
@@ -8017,7 +8102,7 @@ var DEFAULT_BELIEF_CONFIG = {
 };
 
 // src/utils/id-utils.ts
-import { randomUUID as randomUUID2 } from "crypto";
+import { randomUUID as randomUUID3 } from "crypto";
 function generateId(prefix, randomLength = 8) {
   const timestamp = getTimeProvider().now().toString(36);
   const random = getRandomProvider().random().toString(36).substring(2, 2 + randomLength);
@@ -8029,7 +8114,7 @@ function generateHyphenId(prefix, randomLength = 6) {
   return `${prefix}-${timestamp}-${random}`;
 }
 function generateUUID() {
-  return randomUUID2();
+  return randomUUID3();
 }
 
 // src/context/belief-memory-helpers.ts
@@ -12195,7 +12280,7 @@ var ToolMemoryManager = class {
 };
 
 // src/orchestration/outcomes/outcome-store-persistence.ts
-import { appendFileSync, readFileSync as readFileSync3, writeFileSync as writeFileSync3, existsSync as existsSync3 } from "fs";
+import { appendFileSync as appendFileSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3, existsSync as existsSync4 } from "fs";
 var PersistentOutcomeStore = class extends OutcomeStore {
   filePath;
   logger;
@@ -12246,7 +12331,7 @@ var PersistentOutcomeStore = class extends OutcomeStore {
     }
   }
   hydrate() {
-    if (!existsSync3(this.filePath)) {
+    if (!existsSync4(this.filePath)) {
       this.logger.debug("No outcomes file found, starting fresh", {
         path: this.filePath
       });
@@ -12305,7 +12390,7 @@ var PersistentOutcomeStore = class extends OutcomeStore {
   }
   persistLine(outcome) {
     try {
-      appendFileSync(this.filePath, JSON.stringify(outcome) + "\n", "utf-8");
+      appendFileSync2(this.filePath, JSON.stringify(outcome) + "\n", "utf-8");
     } catch (error) {
       const msg = getErrorMessage(error);
       this.logger.warn("Failed to persist outcome to disk", {
@@ -13330,4 +13415,4 @@ export {
   CONSENSUS_VOTE_OUTPUT_SCHEMA,
   registerConsensusVoteTool
 };
-//# sourceMappingURL=chunk-TMOGKDC2.js.map
+//# sourceMappingURL=chunk-CPPZCNAS.js.map