@mindstudio-ai/remy 0.1.39 → 0.1.41

package/dist/headless.js

@@ -44,11 +44,6 @@ function readJsonAsset(fallback, ...segments) {
   }
 }
 
-// src/config.ts
-import fs3 from "fs";
-import path2 from "path";
-import os from "os";
-
 // src/logger.ts
 import fs2 from "fs";
 var LEVELS = {
@@ -60,9 +55,6 @@ var LEVELS = {
 var currentLevel = LEVELS.error;
 var writeFn = () => {
 };
-function timestamp() {
-  return (/* @__PURE__ */ new Date()).toISOString();
-}
 var MAX_VALUE_LENGTH = 200;
 function truncateValues(obj) {
   const result = {};
@@ -77,32 +69,35 @@ 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)
+  };
 }
-var 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/config.ts
+import fs3 from "fs";
+import path2 from "path";
+import os from "os";
+var log = createLogger("config");
 var CONFIG_PATH = path2.join(
   os.homedir(),
   ".mindstudio-local-tunnel",
@@ -144,10 +139,11 @@ function resolveConfig(flags) {
 }
 
 // src/tools/_helpers/sidecar.ts
+var log2 = createLogger("sidecar");
 var baseUrl = null;
 function setSidecarBaseUrl(url) {
   baseUrl = url;
-  log.info("Sidecar configured", { url });
+  log2.info("Configured", { url });
 }
 function isSidecarConfigured() {
   return baseUrl !== null;
@@ -157,7 +153,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",
@@ -166,7 +161,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();
@@ -174,7 +169,7 @@ 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}`);
   }
 }
@@ -429,25 +424,19 @@ ${viewContext?.activeFile ? `Active file: ${viewContext.activeFile}` : ""}
 }
 
 // src/api.ts
+var log3 = createLogger("api");
 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,
+  log3.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 {
@@ -462,15 +451,15 @@ async function* streamChat(params) {
     });
   } catch (err) {
     if (signal?.aborted) {
-      log.info("Request aborted by signal");
+      log3.warn("Request aborted", { requestId });
       throw err;
     }
-    log.error("Network error", { error: err.message });
+    log3.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` });
+  log3.info("API response", { requestId, status: res.status, ttfbMs: ttfb });
   if (!res.ok) {
     let errorMessage = `HTTP ${res.status}`;
     try {
@@ -483,7 +472,11 @@ async function* streamChat(params) {
       }
     } catch {
     }
-    log.error("API error", { status: res.status, error: errorMessage });
+    log3.error("API error", {
+      requestId,
+      status: res.status,
+      error: errorMessage
+    });
     yield { type: "error", error: errorMessage };
     return;
   }
@@ -508,7 +501,10 @@ async function* streamChat(params) {
     } catch {
       clearTimeout(stallTimer);
       await reader.cancel();
-      log.error("Stream stalled", { elapsed: `${Date.now() - startTime}ms` });
+      log3.error("Stream stalled", {
+        requestId,
+        durationMs: Date.now() - startTime
+      });
       yield {
         type: "error",
         error: "Stream stalled \u2014 no data received for 5 minutes"
@@ -530,8 +526,9 @@ async function* streamChat(params) {
         const event = JSON.parse(line.slice(6));
         if (event.type === "done") {
           const elapsed = Date.now() - startTime;
-          log.info("Stream complete", {
-            elapsed: `${elapsed}ms`,
+          log3.info("Stream complete", {
+            requestId,
+            durationMs: elapsed,
             stopReason: event.stopReason,
             inputTokens: event.usage.inputTokens,
             outputTokens: event.usage.outputTokens
@@ -564,11 +561,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;
@@ -583,7 +575,12 @@ async function* streamChatWithRetry(params, options) {
         return;
       }
       const backoff = INITIAL_BACKOFF_MS * 2 ** attempt;
-      log.info("Retrying after backoff", { backoffMs: backoff });
+      log3.warn("Retrying", {
+        requestId: params.requestId,
+        attempt: attempt + 1,
+        maxRetries: MAX_RETRIES,
+        backoffMs: backoff
+      });
       await sleep(backoff);
       continue;
     }
@@ -1491,9 +1488,9 @@ var setProjectMetadataTool = {
 import fs9 from "fs/promises";
 var DEFAULT_MAX_LINES2 = 500;
 function isBinary(buffer) {
-  const sample3 = buffer.subarray(0, 8192);
-  for (let i = 0; i < sample3.length; i++) {
-    if (sample3[i] === 0) {
+  const sample4 = buffer.subarray(0, 8192);
+  for (let i = 0; i < sample4.length; i++) {
+    if (sample4[i] === 0) {
       return true;
     }
   }
@@ -2158,7 +2155,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(
@@ -2218,13 +2214,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: {
@@ -2241,30 +2232,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;
     }
@@ -2272,12 +2251,10 @@ 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");
     }
   };
 }
@@ -2318,6 +2295,7 @@ function cleanMessagesForApi(messages) {
 }
 
 // src/subagents/runner.ts
+var log4 = createLogger("sub-agent");
 async function runSubAgent(config) {
   const {
     system,
@@ -2333,14 +2311,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();
+  log4.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) {
@@ -2360,6 +2343,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
     }
     let lastToolResult = "";
     while (true) {
+      turns++;
       if (signal?.aborted) {
         return abortResult([]);
       }
@@ -2385,6 +2369,7 @@ Current date/time: ${(/* @__PURE__ */ new Date()).toISOString().replace("T", " "
           {
             ...apiConfig,
             model,
+            requestId,
             subAgentId,
             system: fullSystem,
             messages: cleanMessagesForApi(messages),
@@ -2475,7 +2460,8 @@ Current date/time: ${(/* @__PURE__ */ new Date()).toISOString().replace("T", " "
         const text = getPartialText(contentBlocks);
         return { text, messages };
       }
-      log.info("Sub-agent executing tools", {
+      log4.info("Tools executing", {
+        requestId,
         parentToolId,
         count: toolCalls.length,
         tools: toolCalls.map((tc) => tc.name)
@@ -2574,15 +2560,37 @@ Current date/time: ${(/* @__PURE__ */ new Date()).toISOString().replace("T", " "
       }
     }
   };
+  const wrapRun = async () => {
+    try {
+      const result = await run();
+      log4.info("Sub-agent complete", {
+        requestId,
+        parentToolId,
+        agentName,
+        durationMs: Date.now() - runStart,
+        turns
+      });
+      return result;
+    } catch (err) {
+      log4.warn("Sub-agent error", {
+        requestId,
+        parentToolId,
+        agentName,
+        error: err.message
+      });
+      throw err;
+    }
+  };
   if (!background) {
-    return run();
+    return wrapRun();
   }
+  log4.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 };
@@ -2705,6 +2713,7 @@ ${appSpec}
 }
 
 // src/subagents/browserAutomation/index.ts
+var log5 = createLogger("browser-automation");
 var browserAutomationTool = {
   definition: {
     name: "runAutomatedBrowserTest",
@@ -2764,6 +2773,7 @@ var browserAutomationTool = {
       subAgentId: "browserAutomation",
       signal: context.signal,
       parentToolId: context.toolCallId,
+      requestId: context.requestId,
       onEvent: context.onEvent,
       resolveExternalTool: async (id, name, input2) => {
         if (!context.resolveExternalTool) {
@@ -2798,7 +2808,7 @@ var browserAutomationTool = {
                   }
                 }
               } catch {
-                log.debug("Failed to parse batch analysis result", {
+                log5.debug("Failed to parse batch analysis result", {
                   batchResult
                 });
               }
@@ -2885,6 +2895,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
@@ -3006,29 +3018,68 @@ async function execute5(input, onLog) {
   }
 }
 
-// src/subagents/designExpert/tools/generateImages.ts
+// src/subagents/designExpert/tools/images/generateImages.ts
 var generateImages_exports = {};
 __export(generateImages_exports, {
   definition: () => definition6,
   execute: () => execute6
 });
 
-// src/subagents/designExpert/tools/_seedream.ts
-var 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.";
-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
+var SYSTEM_PROMPT = readAsset(
+  "subagents/designExpert/tools/images/enhance-image-prompt.md"
+);
+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();
+}
+
+// src/subagents/designExpert/tools/images/imageGenerator.ts
+var 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.";
+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
       }
     });
@@ -3038,12 +3089,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
         }
       }
@@ -3080,22 +3131,32 @@ 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 });
 }
 
-// src/subagents/designExpert/tools/generateImages.ts
+// src/subagents/designExpert/tools/images/generateImages.ts
 var 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: {
@@ -3104,15 +3165,12 @@ var definition6 = {
         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",
@@ -3123,16 +3181,15 @@ var definition6 = {
   }
 };
 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
   });
 }
 
-// src/subagents/designExpert/tools/editImages.ts
+// src/subagents/designExpert/tools/images/editImages.ts
 var editImages_exports = {};
 __export(editImages_exports, {
   definition: () => definition7,
@@ -3140,7 +3197,7 @@ __export(editImages_exports, {
 });
 var 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: {
@@ -3149,7 +3206,7 @@ var definition7 = {
         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",
@@ -3158,13 +3215,10 @@ var definition7 = {
         },
         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",
@@ -3175,11 +3229,10 @@ var definition7 = {
   }
 };
 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
   });
@@ -3345,15 +3398,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();
 }
 
 // src/subagents/designExpert/data/getDesignReferencesSample.ts
@@ -3373,23 +3422,58 @@ 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();
 }
 
+// src/subagents/designExpert/data/getUiInspirationSample.ts
+var uiScreens = readJsonAsset(
+  { screens: [] },
+  "subagents/designExpert/data/sources/ui_inspiration_compiled.json"
+).screens;
+function sample3(arr, n) {
+  if (arr.length <= n) {
+    return [...arr];
+  }
+  const copy = [...arr];
+  for (let i = copy.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [copy[i], copy[j]] = [copy[j], copy[i]];
+  }
+  return copy.slice(0, n);
+}
+function getUiInspirationSample() {
+  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 Case Studies
+
+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();
+}
+
 // src/subagents/designExpert/prompt.ts
 var SUBAGENT = "subagents/designExpert";
-var RUNTIME_PLACEHOLDERS = /* @__PURE__ */ new Set(["font_library", "design_references"]);
+var RUNTIME_PLACEHOLDERS = /* @__PURE__ */ new Set([
+  "font_library",
+  "visual_design_references",
+  "ui_case_studies"
+]);
 var PROMPT_TEMPLATE = readAsset(SUBAGENT, "prompt.md").replace(/\{\{([^}]+)\}\}/g, (match, key) => {
   const k = key.trim();
   return RUNTIME_PLACEHOLDERS.has(k) ? match : readAsset(SUBAGENT, k);
@@ -3399,7 +3483,7 @@ function getDesignExpertPrompt() {
   let prompt = PROMPT_TEMPLATE.replace(
     "{{font_library}}",
     getFontLibrarySample()
-  ).replace("{{design_references}}", getDesignReferencesSample());
+  ).replace("{{visual_design_references}}", getDesignReferencesSample()).replace("{{ui_case_studies}}", getUiInspirationSample());
   if (specContext) {
     prompt += `
 
@@ -3414,7 +3498,7 @@ ${specContext}`;
 
 // src/subagents/designExpert/index.ts
 var DESCRIPTION = `
-Visual design expert. Describe the situation and what you need \u2014 the agent decides what to deliver. It reads the spec files automatically. Include relevant user requirements and context it can't get from the spec, but do not list specific deliverables or tell it how to do its job.
+Visual design expert. Describe the situation and what you need \u2014 the agent decides what to deliver. It reads the spec files automatically. Include relevant user requirements and context it can't get from the spec, but do not list specific deliverables or tell it how to do its job. Do not suggest implementation details or ideas - only relay what is needed.
 `.trim();
 var designExpertTool = {
   definition: {
@@ -3450,6 +3534,7 @@ var designExpertTool = {
       subAgentId: "visualDesignExpert",
       signal: context.signal,
       parentToolId: context.toolCallId,
+      requestId: context.requestId,
       onEvent: context.onEvent,
       resolveExternalTool: context.resolveExternalTool,
       toolRegistry: context.toolRegistry,
@@ -3746,6 +3831,7 @@ var productVisionTool = {
       subAgentId: "productVision",
       signal: context.signal,
       parentToolId: context.toolCallId,
+      requestId: context.requestId,
       onEvent: context.onEvent,
       resolveExternalTool: context.resolveExternalTool,
       toolRegistry: context.toolRegistry,
@@ -3893,6 +3979,7 @@ var codeSanityCheckTool = {
       subAgentId: "codeSanityCheck",
       signal: context.signal,
       parentToolId: context.toolCallId,
+      requestId: context.requestId,
       onEvent: context.onEvent,
       resolveExternalTool: context.resolveExternalTool,
       toolRegistry: context.toolRegistry
@@ -3985,6 +4072,7 @@ function executeTool(name, input, context) {
 
 // src/session.ts
 import fs17 from "fs";
+var log6 = createLogger("session");
 var SESSION_FILE = ".remy-session.json";
 function loadSession(state) {
   try {
@@ -3992,6 +4080,7 @@ function loadSession(state) {
     const data = JSON.parse(raw);
     if (Array.isArray(data.messages) && data.messages.length > 0) {
       state.messages = sanitizeMessages(data.messages);
+      log6.info("Session loaded", { messageCount: state.messages.length });
       return true;
     }
   } catch {
@@ -4041,7 +4130,9 @@ function saveSession(state) {
       JSON.stringify({ messages: state.messages }, null, 2),
       "utf-8"
     );
-  } catch {
+    log6.info("Session saved", { messageCount: state.messages.length });
+  } catch (err) {
+    log6.warn("Session save failed", { error: err.message });
   }
 }
 function clearSession(state) {
@@ -4242,6 +4333,7 @@ function friendlyError(raw) {
 }
 
 // src/agent.ts
+var log7 = createLogger("agent");
 function getTextContent(blocks) {
   return blocks.filter((b) => b.type === "text").map((b) => b.text).join("");
 }
@@ -4279,17 +4371,17 @@ async function runTurn(params) {
     onEvent,
     resolveExternalTool,
     hidden,
+    requestId,
     toolRegistry,
     onBackgroundComplete
   } = params;
   const tools2 = getToolDefinitions(onboardingState);
-  log.info("Turn started", {
-    messageLength: userMessage.length,
+  log7.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" });
@@ -4299,10 +4391,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([
@@ -4363,11 +4451,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,
@@ -4383,10 +4466,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) {
@@ -4394,18 +4473,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 });
       }
     }
@@ -4414,6 +4483,7 @@ async function runTurn(params) {
         {
           ...apiConfig,
           model,
+          requestId,
           system,
           messages: cleanMessagesForApi(state.messages),
           tools: tools2,
@@ -4465,12 +4535,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);
@@ -4480,11 +4544,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;
           }
@@ -4501,11 +4560,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
+            log7.info("Tool received", {
+              requestId,
+              toolCallId: event.id,
+              name: event.name
             });
             if (!wasStreamed || isInputStreaming) {
               onEvent({
@@ -4559,7 +4617,8 @@ async function runTurn(params) {
       onEvent({ type: "turn_done" });
       return;
     }
-    log.info("Executing tools", {
+    log7.info("Tools executing", {
+      requestId,
       count: toolCalls.length,
       tools: toolCalls.map((tc) => tc.name)
     });
@@ -4602,9 +4661,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
+              log7.info("Waiting for external tool result", {
+                requestId,
+                toolCallId: tc.id,
+                name: tc.name
               });
               result = await resolveExternalTool(tc.id, tc.name, input);
             } else {
@@ -4615,6 +4675,7 @@ async function runTurn(params) {
                 onEvent: wrappedOnEvent,
                 resolveExternalTool,
                 toolCallId: tc.id,
+                requestId,
                 subAgentMessages,
                 toolRegistry,
                 onBackgroundComplete,
@@ -4653,11 +4714,12 @@ async function runTurn(params) {
         run(tc.input);
         const r = await resultPromise;
         toolRegistry?.unregister(tc.id);
-        log.info("Tool completed", {
+        log7.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",
@@ -4703,6 +4765,7 @@ async function runTurn(params) {
 }
 
 // src/toolRegistry.ts
+var log8 = createLogger("tool-registry");
 var ToolRegistry = class {
   entries = /* @__PURE__ */ new Map();
   onEvent;
@@ -4728,6 +4791,7 @@ var ToolRegistry = class {
     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?.() ?? "";
@@ -4760,6 +4824,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?.({
@@ -4775,6 +4840,7 @@ ${partial}` : "[INTERRUPTED] Tool execution was stopped.";
 };
 
 // src/headless.ts
+var log9 = createLogger("headless");
 function loadActionPrompt(name) {
   return readAsset("prompt", "actions", `${name}.md`);
 }
@@ -4873,6 +4939,11 @@ ${xmlParts}
         }
       }
     }
+    log9.info("Background complete", {
+      toolCallId,
+      name,
+      requestId: currentRequestId
+    });
     onEvent({
       type: "tool_background_complete",
       id: toolCallId,
@@ -5065,6 +5136,7 @@ ${xmlParts}
     currentRequestId = requestId;
     currentAbort = new AbortController();
     completedEmitted = false;
+    const turnStart = Date.now();
     const attachments = parsed.attachments;
     if (attachments?.length) {
       console.warn(
@@ -5096,6 +5168,7 @@ ${xmlParts}
         system,
         model: opts.model,
         onboardingState,
+        requestId,
         signal: currentAbort.signal,
         onEvent,
         resolveExternalTool,
@@ -5110,11 +5183,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;
@@ -5130,6 +5212,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 ?? "";