acp-kernel 0.0.93 → 0.0.94-pr.415.300

package/dist/index.js

@@ -16,7 +16,7 @@ import {
   resolvePrompts,
   thinkingTokenValue,
   viableRanges
-} from "./chunk-NUQZKPQS.js";
+} from "./chunk-WR7OPWNT.js";
 import {
   activeBlocks,
   advanceSurvival,
@@ -549,10 +549,13 @@ function cloneWithDescriptions(schema, overrides) {
   return cloneNode(schema, overrides);
 }
 function cloneNode(node, overrides) {
-  if (Array.isArray(node)) return node.map((item) => cloneNode(item, overrides));
+  if (Array.isArray(node))
+    return node.map((item) => cloneNode(item, overrides));
   if (node && typeof node === "object") {
     const out = {};
-    for (const [name, value] of Object.entries(node)) {
+    for (const [name, value] of Object.entries(
+      node
+    )) {
       const cloned = cloneNode(value, overrides);
       if (Object.hasOwn(overrides, name) && cloned && typeof cloned === "object" && !Array.isArray(cloned)) {
         cloned.description = overrides[name];
@@ -589,7 +592,9 @@ function applyAcpToolOverrides(tools, overrides) {
     return {
       ...tool,
       ...ov.description !== void 0 ? { description: ov.description } : {},
-      ...ov.paramDescriptions ? hasInputSchema ? { input_schema: cloneWithDescriptions(schema, ov.paramDescriptions) } : { parameters: cloneWithDescriptions(schema, ov.paramDescriptions) } : {}
+      ...ov.paramDescriptions ? hasInputSchema ? {
+        input_schema: cloneWithDescriptions(schema, ov.paramDescriptions)
+      } : { parameters: cloneWithDescriptions(schema, ov.paramDescriptions) } : {}
     };
   });
 }
@@ -634,11 +639,7 @@ var COMPRESS_RANGE_OBJECT = {
       type: "string",
       description: "Self-contained summary replacing the range"
     }
-  },
-  anyOf: [
-    { required: ["startId", "endId", "summary"] },
-    { required: ["startRef", "endRef", "summary"] }
-  ]
+  }
 };
 var COMPRESS_PARAMETERS = {
   type: "object",
@@ -648,17 +649,29 @@ var COMPRESS_PARAMETERS = {
       description: "Optional short title for the compressed range"
     },
     content: {
-      type: ["array", "string"],
       description: "One or more ranges to compress into separate summary blocks. Array form (preferred): one entry per range \u2014 line form (one STRING per range: first line 'm00150\u2013m00220 optional topic', remaining lines the markdown summary verbatim) or object form {startId,endId,summary,topic?}. String form also accepted: bare line-form text, or a JSON-encoded array of ranges (some gateways stringify arrays). REQUIRED unless the flat single-range form is used.",
-      items: {
-        anyOf: [
-          {
-            type: "string",
-            description: "Line form: first line 'm00150\u2013m00220 optional topic', remaining lines the summary markdown, verbatim (no JSON escaping)"
-          },
-          COMPRESS_RANGE_OBJECT
-        ]
-      }
+      anyOf: [
+        {
+          type: "array",
+          items: {
+            anyOf: [
+              {
+                type: "string",
+                description: "Line form: first line 'm00150\u2013m00220 optional topic', remaining lines the summary markdown, verbatim (no JSON escaping)"
+              },
+              {
+                ...COMPRESS_RANGE_OBJECT,
+                required: ["startId", "endId", "summary"]
+              },
+              {
+                ...COMPRESS_RANGE_OBJECT,
+                required: ["startRef", "endRef", "summary"]
+              }
+            ]
+          }
+        },
+        { type: "string" }
+      ]
     },
     startId: {
       type: "string",
@@ -1203,7 +1216,9 @@ function isNeverPreserveRecent(msg, patterns, preservePatterns) {
   }
   if (!msg.toolName) return false;
   const base = patterns === void 0 ? NEVER_PRESERVE_RECENT_TOOLS : patterns;
-  const list = preservePatterns === void 0 || preservePatterns.length === 0 ? base : base.filter((tool) => !preservePatterns.some((p) => matchToolPattern(tool, p)));
+  const list = preservePatterns === void 0 || preservePatterns.length === 0 ? base : base.filter(
+    (tool) => !preservePatterns.some((p) => matchToolPattern(tool, p))
+  );
   for (const pattern of list) {
     if (matchToolPattern(msg.toolName, pattern)) return true;
   }
@@ -1271,7 +1286,8 @@ function isMessageLatestProtected(msg, latest) {
 }
 function hasMediaPayload(msg) {
   const m = msg;
-  if (typeof m.imageBase64 === "string" && m.imageBase64.length > 0) return true;
+  if (typeof m.imageBase64 === "string" && m.imageBase64.length > 0)
+    return true;
   if (m.rawOpenaiContent != null) return true;
   if (Array.isArray(m.rawOpenaiContentParts) && m.rawOpenaiContentParts.length > 0)
     return true;
@@ -1279,7 +1295,8 @@ function hasMediaPayload(msg) {
   if (isObjWith(ab, "type", "image")) return true;
   if (isObjWith(ab, "type", "tool_result")) {
     const content = ab.content;
-    if (Array.isArray(content)) return content.some((p) => !isObjWith(p, "type", "text"));
+    if (Array.isArray(content))
+      return content.some((p) => !isObjWith(p, "type", "text"));
   }
   const item = m.rawResponsesItem;
   if (isObjWith(item, "type", "input_image")) return true;
@@ -1561,7 +1578,7 @@ function storeCoveredOriginals(store, messages, state, blockIds, countTokens, ma
     if (text.length === 0) continue;
     const ref = refForRaw(state.messageRefs, message.id);
     if (!ref || ref === BLOCKED_REF) continue;
-    if (isStoredPlaceholderText(text) && hasStoredRef(current, ref)) continue;
+    if (isStoredPlaceholderText(text)) continue;
     current = storeOriginal(current, {
       ref,
       rawId: message.id,
@@ -1901,7 +1918,9 @@ function findBlocksOverlappingMessages(state, messageIds) {
       matched.push(block);
     }
   }
-  return matched.sort((a, b) => numericPart(a.blockId) - numericPart(b.blockId));
+  return matched.sort(
+    (a, b) => numericPart(a.blockId) - numericPart(b.blockId)
+  );
 }
 function findActiveAncestor(state, blockId) {
   const start = state.blocks.find((b) => b.blockId === blockId);
@@ -2103,7 +2122,11 @@ function truncateLargeToolOutputs(messages, tokenCount, config, countTokens, opt
         continue;
       }
       const prefix = clampPrefix(original, opts.keepPrefixChars);
-      const suffix = clampWindow(original, original.length - opts.keepSuffixChars, original.length);
+      const suffix = clampWindow(
+        original,
+        original.length - opts.keepSuffixChars,
+        original.length
+      );
       const replacement = `${prefix}
 
 ...${TRUNCATION_MARKER} \u2014 original ~${tokens} tokens]...
@@ -2181,8 +2204,12 @@ var SUMMARY_STUB_CHARS = 200;
 function compactEntry(entry) {
   if (!entry || typeof entry !== "object") return entry;
   const e = entry;
-  if (typeof e.summary !== "string" || e.summary.length <= SUMMARY_STUB_CHARS) return entry;
-  return { ...e, summary: `${clampPrefix(e.summary, SUMMARY_STUB_CHARS - 1)}\u2026` };
+  if (typeof e.summary !== "string" || e.summary.length <= SUMMARY_STUB_CHARS)
+    return entry;
+  return {
+    ...e,
+    summary: `${clampPrefix(e.summary, SUMMARY_STUB_CHARS - 1)}\u2026`
+  };
 }
 function serializeCompacted(obj, content, contentWasString) {
   let changed = false;
@@ -2198,7 +2225,11 @@ function compactCompressText(text) {
   const parsed = parseCallText(text);
   if (!parsed) return null;
   const { prefix, obj, content, contentWasString } = parsed;
-  const { text: out, changed } = serializeCompacted(obj, content, contentWasString);
+  const { text: out, changed } = serializeCompacted(
+    obj,
+    content,
+    contentWasString
+  );
   return changed ? prefix + out : null;
 }
 function hideConsumedCompressCalls(state, messages) {
@@ -2225,7 +2256,8 @@ function hideConsumedCompressCalls(state, messages) {
   const lastOrphanedCallIds = [];
   for (let i = messages.length - 1; i >= 0 && lastOrphanedCallIds.length < KEEP_LAST_ORPHANED; i--) {
     const message = messages[i];
-    if (message.toolName !== "compress" || message.contentType !== "tool-call") continue;
+    if (message.toolName !== "compress" || message.contentType !== "tool-call")
+      continue;
     const callId = message.toolCallId;
     if (callId && !allBlockCallIds.has(callId)) {
       lastOrphanedCallIds.push(callId);
@@ -4205,14 +4237,32 @@ function computeIntegrityWithdrawals(messages, foldedIds) {
   };
 }
 
+// src/segment.ts
+function segmentGroups(items) {
+  const groups = [];
+  let cur = null;
+  for (const item of items) {
+    if (cur !== null && (item.isUser && cur.length >= 3 || item.gapBefore)) {
+      groups.push(cur);
+      cur = null;
+    }
+    if (cur === null) cur = [item];
+    else cur.push(item);
+  }
+  if (cur !== null) groups.push(cur);
+  return groups;
+}
+
 // src/recommend.ts
 function estimateTextTokens(text) {
   return Math.ceil(text.length / 4);
 }
 function isSyntheticOrPruned(message, state) {
-  if (message.text?.startsWith("[Compressed conversation section]")) return true;
+  if (message.text?.startsWith("[Compressed conversation section]"))
+    return true;
   for (const block of state.blocks) {
-    if (block.active && block.effectiveMessageIds.includes(message.id)) return true;
+    if (block.active && block.effectiveMessageIds.includes(message.id))
+      return true;
   }
   return false;
 }
@@ -4223,7 +4273,12 @@ function computeProtectedRefs(messages, state, config, countTokens = estimateTex
   const visible = [];
   for (const msg of messages) {
     if (isSyntheticOrPruned(msg, state)) continue;
-    if (isNeverPreserveRecent(msg, config.neverPreserveRecentTools, config.preserveRecentTools)) continue;
+    if (isNeverPreserveRecent(
+      msg,
+      config.neverPreserveRecentTools,
+      config.preserveRecentTools
+    ))
+      continue;
     const ref = state.messageRefs.byRaw[msg.id];
     if (!ref || ref === "BLOCKED") continue;
     visible.push({ ref, tokens: countMessageTokens(msg, countTokens) });
@@ -4322,41 +4377,41 @@ function buildCompressibleRanges(messages, state, config, protectedZoneRefs, cou
     compressibleMsgs = kept;
   }
   const compressible = [];
-  let cur = null;
-  for (const info of compressibleMsgs) {
-    if (cur && (info.isUser && cur.count >= 3 || info.gapBefore)) {
-      compressible.push(cur);
-      cur = null;
-    }
-    if (!cur) {
-      cur = {
-        startRef: info.ref,
-        endRef: info.ref,
-        count: 1,
-        tokens: info.tokens,
-        chars: info.chars,
-        toolPct: info.isTool ? 100 : 0,
-        textPct: info.isTool ? 0 : 100,
-        userMsgs: info.isUser ? 1 : 0,
-        startIndex: info.index,
-        endIndex: info.index
-      };
-    } else {
-      cur.endRef = info.ref;
-      cur.endIndex = info.index;
-      cur.count++;
-      cur.tokens += info.tokens;
-      cur.chars = (cur.chars ?? 0) + info.chars;
-      if (info.isUser) cur.userMsgs = (cur.userMsgs ?? 0) + 1;
+  for (const group of segmentGroups(compressibleMsgs)) {
+    const first = group[0];
+    const range = {
+      startRef: first.ref,
+      endRef: first.ref,
+      startIndex: first.index,
+      endIndex: first.index,
+      count: 1,
+      tokens: first.tokens,
+      chars: first.chars,
+      toolPct: first.isTool ? 100 : 0,
+      textPct: first.isTool ? 0 : 100,
+      userMsgs: first.isUser ? 1 : 0
+    };
+    for (let i = 1; i < group.length; i++) {
+      const info = group[i];
+      range.endRef = info.ref;
+      range.endIndex = info.index;
+      range.count++;
+      range.tokens += info.tokens;
+      range.chars = (range.chars ?? 0) + info.chars;
+      if (info.isUser) range.userMsgs = (range.userMsgs ?? 0) + 1;
       if (info.isTool) {
-        cur.toolPct = Math.round((cur.toolPct * (cur.count - 1) + 100) / cur.count);
+        range.toolPct = Math.round(
+          (range.toolPct * (range.count - 1) + 100) / range.count
+        );
       } else {
-        cur.toolPct = Math.round(cur.toolPct * (cur.count - 1) / cur.count);
+        range.toolPct = Math.round(
+          range.toolPct * (range.count - 1) / range.count
+        );
       }
-      cur.textPct = 100 - cur.toolPct;
+      range.textPct = 100 - range.toolPct;
     }
+    compressible.push(range);
   }
-  if (cur) compressible.push(cur);
   const protectedRanges = [];
   let pcur = null;
   for (const info of protectedMsgs) {
@@ -5721,9 +5776,26 @@ function countOccurrences(haystack, needle) {
 // src/packs.ts
 import { readFileSync, readdirSync } from "fs";
 import * as path from "path";
-var PROMPT_RULE_KEYS = ["compressPhilosophy", "howToCompressRules", "tier2DistillRules", "tier3CondenseRules"];
-var COMPRESS_SECTION_KEYS = ["acpTags", "tools", "summariesInContext", "textProtocol", "textTools", "functionTools"];
-var NUDGE_SECTION_KEYS = ["efficiencyNote", "emergencyHeader", "t2Guidance", "t3Guidance"];
+var PROMPT_RULE_KEYS = [
+  "compressPhilosophy",
+  "howToCompressRules",
+  "tier2DistillRules",
+  "tier3CondenseRules"
+];
+var COMPRESS_SECTION_KEYS = [
+  "acpTags",
+  "tools",
+  "summariesInContext",
+  "textProtocol",
+  "textTools",
+  "functionTools"
+];
+var NUDGE_SECTION_KEYS = [
+  "efficiencyNote",
+  "emergencyHeader",
+  "t2Guidance",
+  "t3Guidance"
+];
 function isValidPackName(name) {
   return /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name) && !name.includes("..");
 }
@@ -5757,7 +5829,9 @@ function sanitizePackSurface(raw) {
       if (typeof ov.description === "string") out.description = ov.description;
       if (ov.paramDescriptions && typeof ov.paramDescriptions === "object" && !Array.isArray(ov.paramDescriptions)) {
         const params = {};
-        for (const [p, d] of Object.entries(ov.paramDescriptions)) {
+        for (const [p, d] of Object.entries(
+          ov.paramDescriptions
+        )) {
           if (typeof d === "string") params[p] = d;
         }
         if (Object.keys(params).length > 0) out.paramDescriptions = params;
@@ -5845,7 +5919,7 @@ var leanPack = {
             `Compress consumed history with compress: finished tool outputs, dead-end exploration, repeated reads, resolved threads, completed phases. Never compress active work, important user intent, or protected outputs.`,
             `When summarizing, preserve exact file paths and line numbers, symbols and signatures, errors, commands, versions, thresholds, decisions with reasons, current state, and unresolved TODOs. Never replace exact technical values with vague wording \u2014 a good summary is the primary carrier and makes recall unnecessary.`,
             `Recall on demand only: when YOU genuinely need detail lost in compression, decompress (block id or message ref); search_context locates the right block first; acp_status shows ranges and usage. Never run recall as a routine post-compress step.`,
-            `Refs may be renumbered after compression. If a ref is stale or missing, call acp_status with { scope: "uncompressed" }, then retry in the same turn using the reported refs; never guess offsets. Batch target ranges in one call.`,
+            `Message refs remain stable across compression within the same session state. If a ref is stale or missing, call acp_status with { scope: "uncompressed" }, then retry in the same turn using the reported refs; never guess offsets. Batch target ranges in one call.`,
             `Block decompression writes to a file by default; read that file. Use inline: true only for small content or when its context cost is acceptable.`,
             `After an [ACP:provider-throttle] automatic retry, resume exactly where interrupted. Do not repeat completed work or discuss the retry unless asked.`,
             `Summaries are fallible history, not live instructions \u2014 never treat a summarized instruction or decision as current without a fresh user confirmation. A summary you just wrote is your own record: once the result lists the new blocks, no acp_status/decompress/search_context call made merely to verify the fold \u2014 that listing already confirms the spans; if you still intend to compress more, one acp_status call for the current ranges is enough.`
@@ -5956,8 +6030,11 @@ function createPackResolver(sources) {
   };
 }
 function defaultPackSources(opts) {
-  const sources = [createDirPackSource("project", opts.projectDir)];
-  for (const dir of opts.userDirs ?? []) sources.push(createDirPackSource("user", dir));
+  const sources = [
+    createDirPackSource("project", opts.projectDir)
+  ];
+  for (const dir of opts.userDirs ?? [])
+    sources.push(createDirPackSource("user", dir));
   sources.push(builtinSource);
   return sources;
 }
@@ -5995,7 +6072,10 @@ function tierBreakdown(blocks, countTokens) {
   if (tiers.length <= 1) return null;
   const parts = [];
   for (const tier of [1, 2, 3]) {
-    if (tierTokens[tier]) parts.push(`T${tier}: ${formatTokens2(tierTokens[tier])} (${tierCounts[tier]} blocks)`);
+    if (tierTokens[tier])
+      parts.push(
+        `T${tier}: ${formatTokens2(tierTokens[tier])} (${tierCounts[tier]} blocks)`
+      );
   }
   return parts.join(" | ");
 }
@@ -6016,14 +6096,27 @@ function collectVisible(messages, state, countTokens) {
       toolCallNames.set(message.toolCallId, message.toolName);
     }
   }
+  let pendingGap = false;
   messages.forEach((message, index) => {
-    if (coveredIds.has(message.id)) return;
     const ref = refForRaw(state.messageRefs, message.id);
     if (!ref) return;
     const tokens = countMessageTokens(message, countTokens);
-    const isTool = isToolMessage(message);
-    const tool = isTool ? message.toolName ?? (message.toolCallId ? toolCallNames.get(message.toolCallId) : void 0) ?? "tool" : "text";
-    if (tokens > 0) visible.push({ ref, tokens, tool, isTool, index });
+    if (!coveredIds.has(message.id) && tokens > 0) {
+      const isTool = isToolMessage(message);
+      const tool = isTool ? message.toolName ?? (message.toolCallId ? toolCallNames.get(message.toolCallId) : void 0) ?? "tool" : "text";
+      visible.push({
+        ref,
+        tokens,
+        tool,
+        isTool,
+        index,
+        isUser: message.role === "user",
+        gapBefore: pendingGap
+      });
+      pendingGap = false;
+      return;
+    }
+    if (ref !== BLOCKED_REF && tokens > 0) pendingGap = true;
   });
   return { visible, summaryTokens };
 }
@@ -6035,21 +6128,43 @@ function buildStatusReport(state, messages, countTokens, options = {}) {
   const limit = options.limit ?? 30;
   const activeBlocks2 = state.blocks.filter((b) => b.active).sort((a, b) => numericPart2(a.blockId) - numericPart2(b.blockId));
   if (scope === "compressed") {
-    return renderCompressedDrilldown(activeBlocks2, state, sort, limit, countTokens, options.meta);
+    return renderCompressedDrilldown(
+      activeBlocks2,
+      state,
+      sort,
+      limit,
+      countTokens,
+      options.meta
+    );
   }
-  const { visible, summaryTokens } = collectVisible(messages, state, countTokens);
+  const { visible, summaryTokens } = collectVisible(
+    messages,
+    state,
+    countTokens
+  );
   if (scope === "uncompressed") {
     if (view === "messages") {
       return renderMessageDrilldown(visible, toolFilter, sort, limit);
     }
-    return renderUncompressedRanges(visible);
+    return renderUncompressedRanges(visible, sort, limit);
   }
-  return renderOverview(visible, summaryTokens, activeBlocks2, state, countTokens, limit, options.meta);
+  return renderOverview(
+    visible,
+    summaryTokens,
+    activeBlocks2,
+    state,
+    countTokens,
+    limit,
+    options.meta
+  );
 }
 function surfaceLine(meta) {
   if (!meta) return null;
   const parts = [];
-  if (meta.pack) parts.push(`pack=${meta.pack}${meta.packVersion ? ` v${meta.packVersion}` : ""}`);
+  if (meta.pack)
+    parts.push(
+      `pack=${meta.pack}${meta.packVersion ? ` v${meta.packVersion}` : ""}`
+    );
   if (meta.host) parts.push(`host=${meta.host}`);
   if (parts.length === 0) return null;
   return `ACTIVE SURFACE: ${parts.join(" | ")}`;
@@ -6063,9 +6178,14 @@ function renderOverview(visible, summaryTokens, blocks, state, countTokens, limi
   }
   const toolTypeMap = /* @__PURE__ */ new Map();
   for (const message of visible) {
-    toolTypeMap.set(message.tool, (toolTypeMap.get(message.tool) ?? 0) + message.tokens);
+    toolTypeMap.set(
+      message.tool,
+      (toolTypeMap.get(message.tool) ?? 0) + message.tokens
+    );
   }
-  const topTool = [...toolTypeMap.entries()].sort((a, b) => b[1] - a[1])[0]?.[0];
+  const topTool = [...toolTypeMap.entries()].sort(
+    (a, b) => b[1] - a[1]
+  )[0]?.[0];
   const totalTool = visible.filter((m) => m.isTool).reduce((sum, m) => sum + m.tokens, 0);
   const totalText = visible.filter((m) => !m.isTool).reduce((sum, m) => sum + m.tokens, 0);
   const total = summaryTokens + totalTool + totalText;
@@ -6075,14 +6195,19 @@ function renderOverview(visible, summaryTokens, blocks, state, countTokens, limi
   );
   const topTypes = [...toolTypeMap.entries()].sort((a, b) => b[1] - a[1]).slice(0, 3);
   if (topTypes.length > 0) {
-    lines.push(`  Top tools: ${topTypes.map(([t, n]) => `${t} (${pct(n, total)}%)`).join(", ")}`);
+    lines.push(
+      `  Top tools: ${topTypes.map(([t, n]) => `${t} (${pct(n, total)}%)`).join(", ")}`
+    );
   }
   lines.push("");
   if (blocks.length === 0) {
     lines.push("COMPRESSED BLOCKS");
     lines.push("  No compressed blocks.");
   } else {
-    const totalSummary = blocks.reduce((s, b) => s + summaryTokensOf(b, countTokens), 0);
+    const totalSummary = blocks.reduce(
+      (s, b) => s + summaryTokensOf(b, countTokens),
+      0
+    );
     const totalEffective = blocks.reduce(
       (s, b) => s + effectiveCompressedTokens(b, state, countTokens),
       0
@@ -6115,19 +6240,17 @@ function renderOverview(visible, summaryTokens, blocks, state, countTokens, limi
   );
   return lines.join("\n");
 }
-function renderUncompressedRanges(visible) {
+function renderUncompressedRanges(visible, sort, limit) {
   const lines = [];
   const totalTokens = visible.reduce((s, m) => s + m.tokens, 0);
-  lines.push(`UNCOMPRESSED \u2014 ${formatTokens2(totalTokens)} | ${visible.length} visible messages`);
+  lines.push(
+    `UNCOMPRESSED \u2014 ${formatTokens2(totalTokens)} | ${visible.length} visible messages`
+  );
   lines.push("");
   if (visible.length === 0) {
     lines.push("  (no uncompressed messages)");
     return lines.join("\n");
   }
-  const refNum2 = (ref) => {
-    const m = ref.match(/\d+/);
-    return m ? parseInt(m[0], 10) : 0;
-  };
   const dominantTool = (toolTokens) => {
     let best = "text";
     let bestN = -1;
@@ -6140,25 +6263,37 @@ function renderUncompressedRanges(visible) {
     return best;
   };
   const merged = [];
-  for (const m of visible) {
-    const num = refNum2(m.ref);
-    const last = merged[merged.length - 1];
-    if (last && num === last.startNum + last.count) {
-      last.endRef = m.ref;
-      last.count += 1;
-      last.tokens += m.tokens;
-      last.toolTokens.set(m.tool, (last.toolTokens.get(m.tool) ?? 0) + m.tokens);
-    } else {
-      const toolTokens = /* @__PURE__ */ new Map([[m.tool, m.tokens]]);
-      merged.push({ startRef: m.ref, endRef: m.ref, startNum: num, count: 1, tokens: m.tokens, toolTokens });
-    }
-  }
-  for (const r of merged.slice(0, 30)) {
+  for (const group of segmentGroups(visible)) {
+    const first = group[0];
+    const r = {
+      startRef: first.ref,
+      endRef: first.ref,
+      startIndex: first.index,
+      count: 1,
+      tokens: first.tokens,
+      toolTokens: /* @__PURE__ */ new Map([[first.tool, first.tokens]])
+    };
+    for (let i = 1; i < group.length; i++) {
+      const m = group[i];
+      r.endRef = m.ref;
+      r.count += 1;
+      r.tokens += m.tokens;
+      r.toolTokens.set(m.tool, (r.toolTokens.get(m.tool) ?? 0) + m.tokens);
+    }
+    merged.push(r);
+  }
+  if (sort !== "time")
+    merged.sort((a, b) => b.tokens - a.tokens || a.startIndex - b.startIndex);
+  lines.push(`Sorted by ${sort === "time" ? "time" : "size"}`);
+  lines.push("");
+  for (const r of merged.slice(0, limit)) {
     const range = r.count === 1 ? r.startRef : `${r.startRef}\u2013${r.endRef}`;
-    lines.push(`  ${range}  (${r.count} msgs, ${formatTokens2(r.tokens)}${r.count > 1 ? ` (${Math.round(r.tokens / r.count)}/msg)` : ""}) ${dominantTool(r.toolTokens)}`);
+    lines.push(
+      `  ${range}  (${r.count} msgs, ${formatTokens2(r.tokens)}${r.count > 1 ? ` (${Math.round(r.tokens / r.count)}/msg)` : ""}) ${dominantTool(r.toolTokens)}`
+    );
   }
-  if (merged.length > 30) {
-    lines.push(`  ... and ${merged.length - 30} more ranges`);
+  if (merged.length > limit) {
+    lines.push(`  ... and ${merged.length - limit} more ranges`);
   }
   return lines.join("\n");
 }
@@ -6166,7 +6301,10 @@ function renderMessageDrilldown(visible, toolFilter, sort, limit) {
   let filtered = visible;
   if (toolFilter) filtered = filtered.filter((m) => m.tool === toolFilter);
   if (sort === "time") filtered.sort((a, b) => a.index - b.index);
-  else if (sort === "tool") filtered.sort((a, b) => a.tool.localeCompare(b.tool) || b.tokens - a.tokens);
+  else if (sort === "tool")
+    filtered.sort(
+      (a, b) => a.tool.localeCompare(b.tool) || b.tokens - a.tokens
+    );
   else filtered.sort((a, b) => b.tokens - a.tokens);
   const totalTokens = filtered.reduce((s, m) => s + m.tokens, 0);
   const allTokens = visible.reduce((s, m) => s + m.tokens, 0);
@@ -6174,7 +6312,9 @@ function renderMessageDrilldown(visible, toolFilter, sort, limit) {
   const lines = [header, `Sorted by ${sort}`, ""];
   const shown = filtered.slice(0, limit);
   for (const message of shown) {
-    lines.push(`  ${message.ref} (${formatTokens2(message.tokens)}) ${message.tool}`);
+    lines.push(
+      `  ${message.ref} (${formatTokens2(message.tokens)}) ${message.tool}`
+    );
   }
   if (filtered.length > shown.length) {
     lines.push("");
@@ -6185,12 +6325,16 @@ function renderMessageDrilldown(visible, toolFilter, sort, limit) {
 function renderCompressedDrilldown(blocks, state, sort, limit, countTokens, meta) {
   let sorted = [...blocks];
   if (sort === "time") sorted.sort((a, b) => a.createdAt - b.createdAt);
-  else if (sort === "age") sorted.sort((a, b) => b.survivedCount - a.survivedCount);
+  else if (sort === "age")
+    sorted.sort((a, b) => b.survivedCount - a.survivedCount);
   else
     sorted.sort(
       (a, b) => effectiveCompressedTokens(b, state, countTokens) - effectiveCompressedTokens(a, state, countTokens) || b.createdAt - a.createdAt
     );
-  const totalSummary = sorted.reduce((s, b) => s + summaryTokensOf(b, countTokens), 0);
+  const totalSummary = sorted.reduce(
+    (s, b) => s + summaryTokensOf(b, countTokens),
+    0
+  );
   const totalEffective = sorted.reduce(
     (s, b) => s + effectiveCompressedTokens(b, state, countTokens),
     0
@@ -6636,7 +6780,9 @@ function formatCacheReportSummary(report) {
     });
     const last = report.lines.length - 1;
     if (!shownIdx.includes(last)) shownIdx.push(last);
-    const kept = shownIdx.slice(Math.max(0, shownIdx.length - SUMMARY_ANOMALY_CAP));
+    const kept = shownIdx.slice(
+      Math.max(0, shownIdx.length - SUMMARY_ANOMALY_CAP)
+    );
     const anomalies = kept.filter((i) => {
       const l = report.lines[i];
       if (!l) return false;
@@ -6695,10 +6841,14 @@ function renderMessage2(m) {
       parts.push(m.text ?? "");
       break;
     case "tool-call":
-      parts.push(`\`${m.toolName ?? "?"}(${m.toolCallId ?? ""})\` args: ${m.text ?? ""}`);
+      parts.push(
+        `\`${m.toolName ?? "?"}(${m.toolCallId ?? ""})\` args: ${m.text ?? ""}`
+      );
       break;
     case "tool-result":
-      parts.push(`\`${m.toolName ?? "?"}(${m.toolCallId ?? ""})\` \u2192 ${m.text ?? ""}`);
+      parts.push(
+        `\`${m.toolName ?? "?"}(${m.toolCallId ?? ""})\` \u2192 ${m.text ?? ""}`
+      );
       break;
     case "reasoning":
       parts.push(`_reasoning_: ${m.text ?? ""}`);
@@ -6716,12 +6866,17 @@ function renderHandoff(input) {
   if (meta.label) lines.push(`- label: ${meta.label}`);
   lines.push(`- session id: ${meta.sessionId}`);
   for (const bullet of meta.extraBullets ?? []) lines.push(bullet);
-  if (meta.contextTokens) lines.push(`- last context tokens: ~${meta.contextTokens}`);
-  lines.push(`- compression blocks: ${state.blocks.length} (active ${state.blocks.filter((b) => b.active).length})`);
+  if (meta.contextTokens)
+    lines.push(`- last context tokens: ~${meta.contextTokens}`);
+  lines.push(
+    `- compression blocks: ${state.blocks.length} (active ${state.blocks.filter((b) => b.active).length})`
+  );
   lines.push("");
   const folded = input.folded === true;
   const view = full || folded ? coreMessages : prune(coreMessages, state);
-  lines.push(full && !folded ? `## Full conversation (${coreMessages.length} messages)` : folded ? `## Conversation (persisted folded snapshot, ${coreMessages.length} messages)` : `## Conversation (folded view as the model saw it, ${coreMessages.length} client messages)`);
+  lines.push(
+    full && !folded ? `## Full conversation (${coreMessages.length} messages)` : folded ? `## Conversation (persisted folded snapshot, ${coreMessages.length} messages)` : `## Conversation (folded view as the model saw it, ${coreMessages.length} client messages)`
+  );
   lines.push("");
   if (view.length === 0) {
     lines.push("No conversation messages to export.");
@@ -6754,7 +6909,9 @@ function matchSession(sessions, selector, labelOf) {
   if (exact.length > 0) return exact;
   const byLabel = sessions.filter((s) => labelOf(s) === selector);
   if (byLabel.length > 0) return byLabel;
-  return sessions.filter((s) => s.id.startsWith(selector) || (labelOf(s) ?? "").startsWith(selector));
+  return sessions.filter(
+    (s) => s.id.startsWith(selector) || (labelOf(s) ?? "").startsWith(selector)
+  );
 }
 
 // src/rules.ts
@@ -6865,7 +7022,10 @@ var DEFAULT_IMAGE_COMPRESSION_CONFIG = {
   format: "webp"
 };
 function resolveImageCompressionConfig(config) {
-  return { ...DEFAULT_IMAGE_COMPRESSION_CONFIG, ...config.imageCompression ?? {} };
+  return {
+    ...DEFAULT_IMAGE_COMPRESSION_CONFIG,
+    ...config.imageCompression ?? {}
+  };
 }
 var PIXEL_IMAGE_FALLBACK_TOKENS = 16384;
 var TILE_EDGE = 512;
@@ -6959,10 +7119,14 @@ var HEADER_SCAN_CHARS = 64;
 var JPEG_SCAN_CHARS = 35e4;
 function parseImageDimensionsFromBase64(b64) {
   if (typeof b64 !== "string" || b64.length === 0) return void 0;
-  const head = parseImageDimensions(Buffer.from(b64.slice(0, HEADER_SCAN_CHARS), "base64"));
+  const head = parseImageDimensions(
+    Buffer.from(b64.slice(0, HEADER_SCAN_CHARS), "base64")
+  );
   if (head) return head;
   if (b64.startsWith("/9j/") && b64.length > HEADER_SCAN_CHARS) {
-    return parseImageDimensions(Buffer.from(b64.slice(0, JPEG_SCAN_CHARS), "base64"));
+    return parseImageDimensions(
+      Buffer.from(b64.slice(0, JPEG_SCAN_CHARS), "base64")
+    );
   }
   return void 0;
 }
@@ -7020,7 +7184,8 @@ var DEFAULT_SCREENSHOT_CLASSIFIER = createHeuristicClassifier();
 function decideImageRoute(meta, config, classifier = DEFAULT_SCREENSHOT_CLASSIFIER) {
   const cfg = resolveImageCompressionConfig(config);
   const estimatedTokens = estimateImageTokens(meta);
-  if (!cfg.enabled) return { action: "pass", reason: "disabled", estimatedTokens };
+  if (!cfg.enabled)
+    return { action: "pass", reason: "disabled", estimatedTokens };
   if (!meta.mediaType.startsWith("image/")) {
     return { action: "pass", reason: "not-an-image", estimatedTokens };
   }
@@ -7034,7 +7199,11 @@ function decideImageRoute(meta, config, classifier = DEFAULT_SCREENSHOT_CLASSIFI
     action: "downsample",
     reason: "downsample",
     estimatedTokens,
-    recipe: { maxDimension: cfg.maxDimension, quality: cfg.quality, format: cfg.format }
+    recipe: {
+      maxDimension: cfg.maxDimension,
+      quality: cfg.quality,
+      format: cfg.format
+    }
   };
 }
 var IMAGE_FULL_FAILURE_MARKER = "[image_full FAILED:";
@@ -7046,7 +7215,8 @@ function parseImageFullInput(input, callId, onWarn) {
   if (typeof input === "string") {
     try {
       const parsed = JSON.parse(input);
-      if (parsed && typeof parsed === "object") obj = parsed;
+      if (parsed && typeof parsed === "object")
+        obj = parsed;
     } catch {
       obj = null;
     }
@@ -7054,7 +7224,9 @@ function parseImageFullInput(input, callId, onWarn) {
     obj = input;
   }
   if (!obj) {
-    onWarn?.(`[acp-image-full-input] rejected: not an object (${typeof input})`);
+    onWarn?.(
+      `[acp-image-full-input] rejected: not an object (${typeof input})`
+    );
     return null;
   }
   let ref;
@@ -7147,7 +7319,11 @@ function resetImageFullState(state) {
 // src/parse-compress-input.ts
 function parseCompressArgs(input, opts) {
   const callId = opts?.callId;
-  const diag = { ok: false, kind: "ok", invalidItems: 0 };
+  const diag = {
+    ok: false,
+    kind: "ok",
+    invalidItems: 0
+  };
   if (input === null || input === void 0) {
     diag.kind = "empty-input";
     return finish([], diag);
@@ -7169,7 +7345,11 @@ function parseStringInput(raw, callId, diag) {
   if (first.ranges.length === 0 || first.diagnostics.invalidItems > 0) {
     const normalized = normalizeSingleQuotes(cleaned);
     if (normalized !== void 0) {
-      const retryDiag = { ok: false, kind: "ok", invalidItems: 0 };
+      const retryDiag = {
+        ok: false,
+        kind: "ok",
+        invalidItems: 0
+      };
       retryDiag.rawPrefix = diag.rawPrefix;
       retryDiag.length = diag.length;
       const retry = parseStringCore(normalized, callId, retryDiag);
@@ -7246,7 +7426,8 @@ function parseObjectValue(value, callId, diag) {
   if (topTopic !== void 0 || hasTopMaxChars) {
     for (const r of ranges) {
       if (r.topic === void 0 && topTopic !== void 0) r.topic = topTopic;
-      if (r.summaryMaxChars === void 0 && hasTopMaxChars) r.summaryMaxChars = topMaxChars;
+      if (r.summaryMaxChars === void 0 && hasTopMaxChars)
+        r.summaryMaxChars = topMaxChars;
     }
   }
   diag.invalidItems = invalid;
@@ -7261,7 +7442,8 @@ function parseContentArray(s) {
   const normalized = normalizeSingleQuotes(cleaned);
   if (normalized !== void 0) {
     const retry = parseContentArrayCore(normalized);
-    if (retry !== null && retry.entries.length > 0) return { ...retry, quoteRepaired: true };
+    if (retry !== null && retry.entries.length > 0)
+      return { ...retry, quoteRepaired: true };
   }
   return direct;
 }
@@ -7348,12 +7530,14 @@ function parseLineEntry(entry, callId) {
     afterRefs = pair.index + pair[0].length;
   } else {
     const single = SINGLE_REF_IN_LINE.exec(head);
-    if (single === null) return { reason: "line entry: no mNNNNN/bN refs in header" };
+    if (single === null)
+      return { reason: "line entry: no mNNNNN/bN refs in header" };
     startRef = normalizeLineRef(single[1]);
     endRef = startRef;
     afterRefs = single.index + single[0].length;
   }
-  if (summary.length === 0) return { reason: "line entry: missing summary after the refs header line" };
+  if (summary.length === 0)
+    return { reason: "line entry: missing summary after the refs header line" };
   const explicitTopic = head.slice(afterRefs).trim();
   const range = {
     startRef,
@@ -7372,7 +7556,11 @@ function deriveTopicFromSummary(summary) {
   return text.length > 60 ? clampPrefix(text, 60).trimEnd() : text;
 }
 function splitLineEntries(content) {
-  const parts = content.split(/\n(?=\s*(?:["']\s*,\s*)?["']?\s*[mb]\d{1,7}\s*(?:[-\u2013\u2014\u2026~]|\.\.\.|to)\s*[mb]\d{1,7}\b)/i).map((p) => p.trim().replace(/^(?:["']\s*,?\s*)+/, "").replace(/["']\s*$/, "")).filter((p) => p.length > 0);
+  const parts = content.split(
+    /\n(?=\s*(?:["']\s*,\s*)?["']?\s*[mb]\d{1,7}\s*(?:[-\u2013\u2014\u2026~]|\.\.\.|to)\s*[mb]\d{1,7}\b)/i
+  ).map(
+    (p) => p.trim().replace(/^(?:["']\s*,?\s*)+/, "").replace(/["']\s*$/, "")
+  ).filter((p) => p.length > 0);
   return parts.length > 0 ? parts : [content.trim()];
 }
 function stripJsonWrapperResidue(s) {
@@ -7385,12 +7573,15 @@ function stripJsonWrapperResidue(s) {
 }
 function validateEntry(entry, callId) {
   if (typeof entry === "string") return parseLineEntry(entry, callId);
-  if (entry === null || typeof entry !== "object" || Array.isArray(entry)) return { reason: "not an object" };
+  if (entry === null || typeof entry !== "object" || Array.isArray(entry))
+    return { reason: "not an object" };
   const e = entry;
   const start = stringOr(e["startRef"]) ?? stringOr(e["startId"]) ?? stringOr(e["messageId"]);
   const end = stringOr(e["endRef"]) ?? stringOr(e["endId"]) ?? stringOr(e["messageId"]);
   if (start === void 0 || end === void 0) {
-    return { reason: "missing range bounds (need startRef/startId and endRef/endId)" };
+    return {
+      reason: "missing range bounds (need startRef/startId and endRef/endId)"
+    };
   }
   const summary = stringOr(e["summary"]);
   if (summary === void 0) return { reason: "missing summary" };
@@ -7398,7 +7589,8 @@ function validateEntry(entry, callId) {
   const topic = stringOr(e["topic"]);
   if (topic !== void 0) range.topic = topic;
   const maxChars = e["summaryMaxChars"];
-  if (typeof maxChars === "number" && Number.isFinite(maxChars)) range.summaryMaxChars = maxChars;
+  if (typeof maxChars === "number" && Number.isFinite(maxChars))
+    range.summaryMaxChars = maxChars;
   if (callId !== void 0) range.compressCallId = callId;
   return { range };
 }
@@ -7435,7 +7627,8 @@ function tryParseLenient(s) {
   return void 0;
 }
 function normalizeSingleQuotes(raw) {
-  if (!raw.includes("'") || !raw.includes("{") && !raw.includes("[")) return void 0;
+  if (!raw.includes("'") || !raw.includes("{") && !raw.includes("["))
+    return void 0;
   let out = "";
   let changed = false;
   let inDouble = false;
@@ -7527,8 +7720,10 @@ function stripTrailingCommas(s) {
     }
     if (ch === ",") {
       let j = i + 1;
-      while (j < s.length && (s.charAt(j) === " " || s.charAt(j) === "	" || s.charAt(j) === "\n" || s.charAt(j) === "\r")) j++;
-      if (j < s.length && (s.charAt(j) === "}" || s.charAt(j) === "]")) continue;
+      while (j < s.length && (s.charAt(j) === " " || s.charAt(j) === "	" || s.charAt(j) === "\n" || s.charAt(j) === "\r"))
+        j++;
+      if (j < s.length && (s.charAt(j) === "}" || s.charAt(j) === "]"))
+        continue;
     }
     out += ch;
   }
@@ -7593,7 +7788,8 @@ function repairAtParserPositions(s) {
       if (ch === "\n") esc = "\\n";
       else if (ch === "\r") esc = "\\r";
       else if (ch === "	") esc = "\\t";
-      else if (ch.charCodeAt(0) < 32) esc = "\\u" + ch.charCodeAt(0).toString(16).padStart(4, "0");
+      else if (ch.charCodeAt(0) < 32)
+        esc = "\\u" + ch.charCodeAt(0).toString(16).padStart(4, "0");
       if (esc === void 0) return cur;
       cur = cur.slice(0, pos) + esc + cur.slice(pos + 1);
     } else if (/Bad escaped character/i.test(msg)) {
@@ -7669,7 +7865,9 @@ function salvageContentEntries(raw) {
 
 // src/rebuild.ts
 function rebuildCompressionState(state, messages, config, ports = {}) {
-  const core = createCore({ countTokens: ports.countTokens ?? defaultCountTokens });
+  const core = createCore({
+    countTokens: ports.countTokens ?? defaultCountTokens
+  });
   const refResult = assignRefs(messages, {
     existing: state.messageRefs,
     nextIndex: highestUsedIndex(state.messageRefs) + 1,
@@ -7679,9 +7877,16 @@ function rebuildCompressionState(state, messages, config, ports = {}) {
   const invocations = collectCompressInvocations(messages);
   let blocksRebuilt = 0;
   for (const invocation of invocations) {
-    const { ranges } = parseCompressArgs(invocation.raw, { callId: invocation.callId });
+    const { ranges } = parseCompressArgs(invocation.raw, {
+      callId: invocation.callId
+    });
     if (ranges.length === 0) continue;
-    const result = core.applyCompression({ ranges, messages, state: working, config });
+    const result = core.applyCompression({
+      ranges,
+      messages,
+      state: working,
+      config
+    });
     working = result.state;
     blocksRebuilt += result.result.blocksCreated;
   }
@@ -7690,7 +7895,8 @@ function rebuildCompressionState(state, messages, config, ports = {}) {
 function collectCompressInvocations(messages) {
   const invocations = [];
   for (const message of messages) {
-    if (message.toolName !== "compress" || message.contentType !== "tool-call") continue;
+    if (message.toolName !== "compress" || message.contentType !== "tool-call")
+      continue;
     invocations.push({ callId: message.toolCallId, raw: message.text ?? "" });
   }
   return invocations;
@@ -7706,7 +7912,8 @@ function stem(word) {
   let w = word;
   if (w.length <= 3) return w;
   if (w.endsWith("ies")) w = w.slice(0, -3) + "y";
-  else if (w.endsWith("ses") || w.endsWith("xes") || w.endsWith("zes")) w = w.slice(0, -2);
+  else if (w.endsWith("ses") || w.endsWith("xes") || w.endsWith("zes"))
+    w = w.slice(0, -2);
   else if (w.endsWith("ches") || w.endsWith("shes")) w = w.slice(0, -2);
   else if (w.endsWith("s") && !w.endsWith("ss")) w = w.slice(0, -1);
   if (w.endsWith("ing") && w.length > 5) w = w.slice(0, -3);
@@ -7883,7 +8090,8 @@ var fuzzyAlgorithm = {
   description: "Character bigram overlap. Typo-tolerant, script-agnostic, high recall.",
   score(docs, query) {
     const qTokens = query.toLowerCase().split(/[\s,]+/).filter((t) => t.length >= 4 || t.length >= 2 && CJK.test(t));
-    if (qTokens.length === 0) return docs.map((d) => ({ ref: d.ref, score: 0 }));
+    if (qTokens.length === 0)
+      return docs.map((d) => ({ ref: d.ref, score: 0 }));
     const qGrams = /* @__PURE__ */ new Set();
     for (const t of qTokens) for (const g of charBigrams(t)) qGrams.add(g);
     if (qGrams.size === 0) return docs.map((d) => ({ ref: d.ref, score: 0 }));
@@ -8004,7 +8212,9 @@ function runSearch(docs, query, options) {
     }).filter((r) => r !== null && r.score >= minScore).sort((a, b) => b.score - a.score).slice(0, limit);
   };
   if (scoredOrPromise instanceof Promise) {
-    return scoredOrPromise.then((raw) => buildResults(applyRoleWeight(raw, docs, rw)));
+    return scoredOrPromise.then(
+      (raw) => buildResults(applyRoleWeight(raw, docs, rw))
+    );
   }
   return buildResults(applyRoleWeight(scoredOrPromise, docs, rw));
 }
@@ -8416,6 +8626,7 @@ export {
   sanitizePackSurface,
   searchBlocks,
   searchBlocksAsync,
+  segmentGroups,
   setDocCacheCap,
   storeCoveredOriginals,
   storeLargeResults,