@mindstudio-ai/remy 0.1.194 → 0.1.196

package/dist/headless.js

@@ -647,375 +647,215 @@ async function generateBackgroundAck(params) {
   }
 }
 
-// src/usageLedger.ts
-import fs5 from "fs";
-var LEDGER_FILE = ".logs/usage.ndjson";
-var fd = null;
-function nanoToDollars(nano) {
-  return typeof nano === "number" ? nano / 1e9 : void 0;
-}
-function recordUsage(entry) {
-  try {
-    if (fd === null) {
-      fs5.mkdirSync(".logs", { recursive: true });
-      fd = fs5.openSync(LEDGER_FILE, "a");
+// src/tools/spec/readSpec.ts
+import fs5 from "fs/promises";
+
+// src/tools/spec/_helpers.ts
+var HEADING_RE = /^(#{1,6})\s+(.+)$/;
+function parseHeadings(content) {
+  const lines = content.split("\n");
+  const headings = [];
+  for (let i = 0; i < lines.length; i++) {
+    const match = lines[i].match(HEADING_RE);
+    if (match) {
+      headings.push({
+        level: match[1].length,
+        text: match[2].trim(),
+        startLine: i,
+        contentStart: i + 1,
+        contentEnd: lines.length
+        // placeholder — resolved below
+      });
     }
-    fs5.writeSync(fd, JSON.stringify(entry) + "\n");
-  } catch {
   }
+  for (let i = 0; i < headings.length; i++) {
+    const current = headings[i];
+    let end = lines.length;
+    for (let j = i + 1; j < headings.length; j++) {
+      if (headings[j].level <= current.level) {
+        end = headings[j].startLine;
+        break;
+      }
+    }
+    current.contentEnd = end;
+  }
+  return headings;
 }
-
-// src/compaction/index.ts
-var log3 = createLogger("compaction");
-var CONVERSATION_SUMMARY_PROMPT = readAsset("compaction", "conversation.md");
-var SUBAGENT_SUMMARY_PROMPT = readAsset("compaction", "subagent.md");
-var SUMMARIZABLE_SUBAGENTS = ["visualDesignExpert", "productVision"];
-async function compactConversation(messages, apiConfig, system, tools2, model) {
-  const endIndex = findSafeInsertionPoint(messages);
-  const summaries = [];
-  const tasks = [];
-  const conversationMessages = getConversationMessagesForSummary(
-    messages,
-    endIndex
-  );
-  if (conversationMessages.length > 0) {
-    tasks.push(
-      generateSummary(
-        apiConfig,
-        "conversation",
-        CONVERSATION_SUMMARY_PROMPT,
-        conversationMessages,
-        system,
-        tools2,
-        model
-      ).then((text) => {
-        if (text) {
-          summaries.push({ name: "conversation", text });
-        }
-      })
-    );
+function resolveHeadingPath(content, headingPath) {
+  const lines = content.split("\n");
+  const headings = parseHeadings(content);
+  if (headingPath === "") {
+    const firstHeadingLine = headings.length > 0 ? headings[0].startLine : lines.length;
+    return {
+      startLine: 0,
+      contentStart: 0,
+      contentEnd: firstHeadingLine
+    };
   }
-  for (const name of SUMMARIZABLE_SUBAGENTS) {
-    const subagentMessages = getSubAgentMessagesForSummary(
-      messages,
-      name,
-      endIndex
+  const segments = headingPath.split(">").map((s) => s.trim());
+  let searchStart = 0;
+  let searchEnd = lines.length;
+  let resolved = null;
+  for (let si = 0; si < segments.length; si++) {
+    const segment = segments[si].toLowerCase();
+    const candidates = headings.filter(
+      (h) => h.startLine >= searchStart && h.startLine < searchEnd && h.text.toLowerCase() === segment
     );
-    if (subagentMessages.length > 0) {
-      tasks.push(
-        generateSummary(
-          apiConfig,
-          name,
-          SUBAGENT_SUMMARY_PROMPT,
-          subagentMessages,
-          system,
-          tools2,
-          model
-        ).then((text) => {
-          if (text) {
-            summaries.push({ name, text });
-          }
-        })
+    if (candidates.length === 0) {
+      const available = headings.filter((h) => h.startLine >= searchStart && h.startLine < searchEnd).map((h) => `${"#".repeat(h.level)} ${h.text}`).join("\n");
+      const searchedPath = segments.slice(0, si + 1).join(" > ");
+      throw new Error(
+        `Heading not found: "${searchedPath}"
+
+Available headings:
+${available || "(none)"}`
       );
     }
+    resolved = candidates[0];
+    searchStart = resolved.contentStart;
+    searchEnd = resolved.contentEnd;
   }
-  await Promise.all(tasks);
-  const checkpointMessages = summaries.map((s) => ({
-    role: "user",
-    hidden: true,
-    content: [
-      {
-        type: "summary",
-        name: s.name,
-        text: s.text,
-        startedAt: Date.now()
-      }
-    ]
-  }));
-  log3.info("Compaction complete", { summaries: summaries.length });
-  return checkpointMessages;
+  return {
+    startLine: resolved.startLine,
+    contentStart: resolved.contentStart,
+    contentEnd: resolved.contentEnd
+  };
 }
-function findSafeInsertionPoint(messages) {
-  let idx = messages.length;
-  while (idx > 0) {
-    const msg = messages[idx - 1];
-    if (msg.role === "user" && msg.toolCallId) {
-      idx--;
-    } else {
-      break;
-    }
-  }
-  if (idx < messages.length && idx > 0) {
-    const msg = messages[idx - 1];
-    if (msg.role === "assistant" && Array.isArray(msg.content)) {
-      const hasToolUse = msg.content.some(
-        (b) => b.type === "tool"
-      );
-      if (hasToolUse) {
-        idx--;
-      }
-    }
+function validateSpecPath(filePath) {
+  if (!filePath.startsWith("src/")) {
+    throw new Error(`Spec tool paths must start with src/. Got: "${filePath}"`);
   }
-  return idx;
+  return filePath;
 }
-function getConversationMessagesForSummary(messages, endIndex) {
-  let startIdx = 0;
-  for (let i = endIndex - 1; i >= 0; i--) {
-    const msg = messages[i];
-    if (!Array.isArray(msg.content)) {
-      continue;
-    }
-    for (const block of msg.content) {
-      if (block.type === "summary" && block.name === "conversation") {
-        startIdx = i + 1;
-        break;
-      }
-    }
-    if (startIdx > 0) {
-      break;
-    }
+function getHeadingTree(content) {
+  const headings = parseHeadings(content);
+  if (headings.length === 0) {
+    return "(no headings)";
   }
-  return messages.slice(startIdx, endIndex);
+  return headings.map((h) => `${"#".repeat(h.level)} ${h.text}`).join("\n");
 }
-function getSubAgentMessagesForSummary(messages, subAgentName, endIndex) {
-  let checkpointIdx = -1;
-  for (let i = endIndex - 1; i >= 0; i--) {
-    const msg = messages[i];
-    if (!Array.isArray(msg.content)) {
-      continue;
+
+// src/tools/spec/readSpec.ts
+var DEFAULT_MAX_LINES = 500;
+var readSpecTool = {
+  clearable: true,
+  definition: {
+    name: "readSpec",
+    description: "Read a spec file from src/ with line numbers. Always read a spec file before editing it. Paths are relative to the project root and must start with src/ (e.g., src/app.md, src/interfaces/web.md).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: "File path relative to project root, must start with src/ (e.g., src/app.md)."
+        },
+        offset: {
+          type: "number",
+          description: "Line number to start reading from (1-indexed). Use a negative number to read from the end. Defaults to 1."
+        },
+        maxLines: {
+          type: "number",
+          description: "Maximum number of lines to return. Defaults to 500. Set to 0 for no limit."
+        }
+      },
+      required: ["path"]
     }
-    for (const block of msg.content) {
-      if (block.type === "summary" && block.name === subAgentName) {
-        checkpointIdx = i;
-        break;
-      }
+  },
+  async execute(input) {
+    try {
+      validateSpecPath(input.path);
+    } catch (err) {
+      return `Error: ${err.message}`;
     }
-    if (checkpointIdx !== -1) {
-      break;
+    try {
+      const content = await fs5.readFile(input.path, "utf-8");
+      const allLines = content.split("\n");
+      const totalLines = allLines.length;
+      const maxLines = input.maxLines === 0 ? Infinity : input.maxLines || DEFAULT_MAX_LINES;
+      let startIdx;
+      if (input.offset && input.offset < 0) {
+        startIdx = Math.max(0, totalLines + input.offset);
+      } else {
+        startIdx = Math.max(0, (input.offset || 1) - 1);
+      }
+      const sliced = allLines.slice(startIdx, startIdx + maxLines);
+      const numbered = sliced.map((line, i) => `${String(startIdx + i + 1).padStart(4)} ${line}`).join("\n");
+      let result = numbered;
+      const endLine = startIdx + sliced.length;
+      const displayStart = startIdx + 1;
+      if (endLine < totalLines) {
+        result += `
+
+(showing lines ${displayStart}\u2013${endLine} of ${totalLines} \u2014 use offset and maxLines to read more)`;
+      }
+      return result;
+    } catch (err) {
+      return `Error reading file: ${err.message}`;
     }
   }
-  const startIdx = checkpointIdx !== -1 ? checkpointIdx + 1 : 0;
-  const collected = [];
-  for (let i = startIdx; i < endIndex; i++) {
-    const msg = messages[i];
-    if (msg.role !== "assistant" || !Array.isArray(msg.content)) {
-      continue;
-    }
-    for (const block of msg.content) {
-      if (block.type === "tool" && block.name === subAgentName && block.subAgentMessages?.length) {
-        collected.push(...block.subAgentMessages);
-      }
-    }
-  }
-  return collected;
-}
-function serializeForSummary(messages) {
-  return messages.map((msg) => {
-    if (typeof msg.content === "string") {
-      return `[${msg.role}]: ${msg.content}`;
-    }
-    if (!Array.isArray(msg.content)) {
-      return `[${msg.role}]: (empty)`;
-    }
-    const blocks = msg.content;
-    const parts = [];
-    for (const block of blocks) {
-      if (block.type === "text") {
-        parts.push(block.text);
-      } else if (block.type === "tool") {
-        parts.push(
-          `[tool: ${block.name}(${JSON.stringify(block.input).slice(0, 200)})] \u2192 ${(block.result ?? "").slice(0, 500)}`
-        );
-      }
-    }
-    return `[${msg.role}]: ${parts.join("\n")}`;
-  }).join("\n\n");
-}
-var CHUNK_CHAR_LIMIT = 24e5;
-async function generateSummary(apiConfig, name, compactionPrompt, messagesToSummarize, mainSystem, mainTools, model) {
-  const serialized = serializeForSummary(messagesToSummarize);
-  if (!serialized.trim()) {
-    return null;
-  }
-  if (serialized.length > CHUNK_CHAR_LIMIT && messagesToSummarize.length > 1) {
-    const mid = Math.floor(messagesToSummarize.length / 2);
-    log3.info("Chunking summary", {
-      name,
-      messageCount: messagesToSummarize.length,
-      serializedLength: serialized.length
-    });
-    const [first, second] = await Promise.all([
-      generateSummary(
-        apiConfig,
-        `${name} [pt1]`,
-        compactionPrompt,
-        messagesToSummarize.slice(0, mid),
-        mainSystem,
-        mainTools,
-        model
-      ),
-      generateSummary(
-        apiConfig,
-        `${name} [pt2]`,
-        compactionPrompt,
-        messagesToSummarize.slice(mid),
-        mainSystem,
-        mainTools,
-        model
-      )
-    ]);
-    const parts = [first, second].filter((p) => !!p);
-    return parts.length > 0 ? parts.join("\n\n---\n\n") : null;
-  }
-  log3.info("Generating summary", {
-    name,
-    messageCount: messagesToSummarize.length,
-    cacheReuse: !!mainSystem
-  });
-  let summaryText = "";
-  const useMainCache = !!mainSystem;
-  const system = useMainCache ? mainSystem : compactionPrompt;
-  const tools2 = [];
-  const userContent = useMainCache ? `${compactionPrompt}
-
----
-
-Conversation to summarize:
-
-${serialized}` : serialized;
-  const iterStart = Date.now();
-  for await (const event of streamChat({
-    ...apiConfig,
-    model,
-    subAgentId: "conversationSummarizer",
-    system,
-    messages: [{ role: "user", content: userContent }],
-    tools: tools2
-  })) {
-    if (event.type === "text") {
-      summaryText += event.text;
-    } else if (event.type === "done") {
-      recordUsage({
-        ts: Date.now(),
-        agentName: "conversationSummarizer",
-        modelId: event.modelId,
-        inputTokens: event.usage.inputTokens,
-        outputTokens: event.usage.outputTokens,
-        cacheCreationTokens: event.usage.cacheCreationTokens,
-        cacheReadTokens: event.usage.cacheReadTokens,
-        cost: nanoToDollars(event.cost),
-        billingEvents: event.billingEvents,
-        durationMs: Date.now() - iterStart,
-        toolNames: []
-      });
-    } else if (event.type === "error") {
-      log3.error("Summary generation failed", { name, error: event.error });
-      return null;
-    }
-  }
-  if (!summaryText.trim()) {
-    log3.warn("Empty summary generated", { name });
-    return null;
-  }
-  log3.info("Summary generated", { name, summaryLength: summaryText.length });
-  return summaryText.trim();
-}
+};
 
-// src/tools/spec/readSpec.ts
+// src/tools/spec/writeSpec.ts
 import fs6 from "fs/promises";
+import path4 from "path";
 
-// src/tools/spec/_helpers.ts
-var HEADING_RE = /^(#{1,6})\s+(.+)$/;
-function parseHeadings(content) {
-  const lines = content.split("\n");
-  const headings = [];
-  for (let i = 0; i < lines.length; i++) {
-    const match = lines[i].match(HEADING_RE);
-    if (match) {
-      headings.push({
-        level: match[1].length,
-        text: match[2].trim(),
-        startLine: i,
-        contentStart: i + 1,
-        contentEnd: lines.length
-        // placeholder — resolved below
-      });
-    }
+// src/tools/_helpers/diff.ts
+var CONTEXT_LINES = 3;
+function unifiedDiff(filePath, oldText, newText) {
+  const oldLines = oldText ? oldText.split("\n") : [];
+  const newLines = newText ? newText.split("\n") : [];
+  let firstDiff = 0;
+  while (firstDiff < oldLines.length && firstDiff < newLines.length && oldLines[firstDiff] === newLines[firstDiff]) {
+    firstDiff++;
   }
-  for (let i = 0; i < headings.length; i++) {
-    const current = headings[i];
-    let end = lines.length;
-    for (let j = i + 1; j < headings.length; j++) {
-      if (headings[j].level <= current.level) {
-        end = headings[j].startLine;
-        break;
-      }
-    }
-    current.contentEnd = end;
+  let oldEnd = oldLines.length - 1;
+  let newEnd = newLines.length - 1;
+  while (oldEnd > firstDiff && newEnd > firstDiff && oldLines[oldEnd] === newLines[newEnd]) {
+    oldEnd--;
+    newEnd--;
   }
-  return headings;
-}
-function resolveHeadingPath(content, headingPath) {
-  const lines = content.split("\n");
-  const headings = parseHeadings(content);
-  if (headingPath === "") {
-    const firstHeadingLine = headings.length > 0 ? headings[0].startLine : lines.length;
-    return {
-      startLine: 0,
-      contentStart: 0,
-      contentEnd: firstHeadingLine
-    };
+  const ctxStart = Math.max(0, firstDiff - CONTEXT_LINES);
+  const ctxOldEnd = Math.min(oldLines.length - 1, oldEnd + CONTEXT_LINES);
+  const ctxNewEnd = Math.min(newLines.length - 1, newEnd + CONTEXT_LINES);
+  const lines = [];
+  lines.push(`--- ${filePath}`);
+  lines.push(`+++ ${filePath}`);
+  lines.push(
+    `@@ -${ctxStart + 1},${ctxOldEnd - ctxStart + 1} +${ctxStart + 1},${ctxNewEnd - ctxStart + 1} @@`
+  );
+  for (let i = ctxStart; i < firstDiff; i++) {
+    lines.push(` ${oldLines[i]}`);
   }
-  const segments = headingPath.split(">").map((s) => s.trim());
-  let searchStart = 0;
-  let searchEnd = lines.length;
-  let resolved = null;
-  for (let si = 0; si < segments.length; si++) {
-    const segment = segments[si].toLowerCase();
-    const candidates = headings.filter(
-      (h) => h.startLine >= searchStart && h.startLine < searchEnd && h.text.toLowerCase() === segment
-    );
-    if (candidates.length === 0) {
-      const available = headings.filter((h) => h.startLine >= searchStart && h.startLine < searchEnd).map((h) => `${"#".repeat(h.level)} ${h.text}`).join("\n");
-      const searchedPath = segments.slice(0, si + 1).join(" > ");
-      throw new Error(
-        `Heading not found: "${searchedPath}"
-
-Available headings:
-${available || "(none)"}`
-      );
-    }
-    resolved = candidates[0];
-    searchStart = resolved.contentStart;
-    searchEnd = resolved.contentEnd;
+  for (let i = firstDiff; i <= oldEnd; i++) {
+    lines.push(`-${oldLines[i]}`);
   }
-  return {
-    startLine: resolved.startLine,
-    contentStart: resolved.contentStart,
-    contentEnd: resolved.contentEnd
-  };
-}
-function validateSpecPath(filePath) {
-  if (!filePath.startsWith("src/")) {
-    throw new Error(`Spec tool paths must start with src/. Got: "${filePath}"`);
+  for (let i = firstDiff; i <= newEnd; i++) {
+    lines.push(`+${newLines[i]}`);
   }
-  return filePath;
-}
-function getHeadingTree(content) {
-  const headings = parseHeadings(content);
-  if (headings.length === 0) {
-    return "(no headings)";
+  for (let i = oldEnd + 1; i <= ctxOldEnd; i++) {
+    lines.push(` ${oldLines[i]}`);
   }
-  return headings.map((h) => `${"#".repeat(h.level)} ${h.text}`).join("\n");
+  return lines.join("\n");
 }
 
-// src/tools/spec/readSpec.ts
-var DEFAULT_MAX_LINES = 500;
-var readSpecTool = {
+// src/tools/_helpers/fileLock.ts
+var locks = /* @__PURE__ */ new Map();
+function acquireFileLock(filePath) {
+  let release;
+  const next = new Promise((res) => {
+    release = res;
+  });
+  const wait = locks.get(filePath) ?? Promise.resolve();
+  locks.set(filePath, next);
+  return wait.then(() => release);
+}
+
+// src/tools/spec/writeSpec.ts
+var writeSpecTool = {
   clearable: true,
   definition: {
-    name: "readSpec",
-    description: "Read a spec file from src/ with line numbers. Always read a spec file before editing it. Paths are relative to the project root and must start with src/ (e.g., src/app.md, src/interfaces/web.md).",
+    name: "writeSpec",
+    description: "Create a new spec file or completely overwrite an existing one in src/. Parent directories are created automatically. Use this for new spec files or full rewrites. For targeted changes to existing specs, use editSpec instead.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1023,131 +863,17 @@ var readSpecTool = {
           type: "string",
           description: "File path relative to project root, must start with src/ (e.g., src/app.md)."
         },
-        offset: {
-          type: "number",
-          description: "Line number to start reading from (1-indexed). Use a negative number to read from the end. Defaults to 1."
-        },
-        maxLines: {
-          type: "number",
-          description: "Maximum number of lines to return. Defaults to 500. Set to 0 for no limit."
+        content: {
+          type: "string",
+          description: "The full MSFM markdown content to write."
         }
       },
-      required: ["path"]
-    }
-  },
-  async execute(input) {
-    try {
-      validateSpecPath(input.path);
-    } catch (err) {
-      return `Error: ${err.message}`;
-    }
-    try {
-      const content = await fs6.readFile(input.path, "utf-8");
-      const allLines = content.split("\n");
-      const totalLines = allLines.length;
-      const maxLines = input.maxLines === 0 ? Infinity : input.maxLines || DEFAULT_MAX_LINES;
-      let startIdx;
-      if (input.offset && input.offset < 0) {
-        startIdx = Math.max(0, totalLines + input.offset);
-      } else {
-        startIdx = Math.max(0, (input.offset || 1) - 1);
-      }
-      const sliced = allLines.slice(startIdx, startIdx + maxLines);
-      const numbered = sliced.map((line, i) => `${String(startIdx + i + 1).padStart(4)} ${line}`).join("\n");
-      let result = numbered;
-      const endLine = startIdx + sliced.length;
-      const displayStart = startIdx + 1;
-      if (endLine < totalLines) {
-        result += `
-
-(showing lines ${displayStart}\u2013${endLine} of ${totalLines} \u2014 use offset and maxLines to read more)`;
-      }
-      return result;
-    } catch (err) {
-      return `Error reading file: ${err.message}`;
-    }
-  }
-};
-
-// src/tools/spec/writeSpec.ts
-import fs7 from "fs/promises";
-import path4 from "path";
-
-// src/tools/_helpers/diff.ts
-var CONTEXT_LINES = 3;
-function unifiedDiff(filePath, oldText, newText) {
-  const oldLines = oldText ? oldText.split("\n") : [];
-  const newLines = newText ? newText.split("\n") : [];
-  let firstDiff = 0;
-  while (firstDiff < oldLines.length && firstDiff < newLines.length && oldLines[firstDiff] === newLines[firstDiff]) {
-    firstDiff++;
-  }
-  let oldEnd = oldLines.length - 1;
-  let newEnd = newLines.length - 1;
-  while (oldEnd > firstDiff && newEnd > firstDiff && oldLines[oldEnd] === newLines[newEnd]) {
-    oldEnd--;
-    newEnd--;
-  }
-  const ctxStart = Math.max(0, firstDiff - CONTEXT_LINES);
-  const ctxOldEnd = Math.min(oldLines.length - 1, oldEnd + CONTEXT_LINES);
-  const ctxNewEnd = Math.min(newLines.length - 1, newEnd + CONTEXT_LINES);
-  const lines = [];
-  lines.push(`--- ${filePath}`);
-  lines.push(`+++ ${filePath}`);
-  lines.push(
-    `@@ -${ctxStart + 1},${ctxOldEnd - ctxStart + 1} +${ctxStart + 1},${ctxNewEnd - ctxStart + 1} @@`
-  );
-  for (let i = ctxStart; i < firstDiff; i++) {
-    lines.push(` ${oldLines[i]}`);
-  }
-  for (let i = firstDiff; i <= oldEnd; i++) {
-    lines.push(`-${oldLines[i]}`);
-  }
-  for (let i = firstDiff; i <= newEnd; i++) {
-    lines.push(`+${newLines[i]}`);
-  }
-  for (let i = oldEnd + 1; i <= ctxOldEnd; i++) {
-    lines.push(` ${oldLines[i]}`);
-  }
-  return lines.join("\n");
-}
-
-// src/tools/_helpers/fileLock.ts
-var locks = /* @__PURE__ */ new Map();
-function acquireFileLock(filePath) {
-  let release;
-  const next = new Promise((res) => {
-    release = res;
-  });
-  const wait = locks.get(filePath) ?? Promise.resolve();
-  locks.set(filePath, next);
-  return wait.then(() => release);
-}
-
-// src/tools/spec/writeSpec.ts
-var writeSpecTool = {
-  clearable: true,
-  definition: {
-    name: "writeSpec",
-    description: "Create a new spec file or completely overwrite an existing one in src/. Parent directories are created automatically. Use this for new spec files or full rewrites. For targeted changes to existing specs, use editSpec instead.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        path: {
-          type: "string",
-          description: "File path relative to project root, must start with src/ (e.g., src/app.md)."
-        },
-        content: {
-          type: "string",
-          description: "The full MSFM markdown content to write."
-        }
-      },
-      required: ["path", "content"]
+      required: ["path", "content"]
     }
   },
   streaming: {
     transform: async (partial) => {
-      const oldContent = await fs7.readFile(partial.path, "utf-8").catch(() => "");
+      const oldContent = await fs6.readFile(partial.path, "utf-8").catch(() => "");
       const lineCount = partial.content.split("\n").length;
       return `Writing ${partial.path} (${lineCount} lines)
 ${unifiedDiff(partial.path, oldContent, partial.content)}`;
@@ -1161,13 +887,13 @@ ${unifiedDiff(partial.path, oldContent, partial.content)}`;
     }
     const release = await acquireFileLock(input.path);
     try {
-      await fs7.mkdir(path4.dirname(input.path), { recursive: true });
+      await fs6.mkdir(path4.dirname(input.path), { recursive: true });
       let oldContent = null;
       try {
-        oldContent = await fs7.readFile(input.path, "utf-8");
+        oldContent = await fs6.readFile(input.path, "utf-8");
       } catch {
       }
-      await fs7.writeFile(input.path, input.content, "utf-8");
+      await fs6.writeFile(input.path, input.content, "utf-8");
       const lineCount = input.content.split("\n").length;
       const label = oldContent !== null ? "Wrote" : "Created";
       return `${label} ${input.path} (${lineCount} lines)
@@ -1181,7 +907,7 @@ ${unifiedDiff(input.path, oldContent ?? "", input.content)}`;
 };
 
 // src/tools/spec/editSpec.ts
-import fs8 from "fs/promises";
+import fs7 from "fs/promises";
 var editSpecTool = {
   clearable: true,
   definition: {
@@ -1231,7 +957,7 @@ var editSpecTool = {
     try {
       let originalContent;
       try {
-        originalContent = await fs8.readFile(input.path, "utf-8");
+        originalContent = await fs7.readFile(input.path, "utf-8");
       } catch (err) {
         return `Error reading file: ${err.message}`;
       }
@@ -1287,7 +1013,7 @@ ${tree}`;
         content = lines.join("\n");
       }
       try {
-        await fs8.writeFile(input.path, content, "utf-8");
+        await fs7.writeFile(input.path, content, "utf-8");
       } catch (err) {
         return `Error writing file: ${err.message}`;
       }
@@ -1299,7 +1025,7 @@ ${tree}`;
 };
 
 // src/tools/spec/listSpecFiles.ts
-import fs9 from "fs/promises";
+import fs8 from "fs/promises";
 import path5 from "path";
 var listSpecFilesTool = {
   clearable: false,
@@ -1329,7 +1055,7 @@ var listSpecFilesTool = {
 };
 async function listRecursive(dir) {
   const results = [];
-  const entries = await fs9.readdir(dir, { withFileTypes: true });
+  const entries = await fs8.readdir(dir, { withFileTypes: true });
   entries.sort((a, b) => {
     if (a.isDirectory() && !b.isDirectory()) {
       return -1;
@@ -1375,7 +1101,7 @@ var presentPublishPlanTool = {
 };
 
 // src/tools/spec/writePlan.ts
-import fs10 from "fs/promises";
+import fs9 from "fs/promises";
 var PLAN_FILE = ".remy-plan.md";
 var writePlanTool = {
   clearable: false,
@@ -1400,13 +1126,13 @@ status: pending
 ---
 
 ${content}`;
-    await fs10.writeFile(PLAN_FILE, file, "utf-8");
+    await fs9.writeFile(PLAN_FILE, file, "utf-8");
     return "Plan written to .remy-plan.md. Waiting for user approval.";
   }
 };
 
 // src/tools/spec/updatePlanStatus.ts
-import fs11 from "fs/promises";
+import fs10 from "fs/promises";
 var PLAN_FILE2 = ".remy-plan.md";
 var updatePlanStatusTool = {
   clearable: false,
@@ -1429,15 +1155,15 @@ var updatePlanStatusTool = {
     const status = input.status;
     let content;
     try {
-      content = await fs11.readFile(PLAN_FILE2, "utf-8");
+      content = await fs10.readFile(PLAN_FILE2, "utf-8");
     } catch {
       return "No plan file found.";
     }
     if (status === "rejected") {
-      await fs11.unlink(PLAN_FILE2);
+      await fs10.unlink(PLAN_FILE2);
       return "Plan rejected and removed.";
     }
-    await fs11.writeFile(
+    await fs10.writeFile(
       PLAN_FILE2,
       content.replace(/^status:\s*\w+/m, `status: ${status}`),
       "utf-8"
@@ -1743,6 +1469,24 @@ var askMindStudioSdkTool = {
   }
 };
 
+// src/usageLedger.ts
+import fs11 from "fs";
+var LEDGER_FILE = ".logs/usage.ndjson";
+var fd = null;
+function nanoToDollars(nano) {
+  return typeof nano === "number" ? nano / 1e9 : void 0;
+}
+function recordUsage(entry) {
+  try {
+    if (fd === null) {
+      fs11.mkdirSync(".logs", { recursive: true });
+      fd = fs11.openSync(LEDGER_FILE, "a");
+    }
+    fs11.writeSync(fd, JSON.stringify(entry) + "\n");
+  } catch {
+  }
+}
+
 // src/subagents/common/runMindstudioCli.ts
 function stripFlags(args) {
   const out = [];
@@ -2584,11 +2328,11 @@ var editsFinishedTool = {
 };
 
 // src/tools/_helpers/sidecar.ts
-var log4 = createLogger("sidecar");
+var log3 = createLogger("sidecar");
 var baseUrl = null;
 function setSidecarBaseUrl(url) {
   baseUrl = url;
-  log4.info("Configured", { url });
+  log3.info("Configured", { url });
 }
 async function sidecarRequest(endpoint, body = {}, options) {
   if (!baseUrl) {
@@ -2603,7 +2347,7 @@ async function sidecarRequest(endpoint, body = {}, options) {
       signal: options?.timeout ? AbortSignal.timeout(options.timeout) : void 0
     });
     if (!res.ok) {
-      log4.error("Sidecar error", { endpoint, status: res.status });
+      log3.error("Sidecar error", { endpoint, status: res.status });
       throw new Error(`Sidecar error: ${res.status}`);
     }
     const data = await res.json();
@@ -2616,7 +2360,7 @@ async function sidecarRequest(endpoint, body = {}, options) {
     if (err.message.startsWith("Sidecar error")) {
       throw err;
     }
-    log4.error("Sidecar connection error", { endpoint, error: err.message });
+    log3.error("Sidecar connection error", { endpoint, error: err.message });
     throw new Error(`Sidecar connection error: ${err.message}`);
   }
 }
@@ -2907,7 +2651,7 @@ function acquireBrowserLock() {
 }
 
 // src/toolRegistry.ts
-var log5 = createLogger("tool-registry");
+var log4 = 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();
@@ -2934,7 +2678,7 @@ var ToolRegistry = class {
     if (!entry) {
       return false;
     }
-    log5.info("Tool stopped", { toolCallId: id, name: entry.name, mode });
+    log4.info("Tool stopped", { toolCallId: id, name: entry.name, mode });
     entry.abortController.abort(mode);
     if (mode === "graceful") {
       const partial = entry.getPartialResult?.() ?? "";
@@ -2967,7 +2711,7 @@ ${partial}` : "[INTERRUPTED] Tool execution was stopped.";
     if (!entry) {
       return false;
     }
-    log5.info("Tool restarted", { toolCallId: id, name: entry.name });
+    log4.info("Tool restarted", { toolCallId: id, name: entry.name });
     entry.abortController.abort("restart");
     const newInput = patchedInput ? { ...entry.input, ...patchedInput } : entry.input;
     this.onEvent?.({
@@ -3227,7 +2971,7 @@ ${content}` : attachmentHeader;
 }
 
 // src/subagents/runner.ts
-var log6 = createLogger("sub-agent");
+var log5 = createLogger("sub-agent");
 async function runSubAgent(config) {
   const {
     system,
@@ -3254,7 +2998,7 @@ async function runSubAgent(config) {
   const signal = background ? bgAbort.signal : parentSignal;
   const agentName = subAgentId || "sub-agent";
   const runStart = Date.now();
-  log6.info("Sub-agent started", { requestId, parentToolId, agentName });
+  log5.info("Sub-agent started", { requestId, parentToolId, agentName });
   const emit = (e) => {
     onEvent({ ...e, parentToolId });
   };
@@ -3471,7 +3215,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
           ...hasArtifacts ? { artifacts } : {}
         };
       }
-      log6.info("Tools executing", {
+      log5.info("Tools executing", {
         requestId,
         parentToolId,
         count: toolCalls.length,
@@ -3548,7 +3292,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
           run2(tc.input);
           const r = await resultPromise;
           toolRegistry?.unregister(tc.id);
-          log6.info("Tool completed", {
+          log5.info("Tool completed", {
             requestId,
             parentToolId,
             toolCallId: tc.id,
@@ -3599,7 +3343,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
   const wrapRun = async () => {
     try {
       const result = await run();
-      log6.info("Sub-agent complete", {
+      log5.info("Sub-agent complete", {
         requestId,
         parentToolId,
         agentName,
@@ -3608,7 +3352,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
       });
       return result;
     } catch (err) {
-      log6.warn("Sub-agent error", {
+      log5.warn("Sub-agent error", {
         requestId,
         parentToolId,
         agentName,
@@ -3620,7 +3364,7 @@ ${partial}` : "[INTERRUPTED] Agent was interrupted before producing output.",
   if (!background) {
     return wrapRun();
   }
-  log6.info("Sub-agent backgrounded", { requestId, parentToolId, agentName });
+  log5.info("Sub-agent backgrounded", { requestId, parentToolId, agentName });
   toolRegistry?.register({
     id: parentToolId,
     name: agentName,
@@ -3888,6 +3632,7 @@ var ALLOWED_MODELS_BY_TYPE = {
     "claude-4-7-opus",
     "claude-4-6-opus",
     "claude-4-6-sonnet",
+    "claude-fable-5",
     "gpt-5.5",
     "gemini-3-pro",
     "gemini-3.1-pro",
@@ -3903,7 +3648,7 @@ function resolveModel(surfaceId, models, fallback) {
 }
 
 // src/subagents/browserAutomation/index.ts
-var log7 = createLogger("browser-automation");
+var log6 = createLogger("browser-automation");
 async function runBrowserAutomation(task, context, opts) {
   const release = await acquireBrowserLock();
   try {
@@ -4002,7 +3747,7 @@ async function runBrowserAutomation(task, context, opts) {
                   }
                 }
               } catch {
-                log7.debug("Failed to parse batch analysis result", {
+                log6.debug("Failed to parse batch analysis result", {
                   batchResult
                 });
               }
@@ -5676,6 +5421,13 @@ var ALL_TOOLS = [
 var CLEARABLE_TOOLS = new Set(
   ALL_TOOLS.filter((t) => t.clearable).map((t) => t.definition.name)
 );
+var SUBAGENT_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "visualDesignExpert",
+  "productVision",
+  "codeSanityCheck",
+  "runAutomatedBrowserTest",
+  "askMindStudioSdk"
+]);
 function getToolDefinitions(_onboardingState) {
   return ALL_TOOLS.map((t) => t.definition);
 }
@@ -5690,6 +5442,295 @@ function executeTool(name, input, context) {
   return tool.execute(input, context);
 }
 
+// src/compaction/index.ts
+var log7 = createLogger("compaction");
+var CONVERSATION_SUMMARY_PROMPT = readAsset("compaction", "conversation.md");
+var SUBAGENT_SUMMARY_PROMPT = readAsset("compaction", "subagent.md");
+var SUMMARIZABLE_SUBAGENTS = ["visualDesignExpert", "productVision"];
+async function compactConversation(messages, apiConfig, system, tools2, model) {
+  const endIndex = findSafeInsertionPoint(messages);
+  const summaries = [];
+  const tasks = [];
+  const conversationMessages = getConversationMessagesForSummary(
+    messages,
+    endIndex
+  );
+  if (conversationMessages.length > 0) {
+    tasks.push(
+      generateSummary(
+        apiConfig,
+        "conversation",
+        CONVERSATION_SUMMARY_PROMPT,
+        conversationMessages,
+        system,
+        tools2,
+        model
+      ).then((text) => {
+        if (text) {
+          summaries.push({ name: "conversation", text });
+        }
+      })
+    );
+  }
+  for (const name of SUMMARIZABLE_SUBAGENTS) {
+    const subagentMessages = getSubAgentMessagesForSummary(
+      messages,
+      name,
+      endIndex
+    );
+    if (subagentMessages.length > 0) {
+      tasks.push(
+        generateSummary(
+          apiConfig,
+          name,
+          SUBAGENT_SUMMARY_PROMPT,
+          subagentMessages,
+          system,
+          tools2,
+          model
+        ).then((text) => {
+          if (text) {
+            summaries.push({ name, text });
+          }
+        })
+      );
+    }
+  }
+  await Promise.all(tasks);
+  const checkpointMessages = summaries.map((s) => ({
+    role: "user",
+    hidden: true,
+    content: [
+      {
+        type: "summary",
+        name: s.name,
+        text: s.text,
+        startedAt: Date.now()
+      }
+    ]
+  }));
+  log7.info("Compaction complete", { summaries: summaries.length });
+  return checkpointMessages;
+}
+function findSafeInsertionPoint(messages) {
+  let idx = messages.length;
+  while (idx > 0) {
+    const msg = messages[idx - 1];
+    if (msg.role === "user" && msg.toolCallId) {
+      idx--;
+    } else {
+      break;
+    }
+  }
+  if (idx < messages.length && idx > 0) {
+    const msg = messages[idx - 1];
+    if (msg.role === "assistant" && Array.isArray(msg.content)) {
+      const hasToolUse = msg.content.some(
+        (b) => b.type === "tool"
+      );
+      if (hasToolUse) {
+        idx--;
+      }
+    }
+  }
+  return idx;
+}
+function getConversationMessagesForSummary(messages, endIndex) {
+  let startIdx = 0;
+  for (let i = endIndex - 1; i >= 0; i--) {
+    const msg = messages[i];
+    if (!Array.isArray(msg.content)) {
+      continue;
+    }
+    for (const block of msg.content) {
+      if (block.type === "summary" && block.name === "conversation") {
+        startIdx = i + 1;
+        break;
+      }
+    }
+    if (startIdx > 0) {
+      break;
+    }
+  }
+  return messages.slice(startIdx, endIndex);
+}
+function getSubAgentMessagesForSummary(messages, subAgentName, endIndex) {
+  let checkpointIdx = -1;
+  for (let i = endIndex - 1; i >= 0; i--) {
+    const msg = messages[i];
+    if (!Array.isArray(msg.content)) {
+      continue;
+    }
+    for (const block of msg.content) {
+      if (block.type === "summary" && block.name === subAgentName) {
+        checkpointIdx = i;
+        break;
+      }
+    }
+    if (checkpointIdx !== -1) {
+      break;
+    }
+  }
+  const startIdx = checkpointIdx !== -1 ? checkpointIdx + 1 : 0;
+  const collected = [];
+  for (let i = startIdx; i < endIndex; i++) {
+    const msg = messages[i];
+    if (msg.role !== "assistant" || !Array.isArray(msg.content)) {
+      continue;
+    }
+    for (const block of msg.content) {
+      if (block.type === "tool" && block.name === subAgentName && block.subAgentMessages?.length) {
+        collected.push(...block.subAgentMessages);
+      }
+    }
+  }
+  return collected;
+}
+function serializeForSummary(messages) {
+  const toolNameById = /* @__PURE__ */ new Map();
+  for (const msg of messages) {
+    if (!Array.isArray(msg.content)) {
+      continue;
+    }
+    for (const block of msg.content) {
+      if (block.type === "tool") {
+        toolNameById.set(block.id, block.name);
+      }
+    }
+  }
+  const lines = [];
+  for (const msg of messages) {
+    if (msg.role === "user" && msg.toolCallId) {
+      const toolName = toolNameById.get(msg.toolCallId);
+      if (toolName && SUBAGENT_TOOL_NAMES.has(toolName)) {
+        const content = typeof msg.content === "string" ? msg.content : Array.isArray(msg.content) ? msg.content.filter(
+          (b) => b.type === "text"
+        ).map((b) => b.text).join("\n") : "";
+        if (content.trim()) {
+          lines.push(`[${toolName} result]: ${content}`);
+        }
+      }
+      continue;
+    }
+    if (typeof msg.content === "string") {
+      if (msg.content.trim()) {
+        lines.push(`[${msg.role}]: ${msg.content}`);
+      }
+      continue;
+    }
+    if (!Array.isArray(msg.content)) {
+      continue;
+    }
+    const blocks = msg.content;
+    const parts = [];
+    let toolCount = 0;
+    for (const block of blocks) {
+      if (block.type === "text") {
+        parts.push(block.text);
+      } else if (block.type === "tool") {
+        toolCount++;
+      }
+    }
+    if (toolCount > 0) {
+      parts.push(`[used ${toolCount} tool${toolCount === 1 ? "" : "s"}]`);
+    }
+    const body = parts.join("\n").trim();
+    if (body) {
+      lines.push(`[${msg.role}]: ${body}`);
+    }
+  }
+  return lines.join("\n\n");
+}
+var CHUNK_CHAR_LIMIT = 24e5;
+async function generateSummary(apiConfig, name, compactionPrompt, messagesToSummarize, mainSystem, mainTools, model) {
+  const serialized = serializeForSummary(messagesToSummarize);
+  if (!serialized.trim()) {
+    return null;
+  }
+  if (serialized.length > CHUNK_CHAR_LIMIT && messagesToSummarize.length > 1) {
+    const mid = Math.floor(messagesToSummarize.length / 2);
+    log7.info("Chunking summary", {
+      name,
+      messageCount: messagesToSummarize.length,
+      serializedLength: serialized.length
+    });
+    const [first, second] = await Promise.all([
+      generateSummary(
+        apiConfig,
+        `${name} [pt1]`,
+        compactionPrompt,
+        messagesToSummarize.slice(0, mid),
+        mainSystem,
+        mainTools,
+        model
+      ),
+      generateSummary(
+        apiConfig,
+        `${name} [pt2]`,
+        compactionPrompt,
+        messagesToSummarize.slice(mid),
+        mainSystem,
+        mainTools,
+        model
+      )
+    ]);
+    const parts = [first, second].filter((p) => !!p);
+    return parts.length > 0 ? parts.join("\n\n---\n\n") : null;
+  }
+  log7.info("Generating summary", {
+    name,
+    messageCount: messagesToSummarize.length,
+    cacheReuse: !!mainSystem
+  });
+  let summaryText = "";
+  const useMainCache = !!mainSystem;
+  const system = useMainCache ? mainSystem : compactionPrompt;
+  const tools2 = [];
+  const userContent = useMainCache ? `${compactionPrompt}
+
+---
+
+Conversation to summarize:
+
+${serialized}` : serialized;
+  const iterStart = Date.now();
+  for await (const event of streamChat({
+    ...apiConfig,
+    model,
+    subAgentId: "conversationSummarizer",
+    system,
+    messages: [{ role: "user", content: userContent }],
+    tools: tools2
+  })) {
+    if (event.type === "text") {
+      summaryText += event.text;
+    } else if (event.type === "done") {
+      recordUsage({
+        ts: Date.now(),
+        agentName: "conversationSummarizer",
+        modelId: event.modelId,
+        inputTokens: event.usage.inputTokens,
+        outputTokens: event.usage.outputTokens,
+        cacheCreationTokens: event.usage.cacheCreationTokens,
+        cacheReadTokens: event.usage.cacheReadTokens,
+        cost: nanoToDollars(event.cost),
+        billingEvents: event.billingEvents,
+        durationMs: Date.now() - iterStart,
+        toolNames: []
+      });
+    } else if (event.type === "error") {
+      log7.error("Summary generation failed", { name, error: event.error });
+      return null;
+    }
+  }
+  if (!summaryText.trim()) {
+    log7.warn("Empty summary generated", { name });
+    return null;
+  }
+  log7.info("Summary generated", { name, summaryLength: summaryText.length });
+  return summaryText.trim();
+}
+
 // src/compaction/trigger.ts
 var log8 = createLogger("compaction:trigger");
 var pendingSummaries = [];