@schoolai/shipyard-mcp 0.1.3 → 0.2.0-next.477

package/apps/server/dist/index.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import {
+  getEnvironmentContext,
   getGitHubUsername,
   getRepositoryFullName,
   githubConfig
-} from "./chunk-7GPZDCWI.js";
+} from "./chunk-E5DWX2WU.js";
 import {
   assertNever,
   getSessionIdByPlanId,
@@ -18,7 +19,7 @@ import {
 } from "./chunk-EBNL5ZX7.js";
 import {
   InputRequestManager
-} from "./chunk-N44DCU4J.js";
+} from "./chunk-BWP37ADP.js";
 import {
   ArtifactSchema,
   DeliverableSchema,
@@ -62,12 +63,13 @@ import {
   logPlanEvent,
   parseClaudeCodeOrigin,
   parseThreads,
+  resetPlanToDraft,
   setAgentPresence,
   setPlanIndexEntry,
   setPlanMetadata,
   touchPlanIndexEntry,
   transitionPlanStatus
-} from "./chunk-LTC26IRQ.js";
+} from "./chunk-76JWRTPI.js";
 import {
   loadEnv,
   logger
@@ -500,14 +502,14 @@ async function uploadArtifact(params) {
     }
     const { repo, planId, filename, content } = params;
     const { owner, repoName } = parseRepoString(repo);
-    const path = `plans/${planId}/${filename}`;
+    const path2 = `plans/${planId}/${filename}`;
     await ensureArtifactsBranch(repo);
     let existingSha;
     try {
       const { data } = await octokit.repos.getContent({
         owner,
         repo: repoName,
-        path,
+        path: path2,
         ref: ARTIFACTS_BRANCH
       });
       if (!Array.isArray(data) && data.type === "file") {
@@ -521,14 +523,14 @@ async function uploadArtifact(params) {
     await octokit.repos.createOrUpdateFileContents({
       owner,
       repo: repoName,
-      path,
+      path: path2,
       message: `Add artifact: ${filename}`,
       content,
       branch: ARTIFACTS_BRANCH,
       sha: existingSha
     });
-    const url = `https://raw.githubusercontent.com/${repo}/${ARTIFACTS_BRANCH}/${path}`;
-    logger.info({ repo, path, url }, "Artifact uploaded");
+    const url = `https://raw.githubusercontent.com/${repo}/${ARTIFACTS_BRANCH}/${path2}`;
+    logger.info({ repo, path: path2, url }, "Artifact uploaded");
     return url;
   });
 }
@@ -558,7 +560,7 @@ import open from "open";
 // src/config/env/web.ts
 import { z as z2 } from "zod";
 var schema2 = z2.object({
-  SHIPYARD_WEB_URL: z2.string().url().default("http://localhost:5173")
+  SHIPYARD_WEB_URL: z2.string().url().default("https://schoolai.github.io/shipyard")
 });
 var webConfig = loadEnv(schema2);
 
@@ -1027,16 +1029,14 @@ async function waitForApprovalHandler(planId, _reviewRequestIdParam, ctx) {
     if (!reviewedBy) {
       throw new Error(`Invalid session state transition: missing reviewedBy for changes_requested`);
     }
-    if (!syncedFields) {
-      throw new Error(
-        `Invalid session state transition: changes_requested requires synced fields (contentHash, sessionToken)`
-      );
-    }
     const deliverables = extraData.deliverables || (isSessionStateApproved(session) || isSessionStateReviewed(session) || isSessionStateApprovedAwaitingToken(session) ? session.deliverables : []);
+    const webUrl = webConfig.SHIPYARD_WEB_URL;
     setSessionState(sessionId, {
       lifecycle: "reviewed",
       ...baseState,
-      ...syncedFields,
+      contentHash: syncedFields?.contentHash ?? "",
+      sessionToken: syncedFields?.sessionToken ?? "",
+      url: syncedFields?.url ?? `${webUrl}/plan/${baseState.planId}`,
       deliverables,
       reviewComment: reviewComment || "",
       reviewedBy,
@@ -1685,6 +1685,10 @@ function handleResolvedComments(doc, planId, threads, prev, actor) {
 }
 
 // src/registry-server.ts
+function getParam(value) {
+  if (Array.isArray(value)) return value[0];
+  return value;
+}
 var PERSISTENCE_DIR = join3(homedir3(), ".shipyard", "plans");
 var HUB_LOCK_FILE = join3(homedir3(), ".shipyard", "hub.lock");
 var SHIPYARD_DIR = join3(homedir3(), ".shipyard");
@@ -1988,7 +1992,8 @@ async function handleHealthCheck(_req, res) {
   res.json({ status: "ok" });
 }
 async function handleGetPRDiff(req, res) {
-  const { id: planId, prNumber } = req.params;
+  const planId = getParam(req.params.id);
+  const prNumber = getParam(req.params.prNumber);
   if (!planId || !prNumber) {
     res.status(400).json({ error: "Missing plan ID or PR number" });
     return;
@@ -2024,7 +2029,8 @@ async function handleGetPRDiff(req, res) {
   }
 }
 async function handleGetPRFiles(req, res) {
-  const { id: planId, prNumber } = req.params;
+  const planId = getParam(req.params.id);
+  const prNumber = getParam(req.params.prNumber);
   if (!planId || !prNumber) {
     res.status(400).json({ error: "Missing plan ID or PR number" });
     return;
@@ -2065,7 +2071,7 @@ async function handleGetPRFiles(req, res) {
   }
 }
 async function handleGetTranscript(req, res) {
-  const planId = req.params.id;
+  const planId = getParam(req.params.id);
   if (!planId) {
     res.status(400).json({ error: "Missing plan ID" });
     return;
@@ -2155,8 +2161,8 @@ function createApp() {
   app.get("/api/plans/:id/pr-diff/:prNumber", handleGetPRDiff);
   app.get("/api/plans/:id/pr-files/:prNumber", handleGetPRFiles);
   app.get("/artifacts/:planId/:filename", async (req, res) => {
-    const planId = req.params.planId;
-    const filename = req.params.filename;
+    const planId = getParam(req.params.planId);
+    const filename = getParam(req.params.filename);
     if (!planId || !filename) {
       res.status(400).json({ error: "Missing planId or filename" });
       return;
@@ -2291,29 +2297,28 @@ async function createWebRtcProvider(ydoc, planId) {
       }
     }
   });
-  let username;
-  try {
-    username = await getGitHubUsername();
-    const awarenessState = {
-      user: {
-        id: `mcp-${username}`,
-        name: `Claude Code (${username})`,
-        color: "#0066cc"
-      },
-      platform: "claude-code",
-      status: "approved",
-      isOwner: true,
-      webrtcPeerId: crypto.randomUUID()
-    };
-    provider.awareness.setLocalStateField("planStatus", awarenessState);
-    logger.info({ username, platform: "claude-code" }, "MCP awareness state set");
-    sendApprovalStateToSignaling(provider, planId, username);
-  } catch (error) {
-    logger.warn(
-      { error },
-      "Could not set MCP awareness (GitHub not authenticated - run: gh auth login)"
-    );
-  }
+  const username = await getGitHubUsername().catch(() => void 0);
+  const fallbackId = `mcp-anon-${crypto.randomUUID().slice(0, 8)}`;
+  const userId = username ? `mcp-${username}` : fallbackId;
+  const displayName = username ? `Claude Code (${username})` : "Claude Code";
+  const awarenessState = {
+    user: {
+      id: userId,
+      name: displayName,
+      color: "#0066cc"
+    },
+    platform: "claude-code",
+    status: "approved",
+    isOwner: true,
+    webrtcPeerId: crypto.randomUUID(),
+    context: getEnvironmentContext()
+  };
+  provider.awareness.setLocalStateField("planStatus", awarenessState);
+  logger.info(
+    { planId, username: username ?? fallbackId, platform: "claude-code", hasContext: true },
+    "MCP awareness state set"
+  );
+  sendApprovalStateToSignaling(provider, planId, username ?? fallbackId);
   setupProviderListeners(provider, planId);
   logger.info(
     {
@@ -2461,12 +2466,17 @@ async function hasActiveConnections2(planId) {
 }
 
 // src/tools/execute-code.ts
+import * as child_process from "child_process";
+import * as fs from "fs";
+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";
 
 // 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";
@@ -2847,6 +2857,7 @@ Linked to deliverable: ${input.deliverableId}` : "";
         const fragment = doc.getXmlFragment("document");
         const blocks = editor.yXmlFragmentToBlocks(fragment);
         const artifacts = getArtifacts(doc);
+        const hasLocalArtifacts = artifacts.some((a) => a.storage === "local");
         const completionSnapshot = createPlanSnapshot(
           doc,
           "Task completed - all deliverables fulfilled",
@@ -2898,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 = `
@@ -2921,13 +2940,15 @@ Type: ${type}
 Filename: ${filename}
 URL: ${artifactUrl}${linkedText}
 
-\u{1F389} ALL DELIVERABLES COMPLETE! Task auto-completed.
+\u{1F389} ALL DELIVERABLES COMPLETE! Task auto-completed.${prText}
 
-Snapshot URL: ${snapshotUrl}${prText}
-
-Embed this snapshot URL in your PR description as proof of completed work.`
+Snapshot URL saved to: ${snapshotFile}
+(Note: Very long URL - recommend not reading directly. Use file path to attach to PR or access later.)${hasLocalArtifacts ? "\n\n\u26A0\uFE0F WARNING: This plan contains local artifacts that will not be visible to remote viewers. For full remote access, configure GITHUB_TOKEN to upload artifacts to GitHub." : ""}`
             }
-          ]
+          ],
+          // Keep structured data for execute_code wrapper
+          snapshotUrl,
+          allDeliverablesComplete: true
         };
       }
       const statusText = statusChanged ? "\nStatus: draft \u2192 in_progress (auto-updated)" : "";
@@ -3227,6 +3248,7 @@ RETURNS:
       };
     }
     const artifacts = getArtifacts(ydoc);
+    const hasLocalArtifacts = artifacts.some((a) => a.storage === "local");
     if (artifacts.length === 0) {
       return {
         content: [
@@ -3346,6 +3368,9 @@ Generated with [Shipyard](https://github.com/SchoolAI/shipyard)"
 linkPR({ planId, sessionToken, prNumber: 42 })
 \`\`\``;
     }
+    if (hasLocalArtifacts) {
+      responseText += "\n\n\u26A0\uFE0F WARNING: This plan contains local artifacts that will not be visible to remote viewers. For full remote access, configure GITHUB_TOKEN to upload artifacts to GitHub.";
+    }
     return {
       content: [{ type: "text", text: responseText }]
     };
@@ -3602,7 +3627,7 @@ Bad deliverables (not provable):
       deleted: false
     });
     logger.info({ planId }, "Plan index updated");
-    const url = `http://localhost:5173/plan/${planId}`;
+    const url = `${webConfig.SHIPYARD_WEB_URL}/plan/${planId}`;
     await openPlanInBrowser(planId, url);
     const repoInfo = repo ? `Repo: ${repo}${!input.repo ? " (auto-detected)" : ""}` : "Repo: Not set (provide repo and prNumber for artifact uploads)";
     return {
@@ -4128,7 +4153,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: {
@@ -4146,25 +4173,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 {
@@ -4177,10 +4243,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)`
         }
       ]
     };
@@ -4474,7 +4543,40 @@ async function applyOperation(blocks, operation, editor) {
 
 // src/tools/update-plan.ts
 import { ServerBlockNoteEditor as ServerBlockNoteEditor7 } from "@blocknote/server-util";
+import { nanoid as nanoid7 } from "nanoid";
 import { z as z11 } from "zod";
+function buildStatusTransition(targetStatus, actorName) {
+  const now = Date.now();
+  switch (targetStatus) {
+    case "pending_review":
+      return {
+        status: "pending_review",
+        reviewRequestId: nanoid7()
+      };
+    case "changes_requested":
+      return {
+        status: "changes_requested",
+        reviewedAt: now,
+        reviewedBy: actorName
+      };
+    case "in_progress":
+      return {
+        status: "in_progress",
+        reviewedAt: now,
+        reviewedBy: actorName
+      };
+    case "completed":
+      return {
+        status: "completed",
+        completedAt: now,
+        completedBy: actorName
+      };
+    case "draft":
+      return null;
+    default:
+      return null;
+  }
+}
 var UpdatePlanInput = z11.object({
   planId: z11.string().describe("The plan ID to update"),
   sessionToken: z11.string().describe("Session token from create_plan"),
@@ -4524,6 +4626,7 @@ STATUSES:
       required: ["planId", "sessionToken"]
     }
   },
+  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: tool handler orchestrates validation, snapshots, and state transitions
   handler: async (args) => {
     const input = UpdatePlanInput.parse(args);
     const doc = await getOrCreateDoc3(input.planId);
@@ -4551,12 +4654,6 @@ STATUSES:
         isError: true
       };
     }
-    const updates = {
-      updatedAt: Date.now()
-    };
-    if (input.title) updates.title = input.title;
-    if (input.status) updates.status = input.status;
-    if (input.tags !== void 0) updates.tags = input.tags;
     const statusChanged = input.status && input.status !== existingMetadata.status;
     if (statusChanged && input.status) {
       const editor = ServerBlockNoteEditor7.create();
@@ -4565,8 +4662,52 @@ STATUSES:
       const reason = `Status changed to ${input.status}`;
       const snapshot = createPlanSnapshot(doc, reason, actorName, input.status, blocks);
       addSnapshot(doc, snapshot);
+      if (input.status === "draft") {
+        const resetResult = resetPlanToDraft(doc, actorName);
+        if (!resetResult.success) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Failed to reset plan to draft: ${resetResult.error}`
+              }
+            ],
+            isError: true
+          };
+        }
+      } else {
+        const transition = buildStatusTransition(input.status, actorName);
+        if (!transition) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Invalid status: ${input.status}`
+              }
+            ],
+            isError: true
+          };
+        }
+        const transitionResult = transitionPlanStatus(doc, transition, actorName);
+        if (!transitionResult.success) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Failed to transition status: ${transitionResult.error}`
+              }
+            ],
+            isError: true
+          };
+        }
+      }
+    }
+    const updates = {};
+    if (input.title) updates.title = input.title;
+    if (input.tags !== void 0) updates.tags = input.tags;
+    if (Object.keys(updates).length > 0) {
+      setPlanMetadata(doc, updates, actorName);
     }
-    setPlanMetadata(doc, updates, actorName);
     const indexDoc = await getOrCreateDoc3(PLAN_INDEX_DOC_NAME);
     if (existingMetadata.ownerId) {
       setPlanIndexEntry(indexDoc, {
@@ -4767,17 +4908,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? }>
@@ -4789,7 +4949,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:
@@ -5004,7 +5164,7 @@ async function addArtifact2(opts) {
   const metadata = getPlanMetadata(ydoc);
   let artifactUrl = "";
   if (addedArtifact) {
-    artifactUrl = addedArtifact.storage === "github" ? addedArtifact.url : `http://localhost:${process.env.REGISTRY_PORT || 3e3}/artifacts/${addedArtifact.localArtifactId}`;
+    artifactUrl = addedArtifact.storage === "github" ? addedArtifact.url : `http://localhost:${registryConfig.REGISTRY_PORT[0]}/artifacts/${addedArtifact.localArtifactId}`;
   }
   return {
     artifactId: addedArtifact?.id || "",
@@ -5064,7 +5224,7 @@ async function setupReviewNotification(planId, pollIntervalSeconds) {
   return { script, fullResponse: text };
 }
 async function requestUserInput(opts) {
-  const { InputRequestManager: InputRequestManager2 } = await import("./input-request-manager-MVKPYLFW.js");
+  const { InputRequestManager: InputRequestManager2 } = await import("./input-request-manager-73GSTOIB.js");
   const ydoc = await getOrCreateDoc3(PLAN_INDEX_DOC_NAME);
   const manager = new InputRequestManager2();
   const params = opts.type === "choice" ? {
@@ -5108,12 +5268,12 @@ async function requestUserInput(opts) {
   };
 }
 async function postActivityUpdate(opts) {
-  const { logPlanEvent: logPlanEvent2 } = await import("./dist-LQBXUHLR.js");
-  const { getGitHubUsername: getGitHubUsername2 } = await import("./server-identity-KUXYHULN.js");
-  const { nanoid: nanoid7 } = await import("nanoid");
+  const { logPlanEvent: logPlanEvent2 } = await import("./dist-ORKL4P3L.js");
+  const { getGitHubUsername: getGitHubUsername2 } = await import("./server-identity-6PHKR2FY.js");
+  const { nanoid: nanoid8 } = await import("nanoid");
   const doc = await getOrCreateDoc3(opts.planId);
   const actorName = await getGitHubUsername2();
-  const requestId = nanoid7();
+  const requestId = nanoid8();
   const eventId = logPlanEvent2(
     doc,
     "agent_activity",
@@ -5131,8 +5291,8 @@ async function postActivityUpdate(opts) {
   return { success: true, eventId, requestId };
 }
 async function resolveActivityRequest(opts) {
-  const { logPlanEvent: logPlanEvent2, getPlanEvents } = await import("./dist-LQBXUHLR.js");
-  const { getGitHubUsername: getGitHubUsername2 } = await import("./server-identity-KUXYHULN.js");
+  const { logPlanEvent: logPlanEvent2, getPlanEvents } = await import("./dist-ORKL4P3L.js");
+  const { getGitHubUsername: getGitHubUsername2 } = await import("./server-identity-6PHKR2FY.js");
   const doc = await getOrCreateDoc3(opts.planId);
   const actorName = await getGitHubUsername2();
   const events = getPlanEvents(doc);
@@ -5176,7 +5336,38 @@ var executeCodeTool = {
     const { code } = ExecuteCodeInput.parse(args);
     logger.info({ codeLength: code.length }, "Executing code");
     try {
+      async function encodeVideo(opts) {
+        const fps = opts.fps || 6;
+        const outputPath = opts.outputPath || path.join(os.tmpdir(), `video-${Date.now()}.mp4`);
+        const { spawnSync } = child_process;
+        const result2 = spawnSync(
+          ffmpegInstaller.path,
+          [
+            "-y",
+            "-framerate",
+            String(fps),
+            "-i",
+            path.join(opts.framesDir, "frame-%06d.jpg"),
+            "-vf",
+            "scale=trunc(iw/2)*2:trunc(ih/2)*2",
+            "-c:v",
+            "libx264",
+            "-pix_fmt",
+            "yuv420p",
+            "-preset",
+            "fast",
+            outputPath
+          ],
+          { encoding: "utf-8", timeout: 6e4 }
+        );
+        if (result2.status !== 0) {
+          throw new Error(`FFmpeg encoding failed: ${result2.stderr?.slice(-300)}`);
+        }
+        fs.rmSync(opts.framesDir, { recursive: true, force: true });
+        return outputPath;
+      }
       const sandbox = {
+        // Shipyard API functions
         createPlan,
         readPlan,
         updatePlan,
@@ -5189,6 +5380,15 @@ var executeCodeTool = {
         requestUserInput,
         postActivityUpdate,
         resolveActivityRequest,
+        // Video encoding helper (uses bundled FFmpeg)
+        encodeVideo,
+        // Node.js modules for advanced workflows (file ops, process spawning)
+        child_process,
+        fs,
+        path,
+        os,
+        // FFmpeg bundled with server - no installation required
+        ffmpegPath: ffmpegInstaller.path,
         console: {
           log: (...logArgs) => logger.info({ output: logArgs }, "console.log"),
           error: (...logArgs) => logger.error({ output: logArgs }, "console.error")
@@ -5226,7 +5426,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 = {
@@ -5283,7 +5483,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",