nolo-cli 0.30.0 → 0.31.0-alpha.1

package/chunk-BGTUGS3T.js

@@ -0,0 +1,702 @@
+import {
+  compactWhitespace
+} from "./chunk-DWLEOOGR.js";
+import {
+  addContentAction
+} from "./chunk-V54H24CQ.js";
+import {
+  upload
+} from "./chunk-LAXMH7JY.js";
+import {
+  getRuntimeServerContext
+} from "./chunk-2IJAKBK2.js";
+import {
+  API_ENDPOINTS
+} from "./chunk-LCBAMY2M.js";
+import {
+  normalizeServerOrigin
+} from "./chunk-CF7PE763.js";
+
+// packages/ai/context/tokenUtils.ts
+var estimateTokenCount = (text) => {
+  if (!text) return 0;
+  const chineseChars = (text.match(/[\u4e00-\u9fa5\u3400-\u4dbf]/g) || []).length;
+  const otherChars = text.length - chineseChars;
+  return Math.ceil(chineseChars * 1.5 + otherChars * 0.25);
+};
+
+// packages/chat/dialog/actions/builtinDialogLlm.ts
+var BASE_BUILTIN_DIALOG_LLM_CONFIG = {
+  apiSource: "platform",
+  useServerProxy: true
+};
+var BUILTIN_TITLE_LLM_CONFIG = {
+  ...BASE_BUILTIN_DIALOG_LLM_CONFIG,
+  provider: "nolo",
+  id: "builtin-dialog-title-llm",
+  name: "Builtin Dialog Title LLM",
+  model: "deepseek-v4-flash",
+  prompt: "You are a title generator for chat history. \u4F60\u53EA\u505A\u4E00\u4EF6\u4E8B\uFF1A\u6839\u636E\u5BF9\u8BDD\u5185\u5BB9\u8F93\u51FA\u6700\u7EC8\u6807\u9898\u3002\u786C\u6027\u89C4\u5219\uFF1A1) \u53EA\u8F93\u51FA\u6807\u9898\u8FD9\u4E00\u884C\uFF1B\u4E25\u7981\u8F93\u51FA\u63A8\u7406\u3001\u5206\u6790\u3001\u6B65\u9AA4\u3001\u89E3\u91CA\u3001\u524D\u8A00\u3001\u540E\u8BB0\u3001\u7FFB\u8BD1\u3001\u81F4\u6B49\u6216\u4EFB\u4F55\u989D\u5916\u8BF4\u660E\u30022) \u4E0D\u8981\u56DE\u7B54\u7528\u6237\u8BF7\u6C42\uFF0C\u4E0D\u8981\u5199\u6458\u8981\uFF0C\u53EA\u7ED9\u6807\u9898\u7ED3\u679C\u30023) \u6807\u9898\u5C3D\u91CF\u77ED\uFF1A\u901A\u5E38 2-5 \u4E2A\u8BCD\uFF0C\u82F1\u6587\u4E0D\u8D85\u8FC7 6 \u4E2A\u8BCD\u30024) \u4F7F\u7528\u5BF9\u8BDD\u4E3B\u8BED\u8A00\uFF1B\u6DF7\u5408\u8BED\u8A00\u65F6\u4F18\u5148\u7528\u6237\u4E3B\u8981\u8BED\u8A00\u30025) \u4F18\u5148\u590D\u7528\u5BF9\u8BDD\u4E2D\u7684\u5177\u4F53\u4E3B\u9898\u8BCD\uFF0C\u907F\u514D issue\u3001help\u3001discussion\u3001analysis\u3001update \u8FD9\u7C7B\u7A7A\u6CDB\u8BCD\u30026) \u5FFD\u7565 tool JSON\u3001\u51FD\u6570\u540D\u3001branch label\u3001agent \u540D\u3001\u7CFB\u7EDF\u6307\u4EE4\u548C\u7F16\u6392\u75D5\u8FF9\uFF08\u5982 GPT\u3001Claude\u3001Gemini\uFF09\uFF1B\u6807\u9898\u8981\u843D\u5728\u7528\u6237\u771F\u6B63\u8BA8\u8BBA\u7684\u5BF9\u8C61\u6216\u51B3\u7B56\u4E0A\u30027) \u66F4\u504F\u597D\u201C\u5BF9\u8C61 + \u52A8\u4F5C/\u5224\u65AD\u201D\u7684\u77ED\u6807\u9898\uFF0C\u4F8B\u5982\u201CAI \u90AE\u4EF6\u52A9\u624B\u53D6\u820D\u201D\u201C\u4E1C\u4EAC\u56DB\u65E5\u6162\u65C5\u884C\u201D\u201C\u91CD\u590D\u6263\u8D39\u9000\u6B3E\u201D\u30028) \u7EAF\u6587\u672C\uFF0C\u4E0D\u8981\u9879\u76EE\u7B26\u53F7\u3001\u7F16\u53F7\u3001markdown\u3001emoji\u3002\u6700\u7EC8\u53EA\u8FD4\u56DE\u6807\u9898\u6587\u672C\u3002 Output only the title text."
+};
+var BUILTIN_SUMMARY_LLM_CONFIG = {
+  ...BASE_BUILTIN_DIALOG_LLM_CONFIG,
+  provider: "nolo",
+  id: "builtin-dialog-summary-llm",
+  name: "Builtin Dialog Summary LLM",
+  model: "deepseek-v4-flash",
+  // @deprecated 用 COMPACTION_SUMMARY_SYSTEM_PROMPT（packages/ai/context/compactionShared.ts）。
+  // 生产代码已全部迁移；此旧两段式 prompt 仅被 scripts/probes/dialog 探针脚本使用，待探针迁移后删除。
+  prompt: "\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684\u5BF9\u8BDD\u8BB0\u5FC6\u52A9\u7406\u3002\u8BF7\u57FA\u4E8E\u3010\u73B0\u6709\u8BB0\u5FC6\u3011\u548C\u3010\u65B0\u589E\u5BF9\u8BDD\u3011\uFF0C\u8F93\u51FA\u4E00\u4EFD\u66F4\u65B0\u540E\u7684\u5BF9\u8BDD\u8BB0\u5FC6\u6863\u6848\u3002\u4E25\u683C\u53EA\u8F93\u51FA\u4E0B\u9762\u4E24\u90E8\u5206\uFF0C\u6807\u9898\u5FC5\u987B\u5B8C\u5168\u4E00\u81F4\uFF1A\n\u5173\u952E\u4E8B\u5B9E\u6863\u6848\n- ...\n\u5BF9\u8BDD\u5267\u60C5\u6458\u8981\n- ...\n\u8981\u6C42\uFF1A1) \u4F7F\u7528\u5BF9\u8BDD\u4E3B\u8BED\u8A00\uFF1B\u6DF7\u5408\u8BED\u8A00\u65F6\u4F18\u5148\u8DDF\u968F\u7528\u6237\u4E3B\u8981\u8BED\u8A00\uFF0C\u4E13\u6709\u540D\u8BCD\u4FDD\u7559\u539F\u6587\u30022) \u5173\u952E\u4E8B\u5B9E\u6863\u6848\u53EA\u4FDD\u7559\u4E4B\u540E\u7EE7\u7EED\u5BF9\u8BDD\u4ECD\u6709\u4EF7\u503C\u7684\u4FE1\u606F\uFF0C\u4F8B\u5982\u7528\u6237\u504F\u597D\u3001\u76EE\u6807\u3001\u7EA6\u675F\u3001\u6280\u672F\u6808\u3001\u786E\u5B9A\u7684\u6587\u4EF6\u540D/\u53D8\u91CF\u540D\u3001\u6838\u5FC3\u51B3\u7B56\u3001\u5F85\u529E\u4E8B\u9879\u30023) \u5BF9\u8BDD\u5267\u60C5\u6458\u8981\u5148\u6781\u7B80\u6982\u62EC\u65E7\u4E0A\u4E0B\u6587\uFF0C\u518D\u66F4\u8BE6\u7EC6\u8BB0\u5F55\u6700\u8FD1\u65B0\u589E\u7684\u8FDB\u5C55\u3001\u5206\u6B67\u3001\u7ED3\u8BBA\u548C\u4E0B\u4E00\u6B65\u30024) \u5FFD\u7565\u5BD2\u6684\u3001\u91CD\u590D\u5C1D\u8BD5\u3001\u5DF2\u653E\u5F03\u65B9\u6848\u548C\u65E0\u4EF7\u503C\u5E9F\u8BDD\u30025) \u4E0D\u8981\u7F16\u9020\u672A\u51FA\u73B0\u7684\u4FE1\u606F\uFF0C\u4E0D\u8981\u8F93\u51FA\u5F00\u573A\u767D\u3001\u7ED3\u675F\u8BED\u3001markdown \u4EE3\u7801\u5757\u6216\u989D\u5916\u7AE0\u8282\u3002"
+};
+
+// packages/core/chat/messageContentSerialize.ts
+var serializeMessageContent = (content, imagePlaceholder = "[\u56FE\u7247]") => {
+  if (typeof content === "string") {
+    return content.trim() || null;
+  }
+  if (Array.isArray(content)) {
+    const fragments = [];
+    for (const part of content) {
+      if (!part || typeof part !== "object") continue;
+      if (part.type === "text" && typeof part.text === "string") {
+        const text = part.text.trim();
+        if (text) fragments.push(text);
+      } else if (part.type === "image_url") {
+        fragments.push(imagePlaceholder);
+      }
+    }
+    const joined = fragments.join("\n").trim();
+    return joined || null;
+  }
+  return null;
+};
+
+// packages/app/utils/imageUtils.ts
+var BYTES_PER_MB = 1024 * 1024;
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var parseDataUrl = (dataUrl) => {
+  const trimmed = dataUrl.trim();
+  const parts = trimmed.split(",");
+  if (parts.length < 2 || !parts[0] || !parts[1]) {
+    console.warn("[imageUtils] parseDataUrl: invalid data URL", {
+      hasHeader: !!parts[0],
+      hasBody: !!parts[1]
+    });
+    return null;
+  }
+  const header = parts[0];
+  const base64 = parts[1];
+  const mimeMatch = header.match(/:(.*?);/);
+  const mime = mimeMatch?.[1];
+  if (!mime) {
+    console.warn("[imageUtils] parseDataUrl: cannot extract mime from", header);
+    return null;
+  }
+  return { mime, base64 };
+};
+function dataURLtoFile(dataUrl, filename) {
+  try {
+    const parsed = parseDataUrl(dataUrl);
+    if (!parsed) return null;
+    const { mime, base64 } = parsed;
+    const binaryString = atob(base64);
+    const length = binaryString.length;
+    const u8arr = new Uint8Array(length);
+    for (let i = 0; i < length; i++) {
+      u8arr[i] = binaryString.charCodeAt(i);
+    }
+    return new File([u8arr], filename, { type: mime });
+  } catch (error) {
+    console.error("[imageUtils] Error converting data URL to File:", error);
+    return null;
+  }
+}
+var appendNoCacheQuery = (url) => {
+  const stamp = `_t=${Date.now()}`;
+  return url.includes("?") ? `${url}&${stamp}` : `${url}?${stamp}`;
+};
+var tryLoadImage = (url) => new Promise((resolve) => {
+  const img = new Image();
+  const cleanup = () => {
+    img.onload = null;
+    img.onerror = null;
+  };
+  img.onload = () => {
+    cleanup();
+    resolve(true);
+  };
+  img.onerror = () => {
+    cleanup();
+    resolve(false);
+  };
+  img.src = url;
+});
+var waitForFileReady = async (url, {
+  maxWaitMs = 4e3,
+  intervalMs = 250
+} = {}) => {
+  const start = Date.now();
+  while (Date.now() - start < maxWaitMs) {
+    const tryUrl = appendNoCacheQuery(url);
+    const ok = await tryLoadImage(tryUrl);
+    if (ok) {
+      console.debug("[imageUtils] waitForFileReady: image loaded for", url);
+      return true;
+    }
+    await sleep(intervalMs);
+  }
+  console.warn("[imageUtils] waitForFileReady: timeout for", url);
+  return false;
+};
+
+// packages/database/fileUrl.ts
+var normalizeFileId = (fileId) => {
+  if (typeof fileId !== "string") return "";
+  return fileId.trim();
+};
+var buildDatabaseFileContentUrl = (serverOrigin, fileId) => {
+  const normalizedServer = normalizeServerOrigin(serverOrigin);
+  const normalizedFileId = normalizeFileId(fileId);
+  if (!normalizedServer || !normalizedFileId) {
+    return null;
+  }
+  return `${normalizedServer}${API_ENDPOINTS.DATABASE}/file/content/${normalizedFileId}`;
+};
+
+// packages/chat/messages/fileUrl.ts
+var buildMessageFileContentUrl = (serverOrigin, fileId) => buildDatabaseFileContentUrl(serverOrigin, fileId);
+
+// packages/chat/messages/imagePayloadPersistence.ts
+var stripDurableImageInlinePayload = (part) => {
+  if (!part || typeof part !== "object") return part;
+  const { original_data_url: _originalDataUrl, ...withoutOriginalDataUrl } = part;
+  if (withoutOriginalDataUrl.type !== "image_url" || !withoutOriginalDataUrl.google_native || typeof withoutOriginalDataUrl.google_native !== "object") {
+    return withoutOriginalDataUrl;
+  }
+  const { google_native: _googleNative, ...durablePart } = withoutOriginalDataUrl;
+  return durablePart;
+};
+
+// packages/chat/messages/messageContent.ts
+var isDataUrlImage = (url) => typeof url === "string" && url.startsWith("data:image");
+var uploadGeneratedImageDataUrl = async (url, dialogId, messageId, index, dispatch, getState, options) => {
+  const fileName = `generated-image-${dialogId}-${messageId}-${index}.png`;
+  const file = dataURLtoFile(url, fileName);
+  if (!file) {
+    console.warn(
+      "[messageContent] dataURLtoFile failed, drop generated image inline payload"
+    );
+    return null;
+  }
+  const customKey = `generated-image-${dialogId}-${messageId}-${index}`;
+  let metadata;
+  try {
+    metadata = await dispatch(upload({ file, customKey })).unwrap();
+  } catch (err) {
+    console.warn(
+      "[messageContent] upload generated image failed, drop inline payload:",
+      err
+    );
+    return null;
+  }
+  const state = getState();
+  const { currentServer } = getRuntimeServerContext(state);
+  const fileId = metadata?.dbKey || metadata?.id;
+  if (!currentServer || !fileId) {
+    console.warn(
+      "[messageContent] missing currentServer or fileId, drop inline payload",
+      { currentServer, fileId }
+    );
+    return null;
+  }
+  if (options?.spaceId) {
+    try {
+      const agentPrefix = options.agentName ? `[${options.agentName}] ` : "";
+      const title = `${agentPrefix}Generated Image ${index + 1}`;
+      await addContentAction({
+        spaceId: options.spaceId,
+        contentKey: fileId,
+        title,
+        type: "image" /* IMAGE */
+      }, { dispatch, getState });
+      console.log(`[messageContent] Saved generated image to space: ${options.spaceId}`);
+    } catch (err) {
+      console.error("[messageContent] Failed to save generated image to space:", err);
+    }
+  }
+  const imageUrl = buildMessageFileContentUrl(currentServer, fileId);
+  if (!imageUrl) {
+    return null;
+  }
+  const ready = await waitForFileReady(imageUrl);
+  if (!ready) {
+    console.warn(
+      "[messageContent] uploaded generated image not ready, drop inline payload:",
+      imageUrl
+    );
+    return null;
+  }
+  return imageUrl;
+};
+var normalizeAssistantContentBuffer = async (contentBuffer, dialogId, messageId, dispatch, getState, options) => {
+  if (!Array.isArray(contentBuffer) || contentBuffer.length === 0) {
+    return contentBuffer;
+  }
+  const updated = await Promise.all(
+    contentBuffer.map(async (part, index) => {
+      if (!part || part.type !== "image_url" || !part.image_url || !isDataUrlImage(part.image_url.url)) {
+        return part;
+      }
+      const newUrl = await uploadGeneratedImageDataUrl(
+        part.image_url.url,
+        dialogId,
+        messageId,
+        index,
+        dispatch,
+        getState,
+        options
+      );
+      if (!newUrl) {
+        return {
+          type: "text",
+          text: "[\u56FE\u7247\u4FDD\u5B58\u5931\u8D25\uFF0C\u8BF7\u91CD\u8BD5\u751F\u6210\u56FE\u7247]"
+        };
+      }
+      return stripDurableImageInlinePayload({
+        ...part,
+        image_url: {
+          ...part.image_url,
+          url: newUrl
+        }
+      });
+    })
+  );
+  return updated;
+};
+
+// packages/ai/context/retention.ts
+var SAFE_BUFFER_RATIO = 0.95;
+var CACHE_FIRST_RETENTION_STRENGTH = 0.95;
+var clamp = (v, min, max) => Math.min(max, Math.max(min, v));
+var planContextUsage = (params) => {
+  const { contextWindow, summaryTokens, recentLoad } = params;
+  const safeWindowLimit = Math.floor(contextWindow * SAFE_BUFFER_RATIO);
+  const iq = CACHE_FIRST_RETENTION_STRENGTH;
+  const isLargeWindow = contextWindow >= 512e3;
+  const isSmallWindow = contextWindow <= 64e3;
+  let baseHistoryRatio;
+  if (isLargeWindow) {
+    baseHistoryRatio = 0.8 + 0.2 * iq;
+  } else if (isSmallWindow) {
+    baseHistoryRatio = 0.35 + 0.3 * iq;
+  } else {
+    baseHistoryRatio = 0.55 + 0.3 * iq;
+  }
+  let historyRatio = baseHistoryRatio;
+  switch (recentLoad) {
+    case "light": {
+      const maxRatio = isLargeWindow ? 1 : isSmallWindow ? 0.75 : 0.85;
+      historyRatio = clamp(historyRatio * 1.05, 0.3, maxRatio);
+      break;
+    }
+    case "heavy": {
+      const maxRatio = isLargeWindow ? 0.98 : isSmallWindow ? 0.7 : 0.8;
+      const multiplier = isLargeWindow ? 0.98 : isSmallWindow ? 0.9 : 0.9;
+      historyRatio = clamp(historyRatio * multiplier, 0.3, maxRatio);
+      break;
+    }
+    case "medium":
+    default: {
+      const maxRatio = isLargeWindow ? 1 : isSmallWindow ? 0.75 : 0.85;
+      historyRatio = clamp(historyRatio, 0.3, maxRatio);
+      break;
+    }
+  }
+  const historyBudget = Math.max(
+    0,
+    Math.floor(safeWindowLimit * historyRatio)
+  );
+  const minRawRatio = isSmallWindow ? 0.5 : isLargeWindow ? 0.2 : 0.3;
+  const rawMessageBudget = Math.max(
+    Math.floor(historyBudget * minRawRatio),
+    historyBudget - summaryTokens,
+    0
+  );
+  let minTailTokens;
+  if (recentLoad === "light") {
+    minTailTokens = Math.min(
+      Math.floor(safeWindowLimit * 0.3),
+      8e3
+    );
+  } else if (recentLoad === "heavy") {
+    minTailTokens = Math.max(
+      Math.floor(safeWindowLimit * 0.25),
+      16e3
+    );
+  } else {
+    minTailTokens = Math.floor(safeWindowLimit * 0.2);
+  }
+  return { historyBudget, rawMessageBudget, minTailTokens };
+};
+
+// packages/ai/context/planCompression.ts
+var MIN_COMPRESS_COUNT = 5;
+var ACTIVE_SUMMARY_TAIL_KEEP_COUNT = 2;
+var getMessageTokenCount = (msg) => {
+  const content = serializeMessageContent(msg.content) || "";
+  let tokens = estimateTokenCount(content);
+  if (Array.isArray(msg.tool_calls)) {
+    for (const call of msg.tool_calls) {
+      const fn = call?.function;
+      if (fn?.name) tokens += estimateTokenCount(fn.name);
+      const args = fn?.arguments;
+      if (args) {
+        tokens += estimateTokenCount(
+          typeof args === "string" ? args : JSON.stringify(args)
+        );
+      }
+    }
+  }
+  return tokens;
+};
+var hasOpenEndedToolCall = (msg) => !!msg && Array.isArray(msg.tool_calls) && msg.tool_calls.length > 0;
+var isActiveSummaryWorthDoing = (pendingTokens, contextWindow) => {
+  const minTokens = Math.min(
+    4e4,
+    Math.max(1e4, Math.floor(contextWindow * 0.05))
+  );
+  return pendingTokens >= minTokens;
+};
+var classifyConversationLoad = (msgs) => {
+  const N = 20;
+  if (!Array.isArray(msgs) || msgs.length === 0) return "light";
+  const tail = msgs.slice(-N);
+  const tokenSamples = tail.map(getMessageTokenCount);
+  if (tokenSamples.length === 0) return "light";
+  const sum = tokenSamples.reduce((acc, v) => acc + v, 0);
+  const avg = sum / tokenSamples.length;
+  const sorted = [...tokenSamples].sort((a, b) => a - b);
+  const p95 = sorted[Math.floor((sorted.length - 1) * 0.95)];
+  if (p95 < 200 && avg < 120) {
+    return "light";
+  }
+  if (p95 > 2e3 || avg > 1200) {
+    return "heavy";
+  }
+  return "medium";
+};
+var normalizeContextUsageRatio = (value) => {
+  if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
+  const ratio = value > 1 ? value / 100 : value;
+  return ratio >= 0 && ratio <= 1 ? ratio : void 0;
+};
+var emptyPlan = (startIndex) => ({
+  shouldCompress: false,
+  compressCount: 0,
+  msgsToCompress: [],
+  msgsToKeep: [],
+  newSummarizedBeforeId: void 0,
+  startIndex
+});
+function findPendingMessages(allMsgs, summarizedBeforeId) {
+  let startIndex = 0;
+  if (summarizedBeforeId) {
+    const found = allMsgs.findIndex((m) => m.id === summarizedBeforeId);
+    if (found !== -1) startIndex = found + 1;
+  }
+  return { pendingMsgs: allMsgs.slice(startIndex), startIndex };
+}
+function shouldTriggerCompaction(args) {
+  const {
+    pendingTokens,
+    summaryTokens,
+    contextWindow,
+    historyBudget,
+    force,
+    reason,
+    realContextUsagePercent,
+    lastCompactedTokenCount,
+    lastMsg
+  } = args;
+  const totalUsed = summaryTokens + pendingTokens;
+  const usageRatio = normalizeContextUsageRatio(realContextUsagePercent);
+  let shouldTriggerByUsage = false;
+  if (usageRatio !== void 0) {
+    if (usageRatio >= 0.78) {
+      shouldTriggerByUsage = true;
+    } else if (usageRatio >= 0.65 && isActiveSummaryWorthDoing(pendingTokens, contextWindow)) {
+      shouldTriggerByUsage = true;
+    }
+  }
+  if (totalUsed >= historyBudget) {
+    shouldTriggerByUsage = true;
+  }
+  if (typeof lastCompactedTokenCount === "number" && Number.isFinite(lastCompactedTokenCount) && lastCompactedTokenCount >= 0 && !force && !(usageRatio !== void 0 && usageRatio >= 0.78)) {
+    const minNewTokensToCompress = Math.min(4e4, Math.max(5e3, Math.floor(contextWindow * 0.03)));
+    if (totalUsed < lastCompactedTokenCount + minNewTokensToCompress) {
+      return { trigger: false, triggeredByRealUsage: false, shouldRunActiveSummary: false };
+    }
+  }
+  const shouldRunActiveSummary = force && reason === "manual" && !hasOpenEndedToolCall(lastMsg) && isActiveSummaryWorthDoing(pendingTokens, contextWindow);
+  const triggeredByRealUsage = usageRatio !== void 0 && shouldTriggerByUsage;
+  return { trigger: shouldTriggerByUsage || shouldRunActiveSummary, triggeredByRealUsage, shouldRunActiveSummary };
+}
+function calculateCompressCount(pendingMsgs, rawMessageBudget, opts) {
+  const { keepTailCount, totalUsed, historyBudget } = opts;
+  if (keepTailCount && totalUsed < historyBudget) {
+    return Math.max(0, pendingMsgs.length - ACTIVE_SUMMARY_TAIL_KEEP_COUNT);
+  }
+  let tokensToKeep = 0;
+  let keepCount = 0;
+  for (let i = pendingMsgs.length - 1; i >= 0; i--) {
+    const t = getMessageTokenCount(pendingMsgs[i]);
+    if (tokensToKeep + t > rawMessageBudget) break;
+    tokensToKeep += t;
+    keepCount++;
+  }
+  return pendingMsgs.length - keepCount;
+}
+function guardToolChainBoundary(pendingMsgs, compressCount) {
+  let count = compressCount;
+  while (count > 0 && count < pendingMsgs.length && pendingMsgs[count].role === "tool") {
+    count--;
+  }
+  if (count > 0) {
+    const lastCompressed = pendingMsgs[count - 1];
+    if (hasOpenEndedToolCall(lastCompressed)) {
+      count--;
+    }
+  }
+  return count;
+}
+function planCompression(input) {
+  const {
+    allMsgs,
+    summarizedBeforeId,
+    summary,
+    contextWindow,
+    force = false,
+    reason,
+    realContextUsagePercent
+  } = input;
+  const { pendingMsgs, startIndex } = findPendingMessages(allMsgs, summarizedBeforeId);
+  if (pendingMsgs.length === 0) return emptyPlan(startIndex);
+  const summaryTokens = estimateTokenCount(summary || "");
+  const pendingTokens = pendingMsgs.reduce((sum, msg) => sum + getMessageTokenCount(msg), 0);
+  const totalUsed = summaryTokens + pendingTokens;
+  const adjustedSummaryTokens = Math.max(summaryTokens, 1e3);
+  const recentLoad = classifyConversationLoad(pendingMsgs);
+  const { historyBudget, rawMessageBudget } = planContextUsage({
+    contextWindow,
+    summaryTokens: adjustedSummaryTokens,
+    recentLoad
+  });
+  const { trigger, triggeredByRealUsage, shouldRunActiveSummary } = shouldTriggerCompaction({
+    pendingTokens,
+    summaryTokens,
+    contextWindow,
+    historyBudget,
+    force,
+    reason,
+    realContextUsagePercent,
+    lastCompactedTokenCount: input.lastCompactedTokenCount,
+    lastMsg: pendingMsgs[pendingMsgs.length - 1]
+  });
+  if (!trigger) return emptyPlan(startIndex);
+  let compressCount = calculateCompressCount(pendingMsgs, rawMessageBudget, {
+    keepTailCount: shouldRunActiveSummary || triggeredByRealUsage,
+    totalUsed,
+    historyBudget
+  });
+  compressCount = guardToolChainBoundary(pendingMsgs, compressCount);
+  if (compressCount < MIN_COMPRESS_COUNT) return emptyPlan(startIndex);
+  const msgsToCompress = pendingMsgs.slice(0, compressCount);
+  const msgsToKeep = pendingMsgs.slice(compressCount);
+  const newSummarizedBeforeId = msgsToCompress[msgsToCompress.length - 1].id;
+  return {
+    shouldCompress: true,
+    compressCount,
+    msgsToCompress,
+    msgsToKeep,
+    newSummarizedBeforeId,
+    startIndex
+  };
+}
+
+// packages/ai/context/compactionShared.ts
+var COMPACTION_SUMMARY_SYSTEM_PROMPT = `\u4F60\u662F\u5BF9\u8BDD\u4E0A\u4E0B\u6587\u538B\u7F29\u5668\u3002\u6839\u636E\u3010\u73B0\u6709\u8BB0\u5FC6\u3011\u548C\u3010\u65B0\u589E\u5BF9\u8BDD\u3011\uFF0C\u8F93\u51FA\u53EF\u66FF\u4EE3\u539F\u59CB\u6D88\u606F\u7684\u4E8B\u5B9E\u6027\u8981\u70B9\uFF0C\u4F9B\u540E\u7EED\u5BF9\u8BDD\u76F4\u63A5\u4F7F\u7528\u3002
+
+\u4E25\u683C\u53EA\u8F93\u51FA\u4E0B\u9762\u4E09\u90E8\u5206\uFF0C\u6807\u9898\u5FC5\u987B\u5B8C\u5168\u4E00\u81F4\uFF1A
+\u5173\u952E\u4E8B\u5B9E\u6863\u6848
+- ...
+\u5BF9\u8BDD\u8FDB\u5C55\u4E0E\u5F85\u529E
+- ...
+\u6587\u4EF6\u64CD\u4F5C\u6E05\u5355
+- ...
+
+\u8981\u6C42\uFF1A
+1) \u4F7F\u7528\u5BF9\u8BDD\u4E3B\u8BED\u8A00\uFF1B\u6DF7\u5408\u8BED\u8A00\u65F6\u4F18\u5148\u7528\u6237\u4E3B\u8981\u8BED\u8A00\uFF1B\u4E13\u6709\u540D\u8BCD\u3001\u6587\u4EF6\u8DEF\u5F84\u3001\u6807\u8BC6\u7B26\u3001\u547D\u4EE4\u4FDD\u7559\u539F\u6587\uFF0C\u4E0D\u8981\u7FFB\u8BD1\u6216\u8F6C\u8FF0\u3002
+2) \u5173\u952E\u4E8B\u5B9E\u6863\u6848\u53EA\u4FDD\u7559\u4E4B\u540E\u7EE7\u7EED\u5BF9\u8BDD\u4ECD\u6709\u4EF7\u503C\u7684\u4FE1\u606F\uFF1A\u7528\u6237\u76EE\u6807/\u504F\u597D\u3001\u7EA6\u675F\u3001\u6280\u672F\u6808\u3001\u786E\u5B9A\u7684\u6587\u4EF6\u8DEF\u5F84\u3001\u6838\u5FC3\u51B3\u7B56\u3001\u672A\u5B8C\u6210\u5F85\u529E\u3002\u4FDD\u7559\u786E\u5207\u503C\uFF08\u7AEF\u53E3\u53F7\u3001\u7248\u672C\u53F7\u3001\u8DEF\u5F84\u3001\u53D8\u91CF\u540D\u3001\u9519\u8BEF\u4FE1\u606F\u539F\u6587\uFF09\uFF0C\u4E0D\u8981\u6982\u62EC\u6210"\u67D0\u4E2A\u7AEF\u53E3"\u6216"\u67D0\u4E2A\u6587\u4EF6"\u6216"\u67D0\u62A5\u9519"\u3002
+3) \u5BF9\u8BDD\u8FDB\u5C55\u4E0E\u5F85\u529E\u4EE5\u7B2C\u4E00\u4EBA\u79F0\u7EED\u4F5C\u7B14\u8BB0\u7684\u53E3\u543B\u5199\uFF08"\u6211\u505A\u4E86\u2026""\u7528\u6237\u8981\u6C42\u2026""\u4E0B\u4E00\u6B65\u6211\u9700\u8981\u2026"\uFF09\uFF0C\u4E0D\u8981\u5199\u6210\u7B2C\u4E09\u65B9\u89C2\u5BDF\u62A5\u544A\u3002\u5148\u6781\u7B80\u6982\u62EC\u65E7\u4E0A\u4E0B\u6587\uFF0C\u518D\u66F4\u8BE6\u7EC6\u8BB0\u5F55\u6700\u8FD1\u8FDB\u5C55\u3001\u7ED3\u8BBA\u3001\u5206\u6B67\u4E0E\u4E0B\u4E00\u6B65\u3002\u5BF9\u4E8E\u58F0\u79F0\u5DF2\u5B8C\u6210\u4F46\u5C1A\u672A\u9A8C\u8BC1\u7684\u5DE5\u4F5C\uFF08\u5982\u5DE5\u5177\u8C03\u7528\u8FD4\u56DE\u6210\u529F\u4F46\u7ED3\u679C\u672A\u4EBA\u5DE5\u786E\u8BA4\uFF09\uFF0C\u660E\u786E\u6807\u6CE8"\uFF08\u5F85\u9A8C\u8BC1\uFF09"\u2014\u2014\u4E0D\u8981\u9ED8\u8BA4\u4FE1\u4EFB\u5DE5\u5177\u8FD4\u56DE\u503C\u3002
+4) \u6587\u4EF6\u64CD\u4F5C\u6E05\u5355\uFF1A\u5217\u51FA\u672C\u6B21\u538B\u7F29\u8303\u56F4\u5185\u8BFB\u53D6\u3001\u5199\u5165\u3001\u7F16\u8F91\u8FC7\u7684\u6587\u4EF6\u8DEF\u5F84\u53CA\u64CD\u4F5C\u7C7B\u578B\uFF08\u5982: - \u8BFB\u53D6: path/to/file\uFF1B\u82E5\u672A\u6D89\u53CA\u6587\u4EF6\u64CD\u4F5C\u5199"\u65E0"\uFF09\u3002
+5) \u5FFD\u7565\u5BD2\u6684\u3001\u91CD\u590D\u5C1D\u8BD5\u3001\u5DF2\u653E\u5F03\u65B9\u6848\u548C\u65E0\u4EF7\u503C\u5E9F\u8BDD\u3002
+6) \u4E0D\u8981\u7F16\u9020\u672A\u51FA\u73B0\u7684\u4FE1\u606F\uFF1B\u4E0D\u8981\u5F00\u573A\u767D\u3001\u7ED3\u675F\u8BED\u3001markdown \u4EE3\u7801\u5757\u6216\u989D\u5916\u7AE0\u8282\uFF1B\u4E0D\u8981\u8C03\u7528\u4EFB\u4F55\u5DE5\u5177\u3002`;
+function formatMessageContentFallback(msg) {
+  const content = serializeMessageContent(msg.content);
+  if (content) return content;
+  if (Array.isArray(msg.tool_calls)) {
+    return `[tool_calls:${msg.tool_calls.map((c) => c.function?.name).filter(Boolean).join(",")}]`;
+  }
+  return "[\u975E\u6587\u672C\u5185\u5BB9]";
+}
+function buildCompactionUserContent(args) {
+  const parts = [`\u3010\u73B0\u6709\u8BB0\u5FC6\u3011\uFF1A
+${args.previousSummary || "(\u65E0)"}`];
+  if (args.fileOpsText !== void 0) {
+    parts.push(`\u3010\u6587\u4EF6\u64CD\u4F5C\u6E05\u5355\u3011\uFF1A
+${args.fileOpsText || "\u65E0"}`);
+  }
+  parts.push(`\u3010\u65B0\u589E\u5BF9\u8BDD\u3011\uFF1A
+${args.messagesText}`);
+  return parts.join("\n\n").trim();
+}
+function extractFileOperationsFromCalls(calls, resolveCanonicalName) {
+  const result = [];
+  const seen = /* @__PURE__ */ new Set();
+  const fileOperationByTool = {
+    readFile: "read",
+    writeFile: "write",
+    editFile: "edit"
+  };
+  for (const call of calls) {
+    const rawName = call.function?.name || call.name || "";
+    if (!rawName) continue;
+    const canonicalName = resolveCanonicalName(rawName);
+    const opType = fileOperationByTool[canonicalName];
+    if (!opType) continue;
+    let rawArgs = call.function?.arguments;
+    let parsedArgs = null;
+    if (typeof rawArgs === "string") {
+      try {
+        parsedArgs = JSON.parse(rawArgs);
+      } catch {
+      }
+    } else if (typeof rawArgs === "object" && rawArgs !== null) {
+      parsedArgs = rawArgs;
+    }
+    const path = parsedArgs?.path ?? parsedArgs?.filePath ?? parsedArgs?.file;
+    if (typeof path === "string" && path.trim()) {
+      const key = `${opType}:${path.trim()}`;
+      if (!seen.has(key)) {
+        seen.add(key);
+        result.push({ type: opType, path: path.trim() });
+      }
+    }
+  }
+  return result;
+}
+function formatFileOperationsFromMessages(msgs, resolveCanonicalName) {
+  const allOps = [];
+  for (const msg of msgs) {
+    if (!Array.isArray(msg.tool_calls)) continue;
+    allOps.push(
+      ...extractFileOperationsFromCalls(msg.tool_calls, resolveCanonicalName)
+    );
+  }
+  if (allOps.length === 0) return "\u65E0";
+  const typeLabelMap = {
+    read: "\u8BFB\u53D6",
+    write: "\u5199\u5165",
+    edit: "\u7F16\u8F91"
+  };
+  return allOps.map((op) => `- ${typeLabelMap[op.type]}: ${op.path}`).join("\n");
+}
+var TOOL_RESULT_TRUNCATE_CHARS = 4e3;
+function truncateContentForSummary(role, content, maxChars = TOOL_RESULT_TRUNCATE_CHARS) {
+  if (role !== "tool" || content.length <= maxChars) return content;
+  const truncated = content.slice(0, maxChars);
+  const omitted = content.length - maxChars;
+  return `${truncated}
+
+[... ${omitted} chars truncated ...]`;
+}
+function formatMessagesForSummaryWithTruncation(msgs, maxToolResultChars = TOOL_RESULT_TRUNCATE_CHARS) {
+  return msgs.map((msg) => {
+    const rawContent = serializeMessageContent(msg.content) || "";
+    const truncated = truncateContentForSummary(
+      msg.role,
+      rawContent,
+      maxToolResultChars
+    );
+    const text = truncated || formatMessageContentFallback(msg);
+    return `${msg.role}: ${text}`;
+  }).join("\n");
+}
+function buildCompactionMetrics(args) {
+  const {
+    reason,
+    previousSummary,
+    msgsToCompress,
+    msgsToKeep,
+    newSummary,
+    summaryUsage,
+    estimateTokens,
+    estimateMessageTokens
+  } = args;
+  return {
+    reason,
+    previousSummaryTokens: estimateTokens(previousSummary || ""),
+    compressedTokens: msgsToCompress.reduce((s, m) => s + estimateMessageTokens(m), 0),
+    retainedTokens: msgsToKeep.reduce((s, m) => s + estimateMessageTokens(m), 0),
+    newSummaryTokens: estimateTokens(newSummary || ""),
+    compressedCount: msgsToCompress.length,
+    retainedCount: msgsToKeep.length,
+    summaryUsage,
+    hadPreviousSummary: previousSummary.trim().length > 0
+  };
+}
+function buildCompactionMetricsFromPlan(args) {
+  return buildCompactionMetrics({
+    reason: args.reason,
+    previousSummary: args.previousSummary,
+    msgsToCompress: args.plan.msgsToCompress,
+    msgsToKeep: args.plan.msgsToKeep,
+    newSummary: args.newSummary,
+    summaryUsage: args.summaryUsage,
+    estimateTokens: estimateTokenCount,
+    estimateMessageTokens: getMessageTokenCount
+  });
+}
+function formatCompactionMetricsLog(metrics) {
+  const totalBefore = metrics.previousSummaryTokens + metrics.compressedTokens;
+  const totalAfter = metrics.newSummaryTokens + metrics.retainedTokens;
+  const ratio = totalBefore > 0 ? (totalAfter / totalBefore).toFixed(2) : "N/A";
+  const llmInfo = metrics.summaryUsage ? `, summary_llm_in=${metrics.summaryUsage.input_tokens ?? "?"} out=${metrics.summaryUsage.output_tokens ?? "?"}` : "";
+  return `[Compaction] reason=${metrics.reason} compressed=${metrics.compressedCount}->${metrics.retainedCount} msgs, tokens=${totalBefore}->${totalAfter} (ratio=${ratio})${llmInfo}`;
+}
+
+// packages/core/clipCompactText.ts
+function clipCompactText(value, max, ellipsis = "...") {
+  const compact = compactWhitespace(value);
+  if (compact.length <= max) return compact;
+  if (max <= ellipsis.length) return compact.slice(0, max);
+  return `${compact.slice(0, max - ellipsis.length)}${ellipsis}`;
+}
+
+export {
+  clipCompactText,
+  estimateTokenCount,
+  buildDatabaseFileContentUrl,
+  BUILTIN_TITLE_LLM_CONFIG,
+  BUILTIN_SUMMARY_LLM_CONFIG,
+  serializeMessageContent,
+  normalizeAssistantContentBuffer,
+  planContextUsage,
+  planCompression,
+  COMPACTION_SUMMARY_SYSTEM_PROMPT,
+  buildCompactionUserContent,
+  formatFileOperationsFromMessages,
+  formatMessagesForSummaryWithTruncation,
+  buildCompactionMetricsFromPlan,
+  formatCompactionMetricsLog
+};