@grackle-ai/knowledge 0.59.1 → 0.60.0

package/dist/client.d.ts

@@ -10,7 +10,7 @@
 import { type Driver, type Session } from "neo4j-driver";
 /** Configuration for the Neo4j connection. */
 export interface Neo4jClientConfig {
-    /** Bolt URL (default: bolt://localhost:7687). */
+    /** Bolt URL (default: bolt://127.0.0.1:7687). */
     url?: string;
     /** Username (default: neo4j). */
     username?: string;

package/dist/constants.js

@@ -4,7 +4,7 @@
  * @module
  */
 /** Default Neo4j Bolt connection URL. */
-export const DEFAULT_NEO4J_URL = "bolt://localhost:7687";
+export const DEFAULT_NEO4J_URL = "bolt://127.0.0.1:7687";
 /** Default Neo4j username. */
 export const DEFAULT_NEO4J_USER = "neo4j";
 /**

package/dist/edge-store.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Edge CRUD operations for the knowledge graph.
+ *
+ * Provides create and remove operations for typed relationships between
+ * {@link KnowledgeNode} instances, backed by Neo4j.
+ *
+ * @module
+ */
+import { type EdgeType, type KnowledgeEdge } from "./types.js";
+/**
+ * Create a typed edge between two nodes.
+ *
+ * @param fromId - Source node ID.
+ * @param toId - Target node ID.
+ * @param type - Relationship type (must be a valid {@link EdgeType}).
+ * @param metadata - Optional metadata to attach to the edge.
+ * @returns The created edge.
+ * @throws If either node does not exist.
+ * @throws If the edge type is invalid.
+ */
+export declare function createEdge(fromId: string, toId: string, type: EdgeType, metadata?: Record<string, unknown>): Promise<KnowledgeEdge>;
+/**
+ * Remove an edge between two nodes.
+ *
+ * @param fromId - Source node ID.
+ * @param toId - Target node ID.
+ * @param type - Relationship type to remove.
+ * @returns `true` if an edge was removed, `false` if no matching edge existed.
+ * @throws If the edge type is invalid.
+ */
+export declare function removeEdge(fromId: string, toId: string, type: EdgeType): Promise<boolean>;
+//# sourceMappingURL=edge-store.d.ts.map

package/dist/edge-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-store.d.ts","sourceRoot":"","sources":["../src/edge-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAa,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAwD1E;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,aAAa,CAAC,CAiDxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,OAAO,CAAC,CAsBlB"}

package/dist/edge-store.js

@@ -0,0 +1,145 @@
+/**
+ * Edge CRUD operations for the knowledge graph.
+ *
+ * Provides create and remove operations for typed relationships between
+ * {@link KnowledgeNode} instances, backed by Neo4j.
+ *
+ * @module
+ */
+import { getSession } from "./client.js";
+import { logger } from "./logger.js";
+import { NODE_LABEL } from "./constants.js";
+import { EDGE_TYPE } from "./types.js";
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+/** Known edge type values for runtime validation. */
+const VALID_EDGE_TYPES = new Set(Object.values(EDGE_TYPE));
+/**
+ * Assert that a string is a valid {@link EdgeType}.
+ *
+ * @throws If the value is not a known edge type.
+ */
+function assertValidEdgeType(type) {
+    if (!VALID_EDGE_TYPES.has(type)) {
+        throw new Error(`Invalid edge type: "${type}". Must be one of: ${[...VALID_EDGE_TYPES].join(", ")}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Cypher builders
+// ---------------------------------------------------------------------------
+/**
+ * Build the Cypher query for creating an edge of a given type.
+ *
+ * Relationship types cannot be parameterized in Cypher, so the type is
+ * interpolated directly. This is safe because {@link assertValidEdgeType}
+ * ensures the value comes from the closed {@link EdgeType} union.
+ */
+function buildCreateEdgeCypher(edgeType) {
+    return [
+        `MATCH (a:${NODE_LABEL} {id: $fromId}), (b:${NODE_LABEL} {id: $toId})`,
+        `CREATE (a)-[r:${edgeType} {metadata: $metadata, createdAt: $createdAt}]->(b)`,
+        `RETURN a.id AS fromId, b.id AS toId, type(r) AS type, r.metadata AS metadata, r.createdAt AS createdAt`,
+    ].join("\n");
+}
+/**
+ * Build the Cypher query for removing an edge of a given type.
+ */
+function buildRemoveEdgeCypher(edgeType) {
+    return [
+        `MATCH (a:${NODE_LABEL} {id: $fromId})-[r:${edgeType}]->(b:${NODE_LABEL} {id: $toId})`,
+        `DELETE r`,
+        `RETURN count(r) AS deleted`,
+    ].join("\n");
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Create a typed edge between two nodes.
+ *
+ * @param fromId - Source node ID.
+ * @param toId - Target node ID.
+ * @param type - Relationship type (must be a valid {@link EdgeType}).
+ * @param metadata - Optional metadata to attach to the edge.
+ * @returns The created edge.
+ * @throws If either node does not exist.
+ * @throws If the edge type is invalid.
+ */
+export async function createEdge(fromId, toId, type, metadata) {
+    assertValidEdgeType(type);
+    const createdAt = new Date().toISOString();
+    const metadataStr = metadata !== undefined ? JSON.stringify(metadata) : null;
+    const session = getSession();
+    try {
+        const result = await session.run(buildCreateEdgeCypher(type), {
+            fromId,
+            toId,
+            metadata: metadataStr,
+            createdAt,
+        });
+        if (result.records.length === 0) {
+            throw new Error(`Cannot create edge: one or both nodes not found (fromId=${fromId}, toId=${toId})`);
+        }
+        const record = result.records[0];
+        let parsedMetadata;
+        const rawMetadata = record.get("metadata");
+        if (rawMetadata !== null) {
+            try {
+                parsedMetadata = JSON.parse(rawMetadata);
+            }
+            catch {
+                parsedMetadata = undefined;
+            }
+        }
+        logger.debug({ fromId, toId, type }, "Created edge");
+        return {
+            fromId: record.get("fromId"),
+            toId: record.get("toId"),
+            type: record.get("type"),
+            metadata: parsedMetadata,
+            createdAt: record.get("createdAt"),
+        };
+    }
+    finally {
+        try {
+            await session.close();
+        }
+        catch (closeError) {
+            logger.warn({ err: closeError }, "Failed to close session after createEdge");
+        }
+    }
+}
+/**
+ * Remove an edge between two nodes.
+ *
+ * @param fromId - Source node ID.
+ * @param toId - Target node ID.
+ * @param type - Relationship type to remove.
+ * @returns `true` if an edge was removed, `false` if no matching edge existed.
+ * @throws If the edge type is invalid.
+ */
+export async function removeEdge(fromId, toId, type) {
+    assertValidEdgeType(type);
+    const session = getSession();
+    try {
+        const result = await session.run(buildRemoveEdgeCypher(type), {
+            fromId,
+            toId,
+        });
+        const deleted = result.records[0]?.get("deleted");
+        if (deleted > 0) {
+            logger.debug({ fromId, toId, type }, "Removed edge");
+        }
+        return deleted > 0;
+    }
+    finally {
+        try {
+            await session.close();
+        }
+        catch (closeError) {
+            logger.warn({ err: closeError }, "Failed to close session after removeEdge");
+        }
+    }
+}
+//# sourceMappingURL=edge-store.js.map

package/dist/edge-store.js.map

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

package/dist/index.d.ts

@@ -20,4 +20,7 @@ export type { EmbeddedChunk } from "./ingest.js";
 export { ingest } from "./ingest.js";
 export type { TranscriptChunkerOptions } from "./transcript-chunker.js";
 export { createTranscriptChunker } from "./transcript-chunker.js";
+export { createReferenceNode, createNativeNode, getNode, deleteNode, updateNode, recordToNode, } from "./node-store.js";
+export type { CreateReferenceNodeInput, CreateNativeNodeInput, UpdateReferenceNodeInput, UpdateNativeNodeInput, UpdateNodeInput, NodeWithEdges, } from "./node-store.js";
+export { createEdge, removeEdge } from "./edge-store.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxF,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,oCAAoC,EACpC,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxF,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,oCAAoC,EACpC,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -15,4 +15,6 @@ export { createLocalEmbedder } from "./local-embedder.js";
 export { createPassThroughChunker } from "./pass-through-chunker.js";
 export { ingest } from "./ingest.js";
 export { createTranscriptChunker } from "./transcript-chunker.js";
+export { createReferenceNode, createNativeNode, getNode, deleteNode, updateNode, recordToNode, } from "./node-store.js";
+export { createEdge, removeEdge } from "./edge-store.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,oCAAoC,EACpC,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,oCAAoC,EACpC,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/node-store.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Node CRUD operations for the knowledge graph.
+ *
+ * Provides create, read, update, and delete operations for both
+ * {@link ReferenceNode} and {@link NativeNode} types, backed by Neo4j.
+ *
+ * @module
+ */
+import { type ReferenceSource, type NativeCategory, type KnowledgeNode, type KnowledgeEdge } from "./types.js";
+/** Input for creating a reference node. Excludes auto-generated fields. */
+export interface CreateReferenceNodeInput {
+    /** Which entity type this refers to. */
+    sourceType: ReferenceSource;
+    /** The ID of the entity in Grackle's relational DB. */
+    sourceId: string;
+    /** Human-readable label derived from the source. */
+    label: string;
+    /** Dense vector embedding for similarity search. */
+    embedding: number[];
+    /** Workspace scope (empty string = global). */
+    workspaceId: string;
+}
+/** Input for creating a native node. Excludes auto-generated fields. */
+export interface CreateNativeNodeInput {
+    /** Subcategory of the native node. */
+    category: NativeCategory;
+    /** Title or summary. */
+    title: string;
+    /** Full content owned by this node. */
+    content: string;
+    /** Free-form tags for categorization. */
+    tags: string[];
+    /** Dense vector embedding for similarity search. */
+    embedding: number[];
+    /** Workspace scope (empty string = global). */
+    workspaceId: string;
+}
+/** Fields that can be updated on a reference node. */
+export interface UpdateReferenceNodeInput {
+    /** Updated label. */
+    label?: string;
+    /** Updated source ID. */
+    sourceId?: string;
+    /** Updated embedding vector. */
+    embedding?: number[];
+}
+/** Fields that can be updated on a native node. */
+export interface UpdateNativeNodeInput {
+    /** Updated title. */
+    title?: string;
+    /** Updated content. */
+    content?: string;
+    /** Updated tags. */
+    tags?: string[];
+    /** Updated embedding vector. */
+    embedding?: number[];
+}
+/** Union of update inputs for either node kind. */
+export type UpdateNodeInput = UpdateReferenceNodeInput | UpdateNativeNodeInput;
+/** A node together with all its edges. */
+export interface NodeWithEdges {
+    /** The knowledge graph node. */
+    node: KnowledgeNode;
+    /** All edges connected to this node (both incoming and outgoing). */
+    edges: KnowledgeEdge[];
+}
+/**
+ * Convert Neo4j node properties to a typed {@link KnowledgeNode}.
+ *
+ * Handles the discriminated union based on the `kind` property.
+ */
+export declare function recordToNode(properties: Record<string, unknown>): KnowledgeNode;
+/**
+ * Create a reference node in the knowledge graph.
+ *
+ * Generates a UUID and timestamps automatically.
+ *
+ * @returns The ID of the created node.
+ */
+export declare function createReferenceNode(input: CreateReferenceNodeInput): Promise<string>;
+/**
+ * Create a native node in the knowledge graph.
+ *
+ * Generates a UUID and timestamps automatically.
+ *
+ * @returns The ID of the created node.
+ */
+export declare function createNativeNode(input: CreateNativeNodeInput): Promise<string>;
+/**
+ * Get a node by ID, including all its edges.
+ *
+ * @returns The node and its edges, or `undefined` if the node was not found.
+ */
+export declare function getNode(id: string): Promise<NodeWithEdges | undefined>;
+/**
+ * Delete a node and all its edges (`DETACH DELETE`).
+ *
+ * @returns `true` if a node was deleted, `false` if the node was not found.
+ */
+export declare function deleteNode(id: string): Promise<boolean>;
+/**
+ * Update a node's mutable properties.
+ *
+ * Cannot change `kind`, `id`, `createdAt`, or `workspaceId`.
+ * Automatically updates the `updatedAt` timestamp.
+ *
+ * @returns The updated node, or `undefined` if the node was not found.
+ */
+export declare function updateNode(id: string, updates: UpdateNodeInput): Promise<KnowledgeNode | undefined>;
+//# sourceMappingURL=node-store.d.ts.map

package/dist/node-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-store.d.ts","sourceRoot":"","sources":["../src/node-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAEnB,MAAM,YAAY,CAAC;AAMpB,2EAA2E;AAC3E,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,UAAU,EAAE,eAAe,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wEAAwE;AACxE,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,QAAQ,EAAE,cAAc,CAAC;IACzB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,oDAAoD;IACpD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sDAAsD;AACtD,MAAM,WAAW,wBAAwB;IACvC,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,MAAM,eAAe,GAAG,wBAAwB,GAAG,qBAAqB,CAAC;AAE/E,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,qEAAqE;IACrE,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAsCD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,aAAa,CA4Bf;AA4BD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAwB5E;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB7D;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAmCpC"}

package/dist/node-store.js

@@ -0,0 +1,266 @@
+/**
+ * Node CRUD operations for the knowledge graph.
+ *
+ * Provides create, read, update, and delete operations for both
+ * {@link ReferenceNode} and {@link NativeNode} types, backed by Neo4j.
+ *
+ * @module
+ */
+import { randomUUID } from "node:crypto";
+import { getSession } from "./client.js";
+import { logger } from "./logger.js";
+import { NODE_LABEL } from "./constants.js";
+import { NODE_KIND, } from "./types.js";
+// ---------------------------------------------------------------------------
+// Cypher queries
+// ---------------------------------------------------------------------------
+const GET_NODE_WITH_EDGES_CYPHER = `
+  MATCH (n:${NODE_LABEL} {id: $id})
+  OPTIONAL MATCH (n)-[r]-(m:${NODE_LABEL})
+  WITH n, r, m
+  WHERE r IS NOT NULL
+  RETURN n,
+    collect({
+      fromId: CASE WHEN startNode(r) = n THEN n.id ELSE m.id END,
+      toId: CASE WHEN endNode(r) = n THEN n.id ELSE m.id END,
+      type: type(r),
+      metadata: r.metadata,
+      createdAt: r.createdAt
+    }) AS edges
+  UNION ALL
+  MATCH (n:${NODE_LABEL} {id: $id})
+  WHERE NOT (n)-[]-()
+  RETURN n, [] AS edges`;
+const DELETE_NODE_CYPHER = `
+  MATCH (n:${NODE_LABEL} {id: $id})
+  DETACH DELETE n
+  RETURN count(n) AS deleted`;
+const UPDATE_NODE_CYPHER = `
+  MATCH (n:${NODE_LABEL} {id: $id})
+  SET n += $updates
+  RETURN n`;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Convert Neo4j node properties to a typed {@link KnowledgeNode}.
+ *
+ * Handles the discriminated union based on the `kind` property.
+ */
+export function recordToNode(properties) {
+    const base = {
+        id: properties.id,
+        kind: properties.kind,
+        embedding: properties.embedding ?? [],
+        createdAt: properties.createdAt,
+        updatedAt: properties.updatedAt,
+        workspaceId: properties.workspaceId ?? "",
+    };
+    if (base.kind === NODE_KIND.REFERENCE) {
+        return {
+            ...base,
+            kind: NODE_KIND.REFERENCE,
+            sourceType: properties.sourceType,
+            sourceId: properties.sourceId,
+            label: properties.label ?? "",
+        };
+    }
+    return {
+        ...base,
+        kind: NODE_KIND.NATIVE,
+        category: properties.category,
+        title: properties.title ?? "",
+        content: properties.content ?? "",
+        tags: properties.tags ?? [],
+    };
+}
+/**
+ * Convert a raw edge object from Cypher `collect()` to a {@link KnowledgeEdge}.
+ */
+function recordToEdge(raw) {
+    let metadata;
+    if (raw.metadata !== undefined && raw.metadata !== null) {
+        try {
+            metadata = JSON.parse(raw.metadata);
+        }
+        catch {
+            metadata = undefined;
+        }
+    }
+    return {
+        fromId: raw.fromId,
+        toId: raw.toId,
+        type: raw.type,
+        metadata,
+        createdAt: raw.createdAt,
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Create a reference node in the knowledge graph.
+ *
+ * Generates a UUID and timestamps automatically.
+ *
+ * @returns The ID of the created node.
+ */
+export async function createReferenceNode(input) {
+    const id = randomUUID();
+    const now = new Date().toISOString();
+    const props = {
+        id,
+        kind: NODE_KIND.REFERENCE,
+        sourceType: input.sourceType,
+        sourceId: input.sourceId,
+        label: input.label,
+        embedding: input.embedding,
+        workspaceId: input.workspaceId,
+        createdAt: now,
+        updatedAt: now,
+    };
+    const session = getSession();
+    try {
+        await session.run(`CREATE (n:${NODE_LABEL} $props) RETURN n`, { props });
+        logger.debug({ nodeId: id, kind: NODE_KIND.REFERENCE }, "Created reference node");
+        return id;
+    }
+    finally {
+        try {
+            await session.close();
+        }
+        catch (closeError) {
+            logger.warn({ err: closeError }, "Failed to close session after createReferenceNode");
+        }
+    }
+}
+/**
+ * Create a native node in the knowledge graph.
+ *
+ * Generates a UUID and timestamps automatically.
+ *
+ * @returns The ID of the created node.
+ */
+export async function createNativeNode(input) {
+    const id = randomUUID();
+    const now = new Date().toISOString();
+    const props = {
+        id,
+        kind: NODE_KIND.NATIVE,
+        category: input.category,
+        title: input.title,
+        content: input.content,
+        tags: input.tags,
+        embedding: input.embedding,
+        workspaceId: input.workspaceId,
+        createdAt: now,
+        updatedAt: now,
+    };
+    const session = getSession();
+    try {
+        await session.run(`CREATE (n:${NODE_LABEL} $props) RETURN n`, { props });
+        logger.debug({ nodeId: id, kind: NODE_KIND.NATIVE }, "Created native node");
+        return id;
+    }
+    finally {
+        try {
+            await session.close();
+        }
+        catch (closeError) {
+            logger.warn({ err: closeError }, "Failed to close session after createNativeNode");
+        }
+    }
+}
+/**
+ * Get a node by ID, including all its edges.
+ *
+ * @returns The node and its edges, or `undefined` if the node was not found.
+ */
+export async function getNode(id) {
+    const session = getSession();
+    try {
+        const result = await session.run(GET_NODE_WITH_EDGES_CYPHER, { id });
+        if (result.records.length === 0) {
+            return undefined;
+        }
+        const record = result.records[0];
+        const neo4jNode = record.get("n");
+        const rawEdges = record.get("edges");
+        const node = recordToNode(neo4jNode.properties);
+        const edges = rawEdges.map(recordToEdge);
+        return { node, edges };
+    }
+    finally {
+        try {
+            await session.close();
+        }
+        catch (closeError) {
+            logger.warn({ err: closeError }, "Failed to close session after getNode");
+        }
+    }
+}
+/**
+ * Delete a node and all its edges (`DETACH DELETE`).
+ *
+ * @returns `true` if a node was deleted, `false` if the node was not found.
+ */
+export async function deleteNode(id) {
+    const session = getSession();
+    try {
+        const result = await session.run(DELETE_NODE_CYPHER, { id });
+        const deleted = result.records[0]?.get("deleted");
+        if (deleted > 0) {
+            logger.debug({ nodeId: id }, "Deleted node");
+        }
+        return deleted > 0;
+    }
+    finally {
+        try {
+            await session.close();
+        }
+        catch (closeError) {
+            logger.warn({ err: closeError }, "Failed to close session after deleteNode");
+        }
+    }
+}
+/**
+ * Update a node's mutable properties.
+ *
+ * Cannot change `kind`, `id`, `createdAt`, or `workspaceId`.
+ * Automatically updates the `updatedAt` timestamp.
+ *
+ * @returns The updated node, or `undefined` if the node was not found.
+ */
+export async function updateNode(id, updates) {
+    // Strip immutable fields defensively.
+    const { ...mutableUpdates } = updates;
+    const forbidden = ["kind", "id", "createdAt", "workspaceId"];
+    for (const key of forbidden) {
+        delete mutableUpdates[key];
+    }
+    const patchedUpdates = {
+        ...mutableUpdates,
+        updatedAt: new Date().toISOString(),
+    };
+    const session = getSession();
+    try {
+        const result = await session.run(UPDATE_NODE_CYPHER, {
+            id,
+            updates: patchedUpdates,
+        });
+        if (result.records.length === 0) {
+            return undefined;
+        }
+        const neo4jNode = result.records[0].get("n");
+        return recordToNode(neo4jNode.properties);
+    }
+    finally {
+        try {
+            await session.close();
+        }
+        catch (closeError) {
+            logger.warn({ err: closeError }, "Failed to close session after updateNode");
+        }
+    }
+}
+//# sourceMappingURL=node-store.js.map

package/dist/node-store.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grackle-ai/knowledge",
-  "version": "0.59.1",
+  "version": "0.60.0",
   "description": "Knowledge graph subsystem for Grackle (Neo4j + vector search)",
   "license": "MIT",
   "repository": {
@@ -27,7 +27,7 @@
     "@huggingface/transformers": "^3.4.0",
     "neo4j-driver": "^6.0.1",
     "pino": "^10.3.1",
-    "@grackle-ai/common": "0.59.1"
+    "@grackle-ai/common": "0.60.0"
   },
   "devDependencies": {
     "@rushstack/heft": "1.2.4",