@backendkit-labs/agent-core 0.14.0

package/dist/agent-memory/MemorySystem.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemorySystem = void 0;
+exports.createMemorySystem = createMemorySystem;
+const EpisodicMemory_1 = require("./EpisodicMemory");
+const SemanticMemory_1 = require("./SemanticMemory");
+const ProceduralMemory_1 = require("./ProceduralMemory");
+const tools_1 = require("./tools");
+/**
+ * Unified facade for the three-tier agent memory system.
+ *
+ * - episodic:   time-ordered log of experiences (recall by keyword or tag)
+ * - semantic:   knowledge base (recall by keyword or vector similarity)
+ * - procedural: learned patterns from successes and failures
+ *
+ * Use buildContextBlock() to inject relevant memories into system prompts,
+ * and getTools() to register the memory tools with the agent engine.
+ *
+ * @example
+ * const memory = createMemorySystem({
+ *   episodic:   { provider: 'json', path: '~/.bk/memory/episodes.json' },
+ *   semantic:   { provider: 'json', path: '~/.bk/memory/knowledge.json', embedFn: myEmbedder },
+ *   procedural: { provider: 'json', path: '~/.bk/memory/patterns.json' },
+ *   retention:  { maxEpisodes: 1000, summarizeAfter: 100, summarizeFn: myLLMSummarizer },
+ * });
+ */
+class MemorySystem {
+    config;
+    episodic;
+    semantic;
+    procedural;
+    constructor(config = {}) {
+        this.config = config;
+        this.episodic = new EpisodicMemory_1.EpisodicMemory(config.episodic, config.retention);
+        this.semantic = new SemanticMemory_1.SemanticMemory(config.semantic);
+        this.procedural = new ProceduralMemory_1.ProceduralMemory(config.procedural);
+    }
+    /**
+     * Build a markdown context block combining relevant memories from all three tiers.
+     * Inject the result into agent system prompts for in-context retrieval.
+     */
+    async buildContextBlock(query) {
+        const parts = [];
+        const recent = this.episodic.recall(query, 5);
+        if (recent.length > 0) {
+            parts.push('## Relevant Past Experiences');
+            for (const e of recent) {
+                const date = e.createdAt.toISOString().slice(0, 10);
+                const tagStr = e.tags.length ? ` [${e.tags.join(', ')}]` : '';
+                parts.push(`- ${date}${tagStr}: ${e.content}`);
+            }
+        }
+        const knowledge = await this.semantic.search(query, 3);
+        if (knowledge.length > 0) {
+            parts.push('## Relevant Knowledge');
+            for (const k of knowledge) {
+                parts.push(`- ${k.content}`);
+            }
+        }
+        const procedural = this.procedural.buildContextBlock(query);
+        if (procedural)
+            parts.push(procedural);
+        return parts.join('\n\n');
+    }
+    /** Returns pre-built ToolDefinitions to register with the agent engine. */
+    getTools() {
+        return (0, tools_1.buildMemoryTools)(this.episodic, this.semantic, this.procedural);
+    }
+}
+exports.MemorySystem = MemorySystem;
+/** Factory shorthand for MemorySystem. */
+function createMemorySystem(config) {
+    return new MemorySystem(config);
+}
+//# sourceMappingURL=MemorySystem.js.map

package/dist/agent-memory/MemorySystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemorySystem.js","sourceRoot":"","sources":["../../src/agent-memory/MemorySystem.ts"],"names":[],"mappings":";;;AA0EA,gDAEC;AA3ED,qDAAkD;AAClD,qDAAkD;AAClD,yDAAsD;AACtD,mCAA2C;AAG3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,YAAY;IAKQ;IAJpB,QAAQ,CAAiB;IACzB,QAAQ,CAAiB;IACzB,UAAU,CAAmB;IAEtC,YAA6B,SAA6B,EAAE;QAA/B,WAAM,GAAN,MAAM,CAAyB;QACxD,IAAI,CAAC,QAAQ,GAAK,IAAI,+BAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,GAAK,IAAI,+BAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,GAAG,IAAI,mCAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAAa;QACjC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACrB,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpD,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9D,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,GAAG,MAAM,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACnD,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACvD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YACpC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACjC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEvC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,2EAA2E;IAC3E,QAAQ;QACJ,OAAO,IAAA,wBAAgB,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3E,CAAC;CACJ;AA9CD,oCA8CC;AAED,0CAA0C;AAC1C,SAAgB,kBAAkB,CAAC,MAA2B;IAC1D,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/agent-memory/ProceduralMemory.d.ts

@@ -0,0 +1,26 @@
+import type { Pattern, ProceduralConfig } from './types';
+/**
+ * Procedural memory — learned patterns from agent outcomes.
+ *
+ * Agents call learnPattern() after a task succeeds or fails. On the next
+ * relevant task, getRelevantPatterns() retrieves matching heuristics and
+ * buildContextBlock() formats them for injection into the system prompt.
+ */
+export declare class ProceduralMemory {
+    private readonly backend;
+    constructor(cfg?: ProceduralConfig);
+    /**
+     * Record that a particular (trigger → action) pair produced the given outcome.
+     * Repeated calls for the same trigger+action increment the occurrence counter.
+     */
+    learnPattern(trigger: string, action: string, outcome: 'success' | 'failure'): void;
+    /** Return patterns whose trigger keywords overlap with the given context. */
+    getRelevantPatterns(context: string, limit?: number): Pattern[];
+    /**
+     * Format relevant patterns as a markdown block suitable for system prompt injection.
+     * Returns an empty string if no patterns match.
+     */
+    buildContextBlock(context: string): string;
+    count(): number;
+}
+//# sourceMappingURL=ProceduralMemory.d.ts.map

package/dist/agent-memory/ProceduralMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProceduralMemory.d.ts","sourceRoot":"","sources":["../../src/agent-memory/ProceduralMemory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,OAAO,EAAE,gBAAgB,EAAgB,MAAM,SAAS,CAAC;AAa3F;;;;;;GAMG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,GAAG,GAAE,gBAAqB;IAMtC;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI;IA2BnF,6EAA6E;IAC7E,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,EAAE;IAc1D;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAuB1C,KAAK,IAAI,MAAM;CAClB"}

package/dist/agent-memory/ProceduralMemory.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProceduralMemory = void 0;
+const crypto_1 = require("crypto");
+const InMemoryStore_1 = require("./stores/InMemoryStore");
+const JsonFileStore_1 = require("./stores/JsonFileStore");
+const scoring_1 = require("./scoring");
+/**
+ * Procedural memory — learned patterns from agent outcomes.
+ *
+ * Agents call learnPattern() after a task succeeds or fails. On the next
+ * relevant task, getRelevantPatterns() retrieves matching heuristics and
+ * buildContextBlock() formats them for injection into the system prompt.
+ */
+class ProceduralMemory {
+    backend;
+    constructor(cfg = {}) {
+        this.backend = cfg.provider === 'json' && cfg.path
+            ? new JsonFileStore_1.JsonFileStore(cfg.path)
+            : new InMemoryStore_1.InMemoryStore();
+    }
+    /**
+     * Record that a particular (trigger → action) pair produced the given outcome.
+     * Repeated calls for the same trigger+action increment the occurrence counter.
+     */
+    learnPattern(trigger, action, outcome) {
+        const all = this.backend.getAll();
+        const existing = all.find(r => r.trigger.toLowerCase() === trigger.toLowerCase() &&
+            r.action.toLowerCase() === action.toLowerCase() &&
+            r.outcome === outcome);
+        if (existing) {
+            this.backend.upsert(existing.id, {
+                ...existing,
+                occurrences: existing.occurrences + 1,
+                lastSeen: new Date().toISOString(),
+            });
+        }
+        else {
+            this.backend.insert({
+                id: (0, crypto_1.randomUUID)(),
+                trigger,
+                action,
+                outcome,
+                occurrences: 1,
+                lastSeen: new Date().toISOString(),
+                createdAt: new Date().toISOString(),
+            });
+        }
+    }
+    /** Return patterns whose trigger keywords overlap with the given context. */
+    getRelevantPatterns(context, limit = 5) {
+        return this.backend.getAll()
+            .map(r => ({ ...toPattern(r), score: (0, scoring_1.keywordScore)(context, r.trigger) }))
+            .filter(p => (p.score ?? 0) > 0)
+            .sort((a, b) => {
+            // Prefer successful patterns and higher occurrence counts
+            const scoreDiff = (b.score ?? 0) - (a.score ?? 0);
+            if (Math.abs(scoreDiff) > 0.1)
+                return scoreDiff;
+            if (a.outcome !== b.outcome)
+                return a.outcome === 'success' ? -1 : 1;
+            return b.occurrences - a.occurrences;
+        })
+            .slice(0, limit);
+    }
+    /**
+     * Format relevant patterns as a markdown block suitable for system prompt injection.
+     * Returns an empty string if no patterns match.
+     */
+    buildContextBlock(context) {
+        const patterns = this.getRelevantPatterns(context, 6);
+        if (patterns.length === 0)
+            return '';
+        const successes = patterns.filter(p => p.outcome === 'success');
+        const failures = patterns.filter(p => p.outcome === 'failure');
+        const lines = ['## Learned Patterns'];
+        if (successes.length > 0) {
+            lines.push('**What works:**');
+            for (const p of successes) {
+                lines.push(`- When ${p.trigger}: ${p.action} (confirmed ${p.occurrences}×)`);
+            }
+        }
+        if (failures.length > 0) {
+            lines.push('**What to avoid:**');
+            for (const p of failures) {
+                lines.push(`- When ${p.trigger}: avoid "${p.action}" (failed ${p.occurrences}×)`);
+            }
+        }
+        return lines.join('\n');
+    }
+    count() { return this.backend.count(); }
+}
+exports.ProceduralMemory = ProceduralMemory;
+function toPattern(r) {
+    return {
+        id: r.id,
+        trigger: r.trigger,
+        action: r.action,
+        outcome: r.outcome,
+        occurrences: r.occurrences,
+        lastSeen: new Date(r.lastSeen),
+    };
+}
+//# sourceMappingURL=ProceduralMemory.js.map

package/dist/agent-memory/ProceduralMemory.js.map

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

package/dist/agent-memory/SemanticMemory.d.ts

@@ -0,0 +1,21 @@
+import type { Knowledge, SemanticConfig } from './types';
+/**
+ * Semantic memory — a searchable knowledge base.
+ *
+ * Without an embedFn: keyword overlap scoring.
+ * With an embedFn: cosine similarity on stored embeddings (auto-computed on index).
+ */
+export declare class SemanticMemory {
+    private readonly backend;
+    private readonly embedFn;
+    constructor(cfg?: SemanticConfig);
+    /** Store a piece of knowledge. Returns the new entry ID. */
+    index(content: string, metadata?: Record<string, string>): Promise<string>;
+    /**
+     * Find knowledge entries relevant to a query.
+     * Uses cosine similarity when embeddings are available; falls back to keyword scoring.
+     */
+    search(query: string, limit?: number): Promise<Knowledge[]>;
+    count(): number;
+}
+//# sourceMappingURL=SemanticMemory.d.ts.map

package/dist/agent-memory/SemanticMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SemanticMemory.d.ts","sourceRoot":"","sources":["../../src/agent-memory/SemanticMemory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAsB,cAAc,EAAgB,MAAM,SAAS,CAAC;AAW3F;;;;;GAKG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAExC,GAAG,GAAE,cAAmB;IAOpC,4DAA4D;IACtD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAapF;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAoB5D,KAAK,IAAI,MAAM;CAClB"}

package/dist/agent-memory/SemanticMemory.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemanticMemory = void 0;
+const crypto_1 = require("crypto");
+const InMemoryStore_1 = require("./stores/InMemoryStore");
+const JsonFileStore_1 = require("./stores/JsonFileStore");
+const scoring_1 = require("./scoring");
+/**
+ * Semantic memory — a searchable knowledge base.
+ *
+ * Without an embedFn: keyword overlap scoring.
+ * With an embedFn: cosine similarity on stored embeddings (auto-computed on index).
+ */
+class SemanticMemory {
+    backend;
+    embedFn;
+    constructor(cfg = {}) {
+        this.backend = cfg.provider === 'json' && cfg.path
+            ? new JsonFileStore_1.JsonFileStore(cfg.path)
+            : new InMemoryStore_1.InMemoryStore();
+        this.embedFn = cfg.embedFn;
+    }
+    /** Store a piece of knowledge. Returns the new entry ID. */
+    async index(content, metadata = {}) {
+        const id = (0, crypto_1.randomUUID)();
+        const embedding = this.embedFn ? await this.embedFn(content) : undefined;
+        this.backend.insert({
+            id,
+            content,
+            metadata,
+            ...(embedding ? { embedding } : {}),
+            createdAt: new Date().toISOString(),
+        });
+        return id;
+    }
+    /**
+     * Find knowledge entries relevant to a query.
+     * Uses cosine similarity when embeddings are available; falls back to keyword scoring.
+     */
+    async search(query, limit = 5) {
+        const records = this.backend.getAll();
+        const withEmbeddings = records.filter(r => r.embedding);
+        if (this.embedFn && withEmbeddings.length > 0) {
+            const qVec = await this.embedFn(query);
+            return withEmbeddings
+                .map(r => ({ ...toKnowledge(r), score: (0, scoring_1.cosine)(qVec, r.embedding) }))
+                .sort((a, b) => (b.score ?? 0) - (a.score ?? 0))
+                .slice(0, limit);
+        }
+        return records
+            .map(r => ({ ...toKnowledge(r), score: (0, scoring_1.keywordScore)(query, r.content) }))
+            .filter(k => (k.score ?? 0) > 0)
+            .sort((a, b) => (b.score ?? 0) - (a.score ?? 0))
+            .slice(0, limit);
+    }
+    count() { return this.backend.count(); }
+}
+exports.SemanticMemory = SemanticMemory;
+function toKnowledge(r) {
+    return {
+        id: r.id,
+        content: r.content,
+        metadata: r.metadata,
+        embedding: r.embedding,
+        createdAt: new Date(r.createdAt),
+    };
+}
+//# sourceMappingURL=SemanticMemory.js.map

package/dist/agent-memory/SemanticMemory.js.map

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

package/dist/agent-memory/index.d.ts

@@ -0,0 +1,9 @@
+export { MemorySystem, createMemorySystem } from './MemorySystem';
+export { EpisodicMemory } from './EpisodicMemory';
+export { SemanticMemory } from './SemanticMemory';
+export { ProceduralMemory } from './ProceduralMemory';
+export { buildMemoryTools } from './tools';
+export { InMemoryStore } from './stores/InMemoryStore';
+export { JsonFileStore } from './stores/JsonFileStore';
+export type { Episode, Knowledge, Pattern, EmbedFn, SummarizeFn, MemorySystemConfig, EpisodicConfig, SemanticConfig, ProceduralConfig, RetentionConfig, MemoryStoreBackend, StoredRecord, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent-memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EACR,OAAO,EACP,SAAS,EACT,OAAO,EACP,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,YAAY,GACf,MAAM,SAAS,CAAC"}

package/dist/agent-memory/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonFileStore = exports.InMemoryStore = exports.buildMemoryTools = exports.ProceduralMemory = exports.SemanticMemory = exports.EpisodicMemory = exports.createMemorySystem = exports.MemorySystem = void 0;
+var MemorySystem_1 = require("./MemorySystem");
+Object.defineProperty(exports, "MemorySystem", { enumerable: true, get: function () { return MemorySystem_1.MemorySystem; } });
+Object.defineProperty(exports, "createMemorySystem", { enumerable: true, get: function () { return MemorySystem_1.createMemorySystem; } });
+var EpisodicMemory_1 = require("./EpisodicMemory");
+Object.defineProperty(exports, "EpisodicMemory", { enumerable: true, get: function () { return EpisodicMemory_1.EpisodicMemory; } });
+var SemanticMemory_1 = require("./SemanticMemory");
+Object.defineProperty(exports, "SemanticMemory", { enumerable: true, get: function () { return SemanticMemory_1.SemanticMemory; } });
+var ProceduralMemory_1 = require("./ProceduralMemory");
+Object.defineProperty(exports, "ProceduralMemory", { enumerable: true, get: function () { return ProceduralMemory_1.ProceduralMemory; } });
+var tools_1 = require("./tools");
+Object.defineProperty(exports, "buildMemoryTools", { enumerable: true, get: function () { return tools_1.buildMemoryTools; } });
+var InMemoryStore_1 = require("./stores/InMemoryStore");
+Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return InMemoryStore_1.InMemoryStore; } });
+var JsonFileStore_1 = require("./stores/JsonFileStore");
+Object.defineProperty(exports, "JsonFileStore", { enumerable: true, get: function () { return JsonFileStore_1.JsonFileStore; } });
+//# sourceMappingURL=index.js.map

package/dist/agent-memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-memory/index.ts"],"names":[],"mappings":";;;AAAA,+CAAkE;AAAzD,4GAAA,YAAY,OAAA;AAAE,kHAAA,kBAAkB,OAAA;AACzC,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,iCAA2C;AAAlC,yGAAA,gBAAgB,OAAA;AACzB,wDAAuD;AAA9C,8GAAA,aAAa,OAAA;AACtB,wDAAuD;AAA9C,8GAAA,aAAa,OAAA"}

package/dist/agent-memory/scoring.d.ts

@@ -0,0 +1,10 @@
+/** Tokenize text into lowercase terms of length >= 3. */
+export declare function tokenize(text: string): string[];
+/**
+ * Keyword overlap score [0, 1] — what fraction of query terms appear in the doc.
+ * Simple but effective for episodic recall without embeddings.
+ */
+export declare function keywordScore(query: string, doc: string): number;
+/** Cosine similarity between two equal-length vectors. Returns 0 for zero-magnitude inputs. */
+export declare function cosine(a: number[], b: number[]): number;
+//# sourceMappingURL=scoring.d.ts.map

package/dist/agent-memory/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/agent-memory/scoring.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED,+FAA+F;AAC/F,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAQvD"}

package/dist/agent-memory/scoring.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenize = tokenize;
+exports.keywordScore = keywordScore;
+exports.cosine = cosine;
+/** Tokenize text into lowercase terms of length >= 3. */
+function tokenize(text) {
+    return text.toLowerCase().split(/\W+/).filter(t => t.length >= 3);
+}
+/**
+ * Keyword overlap score [0, 1] — what fraction of query terms appear in the doc.
+ * Simple but effective for episodic recall without embeddings.
+ */
+function keywordScore(query, doc) {
+    const queryTerms = new Set(tokenize(query));
+    if (queryTerms.size === 0)
+        return 0;
+    const docText = doc.toLowerCase();
+    const hits = [...queryTerms].filter(t => docText.includes(t)).length;
+    return hits / queryTerms.size;
+}
+/** Cosine similarity between two equal-length vectors. Returns 0 for zero-magnitude inputs. */
+function cosine(a, b) {
+    let dot = 0, magA = 0, magB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * (b[i] ?? 0);
+        magA += a[i] * a[i];
+        magB += (b[i] ?? 0) * (b[i] ?? 0);
+    }
+    return magA && magB ? dot / (Math.sqrt(magA) * Math.sqrt(magB)) : 0;
+}
+//# sourceMappingURL=scoring.js.map

package/dist/agent-memory/scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../../src/agent-memory/scoring.ts"],"names":[],"mappings":";;AACA,4BAEC;AAMD,oCAMC;AAGD,wBAQC;AA1BD,yDAAyD;AACzD,SAAgB,QAAQ,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,KAAa,EAAE,GAAW;IACnD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACrE,OAAO,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;AAClC,CAAC;AAED,+FAA+F;AAC/F,SAAgB,MAAM,CAAC,CAAW,EAAE,CAAW;IAC3C,IAAI,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,GAAG,IAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/dist/agent-memory/stores/InMemoryStore.d.ts

@@ -0,0 +1,10 @@
+import type { MemoryStoreBackend, StoredRecord } from '../types';
+export declare class InMemoryStore implements MemoryStoreBackend {
+    private records;
+    insert(record: StoredRecord): void;
+    upsert(id: string, record: StoredRecord): void;
+    getAll(): StoredRecord[];
+    deleteOldest(keepNewest: number): void;
+    count(): number;
+}
+//# sourceMappingURL=InMemoryStore.d.ts.map

package/dist/agent-memory/stores/InMemoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStore.d.ts","sourceRoot":"","sources":["../../../src/agent-memory/stores/InMemoryStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEjE,qBAAa,aAAc,YAAW,kBAAkB;IACpD,OAAO,CAAC,OAAO,CAAsB;IAErC,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIlC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAM9C,MAAM,IAAI,YAAY,EAAE;IAExB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAMtC,KAAK,IAAI,MAAM;CAClB"}

package/dist/agent-memory/stores/InMemoryStore.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryStore = void 0;
+class InMemoryStore {
+    records = [];
+    insert(record) {
+        this.records.push(record);
+    }
+    upsert(id, record) {
+        const idx = this.records.findIndex(r => r.id === id);
+        if (idx >= 0)
+            this.records[idx] = record;
+        else
+            this.records.push(record);
+    }
+    getAll() { return [...this.records]; }
+    deleteOldest(keepNewest) {
+        if (this.records.length > keepNewest) {
+            this.records = this.records.slice(-keepNewest);
+        }
+    }
+    count() { return this.records.length; }
+}
+exports.InMemoryStore = InMemoryStore;
+//# sourceMappingURL=InMemoryStore.js.map

package/dist/agent-memory/stores/InMemoryStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStore.js","sourceRoot":"","sources":["../../../src/agent-memory/stores/InMemoryStore.ts"],"names":[],"mappings":";;;AAEA,MAAa,aAAa;IACd,OAAO,GAAmB,EAAE,CAAC;IAErC,MAAM,CAAC,MAAoB;QACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,MAAoB;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,IAAI,GAAG,IAAI,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;;YACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,KAAqB,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAEtD,YAAY,CAAC,UAAkB;QAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;QACnD,CAAC;IACL,CAAC;IAED,KAAK,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CAClD;AAtBD,sCAsBC"}

package/dist/agent-memory/stores/JsonFileStore.d.ts

@@ -0,0 +1,18 @@
+import type { MemoryStoreBackend, StoredRecord } from '../types';
+/**
+ * Persistent JSON file backend.
+ * Reads are lazy-cached; writes use atomicWriteSync (tmp + rename) to avoid corruption.
+ */
+export declare class JsonFileStore implements MemoryStoreBackend {
+    private readonly path;
+    private cache;
+    constructor(path: string);
+    insert(record: StoredRecord): void;
+    upsert(id: string, record: StoredRecord): void;
+    getAll(): StoredRecord[];
+    deleteOldest(keepNewest: number): void;
+    count(): number;
+    private load;
+    private persist;
+}
+//# sourceMappingURL=JsonFileStore.d.ts.map

package/dist/agent-memory/stores/JsonFileStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonFileStore.d.ts","sourceRoot":"","sources":["../../../src/agent-memory/stores/JsonFileStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEjE;;;GAGG;AACH,qBAAa,aAAc,YAAW,kBAAkB;IAGxC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,KAAK,CAA+B;gBAEf,IAAI,EAAE,MAAM;IAIzC,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAMlC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAQ9C,MAAM,IAAI,YAAY,EAAE;IAExB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOtC,KAAK,IAAI,MAAM;IAEf,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,OAAO;CAIlB"}

package/dist/agent-memory/stores/JsonFileStore.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonFileStore = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const atomic_write_1 = require("../../shared/utils/atomic-write");
+/**
+ * Persistent JSON file backend.
+ * Reads are lazy-cached; writes use atomicWriteSync (tmp + rename) to avoid corruption.
+ */
+class JsonFileStore {
+    path;
+    cache = null;
+    constructor(path) {
+        this.path = path;
+        (0, fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true });
+    }
+    insert(record) {
+        const records = this.load();
+        records.push(record);
+        this.persist(records);
+    }
+    upsert(id, record) {
+        const records = this.load();
+        const idx = records.findIndex(r => r.id === id);
+        if (idx >= 0)
+            records[idx] = record;
+        else
+            records.push(record);
+        this.persist(records);
+    }
+    getAll() { return this.load(); }
+    deleteOldest(keepNewest) {
+        const records = this.load();
+        if (records.length > keepNewest) {
+            this.persist(records.slice(-keepNewest));
+        }
+    }
+    count() { return this.load().length; }
+    load() {
+        if (this.cache)
+            return this.cache;
+        if (!(0, fs_1.existsSync)(this.path)) {
+            this.cache = [];
+            return [];
+        }
+        try {
+            this.cache = JSON.parse((0, fs_1.readFileSync)(this.path, 'utf-8'));
+        }
+        catch {
+            this.cache = [];
+        }
+        return this.cache;
+    }
+    persist(records) {
+        this.cache = records;
+        (0, atomic_write_1.atomicWriteSync)(this.path, JSON.stringify(records, null, 2));
+    }
+}
+exports.JsonFileStore = JsonFileStore;
+//# sourceMappingURL=JsonFileStore.js.map

package/dist/agent-memory/stores/JsonFileStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonFileStore.js","sourceRoot":"","sources":["../../../src/agent-memory/stores/JsonFileStore.ts"],"names":[],"mappings":";;;AAAA,2BAAyD;AACzD,+BAA+B;AAC/B,kEAAkE;AAGlE;;;GAGG;AACH,MAAa,aAAa;IAGO;IAFrB,KAAK,GAA0B,IAAI,CAAC;IAE5C,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;QACrC,IAAA,cAAS,EAAC,IAAA,cAAO,EAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,MAAoB;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,MAAoB;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAChD,IAAI,GAAG,IAAI,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;;YAC/B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,KAAqB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEhD,YAAY,CAAC,UAAkB;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7C,CAAC;IACL,CAAC;IAED,KAAK,KAAa,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEtC,IAAI;QACR,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QAClC,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAAC,OAAO,EAAE,CAAC;QAAC,CAAC;QAC3D,IAAI,CAAC;YACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAmB,CAAC;QAChF,CAAC;QAAC,MAAM,CAAC;YACL,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QACpB,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAEO,OAAO,CAAC,OAAuB;QACnC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;QACrB,IAAA,8BAAe,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;CACJ;AA/CD,sCA+CC"}

package/dist/agent-memory/tools.d.ts

@@ -0,0 +1,6 @@
+import type { ToolDefinition } from '../types';
+import type { EpisodicMemory } from './EpisodicMemory';
+import type { SemanticMemory } from './SemanticMemory';
+import type { ProceduralMemory } from './ProceduralMemory';
+export declare function buildMemoryTools(episodic: EpisodicMemory, semantic: SemanticMemory, procedural: ProceduralMemory): ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/agent-memory/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agent-memory/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,gBAAgB,GAC7B,cAAc,EAAE,CAwElB"}