@mindstudio-ai/remy 0.1.275 → 0.1.277

package/dist/headless.js

@@ -289,7 +289,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++) {
@@ -433,7 +433,7 @@ var MODEL_SURFACES = {
     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",
@@ -681,10 +681,9 @@ The user has approved your implementation plan in .remy-plan.md. You may referen
   }
 }
 
-// src/prompt/skills/catalog.ts
+// src/skillCatalog.ts
 import fs5 from "fs";
 import path3 from "path";
-var SKILLS_DIR = assetPath("prompt", "skills");
 function parseFrontmatter(content) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
   if (!match) {
@@ -692,23 +691,23 @@ 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;
 }
-function loadCatalog() {
+function buildSkillCatalog(opts) {
   let files;
   try {
-    files = fs5.readdirSync(SKILLS_DIR).filter((f) => f.endsWith(".md"));
+    files = fs5.readdirSync(opts.dir).filter((f) => f.endsWith(".md"));
   } catch {
-    return [];
+    files = [];
   }
   const skills = [];
   for (const file of files.sort()) {
-    const full = path3.join(SKILLS_DIR, file);
+    const full = path3.join(opts.dir, file);
     const id = file.replace(/\.md$/, "");
     const fields = parseFrontmatter(fs5.readFileSync(full, "utf-8"));
     if (!fields.name || !fields.what || !fields.when) {
@@ -722,38 +721,58 @@ function loadCatalog() {
       path: full
     });
   }
-  return skills;
+  return {
+    skills,
+    ids: skills.map((s) => s.id),
+    get(id) {
+      return skills.find((s) => s.id === id);
+    },
+    readBody(skill) {
+      return fs5.readFileSync(skill.path, "utf-8").replace(/^---[\s\S]*?---\s*/, "").trim();
+    },
+    renderCatalogBlock() {
+      if (skills.length === 0) {
+        return "";
+      }
+      const entries = skills.map(
+        (s) => [
+          `### ${s.name} (\`${s.id}\`)`,
+          s.what,
+          "",
+          `When to load: ${s.when}`,
+          `Reference: ${s.path}`
+        ].join("\n")
+      );
+      return `<${opts.tag}>
+${opts.intro}
+
+${entries.join("\n\n")}
+</${opts.tag}>`;
+    }
+  };
 }
-var SKILLS = loadCatalog();
-var SKILL_IDS = SKILLS.map((s) => s.id);
+
+// src/prompt/skills/_catalog.ts
+var INTRO = `Platform capabilities most apps don't use, so their references are kept out of this prompt rather than competing for your attention on every task \u2014 not because they're marginal.
+
+Read what follows as part of what the platform can do, not as a lookup table. Recognising that one of these fits a feature is your job, and proposing one is fair game \u2014 several of them are the difference between an app that works and an app worth showing off. When a trigger fires, load the reference with loadSkill before writing the code rather than after. Loading is cheap and expected; guessing at one of these APIs is not.
+
+A loaded reference drops out of the conversation once it ages out. Re-read it at the path listed with readFile whenever you need it again.`;
+var catalog = buildSkillCatalog({
+  dir: assetPath("prompt", "skills"),
+  tag: "available_skills",
+  intro: INTRO
+});
+var SKILLS = catalog.skills;
+var SKILL_IDS = catalog.ids;
 function getSkill(id) {
-  return SKILLS.find((s) => s.id === id);
+  return catalog.get(id);
 }
 function readSkillBody(skill) {
-  return fs5.readFileSync(skill.path, "utf-8").replace(/^---[\s\S]*?---\s*/, "").trim();
+  return catalog.readBody(skill);
 }
 function loadSkillsCatalog() {
-  if (SKILLS.length === 0) {
-    return "";
-  }
-  const entries = SKILLS.map(
-    (s) => [
-      `### ${s.name} (\`${s.id}\`)`,
-      s.what,
-      "",
-      `When to load: ${s.when}`,
-      `Reference: ${s.path}`
-    ].join("\n")
-  );
-  return `<available_skills>
-Platform capabilities most apps don't use, so their references are kept out of this prompt rather than competing for your attention on every task \u2014 not because they're marginal.
-
-Read what follows as part of what the platform can do, not as a lookup table. Recognising that one of these fits a feature is your job, and proposing one is fair game \u2014 several of them are the difference between an app that works and an app worth showing off. When a trigger fires, load the reference with loadSkill before writing the code rather than after. Loading is cheap and expected; guessing at one of these APIs is not.
-
-A loaded reference drops out of the conversation once it ages out. Re-read it at the path listed with readFile whenever you need it again.
-
-${entries.join("\n\n")}
-</available_skills>`;
+  return catalog.renderCatalogBlock();
 }
 
 // src/prompt/index.ts
@@ -1663,7 +1682,7 @@ function formatCliResult(r) {
   return logBlock + body + truncNote;
 }
 function runCli(command, args, options) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     const timeout = options?.timeout ?? 6e4;
     const maxBuffer = options?.maxBuffer ?? 1024 * 1024;
     let finalArgs = args;
@@ -1692,7 +1711,7 @@ function runCli(command, args, options) {
       if (killTimer) {
         clearTimeout(killTimer);
       }
-      resolve3(result);
+      resolve4(result);
     };
     const child = spawn(command, finalArgs, {
       stdio: [options?.stdin ? "pipe" : "ignore", "pipe", "pipe"]
@@ -2389,7 +2408,7 @@ var bashTool = {
   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.
@@ -2414,9 +2433,9 @@ var bashTool = {
         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;
         }
@@ -2442,18 +2461,18 @@ var bashTool = {
               `${(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}`);
       });
     });
   }
@@ -2570,17 +2589,17 @@ var grepTool = {
     }
     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.");
           }
         });
       });
@@ -2896,7 +2915,7 @@ var restartProcessTool = {
   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)}`;
@@ -3123,6 +3142,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);
@@ -4262,10 +4301,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;
       }
     }
@@ -4569,7 +4608,7 @@ var browserAutomationTool = {
 // src/tools/code/screenshot.ts
 var 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: {
@@ -4600,7 +4639,7 @@ var screenshotDefinition = {
       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",
@@ -4922,7 +4961,36 @@ ${brief}
 }
 
 // src/subagents/designExpert/tools/images/imageGenerator.ts
-var 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.';
+var 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.';
+var 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]
+];
+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,
@@ -4937,7 +5005,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;
@@ -5189,11 +5261,143 @@ 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, {
-  definition: () => definition7,
-  execute: () => execute7
+  definition: () => definition8,
+  execute: () => execute8
 });
 
 // src/subagents/copyEditor/tools.ts
@@ -5249,7 +5453,7 @@ var copyEditorTool = {
 };
 
 // src/subagents/designExpert/tools/polishCopy.ts
-var definition7 = {
+var 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: {
@@ -5263,10 +5467,63 @@ var definition7 = {
     required: ["task"]
   }
 };
-async function execute7(input, _onLog, context) {
+async function execute8(input, _onLog, context) {
   return copyEditorTool.execute(input, context);
 }
 
+// src/subagents/designExpert/tools/loadSkill.ts
+var loadSkill_exports = {};
+__export(loadSkill_exports, {
+  definition: () => definition9,
+  execute: () => execute9
+});
+
+// src/subagents/designExpert/skills/_catalog.ts
+var INTRO2 = `Deep craft references for specific surfaces, kept out of this prompt so they can go far beyond what a resident section could \u2014 full technique recipes, worked examples, quality bars. Recognising that one of these fits the brief is part of your job as much as the design work itself: when a trigger fires, load the reference with loadSkill before designing in that area, not after. The craft in these docs is the difference between a defaulted artifact and a designed one.
+
+A loaded reference drops out of the conversation once it ages out. Re-read it at the path listed with readFile whenever you need it again.`;
+var designSkillCatalog = buildSkillCatalog({
+  dir: assetPath("subagents/designExpert", "skills"),
+  tag: "available_skills",
+  intro: INTRO2
+});
+
+// src/subagents/designExpert/tools/loadSkill.ts
+var definition9 = {
+  name: "loadSkill",
+  description: "Load the full craft reference for a design surface that isn't in your prompt. The available skills and the trigger for each are listed in <available_skills>. Load one before designing in its area, not after \u2014 these are hard-won technique recipes, and the defaulted version of these surfaces is exactly what they exist to prevent. Calling this is cheap and expected \u2014 if you're unsure whether you need it, load it.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      skill: {
+        type: "string",
+        // Omitted when the catalog is empty: an empty enum is a schema no
+        // provider accepts, and failing one tool call beats failing every
+        // request if the docs ever go missing from a build.
+        ...designSkillCatalog.ids.length > 0 ? { enum: designSkillCatalog.ids } : {},
+        description: "The skill id, as listed in <available_skills>."
+      }
+    },
+    required: ["skill"]
+  }
+};
+async function execute9(input) {
+  const id = String(input.skill ?? "");
+  const skill = designSkillCatalog.get(id);
+  if (!skill) {
+    return `Error: unknown skill "${id}". Available: ${designSkillCatalog.ids.join(", ") || "(none)"}`;
+  }
+  try {
+    const body = designSkillCatalog.readBody(skill);
+    return `${body}
+
+---
+This reference lives at ${skill.path}. Re-read it with readFile if you need it again later \u2014 it won't stay in the conversation.`;
+  } catch (err) {
+    return `Error loading skill "${id}": ${err.message}`;
+  }
+}
+
 // src/subagents/designExpert/tools/index.ts
 var tools = {
   searchGoogle: searchGoogle_exports,
@@ -5279,7 +5536,9 @@ var tools = {
   screenshot: { definition: screenshotDefinition, execute: executeScreenshot },
   generateImages: generateImages_exports,
   editImages: editImages_exports,
-  polishCopy: polishCopy_exports
+  renderImage: renderImage_exports,
+  polishCopy: polishCopy_exports,
+  loadSkill: loadSkill_exports
 };
 var DESIGN_EXPERT_TOOLS = [
   ...COMMON_READ_TOOLS,
@@ -5475,6 +5734,12 @@ function getDesignExpertPrompt(onboardingState, opts) {
     "{{ui_case_studies}}",
     getUiInspirationSample(indices.uiInspiration)
   );
+  const skillsBlock = designSkillCatalog.renderCatalogBlock();
+  if (skillsBlock) {
+    prompt += `
+
+${skillsBlock}`;
+  }
   prompt += "\n\n<!-- cache_breakpoint -->";
   if (specContext) {
     prompt += `
@@ -5698,13 +5963,13 @@ var PITCH_DECK_SHELL = readAsset(
   "subagents/productVision",
   "pitch-deck-shell.html"
 );
-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 {
         fs19.mkdirSync(ROADMAP_DIR, { recursive: true });
         let oldContent = null;
@@ -5722,7 +5987,7 @@ ${unifiedDiff(filePath, oldContent ?? "", input.content)}`;
       }
     }
     case "deleteFile": {
-      const filePath = resolve2(input.path);
+      const filePath = resolve3(input.path);
       try {
         if (!fs19.existsSync(filePath)) {
           return `Error: ${filePath} does not exist`;
@@ -5739,7 +6004,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 {
         fs19.mkdirSync(ROADMAP_DIR, { recursive: true });
         const exists = fs19.existsSync(filePath);
@@ -7360,14 +7625,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.)`
@@ -7377,7 +7642,7 @@ ${content}`;
     sections.push(section);
     usedChars += added;
   }
-  return sections.join(sep);
+  return sections.join(sep2);
 }
 function headSlice(content) {
   if (content.length <= HEAD_SLICE_CHARS) {
@@ -8474,8 +8739,8 @@ async function runTurn(params) {
 
 // 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";
 var log15 = createLogger("headless:attachments");
 var UPLOADS_DIR = "src/.user-uploads";
 function filenameFromUrl(url) {
@@ -8488,7 +8753,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;
   }
@@ -8523,7 +8788,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)
       });
@@ -8531,7 +8796,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,
@@ -8545,7 +8810,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 {
@@ -9132,17 +9397,17 @@ var HeadlessSession = class {
       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
       });