@schoolai/shipyard-mcp 0.2.1 → 0.2.2-next.483

package/apps/server/dist/index.js

@@ -4742,7 +4742,7 @@ var BUNDLED_DOCS = `Execute TypeScript code that calls Shipyard APIs. Use this f
 
 ## Available APIs
 
-### createPlan(opts): Promise<{ planId, sessionToken, url, deliverables }>
+### createPlan(opts): Promise<{ planId, sessionToken, url, deliverables, monitoringScript }>
 Create a new plan and open it in browser.
 
 Parameters:
@@ -4756,6 +4756,7 @@ Returns:
 - sessionToken: Required for subsequent API calls
 - url: Browser URL for the plan
 - deliverables: Array of { id, text } for linking artifacts
+- monitoringScript: Bash script to poll for approval (for non-hook agents)
 
 Example:
 \`\`\`typescript
@@ -4763,7 +4764,10 @@ const plan = await createPlan({
   title: "Add auth",
   content: "- [ ] Screenshot of login {#deliverable}"
 });
-// Returns: { planId: "abc", sessionToken: "xyz", url: "...", deliverables: [{ id: "del_xxx", text: "Screenshot of login" }] }
+// Returns: { planId: "abc", sessionToken: "xyz", url: "...", deliverables: [...], monitoringScript: "#!/bin/bash..." }
+
+// For non-hook agents: Run the monitoring script in background to wait for approval
+// bash <(echo "$monitoringScript") &
 \`\`\`
 
 ---
@@ -4801,7 +4805,7 @@ data.deliverables.forEach(d => console.log(d.id, d.completed));
 
 ---
 
-### updatePlan(planId, sessionToken, updates): Promise<void>
+### updatePlan(planId, sessionToken, updates): Promise<{ success, monitoringScript }>
 Update plan metadata.
 
 Parameters:
@@ -4810,6 +4814,10 @@ Parameters:
 - updates.title (string, optional): New title
 - updates.status (string, optional): 'draft' | 'pending_review' | 'changes_requested' | 'in_progress'
 
+Returns:
+- success: Boolean indicating update succeeded
+- monitoringScript: Bash script to poll for approval (for non-hook agents)
+
 Note: Most status transitions are automatic. Rarely needed.
 
 ---
@@ -4900,46 +4908,6 @@ Parameters:
 
 ---
 
-### setupReviewNotification(planId, pollIntervalSeconds?): Promise<{ script }>
-Get a bash script to poll for plan approval status changes.
-
-Parameters:
-- planId (string): Plan ID to monitor
-- pollIntervalSeconds (number, optional): Polling interval (default: 30)
-
-Returns:
-- script: Bash script that polls registry server and exits when status becomes 'in_progress' (approved) or 'changes_requested' (needs work)
-
-**IMPORTANT:** This is ONLY for agents WITHOUT hook support (Cursor, Devin, Windsurf, etc).
-Claude Code users have automatic blocking via the shipyard hook - you don't need this.
-
-**Complete workflow for non-hook agents (example user code):**
-\`\`\`typescript
-// 1. Create plan and get the monitoring script in ONE code block
-const plan = await createPlan({
-  title: "My Feature Implementation",
-  content: "- [ ] Screenshot of working feature {#deliverable}"
-});
-
-// 2. Get the polling script (returns bash script as string)
-const { script } = await setupReviewNotification(plan.planId, 15);
-
-// 3. Return both so the agent can run the script
-return {
-  planId: plan.planId,
-  sessionToken: plan.sessionToken,
-  monitoringScript: script,
-  instructions: "Run the monitoring script in background: bash <script> &"
-};
-\`\`\`
-
-The agent then runs the returned bash script in the background. The script will:
-- Poll the registry server every N seconds
-- Print status changes to stdout
-- Exit with code 0 when the plan is approved/rejected
-
----
-
 ### requestUserInput(opts): Promise<{ success, response?, status, reason? }>
 Request input from the user via browser modal.
 
@@ -5075,7 +5043,9 @@ const plan = await createPlan({
   content: "- [ ] Screenshot {#deliverable}\\n- [ ] Video {#deliverable}"
 });
 
-// plan.deliverables = [{ id: "del_xxx", text: "Screenshot" }, { id: "del_yyy", text: "Video" }]
+// plan includes: planId, sessionToken, url, deliverables, monitoringScript
+// For non-hook agents: Run monitoringScript in background to wait for approval
+// The script polls and exits when human approves/rejects
 
 // Do work, take screenshots...
 
@@ -5105,6 +5075,7 @@ return { planId: plan.planId, snapshotUrl: result.snapshotUrl };
 var ExecuteCodeInput = z12.object({
   code: z12.string().describe("TypeScript code to execute")
 });
+var scriptTracker = [];
 async function createPlan(opts) {
   const result = await createPlanTool.handler(opts);
   const text = result.content[0]?.text || "";
@@ -5115,11 +5086,16 @@ async function createPlan(opts) {
     const allDeliverables = getDeliverables(ydoc);
     deliverables = allDeliverables.map((d) => ({ id: d.id, text: d.text }));
   }
+  const { script: monitoringScript } = await setupReviewNotification(planId, 30);
+  scriptTracker.push(`Plan "${planId}" created.
+
+${monitoringScript}`);
   return {
     planId,
     sessionToken: text.match(/Session Token: (\S+)/)?.[1] || "",
     url: text.match(/URL: (\S+)/)?.[1] || "",
-    deliverables
+    deliverables,
+    monitoringScript
   };
 }
 async function readPlan(planId, sessionToken, opts) {
@@ -5149,6 +5125,14 @@ async function readPlan(planId, sessionToken, opts) {
 }
 async function updatePlan(planId, sessionToken, updates) {
   await updatePlanTool.handler({ planId, sessionToken, ...updates });
+  const { script: monitoringScript } = await setupReviewNotification(planId, 30);
+  scriptTracker.push(`Plan "${planId}" updated.
+
+${monitoringScript}`);
+  return {
+    success: true,
+    monitoringScript
+  };
 }
 async function addArtifact2(opts) {
   const result = await addArtifactTool.handler(opts);
@@ -5335,6 +5319,7 @@ var executeCodeTool = {
   handler: async (args) => {
     const { code } = ExecuteCodeInput.parse(args);
     logger.info({ codeLength: code.length }, "Executing code");
+    scriptTracker.length = 0;
     try {
       async function encodeVideo(opts) {
         const fps = opts.fps || 6;
@@ -5399,14 +5384,33 @@ var executeCodeTool = {
       const script = new vm.Script(wrappedCode);
       const result = await script.runInContext(context, { timeout: 12e4 });
       logger.info({ result }, "Code execution complete");
-      return {
-        content: [
-          {
-            type: "text",
-            text: typeof result === "object" ? JSON.stringify(result, null, 2) : String(result ?? "Done")
-          }
-        ]
-      };
+      const content = [
+        {
+          type: "text",
+          text: typeof result === "object" ? JSON.stringify(result, null, 2) : String(result ?? "Done")
+        }
+      ];
+      const latestScript = scriptTracker[scriptTracker.length - 1];
+      if (latestScript) {
+        const [planAction, ...scriptParts] = latestScript.split("\n\n");
+        content.push({
+          type: "text",
+          text: `
+
+---
+**\u26A0\uFE0F IMPORTANT FOR NON-HOOK AGENTS (Cursor, Devin, Windsurf, etc.):**
+
+${planAction} To wait for human approval before proceeding, run this monitoring script in background:
+
+\`\`\`bash
+${scriptParts.join("\n\n")}
+\`\`\`
+
+Save the script to a file and run: \`bash script.sh &\`
+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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schoolai/shipyard-mcp",
-  "version": "0.2.1",
+  "version": "0.2.2-next.483",
   "description": "Shipyard MCP server and CLI tools for distributed planning with CRDTs",
   "type": "module",
   "bin": {