@schoolai/shipyard-mcp 0.1.3-next.460 → 0.1.3-next.466

package/apps/hook/dist/index.js

@@ -28494,7 +28494,7 @@ init_cjs_shims();
 // ../../packages/schema/dist/index.mjs
 init_cjs_shims();
 
-// ../../packages/schema/dist/yjs-helpers-B435ND5d.mjs
+// ../../packages/schema/dist/yjs-helpers-CFQmkNYl.mjs
 init_cjs_shims();
 
 // ../../packages/schema/dist/plan.mjs
@@ -42665,7 +42665,7 @@ var PRReviewCommentSchema = external_exports.object({
   resolved: external_exports.boolean().optional()
 });
 
-// ../../packages/schema/dist/yjs-helpers-B435ND5d.mjs
+// ../../packages/schema/dist/yjs-helpers-CFQmkNYl.mjs
 function assertNever2(value) {
   throw new Error(`Unhandled discriminated union member: ${JSON.stringify(value)}`);
 }
@@ -42770,7 +42770,7 @@ var InputRequestBaseSchema = external_exports.object({
   message: external_exports.string().min(1, "Message cannot be empty"),
   status: external_exports.enum(InputRequestStatusValues),
   defaultValue: external_exports.string().optional(),
-  timeout: external_exports.number().int().min(10, "Timeout must be at least 10 seconds").max(900, "Timeout cannot exceed 15 minutes").optional(),
+  timeout: external_exports.number().int().min(10, "Timeout must be at least 10 seconds").max(14400, "Timeout cannot exceed 4 hours").optional(),
   planId: external_exports.string().optional(),
   response: external_exports.unknown().optional(),
   answeredAt: external_exports.number().optional(),

package/apps/server/dist/{chunk-4BEPSPPL.js → chunk-75NZRAN5.js}

@@ -863,7 +863,7 @@ function createHandedOffConversationVersion(params) {
   return ConversationVersionSchema.parse(version);
 }
 
-// ../../packages/schema/dist/yjs-helpers-B435ND5d.mjs
+// ../../packages/schema/dist/yjs-helpers-CFQmkNYl.mjs
 import { z as z2 } from "zod";
 import { nanoid as nanoid2 } from "nanoid";
 import * as Y from "yjs";
@@ -959,7 +959,7 @@ var CreateSubscriptionRequestSchema = z2.object({
   threshold: z2.number().positive().optional()
 });
 var CreateSubscriptionResponseSchema = z2.object({ clientId: z2.string() });
-var DEFAULT_INPUT_REQUEST_TIMEOUT_SECONDS = 300;
+var DEFAULT_INPUT_REQUEST_TIMEOUT_SECONDS = 1800;
 var InputRequestTypeValues = [
   "text",
   "multiline",
@@ -978,7 +978,7 @@ var InputRequestBaseSchema = z2.object({
   message: z2.string().min(1, "Message cannot be empty"),
   status: z2.enum(InputRequestStatusValues),
   defaultValue: z2.string().optional(),
-  timeout: z2.number().int().min(10, "Timeout must be at least 10 seconds").max(900, "Timeout cannot exceed 15 minutes").optional(),
+  timeout: z2.number().int().min(10, "Timeout must be at least 10 seconds").max(14400, "Timeout cannot exceed 4 hours").optional(),
   planId: z2.string().optional(),
   response: z2.unknown().optional(),
   answeredAt: z2.number().optional(),

package/apps/server/dist/{chunk-FTOVV4YW.js → chunk-MZTJGBLT.js}

@@ -3,7 +3,7 @@ import {
   YDOC_KEYS,
   createInputRequest,
   logPlanEvent
-} from "./chunk-4BEPSPPL.js";
+} from "./chunk-75NZRAN5.js";
 import {
   logger
 } from "./chunk-GSGLHRWX.js";

package/apps/server/dist/{dist-FZ4WTJ2H.js → dist-HIDISXZO.js}

@@ -203,7 +203,7 @@ import {
   updateLinkedPRStatus,
   updatePlanIndexViewedBy,
   validateA2AMessages
-} from "./chunk-4BEPSPPL.js";
+} from "./chunk-75NZRAN5.js";
 import "./chunk-JSBRDJBE.js";
 export {
   A2ADataPartSchema,

package/apps/server/dist/index.js

@@ -19,7 +19,7 @@ import {
 } from "./chunk-EBNL5ZX7.js";
 import {
   InputRequestManager
-} from "./chunk-FTOVV4YW.js";
+} from "./chunk-MZTJGBLT.js";
 import {
   ArtifactSchema,
   DeliverableSchema,
@@ -68,7 +68,7 @@ import {
   setPlanMetadata,
   touchPlanIndexEntry,
   transitionPlanStatus
-} from "./chunk-4BEPSPPL.js";
+} from "./chunk-75NZRAN5.js";
 import {
   loadEnv,
   logger
@@ -2477,7 +2477,7 @@ import { z as z12 } from "zod";
 
 // src/tools/add-artifact.ts
 import { execSync } from "child_process";
-import { readFile as readFile3 } from "fs/promises";
+import { readFile as readFile3, writeFile as writeFile4 } from "fs/promises";
 import { ServerBlockNoteEditor as ServerBlockNoteEditor2 } from "@blocknote/server-util";
 import { nanoid as nanoid4 } from "nanoid";
 import { z as z3 } from "zod";
@@ -2909,6 +2909,14 @@ Linked to deliverable: ${input.deliverableId}` : "";
           logger.warn({ planId }, "Cannot update plan index: missing ownerId");
         }
         logger.info({ planId, snapshotUrl }, "Task auto-completed");
+        const { homedir: homedir5 } = await import("os");
+        const { join: join6 } = await import("path");
+        const { mkdir: mkdir3 } = await import("fs/promises");
+        const snapshotsDir = join6(homedir5(), ".shipyard", "snapshots");
+        await mkdir3(snapshotsDir, { recursive: true });
+        const snapshotFile = join6(snapshotsDir, `${planId}.txt`);
+        await writeFile4(snapshotFile, snapshotUrl, "utf-8");
+        logger.info({ planId, snapshotFile }, "Snapshot URL written to file");
         let prText = "";
         if (linkedPR) {
           prText = `
@@ -2934,10 +2942,11 @@ URL: ${artifactUrl}${linkedText}
 
 \u{1F389} ALL DELIVERABLES COMPLETE! Task auto-completed.${prText}
 
-Snapshot URL generated. Access via result.snapshotUrl to embed in PR.`
+Snapshot URL saved to: ${snapshotFile}
+(Note: Very long URL - recommend not reading directly. Use file path to attach to PR or access later.)`
             }
           ],
-          // Structured data for programmatic access (avoids token limit issues)
+          // Keep structured data for execute_code wrapper
           snapshotUrl,
           allDeliverablesComplete: true
         };
@@ -4140,7 +4149,9 @@ USAGE (for non-hook agents):
 1. Call this tool to get monitoring script
 2. Run script in background: bash <script> &
 3. Script polls registry server for status changes
-4. Exits when status becomes 'approved' or 'changes_requested'`,
+4. Exits when status becomes 'in_progress' (approved) or 'changes_requested' (needs work)
+
+REQUIREMENTS: The script requires 'jq' for URL encoding. Install with: brew install jq (macOS) or apt install jq (Linux)`,
     inputSchema: {
       type: "object",
       properties: {
@@ -4158,25 +4169,64 @@ USAGE (for non-hook agents):
     const { planId, pollIntervalSeconds = 30 } = input;
     const registryPort2 = registryConfig.REGISTRY_PORT[0];
     const trpcUrl = `http://localhost:${registryPort2}/trpc`;
-    const script = `# Subscribe to status and comment changes via tRPC
-CLIENT_ID=$(curl -sf -X POST "${trpcUrl}/subscription.create" \\
+    const statusInProgress = PlanStatusValues.find((s) => s === "in_progress");
+    const statusChangesRequested = PlanStatusValues.find((s) => s === "changes_requested");
+    if (!statusInProgress || !statusChangesRequested) {
+      throw new Error("Required status values not found in PlanStatusValues");
+    }
+    const script = `#!/bin/bash
+# Monitor plan "${planId}" for approval status changes
+# Polls the Shipyard registry server and exits when approved/rejected
+
+# Check for required dependency
+if ! command -v jq &> /dev/null; then
+  echo "Error: jq is required but not installed."
+  echo "Install with: brew install jq (macOS) or apt install jq (Linux)"
+  exit 1
+fi
+
+TRPC_URL="${trpcUrl}"
+PLAN_ID="${planId}"
+POLL_INTERVAL=${pollIntervalSeconds}
+
+# Subscribe to status changes via tRPC mutation
+echo "Subscribing to plan changes..."
+RESPONSE=$(curl -sf -X POST "$TRPC_URL/subscription.create" \\
   -H "Content-Type: application/json" \\
-  -d '{"planId":"${planId}","subscribe":["status","comments"],"windowMs":5000,"threshold":1}' \\
-  | grep -o '"clientId":"[^"]*"' | cut -d'"' -f4)
-
-echo "Subscribed. Monitoring plan..."
-
-# Poll for changes via tRPC
-while sleep ${pollIntervalSeconds}; do
-  result=$(curl -sf -X POST "${trpcUrl}/subscription.getChanges" \\
-    -H "Content-Type: application/json" \\
-    -d '{"planId":"${planId}","clientId":"'"$CLIENT_ID"'"}' 2>/dev/null)
-  ready=$(echo "$result" | grep -o '"ready":true')
-  if [ -n "$ready" ]; then
-    changes=$(echo "$result" | grep -o '"changes":"[^"]*"' | cut -d'"' -f4)
-    echo "Changes: $changes"
-    # Exit on status change to approved/changes_requested
-    echo "$changes" | grep -qE "Status:.*(approved|changes_requested)" && exit 0
+  -d '{"planId":"'"$PLAN_ID"'","subscribe":["status","comments"],"windowMs":5000,"threshold":1}')
+
+# Extract clientId from response: {"result":{"data":{"clientId":"..."}}}
+CLIENT_ID=$(echo "$RESPONSE" | sed -n 's/.*"clientId":"\\([^"]*\\)".*/\\1/p')
+
+if [ -z "$CLIENT_ID" ]; then
+  echo "Failed to subscribe. Is the Shipyard registry server running?"
+  echo "Response: $RESPONSE"
+  exit 1
+fi
+
+echo "Subscribed with clientId: $CLIENT_ID"
+echo "Polling every $POLL_INTERVAL seconds..."
+
+# Poll for changes via tRPC query (GET with url-encoded input)
+while true; do
+  sleep $POLL_INTERVAL
+
+  # URL-encode the input JSON for GET request
+  INPUT='{"planId":"'"$PLAN_ID"'","clientId":"'"$CLIENT_ID"'"}'
+  ENCODED_INPUT=$(printf '%s' "$INPUT" | jq -sRr @uri)
+
+  RESULT=$(curl -sf "$TRPC_URL/subscription.getChanges?input=$ENCODED_INPUT" 2>/dev/null)
+
+  # Check if changes are ready: {"result":{"data":{"ready":true,"changes":"..."}}}
+  if echo "$RESULT" | grep -q '"ready":true'; then
+    CHANGES=$(echo "$RESULT" | sed -n 's/.*"changes":"\\([^"]*\\)".*/\\1/p')
+    echo "Changes detected: $CHANGES"
+
+    # Exit on status change to in_progress (approved) or changes_requested (needs work)
+    if echo "$CHANGES" | grep -qE "Status:.*(${statusInProgress}|${statusChangesRequested})"; then
+      echo "Plan status changed. Exiting."
+      exit 0
+    fi
   fi
 done`;
     return {
@@ -4189,10 +4239,13 @@ done`;
 ${script}
 \`\`\`
 
-> Subscribes to status and comment changes with server-side batching.
-> Batching: 5s window or 1 change threshold (whichever comes first).
-> Exits when status becomes approved/changes_requested.
-> Most agent environments support background bash notifications.`
+**Usage:** Save to a file and run in background: \`bash script.sh &\`
+
+The script:
+- Subscribes to status/comment changes via tRPC
+- Polls every ${pollIntervalSeconds} seconds
+- Exits when status becomes in_progress (approved) or changes_requested (needs work)
+- Requires \`jq\` for URL encoding (install: brew install jq)`
         }
       ]
     };
@@ -4779,17 +4832,36 @@ Parameters:
 - pollIntervalSeconds (number, optional): Polling interval (default: 30)
 
 Returns:
-- script: Bash script that polls registry server and exits when status becomes 'changes_requested' or 'in_progress'
+- script: Bash script that polls registry server and exits when status becomes 'in_progress' (approved) or 'changes_requested' (needs work)
 
-Use this for agents WITHOUT hook support (Cursor, Devin, etc). The script can be run in background.
+**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.
 
-Example:
+**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);
-// Agent runs this script in background to wait for approval
-console.log(script);
+
+// 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? }>
@@ -4801,7 +4873,7 @@ Parameters:
 - options (string[], optional): For 'choice' type - available options (required for choice)
 - multiSelect (boolean, optional): For 'choice' type - allow selecting multiple options (uses checkboxes instead of radio buttons)
 - defaultValue (string, optional): Pre-filled value for text/multiline inputs
-- timeout (number, optional): Timeout in seconds (default: 300, min: 10, max: 600)
+- timeout (number, optional): Timeout in seconds (default: 1800, min: 10, max: 14400)
 - planId (string, optional): Optional metadata to link request to plan (for activity log filtering)
 
 Returns:
@@ -5076,7 +5148,7 @@ async function setupReviewNotification(planId, pollIntervalSeconds) {
   return { script, fullResponse: text };
 }
 async function requestUserInput(opts) {
-  const { InputRequestManager: InputRequestManager2 } = await import("./input-request-manager-YMNFW4JM.js");
+  const { InputRequestManager: InputRequestManager2 } = await import("./input-request-manager-43QSOJS3.js");
   const ydoc = await getOrCreateDoc3(PLAN_INDEX_DOC_NAME);
   const manager = new InputRequestManager2();
   const params = opts.type === "choice" ? {
@@ -5120,7 +5192,7 @@ async function requestUserInput(opts) {
   };
 }
 async function postActivityUpdate(opts) {
-  const { logPlanEvent: logPlanEvent2 } = await import("./dist-FZ4WTJ2H.js");
+  const { logPlanEvent: logPlanEvent2 } = await import("./dist-HIDISXZO.js");
   const { getGitHubUsername: getGitHubUsername2 } = await import("./server-identity-6PHKR2FY.js");
   const { nanoid: nanoid7 } = await import("nanoid");
   const doc = await getOrCreateDoc3(opts.planId);
@@ -5143,7 +5215,7 @@ async function postActivityUpdate(opts) {
   return { success: true, eventId, requestId };
 }
 async function resolveActivityRequest(opts) {
-  const { logPlanEvent: logPlanEvent2, getPlanEvents } = await import("./dist-FZ4WTJ2H.js");
+  const { logPlanEvent: logPlanEvent2, getPlanEvents } = await import("./dist-HIDISXZO.js");
   const { getGitHubUsername: getGitHubUsername2 } = await import("./server-identity-6PHKR2FY.js");
   const doc = await getOrCreateDoc3(opts.planId);
   const actorName = await getGitHubUsername2();
@@ -5278,7 +5350,7 @@ var RequestUserInputInput = z13.object({
   options: z13.array(z13.string()).optional().describe("For 'choice' type - available options (required for choice)"),
   multiSelect: z13.boolean().optional().describe("For 'choice' type - allow selecting multiple options"),
   defaultValue: z13.string().optional().describe("Pre-filled value for text/multiline inputs"),
-  timeout: z13.number().optional().describe("Timeout in seconds (default: 300, min: 10, max: 900)"),
+  timeout: z13.number().optional().describe("Timeout in seconds (default: 1800, min: 10, max: 14400)"),
   planId: z13.string().optional().describe("Optional metadata to link request to plan (for activity log filtering)")
 });
 var requestUserInputTool = {
@@ -5335,7 +5407,7 @@ NOTE: This is also available as requestUserInput() inside execute_code for multi
         },
         timeout: {
           type: "number",
-          description: "Timeout in seconds (default: 300, min: 10, max: 900)"
+          description: "Timeout in seconds (default: 1800, min: 10, max: 14400)"
         },
         planId: {
           type: "string",

package/apps/server/dist/{input-request-manager-YMNFW4JM.js → input-request-manager-43QSOJS3.js}

@@ -1,7 +1,7 @@
 import {
   InputRequestManager
-} from "./chunk-FTOVV4YW.js";
-import "./chunk-4BEPSPPL.js";
+} from "./chunk-MZTJGBLT.js";
+import "./chunk-75NZRAN5.js";
 import "./chunk-GSGLHRWX.js";
 import "./chunk-JSBRDJBE.js";
 export {

package/package.json

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