@grackle-ai/mcp 0.64.2 → 0.65.0

package/dist/tool-scoping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-scoping.d.ts","sourceRoot":"","sources":["../src/tool-scoping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE,qDAAqD;AACrD,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAM3C,CAAC;AAKH,gDAAgD;AAChD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,GACvB,cAAc,GAAG,SAAS,CAS5B;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,GAAG,cAAc,EAAE,CAKnG"}
+{"version":3,"file":"tool-scoping.d.ts","sourceRoot":"","sources":["../src/tool-scoping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE,qDAAqD;AACrD,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAO3C,CAAC;AAKH,gDAAgD;AAChD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,GACvB,cAAc,GAAG,SAAS,CAS5B;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,GAAG,cAAc,EAAE,CAKnG"}

package/dist/tool-scoping.js

@@ -5,6 +5,7 @@ export const SCOPED_TOOLS = new Set([
     "session_send_input",
     "persona_list", "persona_show",
     "ipc_spawn", "ipc_write", "ipc_close", "ipc_list_fds",
+    "knowledge_search", "knowledge_get_node", "knowledge_create_node",
 ]);
 /** Auth types that receive full tool access. */
 const FULL_ACCESS_TYPES = new Set(["api-key", "oauth"]);

package/dist/tool-scoping.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-scoping.js","sourceRoot":"","sources":["../src/tool-scoping.ts"],"names":[],"mappings":"AAGA,qDAAqD;AACrD,MAAM,CAAC,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC;IACvD,cAAc,EAAE,cAAc;IAC9B,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe;IACtE,oBAAoB;IACpB,cAAc,EAAE,cAAc;IAC9B,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc;CACtD,CAAC,CAAC;AAEH,gDAAgD;AAChD,MAAM,iBAAiB,GAAqC,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAE1F,gDAAgD;AAChD,MAAM,UAAU,kBAAkB,CAChC,QAAsB,EACtB,IAAY,EACZ,WAAwB;IAExB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7E,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,QAAsB,EAAE,WAAwB;IAC/E,IAAI,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"tool-scoping.js","sourceRoot":"","sources":["../src/tool-scoping.ts"],"names":[],"mappings":"AAGA,qDAAqD;AACrD,MAAM,CAAC,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC;IACvD,cAAc,EAAE,cAAc;IAC9B,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe;IACtE,oBAAoB;IACpB,cAAc,EAAE,cAAc;IAC9B,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc;IACrD,kBAAkB,EAAE,oBAAoB,EAAE,uBAAuB;CAClE,CAAC,CAAC;AAEH,gDAAgD;AAChD,MAAM,iBAAiB,GAAqC,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAE1F,gDAAgD;AAChD,MAAM,UAAU,kBAAkB,CAChC,QAAsB,EACtB,IAAY,EACZ,WAAwB;IAExB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7E,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,QAAsB,EAAE,WAAwB;IAC/E,IAAI,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/tools/index.d.ts

@@ -1,4 +1,5 @@
 import { ToolRegistry } from "../tool-registry.js";
 /** Create a ToolRegistry pre-populated with all available MCP tools. */
 export declare function createToolRegistry(): ToolRegistry;
+export { setKnowledgeEmbedder } from "./knowledge.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAcnD,wEAAwE;AACxE,wBAAgB,kBAAkB,IAAI,YAAY,CAejD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAenD,wEAAwE;AACxE,wBAAgB,kBAAkB,IAAI,YAAY,CAgBjD;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tools/index.js

@@ -11,6 +11,7 @@ import { tokenTools } from "./token.js";
 import { configTools } from "./config.js";
 import { ipcTools } from "./ipc.js";
 import { usageTools } from "./usage.js";
+import { knowledgeTools } from "./knowledge.js";
 /** Create a ToolRegistry pre-populated with all available MCP tools. */
 export function createToolRegistry() {
     const registry = new ToolRegistry();
@@ -26,6 +27,8 @@ export function createToolRegistry() {
     registry.registerAll(configTools);
     registry.registerAll(ipcTools);
     registry.registerAll(usageTools);
+    registry.registerAll(knowledgeTools);
     return registry;
 }
+export { setKnowledgeEmbedder } from "./knowledge.js";
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,wEAAwE;AACxE,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,wEAAwE;AACxE,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IACrC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tools/knowledge.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP tools for the Grackle knowledge graph.
+ *
+ * Exposes high-level operations (search, retrieve, create) to agents.
+ * All embedding, graph storage, and traversal details are handled
+ * internally — agents interact with clean Grackle concepts.
+ *
+ * @module
+ */
+import { type Embedder } from "@grackle-ai/knowledge";
+import type { ToolDefinition } from "../tool-registry.js";
+/**
+ * Set the shared embedder instance for knowledge tools.
+ *
+ * Called once by the server at startup (before MCP serves requests).
+ * Pass `undefined` to clear the embedder (e.g., for testing).
+ */
+export declare function setKnowledgeEmbedder(e: Embedder | undefined): void;
+/** Knowledge graph MCP tools. */
+export declare const knowledgeTools: ToolDefinition[];
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/tools/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EASL,KAAK,QAAQ,EAMd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAW1D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAElE;AAiFD,iCAAiC;AACjC,eAAO,MAAM,cAAc,EAAE,cAAc,EAsV1C,CAAC"}

package/dist/tools/knowledge.js

@@ -0,0 +1,355 @@
+/**
+ * MCP tools for the Grackle knowledge graph.
+ *
+ * Exposes high-level operations (search, retrieve, create) to agents.
+ * All embedding, graph storage, and traversal details are handled
+ * internally — agents interact with clean Grackle concepts.
+ *
+ * @module
+ */
+import { z } from "zod";
+import { knowledgeSearch, getNode, createNativeNode, createEdge, expandNode, expandResults, NATIVE_CATEGORY, EDGE_TYPE, } from "@grackle-ai/knowledge";
+import { jsonResult } from "../result-helpers.js";
+import { logger } from "@grackle-ai/knowledge";
+// ---------------------------------------------------------------------------
+// Embedder accessor — set by the server at startup
+// ---------------------------------------------------------------------------
+/** Module-level embedder instance, initialized by the server. */
+let embedder;
+/**
+ * Set the shared embedder instance for knowledge tools.
+ *
+ * Called once by the server at startup (before MCP serves requests).
+ * Pass `undefined` to clear the embedder (e.g., for testing).
+ */
+export function setKnowledgeEmbedder(e) {
+    embedder = e;
+}
+/** Get the shared embedder, throwing if not initialized. */
+function requireEmbedder() {
+    if (!embedder) {
+        throw new Error("Knowledge graph not available. The embedder has not been initialized.");
+    }
+    return embedder;
+}
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Maximum allowed search results. */
+const MAX_SEARCH_LIMIT = 50;
+/** Maximum allowed expansion depth. */
+const MAX_EXPAND_DEPTH = 5;
+// ---------------------------------------------------------------------------
+// Response formatting — hide internal details from agents
+// ---------------------------------------------------------------------------
+/** Format a 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 an edge for agent consumption. */
+function formatEdge(edge) {
+    return {
+        fromId: edge.fromId,
+        toId: edge.toId,
+        type: edge.type,
+        ...(edge.metadata !== undefined ? { metadata: edge.metadata } : {}),
+    };
+}
+/** Format a search result for agent consumption. */
+function formatSearchResult(result) {
+    return {
+        score: Math.round(result.score * 1000) / 1000,
+        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)));
+}
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+/** Knowledge graph MCP tools. */
+export const knowledgeTools = [
+    {
+        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) {
+            const { query, limit, workspaceId, expand, expandDepth, } = args;
+            try {
+                const safeLimit = clampInt(limit, 1, MAX_SEARCH_LIMIT, 10);
+                const results = await knowledgeSearch(query, requireEmbedder(), { limit: safeLimit, workspaceId });
+                const formattedResults = results.map(formatSearchResult);
+                let neighbors;
+                let neighborEdges;
+                if (expand && results.length > 0) {
+                    const safeDepth = clampInt(expandDepth, 1, MAX_EXPAND_DEPTH, 1);
+                    const expansion = await expandResults(results, {
+                        depth: safeDepth,
+                    });
+                    neighbors = expansion.nodes.map(formatNode);
+                    neighborEdges = expansion.edges.map(formatEdge);
+                }
+                return jsonResult({
+                    results: formattedResults,
+                    ...(neighbors !== undefined ? { neighbors, neighborEdges } : {}),
+                });
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: error instanceof Error
+                                    ? error.message
+                                    : "Knowledge search failed",
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        },
+    },
+    {
+        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) {
+            const { id, expand, expandDepth } = args;
+            try {
+                const result = await getNode(id);
+                if (!result) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({ error: `Node not found: ${id}` }, null, 2),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const response = {
+                    node: formatNode(result.node),
+                    edges: result.edges.map(formatEdge),
+                };
+                if (expand) {
+                    const safeDepth = clampInt(expandDepth, 1, MAX_EXPAND_DEPTH, 1);
+                    const expansion = await expandNode(id, {
+                        depth: safeDepth,
+                    });
+                    response.neighbors = expansion.nodes.map(formatNode);
+                    response.neighborEdges = expansion.edges.map(formatEdge);
+                }
+                return jsonResult(response);
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: error instanceof Error
+                                    ? error.message
+                                    : "Failed to retrieve node",
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        },
+    },
+    {
+        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_TYPE.RELATES_TO,
+                    EDGE_TYPE.DEPENDS_ON,
+                    EDGE_TYPE.DERIVED_FROM,
+                    EDGE_TYPE.MENTIONS,
+                    EDGE_TYPE.PART_OF,
+                ])
+                    .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 { title, content, category, tags, workspaceId, edges, } = args;
+            try {
+                const emb = requireEmbedder();
+                const { vector } = await emb.embed(`${title} ${content}`);
+                // For scoped callers, always use the auth context workspace.
+                // For full-access callers, use the provided workspace or empty.
+                const resolvedWorkspaceId = authContext?.type === "scoped"
+                    ? authContext.workspaceId ?? ""
+                    : workspaceId ?? "";
+                const nodeId = await createNativeNode({
+                    category: category ?? NATIVE_CATEGORY.INSIGHT,
+                    title,
+                    content,
+                    tags: tags ?? [],
+                    embedding: vector,
+                    workspaceId: resolvedWorkspaceId,
+                });
+                // Create edges if requested
+                const createdEdges = [];
+                if (edges) {
+                    for (const edge of edges) {
+                        try {
+                            await createEdge(nodeId, edge.toId, edge.type);
+                            createdEdges.push({ toId: edge.toId, type: edge.type });
+                        }
+                        catch (edgeError) {
+                            logger.warn({ nodeId, toId: edge.toId, type: edge.type, err: edgeError }, "Failed to create edge for knowledge node");
+                            createdEdges.push({
+                                toId: edge.toId,
+                                type: edge.type,
+                                error: edgeError instanceof Error
+                                    ? edgeError.message
+                                    : "Failed to create edge",
+                            });
+                        }
+                    }
+                }
+                return jsonResult({
+                    id: nodeId,
+                    title,
+                    category: category ?? NATIVE_CATEGORY.INSIGHT,
+                    ...(createdEdges.length > 0 ? { edges: createdEdges } : {}),
+                });
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: error instanceof Error
+                                    ? error.message
+                                    : "Failed to create knowledge entry",
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        },
+    },
+];
+//# sourceMappingURL=knowledge.js.map

package/dist/tools/knowledge.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grackle-ai/mcp",
-  "version": "0.64.2",
+  "version": "0.65.0",
   "description": "MCP (Model Context Protocol) server for Grackle — translates MCP tool calls to ConnectRPC",
   "license": "MIT",
   "repository": {
@@ -33,7 +33,8 @@
     "@modelcontextprotocol/sdk": "^1.27.0",
     "pino": "^10.3.1",
     "zod": "^4.0.0",
-    "@grackle-ai/common": "0.64.2"
+    "@grackle-ai/common": "0.65.0",
+    "@grackle-ai/knowledge": "0.65.0"
   },
   "devDependencies": {
     "@rushstack/heft": "1.2.4",