@grackle-ai/knowledge-core 0.75.13 → 0.76.1

package/README.md

@@ -393,16 +393,21 @@ The following schema objects are created:
 | `INDEX_KIND` | Index on `kind` for efficient filtering by node type |
 | `INDEX_WORKSPACE` | Index on `workspaceId` for scoped queries |
 | `INDEX_SOURCE` | Composite index on `(sourceType, sourceId)` for reference lookups |
-| `VECTOR_INDEX` | Vector index on `embedding` for cosine similarity search (1536 dimensions) |
+| `VECTOR_INDEX` | Vector index on `embedding` for cosine similarity search (dimensions configurable) |
 
 ```typescript
+const embedder = createLocalEmbedder();
 await openNeo4j();
-await initSchema();
+await initSchema(embedder.dimensions); // creates a 384-dim vector index
 ```
 
+#### `buildSchemaStatements(dimensions?: number): Record<string, string>`
+
+Build the Cypher schema statements with a custom vector index dimensionality. Defaults to `EMBEDDING_DIMENSIONS` (1536) if omitted.
+
 #### `SCHEMA_STATEMENTS: Record<string, string>`
 
-The raw Cypher statements used by `initSchema()`, exported for inspection and testing.
+The raw Cypher statements using the default 1536 dimensions. Prefer `buildSchemaStatements(dimensions)` for custom dimensions.
 
 ### Embedders
 
@@ -457,9 +462,14 @@ const customEmbedder = createLocalEmbedder({
 });
 ```
 
-**Important:** The default local embedder produces 384-dimensional vectors, while the default Neo4j vector index schema created by `initSchema()` is configured for 1536 dimensions (see the `EMBEDDING_DIMENSIONS` constant in the library source). Because that constant is baked into the schema definition, downstream applications cannot realistically change it at runtime. If you use the local embedder, you should either:
-- Use an embedding model that produces 1536-dimensional vectors so it matches the default schema created by `initSchema()`, or
-- Skip `initSchema()` and create a custom Neo4j vector index whose dimensions match your embedder (for example, 384 for the default local model).
+**Dimension matching:** `initSchema()` accepts an optional `dimensions` parameter that controls the vector index size. Pass your embedder's dimensions to ensure they match:
+
+```typescript
+const embedder = createLocalEmbedder();
+await initSchema(embedder.dimensions); // creates a 384-dim vector index
+```
+
+If omitted, `initSchema()` defaults to `EMBEDDING_DIMENSIONS` (1536). Use `buildSchemaStatements(dimensions)` for custom dimensions when building statements manually.
 
 ### Chunkers
 

package/dist/index.d.ts

@@ -9,7 +9,7 @@
  */
 export { openNeo4j, closeNeo4j, healthCheck, getSession, getDriver } from "./client.js";
 export type { Neo4jClientConfig } from "./client.js";
-export { initSchema, SCHEMA_STATEMENTS } from "./schema.js";
+export { initSchema, buildSchemaStatements, SCHEMA_STATEMENTS } from "./schema.js";
 export { logger } from "./logger.js";
 export * from "./types.js";
 export { DEFAULT_NEO4J_URL, DEFAULT_NEO4J_USER, DEFAULT_NEO4J_DATABASE, NEO4J_MAX_POOL_SIZE, NEO4J_CONNECTION_ACQUISITION_TIMEOUT, NODE_LABEL, VECTOR_INDEX_NAME, EMBEDDING_DIMENSIONS, VECTOR_SIMILARITY_FUNCTION, } from "./constants.js";

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,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,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,EACZ,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;AACzD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,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,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,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,EACZ,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;AACzD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -8,7 +8,7 @@
  * @packageDocumentation
  */
 export { openNeo4j, closeNeo4j, healthCheck, getSession, getDriver } from "./client.js";
-export { initSchema, SCHEMA_STATEMENTS } from "./schema.js";
+export { initSchema, buildSchemaStatements, SCHEMA_STATEMENTS } from "./schema.js";
 export { logger } from "./logger.js";
 export * from "./types.js";
 export { DEFAULT_NEO4J_URL, DEFAULT_NEO4J_USER, DEFAULT_NEO4J_DATABASE, NEO4J_MAX_POOL_SIZE, NEO4J_CONNECTION_ACQUISITION_TIMEOUT, NODE_LABEL, VECTOR_INDEX_NAME, EMBEDDING_DIMENSIONS, VECTOR_SIMILARITY_FUNCTION, } from "./constants.js";

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,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,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,EACZ,YAAY,GACb,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,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,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,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,EACZ,YAAY,GACb,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/schema.d.ts

@@ -7,17 +7,30 @@
  * @module
  */
 /**
- * Cypher statements for schema initialization.
+ * Build the Cypher statements for schema initialization.
  *
- * Exported so tests can verify the exact statements that will be executed.
+ * @param dimensions - Dimensionality of the vector index. Should match the
+ *   embedder being used (e.g., 384 for the default local embedder). Defaults
+ *   to {@link EMBEDDING_DIMENSIONS} (1536).
+ */
+export declare function buildSchemaStatements(dimensions?: number): Record<string, string>;
+/**
+ * Static statements using the default dimensions (1536).
+ *
+ * @deprecated Use {@link buildSchemaStatements} with the embedder's actual dimensions.
  */
 export declare const SCHEMA_STATEMENTS: Record<string, string>;
 /**
  * Initialize the Neo4j schema: constraints, property indexes, and the
  * vector index.
  *
- * All statements are idempotent (`IF NOT EXISTS`). Call once at startup
- * after {@link openNeo4j}.
+ * All statements are idempotent (`IF NOT EXISTS`). Transient errors
+ * (deadlocks from concurrent initialization) are retried automatically.
+ * Call once at startup after {@link openNeo4j}.
+ *
+ * @param dimensions - Vector index dimensionality. Should match the
+ *   embedder (e.g., 384 for the default local embedder). Defaults to
+ *   {@link EMBEDDING_DIMENSIONS} (1536).
  */
-export declare function initSchema(): Promise<void>;
+export declare function initSchema(dimensions?: number): Promise<void>;
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA4BpD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBhD"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,GAAE,MAA6B,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8BvG;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAA2B,CAAC;AAwDjF;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBnE"}

package/dist/schema.js

@@ -9,55 +9,110 @@
 import { getSession } from "./client.js";
 import { logger } from "./logger.js";
 import { NODE_LABEL, VECTOR_INDEX_NAME, EMBEDDING_DIMENSIONS, VECTOR_SIMILARITY_FUNCTION, } from "./constants.js";
+// ---------------------------------------------------------------------------
+// Schema statement builders
+// ---------------------------------------------------------------------------
 /**
- * Cypher statements for schema initialization.
+ * Build the Cypher statements for schema initialization.
  *
- * Exported so tests can verify the exact statements that will be executed.
+ * @param dimensions - Dimensionality of the vector index. Should match the
+ *   embedder being used (e.g., 384 for the default local embedder). Defaults
+ *   to {@link EMBEDDING_DIMENSIONS} (1536).
  */
-export const SCHEMA_STATEMENTS = {
-    /** Uniqueness constraint on node ID. */
-    UNIQUE_NODE_ID: `CREATE CONSTRAINT knowledge_node_id_unique IF NOT EXISTS
+export function buildSchemaStatements(dimensions = EMBEDDING_DIMENSIONS) {
+    return {
+        /** Uniqueness constraint on node ID. */
+        UNIQUE_NODE_ID: `CREATE CONSTRAINT knowledge_node_id_unique IF NOT EXISTS
     FOR (n:${NODE_LABEL}) REQUIRE n.id IS UNIQUE`,
-    /** Index on the kind property for efficient filtering. */
-    INDEX_KIND: `CREATE INDEX knowledge_node_kind IF NOT EXISTS
+        /** Index on the kind property for efficient filtering. */
+        INDEX_KIND: `CREATE INDEX knowledge_node_kind IF NOT EXISTS
     FOR (n:${NODE_LABEL}) ON (n.kind)`,
-    /** Index on workspaceId for scoped queries. */
-    INDEX_WORKSPACE: `CREATE INDEX knowledge_node_workspace IF NOT EXISTS
+        /** Index on workspaceId for scoped queries. */
+        INDEX_WORKSPACE: `CREATE INDEX knowledge_node_workspace IF NOT EXISTS
     FOR (n:${NODE_LABEL}) ON (n.workspaceId)`,
-    /** Composite index for reference node lookups by source. */
-    INDEX_SOURCE: `CREATE INDEX knowledge_node_source IF NOT EXISTS
+        /** Composite index for reference node lookups by source. */
+        INDEX_SOURCE: `CREATE INDEX knowledge_node_source IF NOT EXISTS
     FOR (n:${NODE_LABEL}) ON (n.sourceType, n.sourceId)`,
-    /** Vector index for embedding similarity search. */
-    VECTOR_INDEX: [
-        `CREATE VECTOR INDEX ${VECTOR_INDEX_NAME} IF NOT EXISTS`,
-        `FOR (n:${NODE_LABEL}) ON (n.embedding)`,
-        `OPTIONS {`,
-        `  indexConfig: {`,
-        `    \`vector.dimensions\`: ${EMBEDDING_DIMENSIONS},`,
-        `    \`vector.similarity_function\`: '${VECTOR_SIMILARITY_FUNCTION}'`,
-        `  }`,
-        `}`,
-    ].join("\n"),
-};
+        /** Vector index for embedding similarity search. */
+        VECTOR_INDEX: [
+            `CREATE VECTOR INDEX ${VECTOR_INDEX_NAME} IF NOT EXISTS`,
+            `FOR (n:${NODE_LABEL}) ON (n.embedding)`,
+            `OPTIONS {`,
+            `  indexConfig: {`,
+            `    \`vector.dimensions\`: ${dimensions},`,
+            `    \`vector.similarity_function\`: '${VECTOR_SIMILARITY_FUNCTION}'`,
+            `  }`,
+            `}`,
+        ].join("\n"),
+    };
+}
+/**
+ * Static statements using the default dimensions (1536).
+ *
+ * @deprecated Use {@link buildSchemaStatements} with the embedder's actual dimensions.
+ */
+export const SCHEMA_STATEMENTS = buildSchemaStatements();
+// ---------------------------------------------------------------------------
+// Retry helpers
+// ---------------------------------------------------------------------------
+/** Maximum number of retry attempts for transient Neo4j errors. */
+const SCHEMA_RETRY_LIMIT = 3;
+/** Base delay (ms) between retries — multiplied by attempt number. */
+const SCHEMA_RETRY_DELAY_MS = 500;
+/**
+ * Run a single schema statement with retry for transient errors and
+ * tolerance for "already exists" collisions.
+ */
+async function runStatementWithRetry(session, name, cypher) {
+    for (let attempt = 1; attempt <= SCHEMA_RETRY_LIMIT; attempt++) {
+        try {
+            await session.run(cypher);
+            return;
+        }
+        catch (error) {
+            const code = error.code ?? "";
+            // Neo4j CE throws EquivalentSchemaRuleAlreadyExists even with IF NOT EXISTS
+            // when an equivalent index exists with a different internal name.
+            if (code.includes("EquivalentSchemaRuleAlreadyExists")) {
+                logger.debug({ statement: name }, "Schema element already exists, skipping");
+                return;
+            }
+            // Transient errors (deadlocks, lock contention) are retryable
+            const retryable = error.retryable === true;
+            if (retryable && attempt < SCHEMA_RETRY_LIMIT) {
+                logger.warn({ statement: name, attempt }, "Transient schema error, retrying");
+                await new Promise((resolve) => setTimeout(resolve, SCHEMA_RETRY_DELAY_MS * attempt));
+                continue;
+            }
+            logger.error({ err: error, statement: name }, "Schema statement failed");
+            throw new Error(`Schema statement "${name}" failed: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
 /**
  * Initialize the Neo4j schema: constraints, property indexes, and the
  * vector index.
  *
- * All statements are idempotent (`IF NOT EXISTS`). Call once at startup
- * after {@link openNeo4j}.
+ * All statements are idempotent (`IF NOT EXISTS`). Transient errors
+ * (deadlocks from concurrent initialization) are retried automatically.
+ * Call once at startup after {@link openNeo4j}.
+ *
+ * @param dimensions - Vector index dimensionality. Should match the
+ *   embedder (e.g., 384 for the default local embedder). Defaults to
+ *   {@link EMBEDDING_DIMENSIONS} (1536).
  */
-export async function initSchema() {
+export async function initSchema(dimensions) {
+    const statements = dimensions !== undefined
+        ? buildSchemaStatements(dimensions)
+        : SCHEMA_STATEMENTS;
     const session = getSession();
     try {
-        for (const [name, cypher] of Object.entries(SCHEMA_STATEMENTS)) {
+        for (const [name, cypher] of Object.entries(statements)) {
             logger.debug({ statement: name }, "Running schema statement");
-            try {
-                await session.run(cypher);
-            }
-            catch (error) {
-                logger.error({ err: error, statement: name }, "Schema statement failed");
-                throw new Error(`Schema statement "${name}" failed: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-            }
+            await runStatementWithRetry(session, name, cypher);
         }
         logger.info("Knowledge graph schema initialized");
     }

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,wCAAwC;IACxC,cAAc,EAAE;aACL,UAAU,0BAA0B;IAE/C,0DAA0D;IAC1D,UAAU,EAAE;aACD,UAAU,eAAe;IAEpC,+CAA+C;IAC/C,eAAe,EAAE;aACN,UAAU,sBAAsB;IAE3C,4DAA4D;IAC5D,YAAY,EAAE;aACH,UAAU,iCAAiC;IAEtD,oDAAoD;IACpD,YAAY,EAAE;QACZ,uBAAuB,iBAAiB,gBAAgB;QACxD,UAAU,UAAU,oBAAoB;QACxC,WAAW;QACX,kBAAkB;QAClB,8BAA8B,oBAAoB,GAAG;QACrD,wCAAwC,0BAA0B,GAAG;QACrE,KAAK;QACL,GAAG;KACJ,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,0BAA0B,CAAC,CAAC;YAC9D,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,yBAAyB,CAAC,CAAC;gBACzE,MAAM,IAAI,KAAK,CACb,qBAAqB,IAAI,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC9F,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,UAAU,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,2DAA2D,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grackle-ai/knowledge-core",
-  "version": "0.75.13",
+  "version": "0.76.1",
   "description": "Generic knowledge graph SDK on top of Neo4j with vector search, graph traversal, and pluggable embedders/chunkers",
   "license": "MIT",
   "repository": {