@mindstudio-ai/remy 0.1.185 → 0.1.187

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,
@@ -3814,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 {
@@ -3906,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
                 });
               }
@@ -5573,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() {
@@ -5600,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;
@@ -5616,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";
@@ -5624,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() {
@@ -5700,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 = "";
@@ -5731,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;
@@ -5883,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) {
@@ -5893,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) {
@@ -5906,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) {
@@ -5918,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 }
       });
@@ -5971,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) {
@@ -5984,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 {
@@ -6191,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("");
@@ -6240,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,
@@ -6493,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
@@ -6607,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)
@@ -6627,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;
@@ -6646,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) => {
@@ -6654,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
@@ -6722,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,
@@ -6782,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";
@@ -7805,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

@@ -3320,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;
@@ -3607,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 });
   };
@@ -3642,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) {
@@ -3824,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,
@@ -3834,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) => {
@@ -3901,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,
@@ -3952,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,
@@ -3961,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,
@@ -3973,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,
@@ -4000,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");
   }
 });
 
@@ -4269,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
                 });
               }
@@ -4293,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";
@@ -4306,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: {
@@ -6237,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 }
       });
@@ -6290,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) {
@@ -6303,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 {
@@ -6315,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";
   }
@@ -6539,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() {
@@ -6615,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 = "";
@@ -6646,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;
@@ -6796,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";
@@ -6804,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";
@@ -6819,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) {
@@ -6828,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;
   }
@@ -6872,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,
@@ -7125,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
@@ -7239,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)
@@ -7259,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;
@@ -7278,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) => {
@@ -7286,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
@@ -7354,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,
@@ -7413,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";
@@ -7430,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",
@@ -7458,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
     });
@@ -7476,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,
@@ -7490,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",
@@ -7505,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";
@@ -8594,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/dist/prompt/static/coding.md

@@ -78,6 +78,6 @@ You have access to the `mindstudio` CLI, which exposes every SDK action as a com
 ### Production App Management
 You have access to `mindstudio-prod`, a CLI for managing the user's production MindStudio app. Use it via your bash tool. All output is JSON. Run `mindstudio-prod --help` or `mindstudio-prod <command> --help` to discover usage and available options.
 
-Available commands: `requests` (logs, error rates, latency), `releases` (deploy status, history), `domains` (custom subdomains and fully custom domains), `users` (list, set roles), `db` (query production sql db), `methods` (list, invoke), `secrets` (list, get, set, delete).
+Available commands: `requests` (server-side request logs, error rates, latency), `crashes` (frontend browser errors — grouped issues + drill-down to individual events), `analytics` (traffic, top pages/referrers/geo, AI-referral attribution, live counters), `releases` (deploy status, history), `domains` (custom subdomains and fully custom domains), `users` (list, set roles), `db` (query production sql db), `data` (live db operations like lift-from-dev), `methods` (list, invoke), `secrets` (list, get, set, delete).
 
-Use when the user asks about production behavior (errors, logs, metrics), wants to manage their live app (domains, users, roles), needs to seed or query production data, or wants to check release status.
+Use when the user asks about production behavior (server errors via `requests`, browser crashes via `crashes`, traffic/engagement via `analytics`), wants to manage their live app (domains, users, roles), needs to seed or query production data, or wants to check release status.

package/package.json

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