@memstack/core 0.7.3 → 0.8.1

package/dist/index.d.cts

@@ -1,4 +1,13 @@
-type MemoryType = "interaction" | "summary" | "observation" | "fact" | "reflection";
+type MemoryType = "interaction" | "summary" | "observation" | "fact" | "reflection" | "preference" | "decision" | "instruction";
+/** Where a memory came from. Harness writes store it in `metadata.source`. */
+interface MemorySource {
+    /** Harness that wrote the memory, e.g. "claude-code" or "codex". */
+    harness: string;
+    /** Project ID the memory belongs to. */
+    project: string;
+    sessionId?: string;
+    cwd?: string;
+}
 interface Memory {
     id: string;
     actorId: string;
@@ -85,6 +94,8 @@ interface MemoryRetrieveQuery {
     strategy?: "semantic" | "hybrid" | "recent" | "important";
     createdAfter?: Date;
     createdBefore?: Date;
+    /** Mark returned memories as accessed. Default true. Set false to read without side effects. */
+    touch?: boolean;
 }
 interface ContextOptions {
     actorId: string;
@@ -155,7 +166,30 @@ interface EmbeddingProvider {
     /** Maximum number of texts per embed() call. Default: 2048. */
     maxBatchSize?: number;
 }
+/** What a storage adapter can do beyond the required contract. Unset means unknown. */
+interface StorageCapabilities {
+    /** Several processes can read and write the same store at once without errors or lost writes. */
+    multiProcess?: boolean;
+    /** The adapter implements `search()` with native full-text search. */
+    textSearch?: boolean;
+}
+interface TextSearchQuery {
+    /** Namespaces to search, matched exactly against `actorId`. */
+    actorIds: string[];
+    query: string;
+    memoryTypes?: MemoryType[];
+    limit: number;
+}
+interface ScoredMemory {
+    memory: Memory;
+    /** Higher is more relevant. Only comparable within one result set. */
+    score: number;
+}
 interface StorageProvider {
+    /** Optional capability flags, used by harness setup and diagnostics. */
+    readonly capabilities?: StorageCapabilities;
+    /** Optional native full-text search. Core ranks memories itself when absent. */
+    search?(query: TextSearchQuery): Promise<ScoredMemory[]>;
     initialize(): Promise<void>;
     store(memory: MemoryStoreInput): Promise<Memory>;
     storeBatch(memories: MemoryStoreInput[]): Promise<Memory[]>;
@@ -275,11 +309,130 @@ declare class MemStack {
     health(): Promise<HealthStatus>;
     close(): Promise<void>;
     private _parseEnrichmentJson;
-    private _parseTagsJson;
-    /** Strip markdown code fences and extract the JSON payload from LLM output. */
-    private _extractJson;
 }
 
+interface RecallQuery {
+    /** Namespaces to recall from, matched exactly against `actorId`, e.g. `["project:abc", "global"]`. */
+    actorIds: string[];
+    /** Free text. When empty or without words, recall returns the fallback. */
+    query?: string;
+    memoryTypes?: MemoryType[];
+    /** Maximum memories returned. Default 10. */
+    limit?: number;
+    /** Maximum total characters of returned content. The top result is always returned. Default 8000. */
+    maxChars?: number;
+}
+interface RecallHit {
+    memory: Memory;
+    /** BM25 score, or 0 for fallback results. */
+    score: number;
+}
+interface RecallResult {
+    hits: RecallHit[];
+    /** True when nothing matched the query and the hits are the most important and recent memories. */
+    fallback: boolean;
+}
+interface LexicalRetrieverConfig {
+    /** Memories loaded per namespace for ranking, most important first. Default 2000. */
+    candidateLimit?: number;
+    /** Mark returned memories as accessed via `storage.touch`. Default true. */
+    touch?: boolean;
+}
+/**
+ * Recall that works on every storage adapter: memories in scope are loaded
+ * through `StorageProvider.retrieve` and ranked in Core with BM25 over
+ * content and tags. Adapters with native `search()` are used instead when
+ * they declare `textSearch`. Recall never calls an LLM.
+ */
+declare class LexicalRetriever {
+    private storage;
+    private candidateLimit;
+    private touch;
+    constructor(storage: StorageProvider, config?: LexicalRetrieverConfig);
+    recall(query: RecallQuery): Promise<RecallResult>;
+    private loadCandidates;
+    private touchAll;
+}
+
+interface HarnessMemoryConfig {
+    storage: StorageProvider;
+    llm: LLMProvider;
+    /** Ask the LLM for topic tags on every write. Default true. */
+    autoTags?: boolean;
+    /** Give up on tagging after this long and store the memory untagged. Default 10000. */
+    tagTimeoutMs?: number;
+    /** Longest content accepted by `remember`. Default 8000 characters. */
+    maxContentChars?: number;
+    /** Memories ranked per namespace on recall. Default 2000. */
+    candidateLimit?: number;
+    /** Called when tagging fails; the memory is still stored. */
+    onError?: (error: Error, context: string) => void;
+}
+interface RememberInput {
+    /** Namespace to write to, used as `actorId`, e.g. `project:<id>` or `global`. */
+    namespace: string;
+    content: string;
+    kind?: MemoryType;
+    importance?: number;
+    tags?: string[];
+    source: MemorySource;
+}
+interface HarnessRecallInput {
+    /** Namespaces to search together, e.g. `["project:<id>", "global"]`. */
+    namespaces: string[];
+    query?: string;
+    kinds?: MemoryType[];
+    limit?: number;
+    maxChars?: number;
+}
+/**
+ * Memory operations for agent harnesses such as Claude Code and Codex.
+ * Works on any storage adapter. Every read and delete is limited to the
+ * namespaces the caller passes, so one project cannot see another's memories.
+ * Recall never calls the LLM; only `remember` does, for tagging.
+ */
+declare class HarnessMemory {
+    private storage;
+    private llm;
+    private retriever;
+    private autoTags;
+    private tagTimeoutMs;
+    private maxContentChars;
+    private onError?;
+    private initialized?;
+    constructor(config: HarnessMemoryConfig);
+    remember(input: RememberInput): Promise<Memory>;
+    recall(input: HarnessRecallInput): Promise<RecallResult>;
+    /** The memory with this ID, or null when it does not exist or is outside `namespaces`. */
+    get(id: string, namespaces: string[]): Promise<Memory | null>;
+    /** Delete a memory. Memories outside `namespaces` are reported as not found. */
+    forget(id: string, namespaces: string[]): Promise<void>;
+    /** Number of memories in each namespace. */
+    stats(namespaces: string[]): Promise<Record<string, number>>;
+    /**
+     * Moves every memory from one namespace to another, keeping content,
+     * kind, importance, tags, provenance, and creation time. Memories get new
+     * IDs. Used when a project's ID changes, e.g. after its first commit.
+     * Safe to run from two processes at once: a copy whose original was
+     * already moved by the other process is removed again.
+     */
+    moveNamespace(from: string, to: string): Promise<number>;
+    /**
+     * Adopts memories a project stored under IDs it had before, such as
+     * before its first commit. Costs one count per previous ID when there is
+     * nothing to move. Returns the number of memories moved.
+     */
+    adoptProjects(previousIds: string[], projectId: string): Promise<number>;
+    private ensureInit;
+    private suggestTags;
+}
+
+declare const GLOBAL_NAMESPACE = "global";
+declare function projectNamespace(projectId: string): string;
+declare function sessionNamespace(projectId: string, sessionId: string): string;
+/** Namespaces a harness recalls from by default: the project, then global. */
+declare function defaultRecallNamespaces(projectId: string): string[];
+
 type MemStackErrorCode = "STORAGE_ERROR" | "EMBEDDING_ERROR" | "LLM_ERROR" | "VALIDATION_ERROR" | "NOT_FOUND" | "CONFIG_ERROR";
 declare class MemStackError extends Error {
     code: MemStackErrorCode;
@@ -296,6 +449,7 @@ declare function storageError(message: string, cause?: unknown): MemStackError;
 declare function configError(message: string): MemStackError;
 
 declare class InMemoryStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private memories;
     initialize(): Promise<void>;
     generateId(): string;
@@ -316,6 +470,7 @@ interface DiskStorageConfig {
     storageDir?: string;
 }
 declare class DiskStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private dir;
     private _writeLocks;
     private _idIndex;
@@ -352,6 +507,7 @@ interface MarkdownStorageConfig {
     oneFilePerActor?: boolean;
 }
 declare class MarkdownStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private dir;
     private oneFilePerActor;
     private _cache;
@@ -423,6 +579,7 @@ interface PostgresStorageConfig {
     ssl?: boolean | object;
 }
 declare class PostgresStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private pool;
     private table;
     private vectorDimensions;
@@ -463,6 +620,7 @@ interface RedisStorageConfig {
     keyPrefix?: string;
 }
 declare class RedisStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private redis;
     private prefix;
     constructor(config: RedisStorageConfig);
@@ -814,6 +972,7 @@ interface MongoDBStorageConfig {
     vectorDimensions?: number;
 }
 declare class MongoDBStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private collection;
     private vectorDimensions;
     constructor(config: MongoDBStorageConfig);
@@ -844,20 +1003,33 @@ type BetterSqlite3Db = {
         all(...params: unknown[]): unknown[];
     };
     close(): void;
+    inTransaction?: boolean;
 };
 interface SQLiteStorageConfig {
     db: BetterSqlite3Db;
     tableName?: string;
     vectorDimensions?: number;
+    /** How long a write waits for another connection's lock before failing. Default 5000. */
+    busyTimeoutMs?: number;
+    /** Use write-ahead logging so readers never block and writers queue. Default true. */
+    walMode?: boolean;
 }
 declare class SQLiteStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private db;
     private table;
     private vectorDimensions;
+    private busyTimeoutMs;
+    private walMode;
     constructor(config: SQLiteStorageConfig);
     initialize(): Promise<void>;
+    /** Schema version applied to this adapter's table, 0 if none. */
+    schemaVersion(): number;
+    private migrate;
+    private transaction;
     generateId(): string;
     store(input: MemoryStoreInput): Promise<Memory>;
+    private insert;
     storeBatch(inputs: MemoryStoreInput[]): Promise<Memory[]>;
     get(id: string): Promise<Memory | null>;
     delete(id: string): Promise<void>;
@@ -866,6 +1038,7 @@ declare class SQLiteStorageAdapter implements StorageProvider {
     retrieve(query: MemoryRetrieveQuery, embedding?: number[]): Promise<Memory[]>;
     count(filter?: MemoryCountFilter): Promise<number>;
     close(): Promise<void>;
+    private touchRows;
     private _rowToMemory;
 }
 
@@ -1056,4 +1229,4 @@ declare class GroqLLMAdapter implements LLMProvider {
     }>;
 }
 
-export { AnthropicLLMAdapter, type AnthropicLLMConfig, CohereEmbeddingAdapter, type CohereEmbeddingConfig, type CompiledContext, type ContextOptions, DiskStorageAdapter, type DiskStorageConfig, type EmbeddingProvider, GroqLLMAdapter, type GroqLLMConfig, type HealthStatus, HybridStorageAdapter, type HybridStorageConfig, InMemoryStorageAdapter, type LLMProvider, LanceDBStorageAdapter, type LanceDBStorageConfig, MarkdownStorageAdapter, type MarkdownStorageConfig, MemStack, type MemStackConfig, MemStackError, type MemStackErrorCode, type MemStackSnapshot, type Memory, type MemoryCountFilter, type MemoryRetrieveQuery, type MemoryStats, type MemoryStoreInput, type MemoryType, MongoDBStorageAdapter, type MongoDBStorageConfig, Neo4jStorageAdapter, type Neo4jStorageConfig, OllamaLLMAdapter, type OllamaLLMConfig, OpenAIEmbeddingAdapter, type OpenAIEmbeddingConfig, OpenAILLMAdapter, type OpenAILLMConfig, PostgresStorageAdapter, type PostgresStorageConfig, type ProcessInput, type ProcessResult, type PruneStrategy, QdrantStorageAdapter, type QdrantStorageConfig, RedisStorageAdapter, type RedisStorageConfig, SQLiteStorageAdapter, type SQLiteStorageConfig, type StorageProvider, type SummarizeOptions, WeaviateStorageAdapter, type WeaviateStorageConfig, configError, notFound, storageError, validationError };
+export { AnthropicLLMAdapter, type AnthropicLLMConfig, CohereEmbeddingAdapter, type CohereEmbeddingConfig, type CompiledContext, type ContextOptions, DiskStorageAdapter, type DiskStorageConfig, type EmbeddingProvider, GLOBAL_NAMESPACE, GroqLLMAdapter, type GroqLLMConfig, HarnessMemory, type HarnessMemoryConfig, type HarnessRecallInput, type HealthStatus, HybridStorageAdapter, type HybridStorageConfig, InMemoryStorageAdapter, type LLMProvider, LanceDBStorageAdapter, type LanceDBStorageConfig, LexicalRetriever, type LexicalRetrieverConfig, MarkdownStorageAdapter, type MarkdownStorageConfig, MemStack, type MemStackConfig, MemStackError, type MemStackErrorCode, type MemStackSnapshot, type Memory, type MemoryCountFilter, type MemoryRetrieveQuery, type MemorySource, type MemoryStats, type MemoryStoreInput, type MemoryType, MongoDBStorageAdapter, type MongoDBStorageConfig, Neo4jStorageAdapter, type Neo4jStorageConfig, OllamaLLMAdapter, type OllamaLLMConfig, OpenAIEmbeddingAdapter, type OpenAIEmbeddingConfig, OpenAILLMAdapter, type OpenAILLMConfig, PostgresStorageAdapter, type PostgresStorageConfig, type ProcessInput, type ProcessResult, type PruneStrategy, QdrantStorageAdapter, type QdrantStorageConfig, type RecallHit, type RecallQuery, type RecallResult, RedisStorageAdapter, type RedisStorageConfig, type RememberInput, SQLiteStorageAdapter, type SQLiteStorageConfig, type ScoredMemory, type StorageCapabilities, type StorageProvider, type SummarizeOptions, type TextSearchQuery, WeaviateStorageAdapter, type WeaviateStorageConfig, configError, defaultRecallNamespaces, notFound, projectNamespace, sessionNamespace, storageError, validationError };

package/dist/index.d.ts

@@ -1,4 +1,13 @@
-type MemoryType = "interaction" | "summary" | "observation" | "fact" | "reflection";
+type MemoryType = "interaction" | "summary" | "observation" | "fact" | "reflection" | "preference" | "decision" | "instruction";
+/** Where a memory came from. Harness writes store it in `metadata.source`. */
+interface MemorySource {
+    /** Harness that wrote the memory, e.g. "claude-code" or "codex". */
+    harness: string;
+    /** Project ID the memory belongs to. */
+    project: string;
+    sessionId?: string;
+    cwd?: string;
+}
 interface Memory {
     id: string;
     actorId: string;
@@ -85,6 +94,8 @@ interface MemoryRetrieveQuery {
     strategy?: "semantic" | "hybrid" | "recent" | "important";
     createdAfter?: Date;
     createdBefore?: Date;
+    /** Mark returned memories as accessed. Default true. Set false to read without side effects. */
+    touch?: boolean;
 }
 interface ContextOptions {
     actorId: string;
@@ -155,7 +166,30 @@ interface EmbeddingProvider {
     /** Maximum number of texts per embed() call. Default: 2048. */
     maxBatchSize?: number;
 }
+/** What a storage adapter can do beyond the required contract. Unset means unknown. */
+interface StorageCapabilities {
+    /** Several processes can read and write the same store at once without errors or lost writes. */
+    multiProcess?: boolean;
+    /** The adapter implements `search()` with native full-text search. */
+    textSearch?: boolean;
+}
+interface TextSearchQuery {
+    /** Namespaces to search, matched exactly against `actorId`. */
+    actorIds: string[];
+    query: string;
+    memoryTypes?: MemoryType[];
+    limit: number;
+}
+interface ScoredMemory {
+    memory: Memory;
+    /** Higher is more relevant. Only comparable within one result set. */
+    score: number;
+}
 interface StorageProvider {
+    /** Optional capability flags, used by harness setup and diagnostics. */
+    readonly capabilities?: StorageCapabilities;
+    /** Optional native full-text search. Core ranks memories itself when absent. */
+    search?(query: TextSearchQuery): Promise<ScoredMemory[]>;
     initialize(): Promise<void>;
     store(memory: MemoryStoreInput): Promise<Memory>;
     storeBatch(memories: MemoryStoreInput[]): Promise<Memory[]>;
@@ -275,11 +309,130 @@ declare class MemStack {
     health(): Promise<HealthStatus>;
     close(): Promise<void>;
     private _parseEnrichmentJson;
-    private _parseTagsJson;
-    /** Strip markdown code fences and extract the JSON payload from LLM output. */
-    private _extractJson;
 }
 
+interface RecallQuery {
+    /** Namespaces to recall from, matched exactly against `actorId`, e.g. `["project:abc", "global"]`. */
+    actorIds: string[];
+    /** Free text. When empty or without words, recall returns the fallback. */
+    query?: string;
+    memoryTypes?: MemoryType[];
+    /** Maximum memories returned. Default 10. */
+    limit?: number;
+    /** Maximum total characters of returned content. The top result is always returned. Default 8000. */
+    maxChars?: number;
+}
+interface RecallHit {
+    memory: Memory;
+    /** BM25 score, or 0 for fallback results. */
+    score: number;
+}
+interface RecallResult {
+    hits: RecallHit[];
+    /** True when nothing matched the query and the hits are the most important and recent memories. */
+    fallback: boolean;
+}
+interface LexicalRetrieverConfig {
+    /** Memories loaded per namespace for ranking, most important first. Default 2000. */
+    candidateLimit?: number;
+    /** Mark returned memories as accessed via `storage.touch`. Default true. */
+    touch?: boolean;
+}
+/**
+ * Recall that works on every storage adapter: memories in scope are loaded
+ * through `StorageProvider.retrieve` and ranked in Core with BM25 over
+ * content and tags. Adapters with native `search()` are used instead when
+ * they declare `textSearch`. Recall never calls an LLM.
+ */
+declare class LexicalRetriever {
+    private storage;
+    private candidateLimit;
+    private touch;
+    constructor(storage: StorageProvider, config?: LexicalRetrieverConfig);
+    recall(query: RecallQuery): Promise<RecallResult>;
+    private loadCandidates;
+    private touchAll;
+}
+
+interface HarnessMemoryConfig {
+    storage: StorageProvider;
+    llm: LLMProvider;
+    /** Ask the LLM for topic tags on every write. Default true. */
+    autoTags?: boolean;
+    /** Give up on tagging after this long and store the memory untagged. Default 10000. */
+    tagTimeoutMs?: number;
+    /** Longest content accepted by `remember`. Default 8000 characters. */
+    maxContentChars?: number;
+    /** Memories ranked per namespace on recall. Default 2000. */
+    candidateLimit?: number;
+    /** Called when tagging fails; the memory is still stored. */
+    onError?: (error: Error, context: string) => void;
+}
+interface RememberInput {
+    /** Namespace to write to, used as `actorId`, e.g. `project:<id>` or `global`. */
+    namespace: string;
+    content: string;
+    kind?: MemoryType;
+    importance?: number;
+    tags?: string[];
+    source: MemorySource;
+}
+interface HarnessRecallInput {
+    /** Namespaces to search together, e.g. `["project:<id>", "global"]`. */
+    namespaces: string[];
+    query?: string;
+    kinds?: MemoryType[];
+    limit?: number;
+    maxChars?: number;
+}
+/**
+ * Memory operations for agent harnesses such as Claude Code and Codex.
+ * Works on any storage adapter. Every read and delete is limited to the
+ * namespaces the caller passes, so one project cannot see another's memories.
+ * Recall never calls the LLM; only `remember` does, for tagging.
+ */
+declare class HarnessMemory {
+    private storage;
+    private llm;
+    private retriever;
+    private autoTags;
+    private tagTimeoutMs;
+    private maxContentChars;
+    private onError?;
+    private initialized?;
+    constructor(config: HarnessMemoryConfig);
+    remember(input: RememberInput): Promise<Memory>;
+    recall(input: HarnessRecallInput): Promise<RecallResult>;
+    /** The memory with this ID, or null when it does not exist or is outside `namespaces`. */
+    get(id: string, namespaces: string[]): Promise<Memory | null>;
+    /** Delete a memory. Memories outside `namespaces` are reported as not found. */
+    forget(id: string, namespaces: string[]): Promise<void>;
+    /** Number of memories in each namespace. */
+    stats(namespaces: string[]): Promise<Record<string, number>>;
+    /**
+     * Moves every memory from one namespace to another, keeping content,
+     * kind, importance, tags, provenance, and creation time. Memories get new
+     * IDs. Used when a project's ID changes, e.g. after its first commit.
+     * Safe to run from two processes at once: a copy whose original was
+     * already moved by the other process is removed again.
+     */
+    moveNamespace(from: string, to: string): Promise<number>;
+    /**
+     * Adopts memories a project stored under IDs it had before, such as
+     * before its first commit. Costs one count per previous ID when there is
+     * nothing to move. Returns the number of memories moved.
+     */
+    adoptProjects(previousIds: string[], projectId: string): Promise<number>;
+    private ensureInit;
+    private suggestTags;
+}
+
+declare const GLOBAL_NAMESPACE = "global";
+declare function projectNamespace(projectId: string): string;
+declare function sessionNamespace(projectId: string, sessionId: string): string;
+/** Namespaces a harness recalls from by default: the project, then global. */
+declare function defaultRecallNamespaces(projectId: string): string[];
+
 type MemStackErrorCode = "STORAGE_ERROR" | "EMBEDDING_ERROR" | "LLM_ERROR" | "VALIDATION_ERROR" | "NOT_FOUND" | "CONFIG_ERROR";
 declare class MemStackError extends Error {
     code: MemStackErrorCode;
@@ -296,6 +449,7 @@ declare function storageError(message: string, cause?: unknown): MemStackError;
 declare function configError(message: string): MemStackError;
 
 declare class InMemoryStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private memories;
     initialize(): Promise<void>;
     generateId(): string;
@@ -316,6 +470,7 @@ interface DiskStorageConfig {
     storageDir?: string;
 }
 declare class DiskStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private dir;
     private _writeLocks;
     private _idIndex;
@@ -352,6 +507,7 @@ interface MarkdownStorageConfig {
     oneFilePerActor?: boolean;
 }
 declare class MarkdownStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private dir;
     private oneFilePerActor;
     private _cache;
@@ -423,6 +579,7 @@ interface PostgresStorageConfig {
     ssl?: boolean | object;
 }
 declare class PostgresStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private pool;
     private table;
     private vectorDimensions;
@@ -463,6 +620,7 @@ interface RedisStorageConfig {
     keyPrefix?: string;
 }
 declare class RedisStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private redis;
     private prefix;
     constructor(config: RedisStorageConfig);
@@ -814,6 +972,7 @@ interface MongoDBStorageConfig {
     vectorDimensions?: number;
 }
 declare class MongoDBStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private collection;
     private vectorDimensions;
     constructor(config: MongoDBStorageConfig);
@@ -844,20 +1003,33 @@ type BetterSqlite3Db = {
         all(...params: unknown[]): unknown[];
     };
     close(): void;
+    inTransaction?: boolean;
 };
 interface SQLiteStorageConfig {
     db: BetterSqlite3Db;
     tableName?: string;
     vectorDimensions?: number;
+    /** How long a write waits for another connection's lock before failing. Default 5000. */
+    busyTimeoutMs?: number;
+    /** Use write-ahead logging so readers never block and writers queue. Default true. */
+    walMode?: boolean;
 }
 declare class SQLiteStorageAdapter implements StorageProvider {
+    readonly capabilities: StorageCapabilities;
     private db;
     private table;
     private vectorDimensions;
+    private busyTimeoutMs;
+    private walMode;
     constructor(config: SQLiteStorageConfig);
     initialize(): Promise<void>;
+    /** Schema version applied to this adapter's table, 0 if none. */
+    schemaVersion(): number;
+    private migrate;
+    private transaction;
     generateId(): string;
     store(input: MemoryStoreInput): Promise<Memory>;
+    private insert;
     storeBatch(inputs: MemoryStoreInput[]): Promise<Memory[]>;
     get(id: string): Promise<Memory | null>;
     delete(id: string): Promise<void>;
@@ -866,6 +1038,7 @@ declare class SQLiteStorageAdapter implements StorageProvider {
     retrieve(query: MemoryRetrieveQuery, embedding?: number[]): Promise<Memory[]>;
     count(filter?: MemoryCountFilter): Promise<number>;
     close(): Promise<void>;
+    private touchRows;
     private _rowToMemory;
 }
 
@@ -1056,4 +1229,4 @@ declare class GroqLLMAdapter implements LLMProvider {
     }>;
 }
 
-export { AnthropicLLMAdapter, type AnthropicLLMConfig, CohereEmbeddingAdapter, type CohereEmbeddingConfig, type CompiledContext, type ContextOptions, DiskStorageAdapter, type DiskStorageConfig, type EmbeddingProvider, GroqLLMAdapter, type GroqLLMConfig, type HealthStatus, HybridStorageAdapter, type HybridStorageConfig, InMemoryStorageAdapter, type LLMProvider, LanceDBStorageAdapter, type LanceDBStorageConfig, MarkdownStorageAdapter, type MarkdownStorageConfig, MemStack, type MemStackConfig, MemStackError, type MemStackErrorCode, type MemStackSnapshot, type Memory, type MemoryCountFilter, type MemoryRetrieveQuery, type MemoryStats, type MemoryStoreInput, type MemoryType, MongoDBStorageAdapter, type MongoDBStorageConfig, Neo4jStorageAdapter, type Neo4jStorageConfig, OllamaLLMAdapter, type OllamaLLMConfig, OpenAIEmbeddingAdapter, type OpenAIEmbeddingConfig, OpenAILLMAdapter, type OpenAILLMConfig, PostgresStorageAdapter, type PostgresStorageConfig, type ProcessInput, type ProcessResult, type PruneStrategy, QdrantStorageAdapter, type QdrantStorageConfig, RedisStorageAdapter, type RedisStorageConfig, SQLiteStorageAdapter, type SQLiteStorageConfig, type StorageProvider, type SummarizeOptions, WeaviateStorageAdapter, type WeaviateStorageConfig, configError, notFound, storageError, validationError };
+export { AnthropicLLMAdapter, type AnthropicLLMConfig, CohereEmbeddingAdapter, type CohereEmbeddingConfig, type CompiledContext, type ContextOptions, DiskStorageAdapter, type DiskStorageConfig, type EmbeddingProvider, GLOBAL_NAMESPACE, GroqLLMAdapter, type GroqLLMConfig, HarnessMemory, type HarnessMemoryConfig, type HarnessRecallInput, type HealthStatus, HybridStorageAdapter, type HybridStorageConfig, InMemoryStorageAdapter, type LLMProvider, LanceDBStorageAdapter, type LanceDBStorageConfig, LexicalRetriever, type LexicalRetrieverConfig, MarkdownStorageAdapter, type MarkdownStorageConfig, MemStack, type MemStackConfig, MemStackError, type MemStackErrorCode, type MemStackSnapshot, type Memory, type MemoryCountFilter, type MemoryRetrieveQuery, type MemorySource, type MemoryStats, type MemoryStoreInput, type MemoryType, MongoDBStorageAdapter, type MongoDBStorageConfig, Neo4jStorageAdapter, type Neo4jStorageConfig, OllamaLLMAdapter, type OllamaLLMConfig, OpenAIEmbeddingAdapter, type OpenAIEmbeddingConfig, OpenAILLMAdapter, type OpenAILLMConfig, PostgresStorageAdapter, type PostgresStorageConfig, type ProcessInput, type ProcessResult, type PruneStrategy, QdrantStorageAdapter, type QdrantStorageConfig, type RecallHit, type RecallQuery, type RecallResult, RedisStorageAdapter, type RedisStorageConfig, type RememberInput, SQLiteStorageAdapter, type SQLiteStorageConfig, type ScoredMemory, type StorageCapabilities, type StorageProvider, type SummarizeOptions, type TextSearchQuery, WeaviateStorageAdapter, type WeaviateStorageConfig, configError, defaultRecallNamespaces, notFound, projectNamespace, sessionNamespace, storageError, validationError };