construct-shader-graph-mcp 0.7.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "construct-shader-graph-mcp",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Standalone MCP server for Construct Shader Graph",
   "type": "module",
   "files": [

package/src/guidance/skill.md

@@ -124,6 +124,7 @@ Read-only calls:
 - `getManifest`
 - `nodes.list`
 - `nodes.get`
+- `nodes.getInfo`
 - `nodes.getPorts`
 - `nodes.search`
 - `nodeTypes.list`
@@ -223,7 +224,7 @@ This is one of the most important workflows.
 
 To change a node's editable input values:
 
-1. Read the node with `nodes.get(nodeId)`.
+1. Read the node with `nodes.getInfo(nodeId)`.
 2. Inspect `editableInputValues` to see which inputs are editable and currently unconnected.
 3. Edit with `nodes.edit(nodeId, { inputValues: ... })`.
 
@@ -236,10 +237,10 @@ Rules:
 
 Example workflow:
 
-- call `nodes.get(nodeId)`
+- call `nodes.getInfo(nodeId)`
 - inspect `editableInputValues`
 - call `nodes.edit(nodeId, { inputValues: { B: [0, 0, 0, 1] } })`
-- re-read the node with `nodes.get(nodeId)`
+- re-read the node with `nodes.getInfo(nodeId)`
 
 Name-based example:
 

package/src/server.mjs

@@ -33,7 +33,60 @@ function nowIso() {
 }
 
 function loadSkillText() {
-  return fs.readFileSync(SKILL_PATH, "utf8");
+  try {
+    return fs.readFileSync(SKILL_PATH, "utf8");
+  } catch {
+    return null;
+  }
+}
+
+async function fetchGuidanceFromApp() {
+  if (!selectedSessionId) {
+    return null;
+  }
+
+  const session = sessions.get(selectedSessionId);
+  if (!session) {
+    return null;
+  }
+
+  try {
+    const result = await invokeSession(session, "getGuidance", []);
+    if (result?.ok && result.result) {
+      return result.result;
+    }
+  } catch {
+    // Fall back to local file.
+  }
+
+  return null;
+}
+
+async function getSkillText() {
+  const appGuidance = await fetchGuidanceFromApp();
+  if (appGuidance?.skill) {
+    return appGuidance.skill;
+  }
+
+  return loadSkillText() || "No guidance available.";
+}
+
+async function getQuickstartText() {
+  const appGuidance = await fetchGuidanceFromApp();
+  if (appGuidance?.quickstart) {
+    return appGuidance.quickstart;
+  }
+
+  return loadQuickstartText();
+}
+
+async function getPromptPreambleText() {
+  const appGuidance = await fetchGuidanceFromApp();
+  if (appGuidance?.preamble) {
+    return appGuidance.preamble;
+  }
+
+  return getPromptPreamble();
 }
 
 function loadQuickstartText() {
@@ -65,7 +118,7 @@ Use MCP tools only.
 ## Important method patterns
 
 - Discover node types: nodeTypes.search, nodeTypes.list, nodeTypes.get
-- Inspect graph: nodes.list, nodes.get, nodes.getPorts, wires.getAll, uniforms.list
+- Inspect graph: nodes.list, nodes.getInfo, nodes.getPorts, wires.getAll, uniforms.list
 - Edit node input values: nodes.edit(nodeId, { inputValues: { PortName: value } })
 - Wire nodes: wires.create({ from, to }) after inspecting both ports
 - Validate: ai.runDebugCheck({ includeScreenshot: true })
@@ -86,7 +139,7 @@ function getPromptPreamble() {
 function getSessionSummary(session) {
   return {
     sessionId: session.sessionId,
-    project: session.project,
+    projectName: session.project?.name || "Untitled Shader",
     connectedAt: session.connectedAt,
     updatedAt: session.updatedAt,
     manifestVersion: session.manifest?.version || null,
@@ -170,7 +223,7 @@ function createToolDefinitions() {
       handler: async () => {
         const result = {
           title: "Construct Shader Graph MCP Guidance",
-          content: loadSkillText(),
+          content: await getSkillText(),
         };
         return {
           content: [{ type: "text", text: result.content }],
@@ -188,14 +241,7 @@ function createToolDefinitions() {
           projects: z.array(
             z.object({
               sessionId: z.string(),
-              project: z.object({
-                name: z.string(),
-                version: z.string().optional(),
-                author: z.string().optional(),
-                category: z.string().optional(),
-                description: z.string().optional(),
-                shaderInfo: z.any().optional(),
-              }),
+              projectName: z.string(),
               connectedAt: z.string(),
               updatedAt: z.string(),
               manifestVersion: z.string().nullable(),
@@ -234,7 +280,7 @@ function createToolDefinitions() {
         },
         outputSchema: {
           sessionId: z.string(),
-          project: z.any(),
+          projectName: z.string(),
         },
       },
       handler: async ({ sessionId }) => {
@@ -242,7 +288,7 @@ function createToolDefinitions() {
         selectedSessionId = sessionId;
         const result = {
           sessionId,
-          project: session.project,
+          projectName: session.project?.name || "Untitled Shader",
         };
         return {
           content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
@@ -263,7 +309,6 @@ function createToolDefinitions() {
         },
         outputSchema: {
           sessionId: z.string(),
-          project: z.any(),
           manifest: z.any(),
         },
       },
@@ -273,7 +318,6 @@ function createToolDefinitions() {
           : ensureSelectedSession();
         const result = {
           sessionId: session.sessionId,
-          project: session.project,
           manifest: session.manifest,
         };
         return {
@@ -304,7 +348,7 @@ function createToolDefinitions() {
         },
         outputSchema: {
           sessionId: z.string(),
-          project: z.any(),
+          // project: z.any(),
           method: z.string(),
           args: z.array(z.any()),
           durationMs: z.number(),
@@ -348,7 +392,7 @@ function registerResources(server) {
         {
           uri: uri.href,
           mimeType: "text/markdown",
-          text: loadSkillText(),
+          text: await getSkillText(),
         },
       ],
     }),
@@ -367,108 +411,7 @@ function registerResources(server) {
         {
           uri: uri.href,
           mimeType: "text/markdown",
-          text: loadQuickstartText(),
-        },
-      ],
-    }),
-  );
-}
-
-function registerPrompts(server) {
-  server.registerPrompt(
-    "work-with-shader-graph",
-    {
-      title: "Work With Shader Graph",
-      description:
-        "General prompt for safely inspecting and editing a Construct Shader Graph project.",
-      argsSchema: z.object({
-        task: z.string().optional().describe("The user task to accomplish."),
-      }),
-    },
-    ({ task }) => ({
-      messages: [
-        {
-          role: "user",
-          content: {
-            type: "text",
-            text: `${getPromptPreamble()}\n\nFollow the full guidance resource if more detail is needed.\n\nTask: ${task || "Inspect the current project, understand its graph state, and proceed safely."}`,
-          },
-        },
-      ],
-    }),
-  );
-
-  server.registerPrompt(
-    "inspect-graph",
-    {
-      title: "Inspect Graph",
-      description:
-        "Prompt for safely inspecting the current graph before any edits.",
-      argsSchema: z.object({
-        focus: z
-          .string()
-          .optional()
-          .describe(
-            "Optional area to inspect, like uniforms, preview, or node types.",
-          ),
-      }),
-    },
-    ({ focus }) => ({
-      messages: [
-        {
-          role: "user",
-          content: {
-            type: "text",
-            text: `${getPromptPreamble()}\n\nInspect the current graph without mutating it. Read nodes, wires, uniforms, shader info, and any relevant settings first. ${focus ? `Focus on: ${focus}.` : ""}`,
-          },
-        },
-      ],
-    }),
-  );
-
-  server.registerPrompt(
-    "edit-graph-safely",
-    {
-      title: "Edit Graph Safely",
-      description: "Prompt for making a small validated graph edit with MCP.",
-      argsSchema: z.object({
-        task: z.string().describe("The graph edit to perform."),
-      }),
-    },
-    ({ task }) => ({
-      messages: [
-        {
-          role: "user",
-          content: {
-            type: "text",
-            text: `${getPromptPreamble()}\n\nMake the smallest valid change that satisfies this task: ${task}\n\nBefore wiring, inspect ports. Before choosing a node type, use nodeTypes.search or nodeTypes.list. After each structural edit, re-read affected nodes or ports and validate preview/code if relevant.`,
-          },
-        },
-      ],
-    }),
-  );
-
-  server.registerPrompt(
-    "debug-preview-errors",
-    {
-      title: "Debug Preview Errors",
-      description:
-        "Prompt for debugging generated code or preview issues in a shader graph project.",
-      argsSchema: z.object({
-        issue: z
-          .string()
-          .optional()
-          .describe("Optional description of the observed preview issue."),
-      }),
-    },
-    ({ issue }) => ({
-      messages: [
-        {
-          role: "user",
-          content: {
-            type: "text",
-            text: `${getPromptPreamble()}\n\nDebug the current shader graph by inspecting shader.getGeneratedCode, preview.getErrors, preview settings, node preview, and ai.runDebugCheck. ${issue ? `Observed issue: ${issue}` : ""}`,
-          },
+          text: await getQuickstartText(),
         },
       ],
     }),
@@ -482,7 +425,6 @@ function createLocalServer() {
   });
 
   registerResources(server);
-  registerPrompts(server);
   createToolDefinitions().forEach((tool) => {
     server.registerTool(tool.name, tool.config, tool.handler);
   });
@@ -697,7 +639,6 @@ function createProxyServer() {
   });
 
   registerResources(server);
-  registerPrompts(server);
   createToolDefinitions().forEach((tool) => {
     server.registerTool(tool.name, tool.config, async (input = {}) => {
       return callPrimaryTool(tool.name, input);