@melandlabs/memory-store 1.3.8 → 1.4.0

package/dist/{config-9RzSCdXG.d.ts → config-Cnk2b7fH.d.ts}

@@ -2,7 +2,7 @@ import * as _melandlabs_memory_consolidation from '@melandlabs/memory-consolidat
 import { MemoryApplicabilityContext } from '@melandlabs/memory-consolidation';
 import * as _melandlabs_contracts_peer from '@melandlabs/contracts/peer';
 import { Peer } from '@melandlabs/contracts/peer';
-import { m as UnifiedMemoryRrfWeights, i as SessionNeighborExpansionOptions, E as EvidenceSelector, j as UnifiedMemoryMergeStrategy, I as IterativeRecallPlanner, l as UnifiedMemoryReasoningStrategy } from './evidence-selector-uOHsxwch.js';
+import { h as SearchEvidenceProvenance, j as SearchSourceState, o as UnifiedMemoryRrfWeights, k as SessionNeighborExpansionOptions, E as EvidenceSelector, l as UnifiedMemoryMergeStrategy, J as IterativeRecallPlanner, n as UnifiedMemoryReasoningStrategy } from './evidence-selector-C_ZUQsio.js';
 import { FactType } from '@melandlabs/contracts';
 import { DerivedFact } from '@melandlabs/contracts/derived-fact';
 import { EntityEdge } from '@melandlabs/contracts/entity-edge';
@@ -47,6 +47,14 @@ interface Reranker {
     rerank(input: RerankerInput): Promise<RerankerScore[]>;
 }
 
+interface SearchExecutionBudget {
+    signal?: AbortSignal;
+    /** Maximum wait per external retrieval operation. Defaults to five seconds. */
+    sourceTimeoutMs?: number;
+    /** Maximum wait for the complete search, including optional ranking. */
+    searchTimeoutMs?: number;
+}
+
 /**
  * Query rewriting for memory retrieval.
  *
@@ -183,12 +191,15 @@ interface UnifiedSearchKnowledgeResult {
     similarity: number;
     chunkIndex: number;
 }
-interface UnifiedSearchInsightsResult {
+/** Text candidates shared by host-owned insight and file retrieval. */
+interface UnifiedSearchTextResult {
     id: string;
     content: string;
     similarity: number;
     metadata: Record<string, unknown>;
+    provenance?: Partial<SearchEvidenceProvenance>;
 }
+type UnifiedSearchInsightsResult = UnifiedSearchTextResult;
 interface UnifiedSearchReasoningDeps {
     /** Optional extractive context selection after ranking. Disabled unless supplied. */
     evidenceSelector?: EvidenceSelector;
@@ -233,7 +244,17 @@ interface SearchProviderApplicabilityInput {
     /** Epoch milliseconds resolved once at the `search()` boundary. */
     applicabilityAt?: number;
 }
-interface UnifiedSearchDeps {
+interface UnifiedSearchDeps extends SearchExecutionBudget {
+    /** Host-owned file search; the host must enforce trusted scope before querying. */
+    searchWorkspace?: (input: SearchProviderApplicabilityInput & {
+        userId: string;
+        query: string;
+        limit: number;
+    }) => Promise<{
+        hits: UnifiedSearchTextResult[];
+        status: SearchSourceState["status"];
+        message?: string;
+    }>;
     /** Default rank-fusion weights; omitted channels use weight 1. */
     defaultRrfWeights?: UnifiedMemoryRrfWeights;
     /** Default reciprocal-rank damping constant. */
@@ -547,4 +568,4 @@ interface MemoryStoreConfig {
     logger?: Pick<Console, "log" | "warn" | "error">;
 }
 
-export { type EmbedQueryFn as E, type MemoryStoreConfig as M, type QueryRewriter as Q, type SearchProviderApplicabilityInput as S, type UnifiedSearchDeps as U, type VectorBackend as V, type MemoryStoreEnv as a, type MemoryStoreDb as b, type QueryRewriterInput as c, type QueryRewriterOptions as d, type UnifiedSearchInsightsResult as e, type UnifiedSearchKnowledgeResult as f, type UnifiedSearchReasoningDeps as g, createIdentityRewriter as h, createUserVoiceRewriter as i };
+export { type EmbedQueryFn as E, type MemoryStoreConfig as M, type QueryRewriter as Q, type SearchProviderApplicabilityInput as S, type UnifiedSearchDeps as U, type VectorBackend as V, type MemoryStoreEnv as a, type MemoryStoreDb as b, type QueryRewriterInput as c, type QueryRewriterOptions as d, type UnifiedSearchInsightsResult as e, type UnifiedSearchKnowledgeResult as f, type UnifiedSearchReasoningDeps as g, type UnifiedSearchTextResult as h, createIdentityRewriter as i, createUserVoiceRewriter as j };

package/dist/{evidence-selector-uOHsxwch.d.ts → evidence-selector-C_ZUQsio.d.ts}

@@ -1,5 +1,6 @@
-import { FactType } from '@melandlabs/contracts';
+import { Citation, FactType } from '@melandlabs/contracts';
 import { Peer } from '@melandlabs/contracts/peer';
+import { MemoryApplicabilityContext } from '@melandlabs/memory-consolidation';
 
 /**
  * Iterative, LLM-driven memory retrieval.
@@ -130,7 +131,14 @@ declare function createIterativeRecallPlanner(deps: IterativeRecallPlannerDeps):
  */
 declare function createIdentityIterativePlanner(): IterativeRecallPlanner;
 
-type UnifiedMemorySearchSource = "memory" | "insights" | "knowledge";
+type UnifiedMemorySearchSource = "memory" | "insights" | "knowledge" | "workspace";
+/** Retrieval availability and candidate count before cross-source ranking and limits. */
+interface SearchSourceState {
+    source: UnifiedMemorySearchSource;
+    status: "complete" | "partial" | "not_configured" | "not_ready" | "failed";
+    count: number;
+    message?: string;
+}
 /**
  * A retrieval channel that contributed to a hit's final score.
  *
@@ -326,11 +334,13 @@ interface SessionNeighborExpansionOptions {
     maxNeighborSlots?: number;
 }
 interface UnifiedMemorySearchResult {
-    type: "memory" | "insight" | "knowledge";
+    type: "memory" | "insight" | "knowledge" | "workspace";
     id: string;
     content: string;
     similarity: number;
     metadata: Record<string, unknown>;
+    /** Host-supplied evidence identity; absent fields remain explicitly unknown. */
+    provenance?: Partial<SearchEvidenceProvenance>;
     /**
      * Optional per-channel score breakdown. Always populated by the
      * pipeline when at least one channel contributed a non-empty list;
@@ -344,6 +354,7 @@ interface UnifiedMemorySearchOutput {
     results: UnifiedMemorySearchResult[];
     count: number;
     warnings: UnifiedMemorySearchWarning[];
+    sourceStates: SearchSourceState[];
     retrievalDiagnostics?: UnifiedMemoryRetrievalDiagnostics;
     /**
      * Diagnostic information about reasoning and date filtering. Present
@@ -424,7 +435,7 @@ type SearchSource = UnifiedMemorySearchSource;
  * Per-tier evidence bucket consulted by `reflect`-style synthesis.
  * Includes the `summary` tier that the read-only sources do not surface.
  */
-type SearchTier = "summary" | "raw" | "insight" | "knowledge";
+type SearchTier = "summary" | "raw" | "insight" | "knowledge" | "workspace";
 interface SearchInput {
     userId: string;
     query: string;
@@ -488,11 +499,28 @@ interface SearchInput {
      */
     includeDeprecated?: boolean;
 }
+/** Host-owned provenance. Null means unknown, never inferred from ranking or index readiness. */
+interface SearchEvidenceProvenance {
+    citation: Citation | null;
+    origin: string | null;
+    businessReference: string | null;
+    version: string | number | null;
+    contentHash: string | null;
+    scope: readonly MemoryApplicabilityContext[] | null;
+    /** Empty means known to have no derivation; null means unknown. */
+    derivedFrom: readonly string[] | null;
+    confirmation: "confirmed" | "unconfirmed" | null;
+    freshness: {
+        sourceUpdatedAt: string | null;
+        indexedAt: string | null;
+    } | null;
+}
 interface SearchEvidence {
     id: string;
     source: SearchSource | SearchTier;
     snippet: string;
     score: number;
+    provenance: SearchEvidenceProvenance;
     timestamp?: number;
     /**
      * Forwarded from the underlying hit's `metadata`. Surfaces per-fact
@@ -509,6 +537,7 @@ interface SearchOutput {
     evidence: SearchEvidence[];
     count: number;
     warnings: UnifiedMemorySearchWarning[];
+    sourceStates: SearchSourceState[];
     retrievalDiagnostics?: UnifiedMemoryRetrievalDiagnostics;
     reasoning?: UnifiedMemoryReasoningInfo;
     /** Only present when `synthesize` was truthy. */
@@ -594,4 +623,4 @@ interface EvidenceSelectorOptions {
  * changed ranking, or reranker-input changes. Disabled unless explicitly wired. */
 declare function createExtractiveEvidenceSelector(options: EvidenceSelectorOptions): EvidenceSelector;
 
-export { toMemoryResult as A, type EvidenceSelectorOptions as B, type IterativeRecallCandidate as C, type IterativeRecallCompletionOptions as D, type EvidenceSelector as E, type IterativeRecallExecutor as F, type IterativeRecallPlannerOptions as G, type HitChannel as H, type IterativeRecallPlanner as I, type IterativeRecallResult as J, type IterativeRecallSearchRequest as K, type IterativeRecallSearchResult as L, type IterativeRecallStats as M, type UnifiedMemoryReasoningInfo as N, createExtractiveEvidenceSelector as O, createIdentityIterativePlanner as P, createIterativeRecallPlanner as Q, type SearchTier as S, type UnifiedMemorySearchWarning as U, type SearchEvidence as a, type SearchInput as b, type SearchOutput as c, type UnifiedMemorySearchInput as d, type UnifiedMemorySearchOutput as e, type UnifiedMemorySearchResult as f, type HitSignals as g, type SearchSource as h, type SessionNeighborExpansionOptions as i, type UnifiedMemoryMergeStrategy as j, type UnifiedMemoryRankedList as k, type UnifiedMemoryReasoningStrategy as l, type UnifiedMemoryRrfWeights as m, type UnifiedMemorySearchSource as n, clampUnifiedMemorySearchLimit as o, clampUnifiedMemorySearchThreshold as p, deriveLexicalKeywords as q, isRawMemorySemanticResult as r, listNameToChannel as s, materializeSignals as t, mergeUnifiedMemorySearchResults as u, mergeUnifiedMemorySearchResultsRrf as v, normalizeUnifiedMemoryMergeStrategy as w, normalizeUnifiedMemoryReasoningStrategy as x, normalizeUnifiedMemorySearchSources as y, toKnowledgeResult as z };
+export { normalizeUnifiedMemorySearchSources as A, toKnowledgeResult as B, toMemoryResult as C, type EvidenceSelectorOptions as D, type EvidenceSelector as E, type IterativeRecallCompletionOptions as F, type IterativeRecallExecutor as G, type HitChannel as H, type IterativeRecallCandidate as I, type IterativeRecallPlanner as J, type IterativeRecallPlannerOptions as K, type IterativeRecallResult as L, type IterativeRecallSearchRequest as M, type IterativeRecallSearchResult as N, type IterativeRecallStats as O, type UnifiedMemoryReasoningInfo as P, createExtractiveEvidenceSelector as Q, createIdentityIterativePlanner as R, type SearchTier as S, createIterativeRecallPlanner as T, type UnifiedMemorySearchWarning as U, type SearchEvidence as a, type SearchInput as b, type SearchOutput as c, type UnifiedMemorySearchInput as d, type UnifiedMemorySearchOutput as e, type UnifiedMemorySearchResult as f, type HitSignals as g, type SearchEvidenceProvenance as h, type SearchSource as i, type SearchSourceState as j, type SessionNeighborExpansionOptions as k, type UnifiedMemoryMergeStrategy as l, type UnifiedMemoryRankedList as m, type UnifiedMemoryReasoningStrategy as n, type UnifiedMemoryRrfWeights as o, type UnifiedMemorySearchSource as p, clampUnifiedMemorySearchLimit as q, clampUnifiedMemorySearchThreshold as r, deriveLexicalKeywords as s, isRawMemorySemanticResult as t, listNameToChannel as u, materializeSignals as v, mergeUnifiedMemorySearchResults as w, mergeUnifiedMemorySearchResultsRrf as x, normalizeUnifiedMemoryMergeStrategy as y, normalizeUnifiedMemoryReasoningStrategy as z };

package/dist/http.d.ts

@@ -1,7 +1,7 @@
-import { M as MemoryStoreConfig } from './config-9RzSCdXG.js';
+import { M as MemoryStoreConfig } from './config-Cnk2b7fH.js';
 import '@melandlabs/memory-consolidation';
 import '@melandlabs/contracts/peer';
-import './evidence-selector-uOHsxwch.js';
+import './evidence-selector-C_ZUQsio.js';
 import '@melandlabs/contracts';
 import '@melandlabs/contracts/derived-fact';
 import '@melandlabs/contracts/entity-edge';