@nebutra/mcp 4.0.0 → 4.0.1

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @nebutra/mcp
 
+## 4.0.1
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @nebutra/ui@4.0.1
+  - @nebutra/capability-kit@4.0.1
+  - @nebutra/errors@4.0.1
+  - @nebutra/event-log@4.0.1
+  - @nebutra/trace-store@4.0.1
+
 ## 4.0.0
 
 ### Patch Changes

package/dist/{chunk-YMTQFRV2.js → chunk-OPM7YNM4.js}

@@ -9,6 +9,13 @@ import {
   ListToolsRequestSchema,
   ReadResourceRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
+import {
+  encodePreset,
+  presetArgument,
+  presetJsonSchema,
+  readPresetInput,
+  studioReviewUrl
+} from "@nebutra/tokens/preset";
 var NebutraContextServer = class {
   server;
   projectRoot;
@@ -108,11 +115,16 @@ function createContextServerHandlers(projectRoot) {
               properties: {},
               required: []
             }
-          }
+          },
+          ...STUDIO_TOOLS
         ]
       };
     },
-    async callTool({ name }) {
+    async callTool({
+      name,
+      arguments: args
+    }) {
+      if (name.startsWith("studio_")) return callStudioTool(projectRoot, name, args ?? {});
       if (name !== "get_project_structure") {
         throw new Error(`Unknown tool: ${name}`);
       }
@@ -139,6 +151,78 @@ function createContextServerHandlers(projectRoot) {
     }
   };
 }
+var PRESET_ARG = {
+  preset: {
+    description: "A preset object (see studio_preset_schema), its JSON text, a preset code, a base id, or a Studio link."
+  }
+};
+var STUDIO_TOOLS = [
+  {
+    name: "studio_preset_schema",
+    description: "JSON Schema for a Sailor Studio preset: the base design language and every knob with its allowed values.",
+    inputSchema: { type: "object", properties: {}, required: [] }
+  },
+  {
+    name: "studio_preview",
+    description: "Validate a preset and return the Sailor Studio link to show the person, plus the commands that apply it. Ask them to review the link before pulling.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...PRESET_ARG,
+        from: { type: "string", description: "Who proposed it, shown on the Studio banner" }
+      },
+      required: ["preset"]
+    }
+  },
+  {
+    name: "studio_pull",
+    description: "Write an approved preset onto this Sailor project (packages/design/tokens/project/preset). Run `pnpm --filter @nebutra/tokens build` afterwards, or use `nebutra studio pull`, which does both.",
+    inputSchema: { type: "object", properties: PRESET_ARG, required: ["preset"] }
+  }
+];
+var text = (value) => ({
+  content: [
+    { type: "text", text: typeof value === "string" ? value : JSON.stringify(value, null, 2) }
+  ]
+});
+function callStudioTool(projectRoot, name, args) {
+  try {
+    if (name === "studio_preset_schema") return text(presetJsonSchema());
+    const preset = readPresetInput(args.preset);
+    const code = presetArgument(preset);
+    if (name === "studio_preview") {
+      const from = typeof args.from === "string" ? args.from : "agent";
+      return text({
+        code,
+        preset,
+        reviewUrl: studioReviewUrl(preset, from),
+        apply: `nebutra studio pull ${code}`,
+        create: `npx create-sailor@latest my-app --preset ${code}`
+      });
+    }
+    if (name === "studio_pull") {
+      const tokens = path.join(projectRoot, "packages", "design", "tokens");
+      if (!fs.existsSync(path.join(tokens, "package.json"))) {
+        throw new Error(`${projectRoot} is not a Sailor project (no packages/design/tokens).`);
+      }
+      const file = path.join(tokens, "project", "preset");
+      fs.mkdirSync(path.dirname(file), { recursive: true });
+      fs.writeFileSync(file, `${encodePreset(preset)}
+`);
+      return text({
+        written: path.relative(projectRoot, file),
+        code,
+        next: "pnpm --filter @nebutra/tokens build"
+      });
+    }
+    throw new Error(`Unknown tool: ${name}`);
+  } catch (error) {
+    return {
+      ...text(`Error: ${error instanceof Error ? error.message : String(error)}`),
+      isError: true
+    };
+  }
+}
 function getProjectStructure(projectRoot) {
   const roots = ["apps", "packages", "backends"].filter(
     (segment) => fs.existsSync(path.join(projectRoot, segment))
@@ -174,5 +258,7 @@ if (process.argv[1]?.endsWith("contextServer.js") || process.argv[1]?.endsWith("
 
 export {
   createContextServerHandlers,
+  STUDIO_TOOLS,
+  callStudioTool,
   startContextServer
 };

package/dist/cli.js

@@ -5,7 +5,7 @@ import {
 import "./chunk-EMIF5K3P.js";
 import {
   createContextServerHandlers
-} from "./chunk-YMTQFRV2.js";
+} from "./chunk-OPM7YNM4.js";
 
 // src/cli.ts
 var command = process.argv[2] ?? "doctor";

package/dist/server/contextServer.d.ts

@@ -18,7 +18,19 @@ declare function createContextServerHandlers(projectRoot: string): {
         }[];
     }>;
     listTools(): Promise<{
-        tools: {
+        tools: ({
+            name: string;
+            description: string;
+            inputSchema: {
+                type: string;
+                properties: {
+                    preset: {
+                        description: string;
+                    };
+                };
+                required: string[];
+            };
+        } | {
             name: string;
             description: string;
             inputSchema: {
@@ -26,9 +38,9 @@ declare function createContextServerHandlers(projectRoot: string): {
                 properties: {};
                 required: never[];
             };
-        }[];
+        })[];
     }>;
-    callTool({ name }: {
+    callTool({ name, arguments: args, }: {
         name: string;
         arguments?: Record<string, unknown> | undefined;
     }): Promise<{
@@ -36,15 +48,57 @@ declare function createContextServerHandlers(projectRoot: string): {
             type: string;
             text: string;
         }[];
-        isError?: never;
-    } | {
-        content: {
-            type: string;
-            text: string;
-        }[];
-        isError: boolean;
     }>;
 };
+declare const STUDIO_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            from: {
+                type: string;
+                description: string;
+            };
+            preset: {
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            preset: {
+                description: string;
+            };
+        };
+        required: string[];
+    };
+})[];
+declare function callStudioTool(projectRoot: string, name: string, args: Record<string, unknown>): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+} | {
+    isError: boolean;
+    content: {
+        type: string;
+        text: string;
+    }[];
+};
 declare const startContextServer: () => void;
 
-export { createContextServerHandlers, startContextServer };
+export { STUDIO_TOOLS, callStudioTool, createContextServerHandlers, startContextServer };

package/dist/server/contextServer.js

@@ -1,9 +1,13 @@
 #!/usr/bin/env node
 import {
+  STUDIO_TOOLS,
+  callStudioTool,
   createContextServerHandlers,
   startContextServer
-} from "../chunk-YMTQFRV2.js";
+} from "../chunk-OPM7YNM4.js";
 export {
+  STUDIO_TOOLS,
+  callStudioTool,
   createContextServerHandlers,
   startContextServer
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebutra/mcp",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -42,10 +42,11 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
     "zod": "^4.3.6",
-    "@nebutra/capability-kit": "4.0.0",
-    "@nebutra/errors": "4.0.0",
-    "@nebutra/event-log": "4.0.0",
-    "@nebutra/trace-store": "4.0.0"
+    "@nebutra/capability-kit": "4.0.1",
+    "@nebutra/errors": "4.0.1",
+    "@nebutra/tokens": "4.0.1",
+    "@nebutra/event-log": "4.0.1",
+    "@nebutra/trace-store": "4.0.1"
   },
   "devDependencies": {
     "tsup": "^8.5.1",
@@ -72,7 +73,7 @@
     "CHANGELOG.md"
   ],
   "peerDependencies": {
-    "@nebutra/ui": "4.0.0"
+    "@nebutra/ui": "4.0.1"
   },
   "peerDependenciesMeta": {
     "@nebutra/ui": {