@openweave/weave-graph 0.2.0

package/dist/node.js

@@ -0,0 +1,79 @@
+import { NodeType } from "./types";
+import { randomUUID } from "crypto";
+/**
+ * NodeBuilder utility for creating and managing graph nodes
+ */
+export class NodeBuilder {
+    /**
+     * Create a new node with the given type and label
+     */
+    static create(type, label, description, metadata) {
+        return {
+            id: 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(NodeType.CONCEPT, label, description);
+    }
+    /**
+     * Create a DECISION node
+     */
+    static decision(label, description) {
+        return this.create(NodeType.DECISION, label, description);
+    }
+    /**
+     * Create a MILESTONE node
+     */
+    static milestone(label, description) {
+        return this.create(NodeType.MILESTONE, label, description);
+    }
+    /**
+     * Create an ERROR node
+     */
+    static error(label, description) {
+        return this.create(NodeType.ERROR, label, description);
+    }
+    /**
+     * Create a CORRECTION node
+     */
+    static correction(label, description) {
+        return this.create(NodeType.CORRECTION, label, description);
+    }
+    /**
+     * Create a CODE_ENTITY node
+     */
+    static codeEntity(label, description) {
+        return this.create(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(),
+        };
+    }
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,QAAQ,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;GAEG;AACH,MAAM,OAAO,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,IAAc,EACd,KAAa,EACb,WAAoB,EACpB,QAAkC;QAElC,OAAO;YACL,EAAE,EAAE,UAAU,EAAE;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,QAAQ,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,QAAQ,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,QAAQ,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,QAAQ,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,QAAQ,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,QAAQ,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"}

package/dist/persistence.d.ts

@@ -0,0 +1,58 @@
+import { ContextGraphManager } from "./index";
+import { GraphSnapshot } from "./types";
+/**
+ * PersistenceManager
+ * Handles saving and loading graph snapshots to/from disk
+ * Organizes files by chat_id in a configurable data directory
+ */
+export declare class PersistenceManager {
+    private dataDir;
+    constructor(dataDir?: string);
+    /**
+     * Get the file path for a given chat_id
+     */
+    private getFilePath;
+    /**
+     * Ensure the data directory exists
+     */
+    ensureDataDir(): Promise<void>;
+    /**
+     * Save a graph snapshot to disk
+     */
+    saveGraph(snapshot: GraphSnapshot): Promise<void>;
+    /**
+     * Load a graph snapshot from disk
+     */
+    loadGraph(chatId: string): Promise<GraphSnapshot | null>;
+    /**
+     * Load or create a graph manager for a chat session
+     */
+    loadOrCreateGraph(chatId: string, compressionThreshold?: number): Promise<ContextGraphManager>;
+    /**
+     * Check if a graph exists on disk
+     */
+    graphExists(chatId: string): Promise<boolean>;
+    /**
+     * Delete a graph from disk
+     */
+    deleteGraph(chatId: string): Promise<void>;
+    /**
+     * List all saved chat sessions
+     */
+    listSessions(): Promise<Array<{
+        chatId: string;
+        createdAt: Date;
+        updatedAt: Date;
+        nodeCount: number;
+        edgeCount: number;
+    }>>;
+    /**
+     * Change the data directory
+     */
+    setDataDir(newDataDir: string): void;
+    /**
+     * Get the current data directory
+     */
+    getDataDir(): string;
+}
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAuB;IAI5C;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAUpC;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCvD;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA4C9D;;OAEG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,oBAAoB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAU/B;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUnD;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhD;;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;IAmCD;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,UAAU,IAAI,MAAM;CAGrB"}

package/dist/persistence.js

@@ -0,0 +1,188 @@
+import { promises as fs } from "fs";
+import * as path from "path";
+import { ContextGraphManager } from "./index";
+/**
+ * PersistenceManager
+ * Handles saving and loading graph snapshots to/from disk
+ * Organizes files by chat_id in a configurable data directory
+ */
+export class PersistenceManager {
+    dataDir;
+    constructor(dataDir = "./weave-data") {
+        this.dataDir = dataDir;
+    }
+    /**
+     * Get the file path for a given chat_id
+     */
+    getFilePath(chatId) {
+        const sanitizedId = chatId.replace(/[^a-zA-Z0-9_-]/g, "_");
+        return path.join(this.dataDir, `${sanitizedId}.json`);
+    }
+    /**
+     * Ensure the data directory exists
+     */
+    async ensureDataDir() {
+        try {
+            await fs.mkdir(this.dataDir, { recursive: true });
+        }
+        catch (error) {
+            if (error.code !== "EEXIST") {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Save a graph snapshot to disk
+     */
+    async saveGraph(snapshot) {
+        await this.ensureDataDir();
+        const filePath = this.getFilePath(snapshot.metadata.chatId);
+        const serialized = {
+            ...snapshot,
+            metadata: {
+                ...snapshot.metadata,
+                createdAt: snapshot.metadata.createdAt.toISOString(),
+                updatedAt: snapshot.metadata.updatedAt.toISOString(),
+            },
+            nodes: Object.fromEntries(Object.entries(snapshot.nodes).map(([id, node]) => [
+                id,
+                {
+                    ...node,
+                    createdAt: node.createdAt.toISOString(),
+                    updatedAt: node.updatedAt.toISOString(),
+                },
+            ])),
+            edges: Object.fromEntries(Object.entries(snapshot.edges).map(([id, edge]) => [
+                id,
+                {
+                    ...edge,
+                    createdAt: edge.createdAt.toISOString(),
+                    updatedAt: edge.updatedAt.toISOString(),
+                },
+            ])),
+        };
+        await fs.writeFile(filePath, JSON.stringify(serialized, null, 2), "utf-8");
+    }
+    /**
+     * Load a graph snapshot from disk
+     */
+    async loadGraph(chatId) {
+        const filePath = this.getFilePath(chatId);
+        try {
+            const content = await fs.readFile(filePath, "utf-8");
+            const parsed = JSON.parse(content);
+            // Deserialize dates
+            return {
+                ...parsed,
+                metadata: {
+                    ...parsed.metadata,
+                    createdAt: new Date(parsed.metadata.createdAt),
+                    updatedAt: new Date(parsed.metadata.updatedAt),
+                },
+                nodes: Object.fromEntries(Object.entries(parsed.nodes).map(([id, node]) => [
+                    id,
+                    {
+                        ...node,
+                        createdAt: new Date(node.createdAt),
+                        updatedAt: new Date(node.updatedAt),
+                    },
+                ])),
+                edges: Object.fromEntries(Object.entries(parsed.edges).map(([id, edge]) => [
+                    id,
+                    {
+                        ...edge,
+                        createdAt: new Date(edge.createdAt),
+                        updatedAt: new Date(edge.updatedAt),
+                    },
+                ])),
+            };
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Load or create a graph manager for a chat session
+     */
+    async loadOrCreateGraph(chatId, compressionThreshold) {
+        const snapshot = await this.loadGraph(chatId);
+        if (snapshot) {
+            return ContextGraphManager.fromSnapshot(snapshot);
+        }
+        return new ContextGraphManager(chatId, compressionThreshold);
+    }
+    /**
+     * Check if a graph exists on disk
+     */
+    async graphExists(chatId) {
+        const filePath = this.getFilePath(chatId);
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Delete a graph from disk
+     */
+    async deleteGraph(chatId) {
+        const filePath = this.getFilePath(chatId);
+        try {
+            await fs.unlink(filePath);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+        }
+    }
+    /**
+     * List all saved chat sessions
+     */
+    async listSessions() {
+        await this.ensureDataDir();
+        try {
+            const files = await fs.readdir(this.dataDir);
+            const jsonFiles = files.filter((f) => f.endsWith(".json"));
+            const sessions = await Promise.all(jsonFiles.map(async (file) => {
+                const chatId = file.replace(".json", "");
+                const snapshot = await this.loadGraph(chatId);
+                if (!snapshot) {
+                    return null;
+                }
+                return {
+                    chatId,
+                    createdAt: snapshot.metadata.createdAt,
+                    updatedAt: snapshot.metadata.updatedAt,
+                    nodeCount: Object.keys(snapshot.nodes).length,
+                    edgeCount: Object.keys(snapshot.edges).length,
+                };
+            }));
+            return sessions.filter((s) => s !== null);
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return [];
+            }
+            throw error;
+        }
+    }
+    /**
+     * Change the data directory
+     */
+    setDataDir(newDataDir) {
+        this.dataDir = newDataDir;
+    }
+    /**
+     * Get the current data directory
+     */
+    getDataDir() {
+        return this.dataDir;
+    }
+}
+//# sourceMappingURL=persistence.js.map

package/dist/persistence.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Node Types for WeaveGraph
+ * Represents different kinds of concepts in the knowledge graph
+ */
+export declare enum NodeType {
+    CONCEPT = "CONCEPT",
+    DECISION = "DECISION",
+    MILESTONE = "MILESTONE",
+    ERROR = "ERROR",
+    CORRECTION = "CORRECTION",
+    CODE_ENTITY = "CODE_ENTITY"
+}
+/**
+ * Edge Types for WeaveGraph
+ * Represents different semantic relationships between nodes
+ */
+export declare enum EdgeType {
+    RELATES = "RELATES",
+    CAUSES = "CAUSES",
+    CORRECTS = "CORRECTS",
+    IMPLEMENTS = "IMPLEMENTS",
+    DEPENDS_ON = "DEPENDS_ON",
+    BLOCKS = "BLOCKS"
+}
+/**
+ * Node in the WeaveGraph
+ * Base representation of a concept, decision, error, etc.
+ */
+export interface Node {
+    id: string;
+    type: NodeType;
+    label: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+    frequency?: number;
+}
+/**
+ * Edge in the WeaveGraph
+ * Represents a semantic relationship between two nodes
+ */
+export interface Edge {
+    id: string;
+    sourceId: string;
+    targetId: string;
+    type: EdgeType;
+    weight?: number;
+    metadata?: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Query result from keyword-based search
+ */
+export interface QueryResult {
+    nodes: Node[];
+    edges: Edge[];
+}
+/**
+ * Serialized graph for persistence
+ */
+export interface GraphSnapshot {
+    nodes: Record<string, Node>;
+    edges: Record<string, Edge>;
+    metadata: {
+        chatId: string;
+        version: string;
+        createdAt: Date;
+        updatedAt: Date;
+        compressionThreshold: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,WAAW,gBAAgB;CAC5B;AAED;;;GAGG;AACH,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,MAAM,WAAW;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,IAAI,CAAC;QAChB,SAAS,EAAE,IAAI,CAAC;QAChB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH"}

package/dist/types.js

@@ -0,0 +1,27 @@
+/**
+ * Node Types for WeaveGraph
+ * Represents different kinds of concepts in the knowledge graph
+ */
+export var NodeType;
+(function (NodeType) {
+    NodeType["CONCEPT"] = "CONCEPT";
+    NodeType["DECISION"] = "DECISION";
+    NodeType["MILESTONE"] = "MILESTONE";
+    NodeType["ERROR"] = "ERROR";
+    NodeType["CORRECTION"] = "CORRECTION";
+    NodeType["CODE_ENTITY"] = "CODE_ENTITY";
+})(NodeType || (NodeType = {}));
+/**
+ * Edge Types for WeaveGraph
+ * Represents different semantic relationships between nodes
+ */
+export var EdgeType;
+(function (EdgeType) {
+    EdgeType["RELATES"] = "RELATES";
+    EdgeType["CAUSES"] = "CAUSES";
+    EdgeType["CORRECTS"] = "CORRECTS";
+    EdgeType["IMPLEMENTS"] = "IMPLEMENTS";
+    EdgeType["DEPENDS_ON"] = "DEPENDS_ON";
+    EdgeType["BLOCKS"] = "BLOCKS";
+})(EdgeType || (EdgeType = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,+BAAmB,CAAA;IACnB,iCAAqB,CAAA;IACrB,mCAAuB,CAAA;IACvB,2BAAe,CAAA;IACf,qCAAyB,CAAA;IACzB,uCAA2B,CAAA;AAC7B,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,+BAAmB,CAAA;IACnB,6BAAiB,CAAA;IACjB,iCAAqB,CAAA;IACrB,qCAAyB,CAAA;IACzB,qCAAyB,CAAA;IACzB,6BAAiB,CAAA;AACnB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@openweave/weave-graph",
+  "version": "0.2.0",
+  "description": "WeaveGraph — Persistent node & edge data model for AI agent context",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "weave",
+    "graph",
+    "context",
+    "ai-agent",
+    "semantic-memory"
+  ],
+  "devDependencies": {
+    "@types/node": "22.10.2",
+    "typescript": "5.7.2",
+    "vitest": "3.0.0"
+  },
+  "dependencies": {
+    "@openweave/weave-provider": "0.8.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "lint": "eslint src --max-warnings 0",
+    "clean": "rm -rf dist"
+  }
+}