wolbarg 0.5.1 → 0.5.2

package/dist/index.d.cts

@@ -49,7 +49,7 @@ declare const meta: {
  * Schema is intentionally extensible for future providers (Postgres, cloud).
  */
 /** Public operation names recorded as telemetry events. */
-type TelemetryOperation = "remember" | "recall" | "forget" | "compress" | "rememberBatch" | "recallBatch" | "export" | "import" | "checkpoint" | "rollback" | "error" | "startup" | "shutdown" | "ingest" | "history" | "stats" | "clear" | "deleteCheckpoint" | "listCheckpoints" | "getCheckpoint" | "linkMemories" | "getRelated" | "graphQuery";
+type TelemetryOperation = "remember" | "recall" | "forget" | "compress" | "rememberBatch" | "recallBatch" | "export" | "import" | "checkpoint" | "rollback" | "error" | "startup" | "shutdown" | "ingest" | "history" | "stats" | "clear" | "deleteCheckpoint" | "listCheckpoints" | "getCheckpoint" | "linkMemories" | "getRelated" | "graphQuery" | "rememberFromMessages";
 type TelemetryStatus = "ok" | "error" | "cancelled";
 type TelemetryLogLevel = "off" | "error" | "warn" | "info" | "debug" | "trace";
 /** Stage-level latency breakdown recorded on each event. */
@@ -341,6 +341,35 @@ interface RememberOptions {
     /** Per-call dedupe override; undefined uses constructor `memory.dedupe`. */
     dedupe?: boolean | MemoryDedupeConfig;
 }
+/**
+ * Chat turn for {@link Wolbarg.rememberFromMessages}.
+ * @experimental until 1.0
+ */
+interface ConversationMessage {
+    role: string;
+    content: string;
+}
+/** How `mode: "raw"` selects user turns to store. */
+type RememberFromMessagesRawStrategy = "last_user" | "all_user";
+/**
+ * Options for {@link Wolbarg.rememberFromMessages}.
+ * @experimental until 1.0
+ */
+interface RememberFromMessagesOptions {
+    /** Agent identifier that owns the stored memories. */
+    agent: string;
+    /**
+     * `raw` (default) — store user message text without an LLM.
+     * `extract` — use configured `llm` to extract atomic facts, then remember each.
+     */
+    mode?: "raw" | "extract";
+    /** Used when `mode` is `raw`. Defaults to `last_user`. */
+    rawStrategy?: RememberFromMessagesRawStrategy;
+    /** Optional opaque metadata attached to every stored memory. */
+    metadata?: MemoryMetadata;
+    /** Per-call dedupe override; undefined uses constructor `memory.dedupe`. */
+    dedupe?: boolean | MemoryDedupeConfig;
+}
 /** Whether remember created a new row or updated an existing one. */
 type RememberAction = "created" | "updated";
 /** Result of {@link Wolbarg.remember} — MemoryRecord plus upsert action. */
@@ -730,7 +759,7 @@ declare function createChunkingStrategy(name?: "fixed" | "sentence" | "paragraph
 
 /**
  * LLM provider abstractions and OpenAI-compatible chat implementation.
- * Used exclusively for memory compression (and future ORC features).
+ * Used for memory compression and experimental rememberFromMessages extract mode.
  */
 
 interface ChatMessage {
@@ -1296,6 +1325,15 @@ declare class Wolbarg<HasLlm extends boolean = false> {
     remember(options: RememberOptions): Promise<RememberResult>;
     /** Batch remember — sequential when dedupe enabled; otherwise one TX batch. */
     rememberBatch(items: RememberOptions[]): Promise<RememberResult[]>;
+    /**
+     * Store memories from a chat transcript.
+     *
+     * **Experimental** until 1.0 — API shape may change.
+     *
+     * - `mode: "raw"` (default) — remember user message text (no LLM).
+     * - `mode: "extract"` — require configured `llm`; extract atomic facts then remember each.
+     */
+    rememberFromMessages(messages: ConversationMessage[], options: RememberFromMessagesOptions): Promise<RememberResult[]>;
     /**
      * Update an existing memory by id (re-embeds when content changes).
      */
@@ -1388,7 +1426,7 @@ declare class Wolbarg<HasLlm extends boolean = false> {
 declare function wolbarg$1(options: WolbargOptions): Wolbarg;
 
 /** Published SDK semver — keep in sync with package.json `version`. */
-declare const SDK_VERSION = "0.5.0";
+declare const SDK_VERSION = "0.5.2";
 
 /**
  * Operation-scoped errors with reason + suggestion for developer experience.
@@ -1701,6 +1739,8 @@ declare class SqliteStorageProvider implements StorageProvider {
     private requireStatements;
     private requireVectorReady;
     private toVectorParam;
+    /** sqlite-vec vec0 PKs must be bound as BigInt under node:sqlite. */
+    private toVecRowid;
     private describe;
 }
 /** @deprecated Prefer {@link SqliteStorageProvider}. */
@@ -2208,4 +2248,4 @@ interface BenchmarkReport {
 declare function runBenchmark(name: string, iterations: number, fn: () => Promise<void> | void): Promise<BenchmarkSample[]>;
 declare function summarizeBenchmark(samples: BenchmarkSample[], startedAt: string, finishedAt: string): BenchmarkReport;
 
-export { type BenchmarkReport, type BenchmarkSample, type ChatMessage, type CheckpointInfo, type CheckpointMeta, type CheckpointOptions, type CheckpointProvider, type Chunk, type ChunkingOptions, type ChunkingStrategy, type ClearOptions, type CompressOptions, type CompressResult, CompressionError, type CompressionProvider, type ConcurrencyConfig$1 as ConcurrencyConfig, ConfigurationError, type CreateCheckpointOptions, type DatabaseConfig, DatabaseError, type DatabaseProvider, type DatabaseProviderName, type EmbeddingCacheConfig, type EmbeddingConfig, EmbeddingError, type EmbeddingProvider, type EventDatabase, type ExportResult, FixedChunkingStrategy, type ForgetByFilterOptions, type ForgetByIdOptions, type ForgetOptions, type GetRelatedOptions, GraphCheckpointNotSupportedError, type GraphConfig, type GraphDirection, type GraphEntityInput, type GraphHealthResult, type GraphInput$1 as GraphInput, type GraphProvider, HeadingChunkingStrategy, type HistoryEvent, type HistoryOptions, type HistoryResult, type HybridConfig, type ImportResult, type IngestOptions, type IngestResult, type InitOptions, InitializationError, type KeywordDocument, type KeywordSearchHit, type KeywordSearchProvider, type LatencyBreakdown, LlmCompressionProvider, type LlmConfig, type LlmProvider, MarkdownChunkingStrategy, type MemoryChangeCallback, type MemoryChangeEvent, type MemoryContent, type MemoryDedupeConfig, type MemoryDedupeStrategy, type MemoryFilter, type MemoryMetadata, MemoryNotFoundError, type MemoryProvider, type MemoryRecord, type MetadataFilter as MetaFilter, type MetadataComparison, type MetadataFilter, type MmrConfig, Neo4jGraphProvider, NoopTelemetryProvider, type OCRProvider, type OcrResult, ParagraphChunkingStrategy, type PersistedRecallExplainPayload, type PostgresDatabaseConfig, PostgresStorageProvider, ProviderNotConfiguredError, type RecallExplainResponse, type RecallExplanationHit, type RecallOptions, type RecallResult, type RememberAction, type RememberOptions, type RememberResult, type RerankDocument, type RerankHit, type RerankerProvider, type RetrievalConfig, SDK_VERSION, SentenceChunkingStrategy, SqliteCheckpointProvider, type SqliteDatabaseConfig, SqliteDatabaseProvider, SqliteEventDatabase, SqliteGraphProvider, SqliteStorageProvider, SqliteTelemetryProvider, type StageSpan, type StatsResult, type StorageConfig, StorageLockedError, type StorageProvider, type StorageProviderName, type SubscribableEvent, type SubscribeFilter, type TelemetryConfig, TelemetryEmitter, type TelemetryEvent, type TelemetryEventInput, type TelemetryLogLevel, type TelemetryOperation, type TelemetryProvider, type TelemetryQuery, type TelemetryQueryResult, type TelemetryStatus, type Unsubscribe, ValidationError, type VisionProvider, type VisionResult, Wolbarg, WolbargError, WolbargLogger, type WolbargOptions, type WolbargOptionsWithLlm, type WolbargOptionsWithoutLlm, bgeReranker, bm25, cohereReranker, createChunkingStrategy, createCompressionProvider, createDatabaseProvider, createEmbeddingProvider, createLlmProvider, createStorageProvider, createTelemetryProvider, wolbarg as createWolbarg, crossEncoder, geminiEmbedding, geminiVision, jinaReranker, lmStudioEmbedding, meta, neo4jGraph, ollamaEmbedding, ollamaLlm, openRouterEmbedding, openRouterLlm, openaiCompatibleEmbedding, openaiCompatibleLlm, openaiEmbedding, openaiLlm, openaiReranker, openaiVision, postgres, postgresConfig, runBenchmark, sqlite, sqliteCheckpoint, sqliteConfig, sqliteGraph, sqliteTelemetry, summarizeBenchmark, tesseract, togetherEmbedding, vllmEmbedding, wolbarg$1 as wolbarg, wrapOperationError };
+export { type BenchmarkReport, type BenchmarkSample, type ChatMessage, type CheckpointInfo, type CheckpointMeta, type CheckpointOptions, type CheckpointProvider, type Chunk, type ChunkingOptions, type ChunkingStrategy, type ClearOptions, type CompressOptions, type CompressResult, CompressionError, type CompressionProvider, type ConcurrencyConfig$1 as ConcurrencyConfig, ConfigurationError, type ConversationMessage, type CreateCheckpointOptions, type DatabaseConfig, DatabaseError, type DatabaseProvider, type DatabaseProviderName, type EmbeddingCacheConfig, type EmbeddingConfig, EmbeddingError, type EmbeddingProvider, type EventDatabase, type ExportResult, FixedChunkingStrategy, type ForgetByFilterOptions, type ForgetByIdOptions, type ForgetOptions, type GetRelatedOptions, GraphCheckpointNotSupportedError, type GraphConfig, type GraphDirection, type GraphEntityInput, type GraphHealthResult, type GraphInput$1 as GraphInput, type GraphProvider, HeadingChunkingStrategy, type HistoryEvent, type HistoryOptions, type HistoryResult, type HybridConfig, type ImportResult, type IngestOptions, type IngestResult, type InitOptions, InitializationError, type KeywordDocument, type KeywordSearchHit, type KeywordSearchProvider, type LatencyBreakdown, LlmCompressionProvider, type LlmConfig, type LlmProvider, MarkdownChunkingStrategy, type MemoryChangeCallback, type MemoryChangeEvent, type MemoryContent, type MemoryDedupeConfig, type MemoryDedupeStrategy, type MemoryFilter, type MemoryMetadata, MemoryNotFoundError, type MemoryProvider, type MemoryRecord, type MetadataFilter as MetaFilter, type MetadataComparison, type MetadataFilter, type MmrConfig, Neo4jGraphProvider, NoopTelemetryProvider, type OCRProvider, type OcrResult, ParagraphChunkingStrategy, type PersistedRecallExplainPayload, type PostgresDatabaseConfig, PostgresStorageProvider, ProviderNotConfiguredError, type RecallExplainResponse, type RecallExplanationHit, type RecallOptions, type RecallResult, type RememberAction, type RememberFromMessagesOptions, type RememberFromMessagesRawStrategy, type RememberOptions, type RememberResult, type RerankDocument, type RerankHit, type RerankerProvider, type RetrievalConfig, SDK_VERSION, SentenceChunkingStrategy, SqliteCheckpointProvider, type SqliteDatabaseConfig, SqliteDatabaseProvider, SqliteEventDatabase, SqliteGraphProvider, SqliteStorageProvider, SqliteTelemetryProvider, type StageSpan, type StatsResult, type StorageConfig, StorageLockedError, type StorageProvider, type StorageProviderName, type SubscribableEvent, type SubscribeFilter, type TelemetryConfig, TelemetryEmitter, type TelemetryEvent, type TelemetryEventInput, type TelemetryLogLevel, type TelemetryOperation, type TelemetryProvider, type TelemetryQuery, type TelemetryQueryResult, type TelemetryStatus, type Unsubscribe, ValidationError, type VisionProvider, type VisionResult, Wolbarg, WolbargError, WolbargLogger, type WolbargOptions, type WolbargOptionsWithLlm, type WolbargOptionsWithoutLlm, bgeReranker, bm25, cohereReranker, createChunkingStrategy, createCompressionProvider, createDatabaseProvider, createEmbeddingProvider, createLlmProvider, createStorageProvider, createTelemetryProvider, wolbarg as createWolbarg, crossEncoder, geminiEmbedding, geminiVision, jinaReranker, lmStudioEmbedding, meta, neo4jGraph, ollamaEmbedding, ollamaLlm, openRouterEmbedding, openRouterLlm, openaiCompatibleEmbedding, openaiCompatibleLlm, openaiEmbedding, openaiLlm, openaiReranker, openaiVision, postgres, postgresConfig, runBenchmark, sqlite, sqliteCheckpoint, sqliteConfig, sqliteGraph, sqliteTelemetry, summarizeBenchmark, tesseract, togetherEmbedding, vllmEmbedding, wolbarg$1 as wolbarg, wrapOperationError };

package/dist/index.d.ts

@@ -49,7 +49,7 @@ declare const meta: {
  * Schema is intentionally extensible for future providers (Postgres, cloud).
  */
 /** Public operation names recorded as telemetry events. */
-type TelemetryOperation = "remember" | "recall" | "forget" | "compress" | "rememberBatch" | "recallBatch" | "export" | "import" | "checkpoint" | "rollback" | "error" | "startup" | "shutdown" | "ingest" | "history" | "stats" | "clear" | "deleteCheckpoint" | "listCheckpoints" | "getCheckpoint" | "linkMemories" | "getRelated" | "graphQuery";
+type TelemetryOperation = "remember" | "recall" | "forget" | "compress" | "rememberBatch" | "recallBatch" | "export" | "import" | "checkpoint" | "rollback" | "error" | "startup" | "shutdown" | "ingest" | "history" | "stats" | "clear" | "deleteCheckpoint" | "listCheckpoints" | "getCheckpoint" | "linkMemories" | "getRelated" | "graphQuery" | "rememberFromMessages";
 type TelemetryStatus = "ok" | "error" | "cancelled";
 type TelemetryLogLevel = "off" | "error" | "warn" | "info" | "debug" | "trace";
 /** Stage-level latency breakdown recorded on each event. */
@@ -341,6 +341,35 @@ interface RememberOptions {
     /** Per-call dedupe override; undefined uses constructor `memory.dedupe`. */
     dedupe?: boolean | MemoryDedupeConfig;
 }
+/**
+ * Chat turn for {@link Wolbarg.rememberFromMessages}.
+ * @experimental until 1.0
+ */
+interface ConversationMessage {
+    role: string;
+    content: string;
+}
+/** How `mode: "raw"` selects user turns to store. */
+type RememberFromMessagesRawStrategy = "last_user" | "all_user";
+/**
+ * Options for {@link Wolbarg.rememberFromMessages}.
+ * @experimental until 1.0
+ */
+interface RememberFromMessagesOptions {
+    /** Agent identifier that owns the stored memories. */
+    agent: string;
+    /**
+     * `raw` (default) — store user message text without an LLM.
+     * `extract` — use configured `llm` to extract atomic facts, then remember each.
+     */
+    mode?: "raw" | "extract";
+    /** Used when `mode` is `raw`. Defaults to `last_user`. */
+    rawStrategy?: RememberFromMessagesRawStrategy;
+    /** Optional opaque metadata attached to every stored memory. */
+    metadata?: MemoryMetadata;
+    /** Per-call dedupe override; undefined uses constructor `memory.dedupe`. */
+    dedupe?: boolean | MemoryDedupeConfig;
+}
 /** Whether remember created a new row or updated an existing one. */
 type RememberAction = "created" | "updated";
 /** Result of {@link Wolbarg.remember} — MemoryRecord plus upsert action. */
@@ -730,7 +759,7 @@ declare function createChunkingStrategy(name?: "fixed" | "sentence" | "paragraph
 
 /**
  * LLM provider abstractions and OpenAI-compatible chat implementation.
- * Used exclusively for memory compression (and future ORC features).
+ * Used for memory compression and experimental rememberFromMessages extract mode.
  */
 
 interface ChatMessage {
@@ -1296,6 +1325,15 @@ declare class Wolbarg<HasLlm extends boolean = false> {
     remember(options: RememberOptions): Promise<RememberResult>;
     /** Batch remember — sequential when dedupe enabled; otherwise one TX batch. */
     rememberBatch(items: RememberOptions[]): Promise<RememberResult[]>;
+    /**
+     * Store memories from a chat transcript.
+     *
+     * **Experimental** until 1.0 — API shape may change.
+     *
+     * - `mode: "raw"` (default) — remember user message text (no LLM).
+     * - `mode: "extract"` — require configured `llm`; extract atomic facts then remember each.
+     */
+    rememberFromMessages(messages: ConversationMessage[], options: RememberFromMessagesOptions): Promise<RememberResult[]>;
     /**
      * Update an existing memory by id (re-embeds when content changes).
      */
@@ -1388,7 +1426,7 @@ declare class Wolbarg<HasLlm extends boolean = false> {
 declare function wolbarg$1(options: WolbargOptions): Wolbarg;
 
 /** Published SDK semver — keep in sync with package.json `version`. */
-declare const SDK_VERSION = "0.5.0";
+declare const SDK_VERSION = "0.5.2";
 
 /**
  * Operation-scoped errors with reason + suggestion for developer experience.
@@ -1701,6 +1739,8 @@ declare class SqliteStorageProvider implements StorageProvider {
     private requireStatements;
     private requireVectorReady;
     private toVectorParam;
+    /** sqlite-vec vec0 PKs must be bound as BigInt under node:sqlite. */
+    private toVecRowid;
     private describe;
 }
 /** @deprecated Prefer {@link SqliteStorageProvider}. */
@@ -2208,4 +2248,4 @@ interface BenchmarkReport {
 declare function runBenchmark(name: string, iterations: number, fn: () => Promise<void> | void): Promise<BenchmarkSample[]>;
 declare function summarizeBenchmark(samples: BenchmarkSample[], startedAt: string, finishedAt: string): BenchmarkReport;
 
-export { type BenchmarkReport, type BenchmarkSample, type ChatMessage, type CheckpointInfo, type CheckpointMeta, type CheckpointOptions, type CheckpointProvider, type Chunk, type ChunkingOptions, type ChunkingStrategy, type ClearOptions, type CompressOptions, type CompressResult, CompressionError, type CompressionProvider, type ConcurrencyConfig$1 as ConcurrencyConfig, ConfigurationError, type CreateCheckpointOptions, type DatabaseConfig, DatabaseError, type DatabaseProvider, type DatabaseProviderName, type EmbeddingCacheConfig, type EmbeddingConfig, EmbeddingError, type EmbeddingProvider, type EventDatabase, type ExportResult, FixedChunkingStrategy, type ForgetByFilterOptions, type ForgetByIdOptions, type ForgetOptions, type GetRelatedOptions, GraphCheckpointNotSupportedError, type GraphConfig, type GraphDirection, type GraphEntityInput, type GraphHealthResult, type GraphInput$1 as GraphInput, type GraphProvider, HeadingChunkingStrategy, type HistoryEvent, type HistoryOptions, type HistoryResult, type HybridConfig, type ImportResult, type IngestOptions, type IngestResult, type InitOptions, InitializationError, type KeywordDocument, type KeywordSearchHit, type KeywordSearchProvider, type LatencyBreakdown, LlmCompressionProvider, type LlmConfig, type LlmProvider, MarkdownChunkingStrategy, type MemoryChangeCallback, type MemoryChangeEvent, type MemoryContent, type MemoryDedupeConfig, type MemoryDedupeStrategy, type MemoryFilter, type MemoryMetadata, MemoryNotFoundError, type MemoryProvider, type MemoryRecord, type MetadataFilter as MetaFilter, type MetadataComparison, type MetadataFilter, type MmrConfig, Neo4jGraphProvider, NoopTelemetryProvider, type OCRProvider, type OcrResult, ParagraphChunkingStrategy, type PersistedRecallExplainPayload, type PostgresDatabaseConfig, PostgresStorageProvider, ProviderNotConfiguredError, type RecallExplainResponse, type RecallExplanationHit, type RecallOptions, type RecallResult, type RememberAction, type RememberOptions, type RememberResult, type RerankDocument, type RerankHit, type RerankerProvider, type RetrievalConfig, SDK_VERSION, SentenceChunkingStrategy, SqliteCheckpointProvider, type SqliteDatabaseConfig, SqliteDatabaseProvider, SqliteEventDatabase, SqliteGraphProvider, SqliteStorageProvider, SqliteTelemetryProvider, type StageSpan, type StatsResult, type StorageConfig, StorageLockedError, type StorageProvider, type StorageProviderName, type SubscribableEvent, type SubscribeFilter, type TelemetryConfig, TelemetryEmitter, type TelemetryEvent, type TelemetryEventInput, type TelemetryLogLevel, type TelemetryOperation, type TelemetryProvider, type TelemetryQuery, type TelemetryQueryResult, type TelemetryStatus, type Unsubscribe, ValidationError, type VisionProvider, type VisionResult, Wolbarg, WolbargError, WolbargLogger, type WolbargOptions, type WolbargOptionsWithLlm, type WolbargOptionsWithoutLlm, bgeReranker, bm25, cohereReranker, createChunkingStrategy, createCompressionProvider, createDatabaseProvider, createEmbeddingProvider, createLlmProvider, createStorageProvider, createTelemetryProvider, wolbarg as createWolbarg, crossEncoder, geminiEmbedding, geminiVision, jinaReranker, lmStudioEmbedding, meta, neo4jGraph, ollamaEmbedding, ollamaLlm, openRouterEmbedding, openRouterLlm, openaiCompatibleEmbedding, openaiCompatibleLlm, openaiEmbedding, openaiLlm, openaiReranker, openaiVision, postgres, postgresConfig, runBenchmark, sqlite, sqliteCheckpoint, sqliteConfig, sqliteGraph, sqliteTelemetry, summarizeBenchmark, tesseract, togetherEmbedding, vllmEmbedding, wolbarg$1 as wolbarg, wrapOperationError };
+export { type BenchmarkReport, type BenchmarkSample, type ChatMessage, type CheckpointInfo, type CheckpointMeta, type CheckpointOptions, type CheckpointProvider, type Chunk, type ChunkingOptions, type ChunkingStrategy, type ClearOptions, type CompressOptions, type CompressResult, CompressionError, type CompressionProvider, type ConcurrencyConfig$1 as ConcurrencyConfig, ConfigurationError, type ConversationMessage, type CreateCheckpointOptions, type DatabaseConfig, DatabaseError, type DatabaseProvider, type DatabaseProviderName, type EmbeddingCacheConfig, type EmbeddingConfig, EmbeddingError, type EmbeddingProvider, type EventDatabase, type ExportResult, FixedChunkingStrategy, type ForgetByFilterOptions, type ForgetByIdOptions, type ForgetOptions, type GetRelatedOptions, GraphCheckpointNotSupportedError, type GraphConfig, type GraphDirection, type GraphEntityInput, type GraphHealthResult, type GraphInput$1 as GraphInput, type GraphProvider, HeadingChunkingStrategy, type HistoryEvent, type HistoryOptions, type HistoryResult, type HybridConfig, type ImportResult, type IngestOptions, type IngestResult, type InitOptions, InitializationError, type KeywordDocument, type KeywordSearchHit, type KeywordSearchProvider, type LatencyBreakdown, LlmCompressionProvider, type LlmConfig, type LlmProvider, MarkdownChunkingStrategy, type MemoryChangeCallback, type MemoryChangeEvent, type MemoryContent, type MemoryDedupeConfig, type MemoryDedupeStrategy, type MemoryFilter, type MemoryMetadata, MemoryNotFoundError, type MemoryProvider, type MemoryRecord, type MetadataFilter as MetaFilter, type MetadataComparison, type MetadataFilter, type MmrConfig, Neo4jGraphProvider, NoopTelemetryProvider, type OCRProvider, type OcrResult, ParagraphChunkingStrategy, type PersistedRecallExplainPayload, type PostgresDatabaseConfig, PostgresStorageProvider, ProviderNotConfiguredError, type RecallExplainResponse, type RecallExplanationHit, type RecallOptions, type RecallResult, type RememberAction, type RememberFromMessagesOptions, type RememberFromMessagesRawStrategy, type RememberOptions, type RememberResult, type RerankDocument, type RerankHit, type RerankerProvider, type RetrievalConfig, SDK_VERSION, SentenceChunkingStrategy, SqliteCheckpointProvider, type SqliteDatabaseConfig, SqliteDatabaseProvider, SqliteEventDatabase, SqliteGraphProvider, SqliteStorageProvider, SqliteTelemetryProvider, type StageSpan, type StatsResult, type StorageConfig, StorageLockedError, type StorageProvider, type StorageProviderName, type SubscribableEvent, type SubscribeFilter, type TelemetryConfig, TelemetryEmitter, type TelemetryEvent, type TelemetryEventInput, type TelemetryLogLevel, type TelemetryOperation, type TelemetryProvider, type TelemetryQuery, type TelemetryQueryResult, type TelemetryStatus, type Unsubscribe, ValidationError, type VisionProvider, type VisionResult, Wolbarg, WolbargError, WolbargLogger, type WolbargOptions, type WolbargOptionsWithLlm, type WolbargOptionsWithoutLlm, bgeReranker, bm25, cohereReranker, createChunkingStrategy, createCompressionProvider, createDatabaseProvider, createEmbeddingProvider, createLlmProvider, createStorageProvider, createTelemetryProvider, wolbarg as createWolbarg, crossEncoder, geminiEmbedding, geminiVision, jinaReranker, lmStudioEmbedding, meta, neo4jGraph, ollamaEmbedding, ollamaLlm, openRouterEmbedding, openRouterLlm, openaiCompatibleEmbedding, openaiCompatibleLlm, openaiEmbedding, openaiLlm, openaiReranker, openaiVision, postgres, postgresConfig, runBenchmark, sqlite, sqliteCheckpoint, sqliteConfig, sqliteGraph, sqliteTelemetry, summarizeBenchmark, tesseract, togetherEmbedding, vllmEmbedding, wolbarg$1 as wolbarg, wrapOperationError };

package/dist/index.js

@@ -3298,12 +3298,13 @@ var SqliteStorageProvider = class _SqliteStorageProvider {
   insertEmbedding(rowid, embedding) {
     const stmts = this.requireStatements();
     if (this.vectorBackend === "sqlite-vec") {
-      stmts.insertEmbedding.run(rowid, this.toVectorParam(embedding));
+      stmts.insertEmbedding.run(this.toVecRowid(rowid), this.toVectorParam(embedding));
       return;
     }
-    stmts.insertEmbeddingBlob.run(rowid, embeddingToBuffer(embedding));
+    const id = Number(rowid);
+    stmts.insertEmbeddingBlob.run(id, embeddingToBuffer(embedding));
     if (this.memoryIndex) {
-      this.memoryIndex.upsert(rowid, embedding);
+      this.memoryIndex.upsert(id, embedding);
       this.memoryIndexDirty = false;
     } else {
       this.memoryIndexDirty = true;
@@ -3313,10 +3314,11 @@ var SqliteStorageProvider = class _SqliteStorageProvider {
     const stmts = this.requireStatements();
     try {
       if (this.vectorBackend === "sqlite-vec" && stmts.deleteEmbedding) {
-        stmts.deleteEmbedding.run(rowid);
+        stmts.deleteEmbedding.run(this.toVecRowid(rowid));
       } else if (stmts.deleteEmbeddingBlob) {
-        stmts.deleteEmbeddingBlob.run(rowid);
-        this.memoryIndex?.remove(rowid);
+        const id = Number(rowid);
+        stmts.deleteEmbeddingBlob.run(id);
+        this.memoryIndex?.remove(id);
         this.memoryIndexDirty = true;
       }
     } catch {
@@ -3333,8 +3335,8 @@ var SqliteStorageProvider = class _SqliteStorageProvider {
       for (let i = 0; i < rows.length; i += 1) {
         const row = rows[i];
         hits[i] = {
-          memoryRowid: row.memory_rowid,
-          distance: row.distance
+          memoryRowid: Number(row.memory_rowid),
+          distance: Number(row.distance)
         };
       }
       return hits;
@@ -3410,6 +3412,10 @@ var SqliteStorageProvider = class _SqliteStorageProvider {
     const buffer = embeddingToBuffer(embedding);
     return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
   }
+  /** sqlite-vec vec0 PKs must be bound as BigInt under node:sqlite. */
+  toVecRowid(rowid) {
+    return typeof rowid === "bigint" ? rowid : BigInt(rowid);
+  }
   describe(error) {
     if (error instanceof Error) {
       return error.message;
@@ -5138,7 +5144,7 @@ function createDatabaseProvider(config) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.5.0";
+var SDK_VERSION = "0.5.2";
 
 // src/memory/transfer.ts
 var SqliteMemoryTransferProvider = class {
@@ -5264,6 +5270,96 @@ function resolvePath(p) {
   return path7.isAbsolute(p) ? p : path7.resolve(process.cwd(), p);
 }
 
+// src/memory/from-messages.ts
+var DEFAULT_RAW_STRATEGY = "last_user";
+function normalizeConversationMessages(messages) {
+  if (!Array.isArray(messages)) {
+    throw new ValidationError("messages must be an array");
+  }
+  if (messages.length === 0) {
+    throw new ValidationError("messages must be a non-empty array");
+  }
+  return messages.map((message, index) => {
+    if (!message || typeof message !== "object") {
+      throw new ValidationError(`messages[${index}] must be an object`);
+    }
+    if (typeof message.role !== "string" || message.role.trim().length === 0) {
+      throw new ValidationError(`messages[${index}].role must be a non-empty string`);
+    }
+    if (typeof message.content !== "string") {
+      throw new ValidationError(`messages[${index}].content must be a string`);
+    }
+    return {
+      role: message.role.trim(),
+      content: message.content.trim()
+    };
+  });
+}
+function resolveRememberFromMessagesOptions(options) {
+  if (!options || typeof options !== "object") {
+    throw new ValidationError("options is required");
+  }
+  if (typeof options.agent !== "string" || options.agent.trim().length === 0) {
+    throw new ValidationError("agent must be a non-empty string");
+  }
+  const mode = options.mode ?? "raw";
+  if (mode !== "raw" && mode !== "extract") {
+    throw new ValidationError('mode must be "raw" or "extract"');
+  }
+  const rawStrategy = options.rawStrategy ?? DEFAULT_RAW_STRATEGY;
+  if (rawStrategy !== "last_user" && rawStrategy !== "all_user") {
+    throw new ValidationError('rawStrategy must be "last_user" or "all_user"');
+  }
+  return {
+    agent: options.agent.trim(),
+    mode,
+    rawStrategy,
+    ...options.metadata !== void 0 ? { metadata: options.metadata } : {},
+    ...options.dedupe !== void 0 ? { dedupe: options.dedupe } : {}
+  };
+}
+function selectRawUserTexts(messages, strategy) {
+  const userTexts = messages.filter((m) => m.role === "user" && m.content.length > 0).map((m) => m.content);
+  if (userTexts.length === 0) {
+    throw new ValidationError(
+      'no user messages with non-empty content \u2014 nothing to remember in mode "raw"'
+    );
+  }
+  if (strategy === "last_user") {
+    return [userTexts[userTexts.length - 1]];
+  }
+  return userTexts;
+}
+function buildExtractMessages(messages) {
+  const transcript = messages.map((m) => `${m.role}: ${m.content}`).join("\n");
+  return [
+    {
+      role: "system",
+      content: "Extract durable factual memories from the conversation. Return only atomic facts, one per line. No numbering, bullets, or commentary. If there are no facts worth storing, reply with exactly NONE."
+    },
+    {
+      role: "user",
+      content: transcript
+    }
+  ];
+}
+function parseExtractedFacts(llmOutput) {
+  const trimmed = llmOutput.trim();
+  if (trimmed.length === 0 || /^none$/i.test(trimmed)) {
+    return [];
+  }
+  const facts = [];
+  for (const line of trimmed.split(/\r?\n/)) {
+    let fact = line.trim();
+    if (fact.length === 0) continue;
+    fact = fact.replace(/^[-*•]\s+/, "");
+    fact = fact.replace(/^\d+[.)]\s+/, "");
+    if (fact.length === 0 || /^none$/i.test(fact)) continue;
+    facts.push(fact);
+  }
+  return facts;
+}
+
 // src/memory/index.ts
 function toMemoryRecord(row) {
   return {
@@ -7712,6 +7808,81 @@ var Wolbarg = class {
       throw wrapOperationError("rememberBatch", error);
     }
   }
+  /**
+   * Store memories from a chat transcript.
+   *
+   * **Experimental** until 1.0 — API shape may change.
+   *
+   * - `mode: "raw"` (default) — remember user message text (no LLM).
+   * - `mode: "extract"` — require configured `llm`; extract atomic facts then remember each.
+   */
+  async rememberFromMessages(messages, options) {
+    const parent = this.telemetry.start("rememberFromMessages");
+    try {
+      const normalized = normalizeConversationMessages(messages);
+      const resolved = resolveRememberFromMessagesOptions(options);
+      let texts;
+      if (resolved.mode === "extract") {
+        if (!this.llm) {
+          throw new ProviderNotConfiguredError(
+            "llm",
+            "rememberFromMessages",
+            'pass llm: openaiLlm(...) in the constructor when mode is "extract"'
+          );
+        }
+        const llmOutput = await this.llm.complete(
+          buildExtractMessages(normalized)
+        );
+        texts = parseExtractedFacts(llmOutput);
+        if (texts.length === 0) {
+          parent.success({
+            returnedCount: 0,
+            agentId: resolved.agent,
+            extra: { mode: "extract", factCount: 0 }
+          });
+          return [];
+        }
+      } else {
+        texts = selectRawUserTexts(normalized, resolved.rawStrategy);
+      }
+      const out = [];
+      for (const text of texts) {
+        const child = parent.child("remember");
+        const result = await this.rememberOne(
+          {
+            agent: resolved.agent,
+            content: { text },
+            ...resolved.metadata !== void 0 ? { metadata: resolved.metadata } : {},
+            ...resolved.dedupe !== void 0 ? { dedupe: resolved.dedupe } : {}
+          },
+          child
+        );
+        child.success({
+          provider: this.storage?.name,
+          memoryIds: [result.id],
+          returnedCount: 1,
+          metadata: result.metadata,
+          agentId: result.agent,
+          tags: telemetryTags(result.metadata),
+          extra: { upsertAction: result.action, mode: resolved.mode }
+        });
+        out.push(result);
+      }
+      parent.success({
+        provider: this.storage?.name,
+        memoryIds: out.map((r) => r.id),
+        returnedCount: out.length,
+        embeddingProvider: this.embedding?.model,
+        model: this.embedding?.model,
+        agentId: resolved.agent,
+        extra: { mode: resolved.mode }
+      });
+      return out;
+    } catch (error) {
+      parent.failure(error, { agentId: options?.agent });
+      throw wrapOperationError("rememberFromMessages", error);
+    }
+  }
   /**
    * Update an existing memory by id (re-embeds when content changes).
    */