@mindstudio-ai/remy 0.1.278 → 0.1.280

package/dist/index.js

@@ -994,25 +994,18 @@ var init_updatePlanStatus = __esm({
   }
 });
 
-// src/tools/common/setProjectOnboardingState.ts
-var setProjectOnboardingStateTool;
-var init_setProjectOnboardingState = __esm({
-  "src/tools/common/setProjectOnboardingState.ts"() {
+// src/tools/common/markBuildComplete.ts
+var markBuildCompleteTool;
+var init_markBuildComplete = __esm({
+  "src/tools/common/markBuildComplete.ts"() {
     "use strict";
-    setProjectOnboardingStateTool = {
+    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() {
@@ -4146,6 +4139,41 @@ var init_runMethod = __esm({
   }
 });
 
+// src/tools/code/testJewel.ts
+var testJewelTool;
+var init_testJewel = __esm({
+  "src/tools/code/testJewel.ts"() {
+    "use strict";
+    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;
 var init_queryDatabase = __esm({
@@ -6704,6 +6732,155 @@ var init_loadSkill2 = __esm({
   }
 });
 
+// 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";
+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) {
+    log10.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");
+}
+var log10, WIREFRAMES_DIR, UPLOAD_TIMEOUT_MS2, definition10;
+var init_createWireframe = __esm({
+  "src/subagents/designExpert/tools/createWireframe.ts"() {
+    "use strict";
+    init_projectRoot();
+    init_logger();
+    log10 = createLogger("createWireframe");
+    WIREFRAMES_DIR = "src/.wireframes";
+    UPLOAD_TIMEOUT_MS2 = 3e4;
+    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"]
+      }
+    };
+  }
+});
+
 // src/subagents/designExpert/tools/index.ts
 async function executeDesignExpertTool(name, input, context, toolCallId, onLog) {
   const tool = tools[name];
@@ -6728,6 +6905,7 @@ var init_tools4 = __esm({
     init_renderImage();
     init_polishCopy();
     init_loadSkill2();
+    init_createWireframe();
     init_screenshot2();
     tools = {
       searchGoogle: searchGoogle_exports,
@@ -6742,7 +6920,9 @@ var init_tools4 = __esm({
       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
     };
     DESIGN_EXPERT_TOOLS = [
       ...COMMON_READ_TOOLS,
@@ -6757,7 +6937,7 @@ async function initOrgContext(config) {
     cached = await fetchRemyContext(config);
     const orgDefaultModels2 = filterModelPicks(cached?.defaultModels);
     setOrgDefaultModels(orgDefaultModels2);
-    log10.debug("org context loaded", {
+    log11.debug("org context loaded", {
       delegatedAvailable: cached?.auth?.delegatedAvailable ?? false,
       requireDelegatedOnly: cached?.auth?.requireDelegatedOnly ?? false,
       hasOrgName: !!cached?.org?.name,
@@ -6766,7 +6946,7 @@ async function initOrgContext(config) {
   } catch (err) {
     cached = null;
     setOrgDefaultModels({});
-    log10.debug("org context init failed", { error: err.message });
+    log11.debug("org context init failed", { error: err.message });
   }
 }
 function getOrgContext() {
@@ -6802,14 +6982,14 @@ function renderOrgContextBlock() {
   lines.push("</org_context>");
   return lines.join("\n");
 }
-var log10, cached;
+var log11, cached;
 var init_orgContext = __esm({
   "src/orgContext.ts"() {
     "use strict";
     init_api();
     init_surfaces();
     init_logger();
-    log10 = createLogger("orgContext");
+    log11 = createLogger("orgContext");
     cached = null;
   }
 });
@@ -7966,7 +8146,7 @@ var init_tools8 = __esm({
     init_presentPublishPlan();
     init_writePlan();
     init_updatePlanStatus();
-    init_setProjectOnboardingState();
+    init_markBuildComplete();
     init_promptUser();
     init_confirmDestructiveAction();
     init_sdkConsultant();
@@ -7986,6 +8166,7 @@ var init_tools8 = __esm({
     init_restartProcess();
     init_runScenario();
     init_runMethod();
+    init_testJewel();
     init_queryDatabase();
     init_screenshot2();
     init_browserAutomation();
@@ -7998,7 +8179,7 @@ var init_tools8 = __esm({
     init_writeBuildOverview();
     ALL_TOOLS = [
       // Common
-      setProjectOnboardingStateTool,
+      markBuildCompleteTool,
       promptUserTool,
       confirmDestructiveActionTool,
       askMindStudioSdkTool,
@@ -8041,7 +8222,8 @@ var init_tools8 = __esm({
       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
     ];
     SUBAGENT_TOOL_NAMES = /* @__PURE__ */ new Set([
       "visualDesignExpert",
@@ -8336,17 +8518,17 @@ async function runExtraction(apiConfig, model) {
   const inputHash = computeInputHash();
   const cached3 = readCache();
   if (cached3 && cached3.inputHash === inputHash) {
-    log11.debug("Brand inputs unchanged \u2014 skipping extraction", { inputHash });
+    log12.debug("Brand inputs unchanged \u2014 skipping extraction", { inputHash });
     return null;
   }
-  log11.info("Extracting brand", { inputHash });
+  log12.info("Extracting brand", { inputHash });
   const brand = await extractBrand(apiConfig, model);
   if (!brand) {
-    log11.warn("Brand extraction failed \u2014 leaving cache untouched");
+    log12.warn("Brand extraction failed \u2014 leaving cache untouched");
     return null;
   }
   persistBrand(brand, inputHash);
-  log11.info("Brand persisted", { inputHash });
+  log12.info("Brand persisted", { inputHash });
   return brand;
 }
 function isDedicatedBrandFile(filePath) {
@@ -8432,7 +8614,7 @@ function parseFrontmatter3(filePath) {
 async function extractBrand(apiConfig, model) {
   const corpus = buildCorpus();
   if (!corpus.trim()) {
-    log11.debug("No spec corpus \u2014 emitting empty brand");
+    log12.debug("No spec corpus \u2014 emitting empty brand");
     return { version: 1 };
   }
   let responseText = "";
@@ -8466,17 +8648,17 @@ async function extractBrand(apiConfig, model) {
           toolNames: []
         });
       } else if (event.type === "error") {
-        log11.error("Brand extraction stream error", { error: event.error });
+        log12.error("Brand extraction stream error", { error: event.error });
         return null;
       }
     }
   } catch (err) {
-    log11.error("Brand extraction threw", { error: err?.message });
+    log12.error("Brand extraction threw", { error: err?.message });
     return null;
   }
   const parsed = parseJsonResponse(responseText);
   if (!parsed) {
-    log11.warn("Brand extraction returned unparseable JSON", {
+    log12.warn("Brand extraction returned unparseable JSON", {
       preview: responseText.slice(0, 200)
     });
     return null;
@@ -8643,7 +8825,7 @@ function readCache() {
     return null;
   }
 }
-var log11, EXTRACT_PROMPT, BRAND_FILE, CACHE_FILE, HEAD_SLICE_CHARS, BRAND_CORPUS_CHAR_LIMIT;
+var log12, EXTRACT_PROMPT, BRAND_FILE, CACHE_FILE, HEAD_SLICE_CHARS, BRAND_CORPUS_CHAR_LIMIT;
 var init_brandExtraction = __esm({
   "src/brandExtraction/index.ts"() {
     "use strict";
@@ -8652,7 +8834,7 @@ var init_brandExtraction = __esm({
     init_atomicWrite();
     init_logger();
     init_usageLedger();
-    log11 = createLogger("brandExtraction");
+    log12 = createLogger("brandExtraction");
     EXTRACT_PROMPT = readAsset("brandExtraction", "extract.md");
     BRAND_FILE = ".remy-brand.json";
     CACHE_FILE = ".remy-brand.cache.json";
@@ -8669,7 +8851,7 @@ function triggerBrandExtraction(apiConfig, model) {
   }
   inflight = true;
   void runExtraction(apiConfig, model).catch((err) => {
-    log12.error("Brand extraction failed", { error: err?.message });
+    log13.error("Brand extraction failed", { error: err?.message });
   }).finally(() => {
     inflight = false;
     if (dirty) {
@@ -8678,13 +8860,13 @@ function triggerBrandExtraction(apiConfig, model) {
     }
   });
 }
-var log12, inflight, dirty;
+var log13, inflight, dirty;
 var init_trigger2 = __esm({
   "src/brandExtraction/trigger.ts"() {
     "use strict";
     init_brandExtraction();
     init_logger();
-    log12 = createLogger("brandExtraction:trigger");
+    log13 = createLogger("brandExtraction:trigger");
     inflight = false;
     dirty = false;
   }
@@ -8733,7 +8915,7 @@ async function runTurn(params) {
     (n, e) => n + (e.attachments?.length ?? 0),
     0
   );
-  log13.info("Turn started", {
+  log14.info("Turn started", {
     requestId,
     model,
     buildModel: buildModelOverride,
@@ -8782,7 +8964,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"
   ]);
@@ -9028,7 +9210,7 @@ async function runTurn(params) {
               const acc = toolInputAccumulators.get(event.id);
               const wasStreamed = acc?.started ?? false;
               const isInputStreaming = !!tool?.streaming?.partialInput;
-              log13.info("Tool received", {
+              log14.info("Tool received", {
                 requestId,
                 toolCallId: event.id,
                 name: event.name
@@ -9147,7 +9329,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++;
-        log13.warn("Abnormal stop \u2014 nudging model to continue", {
+        log14.warn("Abnormal stop \u2014 nudging model to continue", {
           requestId,
           stopReason,
           attempt: abnormalStopRecoveries
@@ -9175,7 +9357,7 @@ async function runTurn(params) {
         });
         return;
       }
-      log13.info("Tools executing", {
+      log14.info("Tools executing", {
         requestId,
         count: toolCalls.length,
         tools: toolCalls.map((tc) => tc.name)
@@ -9222,7 +9404,7 @@ async function runTurn(params) {
               let result;
               if (EXTERNAL_TOOLS.has(tc.name) && resolveExternalTool) {
                 saveSession(state);
-                log13.info("Waiting for external tool result", {
+                log14.info("Waiting for external tool result", {
                   requestId,
                   toolCallId: tc.id,
                   name: tc.name
@@ -9290,7 +9472,7 @@ async function runTurn(params) {
           if (!isBackgroundCall(tc)) {
             toolRegistry?.unregister(tc.id);
           }
-          log13.info("Tool completed", {
+          log14.info("Tool completed", {
             requestId,
             toolCallId: tc.id,
             name: tc.name,
@@ -9364,7 +9546,7 @@ async function runTurn(params) {
     statusWatcher.stop();
   }
 }
-var log13, BRAND_TRIGGERING_TOOLS, EXTERNAL_TOOLS, USER_BLOCKING_EXTERNAL_TOOLS;
+var log14, BRAND_TRIGGERING_TOOLS, EXTERNAL_TOOLS, USER_BLOCKING_EXTERNAL_TOOLS;
 var init_agent = __esm({
   "src/agent.ts"() {
     "use strict";
@@ -9383,7 +9565,7 @@ var init_agent = __esm({
     init_surfaces();
     init_toolRegistry();
     init_historyLimits();
-    log13 = createLogger("agent");
+    log14 = createLogger("agent");
     BRAND_TRIGGERING_TOOLS = /* @__PURE__ */ new Set([
       "writeSpec",
       "editSpec",
@@ -9391,11 +9573,12 @@ var init_agent = __esm({
     ]);
     EXTERNAL_TOOLS = /* @__PURE__ */ new Set([
       "promptUser",
-      "setProjectOnboardingState",
+      "markBuildComplete",
       "presentPublishPlan",
       "confirmDestructiveAction",
       "runScenario",
       "runMethod",
+      "testJewel",
       "queryDatabase",
       "browserCommand",
       "setProjectMetadata"
@@ -9507,6 +9690,10 @@ function buildSystemPrompt(onboardingState) {
   {{compiled/auth.md}}
   </auth>
 
+  <jewels>
+  {{compiled/jewels.md}}
+  </jewels>
+
   <dev_and_deploy>
   {{compiled/dev-and-deploy.md}}
   </dev_and_deploy>
@@ -9561,7 +9748,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>
 
@@ -9602,10 +9789,10 @@ import os from "os";
 function loadConfigFile() {
   try {
     const raw = fs22.readFileSync(CONFIG_PATH, "utf-8");
-    log14.debug("Loaded config file", { path: CONFIG_PATH });
+    log15.debug("Loaded config file", { path: CONFIG_PATH });
     return JSON.parse(raw);
   } catch (err) {
-    log14.debug("No config file found", {
+    log15.debug("No config file found", {
       path: CONFIG_PATH,
       error: err.message
     });
@@ -9620,13 +9807,13 @@ function resolveConfig(flags2) {
   const baseUrl2 = flags2?.baseUrl || process.env.MINDSTUDIO_BASE_URL || env?.apiBaseUrl || DEFAULT_BASE_URL;
   const appId = process.env.MINDSTUDIO_APP_ID || void 0;
   if (!apiKey) {
-    log14.error("No API key found");
+    log15.error("No API key found");
     throw new Error(
       "No API key found. Set MINDSTUDIO_API_KEY or configure ~/.mindstudio-local-tunnel/config.json."
     );
   }
   const keySource = flags2?.apiKey ? "cli flag" : process.env.MINDSTUDIO_API_KEY ? "env var" : "config file";
-  log14.info("Config resolved", {
+  log15.info("Config resolved", {
     baseUrl: baseUrl2,
     keySource,
     environment: activeEnv,
@@ -9634,12 +9821,12 @@ function resolveConfig(flags2) {
   });
   return { apiKey, baseUrl: baseUrl2, appId };
 }
-var log14, CONFIG_PATH, DEFAULT_BASE_URL;
+var log15, CONFIG_PATH, DEFAULT_BASE_URL;
 var init_config = __esm({
   "src/config.ts"() {
     "use strict";
     init_logger();
-    log14 = createLogger("config");
+    log15 = createLogger("config");
     CONFIG_PATH = path12.join(
       os.homedir(),
       ".mindstudio-local-tunnel",
@@ -9651,8 +9838,8 @@ var init_config = __esm({
 
 // 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";
+import { writeFile as writeFile3 } from "fs/promises";
+import { basename as basename2, join as join3, extname as extname2 } from "path";
 function filenameFromUrl(url) {
   try {
     const pathname = new URL(url).pathname;
@@ -9663,7 +9850,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;
   }
@@ -9697,7 +9884,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)
       });
@@ -9705,8 +9892,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
@@ -9719,8 +9906,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 {
         }
@@ -9764,12 +9951,12 @@ function buildUploadHeader(documents, images) {
   return `[Uploaded files]
 ${lines.join("\n")}`;
 }
-var log15, UPLOADS_DIR, IMAGE_EXTENSIONS;
+var log16, UPLOADS_DIR, IMAGE_EXTENSIONS;
 var init_attachments = __esm({
   "src/headless/attachments.ts"() {
     "use strict";
     init_logger();
-    log15 = createLogger("headless:attachments");
+    log16 = createLogger("headless:attachments");
     UPLOADS_DIR = "src/.user-uploads";
     IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".webp"]);
   }
@@ -9961,7 +10148,7 @@ var headless_exports = {};
 __export(headless_exports, {
   HeadlessSession: () => HeadlessSession
 });
-var log16, EXTERNAL_TOOL_TIMEOUT_MS, USER_FACING_TOOLS, FORCED_COMPACTION_THRESHOLD_TOKENS, HeadlessSession;
+var log17, EXTERNAL_TOOL_TIMEOUT_MS, LONG_RUNNING_TOOLS, LONG_RUNNING_TOOL_TIMEOUT_MS, USER_FACING_TOOLS, FORCED_COMPACTION_THRESHOLD_TOKENS, HeadlessSession;
 var init_headless = __esm({
   "src/headless/index.ts"() {
     "use strict";
@@ -9983,8 +10170,10 @@ var init_headless = __esm({
     init_messageQueue();
     init_resolve();
     init_sentinel();
-    log16 = createLogger("headless");
+    log17 = createLogger("headless");
     EXTERNAL_TOOL_TIMEOUT_MS = 3e5;
+    LONG_RUNNING_TOOLS = /* @__PURE__ */ new Set(["runMethod", "testJewel"]);
+    LONG_RUNNING_TOOL_TIMEOUT_MS = 18e5;
     USER_FACING_TOOLS = /* @__PURE__ */ new Set([
       "promptUser",
       "confirmDestructiveAction",
@@ -10206,7 +10395,7 @@ var init_headless = __esm({
         }
         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
           });
@@ -10292,7 +10481,7 @@ var init_headless = __esm({
         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
@@ -10311,7 +10500,7 @@ var init_headless = __esm({
       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,
@@ -10363,13 +10552,14 @@ var init_headless = __esm({
           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);
@@ -10573,7 +10763,7 @@ var init_headless = __esm({
           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;
         }
       }
@@ -10587,7 +10777,7 @@ var init_headless = __esm({
       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)
           });
@@ -10775,7 +10965,7 @@ var init_headless = __esm({
               error: "Turn ended unexpectedly"
             });
           }
-          log16.info("Turn complete", {
+          log17.info("Turn complete", {
             requestId,
             durationMs: Date.now() - this.turnStart
           });
@@ -10787,7 +10977,7 @@ var init_headless = __esm({
               error: err.message
             });
           }
-          log16.warn("Command failed", {
+          log17.warn("Command failed", {
             action: "message",
             requestId,
             error: err.message
@@ -10997,7 +11187,7 @@ var init_headless = __esm({
         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)
@@ -11006,7 +11196,7 @@ var init_headless = __esm({
           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 ?? "";
@@ -11015,7 +11205,7 @@ var init_headless = __esm({
             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);
@@ -11028,7 +11218,7 @@ var init_headless = __esm({
             ...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,