hippo-memory 1.52.0 → 1.52.2

package/dist/store.d.ts

@@ -109,6 +109,8 @@ export declare function assertNonEmpty<T>(arr: readonly T[], name: string): void
 export declare function getHippoRoot(cwd?: string, opts?: ResolveProjectIdentityOpts): string;
 export declare function isInitialized(hippoRoot: string): boolean;
 export declare function initStore(hippoRoot: string): void;
+/** One open connection with init done on it, for callers who used to pay for `initStore` + a second `openHippoDb`. */
+export declare function openStore(hippoRoot: string): DatabaseSyncLike;
 /** `meta` key holding the default half-life base a store's memories are on (src/half-life-migration.ts). */
 export declare const HALF_LIFE_BASE_META_KEY = "default_half_life_base";
 /**
@@ -411,7 +413,16 @@ export declare function batchWriteAndDelete(hippoRoot: string, toWrite: MemoryEn
 export declare function loadAllEntries(hippoRoot: string, tenantId?: string): MemoryEntry[];
 /** Every memory row on an open connection, so a caller can read inside its own transaction. */
 export declare function selectAllEntries(db: DatabaseSyncLike, tenantId?: string): MemoryEntry[];
-export declare function loadAmbientCandidates(hippoRoot: string, tenantId: string, recentNeeded: number, admit: (e: MemoryEntry) => boolean): MemoryEntry[];
+export declare function loadContentsWithTag(hippoRoot: string, tenantId: string, tag: string): string[];
+export interface AmbientRecallRequest {
+    terms: string[];
+    limit: number;
+}
+export interface AmbientLoadResult {
+    entries: MemoryEntry[];
+    recall?: MemoryEntry[];
+}
+export declare function loadAmbientCandidates(hippoRoot: string, tenantId: string, recentNeeded: number, admit: (e: MemoryEntry) => boolean, recall?: AmbientRecallRequest): AmbientLoadResult;
 /**
  * Load likely search candidates directly from SQLite.
  * Uses FTS5 when available, falls back to LIKE matching, then full-store fallback.
@@ -445,6 +456,10 @@ export declare function loadSearchEntries(hippoRoot: string, query: string, limi
  * undefined as "no tenant filter" for legacy callers.
  */
 export declare function loadRecallSearchEntries(hippoRoot: string, query: string, limit?: number, tenantId?: string, requestedScope?: string, explicitScopeMode?: 'exact' | 'additive', includeSuperseded?: boolean): MemoryEntry[];
+export declare function loadRecallSearchEntriesFromDb(db: DatabaseSyncLike, query: string, limit?: number, tenantId?: string, requestedScope?: string, explicitScopeMode?: 'exact' | 'additive', includeSuperseded?: boolean): MemoryEntry[];
+/** Rarest-K prompt terms for this connection's FTS index, as a space-joined query string.
+ *  Without FTS, returns the first 32 terms, as before rarest-term selection. */
+export declare function pickRarestFtsQuery(db: DatabaseSyncLike, terms: readonly string[], maxTerms?: number): string;
 /**
  * Rebuild mirrors from SQLite, importing any legacy markdown files not already present.
  */