@framers/agentos 0.1.126 → 0.1.128

package/dist/memory/retrieval/feedback/RetrievalFeedbackSignal.js

@@ -0,0 +1,295 @@
+/**
+ * @fileoverview Retrieval feedback signal — detects which injected memory
+ * traces were actually used vs ignored by the LLM response.
+ *
+ * ## Why this exists
+ * When the memory system injects context traces into a prompt, not all of
+ * them will be relevant to the model's generated response.  Tracking which
+ * memories were actually referenced allows the spaced-repetition engine to:
+ * - Reinforce genuinely helpful memories (via `updateOnRetrieval`).
+ * - Accelerate decay on repeatedly-ignored memories (via `penalizeUnused`).
+ *
+ * ## Detection heuristic
+ * A keyword overlap heuristic is used instead of a full LLM call to keep
+ * the feedback loop non-blocking and low-latency:
+ *   1. Extract unique words > 4 characters from each trace's content.
+ *   2. Check how many of those keywords appear in the LLM's response.
+ *   3. If matchRatio > 0.30 → signal = 'used', otherwise 'ignored'.
+ *
+ * An optional `similarityFn` can be injected for higher-fidelity semantic
+ * detection, but is not required for the default path.
+ *
+ * ## Persistence
+ * Each feedback event is written to the `retrieval_feedback` table in the
+ * agent's `SqliteBrain`.  The `detect()` method therefore requires that a
+ * corresponding row exists in `memory_traces` for every trace passed in
+ * (i.e. the trace must already be persisted).
+ *
+ * @module agentos/memory/feedback/RetrievalFeedbackSignal
+ */
+import { penalizeUnused, updateOnRetrieval } from '../../core/decay/DecayModel.js';
+import { parseTraceMetadata, readPersistedDecayState, withPersistedDecayState, } from '../../retrieval/store/tracePersistence.js';
+// ---------------------------------------------------------------------------
+// RetrievalFeedbackSignal
+// ---------------------------------------------------------------------------
+/**
+ * Detects which injected memory traces were used vs ignored by the LLM,
+ * persists those signals to the `retrieval_feedback` table, and applies a
+ * best-effort trace-strength update in `memory_traces`.
+ *
+ * **Lifecycle:**
+ * 1. Before generation: retrieve relevant traces and inject them into the prompt.
+ * 2. After response delivery (non-blocking): call `detect(injectedTraces, response)`.
+ * 3. The signal is recorded immediately and the underlying trace is nudged
+ *    toward reinforcement or decay.
+ * 4. The consolidation pipeline can still read `getStats(traceId)` later for
+ *    broader aggregate decisions.
+ */
+export class RetrievalFeedbackSignal {
+    /**
+     * @param brain        - The agent's SQLite brain; used to persist and query feedback rows.
+     * @param similarityFn - Optional semantic similarity function for higher-fidelity detection.
+     *   Receives two strings and returns a promise of a similarity score in [0, 1].
+     *   When provided, the score supplements the keyword heuristic, but the
+     *   current implementation uses the keyword path only (reserved for future use).
+     */
+    constructor(brain, similarityFn) {
+        this.brain = brain;
+        this.similarityFn = similarityFn;
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    /**
+     * Detect which of the injected traces were referenced in `response`, persist
+     * the signals to `retrieval_feedback`, update the corresponding
+     * `memory_traces` rows, and return the full feedback array.
+     *
+     * **Keyword heuristic:**
+     * - Extract all words > 4 characters from each trace's `content` field,
+     *   lowercased and stripped of non-alphanumeric characters.
+     * - Compute `matchRatio = (words found in response) / (unique keywords)`.
+     * - Signal = `'used'` if matchRatio > 0.30, else `'ignored'`.
+     *
+     * When a trace has no qualifying keywords (all words ≤ 4 characters), it is
+     * treated as `'ignored'` — there is nothing to match against.
+     *
+     * @param injectedTraces - Memory traces that were injected into the prompt.
+     * @param response       - The LLM's generated response text.
+     * @param context        - Optional retrieval context, typically the original query.
+     * @returns Array of `RetrievalFeedback` events, one per injected trace.
+     */
+    async detect(injectedTraces, response, context) {
+        const responseLower = response.toLowerCase();
+        const feedbacks = [];
+        const now = Date.now();
+        const insertSql = `INSERT INTO retrieval_feedback (trace_id, signal, query, created_at)
+       VALUES (?, ?, ?, ?)`;
+        const selectTraceSql = `SELECT id, type, scope, content, strength, created_at, last_accessed,
+              retrieval_count, tags, emotions, metadata, deleted
+       FROM memory_traces
+       WHERE id = ?
+       LIMIT 1`;
+        const usedUpdateSql = `UPDATE memory_traces
+       SET strength = ?, last_accessed = ?, retrieval_count = ?, metadata = ?
+       WHERE id = ?`;
+        const ignoredUpdateSql = `UPDATE memory_traces
+       SET strength = ?, last_accessed = ?, metadata = ?
+       WHERE id = ?`;
+        await this.brain.transaction(async (trx) => {
+            for (const trace of injectedTraces) {
+                const keywords = this._extractKeywords(trace.content);
+                let signal = 'ignored';
+                if (keywords.length > 0) {
+                    const matchCount = keywords.filter((kw) => responseLower.includes(kw)).length;
+                    const matchRatio = matchCount / keywords.length;
+                    if (matchRatio > 0.3) {
+                        signal = 'used';
+                    }
+                }
+                await trx.run(insertSql, [trace.id, signal, context ?? null, now]);
+                const row = await trx.get(selectTraceSql, [trace.id]);
+                if (row) {
+                    const persistedTrace = this._buildTrace(row);
+                    if (signal === 'used') {
+                        const update = updateOnRetrieval(persistedTrace, now);
+                        const metadata = JSON.stringify(withPersistedDecayState(parseTraceMetadata(row.metadata), {
+                            stability: update.stability,
+                            accessCount: update.accessCount,
+                            reinforcementInterval: update.reinforcementInterval,
+                            nextReinforcementAt: update.nextReinforcementAt,
+                        }));
+                        await trx.run(usedUpdateSql, [
+                            update.encodingStrength,
+                            update.lastAccessedAt,
+                            update.retrievalCount,
+                            metadata,
+                            trace.id,
+                        ]);
+                    }
+                    else {
+                        const penalty = penalizeUnused(persistedTrace, now);
+                        const existingDecay = readPersistedDecayState(parseTraceMetadata(row.metadata), row.retrieval_count);
+                        const metadata = JSON.stringify(withPersistedDecayState(parseTraceMetadata(row.metadata), {
+                            stability: penalty.stability,
+                            accessCount: existingDecay.accessCount,
+                            reinforcementInterval: existingDecay.reinforcementInterval,
+                            ...(existingDecay.nextReinforcementAt !== undefined
+                                ? { nextReinforcementAt: existingDecay.nextReinforcementAt }
+                                : {}),
+                        }));
+                        await trx.run(ignoredUpdateSql, [
+                            penalty.encodingStrength,
+                            penalty.lastAccessedAt,
+                            metadata,
+                            trace.id,
+                        ]);
+                    }
+                }
+                feedbacks.push({
+                    traceId: trace.id,
+                    signal,
+                    ...(context ? { context } : {}),
+                    timestamp: now,
+                });
+            }
+        });
+        return feedbacks;
+    }
+    /**
+     * Retrieve the feedback history for a single trace, ordered by most-recent
+     * first.
+     *
+     * @param traceId - The memory trace ID to look up.
+     * @param limit   - Maximum number of rows to return.  Defaults to 100.
+     * @returns Array of `RetrievalFeedback` events, most-recent first.
+     */
+    async getHistory(traceId, limit = 100) {
+        const rows = await this.brain.all(`SELECT id, trace_id, signal, query, created_at
+       FROM retrieval_feedback
+       WHERE trace_id = ?
+       ORDER BY created_at DESC, id DESC
+       LIMIT ?`, [traceId, limit]);
+        return rows.map((row) => ({
+            traceId: row.trace_id,
+            signal: row.signal,
+            context: row.query ?? undefined,
+            timestamp: row.created_at,
+        }));
+    }
+    /**
+     * Return aggregate counts of `'used'` and `'ignored'` signals for a trace.
+     *
+     * Useful for the consolidation pipeline to decide whether to apply
+     * `penalizeUnused` (many ignores) or `updateOnRetrieval` (many used).
+     *
+     * @param traceId - The memory trace ID to aggregate.
+     * @returns `{ used, ignored }` counts.
+     */
+    async getStats(traceId) {
+        const rows = await this.brain.all(`SELECT signal, COUNT(*) AS count
+       FROM retrieval_feedback
+       WHERE trace_id = ?
+       GROUP BY signal`, [traceId]);
+        let used = 0;
+        let ignored = 0;
+        for (const row of rows) {
+            if (row.signal === 'used')
+                used = row.count;
+            else if (row.signal === 'ignored')
+                ignored = row.count;
+        }
+        return { used, ignored };
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Extract unique keywords from a text string.
+     *
+     * A keyword is any word that:
+     * - Has more than 4 characters after stripping non-alphanumeric characters.
+     * - Is lowercased.
+     *
+     * Short stop-words (≤ 4 chars) are excluded because they appear in almost
+     * every response and would inflate `matchRatio` without providing signal.
+     *
+     * @param text - The source text (typically a trace's `content` field).
+     * @returns Deduplicated array of lowercase keywords longer than 4 characters.
+     */
+    _extractKeywords(text) {
+        const words = text
+            .toLowerCase()
+            .split(/\s+/)
+            .map((w) => w.replace(/[^a-z0-9]/g, ''))
+            .filter((w) => w.length > 4);
+        // Return deduplicated list using a Set for uniqueness.
+        return [...new Set(words)];
+    }
+    /**
+     * Convert a raw `memory_traces` row into a minimal `MemoryTrace` envelope
+     * suitable for reuse by the decay model.
+     */
+    _buildTrace(row) {
+        const metadata = parseTraceMetadata(row.metadata);
+        let tags = [];
+        let emotions = {};
+        try {
+            const parsed = JSON.parse(row.tags);
+            if (Array.isArray(parsed)) {
+                tags = parsed.filter((tag) => typeof tag === 'string');
+            }
+        }
+        catch {
+            tags = [];
+        }
+        try {
+            emotions = JSON.parse(row.emotions);
+        }
+        catch {
+            emotions = {};
+        }
+        const scopeId = typeof metadata.scopeId === 'string' ? metadata.scopeId : '';
+        const entities = Array.isArray(metadata.entities)
+            ? metadata.entities.filter((entity) => typeof entity === 'string')
+            : [];
+        const decayState = readPersistedDecayState(metadata, row.retrieval_count);
+        return {
+            id: row.id,
+            type: row.type,
+            scope: row.scope,
+            scopeId,
+            content: row.content,
+            entities,
+            tags,
+            provenance: {
+                sourceType: 'user_statement',
+                sourceTimestamp: row.created_at,
+                confidence: 1.0,
+                verificationCount: 0,
+            },
+            emotionalContext: {
+                valence: 0,
+                arousal: 0,
+                dominance: 0,
+                intensity: 0,
+                gmiMood: 'neutral',
+                ...emotions,
+            },
+            encodingStrength: row.strength,
+            stability: decayState.stability,
+            retrievalCount: row.retrieval_count,
+            lastAccessedAt: row.last_accessed ?? row.created_at,
+            accessCount: decayState.accessCount,
+            reinforcementInterval: decayState.reinforcementInterval,
+            ...(decayState.nextReinforcementAt !== undefined
+                ? { nextReinforcementAt: decayState.nextReinforcementAt }
+                : {}),
+            associatedTraceIds: [],
+            createdAt: row.created_at,
+            updatedAt: row.created_at,
+            isActive: row.deleted === 0,
+        };
+    }
+}
+//# sourceMappingURL=RetrievalFeedbackSignal.js.map

package/dist/memory/retrieval/feedback/RetrievalFeedbackSignal.js.map

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

package/dist/memory/retrieval/feedback/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/memory/retrieval/feedback/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/memory/retrieval/feedback/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/memory/retrieval/feedback/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/memory/retrieval/graph/GraphologyMemoryGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphologyMemoryGraph.d.ts","sourceRoot":"","sources":["../../../../src/memory/retrieval/graph/GraphologyMemoryGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,yBAAyB,EACzB,aAAa,EACb,aAAa,EACd,MAAM,mBAAmB,CAAC;AA4B3B,qBAAa,qBAAsB,YAAW,YAAY;IACxD,OAAO,CAAC,KAAK,CAA2B;IAElC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,OAAO,CAAC,WAAW;IAOb,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IASvE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAM5B,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,UAAU,EAAE;IAoBzD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7D,mBAAmB,CACvB,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,CAAC,EAAE,yBAAyB,GACjC,OAAO,CAAC,aAAa,EAAE,CAAC;IAqBrB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BxF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE;IAMtC,cAAc,CAAC,OAAO,GAAE,MAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAuDnE,SAAS,IAAI,MAAM;IAInB,SAAS,IAAI,MAAM;IAInB,KAAK,IAAI,IAAI;IAIP,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}

package/dist/memory/retrieval/graph/GraphologyMemoryGraph.js

@@ -0,0 +1,224 @@
+/**
+ * @fileoverview In-memory graphology-based memory graph (dev/testing).
+ *
+ * Follows the CapabilityGraph pattern: lazy-loaded graphology,
+ * O(1) neighbor lookups, sub-ms traversal for typical memory counts.
+ *
+ * @module agentos/memory/graph/GraphologyMemoryGraph
+ */
+import { spreadActivation } from './SpreadingActivation.js';
+let _GraphCtor;
+async function resolveGraphology() {
+    if (_GraphCtor)
+        return _GraphCtor;
+    try {
+        const mod = await import('../../../index.js');
+        _GraphCtor = (mod.default ?? mod);
+        return _GraphCtor;
+    }
+    catch {
+        throw new Error('graphology is required for GraphologyMemoryGraph but was not found. ' +
+            'Install it: npm install graphology graphology-types');
+    }
+}
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+export class GraphologyMemoryGraph {
+    constructor() {
+        this.graph = null;
+    }
+    async initialize() {
+        const GraphCtor = await resolveGraphology();
+        this.graph = new GraphCtor({ multi: false, type: 'undirected' });
+    }
+    ensureGraph() {
+        if (!this.graph)
+            throw new Error('GraphologyMemoryGraph not initialized.');
+        return this.graph;
+    }
+    // --- Node operations ---
+    async addNode(memoryId, metadata) {
+        const g = this.ensureGraph();
+        if (g.hasNode(memoryId)) {
+            g.replaceNodeAttributes(memoryId, metadata);
+        }
+        else {
+            g.addNode(memoryId, metadata);
+        }
+    }
+    async removeNode(memoryId) {
+        const g = this.ensureGraph();
+        if (g.hasNode(memoryId)) {
+            g.dropNode(memoryId);
+        }
+    }
+    hasNode(memoryId) {
+        return this.graph?.hasNode(memoryId) ?? false;
+    }
+    // --- Edge operations ---
+    async addEdge(edge) {
+        const g = this.ensureGraph();
+        if (!g.hasNode(edge.sourceId) || !g.hasNode(edge.targetId))
+            return;
+        if (edge.sourceId === edge.targetId)
+            return;
+        try {
+            const existing = g.edge(edge.sourceId, edge.targetId);
+            if (existing) {
+                const attrs = g.getEdgeAttributes(existing);
+                if (edge.weight > attrs.weight) {
+                    g.setEdgeAttribute(existing, 'weight', edge.weight);
+                    g.setEdgeAttribute(existing, 'type', edge.type);
+                }
+            }
+            else {
+                g.addEdge(edge.sourceId, edge.targetId, {
+                    type: edge.type,
+                    weight: edge.weight,
+                    createdAt: edge.createdAt,
+                });
+            }
+        }
+        catch {
+            // Edge already exists in other direction (undirected)
+        }
+    }
+    getEdges(memoryId, type) {
+        const g = this.ensureGraph();
+        if (!g.hasNode(memoryId))
+            return [];
+        const edges = [];
+        g.forEachEdge(memoryId, (_edge, attrs, source, target) => {
+            const edgeType = attrs.type;
+            if (!type || edgeType === type) {
+                edges.push({
+                    sourceId: source,
+                    targetId: target,
+                    type: edgeType,
+                    weight: attrs.weight,
+                    createdAt: attrs.createdAt,
+                });
+            }
+        });
+        return edges;
+    }
+    async removeEdge(sourceId, targetId) {
+        const g = this.ensureGraph();
+        try {
+            const edge = g.edge(sourceId, targetId);
+            if (edge)
+                g.dropEdge(edge);
+        }
+        catch { /* no-op */ }
+    }
+    // --- Spreading activation ---
+    async spreadingActivation(seedIds, config) {
+        const g = this.ensureGraph();
+        // Delegate to pure-function implementation
+        return spreadActivation({
+            seedIds,
+            getNeighbors: (nodeId) => {
+                if (!g.hasNode(nodeId))
+                    return [];
+                const neighbors = [];
+                g.forEachEdge(nodeId, (_edge, attrs, source, target) => {
+                    const neighborId = source === nodeId ? target : source;
+                    neighbors.push({ id: neighborId, weight: attrs.weight });
+                });
+                return neighbors;
+            },
+            config,
+        });
+    }
+    // --- Co-activation (Hebbian learning) ---
+    async recordCoActivation(memoryIds, learningRate = 0.1) {
+        const g = this.ensureGraph();
+        const validIds = memoryIds.filter((id) => g.hasNode(id));
+        const now = Date.now();
+        for (let i = 0; i < validIds.length; i++) {
+            for (let j = i + 1; j < validIds.length; j++) {
+                try {
+                    const existing = g.edge(validIds[i], validIds[j]);
+                    if (existing) {
+                        const attrs = g.getEdgeAttributes(existing);
+                        // Hebbian: strengthen existing connection
+                        g.setEdgeAttribute(existing, 'weight', Math.min(1.0, attrs.weight + learningRate));
+                    }
+                    else {
+                        g.addEdge(validIds[i], validIds[j], {
+                            type: 'CO_ACTIVATED',
+                            weight: learningRate,
+                            createdAt: now,
+                        });
+                    }
+                }
+                catch { /* edge already exists */ }
+            }
+        }
+    }
+    // --- Conflict detection ---
+    getConflicts(memoryId) {
+        return this.getEdges(memoryId, 'CONTRADICTS');
+    }
+    // --- Clustering ---
+    async detectClusters(minSize = 3) {
+        const g = this.ensureGraph();
+        if (g.order < minSize)
+            return [];
+        // Simple connected-component clustering (upgrade to Louvain when graphology-communities is available)
+        const visited = new Set();
+        const clusters = [];
+        let clusterIdx = 0;
+        g.forEachNode((nodeId) => {
+            if (visited.has(nodeId))
+                return;
+            // BFS from this node
+            const component = [];
+            const queue = [nodeId];
+            visited.add(nodeId);
+            while (queue.length > 0) {
+                const current = queue.shift();
+                component.push(current);
+                g.forEachEdge(current, (_edge, _attrs, source, target) => {
+                    const neighbor = source === current ? target : source;
+                    if (!visited.has(neighbor)) {
+                        visited.add(neighbor);
+                        queue.push(neighbor);
+                    }
+                });
+            }
+            if (component.length >= minSize) {
+                // Density = actual edges / possible edges
+                let edgeCount = 0;
+                for (const id of component) {
+                    const nodeEdges = this.getEdges(id);
+                    edgeCount += nodeEdges.filter((e) => component.includes(e.sourceId === id ? e.targetId : e.sourceId)).length;
+                }
+                edgeCount /= 2; // undirected
+                const possibleEdges = (component.length * (component.length - 1)) / 2;
+                clusters.push({
+                    clusterId: `cluster_${clusterIdx++}`,
+                    memberIds: component,
+                    density: possibleEdges > 0 ? edgeCount / possibleEdges : 0,
+                });
+            }
+        });
+        return clusters;
+    }
+    // --- Lifecycle ---
+    nodeCount() {
+        return this.graph?.order ?? 0;
+    }
+    edgeCount() {
+        return this.graph?.size ?? 0;
+    }
+    clear() {
+        this.graph?.clear();
+    }
+    async shutdown() {
+        this.graph?.clear();
+        this.graph = null;
+    }
+}
+//# sourceMappingURL=GraphologyMemoryGraph.js.map

package/dist/memory/retrieval/graph/GraphologyMemoryGraph.js.map

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

package/dist/memory/retrieval/graph/IMemoryGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMemoryGraph.d.ts","sourceRoot":"","sources":["../../../../src/memory/retrieval/graph/IMemoryGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,mBAAmB,GACnB,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,WAAW,GACX,cAAc,GACd,iBAAiB,CAAC;AAEtB,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAMD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAG5B,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAGnC,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,UAAU,EAAE,CAAC;IAChE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG9D,mBAAmB,CACjB,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,CAAC,EAAE,yBAAyB,GACjC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAG5B,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG9E,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IAG7C,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAG3D,SAAS,IAAI,MAAM,CAAC;IACpB,SAAS,IAAI,MAAM,CAAC;IACpB,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/memory/retrieval/graph/IMemoryGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMemoryGraph.js","sourceRoot":"","sources":["../../../../src/memory/retrieval/graph/IMemoryGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/memory/retrieval/graph/KnowledgeGraphMemoryGraph.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Production memory graph backend wrapping IKnowledgeGraph.
+ *
+ * Maps memory graph operations to the existing IKnowledgeGraph interface:
+ * - Nodes = KnowledgeEntity of type 'memory'
+ * - Edges = KnowledgeRelation with memory-specific labels
+ * - Uses traverse() and getNeighborhood() for spreading activation
+ * - Leverages existing Neo4j backend at scale
+ *
+ * @module agentos/memory/graph/KnowledgeGraphMemoryGraph
+ */
+import type { IKnowledgeGraph } from '../../retrieval/graph/knowledge/IKnowledgeGraph.js';
+import type { IMemoryGraph, MemoryGraphNodeMeta, MemoryEdge, MemoryEdgeType, SpreadingActivationConfig, ActivatedNode, MemoryCluster } from './IMemoryGraph.js';
+export declare class KnowledgeGraphMemoryGraph implements IMemoryGraph {
+    private readonly kg;
+    /** In-memory cache of node IDs for hasNode() (sync requirement). */
+    private nodeCache;
+    /** In-memory edge cache for sync getEdges(). */
+    private edgeCache;
+    constructor(kg: IKnowledgeGraph);
+    initialize(): Promise<void>;
+    addNode(memoryId: string, metadata: MemoryGraphNodeMeta): Promise<void>;
+    removeNode(memoryId: string): Promise<void>;
+    hasNode(memoryId: string): boolean;
+    addEdge(edge: MemoryEdge): Promise<void>;
+    getEdges(memoryId: string, type?: MemoryEdgeType): MemoryEdge[];
+    removeEdge(sourceId: string, targetId: string): Promise<void>;
+    spreadingActivation(seedIds: string[], config?: SpreadingActivationConfig): Promise<ActivatedNode[]>;
+    recordCoActivation(memoryIds: string[], learningRate?: number): Promise<void>;
+    getConflicts(memoryId: string): MemoryEdge[];
+    detectClusters(minSize?: number): Promise<MemoryCluster[]>;
+    nodeCount(): number;
+    edgeCount(): number;
+    clear(): void;
+    shutdown(): Promise<void>;
+    private cacheEdge;
+}
+//# sourceMappingURL=KnowledgeGraphMemoryGraph.d.ts.map

package/dist/memory/retrieval/graph/KnowledgeGraphMemoryGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeGraphMemoryGraph.d.ts","sourceRoot":"","sources":["../../../../src/memory/retrieval/graph/KnowledgeGraphMemoryGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAsC,MAAM,oDAAoD,CAAC;AAC9H,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,yBAAyB,EACzB,aAAa,EACb,aAAa,EACd,MAAM,mBAAmB,CAAC;AAqC3B,qBAAa,yBAA0B,YAAW,YAAY;IAMhD,OAAO,CAAC,QAAQ,CAAC,EAAE;IAL/B,oEAAoE;IACpE,OAAO,CAAC,SAAS,CAAqB;IACtC,gDAAgD;IAChD,OAAO,CAAC,SAAS,CAAmC;gBAEvB,EAAE,EAAE,eAAe;IAE1C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAM5B,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,UAAU,EAAE;IAMzD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB7D,mBAAmB,CACvB,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,CAAC,EAAE,yBAAyB,GACjC,OAAO,CAAC,aAAa,EAAE,CAAC;IAyBrB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BxF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE;IAMtC,cAAc,CAAC,OAAO,GAAE,MAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA8CnE,SAAS,IAAI,MAAM;IAInB,SAAS,IAAI,MAAM;IAQnB,KAAK,IAAI,IAAI;IAKP,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B,OAAO,CAAC,SAAS;CAclB"}

package/dist/memory/retrieval/graph/KnowledgeGraphMemoryGraph.js.map

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

package/dist/memory/retrieval/graph/SpreadingActivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpreadingActivation.d.ts","sourceRoot":"","sources":["../../../../src/memory/retrieval/graph/SpreadingActivation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAMlF,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACzH,MAAM,CAAC,EAAE,yBAAyB,CAAC;CACpC;AAiBD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAuEhG"}

package/dist/memory/retrieval/graph/SpreadingActivation.js.map

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