@mindstudio-ai/remy 0.1.139 → 0.1.141

package/dist/automatedActions/approvePlan.md

@@ -0,0 +1,5 @@
+---
+trigger: approvePlan
+---
+
+The user has approved the implementation plan in .remy-plan.md. Proceed with implementing the plan. Delete .remy-plan.md when all planned work is complete.

package/dist/automatedActions/buildFromRoadmap.md

@@ -8,7 +8,7 @@ First, review the specific item and think about how it fits with the existing sp
 
 Then, ask the user any clarifying questions about anything that is ambiguous or requires additional input. Consult the team for any design work, architecture review, or SDK guidance - even if they're just quick questions (that's what the team is there for - they want to help and feel valuable!). Additive feature work is the most fun to build, but make sure you take a step back first and consider any technical debt or organization implications - we need to keep the codebase clean, tidy, bug-free, and easy/intuitive to manage. When adding new features, this might mean extracting shared helpers to separate files, breaking apart components into multiple files, making new folders, etc. - Don't go overboard, but also don't keep adding to one giant file until it ends up unmanageable. Consider organization and structure when building the plan.
 
-Then, put together a plan to build out the feature. Present the plan to the user for their approval.
+Then, put together a plan to build out the feature. Write the plan with `writePlan` for the user's approval.
 
 When they've approved the plan, be sure to update the spec first - remember, the spec is the source of truth about the product. Then, build everything in one turn, using the spec as the master plan.
 

package/dist/automatedActions/codeCleanup.md

@@ -8,4 +8,4 @@ First, explore the project and get a sense of what has built.
 
 Read specific files and trace paths, don't just guess at how something works based on partial information. When you are finished exploring, identiy any high-impact areas for cleaning up the code. This can include things like directory organization, splitting things into separate files to make the project easier to scan, breaking up large components or screens, deduplicating copy-pasted code, removing dead code, and anything else that will leave the project more robust, reliable, and easier to scan/work on for developers. Do not optimize for the sake of optimizing, only focus on reducing real technical debt and leaving the product better and a more pleasant experience for other developers working on it.
 
-When you have a plan, run it by the `codeSanityCheck` to get a second set of eyes. Then, present the plan to the user. The technical detail is important so the user has a sense of what the plan entails, but remember that the user is not very technical, so it is equally important to help them understand the why behind any refactors.
+When you have a plan, run it by the `codeSanityCheck` to get a second set of eyes. Then, write the plan with `writePlan` for the user to review. The technical detail is important so the user has a sense of what the plan entails, but remember that the user is not very technical, so it is equally important to help them understand the why behind any refactors.

package/dist/automatedActions/rejectPlan.md

@@ -0,0 +1,5 @@
+---
+trigger: rejectPlan
+---
+
+The user has rejected the implementation plan. Acknowledge and continue the conversation.

package/dist/headless.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/headless.ts
 import { createInterface } from "readline";
-import { writeFileSync } from "fs";
+import { writeFileSync, readFileSync, unlinkSync } from "fs";
 
 // src/logger.ts
 import fs from "fs";
@@ -292,6 +292,28 @@ function parseFrontmatter(filePath) {
     return { name: "", description: "", type: "" };
   }
 }
+function loadPlanStatus() {
+  try {
+    const content = fs4.readFileSync(".remy-plan.md", "utf-8");
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    const status = match?.[1]?.match(/^status:\s*(.+)$/m)?.[1]?.trim();
+    if (status === "pending") {
+      return `
+<pending_plan>
+You have a pending implementation plan in .remy-plan.md awaiting user approval. Do NOT begin implementing the plan until the user approves it. You may continue chatting, answering questions, and revising the plan if asked. To revise, call writePlan again with updated content.
+</pending_plan>`;
+    }
+    if (status === "approved") {
+      return `
+<approved_plan>
+The user has approved your implementation plan in .remy-plan.md. You may reference it during implementation. Delete the file when you have finished all planned work.
+</approved_plan>`;
+    }
+    return "";
+  } catch {
+    return "";
+  }
+}
 function loadProjectFileListing() {
   try {
     const entries = fs4.readdirSync(".", { withFileTypes: true });
@@ -421,7 +443,7 @@ ${isLspConfigured() ? `<typescript_lsp>
 </code_authoring_instructions>
 
 {{static/instructions.md}}
-
+${loadPlanStatus()}
 <conversation_summaries>
 Your conversation history may include <prior_conversation_summary> blocks in the user's messages. These are automated summaries of earlier messages that have been compacted to save context space. The user does not see this summary, they see the full conversation history in their UI. Treat the summary as ground truth for what happened before, but do not reference it directly to the user ("as mentioned in the summary..."). Just continue naturally as if you remember the prior work.
 
@@ -1363,12 +1385,14 @@ var presentPublishPlanTool = {
   }
 };
 
-// src/tools/spec/presentPlan.ts
-var presentPlanTool = {
+// src/tools/spec/writePlan.ts
+import fs9 from "fs/promises";
+var PLAN_FILE = ".remy-plan.md";
+var writePlanTool = {
   clearable: false,
   definition: {
-    name: "presentPlan",
-    description: "Present an implementation plan for user approval before making changes. Use this only for large, multi-step changes like new features, new interface types, or when the user explicitly asks to see a plan. Most work should be done autonomously without a plan. Write a clear markdown summary of what you intend to do in plain language \u2014 describe the changes from the user's perspective, not as a list of files and code paths. If the user rejects with feedback, revise and present again.",
+    name: "writePlan",
+    description: "Write an implementation plan for user approval before making changes. Use this only for large, multi-step changes like new features, new interface types, or when the user explicitly asks to see a plan. Most work should be done autonomously without a plan. Write a clear markdown summary of what you intend to do in plain language \u2014 describe the changes from the user's perspective, not as a list of files and code paths. The plan is saved to .remy-plan.md and the user can review, discuss, and approve or reject it. If the user asks for revisions, call this tool again with updated content to overwrite the plan.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1380,9 +1404,15 @@ var presentPlanTool = {
       required: ["content"]
     }
   },
-  streaming: {},
-  async execute() {
-    return "approved";
+  async execute(input) {
+    const content = input.content;
+    const file = `---
+status: pending
+---
+
+${content}`;
+    await fs9.writeFile(PLAN_FILE, file, "utf-8");
+    return "Plan written to .remy-plan.md. Waiting for user approval.";
   }
 };
 
@@ -1546,7 +1576,7 @@ var confirmDestructiveActionTool = {
   clearable: false,
   definition: {
     name: "confirmDestructiveAction",
-    description: "Confirm a destructive or irreversible action with the user. Use for things like deleting data, resetting the database, or discarding draft work. Do not use after presentSyncPlan, presentPublishPlan, or presentPlan (those already include approval). Do not use before onboarding state transitions.",
+    description: "Confirm a destructive or irreversible action with the user. Use for things like deleting data, resetting the database, or discarding draft work. Do not use after presentSyncPlan, presentPublishPlan, or writePlan (those already include approval). Do not use before onboarding state transitions.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1763,7 +1793,7 @@ var compactConversationTool = {
 };
 
 // src/tools/code/readFile.ts
-import fs9 from "fs/promises";
+import fs10 from "fs/promises";
 var DEFAULT_MAX_LINES2 = 500;
 function isBinary(buffer) {
   const sample = buffer.subarray(0, 8192);
@@ -1800,7 +1830,7 @@ var readFileTool = {
   },
   async execute(input) {
     try {
-      const buffer = await fs9.readFile(input.path);
+      const buffer = await fs10.readFile(input.path);
       if (isBinary(buffer)) {
         const size = buffer.length;
         const unit = size > 1024 * 1024 ? `${(size / (1024 * 1024)).toFixed(1)}MB` : `${(size / 1024).toFixed(1)}KB`;
@@ -1834,7 +1864,7 @@ var readFileTool = {
 };
 
 // src/tools/code/writeFile.ts
-import fs10 from "fs/promises";
+import fs11 from "fs/promises";
 import path6 from "path";
 var writeFileTool = {
   clearable: true,
@@ -1872,7 +1902,7 @@ var writeFileTool = {
         lastNewlineCount = newlineCount;
         const lastNewline = partial.content.lastIndexOf("\n");
         const completeContent = partial.content.substring(0, lastNewline + 1);
-        const oldContent = await fs10.readFile(partial.path, "utf-8").catch(() => "");
+        const oldContent = await fs11.readFile(partial.path, "utf-8").catch(() => "");
         return `Writing ${partial.path} (${newlineCount} lines)
 ${unifiedDiff(partial.path, oldContent, completeContent)}`;
       }
@@ -1881,13 +1911,13 @@ ${unifiedDiff(partial.path, oldContent, completeContent)}`;
   async execute(input) {
     const release = await acquireFileLock(input.path);
     try {
-      await fs10.mkdir(path6.dirname(input.path), { recursive: true });
+      await fs11.mkdir(path6.dirname(input.path), { recursive: true });
       let oldContent = null;
       try {
-        oldContent = await fs10.readFile(input.path, "utf-8");
+        oldContent = await fs11.readFile(input.path, "utf-8");
       } catch {
       }
-      await fs10.writeFile(input.path, input.content, "utf-8");
+      await fs11.writeFile(input.path, input.content, "utf-8");
       const lineCount = input.content.split("\n").length;
       const label = oldContent !== null ? "Wrote" : "Created";
       return `${label} ${input.path} (${lineCount} lines)
@@ -1901,7 +1931,7 @@ ${unifiedDiff(input.path, oldContent ?? "", input.content)}`;
 };
 
 // src/tools/code/editFile/index.ts
-import fs11 from "fs/promises";
+import fs12 from "fs/promises";
 
 // src/tools/code/editFile/_helpers.ts
 function buildLineOffsets(content) {
@@ -2014,7 +2044,7 @@ var editFileTool = {
   async execute(input) {
     const release = await acquireFileLock(input.path);
     try {
-      const content = await fs11.readFile(input.path, "utf-8");
+      const content = await fs12.readFile(input.path, "utf-8");
       const { old_string, new_string, replace_all } = input;
       const occurrences = findOccurrences(content, old_string);
       if (replace_all) {
@@ -2030,7 +2060,7 @@ var editFileTool = {
             new_string
           );
         }
-        await fs11.writeFile(input.path, updated, "utf-8");
+        await fs12.writeFile(input.path, updated, "utf-8");
         return `Replaced ${occurrences.length} occurrence${occurrences.length > 1 ? "s" : ""} in ${input.path}
 ${unifiedDiff(input.path, content, updated)}`;
       }
@@ -2041,7 +2071,7 @@ ${unifiedDiff(input.path, content, updated)}`;
           old_string.length,
           new_string
         );
-        await fs11.writeFile(input.path, updated, "utf-8");
+        await fs12.writeFile(input.path, updated, "utf-8");
         return `Updated ${input.path}
 ${unifiedDiff(input.path, content, updated)}`;
       }
@@ -2057,7 +2087,7 @@ ${unifiedDiff(input.path, content, updated)}`;
           flex.matchedText.length,
           new_string
         );
-        await fs11.writeFile(input.path, updated, "utf-8");
+        await fs12.writeFile(input.path, updated, "utf-8");
         return `Updated ${input.path} (matched with flexible whitespace at line ${flex.line})
 ${unifiedDiff(input.path, content, updated)}`;
       }
@@ -2268,12 +2298,12 @@ var globTool = {
 };
 
 // src/tools/code/listDir.ts
-import fs12 from "fs/promises";
+import fs13 from "fs/promises";
 import path7 from "path";
 var EXCLUDE = /* @__PURE__ */ new Set([".git", "node_modules"]);
 var MAX_CHILDREN = 15;
 async function readAndSort(dirPath) {
-  const entries = await fs12.readdir(dirPath, { withFileTypes: true });
+  const entries = await fs13.readdir(dirPath, { withFileTypes: true });
   return entries.filter((e) => !EXCLUDE.has(e.name)).sort((a, b) => {
     if (a.isDirectory() && !b.isDirectory()) {
       return -1;
@@ -2314,7 +2344,7 @@ function formatSize(bytes) {
 }
 async function formatFile(dirPath, name, indent) {
   try {
-    const stat = await fs12.stat(path7.join(dirPath, name));
+    const stat = await fs13.stat(path7.join(dirPath, name));
     return `${indent}${name}${" ".repeat(Math.max(1, 30 - indent.length - name.length))}${formatSize(stat.size)}`;
   } catch {
     return `${indent}${name}`;
@@ -2352,7 +2382,30 @@ var listDirTool = {
             const capped = children.slice(0, MAX_CHILDREN);
             for (const child of capped) {
               if (child.isDirectory()) {
-                lines.push(`  ${child.name}/`);
+                const [childDisplay, childFinalPath] = await collapsePath(
+                  finalPath,
+                  child.name
+                );
+                lines.push(`  ${childDisplay}/`);
+                try {
+                  const grandchildren = await readAndSort(childFinalPath);
+                  const gcCapped = grandchildren.slice(0, MAX_CHILDREN);
+                  for (const gc of gcCapped) {
+                    if (gc.isDirectory()) {
+                      lines.push(`    ${gc.name}/`);
+                    } else {
+                      lines.push(
+                        await formatFile(childFinalPath, gc.name, "    ")
+                      );
+                    }
+                  }
+                  if (grandchildren.length > MAX_CHILDREN) {
+                    lines.push(
+                      `    ... and ${grandchildren.length - MAX_CHILDREN} more`
+                    );
+                  }
+                } catch {
+                }
               } else {
                 lines.push(await formatFile(finalPath, child.name, "  "));
               }
@@ -3358,11 +3411,11 @@ var BROWSER_TOOLS = [
 var BROWSER_EXTERNAL_TOOLS = /* @__PURE__ */ new Set(["browserCommand"]);
 
 // src/subagents/browserAutomation/prompt.ts
-import fs13 from "fs";
+import fs14 from "fs";
 var BASE_PROMPT = readAsset("subagents/browserAutomation", "prompt.md");
 function getBrowserAutomationPrompt() {
   try {
-    const appSpec = fs13.readFileSync("src/app.md", "utf-8").trim();
+    const appSpec = fs14.readFileSync("src/app.md", "utf-8").trim();
     return `${BASE_PROMPT}
 
 <!-- cache_breakpoint -->
@@ -4204,12 +4257,12 @@ async function executeDesignExpertTool(name, input, context, toolCallId, onLog)
 }
 
 // src/subagents/common/context.ts
-import fs14 from "fs";
+import fs15 from "fs";
 import path8 from "path";
 function walkMdFiles2(dir, skip) {
   const files = [];
   try {
-    for (const entry of fs14.readdirSync(dir, { withFileTypes: true })) {
+    for (const entry of fs15.readdirSync(dir, { withFileTypes: true })) {
       const full = path8.join(dir, entry.name);
       if (entry.isDirectory()) {
         if (!skip?.has(entry.name)) {
@@ -4225,7 +4278,7 @@ function walkMdFiles2(dir, skip) {
 }
 function parseFrontmatter2(filePath) {
   try {
-    const content = fs14.readFileSync(filePath, "utf-8");
+    const content = fs15.readFileSync(filePath, "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     if (!match) {
       return {};
@@ -4271,7 +4324,7 @@ function loadRoadmapIndex() {
   const parts = [];
   try {
     const indexJson = JSON.parse(
-      fs14.readFileSync("src/roadmap/index.json", "utf-8")
+      fs15.readFileSync("src/roadmap/index.json", "utf-8")
     );
     if (indexJson.lanes?.length > 0) {
       const laneLines = indexJson.lanes.map(
@@ -4374,7 +4427,7 @@ The first-party SDK (@mindstudio-ai/agent) provides access to 200+ AI models (Op
 }
 
 // src/subagents/designExpert/data/sampleCache.ts
-import fs15 from "fs";
+import fs16 from "fs";
 var SAMPLE_FILE = ".remy-design-sample.json";
 var cached = null;
 function generateIndices(poolSize, sampleSize) {
@@ -4388,14 +4441,14 @@ function generateIndices(poolSize, sampleSize) {
 }
 function load() {
   try {
-    return JSON.parse(fs15.readFileSync(SAMPLE_FILE, "utf-8"));
+    return JSON.parse(fs16.readFileSync(SAMPLE_FILE, "utf-8"));
   } catch {
     return null;
   }
 }
 function save(indices) {
   try {
-    fs15.writeFileSync(SAMPLE_FILE, JSON.stringify(indices));
+    fs16.writeFileSync(SAMPLE_FILE, JSON.stringify(indices));
   } catch {
   }
 }
@@ -4724,7 +4777,7 @@ var VISION_TOOLS = [
 ];
 
 // src/subagents/productVision/executor.ts
-import fs16 from "fs";
+import fs17 from "fs";
 import path9 from "path";
 var ROADMAP_DIR = "src/roadmap";
 var PITCH_DECK_SHELL = readAsset(
@@ -4739,13 +4792,13 @@ async function executeVisionTool(name, input, context) {
     case "writeFile": {
       const filePath = resolve(input.path);
       try {
-        fs16.mkdirSync(ROADMAP_DIR, { recursive: true });
+        fs17.mkdirSync(ROADMAP_DIR, { recursive: true });
         let oldContent = null;
         try {
-          oldContent = fs16.readFileSync(filePath, "utf-8");
+          oldContent = fs17.readFileSync(filePath, "utf-8");
         } catch {
         }
-        fs16.writeFileSync(filePath, input.content, "utf-8");
+        fs17.writeFileSync(filePath, input.content, "utf-8");
         const lineCount = input.content.split("\n").length;
         const label = oldContent !== null ? "Wrote" : "Created";
         return `${label} ${filePath} (${lineCount} lines)
@@ -4757,11 +4810,11 @@ ${unifiedDiff(filePath, oldContent ?? "", input.content)}`;
     case "deleteFile": {
       const filePath = resolve(input.path);
       try {
-        if (!fs16.existsSync(filePath)) {
+        if (!fs17.existsSync(filePath)) {
           return `Error: ${filePath} does not exist`;
         }
-        const oldContent = fs16.readFileSync(filePath, "utf-8");
-        fs16.unlinkSync(filePath);
+        const oldContent = fs17.readFileSync(filePath, "utf-8");
+        fs17.unlinkSync(filePath);
         return `Deleted ${filePath}
 ${unifiedDiff(filePath, oldContent, "")}`;
       } catch (err) {
@@ -4774,8 +4827,8 @@ ${unifiedDiff(filePath, oldContent, "")}`;
       }
       const filePath = resolve("pitch.html");
       try {
-        fs16.mkdirSync(ROADMAP_DIR, { recursive: true });
-        const existing = fs16.existsSync(filePath) ? fs16.readFileSync(filePath, "utf-8").trim() : "";
+        fs17.mkdirSync(ROADMAP_DIR, { recursive: true });
+        const existing = fs17.existsSync(filePath) ? fs17.readFileSync(filePath, "utf-8").trim() : "";
         const currentDeck = existing || PITCH_DECK_SHELL;
         const task = `
 <pitch_content>${input.task}</pitch_content>
@@ -4800,7 +4853,7 @@ Respond only with the complete HTML file and absolutely no other text. Your resp
           /```(?:html|wireframe)\n([\s\S]*?)```/
         );
         const html = htmlMatch ? htmlMatch[1].trim() : result;
-        fs16.writeFileSync(filePath, html, "utf-8");
+        fs17.writeFileSync(filePath, html, "utf-8");
         return `Pitch deck written successfully.`;
       } catch (err) {
         return `Error generating pitch deck: ${err.message}`;
@@ -5045,7 +5098,7 @@ var ALL_TOOLS = [
   clearSyncStatusTool,
   presentSyncPlanTool,
   presentPublishPlanTool,
-  presentPlanTool,
+  writePlanTool,
   // Spec
   readSpecTool,
   writeSpecTool,
@@ -5087,12 +5140,12 @@ function executeTool(name, input, context) {
 }
 
 // src/session.ts
-import fs17 from "fs";
+import fs18 from "fs";
 var log7 = createLogger("session");
 var SESSION_FILE = ".remy-session.json";
 function loadSession(state) {
   try {
-    const raw = fs17.readFileSync(SESSION_FILE, "utf-8");
+    const raw = fs18.readFileSync(SESSION_FILE, "utf-8");
     const data = JSON.parse(raw);
     if (Array.isArray(data.messages) && data.messages.length > 0) {
       state.messages = sanitizeMessages(data.messages);
@@ -5141,7 +5194,7 @@ function sanitizeMessages(messages) {
 }
 function saveSession(state) {
   try {
-    fs17.writeFileSync(
+    fs18.writeFileSync(
       SESSION_FILE,
       JSON.stringify({ messages: state.messages }, null, 2),
       "utf-8"
@@ -5154,7 +5207,7 @@ function saveSession(state) {
 function clearSession(state) {
   state.messages = [];
   try {
-    fs17.unlinkSync(SESSION_FILE);
+    fs18.unlinkSync(SESSION_FILE);
   } catch {
   }
 }
@@ -5382,7 +5435,6 @@ var EXTERNAL_TOOLS = /* @__PURE__ */ new Set([
   "clearSyncStatus",
   "presentSyncPlan",
   "presentPublishPlan",
-  "presentPlan",
   "confirmDestructiveAction",
   "runScenario",
   "runMethod",
@@ -6133,7 +6185,6 @@ ${xmlParts}
   const USER_FACING_TOOLS = /* @__PURE__ */ new Set([
     "promptUser",
     "confirmDestructiveAction",
-    "presentPlan",
     "presentSyncPlan",
     "presentPublishPlan"
   ]);
@@ -6351,6 +6402,23 @@ ${xmlParts}
       userMessage = resolved;
     }
     const isHidden = resolved !== null || !!parsed.hidden;
+    const rawText = parsed.text ?? "";
+    if (rawText.startsWith("@@automated::approvePlan@@")) {
+      try {
+        const plan = readFileSync(".remy-plan.md", "utf-8");
+        writeFileSync(
+          ".remy-plan.md",
+          plan.replace(/^status:\s*pending/m, "status: approved"),
+          "utf-8"
+        );
+      } catch {
+      }
+    } else if (rawText.startsWith("@@automated::rejectPlan@@")) {
+      try {
+        unlinkSync(".remy-plan.md");
+      } catch {
+      }
+    }
     const onboardingState = parsed.onboardingState ?? "onboardingFinished";
     const system = buildSystemPrompt(
       onboardingState,

package/dist/index.js

@@ -853,16 +853,18 @@ var init_presentPublishPlan = __esm({
   }
 });
 
-// src/tools/spec/presentPlan.ts
-var presentPlanTool;
-var init_presentPlan = __esm({
-  "src/tools/spec/presentPlan.ts"() {
+// src/tools/spec/writePlan.ts
+import fs6 from "fs/promises";
+var PLAN_FILE, writePlanTool;
+var init_writePlan = __esm({
+  "src/tools/spec/writePlan.ts"() {
     "use strict";
-    presentPlanTool = {
+    PLAN_FILE = ".remy-plan.md";
+    writePlanTool = {
       clearable: false,
       definition: {
-        name: "presentPlan",
-        description: "Present an implementation plan for user approval before making changes. Use this only for large, multi-step changes like new features, new interface types, or when the user explicitly asks to see a plan. Most work should be done autonomously without a plan. Write a clear markdown summary of what you intend to do in plain language \u2014 describe the changes from the user's perspective, not as a list of files and code paths. If the user rejects with feedback, revise and present again.",
+        name: "writePlan",
+        description: "Write an implementation plan for user approval before making changes. Use this only for large, multi-step changes like new features, new interface types, or when the user explicitly asks to see a plan. Most work should be done autonomously without a plan. Write a clear markdown summary of what you intend to do in plain language \u2014 describe the changes from the user's perspective, not as a list of files and code paths. The plan is saved to .remy-plan.md and the user can review, discuss, and approve or reject it. If the user asks for revisions, call this tool again with updated content to overwrite the plan.",
         inputSchema: {
           type: "object",
           properties: {
@@ -874,9 +876,15 @@ var init_presentPlan = __esm({
           required: ["content"]
         }
       },
-      streaming: {},
-      async execute() {
-        return "approved";
+      async execute(input) {
+        const content = input.content;
+        const file = `---
+status: pending
+---
+
+${content}`;
+        await fs6.writeFile(PLAN_FILE, file, "utf-8");
+        return "Plan written to .remy-plan.md. Waiting for user approval.";
       }
     };
   }
@@ -1058,7 +1066,7 @@ var init_confirmDestructiveAction = __esm({
       clearable: false,
       definition: {
         name: "confirmDestructiveAction",
-        description: "Confirm a destructive or irreversible action with the user. Use for things like deleting data, resetting the database, or discarding draft work. Do not use after presentSyncPlan, presentPublishPlan, or presentPlan (those already include approval). Do not use before onboarding state transitions.",
+        description: "Confirm a destructive or irreversible action with the user. Use for things like deleting data, resetting the database, or discarding draft work. Do not use after presentSyncPlan, presentPublishPlan, or writePlan (those already include approval). Do not use before onboarding state transitions.",
         inputSchema: {
           type: "object",
           properties: {
@@ -1279,12 +1287,12 @@ var init_setProjectMetadata = __esm({
 });
 
 // src/assets.ts
-import fs6 from "fs";
+import fs7 from "fs";
 import path3 from "path";
 function findRoot(start) {
   let dir = start;
   while (dir !== path3.dirname(dir)) {
-    if (fs6.existsSync(path3.join(dir, "package.json"))) {
+    if (fs7.existsSync(path3.join(dir, "package.json"))) {
       return dir;
     }
     dir = path3.dirname(dir);
@@ -1297,7 +1305,7 @@ function assetPath(...segments) {
 function readAsset(...segments) {
   const full = assetPath(...segments);
   try {
-    return fs6.readFileSync(full, "utf-8").trim();
+    return fs7.readFileSync(full, "utf-8").trim();
   } catch {
     throw new Error(`Required asset missing: ${full}`);
   }
@@ -1305,7 +1313,7 @@ function readAsset(...segments) {
 function readJsonAsset(fallback, ...segments) {
   const full = assetPath(...segments);
   try {
-    return JSON.parse(fs6.readFileSync(full, "utf-8"));
+    return JSON.parse(fs7.readFileSync(full, "utf-8"));
   } catch {
     return fallback;
   }
@@ -1317,7 +1325,7 @@ var init_assets = __esm({
     ROOT = findRoot(
       import.meta.dirname ?? path3.dirname(new URL(import.meta.url).pathname)
     );
-    ASSETS_BASE = fs6.existsSync(path3.join(ROOT, "dist", "prompt")) ? path3.join(ROOT, "dist") : path3.join(ROOT, "src");
+    ASSETS_BASE = fs7.existsSync(path3.join(ROOT, "dist", "prompt")) ? path3.join(ROOT, "dist") : path3.join(ROOT, "src");
   }
 });
 
@@ -1606,12 +1614,12 @@ var init_lsp = __esm({
 });
 
 // src/prompt/static/projectContext.ts
-import fs7 from "fs";
+import fs8 from "fs";
 import path4 from "path";
 function loadProjectInstructions() {
   for (const file of AGENT_INSTRUCTION_FILES) {
     try {
-      const content = fs7.readFileSync(file, "utf-8").trim();
+      const content = fs8.readFileSync(file, "utf-8").trim();
       if (content) {
         return `
 ## Project Instructions (${file})
@@ -1624,7 +1632,7 @@ ${content}`;
 }
 function loadProjectManifest() {
   try {
-    const manifest = fs7.readFileSync("mindstudio.json", "utf-8");
+    const manifest = fs8.readFileSync("mindstudio.json", "utf-8");
     return `
 ## Project Manifest (mindstudio.json)
 \`\`\`json
@@ -1665,7 +1673,7 @@ ${entries.join("\n")}`;
 function walkMdFiles(dir) {
   const results = [];
   try {
-    const entries = fs7.readdirSync(dir, { withFileTypes: true });
+    const entries = fs8.readdirSync(dir, { withFileTypes: true });
     for (const entry of entries) {
       const full = path4.join(dir, entry.name);
       if (entry.isDirectory()) {
@@ -1680,7 +1688,7 @@ function walkMdFiles(dir) {
 }
 function parseFrontmatter(filePath) {
   try {
-    const content = fs7.readFileSync(filePath, "utf-8");
+    const content = fs8.readFileSync(filePath, "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     if (!match) {
       return { name: "", description: "", type: "" };
@@ -1694,9 +1702,31 @@ function parseFrontmatter(filePath) {
     return { name: "", description: "", type: "" };
   }
 }
+function loadPlanStatus() {
+  try {
+    const content = fs8.readFileSync(".remy-plan.md", "utf-8");
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    const status = match?.[1]?.match(/^status:\s*(.+)$/m)?.[1]?.trim();
+    if (status === "pending") {
+      return `
+<pending_plan>
+You have a pending implementation plan in .remy-plan.md awaiting user approval. Do NOT begin implementing the plan until the user approves it. You may continue chatting, answering questions, and revising the plan if asked. To revise, call writePlan again with updated content.
+</pending_plan>`;
+    }
+    if (status === "approved") {
+      return `
+<approved_plan>
+The user has approved your implementation plan in .remy-plan.md. You may reference it during implementation. Delete the file when you have finished all planned work.
+</approved_plan>`;
+    }
+    return "";
+  } catch {
+    return "";
+  }
+}
 function loadProjectFileListing() {
   try {
-    const entries = fs7.readdirSync(".", { withFileTypes: true });
+    const entries = fs8.readdirSync(".", { withFileTypes: true });
     const listing = entries.filter((e) => e.name !== ".git" && e.name !== "node_modules").sort((a, b) => {
       if (a.isDirectory() && !b.isDirectory()) {
         return -1;
@@ -1845,7 +1875,7 @@ ${isLspConfigured() ? `<typescript_lsp>
 </code_authoring_instructions>
 
 {{static/instructions.md}}
-
+${loadPlanStatus()}
 <conversation_summaries>
 Your conversation history may include <prior_conversation_summary> blocks in the user's messages. These are automated summaries of earlier messages that have been compacted to save context space. The user does not see this summary, they see the full conversation history in their UI. Treat the summary as ground truth for what happened before, but do not reference it directly to the user ("as mentioned in the summary..."). Just continue naturally as if you remember the prior work.
 
@@ -1884,10 +1914,10 @@ var init_prompt = __esm({
 });
 
 // src/session.ts
-import fs8 from "fs";
+import fs9 from "fs";
 function loadSession(state) {
   try {
-    const raw = fs8.readFileSync(SESSION_FILE, "utf-8");
+    const raw = fs9.readFileSync(SESSION_FILE, "utf-8");
     const data = JSON.parse(raw);
     if (Array.isArray(data.messages) && data.messages.length > 0) {
       state.messages = sanitizeMessages(data.messages);
@@ -1936,7 +1966,7 @@ function sanitizeMessages(messages) {
 }
 function saveSession(state) {
   try {
-    fs8.writeFileSync(
+    fs9.writeFileSync(
       SESSION_FILE,
       JSON.stringify({ messages: state.messages }, null, 2),
       "utf-8"
@@ -1949,7 +1979,7 @@ function saveSession(state) {
 function clearSession(state) {
   state.messages = [];
   try {
-    fs8.unlinkSync(SESSION_FILE);
+    fs9.unlinkSync(SESSION_FILE);
   } catch {
   }
 }
@@ -2023,7 +2053,7 @@ var init_compactConversation = __esm({
 });
 
 // src/tools/code/readFile.ts
-import fs9 from "fs/promises";
+import fs10 from "fs/promises";
 function isBinary(buffer) {
   const sample = buffer.subarray(0, 8192);
   for (let i = 0; i < sample.length; i++) {
@@ -2064,7 +2094,7 @@ var init_readFile = __esm({
       },
       async execute(input) {
         try {
-          const buffer = await fs9.readFile(input.path);
+          const buffer = await fs10.readFile(input.path);
           if (isBinary(buffer)) {
             const size = buffer.length;
             const unit = size > 1024 * 1024 ? `${(size / (1024 * 1024)).toFixed(1)}MB` : `${(size / 1024).toFixed(1)}KB`;
@@ -2100,7 +2130,7 @@ var init_readFile = __esm({
 });
 
 // src/tools/code/writeFile.ts
-import fs10 from "fs/promises";
+import fs11 from "fs/promises";
 import path5 from "path";
 var writeFileTool;
 var init_writeFile = __esm({
@@ -2144,7 +2174,7 @@ var init_writeFile = __esm({
             lastNewlineCount = newlineCount;
             const lastNewline = partial.content.lastIndexOf("\n");
             const completeContent = partial.content.substring(0, lastNewline + 1);
-            const oldContent = await fs10.readFile(partial.path, "utf-8").catch(() => "");
+            const oldContent = await fs11.readFile(partial.path, "utf-8").catch(() => "");
             return `Writing ${partial.path} (${newlineCount} lines)
 ${unifiedDiff(partial.path, oldContent, completeContent)}`;
           }
@@ -2153,13 +2183,13 @@ ${unifiedDiff(partial.path, oldContent, completeContent)}`;
       async execute(input) {
         const release = await acquireFileLock(input.path);
         try {
-          await fs10.mkdir(path5.dirname(input.path), { recursive: true });
+          await fs11.mkdir(path5.dirname(input.path), { recursive: true });
           let oldContent = null;
           try {
-            oldContent = await fs10.readFile(input.path, "utf-8");
+            oldContent = await fs11.readFile(input.path, "utf-8");
           } catch {
           }
-          await fs10.writeFile(input.path, input.content, "utf-8");
+          await fs11.writeFile(input.path, input.content, "utf-8");
           const lineCount = input.content.split("\n").length;
           const label = oldContent !== null ? "Wrote" : "Created";
           return `${label} ${input.path} (${lineCount} lines)
@@ -2259,7 +2289,7 @@ var init_helpers2 = __esm({
 });
 
 // src/tools/code/editFile/index.ts
-import fs11 from "fs/promises";
+import fs12 from "fs/promises";
 var editFileTool;
 var init_editFile = __esm({
   "src/tools/code/editFile/index.ts"() {
@@ -2298,7 +2328,7 @@ var init_editFile = __esm({
       async execute(input) {
         const release = await acquireFileLock(input.path);
         try {
-          const content = await fs11.readFile(input.path, "utf-8");
+          const content = await fs12.readFile(input.path, "utf-8");
           const { old_string, new_string, replace_all } = input;
           const occurrences = findOccurrences(content, old_string);
           if (replace_all) {
@@ -2314,7 +2344,7 @@ var init_editFile = __esm({
                 new_string
               );
             }
-            await fs11.writeFile(input.path, updated, "utf-8");
+            await fs12.writeFile(input.path, updated, "utf-8");
             return `Replaced ${occurrences.length} occurrence${occurrences.length > 1 ? "s" : ""} in ${input.path}
 ${unifiedDiff(input.path, content, updated)}`;
           }
@@ -2325,7 +2355,7 @@ ${unifiedDiff(input.path, content, updated)}`;
               old_string.length,
               new_string
             );
-            await fs11.writeFile(input.path, updated, "utf-8");
+            await fs12.writeFile(input.path, updated, "utf-8");
             return `Updated ${input.path}
 ${unifiedDiff(input.path, content, updated)}`;
           }
@@ -2341,7 +2371,7 @@ ${unifiedDiff(input.path, content, updated)}`;
               flex.matchedText.length,
               new_string
             );
-            await fs11.writeFile(input.path, updated, "utf-8");
+            await fs12.writeFile(input.path, updated, "utf-8");
             return `Updated ${input.path} (matched with flexible whitespace at line ${flex.line})
 ${unifiedDiff(input.path, content, updated)}`;
           }
@@ -2572,10 +2602,10 @@ var init_glob = __esm({
 });
 
 // src/tools/code/listDir.ts
-import fs12 from "fs/promises";
+import fs13 from "fs/promises";
 import path6 from "path";
 async function readAndSort(dirPath) {
-  const entries = await fs12.readdir(dirPath, { withFileTypes: true });
+  const entries = await fs13.readdir(dirPath, { withFileTypes: true });
   return entries.filter((e) => !EXCLUDE.has(e.name)).sort((a, b) => {
     if (a.isDirectory() && !b.isDirectory()) {
       return -1;
@@ -2616,7 +2646,7 @@ function formatSize(bytes) {
 }
 async function formatFile(dirPath, name, indent) {
   try {
-    const stat = await fs12.stat(path6.join(dirPath, name));
+    const stat = await fs13.stat(path6.join(dirPath, name));
     return `${indent}${name}${" ".repeat(Math.max(1, 30 - indent.length - name.length))}${formatSize(stat.size)}`;
   } catch {
     return `${indent}${name}`;
@@ -2660,7 +2690,30 @@ var init_listDir = __esm({
                 const capped = children.slice(0, MAX_CHILDREN);
                 for (const child of capped) {
                   if (child.isDirectory()) {
-                    lines.push(`  ${child.name}/`);
+                    const [childDisplay, childFinalPath] = await collapsePath(
+                      finalPath,
+                      child.name
+                    );
+                    lines.push(`  ${childDisplay}/`);
+                    try {
+                      const grandchildren = await readAndSort(childFinalPath);
+                      const gcCapped = grandchildren.slice(0, MAX_CHILDREN);
+                      for (const gc of gcCapped) {
+                        if (gc.isDirectory()) {
+                          lines.push(`    ${gc.name}/`);
+                        } else {
+                          lines.push(
+                            await formatFile(childFinalPath, gc.name, "    ")
+                          );
+                        }
+                      }
+                      if (grandchildren.length > MAX_CHILDREN) {
+                        lines.push(
+                          `    ... and ${grandchildren.length - MAX_CHILDREN} more`
+                        );
+                      }
+                    } catch {
+                    }
                   } else {
                     lines.push(await formatFile(finalPath, child.name, "  "));
                   }
@@ -3754,10 +3807,10 @@ var init_tools = __esm({
 });
 
 // src/subagents/browserAutomation/prompt.ts
-import fs13 from "fs";
+import fs14 from "fs";
 function getBrowserAutomationPrompt() {
   try {
-    const appSpec = fs13.readFileSync("src/app.md", "utf-8").trim();
+    const appSpec = fs14.readFileSync("src/app.md", "utf-8").trim();
     return `${BASE_PROMPT}
 
 <!-- cache_breakpoint -->
@@ -4721,12 +4774,12 @@ var init_tools3 = __esm({
 });
 
 // src/subagents/common/context.ts
-import fs14 from "fs";
+import fs15 from "fs";
 import path7 from "path";
 function walkMdFiles2(dir, skip) {
   const files = [];
   try {
-    for (const entry of fs14.readdirSync(dir, { withFileTypes: true })) {
+    for (const entry of fs15.readdirSync(dir, { withFileTypes: true })) {
       const full = path7.join(dir, entry.name);
       if (entry.isDirectory()) {
         if (!skip?.has(entry.name)) {
@@ -4742,7 +4795,7 @@ function walkMdFiles2(dir, skip) {
 }
 function parseFrontmatter2(filePath) {
   try {
-    const content = fs14.readFileSync(filePath, "utf-8");
+    const content = fs15.readFileSync(filePath, "utf-8");
     const match = content.match(/^---\n([\s\S]*?)\n---/);
     if (!match) {
       return {};
@@ -4788,7 +4841,7 @@ function loadRoadmapIndex() {
   const parts = [];
   try {
     const indexJson = JSON.parse(
-      fs14.readFileSync("src/roadmap/index.json", "utf-8")
+      fs15.readFileSync("src/roadmap/index.json", "utf-8")
     );
     if (indexJson.lanes?.length > 0) {
       const laneLines = indexJson.lanes.map(
@@ -4896,7 +4949,7 @@ var init_context = __esm({
 });
 
 // src/subagents/designExpert/data/sampleCache.ts
-import fs15 from "fs";
+import fs16 from "fs";
 function generateIndices(poolSize, sampleSize) {
   const n = Math.min(sampleSize, poolSize);
   const indices = Array.from({ length: poolSize }, (_, i) => i);
@@ -4908,14 +4961,14 @@ function generateIndices(poolSize, sampleSize) {
 }
 function load() {
   try {
-    return JSON.parse(fs15.readFileSync(SAMPLE_FILE, "utf-8"));
+    return JSON.parse(fs16.readFileSync(SAMPLE_FILE, "utf-8"));
   } catch {
     return null;
   }
 }
 function save(indices) {
   try {
-    fs15.writeFileSync(SAMPLE_FILE, JSON.stringify(indices));
+    fs16.writeFileSync(SAMPLE_FILE, JSON.stringify(indices));
   } catch {
   }
 }
@@ -5312,7 +5365,7 @@ var init_tools4 = __esm({
 });
 
 // src/subagents/productVision/executor.ts
-import fs16 from "fs";
+import fs17 from "fs";
 import path8 from "path";
 function resolve(filePath) {
   return path8.join(ROADMAP_DIR, filePath);
@@ -5322,13 +5375,13 @@ async function executeVisionTool(name, input, context) {
     case "writeFile": {
       const filePath = resolve(input.path);
       try {
-        fs16.mkdirSync(ROADMAP_DIR, { recursive: true });
+        fs17.mkdirSync(ROADMAP_DIR, { recursive: true });
         let oldContent = null;
         try {
-          oldContent = fs16.readFileSync(filePath, "utf-8");
+          oldContent = fs17.readFileSync(filePath, "utf-8");
         } catch {
         }
-        fs16.writeFileSync(filePath, input.content, "utf-8");
+        fs17.writeFileSync(filePath, input.content, "utf-8");
         const lineCount = input.content.split("\n").length;
         const label = oldContent !== null ? "Wrote" : "Created";
         return `${label} ${filePath} (${lineCount} lines)
@@ -5340,11 +5393,11 @@ ${unifiedDiff(filePath, oldContent ?? "", input.content)}`;
     case "deleteFile": {
       const filePath = resolve(input.path);
       try {
-        if (!fs16.existsSync(filePath)) {
+        if (!fs17.existsSync(filePath)) {
           return `Error: ${filePath} does not exist`;
         }
-        const oldContent = fs16.readFileSync(filePath, "utf-8");
-        fs16.unlinkSync(filePath);
+        const oldContent = fs17.readFileSync(filePath, "utf-8");
+        fs17.unlinkSync(filePath);
         return `Deleted ${filePath}
 ${unifiedDiff(filePath, oldContent, "")}`;
       } catch (err) {
@@ -5357,8 +5410,8 @@ ${unifiedDiff(filePath, oldContent, "")}`;
       }
       const filePath = resolve("pitch.html");
       try {
-        fs16.mkdirSync(ROADMAP_DIR, { recursive: true });
-        const existing = fs16.existsSync(filePath) ? fs16.readFileSync(filePath, "utf-8").trim() : "";
+        fs17.mkdirSync(ROADMAP_DIR, { recursive: true });
+        const existing = fs17.existsSync(filePath) ? fs17.readFileSync(filePath, "utf-8").trim() : "";
         const currentDeck = existing || PITCH_DECK_SHELL;
         const task = `
 <pitch_content>${input.task}</pitch_content>
@@ -5383,7 +5436,7 @@ Respond only with the complete HTML file and absolutely no other text. Your resp
           /```(?:html|wireframe)\n([\s\S]*?)```/
         );
         const html = htmlMatch ? htmlMatch[1].trim() : result;
-        fs16.writeFileSync(filePath, html, "utf-8");
+        fs17.writeFileSync(filePath, html, "utf-8");
         return `Pitch deck written successfully.`;
       } catch (err) {
         return `Error generating pitch deck: ${err.message}`;
@@ -5697,7 +5750,7 @@ var init_tools6 = __esm({
     init_clearSyncStatus();
     init_presentSyncPlan();
     init_presentPublishPlan();
-    init_presentPlan();
+    init_writePlan();
     init_setProjectOnboardingState();
     init_promptUser();
     init_confirmDestructiveAction();
@@ -5741,7 +5794,7 @@ var init_tools6 = __esm({
       clearSyncStatusTool,
       presentSyncPlanTool,
       presentPublishPlanTool,
-      presentPlanTool,
+      writePlanTool,
       // Spec
       readSpecTool,
       writeSpecTool,
@@ -6497,7 +6550,6 @@ var init_agent = __esm({
       "clearSyncStatus",
       "presentSyncPlan",
       "presentPublishPlan",
-      "presentPlan",
       "confirmDestructiveAction",
       "runScenario",
       "runMethod",
@@ -6509,12 +6561,12 @@ var init_agent = __esm({
 });
 
 // src/config.ts
-import fs17 from "fs";
+import fs18 from "fs";
 import path9 from "path";
 import os from "os";
 function loadConfigFile() {
   try {
-    const raw = fs17.readFileSync(CONFIG_PATH, "utf-8");
+    const raw = fs18.readFileSync(CONFIG_PATH, "utf-8");
     log9.debug("Loaded config file", { path: CONFIG_PATH });
     return JSON.parse(raw);
   } catch (err) {
@@ -6684,7 +6736,7 @@ __export(headless_exports, {
   startHeadless: () => startHeadless
 });
 import { createInterface } from "readline";
-import { writeFileSync } from "fs";
+import { writeFileSync, readFileSync, unlinkSync } from "fs";
 function emit(event, data, requestId) {
   const payload = { event, ...data };
   if (requestId) {
@@ -6825,7 +6877,6 @@ ${xmlParts}
   const USER_FACING_TOOLS = /* @__PURE__ */ new Set([
     "promptUser",
     "confirmDestructiveAction",
-    "presentPlan",
     "presentSyncPlan",
     "presentPublishPlan"
   ]);
@@ -7043,6 +7094,23 @@ ${xmlParts}
       userMessage = resolved;
     }
     const isHidden = resolved !== null || !!parsed.hidden;
+    const rawText = parsed.text ?? "";
+    if (rawText.startsWith("@@automated::approvePlan@@")) {
+      try {
+        const plan = readFileSync(".remy-plan.md", "utf-8");
+        writeFileSync(
+          ".remy-plan.md",
+          plan.replace(/^status:\s*pending/m, "status: approved"),
+          "utf-8"
+        );
+      } catch {
+      }
+    } else if (rawText.startsWith("@@automated::rejectPlan@@")) {
+      try {
+        unlinkSync(".remy-plan.md");
+      } catch {
+      }
+    }
     const onboardingState = parsed.onboardingState ?? "onboardingFinished";
     const system = buildSystemPrompt(
       onboardingState,
@@ -7240,7 +7308,7 @@ var init_headless = __esm({
 // src/index.tsx
 import { render } from "ink";
 import os2 from "os";
-import fs18 from "fs";
+import fs19 from "fs";
 import path10 from "path";
 
 // src/tui/App.tsx
@@ -7559,7 +7627,7 @@ for (let i = 0; i < args.length; i++) {
 var startupLog = createLogger("startup");
 function printDebugInfo(config) {
   const pkg = JSON.parse(
-    fs18.readFileSync(
+    fs19.readFileSync(
       path10.join(import.meta.dirname, "..", "package.json"),
       "utf-8"
     )

package/dist/prompt/compiled/methods.md

@@ -245,20 +245,54 @@ export function getApprovalState(approvals: Approval[]) {
 
 ## Streaming
 
-Methods can stream token-by-token output (useful for AI-generated content):
+Methods can push real-time updates to the frontend using `stream()`. This is the standard pattern for any method that takes more than a few seconds.
 
 ```typescript
-// Frontend
-const result = await api.generateReport(
-  { month: 'march' },
+import { mindstudio, stream } from '@mindstudio-ai/agent';
+
+export async function enrichProfile(input: { name: string }) {
+  await stream('Researching...');
+
+  const { content } = await mindstudio.generateText(
+    { message: `Find background info on ${input.name}` },
+    { onLog: (event) => stream({ status: event.value }) },
+  );
+
+  await stream({ status: 'generating_image', progress: 0.5 });
+
+  const { imageUrl } = await mindstudio.generateImage(
+    { prompt: `Professional portrait illustration of ${input.name}` },
+    { onLog: (event) => stream({ status: event.value }) },
+  );
+
+  return { bio: content, imageUrl };
+}
+```
+
+Two data types:
+- `stream('text')` sends a text token (like LLM streaming output)
+- `stream({ ... })` sends structured data (progress, status, intermediate results)
+
+Every SDK action accepts an `onLog` callback that emits execution progress. Pipe it through `stream()` so the frontend sees what's happening inside each action in real time. Use `stream()` directly for your own status messages between actions.
+
+When there's no active stream (method not called with `stream: true`, CLI execution, background jobs), `stream()` is a silent no-op. Always safe to include unconditionally.
+
+### Frontend
+
+The frontend calls the method with `stream: true` and receives updates via `onToken`. The `text` value is accumulated (not a delta), so replace your display content each time.
+
+```typescript
+const result = await api.enrichProfile(
+  { name: 'Alice' },
   {
     stream: true,
-    onToken: (text) => setPreview(text),
+    onToken: (text) => setResponseText(text),
   },
 );
+// result is the same final output you'd get without streaming
 ```
 
-The platform handles the SSE transport. The method returns normally — streaming is managed by the SDK and platform, not by your method code.
+Use `onStreamError` for transient error handling. The method's promise still resolves with the final return value once execution completes.
 
 ## Raw Request Context (API Interface)
 

package/dist/prompt/static/coding.md

@@ -30,6 +30,8 @@ For any work involving AI models, external actions (web scraping, email, SMS), o
 
 For multi-step tasks with branching logic (research, enrichment, content pipelines), use `runTask()` instead of manually chaining SDK actions. It runs an autonomous agent loop that composes actions, retries on failure, and returns structured JSON. See the task agents reference for details.
 
+For methods that take more than a few seconds, use `stream()` from `@mindstudio-ai/agent` to push real-time progress to the frontend. Pipe `onLog` from SDK actions through `stream()` so users see what's happening. The frontend calls the method with `stream: true` and gets updates via `onToken`. See the methods reference for the full pattern.
+
 ### Auth
 - Not every app needs auth, and even for apps that do need auth, not every screen needs auth. Think intentionally about places where auth is required. Don't make auth be the first thing a user sees - that's jarring. Only show auth at intuitive and natural moments in the user's journey - be thoughtful about how to implement auth in the UI.
 - Frontend interfaces are always untrusted. Always enforce auth in backend methods. Use frontend auth and role information as a hint to conditionally show/hide UI to make the experience pleasant and seamless for users depending on their state, but remember to always use backend methods for gating data that is conditional on auth.

package/dist/prompt/static/instructions.md

@@ -9,7 +9,7 @@
 - Always keep the spec up to date after making changes to the code, especially when adding features or building things from the roadmap.
 - Change only what the task requires. Match existing styles. Keep solutions simple.
 - Read files before editing them. Understand the context before making changes.
-- When the user asks you to make a change, execute it fully — all steps, no pausing for confirmation. Use `confirmDestructiveAction` to gate before destructive or irreversible actions (e.g., deleting data, resetting the database). For large changes that touch many files or involve significant design decisions, use `presentPlan` to get user approval first — but only when the scope genuinely warrants it or the user asks to see a plan. Most work should be done autonomously.
+- When the user asks you to make a change, execute it fully — all steps, no pausing for confirmation. Use `confirmDestructiveAction` to gate before destructive or irreversible actions (e.g., deleting data, resetting the database). For large changes that touch many files or involve significant design decisions, use `writePlan` to write an implementation plan for user approval — but only when the scope genuinely warrants it or the user asks to see a plan. The plan is saved to `.remy-plan.md` and the user can review, discuss, and refine it before approving. Do not begin implementation until the plan is approved. Most work should be done autonomously without a plan.
 - Work with what you already know. If you've read a file in this session, use what you learned rather than reading it again. If a subagent already researched something, use its findings. Every tool call costs time; prefer acting on information you have over re-gathering it.
 - When multiple tool calls are independent, make them all in a single turn. Reading three files, writing two methods, or running a scenario while taking a screenshot: batch them instead of doing one per turn.
 - After two failed attempts at the same approach, tell the user what's going wrong.
@@ -17,7 +17,7 @@
 - Pushing to main branch will trigger a deploy. The user presses the publish button in the interface to request publishing.
 
 ### Build Notes
-For complex tasks — especially an initial buildout from a spec or making multiple changes in a single turn — write a `.remy-notes.md` scratchpad in the project root. Use it to track progress: a checklist of what's been built and what's remaining. Do not include implementation details or other decisions in the notes - it is solely for keeping track of tasks. Read the spec files directly when you need design details, implementation decisions, or other reference materials - never write them to the notes file. Delete the notes file when your work is done.
+For complex tasks — especially an initial buildout from a spec or making multiple changes in a single turn — write a `.remy-notes.md` scratchpad in the project root. Use it to track progress: a checklist of what's been built and what's remaining. Do not include implementation details or other decisions in the notes - it is solely for keeping track of tasks. Read the spec files directly when you need design details, implementation decisions, or other reference materials - never write them to the notes file. Delete the notes file when your work is done. When implementing an approved plan, `.remy-plan.md` serves as your reference. Delete it when all planned work is complete.
 
 ## Communication
 The user can already see your tool calls, so most of your work is visible without narration. Focus text output on three things:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindstudio-ai/remy",
-  "version": "0.1.139",
+  "version": "0.1.141",
   "description": "MindStudio coding agent",
   "repository": {
     "type": "git",