@grackle-ai/knowledge 0.62.2 → 0.63.0

package/dist/node-store.d.ts

@@ -1,116 +0,0 @@
-/**
- * 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;
-/**
- * Convert a raw edge object from Cypher `collect()` to a {@link KnowledgeEdge}.
- *
- * @internal Exported for use by search and expand modules within this package.
- */
-export declare function recordToEdge(raw: Record<string, unknown>): KnowledgeEdge;
-/**
- * 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

@@ -1 +0,0 @@
-{"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;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAiBxE;AAMD;;;;;;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

@@ -1,268 +0,0 @@
-/**
- * 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}.
- *
- * @internal Exported for use by search and expand modules within this package.
- */
-export 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

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

package/dist/pass-through-chunker.d.ts

@@ -1,16 +0,0 @@
-/**
- * Pass-through chunker that returns the entire input as a single chunk.
- *
- * Suitable for short content such as findings, decisions, and insights
- * that do not need to be split before embedding.
- *
- * @module
- */
-import type { Chunker } from "./chunker.js";
-/**
- * Create a chunker that returns the input as a single chunk unchanged.
- *
- * @returns A {@link Chunker} that produces exactly one chunk per input.
- */
-export declare function createPassThroughChunker(): Chunker;
-//# sourceMappingURL=pass-through-chunker.d.ts.map

package/dist/pass-through-chunker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pass-through-chunker.d.ts","sourceRoot":"","sources":["../src/pass-through-chunker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAS,MAAM,cAAc,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAMlD"}

package/dist/pass-through-chunker.js

@@ -1,21 +0,0 @@
-/**
- * Pass-through chunker that returns the entire input as a single chunk.
- *
- * Suitable for short content such as findings, decisions, and insights
- * that do not need to be split before embedding.
- *
- * @module
- */
-/**
- * Create a chunker that returns the input as a single chunk unchanged.
- *
- * @returns A {@link Chunker} that produces exactly one chunk per input.
- */
-export function createPassThroughChunker() {
-    return {
-        chunk(content, metadata) {
-            return [{ text: content, index: 0, metadata }];
-        },
-    };
-}
-//# sourceMappingURL=pass-through-chunker.js.map

package/dist/pass-through-chunker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pass-through-chunker.js","sourceRoot":"","sources":["../src/pass-through-chunker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,KAAK,CAAC,OAAe,EAAE,QAAkC;YACvD,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/schema.d.ts

@@ -1,23 +0,0 @@
-/**
- * Neo4j schema initialization — constraints, indexes, and vector index.
- *
- * All statements use `IF NOT EXISTS` for idempotency and are safe to run
- * on every application startup.
- *
- * @module
- */
-/**
- * Cypher statements for schema initialization.
- *
- * Exported so tests can verify the exact statements that will be executed.
- */
-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}.
- */
-export declare function initSchema(): Promise<void>;
-//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +0,0 @@
-{"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"}

package/dist/schema.js

@@ -1,73 +0,0 @@
-/**
- * Neo4j schema initialization — constraints, indexes, and vector index.
- *
- * All statements use `IF NOT EXISTS` for idempotency and are safe to run
- * on every application startup.
- *
- * @module
- */
-import { getSession } from "./client.js";
-import { logger } from "./logger.js";
-import { NODE_LABEL, VECTOR_INDEX_NAME, EMBEDDING_DIMENSIONS, VECTOR_SIMILARITY_FUNCTION, } from "./constants.js";
-/**
- * Cypher statements for schema initialization.
- *
- * Exported so tests can verify the exact statements that will be executed.
- */
-export const SCHEMA_STATEMENTS = {
-    /** 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
-    FOR (n:${NODE_LABEL}) ON (n.kind)`,
-    /** 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
-    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"),
-};
-/**
- * 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}.
- */
-export async function initSchema() {
-    const session = getSession();
-    try {
-        for (const [name, cypher] of Object.entries(SCHEMA_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 });
-            }
-        }
-        logger.info("Knowledge graph schema initialized");
-    }
-    finally {
-        try {
-            await session.close();
-        }
-        catch (closeError) {
-            logger.warn({ err: closeError }, "Failed to close Neo4j session after schema initialization");
-        }
-    }
-}
-//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -1 +0,0 @@
-{"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"}

package/dist/search.d.ts

@@ -1,43 +0,0 @@
-/**
- * Vector-based semantic search across the knowledge graph.
- *
- * Embeds a text query, runs k-NN vector search against Neo4j's vector index,
- * and returns ranked results with similarity scores and immediate edges.
- *
- * @module
- */
-import type { Embedder } from "./embedder.js";
-import type { KnowledgeNode, KnowledgeEdge, NodeKind } from "./types.js";
-/** Options for knowledge graph search. */
-export interface SearchOptions {
-    /** Max results to return (default 10). */
-    limit?: number;
-    /** Filter to specific node kinds (reference, native, or both). */
-    nodeKinds?: NodeKind[];
-    /** Minimum similarity score threshold (default 0). Passed directly to the Cypher WHERE clause. */
-    minScore?: number;
-    /** Filter to a specific workspace. */
-    workspaceId?: string;
-}
-/** A search result: a node with its similarity score and immediate edges. */
-export interface SearchResult {
-    /** The matched node. */
-    node: KnowledgeNode;
-    /** Cosine similarity score (0-1). */
-    score: number;
-    /** Edges connected to this node. */
-    edges: KnowledgeEdge[];
-}
-/**
- * Search the knowledge graph by semantic similarity.
- *
- * Embeds the query text, runs k-NN vector search in Neo4j, and returns
- * ranked results with similarity scores and immediate edges.
- *
- * @param query - The text to search for.
- * @param embedder - Produces the query embedding vector.
- * @param options - Optional search filters and limits.
- * @returns Ranked search results, highest similarity first.
- */
-export declare function knowledgeSearch(query: string, embedder: Embedder, options?: SearchOptions): Promise<SearchResult[]>;
-//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMzE,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAgED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CA8DzB"}