@mindstudio-ai/remy 0.1.127 → 0.1.128

package/dist/headless.js

@@ -3511,6 +3511,92 @@ var screenshotTool = {
   }
 };
 
+// src/subagents/common/tools.ts
+var COMMON_READ_TOOLS = [
+  {
+    name: "readFile",
+    description: "Read a file's contents with line numbers. Always read a file before editing it \u2014 never guess at contents. For large files, consider using symbols first to identify the relevant section, then use offset and maxLines to read just that section. Line numbers in the output correspond to what editFile expects. Defaults to first 500 lines. Use a negative offset to read from the end of the file (e.g., offset: -50 reads the last 50 lines).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: "The file path to read, relative to the project root."
+        },
+        offset: {
+          type: "number",
+          description: "Line number to start reading from (1-indexed). Use a negative number to read from the end (e.g., -50 reads the last 50 lines). Defaults to 1."
+        },
+        maxLines: {
+          type: "number",
+          description: "Maximum number of lines to return. Defaults to 500. Set to 0 for no limit."
+        }
+      },
+      required: ["path"]
+    }
+  },
+  {
+    name: "listDir",
+    description: "List the contents of a directory with one level of subdirectory expansion. Shows file sizes and collapses single-child directory chains (a/b/c/ shown as one entry). Use this for a quick overview of a directory's structure. For finding files across the whole project, use glob instead.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: 'Directory path to list, relative to project root. Defaults to ".".'
+        }
+      }
+    }
+  },
+  {
+    name: "grep",
+    description: "Search file contents for a regex pattern. Returns matching lines with file paths and line numbers (default 50 results). Use this to find where something is used, locate function definitions, or search for patterns across the codebase. For finding a symbol's definition precisely, prefer the definition tool if LSP is available. Automatically excludes node_modules and .git.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        pattern: {
+          type: "string",
+          description: "The search pattern (regex supported)."
+        },
+        path: {
+          type: "string",
+          description: "Directory or file to search in. Defaults to current directory."
+        },
+        glob: {
+          type: "string",
+          description: 'File glob to filter (e.g., "*.ts"). Only used with ripgrep.'
+        },
+        maxResults: {
+          type: "number",
+          description: "Maximum number of matching lines to return. Defaults to 50. Increase if you need more comprehensive results."
+        }
+      },
+      required: ["pattern"]
+    }
+  },
+  {
+    name: "glob",
+    description: 'Find files matching a glob pattern. Returns matching file paths sorted alphabetically (default 200 results). Use this to discover project structure, find files by name or extension, or check if a file exists. Common patterns: "**/*.ts" (all TypeScript files), "src/**/*.tsx" (React components in src), "*.json" (root-level JSON files). Automatically excludes node_modules and .git.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        pattern: {
+          type: "string",
+          description: 'Glob pattern (e.g., "**/*.ts", "src/**/*.tsx", "*.json").'
+        },
+        maxResults: {
+          type: "number",
+          description: "Maximum number of file paths to return. Defaults to 200. Increase if you need the complete list."
+        }
+      },
+      required: ["pattern"]
+    }
+  }
+];
+var COMMON_READ_TOOL_NAMES = new Set(
+  COMMON_READ_TOOLS.map((t) => t.name)
+);
+
 // src/subagents/designExpert/tools/searchGoogle.ts
 var searchGoogle_exports = {};
 __export(searchGoogle_exports, {
@@ -4006,9 +4092,10 @@ var tools = {
   generateImages: generateImages_exports,
   editImages: editImages_exports
 };
-var DESIGN_EXPERT_TOOLS = Object.values(tools).map(
-  (t) => t.definition
-);
+var DESIGN_EXPERT_TOOLS = [
+  ...COMMON_READ_TOOLS,
+  ...Object.values(tools).map((t) => t.definition)
+];
 async function executeDesignExpertTool(name, input, context, toolCallId, onLog) {
   const tool = tools[name];
   if (!tool) {
@@ -4036,32 +4123,101 @@ function walkMdFiles2(dir, skip) {
     }
   } catch {
   }
-  return files;
+  return files.sort();
+}
+function parseFrontmatter2(filePath) {
+  try {
+    const content = fs14.readFileSync(filePath, "utf-8");
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) {
+      return {};
+    }
+    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();
+        fm[key] = val;
+      }
+    }
+    return fm;
+  } catch {
+    return {};
+  }
 }
-function loadFilesAsXml(dir, tag, skip) {
-  const files = walkMdFiles2(dir, skip);
+function loadSpecIndex() {
+  const files = walkMdFiles2("src", /* @__PURE__ */ new Set(["roadmap"]));
   if (files.length === 0) {
     return "";
   }
-  const sections = files.map((f) => {
-    try {
-      const content = fs14.readFileSync(f, "utf-8").trim();
-      return `<file path="${f}">
-${content}
-</file>`;
-    } catch {
-      return "";
+  const lines = files.map((f) => {
+    const fm = parseFrontmatter2(f);
+    let line = `- ${f}`;
+    if (fm.name) {
+      line += ` \u2014 "${fm.name}"`;
     }
-  }).filter(Boolean);
-  return `<${tag}>
-${sections.join("\n\n")}
-</${tag}>`;
-}
-function loadSpecContext() {
-  return loadFilesAsXml("src", "spec_files", /* @__PURE__ */ new Set(["roadmap"]));
+    if (fm.description) {
+      line += ` \u2014 ${fm.description}`;
+    }
+    return line;
+  });
+  return `<spec_files>
+## Project Spec Files
+Use readFile to access full contents.
+
+${lines.join("\n")}
+</spec_files>`;
 }
-function loadRoadmapContext() {
-  return loadFilesAsXml("src/roadmap", "current_roadmap");
+function loadRoadmapIndex() {
+  const parts = [];
+  try {
+    const indexJson = JSON.parse(
+      fs14.readFileSync("src/roadmap/index.json", "utf-8")
+    );
+    if (indexJson.lanes?.length > 0) {
+      const laneLines = indexJson.lanes.map(
+        (l) => `- **${l.name}**: ${l.narrative || ""} (${l.items?.length || 0} items)`
+      );
+      parts.push(`### Lanes
+${laneLines.join("\n")}`);
+    }
+    if (indexJson.standalone?.length > 0) {
+      parts.push(
+        `### Standalone
+${indexJson.standalone.map((s) => `- ${s}`).join("\n")}`
+      );
+    }
+  } catch {
+  }
+  const files = walkMdFiles2("src/roadmap");
+  if (files.length > 0) {
+    const lines = files.map((f) => {
+      const fm = parseFrontmatter2(f);
+      let line = `- ${f}`;
+      if (fm.name) {
+        line += ` \u2014 "${fm.name}"`;
+      }
+      if (fm.status) {
+        line += ` (${fm.status})`;
+      }
+      if (fm.description) {
+        line += ` \u2014 ${fm.description}`;
+      }
+      return line;
+    });
+    parts.push(`### Items
+${lines.join("\n")}`);
+  }
+  if (parts.length === 0) {
+    return "";
+  }
+  return `<current_roadmap>
+## Roadmap
+Use readFile to access full contents.
+
+${parts.join("\n\n")}
+</current_roadmap>`;
 }
 function loadPlatformBrief() {
   return `<platform_brief>
@@ -4262,7 +4418,7 @@ var PROMPT_TEMPLATE = readAsset(SUBAGENT, "prompt.md").replace(/\{\{([^}]+)\}\}/
   return RUNTIME_PLACEHOLDERS.has(k) ? match : readAsset(SUBAGENT, k);
 }).replace(/\n{3,}/g, "\n\n");
 function getDesignExpertPrompt(onboardingState) {
-  const specContext = loadSpecContext();
+  const specContext = loadSpecIndex();
   const indices = getSampleIndices(
     {
       uiInspiration: uiScreens.length,
@@ -4381,7 +4537,13 @@ var designExpertTool = {
       history: history.length > 0 ? history : void 0,
       tools: DESIGN_EXPERT_TOOLS,
       externalTools: /* @__PURE__ */ new Set(),
-      executeTool: (name, input2, toolCallId, onLog) => executeDesignExpertTool(name, input2, context, toolCallId, onLog),
+      executeTool: (name, input2, toolCallId, onLog) => {
+        if (COMMON_READ_TOOL_NAMES.has(name)) {
+          const childCtx = toolCallId ? deriveContext(context, toolCallId) : context;
+          return executeTool(name, input2, childCtx);
+        }
+        return executeDesignExpertTool(name, input2, context, toolCallId, onLog);
+      },
       apiConfig: context.apiConfig,
       model: context.model,
       subAgentId: "visualDesignExpert",
@@ -4408,28 +4570,7 @@ var designExpertTool = {
 
 // src/subagents/productVision/tools.ts
 var VISION_TOOLS = [
-  {
-    name: "listDir",
-    description: "List files in src/roadmap/.",
-    inputSchema: {
-      type: "object",
-      properties: {}
-    }
-  },
-  {
-    name: "readFile",
-    description: 'Read a file from src/roadmap/. Path is relative to src/roadmap/ (e.g. "index.json", "mute.md").',
-    inputSchema: {
-      type: "object",
-      properties: {
-        path: {
-          type: "string",
-          description: "File path relative to src/roadmap/."
-        }
-      },
-      required: ["path"]
-    }
-  },
+  ...COMMON_READ_TOOLS,
   {
     name: "writeFile",
     description: 'Create or overwrite a file in src/roadmap/. Path is relative to src/roadmap/ (e.g. "index.json", "ai-weekly-digest.md").',
@@ -4482,42 +4623,15 @@ var VISION_TOOLS = [
 import fs16 from "fs";
 import path9 from "path";
 var ROADMAP_DIR = "src/roadmap";
+var PITCH_DECK_SHELL = readAsset(
+  "subagents/productVision",
+  "pitch-deck-shell.html"
+);
 function resolve(filePath) {
   return path9.join(ROADMAP_DIR, filePath);
 }
 async function executeVisionTool(name, input, context) {
   switch (name) {
-    case "listDir": {
-      try {
-        fs16.mkdirSync(ROADMAP_DIR, { recursive: true });
-        const entries = fs16.readdirSync(ROADMAP_DIR, { withFileTypes: true });
-        const lines = [];
-        const dirs = entries.filter((e) => e.isDirectory()).sort((a, b) => a.name.localeCompare(b.name));
-        const files = entries.filter((e) => !e.isDirectory()).sort((a, b) => a.name.localeCompare(b.name));
-        for (const d of dirs) {
-          lines.push(`${d.name}/`);
-        }
-        for (const f of files) {
-          const stat = fs16.statSync(resolve(f.name));
-          const size = stat.size < 1024 ? `${stat.size}B` : `${(stat.size / 1024).toFixed(1)}KB`;
-          lines.push(`${f.name}  (${size})`);
-        }
-        return lines.length > 0 ? lines.join("\n") : "(empty)";
-      } catch (err) {
-        return `Error: ${err.message}`;
-      }
-    }
-    case "readFile": {
-      const filePath = resolve(input.path);
-      try {
-        const content = fs16.readFileSync(filePath, "utf-8");
-        const lines = content.split("\n");
-        const numbered = lines.map((line, i) => `${String(i + 1).padStart(4)} ${line}`).join("\n");
-        return numbered;
-      } catch (err) {
-        return `Error reading ${filePath}: ${err.message}`;
-      }
-    }
     case "writeFile": {
       const filePath = resolve(input.path);
       try {
@@ -4557,31 +4671,26 @@ ${unifiedDiff(filePath, oldContent, "")}`;
       const filePath = resolve("pitch.html");
       try {
         fs16.mkdirSync(ROADMAP_DIR, { recursive: true });
-        const existingHtml = fs16.existsSync(filePath) ? fs16.readFileSync(filePath, "utf-8").trim() : "";
-        let task = `
+        const existing = fs16.existsSync(filePath) ? fs16.readFileSync(filePath, "utf-8").trim() : "";
+        const currentDeck = existing || PITCH_DECK_SHELL;
+        const task = `
 <pitch_content>${input.task}</pitch_content>
 
-We are building the pitch deck for the app. Using the provided <pitch_content>, as well as the app's spec data, think about what would make a compelling, interactive, self-contained horizontally-scrolling HTML slide deck for this product. Keep it simple, clean, powerful. Giant text, large logo, big, bold stats and claims. Edit the content as necessary to create the most impactful, bold, and beautiful slides. This should not feel text heavy, and it should not feel like a landing page - it should feel like a modern interactive presentation that leaves the user wowed by the product.
+<current_deck>${currentDeck}</current_deck>
 
-### Rules
-- The deck must be a single HTML file - it will be rendered in an iFrame.
-- Keep it simple: 100svh 100vw slides that scroll horizontally using browser scrolling. Must look beautiful on desktop and mobile - use all the principles you know about designing effective landing pages to make a beautiful deck.
-- The deck must support keyboard navigation left and right, and big clickable arrows to transition.
-- Animation between slides must be seamless, no flicker or flashing.
-- Be bold and impactful. Do not be wordy or verbose, no one reads decks with too many words.
-- Keep it simple: 5-7 slides max. No fluff, just imapct.
-- Code must be clean, bug free, and easy-to-parse. Use GSAP for animations.
-`;
-        if (existingHtml) {
-          task += `
+We are building the pitch deck for the app. Using the provided <pitch_content>, as well as the app's spec data, think about what would make a compelling, interactive, self-contained horizontally-scrolling HTML slide deck for this product. Keep it simple, clean, powerful. Giant text, large logo, big, bold stats and claims. Edit the content as necessary to create the most impactful, bold, and beautiful slides. This should not feel like an essay, and it should not feel like a landing page \u2014 it should feel like a modern interactive presentation that leaves the user wowed by the product and excited about its future.
 
-The current pitch deck HTML is below. Refine and update it rather than starting from scratch \u2014 preserve the existing design and structure where it still works, and update the content and slides to reflect the new pitch.
+Use <current_deck> as your starting point and replace or update the content as needed, maintaining the bones of the presentation scaffolding.
 
-<existing_pitch_html>${existingHtml}</existing_pitch_html>`;
-        }
-        task += `
+### Rules
+- The deck must be a single HTML file \u2014 it will be rendered in an iframe.
+- Must look beautiful on desktop and mobile.
+- Animation between slides must be seamless, no flicker or flashing.
+- Be bold and impactful.
+- 6-8 slides max. No fluff, just impact.
+- Code must be clean, bug free, and easy to parse. Use GSAP for animations.
 
-Respond only with the HTML of the deck as a single fenced markdown block and absolutely no other text - your response will be written directly to a file.`;
+Respond only with the complete HTML file and absolutely no other text. Your response will be written directly to an html file.`;
         const result = await designExpertTool.execute({ task }, context);
         const htmlMatch = result.match(
           /```(?:html|wireframe)\n([\s\S]*?)```/
@@ -4605,15 +4714,15 @@ ${unifiedDiff(filePath, oldContent, html)}`;
 // src/subagents/productVision/prompt.ts
 var BASE_PROMPT2 = readAsset("subagents/productVision", "prompt.md");
 function getProductVisionPrompt() {
-  const specContext = loadSpecContext();
-  const roadmapContext = loadRoadmapContext();
+  const specIndex = loadSpecIndex();
+  const roadmapIndex = loadRoadmapIndex();
   const parts = [BASE_PROMPT2, loadPlatformBrief()];
   parts.push("<!-- cache_breakpoint -->");
-  if (specContext) {
-    parts.push(specContext);
+  if (specIndex) {
+    parts.push(specIndex);
   }
-  if (roadmapContext) {
-    parts.push(roadmapContext);
+  if (roadmapIndex) {
+    parts.push(roadmapIndex);
   }
   return parts.join("\n\n");
 }
@@ -4650,11 +4759,13 @@ var productVisionTool = {
       history: history.length > 0 ? history : void 0,
       tools: VISION_TOOLS,
       externalTools: /* @__PURE__ */ new Set(),
-      executeTool: (name, input2, toolCallId) => executeVisionTool(
-        name,
-        input2,
-        toolCallId ? deriveContext(context, toolCallId) : context
-      ),
+      executeTool: (name, input2, toolCallId) => {
+        const childCtx = toolCallId ? deriveContext(context, toolCallId) : context;
+        if (COMMON_READ_TOOL_NAMES.has(name)) {
+          return executeTool(name, input2, childCtx);
+        }
+        return executeVisionTool(name, input2, childCtx);
+      },
       apiConfig: context.apiConfig,
       model: context.model,
       subAgentId: "productVision",
@@ -4681,49 +4792,7 @@ var productVisionTool = {
 
 // src/subagents/codeSanityCheck/tools.ts
 var SANITY_CHECK_TOOLS = [
-  {
-    name: "readFile",
-    description: "Read a file from the project.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        path: {
-          type: "string",
-          description: "File path relative to project root."
-        }
-      },
-      required: ["path"]
-    }
-  },
-  {
-    name: "grep",
-    description: "Search file contents for a pattern.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        pattern: { type: "string", description: "Search pattern (regex)." },
-        path: {
-          type: "string",
-          description: "Directory or file to search in."
-        }
-      },
-      required: ["pattern"]
-    }
-  },
-  {
-    name: "glob",
-    description: "Find files by glob pattern.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        pattern: {
-          type: "string",
-          description: 'Glob pattern (e.g., "src/**/*.ts").'
-        }
-      },
-      required: ["pattern"]
-    }
-  },
+  ...COMMON_READ_TOOLS,
   {
     name: "searchGoogle",
     description: "Search the web. Use to verify packages are current or find alternatives.",
@@ -4792,11 +4861,11 @@ var codeSanityCheckTool = {
     if (!context) {
       return "Error: code sanity check requires execution context";
     }
-    const specContext = loadSpecContext();
+    const specIndex = loadSpecIndex();
     const parts = [BASE_PROMPT3, loadPlatformBrief()];
     parts.push("<!-- cache_breakpoint -->");
-    if (specContext) {
-      parts.push(specContext);
+    if (specIndex) {
+      parts.push(specIndex);
     }
     const system = parts.join("\n\n");
     const result = await runSubAgent({