nlm-memory 0.20.1 → 0.21.12

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

@@ -10,9 +10,19 @@
  * 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, SessionFilter, SessionStore } from "../../ports/session-store.js";
+import type { KeywordNeighbor, SearchOptions, SemanticNeighbor, SessionStore } from "../../ports/session-store.js";
 import type { Session, SessionStatus, SessionEdgeKind } from "../../shared/types.js";
 import type { Fact } from "../../shared/types.js";
 import type { SqliteFactStore } from "./sqlite-fact-store.js";
@@ -45,6 +55,26 @@ export interface IngestRecord {
         readonly model: string;
         readonly confidence: number;
     };
+    readonly scope: string | null;
+    /**
+     * Subagent persona slug / "orchestrator" / runtime name, or the runtime
+     * name for non-claude-code runtimes. Optional: callers with no chunk to
+     * derive from (reprocess, reclassify-oversized) omit it and COALESCE in
+     * the upsert preserves whatever a prior classify-time stamp wrote.
+     */
+    readonly agentPersona?: string | null;
+    /** RUNTIME parent session id (join key against runtime_session_id). Same omit/COALESCE contract as agentPersona. */
+    readonly parentSessionId?: string | null;
+    /**
+     * Majority model across assistant messages in the transcript (claude-code
+     * jsonl only, v1), from scanTranscriptDerivables. NULL when not derivable.
+     * Same omit/COALESCE contract as agentPersona.
+     */
+    readonly primaryModel?: string | null;
+    /** Sum of input_tokens + output_tokens across assistant messages. Same omit/COALESCE contract as agentPersona. */
+    readonly totalTokens?: number | null;
+    /** Slug of the first Skill-tool invocation in the transcript, or null. Same omit/COALESCE contract as agentPersona. */
+    readonly skill?: string | null;
 }
 /**
  * Supersedence target for insertSession. `kind` selects the relation:
@@ -93,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
@@ -114,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
@@ -128,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>;
@@ -139,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
@@ -152,24 +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;
-    list(filter?: SessionFilter): Promise<ReadonlyArray<Session>>;
-    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
@@ -177,16 +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>;
-    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;