universal-agent-protocol 0.5.0

package/dist/memory/backends/qdrant-cloud.js

@@ -0,0 +1,168 @@
+import { QdrantClient } from '@qdrant/js-client-rest';
+import { getEmbeddingService } from '../embeddings.js';
+import { createHash } from 'crypto';
+/**
+ * Generate a safe collection name from project ID
+ * Qdrant collection names must be alphanumeric with underscores
+ */
+function sanitizeCollectionName(base, projectId) {
+    if (!projectId)
+        return base;
+    // Create a short hash of the project ID for uniqueness
+    const hash = createHash('sha256').update(projectId).digest('hex').slice(0, 8);
+    // Sanitize project name (take last path component, remove special chars)
+    const projectName = projectId
+        .split(/[/\\]/).pop() || projectId
+        .replace(/[^a-zA-Z0-9_-]/g, '_')
+        .slice(0, 32);
+    return `${base}_${projectName}_${hash}`;
+}
+export class QdrantCloudBackend {
+    client;
+    collection;
+    projectId;
+    vectorSize;
+    collectionVerified = false;
+    constructor(config) {
+        const apiKey = config.apiKey || process.env.QDRANT_API_KEY;
+        const url = config.url || process.env.QDRANT_URL;
+        if (!url) {
+            throw new Error('Qdrant URL required (QDRANT_URL env var or config)');
+        }
+        this.client = new QdrantClient({ url, apiKey });
+        this.projectId = config.projectId || process.cwd();
+        this.collection = sanitizeCollectionName(config.collection, this.projectId);
+        this.vectorSize = config.vectorSize || 768; // Default to Ollama's nomic-embed-text size
+    }
+    async isConfigured() {
+        try {
+            await this.client.getCollections();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async store(entry) {
+        if (!entry.embedding) {
+            throw new Error('Embedding required for Qdrant storage');
+        }
+        await this.ensureCollection();
+        await this.client.upsert(this.collection, {
+            points: [
+                {
+                    id: entry.id,
+                    vector: entry.embedding,
+                    payload: {
+                        timestamp: entry.timestamp,
+                        type: entry.type,
+                        content: entry.content,
+                        tags: entry.tags,
+                        importance: entry.importance,
+                        ...entry.metadata,
+                    },
+                },
+            ],
+        });
+    }
+    async query(queryText, limit = 10) {
+        // Generate real embedding for semantic search
+        const embeddingService = getEmbeddingService();
+        const queryEmbedding = await embeddingService.embed(queryText);
+        const results = await this.client.search(this.collection, {
+            vector: queryEmbedding,
+            limit,
+            score_threshold: 0.5, // Only return relevant results
+        });
+        return results.map((r) => ({
+            id: String(r.id),
+            timestamp: r.payload?.timestamp,
+            type: r.payload?.type,
+            content: r.payload?.content,
+            embedding: r.vector,
+            tags: r.payload?.tags,
+            importance: r.payload?.importance,
+            metadata: r.payload,
+        }));
+    }
+    async getRecent(limit = 50) {
+        const results = await this.client.scroll(this.collection, {
+            limit,
+            with_payload: true,
+            with_vector: false,
+        });
+        return results.points.map((r) => ({
+            id: String(r.id),
+            timestamp: r.payload?.timestamp,
+            type: r.payload?.type,
+            content: r.payload?.content,
+            tags: r.payload?.tags,
+            importance: r.payload?.importance,
+            metadata: r.payload,
+        }));
+    }
+    async prune(olderThan) {
+        const results = await this.client.scroll(this.collection, {
+            filter: {
+                must: [
+                    {
+                        key: 'timestamp',
+                        range: {
+                            lt: olderThan.toISOString(),
+                        },
+                    },
+                ],
+            },
+            limit: 1000,
+            with_payload: false,
+        });
+        const ids = results.points.map((p) => p.id);
+        if (ids.length > 0) {
+            await this.client.delete(this.collection, { points: ids });
+        }
+        return ids.length;
+    }
+    async ensureCollection() {
+        if (this.collectionVerified)
+            return;
+        const collections = await this.client.getCollections();
+        const exists = collections.collections.some((c) => c.name === this.collection);
+        if (!exists) {
+            // Create collection with correct vector size
+            await this.client.createCollection(this.collection, {
+                vectors: { size: this.vectorSize, distance: 'Cosine' },
+            });
+            this.collectionVerified = true;
+            return;
+        }
+        // Check if existing collection has correct dimensions
+        const collectionInfo = await this.client.getCollection(this.collection);
+        const currentSize = collectionInfo.config?.params?.vectors?.size;
+        if (currentSize && currentSize !== this.vectorSize) {
+            // Create new collection with correct dimensions (append suffix)
+            const newCollectionName = `${this.collection}_v${this.vectorSize}`;
+            const newExists = collections.collections.some((c) => c.name === newCollectionName);
+            if (!newExists) {
+                await this.client.createCollection(newCollectionName, {
+                    vectors: { size: this.vectorSize, distance: 'Cosine' },
+                });
+                console.log(`[Qdrant] Created new collection ${newCollectionName} with ${this.vectorSize} dimensions`);
+            }
+            this.collection = newCollectionName;
+        }
+        this.collectionVerified = true;
+    }
+    /**
+     * Get the actual collection name being used (may differ from config if dimension mismatch)
+     */
+    getCollectionName() {
+        return this.collection;
+    }
+    /**
+     * Get vector dimensions
+     */
+    getVectorSize() {
+        return this.vectorSize;
+    }
+}
+//# sourceMappingURL=qdrant-cloud.js.map

package/dist/memory/backends/qdrant-cloud.js.map

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

package/dist/memory/context-compressor.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Context Compression Module for UAP
+ *
+ * Implements semantic compression to reduce token usage while preserving meaning.
+ * Based on Acon (Agent Context Optimization) and AgentCompress research.
+ */
+export interface CompressionResult {
+    original: string;
+    compressed: string;
+    originalTokens: number;
+    compressedTokens: number;
+    tokenReduction: number;
+    preservedSemantics: number;
+}
+export interface CompressorConfig {
+    maxTokens: number;
+    minSemanticPreservation: number;
+    compressionLevel: 'light' | 'medium' | 'aggressive';
+}
+/**
+ * Estimate token count using improved heuristics for mixed code/prose
+ * More accurate than simple length/4: accounts for whitespace splits,
+ * special characters, camelCase, and numeric tokens.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Compress a single memory entry
+ */
+export declare function compressMemoryEntry(content: string, config?: Partial<CompressorConfig>): CompressionResult;
+/**
+ * Compress multiple memories into a consolidated context
+ */
+export declare function compressMemoryBatch(memories: Array<{
+    content: string;
+    type: string;
+    importance?: number;
+}>, config?: Partial<CompressorConfig>): CompressionResult;
+/**
+ * Summarize old memories into a single compressed entry
+ */
+export declare function summarizeMemories(memories: Array<{
+    content: string;
+    timestamp: string;
+    type: string;
+}>, maxOutputTokens?: number): string;
+/**
+ * Smart truncation using head+tail split.
+ * Preserves both initial context (setup, config) and final output (errors, results).
+ * Head gets 60%, tail gets 40% of the allowed line budget.
+ */
+export declare function smartTruncate(content: string, maxChars: number): string;
+/**
+ * Context budget manager
+ */
+export declare class ContextBudget {
+    private maxTokens;
+    private usedTokens;
+    private sections;
+    constructor(maxTokens?: number);
+    allocate(section: string, content: string): {
+        content: string;
+        tokens: number;
+        truncated: boolean;
+    };
+    remaining(): number;
+    usage(): {
+        total: number;
+        used: number;
+        remaining: number;
+        sections: Record<string, number>;
+    };
+    reset(): void;
+}
+//# sourceMappingURL=context-compressor.d.ts.map

package/dist/memory/context-compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compressor.d.ts","sourceRoot":"","sources":["../../src/memory/context-compressor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC;CACrD;AAQD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsBnD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,iBAAiB,CAqE9G;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACvE,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACrC,iBAAiB,CA+CnB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACrE,eAAe,GAAE,MAAY,GAC5B,MAAM,CAoCR;AAqDD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA4BvE;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAkC;gBAEtC,SAAS,GAAE,MAAc;IAIrC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;IAsBnG,SAAS,IAAI,MAAM;IAInB,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAS7F,KAAK,IAAI,IAAI;CAId"}

package/dist/memory/context-compressor.js

@@ -0,0 +1,289 @@
+/**
+ * Context Compression Module for UAP
+ *
+ * Implements semantic compression to reduce token usage while preserving meaning.
+ * Based on Acon (Agent Context Optimization) and AgentCompress research.
+ */
+import { jaccardSimilarity } from '../utils/string-similarity.js';
+const DEFAULT_CONFIG = {
+    maxTokens: 800,
+    minSemanticPreservation: 0.85,
+    compressionLevel: 'medium',
+};
+/**
+ * Estimate token count using improved heuristics for mixed code/prose
+ * More accurate than simple length/4: accounts for whitespace splits,
+ * special characters, camelCase, and numeric tokens.
+ */
+export function estimateTokens(text) {
+    if (!text || text.length === 0)
+        return 0;
+    // Split by whitespace for base word count
+    const words = text.split(/\s+/).filter(w => w.length > 0);
+    // Special characters that typically become separate tokens
+    const specialChars = (text.match(/[{}()\[\]<>:;,."'`@#$%^&*+=|\\/?!~-]/g) || []).length;
+    // Code tokens: camelCase/snake_case boundaries add sub-word tokens
+    const codeTokens = (text.match(/[a-z][A-Z]|_[a-z]/g) || []).length;
+    // Numeric sequences often tokenize separately
+    const numbers = (text.match(/\d+/g) || []).length;
+    // Average English word is ~1.3 tokens, code identifiers ~1.5
+    const baseTokens = words.length * 1.3;
+    const specialTokens = specialChars * 0.5;
+    const extraCodeTokens = codeTokens * 0.3;
+    const numberTokens = numbers * 0.5;
+    return Math.ceil(baseTokens + specialTokens + extraCodeTokens + numberTokens);
+}
+/**
+ * Compress a single memory entry
+ */
+export function compressMemoryEntry(content, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const originalTokens = estimateTokens(content);
+    if (originalTokens <= cfg.maxTokens / 4) {
+        return {
+            original: content,
+            compressed: content,
+            originalTokens,
+            compressedTokens: originalTokens,
+            tokenReduction: 0,
+            preservedSemantics: 1.0,
+        };
+    }
+    let compressed = content;
+    // Level 1: Remove redundant whitespace and formatting
+    compressed = compressed.replace(/\s+/g, ' ').trim();
+    compressed = compressed.replace(/\n{3,}/g, '\n\n');
+    // Level 2: Remove common filler phrases
+    if (cfg.compressionLevel !== 'light') {
+        const fillerPatterns = [
+            /\b(basically|essentially|actually|really|very|quite|somewhat|rather)\b/gi,
+            /\b(in order to)\b/gi,
+            /\b(it is worth noting that|it should be noted that)\b/gi,
+            /\b(as a matter of fact|in fact)\b/gi,
+            /\b(at the end of the day)\b/gi,
+            /\b(the fact that)\b/gi,
+            /\b(in this case|in that case)\b/gi,
+        ];
+        for (const pattern of fillerPatterns) {
+            compressed = compressed.replace(pattern, '');
+        }
+    }
+    // Level 3: Aggressive - truncate to key sentences
+    if (cfg.compressionLevel === 'aggressive') {
+        const sentences = compressed.split(/(?<=[.!?])\s+/);
+        const maxSentences = Math.max(3, Math.ceil(sentences.length * 0.4));
+        // Keep first sentence (context), middle sentences (key info), last sentence (conclusion)
+        if (sentences.length > maxSentences) {
+            const first = sentences.slice(0, 1);
+            const middle = sentences.slice(1, -1).slice(0, maxSentences - 2);
+            const last = sentences.slice(-1);
+            compressed = [...first, ...middle, ...last].join(' ');
+        }
+    }
+    // Clean up artifacts
+    compressed = compressed.replace(/\s{2,}/g, ' ').trim();
+    const compressedTokens = estimateTokens(compressed);
+    const tokenReduction = 1 - (compressedTokens / originalTokens);
+    // Estimate semantic preservation (based on compression ratio - rough heuristic)
+    const preservedSemantics = Math.max(0.7, 1 - (tokenReduction * 0.3));
+    return {
+        original: content,
+        compressed,
+        originalTokens,
+        compressedTokens,
+        tokenReduction,
+        preservedSemantics,
+    };
+}
+/**
+ * Compress multiple memories into a consolidated context
+ */
+export function compressMemoryBatch(memories, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    // Sort by importance (descending)
+    const sorted = [...memories].sort((a, b) => (b.importance || 5) - (a.importance || 5));
+    // Group by type for structured output
+    const grouped = {};
+    for (const mem of sorted) {
+        const type = mem.type || 'general';
+        if (!grouped[type])
+            grouped[type] = [];
+        grouped[type].push(mem.content);
+    }
+    // Build consolidated context
+    const sections = [];
+    const typeOrder = ['goal', 'action', 'observation', 'thought'];
+    for (const type of typeOrder) {
+        if (grouped[type] && grouped[type].length > 0) {
+            const compressed = grouped[type].map(c => compressMemoryEntry(c, cfg).compressed);
+            sections.push(`[${type.toUpperCase()}]\n${compressed.join('\n')}`);
+        }
+    }
+    // Add remaining types
+    for (const type of Object.keys(grouped)) {
+        if (!typeOrder.includes(type)) {
+            const compressed = grouped[type].map(c => compressMemoryEntry(c, cfg).compressed);
+            sections.push(`[${type.toUpperCase()}]\n${compressed.join('\n')}`);
+        }
+    }
+    const original = memories.map(m => m.content).join('\n');
+    const compressed = sections.join('\n\n');
+    const originalTokens = estimateTokens(original);
+    const compressedTokens = estimateTokens(compressed);
+    return {
+        original,
+        compressed,
+        originalTokens,
+        compressedTokens,
+        tokenReduction: 1 - (compressedTokens / originalTokens),
+        preservedSemantics: 0.9, // Batch compression preserves structure
+    };
+}
+/**
+ * Summarize old memories into a single compressed entry
+ */
+export function summarizeMemories(memories, maxOutputTokens = 500) {
+    if (memories.length === 0)
+        return '';
+    // Group by type
+    const byType = {};
+    for (const mem of memories) {
+        if (!byType[mem.type])
+            byType[mem.type] = [];
+        byType[mem.type].push(mem.content);
+    }
+    // Create summary sections
+    const summaryParts = [];
+    for (const [type, contents] of Object.entries(byType)) {
+        // Deduplicate similar content
+        const unique = deduplicateContent(contents);
+        // Compress each unique entry
+        const compressed = unique.map(c => {
+            const result = compressMemoryEntry(c, { compressionLevel: 'aggressive' });
+            return result.compressed;
+        });
+        // Limit to most important entries
+        const maxPerType = Math.max(2, Math.floor(maxOutputTokens / (Object.keys(byType).length * 50)));
+        const limited = compressed.slice(0, maxPerType);
+        if (limited.length > 0) {
+            summaryParts.push(`${type}: ${limited.join('; ')}`);
+        }
+    }
+    const dateRange = getDateRange(memories.map(m => m.timestamp));
+    const header = `[Summary ${dateRange}]`;
+    return `${header}\n${summaryParts.join('\n')}`;
+}
+/**
+ * Deduplicate content using simple similarity check
+ */
+function deduplicateContent(contents, threshold = 0.8) {
+    const unique = [];
+    for (const content of contents) {
+        const normalizedNew = content.toLowerCase().replace(/\s+/g, ' ').trim();
+        let isDuplicate = false;
+        for (const existing of unique) {
+            const normalizedExisting = existing.toLowerCase().replace(/\s+/g, ' ').trim();
+            const similarity = jaccardSimilarity(normalizedNew, normalizedExisting);
+            if (similarity > threshold) {
+                isDuplicate = true;
+                break;
+            }
+        }
+        if (!isDuplicate) {
+            unique.push(content);
+        }
+    }
+    return unique;
+}
+// jaccardSimilarity imported from ../utils/string-similarity.js
+/**
+ * Get date range string
+ */
+function getDateRange(timestamps) {
+    if (timestamps.length === 0)
+        return 'unknown';
+    const dates = timestamps.map(t => new Date(t)).filter(d => !isNaN(d.getTime()));
+    if (dates.length === 0)
+        return 'unknown';
+    const min = new Date(Math.min(...dates.map(d => d.getTime())));
+    const max = new Date(Math.max(...dates.map(d => d.getTime())));
+    const formatDate = (d) => d.toISOString().split('T')[0];
+    if (formatDate(min) === formatDate(max)) {
+        return formatDate(min);
+    }
+    return `${formatDate(min)} to ${formatDate(max)}`;
+}
+/**
+ * Smart truncation using head+tail split.
+ * Preserves both initial context (setup, config) and final output (errors, results).
+ * Head gets 60%, tail gets 40% of the allowed line budget.
+ */
+export function smartTruncate(content, maxChars) {
+    if (content.length <= maxChars)
+        return content;
+    const lines = content.split('\n');
+    if (lines.length <= 4) {
+        // Too few lines for head+tail split, just char-truncate
+        return content.slice(0, maxChars) + '\n... [truncated]';
+    }
+    const ratio = Math.min(1, maxChars / content.length);
+    const totalLines = Math.max(2, Math.floor(lines.length * ratio));
+    const headLines = Math.max(1, Math.ceil(totalLines * 0.6));
+    const tailLines = Math.max(1, totalLines - headLines);
+    // Avoid overlap when head + tail >= total lines
+    if (headLines + tailLines >= lines.length) {
+        return content.slice(0, maxChars) + '\n... [truncated]';
+    }
+    const headPart = lines.slice(0, headLines);
+    const tailPart = lines.slice(-tailLines);
+    const omitted = lines.length - headLines - tailLines;
+    return [
+        ...headPart,
+        `\n... [${omitted} lines truncated — showing first ${headLines} + last ${tailLines} lines] ...\n`,
+        ...tailPart,
+    ].join('\n');
+}
+/**
+ * Context budget manager
+ */
+export class ContextBudget {
+    maxTokens;
+    usedTokens = 0;
+    sections = new Map();
+    constructor(maxTokens = 12000) {
+        this.maxTokens = maxTokens;
+    }
+    allocate(section, content) {
+        const tokens = estimateTokens(content);
+        const available = this.maxTokens - this.usedTokens;
+        if (tokens <= available) {
+            this.usedTokens += tokens;
+            this.sections.set(section, tokens);
+            return { content, tokens, truncated: false };
+        }
+        // Need to truncate - use head+tail split to preserve error context
+        const targetTokens = Math.floor(available * 0.9);
+        const targetChars = targetTokens * 4;
+        const truncated = smartTruncate(content, targetChars);
+        const actualTokens = estimateTokens(truncated);
+        this.usedTokens += actualTokens;
+        this.sections.set(section, actualTokens);
+        return { content: truncated, tokens: actualTokens, truncated: true };
+    }
+    remaining() {
+        return this.maxTokens - this.usedTokens;
+    }
+    usage() {
+        return {
+            total: this.maxTokens,
+            used: this.usedTokens,
+            remaining: this.remaining(),
+            sections: Object.fromEntries(this.sections),
+        };
+    }
+    reset() {
+        this.usedTokens = 0;
+        this.sections.clear();
+    }
+}
+//# sourceMappingURL=context-compressor.js.map

package/dist/memory/context-compressor.js.map

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

package/dist/memory/correction-propagator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Correction Propagation Protocol
+ *
+ * When a memory is corrected, updates propagate across all tiers:
+ * daily log, working memory, and session memory. Old claims are marked
+ * [superseded] with date and reason, preserving the audit trail.
+ *
+ * Inspired by Total Recall's correction gate.
+ */
+import Database from 'better-sqlite3';
+export interface CorrectionResult {
+    originalFound: boolean;
+    originalId?: number;
+    originalContent?: string;
+    tiersUpdated: string[];
+    supersededCount: number;
+    correctedEntryId?: number;
+}
+export interface SupersededEntry {
+    id: number;
+    tier: string;
+    originalContent: string;
+    supersededDate: string;
+    supersededBy: string;
+    reason: string;
+}
+/**
+ * Ensure the superseded tracking table exists.
+ */
+export declare function ensureSupersededSchema(db: Database.Database): void;
+/**
+ * Propagate a correction across all memory tiers.
+ *
+ * @param dbPath Path to the SQLite database
+ * @param searchContent Content to find and correct (fuzzy match)
+ * @param correctedContent The corrected version
+ * @param reason Why the correction was made
+ */
+export declare function propagateCorrection(dbPath: string, searchContent: string, correctedContent: string, reason?: string): CorrectionResult;
+/**
+ * Get the superseded history for audit trail.
+ */
+export declare function getSupersededHistory(dbPath: string, limit?: number): SupersededEntry[];
+//# sourceMappingURL=correction-propagator.d.ts.map

package/dist/memory/correction-propagator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correction-propagator.d.ts","sourceRoot":"","sources":["../../src/memory/correction-propagator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAItC,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAalE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EACxB,MAAM,GAAE,MAA0B,GACjC,gBAAgB,CAwGlB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAW,GACjB,eAAe,EAAE,CAgCnB"}