@cogitator-ai/memory 0.10.0 → 0.11.1

package/README.md

@@ -15,6 +15,8 @@ pnpm add mongodb  # For MongoDB adapter
 pnpm add @qdrant/js-client-rest  # For Qdrant embedding adapter
 ```
 
+With `@cogitator-ai/core` you usually configure memory on the runtime (`new Cogitator({ memory: { adapter: 'postgres', postgres: { ... } } })`) and read it with `await cog.getMemory()`; the adapters below are for direct use. Website docs: [Memory](https://cogitator.app/docs/memory), [Adapters](https://cogitator.app/docs/memory/adapters), [Embeddings](https://cogitator.app/docs/memory/embeddings), [Hybrid Search](https://cogitator.app/docs/memory/hybrid-search), [Knowledge Graphs](https://cogitator.app/docs/memory/knowledge-graphs).
+
 ## Features
 
 - **Multiple Adapters** - In-memory, Redis (standalone + cluster), PostgreSQL with pgvector, SQLite, MongoDB, Qdrant
@@ -24,10 +26,10 @@ pnpm add @qdrant/js-client-rest  # For Qdrant embedding adapter
 - **Context Builder** - Token-aware context with `recent`, `relevant` (embedding-ranked) and `hybrid` strategies
 - **Scoped Semantic Memory** - Embeddings tagged with `metadata.agentId` / `metadata.threadId` never leak to other agents
 - **Sessions & Compaction** - `SessionManager` for channel sessions, `CompactionService` for summarizing long histories
-- **Embedding Services** - OpenAI and Ollama embedding integration
+- **Embedding Services** - OpenAI, Ollama and Google embedding integration
 - **Semantic Search** - Vector similarity search with pgvector
 - **Hybrid Search** - BM25 + Vector with Reciprocal Rank Fusion
-- **Facts Storage** - Store and retrieve agent knowledge
+- **Facts Storage** - Store and retrieve agent knowledge (`FactAdapter` on PostgreSQL, `CoreFactsStore` on SQLite)
 - **Knowledge Graph** - Entity-relationship memory with multi-hop traversal
 - **Zod Schemas** - Type-safe configuration validation
 
@@ -46,11 +48,13 @@ const thread = unwrap(await memory.createThread('agent-1', { topic: 'greeting' }
 await memory.addEntry({
   threadId: thread.id,
   message: { role: 'user', content: 'Hello!' },
+  tokenCount: 2,
 });
 
 await memory.addEntry({
   threadId: thread.id,
   message: { role: 'assistant', content: 'Hi there!' },
+  tokenCount: 3,
 });
 
 const builder = new ContextBuilder(
@@ -67,7 +71,16 @@ const context = await builder.build({
 console.log(context.messages);
 ```
 
-Adapter calls return a `MemoryResult` — `{ success: true, data }` or `{ success: false, error }` — instead of throwing. `unwrap(result)` returns the data or throws an `Error` with the adapter's message; check `result.success` yourself where a failure is expected.
+Adapter calls return a `MemoryResult` — `{ success: true, data }` or `{ success: false, error }` — instead of throwing. `unwrap(result)` returns the data or throws an `Error` with the adapter's message; check `result.success` yourself where a failure is expected:
+
+```typescript
+const result = await memory.getThread('thread_123');
+if (!result.success) {
+  console.error('Memory unavailable:', result.error);
+} else if (result.data) {
+  console.log(result.data.metadata);
+}
+```
 
 ---
 
@@ -124,6 +137,8 @@ const memory = new PostgresAdapter({
 await memory.connect();
 ```
 
+On `connect()` the adapter creates its tables and an HNSW cosine index on the embeddings, which works from the first row on (no training data needed). An `ivfflat` index left by an earlier version is replaced on the first connect after upgrading, see the [adapters docs](https://cogitator.app/docs/memory/adapters) for building the new index ahead of time on a large table. `search()` raises `hnsw.ef_search` to the requested limit and, on pgvector 0.8+, uses iterative scans, so large limits and filters still get every matching row. Messages, tool calls, tool results and metadata are stored as `jsonb`.
+
 ### SQLite Adapter
 
 ```typescript
@@ -131,9 +146,11 @@ import { SQLiteAdapter } from '@cogitator-ai/memory';
 
 const memory = new SQLiteAdapter({
   provider: 'sqlite',
-  path: './cogitator.db',
+  path: './cogitator.db', // ':memory:' for an in-memory database
   walMode: true,
 });
+
+await memory.connect();
 ```
 
 ### MongoDB Adapter
@@ -146,8 +163,12 @@ const memory = new MongoDBAdapter({
   uri: 'mongodb://localhost:27017',
   database: 'cogitator',
 });
+
+await memory.connect();
 ```
 
+Threads and entries live in the `<collectionPrefix>threads` and `<collectionPrefix>entries` collections (prefix `memory_` by default), indexed on `agentId` and `(threadId, createdAt)`. Fields left `undefined` are omitted from the stored documents, not stored as `null`. A failed `connect()` leaves the adapter disconnected, so a later `connect()` retries.
+
 ### Qdrant Adapter (Embedding)
 
 ```typescript
@@ -159,8 +180,12 @@ const embeddings = new QdrantAdapter({
   collection: 'cogitator',
   dimensions: 1536,
 });
+
+await embeddings.connect();
 ```
 
+`QdrantAdapter` is an `EmbeddingAdapter` (store and search vectors), not a thread store; pair it with one of the adapters above. Points are stored under a deterministic UUID derived from the embedding id (Qdrant accepts only integer and UUID point ids); the `emb_…` id stays in `payload.embeddingId` and is what `search` returns.
+
 ### Factory Function
 
 ```typescript
@@ -187,8 +212,13 @@ const qdrant = await createEmbeddingAdapter({
   provider: 'qdrant',
   dimensions: 1536,
 });
+
+await postgres.connect(); // the factories create adapters; connect them before use
+await qdrant.connect(); // typed as ConnectableEmbeddingAdapter, no cast needed
 ```
 
+`createMemoryAdapter` loads the adapter's driver lazily, so only the drivers you use need to be installed.
+
 ---
 
 ## MemoryAdapter Interface
@@ -220,13 +250,14 @@ interface MemoryAdapter {
 `createThread(agentId, metadata, threadId)` with an existing `threadId` is an upsert: entries and `createdAt` are kept and only the metadata is updated, so it is safe to call on every run.
 
 ```typescript
-const result = await memory.createThread('agent-1', {
-  topic: 'support',
-  user: 'user-123',
-});
-const thread = result.data!;
+const thread = unwrap(
+  await memory.createThread('agent-1', {
+    topic: 'support',
+    user: 'user-123',
+  })
+);
 
-const threadResult = await memory.getThread(thread.id);
+const found = unwrap(await memory.getThread(thread.id)); // Thread | null
 
 await memory.updateThread(thread.id, {
   resolved: true,
@@ -238,21 +269,26 @@ await memory.deleteThread(thread.id);
 ### Entry Operations
 
 ```typescript
-const entry = await memory.addEntry({
-  threadId: thread.id,
-  message: { role: 'user', content: 'Hello' },
-  tokenCount: 10,
-});
+const entry = unwrap(
+  await memory.addEntry({
+    threadId: thread.id,
+    message: { role: 'user', content: 'Hello' },
+    tokenCount: 10,
+  })
+);
 
-const entries = await memory.getEntries({
-  threadId: thread.id,
-  limit: 50,
-  includeToolCalls: true,
-});
+const entries = unwrap(
+  await memory.getEntries({
+    threadId: thread.id,
+    limit: 50, // the most recent 50, oldest first
+    includeToolCalls: true,
+    // before / after: Date bounds
+  })
+);
 
-const single = await memory.getEntry(entry.data!.id);
+const single = unwrap(await memory.getEntry(entry.id));
 
-await memory.deleteEntry(entry.data!.id);
+await memory.deleteEntry(entry.id);
 
 await memory.clearThread(thread.id);
 ```
@@ -273,12 +309,14 @@ interface ContextBuilderConfig {
   includeSystemPrompt?: boolean;
   includeFacts?: boolean;
   includeSemanticContext?: boolean;
+  includeGraphContext?: boolean;
+  graphContextOptions?: GraphContextOptions;
 }
 ```
 
 Strategies:
 
-- `recent` - newest messages that fit into the token budget
+- `recent` - the newest messages that fit into the token budget, as one unbroken run: the window stops at the first message that does not fit, so a reply never appears without the message it answers
 - `relevant` - messages ranked by embedding similarity to `currentInput` (requires `embeddingService`; falls back to `recent` without input), returned in chronological order
 - `hybrid` - always keeps the latest messages and fills the remaining budget with the most relevant older ones
 
@@ -346,6 +384,7 @@ interface BuiltContext {
   messages: Message[];
   facts: Fact[];
   semanticResults: (Embedding & { score: number })[];
+  graphContext?: GraphContext; // with includeGraphContext and a graph adapter
   tokenCount: number;
   truncated: boolean;
   metadata: {
@@ -364,12 +403,26 @@ interface BuiltContext {
 `SessionManager` maps channel conversations (user + channel + agent) onto memory threads. `CompactionService` replaces old history with an LLM summary placed before the most recent messages.
 
 ```typescript
+import { createLLMBackend } from '@cogitator-ai/core';
 import { InMemoryAdapter, SessionManager, CompactionService } from '@cogitator-ai/memory';
 
 const memory = new InMemoryAdapter();
+const llm = createLLMBackend('google', {
+  providers: { google: { apiKey: process.env.GOOGLE_API_KEY! } },
+});
+
 const compaction = new CompactionService({
   adapter: memory,
-  summarize: async (messages) => `Summary of ${messages.length} messages`,
+  summarize: async (messages, { model, prompt } = {}) => {
+    const response = await llm.chat({
+      model: model ?? 'gemini-3.5-flash-lite',
+      messages: [
+        { role: 'system', content: prompt ?? 'Summarize this conversation in a few sentences.' },
+        ...messages,
+      ],
+    });
+    return response.content;
+  },
 });
 const sessions = new SessionManager(memory, { compaction });
 
@@ -383,10 +436,36 @@ const session = await sessions.getOrCreate({
 const all = await sessions.list();
 const mine = await sessions.list({ userId: 'user-1', status: 'active', limit: 20 });
 
-await sessions.compact(session.id, { strategy: 'summary', threshold: 8000, keepRecent: 10 });
+await sessions.compact(session.id, {
+  strategy: 'summary',
+  threshold: 8000,
+  keepRecent: 10,
+  summaryModel: 'gemini-3.5-flash',
+  summaryPrompt: 'Keep names, decisions and open questions.',
+});
 ```
 
-`list()` works with or without a `userId` filter (sessions are tracked in an index thread). `compact()` requires the `compaction` option; without it use `CompactionService` directly.
+`list()` works with or without a `userId` filter (sessions are tracked in an index thread). `compact()` requires the `compaction` option; without it use `CompactionService` directly. The summarizer (`SummarizeFn`) is called as `summarize(messages, options)`, where `options` is a `SummarizeOptions` `{ model?, prompt? }` filled from the `summaryModel` / `summaryPrompt` of the compaction config.
+
+---
+
+## Core Facts
+
+`CoreFactsStore` keeps a small set of key/value facts about the user in SQLite (with history), formatted for a system prompt:
+
+```typescript
+import { CoreFactsStore } from '@cogitator-ai/memory';
+
+const facts = new CoreFactsStore({ path: './facts.db' }); // or { db } to share a better-sqlite3 database
+await facts.initialize();
+
+await facts.set('name', 'Alice');
+await facts.get('name'); // 'Alice'
+await facts.getAll(); // { name: 'Alice' }
+await facts.getHistory('name'); // [{ value, setAt }]
+const prompt = await facts.formatForPrompt();
+await facts.close();
+```
 
 ---
 
@@ -425,10 +504,12 @@ import { OpenAIEmbeddingService, createEmbeddingService } from '@cogitator-ai/me
 
 const embeddings = new OpenAIEmbeddingService({
   apiKey: process.env.OPENAI_API_KEY!,
-  model: 'text-embedding-3-small',
+  model: 'text-embedding-3-small', // default
+  dimensions: 512, // optional, sent to text-embedding-3 models (gateway ids like openai/text-embedding-3-small too)
 });
 
-const embeddings = createEmbeddingService({
+// or through the factory
+const viaFactory = createEmbeddingService({
   provider: 'openai',
   apiKey: process.env.OPENAI_API_KEY!,
 });
@@ -438,6 +519,8 @@ const vector = await embeddings.embed('Hello, world!');
 const vectors = await embeddings.embedBatch(['Hello', 'World']);
 ```
 
+For other models `dimensions` declares the size they return. When a response holds vectors of another size than the configured `dimensions`, `embed()` and `embedBatch()` throw instead of handing them to a store sized for it.
+
 ### Ollama Embeddings
 
 ```typescript
@@ -448,7 +531,7 @@ const embeddings = new OllamaEmbeddingService({
   baseUrl: 'http://localhost:11434',
 });
 
-const embeddings = createEmbeddingService({
+const viaFactory = createEmbeddingService({
   provider: 'ollama',
   model: 'nomic-embed-text',
 });
@@ -467,7 +550,7 @@ const embeddings = new GoogleEmbeddingService({
   dimensions: 768,
 });
 
-const embeddings = createEmbeddingService({
+const viaFactory = createEmbeddingService({
   provider: 'google',
   apiKey: process.env.GOOGLE_API_KEY!,
 });
@@ -530,15 +613,15 @@ const hybridResults = await search.search({
 });
 
 // Results include both scores
-hybridResults.data.forEach((result) => {
+for (const result of unwrap(hybridResults)) {
   console.log(`${result.content} — score: ${result.score}`);
   console.log(`  vector: ${result.vectorScore}, keyword: ${result.keywordScore}`);
-});
+}
 ```
 
 ### Document Indexing
 
-For keyword search, documents must be indexed:
+With a `keywordAdapter`, keyword search runs on that adapter's own index (embeddings added to `InMemoryEmbeddingAdapter` or `PostgresAdapter` are searchable right away). Without one, `HybridSearch` keeps a local BM25 index that you fill yourself (it ignores `filter`):
 
 ```typescript
 // Add documents to BM25 index
@@ -653,12 +736,12 @@ import type {
 ### Conversation History
 
 ```typescript
-import { InMemoryAdapter } from '@cogitator-ai/memory';
+import { InMemoryAdapter, countMessageTokens, unwrap } from '@cogitator-ai/memory';
 
 const memory = new InMemoryAdapter();
 await memory.connect();
 
-const thread = await memory.createThread('chatbot');
+const thread = unwrap(await memory.createThread('chatbot'));
 
 const messages = [
   { role: 'user' as const, content: 'What is AI?' },
@@ -668,15 +751,18 @@ const messages = [
 
 for (const msg of messages) {
   await memory.addEntry({
-    threadId: thread.data!.id,
+    threadId: thread.id,
     message: msg,
+    tokenCount: countMessageTokens(msg),
   });
 }
 
-const history = await memory.getEntries({
-  threadId: thread.data!.id,
-  limit: 10,
-});
+const history = unwrap(
+  await memory.getEntries({
+    threadId: thread.id,
+    limit: 10,
+  })
+);
 ```
 
 ### Token-Limited Context
@@ -708,7 +794,7 @@ console.log(
 ### Semantic Memory with PostgreSQL
 
 ```typescript
-import { PostgresAdapter, OpenAIEmbeddingService } from '@cogitator-ai/memory';
+import { PostgresAdapter, OpenAIEmbeddingService, unwrap } from '@cogitator-ai/memory';
 
 const memory = new PostgresAdapter({
   provider: 'postgres',
@@ -722,7 +808,22 @@ const embeddings = new OpenAIEmbeddingService({
 await memory.connect();
 
 const content = 'Machine learning is a subset of AI...';
-const vector = await embeddings.embed(content);
+await memory.addEmbedding({
+  sourceId: 'doc-1',
+  sourceType: 'document',
+  content,
+  vector: await embeddings.embed(content),
+  metadata: { agentId: 'agent-1' },
+});
+
+const matches = unwrap(
+  await memory.search({
+    vector: await embeddings.embed('What is ML?'),
+    limit: 5,
+    threshold: 0.7,
+    filter: { agentId: 'agent-1' },
+  })
+);
 ```
 
 ---
@@ -733,32 +834,39 @@ Entity-relationship memory with multi-hop traversal and semantic reasoning.
 
 ### PostgresGraphAdapter
 
-```typescript
-import { PostgresGraphAdapter } from '@cogitator-ai/memory';
+Graph adapters return `MemoryResult`s like the memory adapters. `PostgresGraphAdapter` takes an existing `pg` pool and creates its tables on first use; `SQLiteGraphAdapter` takes `{ path, walMode? }`.
 
-const graph = new PostgresGraphAdapter({
-  connectionString: process.env.DATABASE_URL!,
-});
+```typescript
+import { PostgresGraphAdapter, unwrap } from '@cogitator-ai/memory';
+import pg from 'pg';
 
-await graph.connect();
+const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });
+const graph = new PostgresGraphAdapter({ pool, vectorDimensions: 1536 }); // default 768
 
-const person = await graph.addNode({
-  agentId: 'agent-1',
-  type: 'person',
-  name: 'Alice',
-  description: 'Software engineer',
-  properties: { role: 'developer' },
-  confidence: 1.0,
-  source: 'user',
-});
+const person = unwrap(
+  await graph.addNode({
+    agentId: 'agent-1',
+    type: 'person',
+    name: 'Alice',
+    aliases: [],
+    description: 'Software engineer',
+    properties: { role: 'developer' },
+    confidence: 1.0,
+    source: 'user',
+  })
+);
 
-const company = await graph.addNode({
-  agentId: 'agent-1',
-  type: 'organization',
-  name: 'TechCorp',
-  confidence: 1.0,
-  source: 'extracted',
-});
+const company = unwrap(
+  await graph.addNode({
+    agentId: 'agent-1',
+    type: 'organization',
+    name: 'TechCorp',
+    aliases: [],
+    properties: {},
+    confidence: 1.0,
+    source: 'extracted',
+  })
+);
 
 await graph.addEdge({
   agentId: 'agent-1',
@@ -766,6 +874,8 @@ await graph.addEdge({
   targetNodeId: company.id,
   type: 'works_at',
   weight: 1.0,
+  bidirectional: false,
+  properties: {},
   confidence: 0.95,
   source: 'extracted',
 });
@@ -774,12 +884,15 @@ await graph.addEdge({
 ### Multi-hop Traversal
 
 ```typescript
-const result = await graph.traverse({
-  startNodeId: person.id,
-  maxDepth: 3,
-  direction: 'outgoing',
-  edgeTypes: ['works_at', 'knows', 'located_in'],
-});
+const result = unwrap(
+  await graph.traverse({
+    agentId: 'agent-1',
+    startNodeId: person.id,
+    maxDepth: 3,
+    direction: 'outgoing', // 'outgoing' | 'incoming' | 'both'
+    edgeTypes: ['works_at', 'knows', 'located_in'],
+  })
+);
 
 console.log('Visited nodes:', result.visitedNodes);
 console.log('Paths found:', result.paths);
@@ -788,7 +901,7 @@ console.log('Paths found:', result.paths);
 ### Shortest Path
 
 ```typescript
-const path = await graph.findShortestPath(startNodeId, endNodeId);
+const path = unwrap(await graph.findShortestPath('agent-1', person.id, company.id, 5));
 if (path) {
   console.log('Path:', path.nodes.map((n) => n.name).join(' -> '));
   console.log('Total weight:', path.totalWeight);
@@ -798,12 +911,14 @@ if (path) {
 ### Semantic Node Search
 
 ```typescript
-const similar = await graph.searchNodesSemantic({
-  agentId: 'agent-1',
-  query: 'machine learning engineer',
-  limit: 10,
-  threshold: 0.7,
-});
+const similar = unwrap(
+  await graph.searchNodesSemantic({
+    agentId: 'agent-1',
+    vector: await embeddingService.embed('machine learning engineer'), // a vector is required
+    limit: 10,
+    threshold: 0.7,
+  })
+); // nodes with a `score`
 ```
 
 ### LLM Entity Extraction
@@ -811,32 +926,39 @@ const similar = await graph.searchNodesSemantic({
 ```typescript
 import { LLMEntityExtractor } from '@cogitator-ai/memory';
 
-const extractor = new LLMEntityExtractor(llmBackend, {
+const backend = cog.getLLMBackend('openai/gpt-5.5');
+
+const extractor = new LLMEntityExtractor(backend, {
+  model: 'gpt-5.5', // required with an LLMBackend
   minConfidence: 0.7,
   maxEntitiesPerText: 20,
+  maxRelationsPerText: 30,
 });
 
 const result = await extractor.extract(
-  'Alice works at TechCorp in San Francisco. She knows Bob from the AI conference.'
+  'Alice works at TechCorp in San Francisco. She knows Bob from the AI conference.',
+  { agentId: 'agent-1' }
 );
 
 console.log('Entities:', result.entities);
 console.log('Relations:', result.relations);
 ```
 
+Any object with a `chat({ model?, messages, responseFormat })` method resolving to `{ content }` (`LLMBackendMinimal`) also works as the first argument; there `model` is optional and, when set, is passed through in each request.
+
 ### Graph Inference Engine
 
 ```typescript
 import { GraphInferenceEngine } from '@cogitator-ai/memory';
 
-const engine = new GraphInferenceEngine(graph, {
-  minConfidence: 0.5,
-  maxInferredEdges: 100,
-});
+const engine = new GraphInferenceEngine(graph); // built-in rules; pass false to start without them
+
+const inferred = await engine.infer('agent-1', { minConfidence: 0.5, maxInferences: 100 });
+for (const edge of inferred) {
+  console.log(edge.type, edge.sourceNodeId, '->', edge.targetNodeId, 'via rule', edge.ruleId);
+}
 
-const inferred = await engine.infer('agent-1');
-console.log('Inferred edges:', inferred.edges);
-console.log('Rules applied:', inferred.rulesApplied);
+await engine.materialize(inferred); // store them as edges
 ```
 
 ### Graph Context Builder
@@ -850,13 +972,14 @@ const contextBuilder = new GraphContextBuilder(graph, embeddingService, {
   includeInferred: true,
 });
 
-const context = await contextBuilder.buildContext({
-  agentId: 'agent-1',
-  query: 'Tell me about Alice and her work',
+const context = await contextBuilder.buildContext('agent-1', 'Tell me about Alice and her work', {
+  maxDepth: 2,
+  userId: 'user-1', // leave out other users' nodes (metadata.userId)
 });
 
 console.log('Relevant nodes:', context.nodes);
 console.log('Relationships:', context.edges);
+console.log(context.formattedContext); // ready for a system prompt
 ```
 
 ---

package/dist/adapters/index.d.ts

@@ -1,11 +1,19 @@
 /**
  * Memory adapter exports and factory
  */
-import type { MemoryAdapter, EmbeddingAdapter, InMemoryAdapterConfig, RedisAdapterConfig, PostgresAdapterConfig, SQLiteAdapterConfig, MongoDBAdapterConfig, QdrantAdapterConfig } from '@cogitator-ai/types';
+import type { MemoryAdapter, MemoryResult, EmbeddingAdapter, InMemoryAdapterConfig, RedisAdapterConfig, PostgresAdapterConfig, SQLiteAdapterConfig, MongoDBAdapterConfig, QdrantAdapterConfig } from '@cogitator-ai/types';
 export { BaseMemoryAdapter } from './base.js';
 export { InMemoryAdapter } from './memory.js';
 export type MemoryAdapterConfigUnion = InMemoryAdapterConfig | RedisAdapterConfig | PostgresAdapterConfig | SQLiteAdapterConfig | MongoDBAdapterConfig;
 export type EmbeddingAdapterConfigUnion = QdrantAdapterConfig;
+/**
+ * An embedding store that talks to a server, as `createEmbeddingAdapter` returns it: call
+ * `connect()` before the first operation and `disconnect()` when done.
+ */
+export interface ConnectableEmbeddingAdapter extends EmbeddingAdapter {
+    connect(): Promise<MemoryResult<void>>;
+    disconnect(): Promise<MemoryResult<void>>;
+}
 export declare function createMemoryAdapter(config: MemoryAdapterConfigUnion): Promise<MemoryAdapter>;
-export declare function createEmbeddingAdapter(config: EmbeddingAdapterConfigUnion): Promise<EmbeddingAdapter>;
+export declare function createEmbeddingAdapter(config: EmbeddingAdapterConfigUnion): Promise<ConnectableEmbeddingAdapter>;
 //# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,wBAAwB,GAChC,qBAAqB,GACrB,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,GACnB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;AAE9D,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,aAAa,CAAC,CAgCxB;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAO3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,wBAAwB,GAChC,qBAAqB,GACrB,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,GACnB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACnE,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;CAC3C;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,aAAa,CAAC,CAgCxB;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,2BAA2B,CAAC,CAOtC"}

package/dist/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAW3C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAgC;IAEhC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ;YACX,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QAErC,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YACjD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YACvD,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YACnD,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QAED,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YACrD,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,MAAM,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,4BAA6B,UAAuC,CAAC,QAAQ,EAAE,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAmC;IAEnC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YACnD,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAoB3C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAgC;IAEhC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ;YACX,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QAErC,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YACjD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YACvD,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YACnD,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QAED,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YACrD,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,MAAM,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,4BAA6B,UAAuC,CAAC,QAAQ,EAAE,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAmC;IAEnC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YACnD,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/adapters/mongodb.d.ts

@@ -4,13 +4,19 @@ export declare class MongoDBAdapter extends BaseMemoryAdapter {
     readonly provider: MemoryProvider;
     private client;
     private db;
+    private connecting;
     private uri;
     private database;
     private prefix;
     constructor(config: MongoDBAdapterConfig);
     private get threads();
     private get entries();
+    /**
+     * Opens the client and builds the indexes. Concurrent calls share one attempt, and a failed
+     * attempt closes its client and leaves the adapter disconnected, so the next call tries again.
+     */
     connect(): Promise<MemoryResult<void>>;
+    private open;
     disconnect(): Promise<MemoryResult<void>>;
     createThread(agentId: string, metadata?: Record<string, unknown>, threadId?: string): Promise<MemoryResult<Thread>>;
     getThread(threadId: string): Promise<MemoryResult<Thread | null>>;

package/dist/adapters/mongodb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mongodb.d.ts","sourceRoot":"","sources":["../../src/adapters/mongodb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAuD3C,qBAAa,cAAe,SAAQ,iBAAiB;IACnD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAa;IAE9C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,oBAAoB;IAOxC,OAAO,KAAK,OAAO,GAGlB;IAED,OAAO,KAAK,OAAO,GAGlB;IAEK,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAyBtC,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAezC,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACtC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAyB1B,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAmBjE,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAwB1B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAY3D,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IA0B1F,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;IAuC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAsBpE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAWzD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;CAUjE"}
+{"version":3,"file":"mongodb.d.ts","sourceRoot":"","sources":["../../src/adapters/mongodb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,WAAW,EACX,kBAAkB,EAClB,YAAY,EAEZ,oBAAoB,EACpB,cAAc,EAGf,MAAM,qBAAqB,CAAC;AAS7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAyF3C,qBAAa,cAAe,SAAQ,iBAAiB;IACnD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAa;IAE9C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,oBAAoB;IAOxC,OAAO,KAAK,OAAO,GAGlB;IAED,OAAO,KAAK,OAAO,GAGlB;IAED;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAQ9B,IAAI;IA2BZ,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAgBzC,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACtC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAyB1B,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAmBjE,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAwB1B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAY3D,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IA0B1F,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;IAyB7E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAWpE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAWzD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;CAUjE"}