@mindstudio-ai/remy 0.1.300 → 0.1.302

package/dist/headless.js

@@ -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,
@@ -6055,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;
@@ -6143,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?.(
@@ -9083,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) {
@@ -9096,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;
   }
@@ -9131,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

@@ -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,
@@ -7413,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;
@@ -7497,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?.(
@@ -7520,6 +7598,7 @@ var init_designExpert = __esm({
     init_tools4();
     init_tools();
     init_prompt2();
+    init_validateWireframeRefs();
     init_history();
     init_surfaces();
     init_writeFile();
@@ -10011,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;
@@ -10022,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;
   }
@@ -10056,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/prompt/skills/dataSources.md

@@ -31,13 +31,13 @@ const { results } = await Policies.search('what are the payment terms?', { topK:
 const context = results.map((r) => r.text).join('\n\n');
 ```
 
-Hits are `{ score, text, citation }` with `citation: { documentId, filename, pageNumber, chunkIndex, headingPath, boundingBox?, url }`, plus `retrievalRank`/`retrievalScore` — the position before reranking, so you can show what reranking did.
+Hits are `{ score, text, citation }` with `citation: { documentId, filename, pageNumber, chunkIndex, headingPath, boundingBox?, url }`, plus `retrievalRank`/`retrievalScore` — the position before reranking, so you can show what reranking did. With reranking on (the default) `score` is the reranker's 0–1 relevance and the right place for quality cutoffs; without it the scale varies by mode (cosine / rank-fusion / keyword overlap). `scoreThreshold` floors the retrieval branch before fusion and reranking — leave it unset unless measured on the corpus.
 
 **Always render the citation.** `citation.url` is a stable on-domain link — put it in an `<a href>` beside the answer. Retrieval is approximate; a user who can click through can judge for themselves. An answer with no citation is an assertion.
 
 Created on first use, so searching a source the build hasn't populated returns no results rather than throwing. `search` options: `topK` (default 5, max 50), `scoreThreshold`, `filter`, `mode`, `maxPerDocument`, `highlight`, `rerank`, `hybrid`.
 
-**Filtering** narrows a search before ranking, and every condition only narrows: `filter: { metadata: { department: 'legal', year: [2025, 2026] }, filename, documentIds, pages: { min?, max? }, contains: 'all these words', phrase: 'exact adjacent sequence' }`. Metadata is tagged at add time (scalars only, ≤16 keys); re-adding the same bytes with different metadata updates the tags in place, free. Filters are the right tool for scoping retrieval (per-user, per-category); they are NOT a substitute for a `db` query over structured data.
+**Filtering** narrows a search before ranking, and every condition only narrows: `filter: { metadata: { department: 'legal', year: [2025, 2026], signedAt: { gte: 20250101 } }, filename, documentIds, pages: { min?, max? }, contains: 'all these words', phrase: 'exact adjacent sequence' }`. Metadata matches per key: scalar = equals, array = any-of, `{ gte?, lte? }` = numeric range — ranges are numeric only, so store dates as sortable integers at add time (YYYYMMDD or epoch seconds) to range on them. Metadata is tagged at add time (scalars only, ≤16 keys); re-adding the same bytes with different metadata updates the tags in place, free. Filters are the right tool for scoping retrieval (per-user, per-category, a date window); they are NOT a substitute for a `db` query over structured data.
 
 **Modes**: `mode: 'hybrid'` (default) fuses semantic and keyword retrieval; `'semantic'` is the embedding alone; `'lexical'` is keyword-only with **no query embedding** — cheapest and fastest, right when the query is an identifier (an error code, a SKU, a name) rather than a meaning. `maxPerDocument: 2` stops one document monopolizing the results when the answer should draw on several. `highlight: true` adds `matches` (`{start, end}` offsets into `text`) for rendering highlighted excerpts.
 
@@ -84,7 +84,7 @@ Retrieve → join passages as context → have a model answer *from that context
 | Kind | Settings | Cost |
 |---|---|---|
 | **Free** (ranking) | `--rerank`, `--rerank-model`, `--hybrid`, `--top-k` | none, next search |
-| **Rebuild** (how docs become vectors) | `--max-chars`, `--min-chars`, `--drop-blocks`, `--contextual`, `--describe-images`, `--embedding-model`, `--extraction-model` | every document reprocessed |
+| **Rebuild** (how docs become vectors) | `--max-chars`, `--min-chars`, `--drop-blocks`, `--contextual`, `--contextual-model`, `--describe-images`, `--embedding-model`, `--extraction-model` | every document reprocessed |
 
 Images inside documents are described by a vision model and the description substituted into the searchable text (`--describe-images`, on by default) — without it a chart contributes nothing to search at all. Documents with no images cost nothing.
 

package/package.json

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