@xfabric/memory 0.1.0 → 0.2.1

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export type { MemoryConfig, MemorySearchResult, SearchOptions, MemoryFileEntry, MemoryChunk, StoredChunk, MemorySource, VectorSearchResult, KeywordSearchResult, HybridSearchOptions, MemorySearchParams, MemoryGetParams, MemorySearchResponse, MemoryGetResponse, MemoryIndexMeta, FileChangeEvent, SessionEvent, EmbeddingProviderType, SyncProgress, MemoryStatus, ProbeResult, SessionChunk, SessionFileState, BatchConfig, BatchJob, ExtendedMemoryConfig, } from "./types.js";
-export { DEFAULT_CONFIG } from "./types.js";
+export type { MemoryConfig, MemorySearchResult, SearchOptions, MemoryFileEntry, MemoryChunk, StoredChunk, MemorySource, VectorSearchResult, KeywordSearchResult, HybridSearchOptions, MemorySearchParams, MemoryGetParams, MemorySearchResponse, MemoryGetResponse, MemoryIndexMeta, FileChangeEvent, SessionEvent, EmbeddingProviderType, SyncProgress, MemoryStatus, ProbeResult, SessionChunk, SessionFileState, BatchConfig, BatchJob, ExtendedMemoryConfig, ExtendedBatchConfig, OpenAiBatchRequest, OpenAiBatchStatus, OpenAiBatchOutputLine, GeminiBatchRequest, GeminiBatchStatus, GeminiBatchOutputLine, OpenAiEmbeddingClient, GeminiEmbeddingClient, } from "./types.js";
+export { DEFAULT_CONFIG, BATCH_FAILURE_LIMIT, SESSION_DIRTY_DEBOUNCE_MS, EMBEDDING_RETRY_MAX_ATTEMPTS, EMBEDDING_RETRY_BASE_DELAY_MS, EMBEDDING_RETRY_MAX_DELAY_MS, OPENAI_BATCH_MAX_REQUESTS, GEMINI_BATCH_MAX_REQUESTS, OPENAI_BATCH_ENDPOINT, OPENAI_BATCH_COMPLETION_WINDOW, } from "./types.js";
 export { MemoryManager } from "./memory-manager.js";
 export { memorySearch, memoryGet, createMemorySearchToolDef, createMemoryGetToolDef, } from "./tools/index.js";
 export type { EmbeddingProvider, EmbeddingProviderResult, ProviderConfig } from "./providers/index.js";
-export { createEmbeddingProvider, createOpenAIProvider, createGeminiProvider, createLocalProvider, isLocalAvailable, computeProviderKey, } from "./providers/index.js";
+export { createEmbeddingProvider, createOpenAIProvider, createGeminiProvider, createLocalProvider, isLocalAvailable, computeProviderKey, runOpenAiEmbeddingBatches, runGeminiEmbeddingBatches, runWithConcurrency, BatchFailureTracker, } from "./providers/index.js";
 export { MemoryStorage, createDatabase, type StorageOptions, type CreateDatabaseResult, } from "./storage/index.js";
 export { ensureMemoryIndexSchema, migrateSchema, ensureColumn, SCHEMA_VERSION, type SchemaStatus, } from "./storage/index.js";
 export { cosineSimilarity, loadSqliteVec, isSqliteVecAvailable } from "./storage/index.js";
@@ -11,8 +11,15 @@ export { chunkMarkdown, chunkSession, mergeConsecutiveMessages, type ChunkingOpt
 export { FileWatcher, type FileWatcherOptions } from "./sync/index.js";
 export { SessionMonitor, type SessionMonitorOptions } from "./sync/index.js";
 export { minimatch } from "./sync/index.js";
+export { onSessionTranscriptUpdate, emitSessionTranscriptUpdate, getSessionListenerCount, type SessionTranscriptUpdate, type SessionTranscriptListener, } from "./sync/index.js";
 export { searchVector, searchVectorWithSqliteVec, syncVectorTable, searchFts, mergeHybridResults, buildFtsQuery, bm25RankToScore, } from "./search/index.js";
 export { hashText, hashFile } from "./utils/index.js";
 export { retry, RetryError, type RetryOptions } from "./utils/index.js";
 export { Semaphore } from "./utils/index.js";
+export { fingerprintHeaderNames } from "./utils/index.js";
+export { computeMemoryManagerCacheKey, type MemoryManagerCacheKeyConfig } from "./utils/index.js";
+export { computeEmbeddingProviderKey } from "./utils/index.js";
+export { resolveMemoryVectorState, resolveMemoryFtsState, resolveMemoryCacheSummary, resolveMemoryCacheState, type Tone, } from "./utils/index.js";
+export { isRetryableEmbeddingError, shouldFallbackOnError, isBatchTimeoutError, isBatchUnavailableError, } from "./utils/index.js";
+export { getMemoryManager, clearCachedManager, clearAllCachedManagers, type MemoryManagerResult, } from "./utils/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,qBAAqB,EAErB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EACL,YAAY,EACZ,SAAS,EACT,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvG,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG3F,OAAO,EACL,aAAa,EACb,YAAY,EACZ,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,aAAa,EACb,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,10 +1,14 @@
 // Main exports for @vibestudio/memory
-export { DEFAULT_CONFIG } from "./types.js";
+export { DEFAULT_CONFIG, 
+// Constants
+BATCH_FAILURE_LIMIT, SESSION_DIRTY_DEBOUNCE_MS, EMBEDDING_RETRY_MAX_ATTEMPTS, EMBEDDING_RETRY_BASE_DELAY_MS, EMBEDDING_RETRY_MAX_DELAY_MS, OPENAI_BATCH_MAX_REQUESTS, GEMINI_BATCH_MAX_REQUESTS, OPENAI_BATCH_ENDPOINT, OPENAI_BATCH_COMPLETION_WINDOW, } from "./types.js";
 // Memory Manager
 export { MemoryManager } from "./memory-manager.js";
 // Tools
 export { memorySearch, memoryGet, createMemorySearchToolDef, createMemoryGetToolDef, } from "./tools/index.js";
-export { createEmbeddingProvider, createOpenAIProvider, createGeminiProvider, createLocalProvider, isLocalAvailable, computeProviderKey, } from "./providers/index.js";
+export { createEmbeddingProvider, createOpenAIProvider, createGeminiProvider, createLocalProvider, isLocalAvailable, computeProviderKey, 
+// Batch API exports
+runOpenAiEmbeddingBatches, runGeminiEmbeddingBatches, runWithConcurrency, BatchFailureTracker, } from "./providers/index.js";
 // Storage
 export { MemoryStorage, createDatabase, } from "./storage/index.js";
 export { ensureMemoryIndexSchema, migrateSchema, ensureColumn, SCHEMA_VERSION, } from "./storage/index.js";
@@ -15,10 +19,18 @@ export { chunkMarkdown, chunkSession, mergeConsecutiveMessages, } from "./chunki
 export { FileWatcher } from "./sync/index.js";
 export { SessionMonitor } from "./sync/index.js";
 export { minimatch } from "./sync/index.js";
+export { onSessionTranscriptUpdate, emitSessionTranscriptUpdate, getSessionListenerCount, } from "./sync/index.js";
 // Search
 export { searchVector, searchVectorWithSqliteVec, syncVectorTable, searchFts, mergeHybridResults, buildFtsQuery, bm25RankToScore, } from "./search/index.js";
 // Utilities
 export { hashText, hashFile } from "./utils/index.js";
 export { retry, RetryError } from "./utils/index.js";
 export { Semaphore } from "./utils/index.js";
+// New utilities from moltbot port
+export { fingerprintHeaderNames } from "./utils/index.js";
+export { computeMemoryManagerCacheKey } from "./utils/index.js";
+export { computeEmbeddingProviderKey } from "./utils/index.js";
+export { resolveMemoryVectorState, resolveMemoryFtsState, resolveMemoryCacheSummary, resolveMemoryCacheState, } from "./utils/index.js";
+export { isRetryableEmbeddingError, shouldFallbackOnError, isBatchTimeoutError, isBatchUnavailableError, } from "./utils/index.js";
+export { getMemoryManager, clearCachedManager, clearAllCachedManagers, } from "./utils/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAiCtC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,QAAQ;AACR,OAAO,EACL,YAAY,EACZ,SAAS,EACT,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,UAAU;AACV,OAAO,EACL,aAAa,EACb,cAAc,GAGf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,YAAY,EACZ,cAAc,GAEf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE3F,WAAW;AACX,OAAO,EACL,aAAa,EACb,YAAY,EACZ,wBAAwB,GAGzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO;AACP,OAAO,EAAE,WAAW,EAA2B,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,cAAc,EAA8B,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,SAAS;AACT,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,aAAa,EACb,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAqB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AA6CtC,OAAO,EACL,cAAc;AACd,YAAY;AACZ,mBAAmB,EACnB,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AAEpB,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,QAAQ;AACR,OAAO,EACL,YAAY,EACZ,SAAS,EACT,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB;AAClB,oBAAoB;AACpB,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,UAAU;AACV,OAAO,EACL,aAAa,EACb,cAAc,GAGf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,YAAY,EACZ,cAAc,GAEf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE3F,WAAW;AACX,OAAO,EACL,aAAa,EACb,YAAY,EACZ,wBAAwB,GAGzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO;AACP,OAAO,EAAE,WAAW,EAA2B,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,cAAc,EAA8B,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,GAGxB,MAAM,iBAAiB,CAAC;AAEzB,SAAS;AACT,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,aAAa,EACb,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAqB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,kCAAkC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,4BAA4B,EAAoC,MAAM,kBAAkB,CAAC;AAClG,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,GAExB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,GAEvB,MAAM,kBAAkB,CAAC"}

package/dist/memory-manager.d.ts

@@ -1,4 +1,4 @@
-import type { MemoryConfig, MemorySearchResult, SearchOptions, MemorySource, MemoryStatus, ProbeResult, ExtendedMemoryConfig } from "./types.js";
+import type { MemoryConfig, MemorySearchResult, SearchOptions, MemoryFileEntry, MemorySource, MemoryStatus, ProbeResult, ExtendedMemoryConfig } from "./types.js";
 /**
  * Memory manager for indexing and searching workspace content
  */
@@ -19,10 +19,18 @@ export declare class MemoryManager {
     private fallbackProvider;
     private batchDisabled;
     private batchDisableReason?;
+    private batchFailureTracker;
+    private openAiClient?;
+    private geminiClient?;
     private sqliteVecLoaded;
     private sqliteVecError?;
     private syncIntervalTimer;
     private lastSyncAt?;
+    private sessionDeltas;
+    private sessionWarm;
+    private sessionPendingFiles;
+    private sessionWatchTimer;
+    private sessionUnsubscribe;
     private constructor();
     /**
      * Create or get a cached MemoryManager instance
@@ -44,6 +52,10 @@ export declare class MemoryManager {
      * Get provider key for cache isolation
      */
     private get providerKey();
+    /**
+     * Pre-sync on session start with deduplication
+     */
+    warmSession(sessionKey?: string): Promise<void>;
     /**
      * Search memory for relevant content
      */
@@ -132,10 +144,80 @@ export declare class MemoryManager {
      * Embed a batch of texts with caching and rate limiting
      */
     private embedBatch;
+    /**
+     * Embed batch with exponential backoff retry (500ms-8s, 3 attempts)
+     */
+    private embedBatchWithRetry;
+    /**
+     * Build embedding batches respecting token limits
+     */
+    private buildEmbeddingBatches;
+    /**
+     * Run batch with timeout retry (single retry on timeout)
+     */
+    private runBatchWithTimeoutRetry;
+    /**
+     * Run batch with fallback to inline embedding on failure
+     */
+    private runBatchWithFallback;
+    /**
+     * Embed chunks using async batch API (OpenAI or Gemini)
+     * Exposed for advanced use cases where caller controls chunking
+     */
+    embedChunksWithAsyncBatch(chunks: Array<{
+        text: string;
+        hash: string;
+        startLine: number;
+        endLine: number;
+    }>, entry: MemoryFileEntry, source: MemorySource): Promise<number[][]>;
+    /**
+     * Embed chunks using OpenAI async batch API
+     */
+    private embedChunksWithOpenAiBatch;
+    /**
+     * Embed chunks using Gemini async batch API
+     */
+    private embedChunksWithGeminiBatch;
+    /**
+     * Embed chunks using inline batch API (fallback)
+     */
+    private embedChunksInline;
     /**
      * Start watching for file changes
      */
     private startWatching;
+    /**
+     * Schedule session dirty check with debouncing
+     * Call this when a session file is modified externally
+     */
+    scheduleSessionDirty(sessionFile: string): void;
+    /**
+     * Process pending session files and check delta thresholds
+     */
+    private processSessionDeltaBatch;
+    /**
+     * Update session delta tracking for a file
+     */
+    private updateSessionDelta;
+    /**
+     * Count newlines in a file range (for message counting)
+     */
+    private countNewlines;
+    /**
+     * Reset session delta tracking for a file
+     * Call this after successfully processing a session file
+     */
+    resetSessionDelta(absPath: string, size: number): void;
+    /**
+     * Check if a session file belongs to this agent's sessions directory
+     */
+    private isSessionFileForAgent;
+    /**
+     * Set up session transcript event listener
+     * This provides push-based notifications when session files change
+     * Called automatically during create(), but can be called manually if needed
+     */
+    setupSessionListener(): void;
     /**
      * Start interval-based sync
      */

package/dist/memory-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../src/memory-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../src/memory-manager.ts"],"names":[],"mappings":"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"}