@schoolai/shipyard-mcp 0.4.0 → 0.4.1-nightly.20260127

package/README.md

@@ -47,7 +47,11 @@ Shipyard is just an MCP server. One command or a simple JSON config—works with
 Full experience with hooks, skills, and auto-task creation:
 
 ```bash
-/plugin install SchoolAI/shipyard
+# Step 1: Add the marketplace
+/plugin marketplace add https://github.com/SchoolAI/shipyard.git
+
+# Step 2: Install the plugin
+/plugin install shipyard@schoolai-shipyard
 ```
 
 ### Cursor
@@ -59,7 +63,7 @@ Add to `~/.cursor/mcp.json`:
   "mcpServers": {
     "shipyard": {
       "command": "npx",
-      "args": ["-y", "@schoolai/shipyard-mcp@latest"]
+      "args": ["-y", "-p", "@schoolai/shipyard-mcp@latest", "mcp-server-shipyard"]
     }
   }
 }
@@ -70,7 +74,7 @@ Add to `~/.cursor/mcp.json`:
 Add via CLI:
 
 ```bash
-codex mcp add shipyard -- npx -y @schoolai/shipyard-mcp@latest
+codex mcp add shipyard -- npx -y -p @schoolai/shipyard-mcp@latest mcp-server-shipyard
 ```
 
 Or add to `~/.codex/config.toml`:
@@ -78,13 +82,13 @@ Or add to `~/.codex/config.toml`:
 ```toml
 [mcp_servers.shipyard]
 command = "npx"
-args = ["-y", "@schoolai/shipyard-mcp@latest"]
+args = ["-y", "-p", "@schoolai/shipyard-mcp@latest", "mcp-server-shipyard"]
 ```
 
 ### VS Code / GitHub Copilot
 
 ```bash
-code --add-mcp '{"name":"shipyard","command":"npx","args":["-y","@schoolai/shipyard-mcp@latest"]}'
+code --add-mcp '{"name":"shipyard","command":"npx","args":["-y","-p","@schoolai/shipyard-mcp@latest","mcp-server-shipyard"]}'
 ```
 
 <details>
@@ -102,7 +106,7 @@ Add to your config file:
   "mcpServers": {
     "shipyard": {
       "command": "npx",
-      "args": ["-y", "@schoolai/shipyard-mcp@latest"]
+      "args": ["-y", "-p", "@schoolai/shipyard-mcp@latest", "mcp-server-shipyard"]
     }
   }
 }
@@ -117,7 +121,7 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
   "mcpServers": {
     "shipyard": {
       "command": "npx",
-      "args": ["-y", "@schoolai/shipyard-mcp@latest"]
+      "args": ["-y", "-p", "@schoolai/shipyard-mcp@latest", "mcp-server-shipyard"]
     }
   }
 }
@@ -139,7 +143,7 @@ Add to `~/.config/zed/settings.json`:
     "shipyard": {
       "command": {
         "path": "npx",
-        "args": ["-y", "@schoolai/shipyard-mcp@latest"]
+        "args": ["-y", "-p", "@schoolai/shipyard-mcp@latest", "mcp-server-shipyard"]
       }
     }
   }
@@ -154,7 +158,7 @@ Create `.continue/mcpServers/shipyard.yaml`:
 mcpServers:
   - name: Shipyard
     command: npx
-    args: ["-y", "@schoolai/shipyard-mcp@latest"]
+    args: ["-y", "-p", "@schoolai/shipyard-mcp@latest", "mcp-server-shipyard"]
 ```
 
 </details>

package/apps/server/dist/index.js

@@ -81,7 +81,7 @@ import * as os from "os";
 import * as path from "path";
 import * as vm from "vm";
 import ffmpegInstaller from "@ffmpeg-installer/ffmpeg";
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 
 // src/tools/add-artifact.ts
 import { writeFile as writeFile2 } from "fs/promises";
@@ -1360,8 +1360,63 @@ Make sure:
   }
 };
 
-// src/tools/read-diff-comments.ts
+// src/tools/post-update.ts
 import { z as z6 } from "zod";
+var PostUpdateInput = z6.object({
+  taskId: z6.string().describe("The task ID"),
+  sessionToken: z6.string().describe("Session token from plan approval"),
+  message: z6.string().describe("Update content (markdown)")
+});
+function errorResponse2(message) {
+  return { content: [{ type: "text", text: message }], isError: true };
+}
+function successResponse2(message) {
+  return { content: [{ type: "text", text: message }] };
+}
+var postUpdateTool = {
+  definition: {
+    name: TOOL_NAMES.POST_UPDATE,
+    description: `Post a progress update to the task timeline.
+
+Use this to communicate status updates to humans watching your work:
+- "Starting work on authentication module"
+- "Milestone: API integration complete"
+- "Found edge case with rate limiting, investigating"
+
+Updates appear in the Activity tab and keep reviewers informed.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        taskId: { type: "string", description: "The task ID" },
+        sessionToken: { type: "string", description: "Session token from plan approval" },
+        message: { type: "string", description: "Update content (markdown supported)" }
+      },
+      required: ["taskId", "sessionToken", "message"]
+    }
+  },
+  handler: async (args) => {
+    const input = PostUpdateInput.parse(args);
+    const { taskId, sessionToken, message } = input;
+    const doc = await getOrCreateDoc(taskId);
+    const metadata = getPlanMetadata(doc);
+    if (!metadata) {
+      return errorResponse2(`Task "${taskId}" not found.`);
+    }
+    if (!metadata.sessionTokenHash || !verifySessionToken(sessionToken, metadata.sessionTokenHash)) {
+      return errorResponse2(`Invalid session token for task "${taskId}".`);
+    }
+    const actorName = await getGitHubUsername();
+    const eventId = logPlanEvent(doc, "agent_activity", actorName, {
+      activityType: "update",
+      message
+    });
+    logger.info({ taskId, eventId, messageLength: message.length }, "Agent update posted");
+    return successResponse2(`Update posted to task "${taskId}".`);
+  }
+};
+
+// src/tools/read-diff-comments.ts
+import { z as z7 } from "zod";
 function getStalenessContext(doc) {
   const planMetadata = getPlanMetadata(doc);
   const cwd = extractCwdFromMetadata(planMetadata);
@@ -1389,12 +1444,12 @@ function extractCwdFromMetadata(metadata) {
   }
   return void 0;
 }
-var ReadDiffCommentsInput = z6.object({
-  taskId: z6.string().describe("The task ID to read diff comments from"),
-  sessionToken: z6.string().describe("Session token from create_task"),
-  includeLocal: z6.boolean().optional().describe("Include local (uncommitted) diff comments (default: true)"),
-  includePR: z6.boolean().optional().describe("Include PR review diff comments (default: true)"),
-  includeResolved: z6.boolean().optional().describe("Include resolved comments (default: false)")
+var ReadDiffCommentsInput = z7.object({
+  taskId: z7.string().describe("The task ID to read diff comments from"),
+  sessionToken: z7.string().describe("Session token from create_task"),
+  includeLocal: z7.boolean().optional().describe("Include local (uncommitted) diff comments (default: true)"),
+  includePR: z7.boolean().optional().describe("Include PR review diff comments (default: true)"),
+  includeResolved: z7.boolean().optional().describe("Include resolved comments (default: false)")
 });
 var readDiffCommentsTool = {
   definition: {
@@ -1495,7 +1550,7 @@ OUTPUT FORMAT:
 };
 
 // src/tools/read-task.ts
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 
 // src/export-markdown.ts
 import { ServerBlockNoteEditor as ServerBlockNoteEditor4 } from "@blocknote/server-util";
@@ -1757,12 +1812,12 @@ function formatResponseValue(response) {
 }
 
 // src/tools/read-task.ts
-var ReadTaskInput = z7.object({
-  taskId: z7.string().describe("The task ID to read"),
-  sessionToken: z7.string().describe("Session token from create_task"),
-  includeAnnotations: z7.boolean().optional().describe("Include comment threads/annotations in the response (default: false)"),
-  includeLinkedPRs: z7.boolean().optional().describe("Include linked PRs section in the response (default: false)"),
-  includePRComments: z7.boolean().optional().describe(
+var ReadTaskInput = z8.object({
+  taskId: z8.string().describe("The task ID to read"),
+  sessionToken: z8.string().describe("Session token from create_task"),
+  includeAnnotations: z8.boolean().optional().describe("Include comment threads/annotations in the response (default: false)"),
+  includeLinkedPRs: z8.boolean().optional().describe("Include linked PRs section in the response (default: false)"),
+  includePRComments: z8.boolean().optional().describe(
     "Include inline PR review comments (diff line comments) in the response (default: false)"
   )
 });
@@ -1887,9 +1942,9 @@ OUTPUT INCLUDES:
 };
 
 // src/tools/regenerate-session-token.ts
-import { z as z8 } from "zod";
-var RegenerateSessionTokenInput = z8.object({
-  taskId: z8.string().describe("The task ID to regenerate token for")
+import { z as z9 } from "zod";
+var RegenerateSessionTokenInput = z9.object({
+  taskId: z9.string().describe("The task ID to regenerate token for")
 });
 var regenerateSessionTokenTool = {
   definition: {
@@ -2022,10 +2077,10 @@ Use this token for add_artifact, read_task, link_pr, and other task operations.`
 };
 
 // src/tools/setup-review-notification.ts
-import { z as z9 } from "zod";
-var SetupReviewNotificationInput = z9.object({
-  taskId: z9.string().describe("Task ID to monitor"),
-  pollIntervalSeconds: z9.number().optional().default(30).describe("Polling interval in seconds (default: 30)")
+import { z as z10 } from "zod";
+var SetupReviewNotificationInput = z10.object({
+  taskId: z10.string().describe("Task ID to monitor"),
+  pollIntervalSeconds: z10.number().optional().default(30).describe("Polling interval in seconds (default: 30)")
 });
 var setupReviewNotificationTool = {
   definition: {
@@ -2143,31 +2198,31 @@ The script:
 
 // src/tools/update-block-content.ts
 import { ServerBlockNoteEditor as ServerBlockNoteEditor5 } from "@blocknote/server-util";
-import { z as z10 } from "zod";
-var BlockOperationSchema = z10.discriminatedUnion("type", [
-  z10.object({
-    type: z10.literal("update"),
-    blockId: z10.string().describe("The block ID to update (from read_plan output)"),
-    content: z10.string().describe("New markdown content for this block")
+import { z as z11 } from "zod";
+var BlockOperationSchema = z11.discriminatedUnion("type", [
+  z11.object({
+    type: z11.literal("update"),
+    blockId: z11.string().describe("The block ID to update (from read_plan output)"),
+    content: z11.string().describe("New markdown content for this block")
   }),
-  z10.object({
-    type: z10.literal("insert"),
-    afterBlockId: z10.string().nullable().describe("Insert after this block ID (null = insert at beginning)"),
-    content: z10.string().describe("Markdown content to insert as new block(s)")
+  z11.object({
+    type: z11.literal("insert"),
+    afterBlockId: z11.string().nullable().describe("Insert after this block ID (null = insert at beginning)"),
+    content: z11.string().describe("Markdown content to insert as new block(s)")
   }),
-  z10.object({
-    type: z10.literal("delete"),
-    blockId: z10.string().describe("The block ID to delete")
+  z11.object({
+    type: z11.literal("delete"),
+    blockId: z11.string().describe("The block ID to delete")
   }),
-  z10.object({
-    type: z10.literal("replace_all"),
-    content: z10.string().describe("Complete markdown content to replace the entire plan")
+  z11.object({
+    type: z11.literal("replace_all"),
+    content: z11.string().describe("Complete markdown content to replace the entire plan")
   })
 ]);
-var UpdateBlockContentInput = z10.object({
-  taskId: z10.string().describe("The task ID to modify"),
-  sessionToken: z10.string().describe("Session token from create_task"),
-  operations: z10.array(BlockOperationSchema).min(1).describe("Array of operations to perform atomically")
+var UpdateBlockContentInput = z11.object({
+  taskId: z11.string().describe("The task ID to modify"),
+  sessionToken: z11.string().describe("Session token from create_task"),
+  operations: z11.array(BlockOperationSchema).min(1).describe("Array of operations to perform atomically")
 });
 var updateBlockContentTool = {
   definition: {
@@ -2429,7 +2484,7 @@ async function applyOperation(blocks, operation, editor) {
 // src/tools/update-task.ts
 import { ServerBlockNoteEditor as ServerBlockNoteEditor6 } from "@blocknote/server-util";
 import { nanoid as nanoid3 } from "nanoid";
-import { z as z11 } from "zod";
+import { z as z12 } from "zod";
 function buildStatusTransition(targetStatus, actorName) {
   const now = Date.now();
   switch (targetStatus) {
@@ -2462,12 +2517,12 @@ function buildStatusTransition(targetStatus, actorName) {
       return null;
   }
 }
-var UpdateTaskInput = z11.object({
-  taskId: z11.string().describe("The task ID to update"),
-  sessionToken: z11.string().describe("Session token from create_task"),
-  title: z11.string().optional().describe("New title"),
-  status: z11.enum(["draft", "pending_review", "changes_requested", "in_progress", "completed"]).optional().describe("New status"),
-  tags: z11.array(z11.string()).optional().describe("Updated tags (replaces existing tags)")
+var UpdateTaskInput = z12.object({
+  taskId: z12.string().describe("The task ID to update"),
+  sessionToken: z12.string().describe("Session token from create_task"),
+  title: z12.string().optional().describe("New title"),
+  status: z12.enum(["draft", "pending_review", "changes_requested", "in_progress", "completed"]).optional().describe("New status"),
+  tags: z12.array(z12.string()).optional().describe("Updated tags (replaces existing tags)")
 });
 var updateTaskTool = {
   definition: {
@@ -2622,15 +2677,50 @@ STATUSES:
 
 // src/tools/execute-code.ts
 function getToolResultText(result) {
+  if (!result || !Array.isArray(result.content)) return "";
   const first = result.content[0];
   if (!first || typeof first !== "object") return "";
   const record = Object.fromEntries(Object.entries(first));
   const text = record.text;
   return typeof text === "string" ? text : "";
 }
+async function serializeError(error) {
+  const { z: z14 } = await import("zod");
+  if (error instanceof z14.ZodError) {
+    const formattedIssues = error.issues.map((issue) => `  - ${issue.path.join(".")}: ${issue.message}`).join("\n");
+    const message2 = `Validation error:
+${formattedIssues}`;
+    return {
+      details: { name: "ZodError", message: message2, issues: error.issues, stack: error.stack },
+      message: message2,
+      stack: error.stack
+    };
+  }
+  if (error instanceof Error) {
+    return {
+      details: {
+        name: error.name,
+        message: error.message,
+        stack: error.stack,
+        cause: error.cause instanceof Error ? error.cause.message : error.cause
+      },
+      message: error.message,
+      stack: error.stack
+    };
+  }
+  if (error && typeof error === "object") {
+    const message2 = "message" in error && typeof error.message === "string" ? error.message : JSON.stringify(error).slice(0, 500) || "Unknown error";
+    return {
+      details: { raw: JSON.stringify(error).slice(0, 1e3) },
+      message: message2
+    };
+  }
+  const message = String(error) || "Unknown error";
+  return { details: { raw: message }, message };
+}
 var BUNDLED_DOCS = `Execute TypeScript code that calls Shipyard APIs. Use this for multi-step workflows to reduce round-trips.
 
-\u26A0\uFE0F IMPORTANT LIMITATION: Dynamic imports (\`await import()\`) are NOT supported in the VM execution context. Use only the pre-provided functions in the execution environment (createTask, readTask, readDiffComments, updateTask, addArtifact, completeTask, updateBlockContent, linkPR, requestUserInput, regenerateSessionToken). All necessary APIs are already available in the sandbox.
+\u26A0\uFE0F IMPORTANT LIMITATION: Dynamic imports (\`await import()\`) are NOT supported in the VM execution context. Use only the pre-provided functions in the execution environment (createTask, readTask, readDiffComments, updateTask, addArtifact, completeTask, updateBlockContent, linkPR, requestUserInput, regenerateSessionToken, postUpdate). All necessary APIs are already available in the sandbox.
 
 ## Available APIs
 
@@ -3087,6 +3177,40 @@ await addArtifact({
 
 ---
 
+### postUpdate(opts): Promise<{ success, isError?, error? }>
+Post a progress update to the task timeline.
+
+Use this to communicate status updates to humans watching your work:
+- "Starting work on authentication module"
+- "Milestone: API integration complete"
+- "Found edge case with rate limiting, investigating"
+
+Updates appear in the Activity tab and keep reviewers informed.
+
+Parameters:
+- taskId (string): The task ID
+- sessionToken (string): Session token from createTask
+- message (string): Update content (markdown supported)
+
+Returns:
+- success: Boolean indicating update was posted (true on success, false on error)
+- isError: Boolean indicating if an error occurred
+- error: Error message (only present when isError is true)
+
+Example:
+\`\`\`typescript
+const result = await postUpdate({
+  taskId,
+  sessionToken,
+  message: "Starting work on authentication module"
+});
+if (result.isError) {
+  console.log('Failed:', result.error);
+}
+\`\`\`
+
+---
+
 ## Common Pattern
 
 \`\`\`typescript
@@ -3126,8 +3250,8 @@ const result = await addArtifact({
 return { taskId: task.taskId, snapshotUrl: result.snapshotUrl };
 \`\`\`
 `;
-var ExecuteCodeInput = z12.object({
-  code: z12.string().describe("TypeScript code to execute")
+var ExecuteCodeInput = z13.object({
+  code: z13.string().describe("TypeScript code to execute")
 });
 var scriptTracker = [];
 async function createTask(opts) {
@@ -3423,6 +3547,14 @@ async function regenerateSessionToken(taskId) {
     taskId
   };
 }
+async function postUpdate(opts) {
+  const result = await postUpdateTool.handler(opts);
+  const text = getToolResultText(result);
+  if (result.isError) {
+    return { isError: true, error: text, success: false };
+  }
+  return { isError: false, success: true };
+}
 var executeCodeTool = {
   definition: {
     name: TOOL_NAMES.EXECUTE_CODE,
@@ -3484,6 +3616,7 @@ var executeCodeTool = {
         linkPR: linkPR2,
         requestUserInput,
         regenerateSessionToken,
+        postUpdate,
         encodeVideo,
         child_process,
         fs,
@@ -3528,71 +3661,20 @@ The script will exit when the human approves or requests changes.`
       }
       return { content };
     } catch (error) {
-      logger.error({ error, code }, "Code execution failed");
-      const message = error instanceof Error ? error.message : "Unknown error";
+      const { details, message, stack } = await serializeError(error);
+      logger.error({ error: details, code }, "Code execution failed");
+      const errorText = stack ? `Execution error: ${message}
+
+Stack trace:
+${stack}` : `Execution error: ${message}`;
       return {
-        content: [{ type: "text", text: `Execution error: ${message}` }],
+        content: [{ type: "text", text: errorText }],
         isError: true
       };
     }
   }
 };
 
-// src/tools/post-update.ts
-import { z as z13 } from "zod";
-var PostUpdateInput = z13.object({
-  taskId: z13.string().describe("The task ID"),
-  sessionToken: z13.string().describe("Session token from plan approval"),
-  message: z13.string().describe("Update content (markdown)")
-});
-function errorResponse2(message) {
-  return { content: [{ type: "text", text: message }], isError: true };
-}
-function successResponse2(message) {
-  return { content: [{ type: "text", text: message }] };
-}
-var postUpdateTool = {
-  definition: {
-    name: TOOL_NAMES.POST_UPDATE,
-    description: `Post a progress update to the task timeline.
-
-Use this to communicate status updates to humans watching your work:
-- "Starting work on authentication module"
-- "Milestone: API integration complete"
-- "Found edge case with rate limiting, investigating"
-
-Updates appear in the Activity tab and keep reviewers informed.`,
-    inputSchema: {
-      type: "object",
-      properties: {
-        taskId: { type: "string", description: "The task ID" },
-        sessionToken: { type: "string", description: "Session token from plan approval" },
-        message: { type: "string", description: "Update content (markdown supported)" }
-      },
-      required: ["taskId", "sessionToken", "message"]
-    }
-  },
-  handler: async (args) => {
-    const input = PostUpdateInput.parse(args);
-    const { taskId, sessionToken, message } = input;
-    const doc = await getOrCreateDoc(taskId);
-    const metadata = getPlanMetadata(doc);
-    if (!metadata) {
-      return errorResponse2(`Task "${taskId}" not found.`);
-    }
-    if (!metadata.sessionTokenHash || !verifySessionToken(sessionToken, metadata.sessionTokenHash)) {
-      return errorResponse2(`Invalid session token for task "${taskId}".`);
-    }
-    const actorName = await getGitHubUsername();
-    const eventId = logPlanEvent(doc, "agent_activity", actorName, {
-      activityType: "update",
-      message
-    });
-    logger.info({ taskId, eventId, messageLength: message.length }, "Agent update posted");
-    return successResponse2(`Update posted to task "${taskId}".`);
-  }
-};
-
 // src/index.ts
 var registryPort = await isRegistryRunning();
 if (!registryPort) {
@@ -3637,19 +3719,13 @@ var server = new Server(
   }
 );
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: [executeCodeTool.definition, postUpdateTool.definition, readDiffCommentsTool.definition]
+  tools: [executeCodeTool.definition]
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
   if (name === TOOL_NAMES.EXECUTE_CODE) {
     return await executeCodeTool.handler(args ?? {});
   }
-  if (name === TOOL_NAMES.POST_UPDATE) {
-    return await postUpdateTool.handler(args ?? {});
-  }
-  if (name === TOOL_NAMES.READ_DIFF_COMMENTS) {
-    return await readDiffCommentsTool.handler(args ?? {});
-  }
   throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
 });
 var transport = new StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schoolai/shipyard-mcp",
-  "version": "0.4.0",
+  "version": "0.4.1-nightly.20260127",
   "description": "Shipyard MCP server and CLI tools for distributed planning with CRDTs",
   "type": "module",
   "bin": {