@londer/cortex 0.1.0

package/dist/orchestration/ranker.js

@@ -0,0 +1,124 @@
+import { inferScopeTier } from './scope.js';
+const GRAPH_CONNECTION_BONUS = 0.15;
+const RECENCY_BONUS_MAX = 0.1;
+const RECENCY_WINDOW_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+/**
+ * Merge results from semantic search, graph traversal, and recent memories.
+ * Deduplicates by memory ID, applies scope boosting, and truncates to token budget.
+ */
+export function mergeAndRank(semanticResults, graphMemories, recentMemories, currentProject, relatedProjects, maxTokens = 2000) {
+    const seen = new Map();
+    // Process semantic results
+    for (const mem of semanticResults) {
+        const boost = inferScopeTier(mem.project, currentProject, relatedProjects);
+        const entry = {
+            id: mem.id,
+            content: mem.content,
+            type: mem.type,
+            score: mem.score * boost.weight,
+            sourceType: 'semantic',
+            project: mem.project,
+            tags: mem.tags,
+            entities: mem.entities,
+            created_at: mem.created_at,
+        };
+        updateBest(seen, entry);
+    }
+    // Process graph-related memories
+    for (const mem of graphMemories) {
+        const existing = seen.get(mem.id);
+        if (existing) {
+            // Boost existing entry with graph bonus
+            existing.score += GRAPH_CONNECTION_BONUS;
+            if (existing.sourceType === 'semantic') {
+                // Keep as semantic but note the graph boost was applied
+            }
+        }
+        else {
+            // We don't have full metadata from graph results, use defaults
+            const entry = {
+                id: mem.id,
+                content: mem.content,
+                type: 'fact', // Default; caller should enrich from SQLite
+                score: mem.score + GRAPH_CONNECTION_BONUS,
+                sourceType: 'graph',
+                project: null,
+                tags: [],
+                entities: [],
+                created_at: new Date().toISOString(),
+            };
+            updateBest(seen, entry);
+        }
+    }
+    // Process recent memories
+    const now = Date.now();
+    for (const mem of recentMemories) {
+        const age = now - new Date(mem.created_at).getTime();
+        const recencyBoost = age < RECENCY_WINDOW_MS
+            ? RECENCY_BONUS_MAX * (1 - age / RECENCY_WINDOW_MS)
+            : 0;
+        const boost = inferScopeTier(mem.project, currentProject, relatedProjects);
+        const existing = seen.get(mem.id);
+        if (existing) {
+            existing.score += recencyBoost;
+        }
+        else {
+            const entry = {
+                id: mem.id,
+                content: mem.content,
+                type: mem.type,
+                score: 0.3 * boost.weight + recencyBoost, // Base score for recent-only results
+                sourceType: 'recent',
+                project: mem.project,
+                tags: mem.tags,
+                entities: mem.entities,
+                created_at: mem.created_at,
+            };
+            updateBest(seen, entry);
+        }
+    }
+    // Content-based dedup: merge entries with same content but different IDs
+    const byContent = new Map();
+    for (const entry of seen.values()) {
+        const existing = byContent.get(entry.content);
+        if (!existing || entry.score > existing.score) {
+            byContent.set(entry.content, entry);
+        }
+    }
+    // Sort by score descending
+    const ranked = Array.from(byContent.values()).sort((a, b) => b.score - a.score);
+    // Truncate to token budget (rough estimate: 1 token ≈ 4 chars)
+    const charBudget = maxTokens * 4;
+    let totalChars = 0;
+    let cutoffIndex = ranked.length;
+    let truncated = false;
+    for (let i = 0; i < ranked.length; i++) {
+        totalChars += ranked[i].content.length;
+        if (totalChars > charBudget) {
+            cutoffIndex = i + 1; // Include the one that pushed us over
+            truncated = true;
+            break;
+        }
+    }
+    return { ranked: ranked.slice(0, cutoffIndex), truncated };
+}
+function updateBest(map, entry) {
+    const existing = map.get(entry.id);
+    if (!existing || entry.score > existing.score) {
+        map.set(entry.id, entry);
+    }
+}
+/**
+ * Format ranked results into a coherent context block.
+ */
+export function formatContext(ranked) {
+    if (ranked.length === 0)
+        return '';
+    return ranked
+        .map((r, i) => {
+        const meta = [r.type, r.project ?? 'global'].filter(Boolean).join(' | ');
+        return `[${i + 1}] (${meta}, score: ${r.score.toFixed(3)})\n${r.content}`;
+    })
+        .join('\n\n');
+}
+//# sourceMappingURL=ranker.js.map

package/dist/orchestration/ranker.js.map

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

package/dist/orchestration/scope.d.ts

@@ -0,0 +1,15 @@
+import type { ScopeBoost } from '../types/index.js';
+/**
+ * Infer scope tier and boost weight for a memory relative to the current context.
+ *
+ * - If the memory's project matches the current project → PROJECT_LOCAL
+ * - If a relationship exists between projects → RELATED_PROJECT (caller must supply related projects)
+ * - Otherwise → GLOBAL
+ */
+export declare function inferScopeTier(memoryProject: string | null, currentProject: string | null, relatedProjects?: string[]): ScopeBoost;
+/**
+ * Infer the effective project from explicit input or context.
+ * Returns null for global scope.
+ */
+export declare function resolveProject(explicitProject?: string, contextProject?: string): string | null;
+//# sourceMappingURL=scope.d.ts.map

package/dist/orchestration/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/orchestration/scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,UAAU,CAeZ;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,eAAe,CAAC,EAAE,MAAM,EACxB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,IAAI,CAEf"}

package/dist/orchestration/scope.js

@@ -0,0 +1,28 @@
+import { SCOPE_BOOST } from '../config.js';
+/**
+ * Infer scope tier and boost weight for a memory relative to the current context.
+ *
+ * - If the memory's project matches the current project → PROJECT_LOCAL
+ * - If a relationship exists between projects → RELATED_PROJECT (caller must supply related projects)
+ * - Otherwise → GLOBAL
+ */
+export function inferScopeTier(memoryProject, currentProject, relatedProjects) {
+    if (currentProject && memoryProject === currentProject) {
+        return { tier: 'project_local', weight: SCOPE_BOOST.PROJECT_LOCAL };
+    }
+    if (currentProject &&
+        memoryProject &&
+        relatedProjects &&
+        relatedProjects.includes(memoryProject)) {
+        return { tier: 'related_project', weight: SCOPE_BOOST.RELATED_PROJECT };
+    }
+    return { tier: 'global', weight: SCOPE_BOOST.GLOBAL };
+}
+/**
+ * Infer the effective project from explicit input or context.
+ * Returns null for global scope.
+ */
+export function resolveProject(explicitProject, contextProject) {
+    return explicitProject ?? contextProject ?? null;
+}
+//# sourceMappingURL=scope.js.map

package/dist/orchestration/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/orchestration/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,aAA4B,EAC5B,cAA6B,EAC7B,eAA0B;IAE1B,IAAI,cAAc,IAAI,aAAa,KAAK,cAAc,EAAE,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,aAAa,EAAE,CAAC;IACtE,CAAC;IAED,IACE,cAAc;QACd,aAAa;QACb,eAAe;QACf,eAAe,CAAC,QAAQ,CAAC,aAAa,CAAC,EACvC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,CAAC,eAAe,EAAE,CAAC;IAC1E,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,eAAwB,EACxB,cAAuB;IAEvB,OAAO,eAAe,IAAI,cAAc,IAAI,IAAI,CAAC;AACnD,CAAC"}

package/dist/storage/neo4j.d.ts

@@ -0,0 +1,19 @@
+import type { GraphResult } from '../types/index.js';
+import { type CortexConfig } from '../config.js';
+export declare class Neo4jStore {
+    private driver;
+    constructor(config?: CortexConfig);
+    init(): Promise<void>;
+    createEntity(name: string, project?: string): Promise<void>;
+    createRelation(from: string, relation: string, to: string, project?: string, properties?: Record<string, string>): Promise<void>;
+    linkMemoryToEntities(memoryId: string, entityNames: string[]): Promise<void>;
+    traverse(entity: string, depth?: number, relationTypes?: string[], project?: string): Promise<GraphResult>;
+    private extractConnections;
+    findMemoriesByEntity(entityName: string): Promise<string[]>;
+    findEntitiesForMemory(memoryId: string): Promise<string[]>;
+    unlinkMemory(memoryId: string): Promise<void>;
+    deleteEntitiesByProject(projects: string[]): Promise<void>;
+    healthCheck(): Promise<boolean>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=neo4j.d.ts.map

package/dist/storage/neo4j.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j.d.ts","sourceRoot":"","sources":["../../src/storage/neo4j.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,YAAY;IAQ3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBrB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3D,cAAc,CAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC;IA4BV,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5E,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAU,EACjB,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC;IA2EvB,OAAO,CAAC,kBAAkB;IAuDpB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAa3D,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAa1D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB7C,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1D,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAY/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/storage/neo4j.js

@@ -0,0 +1,246 @@
+import neo4j from 'neo4j-driver';
+import { loadConfig } from '../config.js';
+export class Neo4jStore {
+    driver;
+    constructor(config) {
+        const cfg = config ?? loadConfig();
+        this.driver = neo4j.driver(cfg.neo4jUri, neo4j.auth.basic(cfg.neo4jUser, cfg.neo4jPassword));
+    }
+    async init() {
+        const session = this.driver.session();
+        try {
+            await session.run('CREATE INDEX entity_name IF NOT EXISTS FOR (e:Entity) ON (e.name)');
+            await session.run('CREATE INDEX entity_project IF NOT EXISTS FOR (e:Entity) ON (e.project)');
+            await session.run('CREATE INDEX memory_id IF NOT EXISTS FOR (m:Memory) ON (m.id)');
+            console.error('[cortex] Neo4j indexes ensured.');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`[cortex] Neo4j init error: ${message}`);
+            throw new Error(`Failed to initialise Neo4j: ${message}`);
+        }
+        finally {
+            await session.close();
+        }
+    }
+    async createEntity(name, project) {
+        const session = this.driver.session();
+        try {
+            await session.run(`MERGE (e:Entity {name: $name})
+         ON CREATE SET e.project = $project, e.created_at = datetime()`, { name, project: project ?? null });
+        }
+        finally {
+            await session.close();
+        }
+    }
+    async createRelation(from, relation, to, project, properties) {
+        const session = this.driver.session();
+        try {
+            // Validate relation type to prevent injection through dynamic relationship type
+            const validRelations = ['DEPENDS_ON', 'USES', 'PART_OF', 'RELATED_TO', 'IMPLEMENTS', 'CALLS'];
+            const safeRelation = validRelations.includes(relation.toUpperCase())
+                ? relation.toUpperCase()
+                : 'RELATED_TO';
+            await session.run(`MERGE (a:Entity {name: $from})
+         ON CREATE SET a.project = $project, a.created_at = datetime()
+         MERGE (b:Entity {name: $to})
+         ON CREATE SET b.project = $project, b.created_at = datetime()
+         MERGE (a)-[r:${safeRelation}]->(b)
+         SET r.project = $project, r.created_at = datetime(), r.properties = $properties`, {
+                from,
+                to,
+                project: project ?? null,
+                properties: properties ? JSON.stringify(properties) : null,
+            });
+        }
+        finally {
+            await session.close();
+        }
+    }
+    async linkMemoryToEntities(memoryId, entityNames) {
+        if (entityNames.length === 0)
+            return;
+        const session = this.driver.session();
+        try {
+            await session.run(`MERGE (m:Memory {id: $memoryId})
+         WITH m
+         UNWIND $entities AS entityName
+         MERGE (e:Entity {name: entityName})
+         MERGE (m)-[:MENTIONS]->(e)`, { memoryId, entities: entityNames });
+        }
+        finally {
+            await session.close();
+        }
+    }
+    async traverse(entity, depth = 2, relationTypes, project) {
+        const safeDepth = Math.min(Math.max(depth, 1), 4);
+        const session = this.driver.session();
+        try {
+            let relFilter = '';
+            if (relationTypes && relationTypes.length > 0) {
+                const validRelations = ['DEPENDS_ON', 'USES', 'PART_OF', 'RELATED_TO', 'IMPLEMENTS', 'CALLS'];
+                const safe = relationTypes
+                    .map(r => r.toUpperCase())
+                    .filter(r => validRelations.includes(r));
+                if (safe.length > 0) {
+                    relFilter = ':' + safe.join('|');
+                }
+            }
+            const query = `
+        MATCH (start:Entity {name: $entity})
+        CALL apoc.path.subgraphAll(start, {
+          maxLevel: $depth,
+          relationshipFilter: $relFilterStr
+        }) YIELD nodes, relationships
+        UNWIND relationships AS rel
+        WITH start, rel, startNode(rel) AS sn, endNode(rel) AS en
+        RETURN
+          sn.name AS fromEntity,
+          type(rel) AS relation,
+          en.name AS toEntity,
+          rel.properties AS properties,
+          CASE WHEN sn = start THEN 1
+               ELSE length(shortestPath((start)-[*]-(sn))) + 1
+          END AS depth
+      `;
+            // Fallback: use simple variable-length path if APOC is not available
+            const fallbackQuery = `
+        MATCH path = (start:Entity {name: $entity})-[${relFilter}*1..${safeDepth}]-(connected:Entity)
+        ${project ? 'WHERE all(rel in relationships(path) WHERE rel.project IS NULL OR rel.project = $project)' : ''}
+        WITH path, connected, length(path) AS d
+        UNWIND range(0, size(relationships(path)) - 1) AS idx
+        WITH relationships(path)[idx] AS rel,
+             nodes(path)[idx] AS sn,
+             nodes(path)[idx + 1] AS en,
+             idx + 1 AS d
+        RETURN DISTINCT
+          sn.name AS fromEntity,
+          type(rel) AS relation,
+          en.name AS toEntity,
+          rel.properties AS properties,
+          d AS depth
+        ORDER BY depth
+      `;
+            let connections = [];
+            try {
+                const result = await session.run(query, {
+                    entity,
+                    depth: neo4j.int(safeDepth),
+                    relFilterStr: relFilter ? relFilter.slice(1) : '', // Remove leading ':'
+                });
+                connections = this.extractConnections(result, entity);
+            }
+            catch {
+                // APOC not available, fall back to variable-length paths
+                const result = await session.run(fallbackQuery, {
+                    entity,
+                    project: project ?? null,
+                });
+                connections = this.extractConnections(result, entity);
+            }
+            return { entity, connections };
+        }
+        finally {
+            await session.close();
+        }
+    }
+    extractConnections(result, rootEntity) {
+        const seen = new Set();
+        const connections = [];
+        for (const record of result.records) {
+            const fromEntity = record.get('fromEntity');
+            const toEntity = record.get('toEntity');
+            const relation = record.get('relation');
+            const rawProps = record.get('properties');
+            const depth = neo4j.isInt(record.get('depth'))
+                ? record.get('depth').toNumber()
+                : record.get('depth');
+            // Determine direction relative to root and which entity to report
+            const direction = fromEntity === rootEntity ? 'outgoing'
+                : toEntity === rootEntity ? 'incoming'
+                    : 'outgoing';
+            // Report the entity that is NOT the root; for edges between two
+            // non-root entities, report toEntity (the further endpoint)
+            const connectedEntity = toEntity === rootEntity ? fromEntity : toEntity;
+            // Deduplicate by connected entity name
+            const key = `${connectedEntity}:${relation}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            let properties;
+            if (typeof rawProps === 'string') {
+                try {
+                    const parsed = JSON.parse(rawProps);
+                    if (parsed && typeof parsed === 'object' && Object.keys(parsed).length > 0) {
+                        properties = Object.fromEntries(Object.entries(parsed).map(([k, v]) => [k, String(v)]));
+                    }
+                }
+                catch { /* not valid JSON, ignore */ }
+            }
+            connections.push({
+                entity: connectedEntity,
+                relation,
+                direction,
+                depth,
+                ...(properties && Object.keys(properties).length > 0 ? { properties } : {}),
+            });
+        }
+        return connections;
+    }
+    async findMemoriesByEntity(entityName) {
+        const session = this.driver.session();
+        try {
+            const result = await session.run('MATCH (m:Memory)-[:MENTIONS]->(e:Entity {name: $name}) RETURN m.id AS id', { name: entityName });
+            return result.records.map(r => r.get('id'));
+        }
+        finally {
+            await session.close();
+        }
+    }
+    async findEntitiesForMemory(memoryId) {
+        const session = this.driver.session();
+        try {
+            const result = await session.run('MATCH (m:Memory {id: $memoryId})-[:MENTIONS]->(e:Entity) RETURN e.name AS name', { memoryId });
+            return result.records.map(r => r.get('name'));
+        }
+        finally {
+            await session.close();
+        }
+    }
+    async unlinkMemory(memoryId) {
+        const session = this.driver.session();
+        try {
+            await session.run('MATCH (m:Memory {id: $memoryId})-[r:MENTIONS]->() DELETE r', { memoryId });
+            await session.run('MATCH (m:Memory {id: $memoryId}) DELETE m', { memoryId });
+        }
+        finally {
+            await session.close();
+        }
+    }
+    async deleteEntitiesByProject(projects) {
+        const session = this.driver.session();
+        try {
+            await session.run('MATCH (e:Entity) WHERE e.project IN $projects DETACH DELETE e', { projects });
+        }
+        finally {
+            await session.close();
+        }
+    }
+    async healthCheck() {
+        const session = this.driver.session();
+        try {
+            await session.run('RETURN 1');
+            return true;
+        }
+        catch {
+            return false;
+        }
+        finally {
+            await session.close();
+        }
+    }
+    async close() {
+        await this.driver.close();
+    }
+}
+//# sourceMappingURL=neo4j.js.map

package/dist/storage/neo4j.js.map

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

package/dist/storage/qdrant.d.ts

@@ -0,0 +1,21 @@
+import type { MemoryPayload, ScoredMemory } from '../types/index.js';
+import { type CortexConfig } from '../config.js';
+export interface QdrantFilter {
+    project?: string;
+    type?: string;
+    tags?: string[];
+}
+export declare class QdrantStore {
+    private client;
+    private collectionName;
+    private vectorDimensions;
+    constructor(config?: CortexConfig);
+    init(): Promise<void>;
+    private ensurePayloadIndex;
+    upsert(id: string, vector: number[], payload: MemoryPayload): Promise<void>;
+    search(vector: number[], filter?: QdrantFilter, limit?: number): Promise<ScoredMemory[]>;
+    delete(id: string): Promise<void>;
+    healthCheck(): Promise<boolean>;
+    private buildFilter;
+}
+//# sourceMappingURL=qdrant.d.ts.map

package/dist/storage/qdrant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant.d.ts","sourceRoot":"","sources":["../../src/storage/qdrant.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAc,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,CAAC,EAAE,YAAY;IAO3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YA2Bb,kBAAkB;IAW1B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyB5F,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC,OAAO,CAAC,WAAW;CA+BpB"}

package/dist/storage/qdrant.js

@@ -0,0 +1,125 @@
+import { QdrantClient } from '@qdrant/js-client-rest';
+import { loadConfig } from '../config.js';
+export class QdrantStore {
+    client;
+    collectionName;
+    vectorDimensions;
+    constructor(config) {
+        const cfg = config ?? loadConfig();
+        this.client = new QdrantClient({ url: cfg.qdrantUrl });
+        this.collectionName = cfg.collectionName;
+        this.vectorDimensions = cfg.vectorDimensions;
+    }
+    async init() {
+        try {
+            const collections = await this.client.getCollections();
+            const exists = collections.collections.some(c => c.name === this.collectionName);
+            if (!exists) {
+                await this.client.createCollection(this.collectionName, {
+                    vectors: {
+                        size: this.vectorDimensions,
+                        distance: 'Cosine',
+                    },
+                });
+                console.error(`[cortex] Created Qdrant collection: ${this.collectionName}`);
+            }
+            // Create payload indexes
+            await this.ensurePayloadIndex('project', 'keyword');
+            await this.ensurePayloadIndex('type', 'keyword');
+            await this.ensurePayloadIndex('tags', 'keyword');
+            await this.ensurePayloadIndex('created_at', 'integer');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`[cortex] Qdrant init error: ${message}`);
+            throw new Error(`Failed to initialise Qdrant: ${message}`);
+        }
+    }
+    async ensurePayloadIndex(field, type) {
+        try {
+            await this.client.createPayloadIndex(this.collectionName, {
+                field_name: field,
+                field_schema: type,
+            });
+        }
+        catch {
+            // Index may already exist — that's fine
+        }
+    }
+    async upsert(id, vector, payload) {
+        await this.client.upsert(this.collectionName, {
+            points: [
+                {
+                    id,
+                    vector,
+                    payload: payload,
+                },
+            ],
+        });
+    }
+    async search(vector, filter, limit = 10) {
+        const qdrantFilter = this.buildFilter(filter);
+        const results = await this.client.search(this.collectionName, {
+            vector,
+            limit,
+            with_payload: true,
+            ...(qdrantFilter ? { filter: qdrantFilter } : {}),
+        });
+        return results.map(result => {
+            const payload = result.payload;
+            return {
+                id: payload.id,
+                content: '', // Content comes from SQLite — we only store metadata in Qdrant
+                type: payload.type,
+                score: result.score,
+                project: payload.project ?? null,
+                tags: payload.tags ?? [],
+                entities: payload.entities ?? [],
+                created_at: new Date(payload.created_at * 1000).toISOString(),
+            };
+        });
+    }
+    async delete(id) {
+        await this.client.delete(this.collectionName, {
+            points: [id],
+        });
+    }
+    async healthCheck() {
+        try {
+            await this.client.getCollections();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    buildFilter(filter) {
+        if (!filter)
+            return undefined;
+        const must = [];
+        if (filter.project) {
+            must.push({
+                key: 'project',
+                match: { value: filter.project },
+            });
+        }
+        if (filter.type) {
+            must.push({
+                key: 'type',
+                match: { value: filter.type },
+            });
+        }
+        if (filter.tags && filter.tags.length > 0) {
+            for (const tag of filter.tags) {
+                must.push({
+                    key: 'tags',
+                    match: { value: tag },
+                });
+            }
+        }
+        if (must.length === 0)
+            return undefined;
+        return { must };
+    }
+}
+//# sourceMappingURL=qdrant.js.map

package/dist/storage/qdrant.js.map

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

package/dist/storage/sqlite.d.ts

@@ -0,0 +1,23 @@
+import type { Memory, ConsolidationLogEntry } from '../types/index.js';
+export declare class SQLiteStore {
+    private db;
+    constructor(dbPath?: string);
+    init(): void;
+    private migratePhase2;
+    insertMemory(memory: Memory): void;
+    getMemory(id: string): Memory | null;
+    getMemoriesByIds(ids: string[]): Memory[];
+    getRecentMemories(project: string | null, limit: number): Memory[];
+    searchByProject(project: string, limit: number): Memory[];
+    softDelete(id: string): void;
+    deleteByProject(project: string): void;
+    getStats(): {
+        totalMemories: number;
+        totalEntities: number;
+        totalRelationships: number;
+    };
+    insertConsolidationLog(entry: ConsolidationLogEntry): void;
+    close(): void;
+    private rowToMemory;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/storage/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAGvE,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,CAAC,EAAE,MAAM;IAM3B,IAAI,IAAI,IAAI;IAmCZ,OAAO,CAAC,aAAa;IAgCrB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAwBlC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQpC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAUzC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAalE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAOzD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAO5B,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKtC,QAAQ,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE;IAyBxF,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAgB1D,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,WAAW;CAkBpB"}