@rdmind/rdmind 0.0.21-alpha.1 → 0.0.21

package/cli.js

@@ -183747,7 +183747,7 @@ function createContentGeneratorConfig(config, authType, generationConfig) {
   };
 }
 async function createContentGenerator(config, gcConfig, sessionId2) {
-  const version2 = "0.0.21-alpha.1";
+  const version2 = "0.0.21";
   const userAgent2 = `QwenCode/${version2} (${process.platform}; ${process.arch})`;
   const baseHeaders = {
     "User-Agent": userAgent2
@@ -200491,6 +200491,506 @@ ${[...this.pendingCitations].sort().join("\n")}`
   }
 });
 
+// packages/core/src/config/constants.ts
+var DEFAULT_MEMORY_FILE_FILTERING_OPTIONS, DEFAULT_FILE_FILTERING_OPTIONS;
+var init_constants3 = __esm({
+  "packages/core/src/config/constants.ts"() {
+    "use strict";
+    init_esbuild_shims();
+    DEFAULT_MEMORY_FILE_FILTERING_OPTIONS = {
+      respectGitIgnore: false,
+      respectQwenIgnore: true
+    };
+    DEFAULT_FILE_FILTERING_OPTIONS = {
+      respectGitIgnore: true,
+      respectQwenIgnore: true
+    };
+  }
+});
+
+// packages/core/src/utils/getFolderStructure.ts
+import * as fs24 from "node:fs/promises";
+import * as path21 from "node:path";
+async function readFullStructure(rootPath, options2) {
+  const rootName = path21.basename(rootPath);
+  const rootNode = {
+    name: rootName,
+    path: rootPath,
+    files: [],
+    subFolders: [],
+    totalChildren: 0,
+    totalFiles: 0
+  };
+  const queue = [
+    { folderInfo: rootNode, currentPath: rootPath }
+  ];
+  let currentItemCount = 0;
+  const processedPaths = /* @__PURE__ */ new Set();
+  while (queue.length > 0) {
+    const { folderInfo, currentPath } = queue.shift();
+    if (processedPaths.has(currentPath)) {
+      continue;
+    }
+    processedPaths.add(currentPath);
+    if (currentItemCount >= options2.maxItems) {
+      continue;
+    }
+    let entries;
+    try {
+      const rawEntries = await fs24.readdir(currentPath, { withFileTypes: true });
+      entries = rawEntries.sort((a, b) => a.name.localeCompare(b.name));
+    } catch (error) {
+      if (isNodeError(error) && (error.code === "EACCES" || error.code === "ENOENT")) {
+        console.warn(
+          `Warning: Could not read directory ${currentPath}: ${error.message}`
+        );
+        if (currentPath === rootPath && error.code === "ENOENT") {
+          return null;
+        }
+        continue;
+      }
+      throw error;
+    }
+    const filesInCurrentDir = [];
+    const subFoldersInCurrentDir = [];
+    for (const entry of entries) {
+      if (entry.isFile()) {
+        if (currentItemCount >= options2.maxItems) {
+          folderInfo.hasMoreFiles = true;
+          break;
+        }
+        const fileName = entry.name;
+        const filePath = path21.join(currentPath, fileName);
+        if (options2.fileService) {
+          const shouldIgnore = options2.fileFilteringOptions.respectGitIgnore && options2.fileService.shouldGitIgnoreFile(filePath) || options2.fileFilteringOptions.respectQwenIgnore && options2.fileService.shouldQwenIgnoreFile(filePath);
+          if (shouldIgnore) {
+            continue;
+          }
+        }
+        if (!options2.fileIncludePattern || options2.fileIncludePattern.test(fileName)) {
+          filesInCurrentDir.push(fileName);
+          currentItemCount++;
+          folderInfo.totalFiles++;
+          folderInfo.totalChildren++;
+        }
+      }
+    }
+    folderInfo.files = filesInCurrentDir;
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        if (currentItemCount >= options2.maxItems) {
+          folderInfo.hasMoreSubfolders = true;
+          break;
+        }
+        const subFolderName = entry.name;
+        const subFolderPath = path21.join(currentPath, subFolderName);
+        let isIgnored = false;
+        if (options2.fileService) {
+          isIgnored = options2.fileFilteringOptions.respectGitIgnore && options2.fileService.shouldGitIgnoreFile(subFolderPath) || options2.fileFilteringOptions.respectQwenIgnore && options2.fileService.shouldQwenIgnoreFile(subFolderPath);
+        }
+        if (options2.ignoredFolders.has(subFolderName) || isIgnored) {
+          const ignoredSubFolder = {
+            name: subFolderName,
+            path: subFolderPath,
+            files: [],
+            subFolders: [],
+            totalChildren: 0,
+            totalFiles: 0,
+            isIgnored: true
+          };
+          subFoldersInCurrentDir.push(ignoredSubFolder);
+          currentItemCount++;
+          folderInfo.totalChildren++;
+          continue;
+        }
+        const subFolderNode = {
+          name: subFolderName,
+          path: subFolderPath,
+          files: [],
+          subFolders: [],
+          totalChildren: 0,
+          totalFiles: 0
+        };
+        subFoldersInCurrentDir.push(subFolderNode);
+        currentItemCount++;
+        folderInfo.totalChildren++;
+        queue.push({ folderInfo: subFolderNode, currentPath: subFolderPath });
+      }
+    }
+    folderInfo.subFolders = subFoldersInCurrentDir;
+  }
+  return rootNode;
+}
+function formatStructure(node, currentIndent, isLastChildOfParent, isProcessingRootNode, builder) {
+  const connector = isLastChildOfParent ? "\u2514\u2500\u2500\u2500" : "\u251C\u2500\u2500\u2500";
+  if (!isProcessingRootNode || node.isIgnored) {
+    builder.push(
+      `${currentIndent}${connector}${node.name}${path21.sep}${node.isIgnored ? TRUNCATION_INDICATOR : ""}`
+    );
+  }
+  const indentForChildren = isProcessingRootNode ? "" : currentIndent + (isLastChildOfParent ? "    " : "\u2502   ");
+  const fileCount = node.files.length;
+  for (let i = 0; i < fileCount; i++) {
+    const isLastFileAmongSiblings = i === fileCount - 1 && node.subFolders.length === 0 && !node.hasMoreSubfolders;
+    const fileConnector = isLastFileAmongSiblings ? "\u2514\u2500\u2500\u2500" : "\u251C\u2500\u2500\u2500";
+    builder.push(`${indentForChildren}${fileConnector}${node.files[i]}`);
+  }
+  if (node.hasMoreFiles) {
+    const isLastIndicatorAmongSiblings = node.subFolders.length === 0 && !node.hasMoreSubfolders;
+    const fileConnector = isLastIndicatorAmongSiblings ? "\u2514\u2500\u2500\u2500" : "\u251C\u2500\u2500\u2500";
+    builder.push(`${indentForChildren}${fileConnector}${TRUNCATION_INDICATOR}`);
+  }
+  const subFolderCount = node.subFolders.length;
+  for (let i = 0; i < subFolderCount; i++) {
+    const isLastSubfolderAmongSiblings = i === subFolderCount - 1 && !node.hasMoreSubfolders;
+    formatStructure(
+      node.subFolders[i],
+      indentForChildren,
+      isLastSubfolderAmongSiblings,
+      false,
+      builder
+    );
+  }
+  if (node.hasMoreSubfolders) {
+    builder.push(`${indentForChildren}\u2514\u2500\u2500\u2500${TRUNCATION_INDICATOR}`);
+  }
+}
+async function getFolderStructure(directory, options2) {
+  const resolvedPath = path21.resolve(directory);
+  const mergedOptions = {
+    maxItems: options2?.maxItems ?? MAX_ITEMS,
+    ignoredFolders: options2?.ignoredFolders ?? DEFAULT_IGNORED_FOLDERS,
+    fileIncludePattern: options2?.fileIncludePattern,
+    fileService: options2?.fileService,
+    fileFilteringOptions: options2?.fileFilteringOptions ?? DEFAULT_FILE_FILTERING_OPTIONS
+  };
+  try {
+    let isTruncated2 = function(node) {
+      if (node.hasMoreFiles || node.hasMoreSubfolders || node.isIgnored) {
+        return true;
+      }
+      for (const sub of node.subFolders) {
+        if (isTruncated2(sub)) {
+          return true;
+        }
+      }
+      return false;
+    };
+    var isTruncated = isTruncated2;
+    __name(isTruncated2, "isTruncated");
+    const structureRoot = await readFullStructure(resolvedPath, mergedOptions);
+    if (!structureRoot) {
+      return `Error: Could not read directory "${resolvedPath}". Check path and permissions.`;
+    }
+    const structureLines = [];
+    formatStructure(structureRoot, "", true, true, structureLines);
+    let summary = `Showing up to ${mergedOptions.maxItems} items (files + folders).`;
+    if (isTruncated2(structureRoot)) {
+      summary += ` Folders or files indicated with ${TRUNCATION_INDICATOR} contain more items not shown, were ignored, or the display limit (${mergedOptions.maxItems} items) was reached.`;
+    }
+    return `${summary}
+
+${resolvedPath}${path21.sep}
+${structureLines.join("\n")}`;
+  } catch (error) {
+    console.error(`Error getting folder structure for ${resolvedPath}:`, error);
+    return `Error processing directory "${resolvedPath}": ${getErrorMessage(error)}`;
+  }
+}
+var MAX_ITEMS, TRUNCATION_INDICATOR, DEFAULT_IGNORED_FOLDERS;
+var init_getFolderStructure = __esm({
+  "packages/core/src/utils/getFolderStructure.ts"() {
+    "use strict";
+    init_esbuild_shims();
+    init_errors();
+    init_constants3();
+    MAX_ITEMS = 20;
+    TRUNCATION_INDICATOR = "...";
+    DEFAULT_IGNORED_FOLDERS = /* @__PURE__ */ new Set(["node_modules", ".git", "dist"]);
+    __name(readFullStructure, "readFullStructure");
+    __name(formatStructure, "formatStructure");
+    __name(getFolderStructure, "getFolderStructure");
+  }
+});
+
+// packages/core/src/utils/environmentContext.ts
+async function getDirectoryContextString(config) {
+  const workspaceContext = config.getWorkspaceContext();
+  const workspaceDirectories = workspaceContext.getDirectories();
+  const folderStructures = await Promise.all(
+    workspaceDirectories.map(
+      (dir) => getFolderStructure(dir, {
+        fileService: config.getFileService()
+      })
+    )
+  );
+  const folderStructure = folderStructures.join("\n");
+  let workingDirPreamble;
+  if (workspaceDirectories.length === 1) {
+    workingDirPreamble = `I'm currently working in the directory: ${workspaceDirectories[0]}`;
+  } else {
+    const dirList = workspaceDirectories.map((dir) => `  - ${dir}`).join("\n");
+    workingDirPreamble = `I'm currently working in the following directories:
+${dirList}`;
+  }
+  return `${workingDirPreamble}
+Here is the folder structure of the current working directories:
+
+${folderStructure}`;
+}
+async function getEnvironmentContext(config) {
+  const today = (/* @__PURE__ */ new Date()).toLocaleDateString(void 0, {
+    weekday: "long",
+    year: "numeric",
+    month: "long",
+    day: "numeric"
+  });
+  const platform14 = process.platform;
+  const directoryContext = await getDirectoryContextString(config);
+  const context2 = `
+This is the RDMind. We are setting up the context for our chat.
+Today's date is ${today} (formatted according to the user's locale).
+My operating system is: ${platform14}
+${directoryContext}
+        `.trim();
+  const initialParts = [{ text: context2 }];
+  const toolRegistry = config.getToolRegistry();
+  if (config.getFullContext()) {
+    try {
+      const readManyFilesTool = toolRegistry.getTool("read_many_files");
+      if (readManyFilesTool) {
+        const invocation = readManyFilesTool.build({
+          paths: ["**/*"],
+          // Read everything recursively
+          useDefaultExcludes: true
+          // Use default excludes
+        });
+        const result = await invocation.execute(AbortSignal.timeout(3e4));
+        if (result.llmContent) {
+          initialParts.push({
+            text: `
+--- Full File Context ---
+${result.llmContent}`
+          });
+        } else {
+          console.warn(
+            "Full context requested, but read_many_files returned no content."
+          );
+        }
+      } else {
+        console.warn(
+          "Full context requested, but read_many_files tool not found."
+        );
+      }
+    } catch (error) {
+      console.error("Error reading full file context:", error);
+      initialParts.push({
+        text: "\n--- Error reading full file context ---"
+      });
+    }
+  }
+  return initialParts;
+}
+async function getInitialChatHistory(config, extraHistory) {
+  const envParts = await getEnvironmentContext(config);
+  const envContextString = envParts.map((part) => part.text || "").join("\n\n");
+  return [
+    {
+      role: "user",
+      parts: [{ text: envContextString }]
+    },
+    {
+      role: "model",
+      parts: [{ text: "Got it. Thanks for the context!" }]
+    },
+    ...extraHistory ?? []
+  ];
+}
+var init_environmentContext = __esm({
+  "packages/core/src/utils/environmentContext.ts"() {
+    "use strict";
+    init_esbuild_shims();
+    init_getFolderStructure();
+    __name(getDirectoryContextString, "getDirectoryContextString");
+    __name(getEnvironmentContext, "getEnvironmentContext");
+    __name(getInitialChatHistory, "getInitialChatHistory");
+  }
+});
+
+// packages/core/src/services/chatCompressionService.ts
+function findCompressSplitPoint(contents, fraction) {
+  if (fraction <= 0 || fraction >= 1) {
+    throw new Error("Fraction must be between 0 and 1");
+  }
+  const charCounts = contents.map((content) => JSON.stringify(content).length);
+  const totalCharCount = charCounts.reduce((a, b) => a + b, 0);
+  const targetCharCount = totalCharCount * fraction;
+  let lastSplitPoint = 0;
+  let cumulativeCharCount = 0;
+  for (let i = 0; i < contents.length; i++) {
+    const content = contents[i];
+    if (content.role === "user" && !content.parts?.some((part) => !!part.functionResponse)) {
+      if (cumulativeCharCount >= targetCharCount) {
+        return i;
+      }
+      lastSplitPoint = i;
+    }
+    cumulativeCharCount += charCounts[i];
+  }
+  const lastContent = contents[contents.length - 1];
+  if (lastContent?.role === "model" && !lastContent?.parts?.some((part) => part.functionCall)) {
+    return contents.length;
+  }
+  return lastSplitPoint;
+}
+var COMPRESSION_TOKEN_THRESHOLD, COMPRESSION_PRESERVE_THRESHOLD, ChatCompressionService;
+var init_chatCompressionService = __esm({
+  "packages/core/src/services/chatCompressionService.ts"() {
+    "use strict";
+    init_esbuild_shims();
+    init_turn();
+    init_uiTelemetry();
+    init_tokenLimits();
+    init_prompts();
+    init_partUtils();
+    init_loggers();
+    init_types3();
+    init_environmentContext();
+    COMPRESSION_TOKEN_THRESHOLD = 0.7;
+    COMPRESSION_PRESERVE_THRESHOLD = 0.3;
+    __name(findCompressSplitPoint, "findCompressSplitPoint");
+    ChatCompressionService = class {
+      static {
+        __name(this, "ChatCompressionService");
+      }
+      async compress(chat, promptId, force, model, config, hasFailedCompressionAttempt) {
+        const curatedHistory = chat.getHistory(true);
+        if (curatedHistory.length === 0 || hasFailedCompressionAttempt && !force) {
+          return {
+            newHistory: null,
+            info: {
+              originalTokenCount: 0,
+              newTokenCount: 0,
+              compressionStatus: 5 /* NOOP */
+            }
+          };
+        }
+        const originalTokenCount = uiTelemetryService.getLastPromptTokenCount();
+        const contextPercentageThreshold = config.getChatCompression()?.contextPercentageThreshold;
+        if (!force) {
+          const threshold = contextPercentageThreshold ?? COMPRESSION_TOKEN_THRESHOLD;
+          if (originalTokenCount < threshold * tokenLimit(model)) {
+            return {
+              newHistory: null,
+              info: {
+                originalTokenCount,
+                newTokenCount: originalTokenCount,
+                compressionStatus: 5 /* NOOP */
+              }
+            };
+          }
+        }
+        const splitPoint = findCompressSplitPoint(
+          curatedHistory,
+          1 - COMPRESSION_PRESERVE_THRESHOLD
+        );
+        const historyToCompress = curatedHistory.slice(0, splitPoint);
+        const historyToKeep = curatedHistory.slice(splitPoint);
+        if (historyToCompress.length === 0) {
+          return {
+            newHistory: null,
+            info: {
+              originalTokenCount,
+              newTokenCount: originalTokenCount,
+              compressionStatus: 5 /* NOOP */
+            }
+          };
+        }
+        const summaryResponse = await config.getContentGenerator().generateContent(
+          {
+            model,
+            contents: [
+              ...historyToCompress,
+              {
+                role: "user",
+                parts: [
+                  {
+                    text: "First, reason in your scratchpad. Then, generate the <state_snapshot>."
+                  }
+                ]
+              }
+            ],
+            config: {
+              systemInstruction: getCompressionPrompt()
+            }
+          },
+          promptId
+        );
+        const summary = getResponseText(summaryResponse) ?? "";
+        const isSummaryEmpty = !summary || summary.trim().length === 0;
+        let newTokenCount = originalTokenCount;
+        let extraHistory = [];
+        if (!isSummaryEmpty) {
+          extraHistory = [
+            {
+              role: "user",
+              parts: [{ text: summary }]
+            },
+            {
+              role: "model",
+              parts: [{ text: "Got it. Thanks for the additional context!" }]
+            },
+            ...historyToKeep
+          ];
+          const fullNewHistory = await getInitialChatHistory(config, extraHistory);
+          newTokenCount = Math.floor(
+            fullNewHistory.reduce(
+              (total, content) => total + JSON.stringify(content).length,
+              0
+            ) / 4
+          );
+        }
+        logChatCompression(
+          config,
+          makeChatCompressionEvent({
+            tokens_before: originalTokenCount,
+            tokens_after: newTokenCount
+          })
+        );
+        if (isSummaryEmpty) {
+          return {
+            newHistory: null,
+            info: {
+              originalTokenCount,
+              newTokenCount: originalTokenCount,
+              compressionStatus: 4 /* COMPRESSION_FAILED_EMPTY_SUMMARY */
+            }
+          };
+        } else if (newTokenCount > originalTokenCount) {
+          return {
+            newHistory: null,
+            info: {
+              originalTokenCount,
+              newTokenCount,
+              compressionStatus: 2 /* COMPRESSION_FAILED_INFLATED_TOKEN_COUNT */
+            }
+          };
+        } else {
+          uiTelemetryService.setLastPromptTokenCount(newTokenCount);
+          return {
+            newHistory: extraHistory,
+            info: {
+              originalTokenCount,
+              newTokenCount,
+              compressionStatus: 1 /* COMPRESSED */
+            }
+          };
+        }
+      }
+    };
+  }
+});
+
 // packages/core/src/services/loopDetectionService.ts
 import { createHash as createHash3 } from "node:crypto";
 var TOOL_CALL_LOOP_THRESHOLD, CONTENT_LOOP_THRESHOLD, CONTENT_CHUNK_SIZE, MAX_HISTORY_LENGTH, LLM_LOOP_CHECK_HISTORY_COUNT, LLM_CHECK_AFTER_TURNS, DEFAULT_LLM_CHECK_INTERVAL, MIN_LLM_CHECK_INTERVAL, MAX_LLM_CHECK_INTERVAL, LOOP_DETECTION_SYSTEM_PROMPT, LoopDetectionService;
@@ -200872,316 +201372,6 @@ var init_types6 = __esm({
   }
 });
 
-// packages/core/src/config/constants.ts
-var DEFAULT_MEMORY_FILE_FILTERING_OPTIONS, DEFAULT_FILE_FILTERING_OPTIONS;
-var init_constants3 = __esm({
-  "packages/core/src/config/constants.ts"() {
-    "use strict";
-    init_esbuild_shims();
-    DEFAULT_MEMORY_FILE_FILTERING_OPTIONS = {
-      respectGitIgnore: false,
-      respectQwenIgnore: true
-    };
-    DEFAULT_FILE_FILTERING_OPTIONS = {
-      respectGitIgnore: true,
-      respectQwenIgnore: true
-    };
-  }
-});
-
-// packages/core/src/utils/getFolderStructure.ts
-import * as fs24 from "node:fs/promises";
-import * as path21 from "node:path";
-async function readFullStructure(rootPath, options2) {
-  const rootName = path21.basename(rootPath);
-  const rootNode = {
-    name: rootName,
-    path: rootPath,
-    files: [],
-    subFolders: [],
-    totalChildren: 0,
-    totalFiles: 0
-  };
-  const queue = [
-    { folderInfo: rootNode, currentPath: rootPath }
-  ];
-  let currentItemCount = 0;
-  const processedPaths = /* @__PURE__ */ new Set();
-  while (queue.length > 0) {
-    const { folderInfo, currentPath } = queue.shift();
-    if (processedPaths.has(currentPath)) {
-      continue;
-    }
-    processedPaths.add(currentPath);
-    if (currentItemCount >= options2.maxItems) {
-      continue;
-    }
-    let entries;
-    try {
-      const rawEntries = await fs24.readdir(currentPath, { withFileTypes: true });
-      entries = rawEntries.sort((a, b) => a.name.localeCompare(b.name));
-    } catch (error) {
-      if (isNodeError(error) && (error.code === "EACCES" || error.code === "ENOENT")) {
-        console.warn(
-          `Warning: Could not read directory ${currentPath}: ${error.message}`
-        );
-        if (currentPath === rootPath && error.code === "ENOENT") {
-          return null;
-        }
-        continue;
-      }
-      throw error;
-    }
-    const filesInCurrentDir = [];
-    const subFoldersInCurrentDir = [];
-    for (const entry of entries) {
-      if (entry.isFile()) {
-        if (currentItemCount >= options2.maxItems) {
-          folderInfo.hasMoreFiles = true;
-          break;
-        }
-        const fileName = entry.name;
-        const filePath = path21.join(currentPath, fileName);
-        if (options2.fileService) {
-          const shouldIgnore = options2.fileFilteringOptions.respectGitIgnore && options2.fileService.shouldGitIgnoreFile(filePath) || options2.fileFilteringOptions.respectQwenIgnore && options2.fileService.shouldQwenIgnoreFile(filePath);
-          if (shouldIgnore) {
-            continue;
-          }
-        }
-        if (!options2.fileIncludePattern || options2.fileIncludePattern.test(fileName)) {
-          filesInCurrentDir.push(fileName);
-          currentItemCount++;
-          folderInfo.totalFiles++;
-          folderInfo.totalChildren++;
-        }
-      }
-    }
-    folderInfo.files = filesInCurrentDir;
-    for (const entry of entries) {
-      if (entry.isDirectory()) {
-        if (currentItemCount >= options2.maxItems) {
-          folderInfo.hasMoreSubfolders = true;
-          break;
-        }
-        const subFolderName = entry.name;
-        const subFolderPath = path21.join(currentPath, subFolderName);
-        let isIgnored = false;
-        if (options2.fileService) {
-          isIgnored = options2.fileFilteringOptions.respectGitIgnore && options2.fileService.shouldGitIgnoreFile(subFolderPath) || options2.fileFilteringOptions.respectQwenIgnore && options2.fileService.shouldQwenIgnoreFile(subFolderPath);
-        }
-        if (options2.ignoredFolders.has(subFolderName) || isIgnored) {
-          const ignoredSubFolder = {
-            name: subFolderName,
-            path: subFolderPath,
-            files: [],
-            subFolders: [],
-            totalChildren: 0,
-            totalFiles: 0,
-            isIgnored: true
-          };
-          subFoldersInCurrentDir.push(ignoredSubFolder);
-          currentItemCount++;
-          folderInfo.totalChildren++;
-          continue;
-        }
-        const subFolderNode = {
-          name: subFolderName,
-          path: subFolderPath,
-          files: [],
-          subFolders: [],
-          totalChildren: 0,
-          totalFiles: 0
-        };
-        subFoldersInCurrentDir.push(subFolderNode);
-        currentItemCount++;
-        folderInfo.totalChildren++;
-        queue.push({ folderInfo: subFolderNode, currentPath: subFolderPath });
-      }
-    }
-    folderInfo.subFolders = subFoldersInCurrentDir;
-  }
-  return rootNode;
-}
-function formatStructure(node, currentIndent, isLastChildOfParent, isProcessingRootNode, builder) {
-  const connector = isLastChildOfParent ? "\u2514\u2500\u2500\u2500" : "\u251C\u2500\u2500\u2500";
-  if (!isProcessingRootNode || node.isIgnored) {
-    builder.push(
-      `${currentIndent}${connector}${node.name}${path21.sep}${node.isIgnored ? TRUNCATION_INDICATOR : ""}`
-    );
-  }
-  const indentForChildren = isProcessingRootNode ? "" : currentIndent + (isLastChildOfParent ? "    " : "\u2502   ");
-  const fileCount = node.files.length;
-  for (let i = 0; i < fileCount; i++) {
-    const isLastFileAmongSiblings = i === fileCount - 1 && node.subFolders.length === 0 && !node.hasMoreSubfolders;
-    const fileConnector = isLastFileAmongSiblings ? "\u2514\u2500\u2500\u2500" : "\u251C\u2500\u2500\u2500";
-    builder.push(`${indentForChildren}${fileConnector}${node.files[i]}`);
-  }
-  if (node.hasMoreFiles) {
-    const isLastIndicatorAmongSiblings = node.subFolders.length === 0 && !node.hasMoreSubfolders;
-    const fileConnector = isLastIndicatorAmongSiblings ? "\u2514\u2500\u2500\u2500" : "\u251C\u2500\u2500\u2500";
-    builder.push(`${indentForChildren}${fileConnector}${TRUNCATION_INDICATOR}`);
-  }
-  const subFolderCount = node.subFolders.length;
-  for (let i = 0; i < subFolderCount; i++) {
-    const isLastSubfolderAmongSiblings = i === subFolderCount - 1 && !node.hasMoreSubfolders;
-    formatStructure(
-      node.subFolders[i],
-      indentForChildren,
-      isLastSubfolderAmongSiblings,
-      false,
-      builder
-    );
-  }
-  if (node.hasMoreSubfolders) {
-    builder.push(`${indentForChildren}\u2514\u2500\u2500\u2500${TRUNCATION_INDICATOR}`);
-  }
-}
-async function getFolderStructure(directory, options2) {
-  const resolvedPath = path21.resolve(directory);
-  const mergedOptions = {
-    maxItems: options2?.maxItems ?? MAX_ITEMS,
-    ignoredFolders: options2?.ignoredFolders ?? DEFAULT_IGNORED_FOLDERS,
-    fileIncludePattern: options2?.fileIncludePattern,
-    fileService: options2?.fileService,
-    fileFilteringOptions: options2?.fileFilteringOptions ?? DEFAULT_FILE_FILTERING_OPTIONS
-  };
-  try {
-    let isTruncated2 = function(node) {
-      if (node.hasMoreFiles || node.hasMoreSubfolders || node.isIgnored) {
-        return true;
-      }
-      for (const sub of node.subFolders) {
-        if (isTruncated2(sub)) {
-          return true;
-        }
-      }
-      return false;
-    };
-    var isTruncated = isTruncated2;
-    __name(isTruncated2, "isTruncated");
-    const structureRoot = await readFullStructure(resolvedPath, mergedOptions);
-    if (!structureRoot) {
-      return `Error: Could not read directory "${resolvedPath}". Check path and permissions.`;
-    }
-    const structureLines = [];
-    formatStructure(structureRoot, "", true, true, structureLines);
-    let summary = `Showing up to ${mergedOptions.maxItems} items (files + folders).`;
-    if (isTruncated2(structureRoot)) {
-      summary += ` Folders or files indicated with ${TRUNCATION_INDICATOR} contain more items not shown, were ignored, or the display limit (${mergedOptions.maxItems} items) was reached.`;
-    }
-    return `${summary}
-
-${resolvedPath}${path21.sep}
-${structureLines.join("\n")}`;
-  } catch (error) {
-    console.error(`Error getting folder structure for ${resolvedPath}:`, error);
-    return `Error processing directory "${resolvedPath}": ${getErrorMessage(error)}`;
-  }
-}
-var MAX_ITEMS, TRUNCATION_INDICATOR, DEFAULT_IGNORED_FOLDERS;
-var init_getFolderStructure = __esm({
-  "packages/core/src/utils/getFolderStructure.ts"() {
-    "use strict";
-    init_esbuild_shims();
-    init_errors();
-    init_constants3();
-    MAX_ITEMS = 20;
-    TRUNCATION_INDICATOR = "...";
-    DEFAULT_IGNORED_FOLDERS = /* @__PURE__ */ new Set(["node_modules", ".git", "dist"]);
-    __name(readFullStructure, "readFullStructure");
-    __name(formatStructure, "formatStructure");
-    __name(getFolderStructure, "getFolderStructure");
-  }
-});
-
-// packages/core/src/utils/environmentContext.ts
-async function getDirectoryContextString(config) {
-  const workspaceContext = config.getWorkspaceContext();
-  const workspaceDirectories = workspaceContext.getDirectories();
-  const folderStructures = await Promise.all(
-    workspaceDirectories.map(
-      (dir) => getFolderStructure(dir, {
-        fileService: config.getFileService()
-      })
-    )
-  );
-  const folderStructure = folderStructures.join("\n");
-  let workingDirPreamble;
-  if (workspaceDirectories.length === 1) {
-    workingDirPreamble = `I'm currently working in the directory: ${workspaceDirectories[0]}`;
-  } else {
-    const dirList = workspaceDirectories.map((dir) => `  - ${dir}`).join("\n");
-    workingDirPreamble = `I'm currently working in the following directories:
-${dirList}`;
-  }
-  return `${workingDirPreamble}
-Here is the folder structure of the current working directories:
-
-${folderStructure}`;
-}
-async function getEnvironmentContext(config) {
-  const today = (/* @__PURE__ */ new Date()).toLocaleDateString(void 0, {
-    weekday: "long",
-    year: "numeric",
-    month: "long",
-    day: "numeric"
-  });
-  const platform14 = process.platform;
-  const directoryContext = await getDirectoryContextString(config);
-  const context2 = `
-This is the RDMind. We are setting up the context for our chat.
-Today's date is ${today} (formatted according to the user's locale).
-My operating system is: ${platform14}
-${directoryContext}
-        `.trim();
-  const initialParts = [{ text: context2 }];
-  const toolRegistry = config.getToolRegistry();
-  if (config.getFullContext()) {
-    try {
-      const readManyFilesTool = toolRegistry.getTool("read_many_files");
-      if (readManyFilesTool) {
-        const invocation = readManyFilesTool.build({
-          paths: ["**/*"],
-          // Read everything recursively
-          useDefaultExcludes: true
-          // Use default excludes
-        });
-        const result = await invocation.execute(AbortSignal.timeout(3e4));
-        if (result.llmContent) {
-          initialParts.push({
-            text: `
---- Full File Context ---
-${result.llmContent}`
-          });
-        } else {
-          console.warn(
-            "Full context requested, but read_many_files returned no content."
-          );
-        }
-      } else {
-        console.warn(
-          "Full context requested, but read_many_files tool not found."
-        );
-      }
-    } catch (error) {
-      console.error("Error reading full file context:", error);
-      initialParts.push({
-        text: "\n--- Error reading full file context ---"
-      });
-    }
-  }
-  return initialParts;
-}
-var init_environmentContext = __esm({
-  "packages/core/src/utils/environmentContext.ts"() {
-    "use strict";
-    init_esbuild_shims();
-    init_getFolderStructure();
-    __name(getDirectoryContextString, "getDirectoryContextString");
-    __name(getEnvironmentContext, "getEnvironmentContext");
-  }
-});
-
 // packages/core/src/subagents/subagent-events.ts
 import { EventEmitter as EventEmitter5 } from "events";
 var SubAgentEventEmitter;
@@ -201785,11 +201975,7 @@ var init_subagent = __esm({
             "PromptConfig cannot have both `systemPrompt` and `initialMessages` defined."
           );
         }
-        const envParts = await getEnvironmentContext(this.runtimeContext);
-        const envHistory = [
-          { role: "user", parts: envParts },
-          { role: "model", parts: [{ text: "Got it. Thanks for the context!" }] }
-        ];
+        const envHistory = await getInitialChatHistory(this.runtimeContext);
         const start_history = [
           ...envHistory,
           ...this.promptConfig.initialMessages ?? []
@@ -206856,32 +207042,7 @@ var init_types8 = __esm({
 function isThinkingSupported(model) {
   return model.startsWith("gemini-2.5") || model === DEFAULT_GEMINI_MODEL_AUTO;
 }
-function findCompressSplitPoint(contents, fraction) {
-  if (fraction <= 0 || fraction >= 1) {
-    throw new Error("Fraction must be between 0 and 1");
-  }
-  const charCounts = contents.map((content) => JSON.stringify(content).length);
-  const totalCharCount = charCounts.reduce((a, b) => a + b, 0);
-  const targetCharCount = totalCharCount * fraction;
-  let lastSplitPoint = 0;
-  let cumulativeCharCount = 0;
-  for (let i = 0; i < contents.length; i++) {
-    const content = contents[i];
-    if (content.role === "user" && !content.parts?.some((part) => !!part.functionResponse)) {
-      if (cumulativeCharCount >= targetCharCount) {
-        return i;
-      }
-      lastSplitPoint = i;
-    }
-    cumulativeCharCount += charCounts[i];
-  }
-  const lastContent = contents[contents.length - 1];
-  if (lastContent?.role === "model" && !lastContent?.parts?.some((part) => part.functionCall)) {
-    return contents.length;
-  }
-  return lastSplitPoint;
-}
-var MAX_TURNS, COMPRESSION_TOKEN_THRESHOLD, COMPRESSION_PRESERVE_THRESHOLD, GeminiClient;
+var MAX_TURNS, GeminiClient;
 var init_client2 = __esm({
   "packages/core/src/core/client.ts"() {
     "use strict";
@@ -206890,9 +207051,9 @@ var init_client2 = __esm({
     init_models();
     init_geminiChat();
     init_prompts();
-    init_tokenLimits();
     init_turn();
     init_chatRecordingService();
+    init_chatCompressionService();
     init_loopDetectionService();
     init_task();
     init_telemetry();
@@ -206906,10 +207067,7 @@ var init_client2 = __esm({
     init_types8();
     init_handler();
     __name(isThinkingSupported, "isThinkingSupported");
-    __name(findCompressSplitPoint, "findCompressSplitPoint");
     MAX_TURNS = 100;
-    COMPRESSION_TOKEN_THRESHOLD = 0.7;
-    COMPRESSION_PRESERVE_THRESHOLD = 0.3;
     GeminiClient = class {
       constructor(config) {
         this.config = config;
@@ -206992,21 +207150,10 @@ var init_client2 = __esm({
       async startChat(extraHistory) {
         this.forceFullIdeContext = true;
         this.hasFailedCompressionAttempt = false;
-        const envParts = await getEnvironmentContext(this.config);
         const toolRegistry = this.config.getToolRegistry();
         const toolDeclarations = toolRegistry.getFunctionDeclarations();
         const tools = [{ functionDeclarations: toolDeclarations }];
-        const history = [
-          {
-            role: "user",
-            parts: envParts
-          },
-          {
-            role: "model",
-            parts: [{ text: "Got it. Thanks for the context!" }]
-          },
-          ...extraHistory ?? []
-        ];
+        const history = await getInitialChatHistory(this.config, extraHistory);
         try {
           const userMemory = this.config.getUserMemory();
           const model = this.config.getModel();
@@ -207195,12 +207342,13 @@ var init_client2 = __esm({
             userMemory,
             this.config.getModel()
           );
-          const environment = await getEnvironmentContext(this.config);
+          const initialHistory = await getInitialChatHistory(this.config);
           const mockRequestContent = [
             {
               role: "system",
-              parts: [{ text: systemPrompt }, ...environment]
+              parts: [{ text: systemPrompt }]
             },
+            ...initialHistory,
             ...currentHistory
           ];
           const { totalTokens: totalRequestTokens } = await this.config.getContentGenerator().countTokens({
@@ -207360,99 +207508,26 @@ var init_client2 = __esm({
         }
       }
       async tryCompressChat(prompt_id, force = false) {
-        const model = this.config.getModel();
-        const curatedHistory = this.getChat().getHistory(true);
-        if (curatedHistory.length === 0 || this.hasFailedCompressionAttempt && !force) {
-          return {
-            originalTokenCount: 0,
-            newTokenCount: 0,
-            compressionStatus: 4 /* NOOP */
-          };
-        }
-        const originalTokenCount = uiTelemetryService.getLastPromptTokenCount();
-        const contextPercentageThreshold = this.config.getChatCompression()?.contextPercentageThreshold;
-        if (!force) {
-          const threshold = contextPercentageThreshold ?? COMPRESSION_TOKEN_THRESHOLD;
-          if (originalTokenCount < threshold * tokenLimit(model)) {
-            return {
-              originalTokenCount,
-              newTokenCount: originalTokenCount,
-              compressionStatus: 4 /* NOOP */
-            };
-          }
-        }
-        const splitPoint = findCompressSplitPoint(
-          curatedHistory,
-          1 - COMPRESSION_PRESERVE_THRESHOLD
-        );
-        const historyToCompress = curatedHistory.slice(0, splitPoint);
-        const historyToKeep = curatedHistory.slice(splitPoint);
-        const summaryResponse = await this.config.getContentGenerator().generateContent(
-          {
-            model,
-            contents: [
-              ...historyToCompress,
-              {
-                role: "user",
-                parts: [
-                  {
-                    text: "First, reason in your scratchpad. Then, generate the <state_snapshot>."
-                  }
-                ]
-              }
-            ],
-            config: {
-              systemInstruction: { text: getCompressionPrompt() }
-            }
-          },
-          prompt_id
-        );
-        const summary = getResponseText(summaryResponse) ?? "";
-        const chat = await this.startChat([
-          {
-            role: "user",
-            parts: [{ text: summary }]
-          },
-          {
-            role: "model",
-            parts: [{ text: "Got it. Thanks for the additional context!" }]
-          },
-          ...historyToKeep
-        ]);
-        this.forceFullIdeContext = true;
-        const newTokenCount = Math.floor(
-          chat.getHistory().reduce((total, content) => total + JSON.stringify(content).length, 0) / 4
-        );
-        logChatCompression(
+        const compressionService = new ChatCompressionService();
+        const { newHistory, info } = await compressionService.compress(
+          this.getChat(),
+          prompt_id,
+          force,
+          this.config.getModel(),
           this.config,
-          makeChatCompressionEvent({
-            tokens_before: originalTokenCount,
-            tokens_after: newTokenCount
-          })
+          this.hasFailedCompressionAttempt
         );
-        if (newTokenCount > originalTokenCount) {
-          this.hasFailedCompressionAttempt = !force && true;
-          return {
-            originalTokenCount,
-            newTokenCount,
-            compressionStatus: 2 /* COMPRESSION_FAILED_INFLATED_TOKEN_COUNT */
-          };
-        } else {
-          this.chat = chat;
-          uiTelemetryService.setLastPromptTokenCount(newTokenCount);
+        if (info.compressionStatus === 1 /* COMPRESSED */) {
+          if (newHistory) {
+            this.chat = await this.startChat(newHistory);
+            this.forceFullIdeContext = true;
+          }
+        } else if (info.compressionStatus === 2 /* COMPRESSION_FAILED_INFLATED_TOKEN_COUNT */ || info.compressionStatus === 4 /* COMPRESSION_FAILED_EMPTY_SUMMARY */) {
+          if (!force) {
+            this.hasFailedCompressionAttempt = true;
+          }
         }
-        logChatCompression(
-          this.config,
-          makeChatCompressionEvent({
-            tokens_before: originalTokenCount,
-            tokens_after: newTokenCount
-          })
-        );
-        return {
-          originalTokenCount,
-          newTokenCount,
-          compressionStatus: 1 /* COMPRESSED */
-        };
+        return info;
       }
     };
   }
@@ -235724,38 +235799,13 @@ async function listKnowledgeExt(subPath = "", debugMode = false) {
   }
 }
 function findKnowledgeDirectory() {
-  const candidatePaths = [
-    // 1. 用户当前工作目录（用户自己的 .knowledge）
-    path43.resolve(process.cwd(), ".knowledge"),
-    // 2. npm 安装后：从 core 包找到 cli 包中的 .knowledge
-    // core 包位置: node_modules/@rdmind/rdmind/node_modules/@rdmind/rdmind-core/dist/src/tools/
-    // cli 包位置: node_modules/@rdmind/rdmind/.knowledge
-    // 从 __dirname (dist/src/tools) 回退到 cli 包根目录
-    path43.resolve(__dirname4, "../../../../../.knowledge"),
-    // 从 core 包的 dist/src/tools 回退到 cli 包
-    path43.resolve(__dirname4, "../../../../../../.knowledge"),
-    // 兼容不同的安装结构
-    // 3. npm 全局安装：从 core 包所在位置找到 rdmind 包
-    // 全局: /usr/local/lib/node_modules/@rdmind/rdmind/node_modules/@rdmind/rdmind-core/dist/src/tools
-    path43.resolve(__dirname4, "../../../../../../../@rdmind/rdmind/.knowledge"),
-    // 4. 开发环境：相对于项目根目录
-    path43.resolve(__dirname4, "../../../../../../../.knowledge"),
-    // 从 packages/core/dist/src/tools 到项目根
-    path43.resolve(__dirname4, "../../../../../../.knowledge"),
-    path43.resolve(__dirname4, "../../../../../.knowledge"),
-    path43.resolve(__dirname4, "../../../../.knowledge"),
-    path43.resolve(__dirname4, "../../../.knowledge"),
-    path43.resolve(__dirname4, "../../.knowledge"),
-    path43.resolve(__dirname4, "../.knowledge")
-  ];
-  for (const candidatePath of candidatePaths) {
-    try {
-      if (fsSync2.existsSync(candidatePath) && fsSync2.statSync(candidatePath).isDirectory()) {
-        return candidatePath;
-      }
-    } catch {
-      continue;
-    }
+  const userKnowledgePath = path43.resolve(process.cwd(), ".knowledge");
+  if (fsSync2.existsSync(userKnowledgePath) && fsSync2.statSync(userKnowledgePath).isDirectory()) {
+    return userKnowledgePath;
+  }
+  const packageKnowledgePath = path43.join(__dirname4, ".knowledge");
+  if (fsSync2.existsSync(packageKnowledgePath) && fsSync2.statSync(packageKnowledgePath).isDirectory()) {
+    return packageKnowledgePath;
   }
   return null;
 }
@@ -245048,16 +245098,30 @@ var init_redoc_fetch = __esm({
           if (!responseData.data) {
             const errorMessage = "Redoc API response does not contain data field";
             console.error(`[RedocFetchTool] ${errorMessage}`);
-            console.error(`[RedocFetchTool] \u5B8C\u6574\u54CD\u5E94\u6570\u636E:`, JSON.stringify(responseData, null, 2));
+            console.error(
+              `[RedocFetchTool] \u5B8C\u6574\u54CD\u5E94\u6570\u636E:`,
+              JSON.stringify(responseData, null, 2)
+            );
             throw new Error(errorMessage);
           }
           if (!responseData.data.content) {
             const errorMessage = "Redoc API response does not contain content field in data";
             console.error(`[RedocFetchTool] ${errorMessage}`);
-            console.error(`[RedocFetchTool] \u5B8C\u6574\u54CD\u5E94\u6570\u636E:`, JSON.stringify(responseData, null, 2));
-            console.error(`[RedocFetchTool] data \u5B57\u6BB5\u5185\u5BB9:`, JSON.stringify(responseData.data, null, 2));
-            console.error(`[RedocFetchTool] data \u5B57\u6BB5\u7684\u6240\u6709\u952E:`, Object.keys(responseData.data));
-            throw new Error(`${errorMessage}. \u53EF\u7528\u5B57\u6BB5: ${Object.keys(responseData.data).join(", ")}`);
+            console.error(
+              `[RedocFetchTool] \u5B8C\u6574\u54CD\u5E94\u6570\u636E:`,
+              JSON.stringify(responseData, null, 2)
+            );
+            console.error(
+              `[RedocFetchTool] data \u5B57\u6BB5\u5185\u5BB9:`,
+              JSON.stringify(responseData.data, null, 2)
+            );
+            console.error(
+              `[RedocFetchTool] data \u5B57\u6BB5\u7684\u6240\u6709\u952E:`,
+              Object.keys(responseData.data)
+            );
+            throw new Error(
+              `${errorMessage}. \u53EF\u7528\u5B57\u6BB5: ${Object.keys(responseData.data).join(", ")}`
+            );
           }
           console.debug(
             `[RedocFetchTool] Successfully fetched content for doc_id: ${docId}, title: ${responseData.data.title}`
@@ -319835,7 +319899,7 @@ function CompressionMessage({
         return "Chat history compression did not reduce size. This may indicate issues with the compression prompt.";
       case 3 /* COMPRESSION_FAILED_TOKEN_COUNT_ERROR */:
         return "Could not compress chat history due to a token counting error.";
-      case 4 /* NOOP */:
+      case 5 /* NOOP */:
         return "Chat history is already compressed.";
       default:
         return "";
@@ -319912,7 +319976,7 @@ init_esbuild_shims();
 
 // packages/cli/src/generated/git-commit.ts
 init_esbuild_shims();
-var GIT_COMMIT_INFO2 = "34a4d574";
+var GIT_COMMIT_INFO2 = "bf55c089";
 
 // packages/cli/src/ui/components/AboutBox.tsx
 var import_jsx_runtime43 = __toESM(require_jsx_runtime(), 1);
@@ -329514,6 +329578,8 @@ var USER_SETTINGS_PATH = Storage.getGlobalSettingsPath();
 var USER_SETTINGS_DIR2 = path72.dirname(USER_SETTINGS_PATH);
 var DEFAULT_EXCLUDED_ENV_VARS = ["DEBUG", "DEBUG_MODE"];
 var MIGRATE_V2_OVERWRITE = true;
+var SETTINGS_VERSION = 2;
+var SETTINGS_VERSION_KEY = "$version";
 var MIGRATION_MAP = {
   accessibility: "ui.accessibility",
   allowedTools: "tools.allowed",
@@ -329639,6 +329705,12 @@ function setNestedProperty(obj, path109, value) {
 }
 __name(setNestedProperty, "setNestedProperty");
 function needsMigration(settings) {
+  if (SETTINGS_VERSION_KEY in settings) {
+    const version2 = settings[SETTINGS_VERSION_KEY];
+    if (typeof version2 === "number" && version2 >= SETTINGS_VERSION) {
+      return false;
+    }
+  }
   const hasV1Keys = Object.entries(MIGRATION_MAP).some(([v1Key, v2Path]) => {
     if (v1Key === v2Path || !(v1Key in settings)) {
       return false;
@@ -329659,6 +329731,11 @@ function migrateSettingsToV2(flatSettings) {
   const flatKeys = new Set(Object.keys(flatSettings));
   for (const [oldKey, newPath] of Object.entries(MIGRATION_MAP)) {
     if (flatKeys.has(oldKey)) {
+      if (KNOWN_V2_CONTAINERS.has(oldKey) && typeof flatSettings[oldKey] === "object" && flatSettings[oldKey] !== null && !Array.isArray(flatSettings[oldKey])) {
+        v2Settings[oldKey] = flatSettings[oldKey];
+        flatKeys.delete(oldKey);
+        continue;
+      }
       setNestedProperty(v2Settings, newPath, flatSettings[oldKey]);
       flatKeys.delete(oldKey);
     }
@@ -329682,6 +329759,7 @@ function migrateSettingsToV2(flatSettings) {
       v2Settings[remainingKey] = newValue;
     }
   }
+  v2Settings[SETTINGS_VERSION_KEY] = SETTINGS_VERSION;
   return v2Settings;
 }
 __name(migrateSettingsToV2, "migrateSettingsToV2");
@@ -329718,6 +329796,9 @@ function migrateSettingsToV1(v2Settings) {
     v2Keys.delete("mcpServers");
   }
   for (const remainingKey of v2Keys) {
+    if (remainingKey === SETTINGS_VERSION_KEY) {
+      continue;
+    }
     const value = v2Settings[remainingKey];
     if (value === void 0) {
       continue;
@@ -329923,6 +330004,21 @@ function loadSettings(workspaceDir = process27.cwd()) {
             }
             settingsObject = migratedSettings;
           }
+        } else if (!(SETTINGS_VERSION_KEY in settingsObject)) {
+          settingsObject[SETTINGS_VERSION_KEY] = SETTINGS_VERSION;
+          if (MIGRATE_V2_OVERWRITE) {
+            try {
+              fs70.writeFileSync(
+                filePath,
+                JSON.stringify(settingsObject, null, 2),
+                "utf-8"
+              );
+            } catch (e2) {
+              console.error(
+                `Error adding version to settings file: ${getErrorMessage(e2)}`
+              );
+            }
+          }
         }
         return { settings: settingsObject, rawJson: content };
       }
@@ -342023,7 +342119,7 @@ __name(getPackageJson, "getPackageJson");
 // packages/cli/src/utils/version.ts
 async function getCliVersion() {
   const pkgJson = await getPackageJson();
-  return "0.0.21-alpha.1";
+  return "0.0.21";
 }
 __name(getCliVersion, "getCliVersion");
 
@@ -342476,24 +342572,24 @@ async function parseArguments(settings) {
     "\u4F7F\u7528\u65B9\u6CD5: rdmind [options] [command]\n\nRDMind - \u542F\u52A8\u4EA4\u4E92\u5F0F CLI\uFF0C\u4F7F\u7528 -p/--prompt \u8FDB\u5165\u975E\u4EA4\u4E92\u6A21\u5F0F"
   ).option("telemetry", {
     type: "boolean",
-    description: "\u542F\u7528\u9065\u6D4B\uFF1F\u63A7\u5236\u662F\u5426\u53D1\u9001\u9065\u6D4B\u6570\u636E"
+    description: "Enable telemetry? This flag specifically controls if telemetry is sent. Other --telemetry-* flags set specific values but do not enable telemetry on their own."
   }).option("telemetry-target", {
     type: "string",
     choices: ["local", "gcp"],
-    description: "\u8BBE\u7F6E\u9065\u6D4B\u76EE\u6807"
+    description: "Set the telemetry target (local or gcp). Overrides settings files."
   }).option("telemetry-otlp-endpoint", {
     type: "string",
-    description: "\u8BBE\u7F6E\u9065\u6D4B\u7684 OTLP \u7AEF\u70B9"
+    description: "Set the OTLP endpoint for telemetry. Overrides environment variables and settings files."
   }).option("telemetry-otlp-protocol", {
     type: "string",
     choices: ["grpc", "http"],
-    description: "\u8BBE\u7F6E\u9065\u6D4B\u7684 OTLP \u534F\u8BAE"
+    description: "Set the OTLP protocol for telemetry (grpc or http). Overrides settings files."
   }).option("telemetry-log-prompts", {
     type: "boolean",
-    description: "\u542F\u7528\u6216\u7981\u7528\u9065\u6D4B\u4E2D\u7528\u6237\u63D0\u793A\u8BCD\u7684\u65E5\u5FD7\u8BB0\u5F55"
+    description: "Enable or disable logging of user prompts for telemetry. Overrides settings files."
   }).option("telemetry-outfile", {
     type: "string",
-    description: "\u5C06\u6240\u6709\u9065\u6D4B\u8F93\u51FA\u91CD\u5B9A\u5411\u5230\u6307\u5B9A\u6587\u4EF6"
+    description: "Redirect all telemetry output to the specified file."
   }).deprecateOption(
     "telemetry",
     'Use the "telemetry.enabled" setting in settings.json instead. This flag will be removed in a future version.'
@@ -342531,52 +342627,52 @@ async function parseArguments(settings) {
     }).option("model", {
       alias: "m",
       type: "string",
-      description: `\u6A21\u578B`
+      description: `Model`
     }).option("prompt", {
       alias: "p",
       type: "string",
-      description: "\u63D0\u793A\u8BCD"
+      description: "Prompt. Appended to input on stdin (if any)."
     }).option("prompt-interactive", {
       alias: "i",
       type: "string",
-      description: "\u6839\u636E\u63D0\u4F9B\u7684\u63D0\u793A\u8BCD\u6267\u884C\u5E76\u7EE7\u7EED\u4EA4\u4E92\u6A21\u5F0F"
+      description: "Execute the provided prompt and continue in interactive mode"
     }).option("sandbox", {
       alias: "s",
       type: "boolean",
-      description: "\u5728\u6C99\u76D2\u4E2D\u8FD0\u884C\uFF1F"
+      description: "Run in sandbox?"
     }).option("sandbox-image", {
       type: "string",
-      description: "\u6C99\u76D2\u955C\u50CF"
+      description: "Sandbox image URI."
     }).option("all-files", {
       alias: ["a"],
       type: "boolean",
-      description: "\u4E0A\u4E0B\u6587\u4E2D\u5305\u542B\u6240\u6709\u6587\u4EF6\uFF1F",
+      description: "Include ALL files in context?",
       default: false
     }).option("show-memory-usage", {
       type: "boolean",
-      description: "\u72B6\u6001\u680F\u663E\u793A\u4F7F\u7528\u60C5\u51B5\uFF1F",
+      description: "Show memory usage in status bar",
       default: false
     }).option("yolo", {
       alias: "y",
       type: "boolean",
-      description: "\u9ED8\u8BA4\u63A5\u53D7\u6240\u6709\u64CD\u4F5C\uFF08YOLO \u6A21\u5F0F\uFF09\uFF1F",
+      description: "Automatically accept all actions (aka YOLO mode, see https://www.youtube.com/watch?v=xvFZjo5PgG0 for more details)?",
       default: false
     }).option("approval-mode", {
       type: "string",
       choices: ["plan", "default", "auto-edit", "yolo"],
-      description: "\u8BBE\u7F6E\u5BA1\u6279\u6A21\u5F0F\uFF1Aplan\uFF08\u53EA\u505A\u89C4\u5212\uFF09\u3001default\uFF08\u63D0\u793A\u786E\u8BA4\uFF09\u3001auto_edit\uFF08\u63A5\u53D7\u7F16\u8F91\uFF09\u3001yolo\uFF08\u63A5\u53D7\u6240\u6709\u5DE5\u5177\uFF09"
+      description: "Set the approval mode: plan (plan only), default (prompt for approval), auto-edit (auto-approve edit tools), yolo (auto-approve all tools)"
     }).option("checkpointing", {
       alias: "c",
       type: "boolean",
-      description: "\u542F\u7528\u68C0\u67E5\u70B9\u529F\u80FD",
+      description: "Enables checkpointing of file edits",
       default: false
     }).option("experimental-acp", {
       type: "boolean",
-      description: "\u5728 ACP \u6A21\u5F0F\u4E0B\u542F\u52A8\u4EE3\u7406"
+      description: "Starts the agent in ACP mode"
     }).option("allowed-mcp-server-names", {
       type: "array",
       string: true,
-      description: "\u5141\u8BB8\u7684 MCP \u670D\u52A1\u540D\u79F0",
+      description: "Allowed MCP server names",
       coerce: /* @__PURE__ */ __name((mcpServerNames) => (
         // Handle comma-separated values
         mcpServerNames.flatMap(
@@ -342586,7 +342682,7 @@ async function parseArguments(settings) {
     }).option("allowed-tools", {
       type: "array",
       string: true,
-      description: "\u65E0\u9700\u786E\u8BA4\u5373\u53EF\u8FD0\u884C\u7684\u5DE5\u5177",
+      description: "Tools that are allowed to run without confirmation",
       coerce: /* @__PURE__ */ __name((tools) => (
         // Handle comma-separated values
         tools.flatMap((tool) => tool.split(",").map((t2) => t2.trim()))
@@ -342595,7 +342691,7 @@ async function parseArguments(settings) {
       alias: "e",
       type: "array",
       string: true,
-      description: "\u8981\u4F7F\u7528\u7684\u6269\u5C55\u5217\u8868\u3002\u672A\u63D0\u4F9B\u5219\u4F7F\u7528\u6240\u6709\u6269\u5C55",
+      description: "A list of extensions to use. If not provided, all extensions are used.",
       coerce: /* @__PURE__ */ __name((extensions) => (
         // Handle comma-separated values
         extensions.flatMap(
@@ -342605,34 +342701,34 @@ async function parseArguments(settings) {
     }).option("list-extensions", {
       alias: "l",
       type: "boolean",
-      description: "\u5217\u51FA\u6240\u6709\u53EF\u7528\u6269\u5C55\u5E76\u9000\u51FA"
+      description: "List all available extensions and exit."
     }).option("include-directories", {
       type: "array",
       string: true,
-      description: "\u5DE5\u4F5C\u533A\u4E2D\u7684\u989D\u5916\u76EE\u5F55\uFF08\u9017\u53F7\u5206\u9694\u6216\u591A\u4E2A --include-directories\uFF09",
+      description: "Additional directories to include in the workspace (comma-separated or multiple --include-directories)",
       coerce: /* @__PURE__ */ __name((dirs) => (
         // Handle comma-separated values
         dirs.flatMap((dir) => dir.split(",").map((d) => d.trim()))
       ), "coerce")
     }).option("openai-logging", {
       type: "boolean",
-      description: "\u542F\u7528 OpenAI API \u8C03\u7528\u65E5\u5FD7\u8BB0\u5F55"
+      description: "Enable logging of OpenAI API calls for debugging and analysis"
     }).option("openai-api-key", {
       type: "string",
-      description: "\u7528\u4E8E\u8EAB\u4EFD\u9A8C\u8BC1\u7684 OpenAI API \u5BC6\u94A5"
+      description: "OpenAI API key to use for authentication"
     }).option("openai-base-url", {
       type: "string",
-      description: "OpenAI base URL"
+      description: "OpenAI base URL (for custom endpoints)"
     }).option("tavily-api-key", {
       type: "string",
-      description: "Tavily API \u5BC6\u94A5"
+      description: "Tavily API key for web search functionality"
     }).option("screen-reader", {
       type: "boolean",
-      description: "\u542F\u7528 screen-reader"
+      description: "Enable screen reader mode for accessibility."
     }).option("vlm-switch-mode", {
       type: "string",
       choices: ["once", "session", "persist"],
-      description: "\u68C0\u6D4B\u5230\u8F93\u5165\u4E2D\u5305\u542B\u56FE\u50CF\u65F6\u7684\u9ED8\u8BA4\u884C\u4E3A\u3002\u53EF\u9009\u503C\uFF1Aonce\uFF08\u5207\u6362\u4E00\u6B21\uFF09\u3001session\uFF08\u6574\u4E2A\u4F1A\u8BDD\u671F\u95F4\u5207\u6362\uFF09\u3001persist\uFF08\u7EE7\u7EED\u4F7F\u7528\u5F53\u524D\u6A21\u578B\uFF09\u3002\u4F1A\u8986\u76D6\u8BBE\u7F6E\u6587\u4EF6\u7684\u914D\u7F6E",
+      description: "Default behavior when images are detected in input. Values: once (one-time switch), session (switch for entire session), persist (continue with current model). Overrides settings files.",
       default: process.env["VLM_SWITCH_MODE"]
     }).option("output-format", {
       alias: "o",
@@ -342662,13 +342758,13 @@ async function parseArguments(settings) {
       const query = argv["query"];
       const hasPositionalQuery = Array.isArray(query) ? query.length > 0 : !!query;
       if (argv["prompt"] && hasPositionalQuery) {
-        return "\u4E0D\u80FD\u540C\u65F6\u4F7F\u7528\u4F4D\u7F6E\u53C2\u6570\u63D0\u793A\u8BCD\u548C --prompt (-p) \u6807\u5FD7";
+        return "Cannot use both a positional prompt and the --prompt (-p) flag together";
       }
       if (argv["prompt"] && argv["promptInteractive"]) {
-        return "\u4E0D\u80FD\u540C\u65F6\u4F7F\u7528 --prompt (-p) \u548C --prompt-interactive (-i)";
+        return "Cannot use both --prompt (-p) and --prompt-interactive (-i) together";
       }
       if (argv["yolo"] && argv["approvalMode"]) {
-        return "\u4E0D\u80FD\u540C\u65F6\u4F7F\u7528 --yolo (-y) \u548C --approval-mode\u3002\u8BF7\u4F7F\u7528 --approval-mode=yolo \u66FF\u4EE3";
+        return "Cannot use both --yolo (-y) and --approval-mode together. Use --approval-mode=yolo instead.";
       }
       return true;
     })