@mindstudio-ai/remy 0.1.308 → 0.1.310

package/dist/index.js

@@ -4459,6 +4459,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 } : {}
     },
@@ -5624,7 +5625,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>`;
 }
 var init_context = __esm({
@@ -6045,58 +6046,293 @@ var init_scrapeWebUrl = __esm({
   }
 });
 
-// src/subagents/designExpert/tools/analyzeDesign.ts
-var analyzeDesign_exports = {};
-__export(analyzeDesign_exports, {
+// 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";
 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"
-      ],
+  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: [
       {
-        outputKey: "screenshotUrl",
-        timeout: 12e4,
-        onLog,
-        caller: "designExpert"
+        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, definition3;
+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.';
+    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"]
       }
+    };
+  }
+});
+
+// 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";
+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 (IMAGE_EXT_RE.test(url)) {
+    return analyze(
+      url,
+      customPrompt ?? DESIGN_REFERENCE_PROMPT,
+      onLog,
+      context
     );
-    if (!ss.ok) {
-      return `Could not screenshot ${url}: ${ss.value}`;
+  }
+  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
+  });
 }
-var DESIGN_REFERENCE_PROMPT, definition3;
+async function analyzeLocalHtml(path14, customPrompt, onLog, context) {
+  let raw;
+  try {
+    raw = await readFile2(join2(PROJECT_ROOT, path14), "utf8");
+  } catch {
+    return `No file at "${path14}". Paths resolve from the project root; list the directory to check the name.`;
+  }
+  const { name, description, html } = splitFrontmatter(raw);
+  if (!html.trim()) {
+    return `"${path14}" has no HTML to render.`;
+  }
+  onLog?.(`Rendering ${path14} 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 ${path14}: ${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
+  });
+}
+var DESIGN_REFERENCE_PROMPT, definition4, IMAGE_EXT_RE, HTML_EXTS, HTML_RENDER_WIDTH, HTML_RENDER_START_HEIGHT;
 var init_analyzeDesign = __esm({
   "src/subagents/designExpert/tools/analyzeDesign.ts"() {
     "use strict";
     init_runMindstudioCli();
     init_analyzeImage();
     init_surfaces();
+    init_uploadImage();
+    init_screenshot();
+    init_browserLock();
+    init_projectRoot();
+    init_renderImage();
     DESIGN_REFERENCE_PROMPT = `
 You are analyzing a screenshot of a real website or app for a designer's personal technique/inspiration reference notes.
 
@@ -6120,15 +6356,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.
 `;
-    definition3 = {
+    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",
@@ -6138,16 +6374,20 @@ Respond only with your analysis as Markdown and absolutely no other text. Do not
         required: ["url"]
       }
     };
+    IMAGE_EXT_RE = /\.(png|jpe?g|webp|gif|svg|avif)(\?|$)/i;
+    HTML_EXTS = /* @__PURE__ */ new Set([".html", ".htm"]);
+    HTML_RENDER_WIDTH = 1280;
+    HTML_RENDER_START_HEIGHT = 1400;
   }
 });
 
 // src/subagents/designExpert/tools/analyzeImage.ts
 var analyzeImage_exports = {};
 __export(analyzeImage_exports, {
-  definition: () => definition4,
-  execute: () => execute4
+  definition: () => definition5,
+  execute: () => execute5
 });
-async function execute4(input, onLog, context) {
+async function execute5(input, onLog, context) {
   const prompt = buildScreenshotAnalysisPrompt({
     prompt: input.prompt
   });
@@ -6160,14 +6400,14 @@ async function execute4(input, onLog, context) {
   });
   return JSON.stringify({ url, analysis });
 }
-var definition4;
+var definition5;
 var init_analyzeImage2 = __esm({
   "src/subagents/designExpert/tools/analyzeImage.ts"() {
     "use strict";
     init_analyzeImage();
     init_screenshot();
     init_surfaces();
-    definition4 = {
+    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: {
@@ -6435,10 +6675,10 @@ var init_imageGenerator = __esm({
 // src/subagents/designExpert/tools/images/generateImages.ts
 var generateImages_exports = {};
 __export(generateImages_exports, {
-  definition: () => definition5,
-  execute: () => execute5
+  definition: () => definition6,
+  execute: () => execute6
 });
-async function execute5(input, onLog, context) {
+async function execute6(input, onLog, context) {
   return generateImageAssets({
     prompts: input.prompts,
     width: input.width,
@@ -6465,13 +6705,13 @@ async function execute5(input, onLog, context) {
     )
   });
 }
-var definition5;
+var definition6;
 var init_generateImages = __esm({
   "src/subagents/designExpert/tools/images/generateImages.ts"() {
     "use strict";
     init_imageGenerator();
     init_surfaces();
-    definition5 = {
+    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: {
@@ -6510,10 +6750,10 @@ var init_generateImages = __esm({
 // src/subagents/designExpert/tools/images/editImages.ts
 var editImages_exports = {};
 __export(editImages_exports, {
-  definition: () => definition6,
-  execute: () => execute6
+  definition: () => definition7,
+  execute: () => execute7
 });
-async function execute6(input, onLog, context) {
+async function execute7(input, onLog, context) {
   return generateImageAssets({
     prompts: input.prompts,
     sourceImages: input.sourceImages,
@@ -6540,13 +6780,13 @@ async function execute6(input, onLog, context) {
     )
   });
 }
-var definition6;
+var definition7;
 var init_editImages = __esm({
   "src/subagents/designExpert/tools/images/editImages.ts"() {
     "use strict";
     init_imageGenerator();
     init_surfaces();
-    definition6 = {
+    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: {
@@ -6585,150 +6825,6 @@ 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({
@@ -6911,7 +7007,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";
 function singleLine(value) {
   return value.replace(/\s+/g, " ").trim();
 }
@@ -7000,12 +7096,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) {
@@ -7441,7 +7537,7 @@ The guidance about specifying layouts in prose, writing implementation notes, an
 
 // src/subagents/designExpert/validateWireframeRefs.ts
 import { stat as stat3 } from "fs/promises";
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 async function validateWireframeRefs(text) {
   const refs = [...new Set(text.match(WIREFRAME_REF_RE) ?? [])];
   if (refs.length === 0) {
@@ -7449,7 +7545,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
     );
@@ -10267,7 +10363,7 @@ var init_config = __esm({
 // 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";
 function filenameFromUrl(url) {
   try {
     const pathname = new URL(url).pathname;
@@ -10278,11 +10374,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}`)) {
@@ -10292,7 +10388,7 @@ function resolveUniqueFilename(name, claimed) {
 }
 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);
@@ -10312,7 +10408,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)
       });