@melandlabs/memory-store 1.2.3 → 1.2.5

package/dist/{config-DfvVZ--0.d.ts → config-Dw4aXj2a.d.ts}

@@ -87,7 +87,7 @@ interface HitSignals {
  * fetch fallback.
  */
 declare function deriveLexicalKeywords(query: string): string[];
-type UnifiedMemoryReasoningStrategy = "none" | "rewrite" | "iterative";
+type UnifiedMemoryReasoningStrategy = "none" | "rewrite" | "iterative" | "union";
 interface UnifiedMemorySearchWarning {
     source: UnifiedMemorySearchSource;
     code: string;

package/dist/http.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryStoreConfig } from './config-DfvVZ--0.js';
+import { M as MemoryStoreConfig } from './config-Dw4aXj2a.js';
 import '@melandlabs/memory-consolidation';
 import '@melandlabs/contracts/peer';
 import '@melandlabs/contracts';

package/dist/http.js

@@ -462,7 +462,7 @@ function normalizeUnifiedMemoryMergeStrategy(value) {
   return value === "rrf" ? "rrf" : "similarity";
 }
 function normalizeUnifiedMemoryReasoningStrategy(value, defaultStrategy = "none") {
-  if (value === "rewrite" || value === "iterative") {
+  if (value === "rewrite" || value === "iterative" || value === "union") {
     return value;
   }
   return defaultStrategy;
@@ -1156,7 +1156,7 @@ function createUnifiedSearch(deps = {}) {
     return normalizeUnifiedMemoryReasoningStrategy(deps.reasoning?.defaultStrategy, "none");
   }
   async function runMemorySource(input, limit, threshold, warnings, reasoningStrategy = "none", reasoningInfo, peerPeers = []) {
-    if (reasoningStrategy === "iterative" && !deps.reasoning?.iterativePlanner) {
+    if ((reasoningStrategy === "iterative" || reasoningStrategy === "union") && !deps.reasoning?.iterativePlanner) {
       warnings.push({
         source: "memory",
         code: "memory_iterative_planner_not_configured",
@@ -1172,7 +1172,8 @@ function createUnifiedSearch(deps = {}) {
       });
       if (reasoningInfo) reasoningInfo.degraded = true;
     }
-    if (reasoningStrategy === "iterative" && deps.reasoning?.iterativePlanner) {
+    let unionEvidence = null;
+    if ((reasoningStrategy === "iterative" || reasoningStrategy === "union") && deps.reasoning?.iterativePlanner) {
       const planner = deps.reasoning.iterativePlanner;
       const result = await planner.plan({
         query: input.query,
@@ -1229,14 +1230,17 @@ function createUnifiedSearch(deps = {}) {
           reasoningInfo.degraded = true;
         }
       }
-      const semantic2 = result.evidence.map((candidate) => ({
+      const evidence = result.evidence.map((candidate) => ({
         type: "memory",
         id: candidate.id,
         content: candidate.content,
         similarity: candidate.similarity,
-        metadata: { ...candidate.metadata, reasoning: "iterative" }
+        metadata: { ...candidate.metadata, reasoning: reasoningStrategy }
       }));
-      return { semantic: semantic2, lexical: [] };
+      if (reasoningStrategy === "iterative") {
+        return { semantic: evidence, lexical: [] };
+      }
+      unionEvidence = evidence;
     }
     if (typeof deps.embedQuery !== "function") {
       warnings.push({
@@ -1362,6 +1366,37 @@ function createUnifiedSearch(deps = {}) {
         message: "RRF merge requested but entity search is not configured; falling back to semantic+lexical RRF."
       });
     }
+    if (unionEvidence) {
+      const plannerHits = unionEvidence;
+      const base = mergeByMaxScore([
+        filterByDateRange(semantic, input.dateFrom, input.dateTo),
+        filterByDateRange(lexical, input.dateFrom, input.dateTo)
+      ]);
+      const maxBase = base.length > 0 ? Math.max(...base.map((h) => h.similarity)) : 0;
+      const seen = /* @__PURE__ */ new Set();
+      const merged = [];
+      plannerHits.forEach((hit, i) => {
+        if (seen.has(hit.id)) {
+          return;
+        }
+        seen.add(hit.id);
+        merged.push({
+          ...hit,
+          similarity: maxBase + (plannerHits.length - i) * 1e-6
+        });
+      });
+      for (const hit of base) {
+        if (merged.length >= limit) {
+          break;
+        }
+        if (seen.has(hit.id)) {
+          continue;
+        }
+        seen.add(hit.id);
+        merged.push(hit);
+      }
+      return { semantic: merged.slice(0, limit), lexical: [] };
+    }
     const out = {
       semantic: filterByDateRange(semantic, input.dateFrom, input.dateTo),
       lexical: filterByDateRange(lexical, input.dateFrom, input.dateTo)
@@ -2190,7 +2225,7 @@ async function startHttpServer(options = {}) {
       authToken: typeof body.authToken === "string" ? body.authToken : void 0,
       dateFrom: typeof body.dateFrom === "string" ? body.dateFrom : void 0,
       dateTo: typeof body.dateTo === "string" ? body.dateTo : void 0,
-      reasoningStrategy: body.reasoningStrategy === "rewrite" || body.reasoningStrategy === "iterative" ? body.reasoningStrategy : void 0,
+      reasoningStrategy: body.reasoningStrategy === "rewrite" || body.reasoningStrategy === "iterative" || body.reasoningStrategy === "union" ? body.reasoningStrategy : void 0,
       ...wantsSynthesis ? {
         synthesize: {
           ...responseSchema ? { responseSchema } : {}

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as _melandlabs_memory_consolidation from '@melandlabs/memory-consolidation';
 import { OwnerScope } from '@melandlabs/memory-consolidation';
-import { d as SearchInput, e as SearchOutput, M as MemoryStoreConfig } from './config-DfvVZ--0.js';
-export { E as EmbedQueryFn, H as HitChannel, i as HitSignals, I as IterativeRecallCandidate, B as IterativeRecallExecutor, C as IterativeRecallPlanner, D as IterativeRecallPlannerOptions, F as IterativeRecallResult, G as IterativeRecallSearchRequest, J as IterativeRecallSearchResult, K as IterativeRecallStats, L as MemoryStoreDb, a as MemoryStoreEnv, Q as QueryRewriter, N as QueryRewriterInput, O as QueryRewriterOptions, c as SearchEvidence, j as SearchSource, S as SearchTier, k as UnifiedMemoryMergeStrategy, l as UnifiedMemoryRankedList, P as UnifiedMemoryReasoningInfo, m as UnifiedMemoryReasoningStrategy, f as UnifiedMemorySearchInput, g as UnifiedMemorySearchOutput, h as UnifiedMemorySearchResult, n as UnifiedMemorySearchSource, b as UnifiedMemorySearchWarning, R as UnifiedSearchInsightsResult, T as UnifiedSearchKnowledgeResult, V as UnifiedSearchReasoningDeps, W as VectorBackend, o as clampUnifiedMemorySearchLimit, p as clampUnifiedMemorySearchThreshold, X as createIdentityIterativePlanner, Y as createIdentityRewriter, Z as createIterativeRecallPlanner, _ as createUserVoiceRewriter, r as isRawMemorySemanticResult, s as listNameToChannel, t as materializeSignals, u as mergeUnifiedMemorySearchResults, v as mergeUnifiedMemorySearchResultsRrf, x as normalizeUnifiedMemoryReasoningStrategy, y as normalizeUnifiedMemorySearchSources, z as toKnowledgeResult, A as toMemoryResult } from './config-DfvVZ--0.js';
-import { U as UnifiedSearch, A as ApplyConsolidateInput, a as ApplyConsolidateOutput } from './unified-search-A8Q3JHwU.js';
-export { b as applyReflectedPlan, c as createUnifiedSearch } from './unified-search-A8Q3JHwU.js';
+import { d as SearchInput, e as SearchOutput, M as MemoryStoreConfig } from './config-Dw4aXj2a.js';
+export { E as EmbedQueryFn, H as HitChannel, i as HitSignals, I as IterativeRecallCandidate, B as IterativeRecallExecutor, C as IterativeRecallPlanner, D as IterativeRecallPlannerOptions, F as IterativeRecallResult, G as IterativeRecallSearchRequest, J as IterativeRecallSearchResult, K as IterativeRecallStats, L as MemoryStoreDb, a as MemoryStoreEnv, Q as QueryRewriter, N as QueryRewriterInput, O as QueryRewriterOptions, c as SearchEvidence, j as SearchSource, S as SearchTier, k as UnifiedMemoryMergeStrategy, l as UnifiedMemoryRankedList, P as UnifiedMemoryReasoningInfo, m as UnifiedMemoryReasoningStrategy, f as UnifiedMemorySearchInput, g as UnifiedMemorySearchOutput, h as UnifiedMemorySearchResult, n as UnifiedMemorySearchSource, b as UnifiedMemorySearchWarning, R as UnifiedSearchInsightsResult, T as UnifiedSearchKnowledgeResult, V as UnifiedSearchReasoningDeps, W as VectorBackend, o as clampUnifiedMemorySearchLimit, p as clampUnifiedMemorySearchThreshold, X as createIdentityIterativePlanner, Y as createIdentityRewriter, Z as createIterativeRecallPlanner, _ as createUserVoiceRewriter, r as isRawMemorySemanticResult, s as listNameToChannel, t as materializeSignals, u as mergeUnifiedMemorySearchResults, v as mergeUnifiedMemorySearchResultsRrf, x as normalizeUnifiedMemoryReasoningStrategy, y as normalizeUnifiedMemorySearchSources, z as toKnowledgeResult, A as toMemoryResult } from './config-Dw4aXj2a.js';
+import { U as UnifiedSearch, A as ApplyConsolidateInput, a as ApplyConsolidateOutput } from './unified-search-DfE8ek7W.js';
+export { b as applyReflectedPlan, c as createUnifiedSearch } from './unified-search-DfE8ek7W.js';
 import { StoreVsaFactInput, StoreVsaFactOutput, VsaRecallInput, VsaRecallOutput, VsaListInput, VsaFactSummary, VsaForgetInput, VsaForgetOutput, VsaFactStorage } from '@melandlabs/contracts';
 export { DerivedFact, DerivedKind, EntityEdge, EntityKind, StoreVsaFactInput, StoreVsaFactOutput, VsaFact, VsaFactStorage, VsaFactSummary, VsaForgetInput, VsaForgetOutput, VsaListInput, VsaRecallInput, VsaRecallOutput, VsaRecallScore, VsaVocabularyEntry } from '@melandlabs/contracts';
 import { RawMessageStore, getRawMessageManager } from './storage/raw-message-store.js';

package/dist/index.js

@@ -311,7 +311,7 @@ function normalizeUnifiedMemoryMergeStrategy(value) {
   return value === "rrf" ? "rrf" : "similarity";
 }
 function normalizeUnifiedMemoryReasoningStrategy(value, defaultStrategy = "none") {
-  if (value === "rewrite" || value === "iterative") {
+  if (value === "rewrite" || value === "iterative" || value === "union") {
     return value;
   }
   return defaultStrategy;
@@ -1157,7 +1157,7 @@ function createUnifiedSearch(deps = {}) {
     return normalizeUnifiedMemoryReasoningStrategy(deps.reasoning?.defaultStrategy, "none");
   }
   async function runMemorySource(input, limit, threshold, warnings, reasoningStrategy = "none", reasoningInfo, peerPeers = []) {
-    if (reasoningStrategy === "iterative" && !deps.reasoning?.iterativePlanner) {
+    if ((reasoningStrategy === "iterative" || reasoningStrategy === "union") && !deps.reasoning?.iterativePlanner) {
       warnings.push({
         source: "memory",
         code: "memory_iterative_planner_not_configured",
@@ -1173,7 +1173,8 @@ function createUnifiedSearch(deps = {}) {
       });
       if (reasoningInfo) reasoningInfo.degraded = true;
     }
-    if (reasoningStrategy === "iterative" && deps.reasoning?.iterativePlanner) {
+    let unionEvidence = null;
+    if ((reasoningStrategy === "iterative" || reasoningStrategy === "union") && deps.reasoning?.iterativePlanner) {
       const planner = deps.reasoning.iterativePlanner;
       const result = await planner.plan({
         query: input.query,
@@ -1230,14 +1231,17 @@ function createUnifiedSearch(deps = {}) {
           reasoningInfo.degraded = true;
         }
       }
-      const semantic2 = result.evidence.map((candidate) => ({
+      const evidence = result.evidence.map((candidate) => ({
         type: "memory",
         id: candidate.id,
         content: candidate.content,
         similarity: candidate.similarity,
-        metadata: { ...candidate.metadata, reasoning: "iterative" }
+        metadata: { ...candidate.metadata, reasoning: reasoningStrategy }
       }));
-      return { semantic: semantic2, lexical: [] };
+      if (reasoningStrategy === "iterative") {
+        return { semantic: evidence, lexical: [] };
+      }
+      unionEvidence = evidence;
     }
     if (typeof deps.embedQuery !== "function") {
       warnings.push({
@@ -1363,6 +1367,37 @@ function createUnifiedSearch(deps = {}) {
         message: "RRF merge requested but entity search is not configured; falling back to semantic+lexical RRF."
       });
     }
+    if (unionEvidence) {
+      const plannerHits = unionEvidence;
+      const base = mergeByMaxScore([
+        filterByDateRange(semantic, input.dateFrom, input.dateTo),
+        filterByDateRange(lexical, input.dateFrom, input.dateTo)
+      ]);
+      const maxBase = base.length > 0 ? Math.max(...base.map((h) => h.similarity)) : 0;
+      const seen = /* @__PURE__ */ new Set();
+      const merged = [];
+      plannerHits.forEach((hit, i) => {
+        if (seen.has(hit.id)) {
+          return;
+        }
+        seen.add(hit.id);
+        merged.push({
+          ...hit,
+          similarity: maxBase + (plannerHits.length - i) * 1e-6
+        });
+      });
+      for (const hit of base) {
+        if (merged.length >= limit) {
+          break;
+        }
+        if (seen.has(hit.id)) {
+          continue;
+        }
+        seen.add(hit.id);
+        merged.push(hit);
+      }
+      return { semantic: merged.slice(0, limit), lexical: [] };
+    }
     const out = {
       semantic: filterByDateRange(semantic, input.dateFrom, input.dateTo),
       lexical: filterByDateRange(lexical, input.dateFrom, input.dateTo)

package/dist/mcp.d.ts

@@ -1,5 +1,5 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { M as MemoryStoreConfig } from './config-DfvVZ--0.js';
+import { M as MemoryStoreConfig } from './config-Dw4aXj2a.js';
 import '@melandlabs/memory-consolidation';
 import '@melandlabs/contracts/peer';
 import '@melandlabs/contracts';

package/dist/mcp.js

@@ -463,7 +463,7 @@ function normalizeUnifiedMemoryMergeStrategy(value) {
   return value === "rrf" ? "rrf" : "similarity";
 }
 function normalizeUnifiedMemoryReasoningStrategy(value, defaultStrategy = "none") {
-  if (value === "rewrite" || value === "iterative") {
+  if (value === "rewrite" || value === "iterative" || value === "union") {
     return value;
   }
   return defaultStrategy;
@@ -1157,7 +1157,7 @@ function createUnifiedSearch(deps = {}) {
     return normalizeUnifiedMemoryReasoningStrategy(deps.reasoning?.defaultStrategy, "none");
   }
   async function runMemorySource(input, limit, threshold, warnings, reasoningStrategy = "none", reasoningInfo, peerPeers = []) {
-    if (reasoningStrategy === "iterative" && !deps.reasoning?.iterativePlanner) {
+    if ((reasoningStrategy === "iterative" || reasoningStrategy === "union") && !deps.reasoning?.iterativePlanner) {
       warnings.push({
         source: "memory",
         code: "memory_iterative_planner_not_configured",
@@ -1173,7 +1173,8 @@ function createUnifiedSearch(deps = {}) {
       });
       if (reasoningInfo) reasoningInfo.degraded = true;
     }
-    if (reasoningStrategy === "iterative" && deps.reasoning?.iterativePlanner) {
+    let unionEvidence = null;
+    if ((reasoningStrategy === "iterative" || reasoningStrategy === "union") && deps.reasoning?.iterativePlanner) {
       const planner = deps.reasoning.iterativePlanner;
       const result = await planner.plan({
         query: input.query,
@@ -1230,14 +1231,17 @@ function createUnifiedSearch(deps = {}) {
           reasoningInfo.degraded = true;
         }
       }
-      const semantic2 = result.evidence.map((candidate) => ({
+      const evidence = result.evidence.map((candidate) => ({
         type: "memory",
         id: candidate.id,
         content: candidate.content,
         similarity: candidate.similarity,
-        metadata: { ...candidate.metadata, reasoning: "iterative" }
+        metadata: { ...candidate.metadata, reasoning: reasoningStrategy }
       }));
-      return { semantic: semantic2, lexical: [] };
+      if (reasoningStrategy === "iterative") {
+        return { semantic: evidence, lexical: [] };
+      }
+      unionEvidence = evidence;
     }
     if (typeof deps.embedQuery !== "function") {
       warnings.push({
@@ -1363,6 +1367,37 @@ function createUnifiedSearch(deps = {}) {
         message: "RRF merge requested but entity search is not configured; falling back to semantic+lexical RRF."
       });
     }
+    if (unionEvidence) {
+      const plannerHits = unionEvidence;
+      const base = mergeByMaxScore([
+        filterByDateRange(semantic, input.dateFrom, input.dateTo),
+        filterByDateRange(lexical, input.dateFrom, input.dateTo)
+      ]);
+      const maxBase = base.length > 0 ? Math.max(...base.map((h) => h.similarity)) : 0;
+      const seen = /* @__PURE__ */ new Set();
+      const merged = [];
+      plannerHits.forEach((hit, i) => {
+        if (seen.has(hit.id)) {
+          return;
+        }
+        seen.add(hit.id);
+        merged.push({
+          ...hit,
+          similarity: maxBase + (plannerHits.length - i) * 1e-6
+        });
+      });
+      for (const hit of base) {
+        if (merged.length >= limit) {
+          break;
+        }
+        if (seen.has(hit.id)) {
+          continue;
+        }
+        seen.add(hit.id);
+        merged.push(hit);
+      }
+      return { semantic: merged.slice(0, limit), lexical: [] };
+    }
     const out = {
       semantic: filterByDateRange(semantic, input.dateFrom, input.dateTo),
       lexical: filterByDateRange(lexical, input.dateFrom, input.dateTo)
@@ -2165,8 +2200,8 @@ async function startMcpServer(options = {}) {
     tiers: z.array(z.enum(["summary", "raw", "insight", "knowledge"])).optional().describe(
       "Per-tier evidence scope for synthesis. Default: ['summary','raw','insight','knowledge']. Ignored when `synthesize` is falsy."
     ),
-    reasoningStrategy: z.enum(["none", "rewrite", "iterative"]).optional().describe(
-      "LLM reasoning strategy. `rewrite` rephrases the query before embedding; `iterative` runs a planner that searches, notes evidence, and searches again. Requires `unified.reasoning.{queryRewriter,iterativePlanner}` to be wired into the server."
+    reasoningStrategy: z.enum(["none", "rewrite", "iterative", "union"]).optional().describe(
+      "LLM reasoning strategy. `rewrite` rephrases the query before embedding; `iterative` runs a planner that searches, notes evidence, and searches again; `union` merges the planner's evidence with the baseline top-k hits (evidence first, deduped, capped at limit). Requires `unified.reasoning.{queryRewriter,iterativePlanner}` to be wired into the server."
     ),
     synthesize: z.union([z.boolean(), z.object({ responseSchema: z.record(z.string(), z.unknown()).optional() })]).optional().describe(
       "Opt-in LLM synthesis. `true` returns `{ answer, evidence, results, warnings }`. `synthesize.responseSchema` extracts `answer` from a JSON payload."
@@ -2243,7 +2278,7 @@ async function startMcpServer(options = {}) {
         documentIds: a.documentIds,
         authToken: a.authToken,
         includeArchivedInsights: a.includeArchivedInsights,
-        reasoningStrategy: a.reasoningStrategy === "rewrite" || a.reasoningStrategy === "iterative" ? a.reasoningStrategy : void 0,
+        reasoningStrategy: a.reasoningStrategy === "rewrite" || a.reasoningStrategy === "iterative" || a.reasoningStrategy === "union" ? a.reasoningStrategy : void 0,
         ...a.tiers ? { tiers: a.tiers } : {},
         ...wantsSynthesis ? {
           synthesize: {

package/dist/search/derive.d.ts

@@ -1,7 +1,7 @@
 import { DerivedFact } from '@melandlabs/contracts/derived-fact';
 import { FactType } from '@melandlabs/contracts/fact-type';
 import { Peer } from '@melandlabs/contracts/peer';
-import { U as UnifiedSearchDeps } from '../config-DfvVZ--0.js';
+import { U as UnifiedSearchDeps } from '../config-Dw4aXj2a.js';
 import '@melandlabs/memory-consolidation';
 import '@melandlabs/contracts';
 import '@melandlabs/contracts/entity-edge';

package/dist/search/distill.d.ts

@@ -1,5 +1,5 @@
 import { EntityEdge } from '@melandlabs/contracts/entity-edge';
-import { U as UnifiedSearchDeps } from '../config-DfvVZ--0.js';
+import { U as UnifiedSearchDeps } from '../config-Dw4aXj2a.js';
 import '@melandlabs/memory-consolidation';
 import '@melandlabs/contracts/peer';
 import '@melandlabs/contracts';

package/dist/search/unified-search.d.ts

@@ -1,5 +1,5 @@
-export { H as HitChannel, i as HitSignals, c as SearchEvidence, d as SearchInput, e as SearchOutput, j as SearchSource, S as SearchTier, k as UnifiedMemoryMergeStrategy, l as UnifiedMemoryRankedList, m as UnifiedMemoryReasoningStrategy, f as UnifiedMemorySearchInput, g as UnifiedMemorySearchOutput, h as UnifiedMemorySearchResult, n as UnifiedMemorySearchSource, b as UnifiedMemorySearchWarning, o as clampUnifiedMemorySearchLimit, p as clampUnifiedMemorySearchThreshold, q as deriveLexicalKeywords, r as isRawMemorySemanticResult, s as listNameToChannel, t as materializeSignals, u as mergeUnifiedMemorySearchResults, v as mergeUnifiedMemorySearchResultsRrf, w as normalizeUnifiedMemoryMergeStrategy, x as normalizeUnifiedMemoryReasoningStrategy, y as normalizeUnifiedMemorySearchSources, z as toKnowledgeResult, A as toMemoryResult } from '../config-DfvVZ--0.js';
-export { U as UnifiedSearch, c as createUnifiedSearch } from '../unified-search-A8Q3JHwU.js';
+export { H as HitChannel, i as HitSignals, c as SearchEvidence, d as SearchInput, e as SearchOutput, j as SearchSource, S as SearchTier, k as UnifiedMemoryMergeStrategy, l as UnifiedMemoryRankedList, m as UnifiedMemoryReasoningStrategy, f as UnifiedMemorySearchInput, g as UnifiedMemorySearchOutput, h as UnifiedMemorySearchResult, n as UnifiedMemorySearchSource, b as UnifiedMemorySearchWarning, o as clampUnifiedMemorySearchLimit, p as clampUnifiedMemorySearchThreshold, q as deriveLexicalKeywords, r as isRawMemorySemanticResult, s as listNameToChannel, t as materializeSignals, u as mergeUnifiedMemorySearchResults, v as mergeUnifiedMemorySearchResultsRrf, w as normalizeUnifiedMemoryMergeStrategy, x as normalizeUnifiedMemoryReasoningStrategy, y as normalizeUnifiedMemorySearchSources, z as toKnowledgeResult, A as toMemoryResult } from '../config-Dw4aXj2a.js';
+export { U as UnifiedSearch, c as createUnifiedSearch } from '../unified-search-DfE8ek7W.js';
 import '@melandlabs/memory-consolidation';
 import '@melandlabs/contracts/peer';
 import '@melandlabs/contracts';

package/dist/search/unified-search.js

@@ -300,7 +300,7 @@ function normalizeUnifiedMemoryMergeStrategy(value) {
   return value === "rrf" ? "rrf" : "similarity";
 }
 function normalizeUnifiedMemoryReasoningStrategy(value, defaultStrategy = "none") {
-  if (value === "rewrite" || value === "iterative") {
+  if (value === "rewrite" || value === "iterative" || value === "union") {
     return value;
   }
   return defaultStrategy;
@@ -1146,7 +1146,7 @@ function createUnifiedSearch(deps = {}) {
     return normalizeUnifiedMemoryReasoningStrategy(deps.reasoning?.defaultStrategy, "none");
   }
   async function runMemorySource(input, limit, threshold, warnings, reasoningStrategy = "none", reasoningInfo, peerPeers = []) {
-    if (reasoningStrategy === "iterative" && !deps.reasoning?.iterativePlanner) {
+    if ((reasoningStrategy === "iterative" || reasoningStrategy === "union") && !deps.reasoning?.iterativePlanner) {
       warnings.push({
         source: "memory",
         code: "memory_iterative_planner_not_configured",
@@ -1162,7 +1162,8 @@ function createUnifiedSearch(deps = {}) {
       });
       if (reasoningInfo) reasoningInfo.degraded = true;
     }
-    if (reasoningStrategy === "iterative" && deps.reasoning?.iterativePlanner) {
+    let unionEvidence = null;
+    if ((reasoningStrategy === "iterative" || reasoningStrategy === "union") && deps.reasoning?.iterativePlanner) {
       const planner = deps.reasoning.iterativePlanner;
       const result = await planner.plan({
         query: input.query,
@@ -1219,14 +1220,17 @@ function createUnifiedSearch(deps = {}) {
           reasoningInfo.degraded = true;
         }
       }
-      const semantic2 = result.evidence.map((candidate) => ({
+      const evidence = result.evidence.map((candidate) => ({
         type: "memory",
         id: candidate.id,
         content: candidate.content,
         similarity: candidate.similarity,
-        metadata: { ...candidate.metadata, reasoning: "iterative" }
+        metadata: { ...candidate.metadata, reasoning: reasoningStrategy }
       }));
-      return { semantic: semantic2, lexical: [] };
+      if (reasoningStrategy === "iterative") {
+        return { semantic: evidence, lexical: [] };
+      }
+      unionEvidence = evidence;
     }
     if (typeof deps.embedQuery !== "function") {
       warnings.push({
@@ -1352,6 +1356,37 @@ function createUnifiedSearch(deps = {}) {
         message: "RRF merge requested but entity search is not configured; falling back to semantic+lexical RRF."
       });
     }
+    if (unionEvidence) {
+      const plannerHits = unionEvidence;
+      const base = mergeByMaxScore([
+        filterByDateRange(semantic, input.dateFrom, input.dateTo),
+        filterByDateRange(lexical, input.dateFrom, input.dateTo)
+      ]);
+      const maxBase = base.length > 0 ? Math.max(...base.map((h) => h.similarity)) : 0;
+      const seen = /* @__PURE__ */ new Set();
+      const merged = [];
+      plannerHits.forEach((hit, i) => {
+        if (seen.has(hit.id)) {
+          return;
+        }
+        seen.add(hit.id);
+        merged.push({
+          ...hit,
+          similarity: maxBase + (plannerHits.length - i) * 1e-6
+        });
+      });
+      for (const hit of base) {
+        if (merged.length >= limit) {
+          break;
+        }
+        if (seen.has(hit.id)) {
+          continue;
+        }
+        seen.add(hit.id);
+        merged.push(hit);
+      }
+      return { semantic: merged.slice(0, limit), lexical: [] };
+    }
     const out = {
       semantic: filterByDateRange(semantic, input.dateFrom, input.dateTo),
       lexical: filterByDateRange(lexical, input.dateFrom, input.dateTo)

package/dist/server/cli-http.js

@@ -463,7 +463,7 @@ function normalizeUnifiedMemoryMergeStrategy(value) {
   return value === "rrf" ? "rrf" : "similarity";
 }
 function normalizeUnifiedMemoryReasoningStrategy(value, defaultStrategy = "none") {
-  if (value === "rewrite" || value === "iterative") {
+  if (value === "rewrite" || value === "iterative" || value === "union") {
     return value;
   }
   return defaultStrategy;
@@ -1157,7 +1157,7 @@ function createUnifiedSearch(deps = {}) {
     return normalizeUnifiedMemoryReasoningStrategy(deps.reasoning?.defaultStrategy, "none");
   }
   async function runMemorySource(input, limit, threshold, warnings, reasoningStrategy = "none", reasoningInfo, peerPeers = []) {
-    if (reasoningStrategy === "iterative" && !deps.reasoning?.iterativePlanner) {
+    if ((reasoningStrategy === "iterative" || reasoningStrategy === "union") && !deps.reasoning?.iterativePlanner) {
       warnings.push({
         source: "memory",
         code: "memory_iterative_planner_not_configured",
@@ -1173,7 +1173,8 @@ function createUnifiedSearch(deps = {}) {
       });
       if (reasoningInfo) reasoningInfo.degraded = true;
     }
-    if (reasoningStrategy === "iterative" && deps.reasoning?.iterativePlanner) {
+    let unionEvidence = null;
+    if ((reasoningStrategy === "iterative" || reasoningStrategy === "union") && deps.reasoning?.iterativePlanner) {
       const planner = deps.reasoning.iterativePlanner;
       const result = await planner.plan({
         query: input.query,
@@ -1230,14 +1231,17 @@ function createUnifiedSearch(deps = {}) {
           reasoningInfo.degraded = true;
         }
       }
-      const semantic2 = result.evidence.map((candidate) => ({
+      const evidence = result.evidence.map((candidate) => ({
         type: "memory",
         id: candidate.id,
         content: candidate.content,
         similarity: candidate.similarity,
-        metadata: { ...candidate.metadata, reasoning: "iterative" }
+        metadata: { ...candidate.metadata, reasoning: reasoningStrategy }
       }));
-      return { semantic: semantic2, lexical: [] };
+      if (reasoningStrategy === "iterative") {
+        return { semantic: evidence, lexical: [] };
+      }
+      unionEvidence = evidence;
     }
     if (typeof deps.embedQuery !== "function") {
       warnings.push({
@@ -1363,6 +1367,37 @@ function createUnifiedSearch(deps = {}) {
         message: "RRF merge requested but entity search is not configured; falling back to semantic+lexical RRF."
       });
     }
+    if (unionEvidence) {
+      const plannerHits = unionEvidence;
+      const base = mergeByMaxScore([
+        filterByDateRange(semantic, input.dateFrom, input.dateTo),
+        filterByDateRange(lexical, input.dateFrom, input.dateTo)
+      ]);
+      const maxBase = base.length > 0 ? Math.max(...base.map((h) => h.similarity)) : 0;
+      const seen = /* @__PURE__ */ new Set();
+      const merged = [];
+      plannerHits.forEach((hit, i) => {
+        if (seen.has(hit.id)) {
+          return;
+        }
+        seen.add(hit.id);
+        merged.push({
+          ...hit,
+          similarity: maxBase + (plannerHits.length - i) * 1e-6
+        });
+      });
+      for (const hit of base) {
+        if (merged.length >= limit) {
+          break;
+        }
+        if (seen.has(hit.id)) {
+          continue;
+        }
+        seen.add(hit.id);
+        merged.push(hit);
+      }
+      return { semantic: merged.slice(0, limit), lexical: [] };
+    }
     const out = {
       semantic: filterByDateRange(semantic, input.dateFrom, input.dateTo),
       lexical: filterByDateRange(lexical, input.dateFrom, input.dateTo)
@@ -2191,7 +2226,7 @@ async function startHttpServer(options = {}) {
       authToken: typeof body.authToken === "string" ? body.authToken : void 0,
       dateFrom: typeof body.dateFrom === "string" ? body.dateFrom : void 0,
       dateTo: typeof body.dateTo === "string" ? body.dateTo : void 0,
-      reasoningStrategy: body.reasoningStrategy === "rewrite" || body.reasoningStrategy === "iterative" ? body.reasoningStrategy : void 0,
+      reasoningStrategy: body.reasoningStrategy === "rewrite" || body.reasoningStrategy === "iterative" || body.reasoningStrategy === "union" ? body.reasoningStrategy : void 0,
       ...wantsSynthesis ? {
         synthesize: {
           ...responseSchema ? { responseSchema } : {}

package/dist/server/cli-mcp.js

@@ -464,7 +464,7 @@ function normalizeUnifiedMemoryMergeStrategy(value) {
   return value === "rrf" ? "rrf" : "similarity";
 }
 function normalizeUnifiedMemoryReasoningStrategy(value, defaultStrategy = "none") {
-  if (value === "rewrite" || value === "iterative") {
+  if (value === "rewrite" || value === "iterative" || value === "union") {
     return value;
   }
   return defaultStrategy;
@@ -1158,7 +1158,7 @@ function createUnifiedSearch(deps = {}) {
     return normalizeUnifiedMemoryReasoningStrategy(deps.reasoning?.defaultStrategy, "none");
   }
   async function runMemorySource(input, limit, threshold, warnings, reasoningStrategy = "none", reasoningInfo, peerPeers = []) {
-    if (reasoningStrategy === "iterative" && !deps.reasoning?.iterativePlanner) {
+    if ((reasoningStrategy === "iterative" || reasoningStrategy === "union") && !deps.reasoning?.iterativePlanner) {
       warnings.push({
         source: "memory",
         code: "memory_iterative_planner_not_configured",
@@ -1174,7 +1174,8 @@ function createUnifiedSearch(deps = {}) {
       });
       if (reasoningInfo) reasoningInfo.degraded = true;
     }
-    if (reasoningStrategy === "iterative" && deps.reasoning?.iterativePlanner) {
+    let unionEvidence = null;
+    if ((reasoningStrategy === "iterative" || reasoningStrategy === "union") && deps.reasoning?.iterativePlanner) {
       const planner = deps.reasoning.iterativePlanner;
       const result = await planner.plan({
         query: input.query,
@@ -1231,14 +1232,17 @@ function createUnifiedSearch(deps = {}) {
           reasoningInfo.degraded = true;
         }
       }
-      const semantic2 = result.evidence.map((candidate) => ({
+      const evidence = result.evidence.map((candidate) => ({
         type: "memory",
         id: candidate.id,
         content: candidate.content,
         similarity: candidate.similarity,
-        metadata: { ...candidate.metadata, reasoning: "iterative" }
+        metadata: { ...candidate.metadata, reasoning: reasoningStrategy }
       }));
-      return { semantic: semantic2, lexical: [] };
+      if (reasoningStrategy === "iterative") {
+        return { semantic: evidence, lexical: [] };
+      }
+      unionEvidence = evidence;
     }
     if (typeof deps.embedQuery !== "function") {
       warnings.push({
@@ -1364,6 +1368,37 @@ function createUnifiedSearch(deps = {}) {
         message: "RRF merge requested but entity search is not configured; falling back to semantic+lexical RRF."
       });
     }
+    if (unionEvidence) {
+      const plannerHits = unionEvidence;
+      const base = mergeByMaxScore([
+        filterByDateRange(semantic, input.dateFrom, input.dateTo),
+        filterByDateRange(lexical, input.dateFrom, input.dateTo)
+      ]);
+      const maxBase = base.length > 0 ? Math.max(...base.map((h) => h.similarity)) : 0;
+      const seen = /* @__PURE__ */ new Set();
+      const merged = [];
+      plannerHits.forEach((hit, i) => {
+        if (seen.has(hit.id)) {
+          return;
+        }
+        seen.add(hit.id);
+        merged.push({
+          ...hit,
+          similarity: maxBase + (plannerHits.length - i) * 1e-6
+        });
+      });
+      for (const hit of base) {
+        if (merged.length >= limit) {
+          break;
+        }
+        if (seen.has(hit.id)) {
+          continue;
+        }
+        seen.add(hit.id);
+        merged.push(hit);
+      }
+      return { semantic: merged.slice(0, limit), lexical: [] };
+    }
     const out = {
       semantic: filterByDateRange(semantic, input.dateFrom, input.dateTo),
       lexical: filterByDateRange(lexical, input.dateFrom, input.dateTo)
@@ -2166,8 +2201,8 @@ async function startMcpServer(options = {}) {
     tiers: z.array(z.enum(["summary", "raw", "insight", "knowledge"])).optional().describe(
       "Per-tier evidence scope for synthesis. Default: ['summary','raw','insight','knowledge']. Ignored when `synthesize` is falsy."
     ),
-    reasoningStrategy: z.enum(["none", "rewrite", "iterative"]).optional().describe(
-      "LLM reasoning strategy. `rewrite` rephrases the query before embedding; `iterative` runs a planner that searches, notes evidence, and searches again. Requires `unified.reasoning.{queryRewriter,iterativePlanner}` to be wired into the server."
+    reasoningStrategy: z.enum(["none", "rewrite", "iterative", "union"]).optional().describe(
+      "LLM reasoning strategy. `rewrite` rephrases the query before embedding; `iterative` runs a planner that searches, notes evidence, and searches again; `union` merges the planner's evidence with the baseline top-k hits (evidence first, deduped, capped at limit). Requires `unified.reasoning.{queryRewriter,iterativePlanner}` to be wired into the server."
     ),
     synthesize: z.union([z.boolean(), z.object({ responseSchema: z.record(z.string(), z.unknown()).optional() })]).optional().describe(
       "Opt-in LLM synthesis. `true` returns `{ answer, evidence, results, warnings }`. `synthesize.responseSchema` extracts `answer` from a JSON payload."
@@ -2244,7 +2279,7 @@ async function startMcpServer(options = {}) {
         documentIds: a.documentIds,
         authToken: a.authToken,
         includeArchivedInsights: a.includeArchivedInsights,
-        reasoningStrategy: a.reasoningStrategy === "rewrite" || a.reasoningStrategy === "iterative" ? a.reasoningStrategy : void 0,
+        reasoningStrategy: a.reasoningStrategy === "rewrite" || a.reasoningStrategy === "iterative" || a.reasoningStrategy === "union" ? a.reasoningStrategy : void 0,
         ...a.tiers ? { tiers: a.tiers } : {},
         ...wantsSynthesis ? {
           synthesize: {

package/dist/server/cli-shared.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { U as UnifiedSearchDeps } from '../config-DfvVZ--0.js';
+import { U as UnifiedSearchDeps } from '../config-Dw4aXj2a.js';
 import '@melandlabs/memory-consolidation';
 import '@melandlabs/contracts/peer';
 import '@melandlabs/contracts';

package/dist/storage/postgres-raw-message-factory.d.ts

@@ -1,4 +1,4 @@
-import { a as MemoryStoreEnv } from '../config-DfvVZ--0.js';
+import { a as MemoryStoreEnv } from '../config-Dw4aXj2a.js';
 import '@melandlabs/memory-consolidation';
 import '@melandlabs/contracts/peer';
 import '@melandlabs/contracts';

package/dist/storage/raw-message-store.d.ts

@@ -1,5 +1,5 @@
 import { RawMessageStorageManager } from '@melandlabs/indexeddb';
-import { a as MemoryStoreEnv, M as MemoryStoreConfig } from '../config-DfvVZ--0.js';
+import { a as MemoryStoreEnv, M as MemoryStoreConfig } from '../config-Dw4aXj2a.js';
 import '@melandlabs/memory-consolidation';
 import '@melandlabs/contracts/peer';
 import '@melandlabs/contracts';

package/dist/storage/sqlite-raw-message-store.d.ts

@@ -1,5 +1,5 @@
 import { SQLiteRawMessageManager } from '@melandlabs/sqlite';
-import { a as MemoryStoreEnv } from '../config-DfvVZ--0.js';
+import { a as MemoryStoreEnv } from '../config-Dw4aXj2a.js';
 import '@melandlabs/memory-consolidation';
 import '@melandlabs/contracts/peer';
 import '@melandlabs/contracts';

package/dist/storage/sqlite-vector-index.d.ts

@@ -1,5 +1,5 @@
 import { VectorSearchResult } from '@melandlabs/rag/vector-service';
-import { a as MemoryStoreEnv } from '../config-DfvVZ--0.js';
+import { a as MemoryStoreEnv } from '../config-Dw4aXj2a.js';
 import '@melandlabs/memory-consolidation';
 import '@melandlabs/contracts/peer';
 import '@melandlabs/contracts';

package/dist/{unified-search-A8Q3JHwU.d.ts → unified-search-DfE8ek7W.d.ts}

@@ -1,4 +1,4 @@
-import { S as SearchTier, b as UnifiedMemorySearchWarning, c as SearchEvidence, U as UnifiedSearchDeps, d as SearchInput, e as SearchOutput, f as UnifiedMemorySearchInput, g as UnifiedMemorySearchOutput, h as UnifiedMemorySearchResult } from './config-DfvVZ--0.js';
+import { S as SearchTier, b as UnifiedMemorySearchWarning, c as SearchEvidence, U as UnifiedSearchDeps, d as SearchInput, e as SearchOutput, f as UnifiedMemorySearchInput, g as UnifiedMemorySearchOutput, h as UnifiedMemorySearchResult } from './config-Dw4aXj2a.js';
 import { MemoryStorageAdapter } from '@melandlabs/ai/memory';
 import { Peer } from '@melandlabs/contracts/peer';
 import { OwnerScope, MemoryConsolidationPlan, ReflectApplyClusterKeyFn, MemoryStorageAdapterLike, MemoryGraphStoreWithOperationHistory, MemoryGraphUpdateResult } from '@melandlabs/memory-consolidation';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melandlabs/memory-store",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "type": "module",
   "files": [
     "dist",
@@ -60,15 +60,15 @@
     "@modelcontextprotocol/sdk": "^1.25.3",
     "hono": "^4.6.14",
     "zod": "^4.3.6",
-    "@melandlabs/contracts": "0.7.0",
-    "@melandlabs/ai": "0.10.1",
     "@melandlabs/env-config": "0.4.0",
-    "@melandlabs/okf": "0.3.1",
+    "@melandlabs/contracts": "0.7.0",
     "@melandlabs/memory-consolidation": "0.5.2",
+    "@melandlabs/okf": "0.3.1",
+    "@melandlabs/shared": "0.4.0",
+    "@melandlabs/ai": "0.10.3",
     "@melandlabs/rag": "0.3.0",
     "@melandlabs/sqlite": "0.5.2",
-    "@melandlabs/vsa": "0.3.0",
-    "@melandlabs/shared": "0.4.0"
+    "@melandlabs/vsa": "0.3.0"
   },
   "peerDependencies": {
     "@melandlabs/ai-rag": "0.2.9",