@mindstudio-ai/remy 0.1.299 → 0.1.301

package/dist/headless.js

@@ -942,9 +942,9 @@ function buildBackgroundResultsMessage(results) {
 ${r.result}
 </tool_result>`
   ).join("\n\n");
-  const plural = results.length > 1 ? "s" : "";
-  const body = `This is an automated message containing the result${plural} of ${results.length > 1 ? "tool calls" : "a tool call"} that ${results.length > 1 ? "have" : "has"} been working in the background. This is not a direct message from the user.
-<background_results>
+  const body = `<background_results>
+Automated delivery of results from background tool calls that completed while other work was in progress. This block is not from the user \u2014 anything outside it is.
+
 ${xml}
 </background_results>`;
   return automatedMessage("background_results", body);
@@ -1848,7 +1848,7 @@ var askMindStudioSdkTool = {
   async execute(input, context) {
     const query = input.query;
     const result = await runCli("mindstudio", ["ask", query], {
-      timeout: 2e5,
+      timeout: 48e4,
       maxBuffer: 512 * 1024,
       onLog: context?.onLog
     });
@@ -2757,8 +2757,8 @@ function formatSize(bytes) {
 }
 async function formatFile(dirPath, name, indent) {
   try {
-    const stat3 = await fs16.stat(path8.join(dirPath, name));
-    return `${indent}${name}${" ".repeat(Math.max(1, 30 - indent.length - name.length))}${formatSize(stat3.size)}`;
+    const stat4 = await fs16.stat(path8.join(dirPath, name));
+    return `${indent}${name}${" ".repeat(Math.max(1, 30 - indent.length - name.length))}${formatSize(stat4.size)}`;
   } catch {
     return `${indent}${name}`;
   }
@@ -3787,6 +3787,7 @@ async function runSubAgent(config) {
     acquireLock,
     onBackgroundComplete,
     captureArtifacts,
+    validateResult,
     cachePolicy = "run"
   } = config;
   const artifacts = {};
@@ -3807,6 +3808,7 @@ async function runSubAgent(config) {
 
 Current date: ${dateStr}`;
   let turns = 0;
+  let validationRetried = false;
   const run = async () => {
     const historyLen = (history ?? []).length;
     const subAgentMessages = /* @__PURE__ */ new Map();
@@ -4010,8 +4012,41 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
           (b) => b.type === "tool"
         );
         if (stopReason !== "tool_use" || toolCalls.length === 0) {
+          let text = getPartialText(contentBlocks);
+          if (validateResult) {
+            let objection = null;
+            try {
+              objection = await validateResult(text, thisInvocation());
+            } catch (err) {
+              log7.warn("Result validator failed, accepting response", {
+                requestId,
+                parentToolId,
+                agentName,
+                error: err.message
+              });
+            }
+            if (objection && !validationRetried && !signal?.aborted) {
+              validationRetried = true;
+              log7.info("Result rejected by validator, retrying once", {
+                requestId,
+                parentToolId,
+                agentName,
+                objection: objection.slice(0, 200)
+              });
+              emit({
+                type: "status",
+                message: "Response failed validation, revising"
+              });
+              messages.push({ role: "user", content: objection });
+              continue;
+            }
+            if (objection) {
+              text = `${text}
+
+[Response validator: ${objection}]`;
+            }
+          }
           statusWatcher.stop();
-          const text = getPartialText(contentBlocks);
           const hasArtifacts = Object.keys(artifacts).length > 0;
           return {
             text,
@@ -4570,7 +4605,7 @@ async function runBrowserAutomation(task, context, opts) {
       task,
       tools: BROWSER_TOOLS,
       externalTools: BROWSER_EXTERNAL_TOOLS,
-      executeTool: async (name, _input, _toolCallId, onLog) => {
+      executeTool: async (name, _input, toolCallId, onLog) => {
         if (name === "setupBrowser") {
           try {
             const result2 = await sidecarRequest(
@@ -4587,7 +4622,11 @@ async function runBrowserAutomation(task, context, opts) {
           }
         }
         if (COMMON_READ_TOOL_NAMES.has(name) || name === readSpecTool.definition.name) {
-          return executeTool(name, _input, context);
+          return executeTool(
+            name,
+            _input,
+            toolCallId ? deriveContext(context, toolCallId, onLog) : context
+          );
         }
         return `Error: unknown local tool "${name}"`;
       },
@@ -5556,7 +5595,13 @@ var copyEditorTool = {
       task: input.task,
       tools: COPY_EDITOR_TOOLS,
       externalTools: /* @__PURE__ */ new Set(),
-      executeTool: (name, toolInput) => executeTool(name, toolInput, context),
+      executeTool: (name, toolInput, toolCallId, onLog, sams) => {
+        const childCtx = toolCallId ? {
+          ...deriveContext(context, toolCallId, onLog),
+          subAgentMessages: sams
+        } : context;
+        return executeTool(name, toolInput, childCtx);
+      },
       apiConfig: context.apiConfig,
       model: resolveModel("copyEditor", context.models, context.model),
       subAgentId: "copyEditor",
@@ -5824,7 +5869,7 @@ async function executeDesignExpertTool(name, input, context, toolCallId, onLog)
   if (!tool) {
     return `Error: unknown tool "${name}"`;
   }
-  const childContext = context && toolCallId ? deriveContext(context, toolCallId) : context;
+  const childContext = context && toolCallId ? deriveContext(context, toolCallId, onLog) : context;
   return tool.execute(input, onLog, childContext);
 }
 
@@ -6045,6 +6090,38 @@ ${RENDER_TASK_BLOCK}`;
   return prompt;
 }
 
+// src/subagents/designExpert/validateWireframeRefs.ts
+import { stat as stat3 } from "fs/promises";
+import { join as join3 } 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) ?? [])];
+  if (refs.length === 0) {
+    return null;
+  }
+  const missing = [];
+  for (const ref of refs) {
+    const exists = await stat3(join3(PROJECT_ROOT, ref)).then(
+      (s) => s.isFile(),
+      () => false
+    );
+    if (!exists) {
+      missing.push(ref);
+    }
+  }
+  if (missing.length === 0) {
+    return null;
+  }
+  return [
+    `Your response references wireframe files that do not exist on disk:`,
+    ...missing.map((p) => `- ${p}`),
+    ``,
+    `A wireframe reference is only valid as a receipt handed back by a createWireframe result \u2014 that tool is the only way a wireframe comes to exist. A reference composed in prose points at nothing and renders as a dead preview.`,
+    ``,
+    `For each missing path, either author that wireframe now with createWireframe (use the matching slug so the path is identical) or remove the reference. Then send your complete final response again from the top \u2014 it fully replaces your previous response, so include everything, not just the fixes.`
+  ].join("\n");
+}
+
 // src/subagents/common/history.ts
 function getSubAgentHistory(messages, subAgentName) {
   let checkpointIdx = -1;
@@ -6112,7 +6189,10 @@ async function runDesignExpert(opts, context) {
     tools: opts.render ? DESIGN_EXPERT_RENDER_TOOLS : DESIGN_EXPERT_TOOLS,
     externalTools: /* @__PURE__ */ new Set(),
     executeTool: (name, input, toolCallId, onLog, sams) => {
-      const childCtx = toolCallId ? { ...deriveContext(context, toolCallId), subAgentMessages: sams } : { ...context, subAgentMessages: sams };
+      const childCtx = toolCallId ? {
+        ...deriveContext(context, toolCallId, onLog),
+        subAgentMessages: sams
+      } : { ...context, subAgentMessages: sams };
       if (COMMON_READ_TOOL_NAMES.has(name)) {
         return executeTool(name, input, childCtx);
       }
@@ -6130,6 +6210,10 @@ async function runDesignExpert(opts, context) {
     onEvent: context.onEvent,
     resolveExternalTool: context.resolveExternalTool,
     toolRegistry: context.toolRegistry,
+    // Receipt guard: every wireframe reference in the final response must
+    // resolve to a file on disk (see validateWireframeRefs.ts). Covers the
+    // advisor tool, render mode, and both render callers.
+    validateResult: (text) => validateWireframeRefs(text),
     background: opts.background,
     onBackgroundComplete: opts.background ? (bgResult) => {
       context.onBackgroundComplete?.(
@@ -6380,8 +6464,11 @@ var productVisionTool = {
       cachePolicy: "conversation",
       tools: VISION_TOOLS,
       externalTools: /* @__PURE__ */ new Set(),
-      executeTool: (name, input2, toolCallId, _onLog, sams) => {
-        const childCtx = toolCallId ? { ...deriveContext(context, toolCallId), subAgentMessages: sams } : { ...context, subAgentMessages: sams };
+      executeTool: (name, input2, toolCallId, onLog, sams) => {
+        const childCtx = toolCallId ? {
+          ...deriveContext(context, toolCallId, onLog),
+          subAgentMessages: sams
+        } : { ...context, subAgentMessages: sams };
         if (COMMON_READ_TOOL_NAMES.has(name)) {
           return executeTool(name, input2, childCtx);
         }
@@ -6493,7 +6580,13 @@ var codeSanityCheckTool = {
       task: input.task,
       tools: SANITY_CHECK_TOOLS,
       externalTools: /* @__PURE__ */ new Set(),
-      executeTool: (name, toolInput) => executeTool(name, toolInput, context),
+      executeTool: (name, toolInput, toolCallId, onLog, sams) => {
+        const childCtx = toolCallId ? {
+          ...deriveContext(context, toolCallId, onLog),
+          subAgentMessages: sams
+        } : context;
+        return executeTool(name, toolInput, childCtx);
+      },
       apiConfig: context.apiConfig,
       model: resolveModel("codeSanityCheck", context.models, context.model),
       subAgentId: "codeSanityCheck",
@@ -6703,16 +6796,19 @@ After reconciling the spec, refresh the Build Overview: author the complete upda
       task,
       tools: tools2,
       externalTools: /* @__PURE__ */ new Set(),
-      executeTool: (name, toolInput, toolCallId, _onLog, sams) => {
+      executeTool: (name, toolInput, toolCallId, onLog, sams) => {
+        const childCtx = toolCallId ? {
+          ...deriveContext(context, toolCallId, onLog),
+          subAgentMessages: sams
+        } : { ...context, subAgentMessages: sams };
         if (name === "writeBuildOverview") {
-          const childCtx = toolCallId ? { ...deriveContext(context, toolCallId), subAgentMessages: sams } : { ...context, subAgentMessages: sams };
           return renderBuildOverview(
             String(toolInput.content ?? "").trim(),
             childCtx,
             { background: false }
           );
         }
-        return executeTool(name, toolInput, context);
+        return executeTool(name, toolInput, childCtx);
       },
       apiConfig: context.apiConfig,
       model: resolveModel("specSync", context.models, context.model),
@@ -6786,8 +6882,8 @@ var scrapeWebUrlTool = {
 };
 
 // src/tools/index.ts
-function deriveContext(parent, toolCallId) {
-  return { ...parent, toolCallId };
+function deriveContext(parent, toolCallId, onLog) {
+  return { ...parent, toolCallId, onLog };
 }
 var ALL_TOOLS = [
   // Common
@@ -9058,7 +9154,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 join3, extname as extname2 } from "path";
+import { basename as basename2, join as join4, extname as extname2 } from "path";
 var log16 = createLogger("headless:attachments");
 var UPLOADS_DIR = "src/.user-uploads";
 function filenameFromUrl(url) {
@@ -9071,7 +9167,7 @@ function filenameFromUrl(url) {
   }
 }
 function resolveUniqueFilename(name, claimed) {
-  const isFree = (candidate) => !claimed.has(candidate) && !existsSync(join3(UPLOADS_DIR, candidate));
+  const isFree = (candidate) => !claimed.has(candidate) && !existsSync(join4(UPLOADS_DIR, candidate));
   if (isFree(name)) {
     return name;
   }
@@ -9106,7 +9202,7 @@ async function persistAttachments(attachments) {
   const results = await Promise.allSettled(
     nonVoice.map(async (att, i) => {
       const name = names[i];
-      const localPath = join3(UPLOADS_DIR, name);
+      const localPath = join4(UPLOADS_DIR, name);
       const res = await fetch(att.url, {
         signal: AbortSignal.timeout(3e4)
       });

package/dist/index.js

@@ -1379,7 +1379,7 @@ var init_sdkConsultant = __esm({
       async execute(input, context) {
         const query = input.query;
         const result = await runCli("mindstudio", ["ask", query], {
-          timeout: 2e5,
+          timeout: 48e4,
           maxBuffer: 512 * 1024,
           onLog: context?.onLog
         });
@@ -1660,9 +1660,9 @@ function buildBackgroundResultsMessage(results) {
 ${r.result}
 </tool_result>`
   ).join("\n\n");
-  const plural = results.length > 1 ? "s" : "";
-  const body = `This is an automated message containing the result${plural} of ${results.length > 1 ? "tool calls" : "a tool call"} that ${results.length > 1 ? "have" : "has"} been working in the background. This is not a direct message from the user.
-<background_results>
+  const body = `<background_results>
+Automated delivery of results from background tool calls that completed while other work was in progress. This block is not from the user \u2014 anything outside it is.
+
 ${xml}
 </background_results>`;
   return automatedMessage("background_results", body);
@@ -3905,8 +3905,8 @@ function formatSize(bytes) {
 }
 async function formatFile(dirPath, name, indent) {
   try {
-    const stat3 = await fs15.stat(path8.join(dirPath, name));
-    return `${indent}${name}${" ".repeat(Math.max(1, 30 - indent.length - name.length))}${formatSize(stat3.size)}`;
+    const stat4 = await fs15.stat(path8.join(dirPath, name));
+    return `${indent}${name}${" ".repeat(Math.max(1, 30 - indent.length - name.length))}${formatSize(stat4.size)}`;
   } catch {
     return `${indent}${name}`;
   }
@@ -4822,6 +4822,7 @@ async function runSubAgent(config) {
     acquireLock,
     onBackgroundComplete,
     captureArtifacts,
+    validateResult,
     cachePolicy = "run"
   } = config;
   const artifacts = {};
@@ -4842,6 +4843,7 @@ async function runSubAgent(config) {
 
 Current date: ${dateStr}`;
   let turns = 0;
+  let validationRetried = false;
   const run = async () => {
     const historyLen = (history ?? []).length;
     const subAgentMessages = /* @__PURE__ */ new Map();
@@ -5045,8 +5047,41 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
           (b) => b.type === "tool"
         );
         if (stopReason !== "tool_use" || toolCalls.length === 0) {
+          let text = getPartialText(contentBlocks);
+          if (validateResult) {
+            let objection = null;
+            try {
+              objection = await validateResult(text, thisInvocation());
+            } catch (err) {
+              log8.warn("Result validator failed, accepting response", {
+                requestId,
+                parentToolId,
+                agentName,
+                error: err.message
+              });
+            }
+            if (objection && !validationRetried && !signal?.aborted) {
+              validationRetried = true;
+              log8.info("Result rejected by validator, retrying once", {
+                requestId,
+                parentToolId,
+                agentName,
+                objection: objection.slice(0, 200)
+              });
+              emit({
+                type: "status",
+                message: "Response failed validation, revising"
+              });
+              messages.push({ role: "user", content: objection });
+              continue;
+            }
+            if (objection) {
+              text = `${text}
+
+[Response validator: ${objection}]`;
+            }
+          }
           statusWatcher.stop();
-          const text = getPartialText(contentBlocks);
           const hasArtifacts = Object.keys(artifacts).length > 0;
           return {
             text,
@@ -5648,7 +5683,7 @@ async function runBrowserAutomation(task, context, opts) {
       task,
       tools: BROWSER_TOOLS,
       externalTools: BROWSER_EXTERNAL_TOOLS,
-      executeTool: async (name, _input, _toolCallId, onLog) => {
+      executeTool: async (name, _input, toolCallId, onLog) => {
         if (name === "setupBrowser") {
           try {
             const result2 = await sidecarRequest(
@@ -5665,7 +5700,11 @@ async function runBrowserAutomation(task, context, opts) {
           }
         }
         if (COMMON_READ_TOOL_NAMES.has(name) || name === readSpecTool.definition.name) {
-          return executeTool(name, _input, context);
+          return executeTool(
+            name,
+            _input,
+            toolCallId ? deriveContext(context, toolCallId, onLog) : context
+          );
         }
         return `Error: unknown local tool "${name}"`;
       },
@@ -6752,7 +6791,13 @@ var init_copyEditor = __esm({
           task: input.task,
           tools: COPY_EDITOR_TOOLS,
           externalTools: /* @__PURE__ */ new Set(),
-          executeTool: (name, toolInput) => executeTool(name, toolInput, context),
+          executeTool: (name, toolInput, toolCallId, onLog, sams) => {
+            const childCtx = toolCallId ? {
+              ...deriveContext(context, toolCallId, onLog),
+              subAgentMessages: sams
+            } : context;
+            return executeTool(name, toolInput, childCtx);
+          },
           apiConfig: context.apiConfig,
           model: resolveModel("copyEditor", context.models, context.model),
           subAgentId: "copyEditor",
@@ -7034,7 +7079,7 @@ async function executeDesignExpertTool(name, input, context, toolCallId, onLog)
   if (!tool) {
     return `Error: unknown tool "${name}"`;
   }
-  const childContext = context && toolCallId ? deriveContext(context, toolCallId) : context;
+  const childContext = context && toolCallId ? deriveContext(context, toolCallId, onLog) : context;
   return tool.execute(input, onLog, childContext);
 }
 var tools, DESIGN_EXPERT_TOOLS;
@@ -7403,6 +7448,45 @@ 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";
+async function validateWireframeRefs(text) {
+  const refs = [...new Set(text.match(WIREFRAME_REF_RE) ?? [])];
+  if (refs.length === 0) {
+    return null;
+  }
+  const missing = [];
+  for (const ref of refs) {
+    const exists = await stat3(join3(PROJECT_ROOT, ref)).then(
+      (s) => s.isFile(),
+      () => false
+    );
+    if (!exists) {
+      missing.push(ref);
+    }
+  }
+  if (missing.length === 0) {
+    return null;
+  }
+  return [
+    `Your response references wireframe files that do not exist on disk:`,
+    ...missing.map((p) => `- ${p}`),
+    ``,
+    `A wireframe reference is only valid as a receipt handed back by a createWireframe result \u2014 that tool is the only way a wireframe comes to exist. A reference composed in prose points at nothing and renders as a dead preview.`,
+    ``,
+    `For each missing path, either author that wireframe now with createWireframe (use the matching slug so the path is identical) or remove the reference. Then send your complete final response again from the top \u2014 it fully replaces your previous response, so include everything, not just the fixes.`
+  ].join("\n");
+}
+var WIREFRAME_REF_RE;
+var init_validateWireframeRefs = __esm({
+  "src/subagents/designExpert/validateWireframeRefs.ts"() {
+    "use strict";
+    init_projectRoot();
+    WIREFRAME_REF_RE = /src\/\.wireframes\/[a-z0-9][a-z0-9-]*\.html/g;
+  }
+});
+
 // src/subagents/common/history.ts
 function getSubAgentHistory(messages, subAgentName) {
   let checkpointIdx = -1;
@@ -7466,7 +7550,10 @@ async function runDesignExpert(opts, context) {
     tools: opts.render ? DESIGN_EXPERT_RENDER_TOOLS : DESIGN_EXPERT_TOOLS,
     externalTools: /* @__PURE__ */ new Set(),
     executeTool: (name, input, toolCallId, onLog, sams) => {
-      const childCtx = toolCallId ? { ...deriveContext(context, toolCallId), subAgentMessages: sams } : { ...context, subAgentMessages: sams };
+      const childCtx = toolCallId ? {
+        ...deriveContext(context, toolCallId, onLog),
+        subAgentMessages: sams
+      } : { ...context, subAgentMessages: sams };
       if (COMMON_READ_TOOL_NAMES.has(name)) {
         return executeTool(name, input, childCtx);
       }
@@ -7484,6 +7571,10 @@ async function runDesignExpert(opts, context) {
     onEvent: context.onEvent,
     resolveExternalTool: context.resolveExternalTool,
     toolRegistry: context.toolRegistry,
+    // Receipt guard: every wireframe reference in the final response must
+    // resolve to a file on disk (see validateWireframeRefs.ts). Covers the
+    // advisor tool, render mode, and both render callers.
+    validateResult: (text) => validateWireframeRefs(text),
     background: opts.background,
     onBackgroundComplete: opts.background ? (bgResult) => {
       context.onBackgroundComplete?.(
@@ -7507,6 +7598,7 @@ var init_designExpert = __esm({
     init_tools4();
     init_tools();
     init_prompt2();
+    init_validateWireframeRefs();
     init_history();
     init_surfaces();
     init_writeFile();
@@ -7794,8 +7886,11 @@ var init_productVision = __esm({
           cachePolicy: "conversation",
           tools: VISION_TOOLS,
           externalTools: /* @__PURE__ */ new Set(),
-          executeTool: (name, input2, toolCallId, _onLog, sams) => {
-            const childCtx = toolCallId ? { ...deriveContext(context, toolCallId), subAgentMessages: sams } : { ...context, subAgentMessages: sams };
+          executeTool: (name, input2, toolCallId, onLog, sams) => {
+            const childCtx = toolCallId ? {
+              ...deriveContext(context, toolCallId, onLog),
+              subAgentMessages: sams
+            } : { ...context, subAgentMessages: sams };
             if (COMMON_READ_TOOL_NAMES.has(name)) {
               return executeTool(name, input2, childCtx);
             }
@@ -7926,7 +8021,13 @@ var init_codeSanityCheck = __esm({
           task: input.task,
           tools: SANITY_CHECK_TOOLS,
           externalTools: /* @__PURE__ */ new Set(),
-          executeTool: (name, toolInput) => executeTool(name, toolInput, context),
+          executeTool: (name, toolInput, toolCallId, onLog, sams) => {
+            const childCtx = toolCallId ? {
+              ...deriveContext(context, toolCallId, onLog),
+              subAgentMessages: sams
+            } : context;
+            return executeTool(name, toolInput, childCtx);
+          },
           apiConfig: context.apiConfig,
           model: resolveModel("codeSanityCheck", context.models, context.model),
           subAgentId: "codeSanityCheck",
@@ -8173,16 +8274,19 @@ After reconciling the spec, refresh the Build Overview: author the complete upda
           task,
           tools: tools2,
           externalTools: /* @__PURE__ */ new Set(),
-          executeTool: (name, toolInput, toolCallId, _onLog, sams) => {
+          executeTool: (name, toolInput, toolCallId, onLog, sams) => {
+            const childCtx = toolCallId ? {
+              ...deriveContext(context, toolCallId, onLog),
+              subAgentMessages: sams
+            } : { ...context, subAgentMessages: sams };
             if (name === "writeBuildOverview") {
-              const childCtx = toolCallId ? { ...deriveContext(context, toolCallId), subAgentMessages: sams } : { ...context, subAgentMessages: sams };
               return renderBuildOverview(
                 String(toolInput.content ?? "").trim(),
                 childCtx,
                 { background: false }
               );
             }
-            return executeTool(name, toolInput, context);
+            return executeTool(name, toolInput, childCtx);
           },
           apiConfig: context.apiConfig,
           model: resolveModel("specSync", context.models, context.model),
@@ -8266,8 +8370,8 @@ var init_scrapeWebUrl2 = __esm({
 });
 
 // src/tools/index.ts
-function deriveContext(parent, toolCallId) {
-  return { ...parent, toolCallId };
+function deriveContext(parent, toolCallId, onLog) {
+  return { ...parent, toolCallId, onLog };
 }
 function getToolDefinitions() {
   return ALL_TOOLS.map((t) => t.definition);
@@ -9986,7 +10090,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 join3, extname as extname2 } from "path";
+import { basename as basename2, join as join4, extname as extname2 } from "path";
 function filenameFromUrl(url) {
   try {
     const pathname = new URL(url).pathname;
@@ -9997,7 +10101,7 @@ function filenameFromUrl(url) {
   }
 }
 function resolveUniqueFilename(name, claimed) {
-  const isFree = (candidate) => !claimed.has(candidate) && !existsSync(join3(UPLOADS_DIR, candidate));
+  const isFree = (candidate) => !claimed.has(candidate) && !existsSync(join4(UPLOADS_DIR, candidate));
   if (isFree(name)) {
     return name;
   }
@@ -10031,7 +10135,7 @@ async function persistAttachments(attachments) {
   const results = await Promise.allSettled(
     nonVoice.map(async (att, i) => {
       const name = names[i];
-      const localPath = join3(UPLOADS_DIR, name);
+      const localPath = join4(UPLOADS_DIR, name);
       const res = await fetch(att.url, {
         signal: AbortSignal.timeout(3e4)
       });

package/dist/subagents/codeSanityCheck/prompt.md

@@ -38,7 +38,8 @@ These are things we already know about and have decided to accept:
 - Preferences:
   - use [wouter](https://github.com/molefrog/wouter) for React routing instead of reaching for react-router
   - uploading user files should always happen via `platform.uploadFile()` from `@mindstudio-ai/interface` — not custom S3 code, not FormData to a method endpoint
-  - for static prerendering of Vite + React sites, roll your own with a post-build `renderToString` script — do not use `vite-prerender-plugin` (it bundles the prerender script as a client chunk, adding ~800KB to the user-facing bundle with no way to prevent it)
+  - for build-time prerendering of purely static sites (marketing pages with no dynamic content — distinct from the platform's crawler prerendering, below), roll your own with a post-build `renderToString` script — do not use `vite-prerender-plugin` (it bundles the prerender script as a client chunk, adding ~800KB to the user-facing bundle with no way to prevent it)
+  - **Prerendering for crawlers/unfurlers is a platform feature — don't design around it.** For SEO / link-unfurl / AI-crawler visibility on a non-static SPA, the platform already handles it: routes opt in via `web.json` (`{ "web": { "prerender": { "paths": ["/blog/*"] } } }`), the SPA signals readiness by setting `data-prerender-ready` on the html element, deploys invalidate the snapshot cache automatically, and content that changes outside deploys is invalidated at runtime with `await prerender.invalidate([...])` from `@mindstudio-ai/agent` (called from the mutating method). It serves cached headless snapshots of the live SPA to bots — it is NOT build-time rendering. Do not recommend post-build render scripts, rebuild-on-content-change, or third-party prerender services for this. The developer's main context carries the full interfaces reference with exact semantics — tell them to consult it rather than improvising.
 
 ### Common pitfalls (always flag these)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindstudio-ai/remy",
-  "version": "0.1.299",
+  "version": "0.1.301",
   "description": "Remy coding agent",
   "repository": {
     "type": "git",