squish-memory 1.1.5 → 1.2.0

package/dist/core/namespaces/index.js

@@ -1,305 +0,0 @@
-/** Namespace Management - Hierarchical folder-like namespaces for memories */
-import { randomUUID } from 'crypto';
-import { eq, and, isNull } from 'drizzle-orm';
-import { getDb } from '../../db/index.js';
-import { getSchema } from '../../db/schema.js';
-import { logger } from '../logger.js';
-/**
- * Create a new namespace
- */
-export async function createNamespace(input) {
-    const db = await getDb();
-    if (!db) {
-        throw new Error('Database unavailable');
-    }
-    const schema = await getSchema();
-    const id = randomUUID();
-    // Check if namespace with same name exists under parent
-    const sqliteDb = db;
-    const existing = await sqliteDb.select()
-        .from(schema.namespaces)
-        .where(and(eq(schema.namespaces.projectId, input.projectId), eq(schema.namespaces.name, input.name), input.parentId
-        ? eq(schema.namespaces.parentId, input.parentId)
-        : isNull(schema.namespaces.parentId)))
-        .limit(1);
-    if (existing.length > 0) {
-        throw new Error(`Namespace "${input.name}" already exists under ${input.parentId || 'root'}`);
-    }
-    // Build namespace path
-    const path = await buildNamespacePath(input.projectId, input.name, input.parentId ?? null);
-    await sqliteDb.insert(schema.namespaces).values({
-        id,
-        projectId: input.projectId,
-        name: input.name,
-        type: input.type,
-        parentId: input.parentId || null,
-        description: input.description || null,
-        createdAt: new Date(),
-        updatedAt: new Date(),
-    });
-    logger.info(`[Namespaces] Created namespace: ${path}`);
-    return {
-        id,
-        projectId: input.projectId,
-        name: input.name,
-        type: input.type,
-        parentId: input.parentId || null,
-        description: input.description || null,
-        path,
-        createdAt: new Date(),
-        updatedAt: new Date(),
-    };
-}
-/**
- * Build full namespace path from parent
- */
-async function buildNamespacePath(projectId, name, parentId) {
-    if (!parentId) {
-        return name;
-    }
-    const db = await getDb();
-    const schema = await getSchema();
-    const sqliteDb = db;
-    const [parent] = await sqliteDb.select()
-        .from(schema.namespaces)
-        .where(eq(schema.namespaces.id, parentId))
-        .limit(1);
-    if (!parent) {
-        return name;
-    }
-    return `${parent.path}/${name}`;
-}
-/**
- * Get a namespace by ID
- */
-export async function getNamespaceById(id) {
-    const db = await getDb();
-    if (!db)
-        return null;
-    const schema = await getSchema();
-    const sqliteDb = db;
-    const [row] = await sqliteDb.select()
-        .from(schema.namespaces)
-        .where(eq(schema.namespaces.id, id))
-        .limit(1);
-    if (!row)
-        return null;
-    return {
-        id: row.id,
-        projectId: row.projectId,
-        name: row.name,
-        type: row.type,
-        parentId: row.parentId,
-        description: row.description,
-        path: row.path,
-        createdAt: new Date(row.createdAt),
-        updatedAt: new Date(row.updatedAt),
-    };
-}
-/**
- * Resolve a namespace path to a namespace ID
- * @example resolveNamespacePath('my-project', ['user', 'preferences']) -> namespaceId
- */
-export async function resolveNamespacePath(projectId, path) {
-    if (path.length === 0)
-        return null;
-    const db = await getDb();
-    if (!db)
-        return null;
-    const schema = await getSchema();
-    const sqliteDb = db;
-    let parentId = null;
-    let targetNamespace = null;
-    // Traverse path segments
-    for (const segment of path) {
-        const [result] = await sqliteDb.select()
-            .from(schema.namespaces)
-            .where(and(eq(schema.namespaces.projectId, projectId), eq(schema.namespaces.name, segment), parentId
-            ? eq(schema.namespaces.parentId, parentId)
-            : isNull(schema.namespaces.parentId)))
-            .limit(1);
-        if (!result)
-            return null;
-        targetNamespace = result;
-        parentId = result.id;
-    }
-    return targetNamespace?.id || null;
-}
-/**
- * Get namespace tree for a project
- */
-export async function getNamespaceTree(projectId) {
-    const db = await getDb();
-    if (!db)
-        return [];
-    const schema = await getSchema();
-    const sqliteDb = db;
-    // Get all namespaces for project
-    const all = await sqliteDb.select()
-        .from(schema.namespaces)
-        .where(eq(schema.namespaces.projectId, projectId))
-        .orderBy(schema.namespaces.name);
-    // Build tree structure
-    const map = new Map();
-    const roots = [];
-    for (const row of all) {
-        const node = {
-            id: row.id,
-            name: row.name,
-            type: row.type,
-            description: row.description,
-            path: row.path,
-            children: [],
-        };
-        map.set(row.id, node);
-        if (!row.parentId) {
-            roots.push(node);
-        }
-        else {
-            const parent = map.get(row.parentId);
-            if (parent) {
-                parent.children.push(node);
-            }
-        }
-    }
-    return roots;
-}
-/**
- * Get or create default namespaces for a project
- */
-export async function getDefaultNamespaces(projectId) {
-    const db = await getDb();
-    if (!db)
-        return [];
-    const schema = await getSchema();
-    const sqliteDb = db;
-    const created = [];
-    const defaults = [
-        { name: 'user', type: 'user', description: 'User-specific memories and preferences' },
-        { name: 'agent', type: 'agent', description: 'Agent-specific knowledge and state' },
-        { name: 'project', type: 'project', description: 'Project-specific decisions and context' },
-    ];
-    const defaultNames = ['user', 'agent', 'project'];
-    // Check all default namespaces at once with IN clause
-    const existing = await sqliteDb.select()
-        .from(schema.namespaces)
-        .where(and(eq(schema.namespaces.projectId, projectId), eq(schema.namespaces.name, defaultNames[0]), eq(schema.namespaces.type, 'user'), isNull(schema.namespaces.parentId)));
-    if (existing.length > 0) {
-        const ns = await createNamespace({
-            projectId,
-            name: defaultNames[0],
-            type: 'user',
-            parentId: null,
-        });
-        created.push({
-            id: ns.id,
-            projectId: ns.projectId,
-            name: ns.name,
-            type: ns.type,
-            parentId: ns.parentId,
-            description: ns.description,
-            path: ns.path,
-            createdAt: new Date(ns.createdAt),
-            updatedAt: new Date(ns.updatedAt),
-        });
-    }
-    // Check remaining defaults sequentially (agent and project)
-    for (const defName of defaultNames.slice(1)) {
-        const existing = await sqliteDb.select()
-            .from(schema.namespaces)
-            .where(and(eq(schema.namespaces.projectId, projectId), eq(schema.namespaces.name, defName), eq(schema.namespaces.type, defName), isNull(schema.namespaces.parentId)))
-            .limit(1);
-        if (existing.length === 0) {
-            const ns = await createNamespace({
-                projectId,
-                name: defName,
-                type: defName === 'agent' ? 'agent' : 'project',
-                parentId: null,
-            });
-            created.push(ns);
-        }
-        else {
-            created.push({
-                id: existing[0].id,
-                projectId: existing[0].projectId,
-                name: existing[0].name,
-                type: existing[0].type,
-                parentId: existing[0].parentId,
-                description: existing[0].description,
-                path: existing[0].path,
-                createdAt: new Date(existing[0].createdAt),
-                updatedAt: new Date(existing[0].updatedAt),
-            });
-        }
-    }
-    logger.info(`[Namespaces] Default namespaces ready for project: ${projectId}`);
-    return created;
-}
-/**
- * List namespaces with optional filtering
- */
-export async function listNamespaces(options = {}) {
-    const db = await getDb();
-    if (!db)
-        return [];
-    const schema = await getSchema();
-    const sqliteDb = db;
-    const conditions = [];
-    if (options.projectId) {
-        conditions.push(eq(schema.namespaces.projectId, options.projectId));
-    }
-    if (options.type) {
-        conditions.push(eq(schema.namespaces.type, options.type));
-    }
-    if (options.parentId !== undefined) {
-        if (options.parentId === null) {
-            conditions.push(isNull(schema.namespaces.parentId));
-        }
-        else {
-            conditions.push(eq(schema.namespaces.parentId, options.parentId));
-        }
-    }
-    const rows = await sqliteDb.select()
-        .from(schema.namespaces)
-        .where(conditions.length > 0 ? and(...conditions) : undefined)
-        .orderBy(schema.namespaces.name);
-    return rows.map((row) => ({
-        id: row.id,
-        projectId: row.projectId,
-        name: row.name,
-        type: row.type,
-        parentId: row.parentId,
-        description: row.description,
-        path: row.path,
-        createdAt: new Date(row.createdAt),
-        updatedAt: new Date(row.updatedAt),
-    }));
-}
-/**
- * Delete a namespace (cascades to child namespaces)
- */
-export async function deleteNamespace(id) {
-    const db = await getDb();
-    if (!db)
-        return;
-    const schema = await getSchema();
-    const sqliteDb = db;
-    await sqliteDb.delete(schema.namespaces).where(eq(schema.namespaces.id, id));
-    logger.info(`[Namespaces] Deleted namespace: ${id}`);
-}
-/**
- * Update namespace
- */
-export async function updateNamespace(id, updates) {
-    const db = await getDb();
-    if (!db)
-        return;
-    const schema = await getSchema();
-    const sqliteDb = db;
-    await sqliteDb.update(schema.namespaces).set({
-        ...updates,
-        updatedAt: new Date(),
-    }).where(eq(schema.namespaces.id, id));
-    logger.info(`[Namespaces] Updated namespace: ${id}`);
-}
-//# sourceMappingURL=index.js.map

package/dist/core/namespaces/uri-parser.d.ts

@@ -1,31 +0,0 @@
-/** URI Parser for Squish namespace scheme (squish://) */
-export interface SquishURIParsed {
-    type: 'namespace';
-    projectId: string;
-    namespacePath: string[];
-    memoryId?: string;
-}
-/**
- * Parse a squish:// URI into components
- * @example parseSquishURI('squish://my-project/user/preferences') -> { type: 'namespace', projectId: 'my-project', namespacePath: ['user', 'preferences'] }
- */
-export declare function parseSquishURI(uri: string): SquishURIParsed | null;
-/**
- * Build a squish:// URI from components
- * @example buildSquishURI('my-project', ['user', 'preferences']) -> 'squish://my-project/user/preferences'
- */
-export declare function buildSquishURI(projectId: string, path: string[], memoryId?: string): string;
-/**
- * Validate a namespace path (no "..", no empty segments)
- */
-export declare function validateNamespacePath(path: string[]): boolean;
-/**
- * Get parent namespace path
- * @example getParentPath(['user', 'preferences', 'coding']) -> ['user', 'preferences']
- */
-export declare function getParentPath(path: string[]): string[] | null;
-/**
- * Join namespace path segments
- */
-export declare function joinNamespacePath(...segments: (string | string[])[]): string[];
-//# sourceMappingURL=uri-parser.d.ts.map

package/dist/core/namespaces/uri-parser.js

@@ -1,74 +0,0 @@
-/** URI Parser for Squish namespace scheme (squish://) */
-/**
- * Parse a squish:// URI into components
- * @example parseSquishURI('squish://my-project/user/preferences') -> { type: 'namespace', projectId: 'my-project', namespacePath: ['user', 'preferences'] }
- */
-export function parseSquishURI(uri) {
-    if (!uri || typeof uri !== 'string') {
-        return null;
-    }
-    // Match squish://project/path/to/memory
-    const match = uri.match(/^squish:\/\/([^\/]+)\/(.*)$/);
-    if (!match) {
-        return null;
-    }
-    const [, projectId, pathPart] = match;
-    const namespacePath = pathPart ? pathPart.split('/').filter(Boolean) : [];
-    // If path ends with a UUID, it's a memory ID
-    const lastSegment = namespacePath[namespacePath.length - 1];
-    let memoryId;
-    if (lastSegment && /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(lastSegment)) {
-        memoryId = lastSegment;
-        namespacePath.pop();
-    }
-    return {
-        type: 'namespace',
-        projectId,
-        namespacePath,
-        memoryId,
-    };
-}
-/**
- * Build a squish:// URI from components
- * @example buildSquishURI('my-project', ['user', 'preferences']) -> 'squish://my-project/user/preferences'
- */
-export function buildSquishURI(projectId, path, memoryId) {
-    if (!projectId) {
-        throw new Error('Project ID is required');
-    }
-    const cleanPath = path.filter(Boolean);
-    const basePath = `squish://${projectId}${cleanPath.length > 0 ? '/' + cleanPath.join('/') : ''}`;
-    return memoryId ? `${basePath}/${memoryId}` : basePath;
-}
-/**
- * Validate a namespace path (no "..", no empty segments)
- */
-export function validateNamespacePath(path) {
-    if (path.length === 0)
-        return true;
-    for (const segment of path) {
-        if (!segment || segment.length === 0) {
-            return false;
-        }
-        if (segment.includes('..')) {
-            return false;
-        }
-    }
-    return true;
-}
-/**
- * Get parent namespace path
- * @example getParentPath(['user', 'preferences', 'coding']) -> ['user', 'preferences']
- */
-export function getParentPath(path) {
-    if (path.length <= 1)
-        return null;
-    return path.slice(0, -1);
-}
-/**
- * Join namespace path segments
- */
-export function joinNamespacePath(...segments) {
-    return segments.flat().filter(Boolean);
-}
-//# sourceMappingURL=uri-parser.js.map

package/dist/core/search/qmd-search.d.ts

@@ -1,61 +0,0 @@
-/**
- * QMD Hybrid Search Integration
- *
- * Integrates QMD's BM25+vector+rerank pipeline with Squish memories.
- * Provides enhanced search capabilities when QMD is available.
- *
- * QMD Search Pipeline:
- * 1. Query Expansion (LLM generates alternative queries)
- * 2. Parallel BM25 (FTS5) + Vector Search
- * 3. RRF Fusion (Reciprocal Rank Fusion)
- * 4. LLM Re-ranking (yes/no with logprobs)
- * 5. Position-Aware Blending
- *
- * Installation: bun install -g qmd
- * GitHub: https://github.com/tobi/qmd
- */
-import type { SearchInput, SearchResult } from '../memory/memories.js';
-export interface QMDSearchOptions extends SearchInput {
-    useHybrid?: boolean;
-    collection?: string;
-    includeSquishResults?: boolean;
-}
-export interface QMDHybridSearchResult extends SearchResult {
-    qmdScore?: number;
-    source: 'squish' | 'qmd' | 'hybrid';
-}
-/**
- * Search memories using QMD's hybrid search
- *
- * @param options - Search options including query, type, limit, etc.
- * @returns QMD-enhanced search results
- */
-export declare function searchWithQMD(options: QMDSearchOptions): Promise<QMDHybridSearchResult[]>;
-/**
- * Fused search: combine Squish and QMD results
- *
- * Runs both searches in parallel and merges results with deduplication.
- *
- * @param options - Search options
- * @returns Fused search results from both sources
- */
-export declare function fusedSearch(options: QMDSearchOptions): Promise<QMDHybridSearchResult[]>;
-/**
- * Check if QMD is available and configured
- *
- * @returns true if QMD is enabled and available
- */
-export declare function isQMDAvailable(): Promise<boolean>;
-/**
- * Get QMD status and collection info
- *
- * @returns QMD status or null if unavailable
- */
-export declare function getQMDStatus(): Promise<{
-    available: boolean;
-    collections: Array<{
-        name: string;
-        documentCount: number;
-    }>;
-} | null>;
-//# sourceMappingURL=qmd-search.d.ts.map

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

@@ -1,178 +0,0 @@
-/**
- * QMD Hybrid Search Integration
- *
- * Integrates QMD's BM25+vector+rerank pipeline with Squish memories.
- * Provides enhanced search capabilities when QMD is available.
- *
- * QMD Search Pipeline:
- * 1. Query Expansion (LLM generates alternative queries)
- * 2. Parallel BM25 (FTS5) + Vector Search
- * 3. RRF Fusion (Reciprocal Rank Fusion)
- * 4. LLM Re-ranking (yes/no with logprobs)
- * 5. Position-Aware Blending
- *
- * Installation: bun install -g qmd
- * GitHub: https://github.com/tobi/qmd
- */
-import { getQMDClient } from '../embeddings/qmd-client.js';
-import { search } from '../memory/memories.js';
-import { logger } from '../logger.js';
-import { config } from '../../config.js';
-/**
- * Search memories using QMD's hybrid search
- *
- * @param options - Search options including query, type, limit, etc.
- * @returns QMD-enhanced search results
- */
-export async function searchWithQMD(options) {
-    const client = await getQMDClient();
-    if (!(await client.isAvailable())) {
-        logger.warn('QMD unavailable, falling back to Squish search');
-        // Fallback to Squish search
-        const squishResults = await search(options);
-        return squishResults.map((r) => ({
-            ...r,
-            source: 'squish'
-        }));
-    }
-    // Determine collection based on memory type mapping
-    const collection = options.collection || getCollectionForType(options.type);
-    try {
-        let qmdResults = [];
-        if (options.useHybrid !== false) {
-            // Use qmd_query (hybrid with reranking) - best quality
-            qmdResults = await client.query({
-                query: options.query,
-                collection,
-                limit: options.limit || 10,
-                minScore: 0.2
-            });
-        }
-        else {
-            // Use qmd_vsearch (semantic only) - faster
-            qmdResults = await client.vsearch({
-                query: options.query,
-                collection,
-                limit: options.limit || 10,
-                minScore: 0.2
-            });
-        }
-        // Map QMD results to Squish format
-        return qmdResults.map((result) => ({
-            id: result.docid || result.path,
-            content: result.snippet || result.title,
-            type: options.type || 'observation',
-            tags: [],
-            projectId: options.project ? options.project : null,
-            similarity: result.score,
-            qmdScore: result.score,
-            source: 'qmd',
-            createdAt: new Date().toISOString() // QMD doesn't provide timestamps
-        }));
-    }
-    catch (error) {
-        logger.error(`QMD search failed: ${error}`);
-        // Fallback to Squish search
-        const squishResults = await search(options);
-        return squishResults.map((r) => ({
-            ...r,
-            source: 'squish'
-        }));
-    }
-}
-/**
- * Fused search: combine Squish and QMD results
- *
- * Runs both searches in parallel and merges results with deduplication.
- *
- * @param options - Search options
- * @returns Fused search results from both sources
- */
-export async function fusedSearch(options) {
-    const client = await getQMDClient();
-    const qmdAvailable = await client.isAvailable();
-    // Run searches in parallel
-    const results = await Promise.allSettled([
-        search(options),
-        qmdAvailable ? searchWithQMD({ ...options, includeSquishResults: false }) : []
-    ]);
-    const squishResults = results[0].status === 'fulfilled'
-        ? results[0].value.map((r) => ({ ...r, source: 'squish' }))
-        : [];
-    const qmdResults = results[1].status === 'fulfilled'
-        ? results[1].value
-        : [];
-    // Deduplicate by content similarity
-    const seenContent = new Set();
-    const merged = [];
-    for (const result of [...squishResults, ...qmdResults]) {
-        // Create a content key for deduplication (first 100 chars)
-        const contentKey = result.content.substring(0, 100);
-        if (!seenContent.has(contentKey)) {
-            seenContent.add(contentKey);
-            merged.push(result);
-        }
-    }
-    // Re-rank by combined score
-    merged.sort((a, b) => {
-        const scoreA = (a.similarity || 0) + (a.qmdScore || 0) / 2;
-        const scoreB = (b.similarity || 0) + (b.qmdScore || 0) / 2;
-        return scoreB - scoreA;
-    });
-    return merged.slice(0, options.limit || 10);
-}
-/**
- * Get QMD collection name for a memory type
- *
- * Uses the configured collection mapping from config.
- *
- * @param type - Memory type (observation, fact, decision, context, preference)
- * @returns QMD collection name
- */
-function getCollectionForType(type) {
-    if (!type) {
-        return 'squish-all';
-    }
-    const mapping = config.qmdCollectionMapping || {};
-    return mapping[type] || `squish-${type}`;
-}
-/**
- * Check if QMD is available and configured
- *
- * @returns true if QMD is enabled and available
- */
-export async function isQMDAvailable() {
-    if (!config.qmdEnabled) {
-        return false;
-    }
-    try {
-        const client = await getQMDClient();
-        return await client.isAvailable();
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Get QMD status and collection info
- *
- * @returns QMD status or null if unavailable
- */
-export async function getQMDStatus() {
-    try {
-        const client = await getQMDClient();
-        const available = await client.isAvailable();
-        if (!available) {
-            return { available: false, collections: [] };
-        }
-        const status = await client.status();
-        return {
-            available: true,
-            collections: status?.collections || []
-        };
-    }
-    catch {
-        return null;
-    }
-}
-//# sourceMappingURL=qmd-search.js.map

package/dist/core/session-hooks/self-iteration-job.d.ts

@@ -1,20 +0,0 @@
-/** Self-Iteration Job - Auto-extract key facts from ended conversations
- *
- * Processes conversations to extract memories and generate summaries
- */
-import { type JobHandler } from '../scheduler/cron-scheduler.js';
-export interface SelfIterationConfig {
-    enabled: boolean;
-    extractFacts: boolean;
-    generateSummaries: boolean;
-    consolidateMemories: boolean;
-    minMessageCount: number;
-    maxMessagesToProcess: number;
-}
-declare const DEFAULT_CONFIG: SelfIterationConfig;
-/**
- * Register self-iteration job handler
- */
-declare const selfIterationHandler: JobHandler;
-export { selfIterationHandler, DEFAULT_CONFIG };
-//# sourceMappingURL=self-iteration-job.d.ts.map