@mindstudio-ai/remy 0.1.307 → 0.1.309

package/dist/headless.js

@@ -3243,6 +3243,7 @@ async function renderHtmlViaSidecar(opts) {
       html: opts.html,
       width: opts.width,
       height: opts.height,
+      ...opts.autoHeight ? { autoHeight: true } : {},
       ...opts.transparent ? { transparent: true } : {},
       ...opts.scale != null ? { scale: opts.scale } : {}
     },
@@ -4566,7 +4567,7 @@ The first-party SDK (@mindstudio-ai/agent) provides access to 200+ AI models (Op
 ## What Remy apps are NOT good for
 
 - Native mobile apps (iOS/Android). Mobile-responsive web apps are fine.
-- Real-time multiplayer with persistent connections (no WebSocket support). Turn-based or async patterns work.
+- Fast-twitch multiplayer and live co-editing (shared cursors, 60fps sync) \u2014 client\u2192server is always a method invoke, so sub-100ms bidirectional interaction isn't a fit.
 </platform_brief>`;
 }
 
@@ -4933,9 +4934,146 @@ async function execute2(input, onLog) {
 // src/subagents/designExpert/tools/analyzeDesign.ts
 var analyzeDesign_exports = {};
 __export(analyzeDesign_exports, {
+  definition: () => definition4,
+  execute: () => execute4
+});
+import { readFile as readFile2 } from "fs/promises";
+import { extname as extname2, join as join2 } from "path";
+
+// src/subagents/designExpert/tools/images/renderImage.ts
+var renderImage_exports = {};
+__export(renderImage_exports, {
+  RENDER_ANALYZE_PROMPT: () => RENDER_ANALYZE_PROMPT,
   definition: () => definition3,
   execute: () => execute3
 });
+import { mkdir, unlink, writeFile } from "fs/promises";
+import { tmpdir } from "os";
+import { dirname, join, resolve as resolve2, sep } from "path";
+import { randomUUID } from "crypto";
+var MIN_DIMENSION = 16;
+var MAX_DIMENSION = 4096;
+var 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.';
+var definition3 = {
+  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"]
+  }
+};
+async function execute3(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
+      }
+    ]
+  });
+}
+
+// src/subagents/designExpert/tools/analyzeDesign.ts
 var DESIGN_REFERENCE_PROMPT = `
 You are analyzing a screenshot of a real website or app for a designer's personal technique/inspiration reference notes.
 
@@ -4959,15 +5097,15 @@ Identify the specific design moves that make this page interesting and unique, d
 
 Respond only with your analysis as Markdown and absolutely no other text. Do not use emojis - use unicode if you need symbols.
 `;
-var definition3 = {
+var definition4 = {
   name: "analyzeDesign",
-  description: "Analyze the visual design of a website, an image URL, or an image file on disk. Websites are automatically screenshotted first. Provides static image analysis only, will not capture animations or video. If no prompt is provided, performs a full design reference analysis (mood, color, typography, layout, distinctiveness). Provide a custom prompt to ask a specific design question instead. Use a bulleted list to ask many questions at once.",
+  description: "Analyze the visual design of a website, an image (URL or file on disk), or an HTML document on disk. Websites are screenshotted first; an HTML file is rendered in a real browser first and the render is analyzed, which is how you look at a wireframe you authored. Provides static image analysis only, will not capture animations or video. With no prompt, a website or image gets a full design reference analysis (mood, color, typography, layout, distinctiveness) and a rendered HTML document gets a fidelity review (clipping, overflow, webfont loading, alignment). Provide a custom prompt to ask a specific design question instead. Use a bulleted list to ask many questions at once.",
   inputSchema: {
     type: "object",
     properties: {
       url: {
         type: "string",
-        description: "What to analyze: a website URL (will be screenshotted), an image URL, or the path of an image file on disk (e.g. a reference the user uploaded, under src/.user-uploads/). Local files are hosted automatically and their URL comes back in the result."
+        description: "What to analyze: a website URL (will be screenshotted), an image URL, the path of an image file on disk (e.g. a reference the user uploaded, under src/.user-uploads/), or the path of an HTML file on disk (rendered in a browser, then analyzed). Local files are hosted automatically and their URL comes back in the result."
       },
       prompt: {
         type: "string",
@@ -4977,53 +5115,140 @@ var definition3 = {
     required: ["url"]
   }
 };
-async function execute3(input, onLog, context) {
-  const url = input.url;
-  const analysisPrompt = input.prompt || DESIGN_REFERENCE_PROMPT;
-  const isImage = /\.(png|jpe?g|webp|gif|svg|avif)(\?|$)/i.test(url);
-  let image = url;
-  if (!isImage) {
-    const ss = await runMindstudioCliResult(
-      [
-        "screenshot-url",
-        "--url",
-        url,
-        "--mode",
-        "viewport",
-        "--width",
-        "1440",
-        "--delay",
-        "2000"
-      ],
-      {
-        outputKey: "screenshotUrl",
-        timeout: 12e4,
-        onLog,
-        caller: "designExpert"
-      }
+var IMAGE_EXT_RE = /\.(png|jpe?g|webp|gif|svg|avif)(\?|$)/i;
+var HTML_EXTS = /* @__PURE__ */ new Set([".html", ".htm"]);
+var HTML_RENDER_WIDTH = 1280;
+var HTML_RENDER_START_HEIGHT = 1400;
+function splitFrontmatter(raw) {
+  const match = raw.match(/^---\n([\s\S]*?)\n---\n?/);
+  if (!match) {
+    return { html: raw };
+  }
+  const fields = {};
+  for (const line of match[1].split("\n")) {
+    const idx = line.indexOf(":");
+    if (idx > 0) {
+      fields[line.slice(0, idx).trim()] = line.slice(idx + 1).trim();
+    }
+  }
+  return {
+    name: fields.name,
+    description: fields.description,
+    html: raw.slice(match[0].length)
+  };
+}
+async function execute4(input, onLog, context) {
+  const url = String(input.url ?? "").trim();
+  if (!url) {
+    return "Error: url is required.";
+  }
+  const customPrompt = typeof input.prompt === "string" && input.prompt.trim() ? input.prompt : void 0;
+  if (!isFetchableUrl(url)) {
+    if (HTML_EXTS.has(extname2(url).toLowerCase())) {
+      return analyzeLocalHtml(url, customPrompt, onLog, context);
+    }
+    return analyze(
+      url,
+      customPrompt ?? DESIGN_REFERENCE_PROMPT,
+      onLog,
+      context
     );
-    if (!ss.ok) {
-      return `Could not screenshot ${url}: ${ss.value}`;
+  }
+  if (IMAGE_EXT_RE.test(url)) {
+    return analyze(
+      url,
+      customPrompt ?? DESIGN_REFERENCE_PROMPT,
+      onLog,
+      context
+    );
+  }
+  const ss = await runMindstudioCliResult(
+    [
+      "screenshot-url",
+      "--url",
+      url,
+      "--mode",
+      "viewport",
+      "--width",
+      "1440",
+      "--delay",
+      "2000"
+    ],
+    {
+      outputKey: "screenshotUrl",
+      timeout: 12e4,
+      onLog,
+      caller: "designExpert"
     }
-    image = ss.value;
+  );
+  if (!ss.ok) {
+    return `Could not screenshot ${url}: ${ss.value}`;
   }
+  return analyze(
+    ss.value,
+    customPrompt ?? DESIGN_REFERENCE_PROMPT,
+    onLog,
+    context
+  );
+}
+async function analyze(image, prompt, onLog, context, extra) {
   const analyzed = await analyzeImage({
-    prompt: analysisPrompt,
+    prompt,
     image,
     apiConfig: context?.apiConfig,
     onLog,
     model: resolveModel("imageAnalysis", context?.models, context?.model)
   });
-  return JSON.stringify({ url: analyzed.url, analysis: analyzed.analysis });
+  return JSON.stringify({
+    url: analyzed.url,
+    analysis: analyzed.analysis,
+    ...extra
+  });
+}
+async function analyzeLocalHtml(path13, customPrompt, onLog, context) {
+  let raw;
+  try {
+    raw = await readFile2(join2(PROJECT_ROOT, path13), "utf8");
+  } catch {
+    return `No file at "${path13}". Paths resolve from the project root; list the directory to check the name.`;
+  }
+  const { name, description, html } = splitFrontmatter(raw);
+  if (!html.trim()) {
+    return `"${path13}" has no HTML to render.`;
+  }
+  onLog?.(`Rendering ${path13} in the sandbox browser...`);
+  const release = await acquireBrowserLock();
+  let rendered;
+  try {
+    rendered = await renderHtmlViaSidecar({
+      html,
+      width: HTML_RENDER_WIDTH,
+      height: HTML_RENDER_START_HEIGHT,
+      autoHeight: true
+    });
+  } catch (err) {
+    return `Could not render ${path13}: ${err?.message ?? err}`;
+  } finally {
+    release();
+  }
+  const basePrompt = customPrompt ?? RENDER_ANALYZE_PROMPT;
+  const subject = [name, description].filter(Boolean).join(" \u2014 ");
+  const prompt = subject ? `The document rendered below is described by its author as: ${subject}
+
+${basePrompt}` : basePrompt;
+  return analyze(rendered.url, prompt, onLog, context, {
+    renderedWidth: rendered.width,
+    renderedHeight: rendered.height
+  });
 }
 
 // src/subagents/designExpert/tools/analyzeImage.ts
 var analyzeImage_exports = {};
 __export(analyzeImage_exports, {
-  definition: () => definition4,
-  execute: () => execute4
+  definition: () => definition5,
+  execute: () => execute5
 });
-var definition4 = {
+var definition5 = {
   name: "analyzeImage",
   description: "Analyze an image using a vision model. Provides static image analysis only, will not capture animations or video. Returns an objective description of what is visible \u2014 shapes, colors, layout, text, artifacts. Use for factual inventory of image contents, not for subjective design judgment - the vision model providing the analysis has no sense of design. You are the design expert - use the analysis tool for factual inventory, then apply your own expertise for quality and suitability assessments. Optionally provide specific questions about what you're looking for. Use a bulleted list to ask many questions at once. If you are analyzing a screenshot of the app preview, you can reuse the same screenshot URL multiple times to ask multiple questions.",
   inputSchema: {
@@ -5044,7 +5269,7 @@ var definition4 = {
     required: ["imageUrl"]
   }
 };
-async function execute4(input, onLog, context) {
+async function execute5(input, onLog, context) {
   const prompt = buildScreenshotAnalysisPrompt({
     prompt: input.prompt
   });
@@ -5061,8 +5286,8 @@ async function execute4(input, onLog, context) {
 // src/subagents/designExpert/tools/images/generateImages.ts
 var generateImages_exports = {};
 __export(generateImages_exports, {
-  definition: () => definition5,
-  execute: () => execute5
+  definition: () => definition6,
+  execute: () => execute6
 });
 
 // src/subagents/designExpert/tools/images/enhancePrompt.ts
@@ -5289,7 +5514,7 @@ async function generateImageAssets(opts) {
 }
 
 // src/subagents/designExpert/tools/images/generateImages.ts
-var definition5 = {
+var definition6 = {
   name: "generateImages",
   description: "Generate images. Returns CDN URLs with a quality analysis for each image. Produces high-quality results for everything from photorealistic images and abstract/creative visuals. Pass multiple prompts to generate in parallel. No need to analyze images separately after generating \u2014 the analysis is included.",
   inputSchema: {
@@ -5322,7 +5547,7 @@ var definition5 = {
     required: ["prompts"]
   }
 };
-async function execute5(input, onLog, context) {
+async function execute6(input, onLog, context) {
   return generateImageAssets({
     prompts: input.prompts,
     width: input.width,
@@ -5353,10 +5578,10 @@ async function execute5(input, onLog, context) {
 // src/subagents/designExpert/tools/images/editImages.ts
 var editImages_exports = {};
 __export(editImages_exports, {
-  definition: () => definition6,
-  execute: () => execute6
+  definition: () => definition7,
+  execute: () => execute7
 });
-var definition6 = {
+var definition7 = {
   name: "editImages",
   description: "Edit or transform existing images. Provide one or more source image URLs as reference and a prompt describing the desired edit. Use for compositing, style transfer, subject transformation, blending multiple references, or incorporating one or more references into something new. Returns CDN URLs with analysis.",
   inputSchema: {
@@ -5392,7 +5617,7 @@ var definition6 = {
     required: ["prompts", "sourceImages"]
   }
 };
-async function execute6(input, onLog, context) {
+async function execute7(input, onLog, context) {
   return generateImageAssets({
     prompts: input.prompts,
     sourceImages: input.sourceImages,
@@ -5420,138 +5645,6 @@ async function execute6(input, onLog, context) {
   });
 }
 
-// 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";
-var MIN_DIMENSION = 16;
-var MAX_DIMENSION = 4096;
-var 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.';
-var 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"]
-  }
-};
-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
-      }
-    ]
-  });
-}
-
 // src/subagents/designExpert/tools/polishCopy.ts
 var polishCopy_exports = {};
 __export(polishCopy_exports, {
@@ -5697,7 +5790,7 @@ __export(createWireframe_exports, {
   execute: () => execute10
 });
 import { mkdir as mkdir2, stat as stat2, writeFile as writeFile2 } from "fs/promises";
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 var log9 = createLogger("createWireframe");
 var WIREFRAMES_DIR = "src/.wireframes";
 var UPLOAD_TIMEOUT_MS2 = 3e4;
@@ -5816,12 +5909,12 @@ async function execute10(input, onLog, context) {
     html.trim(),
     ""
   ].join("\n");
-  await mkdir2(join2(PROJECT_ROOT, WIREFRAMES_DIR), { recursive: true });
-  const existed = await stat2(join2(PROJECT_ROOT, relPath)).then(
+  await mkdir2(join3(PROJECT_ROOT, WIREFRAMES_DIR), { recursive: true });
+  const existed = await stat2(join3(PROJECT_ROOT, relPath)).then(
     () => true,
     () => false
   );
-  await writeFile2(join2(PROJECT_ROOT, relPath), content, "utf8");
+  await writeFile2(join3(PROJECT_ROOT, relPath), content, "utf8");
   onLog?.(`Wrote ${relPath}, mirroring for preview...`);
   const mirror = await uploadMirror(context, slug, content);
   if (!mirror.ok) {
@@ -6092,7 +6185,7 @@ ${RENDER_TASK_BLOCK}`;
 
 // src/subagents/designExpert/validateWireframeRefs.ts
 import { stat as stat3 } from "fs/promises";
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 var WIREFRAME_REF_RE = /src\/\.wireframes\/[a-z0-9][a-z0-9-]*\.html/g;
 async function validateWireframeRefs(text) {
   const refs = [...new Set(text.match(WIREFRAME_REF_RE) ?? [])];
@@ -6101,7 +6194,7 @@ async function validateWireframeRefs(text) {
   }
   const missing = [];
   for (const ref of refs) {
-    const exists = await stat3(join3(PROJECT_ROOT, ref)).then(
+    const exists = await stat3(join4(PROJECT_ROOT, ref)).then(
       (s) => s.isFile(),
       () => false
     );
@@ -8444,6 +8537,155 @@ function friendlyError(raw) {
   return `Something went wrong: ${raw}`;
 }
 
+// src/suggestions.ts
+var SUGGEST_MARKER = "](suggest:";
+var SEPARATORS = "\\s\xB7|,\\-\u2013\u2014";
+var SEPARATORS_ONLY = new RegExp(`^[${SEPARATORS}]*$`);
+var TRAILING_SEPARATORS = new RegExp(`[${SEPARATORS}]+$`);
+var LIST_MARKER = /^\s*(?:[-*+]|\d+[.)])\s+/;
+var FENCE = /^ {0,3}(?:```|~~~)/;
+function findLinks(line) {
+  const found = [];
+  let i = 0;
+  while (i < line.length) {
+    const ch = line[i];
+    if (ch === "\\") {
+      i += 2;
+      continue;
+    }
+    if (ch === "`") {
+      let runEnd = i;
+      while (runEnd < line.length && line[runEnd] === "`") {
+        runEnd++;
+      }
+      const fence = line.slice(i, runEnd);
+      const close = line.indexOf(fence, runEnd);
+      if (close === -1) {
+        break;
+      }
+      i = close + fence.length;
+      continue;
+    }
+    if (ch !== "[") {
+      i++;
+      continue;
+    }
+    const labelEnd = line.indexOf("]", i + 1);
+    if (labelEnd === -1) {
+      break;
+    }
+    if (!line.startsWith(SUGGEST_MARKER, labelEnd)) {
+      i = labelEnd + 1;
+      continue;
+    }
+    let depth = 1;
+    let p = labelEnd + SUGGEST_MARKER.length;
+    while (p < line.length && depth > 0) {
+      if (line[p] === "(") {
+        depth++;
+      } else if (line[p] === ")") {
+        depth--;
+      }
+      p++;
+    }
+    if (depth > 0) {
+      break;
+    }
+    found.push({
+      start: i,
+      end: p,
+      label: line.slice(i + 1, labelEnd).trim(),
+      message: line.slice(labelEnd + SUGGEST_MARKER.length, p - 1).trim(),
+      standalone: false
+    });
+    i = p;
+  }
+  return found;
+}
+function classify(line, matches) {
+  let tailClean = SEPARATORS_ONLY.test(
+    line.slice(matches[matches.length - 1].end)
+  );
+  for (let i = matches.length - 1; i >= 0; i--) {
+    matches[i].standalone = tailClean;
+    if (!tailClean) {
+      continue;
+    }
+    const gap = i > 0 ? line.slice(matches[i - 1].end, matches[i].start) : "";
+    tailClean = SEPARATORS_ONLY.test(gap);
+  }
+}
+function parseSuggestions(raw) {
+  if (!raw.includes(SUGGEST_MARKER)) {
+    return { text: raw, suggestions: [] };
+  }
+  const suggestions = [];
+  const seen = /* @__PURE__ */ new Set();
+  const outLines = [];
+  let inFence = false;
+  let droppedLine = false;
+  for (const line of raw.split("\n")) {
+    if (FENCE.test(line)) {
+      inFence = !inFence;
+      outLines.push(line);
+      continue;
+    }
+    if (inFence) {
+      outLines.push(line);
+      continue;
+    }
+    const matches = findLinks(line);
+    if (matches.length === 0) {
+      outLines.push(line);
+      continue;
+    }
+    classify(line, matches);
+    for (const m of matches) {
+      const key = `${m.label}::${m.message}`;
+      if (!seen.has(key)) {
+        seen.add(key);
+        suggestions.push({ label: m.label, message: m.message });
+      }
+    }
+    let rebuilt = "";
+    let cursor = 0;
+    for (const m of matches) {
+      rebuilt += line.slice(cursor, m.start);
+      if (!m.standalone) {
+        rebuilt += m.label;
+      }
+      cursor = m.end;
+    }
+    rebuilt += line.slice(cursor);
+    if (matches.some((m) => m.standalone)) {
+      if (SEPARATORS_ONLY.test(rebuilt.replace(LIST_MARKER, ""))) {
+        droppedLine = true;
+        continue;
+      }
+      rebuilt = rebuilt.replace(TRAILING_SEPARATORS, "");
+    }
+    outLines.push(rebuilt);
+  }
+  let text = outLines.join("\n").replace(/\s+$/, "");
+  if (droppedLine) {
+    text = text.replace(/\n{3,}/g, "\n\n");
+  }
+  return { text, suggestions };
+}
+function annotateSuggestions(blocks) {
+  for (const block of blocks) {
+    if (block.type !== "text" || !block.text.includes(SUGGEST_MARKER)) {
+      continue;
+    }
+    const { text, suggestions } = parseSuggestions(block.text);
+    if (suggestions.length === 0) {
+      continue;
+    }
+    block.displayText = text;
+    block.suggestions = suggestions;
+  }
+}
+
 // src/agent.ts
 var log15 = createLogger("agent");
 var BRAND_TRIGGERING_TOOLS = /* @__PURE__ */ new Set([
@@ -8638,8 +8880,27 @@ async function runTurn(params) {
           toolInputAccumulators.set(id, acc);
         }
         return acc;
+      }, emitTextBlockSnapshot2 = function(closing) {
+        let block;
+        for (let i = contentBlocks.length - 1; i >= 0; i--) {
+          const candidate = contentBlocks[i];
+          if (candidate.type === "text") {
+            block = candidate;
+            break;
+          }
+        }
+        if (!block || !block.text.includes(SUGGEST_MARKER)) {
+          return;
+        }
+        const { text, suggestions } = parseSuggestions(block.text);
+        const worthSending = closing ? suggestions.length > 0 : suggestions.length > emittedSuggestionCount;
+        if (!worthSending) {
+          return;
+        }
+        emittedSuggestionCount = suggestions.length;
+        onEvent({ type: "text_block", text, suggestions });
       };
-      var getOrCreateAccumulator = getOrCreateAccumulator2;
+      var getOrCreateAccumulator = getOrCreateAccumulator2, emitTextBlockSnapshot = emitTextBlockSnapshot2;
       if (signal?.aborted) {
         onEvent({ type: "turn_cancelled" });
         saveSession(state);
@@ -8651,6 +8912,7 @@ async function runTurn(params) {
       let thinkingCompleteCount = 0;
       let lastThinkingRelatedStartedAt;
       let textBlockOpen = false;
+      let emittedSuggestionCount = 0;
       const toolInputAccumulators = /* @__PURE__ */ new Map();
       let stopReason = "end_turn";
       let turnProviderMetadata;
@@ -8739,14 +9001,19 @@ async function runTurn(params) {
                   text: event.text,
                   startedAt: event.ts
                 });
+                emittedSuggestionCount = 0;
               }
               textBlockOpen = true;
               onEvent({ type: "text", text: event.text });
+              emitTextBlockSnapshot2(false);
               break;
             }
             case "thinking":
               if (event.text === "") {
                 thinkingBlockStartTimes.push(event.ts);
+                if (textBlockOpen) {
+                  emitTextBlockSnapshot2(true);
+                }
                 textBlockOpen = false;
               }
               onEvent({ type: "thinking", text: event.text });
@@ -8872,6 +9139,11 @@ async function runTurn(params) {
           throw err;
         }
       }
+      if (textBlockOpen) {
+        emitTextBlockSnapshot2(true);
+        textBlockOpen = false;
+      }
+      annotateSuggestions(contentBlocks);
       if (signal?.aborted) {
         statusWatcher.stop();
         if (contentBlocks.length > 0) {
@@ -9145,7 +9417,7 @@ async function runTurn(params) {
 // src/headless/attachments.ts
 import { mkdirSync, existsSync } from "fs";
 import { writeFile as writeFile3 } from "fs/promises";
-import { basename as basename2, join as join4, extname as extname2 } from "path";
+import { basename as basename2, join as join5, extname as extname3 } from "path";
 var log16 = createLogger("headless:attachments");
 var UPLOADS_DIR = "src/.user-uploads";
 function filenameFromUrl(url) {
@@ -9158,11 +9430,11 @@ function filenameFromUrl(url) {
   }
 }
 function resolveUniqueFilename(name, claimed) {
-  const isFree = (candidate) => !claimed.has(candidate) && !existsSync(join4(UPLOADS_DIR, candidate));
+  const isFree = (candidate) => !claimed.has(candidate) && !existsSync(join5(UPLOADS_DIR, candidate));
   if (isFree(name)) {
     return name;
   }
-  const ext = extname2(name);
+  const ext = extname3(name);
   const base = name.slice(0, name.length - ext.length);
   let counter = 1;
   while (!isFree(`${base}-${counter}${ext}`)) {
@@ -9173,7 +9445,7 @@ function resolveUniqueFilename(name, claimed) {
 var IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".webp"]);
 function isImageAttachment(att) {
   const name = att.filename || filenameFromUrl(att.url);
-  return IMAGE_EXTENSIONS.has(extname2(name).toLowerCase());
+  return IMAGE_EXTENSIONS.has(extname3(name).toLowerCase());
 }
 async function persistAttachments(attachments) {
   const nonVoice = attachments.filter((a) => !a.isVoice);
@@ -9193,7 +9465,7 @@ async function persistAttachments(attachments) {
   const results = await Promise.allSettled(
     nonVoice.map(async (att, i) => {
       const name = names[i];
-      const localPath = join4(UPLOADS_DIR, name);
+      const localPath = join5(UPLOADS_DIR, name);
       const res = await fetch(att.url, {
         signal: AbortSignal.timeout(3e4)
       });
@@ -10002,6 +10274,13 @@ var HeadlessSession = class {
           rid
         );
         return;
+      case "text_block":
+        this.emit(
+          "text_block",
+          { text: e.text, suggestions: e.suggestions },
+          rid
+        );
+        return;
       case "thinking":
         this.emit(
           "thinking",