@mindstudio-ai/remy 0.1.278 → 0.1.280

package/dist/headless.js

@@ -813,6 +813,10 @@ function buildSystemPrompt(onboardingState) {
   {{compiled/auth.md}}
   </auth>
 
+  <jewels>
+  {{compiled/jewels.md}}
+  </jewels>
+
   <dev_and_deploy>
   {{compiled/dev-and-deploy.md}}
   </dev_and_deploy>
@@ -867,7 +871,7 @@ New projects progress through four onboarding states. The user might skip this e
 
 - **intake**: Gathering requirements. The project has scaffold code (a "hello world" starter) but it's not the user's app yet. Focus on understanding what they want to build, not on the existing code. Intake ends with a plan proposal via writePlan.
 - **building**: The user approved the initial plan. The agent is writing the spec and building the app. This can take a while and involves heavy tool use (spec authoring, design expert consultation, code generation, verification, polishing).
-- **buildComplete**: The build is done. The frontend is showing the user a reveal experience (pitch deck, app preview). The agent does not need to do anything in this state; the frontend advances to onboardingFinished when the user is ready.
+- **buildComplete**: The build is done \u2014 entered via markBuildComplete at the end of the automated post-build flow. Transient: the frontend lands the user on the Build Overview, fully unlocks the editor, and immediately advances to onboardingFinished on its own. The agent does not need to do anything in this state.
 - **onboardingFinished**: The project is built and ready. Full development mode with all tools available. From here on, keep spec and code in sync as changes are made.
 </project_onboarding>
 
@@ -1488,21 +1492,14 @@ var updatePlanStatusTool = {
   }
 };
 
-// src/tools/common/setProjectOnboardingState.ts
-var setProjectOnboardingStateTool = {
+// src/tools/common/markBuildComplete.ts
+var markBuildCompleteTool = {
   definition: {
-    name: "setProjectOnboardingState",
-    description: "Advance the project onboarding state. Forward-only: building \u2192 buildComplete \u2192 onboardingFinished. Normally driven by automated actions \u2014 don't call this out of order during a normal build, or you'll skip stages the user hasn't experienced. Exception: if the project has been in `building` for a while, the build is clearly done (the user is iterating on a working app, deploying, etc.), and the user reports the editor seems stuck \u2014 disabled Preview/Spec/Code tabs, no reveal, etc. \u2014 call `setProjectOnboardingState({ state: 'buildComplete' })` to unstick them. `onboardingFinished` is always set by the frontend after the user dismisses the reveal; never call it yourself.",
+    name: "markBuildComplete",
+    description: 'Mark the initial build as finished. The frontend lands the user on the Build Overview, fully unlocks the editor, and finishes onboarding; the platform sends the one-time "your first build is ready" email. Normally called as the final step of the automated post-build flow \u2014 don\'t call it early, or you\'ll cut the build experience short. Exception: if the project has been in `building` for a while, the build is clearly done (the user is iterating on a working app, deploying, etc.), and the user reports the editor seems stuck \u2014 disabled Preview/Spec/Code tabs \u2014 call this to unstick them. Refused during intake: the user starts the build via "Start Building", never you.',
     inputSchema: {
       type: "object",
-      properties: {
-        state: {
-          type: "string",
-          enum: ["building", "buildComplete", "onboardingFinished"],
-          description: "The onboarding state to advance to."
-        }
-      },
-      required: ["state"]
+      properties: {}
     }
   },
   async execute() {
@@ -2981,6 +2978,35 @@ var runMethodTool = {
   }
 };
 
+// src/tools/code/testJewel.ts
+var testJewelTool = {
+  definition: {
+    name: "testJewel",
+    description: "Run a method's jewel directly against a test input and return its pair record. Use after writing or modifying a jewel to verify the subject projection, the proposal, and the grading \u2014 the method itself is NOT executed (no data changes) and nothing reaches the pair ledger. Pass `humanInput` (the exact input a human would have submitted) for a full graded run: the jewel derives the subject from it, proposes, and grades its proposal against it as ground truth \u2014 the record carries a verdict (agree/disagree/skip). Or pass `subject` for an ungraded eval run (propose only). Returns the full pair record (subject, proposed, reasoning, actual, verdict, notes, error) plus captured console output and duration. A `pair.error` means your jewel code threw in that phase \u2014 fix and re-run. Seed realistic data first (runScenario) so the jewel's reads have a world to look at.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        method: {
+          type: "string",
+          description: 'The shadowed method\'s export name (camelCase, e.g. "updateIssue"). Its manifest entry must have a `jewel` pointer.'
+        },
+        humanInput: {
+          type: "object",
+          description: "Shadow-style run: the exact method input a human would have submitted. The jewel derives its subject from this, proposes, and grades against it \u2014 the record gets a verdict. Use realistic inputs; this is how you verify agreement."
+        },
+        subject: {
+          type: "object",
+          description: "Eval run: a subject to propose against with no ground truth (record is ungraded). Use to probe the jewel on cases where you don't know the right answer yet. Pass exactly one of humanInput or subject."
+        }
+      },
+      required: ["method"]
+    }
+  },
+  async execute() {
+    return "ok";
+  }
+};
+
 // src/tools/code/queryDatabase.ts
 var queryDatabaseTool = {
   definition: {
@@ -5524,6 +5550,147 @@ This reference lives at ${skill.path}. Re-read it with readFile if you need it a
   }
 }
 
+// src/subagents/designExpert/tools/createWireframe.ts
+var createWireframe_exports = {};
+__export(createWireframe_exports, {
+  WIREFRAMES_DIR: () => WIREFRAMES_DIR,
+  definition: () => definition10,
+  execute: () => execute10
+});
+import { mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
+import { join as join2 } from "path";
+var log9 = createLogger("createWireframe");
+var WIREFRAMES_DIR = "src/.wireframes";
+var UPLOAD_TIMEOUT_MS2 = 3e4;
+var definition10 = {
+  name: "createWireframe",
+  description: "Create a wireframe from self-contained HTML+CSS. Returns a markdown reference line \u2014 include that exact line in your response wherever the wireframe belongs, with your notes in the surrounding prose. To revise a wireframe, create a new one (read the old file first if you are iterating on it).",
+  inputSchema: {
+    type: "object",
+    properties: {
+      name: {
+        type: "string",
+        description: 'Short display name, e.g. "Feed Post Card". Becomes the caption and the filename slug.'
+      },
+      description: {
+        type: "string",
+        description: "One line on what the wireframe shows \u2014 layout, states, motion."
+      },
+      html: {
+        type: "string",
+        description: "The complete HTML document (<html>\u2026</html>), self-contained vanilla HTML/CSS/JS. No frontmatter \u2014 it is added for you."
+      }
+    },
+    required: ["name", "description", "html"]
+  }
+};
+function slugify(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40).replace(/-+$/, "") || "wireframe";
+}
+function singleLine(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+function validate(name, html) {
+  const warnings = [];
+  if (!name.trim()) {
+    return { error: "Error: name is required.", warnings };
+  }
+  if (!html.trim()) {
+    return { error: "Error: html is required.", warnings };
+  }
+  if (/^\s*---/.test(html)) {
+    return {
+      error: "Error: html must not include frontmatter \u2014 pass name and description as parameters and the frontmatter is added for you.",
+      warnings
+    };
+  }
+  if (/<img[\s>]/i.test(html)) {
+    return {
+      error: "Error: wireframes must not contain <img> tags. Use skeleton placeholders (grey boxes, gradients) instead of images.",
+      warnings
+    };
+  }
+  if (!/<style[\s>]/i.test(html) && !/style=/i.test(html)) {
+    return {
+      error: "Error: no CSS found. Wireframes are self-contained HTML+CSS \u2014 style the component container (not the body) so it reads against the transparent background.",
+      warnings
+    };
+  }
+  const lines = html.split("\n").length;
+  if (lines > 120) {
+    warnings.push(
+      `The wireframe is ${lines} lines \u2014 past the ~100-line budget. Wireframes isolate one small piece; consider whether this is building too much.`
+    );
+  }
+  return { warnings };
+}
+async function uploadMirror(context, slug, content) {
+  const { apiConfig } = context;
+  if (!apiConfig?.appId) {
+    return { ok: false, note: "no app id in this session" };
+  }
+  try {
+    const url = `${apiConfig.baseUrl}/_internal/v2/apps/${apiConfig.appId}/dev/wireframes`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiConfig.apiKey}`
+      },
+      body: JSON.stringify({ slug, content }),
+      signal: AbortSignal.timeout(UPLOAD_TIMEOUT_MS2)
+    });
+    if (!res.ok) {
+      return { ok: false, note: `HTTP ${res.status}` };
+    }
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, note: err.message };
+  }
+}
+async function execute10(input, onLog, context) {
+  if (!context) {
+    return "Error: createWireframe requires execution context";
+  }
+  const name = String(input.name ?? "");
+  const description = String(input.description ?? "");
+  const html = String(input.html ?? "");
+  const { error, warnings } = validate(name, html);
+  if (error) {
+    return error;
+  }
+  const slug = `${slugify(name)}-${Math.random().toString(36).slice(2, 8)}`;
+  const relPath = `${WIREFRAMES_DIR}/${slug}.html`;
+  const content = [
+    "---",
+    `name: ${singleLine(name)}`,
+    `description: ${singleLine(description)}`,
+    "---",
+    html.trim(),
+    ""
+  ].join("\n");
+  await mkdir2(join2(PROJECT_ROOT, WIREFRAMES_DIR), { recursive: true });
+  await writeFile2(join2(PROJECT_ROOT, relPath), content, "utf8");
+  onLog?.(`Wrote ${relPath}, mirroring for preview...`);
+  const mirror = await uploadMirror(context, slug, content);
+  if (!mirror.ok) {
+    log9.warn("Wireframe mirror upload failed", { slug, note: mirror.note });
+  }
+  const lines = [
+    `Created wireframe "${singleLine(name)}" at ${relPath}.`,
+    `Reference it in your response and in specs with exactly: ![${singleLine(name)}](${relPath})`
+  ];
+  if (!mirror.ok) {
+    lines.push(
+      `Note: the preview mirror upload failed (${mirror.note}) \u2014 the file is intact and usable by the developer, but the wireframe may not render visually in the dashboard. Do not retry; mention the layout in prose as well.`
+    );
+  }
+  if (warnings.length > 0) {
+    lines.push(...warnings.map((w) => `Note: ${w}`));
+  }
+  return lines.join("\n");
+}
+
 // src/subagents/designExpert/tools/index.ts
 var tools = {
   searchGoogle: searchGoogle_exports,
@@ -5538,7 +5705,9 @@ var tools = {
   editImages: editImages_exports,
   renderImage: renderImage_exports,
   polishCopy: polishCopy_exports,
-  loadSkill: loadSkill_exports
+  loadSkill: loadSkill_exports,
+  // Appended last: tool order is part of the subagent's prompt-cache prefix.
+  createWireframe: createWireframe_exports
 };
 var DESIGN_EXPERT_TOOLS = [
   ...COMMON_READ_TOOLS,
@@ -6516,7 +6685,7 @@ function deriveContext(parent, toolCallId) {
 }
 var ALL_TOOLS = [
   // Common
-  setProjectOnboardingStateTool,
+  markBuildCompleteTool,
   promptUserTool,
   confirmDestructiveActionTool,
   askMindStudioSdkTool,
@@ -6559,7 +6728,8 @@ var ALL_TOOLS = [
   restartProcessTool,
   // Appended rather than grouped: position is part of the cache prefix, so a
   // new tool goes at the end to leave every existing session's prefix intact.
-  loadSkillTool
+  loadSkillTool,
+  testJewelTool
 ];
 var SUBAGENT_TOOL_NAMES = /* @__PURE__ */ new Set([
   "visualDesignExpert",
@@ -6585,7 +6755,7 @@ function executeTool(name, input, context) {
 }
 
 // src/compaction/index.ts
-var log9 = createLogger("compaction");
+var log10 = createLogger("compaction");
 var CONVERSATION_SUMMARY_PROMPT = readAsset("compaction", "conversation.md");
 var SUBAGENT_SUMMARY_PROMPT = readAsset("compaction", "subagent.md");
 var SUMMARIZABLE_SUBAGENTS = ["visualDesignExpert", "productVision"];
@@ -6634,7 +6804,7 @@ async function compactConversation(messages, apiConfig, model) {
           if (text) {
             summaries.push({ name, text });
           } else {
-            log9.warn("Subagent summary unusable \u2014 leaving its history intact", {
+            log10.warn("Subagent summary unusable \u2014 leaving its history intact", {
               name
             });
           }
@@ -6662,7 +6832,7 @@ async function compactConversation(messages, apiConfig, model) {
       }
     ]
   }));
-  log9.info("Compaction complete", {
+  log10.info("Compaction complete", {
     summaries: summaries.length,
     recentNarrativeChars: recent.length
   });
@@ -6868,7 +7038,7 @@ async function generateSummary(apiConfig, name, compactionPrompt, messagesToSumm
       messagesToSummarize.slice(0, mid),
       messagesToSummarize.slice(mid)
     ];
-    log9.info("Chunking summary", {
+    log10.info("Chunking summary", {
       name,
       messageCount: messagesToSummarize.length,
       serializedLength: serialized.length,
@@ -6898,7 +7068,7 @@ async function generateSummary(apiConfig, name, compactionPrompt, messagesToSumm
     const parts = results.filter((p) => p !== null);
     return parts.length > 0 ? parts.join("\n\n---\n\n") : null;
   }
-  log9.info("Generating summary", {
+  log10.info("Generating summary", {
     name,
     messageCount: messagesToSummarize.length,
     serializedLength: serialized.length
@@ -6914,10 +7084,10 @@ async function generateSummary(apiConfig, name, compactionPrompt, messagesToSumm
     return null;
   }
   if (summaryText.length >= MIN_SUMMARY_CHARS) {
-    log9.info("Summary generated", { name, summaryLength: summaryText.length });
+    log10.info("Summary generated", { name, summaryLength: summaryText.length });
     return summaryText;
   }
-  log9.warn("Summary too short to be real", {
+  log10.warn("Summary too short to be real", {
     name,
     summaryLength: summaryText.length,
     minimum: MIN_SUMMARY_CHARS,
@@ -6977,12 +7147,12 @@ Write the summary of the conversation above, following your instructions.`;
         toolNames: []
       });
     } else if (event.type === "error") {
-      log9.error("Summary generation failed", { name, error: event.error });
+      log10.error("Summary generation failed", { name, error: event.error });
       return null;
     }
   }
   if (!summaryText.trim()) {
-    log9.warn("Empty summary generated", { name });
+    log10.warn("Empty summary generated", { name });
     return null;
   }
   return summaryText.trim();
@@ -6991,7 +7161,7 @@ Write the summary of the conversation above, following your instructions.`;
 // src/session.ts
 import fs21 from "fs";
 import path11 from "path";
-var log10 = createLogger("session");
+var log11 = createLogger("session");
 var SESSION_FILE = ".remy-session.json";
 var ARCHIVE_DIR = ".logs/sessions";
 var ARCHIVE_NAME_RE = /^(cleared|rotated)-.*\.json$/;
@@ -7010,7 +7180,7 @@ function loadSession(state) {
     }
     if (Array.isArray(data.messages) && data.messages.length > 0) {
       state.messages = sanitizeMessages(data.messages);
-      log10.info("Session loaded", {
+      log11.info("Session loaded", {
         messageCount: state.messages.length,
         ...state.models && { models: state.models }
       });
@@ -7020,7 +7190,7 @@ function loadSession(state) {
     try {
       const quarantine = `${SESSION_FILE}.corrupt-${Date.now()}`;
       fs21.renameSync(SESSION_FILE, quarantine);
-      log10.warn(`Session file unreadable \u2014 quarantined to ${quarantine}`);
+      log11.warn(`Session file unreadable \u2014 quarantined to ${quarantine}`);
     } catch {
     }
   }
@@ -7085,7 +7255,7 @@ function archiveMessages(messages, label, models) {
   }
   writeFileAtomicSync(dest, JSON.stringify(payload));
   archiveCountCache.set(path11.basename(dest), count);
-  log10.info("Session archived", { label, dest, messageCount: count });
+  log11.info("Session archived", { label, dest, messageCount: count });
   pruneArchives();
   return dest;
 }
@@ -7122,7 +7292,7 @@ function pruneArchives() {
       }
     }
     if (removed > 0) {
-      log10.info("Session archives pruned", {
+      log11.info("Session archives pruned", {
         removed,
         freedBytes: freed,
         keptBytes: kept
@@ -7156,7 +7326,7 @@ function parseArchive(name) {
     }
     return messages;
   } catch (err) {
-    log10.warn("Session archive unreadable", { name, error: err?.message });
+    log11.warn("Session archive unreadable", { name, error: err?.message });
     return null;
   }
 }
@@ -7271,7 +7441,7 @@ function getHistoryPage(state, opts) {
       }
       messages.splice(0, cut);
       startIndex += cut;
-      log10.info("History page trimmed to byte budget", {
+      log11.info("History page trimmed to byte budget", {
         dropped: cut,
         kept: messages.length,
         startIndex
@@ -7302,7 +7472,7 @@ function rotate(state) {
   }
   archiveMessages(messages.slice(0, cut), "rotated", state.models);
   state.messages = messages.slice(cut);
-  log10.info("Session rotated", {
+  log11.info("Session rotated", {
     archived: cut,
     retained: state.messages.length
   });
@@ -7315,9 +7485,9 @@ function saveSession(state) {
       serialized = JSON.stringify(buildPayload(state));
     }
     writeFileAtomicSync(SESSION_FILE, serialized);
-    log10.info("Session saved", { messageCount: state.messages.length });
+    log11.info("Session saved", { messageCount: state.messages.length });
   } catch (err) {
-    log10.warn("Session save failed", { error: err.message });
+    log11.warn("Session save failed", { error: err.message });
   }
 }
 function clearSession(state) {
@@ -7326,7 +7496,7 @@ function clearSession(state) {
       archiveMessages(state.messages, "cleared", state.models);
     }
   } catch (err) {
-    log10.warn("Session archive on clear failed", { error: err.message });
+    log11.warn("Session archive on clear failed", { error: err.message });
   }
   state.messages = [];
   try {
@@ -7334,14 +7504,14 @@ function clearSession(state) {
       fs21.unlinkSync(SESSION_FILE);
     }
   } catch (err) {
-    log10.warn("Session clear: could not remove live file", {
+    log11.warn("Session clear: could not remove live file", {
       error: err.message
     });
   }
 }
 
 // src/compaction/trigger.ts
-var log11 = createLogger("compaction:trigger");
+var log12 = createLogger("compaction:trigger");
 var pending = null;
 var inflightCompaction = null;
 function getInflightCompaction() {
@@ -7380,7 +7550,7 @@ function applyPendingSummaries(state) {
     idx = at === -1 ? 0 : at + 1;
   }
   state.messages.splice(idx, 0, ...drained.checkpoints);
-  log11.info("Checkpoint applied", {
+  log12.info("Checkpoint applied", {
     index: idx,
     messageCount: state.messages.length
   });
@@ -7414,7 +7584,7 @@ function triggerCompaction(state, apiConfig, opts = {}) {
     return inflightCompaction;
   }
   if (pending) {
-    log11.info("Compaction skipped \u2014 a checkpoint is already waiting to apply");
+    log12.info("Compaction skipped \u2014 a checkpoint is already waiting to apply");
     return Promise.resolve(null);
   }
   const { blocking = false, requestId, model, origin, toolCallId } = opts;
@@ -7431,12 +7601,12 @@ function triggerCompaction(state, apiConfig, opts = {}) {
       requestId,
       ...summaries.length > 0 && { summaries }
     });
-    log11.info("Compaction complete");
+    log12.info("Compaction complete");
     return summaries;
   }).catch((err) => {
     const message = err.message || "Compaction failed";
     listener?.({ type: "complete", error: message, requestId });
-    log11.error("Compaction failed", { error: message });
+    log12.error("Compaction failed", { error: message });
     throw err;
   }).finally(() => {
     inflightCompaction = null;
@@ -7448,7 +7618,7 @@ function triggerCompaction(state, apiConfig, opts = {}) {
 import fs22 from "fs";
 import path12 from "path";
 import { createHash } from "crypto";
-var log12 = createLogger("brandExtraction");
+var log13 = createLogger("brandExtraction");
 var EXTRACT_PROMPT = readAsset("brandExtraction", "extract.md");
 var BRAND_FILE = ".remy-brand.json";
 var CACHE_FILE = ".remy-brand.cache.json";
@@ -7456,17 +7626,17 @@ async function runExtraction(apiConfig, model) {
   const inputHash = computeInputHash();
   const cached3 = readCache();
   if (cached3 && cached3.inputHash === inputHash) {
-    log12.debug("Brand inputs unchanged \u2014 skipping extraction", { inputHash });
+    log13.debug("Brand inputs unchanged \u2014 skipping extraction", { inputHash });
     return null;
   }
-  log12.info("Extracting brand", { inputHash });
+  log13.info("Extracting brand", { inputHash });
   const brand = await extractBrand(apiConfig, model);
   if (!brand) {
-    log12.warn("Brand extraction failed \u2014 leaving cache untouched");
+    log13.warn("Brand extraction failed \u2014 leaving cache untouched");
     return null;
   }
   persistBrand(brand, inputHash);
-  log12.info("Brand persisted", { inputHash });
+  log13.info("Brand persisted", { inputHash });
   return brand;
 }
 function isDedicatedBrandFile(filePath) {
@@ -7552,7 +7722,7 @@ function parseFrontmatter3(filePath) {
 async function extractBrand(apiConfig, model) {
   const corpus = buildCorpus();
   if (!corpus.trim()) {
-    log12.debug("No spec corpus \u2014 emitting empty brand");
+    log13.debug("No spec corpus \u2014 emitting empty brand");
     return { version: 1 };
   }
   let responseText = "";
@@ -7586,17 +7756,17 @@ async function extractBrand(apiConfig, model) {
           toolNames: []
         });
       } else if (event.type === "error") {
-        log12.error("Brand extraction stream error", { error: event.error });
+        log13.error("Brand extraction stream error", { error: event.error });
         return null;
       }
     }
   } catch (err) {
-    log12.error("Brand extraction threw", { error: err?.message });
+    log13.error("Brand extraction threw", { error: err?.message });
     return null;
   }
   const parsed = parseJsonResponse(responseText);
   if (!parsed) {
-    log12.warn("Brand extraction returned unparseable JSON", {
+    log13.warn("Brand extraction returned unparseable JSON", {
       preview: responseText.slice(0, 200)
     });
     return null;
@@ -7767,7 +7937,7 @@ function readCache() {
 }
 
 // src/brandExtraction/trigger.ts
-var log13 = createLogger("brandExtraction:trigger");
+var log14 = createLogger("brandExtraction:trigger");
 var inflight = false;
 var dirty = false;
 function triggerBrandExtraction(apiConfig, model) {
@@ -7777,7 +7947,7 @@ function triggerBrandExtraction(apiConfig, model) {
   }
   inflight = true;
   void runExtraction(apiConfig, model).catch((err) => {
-    log13.error("Brand extraction failed", { error: err?.message });
+    log14.error("Brand extraction failed", { error: err?.message });
   }).finally(() => {
     inflight = false;
     if (dirty) {
@@ -8041,7 +8211,7 @@ function friendlyError(raw) {
 }
 
 // src/agent.ts
-var log14 = createLogger("agent");
+var log15 = createLogger("agent");
 var BRAND_TRIGGERING_TOOLS = /* @__PURE__ */ new Set([
   "writeSpec",
   "editSpec",
@@ -8057,11 +8227,12 @@ function getToolCalls(blocks) {
 }
 var EXTERNAL_TOOLS = /* @__PURE__ */ new Set([
   "promptUser",
-  "setProjectOnboardingState",
+  "markBuildComplete",
   "presentPublishPlan",
   "confirmDestructiveAction",
   "runScenario",
   "runMethod",
+  "testJewel",
   "queryDatabase",
   "browserCommand",
   "setProjectMetadata"
@@ -8105,7 +8276,7 @@ async function runTurn(params) {
     (n, e) => n + (e.attachments?.length ?? 0),
     0
   );
-  log14.info("Turn started", {
+  log15.info("Turn started", {
     requestId,
     model,
     buildModel: buildModelOverride,
@@ -8154,7 +8325,7 @@ async function runTurn(params) {
   }
   const isFirstMessage = state.messages.filter((m) => m.role === "user").length === 1;
   const STATUS_EXCLUDED_TOOLS = /* @__PURE__ */ new Set([
-    "setProjectOnboardingState",
+    "markBuildComplete",
     "setProjectMetadata",
     "editsFinished"
   ]);
@@ -8400,7 +8571,7 @@ async function runTurn(params) {
               const acc = toolInputAccumulators.get(event.id);
               const wasStreamed = acc?.started ?? false;
               const isInputStreaming = !!tool?.streaming?.partialInput;
-              log14.info("Tool received", {
+              log15.info("Tool received", {
                 requestId,
                 toolCallId: event.id,
                 name: event.name
@@ -8519,7 +8690,7 @@ async function runTurn(params) {
       const toolCalls = getToolCalls(contentBlocks);
       if (toolCalls.length === 0 && (stopReason === "repetition" || stopReason === "max_tokens") && abnormalStopRecoveries < MAX_ABNORMAL_STOP_RECOVERIES && !signal?.aborted) {
         abnormalStopRecoveries++;
-        log14.warn("Abnormal stop \u2014 nudging model to continue", {
+        log15.warn("Abnormal stop \u2014 nudging model to continue", {
           requestId,
           stopReason,
           attempt: abnormalStopRecoveries
@@ -8547,7 +8718,7 @@ async function runTurn(params) {
         });
         return;
       }
-      log14.info("Tools executing", {
+      log15.info("Tools executing", {
         requestId,
         count: toolCalls.length,
         tools: toolCalls.map((tc) => tc.name)
@@ -8594,7 +8765,7 @@ async function runTurn(params) {
               let result;
               if (EXTERNAL_TOOLS.has(tc.name) && resolveExternalTool) {
                 saveSession(state);
-                log14.info("Waiting for external tool result", {
+                log15.info("Waiting for external tool result", {
                   requestId,
                   toolCallId: tc.id,
                   name: tc.name
@@ -8662,7 +8833,7 @@ async function runTurn(params) {
           if (!isBackgroundCall(tc)) {
             toolRegistry?.unregister(tc.id);
           }
-          log14.info("Tool completed", {
+          log15.info("Tool completed", {
             requestId,
             toolCallId: tc.id,
             name: tc.name,
@@ -8739,9 +8910,9 @@ async function runTurn(params) {
 
 // src/headless/attachments.ts
 import { mkdirSync, existsSync } from "fs";
-import { writeFile as writeFile2 } from "fs/promises";
-import { basename as basename2, join as join2, extname as extname2 } from "path";
-var log15 = createLogger("headless:attachments");
+import { writeFile as writeFile3 } from "fs/promises";
+import { basename as basename2, join as join3, extname as extname2 } from "path";
+var log16 = createLogger("headless:attachments");
 var UPLOADS_DIR = "src/.user-uploads";
 function filenameFromUrl(url) {
   try {
@@ -8753,7 +8924,7 @@ function filenameFromUrl(url) {
   }
 }
 function resolveUniqueFilename(name, claimed) {
-  const isFree = (candidate) => !claimed.has(candidate) && !existsSync(join2(UPLOADS_DIR, candidate));
+  const isFree = (candidate) => !claimed.has(candidate) && !existsSync(join3(UPLOADS_DIR, candidate));
   if (isFree(name)) {
     return name;
   }
@@ -8788,7 +8959,7 @@ async function persistAttachments(attachments) {
   const results = await Promise.allSettled(
     nonVoice.map(async (att, i) => {
       const name = names[i];
-      const localPath = join2(UPLOADS_DIR, name);
+      const localPath = join3(UPLOADS_DIR, name);
       const res = await fetch(att.url, {
         signal: AbortSignal.timeout(3e4)
       });
@@ -8796,8 +8967,8 @@ async function persistAttachments(attachments) {
         throw new Error(`HTTP ${res.status} downloading ${att.url}`);
       }
       const buffer = Buffer.from(await res.arrayBuffer());
-      await writeFile2(localPath, buffer);
-      log15.info("Attachment saved", {
+      await writeFile3(localPath, buffer);
+      log16.info("Attachment saved", {
         filename: name,
         path: localPath,
         bytes: buffer.length
@@ -8810,8 +8981,8 @@ async function persistAttachments(attachments) {
           });
           if (textRes.ok) {
             extractedTextPath = `${localPath}.txt`;
-            await writeFile2(extractedTextPath, await textRes.text(), "utf-8");
-            log15.info("Extracted text saved", { path: extractedTextPath });
+            await writeFile3(extractedTextPath, await textRes.text(), "utf-8");
+            log16.info("Extracted text saved", { path: extractedTextPath });
           }
         } catch {
         }
@@ -9017,8 +9188,10 @@ var MessageQueue = class {
 };
 
 // src/headless/index.ts
-var log16 = createLogger("headless");
+var log17 = createLogger("headless");
 var EXTERNAL_TOOL_TIMEOUT_MS = 3e5;
+var LONG_RUNNING_TOOLS = /* @__PURE__ */ new Set(["runMethod", "testJewel"]);
+var LONG_RUNNING_TOOL_TIMEOUT_MS = 18e5;
 var USER_FACING_TOOLS = /* @__PURE__ */ new Set([
   "promptUser",
   "confirmDestructiveAction",
@@ -9240,7 +9413,7 @@ var HeadlessSession = class {
     }
     const line = JSON.stringify(payload) + "\n";
     if (event === "history") {
-      log16.info("Wrote history event to stdout", {
+      log17.info("Wrote history event to stdout", {
         requestId,
         bytes: line.length
       });
@@ -9326,7 +9499,7 @@ var HeadlessSession = class {
     if (this.sessionStats.lastContextSize <= FORCED_COMPACTION_THRESHOLD_TOKENS) {
       return;
     }
-    log16.info("Forced compaction gate triggered", {
+    log17.info("Forced compaction gate triggered", {
       contextSize: this.sessionStats.lastContextSize,
       threshold: FORCED_COMPACTION_THRESHOLD_TOKENS,
       requestId
@@ -9345,7 +9518,7 @@ var HeadlessSession = class {
   onBackgroundComplete = (toolCallId, name, result, subAgentMessages) => {
     const notify = getToolByName(name)?.backgroundNotify ?? "wake";
     this.pendingBlockUpdates.push({ toolCallId, result, subAgentMessages });
-    log16.info("Background complete", {
+    log17.info("Background complete", {
       toolCallId,
       name,
       notify,
@@ -9397,13 +9570,14 @@ var HeadlessSession = class {
       return Promise.resolve(early);
     }
     const shouldTimeout = !USER_FACING_TOOLS.has(name);
+    const timeoutMs = LONG_RUNNING_TOOLS.has(name) ? LONG_RUNNING_TOOL_TIMEOUT_MS : EXTERNAL_TOOL_TIMEOUT_MS;
     return new Promise((resolve4) => {
       const timeout = shouldTimeout ? setTimeout(() => {
         this.pendingTools.delete(id);
         resolve4(
-          "Error: Tool timed out \u2014 no response from the app environment after 5 minutes."
+          `Error: Tool timed out \u2014 no response from the app environment after ${Math.round(timeoutMs / 6e4)} minutes.`
         );
-      }, EXTERNAL_TOOL_TIMEOUT_MS) : void 0;
+      }, timeoutMs) : void 0;
       this.pendingTools.set(id, {
         resolve: (result) => {
           clearTimeout(timeout);
@@ -9607,7 +9781,7 @@ var HeadlessSession = class {
       const { documents, images } = await persistAttachments(attachments);
       return buildUploadHeader(documents, images) || void 0;
     } catch (err) {
-      log16.warn("Attachment persistence failed", { error: err.message });
+      log17.warn("Attachment persistence failed", { error: err.message });
       return void 0;
     }
   }
@@ -9621,7 +9795,7 @@ var HeadlessSession = class {
   async runSingleTurn(parsed, requestId, fromChain = false, queued = false) {
     const attachments = parsed.attachments;
     if (attachments?.length) {
-      log16.info("Message has attachments", {
+      log17.info("Message has attachments", {
         count: attachments.length,
         urls: attachments.map((a) => a.url)
       });
@@ -9809,7 +9983,7 @@ var HeadlessSession = class {
           error: "Turn ended unexpectedly"
         });
       }
-      log16.info("Turn complete", {
+      log17.info("Turn complete", {
         requestId,
         durationMs: Date.now() - this.turnStart
       });
@@ -9821,7 +9995,7 @@ var HeadlessSession = class {
           error: err.message
         });
       }
-      log16.warn("Command failed", {
+      log17.warn("Command failed", {
         action: "message",
         requestId,
         error: err.message
@@ -10031,7 +10205,7 @@ var HeadlessSession = class {
     try {
       parsed = JSON.parse(line);
     } catch (err) {
-      log16.warn("Invalid JSON on stdin", {
+      log17.warn("Invalid JSON on stdin", {
         error: err.message,
         lineLength: line.length,
         preview: line.slice(0, 200)
@@ -10040,7 +10214,7 @@ var HeadlessSession = class {
       return;
     }
     const { action, requestId } = parsed;
-    log16.info("Command received", { action, requestId });
+    log17.info("Command received", { action, requestId });
     if (action === "tool_result" && parsed.id) {
       const id = parsed.id;
       const result = parsed.result ?? "";
@@ -10049,7 +10223,7 @@ var HeadlessSession = class {
         this.pendingTools.delete(id);
         pending2.resolve(result);
       } else if (!this.running) {
-        log16.info("Late tool_result while idle, dismissing", { id });
+        log17.info("Late tool_result while idle, dismissing", { id });
         this.emit("completed", { success: true }, requestId);
       } else {
         this.earlyResults.set(id, result);
@@ -10062,7 +10236,7 @@ var HeadlessSession = class {
         ...typeof parsed.before === "number" ? { before: parsed.before } : {},
         ...typeof parsed.limit === "number" ? { limit: parsed.limit } : {}
       });
-      log16.info("History response", {
+      log17.info("History response", {
         requestId,
         startIndex: page.startIndex,
         endIndex: page.endIndex,