@openweave/weave-graph 0.2.0 → 0.2.1

package/dist/cjs/index.js

@@ -0,0 +1,417 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HebbianWeights = exports.cosineSimilarity = exports.jaccardSimilarity = exports.tokenize = exports.SynapticEngine = exports.ErrorSuppression = exports.CompressionManager = exports.EdgeBuilder = exports.NodeBuilder = exports.PersistenceManager = exports.EdgeType = exports.NodeType = exports.ContextGraphManager = void 0;
+const types_1 = require("./types");
+const node_1 = require("./node");
+const edge_1 = require("./edge");
+const compression_1 = require("./compression");
+/**
+ * ContextGraphManager
+ * Main interface for managing the WeaveGraph
+ * Handles node/edge operations, queries, and persistence metadata
+ */
+class ContextGraphManager {
+    nodes;
+    edges;
+    edgesBySource; // sourceId -> Set<edgeId>
+    edgesByTarget; // targetId -> Set<edgeId>
+    nodesByLabel; // label (lowercased) -> Set<nodeId>
+    chatId;
+    compressionThreshold = 0.75;
+    version = "0.1.0";
+    createdAt;
+    updatedAt;
+    synapticEngine;
+    hebbianWeights;
+    constructor(chatId, compressionThreshold) {
+        this.chatId = chatId;
+        this.nodes = new Map();
+        this.edges = new Map();
+        this.edgesBySource = new Map();
+        this.edgesByTarget = new Map();
+        this.nodesByLabel = new Map();
+        this.createdAt = new Date();
+        this.updatedAt = new Date();
+        if (compressionThreshold !== undefined) {
+            this.compressionThreshold = compressionThreshold;
+        }
+    }
+    /**
+     * Attach a SynapticEngine to this graph. Once set, every subsequent
+     * `addNode()` call will automatically trigger retroactive linking.
+     */
+    setSynapticEngine(engine) {
+        this.synapticEngine = engine;
+    }
+    /**
+     * Attach a HebbianWeights instance to this graph. Once set,
+     * `queryNodesByLabel()` and `queryNodesByType()` will automatically
+     * strengthen edges between co-activated result nodes.
+     */
+    setHebbianWeights(hw) {
+        this.hebbianWeights = hw;
+    }
+    /**
+     * Add a node to the graph.
+     * If a SynapticEngine is attached, retroactive linking is performed
+     * immediately after the node is indexed.
+     */
+    addNode(node) {
+        this.nodes.set(node.id, node);
+        // Index by label for keyword search
+        const labelKey = node.label.toLowerCase();
+        if (!this.nodesByLabel.has(labelKey)) {
+            this.nodesByLabel.set(labelKey, new Set());
+        }
+        this.nodesByLabel.get(labelKey).add(node.id);
+        this.updatedAt = new Date();
+        // Retroactive linking — fires only when a SynapticEngine is attached
+        if (this.synapticEngine) {
+            this.synapticEngine.linkRetroactively(node, this);
+        }
+        return node;
+    }
+    /**
+     * Add a node to the graph and run embedding-based retroactive linking
+     * (async). If the attached SynapticEngine has an `embeddingService`,
+     * cosine similarity is used instead of Jaccard keyword overlap.
+     *
+     * If no SynapticEngine is attached, behaves identically to `addNode()`.
+     * If a SynapticEngine is attached but has no embedding service, the
+     * keyword-based path runs (same as `addNode()`).
+     *
+     * @returns The added node.
+     */
+    async addNodeAsync(node) {
+        this.nodes.set(node.id, node);
+        // Index by label
+        const labelKey = node.label.toLowerCase();
+        if (!this.nodesByLabel.has(labelKey)) {
+            this.nodesByLabel.set(labelKey, new Set());
+        }
+        this.nodesByLabel.get(labelKey).add(node.id);
+        this.updatedAt = new Date();
+        // Embedding-based retroactive linking (falls back to keyword if no embeddings)
+        if (this.synapticEngine) {
+            await this.synapticEngine.linkRetroactivelyEmbedding(node, this);
+        }
+        return node;
+    }
+    /**
+     * Get a node by ID
+     */
+    getNode(nodeId) {
+        return this.nodes.get(nodeId);
+    }
+    /**
+     * Update an existing node
+     */
+    updateNode(nodeId, updates) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return undefined;
+        const updated = node_1.NodeBuilder.clone(node, updates);
+        this.nodes.set(nodeId, updated);
+        this.updatedAt = new Date();
+        return updated;
+    }
+    /**
+     * Delete a node (and all related edges)
+     */
+    deleteNode(nodeId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return false;
+        // Remove label index
+        const labelKey = node.label.toLowerCase();
+        const labelSet = this.nodesByLabel.get(labelKey);
+        if (labelSet) {
+            labelSet.delete(nodeId);
+            if (labelSet.size === 0) {
+                this.nodesByLabel.delete(labelKey);
+            }
+        }
+        // Remove all connected edges
+        const sourceEdges = this.edgesBySource.get(nodeId) || new Set();
+        const targetEdges = this.edgesByTarget.get(nodeId) || new Set();
+        [...sourceEdges, ...targetEdges].forEach((edgeId) => {
+            this.edges.delete(edgeId);
+        });
+        this.edgesBySource.delete(nodeId);
+        this.edgesByTarget.delete(nodeId);
+        this.nodes.delete(nodeId);
+        this.updatedAt = new Date();
+        return true;
+    }
+    /**
+     * Add an edge to the graph
+     */
+    addEdge(edge) {
+        this.edges.set(edge.id, edge);
+        // Index by source and target
+        if (!this.edgesBySource.has(edge.sourceId)) {
+            this.edgesBySource.set(edge.sourceId, new Set());
+        }
+        this.edgesBySource.get(edge.sourceId).add(edge.id);
+        if (!this.edgesByTarget.has(edge.targetId)) {
+            this.edgesByTarget.set(edge.targetId, new Set());
+        }
+        this.edgesByTarget.get(edge.targetId).add(edge.id);
+        this.updatedAt = new Date();
+        return edge;
+    }
+    /**
+     * Get an edge by ID
+     */
+    getEdge(edgeId) {
+        return this.edges.get(edgeId);
+    }
+    /**
+     * Update an existing edge
+     */
+    updateEdge(edgeId, updates) {
+        const edge = this.edges.get(edgeId);
+        if (!edge)
+            return undefined;
+        const updated = edge_1.EdgeBuilder.clone(edge, updates);
+        this.edges.set(edgeId, updated);
+        this.updatedAt = new Date();
+        return updated;
+    }
+    /**
+     * Delete an edge
+     */
+    deleteEdge(edgeId) {
+        const edge = this.edges.get(edgeId);
+        if (!edge)
+            return false;
+        this.edgesBySource.get(edge.sourceId)?.delete(edgeId);
+        this.edgesByTarget.get(edge.targetId)?.delete(edgeId);
+        this.edges.delete(edgeId);
+        this.updatedAt = new Date();
+        return true;
+    }
+    /**
+     * Get all edges from a source node
+     */
+    getEdgesFromNode(nodeId) {
+        const edgeIds = this.edgesBySource.get(nodeId) || new Set();
+        return Array.from(edgeIds)
+            .map((id) => this.edges.get(id))
+            .filter((edge) => edge !== undefined);
+    }
+    /**
+     * Get all edges to a target node
+     */
+    getEdgesToNode(nodeId) {
+        const edgeIds = this.edgesByTarget.get(nodeId) || new Set();
+        return Array.from(edgeIds)
+            .map((id) => this.edges.get(id))
+            .filter((edge) => edge !== undefined);
+    }
+    /**
+     * Query nodes by label (keyword search)
+     * Returns nodes where the label contains the query string
+     */
+    queryNodesByLabel(query) {
+        const lowerQuery = query.toLowerCase();
+        const results = [];
+        for (const [label, nodeIds] of this.nodesByLabel.entries()) {
+            if (label.includes(lowerQuery)) {
+                nodeIds.forEach((nodeId) => {
+                    const node = this.nodes.get(nodeId);
+                    if (node)
+                        results.push(node);
+                });
+            }
+        }
+        const sorted = results.sort((a, b) => (b.frequency ?? 0) - (a.frequency ?? 0));
+        // Hebbian strengthening — reinforce edges between co-activated nodes
+        if (this.hebbianWeights && sorted.length >= 2) {
+            this.hebbianWeights.strengthenCoActivated(sorted.map((n) => n.id), this);
+        }
+        return sorted;
+    }
+    /**
+     * Query nodes by type
+     */
+    queryNodesByType(type) {
+        const results = Array.from(this.nodes.values()).filter((node) => node.type === type);
+        // Hebbian strengthening — reinforce edges between co-activated nodes
+        if (this.hebbianWeights && results.length >= 2) {
+            this.hebbianWeights.strengthenCoActivated(results.map((n) => n.id), this);
+        }
+        return results;
+    }
+    /**
+     * Query edges by type
+     */
+    queryEdgesByType(type) {
+        return Array.from(this.edges.values()).filter((edge) => edge.type === type);
+    }
+    /**
+     * Get graph statistics
+     */
+    getStats() {
+        const nodesByType = new Map();
+        const edgesByType = new Map();
+        for (const node of this.nodes.values()) {
+            nodesByType.set(node.type, (nodesByType.get(node.type) ?? 0) + 1);
+        }
+        for (const edge of this.edges.values()) {
+            edgesByType.set(edge.type, (edgesByType.get(edge.type) ?? 0) + 1);
+        }
+        return {
+            totalNodes: this.nodes.size,
+            totalEdges: this.edges.size,
+            nodesByType: Object.fromEntries(nodesByType),
+            edgesByType: Object.fromEntries(edgesByType),
+            chatId: this.chatId,
+            createdAt: this.createdAt,
+            updatedAt: this.updatedAt,
+        };
+    }
+    /**
+     * Snapshot the graph for serialization
+     */
+    snapshot() {
+        return {
+            nodes: Object.fromEntries(this.nodes),
+            edges: Object.fromEntries(this.edges),
+            metadata: {
+                chatId: this.chatId,
+                version: this.version,
+                createdAt: this.createdAt,
+                updatedAt: this.updatedAt,
+                compressionThreshold: this.compressionThreshold,
+            },
+        };
+    }
+    /**
+     * Restore graph from snapshot
+     */
+    static fromSnapshot(snapshot) {
+        const manager = new ContextGraphManager(snapshot.metadata.chatId, snapshot.metadata.compressionThreshold);
+        Object.values(snapshot.nodes).forEach((node) => {
+            manager.addNode(node);
+        });
+        Object.values(snapshot.edges).forEach((edge) => {
+            manager.addEdge(edge);
+        });
+        manager.createdAt = snapshot.metadata.createdAt;
+        manager.updatedAt = snapshot.metadata.updatedAt;
+        return manager;
+    }
+    /**
+     * Get the current window size percentage
+     * Calculates actual context window usage based on node and edge sizes
+     */
+    getContextWindowUsage() {
+        const contextSize = compression_1.CompressionManager.calculateContextSize(this.getAllNodes(), this.getAllEdges());
+        return compression_1.CompressionManager.calculateContextUsagePercentage(contextSize);
+    }
+    /**
+     * Get estimated context size in bytes
+     */
+    getContextSize() {
+        return compression_1.CompressionManager.calculateContextSize(this.getAllNodes(), this.getAllEdges());
+    }
+    /**
+     * Check if compression threshold has been reached
+     */
+    shouldCompress() {
+        return this.getContextWindowUsage() >= this.compressionThreshold;
+    }
+    /**
+     * Compress the graph by archiving low-frequency nodes
+     * Returns compression statistics
+     */
+    compress(targetReductionPercentage = 0.3) {
+        const archiveCandidates = compression_1.CompressionManager.identifyArchiveCandidates(this.getAllNodes(), this.getAllEdges(), targetReductionPercentage);
+        const compressionMgr = new compression_1.CompressionManager();
+        compressionMgr.archiveNodes(archiveCandidates, this.nodes, this.edges);
+        // Remove archived nodes from active graph
+        for (const nodeId of archiveCandidates) {
+            this.deleteNode(nodeId);
+        }
+        return {
+            archivedNodeCount: archiveCandidates.length,
+            archiveStats: compressionMgr.getArchiveStats(),
+            newContextSize: this.getContextSize(),
+            contextUsagePercentage: this.getContextWindowUsage(),
+        };
+    }
+    /**
+     * Suppress an error node and create a correction
+     */
+    suppressError(errorNodeId, correctionLabel, correctionDescription) {
+        const errorNode = this.getNode(errorNodeId);
+        if (!errorNode || errorNode.type !== types_1.NodeType.ERROR) {
+            throw new Error("Node must be an ERROR type to suppress it");
+        }
+        // Mark error as suppressed
+        const suppressedError = compression_1.ErrorSuppression.suppressNode(errorNode);
+        this.updateNode(errorNodeId, suppressedError);
+        // Create correction node and link it
+        const { correctionNode, correctionEdge } = compression_1.ErrorSuppression.createCorrection(errorNodeId, correctionLabel, correctionDescription);
+        this.addNode(correctionNode);
+        this.addEdge(correctionEdge);
+        return { correctionNode, correctionEdge };
+    }
+    /**
+     * Get all error nodes that have been corrected
+     */
+    getCorrectedErrors() {
+        return compression_1.ErrorSuppression.findCorrectedErrors(this.nodes, this.edges);
+    }
+    /**
+     * Get all error nodes that haven't been corrected yet
+     */
+    getUncorrectedErrors() {
+        return compression_1.ErrorSuppression.findUncorrectedErrors(this.nodes, this.edges);
+    }
+    /**
+     * Get all nodes
+     */
+    getAllNodes() {
+        return Array.from(this.nodes.values());
+    }
+    /**
+     * Get all edges
+     */
+    getAllEdges() {
+        return Array.from(this.edges.values());
+    }
+    /**
+     * Clear the entire graph
+     */
+    clear() {
+        this.nodes.clear();
+        this.edges.clear();
+        this.edgesBySource.clear();
+        this.edgesByTarget.clear();
+        this.nodesByLabel.clear();
+        this.updatedAt = new Date();
+    }
+}
+exports.ContextGraphManager = ContextGraphManager;
+var types_2 = require("./types");
+Object.defineProperty(exports, "NodeType", { enumerable: true, get: function () { return types_2.NodeType; } });
+Object.defineProperty(exports, "EdgeType", { enumerable: true, get: function () { return types_2.EdgeType; } });
+var persistence_1 = require("./persistence");
+Object.defineProperty(exports, "PersistenceManager", { enumerable: true, get: function () { return persistence_1.PersistenceManager; } });
+var node_2 = require("./node");
+Object.defineProperty(exports, "NodeBuilder", { enumerable: true, get: function () { return node_2.NodeBuilder; } });
+var edge_2 = require("./edge");
+Object.defineProperty(exports, "EdgeBuilder", { enumerable: true, get: function () { return edge_2.EdgeBuilder; } });
+var compression_2 = require("./compression");
+Object.defineProperty(exports, "CompressionManager", { enumerable: true, get: function () { return compression_2.CompressionManager; } });
+Object.defineProperty(exports, "ErrorSuppression", { enumerable: true, get: function () { return compression_2.ErrorSuppression; } });
+var synaptic_engine_1 = require("./synaptic-engine");
+Object.defineProperty(exports, "SynapticEngine", { enumerable: true, get: function () { return synaptic_engine_1.SynapticEngine; } });
+Object.defineProperty(exports, "tokenize", { enumerable: true, get: function () { return synaptic_engine_1.tokenize; } });
+Object.defineProperty(exports, "jaccardSimilarity", { enumerable: true, get: function () { return synaptic_engine_1.jaccardSimilarity; } });
+Object.defineProperty(exports, "cosineSimilarity", { enumerable: true, get: function () { return synaptic_engine_1.cosineSimilarity; } });
+var hebbian_weights_1 = require("./hebbian-weights");
+Object.defineProperty(exports, "HebbianWeights", { enumerable: true, get: function () { return hebbian_weights_1.HebbianWeights; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

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

package/dist/cjs/node.d.ts

@@ -0,0 +1,43 @@
+import { Node, NodeType } from "./types";
+/**
+ * NodeBuilder utility for creating and managing graph nodes
+ */
+export declare class NodeBuilder {
+    /**
+     * Create a new node with the given type and label
+     */
+    static create(type: NodeType, label: string, description?: string, metadata?: Record<string, unknown>): Node;
+    /**
+     * Create a CONCEPT node
+     */
+    static concept(label: string, description?: string): Node;
+    /**
+     * Create a DECISION node
+     */
+    static decision(label: string, description?: string): Node;
+    /**
+     * Create a MILESTONE node
+     */
+    static milestone(label: string, description?: string): Node;
+    /**
+     * Create an ERROR node
+     */
+    static error(label: string, description?: string): Node;
+    /**
+     * Create a CORRECTION node
+     */
+    static correction(label: string, description?: string): Node;
+    /**
+     * Create a CODE_ENTITY node
+     */
+    static codeEntity(label: string, description?: string): Node;
+    /**
+     * Clone a node with updated values
+     */
+    static clone(node: Node, updates?: Partial<Node>): Node;
+    /**
+     * Increment frequency counter for a node
+     */
+    static incrementFrequency(node: Node): Node;
+}
+//# sourceMappingURL=node.d.ts.map

package/dist/cjs/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGzC;;GAEG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAaP;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAIzD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAI1D;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3D;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5D;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5D;;OAEG;IACH,MAAM,CAAC,KAAK,CACV,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GACtB,IAAI;IAQP;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CAO5C"}

package/dist/cjs/node.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeBuilder = void 0;
+const types_1 = require("./types");
+const crypto_1 = require("crypto");
+/**
+ * NodeBuilder utility for creating and managing graph nodes
+ */
+class NodeBuilder {
+    /**
+     * Create a new node with the given type and label
+     */
+    static create(type, label, description, metadata) {
+        return {
+            id: (0, crypto_1.randomUUID)(),
+            type,
+            label,
+            description,
+            metadata: metadata ?? {},
+            createdAt: new Date(),
+            updatedAt: new Date(),
+            frequency: 1,
+        };
+    }
+    /**
+     * Create a CONCEPT node
+     */
+    static concept(label, description) {
+        return this.create(types_1.NodeType.CONCEPT, label, description);
+    }
+    /**
+     * Create a DECISION node
+     */
+    static decision(label, description) {
+        return this.create(types_1.NodeType.DECISION, label, description);
+    }
+    /**
+     * Create a MILESTONE node
+     */
+    static milestone(label, description) {
+        return this.create(types_1.NodeType.MILESTONE, label, description);
+    }
+    /**
+     * Create an ERROR node
+     */
+    static error(label, description) {
+        return this.create(types_1.NodeType.ERROR, label, description);
+    }
+    /**
+     * Create a CORRECTION node
+     */
+    static correction(label, description) {
+        return this.create(types_1.NodeType.CORRECTION, label, description);
+    }
+    /**
+     * Create a CODE_ENTITY node
+     */
+    static codeEntity(label, description) {
+        return this.create(types_1.NodeType.CODE_ENTITY, label, description);
+    }
+    /**
+     * Clone a node with updated values
+     */
+    static clone(node, updates) {
+        return {
+            ...node,
+            updatedAt: new Date(),
+            ...updates,
+        };
+    }
+    /**
+     * Increment frequency counter for a node
+     */
+    static incrementFrequency(node) {
+        return {
+            ...node,
+            frequency: (node.frequency ?? 1) + 1,
+            updatedAt: new Date(),
+        };
+    }
+}
+exports.NodeBuilder = NodeBuilder;
+//# sourceMappingURL=node.js.map

package/dist/cjs/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/node.ts"],"names":[],"mappings":";;;AAAA,mCAAyC;AACzC,mCAAoC;AAEpC;;GAEG;AACH,MAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,IAAc,EACd,KAAa,EACb,WAAoB,EACpB,QAAkC;QAElC,OAAO;YACL,EAAE,EAAE,IAAA,mBAAU,GAAE;YAChB,IAAI;YACJ,KAAK;YACL,WAAW;YACX,QAAQ,EAAE,QAAQ,IAAI,EAAE;YACxB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAa,EAAE,WAAoB;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAa,EAAE,WAAoB;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,KAAa,EAAE,WAAoB;QAClD,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAQ,CAAC,SAAS,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAa,EAAE,WAAoB;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,KAAa,EAAE,WAAoB;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,KAAa,EAAE,WAAoB;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAQ,CAAC,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CACV,IAAU,EACV,OAAuB;QAEvB,OAAO;YACL,GAAG,IAAI;YACP,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAU;QAClC,OAAO;YACL,GAAG,IAAI;YACP,SAAS,EAAE,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC;YACpC,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;CACF;AAxFD,kCAwFC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/persistence.d.ts

@@ -0,0 +1,86 @@
+import { IWeaveProvider } from "@openweave/weave-provider";
+import { ContextGraphManager } from "./index";
+import { GraphSnapshot } from "./types";
+type SerializedSnapshot = Record<string, unknown>;
+/**
+ * PersistenceManager
+ *
+ * Handles saving and loading graph snapshots through a pluggable
+ * IWeaveProvider. If no provider is injected, it falls back to the
+ * built-in JsonProvider (same behaviour as before, backward-compatible).
+ *
+ * Key convention: `graph:<chatId>` — namespaced so multiple subsystems can
+ * share a single provider without key collisions.
+ */
+export declare class PersistenceManager {
+    /** Kept for backward-compat (`getDataDir` / `setDataDir` / constructor). */
+    private dataDir;
+    private provider;
+    /**
+     * @param dataDir  Root directory used by the default JsonProvider.
+     *                 Ignored when an explicit `provider` is supplied.
+     * @param provider Optional storage provider. Defaults to `JsonProvider(dataDir)`.
+     */
+    constructor(dataDir?: string, provider?: IWeaveProvider<SerializedSnapshot>);
+    private graphKey;
+    /**
+     * Serialize a GraphSnapshot to a plain object (dates → ISO strings).
+     */
+    private serialize;
+    /**
+     * Deserialize a plain object back to a GraphSnapshot (ISO strings → dates).
+     */
+    private deserialize;
+    /**
+     * Ensure the data directory exists.
+     * Delegates to the OS mkdir so callers that relied on the old
+     * PersistenceManager behaviour continue to work unchanged.
+     */
+    ensureDataDir(): Promise<void>;
+    /**
+     * Save a graph snapshot via the configured provider.
+     */
+    saveGraph(snapshot: GraphSnapshot): Promise<void>;
+    /**
+     * Load a graph snapshot from the configured provider.
+     * Returns `null` if the snapshot does not exist.
+     */
+    loadGraph(chatId: string): Promise<GraphSnapshot | null>;
+    /**
+     * Load or create a graph manager for a chat session.
+     */
+    loadOrCreateGraph(chatId: string, compressionThreshold?: number): Promise<ContextGraphManager>;
+    /**
+     * Check whether a graph exists in the provider.
+     */
+    graphExists(chatId: string): Promise<boolean>;
+    /**
+     * Delete a graph from the provider. No-op if it does not exist.
+     */
+    deleteGraph(chatId: string): Promise<void>;
+    /**
+     * List all saved chat sessions by querying the `graph:` namespace.
+     */
+    listSessions(): Promise<Array<{
+        chatId: string;
+        createdAt: Date;
+        updatedAt: Date;
+        nodeCount: number;
+        edgeCount: number;
+    }>>;
+    /**
+     * Swap in a different provider at runtime (e.g. after migration).
+     */
+    setProvider(provider: IWeaveProvider<SerializedSnapshot>): void;
+    /** Returns the active provider (useful for tests / diagnostics). */
+    getProvider(): IWeaveProvider<SerializedSnapshot>;
+    /**
+     * Change the data directory used by the default JsonProvider.
+     * Has no effect when an external provider was injected.
+     */
+    setDataDir(newDataDir: string): void;
+    /** Returns the configured data directory. */
+    getDataDir(): string;
+}
+export {};
+//# sourceMappingURL=persistence.d.ts.map

package/dist/cjs/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAgB,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAElD;;;;;;;;;GASG;AACH,qBAAa,kBAAkB;IAC7B,4EAA4E;IAC5E,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAqC;IAErD;;;;OAIG;gBAED,OAAO,GAAE,MAAuB,EAChC,QAAQ,CAAC,EAAE,cAAc,CAAC,kBAAkB,CAAC;IAQ/C,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,SAAS;IA+BjB;;OAEG;IAEH,OAAO,CAAC,WAAW;IA2BnB;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpC;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAM9D;;OAEG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,oBAAoB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAM/B;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;IACG,YAAY,IAAI,OAAO,CAC3B,KAAK,CAAC;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,IAAI,CAAC;QAChB,SAAS,EAAE,IAAI,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CACH;IAmBD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAI/D,oEAAoE;IACpE,WAAW,IAAI,cAAc,CAAC,kBAAkB,CAAC;IAIjD;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOpC,6CAA6C;IAC7C,UAAU,IAAI,MAAM;CAGrB"}