clawmux 0.3.4 → 0.3.6

package/README.md

@@ -138,8 +138,8 @@ Tests are co-located with source files as `*.test.ts`.
 
 ## Uninstall
 
+Fetch the uninstallation guide and follow it:
+
 ```bash
-clawmux uninstall
+curl -fsSL https://raw.githubusercontent.com/HyeokjaeLee/ClawMux/refs/heads/main/docs/guide/uninstallation.md
 ```
-
-Stops the system service, removes the service file, and removes the `clawmux` provider from your OpenClaw config. A backup is created before any changes.

package/dist/cli.cjs

@@ -3313,39 +3313,155 @@ function createSessionStore(maxSessions = 500) {
   };
 }
 
-// src/compression/worker.ts
-var SUMMARY_PREFIX = "[Summary of previous conversation]";
-function messageContentToString2(content) {
+// src/compression/prompt.ts
+var MAX_MESSAGE_CHARS = 2000;
+var SUMMARY_TEMPLATE = `## Goal
+[What the user is trying to accomplish]
+
+## Constraints & Preferences
+- [User's stated requirements and preferences, or "(none)"]
+
+## Progress
+### Done
+- [x] [Completed items]
+
+### In Progress
+- [ ] [Current work]
+
+### Blocked
+- [Issues preventing progress, if any]
+
+## Key Decisions
+- **[Decision]**: [Brief rationale]
+
+## Next Steps
+1. [Ordered list of what should happen next]
+
+## Critical Context
+- [Any data, examples, or references needed to continue, or "(none)"]`;
+var REQUIRED_SUMMARY_SECTIONS = [
+  "## Goal",
+  "## Constraints & Preferences",
+  "## Progress",
+  "## Key Decisions",
+  "## Next Steps",
+  "## Critical Context"
+];
+var SYSTEM_PROMPT = "You are a context summarization assistant. Your task is to read a conversation between a user and an AI assistant, " + `then produce a structured summary following the exact format specified.
+
+` + "Do NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.";
+var IDENTIFIER_INSTRUCTIONS = "Preserve all opaque identifiers exactly as written (no shortening or reconstruction), " + "including UUIDs, hashes, IDs, tokens, hostnames, IPs, ports, URLs, and file paths.";
+var LANGUAGE_INSTRUCTIONS = "Write the summary body in the primary language used in the conversation. " + "Keep the required summary structure and section headers unchanged. " + "Do not translate or alter code, file paths, identifiers, or error messages.";
+var INITIAL_SUMMARIZATION_INSTRUCTIONS = `Compress the conversation above into a structured summary that another AI assistant will use to continue the work.
+Preserve: file paths, tool call names/results, error messages, URLs.
+Skip: base64 images, thinking blocks, redundant greetings.
+
+${IDENTIFIER_INSTRUCTIONS}
+${LANGUAGE_INSTRUCTIONS}
+
+Use this EXACT format:
+
+${SUMMARY_TEMPLATE}`;
+var UPDATE_SUMMARIZATION_INSTRUCTIONS = `The messages above are NEW conversation messages to incorporate into the existing summary provided in <previous-summary> tags.
+
+Update the existing structured summary with new information. RULES:
+- PRESERVE all existing information from the previous summary
+- ADD new progress, decisions, and context from the new messages
+- UPDATE the Progress section: move items from "In Progress" to "Done" when completed
+- UPDATE "Next Steps" based on what was accomplished
+- PRESERVE exact file paths, function names, and error messages
+- If something is no longer relevant, you may remove it
+
+${IDENTIFIER_INSTRUCTIONS}
+${LANGUAGE_INSTRUCTIONS}
+
+Use this EXACT format:
+
+${SUMMARY_TEMPLATE}`;
+function isContentBlockArray(content) {
+  return Array.isArray(content) && content.length > 0 && typeof content[0] === "object" && content[0] !== null && "type" in content[0];
+}
+function extractTextFromBlock(block) {
+  if (block.type === "thinking")
+    return "[thinking]";
+  if (block.type === "image" || block.type === "image_url")
+    return "[image]";
+  if (block.type === "text" && block.text !== undefined)
+    return block.text;
+  if (block.type === "tool_result")
+    return extractToolResultText(block);
+  if (block.type === "tool_use")
+    return `[tool: ${String(block.name ?? block.type)}]`;
+  return "";
+}
+function extractToolResultText(block) {
+  const { content } = block;
   if (typeof content === "string")
     return content;
   if (Array.isArray(content)) {
-    return content.filter((block) => block.type === "text" && typeof block.text === "string").map((block) => block.text).join(`
-`);
+    return content.filter((sub) => sub.type === "text" && sub.text !== undefined).map((sub) => sub.text).join(" ");
   }
-  return JSON.stringify(content);
+  return "";
 }
-function estimateMessageTokens(msg) {
-  const MESSAGE_OVERHEAD2 = 4;
-  return MESSAGE_OVERHEAD2 + estimateTokens(messageContentToString2(msg.content));
+function extractContentText(content) {
+  if (typeof content === "string")
+    return content;
+  if (isContentBlockArray(content)) {
+    return content.map(extractTextFromBlock).filter(Boolean).join(" ");
+  }
+  return String(content);
+}
+function truncate(text) {
+  if (text.length <= MAX_MESSAGE_CHARS)
+    return text;
+  return text.slice(0, MAX_MESSAGE_CHARS) + "... [truncated]";
+}
+function messagesToText(messages) {
+  if (messages.length === 0)
+    return "";
+  return messages.map((msg) => {
+    const label = msg.role === "user" ? "[User]" : msg.role === "assistant" ? "[Assistant]" : `[${msg.role}]`;
+    const text = truncate(extractContentText(msg.content));
+    return `${label}: ${text}`;
+  }).join(`
+`) + `
+`;
 }
-function buildCompressionPrompt(messages, targetTokens) {
-  const conversationText = messages.map((m) => `${m.role}: ${messageContentToString2(m.content)}`).join(`
-
-`);
+function buildCompressionPrompt(messages, targetTokens, previousSummary) {
+  const conversationText = messagesToText(messages);
+  const parts = [
+    `<conversation>`,
+    conversationText.trimEnd(),
+    `</conversation>`,
+    ``,
+    `Target approximately ${targetTokens} tokens.`,
+    ``
+  ];
+  if (previousSummary) {
+    parts.push(`<previous-summary>`, previousSummary, `</previous-summary>`, ``);
+    parts.push(UPDATE_SUMMARIZATION_INSTRUCTIONS);
+  } else {
+    parts.push(INITIAL_SUMMARIZATION_INSTRUCTIONS);
+  }
   return [
-    {
-      role: "system",
-      content: [
-        "You are a conversation summarizer. Produce a concise summary of the conversation below.",
-        `Target length: approximately ${targetTokens} tokens.`,
-        "Preserve: key decisions, code snippets, technical details, and action items.",
-        "Format: plain text paragraphs. Start with the most important context."
-      ].join(`
-`)
-    },
+    { role: "system", content: SYSTEM_PROMPT },
+    { role: "user", content: parts.join(`
+`) }
+  ];
+}
+function validateSummary(summary) {
+  const missingSections = REQUIRED_SUMMARY_SECTIONS.filter((section) => !summary.includes(section));
+  return { valid: missingSections.length === 0, missingSections };
+}
+function buildQualityFeedbackPrompt(summary, missingSections) {
+  return [
+    { role: "assistant", content: summary },
     {
       role: "user",
-      content: conversationText
+      content: `The summary is missing required sections: ${missingSections.join(", ")}.
+` + `Please regenerate the summary including ALL required sections with this EXACT format:
+
+` + SUMMARY_TEMPLATE
     }
   ];
 }
@@ -3353,7 +3469,7 @@ function buildCompressedMessages(summary) {
   return [
     {
       role: "user",
-      content: `${SUMMARY_PREFIX}
+      content: `[Summary of previous conversation]
 ${summary}`
     },
     {
@@ -3362,6 +3478,46 @@ ${summary}`
     }
   ];
 }
+
+// src/compression/worker.ts
+var MAX_RETRIES = 3;
+var MAX_QUALITY_RETRIES = 3;
+var BASE_RETRY_DELAY_MS = 500;
+var MAX_RETRY_DELAY_MS = 5000;
+function retryDelayMs(attempt) {
+  const jitter = Math.random() * 500;
+  return Math.min(BASE_RETRY_DELAY_MS * 2 ** attempt + jitter, MAX_RETRY_DELAY_MS);
+}
+async function withRetry(fn, maxRetries) {
+  let lastError = new Error("unknown");
+  for (let attempt = 0;attempt < maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err instanceof Error ? err : new Error(String(err));
+      if (lastError.message === "compression_timeout")
+        throw lastError;
+      if (attempt < maxRetries - 1) {
+        await new Promise((r) => setTimeout(r, retryDelayMs(attempt)));
+      }
+    }
+  }
+  throw lastError;
+}
+var SUMMARY_PREFIX = "[Summary of previous conversation]";
+function messageContentToString2(content) {
+  if (typeof content === "string")
+    return content;
+  if (Array.isArray(content)) {
+    return content.filter((block) => block.type === "text" && typeof block.text === "string").map((block) => block.text).join(`
+`);
+  }
+  return JSON.stringify(content);
+}
+function estimateMessageTokens(msg) {
+  const MESSAGE_OVERHEAD2 = 4;
+  return MESSAGE_OVERHEAD2 + estimateTokens(messageContentToString2(msg.content));
+}
 function truncateToFit(messages, targetTokens) {
   const result = [];
   let usedTokens = 0;
@@ -3393,6 +3549,21 @@ function createCompressionWorker(config) {
     const thresholdTokens = config.threshold * config.contextWindow;
     return session.tokenCount >= thresholdTokens && session.compressionState === "idle";
   }
+  async function summarizeWithQualityGuard(messages, targetTokens, previousSummary, makeApiCall) {
+    const initialPrompt = buildCompressionPrompt(messages, targetTokens, previousSummary);
+    let summaryText = await makeApiCall(config.compressionModel, initialPrompt);
+    for (let attempt = 0;attempt < MAX_QUALITY_RETRIES - 1; attempt++) {
+      const { valid, missingSections } = validateSummary(summaryText);
+      if (valid)
+        break;
+      const feedbackMessages = [
+        ...initialPrompt,
+        ...buildQualityFeedbackPrompt(summaryText, missingSections)
+      ];
+      summaryText = await makeApiCall(config.compressionModel, feedbackMessages);
+    }
+    return summaryText;
+  }
   function triggerCompression(session, sessionStore, makeApiCall) {
     if (activeJobs >= config.maxConcurrent)
       return;
@@ -3404,11 +3575,11 @@ function createCompressionWorker(config) {
     });
     activeJobs++;
     const targetTokens = config.targetRatio * config.contextWindow;
-    const promptMessages = buildCompressionPrompt(session.messages, targetTokens);
     const sessionId = session.id;
     const originalMessages = [...session.messages];
+    const previousSummary = session.compressedSummary;
     const jobPromise = Promise.race([
-      makeApiCall(config.compressionModel, promptMessages),
+      withRetry(() => summarizeWithQualityGuard(originalMessages, targetTokens, previousSummary, makeApiCall), MAX_RETRIES),
       new Promise((_resolve, reject) => {
         setTimeout(() => reject(new Error("compression_timeout")), config.timeoutMs);
       })
@@ -3545,7 +3716,7 @@ function createCompressionMiddleware(config) {
     compressionModel: config.compressionModel,
     contextWindow,
     maxConcurrent: 2,
-    timeoutMs: 60000
+    timeoutMs: 900000
   });
   function beforeForward(parsed, adapter) {
     const messages = parsed.messages;
@@ -3778,7 +3949,10 @@ async function handleApiRequest(req, body, apiType, config, openclawConfig, auth
     const message = err instanceof Error ? err.message : String(err);
     return jsonErrorResponse(`Upstream request failed: ${message}`, 502);
   }
-  console.log(`[clawmux] [llm] ${decision.tier} → ${decision.model} | conf=${classification.confidence.toFixed(2)}${classification.reasoning ? ` | ${classification.reasoning}` : ""}`);
+  const lastUserMsg = [...parsed.messages].reverse().find((m) => m.role === "user");
+  const msgText = typeof lastUserMsg?.content === "string" ? lastUserMsg.content : Array.isArray(lastUserMsg?.content) ? lastUserMsg.content.filter((b) => b.type === "text").map((b) => b.text ?? "").join(" ") : "";
+  const preview = msgText.replace(/\s+/g, " ").trim().slice(0, 100);
+  console.log(`[clawmux] [llm] ${decision.tier} → ${decision.model} | conf=${classification.confidence.toFixed(2)}${classification.reasoning ? ` | ${classification.reasoning}` : ""}${preview ? ` | "${preview}${msgText.length > 100 ? "…" : ""}"` : ""}`);
   if (compressionMiddleware && upstreamResponse.ok) {
     compressionMiddleware.afterResponse(parsed, adapter, baseUrl, authInfo);
   }
@@ -3942,7 +4116,7 @@ function getLogDir() {
 }
 
 // src/cli.ts
-var VERSION2 = process.env.npm_package_version ?? "0.3.4";
+var VERSION2 = process.env.npm_package_version ?? "0.3.6";
 var SERVICE_NAME = "clawmux";
 var HELP = `Usage: clawmux <command>
 
@@ -3983,23 +4157,30 @@ async function fileExistsLocal(path) {
     return false;
   }
 }
-function detectPackageManager() {
+function detectInstallMethod() {
+  try {
+    const bin = import_node_child_process.execSync("which clawmux", { encoding: "utf-8" }).trim();
+    if (bin.includes(".bun/"))
+      return "bun";
+    if (bin.includes(".npm/") || bin.includes("lib/node_modules/"))
+      return "npm";
+  } catch {}
   try {
     import_node_child_process.execSync("which bun", { stdio: "pipe" });
-    return "bunx";
+    return "bun";
   } catch {
-    return "npx";
+    return "npm";
   }
 }
 function resolveClawmuxBin() {
   try {
     const bin = import_node_child_process.execSync("which clawmux", { encoding: "utf-8" }).trim();
     if (bin.includes("/tmp/") || bin.includes("bunx-") || bin.includes("npx-")) {
-      return detectPackageManager() === "bunx" ? "bunx clawmux" : "npx clawmux";
+      return detectInstallMethod() === "bun" ? "bunx clawmux" : "npx clawmux";
     }
     return bin;
   } catch {
-    return detectPackageManager() === "bunx" ? "bunx clawmux" : "npx clawmux";
+    return detectInstallMethod() === "bun" ? "bunx clawmux" : "npx clawmux";
   }
 }
 function getHomeDir3() {
@@ -4182,7 +4363,7 @@ async function checkForUpdate() {
   } catch (_) {}
 }
 async function update() {
-  const pm = detectPackageManager();
+  const pm = detectInstallMethod();
   console.log(`[clawmux] Checking for updates...`);
   try {
     const res = await fetch("https://registry.npmjs.org/clawmux/latest", {
@@ -4203,7 +4384,7 @@ async function update() {
       return;
     }
     console.log(`[clawmux] Updating ${VERSION2} → ${latest}...`);
-    if (pm === "bunx") {
+    if (pm === "bun") {
       import_node_child_process.execSync("bun pm cache rm clawmux 2>/dev/null; bunx clawmux@latest version", { stdio: "inherit" });
     } else {
       import_node_child_process.execSync("npx clawmux@latest version", { stdio: "inherit" });
@@ -4359,7 +4540,21 @@ async function uninstall() {
       console.log(`[info] Removed ${removed} ClawMux provider(s) from openclaw.json`);
     }
   }
+  const clawmuxDir = import_node_path5.join(homeDir, ".openclaw", "clawmux");
+  if (await fileExistsLocal(clawmuxDir)) {
+    const { rm } = await import("node:fs/promises");
+    await rm(clawmuxDir, { recursive: true, force: true });
+    console.log("[info] Removed ~/.openclaw/clawmux (config and logs)");
+  }
   console.log("[info] ClawMux uninstalled");
+  const pm = detectInstallMethod();
+  console.log(`
+To remove the clawmux command, run:`);
+  if (pm === "bun") {
+    console.log("  bun remove -g clawmux");
+  } else {
+    console.log("  npm uninstall -g clawmux");
+  }
 }
 var command = process.argv[2];
 switch (command) {

package/dist/index.cjs

@@ -3336,39 +3336,155 @@ function createSessionStore(maxSessions = 500) {
   };
 }
 
-// src/compression/worker.ts
-var SUMMARY_PREFIX = "[Summary of previous conversation]";
-function messageContentToString2(content) {
+// src/compression/prompt.ts
+var MAX_MESSAGE_CHARS = 2000;
+var SUMMARY_TEMPLATE = `## Goal
+[What the user is trying to accomplish]
+
+## Constraints & Preferences
+- [User's stated requirements and preferences, or "(none)"]
+
+## Progress
+### Done
+- [x] [Completed items]
+
+### In Progress
+- [ ] [Current work]
+
+### Blocked
+- [Issues preventing progress, if any]
+
+## Key Decisions
+- **[Decision]**: [Brief rationale]
+
+## Next Steps
+1. [Ordered list of what should happen next]
+
+## Critical Context
+- [Any data, examples, or references needed to continue, or "(none)"]`;
+var REQUIRED_SUMMARY_SECTIONS = [
+  "## Goal",
+  "## Constraints & Preferences",
+  "## Progress",
+  "## Key Decisions",
+  "## Next Steps",
+  "## Critical Context"
+];
+var SYSTEM_PROMPT = "You are a context summarization assistant. Your task is to read a conversation between a user and an AI assistant, " + `then produce a structured summary following the exact format specified.
+
+` + "Do NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.";
+var IDENTIFIER_INSTRUCTIONS = "Preserve all opaque identifiers exactly as written (no shortening or reconstruction), " + "including UUIDs, hashes, IDs, tokens, hostnames, IPs, ports, URLs, and file paths.";
+var LANGUAGE_INSTRUCTIONS = "Write the summary body in the primary language used in the conversation. " + "Keep the required summary structure and section headers unchanged. " + "Do not translate or alter code, file paths, identifiers, or error messages.";
+var INITIAL_SUMMARIZATION_INSTRUCTIONS = `Compress the conversation above into a structured summary that another AI assistant will use to continue the work.
+Preserve: file paths, tool call names/results, error messages, URLs.
+Skip: base64 images, thinking blocks, redundant greetings.
+
+${IDENTIFIER_INSTRUCTIONS}
+${LANGUAGE_INSTRUCTIONS}
+
+Use this EXACT format:
+
+${SUMMARY_TEMPLATE}`;
+var UPDATE_SUMMARIZATION_INSTRUCTIONS = `The messages above are NEW conversation messages to incorporate into the existing summary provided in <previous-summary> tags.
+
+Update the existing structured summary with new information. RULES:
+- PRESERVE all existing information from the previous summary
+- ADD new progress, decisions, and context from the new messages
+- UPDATE the Progress section: move items from "In Progress" to "Done" when completed
+- UPDATE "Next Steps" based on what was accomplished
+- PRESERVE exact file paths, function names, and error messages
+- If something is no longer relevant, you may remove it
+
+${IDENTIFIER_INSTRUCTIONS}
+${LANGUAGE_INSTRUCTIONS}
+
+Use this EXACT format:
+
+${SUMMARY_TEMPLATE}`;
+function isContentBlockArray(content) {
+  return Array.isArray(content) && content.length > 0 && typeof content[0] === "object" && content[0] !== null && "type" in content[0];
+}
+function extractTextFromBlock(block) {
+  if (block.type === "thinking")
+    return "[thinking]";
+  if (block.type === "image" || block.type === "image_url")
+    return "[image]";
+  if (block.type === "text" && block.text !== undefined)
+    return block.text;
+  if (block.type === "tool_result")
+    return extractToolResultText(block);
+  if (block.type === "tool_use")
+    return `[tool: ${String(block.name ?? block.type)}]`;
+  return "";
+}
+function extractToolResultText(block) {
+  const { content } = block;
   if (typeof content === "string")
     return content;
   if (Array.isArray(content)) {
-    return content.filter((block) => block.type === "text" && typeof block.text === "string").map((block) => block.text).join(`
-`);
+    return content.filter((sub) => sub.type === "text" && sub.text !== undefined).map((sub) => sub.text).join(" ");
   }
-  return JSON.stringify(content);
+  return "";
 }
-function estimateMessageTokens(msg) {
-  const MESSAGE_OVERHEAD2 = 4;
-  return MESSAGE_OVERHEAD2 + estimateTokens(messageContentToString2(msg.content));
+function extractContentText(content) {
+  if (typeof content === "string")
+    return content;
+  if (isContentBlockArray(content)) {
+    return content.map(extractTextFromBlock).filter(Boolean).join(" ");
+  }
+  return String(content);
+}
+function truncate(text) {
+  if (text.length <= MAX_MESSAGE_CHARS)
+    return text;
+  return text.slice(0, MAX_MESSAGE_CHARS) + "... [truncated]";
+}
+function messagesToText(messages) {
+  if (messages.length === 0)
+    return "";
+  return messages.map((msg) => {
+    const label = msg.role === "user" ? "[User]" : msg.role === "assistant" ? "[Assistant]" : `[${msg.role}]`;
+    const text = truncate(extractContentText(msg.content));
+    return `${label}: ${text}`;
+  }).join(`
+`) + `
+`;
 }
-function buildCompressionPrompt(messages, targetTokens) {
-  const conversationText = messages.map((m) => `${m.role}: ${messageContentToString2(m.content)}`).join(`
-
-`);
+function buildCompressionPrompt(messages, targetTokens, previousSummary) {
+  const conversationText = messagesToText(messages);
+  const parts = [
+    `<conversation>`,
+    conversationText.trimEnd(),
+    `</conversation>`,
+    ``,
+    `Target approximately ${targetTokens} tokens.`,
+    ``
+  ];
+  if (previousSummary) {
+    parts.push(`<previous-summary>`, previousSummary, `</previous-summary>`, ``);
+    parts.push(UPDATE_SUMMARIZATION_INSTRUCTIONS);
+  } else {
+    parts.push(INITIAL_SUMMARIZATION_INSTRUCTIONS);
+  }
   return [
-    {
-      role: "system",
-      content: [
-        "You are a conversation summarizer. Produce a concise summary of the conversation below.",
-        `Target length: approximately ${targetTokens} tokens.`,
-        "Preserve: key decisions, code snippets, technical details, and action items.",
-        "Format: plain text paragraphs. Start with the most important context."
-      ].join(`
-`)
-    },
+    { role: "system", content: SYSTEM_PROMPT },
+    { role: "user", content: parts.join(`
+`) }
+  ];
+}
+function validateSummary(summary) {
+  const missingSections = REQUIRED_SUMMARY_SECTIONS.filter((section) => !summary.includes(section));
+  return { valid: missingSections.length === 0, missingSections };
+}
+function buildQualityFeedbackPrompt(summary, missingSections) {
+  return [
+    { role: "assistant", content: summary },
     {
       role: "user",
-      content: conversationText
+      content: `The summary is missing required sections: ${missingSections.join(", ")}.
+` + `Please regenerate the summary including ALL required sections with this EXACT format:
+
+` + SUMMARY_TEMPLATE
     }
   ];
 }
@@ -3376,7 +3492,7 @@ function buildCompressedMessages(summary) {
   return [
     {
       role: "user",
-      content: `${SUMMARY_PREFIX}
+      content: `[Summary of previous conversation]
 ${summary}`
     },
     {
@@ -3385,6 +3501,46 @@ ${summary}`
     }
   ];
 }
+
+// src/compression/worker.ts
+var MAX_RETRIES = 3;
+var MAX_QUALITY_RETRIES = 3;
+var BASE_RETRY_DELAY_MS = 500;
+var MAX_RETRY_DELAY_MS = 5000;
+function retryDelayMs(attempt) {
+  const jitter = Math.random() * 500;
+  return Math.min(BASE_RETRY_DELAY_MS * 2 ** attempt + jitter, MAX_RETRY_DELAY_MS);
+}
+async function withRetry(fn, maxRetries) {
+  let lastError = new Error("unknown");
+  for (let attempt = 0;attempt < maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err instanceof Error ? err : new Error(String(err));
+      if (lastError.message === "compression_timeout")
+        throw lastError;
+      if (attempt < maxRetries - 1) {
+        await new Promise((r) => setTimeout(r, retryDelayMs(attempt)));
+      }
+    }
+  }
+  throw lastError;
+}
+var SUMMARY_PREFIX = "[Summary of previous conversation]";
+function messageContentToString2(content) {
+  if (typeof content === "string")
+    return content;
+  if (Array.isArray(content)) {
+    return content.filter((block) => block.type === "text" && typeof block.text === "string").map((block) => block.text).join(`
+`);
+  }
+  return JSON.stringify(content);
+}
+function estimateMessageTokens(msg) {
+  const MESSAGE_OVERHEAD2 = 4;
+  return MESSAGE_OVERHEAD2 + estimateTokens(messageContentToString2(msg.content));
+}
 function truncateToFit(messages, targetTokens) {
   const result = [];
   let usedTokens = 0;
@@ -3416,6 +3572,21 @@ function createCompressionWorker(config) {
     const thresholdTokens = config.threshold * config.contextWindow;
     return session.tokenCount >= thresholdTokens && session.compressionState === "idle";
   }
+  async function summarizeWithQualityGuard(messages, targetTokens, previousSummary, makeApiCall) {
+    const initialPrompt = buildCompressionPrompt(messages, targetTokens, previousSummary);
+    let summaryText = await makeApiCall(config.compressionModel, initialPrompt);
+    for (let attempt = 0;attempt < MAX_QUALITY_RETRIES - 1; attempt++) {
+      const { valid, missingSections } = validateSummary(summaryText);
+      if (valid)
+        break;
+      const feedbackMessages = [
+        ...initialPrompt,
+        ...buildQualityFeedbackPrompt(summaryText, missingSections)
+      ];
+      summaryText = await makeApiCall(config.compressionModel, feedbackMessages);
+    }
+    return summaryText;
+  }
   function triggerCompression(session, sessionStore, makeApiCall) {
     if (activeJobs >= config.maxConcurrent)
       return;
@@ -3427,11 +3598,11 @@ function createCompressionWorker(config) {
     });
     activeJobs++;
     const targetTokens = config.targetRatio * config.contextWindow;
-    const promptMessages = buildCompressionPrompt(session.messages, targetTokens);
     const sessionId = session.id;
     const originalMessages = [...session.messages];
+    const previousSummary = session.compressedSummary;
     const jobPromise = Promise.race([
-      makeApiCall(config.compressionModel, promptMessages),
+      withRetry(() => summarizeWithQualityGuard(originalMessages, targetTokens, previousSummary, makeApiCall), MAX_RETRIES),
       new Promise((_resolve, reject) => {
         setTimeout(() => reject(new Error("compression_timeout")), config.timeoutMs);
       })
@@ -3568,7 +3739,7 @@ function createCompressionMiddleware(config) {
     compressionModel: config.compressionModel,
     contextWindow,
     maxConcurrent: 2,
-    timeoutMs: 60000
+    timeoutMs: 900000
   });
   function beforeForward(parsed, adapter) {
     const messages = parsed.messages;
@@ -3801,7 +3972,10 @@ async function handleApiRequest(req, body, apiType, config, openclawConfig, auth
     const message = err instanceof Error ? err.message : String(err);
     return jsonErrorResponse(`Upstream request failed: ${message}`, 502);
   }
-  console.log(`[clawmux] [llm] ${decision.tier} → ${decision.model} | conf=${classification.confidence.toFixed(2)}${classification.reasoning ? ` | ${classification.reasoning}` : ""}`);
+  const lastUserMsg = [...parsed.messages].reverse().find((m) => m.role === "user");
+  const msgText = typeof lastUserMsg?.content === "string" ? lastUserMsg.content : Array.isArray(lastUserMsg?.content) ? lastUserMsg.content.filter((b) => b.type === "text").map((b) => b.text ?? "").join(" ") : "";
+  const preview = msgText.replace(/\s+/g, " ").trim().slice(0, 100);
+  console.log(`[clawmux] [llm] ${decision.tier} → ${decision.model} | conf=${classification.confidence.toFixed(2)}${classification.reasoning ? ` | ${classification.reasoning}` : ""}${preview ? ` | "${preview}${msgText.length > 100 ? "…" : ""}"` : ""}`);
   if (compressionMiddleware && upstreamResponse.ok) {
     compressionMiddleware.afterResponse(parsed, adapter, baseUrl, authInfo);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawmux",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Smart model routing + context compression proxy for OpenClaw",
   "type": "module",
   "bin": {