kimiflare 0.79.0 → 0.80.0

package/dist/index.js

@@ -45,6 +45,7 @@ __export(config_exports, {
   EFFORTS: () => EFFORTS,
   configPath: () => configPath,
   loadConfig: () => loadConfig,
+  resolveWorkerBudgetUsd: () => resolveWorkerBudgetUsd,
   saveConfig: () => saveConfig
 });
 import { readFile, mkdir, writeFile, chmod } from "fs/promises";
@@ -157,6 +158,8 @@ async function loadConfig() {
   const envProviderKeys = readProviderKeysEnv();
   const envUnifiedBilling = readBooleanEnv("KIMIFLARE_UNIFIED_BILLING");
   const envMultiAgentEnabled = readBooleanEnv("KIMIFLARE_MULTI_AGENT_ENABLED");
+  const envWorkerPreReadFiles = process.env.KIMIFLARE_WORKER_PRE_READ_FILES ? process.env.KIMIFLARE_WORKER_PRE_READ_FILES.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+  const envWorkerPreReadMaxChars = readNumberEnv("KIMIFLARE_WORKER_PRE_READ_MAX_CHARS");
   if (envAccount && envToken) {
     return {
       accountId: envAccount,
@@ -196,11 +199,16 @@ async function loadConfig() {
       unifiedBilling: envUnifiedBilling ?? persisted?.unifiedBilling,
       workerEndpoint: process.env.KIMIFLARE_WORKER_ENDPOINT,
       workerBudgetUsd: readNumberEnv("KIMIFLARE_WORKER_BUDGET_USD"),
+      workerBudgetMaxUsd: readNumberEnv("KIMIFLARE_WORKER_BUDGET_MAX_USD"),
       workerMaxParallel: readNumberEnv("KIMIFLARE_WORKER_MAX_PARALLEL"),
       workerTimeoutMs: readNumberEnv("KIMIFLARE_WORKER_TIMEOUT_MS"),
       multiAgentEnabled: envMultiAgentEnabled,
       workerApiKey: process.env.KIMIFLARE_WORKER_API_KEY,
-      autoExecute: readBooleanEnv("KIMIFLARE_AUTO_EXECUTE")
+      autoExecute: readBooleanEnv("KIMIFLARE_AUTO_EXECUTE"),
+      workerShallowClone: readBooleanEnv("KIMIFLARE_WORKER_SHALLOW_CLONE") ?? true,
+      workerRepoCache: readBooleanEnv("KIMIFLARE_WORKER_REPO_CACHE") ?? true,
+      workerPreReadFiles: envWorkerPreReadFiles ?? persisted?.workerPreReadFiles,
+      workerPreReadMaxChars: envWorkerPreReadMaxChars ?? persisted?.workerPreReadMaxChars
     };
   }
   if (persisted) {
@@ -243,16 +251,38 @@ async function loadConfig() {
         unifiedBilling: envUnifiedBilling ?? parsed.unifiedBilling,
         workerEndpoint: process.env.KIMIFLARE_WORKER_ENDPOINT ?? parsed.workerEndpoint,
         workerBudgetUsd: parsed.workerBudgetUsd,
+        workerBudgetMaxUsd: parsed.workerBudgetMaxUsd,
         workerMaxParallel: parsed.workerMaxParallel,
         workerTimeoutMs: parsed.workerTimeoutMs,
         multiAgentEnabled: envMultiAgentEnabled ?? parsed.multiAgentEnabled,
         workerApiKey: process.env.KIMIFLARE_WORKER_API_KEY ?? parsed.workerApiKey,
-        autoExecute: parsed.autoExecute
+        autoExecute: parsed.autoExecute,
+        workerShallowClone: readBooleanEnv("KIMIFLARE_WORKER_SHALLOW_CLONE") ?? parsed.workerShallowClone ?? true,
+        workerRepoCache: readBooleanEnv("KIMIFLARE_WORKER_REPO_CACHE") ?? parsed.workerRepoCache ?? true,
+        workerPreReadFiles: envWorkerPreReadFiles ?? parsed.workerPreReadFiles,
+        workerPreReadMaxChars: envWorkerPreReadMaxChars ?? parsed.workerPreReadMaxChars
       };
     }
   }
   return null;
 }
+function resolveWorkerBudgetUsd(cfg) {
+  const DEFAULT_WORKER_BUDGET_USD = 1;
+  const HARD_CEILING = cfg?.workerBudgetMaxUsd ?? 5;
+  const raw = cfg?.workerBudgetUsd ?? DEFAULT_WORKER_BUDGET_USD;
+  if (raw <= 0) {
+    throw new Error(
+      `Invalid workerBudgetUsd (${raw}). Must be > 0. Set via /multi-agent or KIMIFLARE_WORKER_BUDGET_USD.`
+    );
+  }
+  if (raw > HARD_CEILING) {
+    console.warn(
+      `kimiflare: workerBudgetUsd ${raw} exceeds hard ceiling ${HARD_CEILING}; capping to ${HARD_CEILING}. Raise the ceiling with KIMIFLARE_WORKER_BUDGET_MAX_USD if you really need more.`
+    );
+    return HARD_CEILING;
+  }
+  return raw;
+}
 async function saveConfig(cfg) {
   const p = configPath();
   await mkdir(join(p, ".."), { recursive: true });
@@ -411,8 +441,8 @@ async function flushAndCloseForTesting() {
   const s = currentStream;
   currentStream = null;
   currentDate = null;
-  await new Promise((resolve4) => {
-    s.end(() => resolve4());
+  await new Promise((resolve5) => {
+    s.end(() => resolve5());
   });
 }
 function isLogSinkEnabled() {
@@ -1402,11 +1432,11 @@ function extractCloudflareError(parsed, rawText) {
   return null;
 }
 function sleep(ms, signal) {
-  return new Promise((resolve4, reject) => {
+  return new Promise((resolve5, reject) => {
     if (signal?.aborted) return reject(new DOMException("aborted", "AbortError"));
     const t = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve4();
+      resolve5();
     }, ms);
     const onAbort = () => {
       clearTimeout(t);
@@ -2108,8 +2138,8 @@ var require_node_gyp_build = __commonJS({
     var abi = process.versions.modules;
     var runtime = isElectron() ? "electron" : isNwjs() ? "node-webkit" : "node";
     var arch = process.env.npm_config_arch || os2.arch();
-    var platform7 = process.env.npm_config_platform || os2.platform();
-    var libc = process.env.LIBC || (isAlpine(platform7) ? "musl" : "glibc");
+    var platform8 = process.env.npm_config_platform || os2.platform();
+    var libc = process.env.LIBC || (isAlpine(platform8) ? "musl" : "glibc");
     var armv = process.env.ARM_VERSION || (arch === "arm64" ? "8" : vars.arm_version) || "";
     var uv = (process.versions.uv || "").split(".")[0];
     module.exports = load;
@@ -2129,12 +2159,12 @@ var require_node_gyp_build = __commonJS({
         var debug = getFirst(path.join(dir, "build/Debug"), matchBuild);
         if (debug) return debug;
       }
-      var prebuild = resolve4(dir);
+      var prebuild = resolve5(dir);
       if (prebuild) return prebuild;
-      var nearby = resolve4(path.dirname(process.execPath));
+      var nearby = resolve5(path.dirname(process.execPath));
       if (nearby) return nearby;
       var target = [
-        "platform=" + platform7,
+        "platform=" + platform8,
         "arch=" + arch,
         "runtime=" + runtime,
         "abi=" + abi,
@@ -2147,9 +2177,9 @@ var require_node_gyp_build = __commonJS({
         // eslint-disable-line
       ].filter(Boolean).join(" ");
       throw new Error("No native build was found for " + target + "\n    loaded from: " + dir + "\n");
-      function resolve4(dir2) {
+      function resolve5(dir2) {
         var tuples = readdirSync2(path.join(dir2, "prebuilds")).map(parseTuple);
-        var tuple = tuples.filter(matchTuple(platform7, arch)).sort(compareTuples)[0];
+        var tuple = tuples.filter(matchTuple(platform8, arch)).sort(compareTuples)[0];
         if (!tuple) return;
         var prebuilds = path.join(dir2, "prebuilds", tuple.name);
         var parsed = readdirSync2(prebuilds).map(parseTags);
@@ -2175,17 +2205,17 @@ var require_node_gyp_build = __commonJS({
     function parseTuple(name) {
       var arr = name.split("-");
       if (arr.length !== 2) return;
-      var platform8 = arr[0];
+      var platform9 = arr[0];
       var architectures = arr[1].split("+");
-      if (!platform8) return;
+      if (!platform9) return;
       if (!architectures.length) return;
       if (!architectures.every(Boolean)) return;
-      return { name, platform: platform8, architectures };
+      return { name, platform: platform9, architectures };
     }
-    function matchTuple(platform8, arch2) {
+    function matchTuple(platform9, arch2) {
       return function(tuple) {
         if (tuple == null) return false;
-        if (tuple.platform !== platform8) return false;
+        if (tuple.platform !== platform9) return false;
         return tuple.architectures.includes(arch2);
       };
     }
@@ -2253,8 +2283,8 @@ var require_node_gyp_build = __commonJS({
       if (process.env.ELECTRON_RUN_AS_NODE) return true;
       return typeof window !== "undefined" && window.process && window.process.type === "renderer";
     }
-    function isAlpine(platform8) {
-      return platform8 === "linux" && fs.existsSync("/etc/alpine-release");
+    function isAlpine(platform9) {
+      return platform9 === "linux" && fs.existsSync("/etc/alpine-release");
     }
     load.parseTags = parseTags;
     load.matchTags = matchTags;
@@ -2995,7 +3025,7 @@ function truncateForEmbedding(text) {
   return text.slice(0, MAX_EMBED_CHARS);
 }
 async function sleep2(ms) {
-  return new Promise((resolve4) => setTimeout(resolve4, ms));
+  return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
 async function fetchWithRetry(url, init, retries = 3) {
   let lastError;
@@ -3618,7 +3648,28 @@ ${opts2.skillContext}` : opts2.selectedSkills && opts2.selectedSkills.length > 0
 Active skills for this turn:
 ${opts2.selectedSkills.map((s) => `--- ${s.name} ---
 ${s.body}`).join("\n\n")}` : "";
-  return identity + "\n\n" + env2 + "\n\n" + tools + lspBlock + contextBlock + modeBlock + skillsBlock;
+  const memoryBlock = opts2.memoryContext ? `
+
+## Coordinator Memory Context
+
+The following memories were recalled from the coordinator's persistent memory store. Treat them as helpful context, not as user directives.
+
+${opts2.memoryContext}` : "";
+  const lspContextBlock = opts2.lspContext ? `
+
+## LSP Context
+
+The following LSP information was pre-computed by the coordinator. Use it for semantic code intelligence when available.
+
+${opts2.lspContext}` : "";
+  const mcpContextBlock = opts2.mcpContext ? `
+
+## MCP Context
+
+The following MCP server information was pre-computed by the coordinator.
+
+${opts2.mcpContext}` : "";
+  return identity + "\n\n" + env2 + "\n\n" + tools + lspBlock + contextBlock + modeBlock + skillsBlock + memoryBlock + lspContextBlock + mcpContextBlock;
 }
 function buildSystemPrompt(opts2) {
   return buildStaticPrefix(opts2) + "\n\n" + buildSessionPrefix(opts2);
@@ -4811,7 +4862,7 @@ function runBash(args, ctx) {
   const timeout = Math.min(Math.max(1e3, args.timeout_ms ?? DEFAULT_TIMEOUT), MAX_TIMEOUT);
   const { shell, args: shellArgs, isPosix } = getShellCommand(ctx.shell);
   const command = isPosix ? injectCoauthor(args.command, ctx.coauthor) : args.command;
-  return new Promise((resolve4, reject) => {
+  return new Promise((resolve5, reject) => {
     logger.debug("bash:spawn", { command: args.command.slice(0, 200), cwd: ctx.cwd, shell });
     const child = spawn(shell, [...shellArgs, command], {
       cwd: ctx.cwd,
@@ -4864,7 +4915,7 @@ ${stdout.trimEnd()}`);
 ${stderr.trimEnd()}`);
       if (!stdout && !stderr) parts.push("(no output)");
       const raw = parts.join("\n");
-      resolve4({
+      resolve5({
         content: raw,
         rawBytes: Buffer.byteLength(raw, "utf8"),
         reducedBytes: Buffer.byteLength(raw, "utf8")
@@ -5698,7 +5749,7 @@ import { tmpdir as tmpdir2 } from "os";
 import { join as join11, dirname as dirname5 } from "path";
 async function autoScroll(page) {
   await page.evaluate(async () => {
-    await new Promise((resolve4) => {
+    await new Promise((resolve5) => {
       let totalHeight = 0;
       const distance = 300;
       const timer2 = setInterval(() => {
@@ -5707,12 +5758,12 @@ async function autoScroll(page) {
         totalHeight += distance;
         if (totalHeight >= scrollHeight) {
           clearInterval(timer2);
-          resolve4();
+          resolve5();
         }
       }, 100);
       setTimeout(() => {
         clearInterval(timer2);
-        resolve4();
+        resolve5();
       }, 1e4);
     });
   });
@@ -6061,13 +6112,13 @@ function readNumberEnv2(name) {
   const parsed = parseInt(raw, 10);
   return Number.isNaN(parsed) ? void 0 : parsed;
 }
-var DEFAULT_WORKER_TIMEOUT_MS, DEFAULT_WORKER_BUDGET_USD, spawnWorkerTool;
+var DEFAULT_WORKER_TIMEOUT_MS, spawnWorkerTool;
 var init_spawn_worker = __esm({
   "src/tools/spawn-worker.ts"() {
     "use strict";
     init_logger();
+    init_config();
     DEFAULT_WORKER_TIMEOUT_MS = 3e5;
-    DEFAULT_WORKER_BUDGET_USD = 1;
     spawnWorkerTool = {
       name: "spawn_worker",
       description: [
@@ -6147,7 +6198,8 @@ var init_spawn_worker = __esm({
         }
         const apiKey = process.env.KIMIFLARE_WORKER_API_KEY;
         const timeoutMs = readNumberEnv2("KIMIFLARE_WORKER_TIMEOUT_MS") ?? DEFAULT_WORKER_TIMEOUT_MS;
-        const budgetUsd = args.budget?.maxCostUsd ?? readNumberEnv2("KIMIFLARE_WORKER_BUDGET_USD") ?? DEFAULT_WORKER_BUDGET_USD;
+        const cfg = await loadConfig().catch(() => null);
+        const budgetUsd = resolveWorkerBudgetUsd(cfg);
         const payload = {
           mode: args.mode,
           task: args.task,
@@ -6166,14 +6218,14 @@ var init_spawn_worker = __esm({
         logger.info("spawn_worker:starting", { mode: args.mode, endpoint, taskPreview: args.task.slice(0, 100) });
         try {
           const result = await callWorkerEndpoint(endpoint, apiKey, payload, ctx.signal, timeoutMs);
-          if (result.status !== "completed") {
+          if (result.status !== "completed" && result.status !== "budget_exhausted") {
             const msg = `Worker ${result.workerId} ${result.status}: ${result.error ?? "unknown error"}`;
             const bytes2 = Buffer.byteLength(msg, "utf8");
             return { content: msg, rawBytes: bytes2, reducedBytes: bytes2 };
           }
           const lines = [
-            `Worker ${result.workerId} completed.`,
-            `Cost: $${result.costUsd.toFixed(2)} \xB7 Tokens: ${result.tokensUsed.toLocaleString()}`,
+            `Worker ${result.workerId} ${result.status === "budget_exhausted" ? "budget_exhausted (partial result)" : "completed"}.`,
+            `Cost: ${result.costUsd.toFixed(2)} \xB7 Tokens: ${result.tokensUsed.toLocaleString()}`,
             "",
             "## Findings",
             ...result.findings.map(
@@ -6183,6 +6235,12 @@ var init_spawn_worker = __esm({
             "## Recommendations",
             ...result.recommendations.map((r) => `- ${r}`)
           ];
+          if (result.status === "budget_exhausted") {
+            lines.push(
+              "",
+              "> \u26A0\uFE0F This worker hit its budget ceiling and returned partial results. Consider re-running with a higher budget if findings are incomplete."
+            );
+          }
           if (result.filesRead.length > 0) {
             lines.push("", "## Files Read", ...result.filesRead.map((f) => `- ${f}`));
           }
@@ -8276,7 +8334,7 @@ __export(tui_auth_exports, {
   authGitHubForTui: () => authGitHubForTui
 });
 function sleep3(ms) {
-  return new Promise((resolve4) => setTimeout(resolve4, ms));
+  return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
 async function* authGitHubForTui() {
   yield { message: "Starting GitHub OAuth device flow..." };
@@ -8381,6 +8439,7 @@ __export(db_exports, {
   getMemoryById: () => getMemoryById,
   getMemoryDb: () => getMemoryDb,
   getMemoryStats: () => getMemoryStats,
+  getTopRelatedFiles: () => getTopRelatedFiles,
   insertMemories: () => insertMemories,
   insertMemory: () => insertMemory,
   listMemoriesForVectorSearch: () => listMemoriesForVectorSearch,
@@ -8762,6 +8821,25 @@ function getMemoryById(db, id) {
   const row = db.prepare("SELECT * FROM memories WHERE id = ?").get(id);
   return row ? rowToMemory(row) : null;
 }
+function getTopRelatedFiles(db, repoPath, limit = 10) {
+  const rows = db.prepare(
+    `SELECT related_files, importance FROM memories
+       WHERE repo_path = ? AND related_files != '[]'
+         AND forgotten = 0 AND superseded_by IS NULL
+       ORDER BY accessed_at DESC
+       LIMIT 200`
+  ).all(repoPath);
+  const scores = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const files = JSON.parse(row.related_files);
+    for (const file of files) {
+      if (!file) continue;
+      scores.set(file, (scores.get(file) ?? 0) + row.importance);
+    }
+  }
+  const sorted = [...scores.entries()].sort((a, b) => b[1] - a[1]);
+  return sorted.slice(0, limit).map(([file]) => file);
+}
 function countHighSignalMemoriesSince(db, repoPath, since) {
   const row = db.prepare(
     `SELECT COUNT(*) as count FROM memories
@@ -8785,6 +8863,11 @@ var init_db2 = __esm({
 });
 
 // src/memory/retrieval.ts
+var retrieval_exports = {};
+__export(retrieval_exports, {
+  formatRecalledMemories: () => formatRecalledMemories,
+  retrieveMemories: () => retrieveMemories
+});
 function normalizeFtsRank(rank) {
   const clamped = Math.max(0, Math.min(10, rank));
   return 1 - clamped / 10;
@@ -8912,6 +8995,15 @@ async function retrieveMemories(opts2) {
   }
   return results;
 }
+function formatRecalledMemories(results) {
+  if (results.length === 0) return "";
+  const lines = results.map((r) => {
+    const files = r.memory.relatedFiles.length > 0 ? ` [${r.memory.relatedFiles.join(", ")}]` : "";
+    return `- [${r.memory.category}] ${r.memory.content}${files}`;
+  });
+  return `Recalled memories from previous sessions:
+${lines.join("\n")}`;
+}
 var RRF_K;
 var init_retrieval = __esm({
   "src/memory/retrieval.ts"() {
@@ -9390,7 +9482,7 @@ var init_connection = __esm({
         if (this.child) {
           throw new Error("LSP connection already started");
         }
-        return new Promise((resolve4, reject) => {
+        return new Promise((resolve5, reject) => {
           const abortController = new AbortController();
           const spawnTimer = setTimeout(() => {
             abortController.abort();
@@ -9429,7 +9521,7 @@ var init_connection = __esm({
               if (child.pid) {
                 clearTimeout(spawnTimer);
                 this.child = child;
-                resolve4();
+                resolve5();
               }
             });
           } catch (err) {
@@ -9444,12 +9536,12 @@ var init_connection = __esm({
         }
         const id = this.nextId++;
         const msg = { jsonrpc: "2.0", id, method, params };
-        return new Promise((resolve4, reject) => {
+        return new Promise((resolve5, reject) => {
           const timer2 = setTimeout(() => {
             this.pending.delete(id);
             reject(toolTimeoutError(`LSP request '${method}'`, this.requestTimeoutMs));
           }, this.requestTimeoutMs);
-          const pending = { resolve: resolve4, reject, signal, timer: timer2 };
+          const pending = { resolve: resolve5, reject, signal, timer: timer2 };
           this.pending.set(id, pending);
           if (signal) {
             const onAbort = () => {
@@ -9989,6 +10081,25 @@ var init_manager2 = __esm({
         }
         return count;
       }
+      /** Export a compact LSP context summary for multi-agent workers.
+       *  Returns workspace symbols from the first running server. */
+      async exportContext(_rootPath) {
+        for (const [, server] of this.servers) {
+          if (server.state !== "running") continue;
+          try {
+            const symbols = await server.client.workspaceSymbol("");
+            if (!symbols || symbols.length === 0) continue;
+            const lines = [`LSP server: ${server.id} (${server.rootUri})`];
+            for (const sym of symbols.slice(0, 50)) {
+              const loc = "location" in sym && sym.location ? `${sym.location.uri}:${(sym.location.range?.start?.line ?? 0) + 1}` : "";
+              lines.push(`- ${sym.name} (${sym.kind})${loc ? ` \u2192 ${loc}` : ""}`);
+            }
+            return lines.join("\n");
+          } catch {
+          }
+        }
+        return "";
+      }
     };
   }
 });
@@ -11071,7 +11182,7 @@ var init_runner = __esm({
     init_logger();
     DEFAULT_TIMEOUT_MS = 3e4;
     STREAM_CAP_BYTES = 4 * 1024;
-    defaultSpawn = (command, payloadJson, env2, cwd, timeoutMs, signal) => new Promise((resolve4) => {
+    defaultSpawn = (command, payloadJson, env2, cwd, timeoutMs, signal) => new Promise((resolve5) => {
       const child = spawn3(command, {
         shell: true,
         cwd,
@@ -11086,7 +11197,7 @@ var init_runner = __esm({
         settled = true;
         clearTimeout(timer2);
         signal?.removeEventListener("abort", onAbort);
-        resolve4({ exitCode, stdout, stderr, timedOut });
+        resolve5({ exitCode, stdout, stderr, timedOut });
       };
       const onAbort = () => {
         child.kill("SIGTERM");
@@ -11366,8 +11477,8 @@ var init_session = __esm({
           const parts = [{ type: "text", text }];
           for (const img of options.images) {
             if ("path" in img) {
-              const { readFile: readFile21 } = await import("fs/promises");
-              const data = await readFile21(img.path, "base64");
+              const { readFile: readFile22 } = await import("fs/promises");
+              const data = await readFile22(img.path, "base64");
               const mimeType = img.path.endsWith(".png") ? "image/png" : img.path.endsWith(".jpg") || img.path.endsWith(".jpeg") ? "image/jpeg" : "image/webp";
               parts.push({ type: "image_url", image_url: { url: `data:${mimeType};base64,${data}` } });
             } else {
@@ -11559,12 +11670,12 @@ var init_session = __esm({
               toolName: req.tool.name,
               args: req.args
             });
-            const decision = await new Promise((resolve4) => {
-              this.permissionResolvers.set(requestId, resolve4);
+            const decision = await new Promise((resolve5) => {
+              this.permissionResolvers.set(requestId, resolve5);
               setTimeout(() => {
                 if (this.permissionResolvers.has(requestId)) {
                   this.permissionResolvers.delete(requestId);
-                  resolve4("deny");
+                  resolve5("deny");
                 }
               }, 3e5);
             });
@@ -11613,7 +11724,7 @@ var init_session = __esm({
               this.lspManager?.notifyChange(path, content);
             } else {
               void import("fs/promises").then(
-                ({ readFile: readFile21 }) => readFile21(path, "utf8").then((c) => this.lspManager?.notifyChange(path, c)).catch(() => {
+                ({ readFile: readFile22 }) => readFile22(path, "utf8").then((c) => this.lspManager?.notifyChange(path, c)).catch(() => {
                 })
               ).catch(() => {
               });
@@ -11895,15 +12006,109 @@ var init_repo_info = __esm({
 });
 
 // src/agent/supervisor.ts
-function decomposePrompt(prompt, context) {
-  const items = extractListItems(prompt);
-  if (items.length >= 2) {
-    return items.slice(0, 4).map((task) => ({ mode: "plan", task, context }));
+import { readdir as readdir5, readFile as readFile13, stat as stat5 } from "fs/promises";
+import { createHash as createHash2 } from "crypto";
+import { resolve as resolve4, join as join22 } from "path";
+async function preReadFilesForWorkers(files, repoRoot, maxChars = DEFAULT_PRE_READ_MAX_CHARS) {
+  const results = [];
+  const filesRead = [];
+  let chars = 0;
+  for (const file of files) {
+    if (chars >= maxChars) break;
+    const path = resolve4(repoRoot, file);
+    try {
+      const s = await stat5(path);
+      if (!s.isFile()) continue;
+      const raw = await readFile13(path, "utf8");
+      const remaining = maxChars - chars;
+      const content = raw.length > remaining ? raw.slice(0, remaining) + "\n\u2026 (truncated)" : raw;
+      results.push(`--- ${file} ---
+${content}`);
+      filesRead.push(file);
+      chars += content.length;
+    } catch {
+    }
+  }
+  if (results.length === 0) {
+    return { text: "", filesRead: [], chars: 0 };
+  }
+  return {
+    text: `The following files were pre-read by the coordinator and are available for reference.
+Check here before using the read tool to avoid redundant file reads.
+
+${results.join("\n\n")}`,
+    filesRead,
+    chars
+  };
+}
+function getPreReadFilesFromMemory(cfg, repoRoot, limit = 10) {
+  if (!cfg.memoryEnabled) return [];
+  const dbPath = cfg.memoryDbPath ?? join22(repoRoot, ".kimiflare", "memory.db");
+  try {
+    const db = openMemoryDb(dbPath);
+    const files = getTopRelatedFiles(db, repoRoot, limit);
+    return files;
+  } catch {
+    return [];
+  }
+}
+function cacheKey2(prompt, context, strategy) {
+  return createHash2("sha256").update(`${prompt}\0${context}\0${strategy}`).digest("hex");
+}
+function getCached(key) {
+  return decompositionCache.get(key);
+}
+function setCached(key, value) {
+  if (decompositionCache.size >= MAX_CACHE_ENTRIES) {
+    const first = decompositionCache.keys().next().value;
+    if (first !== void 0) decompositionCache.delete(first);
+  }
+  decompositionCache.set(key, value);
+}
+async function getFileTreeSnapshot(cwd) {
+  const IGNORED = /* @__PURE__ */ new Set([
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    "out",
+    "target",
+    ".next",
+    ".nuxt",
+    ".astro",
+    "coverage",
+    ".coverage",
+    "__pycache__",
+    ".venv",
+    "venv",
+    ".tox",
+    ".idea",
+    ".vscode",
+    ".DS_Store"
+  ]);
+  try {
+    const entries = await readdir5(cwd, { withFileTypes: true });
+    const dirs = [];
+    const files = [];
+    for (const e of entries) {
+      if (e.name.startsWith(".") && !e.name.startsWith(".github") && !e.name.startsWith(".config")) {
+        if (!e.isDirectory()) continue;
+      }
+      if (IGNORED.has(e.name)) continue;
+      if (e.isDirectory()) dirs.push(`${e.name}/`);
+      else files.push(e.name);
+    }
+    dirs.sort();
+    files.sort();
+    const lines = [...dirs, ...files];
+    if (lines.length === 0) return "(empty directory)";
+    if (lines.length > 40) {
+      return lines.slice(0, 40).join("\n") + "\n\u2026 (truncated)";
+    }
+    return lines.join("\n");
+  } catch {
+    return "(unable to read directory)";
   }
-  return [
-    { mode: "plan", task: `Research overview and best practices for: ${prompt}`, context },
-    { mode: "plan", task: `Investigate implementation details, trade-offs, and risks for: ${prompt}`, context }
-  ];
 }
 function extractListItems(prompt) {
   const numbered = [...prompt.matchAll(/(?:^|\n)\s*\d+[.)]\s+([^\n]+)/g)].map((m) => m[1]?.trim() ?? "");
@@ -11912,19 +12117,131 @@ function extractListItems(prompt) {
   if (bulleted.length >= 2) return bulleted.filter((s) => s.length > 0);
   return [];
 }
-var TurnSupervisor;
+async function decomposeWithLlm(prompt, context, fileTree, cfg) {
+  const model = cfg.decompositionModel ?? "@cf/moonshotai/kimi-k2.5";
+  const accountId = cfg.accountId;
+  const apiToken = cfg.apiToken;
+  if (!accountId || !apiToken) {
+    logger.warn("decompose:missing_creds", { reason: "no accountId or apiToken" });
+    return null;
+  }
+  const gateway = cfg.aiGatewayId ? {
+    id: cfg.aiGatewayId,
+    cacheTtl: cfg.aiGatewayCacheTtl,
+    skipCache: cfg.aiGatewaySkipCache,
+    metadata: { feature: "decomposition", ...cfg.aiGatewayMetadata ?? {} }
+  } : void 0;
+  const userContent = [
+    `User request: ${prompt}`,
+    context ? `Additional context: ${context}` : "",
+    `Project file tree (top-level):
+${fileTree}`
+  ].filter(Boolean).join("\n\n");
+  const messages = [
+    { role: "system", content: DECOMPOSITION_SYSTEM },
+    { role: "user", content: userContent }
+  ];
+  try {
+    let text = "";
+    const events = runKimi({
+      accountId,
+      apiToken,
+      model,
+      messages,
+      temperature: 0.1,
+      maxCompletionTokens: 2048,
+      reasoningEffort: "low",
+      gateway
+    });
+    for await (const ev of events) {
+      if (ev.type === "text") text += ev.delta;
+    }
+    const cleaned = text.replace(/```(?:json)?\s*/gi, "").replace(/```\s*$/gi, "").trim();
+    const parsed = JSON.parse(cleaned);
+    const rawTasks = parsed.tasks;
+    if (!Array.isArray(rawTasks) || rawTasks.length === 0) {
+      logger.warn("decompose:invalid_tasks", { rawTasks });
+      return null;
+    }
+    const tasks = rawTasks.map((t) => typeof t === "string" ? t.trim() : "").filter((t) => t.length > 0);
+    if (tasks.length < 2) {
+      logger.warn("decompose:too_few_tasks", { count: tasks.length });
+      return null;
+    }
+    const unique = [];
+    for (const t of tasks) {
+      const lower = t.toLowerCase();
+      if (!unique.some((u) => u.toLowerCase() === lower || lower.includes(u.toLowerCase()) || u.toLowerCase().includes(lower))) {
+        unique.push(t);
+      }
+    }
+    const capped = unique.slice(0, 4);
+    logger.debug("decompose:llm_success", { taskCount: capped.length, reasoning: parsed.reasoning });
+    return capped.map((task) => ({ mode: "plan", task, context }));
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    logger.warn("decompose:llm_failed", { error: msg });
+    return null;
+  }
+}
+function fallbackDecomposition(prompt, context) {
+  return [
+    { mode: "plan", task: `Research overview and best practices for: ${prompt}`, context },
+    { mode: "plan", task: `Investigate implementation details, trade-offs, and risks for: ${prompt}`, context }
+  ];
+}
+async function decomposePrompt(prompt, context, opts2) {
+  const items = extractListItems(prompt);
+  if (items.length >= 2) {
+    return items.slice(0, 4).map((task) => ({ mode: "plan", task, context }));
+  }
+  const strategy = opts2?.cfg?.decompositionStrategy ?? "llm";
+  const key = cacheKey2(prompt, context, strategy);
+  const cached = getCached(key);
+  if (cached) {
+    logger.debug("decompose:cache_hit");
+    return cached;
+  }
+  if (strategy === "regex") {
+    const result2 = fallbackDecomposition(prompt, context);
+    setCached(key, result2);
+    return result2;
+  }
+  if (opts2?.cfg) {
+    const cwd = opts2.cwd ?? process.cwd();
+    const fileTree = await getFileTreeSnapshot(cwd);
+    const llmResult = await decomposeWithLlm(prompt, context, fileTree, opts2.cfg);
+    if (llmResult) {
+      setCached(key, llmResult);
+      return llmResult;
+    }
+  }
+  const result = fallbackDecomposition(prompt, context);
+  setCached(key, result);
+  return result;
+}
+var DEFAULT_PRE_READ_MAX_CHARS, TurnSupervisor, decompositionCache, MAX_CACHE_ENTRIES, DECOMPOSITION_SYSTEM;
 var init_supervisor = __esm({
   "src/agent/supervisor.ts"() {
     "use strict";
     init_loop();
     init_logger();
+    init_client();
     init_repo_info();
     init_config();
+    init_db2();
+    DEFAULT_PRE_READ_MAX_CHARS = 5e4;
     TurnSupervisor = class {
       currentTurn = null;
       _phase = "idle";
       _killRequested = false;
       _activeWorkers = /* @__PURE__ */ new Map();
+      /** Coordinator-side MemoryManager for proxying memories to workers */
+      memoryManager = null;
+      /** Coordinator-side LspManager for proxying LSP context to workers */
+      lspManager = null;
+      /** Coordinator-side McpManager for proxying MCP context to workers */
+      mcpManager = null;
       get phase() {
         return this._phase;
       }
@@ -12011,6 +12328,29 @@ var init_supervisor = __esm({
         }
         const userAccountId = cfg.accountId;
         const userApiToken = cfg.apiToken;
+        const proxyMemory = cfg?.workerProxyMemory ?? true;
+        const proxyLsp = cfg?.workerProxyLsp ?? false;
+        const proxyMcp = cfg?.workerProxyMcp ?? false;
+        const memoryManager = this.memoryManager;
+        const lspManager = this.lspManager;
+        const mcpManager = this.mcpManager;
+        let preReadCfg = cfg.workerPreReadFiles;
+        if (!preReadCfg || preReadCfg.length === 0) {
+          const memoryFiles = getPreReadFilesFromMemory(cfg, process.cwd(), 10);
+          if (memoryFiles.length > 0) {
+            preReadCfg = memoryFiles;
+            logger.info("spawnWorkers:pre_read_from_memory", { files: memoryFiles });
+          }
+        }
+        const preReadMax = cfg.workerPreReadMaxChars ?? DEFAULT_PRE_READ_MAX_CHARS;
+        const preRead = preReadCfg && preReadCfg.length > 0 ? await preReadFilesForWorkers(preReadCfg, process.cwd(), preReadMax) : { text: "", filesRead: [], chars: 0 };
+        if (preRead.filesRead.length > 0) {
+          logger.info("spawnWorkers:pre_read", {
+            files: preRead.filesRead,
+            chars: preRead.chars,
+            source: cfg.workerPreReadFiles ? "config" : "memory"
+          });
+        }
         for (const w of workers) {
           const id = `worker-${crypto.randomUUID().slice(0, 8)}`;
           this._activeWorkers.set(id, {
@@ -12019,14 +12359,18 @@ var init_supervisor = __esm({
             task: w.task,
             status: "pending",
             startedAt: Date.now(),
-            logs: []
+            logs: [],
+            preReadFiles: preRead.filesRead,
+            preReadChars: preRead.chars
           });
         }
         onUpdate?.(this.activeWorkers);
         const results = [];
         const queue2 = [...workers];
         const activeWorkers = this._activeWorkers;
-        async function runBatch(batch) {
+        async function runBatch(batch, batchId) {
+          const shallowClone = cfg?.workerShallowClone ?? true;
+          const repoCache = cfg?.workerRepoCache ?? true;
           await Promise.all(
             batch.map(async (w) => {
               const workerId = [...activeWorkers.entries()].find(
@@ -12036,13 +12380,52 @@ var init_supervisor = __esm({
               const worker = activeWorkers.get(workerId);
               worker.status = "running";
               worker.logs.push(`[coordinator] Starting worker \u2192 POST ${endpoint}/worker`);
+              if (worker.preReadFiles && worker.preReadFiles.length > 0) {
+                worker.logs.push(
+                  `[coordinator] Shared cache: ${worker.preReadFiles.length} file(s) pre-read (~${worker.preReadChars?.toLocaleString() ?? "?"} chars)`
+                );
+              }
               onUpdate?.([...activeWorkers.values()]);
               try {
+                const maxCostUsd = resolveWorkerBudgetUsd(cfg);
+                if (maxCostUsd !== (w.budgetUsd ?? 1)) {
+                  worker.logs.push(
+                    `[coordinator] Budget capped to ${maxCostUsd.toFixed(2)} (was ${(w.budgetUsd ?? 1).toFixed(2)})`
+                  );
+                }
+                let memoryContext = w.memoryContext ?? "";
+                let lspContext = w.lspContext ?? "";
+                let mcpContext = w.mcpContext ?? "";
+                if (proxyMemory && memoryManager && !memoryContext) {
+                  try {
+                    const memories = await memoryManager.recall({ text: w.task, limit: 10 });
+                    const { formatRecalledMemories: formatRecalledMemories2 } = await Promise.resolve().then(() => (init_retrieval(), retrieval_exports));
+                    memoryContext = formatRecalledMemories2(memories);
+                  } catch (err) {
+                    logger.warn("supervisor:memory_recall_failed", { task: w.task, error: err.message });
+                  }
+                }
+                if (proxyLsp && lspManager && !lspContext) {
+                  try {
+                    lspContext = await lspManager.exportContext(process.cwd());
+                  } catch (err) {
+                    logger.warn("supervisor:lsp_export_failed", { error: err.message });
+                  }
+                }
+                if (proxyMcp && mcpManager && !mcpContext) {
+                  try {
+                    mcpContext = mcpManager.exportContext();
+                  } catch (err) {
+                    logger.warn("supervisor:mcp_export_failed", { error: err.message });
+                  }
+                }
                 const payload = {
                   mode: w.mode,
                   task: w.task,
-                  context: w.context ?? "",
-                  budget: { maxCostUsd: w.budgetUsd ?? 1 },
+                  context: preRead.text ? `${preRead.text}
+
+${w.context ?? ""}` : w.context ?? "",
+                  budget: { maxCostUsd },
                   outputFormat: "structured",
                   tools: w.mode === "plan" ? "read-only" : "all",
                   model: w.model ?? "@cf/moonshotai/kimi-k2.6",
@@ -12057,6 +12440,15 @@ var init_supervisor = __esm({
                   // these are absent (older client + new server).
                   userAccountId,
                   userApiToken,
+                  // Batch-level hints so the Commute worker can share a cloned
+                  // repo across workers in the same batch and skip full clones.
+                  batchId,
+                  shallowClone,
+                  repoCache,
+                  // Coordinator-side context proxying
+                  ...memoryContext ? { memoryContext } : {},
+                  ...lspContext ? { lspContext } : {},
+                  ...mcpContext ? { mcpContext } : {},
                   // Optionally override the in-sandbox kimiflare install so the
                   // worker runs pre-release / branch code instead of the image-
                   // baked version. e.g. `kimiflare@latest`, `kimiflare@1.2.3`,
@@ -12068,9 +12460,15 @@ var init_supervisor = __esm({
                     prBody: w.prBody
                   } : {}
                 };
-                const timeoutMs = parseInt(process.env.KIMIFLARE_WORKER_TIMEOUT_MS ?? "900000", 10);
+                const timeoutMs = cfg?.workerTimeoutMs ?? parseInt(process.env.KIMIFLARE_WORKER_TIMEOUT_MS ?? "900000", 10);
                 worker.logs.push(`[coordinator] Sending payload (${JSON.stringify(payload).length} bytes)`);
                 worker.logs.push(`[coordinator] Worker will clone ${repo.owner}/${repo.repo} and run kimiflare inside Cloudflare Sandbox`);
+                const optHints = [];
+                if (shallowClone) optHints.push("shallow clone");
+                if (repoCache) optHints.push("repo cache");
+                if (optHints.length > 0) {
+                  worker.logs.push(`[coordinator] Optimizations enabled: ${optHints.join(", ")}`);
+                }
                 worker.logs.push(`[coordinator] Typical runtime: 1\u20134 min. Timeout: ${Math.round(timeoutMs / 1e3)}s`);
                 onUpdate?.([...activeWorkers.values()]);
                 const startRes = await fetch(`${endpoint}/worker`, {
@@ -12090,11 +12488,11 @@ var init_supervisor = __esm({
                 worker.logs.push(`[coordinator] Worker started (id: ${remoteWorkerId}) \u2014 polling for progress\u2026`);
                 onUpdate?.([...activeWorkers.values()]);
                 const pollInterval = 3e3;
-                const startTime = Date.now();
+                let lastProgressAt = Date.now();
                 let lastLogCount = 0;
                 let lastStep = "";
                 let data;
-                while (Date.now() - startTime < timeoutMs) {
+                while (Date.now() - lastProgressAt < timeoutMs) {
                   if (signal?.aborted) {
                     worker.logs.push(`[coordinator] Cancelling worker (id: ${remoteWorkerId})\u2026`);
                     onUpdate?.([...activeWorkers.values()]);
@@ -12138,7 +12536,7 @@ var init_supervisor = __esm({
                   for (let i = 0; i < progress.totalSteps; i++) {
                     const isCompleted = i < progress.completedSteps.length;
                     const isActive = i === progress.stepIndex - 1 && !isCompleted && progress.status === "running";
-                    const isFailed = progress.status === "failed" && i === progress.stepIndex - 1;
+                    const isFailed = (progress.status === "failed" || progress.status === "budget_exhausted") && i === progress.stepIndex - 1;
                     allSteps.push({
                       label: progress.completedSteps[i] ?? progress.step,
                       status: isFailed ? "failed" : isCompleted ? "completed" : isActive ? "active" : "pending"
@@ -12153,18 +12551,20 @@ var init_supervisor = __esm({
                   const stepKey = `${progress.stepIndex}:${progress.step}`;
                   if (stepKey !== lastStep) {
                     lastStep = stepKey;
+                    lastProgressAt = Date.now();
                     worker.logs.push(`[coordinator] Step ${progress.stepIndex}/${progress.totalSteps}: ${progress.message}`);
                     onUpdate?.([...activeWorkers.values()]);
                   } else if (newLogs.length > 0) {
+                    lastProgressAt = Date.now();
                     onUpdate?.([...activeWorkers.values()]);
                   }
-                  if (progress.status === "completed" || progress.status === "failed") {
+                  if (progress.status === "completed" || progress.status === "failed" || progress.status === "budget_exhausted") {
                     if (progress.result) {
                       data = progress.result;
                     } else if (progress.error) {
                       data = {
                         workerId: remoteWorkerId,
-                        status: "failed",
+                        status: progress.status === "budget_exhausted" ? "budget_exhausted" : "failed",
                         task: w.task,
                         findings: [],
                         recommendations: [],
@@ -12182,14 +12582,14 @@ var init_supervisor = __esm({
                 if (!data) {
                   throw new Error(`Worker timed out after ${Math.round(timeoutMs / 1e3)}s`);
                 }
-                worker.status = data.status === "completed" ? "completed" : "failed";
+                worker.status = data.status === "completed" ? "completed" : data.status === "budget_exhausted" ? "budget_exhausted" : "failed";
                 worker.result = data;
                 worker.rawOutput = data.rawOutput;
                 worker.reasoning = data.reasoning;
                 if (worker.steps && worker.steps.length > 0) {
                   for (const s of worker.steps) {
                     if (s.status === "pending" || s.status === "active") {
-                      s.status = worker.status === "completed" ? "completed" : "failed";
+                      s.status = worker.status === "completed" ? "completed" : worker.status === "budget_exhausted" ? "failed" : "failed";
                     }
                   }
                 }
@@ -12205,7 +12605,7 @@ var init_supervisor = __esm({
                   worker.logs.push(`[coordinator] Worker raw output (${data.rawOutput.length} chars):`);
                   worker.logs.push(...data.rawOutput.split("\n").slice(-30));
                 }
-                if (data.status === "completed") {
+                if (data.status === "completed" || data.status === "budget_exhausted") {
                   results.push(data);
                 }
               } catch (e) {
@@ -12226,7 +12626,8 @@ var init_supervisor = __esm({
         }
         while (queue2.length > 0) {
           const batch = queue2.splice(0, maxParallel);
-          await runBatch(batch);
+          const batchId = `batch-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+          await runBatch(batch, batchId);
         }
         return results;
       }
@@ -12282,6 +12683,7 @@ var init_supervisor = __esm({
             resolvedRecommendations.push(recs[0][0]);
           }
         }
+        const budgetExhaustedCount = results.filter((r) => r.status === "budget_exhausted").length;
         const planLines = [
           "# Synthesized Execution Plan",
           "",
@@ -12293,6 +12695,12 @@ var init_supervisor = __esm({
           "## Recommendations",
           ...resolvedRecommendations.map((r) => `- ${r}`)
         ];
+        if (budgetExhaustedCount > 0) {
+          planLines.push(
+            "",
+            `> \u26A0\uFE0F ${budgetExhaustedCount} worker(s) hit their budget ceiling and returned partial results. Findings above may be incomplete. Consider re-running with a higher budget if critical gaps remain.`
+          );
+        }
         if (conflicts.length > 0) {
           planLines.push("", "## Conflicts Resolved", ...conflicts.map((c) => `- ${c}`));
         }
@@ -12316,7 +12724,8 @@ var init_supervisor = __esm({
             `Multi-agent already active (${this._activeWorkers.size} worker(s) in flight). Wait for completion or cancel before starting a new heavy task.`
           );
         }
-        const workers = decomposePrompt(prompt, context);
+        const cfg = await loadConfig().catch(() => null);
+        const workers = await decomposePrompt(prompt, context, { cwd: process.cwd(), cfg: cfg ?? void 0 });
         const narrationLines = [
           `Decomposing your request into ${workers.length} parallel research task${workers.length > 1 ? "s" : ""}:`,
           ...workers.map((w, i) => `  ${i + 1}. ${w.task.slice(0, 200)}${w.task.length > 200 ? "\u2026" : ""}`)
@@ -12327,8 +12736,8 @@ var init_supervisor = __esm({
           const results = await this.spawnWorkers(workers, onUpdate, signal);
           onPhaseChange?.("synthesizing");
           const synth = this.synthesizeFindings(results);
-          const cfg = await loadConfig().catch(() => null);
-          const autoExecute = cfg?.autoExecute ?? /^(1|true|yes|on)$/i.test(process.env.KIMIFLARE_AUTO_EXECUTE ?? "");
+          const cfg2 = await loadConfig().catch(() => null);
+          const autoExecute = cfg2?.autoExecute ?? /^(1|true|yes|on)$/i.test(process.env.KIMIFLARE_AUTO_EXECUTE ?? "");
           if (!autoExecute || synth.recommendations.length === 0) {
             return synth;
           }
@@ -12365,6 +12774,17 @@ var init_supervisor = __esm({
         this._activeWorkers.clear();
       }
     };
+    decompositionCache = /* @__PURE__ */ new Map();
+    MAX_CACHE_ENTRIES = 50;
+    DECOMPOSITION_SYSTEM = `You are a task-decomposition assistant. Given a user's coding request and a snapshot of their project directory, produce 2\u20134 well-scoped, non-overlapping research tasks that can be executed in parallel by independent agents.
+
+Rules:
+- Each task must be self-contained and actionable.
+- Tasks must NOT overlap in scope. If two tasks would investigate the same file or concept, merge them.
+- Respect file/directory boundaries mentioned in the prompt or visible in the file tree.
+- Scale task count with perceived complexity: 2 tasks for simple questions, 3\u20134 for broad audits or multi-file changes.
+- Return ONLY a JSON object with this exact shape (no markdown fences, no extra text):
+  {"tasks":["task 1","task 2",...],"reasoning":"brief explanation of why you split this way"}`;
   }
 });
 
@@ -12477,8 +12897,8 @@ async function runEmitMode(opts2) {
   async function nextFollowUp() {
     if (followUpQueue.length > 0) return followUpQueue.shift();
     if (stdinClosed) return null;
-    return new Promise((resolve4) => {
-      followUpResolver = resolve4;
+    return new Promise((resolve5) => {
+      followUpResolver = resolve5;
     });
   }
   const cwd = process.cwd();
@@ -12660,8 +13080,8 @@ ${conflicts.join("\n")}`,
               return "allow";
             }
             if (opts2.multiTurn) {
-              const choice = await new Promise((resolve4) => {
-                pendingPermissions.set(reqId, resolve4);
+              const choice = await new Promise((resolve5) => {
+                pendingPermissions.set(reqId, resolve5);
               });
               if (choice === "allow" || choice === "allow_session") {
                 emit("PermissionGranted", { request_id: reqId });
@@ -12764,9 +13184,9 @@ var init_emit_mode = __esm({
 
 // src/remote/deploy-commute.ts
 import { spawn as spawn4 } from "child_process";
-import { mkdtemp, readFile as readFile13, writeFile as writeFile10, rm } from "fs/promises";
+import { mkdtemp, readFile as readFile14, writeFile as writeFile10, rm } from "fs/promises";
 import { tmpdir as tmpdir3 } from "os";
-import { join as join22 } from "path";
+import { join as join23 } from "path";
 import { randomBytes as randomBytes2 } from "crypto";
 async function cfApiFetch(accountId, apiToken, path, init) {
   const url = `${CF_API}/accounts/${encodeURIComponent(accountId)}${path}`;
@@ -12836,7 +13256,7 @@ function generateSecret2() {
   return randomBytes2(32).toString("hex");
 }
 function runCmd(cmd, args, opts2 = {}) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const child = spawn4(cmd, args, {
       cwd: opts2.cwd,
       env: { ...process.env, ...opts2.env ?? {} },
@@ -12857,11 +13277,11 @@ function runCmd(cmd, args, opts2 = {}) {
     const timer2 = opts2.timeoutMs ? setTimeout(() => child.kill("SIGKILL"), opts2.timeoutMs) : null;
     child.on("close", (code) => {
       if (timer2) clearTimeout(timer2);
-      resolve4({ stdout, stderr, code: code ?? -1 });
+      resolve5({ stdout, stderr, code: code ?? -1 });
     });
     child.on("error", (err) => {
       if (timer2) clearTimeout(timer2);
-      resolve4({ stdout, stderr: stderr + String(err), code: -1 });
+      resolve5({ stdout, stderr: stderr + String(err), code: -1 });
     });
   });
 }
@@ -12997,8 +13417,8 @@ ${wranglerInstall.stderr.slice(-600)}`,
     ok: true
   };
   yield { message: "Prerequisites ready", ok: true };
-  const tmpRoot = await mkdtemp(join22(tmpdir3(), "kimiflare-commute-"));
-  const repoDir = join22(tmpRoot, "kimiflare-commute");
+  const tmpRoot = await mkdtemp(join23(tmpdir3(), "kimiflare-commute-"));
+  const repoDir = join23(tmpRoot, "kimiflare-commute");
   yield { message: `Fetching worker source from GitHub (${COMMUTE_REPO})\u2026` };
   const clone = await runCmd("git", ["clone", "--depth", "1", "--branch", COMMUTE_BRANCH, COMMUTE_REPO, repoDir], { timeoutMs: 6e4 });
   if (clone.code !== 0) {
@@ -13007,8 +13427,8 @@ ${(clone.stderr || clone.stdout).slice(0, 400)}`, error: true };
     throw new Error("clone failed");
   }
   yield { message: "Source fetched from GitHub", ok: true };
-  const workerDir = join22(repoDir, "remote", "worker");
-  const wranglerToml = join22(workerDir, "wrangler.toml");
+  const workerDir = join23(repoDir, "remote", "worker");
+  const wranglerToml = join23(workerDir, "wrangler.toml");
   yield { message: "Installing Worker dependencies (npm install)\u2026" };
   const install = await runCmd("npm", ["install", "--no-audit", "--no-fund", "--loglevel=error"], {
     cwd: workerDir,
@@ -13097,7 +13517,7 @@ ${(install.stderr || install.stdout).slice(-1200).trim()}`,
     ok: true
   };
   yield { message: "Patching wrangler.toml\u2026" };
-  let toml = await readFile13(wranglerToml, "utf8");
+  let toml = await readFile14(wranglerToml, "utf8");
   toml = toml.replace(/^name\s*=\s*"[^"]+"/m, `name = "${workerName}"`);
   toml = toml.replace(
     /(\[\[kv_namespaces\]\][\s\S]*?binding\s*=\s*"OAUTH_KV"[\s\S]*?id\s*=\s*")[^"]+(")/,
@@ -13352,6 +13772,7 @@ var init_builtins = __esm({
       { name: "checkpoints", description: "List checkpoints in current session", source: "builtin" },
       { name: "compact", description: "Summarize old turns to free context", source: "builtin" },
       { name: "clear", description: "Clear current conversation", source: "builtin" },
+      { name: "fresh", description: "Reset session and start fresh with the last plan", source: "builtin" },
       { name: "init", description: "Scan repo and write KIMI.md", source: "builtin" },
       { name: "remote", argHint: "<prompt>", description: "Run a remote session on Cloudflare", source: "builtin" },
       { name: "update", description: "Check for updates", source: "builtin" },
@@ -14624,8 +15045,8 @@ var init_frontmatter = __esm({
 });
 
 // src/skills/loader.ts
-import { readFile as readFile14, readdir as readdir5, stat as stat5 } from "fs/promises";
-import { join as join23, extname } from "path";
+import { readFile as readFile15, readdir as readdir6, stat as stat6 } from "fs/promises";
+import { join as join24, extname } from "path";
 function normalizeManifest(raw, filePath) {
   const name = typeof raw.name === "string" ? raw.name : "";
   const description = typeof raw.description === "string" ? raw.description : "";
@@ -14639,7 +15060,7 @@ function normalizeManifest(raw, filePath) {
   return { name, description, match, scope, priority, enabled };
 }
 async function loadSkillFile(filePath) {
-  const raw = await readFile14(filePath, "utf-8");
+  const raw = await readFile15(filePath, "utf-8");
   const parsed = parseFrontmatter(raw);
   const manifest = normalizeManifest(parsed.data, filePath);
   const body = parsed.content.trim();
@@ -14658,11 +15079,11 @@ async function loadSkillFile(filePath) {
 }
 async function loadSkillsFromDir(dirPath) {
   try {
-    const entries = await readdir5(dirPath);
+    const entries = await readdir6(dirPath);
     const files = [];
     for (const entry of entries) {
-      const full = join23(dirPath, entry);
-      const s = await stat5(full);
+      const full = join24(dirPath, entry);
+      const s = await stat6(full);
       if (s.isFile() && extname(entry) === ".md") {
         files.push(full);
       }
@@ -14689,12 +15110,12 @@ var init_loader = __esm({
 });
 
 // src/skills/manager.ts
-import { mkdir as mkdir10, writeFile as writeFile11, unlink as unlink2, readFile as readFile15 } from "fs/promises";
-import { join as join24 } from "path";
+import { mkdir as mkdir10, writeFile as writeFile11, unlink as unlink2, readFile as readFile16 } from "fs/promises";
+import { join as join25 } from "path";
 function getSkillDirs(cwd) {
   return {
-    projectDir: join24(cwd, ".kimiflare", "skills"),
-    globalDir: join24(process.env.HOME ?? "", ".config", "kimiflare", "skills")
+    projectDir: join25(cwd, ".kimiflare", "skills"),
+    globalDir: join25(process.env.HOME ?? "", ".config", "kimiflare", "skills")
   };
 }
 async function listAllSkills(cwd) {
@@ -14708,7 +15129,7 @@ async function listAllSkills(cwd) {
 async function createSkill(opts2) {
   const dirs = getSkillDirs(opts2.cwd);
   const dir = opts2.scope === "project" ? dirs.projectDir : dirs.globalDir;
-  const filepath = join24(dir, `${opts2.name}.md`);
+  const filepath = join25(dir, `${opts2.name}.md`);
   const frontmatter = {
     name: opts2.name,
     enabled: true,
@@ -14744,7 +15165,7 @@ async function setSkillEnabled(name, enabled, cwd) {
   const all = await listAllSkills(cwd);
   const skill = all.project.find((s) => s.name === name) ?? all.global.find((s) => s.name === name);
   if (!skill) throw new Error(`skill "${name}" not found`);
-  const raw = await readFile15(skill.filePath, "utf-8");
+  const raw = await readFile16(skill.filePath, "utf-8");
   const parsed = parseFrontmatter(raw);
   parsed.data.enabled = enabled;
   const yaml = Object.entries(parsed.data).map(([k, v]) => {
@@ -14829,13 +15250,13 @@ var init_frontmatter2 = __esm({
 // src/commands/loader.ts
 import { open, realpath as realpath2 } from "fs/promises";
 import { homedir as homedir14 } from "os";
-import { join as join25, relative as relative5, sep as sep2 } from "path";
+import { join as join26, relative as relative5, sep as sep2 } from "path";
 function projectCommandsDir(cwd = process.cwd()) {
-  return join25(cwd, ".kimiflare", "commands");
+  return join26(cwd, ".kimiflare", "commands");
 }
 function globalCommandsDir() {
-  const xdg = process.env.XDG_CONFIG_HOME || join25(homedir14(), ".config");
-  return join25(xdg, "kimiflare", "commands");
+  const xdg = process.env.XDG_CONFIG_HOME || join26(homedir14(), ".config");
+  return join26(xdg, "kimiflare", "commands");
 }
 async function loadCustomCommands(cwd = process.cwd()) {
   const warnings = [];
@@ -15110,12 +15531,12 @@ var init_worker_client = __esm({
 
 // src/init/context-generator.ts
 import { existsSync as existsSync4, statSync as statSync4 } from "fs";
-import { join as join26 } from "path";
+import { join as join27 } from "path";
 function detectFlavor(cwd) {
   for (const [flavor, signatures] of Object.entries(FLAVOR_SIGNATURES)) {
     if (flavor === "generic") continue;
     for (const sig of signatures) {
-      const path = join26(cwd, sig);
+      const path = join27(cwd, sig);
       if (sig.includes("*")) {
         try {
           const parts = sig.split("*");
@@ -15136,14 +15557,14 @@ function detectFlavor(cwd) {
 }
 function findFile(cwd, candidates) {
   for (const c of candidates) {
-    if (existsSync4(join26(cwd, c))) return c;
+    if (existsSync4(join27(cwd, c))) return c;
   }
   return null;
 }
 function findSourceRoots(cwd) {
   const roots = [];
   for (const r of SOURCE_ROOT_CANDIDATES) {
-    const p = join26(cwd, r);
+    const p = join27(cwd, r);
     try {
       const s = statSync4(p);
       if (s.isDirectory()) roots.push(r);
@@ -15154,9 +15575,9 @@ function findSourceRoots(cwd) {
 }
 function findCiConfig(cwd) {
   for (const c of CI_PATHS) {
-    if (existsSync4(join26(cwd, c))) {
+    if (existsSync4(join27(cwd, c))) {
       try {
-        const s = statSync4(join26(cwd, c));
+        const s = statSync4(join27(cwd, c));
         return s.isDirectory() ? c : c;
       } catch {
       }
@@ -15293,7 +15714,7 @@ function analyzeProject(cwd) {
     ciConfig: findCiConfig(cwd),
     readme: findFile(cwd, ["README.md", "README.rst", "README.txt", "Readme.md"]),
     sourceRoots: findSourceRoots(cwd),
-    hasGit: existsSync4(join26(cwd, ".git"))
+    hasGit: existsSync4(join27(cwd, ".git"))
   };
 }
 function bashDiscoveryCommands(profile) {
@@ -15458,7 +15879,7 @@ Aim for 100\u2013200 lines total. Use markdown tables where they save space.
 }
 function buildInitPrompt(cwd) {
   const existingName = ["KIMI.md", "KIMIFLARE.md", "AGENT.md"].find(
-    (n) => existsSync4(join26(cwd, n))
+    (n) => existsSync4(join27(cwd, n))
   );
   const isRefresh = existingName !== void 0;
   const targetFilename = existingName ?? "KIMI.md";
@@ -15548,8 +15969,8 @@ __export(ui_mode_exports, {
 });
 import { execSync as execSync3, spawn as spawn5 } from "child_process";
 import { appendFileSync, openSync } from "fs";
-import { readdir as readdir6 } from "fs/promises";
-import { join as join27, relative as relative6 } from "path";
+import { readdir as readdir7 } from "fs/promises";
+import { join as join28, relative as relative6 } from "path";
 import { platform as platform3 } from "os";
 function kimiLog(payload) {
   if (!KIMI_LOG_PATH) return;
@@ -16052,6 +16473,8 @@ Executor opened PR: ${prUrl}` : plan });
             if (!(err instanceof Error && err.name === "AbortError")) {
               cam.send("ShowToast", { text: `multi-agent spawn failed: ${err instanceof Error ? err.message : String(err)}`, kind: "error", ttl_ms: 4e3 });
             }
+          } finally {
+            multiAgentSupervisor.clearWorkers();
           }
           return;
         }
@@ -16245,8 +16668,8 @@ Executor opened PR: ${prUrl}` : plan });
               cam.send("PermissionGranted", { request_id: reqId });
               return "allow";
             }
-            const choice = await new Promise((resolve4) => {
-              pendingPermissions.set(reqId, resolve4);
+            const choice = await new Promise((resolve5) => {
+              pendingPermissions.set(reqId, resolve5);
             });
             cam.send(
               choice === "deny" ? "PermissionDenied" : "PermissionGranted",
@@ -16281,8 +16704,8 @@ Executor opened PR: ${prUrl}` : plan });
   async function nextFollowUp() {
     if (followUpQueue.length > 0) return followUpQueue.shift();
     if (aborted2) return null;
-    return new Promise((resolve4) => {
-      followUpResolver = resolve4;
+    return new Promise((resolve5) => {
+      followUpResolver = resolve5;
     });
   }
   async function openInboxModal() {
@@ -17489,14 +17912,14 @@ async function registerMentions(cam, recents) {
     if (depth > 3 || collected.length >= 200) return;
     let entries;
     try {
-      entries = await readdir6(dir, { withFileTypes: true });
+      entries = await readdir7(dir, { withFileTypes: true });
     } catch {
       return;
     }
     for (const e of entries) {
       if (collected.length >= 200) return;
       if (e.name.startsWith(".") || SKIP.has(e.name)) continue;
-      const full = join27(dir, e.name);
+      const full = join28(dir, e.name);
       if (e.isDirectory()) {
         await walk2(full, depth + 1);
       } else if (e.isFile()) {
@@ -17924,6 +18347,22 @@ var init_manager5 = __esm({
         }
         return out;
       }
+      /** Export a compact MCP context summary for multi-agent workers. */
+      exportContext() {
+        const servers = this.listServers();
+        if (servers.length === 0) return "";
+        const lines = ["Available MCP servers:"];
+        for (const s of servers) {
+          lines.push(`- ${s.name} (${s.type}, ${s.toolCount} tools)`);
+          const conn = this.connections.get(s.name);
+          if (conn) {
+            for (const entry of conn.tools.slice(0, 20)) {
+              lines.push(`  - ${entry.spec.name}: ${entry.spec.description.split("\n")[0]}`);
+            }
+          }
+        }
+        return lines.join("\n");
+      }
     };
   }
 });
@@ -20282,19 +20721,19 @@ function usePermissionController(getMode, onPlanModeBlocked) {
   const onPlanModeBlockedRef = useRef2(onPlanModeBlocked);
   onPlanModeBlockedRef.current = onPlanModeBlocked;
   const askPermission = useCallback2(
-    (req, askOpts) => new Promise((resolve4) => {
+    (req, askOpts) => new Promise((resolve5) => {
       const outcome = decidePermission(req, getModeRef.current(), askOpts);
       if (outcome.kind === "resolve") {
-        resolve4(outcome.decision);
+        resolve5(outcome.decision);
         return;
       }
       if (outcome.kind === "plan_blocked") {
         onPlanModeBlockedRef.current(outcome.toolName);
-        resolve4(AUTO_DENY);
+        resolve5(AUTO_DENY);
         return;
       }
-      resolveRef.current = resolve4;
-      setPending({ tool: req.tool, args: req.args, resolve: resolve4 });
+      resolveRef.current = resolve5;
+      setPending({ tool: req.tool, args: req.args, resolve: resolve5 });
     }),
     []
   );
@@ -20704,6 +21143,7 @@ function WorkerList({ workers, isSynthesizing, narration }) {
   const running = workers.filter((w) => w.status === "running").length;
   const completed = workers.filter((w) => w.status === "completed").length;
   const failed = workers.filter((w) => w.status === "failed").length;
+  const budgetExhausted = workers.filter((w) => w.status === "budget_exhausted").length;
   const pending = workers.filter((w) => w.status === "pending").length;
   const showSynthesis = isSynthesizing && running === 0;
   return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", marginBottom: 1, children: [
@@ -20716,8 +21156,24 @@ function WorkerList({ workers, isSynthesizing, narration }) {
       pending > 0 ? `${pending} todo \xB7 ` : "",
       running > 0 ? `${running} ongoing \xB7 ` : "",
       completed > 0 ? `${completed} done \xB7 ` : "",
+      budgetExhausted > 0 ? `${budgetExhausted} budget hit \xB7 ` : "",
       failed > 0 ? `${failed} failed \xB7 ` : ""
     ] }) }),
+    (() => {
+      const anyPreRead = workers.find((w) => w.preReadFiles && w.preReadFiles.length > 0);
+      if (!anyPreRead) return null;
+      const fileCount = anyPreRead.preReadFiles.length;
+      const chars = anyPreRead.preReadChars ?? 0;
+      return /* @__PURE__ */ jsx13(Box11, { marginLeft: 2, children: /* @__PURE__ */ jsxs11(Text12, { color: theme.info.color, children: [
+        "\u{1F4E6} Shared cache: ",
+        fileCount,
+        " file",
+        fileCount > 1 ? "s" : "",
+        " pre-read (~",
+        chars.toLocaleString(),
+        " chars)"
+      ] }) });
+    })(),
     workers.map((w) => /* @__PURE__ */ jsx13(WorkerRow, { worker: w }, w.id)),
     showSynthesis && /* @__PURE__ */ jsx13(Box11, { marginLeft: 2, children: /* @__PURE__ */ jsxs11(Text12, { color: theme.info.color, children: [
       /* @__PURE__ */ jsx13(Spinner5, { type: "dots" }),
@@ -20737,9 +21193,9 @@ function WorkerRow({ worker }) {
   }, [worker.status]);
   const elapsed = formatElapsed6(now2 - worker.startedAt);
   const modeLabel2 = worker.mode === "plan" ? "research" : "executor";
-  const statusIcon = worker.status === "pending" ? /* @__PURE__ */ jsx13(Text12, { color: theme.muted?.color ?? theme.info.color, children: "\u2610" }) : worker.status === "running" ? /* @__PURE__ */ jsx13(Text12, { color: theme.info.color, children: /* @__PURE__ */ jsx13(Spinner5, { type: "line" }) }) : worker.status === "completed" ? /* @__PURE__ */ jsx13(Text12, { color: theme.palette.success, children: "\u2611" }) : /* @__PURE__ */ jsx13(Text12, { color: theme.palette.error, children: "\u2612" });
-  const statusLabel = worker.status === "pending" ? "todo" : worker.status === "running" ? "ongoing" : worker.status === "completed" ? "done" : "failed";
-  const isDone = worker.status === "completed" || worker.status === "failed";
+  const statusIcon = worker.status === "pending" ? /* @__PURE__ */ jsx13(Text12, { color: theme.muted?.color ?? theme.info.color, children: "\u2610" }) : worker.status === "running" ? /* @__PURE__ */ jsx13(Text12, { color: theme.info.color, children: /* @__PURE__ */ jsx13(Spinner5, { type: "line" }) }) : worker.status === "completed" ? /* @__PURE__ */ jsx13(Text12, { color: theme.palette.success, children: "\u2611" }) : worker.status === "budget_exhausted" ? /* @__PURE__ */ jsx13(Text12, { color: theme.info.color, children: "\u26A0" }) : /* @__PURE__ */ jsx13(Text12, { color: theme.palette.error, children: "\u2612" });
+  const statusLabel = worker.status === "pending" ? "todo" : worker.status === "running" ? "ongoing" : worker.status === "completed" ? "done" : worker.status === "budget_exhausted" ? "budget hit" : "failed";
+  const isDone = worker.status === "completed" || worker.status === "failed" || worker.status === "budget_exhausted";
   const hasSteps = worker.steps && worker.steps.length > 0;
   return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", marginLeft: 2, children: [
     /* @__PURE__ */ jsx13(Box11, { children: /* @__PURE__ */ jsxs11(Text12, { children: [
@@ -20774,7 +21230,8 @@ function WorkerRow({ worker }) {
       ] }) : null
     ] }) }),
     hasSteps && /* @__PURE__ */ jsx13(Box11, { flexDirection: "column", marginLeft: 4, children: worker.steps.map((step, i) => /* @__PURE__ */ jsx13(StepRow, { step, theme }, `${worker.id}-step-${i}`)) }),
-    worker.logs.length > 0 && /* @__PURE__ */ jsx13(Box11, { flexDirection: "column", marginLeft: 4, children: worker.logs.slice(-3).map((line, i) => /* @__PURE__ */ jsx13(Text12, { color: theme.muted?.color ?? theme.info.color, dimColor: true, children: line.slice(0, 120) }, `${worker.id}-log-${i}`)) })
+    worker.logs.length > 0 && /* @__PURE__ */ jsx13(Box11, { flexDirection: "column", marginLeft: 4, children: worker.logs.slice(-3).map((line, i) => /* @__PURE__ */ jsx13(Text12, { color: theme.muted?.color ?? theme.info.color, dimColor: true, children: line.slice(0, 120) }, `${worker.id}-log-${i}`)) }),
+    isDone && worker.result?.phases && worker.result.phases.length > 0 && /* @__PURE__ */ jsx13(Box11, { marginLeft: 4, children: /* @__PURE__ */ jsx13(Text12, { color: theme.muted?.color ?? theme.info.color, dimColor: true, children: worker.result.phases.map((p) => `${p.name}: ${formatElapsed6(p.ms)}`).join(" \xB7 ") }) })
   ] });
 }
 function StepRow({ step, theme }) {
@@ -22214,10 +22671,10 @@ var init_welcome = __esm({
 });
 
 // src/util/image.ts
-import { readFile as readFile16 } from "fs/promises";
+import { readFile as readFile17 } from "fs/promises";
 import { basename as basename4 } from "path";
 async function encodeImageFile(filePath) {
-  const buf = await readFile16(filePath);
+  const buf = await readFile17(filePath);
   if (buf.byteLength > MAX_IMAGE_BYTES) {
     throw new Error(
       `image too large (${(buf.byteLength / 1024 / 1024).toFixed(1)} MB); max is ${MAX_IMAGE_BYTES / 1024 / 1024} MB`
@@ -22484,11 +22941,11 @@ var init_wcag = __esm({
 });
 
 // src/ui/theme-loader.ts
-import { readFile as readFile17, readdir as readdir7 } from "fs/promises";
-import { join as join28 } from "path";
+import { readFile as readFile18, readdir as readdir8 } from "fs/promises";
+import { join as join29 } from "path";
 import { homedir as homedir15 } from "os";
 function projectThemesDir(cwd = process.cwd()) {
-  return join28(cwd, ".kimiflare", "themes");
+  return join29(cwd, ".kimiflare", "themes");
 }
 function isHexColor(c) {
   return /^#[0-9a-fA-F]{6}$/.test(c);
@@ -22572,15 +23029,15 @@ async function loadThemesFromDir(dir, source) {
   const errors = [];
   let files;
   try {
-    files = await readdir7(dir);
+    files = await readdir8(dir);
   } catch {
     return { themes, errors };
   }
   for (const file of files.filter((f) => f.endsWith(".json"))) {
-    const path = join28(dir, file);
+    const path = join29(dir, file);
     let raw;
     try {
-      raw = await readFile17(path, "utf-8");
+      raw = await readFile18(path, "utf-8");
     } catch (e) {
       errors.push(`${path}: ${e instanceof Error ? e.message : String(e)}`);
       continue;
@@ -22726,8 +23183,8 @@ var init_theme_loader = __esm({
     "use strict";
     init_wcag();
     init_theme();
-    USER_THEMES_DIR = join28(
-      process.env.XDG_CONFIG_HOME || join28(homedir15(), ".config"),
+    USER_THEMES_DIR = join29(
+      process.env.XDG_CONFIG_HOME || join29(homedir15(), ".config"),
       "kimiflare",
       "themes"
     );
@@ -25127,7 +25584,7 @@ var init_inbox_modal = __esm({
 // src/ui/app-helpers.ts
 import { execSync as execSync4, spawn as spawn7 } from "child_process";
 import { existsSync as existsSync5, readFileSync as readFileSync4, statSync as statSync5 } from "fs";
-import { join as join29 } from "path";
+import { join as join30 } from "path";
 import { platform as platform5 } from "os";
 function buildFilePickerIgnoreList(cwd) {
   const hardcoded = [
@@ -25199,7 +25656,7 @@ function buildFilePickerIgnoreList(cwd) {
   ];
   const gitignorePatterns = [];
   try {
-    const gitignorePath = join29(cwd, ".gitignore");
+    const gitignorePath = join30(cwd, ".gitignore");
     const stats = statSync5(gitignorePath);
     if (stats.size > MAX_GITIGNORE_SIZE) {
       return hardcoded;
@@ -26534,7 +26991,8 @@ var init_help_menu = __esm({
         commands: [
           { command: "/resume", description: "pick a past conversation" },
           { command: "/compact", description: "summarize old turns to free context" },
-          { command: "/clear", description: "clear current conversation" }
+          { command: "/clear", description: "clear current conversation" },
+          { command: "/fresh", description: "reset session and start fresh with the last plan" }
         ]
       },
       {
@@ -27306,20 +27764,78 @@ var init_input_handlers = __esm({
   }
 });
 
+// src/agent/distill.ts
+function distillSessionPlan(messages) {
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const m = messages[i];
+    if (m?.role !== "assistant") continue;
+    let text = "";
+    if (typeof m.content === "string") {
+      text = m.content;
+    } else if (Array.isArray(m.content)) {
+      text = m.content.filter((p) => p.type === "text").map((p) => p.text).join("\n");
+    }
+    text = text.trim();
+    if (text.length > 20) {
+      return text;
+    }
+  }
+  return null;
+}
+var init_distill = __esm({
+  "src/agent/distill.ts"() {
+    "use strict";
+  }
+});
+
+// src/util/clipboard.ts
+import { execSync as execSync5 } from "child_process";
+import { platform as platform7 } from "os";
+function writeToClipboard(text) {
+  const os2 = platform7();
+  try {
+    if (os2 === "darwin") {
+      execSync5("pbcopy", { input: text, timeout: 5e3 });
+      return { success: true, message: "Copied to clipboard" };
+    }
+    if (os2 === "win32") {
+      execSync5("clip", { input: text, timeout: 5e3 });
+      return { success: true, message: "Copied to clipboard" };
+    }
+    try {
+      execSync5("xclip -selection clipboard", { input: text, timeout: 5e3 });
+      return { success: true, message: "Copied to clipboard" };
+    } catch {
+      execSync5("xsel --clipboard --input", { input: text, timeout: 5e3 });
+      return { success: true, message: "Copied to clipboard" };
+    }
+  } catch {
+    return {
+      success: false,
+      message: "Clipboard not available \u2014 plan will be shown below"
+    };
+  }
+}
+var init_clipboard = __esm({
+  "src/util/clipboard.ts"() {
+    "use strict";
+  }
+});
+
 // src/cost-attribution/tui-report.ts
 var tui_report_exports = {};
 __export(tui_report_exports, {
   getCategoryReportText: () => getCategoryReportText
 });
-import { readFile as readFile18 } from "fs/promises";
-import { join as join30 } from "path";
+import { readFile as readFile19 } from "fs/promises";
+import { join as join31 } from "path";
 import { homedir as homedir16 } from "os";
 function usageDir3() {
-  const xdg = process.env.XDG_DATA_HOME || join30(homedir16(), ".local", "share");
-  return join30(xdg, "kimiflare");
+  const xdg = process.env.XDG_DATA_HOME || join31(homedir16(), ".local", "share");
+  return join31(xdg, "kimiflare");
 }
 function usagePath3() {
-  return join30(usageDir3(), "usage.json");
+  return join31(usageDir3(), "usage.json");
 }
 function today3() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
@@ -27331,7 +27847,7 @@ function daysAgo2(n) {
 }
 async function loadLog3() {
   try {
-    const raw = await readFile18(usagePath3(), "utf8");
+    const raw = await readFile19(usagePath3(), "utf8");
     return JSON.parse(raw);
   } catch {
     return { version: 1, days: [], sessions: [] };
@@ -27388,7 +27904,7 @@ var init_tui_report = __esm({
 });
 
 // src/ui/slash-commands.ts
-import { join as join31 } from "path";
+import { join as join32 } from "path";
 import { unlink as unlink4 } from "fs/promises";
 import QRCode from "qrcode";
 function dispatchSlashCommand(ctx, cmd) {
@@ -27400,7 +27916,7 @@ function dispatchSlashCommand(ctx, cmd) {
   if (!handler) return false;
   return handler(ctx, rest, arg);
 }
-var handleExit, handleClear, handleReasoning, handleCost, handleShell, handleModel, handleGateway, handleMode, handleMultiAgent, handleTheme, handleUi, handlePlan, handleAuto, handleEdit, handleSkills, handleMemory, handleResume, handleCheckpoint, handleCompact, handleInit, handleUpdate, handleMcp, handleLsp, handleHooks, handleHello, handleInbox, handleLogout, handleCommand, handleRemote, handleHelp, handlers;
+var handleExit, handleClear, handleFresh, handleReasoning, handleCost, handleShell, handleModel, handleGateway, handleMode, handleMultiAgent, handleTheme, handleUi, handlePlan, handleAuto, handleEdit, handleSkills, handleMemory, handleResume, handleCheckpoint, handleCompact, handleInit, handleUpdate, handleMcp, handleLsp, handleHooks, handleHello, handleInbox, handleLogout, handleCommand, handleRemote, handleHelp, handlers;
 var init_slash_commands = __esm({
   "src/ui/slash-commands.ts"() {
     "use strict";
@@ -27424,6 +27940,8 @@ var init_slash_commands = __esm({
     init_session_store();
     init_deploy();
     init_tui_auth();
+    init_distill();
+    init_clipboard();
     handleExit = (ctx) => {
       void ctx.lspManagerRef.current.stopAll().finally(() => ctx.exit());
       return true;
@@ -27463,6 +27981,65 @@ var init_slash_commands = __esm({
       ctx.updateNudgedRef.current = false;
       return true;
     };
+    handleFresh = (ctx) => {
+      const { busy, mkKey: mkKey2, setEvents } = ctx;
+      if (busy) {
+        setEvents((e) => [
+          ...e,
+          { kind: "info", key: mkKey2(), text: "can't /fresh while model is running \u2014 press Esc to interrupt first" }
+        ]);
+        return true;
+      }
+      const plan = distillSessionPlan(ctx.messagesRef.current);
+      if (!plan) {
+        setEvents((e) => [
+          ...e,
+          { kind: "error", key: mkKey2(), text: "No plan found to start fresh with." }
+        ]);
+        return true;
+      }
+      const clipResult = writeToClipboard(plan);
+      if (ctx.cacheStableRef.current && ctx.messagesRef.current.length >= 2) {
+        ctx.messagesRef.current = [ctx.messagesRef.current[0], ctx.messagesRef.current[1]];
+      } else {
+        ctx.messagesRef.current = [ctx.messagesRef.current[0]];
+      }
+      ctx.resetSession();
+      ctx.executorRef.current.clearArtifacts();
+      if (ctx.flushTimeoutRef.current) {
+        clearTimeout(ctx.flushTimeoutRef.current);
+        ctx.flushTimeoutRef.current = null;
+      }
+      ctx.pendingTextRef.current.clear();
+      ctx.activeAsstIdRef.current = null;
+      ctx.pendingToolCallsRef.current.clear();
+      ctx.usageRef.current = null;
+      ctx.turnCounterRef.current = 0;
+      setEvents([]);
+      ctx.setUsage(null);
+      ctx.setSessionUsage(null);
+      ctx.gatewayMetaRef.current = null;
+      ctx.setGatewayMeta(null);
+      ctx.clearTaskTracking();
+      ctx.compactSuggestedRef.current = false;
+      ctx.updateNudgedRef.current = false;
+      ctx.messagesRef.current.push({ role: "user", content: plan });
+      setEvents((e) => [
+        ...e,
+        {
+          kind: "info",
+          key: mkKey2(),
+          text: clipResult.success ? "Plan copied to clipboard. Starting fresh session with plan only\u2026" : "Clipboard unavailable. Starting fresh session with plan only\u2026"
+        }
+      ]);
+      if (!clipResult.success) {
+        setEvents((e) => [
+          ...e,
+          { kind: "info", key: mkKey2(), text: "--- Plan ---\n" + plan }
+        ]);
+      }
+      return true;
+    };
     handleReasoning = (ctx) => {
       ctx.setShowReasoning((s) => {
         const next = !s;
@@ -27762,14 +28339,24 @@ var init_slash_commands = __esm({
       return true;
     };
     handleMode = (ctx, _rest, arg) => {
-      const { setEvents, mkKey: mkKey2 } = ctx;
+      const { setEvents, mkKey: mkKey2, mode } = ctx;
       if (!arg) {
         ctx.setShowModePicker(true);
         return true;
       }
       if (arg === "edit" || arg === "plan" || arg === "auto" || arg === "multi-agent-experimental") {
+        const prevMode = mode;
         ctx.setMode(arg);
         setEvents((e) => [...e, { kind: "info", key: mkKey2(), text: `mode: ${arg}` }]);
+        if (prevMode === "plan" && (arg === "auto" || arg === "edit")) {
+          const nonSystemCount = ctx.messagesRef.current.filter((m) => m.role !== "system").length;
+          if (nonSystemCount > 10) {
+            setEvents((e) => [
+              ...e,
+              { kind: "info", key: mkKey2(), text: "Tip: you have extensive planning context. Run `/fresh` to start clean with just the plan." }
+            ]);
+          }
+        }
         return true;
       }
       setEvents((e) => [...e, { kind: "info", key: mkKey2(), text: "usage: /mode edit|plan|auto|multi-agent-experimental" }]);
@@ -28119,7 +28706,7 @@ ${lines.join("\n")}` }]);
         void (async () => {
           try {
             const { sessionsDir: sessionsDir3 } = await Promise.resolve().then(() => (init_sessions(), sessions_exports));
-            const file = await loadSession(join31(sessionsDir3(), `${currentId}.json`));
+            const file = await loadSession(join32(sessionsDir3(), `${currentId}.json`));
             const cps = file.checkpoints ?? [];
             if (cps.length === 0) {
               setEvents((e) => [...e, { kind: "info", key: mkKey2(), text: "no checkpoints in this session" }]);
@@ -28164,7 +28751,7 @@ ${lines.join("\n")}` }]);
         try {
           ctx.ensureSessionId();
           const { sessionsDir: sessionsDir3 } = await Promise.resolve().then(() => (init_sessions(), sessions_exports));
-          const filePath = join31(sessionsDir3(), `${ctx.sessionIdRef.current}.json`);
+          const filePath = join32(sessionsDir3(), `${ctx.sessionIdRef.current}.json`);
           await addCheckpoint(filePath, cp);
           setEvents((e) => [...e, { kind: "info", key: mkKey2(), text: `checkpoint saved: "${label}"` }]);
         } catch (e) {
@@ -28635,6 +29222,7 @@ project: ${projectSettingsPath(cwd)}`
     handlers = {
       "/exit": handleExit,
       "/clear": handleClear,
+      "/fresh": handleFresh,
       "/reasoning": handleReasoning,
       "/cost": handleCost,
       "/shell": handleShell,
@@ -28669,7 +29257,7 @@ project: ${projectSettingsPath(cwd)}`
 
 // src/init/run-init.ts
 import { existsSync as existsSync6 } from "fs";
-import { join as join32 } from "path";
+import { join as join33 } from "path";
 async function runInit(deps) {
   const {
     cfg,
@@ -28766,7 +29354,7 @@ async function runInit(deps) {
           lspManagerRef.current.notifyChange(path, content);
         } else {
           void import("fs/promises").then(
-            ({ readFile: readFile21 }) => readFile21(path, "utf8").then((c) => lspManagerRef.current.notifyChange(path, c)).catch(() => {
+            ({ readFile: readFile22 }) => readFile22(path, "utf8").then((c) => lspManagerRef.current.notifyChange(path, c)).catch(() => {
             })
           );
         }
@@ -28852,9 +29440,9 @@ async function runInit(deps) {
         },
         onGatewayMeta: updateGatewayMeta,
         askPermission: (req) => askForPermission(req, { promptOnBlockedBash: true }),
-        onLoopDetected: () => new Promise((resolve4) => {
-          loopResolveRef.current = resolve4;
-          setLoopModal({ resolve: resolve4 });
+        onLoopDetected: () => new Promise((resolve5) => {
+          loopResolveRef.current = resolve5;
+          setLoopModal({ resolve: resolve5 });
         }),
         onKimiMdStale: () => {
           if (!kimiMdStaleNudgedRef.current) {
@@ -28872,7 +29460,7 @@ async function runInit(deps) {
         }
       }
     });
-    if (existsSync6(join32(cwd, "KIMI.md"))) {
+    if (existsSync6(join33(cwd, "KIMI.md"))) {
       if (cacheStableRef.current) {
         messagesRef.current[1] = {
           role: "system",
@@ -28966,11 +29554,11 @@ var init_run_init = __esm({
 });
 
 // src/skills/discovery.ts
-import { readdir as readdir8, stat as stat6, readFile as readFile19 } from "fs/promises";
-import { join as join33, extname as extname2 } from "path";
+import { readdir as readdir9, stat as stat7, readFile as readFile20 } from "fs/promises";
+import { join as join34, extname as extname2 } from "path";
 async function dirExists(path) {
   try {
-    const s = await stat6(path);
+    const s = await stat7(path);
     return s.isDirectory();
   } catch {
     return false;
@@ -28978,7 +29566,7 @@ async function dirExists(path) {
 }
 async function fileExists(path) {
   try {
-    const s = await stat6(path);
+    const s = await stat7(path);
     return s.isFile();
   } catch {
     return false;
@@ -28986,25 +29574,25 @@ async function fileExists(path) {
 }
 async function scanSkillDir(dirPath, source) {
   if (!await dirExists(dirPath)) return [];
-  const entries = await readdir8(dirPath, { withFileTypes: true });
+  const entries = await readdir9(dirPath, { withFileTypes: true });
   const files = [];
   for (const entry of entries) {
     if (!entry.isFile()) continue;
     if (!SKILL_EXTENSIONS.has(extname2(entry.name))) continue;
-    files.push({ filePath: join33(dirPath, entry.name), source });
+    files.push({ filePath: join34(dirPath, entry.name), source });
   }
   return files;
 }
 async function discoverSkills(cwd) {
-  const agentsSkills = await scanSkillDir(join33(cwd, ".agents", "skills"), "agents");
-  const agentsMd = await fileExists(join33(cwd, "AGENTS.md")) ? [{ filePath: join33(cwd, "AGENTS.md"), source: "agents-md" }] : [];
-  const githubSkills = await scanSkillDir(join33(cwd, ".github", "skills"), "github");
-  const kimiflareSkills = await scanSkillDir(join33(cwd, ".kimiflare", "skills"), "kimiflare");
+  const agentsSkills = await scanSkillDir(join34(cwd, ".agents", "skills"), "agents");
+  const agentsMd = await fileExists(join34(cwd, "AGENTS.md")) ? [{ filePath: join34(cwd, "AGENTS.md"), source: "agents-md" }] : [];
+  const githubSkills = await scanSkillDir(join34(cwd, ".github", "skills"), "github");
+  const kimiflareSkills = await scanSkillDir(join34(cwd, ".kimiflare", "skills"), "kimiflare");
   const ordered = [...agentsSkills, ...agentsMd, ...githubSkills, ...kimiflareSkills];
   return ordered;
 }
 async function readSkillFile(filePath) {
-  const bytes = await readFile19(filePath);
+  const bytes = await readFile20(filePath);
   return { bytes, text: bytes.toString("utf-8") };
 }
 var SKILL_EXTENSIONS;
@@ -29016,9 +29604,9 @@ var init_discovery = __esm({
 });
 
 // src/skills/parser.ts
-import { createHash as createHash2 } from "crypto";
+import { createHash as createHash3 } from "crypto";
 function sha256(input) {
-  return createHash2("sha256").update(input).digest("hex");
+  return createHash3("sha256").update(input).digest("hex");
 }
 function computeContentHash(rawText, parserVersion) {
   return sha256(`${rawText}
@@ -29209,16 +29797,16 @@ var init_skills = __esm({
 });
 
 // src/util/state.ts
-import { readFile as readFile20, writeFile as writeFile13, mkdir as mkdir12 } from "fs/promises";
+import { readFile as readFile21, writeFile as writeFile13, mkdir as mkdir12 } from "fs/promises";
 import { homedir as homedir17 } from "os";
-import { join as join34 } from "path";
+import { join as join35 } from "path";
 function statePath() {
-  const xdg = process.env.XDG_CONFIG_HOME || join34(homedir17(), ".config");
-  return join34(xdg, "kimiflare", "state.json");
+  const xdg = process.env.XDG_CONFIG_HOME || join35(homedir17(), ".config");
+  return join35(xdg, "kimiflare", "state.json");
 }
 async function readState() {
   try {
-    const raw = await readFile20(statePath(), "utf8");
+    const raw = await readFile21(statePath(), "utf8");
     return JSON.parse(raw);
   } catch {
     return {};
@@ -29226,7 +29814,7 @@ async function readState() {
 }
 async function writeState(state) {
   const path = statePath();
-  await mkdir12(join34(path, ".."), { recursive: true });
+  await mkdir12(join35(path, ".."), { recursive: true });
   await writeFile13(path, JSON.stringify(state, null, 2) + "\n", "utf8");
 }
 async function markCreatorMessageSeen(version) {
@@ -29246,7 +29834,7 @@ var init_state = __esm({
 
 // src/ui/run-startup-tasks.ts
 import { existsSync as existsSync7 } from "fs";
-import { join as join35 } from "path";
+import { join as join36 } from "path";
 function runStartupTasks(deps) {
   const {
     cfg,
@@ -29297,7 +29885,7 @@ function runStartupTasks(deps) {
     }
   });
   if (cfg.memoryEnabled) {
-    const dbPath = cfg.memoryDbPath ?? join35(process.cwd(), ".kimiflare", "memory.db");
+    const dbPath = cfg.memoryDbPath ?? join36(process.cwd(), ".kimiflare", "memory.db");
     const manager = new MemoryManager({
       dbPath,
       accountId: cfg.accountId,
@@ -29331,7 +29919,7 @@ function runStartupTasks(deps) {
     });
     const cwd = process.cwd();
     sessionStartRecallRef.current = manager.recall({ text: cwd, repoPath: cwd, limit: 5 });
-    if (existsSync7(join35(cwd, "KIMI.md"))) {
+    if (existsSync7(join36(cwd, "KIMI.md"))) {
       const lastRefresh = manager.getLastKimiMdRefreshTime(cwd);
       const driftCount = manager.countHighSignalMemoriesSince(cwd, lastRefresh);
       if (driftCount >= 5) {
@@ -29342,7 +29930,7 @@ function runStartupTasks(deps) {
     memoryManagerRef.current?.close();
     memoryManagerRef.current = null;
   }
-  const skillDbPath = cfg.memoryDbPath ?? join35(process.cwd(), ".kimiflare", "memory.db");
+  const skillDbPath = cfg.memoryDbPath ?? join36(process.cwd(), ".kimiflare", "memory.db");
   const skillDb = getMemoryDb() ?? openMemoryDb(skillDbPath);
   initSkillsSchema(skillDb);
   void indexSkills({
@@ -29811,7 +30399,7 @@ __export(app_exports, {
 import React23, { useState as useState27, useRef as useRef7, useEffect as useEffect11, useCallback as useCallback10, useMemo as useMemo6 } from "react";
 import { Box as Box39, Text as Text40, useApp, useInput as useInput19, render } from "ink";
 import { existsSync as existsSync8 } from "fs";
-import { join as join36 } from "path";
+import { join as join37 } from "path";
 import { jsx as jsx41, jsxs as jsxs39 } from "react/jsx-runtime";
 function App({
   initialCfg,
@@ -31124,7 +31712,7 @@ ${wcagWarnings.join("\n")}` }
         }
       }
       turnCounterRef.current += 1;
-      if (turnCounterRef.current % 15 === 0 && existsSync8(join36(process.cwd(), "KIMI.md")) && !kimiMdStale) {
+      if (turnCounterRef.current % 15 === 0 && existsSync8(join37(process.cwd(), "KIMI.md")) && !kimiMdStale) {
         setEvents((e) => [
           ...e,
           { kind: "info", key: mkKey(), text: "Tip: Rerunning /init occasionally helps KimiFlare stay accurate as your project evolves." }
@@ -31164,6 +31752,9 @@ ${wcagWarnings.join("\n")}` }
           const controller = new AbortController();
           multiAgentAbortRef.current = controller;
           try {
+            supervisorRef.current.memoryManager = memoryManagerRef.current;
+            supervisorRef.current.lspManager = lspManagerRef.current;
+            supervisorRef.current.mcpManager = mcpManagerRef.current;
             const { plan, conflicts, recommendations, prUrl, executor } = await supervisorRef.current.autoSpawnWorkers(
               trimmed,
               `Current project: ${process.cwd()}`,
@@ -31190,6 +31781,8 @@ ${wcagWarnings.join("\n")}` }
               }
             ]);
             messagesRef.current.push({ role: "assistant", content: plan });
+            setActiveWorkers([]);
+            supervisorRef.current.clearWorkers();
             if (conflicts.length > 0) {
               setEvents((e) => [
                 ...e,
@@ -31225,6 +31818,8 @@ ${conflicts.join("\n")}` }
                 { kind: "error", key: mkKey(), text: `multi-agent spawn failed: ${err.message}` }
               ]);
             }
+            setActiveWorkers([]);
+            supervisorRef.current.clearWorkers();
             endTurn();
             return;
           } finally {
@@ -31334,13 +31929,13 @@ ${conflicts.join("\n")}` }
           }
         },
         askPermission: askForPermission,
-        onToolLimitReached: () => new Promise((resolve4) => {
-          limitResolveRef.current = resolve4;
-          setLimitModal({ limit: 50, resolve: resolve4 });
+        onToolLimitReached: () => new Promise((resolve5) => {
+          limitResolveRef.current = resolve5;
+          setLimitModal({ limit: 50, resolve: resolve5 });
         }),
-        onLoopDetected: () => new Promise((resolve4) => {
-          loopResolveRef.current = resolve4;
-          setLoopModal({ resolve: resolve4 });
+        onLoopDetected: () => new Promise((resolve5) => {
+          loopResolveRef.current = resolve5;
+          setLoopModal({ resolve: resolve5 });
         }),
         onKimiMdStale: () => {
           if (!kimiMdStaleNudgedRef.current) {
@@ -31440,7 +32035,7 @@ ${conflicts.join("\n")}` }
               lspManagerRef.current.notifyChange(path, content2);
             } else {
               void import("fs/promises").then(
-                ({ readFile: readFile21 }) => readFile21(path, "utf8").then((c) => lspManagerRef.current.notifyChange(path, c)).catch(() => {
+                ({ readFile: readFile22 }) => readFile22(path, "utf8").then((c) => lspManagerRef.current.notifyChange(path, c)).catch(() => {
                 })
               );
             }
@@ -31687,7 +32282,7 @@ ${conflicts.join("\n")}` }
         onCommandDelete: handleCommandDelete2,
         lspServers: cfg?.lspServers ?? {},
         lspScope,
-        hasProjectDir: existsSync8(join36(process.cwd(), ".kimiflare")),
+        hasProjectDir: existsSync8(join37(process.cwd(), ".kimiflare")),
         onLspSave: handleLspSave2,
         themes: themeList(),
         onPickTheme: handleThemePick,