@mindstudio-ai/remy 0.1.274 → 0.1.276

package/dist/index.js

@@ -270,7 +270,7 @@ function isRetryableError(error) {
   /Unable to download/i.test(error);
 }
 function sleep(ms) {
-  return new Promise((resolve3) => setTimeout(resolve3, ms));
+  return new Promise((resolve4) => setTimeout(resolve4, ms));
 }
 async function* streamChatWithRetry(params, options) {
   for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
@@ -1203,7 +1203,7 @@ function formatCliResult(r) {
   return logBlock + body + truncNote;
 }
 function runCli(command, args2, options) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     const timeout = options?.timeout ?? 6e4;
     const maxBuffer = options?.maxBuffer ?? 1024 * 1024;
     let finalArgs = args2;
@@ -1232,7 +1232,7 @@ function runCli(command, args2, options) {
       if (killTimer) {
         clearTimeout(killTimer);
       }
-      resolve3(result);
+      resolve4(result);
     };
     const child = spawn(command, finalArgs, {
       stdio: [options?.stdin ? "pipe" : "ignore", "pipe", "pipe"]
@@ -2173,7 +2173,7 @@ var init_surfaces = __esm({
         userPickable: true
       },
       imageGeneration: {
-        default: "seedream-4.5",
+        default: "gpt-image-2",
         label: "Image Generation",
         description: "Creates images for your product \u2014 icons, illustrations, photos, and any other visual assets.",
         modelType: "image_generation",
@@ -2409,22 +2409,74 @@ var init_cleanMessages = __esm({
   }
 });
 
-// src/toolResultCap.ts
-function capToolResult(result) {
+// src/historyLimits.ts
+function capToolResult(result, maxBytes = MAX_TOOL_RESULT_BYTES) {
   const total = Buffer.byteLength(result, "utf-8");
-  if (total <= MAX_TOOL_RESULT_BYTES) {
+  if (total <= maxBytes) {
     return result;
   }
-  const head = Buffer.from(result, "utf-8").subarray(0, MAX_TOOL_RESULT_BYTES).toString("utf-8");
+  const head = Buffer.from(result, "utf-8").subarray(0, maxBytes).toString("utf-8");
   return head + `
 
-(tool result truncated at ${(MAX_TOOL_RESULT_BYTES / 1024).toFixed(0)}KB of ${(total / 1024).toFixed(0)}KB \u2014 too large to keep in context. Narrow the call (select fewer fields, paginate, or query a subset) instead of fetching everything.)`;
+(tool result truncated at ${(maxBytes / 1024).toFixed(0)}KB of ${(total / 1024).toFixed(0)}KB \u2014 too large to keep in context. Narrow the call (select fewer fields, paginate, or query a subset) instead of fetching everything.)`;
 }
-var MAX_TOOL_RESULT_BYTES;
-var init_toolResultCap = __esm({
-  "src/toolResultCap.ts"() {
+function capSubAgentTranscript(messages) {
+  for (const msg of messages) {
+    capMessageForHistory(msg, MAX_SUBAGENT_RESULT_BYTES);
+  }
+  const sizes = messages.map(
+    (m) => Buffer.byteLength(JSON.stringify(m), "utf-8") + 1
+  );
+  let total = sizes.reduce((a, b) => a + b, 0);
+  if (total <= MAX_SUBAGENT_TRANSCRIPT_BYTES) {
+    return messages;
+  }
+  let start = 0;
+  while (start < messages.length - 1 && total > MAX_SUBAGENT_TRANSCRIPT_BYTES) {
+    total -= sizes[start];
+    start++;
+  }
+  while (start < messages.length - 1 && messages[start].role === "user" && messages[start].toolCallId) {
+    start++;
+  }
+  return messages.slice(start);
+}
+function capMessageForHistory(msg, maxBytes = MAX_TOOL_RESULT_BYTES) {
+  if (msg.role === "assistant" && Array.isArray(msg.content)) {
+    for (const block of msg.content) {
+      if (block.type !== "tool") {
+        continue;
+      }
+      if (typeof block.result === "string") {
+        block.result = capToolResult(block.result, maxBytes);
+      }
+      if (typeof block.backgroundResult === "string") {
+        block.backgroundResult = capToolResult(
+          block.backgroundResult,
+          maxBytes
+        );
+      }
+      if (Array.isArray(block.subAgentMessages)) {
+        block.subAgentMessages = capSubAgentTranscript(block.subAgentMessages);
+      }
+    }
+  } else if (msg.role === "user" && msg.toolCallId && typeof msg.content === "string") {
+    msg.content = capToolResult(msg.content, maxBytes);
+  }
+}
+var MAX_TOOL_RESULT_BYTES, MAX_SUBAGENT_RESULT_BYTES, MAX_SUBAGENT_TRANSCRIPT_BYTES, HISTORY_PAGE_MAX_BYTES, HISTORY_DEFAULT_LIMIT, HISTORY_MAX_LIMIT, ROTATE_THRESHOLD_BYTES, RETAIN_TAIL_BYTES, ARCHIVE_RETENTION_BYTES;
+var init_historyLimits = __esm({
+  "src/historyLimits.ts"() {
     "use strict";
     MAX_TOOL_RESULT_BYTES = 256 * 1024;
+    MAX_SUBAGENT_RESULT_BYTES = 32 * 1024;
+    MAX_SUBAGENT_TRANSCRIPT_BYTES = 512 * 1024;
+    HISTORY_PAGE_MAX_BYTES = 2 * 1024 * 1024;
+    HISTORY_DEFAULT_LIMIT = 500;
+    HISTORY_MAX_LIMIT = 2e3;
+    ROTATE_THRESHOLD_BYTES = 32 * 1024 * 1024;
+    RETAIN_TAIL_BYTES = 16 * 1024 * 1024;
+    ARCHIVE_RETENTION_BYTES = 64 * 1024 * 1024;
   }
 });
 
@@ -2457,22 +2509,11 @@ function loadSession(state) {
   }
   return false;
 }
-function capOversizedResults(msg) {
-  if (msg.role === "assistant" && Array.isArray(msg.content)) {
-    for (const block of msg.content) {
-      if (block.type === "tool" && typeof block.result === "string") {
-        block.result = capToolResult(block.result);
-      }
-    }
-  } else if (msg.role === "user" && msg.toolCallId && typeof msg.content === "string") {
-    msg.content = capToolResult(msg.content);
-  }
-}
 function sanitizeMessages(messages) {
   const result = [];
   for (let i = 0; i < messages.length; i++) {
     const msg = messages[i];
-    capOversizedResults(msg);
+    capMessageForHistory(msg);
     result.push(msg);
     if (msg.role !== "assistant" || !Array.isArray(msg.content)) {
       continue;
@@ -2584,6 +2625,9 @@ function parseArchive(name) {
     const raw = fs10.readFileSync(path4.join(ARCHIVE_DIR, name), "utf-8");
     const data = JSON.parse(raw);
     const messages = Array.isArray(data?.messages) ? data.messages : [];
+    for (const msg of messages) {
+      capMessageForHistory(msg);
+    }
     archiveCountCache.set(name, messages.length);
     archiveMsgCache.set(name, messages);
     while (archiveMsgCache.size > ARCHIVE_MSG_CACHE_MAX) {
@@ -2694,6 +2738,29 @@ function getHistoryPage(state, opts) {
       messages.push(state.messages[i]);
     }
   }
+  if (messages.length > 1) {
+    let bytes = 0;
+    let cut = 0;
+    for (let i = messages.length - 1; i >= 0; i--) {
+      bytes += Buffer.byteLength(JSON.stringify(messages[i]), "utf-8") + 1;
+      if (bytes > HISTORY_PAGE_MAX_BYTES && i < messages.length - 1) {
+        cut = i + 1;
+        break;
+      }
+    }
+    if (cut > 0) {
+      while (cut < messages.length - 1 && messages[cut]?.role === "user" && messages[cut]?.toolCallId) {
+        cut++;
+      }
+      messages.splice(0, cut);
+      startIndex += cut;
+      log3.info("History page trimmed to byte budget", {
+        dropped: cut,
+        kept: messages.length,
+        startIndex
+      });
+    }
+  }
   return { messages, startIndex, endIndex, totalMessageCount: total };
 }
 function rotate(state) {
@@ -2755,7 +2822,7 @@ function clearSession(state) {
     });
   }
 }
-var log3, SESSION_FILE, ARCHIVE_DIR, ROTATE_THRESHOLD_BYTES, RETAIN_TAIL_BYTES, ARCHIVE_RETENTION_BYTES, ARCHIVE_NAME_RE, archiveSortKey, ARCHIVE_COUNT_RE, HISTORY_DEFAULT_LIMIT, HISTORY_MAX_LIMIT, archiveCountCache, archiveMsgCache, ARCHIVE_MSG_CACHE_MAX;
+var log3, SESSION_FILE, ARCHIVE_DIR, ARCHIVE_NAME_RE, archiveSortKey, ARCHIVE_COUNT_RE, archiveCountCache, archiveMsgCache, ARCHIVE_MSG_CACHE_MAX;
 var init_session = __esm({
   "src/session.ts"() {
     "use strict";
@@ -2763,18 +2830,13 @@ var init_session = __esm({
     init_logger();
     init_compaction();
     init_cleanMessages();
-    init_toolResultCap();
+    init_historyLimits();
     log3 = createLogger("session");
     SESSION_FILE = ".remy-session.json";
     ARCHIVE_DIR = ".logs/sessions";
-    ROTATE_THRESHOLD_BYTES = 32 * 1024 * 1024;
-    RETAIN_TAIL_BYTES = 16 * 1024 * 1024;
-    ARCHIVE_RETENTION_BYTES = 64 * 1024 * 1024;
     ARCHIVE_NAME_RE = /^(cleared|rotated)-.*\.json$/;
     archiveSortKey = (name) => name.replace(/^(cleared|rotated)-/, "");
     ARCHIVE_COUNT_RE = /\.c(\d+)\.json$/;
-    HISTORY_DEFAULT_LIMIT = 500;
-    HISTORY_MAX_LIMIT = 2e3;
     archiveCountCache = /* @__PURE__ */ new Map();
     archiveMsgCache = /* @__PURE__ */ new Map();
     ARCHIVE_MSG_CACHE_MAX = 3;
@@ -2963,9 +3025,9 @@ function parseFrontmatter(content) {
   }
   const fields = {};
   for (const line of match[1].split("\n")) {
-    const sep = line.indexOf(":");
-    if (sep > 0) {
-      fields[line.slice(0, sep).trim()] = line.slice(sep + 1).trim();
+    const sep2 = line.indexOf(":");
+    if (sep2 > 0) {
+      fields[line.slice(0, sep2).trim()] = line.slice(sep2 + 1).trim();
     }
   }
   return fields;
@@ -3420,7 +3482,7 @@ var init_bash = __esm({
       async execute(input, context) {
         const maxLines = input.maxLines === 0 ? Infinity : input.maxLines || DEFAULT_MAX_LINES2;
         const timeoutMs = input.timeout ? input.timeout * 1e3 : DEFAULT_TIMEOUT_MS;
-        return new Promise((resolve3) => {
+        return new Promise((resolve4) => {
           const child = spawn2("sh", ["-c", input.command], {
             // Pinned rather than inherited. `undefined` here means "wherever the
             // process happens to be", which is the project root only by luck.
@@ -3445,9 +3507,9 @@ var init_bash = __esm({
             clearTimeout(timer);
             if (!output) {
               if (code && code !== 0) {
-                resolve3(`Error: process exited with code ${code}`);
+                resolve4(`Error: process exited with code ${code}`);
               } else {
-                resolve3("(no output)");
+                resolve4("(no output)");
               }
               return;
             }
@@ -3473,18 +3535,18 @@ var init_bash = __esm({
                   `${(MAX_OUTPUT_BYTES / 1024).toFixed(0)}KB of ${(totalBytes / 1024).toFixed(0)}KB`
                 );
               }
-              resolve3(
+              resolve4(
                 truncated + `
 
 (truncated at ${reasons.join(" / ")} \u2014 narrow the command (grep, head/tail, smaller paths) instead of increasing limits)`
               );
             } else {
-              resolve3(output);
+              resolve4(output);
             }
           });
           child.on("error", (err) => {
             clearTimeout(timer);
-            resolve3(`Error: ${err.message}`);
+            resolve4(`Error: ${err.message}`);
           });
         });
       }
@@ -3607,17 +3669,17 @@ var init_grep = __esm({
         }
         const rgCmd = `rg ${rgFlags}${globFlag} '${escaped}' ${searchPath}`;
         const grepCmd = `grep ${grepFlags} '${escaped}' ${searchPath} --include='*.ts' --include='*.tsx' --include='*.js' --include='*.json' --include='*.md'`;
-        return new Promise((resolve3) => {
+        return new Promise((resolve4) => {
           exec(rgCmd, { maxBuffer: 512 * 1024 }, (err, stdout) => {
             if (stdout?.trim()) {
-              resolve3(formatResults(stdout, max, mode));
+              resolve4(formatResults(stdout, max, mode));
               return;
             }
             exec(grepCmd, { maxBuffer: 512 * 1024 }, (_err, grepStdout) => {
               if (grepStdout?.trim()) {
-                resolve3(formatResults(grepStdout, max, mode));
+                resolve4(formatResults(grepStdout, max, mode));
               } else {
-                resolve3("No matches found.");
+                resolve4("No matches found.");
               }
             });
           });
@@ -3979,7 +4041,7 @@ var init_restartProcess = __esm({
       async execute(input) {
         const data = await lspRequest("/restart-process", { name: input.name });
         if (data.ok) {
-          await new Promise((resolve3) => setTimeout(resolve3, 5e3));
+          await new Promise((resolve4) => setTimeout(resolve4, 5e3));
           return `Restarted ${input.name}.`;
         }
         return `Error: unexpected response: ${JSON.stringify(data)}`;
@@ -4237,6 +4299,26 @@ ${opts.styleMap}
 ${ANALYSIS_RESPONSE_FORMAT}`;
   return p;
 }
+async function renderHtmlViaSidecar(opts) {
+  const result = await sidecarRequest(
+    "/render-html",
+    {
+      html: opts.html,
+      width: opts.width,
+      height: opts.height,
+      ...opts.transparent ? { transparent: true } : {},
+      ...opts.scale != null ? { scale: opts.scale } : {}
+    },
+    { timeout: VIEWPORT_CAPTURE_TIMEOUT_MS }
+  );
+  const url = result?.url;
+  if (!url) {
+    throw new Error(
+      `No URL in sidecar render response. The browser may not be ready yet. Response: ${JSON.stringify(result)}`
+    );
+  }
+  return { url, width: result.width, height: result.height };
+}
 async function streamScreenshotAnalysis(opts) {
   const { image, prompt, styleMap, onLog, model, apiConfig } = opts;
   const url = await resolveImageRef(image, apiConfig);
@@ -4920,7 +5002,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
             block.completedAt = Date.now();
             const innerMsgs = subAgentMessages.get(r.id);
             if (innerMsgs) {
-              block.subAgentMessages = innerMsgs;
+              block.subAgentMessages = capSubAgentTranscript(innerMsgs);
             }
             if (captureArtifacts?.includes(block.name) && !r.isError) {
               try {
@@ -5008,7 +5090,7 @@ var init_runner = __esm({
     init_logger();
     init_usageLedger();
     init_toolRegistry();
-    init_toolResultCap();
+    init_historyLimits();
     init_statusWatcher();
     init_cleanMessages();
     log8 = createLogger("sub-agent");
@@ -5218,10 +5300,10 @@ function parseFrontmatter2(filePath) {
     }
     const fm = {};
     for (const line of match[1].split("\n")) {
-      const sep = line.indexOf(":");
-      if (sep > 0) {
-        const key = line.slice(0, sep).trim();
-        const val = line.slice(sep + 1).trim();
+      const sep2 = line.indexOf(":");
+      if (sep2 > 0) {
+        const key = line.slice(0, sep2).trim();
+        const val = line.slice(sep2 + 1).trim();
         fm[key] = val;
       }
     }
@@ -5615,7 +5697,7 @@ var init_screenshot2 = __esm({
     init_surfaces();
     screenshotDefinition = {
       name: "screenshot",
-      description: "Capture a screenshot of the app preview and get a description of what's on screen. Choose `fullPage`: `false` captures just the visible viewport (fast \u2014 for a specific section the page is scrolled to), `true` captures the entire page top-to-bottom (slower \u2014 for overall composition or content past the fold). Captures the settled page state \u2014 it cannot catch animations, transitions, or transient state. The analysis is not precise about every detail \u2014 for example it cannot reliably identify specific fonts by name, only describe what the letterforms look like. Optionally provide specific questions about what you're looking for. Use a bulleted list to ask many questions at once. To ask additional questions about a screenshot you have already captured, pass its URL as `imageUrl` to skip recapture; `imageUrl` also accepts the disk path of an image file (a user upload, a saved asset) to analyze that instead of the preview. If the screenshot requires interaction first (logging in, clicking a tab, dismissing a modal, scrolling to a section), use the instructions param to describe the steps. To render a fixed-size image such as an Open Graph share card, set `width` and `height` (e.g. 1200 \xD7 630) and `format: 'png'`: the tool navigates to `path`, clips to exactly those pixel dimensions, and returns the image URL.",
+      description: "Capture a screenshot of the app preview and get a description of what's on screen. Choose `fullPage`: `false` captures just the visible viewport (fast \u2014 for a specific section the page is scrolled to), `true` captures the entire page top-to-bottom (slower \u2014 for overall composition or content past the fold). Captures the settled page state \u2014 it cannot catch animations, transitions, or transient state. The analysis is not precise about every detail \u2014 for example it cannot reliably identify specific fonts by name, only describe what the letterforms look like. Optionally provide specific questions about what you're looking for. Use a bulleted list to ask many questions at once. To ask additional questions about a screenshot you have already captured, pass its URL as `imageUrl` to skip recapture; `imageUrl` also accepts the disk path of an image file (a user upload, a saved asset) to analyze that instead of the preview. If the screenshot requires interaction first (logging in, clicking a tab, dismissing a modal, scrolling to a section), use the instructions param to describe the steps. To capture at exact pixel dimensions, set `width` and `height`: the tool clips to exactly that viewport and returns the image URL.",
       inputSchema: {
         type: "object",
         properties: {
@@ -5646,7 +5728,7 @@ var init_screenshot2 = __esm({
           format: {
             type: "string",
             enum: ["png", "jpeg"],
-            description: "Output image format. Defaults to 'jpeg'. Use 'png' for crisp flat graphics like share cards, where JPEG artifacts show on sharp type and edges."
+            description: "Output image format. Defaults to 'jpeg'. Use 'png' for crisp flat graphics where JPEG artifacts show on sharp type and edges."
           },
           instructions: {
             type: "string",
@@ -5954,6 +6036,20 @@ var init_enhancePrompt = __esm({
 });
 
 // src/subagents/designExpert/tools/images/imageGenerator.ts
+function snapToOpenAiImageSize(width, height) {
+  let best = OPENAI_IMAGE_SIZES[0];
+  let bestScore = Infinity;
+  for (const [w, h] of OPENAI_IMAGE_SIZES) {
+    const aspectDiff = Math.abs(Math.log(w / h / (width / height)));
+    const areaDiff = Math.abs(Math.log(w * h / (width * height)));
+    const score = aspectDiff * 8 + areaDiff;
+    if (score < bestScore) {
+      bestScore = score;
+      best = [w, h];
+    }
+  }
+  return `${best[0]}x${best[1]}`;
+}
 async function generateImageAssets(opts) {
   const {
     prompts,
@@ -5968,7 +6064,11 @@ async function generateImageAssets(opts) {
   const sourceImages = opts.sourceImages?.length ? await resolveImageRefs(opts.sourceImages, apiConfig) : void 0;
   const width = opts.width || 2048;
   const height = opts.height || 2048;
-  const config = { width, height };
+  const config = {
+    width,
+    height,
+    size: snapToOpenAiImageSize(width, height)
+  };
   if (sourceImages?.length) {
     const [firstImage] = sourceImages;
     config.images = sourceImages;
@@ -6087,7 +6187,7 @@ async function generateImageAssets(opts) {
   );
   return JSON.stringify({ images });
 }
-var ANALYZE_PROMPT;
+var ANALYZE_PROMPT, OPENAI_IMAGE_SIZES;
 var init_imageGenerator = __esm({
   "src/subagents/designExpert/tools/images/imageGenerator.ts"() {
     "use strict";
@@ -6095,7 +6195,22 @@ var init_imageGenerator = __esm({
     init_analyzeImage();
     init_uploadImage();
     init_enhancePrompt();
-    ANALYZE_PROMPT = 'You are reviewing this image for a visual designer sourcing assets for a project. Describe: what the image depicts, the mood and color palette, how the lighting and composition work, any text present in the image, whether there are any issues (artifacts, distortions), and how it could be used in a layout for an app or website. Be concise and practical. Respond only with your analysis as Markdown (starting with the title "Asset Review") and absolutely no other text. Do not use emojis - use unicode if you need symbols.';
+    ANALYZE_PROMPT = 'You are reviewing this image for a visual designer sourcing assets for a project. Describe: what the image depicts, the mood and color palette, how the lighting and composition work, any text present in the image, whether there are any issues (artifacts, distortions), whether the artwork extends fully to all four edges of the canvas or sits inset (call out any baked-in border, frame, rounded-corner mask, drop-shadow margin, or mockup presentation such as an icon rendered on a background or device), and how it could be used in a layout for an app or website. Be concise and practical. Respond only with your analysis as Markdown (starting with the title "Asset Review") and absolutely no other text. Do not use emojis - use unicode if you need symbols.';
+    OPENAI_IMAGE_SIZES = [
+      [768, 1024],
+      [1024, 768],
+      [1024, 1024],
+      [1024, 1536],
+      [1536, 1024],
+      [1280, 2560],
+      [2560, 1280],
+      [1440, 2560],
+      [2560, 1440],
+      [1792, 2400],
+      [2400, 1792],
+      [2400, 2880],
+      [2560, 2560]
+    ];
   }
 });
 
@@ -6252,6 +6367,150 @@ var init_editImages = __esm({
   }
 });
 
+// src/subagents/designExpert/tools/images/renderImage.ts
+var renderImage_exports = {};
+__export(renderImage_exports, {
+  definition: () => definition7,
+  execute: () => execute7
+});
+import { mkdir, unlink, writeFile } from "fs/promises";
+import { tmpdir } from "os";
+import { dirname, join, resolve as resolve2, sep } from "path";
+import { randomUUID } from "crypto";
+async function execute7(input, onLog, context) {
+  const html = typeof input.html === "string" ? input.html : "";
+  const width = Math.round(Number(input.width));
+  const height = Math.round(Number(input.height));
+  if (!html || !Number.isFinite(width) || !Number.isFinite(height) || width < MIN_DIMENSION || width > MAX_DIMENSION || height < MIN_DIMENSION || height > MAX_DIMENSION) {
+    return `Error: renderImage requires an html string plus width/height between ${MIN_DIMENSION} and ${MAX_DIMENSION}.`;
+  }
+  const release = await acquireBrowserLock();
+  let rendered;
+  try {
+    onLog?.("Rendering document in the sandbox browser...");
+    rendered = await renderHtmlViaSidecar({
+      html,
+      width,
+      height,
+      transparent: input.transparentBackground === true,
+      scale: typeof input.scale === "number" ? input.scale : void 0
+    });
+  } catch (err) {
+    return `Error: render failed: ${err?.message ?? err}`;
+  } finally {
+    release();
+  }
+  let bytes;
+  try {
+    const res = await fetch(rendered.url);
+    if (!res.ok) {
+      throw new Error(`fetch returned ${res.status}`);
+    }
+    bytes = Buffer.from(await res.arrayBuffer());
+  } catch (err) {
+    return `Error: rendered but could not download the capture (${err?.message ?? err}). Temporary URL: ${rendered.url}`;
+  }
+  let savedPath;
+  if (typeof input.savePath === "string" && input.savePath) {
+    const absolute = resolve2(PROJECT_ROOT, input.savePath);
+    if (!absolute.startsWith(PROJECT_ROOT + sep)) {
+      return "Error: savePath must resolve inside the project.";
+    }
+    await mkdir(dirname(absolute), { recursive: true });
+    await writeFile(absolute, bytes);
+    savedPath = input.savePath;
+  }
+  onLog?.("Hosting the capture...");
+  const tmpPath = join(tmpdir(), `render-${randomUUID()}.png`);
+  let url = rendered.url;
+  let temporary = true;
+  try {
+    await writeFile(tmpPath, bytes);
+    const upload = await runMindstudioCliResult(["upload", tmpPath], {
+      timeout: 6e4,
+      onLog,
+      caller: "designExpert"
+    });
+    const match = upload.ok ? upload.value.match(/https:\/\/\S+/g) : null;
+    if (match?.length) {
+      url = match[match.length - 1];
+      temporary = false;
+    }
+  } finally {
+    await unlink(tmpPath).catch(() => {
+    });
+  }
+  const analysis = await analyzeImage({
+    prompt: RENDER_ANALYZE_PROMPT,
+    image: url,
+    onLog,
+    model: resolveModel("imageAnalysis", context?.models, context?.model)
+  }).then((r) => r.analysis).catch((err) => `Could not review this image: ${err.message}`);
+  return JSON.stringify({
+    images: [
+      {
+        url,
+        ...temporary ? {
+          note: "Durable hosting failed \u2014 this URL is dev-session scratch storage and may expire. Do not use it for app metadata; retry if a durable URL is needed."
+        } : {},
+        ...savedPath ? { savedPath } : {},
+        analysis,
+        width: rendered.width,
+        height: rendered.height
+      }
+    ]
+  });
+}
+var MIN_DIMENSION, MAX_DIMENSION, RENDER_ANALYZE_PROMPT, definition7;
+var init_renderImage = __esm({
+  "src/subagents/designExpert/tools/images/renderImage.ts"() {
+    "use strict";
+    init_screenshot();
+    init_browserLock();
+    init_runMindstudioCli();
+    init_analyzeImage();
+    init_surfaces();
+    init_projectRoot();
+    MIN_DIMENSION = 16;
+    MAX_DIMENSION = 4096;
+    RENDER_ANALYZE_PROMPT = 'You are reviewing a browser-rendered graphic (composed from HTML/CSS by a designer) for fidelity. Report: whether the composition fills the full canvas or leaves unintended gaps at any edge, any clipped or overflowing text, whether custom webfonts appear to have loaded (distinctive letterforms vs generic fallback serif/sans), any misalignment or uneven spacing, any unintended scrollbars or default-styling artifacts, and \u2014 if the background is transparent \u2014 any fringing or stray opaque pixels at the edges. Then briefly describe the overall composition and how polished it looks. Be concise and practical. Respond only with your analysis as Markdown (starting with the title "Render Review") and absolutely no other text. Do not use emojis - use unicode if you need symbols.';
+    definition7 = {
+      name: "renderImage",
+      description: "Render a self-contained HTML document in a real browser and capture it as a hosted PNG at exact pixel dimensions, with a fidelity review included. Deterministic \u2014 exact hex colors, real loaded webfonts, precise geometry \u2014 unlike generateImages, which is an image model. Use for token-exact graphics: Open Graph share cards, wordmarks, flat/geometric icon tiles, badges, any composition where letterforms and spacing carry the design. Compose with HTML/CSS (link webfonts from CDNs \u2014 the renderer waits for them to load); inline existing SVG markup when needed, but never hand-write new SVG path data.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          html: {
+            type: "string",
+            description: "A complete, self-contained HTML document sized to fill the viewport (style html/body to the full dimensions with margin 0). External webfonts and images from CDNs are fine \u2014 loading is awaited before capture."
+          },
+          width: {
+            type: "number",
+            description: "Viewport width in CSS pixels (e.g. 1200 for an OG card, 512 for an icon tile). Range: 16-4096."
+          },
+          height: {
+            type: "number",
+            description: "Viewport height in CSS pixels. Range: 16-4096."
+          },
+          scale: {
+            type: "number",
+            description: "Device scale factor, 1-3. Output pixels = css \xD7 scale. Use 2 for crisp icon masters (e.g. a 512\xD7512 document captured at 1024\xD71024)."
+          },
+          transparentBackground: {
+            type: "boolean",
+            description: "Capture with true alpha: leave the document background transparent (no background on html/body) and the PNG keeps it. No background-removal model involved."
+          },
+          savePath: {
+            type: "string",
+            description: "Optional project-relative path to also save the PNG into the app (e.g. 'dist/interfaces/web/public/og-image.png' so the deployed site self-hosts it)."
+          }
+        },
+        required: ["html", "width", "height"]
+      }
+    };
+  }
+});
+
 // src/subagents/copyEditor/tools.ts
 var COPY_EDITOR_TOOLS;
 var init_tools3 = __esm({
@@ -6326,18 +6585,18 @@ var init_copyEditor = __esm({
 // src/subagents/designExpert/tools/polishCopy.ts
 var polishCopy_exports = {};
 __export(polishCopy_exports, {
-  definition: () => definition7,
-  execute: () => execute7
+  definition: () => definition8,
+  execute: () => execute8
 });
-async function execute7(input, _onLog, context) {
+async function execute8(input, _onLog, context) {
   return copyEditorTool.execute(input, context);
 }
-var definition7;
+var definition8;
 var init_polishCopy = __esm({
   "src/subagents/designExpert/tools/polishCopy.ts"() {
     "use strict";
     init_copyEditor();
-    definition7 = {
+    definition8 = {
       name: "polishCopy",
       description: "Hand off any user-facing copy you've written \u2014 headlines, captions, labels, body text \u2014 and get back a sharper version: better built for its audience and free of the fingerprints that make writing read as AI. It elevates how the copy communicates without inventing facts or claims you didn't give it. Give it the text plus what it's for (where it appears, the audience).",
       inputSchema: {
@@ -6375,6 +6634,7 @@ var init_tools4 = __esm({
     init_analyzeImage2();
     init_generateImages();
     init_editImages();
+    init_renderImage();
     init_polishCopy();
     init_screenshot2();
     tools = {
@@ -6388,6 +6648,7 @@ var init_tools4 = __esm({
       screenshot: { definition: screenshotDefinition, execute: executeScreenshot },
       generateImages: generateImages_exports,
       editImages: editImages_exports,
+      renderImage: renderImage_exports,
       polishCopy: polishCopy_exports
     };
     DESIGN_EXPERT_TOOLS = [
@@ -6930,13 +7191,13 @@ var init_tools5 = __esm({
 // src/subagents/productVision/executor.ts
 import fs18 from "fs";
 import path10 from "path";
-function resolve2(filePath) {
+function resolve3(filePath) {
   return path10.join(ROADMAP_DIR, filePath);
 }
 async function executeVisionTool(name, input, context) {
   switch (name) {
     case "writeFile": {
-      const filePath = resolve2(input.path);
+      const filePath = resolve3(input.path);
       try {
         fs18.mkdirSync(ROADMAP_DIR, { recursive: true });
         let oldContent = null;
@@ -6954,7 +7215,7 @@ ${unifiedDiff(filePath, oldContent ?? "", input.content)}`;
       }
     }
     case "deleteFile": {
-      const filePath = resolve2(input.path);
+      const filePath = resolve3(input.path);
       try {
         if (!fs18.existsSync(filePath)) {
           return `Error: ${filePath} does not exist`;
@@ -6971,7 +7232,7 @@ ${unifiedDiff(filePath, oldContent, "")}`;
       if (!context) {
         return "Error: writePitchDeck requires execution context for design expert delegation";
       }
-      const filePath = resolve2("pitch.html");
+      const filePath = resolve3("pitch.html");
       try {
         fs18.mkdirSync(ROADMAP_DIR, { recursive: true });
         const exists = fs18.existsSync(filePath);
@@ -8142,14 +8403,14 @@ function buildCorpus() {
       });
     }
   }
-  const sep = "\n\n---\n\n";
+  const sep2 = "\n\n---\n\n";
   const sections = [];
   let usedChars = 0;
   for (const { path: p, content } of files) {
     const section = `## File: ${p}
 
 ${content}`;
-    const added = section.length + (sections.length > 0 ? sep.length : 0);
+    const added = section.length + (sections.length > 0 ? sep2.length : 0);
     if (sections.length > 0 && usedChars + added > BRAND_CORPUS_CHAR_LIMIT) {
       sections.push(
         `(brand corpus truncated: included ${sections.length} of ${files.length} files, ~${(usedChars / 1024).toFixed(0)}KB; brand-relevant files were prioritized.)`
@@ -8159,7 +8420,7 @@ ${content}`;
     sections.push(section);
     usedChars += added;
   }
-  return sections.join(sep);
+  return sections.join(sep2);
 }
 function headSlice(content) {
   if (content.length <= HEAD_SLICE_CHARS) {
@@ -8439,6 +8700,8 @@ async function runTurn(params) {
   let lastCallInputTokens = 0;
   let lastCallCacheCreation = 0;
   let lastCallCacheRead = 0;
+  let abnormalStopRecoveries = 0;
+  const MAX_ABNORMAL_STOP_RECOVERIES = 2;
   const statusWatcher = isFirstMessage ? { stop() {
   }, pause() {
   }, resume() {
@@ -8782,6 +9045,18 @@ 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", {
+          requestId,
+          stopReason,
+          attempt: abnormalStopRecoveries
+        });
+        const nudge = "Your previous response was cut off \u2014 it degenerated into repeated text or hit the output limit, and the repeated portion was removed. Reassess where you are in the task and continue from where you left off. Prefer a tool call over restating what you were about to do.";
+        state.messages.push({ role: "user", content: nudge, hidden: true });
+        onEvent({ type: "user_message", text: nudge, hidden: true });
+        continue;
+      }
       if (stopReason !== "tool_use" || toolCalls.length === 0) {
         statusWatcher.stop();
         saveSession(state);
@@ -8948,7 +9223,7 @@ async function runTurn(params) {
           block.completedAt = Date.now();
           const msgs = subAgentMessages.get(r.id);
           if (msgs) {
-            block.subAgentMessages = msgs;
+            block.subAgentMessages = capSubAgentTranscript(msgs);
           }
         }
       }
@@ -9007,7 +9282,7 @@ var init_agent = __esm({
     init_trigger2();
     init_surfaces();
     init_toolRegistry();
-    init_toolResultCap();
+    init_historyLimits();
     log13 = createLogger("agent");
     BRAND_TRIGGERING_TOOLS = /* @__PURE__ */ new Set([
       "writeSpec",
@@ -9276,8 +9551,8 @@ var init_config = __esm({
 
 // src/headless/attachments.ts
 import { mkdirSync, existsSync } from "fs";
-import { writeFile } from "fs/promises";
-import { basename as basename2, join, extname as extname2 } from "path";
+import { writeFile as writeFile2 } from "fs/promises";
+import { basename as basename2, join as join2, extname as extname2 } from "path";
 function filenameFromUrl(url) {
   try {
     const pathname = new URL(url).pathname;
@@ -9288,7 +9563,7 @@ function filenameFromUrl(url) {
   }
 }
 function resolveUniqueFilename(name, claimed) {
-  const isFree = (candidate) => !claimed.has(candidate) && !existsSync(join(UPLOADS_DIR, candidate));
+  const isFree = (candidate) => !claimed.has(candidate) && !existsSync(join2(UPLOADS_DIR, candidate));
   if (isFree(name)) {
     return name;
   }
@@ -9322,7 +9597,7 @@ async function persistAttachments(attachments) {
   const results = await Promise.allSettled(
     nonVoice.map(async (att, i) => {
       const name = names[i];
-      const localPath = join(UPLOADS_DIR, name);
+      const localPath = join2(UPLOADS_DIR, name);
       const res = await fetch(att.url, {
         signal: AbortSignal.timeout(3e4)
       });
@@ -9330,7 +9605,7 @@ async function persistAttachments(attachments) {
         throw new Error(`HTTP ${res.status} downloading ${att.url}`);
       }
       const buffer = Buffer.from(await res.arrayBuffer());
-      await writeFile(localPath, buffer);
+      await writeFile2(localPath, buffer);
       log15.info("Attachment saved", {
         filename: name,
         path: localPath,
@@ -9344,7 +9619,7 @@ async function persistAttachments(attachments) {
           });
           if (textRes.ok) {
             extractedTextPath = `${localPath}.txt`;
-            await writeFile(extractedTextPath, await textRes.text(), "utf-8");
+            await writeFile2(extractedTextPath, await textRes.text(), "utf-8");
             log15.info("Extracted text saved", { path: extractedTextPath });
           }
         } catch {
@@ -9988,17 +10263,17 @@ var init_headless = __esm({
           return Promise.resolve(early);
         }
         const shouldTimeout = !USER_FACING_TOOLS.has(name);
-        return new Promise((resolve3) => {
+        return new Promise((resolve4) => {
           const timeout = shouldTimeout ? setTimeout(() => {
             this.pendingTools.delete(id);
-            resolve3(
+            resolve4(
               "Error: Tool timed out \u2014 no response from the app environment after 5 minutes."
             );
           }, EXTERNAL_TOOL_TIMEOUT_MS) : void 0;
           this.pendingTools.set(id, {
             resolve: (result) => {
               clearTimeout(timeout);
-              resolve3(result);
+              resolve4(result);
             },
             timeout
           });