@skyelight/mcp 0.5.2 → 0.6.0

package/CHANGELOG.md

@@ -11,6 +11,28 @@ keeps working. A **patch** is a fix or a wording change. A **major** would be
 removing a tool or an argument, or changing what an existing field means, and
 there has not been one.
 
+## 0.6.0 — unreleased
+
+### Added
+
+- **`publish_prototype`.** Hosts a prototype on Skyelight: pass the complete
+  code of one file (an HTML page, or one React component with an export
+  default) and Skyelight serves it at its own link with the review badge on
+  it, in a project of your choosing or a new one. Returns the share link and
+  the project link. Publishing again with the same `prototypeId`, or the same
+  name in the same project, makes a new version at the same link. Owners,
+  admins and collaborators; on a person's own connection.
+
+## 0.5.3 — 2026-10-02
+
+### Changed
+
+- **License.** `@skyelight/mcp` is now proprietary ("UNLICENSED" on npm; see
+  `LICENSE`): it may be used to connect your own tools to your own Skyelight
+  account, and not copied, modified or redistributed. Versions up to 0.5.2
+  stay under the MIT License they were published with. No change to the
+  tools or how they behave.
+
 ## 0.5.2 — 2026-09-30
 
 ### Changed

package/LICENSE

@@ -1,21 +1,17 @@
-MIT License
+Copyright (c) 2026 Plastr Lab. All rights reserved.
 
-Copyright (c) 2026 Plastr Lab
+This software is proprietary. It is licensed, not sold, for use with the
+Skyelight service (https://skyelight.ai) under the Skyelight terms of
+service. You may install and run it to connect your own tools to your own
+Skyelight account. You may not copy, modify, distribute, sublicense or sell
+it, or use it with any other service, without Plastr Lab's written
+permission.
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+Versions of this package published before 0.5.3 were released under the MIT
+License, and those versions remain under it.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+LIABILITY ARISING FROM THE USE OF THE SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyelight/mcp",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "MCP server for Skyelight — read feedback items from your project as an agent",
   "type": "module",
   "bin": {
@@ -25,7 +25,7 @@
     "skyelight",
     "feedback"
   ],
-  "license": "MIT",
+  "license": "UNLICENSED",
   "homepage": "https://skyelight.ai",
   "publishConfig": {
     "access": "public"

package/src/brand.js

@@ -61,4 +61,8 @@ export const STATUS = {
   merge_items: ["Merging duplicates", "Merged the duplicates"],
   decision_log: ["Reading the decisions", "Read the decisions"],
   save_rule: ["Saving the rule", "Saved the rule"],
+  publish_prototype: [
+    "Publishing the prototype to Skyelight",
+    "Published the prototype",
+  ],
 };

package/src/client.js

@@ -110,5 +110,6 @@ export function createClient({ apiUrl, token, fetchImpl = fetch }) {
     mergeItems: (body) => post("/api/v1/items/merge", body),
     decisionLog: (params) => request("/api/v1/decisions", params),
     saveRule: (body) => post("/api/v1/rules", body),
+    publishPrototype: (body) => post("/api/v1/prototypes/publish", body),
   };
 }

package/src/tools.d.ts

@@ -41,6 +41,7 @@ export declare function renderProjects(result: unknown): string;
 export declare function renderMembers(result: unknown): string;
 export declare function renderAssigned(result: unknown): string;
 
+export declare function renderPublished(result: unknown): string;
 export declare function renderPosted(
   result: unknown,
   opts: { kind: "update" | "item" },

package/src/tools.js

@@ -203,6 +203,52 @@ export function toolDefinitions(opts = {}) {
         required: ["url", "body"],
       },
     },
+    {
+      name: "publish_prototype",
+      description:
+        "Host a prototype on Skyelight so people can review it: Skyelight serves the code at " +
+        "its own link with the review badge on it, and their pins land in a Skyelight project. " +
+        "Pass the complete code of one file: a whole HTML page, or one React component with " +
+        "an export default (Tailwind classes and npm imports work; local imports such as " +
+        "@/components do not). Returns the share link and the project link; give both to the " +
+        "person. Publishing again with the same prototypeId, or the same name in the same " +
+        "project, makes a new version at the same link. The link is public to anyone who has it.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          name: {
+            type: "string",
+            description:
+              "What it is, in a few words. Names the link and, when no project is given, a new project.",
+          },
+          code: {
+            type: "string",
+            description: "The complete file. Never a summary or an excerpt.",
+          },
+          kind: {
+            type: "string",
+            enum: ["html", "react"],
+            description: "Optional; worked out from the code when left out.",
+          },
+          projectId: {
+            type: "string",
+            description:
+              "Optional: the project to put it in. Left out, a new project is made for it.",
+          },
+          prototypeId: {
+            type: "string",
+            description:
+              "To publish a new version of a prototype published before.",
+          },
+          workspaceId: {
+            type: "string",
+            description:
+              "When you are in more than one workspace and give no project, from list_workspaces.",
+          },
+        },
+        required: ["code"],
+      },
+    },
     {
       name: "list_members",
       description:
@@ -340,6 +386,8 @@ const TOOL_ANNOTATIONS = {
   save_rule: { ...WRITE, idempotentHint: true },
   // Hides items from every list (reversible in the app, but not here).
   merge_items: { ...WRITE, destructiveHint: true },
+  // Puts code at a public link: something the person should agree to.
+  publish_prototype: { ...WRITE, openWorldHint: true },
 };
 
 function plural(n, one, many) {
@@ -749,6 +797,19 @@ export function renderPosted(result, { kind }) {
   );
 }
 
+export function renderPublished(result) {
+  const lines = [
+    result.newPrototype
+      ? `Published "${result.name}" in ${result.projectName}.`
+      : `Published version ${result.version}. The link is the same, and shows this version now.`,
+    `Share link: ${result.shareUrl}`,
+    `Project: ${result.projectUrl}${result.createdProject ? " (new project)" : ""}`,
+    `prototypeId ${result.prototypeId}: pass it to publish the next version at the same link.`,
+    "Anyone with the share link can open it; people sign in to Skyelight to leave pins.",
+  ];
+  return lines.join("\n");
+}
+
 export function renderMembers(result) {
   const members = result?.members ?? [];
   const where = result?.workspace?.name ? ` in ${result.workspace.name}` : "";
@@ -836,6 +897,26 @@ export async function callTool(name, args, { client, config }) {
     return { text: renderPosted(result, { kind: "item" }), data: result };
   }
 
+  if (name === "publish_prototype") {
+    if (!args.code?.trim()) {
+      throw new Error(
+        "publish_prototype needs code: the whole page, or one React component",
+      );
+    }
+    if (!args.prototypeId && !args.name?.trim()) {
+      throw new Error("publish_prototype needs a name");
+    }
+    const result = await client.publishPrototype({
+      name: args.name ?? "",
+      code: args.code,
+      ...(args.kind ? { kind: args.kind } : {}),
+      ...(args.projectId ? { projectId: args.projectId } : {}),
+      ...(args.prototypeId ? { prototypeId: args.prototypeId } : {}),
+      ...(args.workspaceId ? { workspaceId: args.workspaceId } : {}),
+    });
+    return { text: renderPublished(result), data: result };
+  }
+
   if (name === "list_members") {
     const result = await client.listMembers({
       projectId,

package/src/version.js

@@ -12,4 +12,4 @@
  * filesystem there. `test/server.test.js` asserts the two agree, so the pair
  * cannot drift again without a test going red.
  */
-export const VERSION = "0.5.2";
+export const VERSION = "0.6.0";