@iflow-mcp/jkheadley-instar 0.26.2

package/dist/memory/EmbeddingProvider.d.ts

@@ -0,0 +1,82 @@
+/**
+ * EmbeddingProvider — Shared local embedding service using Transformers.js (ONNX).
+ *
+ * Loads all-MiniLM-L6-v2 (384-dim) once and provides embeddings to any memory
+ * system (SemanticMemory, MemoryIndex, TopicMemory). Also handles loading the
+ * sqlite-vec extension into better-sqlite3 connections.
+ *
+ * Design decisions:
+ *   - Singleton: Model (~80MB) is loaded once, shared across all consumers
+ *   - Lazy init: Model downloads on first embed() call, not on construction
+ *   - Graceful degradation: If model fails to load, embed() throws but callers
+ *     can catch and fall back to FTS5-only search
+ *   - Batch support: embedBatch() is more efficient than sequential embed() calls
+ */
+type Database = import('better-sqlite3').Database;
+export interface EmbeddingProviderConfig {
+    /** Model name for @huggingface/transformers (default: 'Xenova/all-MiniLM-L6-v2') */
+    modelName?: string;
+    /** Embedding dimension (default: 384 for all-MiniLM-L6-v2) */
+    dimensions?: number;
+    /** Maximum text length to embed in characters (default: 8192) */
+    maxTextLength?: number;
+}
+export declare class EmbeddingProvider {
+    private pipeline;
+    private loading;
+    private readonly modelName;
+    readonly dimensions: number;
+    private readonly maxTextLength;
+    private vecExtensionLoaded;
+    constructor(config?: EmbeddingProviderConfig);
+    /**
+     * Ensure the model is loaded. Safe to call multiple times — only loads once.
+     */
+    initialize(): Promise<void>;
+    private loadModel;
+    /**
+     * Whether the model is loaded and ready for embedding.
+     */
+    get isReady(): boolean;
+    /**
+     * Generate a normalized embedding for a single text string.
+     * Lazy-initializes the model on first call.
+     */
+    embed(text: string): Promise<Float32Array>;
+    /**
+     * Generate normalized embeddings for multiple texts.
+     * More efficient than sequential embed() calls for large batches.
+     */
+    embedBatch(texts: string[]): Promise<Float32Array[]>;
+    /**
+     * Load the sqlite-vec extension into a better-sqlite3 database connection.
+     * Safe to call multiple times on the same connection — tracks loaded state.
+     *
+     * @returns true if loaded successfully, false if sqlite-vec unavailable
+     */
+    loadVecExtension(db: Database): boolean;
+    private _sqliteVecModule;
+    /**
+     * Pre-load the sqlite-vec module. Must be called before loadVecExtension().
+     * Safe to call multiple times — only loads once.
+     *
+     * @returns true if sqlite-vec is available, false if not installed
+     */
+    loadVecModule(): Promise<boolean>;
+    /**
+     * Serialize a Float32Array to a Buffer for sqlite-vec storage.
+     * sqlite-vec expects embeddings as raw binary blobs.
+     */
+    static toBuffer(embedding: Float32Array): Buffer;
+    /**
+     * Deserialize a Buffer back to a Float32Array.
+     */
+    static fromBuffer(buffer: Buffer): Float32Array;
+    /**
+     * Compute cosine similarity between two embeddings.
+     * Assumes both are already L2-normalized (as produced by embed()).
+     */
+    static cosineSimilarity(a: Float32Array, b: Float32Array): number;
+}
+export {};
+//# sourceMappingURL=EmbeddingProvider.d.ts.map

package/dist/memory/EmbeddingProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingProvider.d.ts","sourceRoot":"","sources":["../../src/memory/EmbeddingProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,KAAK,QAAQ,GAAG,OAAO,gBAAgB,EAAE,QAAQ,CAAC;AAElD,MAAM,WAAW,uBAAuB;IACtC,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,kBAAkB,CAAyB;gBAEvC,MAAM,CAAC,EAAE,uBAAuB;IAQ5C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAWnB,SAAS;IAOvB;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAID;;;OAGG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAahD;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA2B1D;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO;IAgBvC,OAAO,CAAC,gBAAgB,CAA4C;IAEpE;;;;;OAKG;IACG,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAcvC;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM;IAIhD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAO/C;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM;CAUlE"}

package/dist/memory/EmbeddingProvider.js

@@ -0,0 +1,168 @@
+/**
+ * EmbeddingProvider — Shared local embedding service using Transformers.js (ONNX).
+ *
+ * Loads all-MiniLM-L6-v2 (384-dim) once and provides embeddings to any memory
+ * system (SemanticMemory, MemoryIndex, TopicMemory). Also handles loading the
+ * sqlite-vec extension into better-sqlite3 connections.
+ *
+ * Design decisions:
+ *   - Singleton: Model (~80MB) is loaded once, shared across all consumers
+ *   - Lazy init: Model downloads on first embed() call, not on construction
+ *   - Graceful degradation: If model fails to load, embed() throws but callers
+ *     can catch and fall back to FTS5-only search
+ *   - Batch support: embedBatch() is more efficient than sequential embed() calls
+ */
+export class EmbeddingProvider {
+    pipeline = null;
+    loading = null;
+    modelName;
+    dimensions;
+    maxTextLength;
+    vecExtensionLoaded = new WeakSet();
+    constructor(config) {
+        this.modelName = config?.modelName ?? 'Xenova/all-MiniLM-L6-v2';
+        this.dimensions = config?.dimensions ?? 384;
+        this.maxTextLength = config?.maxTextLength ?? 8192;
+    }
+    // ─── Lifecycle ──────────────────────────────────────────────────
+    /**
+     * Ensure the model is loaded. Safe to call multiple times — only loads once.
+     */
+    async initialize() {
+        if (this.pipeline)
+            return;
+        if (this.loading) {
+            await this.loading;
+            return;
+        }
+        this.loading = this.loadModel();
+        await this.loading;
+    }
+    async loadModel() {
+        const { pipeline: createPipeline } = await import('@huggingface/transformers');
+        this.pipeline = await createPipeline('feature-extraction', this.modelName, {
+            dtype: 'fp32',
+        });
+    }
+    /**
+     * Whether the model is loaded and ready for embedding.
+     */
+    get isReady() {
+        return this.pipeline !== null;
+    }
+    // ─── Embedding ──────────────────────────────────────────────────
+    /**
+     * Generate a normalized embedding for a single text string.
+     * Lazy-initializes the model on first call.
+     */
+    async embed(text) {
+        await this.initialize();
+        const truncated = text.slice(0, this.maxTextLength);
+        const output = await this.pipeline(truncated, {
+            pooling: 'mean',
+            normalize: true,
+        });
+        // output.data is a Float32Array from the ONNX model
+        return new Float32Array(output.data);
+    }
+    /**
+     * Generate normalized embeddings for multiple texts.
+     * More efficient than sequential embed() calls for large batches.
+     */
+    async embedBatch(texts) {
+        if (texts.length === 0)
+            return [];
+        if (texts.length === 1)
+            return [await this.embed(texts[0])];
+        await this.initialize();
+        const truncated = texts.map(t => t.slice(0, this.maxTextLength));
+        const results = [];
+        // Process in batches of 32 to avoid memory pressure
+        const batchSize = 32;
+        for (let i = 0; i < truncated.length; i += batchSize) {
+            const batch = truncated.slice(i, i + batchSize);
+            for (const text of batch) {
+                const output = await this.pipeline(text, {
+                    pooling: 'mean',
+                    normalize: true,
+                });
+                results.push(new Float32Array(output.data));
+            }
+        }
+        return results;
+    }
+    // ─── sqlite-vec Extension ───────────────────────────────────────
+    /**
+     * Load the sqlite-vec extension into a better-sqlite3 database connection.
+     * Safe to call multiple times on the same connection — tracks loaded state.
+     *
+     * @returns true if loaded successfully, false if sqlite-vec unavailable
+     */
+    loadVecExtension(db) {
+        // Use db object identity to track whether extension is already loaded
+        if (this.vecExtensionLoaded.has(db))
+            return true;
+        // sqlite-vec must be pre-loaded via loadVecExtensionAsync() first
+        if (!this._sqliteVecModule)
+            return false;
+        try {
+            this._sqliteVecModule.load(db);
+            this.vecExtensionLoaded.add(db);
+            return true;
+        }
+        catch { // @silent-fallback-ok: graceful degradation to FTS5-only when sqlite-vec fails
+            return false;
+        }
+    }
+    _sqliteVecModule = null;
+    /**
+     * Pre-load the sqlite-vec module. Must be called before loadVecExtension().
+     * Safe to call multiple times — only loads once.
+     *
+     * @returns true if sqlite-vec is available, false if not installed
+     */
+    async loadVecModule() {
+        if (this._sqliteVecModule)
+            return true;
+        try {
+            const mod = await import('sqlite-vec');
+            this._sqliteVecModule = mod;
+            return true;
+        }
+        catch { // @silent-fallback-ok: sqlite-vec is optional dependency, FTS5-only when not installed
+            return false;
+        }
+    }
+    // ─── Utilities ──────────────────────────────────────────────────
+    /**
+     * Serialize a Float32Array to a Buffer for sqlite-vec storage.
+     * sqlite-vec expects embeddings as raw binary blobs.
+     */
+    static toBuffer(embedding) {
+        return Buffer.from(embedding.buffer, embedding.byteOffset, embedding.byteLength);
+    }
+    /**
+     * Deserialize a Buffer back to a Float32Array.
+     */
+    static fromBuffer(buffer) {
+        const copy = new ArrayBuffer(buffer.length);
+        const view = new Uint8Array(copy);
+        view.set(buffer);
+        return new Float32Array(copy);
+    }
+    /**
+     * Compute cosine similarity between two embeddings.
+     * Assumes both are already L2-normalized (as produced by embed()).
+     */
+    static cosineSimilarity(a, b) {
+        if (a.length !== b.length) {
+            throw new Error(`Dimension mismatch: ${a.length} vs ${b.length}`);
+        }
+        let dot = 0;
+        for (let i = 0; i < a.length; i++) {
+            dot += a[i] * b[i];
+        }
+        return dot;
+    }
+}
+//# sourceMappingURL=EmbeddingProvider.js.map

package/dist/memory/EmbeddingProvider.js.map

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

package/dist/memory/EpisodicMemory.d.ts

@@ -0,0 +1,141 @@
+/**
+ * EpisodicMemory — Activity digest + session synthesis storage and retrieval.
+ *
+ * Stores two levels of episodic data:
+ *   1. Activity Digests (mini-digests) — short summaries of individual activity
+ *      units within a session (30-60 min chunks)
+ *   2. Session Syntheses — coherent overviews composed from all activity digests
+ *      when a session completes
+ *
+ * Storage is JSON file-based (no SQLite) to keep episodic data portable
+ * and easily inspectable. Files live under state/episodes/.
+ *
+ * Implements the Phase 3 design from PROP-memory-architecture.md v3.1.
+ */
+export type BoundarySignal = 'topic_shift' | 'task_complete' | 'long_pause' | 'explicit_switch' | 'time_threshold' | 'session_end';
+export interface ActivityDigest {
+    id: string;
+    sessionId: string;
+    sessionName: string;
+    startedAt: string;
+    endedAt: string;
+    telegramTopicId?: number;
+    summary: string;
+    actions: string[];
+    entities: string[];
+    learnings: string[];
+    significance: number;
+    themes: string[];
+    boundarySignal: BoundarySignal;
+}
+export interface SessionSynthesis {
+    sessionId: string;
+    sessionName: string;
+    startedAt: string;
+    endedAt: string;
+    jobSlug?: string;
+    telegramTopicId?: number;
+    activityDigestIds: string[];
+    summary: string;
+    keyOutcomes: string[];
+    allEntities: string[];
+    allLearnings: string[];
+    significance: number;
+    themes: string[];
+    followUp?: string;
+}
+export interface SentinelState {
+    lastScanAt: string;
+    sessions: Record<string, {
+        lastDigestedAt: string;
+        lastActivityAt?: string;
+        digestCount: number;
+    }>;
+}
+export interface EpisodicMemoryConfig {
+    stateDir: string;
+}
+export declare class EpisodicMemory {
+    private readonly episodesDir;
+    private readonly activitiesDir;
+    private readonly sessionsDir;
+    private readonly pendingDir;
+    private readonly sentinelStatePath;
+    constructor(config: EpisodicMemoryConfig);
+    private ensureDirs;
+    /**
+     * Save an activity digest. Returns the digest ID.
+     * Idempotent: uses hash(sessionId + startedAt + endedAt) to detect duplicates.
+     */
+    saveDigest(digest: Omit<ActivityDigest, 'id'>): string;
+    /**
+     * Get a specific activity digest by ID.
+     */
+    getDigest(sessionId: string, digestId: string): ActivityDigest | null;
+    /**
+     * Get all activity digests for a session, ordered by startedAt.
+     */
+    getSessionActivities(sessionId: string): ActivityDigest[];
+    /**
+     * Save a session synthesis. Overwrites if exists.
+     */
+    saveSynthesis(synthesis: SessionSynthesis): void;
+    /**
+     * Get the session synthesis for a completed session.
+     */
+    getSynthesis(sessionId: string): SessionSynthesis | null;
+    /**
+     * List all session syntheses, ordered by startedAt descending (newest first).
+     */
+    listSyntheses(limit?: number): SessionSynthesis[];
+    /**
+     * Get digests across all sessions within a time range.
+     */
+    getByTimeRange(start: string, end: string): ActivityDigest[];
+    /**
+     * Get digests matching a theme across all sessions.
+     */
+    getByTheme(theme: string): ActivityDigest[];
+    /**
+     * Get the most significant digests across all sessions.
+     */
+    getBySignificance(minSignificance: number): ActivityDigest[];
+    /**
+     * Get recent activity across all sessions (for working memory).
+     */
+    getRecentActivity(hours: number, limit: number): ActivityDigest[];
+    getSentinelState(): SentinelState;
+    saveSentinelState(state: SentinelState): void;
+    /**
+     * Save raw activity content when LLM digestion fails.
+     * Stored for retry by the sentinel.
+     */
+    savePending(sessionId: string, content: string): string;
+    /**
+     * Get all pending items for a session.
+     */
+    getPending(sessionId: string): Array<{
+        id: string;
+        sessionId: string;
+        content: string;
+        createdAt: string;
+        retryCount: number;
+    }>;
+    /**
+     * Remove a pending item after successful processing.
+     */
+    removePending(sessionId: string, pendingId: string): void;
+    /**
+     * Increment retry count for a pending item.
+     */
+    incrementPendingRetry(sessionId: string, pendingId: string): number;
+    stats(): {
+        totalDigests: number;
+        totalSyntheses: number;
+        totalPending: number;
+        sessionCount: number;
+    };
+    private digestKey;
+    private findDigestByKey;
+}
+//# sourceMappingURL=EpisodicMemory.d.ts.map

package/dist/memory/EpisodicMemory.d.ts.map

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