@oobe-protocol-labs/sap-mcp-server 0.9.1 → 0.9.3

package/dist/memory/hermes-bridge.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @module memory
+ * @description SAP MCP local agent memory subsystem — SQLite FTS5 backed.
+ *
+ * Exports all stores and types for use by the MCP tool registration layer.
+ *
+ * Architecture:
+ * - database.ts: Thread-safe singleton SQLite connection with WAL mode + FTS5.
+ * - tool-call-store.ts: Records and searches tool call history.
+ * - memory-store.ts: Manages LLM-generated agent memories with relevance decay.
+ * - stream-buffer-store.ts: Buffers premium stream events for offline consumption.
+ * - types.ts: Type definitions.
+ * - utils.ts: Utility functions (truncate, decay, expiry).
+ */
+export { MemoryDatabase, memoryDatabase, DEFAULT_CONFIG } from './database.js';
+export { ToolCallStore, toolCallStore } from './tool-call-store.js';
+export { MemoryStore, memoryStore } from './memory-store.js';
+export { StreamBufferStore, streamBufferStore } from './stream-buffer-store.js';
+export { AsyncMemoryProcessor, asyncMemoryProcessor } from './async-processor.js';
+export { recordToolCall } from './auto-record.js';
+export { HermesBridge, hermesBridge } from './hermes-bridge.js';
+export type { ToolCallRecord, ToolCallOutcome, AgentMemoryRecord, MemoryType, StreamBufferRecord, MemorySearchResult, MemoryQueryOptions, MemoryStats, MemoryPruneResult, MemoryConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,22 @@
+/**
+ * @module memory
+ * @description SAP MCP local agent memory subsystem — SQLite FTS5 backed.
+ *
+ * Exports all stores and types for use by the MCP tool registration layer.
+ *
+ * Architecture:
+ * - database.ts: Thread-safe singleton SQLite connection with WAL mode + FTS5.
+ * - tool-call-store.ts: Records and searches tool call history.
+ * - memory-store.ts: Manages LLM-generated agent memories with relevance decay.
+ * - stream-buffer-store.ts: Buffers premium stream events for offline consumption.
+ * - types.ts: Type definitions.
+ * - utils.ts: Utility functions (truncate, decay, expiry).
+ */
+export { MemoryDatabase, memoryDatabase, DEFAULT_CONFIG } from './database.js';
+export { ToolCallStore, toolCallStore } from './tool-call-store.js';
+export { MemoryStore, memoryStore } from './memory-store.js';
+export { StreamBufferStore, streamBufferStore } from './stream-buffer-store.js';
+export { AsyncMemoryProcessor, asyncMemoryProcessor } from './async-processor.js';
+export { recordToolCall } from './auto-record.js';
+export { HermesBridge, hermesBridge } from './hermes-bridge.js';
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/memory/memory-store.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @module memory/memory-store
+ * @description Store for agent memories — LLM-compressed summaries of past interactions.
+ *
+ * Memories are created by the agent (or auto-generated by the summarize tool)
+ * and stored with a relevance score that decays over time. The FTS5 index
+ * enables semantic search across all memories for context injection.
+ */
+import type { AgentMemoryRecord, MemoryType, MemorySearchResult, MemoryQueryOptions } from './types.js';
+/**
+ * @name MemoryStore
+ * @description Manages agent memory records with relevance decay and FTS5 search.
+ */
+export declare class MemoryStore {
+    /**
+     * @name record
+     * @description Creates a new agent memory entry.
+     * @param record - Memory data to record (without id, timestamps, relevance).
+     * @param initialRelevance - Initial relevance score 0-1. Default 0.8.
+     * @returns The inserted record ID, or -1 if degraded.
+     */
+    record(record: Pick<AgentMemoryRecord, 'memoryType' | 'category' | 'summary' | 'sourceToolCalls' | 'expiresAt'>, initialRelevance?: number): number;
+    /**
+     * @name search
+     * @description Full-text search across agent memories using FTS5.
+     * Results are ranked by BM25 relevance with decayed score.
+     */
+    search(options: MemoryQueryOptions): MemorySearchResult<AgentMemoryRecord & {
+        decayedRelevance: number;
+    }>;
+    /**
+     * @name recall
+     * @description Returns the most relevant memories for a given category.
+     * Used for prompt injection — the agent gets the top N memories ordered
+     * by decayed relevance.
+     * @param category - Tool category to recall memories for.
+     * @param limit - Maximum number of memories. Default 5.
+     * @returns Relevant memories sorted by decayed relevance.
+     */
+    recall(category: string, limit?: number): AgentMemoryRecord[];
+    /**
+     * @name count
+     * @description Returns the total number of agent memory records.
+     */
+    count(): number;
+    /**
+     * @name memoryTypeBreakdown
+     * @description Returns counts grouped by memory type.
+     */
+    memoryTypeBreakdown(): Record<MemoryType, number>;
+    /**
+     * @name lastMemoryAt
+     * @description Returns the timestamp of the most recent memory.
+     */
+    lastMemoryAt(): string | null;
+    /**
+     * @name prune
+     * @description Removes expired memories and memories with relevance below
+     * the threshold after decay.
+     * @param minRelevance - Minimum decayed relevance to keep. Default 0.05.
+     * @returns Number of memories pruned.
+     */
+    prune(minRelevance?: number): number;
+    /**
+     * @name buildFtsQuery
+     * @description Converts a natural language query into a FTS5 MATCH expression.
+     * @internal
+     */
+    private buildFtsQuery;
+}
+/**
+ * @name memoryStore
+ * @description Singleton instance of the memory store.
+ */
+export declare const memoryStore: MemoryStore;
+//# sourceMappingURL=memory-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/memory/memory-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAExG;;;GAGG;AACH,qBAAa,WAAW;IACtB;;;;;;OAMG;IACH,MAAM,CACJ,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,iBAAiB,GAAG,WAAW,CAAC,EACxG,gBAAgB,SAAM,GACrB,MAAM;IAmBT;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAAC,iBAAiB,GAAG;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IAsEzG;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,iBAAiB,EAAE;IA2BxD;;;OAGG;IACH,KAAK,IAAI,MAAM;IAQf;;;OAGG;IACH,mBAAmB,IAAI,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC;IAgBjD;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAS7B;;;;;;OAMG;IACH,KAAK,CAAC,YAAY,SAAO,GAAG,MAAM;IA4BlC;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAOtB;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/memory/memory-store.js

@@ -0,0 +1,231 @@
+/**
+ * @module memory/memory-store
+ * @description Store for agent memories — LLM-compressed summaries of past interactions.
+ *
+ * Memories are created by the agent (or auto-generated by the summarize tool)
+ * and stored with a relevance score that decays over time. The FTS5 index
+ * enables semantic search across all memories for context injection.
+ */
+import { memoryDatabase } from './database.js';
+import { decayRelevance, isExpired } from './utils.js';
+/**
+ * @name MemoryStore
+ * @description Manages agent memory records with relevance decay and FTS5 search.
+ */
+export class MemoryStore {
+    /**
+     * @name record
+     * @description Creates a new agent memory entry.
+     * @param record - Memory data to record (without id, timestamps, relevance).
+     * @param initialRelevance - Initial relevance score 0-1. Default 0.8.
+     * @returns The inserted record ID, or -1 if degraded.
+     */
+    record(record, initialRelevance = 0.8) {
+        if (memoryDatabase.isDegraded())
+            return -1;
+        memoryDatabase.init();
+        const stmt = memoryDatabase.getStatement('insert_memory');
+        if (!stmt)
+            return -1;
+        const result = stmt.run({
+            memoryType: record.memoryType,
+            category: record.category,
+            summary: record.summary,
+            sourceToolCalls: record.sourceToolCalls ?? null,
+            relevanceScore: Math.max(0, Math.min(1, initialRelevance)),
+            expiresAt: record.expiresAt ?? null,
+        });
+        return result.lastInsertRowid;
+    }
+    /**
+     * @name search
+     * @description Full-text search across agent memories using FTS5.
+     * Results are ranked by BM25 relevance with decayed score.
+     */
+    search(options) {
+        if (memoryDatabase.isDegraded()) {
+            return { results: [], total: 0, hasMore: false };
+        }
+        memoryDatabase.init();
+        const db = memoryDatabase.getDb();
+        const limit = Math.min(options.limit ?? 20, 100);
+        const offset = options.offset ?? 0;
+        let whereClause = '';
+        const params = { limit, offset };
+        if (options.memoryType) {
+            whereClause += ' AND m.memory_type = @memoryType';
+            params['memoryType'] = options.memoryType;
+        }
+        if (options.category) {
+            whereClause += ' AND m.category = @category';
+            params['category'] = options.category;
+        }
+        const ftsQuery = this.buildFtsQuery(options.query);
+        const sql = `
+      SELECT m.id, m.memory_type, m.category, m.summary, m.source_tool_calls,
+             m.relevance_score, m.created_at, m.expires_at, m.last_accessed_at
+      FROM agent_memory_fts fts
+      JOIN agent_memory m ON m.id = fts.rowid
+      WHERE agent_memory_fts MATCH @ftsQuery
+      ${whereClause}
+      ORDER BY ${options.sort === 'newest' ? 'm.created_at DESC' : options.sort === 'oldest' ? 'm.created_at ASC' : 'bm25(agent_memory_fts)'}
+      LIMIT @limit OFFSET @offset
+    `;
+        params['ftsQuery'] = ftsQuery;
+        try {
+            const rows = db.prepare(sql).all(params);
+            const results = rows.map(row => ({
+                ...row,
+                decayedRelevance: decayRelevance(row.relevanceScore, row.createdAt, 0.01),
+            }));
+            // Filter by minimum relevance (after decay).
+            const filtered = options.minRelevance
+                ? results.filter(r => r.decayedRelevance >= (options.minRelevance ?? 0))
+                : results;
+            // Filter out expired memories.
+            const active = filtered.filter(r => !isExpired(r.expiresAt));
+            // Update last_accessed_at for returned memories.
+            const updateStmt = memoryDatabase.getStatement('update_memory_access');
+            if (updateStmt) {
+                for (const r of active) {
+                    if (r.id)
+                        updateStmt.run(r.id);
+                }
+            }
+            return {
+                results: active,
+                total: active.length,
+                hasMore: false,
+            };
+        }
+        catch {
+            return { results: [], total: 0, hasMore: false };
+        }
+    }
+    /**
+     * @name recall
+     * @description Returns the most relevant memories for a given category.
+     * Used for prompt injection — the agent gets the top N memories ordered
+     * by decayed relevance.
+     * @param category - Tool category to recall memories for.
+     * @param limit - Maximum number of memories. Default 5.
+     * @returns Relevant memories sorted by decayed relevance.
+     */
+    recall(category, limit = 5) {
+        if (memoryDatabase.isDegraded())
+            return [];
+        memoryDatabase.init();
+        const db = memoryDatabase.getDb();
+        try {
+            const rows = db.prepare(`SELECT * FROM agent_memory
+         WHERE category = ? AND (expires_at IS NULL OR expires_at > datetime('now'))
+         ORDER BY relevance_score DESC
+         LIMIT ?`).all(category, limit);
+            // Update last_accessed_at.
+            const updateStmt = memoryDatabase.getStatement('update_memory_access');
+            if (updateStmt) {
+                for (const row of rows) {
+                    if (row.id)
+                        updateStmt.run(row.id);
+                }
+            }
+            return rows;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * @name count
+     * @description Returns the total number of agent memory records.
+     */
+    count() {
+        if (memoryDatabase.isDegraded())
+            return 0;
+        memoryDatabase.init();
+        const stmt = memoryDatabase.getStatement('count_memory');
+        if (!stmt)
+            return 0;
+        return stmt.get().count;
+    }
+    /**
+     * @name memoryTypeBreakdown
+     * @description Returns counts grouped by memory type.
+     */
+    memoryTypeBreakdown() {
+        if (memoryDatabase.isDegraded()) {
+            return { lesson: 0, pattern: 0, failure: 0, success: 0 };
+        }
+        memoryDatabase.init();
+        const stmt = memoryDatabase.getStatement('count_memory_by_type');
+        if (!stmt)
+            return { lesson: 0, pattern: 0, failure: 0, success: 0 };
+        const rows = stmt.all();
+        const result = { lesson: 0, pattern: 0, failure: 0, success: 0 };
+        for (const row of rows) {
+            result[row.memory_type] = row.count;
+        }
+        return result;
+    }
+    /**
+     * @name lastMemoryAt
+     * @description Returns the timestamp of the most recent memory.
+     */
+    lastMemoryAt() {
+        if (memoryDatabase.isDegraded())
+            return null;
+        memoryDatabase.init();
+        const stmt = memoryDatabase.getStatement('last_memory_at');
+        if (!stmt)
+            return null;
+        const row = stmt.get();
+        return row?.created_at ?? null;
+    }
+    /**
+     * @name prune
+     * @description Removes expired memories and memories with relevance below
+     * the threshold after decay.
+     * @param minRelevance - Minimum decayed relevance to keep. Default 0.05.
+     * @returns Number of memories pruned.
+     */
+    prune(minRelevance = 0.05) {
+        if (memoryDatabase.isDegraded())
+            return 0;
+        memoryDatabase.init();
+        const db = memoryDatabase.getDb();
+        // Delete expired memories.
+        const expiredResult = db.prepare(`DELETE FROM agent_memory WHERE expires_at IS NOT NULL AND expires_at <= datetime('now')`).run();
+        // Delete low-relevance memories (check decayed relevance in JS to avoid
+        // complex SQL — better-sqlite3 is synchronous so this is fast).
+        const allRows = db.prepare(`SELECT id, relevance_score, created_at FROM agent_memory`).all();
+        let pruned = expiredResult.changes;
+        for (const row of allRows) {
+            const decayed = decayRelevance(row.relevance_score, row.created_at, 0.01);
+            if (decayed < minRelevance) {
+                db.prepare('DELETE FROM agent_memory WHERE id = ?').run(row.id);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+    /**
+     * @name buildFtsQuery
+     * @description Converts a natural language query into a FTS5 MATCH expression.
+     * @internal
+     */
+    buildFtsQuery(query) {
+        const escaped = query.replace(/["'*:]/g, ' ').trim();
+        if (!escaped)
+            return '*';
+        const words = escaped.split(/\s+/).filter(w => w.length > 0);
+        if (words.length === 1)
+            return `"${words[0]}"*`;
+        return words.map(w => `"${w}"*`).join(' OR ');
+    }
+}
+/**
+ * @name memoryStore
+ * @description Singleton instance of the memory store.
+ */
+export const memoryStore = new MemoryStore();
+//# sourceMappingURL=memory-store.js.map

package/dist/memory/memory-store.js.map

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

package/dist/memory/stream-buffer-store.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @module memory/stream-buffer-store
+ * @description Store for buffering stream events locally in SQLite.
+ *
+ * Premium stream events (Pyth price ticks, meme alerts, volatility signals) are
+ * persisted locally so the agent can consume them without paid polls. Events
+ * are deduplicated by (streamType, eventId) and consumed in FIFO order.
+ */
+import type { StreamBufferRecord } from './types.js';
+/**
+ * @name StreamBufferStore
+ * @description Manages local stream event buffering with FIFO consumption.
+ */
+export declare class StreamBufferStore {
+    /**
+     * @name buffer
+     * @description Buffers a stream event. Deduplicates by (streamType, eventId).
+     * @param record - Event to buffer.
+     * @returns The row ID, or -1 if the event was already buffered (dedup).
+     */
+    buffer(record: Omit<StreamBufferRecord, 'id' | 'consumed' | 'createdAt'>): number;
+    /**
+     * @name consume
+     * @description Returns unconsumed events for a stream type and marks them consumed.
+     * FIFO order (oldest first). Returns up to `limit` events.
+     * @param streamType - Stream type to consume (e.g. 'pyth-price').
+     * @param limit - Maximum events to consume. Default 20.
+     * @returns Consumed events.
+     */
+    consume(streamType: string, limit?: number): StreamBufferRecord[];
+    /**
+     * @name peek
+     * @description Returns unconsumed events without marking them consumed.
+     * Used for preview/inspection.
+     */
+    peek(streamType: string, limit?: number): StreamBufferRecord[];
+    /**
+     * @name replay
+     * @description Returns all events (consumed + unconsumed) for a stream type
+     * within a time range. Used for backtest/analysis.
+     * @param streamType - Stream type to replay.
+     * @param since - ISO 8601 timestamp. Events created after this time.
+     * @param limit - Maximum events. Default 100.
+     */
+    replay(streamType: string, since?: string, limit?: number): StreamBufferRecord[];
+    /**
+     * @name pendingCount
+     * @description Returns the number of unconsumed events.
+     */
+    pendingCount(): number;
+    /**
+     * @name evict
+     * @description Evicts old consumed events to keep the buffer bounded.
+     * @param maxPerType - Maximum events per stream type. Default 10000.
+     * @returns Number of events evicted.
+     */
+    evict(maxPerType?: number): number;
+    /**
+     * @name clear
+     * @description Clears all events for a stream type.
+     */
+    clear(streamType: string): number;
+}
+/**
+ * @name streamBufferStore
+ * @description Singleton instance of the stream buffer store.
+ */
+export declare const streamBufferStore: StreamBufferStore;
+//# sourceMappingURL=stream-buffer-store.d.ts.map

package/dist/memory/stream-buffer-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-buffer-store.d.ts","sourceRoot":"","sources":["../../src/memory/stream-buffer-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,CAAC,GAAG,MAAM;IAqBjF;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,kBAAkB,EAAE;IA4B7D;;;;OAIG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,kBAAkB,EAAE;IAiB1D;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,kBAAkB,EAAE;IAuB7E;;;OAGG;IACH,YAAY,IAAI,MAAM;IAQtB;;;;;OAKG;IACH,KAAK,CAAC,UAAU,SAAS,GAAG,MAAM;IAoBlC;;;OAGG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAalC;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/memory/stream-buffer-store.js

@@ -0,0 +1,182 @@
+/**
+ * @module memory/stream-buffer-store
+ * @description Store for buffering stream events locally in SQLite.
+ *
+ * Premium stream events (Pyth price ticks, meme alerts, volatility signals) are
+ * persisted locally so the agent can consume them without paid polls. Events
+ * are deduplicated by (streamType, eventId) and consumed in FIFO order.
+ */
+import { memoryDatabase } from './database.js';
+/**
+ * @name StreamBufferStore
+ * @description Manages local stream event buffering with FIFO consumption.
+ */
+export class StreamBufferStore {
+    /**
+     * @name buffer
+     * @description Buffers a stream event. Deduplicates by (streamType, eventId).
+     * @param record - Event to buffer.
+     * @returns The row ID, or -1 if the event was already buffered (dedup).
+     */
+    buffer(record) {
+        if (memoryDatabase.isDegraded())
+            return -1;
+        memoryDatabase.init();
+        const stmt = memoryDatabase.getStatement('insert_stream_event');
+        if (!stmt)
+            return -1;
+        try {
+            const result = stmt.run({
+                streamType: record.streamType,
+                eventId: record.eventId,
+                eventType: record.eventType,
+                payload: record.payload,
+            });
+            return result.lastInsertRowid;
+        }
+        catch {
+            // INSERT OR IGNORE — dedup case, event already exists.
+            return -1;
+        }
+    }
+    /**
+     * @name consume
+     * @description Returns unconsumed events for a stream type and marks them consumed.
+     * FIFO order (oldest first). Returns up to `limit` events.
+     * @param streamType - Stream type to consume (e.g. 'pyth-price').
+     * @param limit - Maximum events to consume. Default 20.
+     * @returns Consumed events.
+     */
+    consume(streamType, limit = 20) {
+        if (memoryDatabase.isDegraded())
+            return [];
+        memoryDatabase.init();
+        const db = memoryDatabase.getDb();
+        try {
+            const events = db.prepare(`SELECT * FROM stream_buffers
+         WHERE stream_type = ? AND consumed = 0
+         ORDER BY id ASC
+         LIMIT ?`).all(streamType, limit);
+            if (events.length === 0)
+                return [];
+            // Mark as consumed.
+            const lastId = events[events.length - 1].id;
+            if (lastId !== undefined) {
+                const consumeStmt = memoryDatabase.getStatement('consume_stream_events');
+                consumeStmt?.run(streamType, lastId);
+            }
+            return events;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * @name peek
+     * @description Returns unconsumed events without marking them consumed.
+     * Used for preview/inspection.
+     */
+    peek(streamType, limit = 20) {
+        if (memoryDatabase.isDegraded())
+            return [];
+        memoryDatabase.init();
+        const db = memoryDatabase.getDb();
+        try {
+            return db.prepare(`SELECT * FROM stream_buffers
+         WHERE stream_type = ? AND consumed = 0
+         ORDER BY id ASC
+         LIMIT ?`).all(streamType, limit);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * @name replay
+     * @description Returns all events (consumed + unconsumed) for a stream type
+     * within a time range. Used for backtest/analysis.
+     * @param streamType - Stream type to replay.
+     * @param since - ISO 8601 timestamp. Events created after this time.
+     * @param limit - Maximum events. Default 100.
+     */
+    replay(streamType, since, limit = 100) {
+        if (memoryDatabase.isDegraded())
+            return [];
+        memoryDatabase.init();
+        const db = memoryDatabase.getDb();
+        try {
+            if (since) {
+                return db.prepare(`SELECT * FROM stream_buffers
+           WHERE stream_type = ? AND created_at >= ?
+           ORDER BY id ASC LIMIT ?`).all(streamType, since, limit);
+            }
+            return db.prepare(`SELECT * FROM stream_buffers
+         WHERE stream_type = ?
+         ORDER BY id ASC LIMIT ?`).all(streamType, limit);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * @name pendingCount
+     * @description Returns the number of unconsumed events.
+     */
+    pendingCount() {
+        if (memoryDatabase.isDegraded())
+            return 0;
+        memoryDatabase.init();
+        const stmt = memoryDatabase.getStatement('count_pending_streams');
+        if (!stmt)
+            return 0;
+        return stmt.get().count;
+    }
+    /**
+     * @name evict
+     * @description Evicts old consumed events to keep the buffer bounded.
+     * @param maxPerType - Maximum events per stream type. Default 10000.
+     * @returns Number of events evicted.
+     */
+    evict(maxPerType = 10_000) {
+        if (memoryDatabase.isDegraded())
+            return 0;
+        memoryDatabase.init();
+        const db = memoryDatabase.getDb();
+        try {
+            // Delete oldest consumed events that exceed the per-type limit.
+            const result = db.prepare(`DELETE FROM stream_buffers
+         WHERE consumed = 1 AND id NOT IN (
+           SELECT id FROM stream_buffers
+           WHERE stream_type = (SELECT stream_type FROM stream_buffers s2 WHERE s2.id = stream_buffers.id)
+           ORDER BY id DESC LIMIT ?
+         )`).run(maxPerType);
+            return result.changes;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * @name clear
+     * @description Clears all events for a stream type.
+     */
+    clear(streamType) {
+        if (memoryDatabase.isDegraded())
+            return 0;
+        memoryDatabase.init();
+        const db = memoryDatabase.getDb();
+        try {
+            const result = db.prepare('DELETE FROM stream_buffers WHERE stream_type = ?').run(streamType);
+            return result.changes;
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+/**
+ * @name streamBufferStore
+ * @description Singleton instance of the stream buffer store.
+ */
+export const streamBufferStore = new StreamBufferStore();
+//# sourceMappingURL=stream-buffer-store.js.map

package/dist/memory/stream-buffer-store.js.map

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