@mindstudio-ai/remy 0.1.40 → 0.1.41

package/dist/index.js

@@ -11,9 +11,6 @@ var __export = (target, all) => {
 
 // src/logger.ts
 import fs from "fs";
-function timestamp() {
-  return (/* @__PURE__ */ new Date()).toISOString();
-}
 function truncateValues(obj) {
   const result = {};
   for (const [key, value] of Object.entries(obj)) {
@@ -27,15 +24,28 @@ function truncateValues(obj) {
   }
   return result;
 }
-function write(level, msg, data) {
+function write(level, module, msg, data) {
   if (LEVELS[level] > currentLevel) {
     return;
   }
-  const parts = [`[${timestamp()}]`, level.toUpperCase().padEnd(5), msg];
+  const entry = {
+    ts: Date.now(),
+    level,
+    module,
+    msg
+  };
   if (data) {
-    parts.push(JSON.stringify(truncateValues(data)));
+    Object.assign(entry, truncateValues(data));
   }
-  writeFn(parts.join(" "));
+  writeFn(JSON.stringify(entry));
+}
+function createLogger(module) {
+  return {
+    error: (msg, data) => write("error", module, msg, data),
+    warn: (msg, data) => write("warn", module, msg, data),
+    info: (msg, data) => write("info", module, msg, data),
+    debug: (msg, data) => write("debug", module, msg, data)
+  };
 }
 function initLoggerHeadless(level = "info") {
   currentLevel = LEVELS[level];
@@ -49,14 +59,15 @@ function initLoggerInteractive(level = "error") {
   writeFn = (line) => {
     try {
       if (fd === null) {
-        fd = fs.openSync(".remy-debug.log", "a");
+        fs.mkdirSync(".logs", { recursive: true });
+        fd = fs.openSync(".logs/agent.ndjson", "a");
       }
       fs.writeSync(fd, line + "\n");
     } catch {
     }
   };
 }
-var LEVELS, currentLevel, writeFn, MAX_VALUE_LENGTH, log;
+var LEVELS, currentLevel, writeFn, MAX_VALUE_LENGTH;
 var init_logger = __esm({
   "src/logger.ts"() {
     "use strict";
@@ -70,43 +81,22 @@ var init_logger = __esm({
     writeFn = () => {
     };
     MAX_VALUE_LENGTH = 200;
-    log = {
-      error(msg, data) {
-        write("error", msg, data);
-      },
-      warn(msg, data) {
-        write("warn", msg, data);
-      },
-      info(msg, data) {
-        write("info", msg, data);
-      },
-      debug(msg, data) {
-        write("debug", msg, data);
-      }
-    };
   }
 });
 
 // src/api.ts
 async function* streamChat(params) {
-  const { baseUrl: baseUrl2, apiKey, signal, ...body } = params;
+  const { baseUrl: baseUrl2, apiKey, signal, requestId, ...body } = params;
   const url = `${baseUrl2}/_internal/v2/agent/remy/chat`;
   const startTime = Date.now();
   const messagesWithAttachments = body.messages.filter(
     (m) => m.attachments && m.attachments.length > 0
   );
-  log.info("POST agent/chat", {
-    url,
+  log.info("API request", {
+    requestId,
     model: body.model,
     messageCount: body.messages.length,
-    toolCount: body.tools.length,
-    ...messagesWithAttachments.length > 0 && {
-      attachments: messagesWithAttachments.map((m) => ({
-        role: m.role,
-        attachmentCount: m.attachments.length,
-        urls: m.attachments.map((a) => a.url)
-      }))
-    }
+    toolCount: body.tools.length
   });
   let res;
   try {
@@ -121,15 +111,15 @@ async function* streamChat(params) {
     });
   } catch (err) {
     if (signal?.aborted) {
-      log.info("Request aborted by signal");
+      log.warn("Request aborted", { requestId });
       throw err;
     }
-    log.error("Network error", { error: err.message });
+    log.error("Network error", { requestId, error: err.message });
     yield { type: "error", error: `Network error: ${err.message}` };
     return;
   }
   const ttfb = Date.now() - startTime;
-  log.info(`Response ${res.status}`, { ttfb: `${ttfb}ms` });
+  log.info("API response", { requestId, status: res.status, ttfbMs: ttfb });
   if (!res.ok) {
     let errorMessage = `HTTP ${res.status}`;
     try {
@@ -142,7 +132,11 @@ async function* streamChat(params) {
       }
     } catch {
     }
-    log.error("API error", { status: res.status, error: errorMessage });
+    log.error("API error", {
+      requestId,
+      status: res.status,
+      error: errorMessage
+    });
     yield { type: "error", error: errorMessage };
     return;
   }
@@ -167,7 +161,10 @@ async function* streamChat(params) {
     } catch {
       clearTimeout(stallTimer);
       await reader.cancel();
-      log.error("Stream stalled", { elapsed: `${Date.now() - startTime}ms` });
+      log.error("Stream stalled", {
+        requestId,
+        durationMs: Date.now() - startTime
+      });
       yield {
         type: "error",
         error: "Stream stalled \u2014 no data received for 5 minutes"
@@ -190,7 +187,8 @@ async function* streamChat(params) {
         if (event.type === "done") {
           const elapsed = Date.now() - startTime;
           log.info("Stream complete", {
-            elapsed: `${elapsed}ms`,
+            requestId,
+            durationMs: elapsed,
             stopReason: event.stopReason,
             inputTokens: event.usage.inputTokens,
             outputTokens: event.usage.outputTokens
@@ -221,11 +219,6 @@ async function* streamChatWithRetry(params, options) {
     for await (const event of streamChat(params)) {
       if (event.type === "error") {
         if (isRetryableError(event.error) && attempt < MAX_RETRIES - 1) {
-          log.warn("Retryable error, will retry", {
-            attempt: attempt + 1,
-            maxRetries: MAX_RETRIES,
-            error: event.error
-          });
           options?.onRetry?.(attempt, event.error);
           retryableFailure = true;
           break;
@@ -240,7 +233,12 @@ async function* streamChatWithRetry(params, options) {
         return;
       }
       const backoff = INITIAL_BACKOFF_MS * 2 ** attempt;
-      log.info("Retrying after backoff", { backoffMs: backoff });
+      log.warn("Retrying", {
+        requestId: params.requestId,
+        attempt: attempt + 1,
+        maxRetries: MAX_RETRIES,
+        backoffMs: backoff
+      });
       await sleep(backoff);
       continue;
     }
@@ -274,11 +272,12 @@ async function generateBackgroundAck(params) {
     return FALLBACK_ACK;
   }
 }
-var MAX_RETRIES, INITIAL_BACKOFF_MS, FALLBACK_ACK;
+var log, MAX_RETRIES, INITIAL_BACKOFF_MS, FALLBACK_ACK;
 var init_api = __esm({
   "src/api.ts"() {
     "use strict";
     init_logger();
+    log = createLogger("api");
     MAX_RETRIES = 3;
     INITIAL_BACKOFF_MS = 1e3;
     FALLBACK_ACK = "[Message sent to agent. Agent is working in the background and will report back with its results when finished.]";
@@ -1858,7 +1857,7 @@ var init_editsFinished = __esm({
 // src/tools/_helpers/sidecar.ts
 function setSidecarBaseUrl(url) {
   baseUrl = url;
-  log.info("Sidecar configured", { url });
+  log2.info("Configured", { url });
 }
 function isSidecarConfigured() {
   return baseUrl !== null;
@@ -1868,7 +1867,6 @@ async function sidecarRequest(endpoint, body = {}, options) {
     throw new Error("Sidecar not available");
   }
   const url = `${baseUrl}${endpoint}`;
-  log.debug("Sidecar request", { endpoint, body });
   try {
     const res = await fetch(url, {
       method: "POST",
@@ -1877,7 +1875,7 @@ async function sidecarRequest(endpoint, body = {}, options) {
       signal: options?.timeout ? AbortSignal.timeout(options.timeout) : void 0
     });
     if (!res.ok) {
-      log.error("Sidecar error", { endpoint, status: res.status });
+      log2.error("Sidecar error", { endpoint, status: res.status });
       throw new Error(`Sidecar error: ${res.status}`);
     }
     return res.json();
@@ -1885,15 +1883,16 @@ async function sidecarRequest(endpoint, body = {}, options) {
     if (err.message.startsWith("Sidecar error")) {
       throw err;
     }
-    log.error("Sidecar connection error", { endpoint, error: err.message });
+    log2.error("Sidecar connection error", { endpoint, error: err.message });
     throw new Error(`Sidecar connection error: ${err.message}`);
   }
 }
-var baseUrl;
+var log2, baseUrl;
 var init_sidecar = __esm({
   "src/tools/_helpers/sidecar.ts"() {
     "use strict";
     init_logger();
+    log2 = createLogger("sidecar");
     baseUrl = null;
   }
 });
@@ -2071,7 +2070,6 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   const ssResult = await sidecarRequest("/screenshot-full-page", void 0, {
     timeout: 12e4
   });
-  log.debug("Screenshot response", { ssResult });
   const url = ssResult?.url || ssResult?.screenshotUrl;
   if (!url) {
     throw new Error(
@@ -2094,7 +2092,6 @@ var init_screenshot = __esm({
     "use strict";
     init_sidecar();
     init_runCli();
-    init_logger();
     SCREENSHOT_ANALYSIS_PROMPT = "Describe everything visible on screen from top to bottom \u2014 every element, its position, its size relative to the viewport, 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.";
   }
 });
@@ -2148,13 +2145,8 @@ function startStatusWatcher(config) {
     try {
       const ctx = getContext();
       if (!ctx.assistantText && !ctx.lastToolName) {
-        log.debug("Status watcher: no context, skipping");
         return;
       }
-      log.debug("Status watcher: requesting label", {
-        textLength: ctx.assistantText.length,
-        lastToolName: ctx.lastToolName
-      });
       const res = await fetch(url, {
         method: "POST",
         headers: {
@@ -2171,30 +2163,18 @@ function startStatusWatcher(config) {
         signal
       });
       if (!res.ok) {
-        log.debug("Status watcher: endpoint returned non-ok", {
-          status: res.status
-        });
         return;
       }
       const data = await res.json();
-      if (!data.label) {
-        log.debug("Status watcher: no label in response");
-        return;
-      }
-      if (data.label === lastLabel) {
-        log.debug("Status watcher: duplicate label, skipping", {
-          label: data.label
-        });
+      if (!data.label || data.label === lastLabel) {
         return;
       }
       lastLabel = data.label;
       if (stopped) {
         return;
       }
-      log.debug("Status watcher: emitting", { label: data.label });
       onStatus(data.label);
-    } catch (err) {
-      log.debug("Status watcher: error", { error: err?.message ?? "unknown" });
+    } catch {
     } finally {
       inflight = false;
     }
@@ -2202,19 +2182,16 @@ function startStatusWatcher(config) {
   const timer = setInterval(tick, interval);
   tick().catch(() => {
   });
-  log.debug("Status watcher started", { interval });
   return {
     stop() {
       stopped = true;
       clearInterval(timer);
-      log.debug("Status watcher stopped");
     }
   };
 }
 var init_statusWatcher = __esm({
   "src/statusWatcher.ts"() {
     "use strict";
-    init_logger();
   }
 });
 
@@ -2274,14 +2251,19 @@ async function runSubAgent(config) {
     onEvent,
     resolveExternalTool,
     toolRegistry,
+    requestId,
     background,
     onBackgroundComplete
   } = config;
   const bgAbort = background ? new AbortController() : null;
   const signal = background ? bgAbort.signal : parentSignal;
+  const agentName = subAgentId || "sub-agent";
+  const runStart = Date.now();
+  log3.info("Sub-agent started", { requestId, parentToolId, agentName });
   const emit2 = (e) => {
     onEvent({ ...e, parentToolId });
   };
+  let turns = 0;
   const run = async () => {
     const messages = [{ role: "user", content: task }];
     function getPartialText(blocks) {
@@ -2301,6 +2283,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
     }
     let lastToolResult = "";
     while (true) {
+      turns++;
       if (signal?.aborted) {
         return abortResult([]);
       }
@@ -2326,6 +2309,7 @@ Current date/time: ${(/* @__PURE__ */ new Date()).toISOString().replace("T", " "
           {
             ...apiConfig,
             model,
+            requestId,
             subAgentId,
             system: fullSystem,
             messages: cleanMessagesForApi(messages),
@@ -2416,7 +2400,8 @@ Current date/time: ${(/* @__PURE__ */ new Date()).toISOString().replace("T", " "
         const text = getPartialText(contentBlocks);
         return { text, messages };
       }
-      log.info("Sub-agent executing tools", {
+      log3.info("Tools executing", {
+        requestId,
         parentToolId,
         count: toolCalls.length,
         tools: toolCalls.map((tc) => tc.name)
@@ -2515,19 +2500,42 @@ Current date/time: ${(/* @__PURE__ */ new Date()).toISOString().replace("T", " "
       }
     }
   };
+  const wrapRun = async () => {
+    try {
+      const result = await run();
+      log3.info("Sub-agent complete", {
+        requestId,
+        parentToolId,
+        agentName,
+        durationMs: Date.now() - runStart,
+        turns
+      });
+      return result;
+    } catch (err) {
+      log3.warn("Sub-agent error", {
+        requestId,
+        parentToolId,
+        agentName,
+        error: err.message
+      });
+      throw err;
+    }
+  };
   if (!background) {
-    return run();
+    return wrapRun();
   }
+  log3.info("Sub-agent backgrounded", { requestId, parentToolId, agentName });
   const ack = await generateBackgroundAck({
     apiConfig,
     agentName: subAgentId || "agent",
     task
   });
-  run().then((finalResult) => onBackgroundComplete?.(finalResult)).catch(
+  wrapRun().then((finalResult) => onBackgroundComplete?.(finalResult)).catch(
     (err) => onBackgroundComplete?.({ text: `Error: ${err.message}`, messages: [] })
   );
   return { text: ack, messages: [], backgrounded: true };
 }
+var log3;
 var init_runner = __esm({
   "src/subagents/runner.ts"() {
     "use strict";
@@ -2535,6 +2543,7 @@ var init_runner = __esm({
     init_logger();
     init_statusWatcher();
     init_cleanMessages();
+    log3 = createLogger("sub-agent");
   }
 });
 
@@ -2711,7 +2720,7 @@ var init_prompt = __esm({
 });
 
 // src/subagents/browserAutomation/index.ts
-var browserAutomationTool;
+var log4, browserAutomationTool;
 var init_browserAutomation = __esm({
   "src/subagents/browserAutomation/index.ts"() {
     "use strict";
@@ -2722,6 +2731,7 @@ var init_browserAutomation = __esm({
     init_screenshot();
     init_runCli();
     init_logger();
+    log4 = createLogger("browser-automation");
     browserAutomationTool = {
       definition: {
         name: "runAutomatedBrowserTest",
@@ -2781,6 +2791,7 @@ var init_browserAutomation = __esm({
           subAgentId: "browserAutomation",
           signal: context.signal,
           parentToolId: context.toolCallId,
+          requestId: context.requestId,
           onEvent: context.onEvent,
           resolveExternalTool: async (id, name, input2) => {
             if (!context.resolveExternalTool) {
@@ -2815,7 +2826,7 @@ var init_browserAutomation = __esm({
                       }
                     }
                   } catch {
-                    log.debug("Failed to parse batch analysis result", {
+                    log4.debug("Failed to parse batch analysis result", {
                       batchResult
                     });
                   }
@@ -2944,6 +2955,8 @@ You are analyzing a screenshot of a real website or app for a designer's persona
 
 Analyze the image and think about what makes the site or app special and unique.  What is it doing that is unique, different, original, and creative? What makes it special? What isn't working? What doesn't look or feel good?
 
+Important: First, look at the screenshot and use your judgement to identify what the user wants notes about. If the screenshot is of a website for design case studies, or a blog post writeup about a new product or design, assume that the user is interested in a reference for the site/app/product being talked about - it is unlikely they are interested in a design audit of dribble.com, for example.
+
 Then, provide the following analysis:
 
 ## Context
@@ -3060,21 +3073,68 @@ var init_screenshot3 = __esm({
   }
 });
 
-// src/subagents/designExpert/tools/_seedream.ts
-async function seedreamGenerate(opts) {
-  const { prompts, sourceImages, transparentBackground, onLog } = opts;
-  const width = opts.width || 2048;
-  const height = opts.height || 2048;
-  const config = { width, height };
-  if (sourceImages?.length) {
-    config.images = sourceImages;
+// src/subagents/designExpert/tools/images/enhancePrompt.ts
+async function enhanceImagePrompt(params) {
+  const { brief, aspectRatio, transparentBackground, onLog } = params;
+  const orientation = aspectRatio === "1:1" ? "square" : ["16:9", "4:3", "3:2"].includes(aspectRatio) ? "landscape" : "portrait";
+  const contextParts = [
+    `Aspect ratio: ${aspectRatio} (${orientation})`
+  ];
+  if (transparentBackground) {
+    contextParts.push(
+      "Transparent background: yes \u2014 the background will be removed. Focus on the subject as an isolated element."
+    );
+  }
+  const message = `<context>
+${contextParts.join("\n")}
+</context>
+
+<brief>
+${brief}
+</brief>`;
+  const enhanced = await runCli(
+    `mindstudio generate-text --prompt ${JSON.stringify(SYSTEM_PROMPT)} --message ${JSON.stringify(message)} --output-key enhanced --no-meta`,
+    { timeout: 6e4, onLog }
+  );
+  return enhanced.trim();
+}
+var SYSTEM_PROMPT;
+var init_enhancePrompt = __esm({
+  "src/subagents/designExpert/tools/images/enhancePrompt.ts"() {
+    "use strict";
+    init_runCli();
+    init_assets();
+    SYSTEM_PROMPT = readAsset(
+      "subagents/designExpert/tools/images/enhance-image-prompt.md"
+    );
   }
+});
+
+// src/subagents/designExpert/tools/images/imageGenerator.ts
+async function generateImageAssets(opts) {
+  const { prompts, sourceImages, transparentBackground, onLog } = opts;
+  const aspectRatio = opts.aspectRatio || "1:1";
+  const config = {
+    aspect_ratio: aspectRatio,
+    ...sourceImages?.length && { source_images: sourceImages }
+  };
+  const isEdit = !!sourceImages?.length;
+  const enhancedPrompts = isEdit ? prompts : await Promise.all(
+    prompts.map(
+      (brief) => enhanceImagePrompt({
+        brief,
+        aspectRatio,
+        transparentBackground,
+        onLog
+      })
+    )
+  );
   let imageUrls;
-  if (prompts.length === 1) {
+  if (enhancedPrompts.length === 1) {
     const step = JSON.stringify({
-      prompt: prompts[0],
+      prompt: enhancedPrompts[0],
       imageModelOverride: {
-        model: "seedream-4.5",
+        model: "gemini-3.1-flash-image",
         config
       }
     });
@@ -3084,12 +3144,12 @@ async function seedreamGenerate(opts) {
     );
     imageUrls = [url];
   } else {
-    const steps = prompts.map((prompt) => ({
+    const steps = enhancedPrompts.map((prompt) => ({
       stepType: "generateImage",
       step: {
         prompt,
         imageModelOverride: {
-          model: "seedream-4.5",
+          model: "gemini-3.1-flash-image",
           config
         }
       }
@@ -3126,49 +3186,59 @@ async function seedreamGenerate(opts) {
   const images = await Promise.all(
     imageUrls.map(async (url, i) => {
       if (url.startsWith("Error")) {
-        return { prompt: prompts[i], error: url };
+        return {
+          prompt: prompts[i],
+          ...!isEdit && { enhancedPrompt: enhancedPrompts[i] },
+          error: url
+        };
       }
       const analysis = await runCli(
         `mindstudio analyze-image --prompt ${JSON.stringify(ANALYZE_PROMPT)} --image-url ${JSON.stringify(url)} --output-key analysis --no-meta`,
         { timeout: 2e5, onLog }
       );
-      return { url, prompt: prompts[i], analysis, width, height };
+      return {
+        url,
+        prompt: prompts[i],
+        ...!isEdit && { enhancedPrompt: enhancedPrompts[i] },
+        analysis,
+        aspectRatio
+      };
     })
   );
   return JSON.stringify({ images });
 }
 var ANALYZE_PROMPT;
-var init_seedream = __esm({
-  "src/subagents/designExpert/tools/_seedream.ts"() {
+var init_imageGenerator = __esm({
+  "src/subagents/designExpert/tools/images/imageGenerator.ts"() {
     "use strict";
     init_runCli();
-    ANALYZE_PROMPT = "You are reviewing this image for a visual designer sourcing assets for a project. Describe: what the image depicts, the mood and color palette, how the lighting and composition work, whether there are any issues (unwanted text, artifacts, distortions), and how it could be used in a layout (hero background, feature section, card texture, etc). Be concise and practical. Respond only with your analysis as Markdown and absolutely no other text. Do not use emojis - use unicode if you need symbols.";
+    init_enhancePrompt();
+    ANALYZE_PROMPT = "You are reviewing this image for a visual designer sourcing assets for a project. Describe: what the image depicts, the mood and color palette, how the lighting and composition work, any text present in the image, whether there are any issues (artifacts, distortions), and how it could be used in a layout for an app or website. Be concise and practical. Respond only with your analysis as Markdown and absolutely no other text. Do not use emojis - use unicode if you need symbols.";
   }
 });
 
-// src/subagents/designExpert/tools/generateImages.ts
+// src/subagents/designExpert/tools/images/generateImages.ts
 var generateImages_exports = {};
 __export(generateImages_exports, {
   definition: () => definition6,
   execute: () => execute6
 });
 async function execute6(input, onLog) {
-  return seedreamGenerate({
+  return generateImageAssets({
     prompts: input.prompts,
-    width: input.width,
-    height: input.height,
+    aspectRatio: input.aspectRatio,
     transparentBackground: input.transparentBackground,
     onLog
   });
 }
 var definition6;
 var init_generateImages = __esm({
-  "src/subagents/designExpert/tools/generateImages.ts"() {
+  "src/subagents/designExpert/tools/images/generateImages.ts"() {
     "use strict";
-    init_seedream();
+    init_imageGenerator();
     definition6 = {
       name: "generateImages",
-      description: "Generate images using AI. 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.",
+      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: {
         type: "object",
         properties: {
@@ -3177,15 +3247,12 @@ var init_generateImages = __esm({
             items: {
               type: "string"
             },
-            description: "One or more image generation prompts. Be detailed: describe style, mood, composition, colors. Multiple prompts run in parallel."
-          },
-          width: {
-            type: "number",
-            description: "Image width in pixels. Default 2048. Range: 2048-4096."
+            description: "One or more image briefs describing what you want. Focus on subject, mood, style, and intended use \u2014 the tool optimizes your brief into a model-ready prompt automatically. Multiple briefs run in parallel."
           },
-          height: {
-            type: "number",
-            description: "Image height in pixels. Default 2048. Range: 2048-4096."
+          aspectRatio: {
+            type: "string",
+            enum: ["1:1", "16:9", "9:16", "3:4", "4:3", "2:3", "3:2"],
+            description: "Aspect ratio. Default 1:1."
           },
           transparentBackground: {
             type: "boolean",
@@ -3198,30 +3265,29 @@ var init_generateImages = __esm({
   }
 });
 
-// src/subagents/designExpert/tools/editImages.ts
+// src/subagents/designExpert/tools/images/editImages.ts
 var editImages_exports = {};
 __export(editImages_exports, {
   definition: () => definition7,
   execute: () => execute7
 });
 async function execute7(input, onLog) {
-  return seedreamGenerate({
+  return generateImageAssets({
     prompts: input.prompts,
     sourceImages: input.sourceImages,
-    width: input.width,
-    height: input.height,
+    aspectRatio: input.aspectRatio,
     transparentBackground: input.transparentBackground,
     onLog
   });
 }
 var definition7;
 var init_editImages = __esm({
-  "src/subagents/designExpert/tools/editImages.ts"() {
+  "src/subagents/designExpert/tools/images/editImages.ts"() {
     "use strict";
-    init_seedream();
+    init_imageGenerator();
     definition7 = {
       name: "editImages",
-      description: "Edit or transform existing images using AI. 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 ferences into something new. Returns CDN URLs with analysis.",
+      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: {
         type: "object",
         properties: {
@@ -3230,7 +3296,7 @@ var init_editImages = __esm({
             items: {
               type: "string"
             },
-            description: "One or more edit prompts describing how to transform the source images. Multiple prompts run in parallel, each using the same source images."
+            description: "One or more edit briefs describing the desired transformation. Focus on what to change relative to the source material. Multiple briefs run in parallel, each using the same source images."
           },
           sourceImages: {
             type: "array",
@@ -3239,13 +3305,10 @@ var init_editImages = __esm({
             },
             description: "One or more source/reference image URLs. These are used as the basis for the edit \u2014 the AI will use them as reference for style, subject, or composition."
           },
-          width: {
-            type: "number",
-            description: "Output width in pixels. Default 2048. Range: 2048-4096."
-          },
-          height: {
-            type: "number",
-            description: "Output height in pixels. Default 2048. Range: 2048-4096."
+          aspectRatio: {
+            type: "string",
+            enum: ["1:1", "16:9", "9:16", "3:4", "4:3", "2:3", "3:2"],
+            description: "Output aspect ratio. Default 1:1."
           },
           transparentBackground: {
             type: "boolean",
@@ -3429,15 +3492,11 @@ function getFontLibrarySample() {
   return `
 ## Font Library
 
-A random sample from a curated font library. Use these as starting points for font selection.
+This is your personal library of fonts you love. Use it as a starting point when thinking about anything related to typography.
 
 ### Fonts
 
-${fontList}
-
-### Pairings
-
-${pairingList}`.trim();
+${fontList}`.trim();
 }
 var fontData;
 var init_getFontLibrarySample = __esm({
@@ -3464,16 +3523,16 @@ function sample2(arr, n) {
   return copy.slice(0, n);
 }
 function getDesignReferencesSample() {
-  const images = sample2(inspirationImages, 30);
+  const images = sample2(inspirationImages, 25);
   if (!images.length) {
     return "";
   }
   const imageList = images.map((img, i) => `### Reference ${i + 1}
 ${img.analysis}`).join("\n\n");
   return `
-## Design References
+## Visual Design References
 
-This is what the bar looks like. These are real sites that made it onto curated design galleries because they did something bold, intentional, and memorable. Use them as inspiration and let the takeaways guide your work. Your designs should feel like they belong in this company.
+This is your personal reference library of visual design you love. The apps and sites featured within made it into your library because they did something bold, intentional, and memorable. Use them as reference, inspiration, and let the takeaways guide your work.
 
 ${imageList}`.trim();
 }
@@ -3502,16 +3561,16 @@ function sample3(arr, n) {
   return copy.slice(0, n);
 }
 function getUiInspirationSample() {
-  const screens = sample3(uiScreens, 20);
+  const screens = sample3(uiScreens, 25);
   if (!screens.length) {
     return "";
   }
   const screenList = screens.map((s, i) => `### Screen ${i + 1}
 ${s.analysis}`).join("\n\n");
   return `
-## UI Pattern References
+## UI Case Studies
 
-There are real app screens from well-designed products, sourced and curated by hand as a reference by a desigher. Use them as inspiration and let the takeaways guide your work. Your designs should feel like they belong in this company.
+These are your personal notes, collected over the years, about UI patterns you've encountered in the wild that you love. You re-use aspects of them liberally in your work, reference them as ground truths, as well as use them to synthesize new ideas and refine your sense of what good UI feels and looks like. The work you do must always feel like it belongs in this company.
 
 ${screenList}`.trim();
 }
@@ -3534,7 +3593,7 @@ function getDesignExpertPrompt() {
   let prompt = PROMPT_TEMPLATE.replace(
     "{{font_library}}",
     getFontLibrarySample()
-  ).replace("{{design_references}}", getDesignReferencesSample()).replace("{{ui_patterns}}", getUiInspirationSample());
+  ).replace("{{visual_design_references}}", getDesignReferencesSample()).replace("{{ui_case_studies}}", getUiInspirationSample());
   if (specContext) {
     prompt += `
 
@@ -3558,8 +3617,8 @@ var init_prompt2 = __esm({
     SUBAGENT = "subagents/designExpert";
     RUNTIME_PLACEHOLDERS = /* @__PURE__ */ new Set([
       "font_library",
-      "design_references",
-      "ui_patterns"
+      "visual_design_references",
+      "ui_case_studies"
     ]);
     PROMPT_TEMPLATE = readAsset(SUBAGENT, "prompt.md").replace(/\{\{([^}]+)\}\}/g, (match, key) => {
       const k = key.trim();
@@ -3577,7 +3636,7 @@ var init_designExpert = __esm({
     init_tools2();
     init_prompt2();
     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.
+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();
     designExpertTool = {
       definition: {
@@ -3613,6 +3672,7 @@ Visual design expert. Describe the situation and what you need \u2014 the agent
           subAgentId: "visualDesignExpert",
           signal: context.signal,
           parentToolId: context.toolCallId,
+          requestId: context.requestId,
           onEvent: context.onEvent,
           resolveExternalTool: context.resolveExternalTool,
           toolRegistry: context.toolRegistry,
@@ -3942,6 +4002,7 @@ var init_productVision = __esm({
           subAgentId: "productVision",
           signal: context.signal,
           parentToolId: context.toolCallId,
+          requestId: context.requestId,
           onEvent: context.onEvent,
           resolveExternalTool: context.resolveExternalTool,
           toolRegistry: context.toolRegistry,
@@ -4106,6 +4167,7 @@ var init_codeSanityCheck = __esm({
           subAgentId: "codeSanityCheck",
           signal: context.signal,
           parentToolId: context.toolCallId,
+          requestId: context.requestId,
           onEvent: context.onEvent,
           resolveExternalTool: context.resolveExternalTool,
           toolRegistry: context.toolRegistry
@@ -4244,6 +4306,7 @@ function loadSession(state) {
     const data = JSON.parse(raw);
     if (Array.isArray(data.messages) && data.messages.length > 0) {
       state.messages = sanitizeMessages(data.messages);
+      log5.info("Session loaded", { messageCount: state.messages.length });
       return true;
     }
   } catch {
@@ -4293,7 +4356,9 @@ function saveSession(state) {
       JSON.stringify({ messages: state.messages }, null, 2),
       "utf-8"
     );
-  } catch {
+    log5.info("Session saved", { messageCount: state.messages.length });
+  } catch (err) {
+    log5.warn("Session save failed", { error: err.message });
   }
 }
 function clearSession(state) {
@@ -4303,10 +4368,12 @@ function clearSession(state) {
   } catch {
   }
 }
-var SESSION_FILE;
+var log5, SESSION_FILE;
 var init_session = __esm({
   "src/session.ts"() {
     "use strict";
+    init_logger();
+    log5 = createLogger("session");
     SESSION_FILE = ".remy-session.json";
   }
 });
@@ -4537,17 +4604,17 @@ async function runTurn(params) {
     onEvent,
     resolveExternalTool,
     hidden,
+    requestId,
     toolRegistry,
     onBackgroundComplete
   } = params;
   const tools2 = getToolDefinitions(onboardingState);
-  log.info("Turn started", {
-    messageLength: userMessage.length,
+  log6.info("Turn started", {
+    requestId,
+    model,
     toolCount: tools2.length,
-    tools: tools2.map((t) => t.name),
     ...attachments && attachments.length > 0 && {
-      attachmentCount: attachments.length,
-      attachmentUrls: attachments.map((a) => a.url)
+      attachmentCount: attachments.length
     }
   });
   onEvent({ type: "turn_started" });
@@ -4557,10 +4624,6 @@ async function runTurn(params) {
   }
   if (attachments && attachments.length > 0) {
     userMsg.attachments = attachments;
-    log.debug("Attachments added to user message", {
-      count: attachments.length,
-      urls: attachments.map((a) => a.url)
-    });
   }
   state.messages.push(userMsg);
   const STATUS_EXCLUDED_TOOLS = /* @__PURE__ */ new Set([
@@ -4621,11 +4684,6 @@ async function runTurn(params) {
         }
         acc.lastEmittedCount = result.emittedCount;
         acc.started = true;
-        log.debug("Streaming partial tool_start", {
-          id,
-          name,
-          emittedCount: result.emittedCount
-        });
         onEvent({
           type: "tool_start",
           id,
@@ -4641,10 +4699,6 @@ async function runTurn(params) {
       }
       if (!acc.started) {
         acc.started = true;
-        log.debug("Streaming content tool: emitting early tool_start", {
-          id,
-          name
-        });
         onEvent({ type: "tool_start", id, name, input: partial });
       }
       if (transform) {
@@ -4652,18 +4706,8 @@ async function runTurn(params) {
         if (result === null) {
           return;
         }
-        log.debug("Streaming content tool: emitting tool_input_delta", {
-          id,
-          name,
-          resultLength: result.length
-        });
         onEvent({ type: "tool_input_delta", id, name, result });
       } else {
-        log.debug("Streaming content tool: emitting tool_input_delta", {
-          id,
-          name,
-          contentLength: content.length
-        });
         onEvent({ type: "tool_input_delta", id, name, result: content });
       }
     }
@@ -4672,6 +4716,7 @@ async function runTurn(params) {
         {
           ...apiConfig,
           model,
+          requestId,
           system,
           messages: cleanMessagesForApi(state.messages),
           tools: tools2,
@@ -4723,12 +4768,6 @@ async function runTurn(params) {
           case "tool_input_delta": {
             const acc = getOrCreateAccumulator2(event.id, event.name);
             acc.json += event.delta;
-            log.debug("Received tool_input_delta", {
-              id: event.id,
-              name: event.name,
-              deltaLength: event.delta.length,
-              accumulatedLength: acc.json.length
-            });
             try {
               const partial = parsePartialJson(acc.json);
               await handlePartialInput(acc, event.id, event.name, partial);
@@ -4738,11 +4777,6 @@ async function runTurn(params) {
           }
           case "tool_input_args": {
             const acc = getOrCreateAccumulator2(event.id, event.name);
-            log.debug("Received tool_input_args", {
-              id: event.id,
-              name: event.name,
-              keys: Object.keys(event.args)
-            });
             await handlePartialInput(acc, event.id, event.name, event.args);
             break;
           }
@@ -4759,11 +4793,10 @@ async function runTurn(params) {
             const tool = getToolByName(event.name);
             const wasStreamed = acc?.started ?? false;
             const isInputStreaming = !!tool?.streaming?.partialInput;
-            log.info("Tool call received", {
-              id: event.id,
-              name: event.name,
-              wasStreamed,
-              isInputStreaming
+            log6.info("Tool received", {
+              requestId,
+              toolCallId: event.id,
+              name: event.name
             });
             if (!wasStreamed || isInputStreaming) {
               onEvent({
@@ -4817,7 +4850,8 @@ async function runTurn(params) {
       onEvent({ type: "turn_done" });
       return;
     }
-    log.info("Executing tools", {
+    log6.info("Tools executing", {
+      requestId,
       count: toolCalls.length,
       tools: toolCalls.map((tc) => tc.name)
     });
@@ -4860,9 +4894,10 @@ async function runTurn(params) {
             let result;
             if (EXTERNAL_TOOLS.has(tc.name) && resolveExternalTool) {
               saveSession(state);
-              log.info("Waiting for external tool result", {
-                name: tc.name,
-                id: tc.id
+              log6.info("Waiting for external tool result", {
+                requestId,
+                toolCallId: tc.id,
+                name: tc.name
               });
               result = await resolveExternalTool(tc.id, tc.name, input);
             } else {
@@ -4873,6 +4908,7 @@ async function runTurn(params) {
                 onEvent: wrappedOnEvent,
                 resolveExternalTool,
                 toolCallId: tc.id,
+                requestId,
                 subAgentMessages,
                 toolRegistry,
                 onBackgroundComplete,
@@ -4911,11 +4947,12 @@ async function runTurn(params) {
         run(tc.input);
         const r = await resultPromise;
         toolRegistry?.unregister(tc.id);
-        log.info("Tool completed", {
+        log6.info("Tool completed", {
+          requestId,
+          toolCallId: tc.id,
           name: tc.name,
-          elapsed: `${Date.now() - toolStart}ms`,
-          isError: r.isError,
-          resultLength: r.result.length
+          durationMs: Date.now() - toolStart,
+          isError: r.isError
         });
         onEvent({
           type: "tool_done",
@@ -4959,7 +4996,7 @@ async function runTurn(params) {
     }
   }
 }
-var EXTERNAL_TOOLS;
+var log6, EXTERNAL_TOOLS;
 var init_agent = __esm({
   "src/agent.ts"() {
     "use strict";
@@ -4971,6 +5008,7 @@ var init_agent = __esm({
     init_statusWatcher();
     init_errors();
     init_cleanMessages();
+    log6 = createLogger("agent");
     EXTERNAL_TOOLS = /* @__PURE__ */ new Set([
       "promptUser",
       "setProjectOnboardingState",
@@ -5250,10 +5288,10 @@ import os from "os";
 function loadConfigFile() {
   try {
     const raw = fs17.readFileSync(CONFIG_PATH, "utf-8");
-    log.debug("Loaded config file", { path: CONFIG_PATH });
+    log7.debug("Loaded config file", { path: CONFIG_PATH });
     return JSON.parse(raw);
   } catch (err) {
-    log.debug("No config file found", {
+    log7.debug("No config file found", {
       path: CONFIG_PATH,
       error: err.message
     });
@@ -5267,24 +5305,25 @@ function resolveConfig(flags2) {
   const apiKey = flags2?.apiKey || process.env.MINDSTUDIO_API_KEY || env?.apiKey || "";
   const baseUrl2 = flags2?.baseUrl || process.env.MINDSTUDIO_BASE_URL || env?.apiBaseUrl || DEFAULT_BASE_URL;
   if (!apiKey) {
-    log.error("No API key found");
+    log7.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";
-  log.info("Config resolved", {
+  log7.info("Config resolved", {
     baseUrl: baseUrl2,
     keySource,
     environment: activeEnv
   });
   return { apiKey, baseUrl: baseUrl2 };
 }
-var CONFIG_PATH, DEFAULT_BASE_URL;
+var log7, CONFIG_PATH, DEFAULT_BASE_URL;
 var init_config = __esm({
   "src/config.ts"() {
     "use strict";
     init_logger();
+    log7 = createLogger("config");
     CONFIG_PATH = path8.join(
       os.homedir(),
       ".mindstudio-local-tunnel",
@@ -5295,10 +5334,12 @@ var init_config = __esm({
 });
 
 // src/toolRegistry.ts
-var ToolRegistry;
+var log8, ToolRegistry;
 var init_toolRegistry = __esm({
   "src/toolRegistry.ts"() {
     "use strict";
+    init_logger();
+    log8 = createLogger("tool-registry");
     ToolRegistry = class {
       entries = /* @__PURE__ */ new Map();
       onEvent;
@@ -5324,6 +5365,7 @@ var init_toolRegistry = __esm({
         if (!entry) {
           return false;
         }
+        log8.info("Tool stopped", { toolCallId: id, name: entry.name, mode });
         entry.abortController.abort(mode);
         if (mode === "graceful") {
           const partial = entry.getPartialResult?.() ?? "";
@@ -5356,6 +5398,7 @@ ${partial}` : "[INTERRUPTED] Tool execution was stopped.";
         if (!entry) {
           return false;
         }
+        log8.info("Tool restarted", { toolCallId: id, name: entry.name });
         entry.abortController.abort("restart");
         const newInput = patchedInput ? { ...entry.input, ...patchedInput } : entry.input;
         this.onEvent?.({
@@ -5476,6 +5519,11 @@ ${xmlParts}
         }
       }
     }
+    log9.info("Background complete", {
+      toolCallId,
+      name,
+      requestId: currentRequestId
+    });
     onEvent({
       type: "tool_background_complete",
       id: toolCallId,
@@ -5668,6 +5716,7 @@ ${xmlParts}
     currentRequestId = requestId;
     currentAbort = new AbortController();
     completedEmitted = false;
+    const turnStart = Date.now();
     const attachments = parsed.attachments;
     if (attachments?.length) {
       console.warn(
@@ -5699,6 +5748,7 @@ ${xmlParts}
         system,
         model: opts.model,
         onboardingState,
+        requestId,
         signal: currentAbort.signal,
         onEvent,
         resolveExternalTool,
@@ -5713,11 +5763,20 @@ ${xmlParts}
           requestId
         );
       }
+      log9.info("Turn complete", {
+        requestId,
+        durationMs: Date.now() - turnStart
+      });
     } catch (err) {
       if (!completedEmitted) {
         emit("error", { error: err.message }, requestId);
         emit("completed", { success: false, error: err.message }, requestId);
       }
+      log9.warn("Command failed", {
+        action: "message",
+        requestId,
+        error: err.message
+      });
     }
     currentAbort = null;
     currentRequestId = void 0;
@@ -5733,6 +5792,7 @@ ${xmlParts}
       return;
     }
     const { action, requestId } = parsed;
+    log9.info("Command received", { action, requestId });
     if (action === "tool_result" && parsed.id) {
       const id = parsed.id;
       const result = parsed.result ?? "";
@@ -5813,16 +5873,19 @@ ${xmlParts}
   process.on("SIGINT", shutdown);
   emit("ready");
 }
+var log9;
 var init_headless = __esm({
   "src/headless.ts"() {
     "use strict";
     init_assets();
+    init_logger();
     init_config();
     init_prompt4();
     init_lsp();
     init_agent();
     init_session();
     init_toolRegistry();
+    log9 = createLogger("headless");
   }
 });
 
@@ -6145,6 +6208,7 @@ for (let i = 0; i < args.length; i++) {
     headless = true;
   }
 }
+var startupLog = createLogger("startup");
 function printDebugInfo(config) {
   const pkg = JSON.parse(
     fs18.readFileSync(
@@ -6153,23 +6217,18 @@ function printDebugInfo(config) {
     )
   );
   const keyPreview = config.apiKey ? `${config.apiKey.slice(0, 8)}...${config.apiKey.slice(-4)}` : "(none)";
-  console.log("");
-  console.log("remy debug info");
-  console.log("\u2500".repeat(40));
-  console.log(`  version:    ${pkg.version}`);
-  console.log(`  node:       ${process.version}`);
-  console.log(`  platform:   ${os2.platform()} ${os2.arch()}`);
-  console.log(`  os:         ${os2.type()} ${os2.release()}`);
-  console.log(`  cwd:        ${process.cwd()}`);
-  console.log(`  bin:        ${process.argv[1]}`);
-  console.log(`  model:      ${flags.model || "(default)"}`);
-  console.log(`  base url:   ${config.baseUrl}`);
-  console.log(`  api key:    ${keyPreview}`);
-  console.log(
-    `  key source: ${flags.apiKey ? "cli flag" : process.env.MINDSTUDIO_API_KEY ? "env var" : "config file"}`
-  );
-  console.log("\u2500".repeat(40));
-  console.log("");
+  startupLog.info("Startup", {
+    version: pkg.version,
+    node: process.version,
+    platform: `${os2.platform()} ${os2.arch()}`,
+    os: `${os2.type()} ${os2.release()}`,
+    cwd: process.cwd(),
+    bin: process.argv[1],
+    model: flags.model || "(default)",
+    baseUrl: config.baseUrl,
+    apiKey: keyPreview,
+    keySource: flags.apiKey ? "cli flag" : process.env.MINDSTUDIO_API_KEY ? "env var" : "config file"
+  });
 }
 var logLevel = flags.logLevel || void 0;
 if (headless) {