@grackle-ai/plugin-knowledge 0.99.0

package/dist/knowledge-init.js.map

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

package/dist/knowledge-plugin.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Knowledge plugin factory.
+ *
+ * Wires Neo4j, embeddings, gRPC handlers, entity sync, and MCP tools
+ * into the Grackle plugin system.
+ *
+ * @module
+ */
+import type { GracklePlugin } from "@grackle-ai/plugin-sdk";
+/**
+ * Create the knowledge plugin that contributes Neo4j-backed knowledge graph
+ * capabilities to the Grackle server.
+ *
+ * - **gRPC handlers**: searchKnowledge, getKnowledgeNode, expandKnowledgeNode,
+ *   listRecentKnowledgeNodes, createKnowledgeNode
+ * - **Reconciliation phases**: knowledge-health (Neo4j connectivity check)
+ * - **Event subscribers**: entity sync (task/finding → knowledge graph)
+ * - **MCP tools**: knowledge_search, knowledge_get_node, knowledge_create_node
+ *
+ * Depends on the "core" plugin.
+ *
+ * @returns A GracklePlugin ready to pass to `loadPlugins()`.
+ */
+export declare function createKnowledgePlugin(): GracklePlugin;
+//# sourceMappingURL=knowledge-plugin.d.ts.map

package/dist/knowledge-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-plugin.d.ts","sourceRoot":"","sources":["../src/knowledge-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,wBAAwB,CAAC;AAkB3E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,IAAI,aAAa,CA0CrD"}

package/dist/knowledge-plugin.js

@@ -0,0 +1,66 @@
+/**
+ * Knowledge plugin factory.
+ *
+ * Wires Neo4j, embeddings, gRPC handlers, entity sync, and MCP tools
+ * into the Grackle plugin system.
+ *
+ * @module
+ */
+import { grackle } from "@grackle-ai/common";
+import { logger } from "./logger.js";
+import { initKnowledge, createEntitySyncSubscriber, neo4jHealthCheck, } from "./knowledge-init.js";
+import { createKnowledgeHealthPhase, markKnowledgeInitFailed } from "./knowledge-health.js";
+import { searchKnowledge, getKnowledgeNode, expandKnowledgeNode, listRecentKnowledgeNodes, createKnowledgeNode, } from "./knowledge-handlers.js";
+import { knowledgeMcpTools } from "./mcp-tools.js";
+/**
+ * Create the knowledge plugin that contributes Neo4j-backed knowledge graph
+ * capabilities to the Grackle server.
+ *
+ * - **gRPC handlers**: searchKnowledge, getKnowledgeNode, expandKnowledgeNode,
+ *   listRecentKnowledgeNodes, createKnowledgeNode
+ * - **Reconciliation phases**: knowledge-health (Neo4j connectivity check)
+ * - **Event subscribers**: entity sync (task/finding → knowledge graph)
+ * - **MCP tools**: knowledge_search, knowledge_get_node, knowledge_create_node
+ *
+ * Depends on the "core" plugin.
+ *
+ * @returns A GracklePlugin ready to pass to `loadPlugins()`.
+ */
+export function createKnowledgePlugin() {
+    let cleanup;
+    return {
+        name: "knowledge",
+        dependencies: ["core"],
+        initialize: async (ctx) => {
+            try {
+                cleanup = await initKnowledge(ctx);
+            }
+            catch (err) {
+                // Knowledge init failure (e.g. Neo4j unreachable) is non-fatal.
+                // Mark health as failed immediately so /readyz reflects accurate status.
+                markKnowledgeInitFailed();
+                logger.error({ err }, "Knowledge plugin initialization failed — running degraded");
+            }
+        },
+        shutdown: async () => {
+            await cleanup?.();
+            cleanup = undefined;
+        },
+        grpcHandlers: () => [{
+                service: grackle.Grackle,
+                handlers: {
+                    searchKnowledge,
+                    getKnowledgeNode,
+                    expandKnowledgeNode,
+                    listRecentKnowledgeNodes,
+                    createKnowledgeNode,
+                },
+            }],
+        reconciliationPhases: () => [
+            createKnowledgeHealthPhase({ healthCheck: neo4jHealthCheck }),
+        ],
+        eventSubscribers: (ctx) => [createEntitySyncSubscriber(ctx)],
+        mcpTools: () => knowledgeMcpTools,
+    };
+}
+//# sourceMappingURL=knowledge-plugin.js.map

package/dist/knowledge-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-plugin.js","sourceRoot":"","sources":["../src/knowledge-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,OAA0C,CAAC;IAE/C,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,YAAY,EAAE,CAAC,MAAM,CAAC;QAEtB,UAAU,EAAE,KAAK,EAAE,GAAkB,EAAiB,EAAE;YACtD,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,gEAAgE;gBAChE,yEAAyE;gBACzE,uBAAuB,EAAE,CAAC;gBAC1B,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,2DAA2D,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;QAED,QAAQ,EAAE,KAAK,IAAmB,EAAE;YAClC,MAAM,OAAO,EAAE,EAAE,CAAC;YAClB,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;QAED,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;gBACnB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE;oBACR,eAAe;oBACf,gBAAgB;oBAChB,mBAAmB;oBACnB,wBAAwB;oBACxB,mBAAmB;iBACpB;aACF,CAAC;QAEF,oBAAoB,EAAE,GAAG,EAAE,CAAC;YAC1B,0BAA0B,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;SAC9D;QAED,gBAAgB,EAAE,CAAC,GAAkB,EAAE,EAAE,CAAC,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC;QAE3E,QAAQ,EAAE,GAAG,EAAE,CAAC,iBAAiB;KAClC,CAAC;AACJ,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,4 @@
+import type { Logger } from "pino";
+/** Structured logger for the knowledge plugin — child of the core logger. */
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,6EAA6E;AAC7E,eAAO,MAAM,MAAM,EAAE,MAA+D,CAAC"}

package/dist/logger.js

@@ -0,0 +1,4 @@
+import { logger as coreLogger } from "@grackle-ai/core";
+/** Structured logger for the knowledge plugin — child of the core logger. */
+export const logger = coreLogger.child({ name: "grackle-plugin-knowledge" });
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAExD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,MAAM,GAAW,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,CAAC"}

package/dist/mcp-tools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP tools for the Grackle knowledge graph.
+ *
+ * Exposes high-level operations (search, retrieve, create) to agents.
+ * All calls go through gRPC to the Grackle server.
+ *
+ * @module
+ */
+import type { PluginToolDefinition } from "@grackle-ai/plugin-sdk";
+/** Knowledge graph MCP tools contributed by the plugin. */
+export declare const knowledgeMcpTools: PluginToolDefinition[];
+//# sourceMappingURL=mcp-tools.d.ts.map

package/dist/mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../src/mcp-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AA8FnE,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,EAAE,oBAAoB,EA+UnD,CAAC"}

package/dist/mcp-tools.js

@@ -0,0 +1,342 @@
+/**
+ * MCP tools for the Grackle knowledge graph.
+ *
+ * Exposes high-level operations (search, retrieve, create) to agents.
+ * All calls go through gRPC to the Grackle server.
+ *
+ * @module
+ */
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Maximum allowed search results. */
+const MAX_SEARCH_LIMIT = 50;
+/** Maximum allowed expansion depth. */
+const MAX_EXPAND_DEPTH = 5;
+/** Valid edge type values. */
+const EDGE_TYPES = [
+    "RELATES_TO",
+    "DEPENDS_ON",
+    "DERIVED_FROM",
+    "MENTIONS",
+    "PART_OF",
+];
+// ---------------------------------------------------------------------------
+// Response formatting — hide internal details from agents
+// ---------------------------------------------------------------------------
+/** Format a proto node for agent consumption. */
+function formatNode(node) {
+    const base = {
+        id: node.id,
+        kind: node.kind,
+        workspaceId: node.workspaceId,
+        createdAt: node.createdAt,
+        updatedAt: node.updatedAt,
+    };
+    if (node.kind === "reference") {
+        base.sourceType = node.sourceType;
+        base.sourceId = node.sourceId;
+        base.label = node.label;
+    }
+    else {
+        base.category = node.category;
+        base.title = node.title;
+        base.content = node.content;
+        base.tags = [...node.tags];
+    }
+    return base;
+}
+/** Format a proto edge for agent consumption. */
+function formatEdge(edge) {
+    const result = {
+        fromId: edge.fromId,
+        toId: edge.toId,
+        type: edge.type,
+    };
+    if (edge.metadataJson) {
+        try {
+            result.metadata = JSON.parse(edge.metadataJson);
+        }
+        catch {
+            // ignore malformed metadata
+        }
+    }
+    return result;
+}
+/** Format a search result for agent consumption. */
+function formatSearchResult(result) {
+    return {
+        score: Math.round(result.score * 1000) / 1000,
+        node: result.node ? formatNode(result.node) : {},
+        edges: result.edges.map(formatEdge),
+    };
+}
+/** Clamp a numeric input to a safe integer range. */
+function clampInt(value, min, max, defaultValue) {
+    if (value === undefined) {
+        return defaultValue;
+    }
+    return Math.max(min, Math.min(max, Math.floor(value)));
+}
+/** Return a JSON text content block. */
+function jsonResult(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+/** Knowledge graph MCP tools contributed by the plugin. */
+export const knowledgeMcpTools = [
+    {
+        name: "knowledge_search",
+        group: "knowledge",
+        description: "Search the knowledge graph using natural language. Returns relevant nodes " +
+            "(decisions, insights, task references, findings) ranked by semantic similarity.",
+        inputSchema: z.object({
+            query: z.string().describe("Natural language search query"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(MAX_SEARCH_LIMIT)
+                .optional()
+                .describe(`Maximum number of results to return (default 10, max ${MAX_SEARCH_LIMIT})`),
+            workspaceId: z
+                .string()
+                .optional()
+                .describe("Filter results to a specific workspace"),
+            expand: z
+                .boolean()
+                .optional()
+                .describe("If true, also return nodes connected to the search results (default false)"),
+            expandDepth: z
+                .number()
+                .int()
+                .min(1)
+                .max(MAX_EXPAND_DEPTH)
+                .optional()
+                .describe(`How many hops to traverse when expanding (default 1, max ${MAX_EXPAND_DEPTH})`),
+        }),
+        rpcMethod: "knowledgeSearch",
+        mutating: false,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        async handler(args, client, authContext) {
+            const typedClient = client;
+            const typedAuth = authContext;
+            const { query, limit, workspaceId, expand, expandDepth, } = args;
+            // For scoped callers, always use the auth context workspace.
+            const resolvedWorkspaceId = typedAuth?.type === "scoped"
+                ? typedAuth.workspaceId ?? ""
+                : workspaceId ?? "";
+            const safeLimit = clampInt(limit, 1, MAX_SEARCH_LIMIT, 10);
+            const response = await typedClient.searchKnowledge({
+                query,
+                limit: safeLimit,
+                workspaceId: resolvedWorkspaceId,
+            });
+            const formattedResults = response.results.map(formatSearchResult);
+            let neighbors;
+            let neighborEdges;
+            if (expand && response.results.length > 0) {
+                const safeDepth = clampInt(expandDepth, 1, MAX_EXPAND_DEPTH, 1);
+                const allNeighbors = new Map();
+                const allEdges = [];
+                const startIds = new Set(response.results.map((r) => r.node?.id ?? "").filter(Boolean));
+                for (const result of response.results) {
+                    if (!result.node) {
+                        continue;
+                    }
+                    const expansion = await typedClient.expandKnowledgeNode({
+                        id: result.node.id,
+                        depth: safeDepth,
+                    });
+                    for (const node of expansion.nodes) {
+                        if (!startIds.has(node.id)) {
+                            allNeighbors.set(node.id, formatNode(node));
+                        }
+                    }
+                    for (const edge of expansion.edges) {
+                        allEdges.push(formatEdge(edge));
+                    }
+                }
+                neighbors = [...allNeighbors.values()];
+                neighborEdges = allEdges;
+                if (typedAuth?.type === "scoped") {
+                    const allowedWorkspaceId = typedAuth.workspaceId ?? "";
+                    const allowedIds = new Set();
+                    neighbors = neighbors.filter((n) => {
+                        const allowed = n.workspaceId === allowedWorkspaceId;
+                        if (allowed) {
+                            allowedIds.add(n.id);
+                        }
+                        return allowed;
+                    });
+                    const allowedEdgeNodeIds = new Set([
+                        ...startIds,
+                        ...allowedIds,
+                    ]);
+                    neighborEdges = neighborEdges.filter((e) => allowedEdgeNodeIds.has(e.fromId) && allowedEdgeNodeIds.has(e.toId));
+                }
+            }
+            return jsonResult({
+                results: formattedResults,
+                ...(neighbors !== undefined ? { neighbors, neighborEdges } : {}),
+            });
+        },
+    },
+    {
+        name: "knowledge_get_node",
+        group: "knowledge",
+        description: "Retrieve a specific node from the knowledge graph by its ID, " +
+            "including all edges connecting it to other nodes.",
+        inputSchema: z.object({
+            id: z.string().describe("The node ID to retrieve"),
+            expand: z
+                .boolean()
+                .optional()
+                .describe("If true, also return neighbor nodes within expandDepth hops (default false)"),
+            expandDepth: z
+                .number()
+                .int()
+                .min(1)
+                .max(MAX_EXPAND_DEPTH)
+                .optional()
+                .describe(`How many hops to traverse when expanding (default 1, max ${MAX_EXPAND_DEPTH})`),
+        }),
+        rpcMethod: "knowledgeGetNode",
+        mutating: false,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        async handler(args, client, authContext) {
+            const typedClient = client;
+            const typedAuth = authContext;
+            const { id, expand, expandDepth } = args;
+            const response = await typedClient.getKnowledgeNode({ id });
+            if (!response.node) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ error: `Node not found: ${id}` }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (typedAuth?.type === "scoped") {
+                if (response.node.workspaceId !== (typedAuth.workspaceId ?? "")) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({ error: `Node not found: ${id}` }, null, 2),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+            }
+            const result = {
+                node: formatNode(response.node),
+                edges: response.edges.map(formatEdge),
+            };
+            if (expand) {
+                const safeDepth = clampInt(expandDepth, 1, MAX_EXPAND_DEPTH, 1);
+                const expansion = await typedClient.expandKnowledgeNode({ id, depth: safeDepth });
+                let expandedNodes = expansion.nodes.map(formatNode);
+                let expandedEdges = expansion.edges.map(formatEdge);
+                if (typedAuth?.type === "scoped") {
+                    const allowedWorkspaceId = typedAuth.workspaceId ?? "";
+                    const allowedIds = new Set([id]);
+                    expandedNodes = expandedNodes.filter((n) => {
+                        const allowed = n.workspaceId === allowedWorkspaceId;
+                        if (allowed) {
+                            allowedIds.add(n.id);
+                        }
+                        return allowed;
+                    });
+                    expandedEdges = expandedEdges.filter((e) => allowedIds.has(e.fromId) && allowedIds.has(e.toId));
+                }
+                result.neighbors = expandedNodes;
+                result.neighborEdges = expandedEdges;
+            }
+            return jsonResult(result);
+        },
+    },
+    {
+        name: "knowledge_create_node",
+        group: "knowledge",
+        description: "Create a new knowledge entry (decision, insight, concept, or snippet). " +
+            "The content is automatically embedded for future semantic search. " +
+            "Optionally link it to existing nodes.",
+        inputSchema: z.object({
+            title: z.string().describe("Title or summary of the knowledge entry"),
+            content: z
+                .string()
+                .describe("Full content to store and embed for search"),
+            category: z
+                .string()
+                .optional()
+                .describe("Category: decision, insight, concept, snippet (default: insight)"),
+            tags: z
+                .array(z.string())
+                .optional()
+                .describe("Tags for categorization"),
+            workspaceId: z
+                .string()
+                .optional()
+                .describe("Workspace to scope this entry to"),
+            edges: z
+                .array(z.object({
+                toId: z.string().describe("ID of the node to link to"),
+                type: z
+                    .enum(EDGE_TYPES)
+                    .describe("Relationship type: RELATES_TO, DEPENDS_ON, DERIVED_FROM, MENTIONS, PART_OF"),
+            }))
+                .optional()
+                .describe("Edges to create from this node to existing nodes"),
+        }),
+        rpcMethod: "knowledgeCreateNode",
+        mutating: true,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+        async handler(args, client, authContext) {
+            const typedClient = client;
+            const typedAuth = authContext;
+            const { title, content, category, tags, workspaceId, } = args;
+            // For scoped callers, always use the auth context workspace.
+            const resolvedWorkspaceId = typedAuth?.type === "scoped"
+                ? typedAuth.workspaceId ?? ""
+                : workspaceId ?? "";
+            const response = await typedClient.createKnowledgeNode({
+                title,
+                content,
+                category: category ?? "insight",
+                tags: tags ?? [],
+                workspaceId: resolvedWorkspaceId,
+            });
+            return jsonResult({
+                id: response.id,
+                title,
+                category: category ?? "insight",
+            });
+        },
+    },
+];
+//# sourceMappingURL=mcp-tools.js.map

package/dist/mcp-tools.js.map

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

package/dist/proto-converters.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Proto converters for knowledge graph types.
+ *
+ * @module
+ */
+import { grackle } from "@grackle-ai/common";
+import type { KnowledgeNode, KnowledgeEdge } from "@grackle-ai/knowledge";
+/** Convert a KnowledgeNode to its proto representation. */
+export declare function knowledgeNodeToProto(node: KnowledgeNode): grackle.KnowledgeNodeProto;
+/** Convert a KnowledgeEdge to its proto representation. */
+export declare function knowledgeEdgeToProto(edge: KnowledgeEdge): grackle.KnowledgeEdgeProto;
+//# sourceMappingURL=proto-converters.d.ts.map

package/dist/proto-converters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proto-converters.d.ts","sourceRoot":"","sources":["../src/proto-converters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE1E,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAepF;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAQpF"}

package/dist/proto-converters.js

@@ -0,0 +1,35 @@
+/**
+ * Proto converters for knowledge graph types.
+ *
+ * @module
+ */
+import { create } from "@bufbuild/protobuf";
+import { grackle } from "@grackle-ai/common";
+/** Convert a KnowledgeNode to its proto representation. */
+export function knowledgeNodeToProto(node) {
+    return create(grackle.KnowledgeNodeProtoSchema, {
+        id: node.id,
+        kind: node.kind,
+        workspaceId: node.workspaceId,
+        createdAt: node.createdAt,
+        updatedAt: node.updatedAt,
+        sourceType: node.kind === "reference" ? node.sourceType : "",
+        sourceId: node.kind === "reference" ? node.sourceId : "",
+        label: node.kind === "reference" ? node.label : "",
+        category: node.kind === "native" ? node.category : "",
+        title: node.kind === "native" ? node.title : "",
+        content: node.kind === "native" ? node.content : "",
+        tags: node.kind === "native" ? node.tags : [],
+    });
+}
+/** Convert a KnowledgeEdge to its proto representation. */
+export function knowledgeEdgeToProto(edge) {
+    return create(grackle.KnowledgeEdgeProtoSchema, {
+        fromId: edge.fromId,
+        toId: edge.toId,
+        type: edge.type,
+        metadataJson: edge.metadata ? JSON.stringify(edge.metadata) : "",
+        createdAt: edge.createdAt,
+    });
+}
+//# sourceMappingURL=proto-converters.js.map

package/dist/proto-converters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proto-converters.js","sourceRoot":"","sources":["../src/proto-converters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,2DAA2D;AAC3D,MAAM,UAAU,oBAAoB,CAAC,IAAmB;IACtD,OAAO,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE;QAC9C,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;QAC5D,QAAQ,EAAE,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QACxD,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAClD,QAAQ,EAAE,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QACrD,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAC/C,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACnD,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;KAC9C,CAAC,CAAC;AACL,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,oBAAoB,CAAC,IAAmB;IACtD,OAAO,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE;QAC9C,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QAChE,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.57.7"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@grackle-ai/plugin-knowledge",
+  "version": "0.99.0",
+  "description": "Knowledge graph plugin for Grackle — Neo4j, embeddings, and knowledge MCP tools",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nick-pape/grackle.git",
+    "directory": "packages/plugin-knowledge"
+  },
+  "keywords": [
+    "grackle",
+    "plugin",
+    "knowledge",
+    "neo4j"
+  ],
+  "homepage": "https://github.com/nick-pape/grackle#readme",
+  "bugs": {
+    "url": "https://github.com/nick-pape/grackle/issues"
+  },
+  "engines": {
+    "node": ">=22.0.0 <24.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.5.0",
+    "@connectrpc/connect": "^2.0.0",
+    "pino": "^10.3.1",
+    "zod": "^4.0.0",
+    "@grackle-ai/auth": "0.99.0",
+    "@grackle-ai/common": "0.99.0",
+    "@grackle-ai/database": "0.99.0",
+    "@grackle-ai/core": "0.99.0",
+    "@grackle-ai/knowledge": "0.99.0",
+    "@grackle-ai/plugin-sdk": "0.99.0"
+  },
+  "devDependencies": {
+    "@rushstack/heft": "1.2.7",
+    "@types/node": "^22.0.0",
+    "vitest": "^3.2.1",
+    "@grackle-ai/heft-rig": "0.0.1"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "test": "vitest run",
+    "clean": "heft clean",
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "vitest run"
+  }
+}