squish-memory 0.7.0

package/dist/core/sync/qmd-sync.js

@@ -0,0 +1,213 @@
+/**
+ * QMD Memory Synchronization
+ *
+ * Syncs Squish memories to QMD collections for hybrid search.
+ * Writes memories as markdown files to QMD collection directories.
+ *
+ * QMD automatically indexes files in collection directories, so we just
+ * need to write files to the right location.
+ *
+ * Collection Structure:
+ * - qmd-collections/squish-observations/ - Observation memories
+ * - qmd-collections/squish-facts/ - Fact memories
+ * - qmd-collections/squish-decisions/ - Decision memories
+ * - qmd-collections/squish-context/ - Context memories
+ * - qmd-collections/squish-preferences/ - Preference memories
+ */
+import { mkdir, writeFile } from 'fs/promises';
+import { join } from 'path';
+import { getQMDClient } from '../embeddings/qmd-client.js';
+import { config } from '../../config.js';
+import { logger } from '../logger.js';
+/**
+ * QMD Memory Sync class
+ *
+ * Manages synchronization of Squish memories to QMD collections.
+ */
+export class QMDMemorySync {
+    collectionsPath;
+    client;
+    initialized = false;
+    constructor() {
+        this.collectionsPath = config.qmdCollectionsPath;
+    }
+    /**
+     * Initialize the sync layer
+     *
+     * Creates collection directories and verifies QMD connection.
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        this.initialized = true;
+        try {
+            // Ensure collections directory exists
+            await mkdir(this.collectionsPath, { recursive: true });
+            // Initialize QMD client (but don't fail if QMD isn't installed)
+            try {
+                this.client = await getQMDClient();
+                const available = await this.client.isAvailable();
+                if (available) {
+                    logger.info('QMD sync initialized with available QMD server');
+                }
+                else {
+                    logger.info('QMD sync initialized (QMD server not available)');
+                }
+            }
+            catch (error) {
+                logger.debug('QMD client unavailable, sync will be deferred');
+            }
+            // Create collection directories for each memory type
+            for (const [memoryType, collectionName] of Object.entries(config.qmdCollectionMapping)) {
+                await this.createCollection(String(collectionName));
+            }
+        }
+        catch (error) {
+            logger.error(`Failed to initialize QMD sync: ${error}`);
+        }
+    }
+    /**
+     * Sync a memory to QMD
+     *
+     * Writes memory as markdown to the appropriate collection directory.
+     * QMD will automatically index the file on its next update cycle.
+     *
+     * @param memory - Memory record to sync
+     */
+    async syncMemory(memory) {
+        // Lazy initialization
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        // Check if QMD is available
+        if (this.client && !(await this.client.isAvailable())) {
+            logger.debug('QMD unavailable, skipping sync');
+            return;
+        }
+        const collection = this.getCollectionForMemory(memory);
+        const filename = this.getFilenameForMemory(memory);
+        const content = this.formatMemoryAsMarkdown(memory);
+        const filepath = join(this.collectionsPath, collection, filename);
+        try {
+            await mkdir(join(this.collectionsPath, collection), { recursive: true });
+            await writeFile(filepath, content, 'utf-8');
+            logger.debug(`Synced memory ${memory.id} to QMD collection ${collection}`);
+        }
+        catch (error) {
+            logger.error(`Failed to sync memory to QMD: ${error}`);
+        }
+    }
+    /**
+     * Batch sync multiple memories
+     *
+     * @param memories - Array of memory records to sync
+     */
+    async syncMemories(memories) {
+        for (const memory of memories) {
+            await this.syncMemory(memory);
+        }
+    }
+    /**
+     * Trigger QMD re-index
+     *
+     * Note: This would typically call `qmd update` or `qmd embed`.
+     * For now, we just log that documents are ready for indexing.
+     */
+    async reindex() {
+        if (!this.client || !(await this.client.isAvailable())) {
+            logger.debug('QMD unavailable, skipping reindex');
+            return;
+        }
+        // In a full implementation, this would spawn a qmd process
+        // to update the index. For now, we rely on QMD's background indexing.
+        logger.info('QMD collections updated, ready for indexing');
+    }
+    /**
+     * Get collection name for a memory
+     *
+     * @param memory - Memory record
+     * @returns QMD collection name
+     */
+    getCollectionForMemory(memory) {
+        const mapping = config.qmdCollectionMapping || {};
+        return mapping[memory.type] || 'squish-default';
+    }
+    /**
+     * Generate filename for memory
+     *
+     * Uses a docid-like format (6-char hash) for consistent naming.
+     *
+     * @param memory - Memory record
+     * @returns Filename for the memory
+     */
+    getFilenameForMemory(memory) {
+        // Create a short hash from the memory ID (like QMD's docid)
+        const hash = Buffer.from(memory.id.replace(/-/g, '')).toString('base64')
+            .replace(/[+/=]/g, '')
+            .substring(0, 6);
+        // Format: type-hash.md
+        return `${memory.type}-${hash}.md`;
+    }
+    /**
+     * Format memory as markdown for QMD indexing
+     *
+     * Uses frontmatter for metadata and standard markdown for content.
+     *
+     * @param memory - Memory record
+     * @returns Markdown formatted string
+     */
+    formatMemoryAsMarkdown(memory) {
+        const frontmatter = [
+            '---',
+            `id: ${memory.id}`,
+            `type: ${memory.type}`,
+            memory.tags && memory.tags.length > 0 ? `tags: ${memory.tags.join(', ')}` : '',
+            memory.createdAt ? `created: ${memory.createdAt}` : '',
+            memory.metadata ? `metadata: ${JSON.stringify(memory.metadata)}` : '',
+            '---',
+            '',
+            `# ${this.capitalize(memory.type)}`,
+            ''
+        ].filter(line => line !== '').join('\n');
+        return frontmatter + memory.content;
+    }
+    /**
+     * Capitalize first letter of a string
+     */
+    capitalize(str) {
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    }
+    /**
+     * Create a QMD collection directory
+     *
+     * @param name - Collection name
+     */
+    async createCollection(name) {
+        const collectionPath = join(this.collectionsPath, name);
+        await mkdir(collectionPath, { recursive: true });
+        logger.debug(`QMD collection prepared: ${name}`);
+    }
+}
+// Singleton instance
+let syncInstance = null;
+/**
+ * Get the singleton QMD memory sync instance
+ *
+ * @returns QMDMemorySync instance
+ */
+export async function getQMDMemorySync() {
+    if (!syncInstance) {
+        syncInstance = new QMDMemorySync();
+        await syncInstance.initialize();
+    }
+    return syncInstance;
+}
+/**
+ * Reset the singleton sync instance
+ * Useful for testing or when configuration changes.
+ */
+export function resetQMDMemorySync() {
+    syncInstance = null;
+}
+//# sourceMappingURL=qmd-sync.js.map

package/dist/core/sync/qmd-sync.js.map

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

package/dist/core/temporal-facts.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Temporal Facts System
+ * Manages versioned facts with validity windows
+ */
+/**
+ * Store a new fact with temporal validity
+ */
+export declare function storeFact(content: string, options?: {
+    validFrom?: Date;
+    validTo?: Date;
+    confidence?: number;
+    tags?: string[];
+    projectId?: string;
+}): Promise<string>;
+/**
+ * Update a fact by creating a new version
+ */
+export declare function updateFact(previousFactId: string, newContent: string, reason: string): Promise<string>;
+/**
+ * Query facts valid at a specific point in time
+ */
+export declare function queryFactsAtTime(timestamp?: Date, options?: {
+    minConfidence?: number;
+    tags?: string[];
+    projectId?: string;
+    limit?: number;
+}): Promise<any[]>;
+/**
+ * Get the complete version history of a fact
+ */
+export declare function getFactHistory(factId: string): Promise<any[]>;
+/**
+ * Apply confidence decay based on temporal distance
+ */
+export declare function applyConfidenceDecay(factId: string, ageDays: number): Promise<void>;
+/**
+ * Invalidate a fact (mark as no longer valid)
+ */
+export declare function invalidateFact(factId: string, reason: string): Promise<void>;
+/**
+ * Check if a fact is currently valid
+ */
+export declare function isFactValid(factId: string, atTime?: Date): Promise<boolean>;
+/**
+ * Get statistics about facts
+ */
+export declare function getFactStats(projectId?: string): Promise<{
+    totalFacts: number;
+    activeFacts: number;
+    expiredFacts: number;
+    avgConfidence: number;
+    avgAge: number;
+}>;
+//# sourceMappingURL=temporal-facts.d.ts.map

package/dist/core/temporal-facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-facts.d.ts","sourceRoot":"","sources":["../../core/temporal-facts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,GAAE,IAAiB,EAC5B,OAAO,GAAE;IACP,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GACL,OAAO,CAAC,GAAG,EAAE,CAAC,CA2BhB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAEnE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BzF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAelF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,IAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAmB7F;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CA8CD"}

package/dist/core/temporal-facts.js

@@ -0,0 +1,193 @@
+/**
+ * Temporal Facts System
+ * Manages versioned facts with validity windows
+ */
+import { and, eq, gte, desc } from 'drizzle-orm';
+import { randomUUID } from 'crypto';
+import { getDb } from '../db/index.js';
+import { getSchema } from '../db/schema.js';
+import { traverseSupersededChain } from './utils/history-traversal.js';
+import { createNewFactVersion } from './utils/version-management.js';
+import { buildFactAtTimeQuery } from './utils/temporal-queries.js';
+import { logger } from './logger.js';
+/**
+ * Store a new fact with temporal validity
+ */
+export async function storeFact(content, options = {}) {
+    try {
+        const db = await getDb();
+        const schema = await getSchema();
+        const factId = randomUUID();
+        await db.insert(schema.memories).values({
+            id: factId,
+            type: 'fact',
+            sector: 'semantic',
+            content,
+            confidence: options.confidence || 100,
+            validFrom: options.validFrom || new Date(),
+            validTo: options.validTo || null,
+            version: 1,
+            tags: options.tags || [],
+            projectId: options.projectId || null,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        });
+        return factId;
+    }
+    catch (error) {
+        logger.error('Error storing fact', error);
+        throw error;
+    }
+}
+/**
+ * Update a fact by creating a new version
+ */
+export async function updateFact(previousFactId, newContent, reason) {
+    return createNewFactVersion(previousFactId, newContent, {}, reason);
+}
+/**
+ * Query facts valid at a specific point in time
+ */
+export async function queryFactsAtTime(timestamp = new Date(), options = {}) {
+    try {
+        const db = await getDb();
+        const schema = await getSchema();
+        const minConfidence = options.minConfidence || 0;
+        const limit = options.limit || 100;
+        const additionalFilters = [gte(schema.memories.confidence, minConfidence)];
+        if (options.projectId) {
+            additionalFilters.push(eq(schema.memories.projectId, options.projectId));
+        }
+        const where = buildFactAtTimeQuery(schema, timestamp, additionalFilters);
+        const results = await db
+            .select()
+            .from(schema.memories)
+            .where(where)
+            .orderBy(desc(schema.memories.confidence))
+            .limit(limit);
+        return results;
+    }
+    catch (error) {
+        logger.error('Error querying facts at time', error);
+        return [];
+    }
+}
+/**
+ * Get the complete version history of a fact
+ */
+export async function getFactHistory(factId) {
+    return traverseSupersededChain(factId);
+}
+/**
+ * Apply confidence decay based on temporal distance
+ */
+export async function applyConfidenceDecay(factId, ageDays) {
+    try {
+        const db = await getDb();
+        const schema = await getSchema();
+        // Confidence decays exponentially: newConfidence = originalConfidence * e^(-lambda * ageDays)
+        // Using lambda = 0.01 for moderate decay
+        const decayFactor = Math.exp(-0.01 * ageDays);
+        const fact = await db
+            .select()
+            .from(schema.memories)
+            .where(eq(schema.memories.id, factId))
+            .limit(1);
+        if (fact.length === 0)
+            return;
+        const newConfidence = Math.max(0, Math.floor(fact[0].confidence * decayFactor));
+        await db
+            .update(schema.memories)
+            .set({ confidence: newConfidence })
+            .where(eq(schema.memories.id, factId));
+    }
+    catch (error) {
+        logger.error('Error applying confidence decay', error);
+    }
+}
+/**
+ * Invalidate a fact (mark as no longer valid)
+ */
+export async function invalidateFact(factId, reason) {
+    try {
+        const db = await getDb();
+        const schema = await getSchema();
+        await db
+            .update(schema.memories)
+            .set({
+            validTo: new Date(),
+            metadata: { invalidationReason: reason, invalidatedAt: new Date().toISOString() },
+        })
+            .where(eq(schema.memories.id, factId));
+    }
+    catch (error) {
+        logger.error('Error invalidating fact', error);
+    }
+}
+/**
+ * Check if a fact is currently valid
+ */
+export async function isFactValid(factId, atTime = new Date()) {
+    try {
+        const db = await getDb();
+        const schema = await getSchema();
+        const additionalFilters = [eq(schema.memories.id, factId)];
+        const where = buildFactAtTimeQuery(schema, atTime, additionalFilters);
+        const fact = await db
+            .select()
+            .from(schema.memories)
+            .where(where)
+            .limit(1);
+        return fact.length > 0;
+    }
+    catch (error) {
+        logger.error('Error checking fact validity', error);
+        return false;
+    }
+}
+/**
+ * Get statistics about facts
+ */
+export async function getFactStats(projectId) {
+    try {
+        const db = await getDb();
+        const schema = await getSchema();
+        const now = new Date();
+        const where = projectId
+            ? and(eq(schema.memories.type, 'fact'), eq(schema.memories.projectId, projectId))
+            : eq(schema.memories.type, 'fact');
+        const facts = await db.select().from(schema.memories).where(where);
+        let active = 0;
+        let expired = 0;
+        let totalConfidence = 0;
+        let totalAge = 0;
+        for (const fact of facts) {
+            totalConfidence += fact.confidence || 0;
+            if (fact.validTo && new Date(fact.validTo) < now) {
+                expired++;
+            }
+            else if (!fact.validTo || new Date(fact.validTo) >= now) {
+                active++;
+            }
+            totalAge += (now.getTime() - new Date(fact.createdAt).getTime()) / (1000 * 60 * 60 * 24);
+        }
+        return {
+            totalFacts: facts.length,
+            activeFacts: active,
+            expiredFacts: expired,
+            avgConfidence: facts.length > 0 ? totalConfidence / facts.length : 0,
+            avgAge: facts.length > 0 ? totalAge / facts.length : 0,
+        };
+    }
+    catch (error) {
+        logger.error('Error getting fact stats', error);
+        return {
+            totalFacts: 0,
+            activeFacts: 0,
+            expiredFacts: 0,
+            avgConfidence: 0,
+            avgAge: 0,
+        };
+    }
+}
+//# sourceMappingURL=temporal-facts.js.map

package/dist/core/temporal-facts.js.map

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

package/dist/core/utils/cleanup-operations.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared Cleanup Operations Utilities
+ * Common patterns for age-based cleanup operations
+ */
+/**
+ * Cleanup old session summaries
+ */
+export declare function cleanupOldSessionSummaries(olderThanDays?: number): Promise<number>;
+/**
+ * Cleanup old memory snapshots
+ */
+export declare function cleanupOldMemorySnapshots(olderThanDays?: number): Promise<number>;
+//# sourceMappingURL=cleanup-operations.d.ts.map

package/dist/core/utils/cleanup-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-operations.d.ts","sourceRoot":"","sources":["../../../core/utils/cleanup-operations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB5F;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB3F"}

package/dist/core/utils/cleanup-operations.js

@@ -0,0 +1,44 @@
+/**
+ * Shared Cleanup Operations Utilities
+ * Common patterns for age-based cleanup operations
+ */
+import { getDb } from '../../db/index.js';
+import { getSchema } from '../../db/schema.js';
+import { logger } from '../logger.js';
+/**
+ * Cleanup old session summaries
+ */
+export async function cleanupOldSessionSummaries(olderThanDays = 30) {
+    try {
+        const db = await getDb();
+        const schema = await getSchema();
+        const threshold = new Date(Date.now() - olderThanDays * 24 * 60 * 60 * 1000);
+        const result = await db
+            .delete(schema.sessionSummaries)
+            .where(schema.sessionSummaries.createdAt < threshold);
+        return result?.rowCount || 0;
+    }
+    catch (error) {
+        logger.error('Error pruning old summaries', error);
+        return 0;
+    }
+}
+/**
+ * Cleanup old memory snapshots
+ */
+export async function cleanupOldMemorySnapshots(olderThanDays = 90) {
+    try {
+        const db = await getDb();
+        const schema = await getSchema();
+        const threshold = new Date(Date.now() - olderThanDays * 24 * 60 * 60 * 1000);
+        const result = await db
+            .delete(schema.memorySnapshots)
+            .where(schema.memorySnapshots.createdAt < threshold);
+        return result?.rowCount || 0;
+    }
+    catch (error) {
+        logger.error('Error deleting old snapshots', error);
+        return 0;
+    }
+}
+//# sourceMappingURL=cleanup-operations.js.map

package/dist/core/utils/cleanup-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-operations.js","sourceRoot":"","sources":["../../../core/utils/cleanup-operations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,gBAAwB,EAAE;IACzE,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QAEjC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAE7E,MAAM,MAAM,GAAG,MAAO,EAAU;aAC7B,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;aAC/B,KAAK,CAAE,MAAM,CAAC,gBAAgB,CAAC,SAAiB,GAAG,SAAS,CAAC,CAAC;QAEjE,OAAO,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACnD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,gBAAwB,EAAE;IACxE,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QAEjC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAE7E,MAAM,MAAM,GAAG,MAAO,EAAU;aAC7B,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC;aAC9B,KAAK,CAAE,MAAM,CAAC,eAAe,CAAC,SAAiB,GAAG,SAAS,CAAC,CAAC;QAEhE,OAAO,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/core/utils/content-extraction.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared Content Extraction Utilities
+ * Common patterns for extracting information from messages
+ */
+/**
+ * Extract key information from conversation messages
+ */
+export declare function extractMessageContent(messages: any[]): {
+    userMessages: any[];
+    assistantMessages: any[];
+    toolCalls: Set<string>;
+    topics: Set<string>;
+    timestamp: string;
+};
+/**
+ * Generate basic extractive summary from extracted content
+ */
+export declare function generateExtractiveSummary(extracted: ReturnType<typeof extractMessageContent>): string;
+//# sourceMappingURL=content-extraction.d.ts.map

package/dist/core/utils/content-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-extraction.d.ts","sourceRoot":"","sources":["../../../core/utils/content-extraction.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG;IACtD,YAAY,EAAE,GAAG,EAAE,CAAC;IACpB,iBAAiB,EAAE,GAAG,EAAE,CAAC;IACzB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAwCA;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,GAAG,MAAM,CAsBrG"}

package/dist/core/utils/content-extraction.js

@@ -0,0 +1,65 @@
+/**
+ * Shared Content Extraction Utilities
+ * Common patterns for extracting information from messages
+ */
+/**
+ * Extract key information from conversation messages
+ */
+export function extractMessageContent(messages) {
+    // Extract key information from messages
+    const userMessages = messages.filter((m) => m.role === 'user');
+    const assistantMessages = messages.filter((m) => m.role === 'assistant');
+    // Extract tool calls
+    const toolCalls = new Set();
+    for (const msg of messages) {
+        if (msg.toolCalls && Array.isArray(msg.toolCalls)) {
+            for (const tc of msg.toolCalls) {
+                toolCalls.add(tc.name);
+            }
+        }
+    }
+    // Extract topics from first and last user messages
+    const topics = new Set();
+    if (userMessages.length > 0) {
+        const firstUser = userMessages[0].content || '';
+        const lastUser = userMessages[userMessages.length - 1].content || '';
+        // Simple topic extraction (first 10 words)
+        const extractTopics = (text) => {
+            const words = text.split(/\s+/).slice(0, 10);
+            return words.join(' ');
+        };
+        if (firstUser)
+            topics.add(extractTopics(firstUser));
+        if (lastUser && lastUser !== firstUser)
+            topics.add(extractTopics(lastUser));
+    }
+    const timestamp = messages.length > 0 ? messages[messages.length - 1].createdAt : 'unknown';
+    return {
+        userMessages,
+        assistantMessages,
+        toolCalls,
+        topics,
+        timestamp,
+    };
+}
+/**
+ * Generate basic extractive summary from extracted content
+ */
+export function generateExtractiveSummary(extracted) {
+    const parts = [];
+    if (extracted.userMessages.length > 0) {
+        parts.push(`User prompts: ${extracted.userMessages.length}`);
+    }
+    if (extracted.assistantMessages.length > 0) {
+        parts.push(`Assistant responses: ${extracted.assistantMessages.length}`);
+    }
+    if (extracted.toolCalls.size > 0) {
+        parts.push(`Tools used: ${Array.from(extracted.toolCalls).join(', ')}`);
+    }
+    if (extracted.topics.size > 0) {
+        parts.push(`Topics: ${Array.from(extracted.topics).join('; ')}`);
+    }
+    parts.push(`Last activity: ${extracted.timestamp}`);
+    return parts.join('. ');
+}
+//# sourceMappingURL=content-extraction.js.map

package/dist/core/utils/content-extraction.js.map

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

package/dist/core/utils/filter-builder.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared Requirements Filter Builder
+ * Common patterns for building database filters from criteria objects
+ */
+/**
+ * Build database filter array from MemoryCriteria
+ */
+export declare function buildMemoryFilters(criteria: any, schema: any): any[];
+/**
+ * Build database filter array from partial criteria (for assertions)
+ */
+export declare function buildMemoryFiltersPartial(criteria: any, schema: any): any[];
+//# sourceMappingURL=filter-builder.d.ts.map

package/dist/core/utils/filter-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-builder.d.ts","sourceRoot":"","sources":["../../../core/utils/filter-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,EAAE,CAgCpE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,EAAE,CAQ3E"}