wolbarg 0.5.2 → 0.5.4

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" | "rememberFromMessages";
+type TelemetryOperation = "remember" | "update" | "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. */
@@ -282,7 +282,7 @@ interface MmrConfig {
 }
 /** Retrieval pipeline defaults applied when constructing Wolbarg. */
 interface RetrievalConfig {
-    /** Default over-fetch multiplier for candidate generation. Defaults to 4. */
+    /** Default over-fetch multiplier for candidate generation. Defaults to 2 (no filters) or 4 (with metadata filters). */
     overFetchFactor?: number;
     /** Default hybrid fusion weights. */
     hybrid?: HybridConfig;
@@ -1426,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.2";
+declare const SDK_VERSION = "0.5.4";
 
 /**
  * Operation-scoped errors with reason + suggestion for developer experience.
@@ -1609,6 +1609,10 @@ declare class SqliteStorageProvider implements StorageProvider {
     private vectorDimensions;
     private vectorBackend;
     private sqliteVecLoaded;
+    /** Tracks nesting depth for {@link withTransaction} so we can use savepoints. */
+    private transactionDepth;
+    /** Incrementing counter for deterministic savepoint names. */
+    private savepointCounter;
     /** Hot in-process ANN for blob backend (sqlite-vec unavailable platforms). */
     private memoryIndex;
     private memoryIndexDirty;
@@ -2009,6 +2013,7 @@ declare class Neo4jGraphProvider implements GraphProvider {
     private requireDriver;
     private withSession;
     private run;
+    private runOnSession;
     private ensureMemoryNode;
     linkMemories(fromId: string, toId: string, relation: string, metadata?: Record<string, unknown>): Promise<void>;
     unlinkMemories(fromId: string, toId: string, relation?: string): Promise<void>;
@@ -2102,6 +2107,8 @@ declare class SqliteTelemetryProvider implements TelemetryProvider {
     private flushing;
     private closed;
     private openPromise;
+    private warnedQueueDrop;
+    private warnedFlushFailure;
     constructor(options: SqliteTelemetryProviderOptions);
     open(): Promise<void>;
     close(): Promise<void>;

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" | "rememberFromMessages";
+type TelemetryOperation = "remember" | "update" | "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. */
@@ -282,7 +282,7 @@ interface MmrConfig {
 }
 /** Retrieval pipeline defaults applied when constructing Wolbarg. */
 interface RetrievalConfig {
-    /** Default over-fetch multiplier for candidate generation. Defaults to 4. */
+    /** Default over-fetch multiplier for candidate generation. Defaults to 2 (no filters) or 4 (with metadata filters). */
     overFetchFactor?: number;
     /** Default hybrid fusion weights. */
     hybrid?: HybridConfig;
@@ -1426,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.2";
+declare const SDK_VERSION = "0.5.4";
 
 /**
  * Operation-scoped errors with reason + suggestion for developer experience.
@@ -1609,6 +1609,10 @@ declare class SqliteStorageProvider implements StorageProvider {
     private vectorDimensions;
     private vectorBackend;
     private sqliteVecLoaded;
+    /** Tracks nesting depth for {@link withTransaction} so we can use savepoints. */
+    private transactionDepth;
+    /** Incrementing counter for deterministic savepoint names. */
+    private savepointCounter;
     /** Hot in-process ANN for blob backend (sqlite-vec unavailable platforms). */
     private memoryIndex;
     private memoryIndexDirty;
@@ -2009,6 +2013,7 @@ declare class Neo4jGraphProvider implements GraphProvider {
     private requireDriver;
     private withSession;
     private run;
+    private runOnSession;
     private ensureMemoryNode;
     linkMemories(fromId: string, toId: string, relation: string, metadata?: Record<string, unknown>): Promise<void>;
     unlinkMemories(fromId: string, toId: string, relation?: string): Promise<void>;
@@ -2102,6 +2107,8 @@ declare class SqliteTelemetryProvider implements TelemetryProvider {
     private flushing;
     private closed;
     private openPromise;
+    private warnedQueueDrop;
+    private warnedFlushFailure;
     constructor(options: SqliteTelemetryProviderOptions);
     open(): Promise<void>;
     close(): Promise<void>;