nexus-agents 2.129.2 → 2.130.0

package/dist/{chunk-QJ52FRQX.js → chunk-L4ETHMN6.js}

@@ -4,7 +4,7 @@ import {
   getErrorMessage,
   getTimeProvider,
   ok
-} from "./chunk-VBAGMX5I.js";
+} from "./chunk-MII2DHXL.js";
 
 // src/context/session-memory.ts
 import * as fs from "fs";
@@ -351,4 +351,4 @@ export {
   SessionMemory,
   createSessionMemory
 };
-//# sourceMappingURL=chunk-QJ52FRQX.js.map
+//# sourceMappingURL=chunk-L4ETHMN6.js.map

package/dist/{chunk-U3FNIYWH.js → chunk-LICM3H4J.js}

@@ -8,7 +8,7 @@ import {
   getErrorMessage,
   ok,
   parseBoolEnv
-} from "./chunk-VBAGMX5I.js";
+} from "./chunk-MII2DHXL.js";
 
 // src/cli/research-helpers-io.ts
 import * as fs2 from "fs/promises";
@@ -146,4 +146,4 @@ export {
   loadPapersRegistry,
   savePapersRegistry
 };
-//# sourceMappingURL=chunk-U3FNIYWH.js.map
+//# sourceMappingURL=chunk-LICM3H4J.js.map

package/dist/{chunk-VBAGMX5I.js → chunk-MII2DHXL.js}

@@ -2330,7 +2330,7 @@ function setDefaultRegistry(registry) {
 }
 async function reloadDefaultRegistry() {
   globalRegistry = buildDefaultRegistry();
-  const { resetGlobalRegistry } = await import("./unified-registry-WMJQUA43.js");
+  const { resetGlobalRegistry } = await import("./unified-registry-WP4XC656.js");
   resetGlobalRegistry();
   return globalRegistry;
 }
@@ -12757,7 +12757,7 @@ var CompositeRouter = class _CompositeRouter {
    */
   async consultUnifiedContext(task) {
     try {
-      const { getContextForTask, inferTaskCategory } = await import("./context-retriever-OLWFVOJG.js");
+      const { getContextForTask, inferTaskCategory } = await import("./context-retriever-LVW25GWO.js");
       const ctx = await getContextForTask({
         task: task.content,
         category: inferTaskCategory(task.content),
@@ -13480,6 +13480,10 @@ var ExperienceMemoryImpl = class {
       (p) => p.successRate >= this.config.minExperienceSuccessRate && p.attemptCount >= 3
     );
   }
+  /** #3234: all recorded entries across task types — for the research-maturity measurement surface. */
+  getAllPatterns() {
+    return [...this.patterns.values()];
+  }
   getBestPattern(taskType, contextSignature) {
     let best = null;
     let bestScore = -1;
@@ -13726,6 +13730,96 @@ function defaultSharedDbPath() {
   return `${root}/memory/mobimem.db`;
 }
 
+// src/pipeline/research-context.ts
+var MAX_RENDERED_ITEMS = 8;
+function sanitizeExternal(value, maxLen = 160) {
+  const collapsed = value.replace(/`/g, "").replace(/[-]/g, " ").replace(/\s+/g, " ").trim();
+  return collapsed.length > maxLen ? `${collapsed.slice(0, maxLen - 1)}\u2026` : collapsed;
+}
+function buildResearchContextMetadata(discover, analyze) {
+  const discoveredItems = discover.items.map((item) => ({
+    title: item.title,
+    url: item.url,
+    ...item.relevanceScore !== void 0 ? { relevanceScore: item.relevanceScore } : {},
+    alreadyInRegistry: item.alreadyInRegistry
+  })).sort((a, b) => (b.relevanceScore ?? 0) - (a.relevanceScore ?? 0));
+  return {
+    discoveredItems,
+    recommendations: analyze?.recommendations ?? [],
+    qualitySignals: {
+      totalFound: discover.totalFound,
+      newItems: discover.newItems,
+      alreadyInRegistry: discover.alreadyInRegistry
+    }
+  };
+}
+function renderResearchText(metadata, topic) {
+  const { discoveredItems, recommendations, qualitySignals } = metadata;
+  const lines = [];
+  lines.push(`[Research] ${sanitizeExternal(topic, 120)}`);
+  lines.push(
+    `Maturity: ${String(qualitySignals.totalFound)} found, ${String(qualitySignals.newItems)} new, ${String(qualitySignals.alreadyInRegistry)} already in registry.`
+  );
+  if (discoveredItems.length > 0) {
+    lines.push("Top discoveries (by relevance):");
+    for (const item of discoveredItems.slice(0, MAX_RENDERED_ITEMS)) {
+      const score = item.relevanceScore !== void 0 ? item.relevanceScore.toFixed(2) : "n/a";
+      const known = item.alreadyInRegistry ? " [in registry]" : "";
+      lines.push(`- ${sanitizeExternal(item.title)} (relevance ${score})${known}`);
+    }
+  } else {
+    lines.push("Top discoveries (by relevance): none.");
+  }
+  if (recommendations.length > 0) {
+    lines.push("Gap recommendations:");
+    for (const rec of recommendations) lines.push(`- ${sanitizeExternal(rec)}`);
+  }
+  return lines.join("\n");
+}
+function buildResearchContext(discover, analyze, topic = discover.topic) {
+  const metadata = buildResearchContextMetadata(discover, analyze);
+  return { text: renderResearchText(metadata, topic), metadata };
+}
+var RESEARCH_MATURITY_SATURATION = 8;
+function deriveResearchMaturity(metadata) {
+  const found = metadata.qualitySignals.totalFound;
+  if (found <= 0) return 0;
+  return Math.min(1, found / RESEARCH_MATURITY_SATURATION);
+}
+function researchMaturityBucket(score) {
+  if (score <= 0) return "none";
+  return score < 0.5 ? "low" : "high";
+}
+function computeResearchMaturityReport(records) {
+  const acc = {
+    none: { count: 0, succ: 0, att: 0 },
+    low: { count: 0, succ: 0, att: 0 },
+    high: { count: 0, succ: 0, att: 0 }
+  };
+  for (const r of records) {
+    const b = acc[researchMaturityBucket(r.researchMaturity ?? 0)];
+    b.count += 1;
+    b.succ += r.successCount;
+    b.att += r.attemptCount;
+  }
+  const rate = (b) => b.att > 0 ? b.succ / b.att : 0;
+  const byBucket = {
+    none: { count: acc.none.count, attempts: acc.none.att, successRate: rate(acc.none) },
+    low: { count: acc.low.count, attempts: acc.low.att, successRate: rate(acc.low) },
+    high: { count: acc.high.count, attempts: acc.high.att, successRate: rate(acc.high) }
+  };
+  const delta = byBucket.high.count > 0 && byBucket.none.count > 0 ? byBucket.high.successRate - byBucket.none.successRate : 0;
+  return { byBucket, highVsNoneDelta: delta, totalRecords: records.length };
+}
+var EMPTY_RESEARCH_METADATA = {
+  discoveredItems: [],
+  recommendations: [],
+  qualitySignals: { totalFound: 0, newItems: 0, alreadyInRegistry: 0 }
+};
+function researchContextFromText(text) {
+  return { text, metadata: EMPTY_RESEARCH_METADATA };
+}
+
 // src/context/routing-memory.ts
 var DEFAULT_ROUTING_MEMORY_CONFIG = {
   minObservations: 5,
@@ -13816,15 +13910,13 @@ var RoutingMemory = class {
       durationMs: Math.floor(metrics2.durationMs / models.length),
       success
     }));
-    const outcome = metrics2.qualityScore !== void 0 ? {
-      success,
-      qualityScore: metrics2.qualityScore,
-      totalDurationMs: metrics2.durationMs,
-      tokensUsed: metrics2.tokensUsed
-    } : {
+    const outcome = {
       success,
       totalDurationMs: metrics2.durationMs,
-      tokensUsed: metrics2.tokensUsed
+      tokensUsed: metrics2.tokensUsed,
+      ...metrics2.qualityScore !== void 0 ? { qualityScore: metrics2.qualityScore } : {},
+      // #3234: record research-maturity for the measurement surface (#3815 gates use).
+      ...metrics2.researchMaturity !== void 0 ? { researchMaturity: metrics2.researchMaturity } : {}
     };
     this.mobimem.experience.recordExecution(workflow, actionSequence, outcome, contextSignature);
     this.logger.debug("Recorded routing experience", {
@@ -13838,6 +13930,20 @@ var RoutingMemory = class {
     const experiences = this.mobimem.experience.findPatterns(workflow);
     return experiences.filter((exp) => exp.successRate >= this.config.successRateThreshold).map((exp) => this.mapExperienceToPattern(exp));
   }
+  /**
+   * #3234 measurement surface: bucket ALL recorded experience by the run's
+   * research-maturity and report the attempt-weighted success rate per bucket.
+   * This is the read-only consumer of {@link ExecutionOutcome.researchMaturity} —
+   * it does NOT influence routing (live weighting is gated on a measured lift, #3815).
+   */
+  getResearchMaturityReport() {
+    const records = this.mobimem.experience.getAllPatterns().map((exp) => ({
+      successCount: exp.successCount,
+      attemptCount: exp.attemptCount,
+      researchMaturity: exp.outcome.researchMaturity
+    }));
+    return computeResearchMaturityReport(records);
+  }
   cacheAction(action, model, result, durationMs2) {
     const input = { actionSignature: action, model };
     this.mobimem.action.cache(input, result, durationMs2);
@@ -14104,6 +14210,9 @@ export {
   DEFAULT_ZERO_ROUTER_CONFIG,
   getSharedMobiMem,
   setSharedMobiMemDbPathResolver,
+  buildResearchContext,
+  deriveResearchMaturity,
+  researchContextFromText,
   DEFAULT_ROUTING_MEMORY_CONFIG,
   RoutingMemory,
   createRoutingMemory,
@@ -14143,4 +14252,4 @@ export {
   AgentCapability,
   OrchestratorError
 };
-//# sourceMappingURL=chunk-VBAGMX5I.js.map
+//# sourceMappingURL=chunk-MII2DHXL.js.map