@mindstudio-ai/remy 0.1.184 → 0.1.186

package/dist/headless.js

@@ -2902,6 +2902,82 @@ function acquireBrowserLock() {
   return wait.then(() => release);
 }
 
+// src/toolRegistry.ts
+var log5 = createLogger("tool-registry");
+var USER_CANCELLED_RESULT = "[USER CANCELLED] The user manually cancelled this tool. Do not retry it automatically \u2014 wait for the user\u2019s next message for direction.";
+var ToolRegistry = class {
+  entries = /* @__PURE__ */ new Map();
+  onEvent;
+  register(entry) {
+    this.entries.set(entry.id, entry);
+  }
+  unregister(id) {
+    this.entries.delete(id);
+  }
+  get(id) {
+    return this.entries.get(id);
+  }
+  /**
+   * Stop a running tool.
+   *
+   * - graceful: abort and settle with [INTERRUPTED] + partial result
+   * - hard: abort and settle with a generic error
+   *
+   * Returns true if the tool was found and stopped.
+   */
+  stop(id, mode) {
+    const entry = this.entries.get(id);
+    if (!entry) {
+      return false;
+    }
+    log5.info("Tool stopped", { toolCallId: id, name: entry.name, mode });
+    entry.abortController.abort(mode);
+    if (mode === "graceful") {
+      const partial = entry.getPartialResult?.() ?? "";
+      const result = partial ? `[INTERRUPTED]
+
+${partial}` : "[INTERRUPTED] Tool execution was stopped.";
+      entry.settle(result, false);
+    } else {
+      entry.settle(USER_CANCELLED_RESULT, true);
+    }
+    this.onEvent?.({
+      type: "tool_stopped",
+      id: entry.id,
+      name: entry.name,
+      mode,
+      ...entry.parentToolId && { parentToolId: entry.parentToolId }
+    });
+    this.entries.delete(id);
+    return true;
+  }
+  /**
+   * Restart a running tool with the same or patched input.
+   * The original controllable promise stays pending and settles
+   * when the new execution finishes.
+   *
+   * Returns true if the tool was found and restarted.
+   */
+  restart(id, patchedInput) {
+    const entry = this.entries.get(id);
+    if (!entry) {
+      return false;
+    }
+    log5.info("Tool restarted", { toolCallId: id, name: entry.name });
+    entry.abortController.abort("restart");
+    const newInput = patchedInput ? { ...entry.input, ...patchedInput } : entry.input;
+    this.onEvent?.({
+      type: "tool_restarted",
+      id: entry.id,
+      name: entry.name,
+      input: newInput,
+      ...entry.parentToolId && { parentToolId: entry.parentToolId }
+    });
+    entry.rerun(newInput);
+    return true;
+  }
+};
+
 // src/statusWatcher.ts
 function startStatusWatcher(config) {
   const { apiConfig, getContext, onStatus, interval = 5e3, signal } = config;
@@ -3147,7 +3223,7 @@ ${content}` : attachmentHeader;
 }
 
 // src/subagents/runner.ts
-var log5 = createLogger("sub-agent");
+var log6 = createLogger("sub-agent");
 async function runSubAgent(config) {
   const {
     system,
@@ -3174,7 +3250,7 @@ async function runSubAgent(config) {
   const signal = background ? bgAbort.signal : parentSignal;
   const agentName = subAgentId || "sub-agent";
   const runStart = Date.now();
-  log5.info("Sub-agent started", { requestId, parentToolId, agentName });
+  log6.info("Sub-agent started", { requestId, parentToolId, agentName });
   const emit = (e) => {
     onEvent({ ...e, parentToolId });
   };
@@ -3209,7 +3285,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
           messages: thisInvocation()
         };
       }
-      return { text: "Error: cancelled", messages: thisInvocation() };
+      return { text: USER_CANCELLED_RESULT, messages: thisInvocation() };
     }
     let lastToolResult = "";
     while (true) {
@@ -3391,7 +3467,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
           ...hasArtifacts ? { artifacts } : {}
         };
       }
-      log5.info("Tools executing", {
+      log6.info("Tools executing", {
         requestId,
         parentToolId,
         count: toolCalls.length,
@@ -3401,7 +3477,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
       const results = await Promise.all(
         toolCalls.map(async (tc) => {
           if (signal?.aborted) {
-            return { id: tc.id, result: "Error: cancelled", isError: true };
+            return { id: tc.id, result: USER_CANCELLED_RESULT, isError: true };
           }
           let settle;
           const resultPromise = new Promise((res) => {
@@ -3468,7 +3544,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
           run2(tc.input);
           const r = await resultPromise;
           toolRegistry?.unregister(tc.id);
-          log5.info("Tool completed", {
+          log6.info("Tool completed", {
             requestId,
             parentToolId,
             toolCallId: tc.id,
@@ -3519,7 +3595,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
   const wrapRun = async () => {
     try {
       const result = await run();
-      log5.info("Sub-agent complete", {
+      log6.info("Sub-agent complete", {
         requestId,
         parentToolId,
         agentName,
@@ -3528,7 +3604,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
       });
       return result;
     } catch (err) {
-      log5.warn("Sub-agent error", {
+      log6.warn("Sub-agent error", {
         requestId,
         parentToolId,
         agentName,
@@ -3540,7 +3616,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
   if (!background) {
     return wrapRun();
   }
-  log5.info("Sub-agent backgrounded", { requestId, parentToolId, agentName });
+  log6.info("Sub-agent backgrounded", { requestId, parentToolId, agentName });
   toolRegistry?.register({
     id: parentToolId,
     name: agentName,
@@ -3722,14 +3798,14 @@ ${appSpec}
 // src/models/surfaces.ts
 var MODEL_SURFACES = {
   parent: {
-    default: "claude-4-7-opus",
+    default: "claude-4-8-opus",
     label: "Remy",
     description: "The main Remy agent you chat with about your product. Writes code and manages delegation to other agents.",
     modelType: "text",
     userPickable: true
   },
   visualDesignExpert: {
-    default: "claude-4-7-opus",
+    default: "claude-4-8-opus",
     label: "Design Agent",
     description: "Designs your product's interfaces, including components, layouts, typography, color, and visual identity.",
     modelType: "text",
@@ -3796,6 +3872,7 @@ var MODEL_SURFACES = {
 };
 var ALLOWED_MODELS_BY_TYPE = {
   text: [
+    "claude-4-8-opus",
     "claude-4-7-opus",
     "claude-4-6-opus",
     "claude-4-6-sonnet",
@@ -3813,7 +3890,7 @@ function resolveModel(surfaceId, models, fallback) {
 }
 
 // src/subagents/browserAutomation/index.ts
-var log6 = createLogger("browser-automation");
+var log7 = createLogger("browser-automation");
 async function runBrowserAutomation(task, context) {
   const release = await acquireBrowserLock();
   try {
@@ -3905,7 +3982,7 @@ async function runBrowserAutomation(task, context) {
                   }
                 }
               } catch {
-                log6.debug("Failed to parse batch analysis result", {
+                log7.debug("Failed to parse batch analysis result", {
                   batchResult
                 });
               }
@@ -5572,7 +5649,7 @@ function executeTool(name, input, context) {
 }
 
 // src/compaction/trigger.ts
-var log7 = createLogger("compaction:trigger");
+var log8 = createLogger("compaction:trigger");
 var pendingSummaries = [];
 var inflightCompaction = null;
 function getPendingSummaries() {
@@ -5599,11 +5676,11 @@ function triggerCompaction(state, apiConfig, opts = {}) {
   ).then((summaries) => {
     pendingSummaries.push(...summaries);
     listener?.({ type: "complete", requestId });
-    log7.info("Compaction complete");
+    log8.info("Compaction complete");
   }).catch((err) => {
     const message = err.message || "Compaction failed";
     listener?.({ type: "complete", error: message, requestId });
-    log7.error("Compaction failed", { error: message });
+    log8.error("Compaction failed", { error: message });
     throw err;
   }).finally(() => {
     inflightCompaction = null;
@@ -5615,7 +5692,7 @@ function triggerCompaction(state, apiConfig, opts = {}) {
 import fs20 from "fs";
 import path10 from "path";
 import { createHash } from "crypto";
-var log8 = createLogger("brandExtraction");
+var log9 = createLogger("brandExtraction");
 var EXTRACT_PROMPT = readAsset("brandExtraction", "extract.md");
 var BRAND_FILE = ".remy-brand.json";
 var CACHE_FILE = ".remy-brand.cache.json";
@@ -5623,17 +5700,17 @@ async function runExtraction(apiConfig, model) {
   const inputHash = computeInputHash();
   const cached2 = readCache();
   if (cached2 && cached2.inputHash === inputHash) {
-    log8.debug("Brand inputs unchanged \u2014 skipping extraction", { inputHash });
+    log9.debug("Brand inputs unchanged \u2014 skipping extraction", { inputHash });
     return null;
   }
-  log8.info("Extracting brand", { inputHash });
+  log9.info("Extracting brand", { inputHash });
   const brand = await extractBrand(apiConfig, model);
   if (!brand) {
-    log8.warn("Brand extraction failed \u2014 leaving cache untouched");
+    log9.warn("Brand extraction failed \u2014 leaving cache untouched");
     return null;
   }
   persistBrand(brand, inputHash);
-  log8.info("Brand persisted", { inputHash });
+  log9.info("Brand persisted", { inputHash });
   return brand;
 }
 function computeInputHash() {
@@ -5699,7 +5776,7 @@ function parseFrontmatter3(filePath) {
 async function extractBrand(apiConfig, model) {
   const corpus = buildCorpus();
   if (!corpus.trim()) {
-    log8.debug("No spec corpus \u2014 emitting empty brand");
+    log9.debug("No spec corpus \u2014 emitting empty brand");
     return { version: 1 };
   }
   let responseText = "";
@@ -5730,17 +5807,17 @@ async function extractBrand(apiConfig, model) {
           toolNames: []
         });
       } else if (event.type === "error") {
-        log8.error("Brand extraction stream error", { error: event.error });
+        log9.error("Brand extraction stream error", { error: event.error });
         return null;
       }
     }
   } catch (err) {
-    log8.error("Brand extraction threw", { error: err?.message });
+    log9.error("Brand extraction threw", { error: err?.message });
     return null;
   }
   const parsed = parseJsonResponse(responseText);
   if (!parsed) {
-    log8.warn("Brand extraction returned unparseable JSON", {
+    log9.warn("Brand extraction returned unparseable JSON", {
       preview: responseText.slice(0, 200)
     });
     return null;
@@ -5882,7 +5959,7 @@ function readCache() {
 }
 
 // src/brandExtraction/trigger.ts
-var log9 = createLogger("brandExtraction:trigger");
+var log10 = createLogger("brandExtraction:trigger");
 var inflight = false;
 var dirty = false;
 function triggerBrandExtraction(apiConfig, model) {
@@ -5892,7 +5969,7 @@ function triggerBrandExtraction(apiConfig, model) {
   }
   inflight = true;
   void runExtraction(apiConfig, model).catch((err) => {
-    log9.error("Brand extraction failed", { error: err?.message });
+    log10.error("Brand extraction failed", { error: err?.message });
   }).finally(() => {
     inflight = false;
     if (dirty) {
@@ -5905,7 +5982,7 @@ function triggerBrandExtraction(apiConfig, model) {
 // src/session.ts
 import fs21 from "fs";
 import path11 from "path";
-var log10 = createLogger("session");
+var log11 = createLogger("session");
 var SESSION_FILE = ".remy-session.json";
 var ARCHIVE_DIR = ".logs/sessions";
 function loadSession(state) {
@@ -5917,7 +5994,7 @@ function loadSession(state) {
     }
     if (Array.isArray(data.messages) && data.messages.length > 0) {
       state.messages = sanitizeMessages(data.messages);
-      log10.info("Session loaded", {
+      log11.info("Session loaded", {
         messageCount: state.messages.length,
         ...state.models && { models: state.models }
       });
@@ -5970,9 +6047,9 @@ function saveSession(state) {
       payload.models = state.models;
     }
     fs21.writeFileSync(SESSION_FILE, JSON.stringify(payload, null, 2), "utf-8");
-    log10.info("Session saved", { messageCount: state.messages.length });
+    log11.info("Session saved", { messageCount: state.messages.length });
   } catch (err) {
-    log10.warn("Session save failed", { error: err.message });
+    log11.warn("Session save failed", { error: err.message });
   }
 }
 function clearSession(state) {
@@ -5983,10 +6060,10 @@ function clearSession(state) {
       const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
       const dest = path11.join(ARCHIVE_DIR, `cleared-${ts}.json`);
       fs21.renameSync(SESSION_FILE, dest);
-      log10.info("Session archived on clear", { dest });
+      log11.info("Session archived on clear", { dest });
     }
   } catch (err) {
-    log10.warn("Session archive on clear failed, deleting instead", {
+    log11.warn("Session archive on clear failed, deleting instead", {
       error: err.message
     });
     try {
@@ -6190,7 +6267,7 @@ function friendlyError(raw) {
 }
 
 // src/agent.ts
-var log11 = createLogger("agent");
+var log12 = createLogger("agent");
 var BRAND_TRIGGERING_TOOLS = /* @__PURE__ */ new Set(["writeSpec", "editSpec"]);
 function getTextContent(blocks) {
   return blocks.filter((b) => b.type === "text").map((b) => b.text).join("");
@@ -6239,7 +6316,7 @@ async function runTurn(params) {
   } = params;
   const tools2 = getToolDefinitions(onboardingState);
   const excludeToolsFromClearing = tools2.filter((t) => !CLEARABLE_TOOLS.has(t.name)).map((t) => t.name);
-  log11.info("Turn started", {
+  log12.info("Turn started", {
     requestId,
     model,
     toolCount: tools2.length,
@@ -6492,7 +6569,7 @@ async function runTurn(params) {
             const tool = getToolByName(event.name);
             const wasStreamed = acc?.started ?? false;
             const isInputStreaming = !!tool?.streaming?.partialInput;
-            log11.info("Tool received", {
+            log12.info("Tool received", {
               requestId,
               toolCallId: event.id,
               name: event.name
@@ -6606,7 +6683,7 @@ async function runTurn(params) {
       });
       return;
     }
-    log11.info("Tools executing", {
+    log12.info("Tools executing", {
       requestId,
       count: toolCalls.length,
       tools: toolCalls.map((tc) => tc.name)
@@ -6626,7 +6703,7 @@ async function runTurn(params) {
     const results = await Promise.all(
       toolCalls.map(async (tc) => {
         if (signal?.aborted) {
-          return { id: tc.id, result: "Error: cancelled", isError: true };
+          return { id: tc.id, result: USER_CANCELLED_RESULT, isError: true };
         }
         const toolStart = Date.now();
         let settle;
@@ -6645,7 +6722,7 @@ async function runTurn(params) {
         };
         const cascadeAbort = () => {
           toolAbort.abort();
-          safeSettle("Error: cancelled", true);
+          safeSettle(USER_CANCELLED_RESULT, true);
         };
         signal?.addEventListener("abort", cascadeAbort, { once: true });
         const run = async (input) => {
@@ -6653,7 +6730,7 @@ async function runTurn(params) {
             let result;
             if (EXTERNAL_TOOLS.has(tc.name) && resolveExternalTool) {
               saveSession(state);
-              log11.info("Waiting for external tool result", {
+              log12.info("Waiting for external tool result", {
                 requestId,
                 toolCallId: tc.id,
                 name: tc.name
@@ -6721,7 +6798,7 @@ async function runTurn(params) {
         if (!tc.input.background) {
           toolRegistry?.unregister(tc.id);
         }
-        log11.info("Tool completed", {
+        log12.info("Tool completed", {
           requestId,
           toolCallId: tc.id,
           name: tc.name,
@@ -6781,81 +6858,6 @@ async function runTurn(params) {
   }
 }
 
-// src/toolRegistry.ts
-var log12 = createLogger("tool-registry");
-var ToolRegistry = class {
-  entries = /* @__PURE__ */ new Map();
-  onEvent;
-  register(entry) {
-    this.entries.set(entry.id, entry);
-  }
-  unregister(id) {
-    this.entries.delete(id);
-  }
-  get(id) {
-    return this.entries.get(id);
-  }
-  /**
-   * Stop a running tool.
-   *
-   * - graceful: abort and settle with [INTERRUPTED] + partial result
-   * - hard: abort and settle with a generic error
-   *
-   * Returns true if the tool was found and stopped.
-   */
-  stop(id, mode) {
-    const entry = this.entries.get(id);
-    if (!entry) {
-      return false;
-    }
-    log12.info("Tool stopped", { toolCallId: id, name: entry.name, mode });
-    entry.abortController.abort(mode);
-    if (mode === "graceful") {
-      const partial = entry.getPartialResult?.() ?? "";
-      const result = partial ? `[INTERRUPTED]
-
-${partial}` : "[INTERRUPTED] Tool execution was stopped.";
-      entry.settle(result, false);
-    } else {
-      entry.settle("Error: tool was cancelled", true);
-    }
-    this.onEvent?.({
-      type: "tool_stopped",
-      id: entry.id,
-      name: entry.name,
-      mode,
-      ...entry.parentToolId && { parentToolId: entry.parentToolId }
-    });
-    this.entries.delete(id);
-    return true;
-  }
-  /**
-   * Restart a running tool with the same or patched input.
-   * The original controllable promise stays pending and settles
-   * when the new execution finishes.
-   *
-   * Returns true if the tool was found and restarted.
-   */
-  restart(id, patchedInput) {
-    const entry = this.entries.get(id);
-    if (!entry) {
-      return false;
-    }
-    log12.info("Tool restarted", { toolCallId: id, name: entry.name });
-    entry.abortController.abort("restart");
-    const newInput = patchedInput ? { ...entry.input, ...patchedInput } : entry.input;
-    this.onEvent?.({
-      type: "tool_restarted",
-      id: entry.id,
-      name: entry.name,
-      input: newInput,
-      ...entry.parentToolId && { parentToolId: entry.parentToolId }
-    });
-    entry.rerun(newInput);
-    return true;
-  }
-};
-
 // src/headless/attachments.ts
 import { mkdirSync, existsSync } from "fs";
 import { writeFile } from "fs/promises";
@@ -7804,7 +7806,7 @@ var HeadlessSession = class {
     }
     for (const [id, pending] of this.pendingTools) {
       clearTimeout(pending.timeout);
-      pending.resolve("Error: cancelled");
+      pending.resolve(USER_CANCELLED_RESULT);
       this.pendingTools.delete(id);
     }
     return this.queue.drain();

package/dist/index.js

@@ -2034,14 +2034,14 @@ var init_surfaces = __esm({
     "use strict";
     MODEL_SURFACES = {
       parent: {
-        default: "claude-4-7-opus",
+        default: "claude-4-8-opus",
         label: "Remy",
         description: "The main Remy agent you chat with about your product. Writes code and manages delegation to other agents.",
         modelType: "text",
         userPickable: true
       },
       visualDesignExpert: {
-        default: "claude-4-7-opus",
+        default: "claude-4-8-opus",
         label: "Design Agent",
         description: "Designs your product's interfaces, including components, layouts, typography, color, and visual identity.",
         modelType: "text",
@@ -2108,6 +2108,7 @@ var init_surfaces = __esm({
     };
     ALLOWED_MODELS_BY_TYPE = {
       text: [
+        "claude-4-8-opus",
         "claude-4-7-opus",
         "claude-4-6-opus",
         "claude-4-6-sonnet",
@@ -3319,6 +3320,89 @@ var init_browserLock = __esm({
   }
 });
 
+// src/toolRegistry.ts
+var log5, USER_CANCELLED_RESULT, ToolRegistry;
+var init_toolRegistry = __esm({
+  "src/toolRegistry.ts"() {
+    "use strict";
+    init_logger();
+    log5 = createLogger("tool-registry");
+    USER_CANCELLED_RESULT = "[USER CANCELLED] The user manually cancelled this tool. Do not retry it automatically \u2014 wait for the user\u2019s next message for direction.";
+    ToolRegistry = class {
+      entries = /* @__PURE__ */ new Map();
+      onEvent;
+      register(entry) {
+        this.entries.set(entry.id, entry);
+      }
+      unregister(id) {
+        this.entries.delete(id);
+      }
+      get(id) {
+        return this.entries.get(id);
+      }
+      /**
+       * Stop a running tool.
+       *
+       * - graceful: abort and settle with [INTERRUPTED] + partial result
+       * - hard: abort and settle with a generic error
+       *
+       * Returns true if the tool was found and stopped.
+       */
+      stop(id, mode) {
+        const entry = this.entries.get(id);
+        if (!entry) {
+          return false;
+        }
+        log5.info("Tool stopped", { toolCallId: id, name: entry.name, mode });
+        entry.abortController.abort(mode);
+        if (mode === "graceful") {
+          const partial = entry.getPartialResult?.() ?? "";
+          const result = partial ? `[INTERRUPTED]
+
+${partial}` : "[INTERRUPTED] Tool execution was stopped.";
+          entry.settle(result, false);
+        } else {
+          entry.settle(USER_CANCELLED_RESULT, true);
+        }
+        this.onEvent?.({
+          type: "tool_stopped",
+          id: entry.id,
+          name: entry.name,
+          mode,
+          ...entry.parentToolId && { parentToolId: entry.parentToolId }
+        });
+        this.entries.delete(id);
+        return true;
+      }
+      /**
+       * Restart a running tool with the same or patched input.
+       * The original controllable promise stays pending and settles
+       * when the new execution finishes.
+       *
+       * Returns true if the tool was found and restarted.
+       */
+      restart(id, patchedInput) {
+        const entry = this.entries.get(id);
+        if (!entry) {
+          return false;
+        }
+        log5.info("Tool restarted", { toolCallId: id, name: entry.name });
+        entry.abortController.abort("restart");
+        const newInput = patchedInput ? { ...entry.input, ...patchedInput } : entry.input;
+        this.onEvent?.({
+          type: "tool_restarted",
+          id: entry.id,
+          name: entry.name,
+          input: newInput,
+          ...entry.parentToolId && { parentToolId: entry.parentToolId }
+        });
+        entry.rerun(newInput);
+        return true;
+      }
+    };
+  }
+});
+
 // src/statusWatcher.ts
 function startStatusWatcher(config) {
   const { apiConfig, getContext, onStatus, interval = 5e3, signal } = config;
@@ -3606,7 +3690,7 @@ async function runSubAgent(config) {
   const signal = background ? bgAbort.signal : parentSignal;
   const agentName = subAgentId || "sub-agent";
   const runStart = Date.now();
-  log5.info("Sub-agent started", { requestId, parentToolId, agentName });
+  log6.info("Sub-agent started", { requestId, parentToolId, agentName });
   const emit = (e) => {
     onEvent({ ...e, parentToolId });
   };
@@ -3641,7 +3725,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
           messages: thisInvocation()
         };
       }
-      return { text: "Error: cancelled", messages: thisInvocation() };
+      return { text: USER_CANCELLED_RESULT, messages: thisInvocation() };
     }
     let lastToolResult = "";
     while (true) {
@@ -3823,7 +3907,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
           ...hasArtifacts ? { artifacts } : {}
         };
       }
-      log5.info("Tools executing", {
+      log6.info("Tools executing", {
         requestId,
         parentToolId,
         count: toolCalls.length,
@@ -3833,7 +3917,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
       const results = await Promise.all(
         toolCalls.map(async (tc) => {
           if (signal?.aborted) {
-            return { id: tc.id, result: "Error: cancelled", isError: true };
+            return { id: tc.id, result: USER_CANCELLED_RESULT, isError: true };
           }
           let settle;
           const resultPromise = new Promise((res) => {
@@ -3900,7 +3984,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
           run2(tc.input);
           const r = await resultPromise;
           toolRegistry?.unregister(tc.id);
-          log5.info("Tool completed", {
+          log6.info("Tool completed", {
             requestId,
             parentToolId,
             toolCallId: tc.id,
@@ -3951,7 +4035,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
   const wrapRun = async () => {
     try {
       const result = await run();
-      log5.info("Sub-agent complete", {
+      log6.info("Sub-agent complete", {
         requestId,
         parentToolId,
         agentName,
@@ -3960,7 +4044,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
       });
       return result;
     } catch (err) {
-      log5.warn("Sub-agent error", {
+      log6.warn("Sub-agent error", {
         requestId,
         parentToolId,
         agentName,
@@ -3972,7 +4056,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
   if (!background) {
     return wrapRun();
   }
-  log5.info("Sub-agent backgrounded", { requestId, parentToolId, agentName });
+  log6.info("Sub-agent backgrounded", { requestId, parentToolId, agentName });
   toolRegistry?.register({
     id: parentToolId,
     name: agentName,
@@ -3999,16 +4083,17 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
   });
   return { text: ack, messages: [], backgrounded: true };
 }
-var log5;
+var log6;
 var init_runner = __esm({
   "src/subagents/runner.ts"() {
     "use strict";
     init_api();
     init_logger();
     init_usageLedger();
+    init_toolRegistry();
     init_statusWatcher();
     init_cleanMessages();
-    log5 = createLogger("sub-agent");
+    log6 = createLogger("sub-agent");
   }
 });
 
@@ -4268,7 +4353,7 @@ async function runBrowserAutomation(task, context) {
                   }
                 }
               } catch {
-                log6.debug("Failed to parse batch analysis result", {
+                log7.debug("Failed to parse batch analysis result", {
                   batchResult
                 });
               }
@@ -4292,7 +4377,7 @@ async function runBrowserAutomation(task, context) {
     release();
   }
 }
-var log6, browserAutomationTool;
+var log7, browserAutomationTool;
 var init_browserAutomation = __esm({
   "src/subagents/browserAutomation/index.ts"() {
     "use strict";
@@ -4305,7 +4390,7 @@ var init_browserAutomation = __esm({
     init_runMindstudioCli();
     init_surfaces();
     init_logger();
-    log6 = createLogger("browser-automation");
+    log7 = createLogger("browser-automation");
     browserAutomationTool = {
       clearable: true,
       definition: {
@@ -6236,7 +6321,7 @@ function loadSession(state) {
     }
     if (Array.isArray(data.messages) && data.messages.length > 0) {
       state.messages = sanitizeMessages(data.messages);
-      log7.info("Session loaded", {
+      log8.info("Session loaded", {
         messageCount: state.messages.length,
         ...state.models && { models: state.models }
       });
@@ -6289,9 +6374,9 @@ function saveSession(state) {
       payload.models = state.models;
     }
     fs19.writeFileSync(SESSION_FILE, JSON.stringify(payload, null, 2), "utf-8");
-    log7.info("Session saved", { messageCount: state.messages.length });
+    log8.info("Session saved", { messageCount: state.messages.length });
   } catch (err) {
-    log7.warn("Session save failed", { error: err.message });
+    log8.warn("Session save failed", { error: err.message });
   }
 }
 function clearSession(state) {
@@ -6302,10 +6387,10 @@ function clearSession(state) {
       const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
       const dest = path9.join(ARCHIVE_DIR, `cleared-${ts}.json`);
       fs19.renameSync(SESSION_FILE, dest);
-      log7.info("Session archived on clear", { dest });
+      log8.info("Session archived on clear", { dest });
     }
   } catch (err) {
-    log7.warn("Session archive on clear failed, deleting instead", {
+    log8.warn("Session archive on clear failed, deleting instead", {
       error: err.message
     });
     try {
@@ -6314,12 +6399,12 @@ function clearSession(state) {
     }
   }
 }
-var log7, SESSION_FILE, ARCHIVE_DIR;
+var log8, SESSION_FILE, ARCHIVE_DIR;
 var init_session = __esm({
   "src/session.ts"() {
     "use strict";
     init_logger();
-    log7 = createLogger("session");
+    log8 = createLogger("session");
     SESSION_FILE = ".remy-session.json";
     ARCHIVE_DIR = ".logs/sessions";
   }
@@ -6538,17 +6623,17 @@ async function runExtraction(apiConfig, model) {
   const inputHash = computeInputHash();
   const cached2 = readCache();
   if (cached2 && cached2.inputHash === inputHash) {
-    log8.debug("Brand inputs unchanged \u2014 skipping extraction", { inputHash });
+    log9.debug("Brand inputs unchanged \u2014 skipping extraction", { inputHash });
     return null;
   }
-  log8.info("Extracting brand", { inputHash });
+  log9.info("Extracting brand", { inputHash });
   const brand = await extractBrand(apiConfig, model);
   if (!brand) {
-    log8.warn("Brand extraction failed \u2014 leaving cache untouched");
+    log9.warn("Brand extraction failed \u2014 leaving cache untouched");
     return null;
   }
   persistBrand(brand, inputHash);
-  log8.info("Brand persisted", { inputHash });
+  log9.info("Brand persisted", { inputHash });
   return brand;
 }
 function computeInputHash() {
@@ -6614,7 +6699,7 @@ function parseFrontmatter3(filePath) {
 async function extractBrand(apiConfig, model) {
   const corpus = buildCorpus();
   if (!corpus.trim()) {
-    log8.debug("No spec corpus \u2014 emitting empty brand");
+    log9.debug("No spec corpus \u2014 emitting empty brand");
     return { version: 1 };
   }
   let responseText = "";
@@ -6645,17 +6730,17 @@ async function extractBrand(apiConfig, model) {
           toolNames: []
         });
       } else if (event.type === "error") {
-        log8.error("Brand extraction stream error", { error: event.error });
+        log9.error("Brand extraction stream error", { error: event.error });
         return null;
       }
     }
   } catch (err) {
-    log8.error("Brand extraction threw", { error: err?.message });
+    log9.error("Brand extraction threw", { error: err?.message });
     return null;
   }
   const parsed = parseJsonResponse(responseText);
   if (!parsed) {
-    log8.warn("Brand extraction returned unparseable JSON", {
+    log9.warn("Brand extraction returned unparseable JSON", {
       preview: responseText.slice(0, 200)
     });
     return null;
@@ -6795,7 +6880,7 @@ function readCache() {
     return null;
   }
 }
-var log8, EXTRACT_PROMPT, BRAND_FILE, CACHE_FILE;
+var log9, EXTRACT_PROMPT, BRAND_FILE, CACHE_FILE;
 var init_brandExtraction = __esm({
   "src/brandExtraction/index.ts"() {
     "use strict";
@@ -6803,7 +6888,7 @@ var init_brandExtraction = __esm({
     init_assets();
     init_logger();
     init_usageLedger();
-    log8 = createLogger("brandExtraction");
+    log9 = createLogger("brandExtraction");
     EXTRACT_PROMPT = readAsset("brandExtraction", "extract.md");
     BRAND_FILE = ".remy-brand.json";
     CACHE_FILE = ".remy-brand.cache.json";
@@ -6818,7 +6903,7 @@ function triggerBrandExtraction(apiConfig, model) {
   }
   inflight = true;
   void runExtraction(apiConfig, model).catch((err) => {
-    log9.error("Brand extraction failed", { error: err?.message });
+    log10.error("Brand extraction failed", { error: err?.message });
   }).finally(() => {
     inflight = false;
     if (dirty) {
@@ -6827,13 +6912,13 @@ function triggerBrandExtraction(apiConfig, model) {
     }
   });
 }
-var log9, inflight, dirty;
+var log10, inflight, dirty;
 var init_trigger2 = __esm({
   "src/brandExtraction/trigger.ts"() {
     "use strict";
     init_brandExtraction();
     init_logger();
-    log9 = createLogger("brandExtraction:trigger");
+    log10 = createLogger("brandExtraction:trigger");
     inflight = false;
     dirty = false;
   }
@@ -6871,7 +6956,7 @@ async function runTurn(params) {
   } = params;
   const tools2 = getToolDefinitions(onboardingState);
   const excludeToolsFromClearing = tools2.filter((t) => !CLEARABLE_TOOLS.has(t.name)).map((t) => t.name);
-  log10.info("Turn started", {
+  log11.info("Turn started", {
     requestId,
     model,
     toolCount: tools2.length,
@@ -7124,7 +7209,7 @@ async function runTurn(params) {
             const tool = getToolByName(event.name);
             const wasStreamed = acc?.started ?? false;
             const isInputStreaming = !!tool?.streaming?.partialInput;
-            log10.info("Tool received", {
+            log11.info("Tool received", {
               requestId,
               toolCallId: event.id,
               name: event.name
@@ -7238,7 +7323,7 @@ async function runTurn(params) {
       });
       return;
     }
-    log10.info("Tools executing", {
+    log11.info("Tools executing", {
       requestId,
       count: toolCalls.length,
       tools: toolCalls.map((tc) => tc.name)
@@ -7258,7 +7343,7 @@ async function runTurn(params) {
     const results = await Promise.all(
       toolCalls.map(async (tc) => {
         if (signal?.aborted) {
-          return { id: tc.id, result: "Error: cancelled", isError: true };
+          return { id: tc.id, result: USER_CANCELLED_RESULT, isError: true };
         }
         const toolStart = Date.now();
         let settle;
@@ -7277,7 +7362,7 @@ async function runTurn(params) {
         };
         const cascadeAbort = () => {
           toolAbort.abort();
-          safeSettle("Error: cancelled", true);
+          safeSettle(USER_CANCELLED_RESULT, true);
         };
         signal?.addEventListener("abort", cascadeAbort, { once: true });
         const run = async (input) => {
@@ -7285,7 +7370,7 @@ async function runTurn(params) {
             let result;
             if (EXTERNAL_TOOLS.has(tc.name) && resolveExternalTool) {
               saveSession(state);
-              log10.info("Waiting for external tool result", {
+              log11.info("Waiting for external tool result", {
                 requestId,
                 toolCallId: tc.id,
                 name: tc.name
@@ -7353,7 +7438,7 @@ async function runTurn(params) {
         if (!tc.input.background) {
           toolRegistry?.unregister(tc.id);
         }
-        log10.info("Tool completed", {
+        log11.info("Tool completed", {
           requestId,
           toolCallId: tc.id,
           name: tc.name,
@@ -7412,7 +7497,7 @@ async function runTurn(params) {
     }
   }
 }
-var log10, BRAND_TRIGGERING_TOOLS, EXTERNAL_TOOLS, USER_BLOCKING_EXTERNAL_TOOLS;
+var log11, BRAND_TRIGGERING_TOOLS, EXTERNAL_TOOLS, USER_BLOCKING_EXTERNAL_TOOLS;
 var init_agent = __esm({
   "src/agent.ts"() {
     "use strict";
@@ -7429,7 +7514,8 @@ var init_agent = __esm({
     init_sentinel();
     init_trigger2();
     init_surfaces();
-    log10 = createLogger("agent");
+    init_toolRegistry();
+    log11 = createLogger("agent");
     BRAND_TRIGGERING_TOOLS = /* @__PURE__ */ new Set(["writeSpec", "editSpec"]);
     EXTERNAL_TOOLS = /* @__PURE__ */ new Set([
       "promptUser",
@@ -7457,10 +7543,10 @@ import os from "os";
 function loadConfigFile() {
   try {
     const raw = fs21.readFileSync(CONFIG_PATH, "utf-8");
-    log11.debug("Loaded config file", { path: CONFIG_PATH });
+    log12.debug("Loaded config file", { path: CONFIG_PATH });
     return JSON.parse(raw);
   } catch (err) {
-    log11.debug("No config file found", {
+    log12.debug("No config file found", {
       path: CONFIG_PATH,
       error: err.message
     });
@@ -7475,13 +7561,13 @@ function resolveConfig(flags2) {
   const baseUrl2 = flags2?.baseUrl || process.env.MINDSTUDIO_BASE_URL || env?.apiBaseUrl || DEFAULT_BASE_URL;
   const appId = process.env.MINDSTUDIO_APP_ID || void 0;
   if (!apiKey) {
-    log11.error("No API key found");
+    log12.error("No API key found");
     throw new Error(
       "No API key found. Set MINDSTUDIO_API_KEY or configure ~/.mindstudio-local-tunnel/config.json."
     );
   }
   const keySource = flags2?.apiKey ? "cli flag" : process.env.MINDSTUDIO_API_KEY ? "env var" : "config file";
-  log11.info("Config resolved", {
+  log12.info("Config resolved", {
     baseUrl: baseUrl2,
     keySource,
     environment: activeEnv,
@@ -7489,12 +7575,12 @@ function resolveConfig(flags2) {
   });
   return { apiKey, baseUrl: baseUrl2, appId };
 }
-var log11, CONFIG_PATH, DEFAULT_BASE_URL;
+var log12, CONFIG_PATH, DEFAULT_BASE_URL;
 var init_config = __esm({
   "src/config.ts"() {
     "use strict";
     init_logger();
-    log11 = createLogger("config");
+    log12 = createLogger("config");
     CONFIG_PATH = path11.join(
       os.homedir(),
       ".mindstudio-local-tunnel",
@@ -7504,88 +7590,6 @@ var init_config = __esm({
   }
 });
 
-// src/toolRegistry.ts
-var log12, ToolRegistry;
-var init_toolRegistry = __esm({
-  "src/toolRegistry.ts"() {
-    "use strict";
-    init_logger();
-    log12 = createLogger("tool-registry");
-    ToolRegistry = class {
-      entries = /* @__PURE__ */ new Map();
-      onEvent;
-      register(entry) {
-        this.entries.set(entry.id, entry);
-      }
-      unregister(id) {
-        this.entries.delete(id);
-      }
-      get(id) {
-        return this.entries.get(id);
-      }
-      /**
-       * Stop a running tool.
-       *
-       * - graceful: abort and settle with [INTERRUPTED] + partial result
-       * - hard: abort and settle with a generic error
-       *
-       * Returns true if the tool was found and stopped.
-       */
-      stop(id, mode) {
-        const entry = this.entries.get(id);
-        if (!entry) {
-          return false;
-        }
-        log12.info("Tool stopped", { toolCallId: id, name: entry.name, mode });
-        entry.abortController.abort(mode);
-        if (mode === "graceful") {
-          const partial = entry.getPartialResult?.() ?? "";
-          const result = partial ? `[INTERRUPTED]
-
-${partial}` : "[INTERRUPTED] Tool execution was stopped.";
-          entry.settle(result, false);
-        } else {
-          entry.settle("Error: tool was cancelled", true);
-        }
-        this.onEvent?.({
-          type: "tool_stopped",
-          id: entry.id,
-          name: entry.name,
-          mode,
-          ...entry.parentToolId && { parentToolId: entry.parentToolId }
-        });
-        this.entries.delete(id);
-        return true;
-      }
-      /**
-       * Restart a running tool with the same or patched input.
-       * The original controllable promise stays pending and settles
-       * when the new execution finishes.
-       *
-       * Returns true if the tool was found and restarted.
-       */
-      restart(id, patchedInput) {
-        const entry = this.entries.get(id);
-        if (!entry) {
-          return false;
-        }
-        log12.info("Tool restarted", { toolCallId: id, name: entry.name });
-        entry.abortController.abort("restart");
-        const newInput = patchedInput ? { ...entry.input, ...patchedInput } : entry.input;
-        this.onEvent?.({
-          type: "tool_restarted",
-          id: entry.id,
-          name: entry.name,
-          input: newInput,
-          ...entry.parentToolId && { parentToolId: entry.parentToolId }
-        });
-        entry.rerun(newInput);
-        return true;
-      }
-    };
-  }
-});
-
 // src/headless/attachments.ts
 import { mkdirSync, existsSync } from "fs";
 import { writeFile } from "fs/promises";
@@ -8593,7 +8597,7 @@ var init_headless = __esm({
         }
         for (const [id, pending] of this.pendingTools) {
           clearTimeout(pending.timeout);
-          pending.resolve("Error: cancelled");
+          pending.resolve(USER_CANCELLED_RESULT);
           this.pendingTools.delete(id);
         }
         return this.queue.drain();

package/dist/prompt/compiled/interfaces.md

@@ -344,7 +344,19 @@ Accepts any HTTP method. The method receives `{ method, headers, query, body }`
 
 ## Email
 
-Inbound email triggers. An app can register one inbound address that routes all inbound emails to one method.
+Inbound email triggers. Each app has one email-handler method; the platform routes all inbound mail destined for the app — across any of its address tiers — to that method.
+
+### Address tiers
+
+Three tiers, all delivered to the same handler method. The new tiers are catchall (no localpart registration); the legacy tier is specific-localpart and frozen for new apps.
+
+| Tier | Address | How it's set up |
+|---|---|---|
+| Platform subdomain (default) | `*@<custom_subdomain>.madewithremy.com` | Automatic the moment the app has a `custom_subdomain` set. Every address on that subdomain delivers to the handler. |
+| Custom domain | `*@<their-domain>` | The user adds a domain in the dashboard's email-domains settings and points one MX record at `mx.msagent.ai`. Not something the agent provisions. |
+| Legacy `mindstudio-hooks.com` | `<name>@mindstudio-hooks.com` | Existing apps only — frozen for new apps. Don't recommend it; treat as read-only history. |
+
+Because the new tiers are catchall, `to` carries an arbitrary localpart. Methods that need to branch on it should read `input.to` (e.g. `if (input.to.startsWith('support@')) ...`).
 
 ### Config (`interface.json`)
 
@@ -357,27 +369,27 @@ Inbound email triggers. An app can register one inbound address that routes all
 }
 ```
 
-`approvedSenders` is optional. When set, only senders matching an exact address or `*@domain.com` wildcard reach the method; everything else is rejected by the platform with `400 invalid_sender` before the method runs.
-
-Address pattern: `{custom-name}@mindstudio-hooks.com`.
+`approvedSenders` is optional. When set, only senders matching an exact address or `*@domain.com` wildcard reach the method; everything else is rejected by the platform with `400 invalid_sender` before the method runs (silently — the sender isn't bounced). Matching is case-insensitive. The same list applies uniformly across all three address tiers.
 
 ### Input shape
 
 ```ts
 {
-  to: string;            // resolved from the SMTP envelope
+  to: string;            // full recipient address; localpart is arbitrary on catchall tiers
   from: string;          // bare address, extracted from "Name <a@b>" form
   subject: string;       // 'No Subject' if missing
-  message: string;       // plain text body; 'No Body' if neither text nor html was sent
+  message: string;       // plain text body, falls back to HTML if text is missing; 'No Body' if neither was sent
   html: string;          // HTML body, or '' when text-only
   attachments: string[]; // CDN URLs — already uploaded by the platform
 }
 ```
 
-### Attachments
+### Attachments and size limits
 
 `attachments[]` is an array of CDN URLs — the platform has already received and uploaded the files. Fetch them server-side via the URL when you need the bytes; pass them through as URLs to UI or downstream services.
 
+Max inbound message size is 25 MB total (including all attachments). Oversized messages are rejected by the platform before the method runs.
+
 ### Auth
 
 Methods invoked through this interface run with `auth.roles: ['system']` (see the system-roles section above). They have no user session and can't impersonate. Use `auth.requireRole('system')` to gate methods that should only be reachable via email.

package/package.json

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