@mindstudio-ai/remy 0.1.69 → 0.1.71

package/README.md

@@ -49,7 +49,7 @@ Tool availability depends on the project's onboarding state, sent by the sandbox
 
 | Tool | Description |
 |------|-------------|
-| `setProjectOnboardingState` | Advance the onboarding flow (intake → initialSpecAuthoring → initialCodegen → onboardingFinished) |
+| `setProjectOnboardingState` | Advance the onboarding flow (intake → initialSpecReview → initialCodegen → onboardingFinished) |
 | `setProjectName` | Set the project name |
 | `promptUser` | Ask the user structured questions (form or inline display) |
 | `confirmDestructiveAction` | Confirm a destructive or irreversible action with the user |

package/dist/headless.js

@@ -650,7 +650,7 @@ var log4 = createLogger("compaction");
 var CONVERSATION_SUMMARY_PROMPT = readAsset("compaction", "conversation.md");
 var SUBAGENT_SUMMARY_PROMPT = readAsset("compaction", "subagent.md");
 var SUMMARIZABLE_SUBAGENTS = ["visualDesignExpert", "productVision"];
-async function compactConversation(state, apiConfig) {
+async function compactConversation(state, apiConfig, system, tools2) {
   const insertionIndex = findSafeInsertionPoint(state.messages);
   const summaries = [];
   const tasks = [];
@@ -664,7 +664,9 @@ async function compactConversation(state, apiConfig) {
         apiConfig,
         "conversation",
         CONVERSATION_SUMMARY_PROMPT,
-        conversationMessages
+        conversationMessages,
+        system,
+        tools2
       ).then((text) => {
         if (text) {
           summaries.push({ name: "conversation", text });
@@ -684,7 +686,9 @@ async function compactConversation(state, apiConfig) {
           apiConfig,
           name,
           SUBAGENT_SUMMARY_PROMPT,
-          subagentMessages
+          subagentMessages,
+          system,
+          tools2
         ).then((text) => {
           if (text) {
             summaries.push({ name, text });
@@ -811,22 +815,33 @@ function serializeForSummary(messages) {
     return `[${msg.role}]: ${parts.join("\n")}`;
   }).join("\n\n");
 }
-async function generateSummary(apiConfig, name, systemPrompt, messagesToSummarize) {
+async function generateSummary(apiConfig, name, compactionPrompt, messagesToSummarize, mainSystem, mainTools) {
   const serialized = serializeForSummary(messagesToSummarize);
   if (!serialized.trim()) {
     return null;
   }
   log4.info("Generating summary", {
     name,
-    messageCount: messagesToSummarize.length
+    messageCount: messagesToSummarize.length,
+    cacheReuse: !!mainSystem
   });
   let summaryText = "";
+  const useMainCache = !!mainSystem;
+  const system = useMainCache ? mainSystem : compactionPrompt;
+  const tools2 = useMainCache ? mainTools ?? [] : [];
+  const userContent = useMainCache ? `${compactionPrompt}
+
+---
+
+Conversation to summarize:
+
+${serialized}` : serialized;
   for await (const event of streamChat({
     ...apiConfig,
     subAgentId: "conversationSummarizer",
-    system: systemPrompt,
-    messages: [{ role: "user", content: serialized }],
-    tools: []
+    system,
+    messages: [{ role: "user", content: userContent }],
+    tools: tools2
   })) {
     if (event.type === "text") {
       summaryText += event.text;
@@ -934,6 +949,7 @@ function getHeadingTree(content) {
 // src/tools/spec/readSpec.ts
 var DEFAULT_MAX_LINES = 500;
 var readSpecTool = {
+  clearable: true,
   definition: {
     name: "readSpec",
     description: "Read a spec file from src/ with line numbers. Always read a spec file before editing it. Paths are relative to the project root and must start with src/ (e.g., src/app.md, src/interfaces/web.md).",
@@ -1035,6 +1051,7 @@ function unifiedDiff(filePath, oldText, newText) {
 
 // src/tools/spec/writeSpec.ts
 var writeSpecTool = {
+  clearable: true,
   definition: {
     name: "writeSpec",
     description: "Create a new spec file or completely overwrite an existing one in src/. Parent directories are created automatically. Use this for new spec files or full rewrites. For targeted changes to existing specs, use editSpec instead.",
@@ -1088,6 +1105,7 @@ ${unifiedDiff(input.path, oldContent ?? "", input.content)}`;
 // src/tools/spec/editSpec.ts
 import fs7 from "fs/promises";
 var editSpecTool = {
+  clearable: true,
   definition: {
     name: "editSpec",
     description: 'Make targeted edits to a spec file by heading path. This is the primary tool for modifying existing specs. Each edit targets a section by its heading hierarchy (e.g., "Vendors > Approval Flow") and applies an operation. Multiple edits are applied in order.',
@@ -1201,6 +1219,7 @@ ${tree}`;
 import fs8 from "fs/promises";
 import path5 from "path";
 var listSpecFilesTool = {
+  clearable: false,
   definition: {
     name: "listSpecFiles",
     description: "List all files in the src/ directory (spec files, brand guidelines, interface specs, references). Use this to understand what spec files exist before reading or editing them.",
@@ -1251,6 +1270,7 @@ async function listRecursive(dir) {
 
 // src/tools/spec/clearSyncStatus.ts
 var clearSyncStatusTool = {
+  clearable: false,
   definition: {
     name: "clearSyncStatus",
     description: "Clear the sync status flags after syncing spec and code. Call this after finishing a sync operation.",
@@ -1266,6 +1286,7 @@ var clearSyncStatusTool = {
 
 // src/tools/spec/presentSyncPlan.ts
 var presentSyncPlanTool = {
+  clearable: false,
   definition: {
     name: "presentSyncPlan",
     description: "Present a structured sync plan to the user for approval. Write a clear markdown summary of what changed and what you intend to update. The user will see this in a full-screen view and can approve or dismiss. Call this BEFORE making any sync edits.",
@@ -1288,6 +1309,7 @@ var presentSyncPlanTool = {
 
 // src/tools/spec/presentPublishPlan.ts
 var presentPublishPlanTool = {
+  clearable: false,
   definition: {
     name: "presentPublishPlan",
     description: "Present a publish changelog to the user for approval. Write a clear markdown summary of what changed since the last deploy. The user will see this in a full-screen view and can approve or dismiss. Call this BEFORE committing or pushing.",
@@ -1310,6 +1332,7 @@ var presentPublishPlanTool = {
 
 // src/tools/spec/presentPlan.ts
 var presentPlanTool = {
+  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.",
@@ -1332,19 +1355,16 @@ var presentPlanTool = {
 
 // src/tools/common/setProjectOnboardingState.ts
 var setProjectOnboardingStateTool = {
+  clearable: false,
   definition: {
     name: "setProjectOnboardingState",
-    description: "Advance the project onboarding state. Call at natural transition points: before writing the first spec (initialSpecAuthoring), before starting the first code generation (initialCodegen), after the first build succeeds (onboardingFinished). Forward-only progression.",
+    description: "Advance the project onboarding state. Call at natural transition points: after writing the first draft of the spec (initialSpecReview), before starting the first code generation (initialCodegen), after the first build succeeds (onboardingFinished). Forward-only progression.",
     inputSchema: {
       type: "object",
       properties: {
         state: {
           type: "string",
-          enum: [
-            "initialSpecAuthoring",
-            "initialCodegen",
-            "onboardingFinished"
-          ],
+          enum: ["initialSpecReview", "initialCodegen", "onboardingFinished"],
           description: "The onboarding state to advance to."
         }
       },
@@ -1358,6 +1378,7 @@ var setProjectOnboardingStateTool = {
 
 // src/tools/common/promptUser.ts
 var promptUserTool = {
+  clearable: false,
   definition: {
     name: "promptUser",
     description: 'Ask the user structured questions. Choose type first: "form" for structured intake (5+ questions, takes over screen), "inline" for quick clarifications or confirmations. Blocks until the user responds. Result contains `_dismissed: true` if the user dismisses without answering.',
@@ -1489,6 +1510,7 @@ ${lines.join("\n")}`;
 
 // src/tools/common/confirmDestructiveAction.ts
 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.",
@@ -1600,9 +1622,10 @@ function runCli(cmd, options) {
 
 // src/subagents/sdkConsultant/index.ts
 var askMindStudioSdkTool = {
+  clearable: false,
   definition: {
     name: "askMindStudioSdk",
-    description: "@mindstudio-ai/agent SDK expert. Knows every action, model, connector, and configuration option. Returns architectural guidance and working code. Describe what you want to build, not just what API method you need. Batch related questions into a single query.",
+    description: "@mindstudio-ai/agent backend SDK expert. Knows every backend action, AI model, connector, and configuration option. Returns architectural guidance and working code. Only covers the backend SDK (@mindstudio-ai/agent) \u2014 do NOT use for frontend/interface SDK questions (@mindstudio-ai/interface) like file uploads, auth, or client-side APIs. Describe what you want to build, not just what API method you need. Batch related questions into a single query.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1626,6 +1649,7 @@ var askMindStudioSdkTool = {
 
 // src/tools/common/searchGoogle.ts
 var searchGoogleTool = {
+  clearable: false,
   definition: {
     name: "searchGoogle",
     description: "Search Google and return results. Use for research, finding documentation, looking up APIs, or any task where web search would help.",
@@ -1651,6 +1675,7 @@ var searchGoogleTool = {
 
 // src/tools/common/setProjectMetadata.ts
 var setProjectMetadataTool = {
+  clearable: false,
   definition: {
     name: "setProjectMetadata",
     description: "Set project metadata. Can update any combination of: display name, app icon, and Open Graph share image. Provide only the fields you want to change.",
@@ -1690,6 +1715,7 @@ function isBinary(buffer) {
   return false;
 }
 var readFileTool = {
+  clearable: true,
   definition: {
     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).",
@@ -1751,6 +1777,7 @@ var readFileTool = {
 import fs10 from "fs/promises";
 import path6 from "path";
 var writeFileTool = {
+  clearable: true,
   definition: {
     name: "writeFile",
     description: "Create a new file or completely overwrite an existing one. Parent directories are created automatically. Use this for new files or full rewrites. For targeted changes to existing files, use editFile instead \u2014 it preserves the parts you don't want to change and avoids errors from forgetting to include unchanged code.",
@@ -1894,6 +1921,7 @@ function formatOccurrenceError(count, lines, filePath) {
 
 // src/tools/code/editFile/index.ts
 var editFileTool = {
+  clearable: true,
   definition: {
     name: "editFile",
     description: "Replace a string in a file. old_string must appear exactly once (minor indentation differences are handled automatically). Set replace_all to true to replace every occurrence at once. For bulk mechanical substitutions (renaming a variable, swapping colors), prefer replace_all. Always read the file first so you know the exact text to match. When editing nested structures (objects, function bodies, arrays, template literals), always include the full enclosing structure in old_string rather than just an inner fragment. Replacing a partial slice from the middle of nested code is the most common source of syntax errors.",
@@ -1981,6 +2009,7 @@ import { exec } from "child_process";
 var DEFAULT_TIMEOUT_MS = 12e4;
 var DEFAULT_MAX_LINES3 = 500;
 var bashTool = {
+  clearable: true,
   definition: {
     name: "bash",
     description: "Run a shell command and return stdout + stderr. 120-second timeout by default (configurable). Use for: npm install/build/test, git operations, tsc --noEmit, or any CLI tool. Prefer dedicated tools over bash when available (use grep instead of bash + rg, readFile instead of bash + cat). Output is truncated to 500 lines by default.",
@@ -2064,6 +2093,7 @@ function formatResults(stdout, max) {
   return result;
 }
 var grepTool = {
+  clearable: true,
   definition: {
     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.",
@@ -2119,6 +2149,7 @@ var grepTool = {
 import fg from "fast-glob";
 var DEFAULT_MAX2 = 200;
 var globTool = {
+  clearable: true,
   definition: {
     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.',
@@ -2165,6 +2196,7 @@ var globTool = {
 // src/tools/code/listDir.ts
 import fs12 from "fs/promises";
 var listDirTool = {
+  clearable: true,
   definition: {
     name: "listDir",
     description: "List the contents of a directory. Shows entries with / suffix for directories, sorted directories-first then alphabetically. Use this for a quick overview of a directory's contents. For finding files across the whole project, use glob instead.",
@@ -2200,6 +2232,7 @@ var listDirTool = {
 
 // src/tools/code/editsFinished.ts
 var editsFinishedTool = {
+  clearable: false,
   definition: {
     name: "editsFinished",
     description: "Signal that file edits are complete. Call this after you finish writing/editing files so the live preview updates cleanly. The preview is paused while you edit to avoid showing broken intermediate states \u2014 this unpauses it. If you forget to call this, the preview updates when your turn ends.",
@@ -2216,6 +2249,7 @@ var editsFinishedTool = {
 
 // src/tools/code/lspDiagnostics.ts
 var lspDiagnosticsTool = {
+  clearable: true,
   definition: {
     name: "lspDiagnostics",
     description: "Get TypeScript diagnostics (type errors, warnings) for a file, with suggested fixes when available. Use this after editing a file to check for errors.",
@@ -2264,6 +2298,7 @@ var lspDiagnosticsTool = {
 
 // src/tools/code/restartProcess.ts
 var restartProcessTool = {
+  clearable: false,
   definition: {
     name: "restartProcess",
     description: "Restart a managed sandbox process. Use this after running npm install or changing package.json to restart the dev server so it picks up new dependencies.",
@@ -2290,6 +2325,7 @@ var restartProcessTool = {
 
 // src/tools/code/runScenario.ts
 var runScenarioTool = {
+  clearable: true,
   definition: {
     name: "runScenario",
     description: "Run a scenario to seed the dev database with test data. Truncates all tables first, then executes the seed function and impersonates the scenario roles. Blocks until complete. Scenario IDs are defined in mindstudio.json. If it fails, check .logs/tunnel.log or .logs/requests.ndjson for details. Return synchronously - no need to sleep before checking results.",
@@ -2311,6 +2347,7 @@ var runScenarioTool = {
 
 // src/tools/code/runMethod.ts
 var runMethodTool = {
+  clearable: true,
   definition: {
     name: "runMethod",
     description: "Run a method in the dev environment and return the result. Use for testing methods after writing or modifying them. Returns output, captured console output, errors with stack traces, and duration. If it fails, check .logs/tunnel.log or .logs/requests.ndjson for more details. Return synchronously - no need to sleep before checking results.",
@@ -2393,6 +2430,7 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
 
 // src/tools/code/screenshot.ts
 var screenshotTool = {
+  clearable: true,
   definition: {
     name: "screenshot",
     description: "Capture a full-height screenshot of the app preview and get a description of what's on screen. Provides static image analysis only, will not capture animations or video. Optionally provide specific questions about what you're looking for. Use a bulleted list to ask many questions at once. To ask additional questions about a screenshot you have already captured, pass its URL as imageUrl to skip recapture.",
@@ -2651,6 +2689,7 @@ async function runSubAgent(config) {
   const fullSystem = `${system}
 
 Current date: ${dateStr}`;
+  const excludeToolsFromClearing = tools2.filter((t) => t.clearable === false).map((t) => t.name);
   let turns = 0;
   const run = async () => {
     const messages = [
@@ -2714,6 +2753,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
             system: fullSystem,
             messages: cleanMessagesForApi(messages),
             tools: tools2,
+            excludeToolsFromClearing,
             signal
           },
           {
@@ -2964,6 +3004,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
 // src/subagents/browserAutomation/tools.ts
 var BROWSER_TOOLS = [
   {
+    clearable: true,
     name: "browserCommand",
     description: "Interact with the app's live preview by sending browser commands. Commands execute sequentially with an animated cursor. Always start with a snapshot to see the current state and get ref identifiers. The result includes a snapshot field with the final page state after all steps complete. On error, the failing step has an error field and execution stops. Timeout: 120s.",
     inputSchema: {
@@ -3044,6 +3085,7 @@ var BROWSER_TOOLS = [
     }
   },
   {
+    clearable: true,
     name: "screenshotFullPage",
     description: "Capture a full-height screenshot of the current page. Returns a CDN URL with full text analysis and description.",
     inputSchema: {
@@ -3057,6 +3099,7 @@ var BROWSER_TOOLS = [
     }
   },
   {
+    clearable: false,
     name: "resetBrowser",
     description: "Reset the browser to a clean state. Call this once after all tests are complete to restore the preview for the user. Fire and forget \u2014 does not wait for the reload to finish.",
     inputSchema: {
@@ -3088,6 +3131,7 @@ ${appSpec}
 // src/subagents/browserAutomation/index.ts
 var log6 = createLogger("browser-automation");
 var browserAutomationTool = {
+  clearable: true,
   definition: {
     name: "runAutomatedBrowserTest",
     description: "Run an automated browser test against the live preview. Describe what to test \u2014 the agent figures out how. Use after meaningful changes frontend code, to reproduce user-reported issues, or to test end-to-end flows.",
@@ -3209,6 +3253,7 @@ __export(searchGoogle_exports, {
   execute: () => execute
 });
 var definition = {
+  clearable: false,
   name: "searchGoogle",
   description: 'Search Google for web results. Reserch modern design trends in industries or verticals, "best [domain] apps 2026", ui patterns, or find something specific if the the user has an explicit reference. Searching for and reading case studies is a great way to get information and context about a project\'s domain. Prioritize authoritative sources like Figma and other design leaders, avoid random blog spam. Pick one or more URLs from the results and then use `scrapeWebUrl` to get their text content.',
   inputSchema: {
@@ -3236,6 +3281,7 @@ __export(scrapeWebUrl_exports, {
   execute: () => execute2
 });
 var definition2 = {
+  clearable: false,
   name: "scrapeWebUrl",
   description: "Fetch the content of a web page as markdown. Use when reading sites from search results or specific things the user wants to incorporate.",
   inputSchema: {
@@ -3290,6 +3336,7 @@ Identify the specific design moves that make this page interesting and unique, d
 Respond only with your analysis as Markdown and absolutely no other text. Do not use emojis - use unicode if you need symbols.
 `;
 var definition3 = {
+  clearable: false,
   name: "analyzeDesign",
   description: "Analyze the visual design of a website or image URL. Websites are automatically screenshotted first. Provides static image analysis only, will not capture animations or video. If no prompt is provided, performs a full design reference analysis (mood, color, typography, layout, distinctiveness). Provide a custom prompt to ask a specific design question instead. Use a bulleted list to ask many questions at once.",
   inputSchema: {
@@ -3338,6 +3385,7 @@ __export(analyzeImage_exports, {
 });
 var DEFAULT_PROMPT = "Describe everything visible in this image \u2014 every element, its position, its size relative to the frame, its colors, its content. Be comprehensive, thorough and spatial. After the inventory, note anything that looks visually broken (overlapping elements, clipped text, misaligned components). Respond only with your analysis as Markdown and absolutely no other text. Do not use emojis - use unicode if you need symbols.";
 var definition4 = {
+  clearable: true,
   name: "analyzeImage",
   description: "Analyze an image by URL using a vision model. Provides static image analysis only, will not capture animations or video. Returns an objective description of what is visible \u2014 shapes, colors, layout, text, artifacts. Use for factual inventory of image contents, not for subjective design judgment - the vision model providing the analysis has no sense of design. You are the design expert - use the analysis tool for factual inventory, then apply your own expertise for quality and suitability assessments. Optionally provide specific questions about what you're looking for. Use a bulleted list to ask many questions at once. If you are analyzing a screenshot of the app preview, you can reuse the same screenshot URL multiple times to ask multiple questions.",
   inputSchema: {
@@ -3373,6 +3421,7 @@ __export(screenshot_exports, {
   execute: () => execute5
 });
 var definition5 = {
+  clearable: true,
   name: "screenshot",
   description: "Capture a full-height screenshot of the current app preview. Returns a CDN URL along with visual analysis. Use to review the current state of the UI being built. Remember, the screenshot analysis is not overly precise - for example, it cannot reliably identify specific fonts by name \u2014 it can only describe what letterforms look like.",
   inputSchema: {
@@ -3575,6 +3624,7 @@ async function generateImageAssets(opts) {
 
 // src/subagents/designExpert/tools/images/generateImages.ts
 var definition6 = {
+  clearable: false,
   name: "generateImages",
   description: "Generate images. Returns CDN URLs with a quality analysis for each image. Produces high-quality results for everything from photorealistic images and abstract/creative visuals. Pass multiple prompts to generate in parallel. No need to analyze images separately after generating \u2014 the analysis is included.",
   inputSchema: {
@@ -3620,6 +3670,7 @@ __export(editImages_exports, {
   execute: () => execute7
 });
 var definition7 = {
+  clearable: false,
   name: "editImages",
   description: "Edit or transform existing images. Provide one or more source image URLs as reference and a prompt describing the desired edit. Use for compositing, style transfer, subject transformation, blending multiple references, or incorporating one or more references into something new. Returns CDN URLs with analysis.",
   inputSchema: {
@@ -3739,15 +3790,19 @@ function loadPlatformBrief() {
   return `<platform_brief>
 ## What is a MindStudio app?
 
-A MindStudio app is a managed TypeScript project with three layers: a spec (natural language in src/), a backend contract (methods, tables, roles in dist/), and one or more interfaces (web, API, bots, cron, etc.). The spec is the source of truth; code is derived from it.
+A MindStudio app is a managed full-stack TypeScript project with three layers: a spec (natural language in src/), a backend contract (methods, tables, roles in dist/), and one or more interfaces (web, API, bots, cron, etc.). The spec is the source of truth; code is derived from it.
+
+This is a capable, stable platform used in production by 100k+ users. Build with confidence \u2014 you're building production-grade apps, not fragile prototypes.
 
 ## What people build
 
-- Business tools \u2014 dashboards, admin panels, approval workflows, data entry apps, internal tools with role-based access
-- AI-powered apps \u2014 chatbots, content generators, document processors, image/video tools, AI agents that take actions
+- Business tools \u2014 client portals, approval workflows, admin panels with role-based access
+- AI-powered apps \u2014 document processors, image/video tools, content generators, conversational agents that take actions
+- Full-stack web apps \u2014 social platforms, membership sites, marketplaces, booking systems, community hubs \u2014 multi-user apps with auth, data, UI
 - Automations with no UI \u2014 cron jobs, webhook handlers, email processors, data sync pipelines
+- Marketing & launch pages \u2014 landing pages, waitlist pages with referral mechanics, product sites with scroll animations
 - Bots \u2014 Discord slash-command bots, Telegram bots, MCP tool servers for AI assistants
-- Creative/interactive projects \u2014 games, interactive visualizations, generative art, portfolio sites
+- Creative/interactive projects \u2014 browser games with p5.js or Three.js, interactive visualizations, generative art, portfolio sites
 - API services \u2014 backend logic exposed as REST endpoints
 - Simple static sites \u2014 no backend needed, just a web interface with a build step
 
@@ -3772,13 +3827,12 @@ Each interface type invokes the same backend methods. Methods don't know which i
 TypeScript running in a sandboxed environment. Any npm package can be installed. Key capabilities:
 
 - Managed SQLite database with typed schemas and automatic migrations. Define a TypeScript interface, push, and the platform handles diffing and migrating.
-- Built-in role-based auth. Define roles in the manifest, gate methods with auth.requireRole(). Platform handles sessions, tokens, user resolution.
-- Sandboxed execution with npm packages pre-installed.
+- Built-in app-managed auth. Opt-in via manifest \u2014 developer builds login UI, platform handles verification codes (email/SMS), cookie sessions, and role enforcement. Backend methods use auth.requireRole() for access control.
 - Git-native deployment. Push to default branch to deploy.
 
 ## MindStudio SDK
 
-The first-party SDK (@mindstudio-ai/agent) provides access to 200+ AI models (OpenAI, Anthropic, Google, Meta, Mistral, and more) and 1000+ integrations (email, SMS, Slack, HubSpot, Google Workspace, web scraping, image/video generation, media processing, and much more) with zero configuration \u2014 credentials are handled automatically in the execution environment. No API keys needed.
+The first-party SDK (@mindstudio-ai/agent) provides access to 200+ AI models (OpenAI, Anthropic, Google, Meta, Mistral, and more) and 1000+ integrations (email, SMS, Slack, HubSpot, Google Workspace, web scraping, image/video generation, media processing, and much more) with zero configuration \u2014 credentials are handled automatically in the execution environment. No API keys needed. This SDK is robust and battle-tested in production.
 
 ## What MindStudio apps are NOT good for
 
@@ -3975,6 +4029,7 @@ var DESCRIPTION = `
 Visual design expert. Describe the situation and what you need \u2014 the agent decides what to deliver. It reads the spec files automatically. Include relevant user requirements and context it can't get from the spec, but do not list specific deliverables or tell it how to do its job. Do not suggest implementation details or ideas - only relay what is needed.
 `.trim();
 var designExpertTool = {
+  clearable: false,
   definition: {
     name: "visualDesignExpert",
     description: DESCRIPTION,
@@ -4275,6 +4330,7 @@ function getProductVisionPrompt() {
 
 // src/subagents/productVision/index.ts
 var productVisionTool = {
+  clearable: false,
   definition: {
     name: "productVision",
     description: "Owns the product roadmap. Reads spec and roadmap files automatically. Creates, updates, and deletes roadmap items in src/roadmap/. Describe the situation and what needs to happen.",
@@ -4423,6 +4479,7 @@ var SANITY_CHECK_TOOLS = [
 // src/subagents/codeSanityCheck/index.ts
 var BASE_PROMPT3 = readAsset("subagents/codeSanityCheck", "prompt.md");
 var codeSanityCheckTool = {
+  clearable: false,
   definition: {
     name: "codeSanityCheck",
     description: 'Quick sanity check on an approach before building. Reviews architecture, package choices, and flags potential issues. Usually responds with "looks good." Occasionally catches something important. Readonly \u2014 can search the web and read code but cannot modify anything.',
@@ -4471,6 +4528,7 @@ var codeSanityCheckTool = {
 
 // src/tools/common/scrapeWebUrl.ts
 var scrapeWebUrlTool = {
+  clearable: false,
   definition: {
     name: "scrapeWebUrl",
     description: "Scrape the content of a web page. Returns the HTML of the page as markdown text. Optionally capture a screenshot if you need see the visual design. Use this when you need to fetch or analyze content from a website",
@@ -4543,6 +4601,9 @@ var ALL_TOOLS = [
   lspDiagnosticsTool,
   restartProcessTool
 ];
+var CLEARABLE_TOOLS = new Set(
+  ALL_TOOLS.filter((t) => t.clearable).map((t) => t.definition.name)
+);
 function getToolDefinitions(_onboardingState) {
   return ALL_TOOLS.map((t) => t.definition);
 }
@@ -4863,6 +4924,7 @@ async function runTurn(params) {
     onBackgroundComplete
   } = params;
   const tools2 = getToolDefinitions(onboardingState);
+  const excludeToolsFromClearing = tools2.filter((t) => !CLEARABLE_TOOLS.has(t.name)).map((t) => t.name);
   log8.info("Turn started", {
     requestId,
     model,
@@ -4872,11 +4934,17 @@ async function runTurn(params) {
     }
   });
   onEvent({ type: "turn_started" });
+  const hasText = userMessage.trim().length > 0;
+  const hasAttachments = attachments && attachments.length > 0;
+  if (!hasText && !hasAttachments) {
+    onEvent({ type: "error", error: "Empty message" });
+    return;
+  }
   const userMsg = { role: "user", content: userMessage };
   if (hidden) {
     userMsg.hidden = true;
   }
-  if (attachments && attachments.length > 0) {
+  if (hasAttachments) {
     userMsg.attachments = attachments;
   }
   state.messages.push(userMsg);
@@ -5002,6 +5070,7 @@ async function runTurn(params) {
           system,
           messages: cleanMessagesForApi(state.messages),
           tools: tools2,
+          excludeToolsFromClearing,
           signal
         },
         {
@@ -5474,6 +5543,7 @@ async function startHeadless(opts = {}) {
   let currentAbort = null;
   let currentRequestId;
   let completedEmitted = false;
+  let turnStart = 0;
   const EXTERNAL_TOOL_TIMEOUT_MS = 3e5;
   const pendingTools = /* @__PURE__ */ new Map();
   const earlyResults = /* @__PURE__ */ new Map();
@@ -5586,8 +5656,8 @@ ${xmlParts}
   function onEvent(e) {
     const rid = currentRequestId;
     switch (e.type) {
-      // Suppressed — caller already knows the request started
       case "turn_started":
+        emit("turn_started", {}, rid);
         return;
       // Terminal events — translate to `completed`
       case "turn_done":
@@ -5606,7 +5676,11 @@ ${xmlParts}
           writeFileSync(".remy-stats.json", JSON.stringify(sessionStats));
         } catch {
         }
-        emit("completed", { success: true }, rid);
+        emit(
+          "completed",
+          { success: true, durationMs: Date.now() - turnStart },
+          rid
+        );
         setTimeout(() => {
           applyPendingBlockUpdates();
           flushBackgroundQueue();
@@ -5746,7 +5820,7 @@ ${xmlParts}
     currentRequestId = requestId;
     currentAbort = new AbortController();
     completedEmitted = false;
-    const turnStart = Date.now();
+    turnStart = Date.now();
     const attachments = parsed.attachments;
     if (attachments?.length) {
       console.warn(
@@ -5891,7 +5965,9 @@ ${xmlParts}
         writeFileSync(".remy-stats.json", JSON.stringify(sessionStats));
       } catch {
       }
-      compactConversation(state, config).then(() => {
+      const compactSystem = buildSystemPrompt("onboardingFinished");
+      const compactTools = getToolDefinitions("onboardingFinished");
+      compactConversation(state, config, compactSystem, compactTools).then(() => {
         saveSession(state);
         emit("compaction_complete", {}, requestId);
         emit("completed", { success: true }, requestId);