@easynet/agent-memory 0.0.2

package/dist/persistence/utils/serialization.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Serialization utilities for SQLite repository
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeActor = serializeActor;
+exports.deserializeActor = deserializeActor;
+exports.serializeScope = serializeScope;
+exports.deserializeScope = deserializeScope;
+exports.rowToMemoryItem = rowToMemoryItem;
+/**
+ * Serialize actor to database fields
+ */
+function serializeActor(actor) {
+    if (!actor)
+        return {};
+    return {
+        actor_id: actor.id,
+        actor_type: actor.type,
+    };
+}
+/**
+ * Deserialize actor from database
+ */
+function deserializeActor(row) {
+    if (!row.actor_id)
+        return undefined;
+    return {
+        id: row.actor_id,
+        type: row.actor_type || "user",
+        name: row.actor_name,
+    };
+}
+/**
+ * Serialize scope to database fields
+ */
+function serializeScope(scope) {
+    if (!scope)
+        return {};
+    return {
+        scope_project_id: scope.projectId,
+        scope_channel_id: scope.channelId,
+        scope_thread_id: scope.threadId,
+        scope_run_id: scope.runId,
+    };
+}
+/**
+ * Deserialize scope from database
+ */
+function deserializeScope(row) {
+    if (!row.scope_project_id && !row.scope_channel_id && !row.scope_thread_id && !row.scope_run_id) {
+        return undefined;
+    }
+    return {
+        projectId: row.scope_project_id,
+        channelId: row.scope_channel_id,
+        threadId: row.scope_thread_id,
+        runId: row.scope_run_id,
+    };
+}
+/**
+ * Convert database row to MemoryItem
+ */
+function rowToMemoryItem(row, deserializeActorFn, deserializeScopeFn) {
+    return {
+        id: row.id,
+        type: row.type,
+        content: row.content,
+        actor: deserializeActorFn(row),
+        scope: deserializeScopeFn(row),
+        tags: row.tags_json ? JSON.parse(row.tags_json) : undefined,
+        confidence: row.confidence,
+        utility: row.utility || 0,
+        source: row.source_kind
+            ? {
+                kind: row.source_kind,
+                ref: row.source_ref,
+            }
+            : undefined,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        expiresAt: row.expires_at,
+    };
+}
+//# sourceMappingURL=serialization.js.map

package/dist/persistence/utils/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../../src/persistence/utils/serialization.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAOH,wCAMC;AAKD,4CAOC;AAKD,wCAaC;AAKD,4CAUC;AAKD,0CAoBC;AA/ED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,EAAE;QAClB,UAAU,EAAE,KAAK,CAAC,IAAI;KACvB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,GAAQ;IACvC,IAAI,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,QAAQ;QAChB,IAAI,EAAE,GAAG,CAAC,UAAU,IAAI,MAAM;QAC9B,IAAI,EAAE,GAAG,CAAC,UAAU;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAa;IAM1C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO;QACL,gBAAgB,EAAE,KAAK,CAAC,SAAS;QACjC,gBAAgB,EAAE,KAAK,CAAC,SAAS;QACjC,eAAe,EAAE,KAAK,CAAC,QAAQ;QAC/B,YAAY,EAAE,KAAK,CAAC,KAAK;KAC1B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,GAAQ;IACvC,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QAChG,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,gBAAgB;QAC/B,SAAS,EAAE,GAAG,CAAC,gBAAgB;QAC/B,QAAQ,EAAE,GAAG,CAAC,eAAe;QAC7B,KAAK,EAAE,GAAG,CAAC,YAAY;KACxB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,GAAQ,EAAE,kBAAmD,EAAE,kBAAmD;IAChJ,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAA0B;QACpC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC;QAC9B,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC;QAC9B,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;QAC3D,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,CAAC;QACzB,MAAM,EAAE,GAAG,CAAC,WAAW;YACrB,CAAC,CAAC;gBACE,IAAI,EAAE,GAAG,CAAC,WAAiD;gBAC3D,GAAG,EAAE,GAAG,CAAC,UAAU;aACpB;YACH,CAAC,CAAC,SAAS;QACb,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAC;AACJ,CAAC"}

package/dist/processing/document/document-processor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Document Processor - Handles document parsing and chunking
+ */
+import { DocumentChunk } from "../../types/document";
+import { MemoryItem } from "../../types";
+export interface ChunkingOptions {
+    chunkSize?: number;
+    chunkOverlap?: number;
+}
+export declare class DocumentProcessor {
+    private defaultChunkSize;
+    private defaultChunkOverlap;
+    /**
+     * Process document into chunks
+     */
+    processDocument(document: DocumentChunk | DocumentChunk[], options?: ChunkingOptions): DocumentChunk[];
+    /**
+     * Convert document chunks to MemoryItems
+     */
+    chunksToMemoryItems(chunks: DocumentChunk[], actor?: import("../../types").Actor, scope?: import("../../types").Scope, tags?: string[]): MemoryItem[];
+    /**
+     * Extract metadata as separate memory items
+     */
+    extractMetadataAsMemories(chunk: DocumentChunk, actor?: import("../../types").Actor, scope?: import("../../types").Scope): MemoryItem[];
+    /**
+     * Simple text chunking (sliding window)
+     */
+    private chunkText;
+}
+//# sourceMappingURL=document-processor.d.ts.map

package/dist/processing/document/document-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-processor.d.ts","sourceRoot":"","sources":["../../../src/processing/document/document-processor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAgB,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,mBAAmB,CAAe;IAE1C;;OAEG;IACH,eAAe,CACb,QAAQ,EAAE,aAAa,GAAG,aAAa,EAAE,EACzC,OAAO,GAAE,eAAoB,GAC5B,aAAa,EAAE;IAoBlB;;OAEG;IACH,mBAAmB,CACjB,MAAM,EAAE,aAAa,EAAE,EACvB,KAAK,CAAC,EAAE,OAAO,aAAa,EAAE,KAAK,EACnC,KAAK,CAAC,EAAE,OAAO,aAAa,EAAE,KAAK,EACnC,IAAI,CAAC,EAAE,MAAM,EAAE,GACd,UAAU,EAAE;IAwDf;;OAEG;IACH,yBAAyB,CACvB,KAAK,EAAE,aAAa,EACpB,KAAK,CAAC,EAAE,OAAO,aAAa,EAAE,KAAK,EACnC,KAAK,CAAC,EAAE,OAAO,aAAa,EAAE,KAAK,GAClC,UAAU,EAAE;IAuCf;;OAEG;IACH,OAAO,CAAC,SAAS;CAqClB"}

package/dist/processing/document/document-processor.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * Document Processor - Handles document parsing and chunking
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentProcessor = void 0;
+class DocumentProcessor {
+    constructor() {
+        this.defaultChunkSize = 1000;
+        this.defaultChunkOverlap = 200;
+    }
+    /**
+     * Process document into chunks
+     */
+    processDocument(document, options = {}) {
+        const chunks = [];
+        const docs = Array.isArray(document) ? document : [document];
+        const chunkSize = options.chunkSize || this.defaultChunkSize;
+        const chunkOverlap = options.chunkOverlap || this.defaultChunkOverlap;
+        for (const doc of docs) {
+            if (doc.text.length <= chunkSize) {
+                // Small document, no chunking needed
+                chunks.push(doc);
+            }
+            else {
+                // Chunk large documents
+                const docChunks = this.chunkText(doc, chunkSize, chunkOverlap);
+                chunks.push(...docChunks);
+            }
+        }
+        return chunks;
+    }
+    /**
+     * Convert document chunks to MemoryItems
+     */
+    chunksToMemoryItems(chunks, actor, scope, tags) {
+        const now = new Date().toISOString();
+        const items = [];
+        for (const chunk of chunks) {
+            // Determine memory type based on document type
+            let memoryType = "episodic";
+            if (chunk.type === "code") {
+                memoryType = "policy";
+            }
+            else if (chunk.metadata?.title?.toLowerCase().includes("policy") ||
+                chunk.metadata?.title?.toLowerCase().includes("guide")) {
+                memoryType = "policy";
+            }
+            // Build content with context
+            let content = chunk.text;
+            if (chunk.extractedText && chunk.extractedText !== chunk.text) {
+                content = `${chunk.text}\n\n[Extracted from ${chunk.type}]: ${chunk.extractedText}`;
+            }
+            // Add metadata context
+            const metadataParts = [];
+            if (chunk.metadata?.title) {
+                metadataParts.push(`Document: ${chunk.metadata.title}`);
+            }
+            if (chunk.page !== undefined) {
+                metadataParts.push(`Page: ${chunk.page}`);
+            }
+            if (chunk.section) {
+                metadataParts.push(`Section: ${chunk.section}`);
+            }
+            if (metadataParts.length > 0) {
+                content = `[${metadataParts.join(", ")}]\n\n${content}`;
+            }
+            const item = {
+                id: `doc_${Date.now()}_${items.length}`,
+                type: memoryType,
+                content: content.trim(),
+                actor,
+                scope,
+                tags: tags ? [...tags, `doc:${chunk.type}`] : [`doc:${chunk.type}`],
+                confidence: 0.8, // Documents are generally high confidence
+                source: {
+                    kind: "doc",
+                    ref: chunk.metadata?.url || chunk.metadata?.path || chunk.id,
+                },
+                createdAt: now,
+            };
+            items.push(item);
+        }
+        return items;
+    }
+    /**
+     * Extract metadata as separate memory items
+     */
+    extractMetadataAsMemories(chunk, actor, scope) {
+        const items = [];
+        const now = new Date().toISOString();
+        if (chunk.metadata?.title) {
+            items.push({
+                id: `doc_meta_${Date.now()}_title`,
+                type: "profile",
+                content: `Document title: ${chunk.metadata.title}`,
+                actor,
+                scope,
+                tags: ["doc:metadata", "doc:title"],
+                source: {
+                    kind: "doc",
+                    ref: chunk.metadata.url || chunk.metadata.path,
+                },
+                createdAt: now,
+            });
+        }
+        if (chunk.metadata?.author) {
+            items.push({
+                id: `doc_meta_${Date.now()}_author`,
+                type: "profile",
+                content: `Document author: ${chunk.metadata.author}`,
+                actor,
+                scope,
+                tags: ["doc:metadata", "doc:author"],
+                source: {
+                    kind: "doc",
+                    ref: chunk.metadata.url || chunk.metadata.path,
+                },
+                createdAt: now,
+            });
+        }
+        return items;
+    }
+    /**
+     * Simple text chunking (sliding window)
+     */
+    chunkText(doc, chunkSize, overlap) {
+        const chunks = [];
+        const text = doc.text;
+        let start = 0;
+        while (start < text.length) {
+            const end = Math.min(start + chunkSize, text.length);
+            const chunkText = text.slice(start, end);
+            // Try to break at sentence boundary
+            let actualEnd = end;
+            if (end < text.length) {
+                const lastPeriod = chunkText.lastIndexOf(".");
+                const lastNewline = chunkText.lastIndexOf("\n");
+                const breakPoint = Math.max(lastPeriod, lastNewline);
+                if (breakPoint > chunkSize * 0.5) {
+                    actualEnd = start + breakPoint + 1;
+                }
+            }
+            chunks.push({
+                ...doc,
+                id: `${doc.id}_chunk_${chunks.length}`,
+                text: text.slice(start, actualEnd).trim(),
+                section: doc.section || `chunk_${chunks.length}`,
+            });
+            start = actualEnd - overlap;
+            if (start >= text.length)
+                break;
+        }
+        return chunks;
+    }
+}
+exports.DocumentProcessor = DocumentProcessor;
+//# sourceMappingURL=document-processor.js.map

package/dist/processing/document/document-processor.js.map

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

package/dist/processing/document/index.d.ts

@@ -0,0 +1,3 @@
+export { DocumentProcessor } from "./document-processor";
+export type { ChunkingOptions } from "./document-processor";
+//# sourceMappingURL=index.d.ts.map

package/dist/processing/document/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/processing/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/processing/document/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentProcessor = void 0;
+var document_processor_1 = require("./document-processor");
+Object.defineProperty(exports, "DocumentProcessor", { enumerable: true, get: function () { return document_processor_1.DocumentProcessor; } });
+//# sourceMappingURL=index.js.map

package/dist/processing/document/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/processing/document/index.ts"],"names":[],"mappings":";;;AAAA,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA"}

package/dist/ranker/ranker.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Ranking for memory and document retrieval results
+ */
+import { MemoryItem, DocChunk } from "../types";
+export interface RankingConfig {
+    memory?: {
+        sim_weight: number;
+        utility_weight: number;
+    };
+    docs?: {
+        score_weight: number;
+    };
+}
+export declare class Ranker {
+    private config;
+    constructor(config: RankingConfig);
+    /**
+     * Rank memory items by similarity and utility
+     */
+    rankMemory(items: MemoryItem[]): MemoryItem[];
+    /**
+     * Rank document chunks by score
+     */
+    rankDocs(chunks: DocChunk[]): DocChunk[];
+}
+//# sourceMappingURL=ranker.d.ts.map

package/dist/ranker/ranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranker.d.ts","sourceRoot":"","sources":["../../src/ranker/ranker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAIjC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE;IAa7C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE;CAWzC"}

package/dist/ranker/ranker.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Ranking for memory and document retrieval results
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Ranker = void 0;
+class Ranker {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Rank memory items by similarity and utility
+     */
+    rankMemory(items) {
+        const simWeight = this.config.memory?.sim_weight ?? 0.6;
+        const utilityWeight = this.config.memory?.utility_weight ?? 0.4;
+        return items
+            .map(item => ({
+            ...item,
+            _rankScore: (item.confidence || 0) * simWeight + (item.utility || 0) * utilityWeight,
+        }))
+            .sort((a, b) => (b._rankScore || 0) - (a._rankScore || 0))
+            .map(({ _rankScore, ...item }) => item);
+    }
+    /**
+     * Rank document chunks by score
+     */
+    rankDocs(chunks) {
+        const scoreWeight = this.config.docs?.score_weight ?? 1.0;
+        return chunks
+            .map(chunk => ({
+            ...chunk,
+            _rankScore: (chunk.score || 0) * scoreWeight,
+        }))
+            .sort((a, b) => (b._rankScore || 0) - (a._rankScore || 0))
+            .map(({ _rankScore, ...chunk }) => chunk);
+    }
+}
+exports.Ranker = Ranker;
+//# sourceMappingURL=ranker.js.map

package/dist/ranker/ranker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranker.js","sourceRoot":"","sources":["../../src/ranker/ranker.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAcH,MAAa,MAAM;IAGjB,YAAY,MAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAmB;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,IAAI,GAAG,CAAC;QACxD,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,IAAI,GAAG,CAAC;QAEhE,OAAO,KAAK;aACT,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,GAAG,IAAI;YACP,UAAU,EAAE,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,aAAa;SACrF,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;aACzD,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAkB;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,IAAI,GAAG,CAAC;QAE1D,OAAO,MAAM;aACV,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACb,GAAG,KAAK;YACR,UAAU,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,WAAW;SAC7C,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;aACzD,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;CACF;AArCD,wBAqCC"}

package/dist/recall/recall-engine.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Recall Engine - Hybrid retrieval of memory and documents
+ */
+import { MemoryStore, DocRetriever } from "../adapters/types";
+import { RecallOptions, RecallResult } from "../types";
+import { Config } from "../types/config";
+export declare class RecallEngine {
+    private store;
+    private retriever;
+    private config;
+    private ranker;
+    private contextBuilder;
+    constructor(store: MemoryStore, retriever: DocRetriever | null, config: Config);
+    /**
+     * Recall memories and documents
+     */
+    recall(options: RecallOptions): Promise<RecallResult>;
+}
+//# sourceMappingURL=recall-engine.d.ts.map

package/dist/recall/recall-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-engine.d.ts","sourceRoot":"","sources":["../../src/recall/recall-engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAwB,aAAa,EAAE,YAAY,EAAgB,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAYzC,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAiB;gBAGrC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,YAAY,GAAG,IAAI,EAC9B,MAAM,EAAE,MAAM;IAehB;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CA+C5D"}

package/dist/recall/recall-engine.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Recall Engine - Hybrid retrieval of memory and documents
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecallEngine = void 0;
+const ranker_1 = require("../ranker/ranker");
+const context_builder_1 = require("../context/context-builder");
+// Simple UUID v4 generator
+function generateTraceId() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        const r = Math.random() * 16 | 0;
+        const v = c === 'x' ? r : (r & 0x3 | 0x8);
+        return v.toString(16);
+    });
+}
+class RecallEngine {
+    constructor(store, retriever, config) {
+        this.store = store;
+        this.retriever = retriever;
+        this.config = config;
+        const recallConfig = config.recall;
+        this.ranker = new ranker_1.Ranker(recallConfig?.ranker || {});
+        this.contextBuilder = new context_builder_1.ContextBuilder(recallConfig?.context || {
+            enabled: true,
+            template: "default",
+            max_tokens: 1400,
+        });
+    }
+    /**
+     * Recall memories and documents
+     */
+    async recall(options) {
+        const traceId = generateTraceId();
+        const strategy = this.config.recall?.strategy || "hybrid";
+        const topK = options.topK || 10;
+        const includeMemory = options.includeMemory !== false;
+        const includeDocs = options.includeDocs !== false;
+        let memory = [];
+        let docs = [];
+        // Retrieve memory
+        if (includeMemory && (strategy === "hybrid" || strategy === "memory_only")) {
+            try {
+                memory = await this.store.search(options.query, {
+                    actor: options.actor,
+                    scope: options.scope,
+                    topK,
+                });
+                memory = this.ranker.rankMemory(memory);
+            }
+            catch (error) {
+                console.error("Failed to retrieve memory:", error);
+            }
+        }
+        // Retrieve documents
+        if (includeDocs && this.retriever && (strategy === "hybrid" || strategy === "docs_only")) {
+            try {
+                docs = await this.retriever.search(options.query, {
+                    scope: options.scope,
+                    topK,
+                });
+                docs = this.ranker.rankDocs(docs);
+            }
+            catch (error) {
+                console.error("Failed to retrieve documents:", error);
+            }
+        }
+        // Build context
+        const context = this.contextBuilder.build(memory, docs);
+        return {
+            memory,
+            docs,
+            context,
+            traceId,
+        };
+    }
+}
+exports.RecallEngine = RecallEngine;
+//# sourceMappingURL=recall-engine.js.map

package/dist/recall/recall-engine.js.map

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