nexus-agents 2.105.0 → 2.106.0

package/dist/{child-mcp-config-XOIMNU6R.js → child-mcp-config-KP2XBOIB.js}

@@ -1,6 +1,6 @@
 import {
   createLogger
-} from "./chunk-WDVUKSIQ.js";
+} from "./chunk-2DHISFDY.js";
 import "./chunk-CH7QIDHQ.js";
 import "./chunk-PR4QN5HX.js";
 
@@ -59,4 +59,4 @@ export {
   generateMcpConfig,
   getDefaultAllowedTools
 };
-//# sourceMappingURL=child-mcp-config-XOIMNU6R.js.map
+//# sourceMappingURL=child-mcp-config-KP2XBOIB.js.map

package/dist/{chunk-WDVUKSIQ.js → chunk-2DHISFDY.js}

@@ -4151,6 +4151,25 @@ function estimateTokens(text) {
   return getTokenEstimator().estimateText(text);
 }
 
+// src/cli-adapters/types-core.ts
+function apiArmId(vendor) {
+  return `api:${vendor}`;
+}
+function routingArmDisplaySlot(armId) {
+  switch (armId) {
+    case "api:anthropic":
+      return "claude";
+    case "api:openai":
+      return "codex";
+    case "api:google":
+      return "gemini";
+    case "api:custom-openai":
+      return "opencode";
+    default:
+      return armId;
+  }
+}
+
 // src/cli-adapters/types-capability.ts
 var CLI_VERSION_REQUIREMENTS = {
   claude: {
@@ -4536,13 +4555,14 @@ var BudgetRouter = class {
   }
   selectAdapterWithinBudget(budget, estimatedTokens) {
     const sortedAdapters = [...this.adapters].sort((a, b) => {
-      const capA = DEFAULT_CAPABILITIES[a[0]];
-      const capB = DEFAULT_CAPABILITIES[b[0]];
+      const capA = DEFAULT_CAPABILITIES[routingArmDisplaySlot(a[0])];
+      const capB = DEFAULT_CAPABILITIES[routingArmDisplaySlot(b[0])];
       return capB.cost - capA.cost;
     });
     for (const [name, adapter] of sortedAdapters) {
-      const estimatedCost = estimateCost(name, estimatedTokens / 2, estimatedTokens / 2);
-      const caps = DEFAULT_CAPABILITIES[name];
+      const slot = routingArmDisplaySlot(name);
+      const estimatedCost = estimateCost(slot, estimatedTokens / 2, estimatedTokens / 2);
+      const caps = DEFAULT_CAPABILITIES[slot];
       const withinTokenBudget = budget.maxTokens === void 0 || estimatedTokens <= budget.maxTokens;
       const withinCostBudget = budget.maxCostUsd === void 0 || estimatedCost <= budget.maxCostUsd;
       const withinContextWindow = estimatedTokens <= caps.contextWindow;
@@ -8835,7 +8855,7 @@ function filterByPreferenceTier(candidates, tier) {
   const strongModels = ["claude"];
   const weakModels = ["gemini", "codex"];
   const preferred = tier === "strong" ? strongModels : weakModels;
-  const filtered = candidates.filter((c) => preferred.includes(c));
+  const filtered = candidates.filter((c) => preferred.includes(routingArmDisplaySlot(c)));
   return filtered.length > 0 ? filtered : candidates;
 }
 function cliTaskToTask(cliTask) {
@@ -8914,7 +8934,8 @@ function adjustProfileWithStageScores(profiles, stageScores) {
   });
 }
 function buildAdjustedProfiles(taskProfile, candidates, options) {
-  const profiles = DEFAULT_MODEL_PROFILES.filter((p) => candidates.includes(p.cliName));
+  const candidateSlots = new Set(candidates.map(routingArmDisplaySlot));
+  const profiles = DEFAULT_MODEL_PROFILES.filter((p) => candidateSlots.has(p.cliName));
   let adjusted = profiles.map((p) => adjustProfileForTask(p, taskProfile));
   if (options?.stageScores !== void 0 && options.stageScores.size > 0) {
     adjusted = adjustProfileWithStageScores(adjusted, options.stageScores);
@@ -8933,10 +8954,12 @@ function applyTopsisRanking(taskProfile, candidates, topsisRouter, options) {
   const adjustedProfiles = buildAdjustedProfiles(taskProfile, candidates, options);
   const result = router.selectModel({ profiles: adjustedProfiles });
   const scoreMap = new Map(result.scores.map((s) => [s.cliName, s.closenessScore]));
-  const ranking = [...candidates].sort((a, b) => (scoreMap.get(b) ?? 0) - (scoreMap.get(a) ?? 0));
-  const topScore = scoreMap.get(ranking[0] ?? "claude") ?? 1;
+  const scoreOf = (arm) => scoreMap.get(routingArmDisplaySlot(arm)) ?? 0;
+  const ranking = [...candidates].sort((a, b) => scoreOf(b) - scoreOf(a));
+  const topArm = ranking[0];
+  const topScore = topArm !== void 0 ? scoreOf(topArm) : 1;
   const threshold = topScore * (1 - TOPSIS_TOLERANCE_BAND_PERCENT);
-  const toleranceBandSize = ranking.filter((c) => (scoreMap.get(c) ?? 0) >= threshold).length;
+  const toleranceBandSize = ranking.filter((c) => scoreOf(c) >= threshold).length;
   return { ranking, topScore, toleranceBandSize };
 }
 function defaultPreferenceStageResult(candidates) {
@@ -8961,8 +8984,8 @@ function filterByDifficultyTier(candidates, tier) {
   };
   const preferred = tierPreferences[tier];
   const sortedCandidates = [...candidates].sort((a, b) => {
-    const aIndex = preferred.indexOf(a);
-    const bIndex = preferred.indexOf(b);
+    const aIndex = preferred.indexOf(routingArmDisplaySlot(a));
+    const bIndex = preferred.indexOf(routingArmDisplaySlot(b));
     const aPos = aIndex === -1 ? preferred.length : aIndex;
     const bPos = bIndex === -1 ? preferred.length : bIndex;
     return aPos - bPos;
@@ -8973,7 +8996,7 @@ function applyZeroRouterFilter(task, candidates, zeroRouter) {
   if (zeroRouter === void 0 || candidates.length === 0) {
     return defaultZeroRouterStageResult(candidates);
   }
-  const decision = zeroRouter.routeByDifficulty(task, candidates);
+  const decision = zeroRouter.routeByDifficulty(task, candidates.map(routingArmDisplaySlot));
   const difficultyEstimate = decision.difficulty;
   const difficultyTier = decision.tier;
   const filteredCandidates = filterByDifficultyTier(candidates, difficultyTier);
@@ -10606,6 +10629,13 @@ function getFallbackChainForCategory(category, bucketType, registry = DEFAULT_FA
 // src/cli-adapters/composite-router-stages.ts
 var logger9 = createLogger({ component: "composite-router-stages" });
 var sharedAnalyzer2 = createSharedTaskAnalyzer();
+function armsToSlots(candidates) {
+  return [...new Set(candidates.map(routingArmDisplaySlot))];
+}
+function keepArmsForSlots(candidates, survivingSlots) {
+  const slotSet = new Set(survivingSlots);
+  return candidates.filter((arm) => slotSet.has(routingArmDisplaySlot(arm)));
+}
 function analyzeTaskProfile(task, stagesExecuted) {
   const internalTask = cliTaskToTask(task);
   const analysis = sharedAnalyzer2.analyze(internalTask);
@@ -10666,7 +10696,7 @@ async function runConfidenceCascadeStage(task, candidates, stagesExecuted, deps)
   if (!deps.config.enableConfidenceCascade || deps.confidenceCascadeStage === void 0) {
     return DEFAULT_CASCADE_RESULT;
   }
-  const ctx = createRoutingContext(task.content, candidates);
+  const ctx = createRoutingContext(task.content, armsToSlots(candidates));
   const result = await deps.confidenceCascadeStage.route(ctx);
   stagesExecuted.push("confidence-cascade");
   if (!result.ok) {
@@ -10692,7 +10722,7 @@ async function runCapabilityMatchStage(task, candidates, stagesExecuted, deps) {
   if (!deps.config.enableCapabilityMatch || deps.capabilityMatchStage === void 0) {
     return DEFAULT_CAPABILITY_RESULT;
   }
-  const ctx = createRoutingContext(task.content, candidates);
+  const ctx = createRoutingContext(task.content, armsToSlots(candidates));
   const result = await deps.capabilityMatchStage.route(ctx);
   stagesExecuted.push("capability-match");
   if (!result.ok) {
@@ -10713,7 +10743,7 @@ async function runQualityConstraintStage(candidates, stagesExecuted, deps) {
   if (!deps.config.enableQualityConstraint || deps.qualityConstraintStage === void 0) {
     return { eligible: candidates, filtered: /* @__PURE__ */ new Map(), usedFallback: false };
   }
-  const ctx = createRoutingContext("", candidates);
+  const ctx = createRoutingContext("", armsToSlots(candidates));
   const result = await deps.qualityConstraintStage.route(ctx);
   stagesExecuted.push("quality-constraint");
   if (!result.ok) {
@@ -10728,7 +10758,7 @@ async function runQualityConstraintStage(candidates, stagesExecuted, deps) {
     filtered: filtered.size,
     usedFallback
   });
-  const eligible = remaining.length > 0 ? remaining : candidates;
+  const eligible = remaining.length > 0 ? keepArmsForSlots(candidates, remaining) : candidates;
   return { eligible, filtered, usedFallback: remaining.length === 0 || usedFallback };
 }
 var DEFAULT_RESOURCE_RESULT = {
@@ -10740,7 +10770,7 @@ async function runResourceStrategyStage(task, candidates, stagesExecuted, deps)
   if (!deps.config.enableResourceStrategy || deps.resourceStrategyStage === void 0) {
     return DEFAULT_RESOURCE_RESULT;
   }
-  const ctx = createRoutingContext(task.content, candidates);
+  const ctx = createRoutingContext(task.content, armsToSlots(candidates));
   const result = await deps.resourceStrategyStage.route(ctx);
   stagesExecuted.push("resource-strategy");
   if (!result.ok) {
@@ -10756,7 +10786,7 @@ async function runDistilledRuleStage(task, candidates, stagesExecuted, deps) {
   if (!deps.config.enableStrategyDistillation || deps.distilledRuleStage === void 0) {
     return { scores: /* @__PURE__ */ new Map(), rulesApplied: 0 };
   }
-  const ctx = createRoutingContext(task.content, candidates);
+  const ctx = createRoutingContext(task.content, armsToSlots(candidates));
   const result = await deps.distilledRuleStage.route(ctx);
   stagesExecuted.push("distilled-rule");
   if (!result.ok) {
@@ -10772,7 +10802,7 @@ async function runKnnRoutingStage(task, candidates, stagesExecuted, deps) {
   if (!deps.config.enableKnnRouting || deps.knnRoutingStage === void 0) {
     return { scores: /* @__PURE__ */ new Map(), hasExperience: false };
   }
-  const ctx = createRoutingContext(task.content, candidates);
+  const ctx = createRoutingContext(task.content, armsToSlots(candidates));
   const result = await deps.knnRoutingStage.route(ctx);
   stagesExecuted.push("knn-routing");
   if (!result.ok) {
@@ -10871,14 +10901,12 @@ function runLatencyStage(candidates, stagesExecuted, deps) {
   if (!deps.config.enableLatencyTracking || deps.latencyTracker === void 0) {
     return { latencyScore: void 0, latencyAdjustedRanking: candidates };
   }
-  const scores = deps.latencyTracker.getScores(candidates);
+  const scores = deps.latencyTracker.getScores(armsToSlots(candidates));
   stagesExecuted.push("latency-scoring");
-  const sortedCandidates = [...candidates].sort((a, b) => {
-    const scoreA = scores.find((s) => s.cli === a)?.score ?? 0;
-    const scoreB = scores.find((s) => s.cli === b)?.score ?? 0;
-    return scoreB - scoreA;
-  });
-  const topScore = scores.find((s) => s.cli === sortedCandidates[0])?.score;
+  const scoreOf = (arm) => scores.find((s) => s.cli === routingArmDisplaySlot(arm))?.score ?? 0;
+  const sortedCandidates = [...candidates].sort((a, b) => scoreOf(b) - scoreOf(a));
+  const topArm = sortedCandidates[0];
+  const topScore = topArm !== void 0 ? scores.find((s) => s.cli === routingArmDisplaySlot(topArm))?.score : void 0;
   deps.logger.debug("Latency scoring applied", {
     scores: scores.map((s) => ({
       cli: s.cli,
@@ -10899,7 +10927,7 @@ function runRoutingMemoryStage(task, candidates, stagesExecuted, deps) {
   const taskType = inferTaskTypeFromContent(task.content);
   const recommendation = deps.routingMemory.getRecommendation(taskType);
   stagesExecuted.push("routing-memory");
-  if (recommendation !== void 0 && candidates.includes(recommendation)) {
+  if (recommendation !== void 0 && armsToSlots(candidates).includes(recommendation)) {
     deps.logger.debug("Routing memory recommendation", {
       taskType,
       recommended: recommendation,
@@ -10970,7 +10998,7 @@ function aggregateStageScores(scoring, taskContent, candidates) {
     scoring.distilledResult.scores,
     scoring.resourceResult.scores,
     weatherScores,
-    getTuneAdjustmentScores(candidates)
+    getTuneAdjustmentScores(armsToSlots([...candidates]))
   );
 }
 var TUNE_ENFORCE_ENV = "NEXUS_TUNE_ENFORCE";
@@ -11012,8 +11040,9 @@ function applyCategoryOverride(task, candidates, stagesExecuted) {
   if (match === null) return ok(candidates);
   const override = CATEGORY_CHAIN_OVERRIDES[match.category];
   if (override === void 0) return ok(candidates);
-  const candidateSet = new Set(candidates);
-  const filtered = override.filter((cli) => candidateSet.has(cli));
+  const overrideSet = new Set(override);
+  const orderIndex = (arm) => override.indexOf(routingArmDisplaySlot(arm));
+  const filtered = candidates.filter((arm) => overrideSet.has(routingArmDisplaySlot(arm))).sort((a, b) => orderIndex(a) - orderIndex(b));
   if (filtered.length === 0) {
     if (isCategoryFailClosed(match.category)) {
       stagesExecuted.push("category-override:fail-closed");
@@ -11037,7 +11066,7 @@ function applyCategoryOverride(task, candidates, stagesExecuted) {
 }
 function applyLinUCBFloorOverride(linucbCli, topsisRanking, opts) {
   if (opts.perfData === void 0) return linucbCli;
-  const cliPerf = opts.perfData.get(linucbCli);
+  const cliPerf = opts.perfData.get(routingArmDisplaySlot(linucbCli));
   if (cliPerf === void 0 || cliPerf.sampleCount < 20 || cliPerf.successRate >= 0.5) {
     return linucbCli;
   }
@@ -11475,7 +11504,9 @@ function recordZeroRouterOutcome(task, success, qualityScore, deps) {
   const outcome = buildDifficultyOutcome(
     task.content,
     difficulty,
-    selectedCli,
+    // Difficulty calibration is slot-level; collapse an api:* arm to its
+    // display slot here (the bandit retains the distinct arm). (#3422)
+    routingArmDisplaySlot(selectedCli),
     success,
     qualityScore
   );
@@ -11531,11 +11562,12 @@ function computeQualityReward(cli, success, durationMs2) {
 // src/cli-adapters/composite-router-metrics.ts
 function recordDecisionToMetrics(decision, traceId, deps) {
   if (deps.metricsCollector === void 0) return;
+  const selectedModel = routingArmDisplaySlot(decision.cliName);
   deps.metricsCollector.recordDecision({
     timestamp: getTimeProvider().nowIso(),
     traceId,
-    selectedModel: decision.cliName,
-    alternativeModels: decision.alternatives,
+    selectedModel,
+    alternativeModels: decision.alternatives.map(routingArmDisplaySlot),
     isExploration: decision.ucbScore !== void 0 && decision.ucbScore > 0.5,
     taskType: decision.taskProfile.taskType,
     contextTokens: decision.taskProfile.contextRequired,
@@ -11543,7 +11575,7 @@ function recordDecisionToMetrics(decision, traceId, deps) {
   });
   deps.logger.debug("Recorded routing decision to metrics", {
     traceId,
-    selectedModel: decision.cliName
+    selectedModel
   });
 }
 function recordOutcomeToMetrics(opts, deps) {
@@ -11729,7 +11761,9 @@ var CompositeRouter = class _CompositeRouter {
       type: "routing.decision",
       timestamp: getTimeProvider().now(),
       taskId: taskDescription.slice(0, 100),
-      selectedModel: decision.cliName,
+      // Trace attribution is slot-level; collapse the api:* arm (#3422) so this
+      // sink matches every other telemetry sink (the bandit keeps the arm).
+      selectedModel: routingArmDisplaySlot(decision.cliName),
       reasoning: decision.reason,
       decisionPath: decision.stagesExecuted
     });
@@ -11806,7 +11840,7 @@ var CompositeRouter = class _CompositeRouter {
    */
   async consultUnifiedContext(task) {
     try {
-      const { getContextForTask, inferTaskCategory } = await import("./context-retriever-J7DIPQUO.js");
+      const { getContextForTask, inferTaskCategory } = await import("./context-retriever-52RLYDVE.js");
       const ctx = await getContextForTask({
         task: task.content,
         category: inferTaskCategory(task.content),
@@ -11854,11 +11888,13 @@ var CompositeRouter = class _CompositeRouter {
     return executeResult;
   }
   autoRecordFeedback(decision, task, success, durationMs2) {
-    const reward = computeQualityReward(decision.cliName, success, durationMs2);
-    this.recordOutcome(decision.cliName, task, reward);
+    const arm = decision.cliName;
+    const slot = routingArmDisplaySlot(arm);
+    const reward = computeQualityReward(slot, success, durationMs2);
+    this.recordOutcome(arm, task, reward);
     this.recordDifficultyOutcome(task, success);
     if (this.latencyTracker !== void 0) {
-      this.latencyTracker.record(decision.cliName, durationMs2, success);
+      this.latencyTracker.record(slot, durationMs2, success);
     }
     if (this.routingMemory !== void 0) {
       const taskType = this.inferTaskType(task);
@@ -11869,13 +11905,13 @@ var CompositeRouter = class _CompositeRouter {
         avgTokens: task.maxTokens ?? DEFAULT_TOKEN_ESTIMATE,
         observations: 1
       };
-      this.routingMemory.storePreference(decision.cliName, taskType, performance2);
+      this.routingMemory.storePreference(slot, taskType, performance2);
     }
     if (this.lastTraceId !== void 0) {
       recordOutcomeToMetrics(
         {
           traceId: this.lastTraceId,
-          cliName: decision.cliName,
+          cliName: slot,
           success,
           reward,
           qualityScore: success ? decision.confidence : FAILURE_QUALITY_SCORE,
@@ -11885,7 +11921,7 @@ var CompositeRouter = class _CompositeRouter {
       );
     }
     this.logger.debug("Auto-recorded feedback", {
-      cli: decision.cliName,
+      cli: arm,
       success,
       durationMs: durationMs2,
       reward
@@ -11956,7 +11992,9 @@ var CompositeRouter = class _CompositeRouter {
       const all = await this.availableModelsCache.getAll();
       if (all.length === 0) return this.cliNames;
       const sourcesWithModels = new Set(all.map((m) => m.source));
-      const filtered = this.cliNames.filter((name) => sourcesWithModels.has(name));
+      const filtered = this.cliNames.filter(
+        (name) => sourcesWithModels.has(routingArmDisplaySlot(name))
+      );
       return filtered.length > 0 ? filtered : this.cliNames;
     } catch (e) {
       this.logger.warn("AvailableModelsCache query failed; falling back to all CLIs", {
@@ -12012,7 +12050,7 @@ var CompositeRouter = class _CompositeRouter {
     const decisionTimeMs = getTimeProvider().now() - params.startTime;
     this.updateStats(params.selectedCli, decisionTimeMs);
     const { confidence, reason, alternatives } = buildDecisionFields({ ...params, decisionTimeMs });
-    const model = isRouteModelSelectionEnabled() && params.difficultyTier !== void 0 ? resolveModelForTier(params.selectedCli, params.difficultyTier) : void 0;
+    const model = isRouteModelSelectionEnabled() && params.difficultyTier !== void 0 ? resolveModelForTier(routingArmDisplaySlot(params.selectedCli), params.difficultyTier) : void 0;
     return ok({
       adapter: selectedAdapter,
       cliName: params.selectedCli,
@@ -12035,7 +12073,7 @@ var CompositeRouter = class _CompositeRouter {
   }
   updateStats(selectedCli, decisionTimeMs) {
     this.totalDecisions++;
-    this.decisionsPerCli[selectedCli]++;
+    this.decisionsPerCli[routingArmDisplaySlot(selectedCli)]++;
     this.totalDecisionTimeMs += decisionTimeMs;
   }
   /**
@@ -12049,10 +12087,10 @@ var CompositeRouter = class _CompositeRouter {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       taskId: `task-${getRandomProvider().uuid()}`,
       taskDescription: task.content.length > 100 ? task.content.substring(0, 100) + "..." : task.content,
-      selectedCli: decision.cliName,
+      selectedCli: routingArmDisplaySlot(decision.cliName),
       confidence: decision.confidence,
       reason: decision.reason,
-      alternatives: decision.alternatives,
+      alternatives: decision.alternatives.map(routingArmDisplaySlot),
       stagesExecuted: decision.stagesExecuted,
       decisionTimeMs: decision.decisionTimeMs,
       withinBudget: decision.withinBudget,
@@ -13009,6 +13047,7 @@ export {
   getCliModelName,
   resolveCliAlias,
   buildCapabilityProfiles,
+  buildCliCapabilityProfiles,
   findCanonicalModel,
   buildModelInfo,
   getInTreeCapabilitiesMatrix,
@@ -13047,6 +13086,8 @@ export {
   getRandomProvider,
   getTokenEstimator,
   estimateTokens,
+  apiArmId,
+  routingArmDisplaySlot,
   CLI_VERSION_REQUIREMENTS,
   DEFAULT_CAPABILITIES,
   RoutingMemoryError,
@@ -13156,4 +13197,4 @@ export {
   ParseError,
   OrchestratorError
 };
-//# sourceMappingURL=chunk-WDVUKSIQ.js.map
+//# sourceMappingURL=chunk-2DHISFDY.js.map