@massa-ai/tools-api 1.10.0 → 1.12.0

package/dist/index.js

@@ -114859,122 +114859,6 @@ var init_search_diagnostics = __esm(() => {
   };
 });
 
-// ../../packages/core/dist/services/search/rlm-fusion.js
-function fuseResultsImpl(rlm, resultSets, query, explainScores = false) {
-  const scoreMap = new Map;
-  const hasCodePattern = (text2) => {
-    const codePatterns = [
-      /\w+\(\)/,
-      /\bfunction\b/i,
-      /\bclass\b/i,
-      /\binterface\b/i,
-      /\benum\b/i,
-      /\btype\b/i,
-      /\bconst\b/i,
-      /\bimport\b/i,
-      /\bexport\b/i
-    ];
-    return codePatterns.some((pattern) => pattern.test(text2));
-  };
-  const isCodeQuery = hasCodePattern(query);
-  const codeKeywordBoostRaw = Number(process.env.RRF_KEYWORD_BOOST ?? "2.5");
-  const codeKeywordBoost = Number.isFinite(codeKeywordBoostRaw) && codeKeywordBoostRaw > 0 ? codeKeywordBoostRaw : 2.5;
-  const KEYWORD_BOOST = isCodeQuery ? codeKeywordBoost : 1;
-  logger.debug("RRF fusion parameters", {
-    query,
-    isCodeQuery,
-    keywordBoost: KEYWORD_BOOST,
-    vectorResults: resultSets[0]?.length || 0,
-    keywordResults: resultSets[1]?.length || 0
-  });
-  for (let i = 0;i < resultSets.length; i++) {
-    const results = resultSets[i];
-    const isVector = i === 0;
-    const isMemoryStream = results.some((r2) => r2.source === "memory" || r2.metadata?.context?.graphNeighbor === true);
-    const boost = isVector ? 1 : isMemoryStream ? 1 : KEYWORD_BOOST;
-    results.forEach((result, rank) => {
-      const rrfScore = 1 / (rlm.RRF_K + rank + 1) * boost;
-      if (scoreMap.has(result.id)) {
-        const existing = scoreMap.get(result.id);
-        if (isVector) {
-          existing.vectorRrfScore += rrfScore;
-          existing.vectorRank = rank;
-          existing.vectorScore = result.score;
-        } else if (isMemoryStream) {
-          existing.memoryRrfScore += rrfScore;
-        } else {
-          existing.lexicalRrfScore = Math.max(existing.lexicalRrfScore, rrfScore);
-          if (existing.keywordRank === undefined || rank < existing.keywordRank) {
-            existing.keywordRank = rank;
-            existing.keywordScore = result.score;
-          }
-        }
-        existing.rrfScore = existing.vectorRrfScore + existing.lexicalRrfScore + existing.memoryRrfScore;
-      } else {
-        const vectorRrfScore = isVector ? rrfScore : 0;
-        const lexicalRrfScore = !isVector && !isMemoryStream ? rrfScore : 0;
-        const memoryRrfScore = isMemoryStream ? rrfScore : 0;
-        scoreMap.set(result.id, {
-          result: { ...result },
-          rrfScore: vectorRrfScore + lexicalRrfScore + memoryRrfScore,
-          vectorRrfScore,
-          lexicalRrfScore,
-          memoryRrfScore,
-          vectorRank: isVector ? rank : undefined,
-          keywordRank: !isVector && !isMemoryStream ? rank : undefined,
-          vectorScore: isVector ? result.score : undefined,
-          keywordScore: !isVector && !isMemoryStream ? result.score : undefined
-        });
-      }
-    });
-  }
-  const sorted = Array.from(scoreMap.values()).sort((a12, b) => b.rrfScore - a12.rrfScore);
-  const maxRrfScore = sorted[0]?.rrfScore || 1;
-  const vectorWeightRaw = Number(process.env.RRF_VECTOR_WEIGHT ?? "0.3");
-  const vectorWeight = Number.isFinite(vectorWeightRaw) ? Math.min(1, Math.max(0, vectorWeightRaw)) : 0.3;
-  return sorted.map(({ result, rrfScore, vectorRank, keywordRank, vectorScore, keywordScore, vectorRrfScore, lexicalRrfScore, memoryRrfScore }, index) => {
-    const rrfNormalized = rrfScore / maxRrfScore;
-    const vectorSimilarity = vectorScore || 0;
-    const combinedScore = rrfNormalized * (1 - vectorWeight) + vectorSimilarity * vectorWeight;
-    const centralityScore = typeof result.metadata?.centralityScore === "number" ? result.metadata.centralityScore : 0;
-    const normalizedScore = Math.min(1, combinedScore * (1 + 0.2 * centralityScore));
-    const memoryOnly = memoryRrfScore > 0 && vectorRrfScore === 0 && lexicalRrfScore === 0;
-    const explanation = explainScores ? generateScoreExplanationImpl(normalizedScore, rrfScore, vectorScore, keywordScore, vectorRank, keywordRank, index) : undefined;
-    return {
-      ...result,
-      score: normalizedScore,
-      explanation,
-      metadata: {
-        ...result.metadata,
-        _rrfRawVectorScore: vectorScore ?? (memoryOnly ? 0 : undefined)
-      }
-    };
-  });
-}
-function generateScoreExplanationImpl(finalScore, rrfScore, vectorScore, keywordScore, vectorRank, keywordRank, combinedRank) {
-  const parts = [];
-  if (vectorScore != null && vectorRank != null) {
-    parts.push(`Vector: ${(vectorScore * 100).toFixed(1)}% (rank #${vectorRank + 1})`);
-  }
-  if (keywordScore != null && keywordRank != null) {
-    parts.push(`Keyword: ${(keywordScore * 100).toFixed(1)}% (rank #${keywordRank + 1})`);
-  }
-  const breakdown = parts.join(" + ") + ` \u2192 RRF: ${rrfScore.toFixed(4)} \u2192 Final: ${(finalScore * 100).toFixed(1)}%`;
-  return {
-    finalScore,
-    vectorScore: vectorScore ?? undefined,
-    keywordScore: keywordScore ?? undefined,
-    rrfScore,
-    vectorRank: vectorRank != null ? vectorRank + 1 : undefined,
-    keywordRank: keywordRank != null ? keywordRank + 1 : undefined,
-    combinedRank: combinedRank != null ? combinedRank + 1 : undefined,
-    breakdown
-  };
-}
-var init_rlm_fusion = __esm(() => {
-  init_dist();
-});
-
 // ../../packages/core/dist/services/search/rlm-search.js
 async function searchImpl(rlm, query, projectId, options = {}) {
   try {
@@ -115359,7 +115243,123 @@ var init_rlm_search = __esm(() => {
   init_lexical_search();
   init_event_bus();
   init_search_diagnostics();
-  init_rlm_fusion();
+});
+
+// ../../packages/core/dist/services/search/result-fusion.js
+function fuseResults(resultSets, query, explainScores = false) {
+  const scoreMap = new Map;
+  const hasCodePattern = (text2) => {
+    const codePatterns = [
+      /\w+\(\)/,
+      /\bfunction\b/i,
+      /\bclass\b/i,
+      /\binterface\b/i,
+      /\benum\b/i,
+      /\btype\b/i,
+      /\bconst\b/i,
+      /\bimport\b/i,
+      /\bexport\b/i
+    ];
+    return codePatterns.some((pattern) => pattern.test(text2));
+  };
+  const isCodeQuery = hasCodePattern(query);
+  const codeKeywordBoostRaw = Number(process.env.RRF_KEYWORD_BOOST ?? "2.5");
+  const codeKeywordBoost = Number.isFinite(codeKeywordBoostRaw) && codeKeywordBoostRaw > 0 ? codeKeywordBoostRaw : 2.5;
+  const KEYWORD_BOOST = isCodeQuery ? codeKeywordBoost : 1;
+  logger.debug("RRF fusion parameters", {
+    query,
+    isCodeQuery,
+    keywordBoost: KEYWORD_BOOST,
+    vectorResults: resultSets[0]?.length || 0,
+    keywordResults: resultSets[1]?.length || 0
+  });
+  for (let i = 0;i < resultSets.length; i++) {
+    const results = resultSets[i];
+    const isVector = i === 0;
+    const isMemoryStream = results.some((r2) => r2.source === "memory" || r2.metadata?.context?.graphNeighbor === true);
+    const boost = isVector ? 1 : isMemoryStream ? 1 : KEYWORD_BOOST;
+    results.forEach((result, rank) => {
+      const rrfScore = 1 / (RRF_K + rank + 1) * boost;
+      if (scoreMap.has(result.id)) {
+        const existing = scoreMap.get(result.id);
+        if (isVector) {
+          existing.vectorRrfScore += rrfScore;
+          existing.vectorRank = rank;
+          existing.vectorScore = result.score;
+        } else if (isMemoryStream) {
+          existing.memoryRrfScore += rrfScore;
+        } else {
+          existing.lexicalRrfScore = Math.max(existing.lexicalRrfScore, rrfScore);
+          if (existing.keywordRank === undefined || rank < existing.keywordRank) {
+            existing.keywordRank = rank;
+            existing.keywordScore = result.score;
+          }
+        }
+        existing.rrfScore = existing.vectorRrfScore + existing.lexicalRrfScore + existing.memoryRrfScore;
+      } else {
+        const vectorRrfScore = isVector ? rrfScore : 0;
+        const lexicalRrfScore = !isVector && !isMemoryStream ? rrfScore : 0;
+        const memoryRrfScore = isMemoryStream ? rrfScore : 0;
+        scoreMap.set(result.id, {
+          result: { ...result },
+          rrfScore: vectorRrfScore + lexicalRrfScore + memoryRrfScore,
+          vectorRrfScore,
+          lexicalRrfScore,
+          memoryRrfScore,
+          vectorRank: isVector ? rank : undefined,
+          keywordRank: !isVector && !isMemoryStream ? rank : undefined,
+          vectorScore: isVector ? result.score : undefined,
+          keywordScore: !isVector && !isMemoryStream ? result.score : undefined
+        });
+      }
+    });
+  }
+  const sorted = Array.from(scoreMap.values()).sort((a12, b) => b.rrfScore - a12.rrfScore);
+  const maxRrfScore = sorted[0]?.rrfScore || 1;
+  const vectorWeightRaw = Number(process.env.RRF_VECTOR_WEIGHT ?? "0.3");
+  const vectorWeight = Number.isFinite(vectorWeightRaw) ? Math.min(1, Math.max(0, vectorWeightRaw)) : 0.3;
+  return sorted.map(({ result, rrfScore, vectorRank, keywordRank, vectorScore, keywordScore, vectorRrfScore, lexicalRrfScore, memoryRrfScore }, index) => {
+    const rrfNormalized = rrfScore / maxRrfScore;
+    const vectorSimilarity = vectorScore || 0;
+    const combinedScore = rrfNormalized * (1 - vectorWeight) + vectorSimilarity * vectorWeight;
+    const centralityScore = typeof result.metadata?.centralityScore === "number" ? result.metadata.centralityScore : 0;
+    const normalizedScore = Math.min(1, combinedScore * (1 + 0.2 * centralityScore));
+    const memoryOnly = memoryRrfScore > 0 && vectorRrfScore === 0 && lexicalRrfScore === 0;
+    const explanation = explainScores ? generateScoreExplanation(normalizedScore, rrfScore, vectorScore, keywordScore, vectorRank, keywordRank, index) : undefined;
+    return {
+      ...result,
+      score: normalizedScore,
+      explanation,
+      metadata: {
+        ...result.metadata,
+        _rrfRawVectorScore: vectorScore ?? (memoryOnly ? 0 : undefined)
+      }
+    };
+  });
+}
+function generateScoreExplanation(finalScore, rrfScore, vectorScore, keywordScore, vectorRank, keywordRank, combinedRank) {
+  const parts = [];
+  if (vectorScore != null && vectorRank != null) {
+    parts.push(`Vector: ${(vectorScore * 100).toFixed(1)}% (rank #${vectorRank + 1})`);
+  }
+  if (keywordScore != null && keywordRank != null) {
+    parts.push(`Keyword: ${(keywordScore * 100).toFixed(1)}% (rank #${keywordRank + 1})`);
+  }
+  const breakdown = parts.join(" + ") + ` \u2192 RRF: ${rrfScore.toFixed(4)} \u2192 Final: ${(finalScore * 100).toFixed(1)}%`;
+  return {
+    finalScore,
+    vectorScore: vectorScore ?? undefined,
+    keywordScore: keywordScore ?? undefined,
+    rrfScore,
+    vectorRank: vectorRank != null ? vectorRank + 1 : undefined,
+    keywordRank: keywordRank != null ? keywordRank + 1 : undefined,
+    combinedRank: combinedRank != null ? combinedRank + 1 : undefined,
+    breakdown
+  };
+}
+var RRF_K = 60;
+var init_result_fusion = __esm(() => {
+  init_dist();
 });
 
 // ../../packages/core/dist/services/search/rlm-admin.js
@@ -115451,6 +115451,7 @@ var init_contextual_search_rlm = __esm(() => {
   init_rlm_indexing();
   init_rlm_synapse();
   init_rlm_search();
+  init_result_fusion();
   init_rlm_admin();
   ContextualSearchRLM = class ContextualSearchRLM {
     keywordSearch;
@@ -115461,7 +115462,6 @@ var init_contextual_search_rlm = __esm(() => {
     symbolRepo;
     fileFilterCache;
     queryUnderstanding;
-    RRF_K = 60;
     initialized = false;
     static indexingLocks = new Map;
     injectedDeps;
@@ -115505,10 +115505,10 @@ var init_contextual_search_rlm = __esm(() => {
       return buildGraphStreamImpl(this, resultSets, maxResults, projectId, reportDegradation);
     }
     fuseResults(resultSets, query, explainScores = false) {
-      return fuseResultsImpl(this, resultSets, query, explainScores);
+      return fuseResults(resultSets, query, explainScores);
     }
     generateScoreExplanation(finalScore, rrfScore, vectorScore, keywordScore, vectorRank, keywordRank, combinedRank) {
-      return generateScoreExplanationImpl(finalScore, rrfScore, vectorScore, keywordScore, vectorRank, keywordRank, combinedRank);
+      return generateScoreExplanation(finalScore, rrfScore, vectorScore, keywordScore, vectorRank, keywordRank, combinedRank);
     }
     async addContextToResults(results, _projectId) {
       return addContextToResultsImpl(this, results, _projectId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massa-ai/tools-api",
-  "version": "1.10.0",
+  "version": "1.12.0",
   "author": "luizgmassa",
   "description": "massa-ai REST API server - Semantic code search, memory, and context compression",
   "type": "module",
@@ -21,8 +21,8 @@
     "test": "bun scripts/run-tests-isolated.ts"
   },
   "dependencies": {
-    "@massa-ai/core": "^1.10.0",
-    "@massa-ai/shared": "^1.10.0",
+    "@massa-ai/core": "^1.12.0",
+    "@massa-ai/shared": "^1.12.0",
     "elysia": "^1.2.25",
     "@elysiajs/swagger": "^1.2.0",
     "@elysiajs/cors": "^1.2.0",