nlm-memory 0.21.0 → 0.21.13

package/dist/core/storage/sqlite-session-store.d.ts

@@ -10,6 +10,16 @@
  * markers + session_embedding_chunks (vec0). Idle-status overlay (computed
  * from transcript mtime) is deferred to a later phase; A.2 returns the
  * persisted status verbatim.
+ *
+ * Tenancy (program spec §4, M2 plan Wave B): every method takes `tenantId`
+ * as its non-optional first parameter. `sessions`, `entities`,
+ * `entity_variants`, and `session_entities` are STAMP tables and every
+ * SELECT/UPDATE/DELETE against them routes its WHERE fragment through
+ * `tenantClause`; INSERTs stamp `tenant_id` explicitly. `markers` and
+ * `session_edges` carry no `tenant_id` column (DERIVE-VIA-FK) — they are
+ * reached only through an already tenant-filtered session id set, or (for
+ * `recentMarkers`/`markSuperseded`'s fact cascade) via an explicit join back
+ * to a tenant-filtered `sessions` row.
  */
 import Database from "better-sqlite3";
 import type { KeywordNeighbor, SearchOptions, SemanticNeighbor, SessionStore } from "../../ports/session-store.js";
@@ -113,7 +123,6 @@ export interface BackfillCandidate {
 export declare class SqliteSessionStore implements SessionStore {
     private readonly db;
     private overlayCache;
-    private overlayCacheAt;
     /**
      * @internal. Construct via SqliteStorage.create(...) instead. Direct
      * construction is preserved for the SqliteStorage adapter only; all
@@ -134,9 +143,9 @@ export declare class SqliteSessionStore implements SessionStore {
     invalidateOverlayCache(): void;
     private overlay;
     /** Recently-written sessions ordered by created_at desc. Powers /live Writes column. */
-    recentWrites(limit: number): RecentWrite[];
+    recentWrites(tenantId: string, limit: number): RecentWrite[];
     /** Recently-extracted markers ordered by session created_at desc. Powers /live Decisions column. */
-    recentMarkers(limit: number): RecentMarker[];
+    recentMarkers(tenantId: string, limit: number): RecentMarker[];
     /**
      * Atomic ingest: writes the session row, markers, entity rows + links,
      * supersedes edge (if any), and the embedding (best-effort) in one
@@ -148,7 +157,7 @@ export declare class SqliteSessionStore implements SessionStore {
      * Mirrors Python's SQLiteStore.insert_session. Markdown projection is not
      * yet ported and skipped here.
      */
-    insertSession(record: IngestRecord, embedder?: import("../../ports/llm-client.js").LLMClient | null, supersedes?: Supersedes | null, factSink?: {
+    insertSession(tenantId: string, record: IngestRecord, embedder?: import("../../ports/llm-client.js").LLMClient | null, supersedes?: Supersedes | null, factSink?: {
         factStore: SqliteFactStore;
         facts: ReadonlyArray<Fact>;
     } | null): Promise<void>;
@@ -159,7 +168,7 @@ export declare class SqliteSessionStore implements SessionStore {
      * Non-empty body required (the classifier needs transcript text). When
      * `reprocess` is false, sessions that already have facts are excluded.
      */
-    listBackfillCandidates(filter: BackfillCandidateFilter): Promise<BackfillCandidate[]>;
+    listBackfillCandidates(tenantId: string, filter: BackfillCandidateFilter): Promise<BackfillCandidate[]>;
     /**
      * Phase B.5 — backfill entry point. Writes facts (with deterministic
      * supersedence + best-effort embeddings) for an EXISTING session row
@@ -172,23 +181,23 @@ export declare class SqliteSessionStore implements SessionStore {
      * write path. The live ingest path (`insertSession`) keeps using the
      * internal helpers directly so session+facts commit together.
      */
-    insertFactsForSession(sessionId: string, factStore: SqliteFactStore, facts: ReadonlyArray<Fact>, embedder?: import("../../ports/llm-client.js").LLMClient | null): Promise<void>;
+    insertFactsForSession(tenantId: string, sessionId: string, factStore: SqliteFactStore, facts: ReadonlyArray<Fact>, embedder?: import("../../ports/llm-client.js").LLMClient | null): Promise<void>;
     /**
      * Best-effort per-fact embedding. Writes `${subject} ${predicate} ${value}`
      * embeddings to fact_embeddings via FactStore.upsertEmbedding. Per-fact
      * failures don't abort the batch, and never affect committed fact rows.
      */
     private embedFacts;
-    getById(sessionId: string): Promise<Session | null>;
+    getById(tenantId: string, sessionId: string): Promise<Session | null>;
     /**
      * Batched session fetch for the recall path. Deliberately omits the
      * `body` column — body is ~48KB/row of session markdown that recall
      * never reads, and SELECTing it for the corpus is what wedged the
      * daemon. Resolved sessions carry `body: ""`.
      */
-    getByIds(ids: ReadonlyArray<string>): Promise<ReadonlyArray<Session>>;
-    listByDateRange(fromIso: string, toIso: string): Promise<ReadonlyArray<Session>>;
-    semanticSearch(queryVector: Float32Array, limit: number, opts?: SearchOptions): Promise<ReadonlyArray<SemanticNeighbor>>;
+    getByIds(tenantId: string, ids: ReadonlyArray<string>): Promise<ReadonlyArray<Session>>;
+    listByDateRange(tenantId: string, fromIso: string, toIso: string): Promise<ReadonlyArray<Session>>;
+    semanticSearch(tenantId: string, queryVector: Float32Array, limit: number, opts?: SearchOptions): Promise<ReadonlyArray<SemanticNeighbor>>;
     /**
      * Lexical recall via the sessions_fts FTS5 index. BM25 column weights
      * favour label over summary over body. Returns sessions ranked best-first
@@ -196,17 +205,17 @@ export declare class SqliteSessionStore implements SessionStore {
      * for better matches). User input is tokenized and rebuilt into a quoted
      * OR query so FTS5 metacharacters cannot reach the MATCH parser.
      */
-    keywordSearch(query: string, limit: number, opts?: SearchOptions): Promise<ReadonlyArray<KeywordNeighbor>>;
-    resolveSuccessors(ids: ReadonlyArray<string>): Promise<Map<string, string>>;
-    updateStatus(sessionId: string, status: SessionStatus): Promise<void>;
-    markSuperseded(predecessorId: string, successorId: string): Promise<void>;
-    getSessionScopeById(id: string): Promise<string | null>;
-    setWorkstreamBinding(sessionId: string, workstreamId: string | null, source: import("../workstream/model.js").BindingSource | null, confidence: number | null): Promise<void>;
-    listSessionIdsByWorkstreams(workstreamIds: ReadonlyArray<string>): Promise<ReadonlyArray<string>>;
-    getEntities(sessionId: string): Promise<ReadonlyArray<string>>;
-    getWorkstreamIds(sessionIds: ReadonlyArray<string>): Promise<Map<string, string | null>>;
+    keywordSearch(tenantId: string, query: string, limit: number, opts?: SearchOptions): Promise<ReadonlyArray<KeywordNeighbor>>;
+    resolveSuccessors(tenantId: string, ids: ReadonlyArray<string>): Promise<Map<string, string>>;
+    updateStatus(tenantId: string, sessionId: string, status: SessionStatus): Promise<void>;
+    markSuperseded(tenantId: string, predecessorId: string, successorId: string): Promise<void>;
+    getSessionScopeById(tenantId: string, id: string): Promise<string | null>;
+    setWorkstreamBinding(tenantId: string, sessionId: string, workstreamId: string | null, source: import("../workstream/model.js").BindingSource | null, confidence: number | null): Promise<void>;
+    listSessionIdsByWorkstreams(tenantId: string, workstreamIds: ReadonlyArray<string>): Promise<ReadonlyArray<string>>;
+    getEntities(tenantId: string, sessionId: string): Promise<ReadonlyArray<string>>;
+    getWorkstreamIds(tenantId: string, sessionIds: ReadonlyArray<string>): Promise<Map<string, string | null>>;
     /** @internal test-only helper; production callers use insertSession(). */
-    insertSessionForTest(session: Session): void;
+    insertSessionForTest(session: Session, tenantId?: string): void;
     insertEdgeForTest(fromSession: string, toSession: string, kind?: "supersedes" | "continues"): void;
     insertEmbeddingForTest(sessionId: string, vector: Float32Array): void;
     insertChunkEmbeddingForTest(sessionId: string, chunkIdx: number, vector: Float32Array): void;