blun-king-cli 9.1.97 → 9.1.99

package/LIESMICH.txt

@@ -9,7 +9,7 @@ Installation
 ------------
 Die geprüfte Version exakt global installieren:
 
-  npm install -g blun-king-cli@9.1.97
+  npm install -g blun-king-cli@9.1.99
 
 Start
 -----
@@ -85,14 +85,20 @@ King bewahrt den vollständigen Verlauf weiterhin im Sitzungs-Wire auf. Erreicht
 
 Dabei werden keine gespeicherten Nachrichten geändert oder gelöscht. Fortsetzen, Exportieren und die sichtbare Historie behalten die ursprünglichen Werkzeugergebnisse und Werkzeugargumente. Das Telemetrieereignis `micro_compaction_finished` nennt den Auslöser, den Schnitt und die geschätzte Tokenzahl vor und nach der Entlastung. Außerdem zählt es getrennt, wie viele Werkzeugergebnisse und Werkzeugargumente entlastet wurden. Der Sitzungsinspektor summiert zusätzlich die eingesparten Argument-Token, ohne Inhalte offenzulegen. Beispiel: Ein früherer `Write`-Aufruf mit einem vollständigen Dateiinhalt bleibt im Wire erhalten; die Modellprojektion trägt nur noch einen Platzhalter, sobald für diesen `Write`-Aufruf ein zugehöriges Ergebnis vorliegt.
 
+Ab BLUN King 9.1.98 kann King einen abgeschlossenen Arbeitsabschnitt verdichten, bevor die harte automatische Grenze erreicht ist. Unterhalb der halben Vollverdichtungsgrenze bleibt `CompactConversation` vollständig aus dem Modellprompt. Ab 128.000 geschätzten Token im Standardmodellfenster wird es für den nächsten Modellschritt verfügbar. Die Verdichtung beginnt erst nach Abschluss des aktuellen Werkzeugschritts, öffnet keinen konkurrierenden Zug und lässt den ursprünglichen Verlauf bei einem Fehlschlag unverändert.
+
 ## Große Werkzeugausgaben und isolierte Teilagenten
 
 Große textbasierte Werkzeugergebnisse bleiben nicht mehr vollständig im Modellkontext. Ab 12.001 Zeichen speichert BLUN King das vollständige Ergebnis in einer privaten Datei im Sitzungsordner `tool-results`. Im Modellkontext verbleiben die ersten 1.000 und die letzten 1.000 Zeichen, die genaue Zahl der ausgelassenen Zeichen und der `output_path`. Der Agent kann das vollständige Ergebnis anschließend mit `Read` seitenweise über diesen Pfad lesen. Ergebnisse bis einschließlich 12.000 Zeichen, gemischte Medienergebnisse und bereits gekürzte Ergebnisse bleiben unverändert. Auch eine spätere Mikroverdichtung bewahrt den Dateiverweis. Beispiel: Bei einem Suchergebnis mit 30.000 Zeichen sehen folgende Modellanfragen den Anfang und das abschließende Ergebnis oder den Fehler; der vollständige Text bleibt lokal verfügbar.
 
+Ab BLUN King 9.1.99 werden auch direkt aufeinanderfolgende reine Textergebnisse als Stapel betrachtet. Enthalten sie zusammen mehr als 12.000 Zeichen, obwohl kein einzelnes Ergebnis diese Grenze überschreitet, speichert King so viele der größten geeigneten Ergebnisse wie nötig in privaten Dateien. In der Modellprojektion verbleiben lesbare Verweise. Der unveränderte Sitzungsrohverlauf bleibt vollständig erhalten. Gemischte Medienergebnisse, einzelne Ergebnisse unter 3.000 Zeichen und Stapel bis einschließlich 12.000 Zeichen bleiben unverändert. Beispiel: Bei zwei Suchergebnissen mit 7.000 und 6.000 Zeichen wird das größere Ergebnis privat gespeichert; Anfang, Ende, ausgelassene Zeichenzahl und `output_path` bleiben für den Agenten sichtbar.
+
 Große Dateien werden weiterhin seitenweise gelesen. Erreicht `Read` seine interne Grenze von 1.000 Zeilen und enthält die Datei weitere Zeilen, nennt das Ergebnis jetzt den exakten nächsten `line_offset`. Beispiel: Ein Lesevorgang ab Zeile 2001 wird mit `line_offset=3001` fortgesetzt. Am Dateiende und bei einem bewusst kleineren Leseausschnitt erscheint kein Fortsetzungshinweis. Dadurch zieht der Agent keine Schlüsse aus einem unvollständigen Ausschnitt und liest die Datei nicht erneut ab der ersten Zeile.
 
 Das Telemetrieereignis `tool_result_offloaded` enthält ausschließlich `tool_name`, `output_size_chars`, `output_size_bytes` und `preview_size_chars`. Es enthält weder den Inhalt noch den Speicherpfad. Beispiel: Eine Ausgabe mit 80.000 Zeichen erzeugt eine Vorschau mit 2.000 Zeichen; die Telemetrie zeigt die Größenersparnis, ohne Nutzdaten zu protokollieren.
 
+Das Telemetrieereignis `tool_result_batch_offloaded` meldet ausschließlich die Zahl der Ergebnisse sowie die Zeichenzahlen vor und nach der Entlastung und die eingesparte Zeichenzahl. Es enthält weder Ergebnisinhalte noch Speicherpfade.
+
 Reguläre `Agent`-Teilaufgaben verwenden eine eigene `ContextMemory` und eine eigene `wire.jsonl` in einem getrennten Agentenverzeichnis. Der Hauptagent erhält nur die Ergebniszusammenfassung, sodass lange Teilaufgaben nicht den Hauptverlauf füllen. `TodoList` speichert Pläne weiterhin maschinenlesbar im Sitzungs-Wire; `blun handoff` übergibt sie zusammen mit prüfbaren Hashes zwischen CLI, Desktop und Web.
 
 Rein lesende Sitzungsdiagnose

package/README.md

@@ -9,7 +9,7 @@ Voraussetzung ist Node.js 24.15 oder neuer. Die geprüfte Version wird exakt
 installiert:
 
 ```powershell
-npm install -g blun-king-cli@9.1.97
+npm install -g blun-king-cli@9.1.99
 ```
 
 ## Reproduzierbares Staging und Packen
@@ -105,14 +105,20 @@ King bewahrt den vollständigen Verlauf weiterhin im Sitzungs-Wire auf. Bei 75 P
 
 Dabei werden keine gespeicherten Nachrichten geändert oder gelöscht. Fortsetzen, Exportieren und die sichtbare Historie behalten die ursprünglichen Werkzeugergebnisse und Werkzeugargumente. Das Telemetrieereignis `micro_compaction_finished` nennt den Auslöser, den Schnitt, die verwendete Druckgrenze, das Modellfenster und die geschätzte Tokenzahl vor und nach der Entlastung. Außerdem zählt es getrennt, wie viele Werkzeugergebnisse und Werkzeugargumente entlastet wurden. Der Sitzungsinspektor summiert zusätzlich die eingesparten Argument-Token, ohne Inhalte offenzulegen. Beispiel: Ein früherer `Write`-Aufruf mit einem vollständigen Dateiinhalt bleibt im Wire erhalten; die Modellprojektion trägt nur noch einen Platzhalter, sobald für diesen `Write`-Aufruf ein zugehöriges Ergebnis vorliegt.
 
+Ab BLUN King 9.1.98 kann King einen abgeschlossenen Arbeitsabschnitt verdichten, bevor die harte automatische Grenze erreicht ist. Unterhalb der halben Vollverdichtungsgrenze bleibt `CompactConversation` vollständig aus dem Modellprompt. Ab 128.000 geschätzten Token im Standardmodellfenster wird es für den nächsten Modellschritt verfügbar. Die Verdichtung beginnt erst nach Abschluss des aktuellen Werkzeugschritts, öffnet keinen konkurrierenden Zug und lässt den ursprünglichen Verlauf bei einem Fehlschlag unverändert.
+
 ## Große Werkzeugausgaben und isolierte Teilagenten
 
 Große textbasierte Werkzeugergebnisse bleiben nicht mehr vollständig im Modellkontext. Ab 12.001 Zeichen speichert BLUN King das vollständige Ergebnis in einer privaten Datei im Sitzungsordner `tool-results`. Im Modellkontext verbleiben die ersten 1.000 und die letzten 1.000 Zeichen, die genaue Zahl der ausgelassenen Zeichen und der `output_path`. Der Agent kann das vollständige Ergebnis anschließend mit `Read` seitenweise über diesen Pfad lesen. Ergebnisse bis einschließlich 12.000 Zeichen, gemischte Medienergebnisse und bereits gekürzte Ergebnisse bleiben unverändert. Auch eine spätere Mikroverdichtung bewahrt den Dateiverweis. Beispiel: Bei einem Suchergebnis mit 30.000 Zeichen sehen folgende Modellanfragen den Anfang und das abschließende Ergebnis oder den Fehler; der vollständige Text bleibt lokal verfügbar.
 
+Ab BLUN King 9.1.99 werden auch direkt aufeinanderfolgende reine Textergebnisse als Stapel betrachtet. Enthalten sie zusammen mehr als 12.000 Zeichen, obwohl kein einzelnes Ergebnis diese Grenze überschreitet, speichert King so viele der größten geeigneten Ergebnisse wie nötig in privaten Dateien. In der Modellprojektion verbleiben lesbare Verweise. Der unveränderte Sitzungsrohverlauf bleibt vollständig erhalten. Gemischte Medienergebnisse, einzelne Ergebnisse unter 3.000 Zeichen und Stapel bis einschließlich 12.000 Zeichen bleiben unverändert. Beispiel: Bei zwei Suchergebnissen mit 7.000 und 6.000 Zeichen wird das größere Ergebnis privat gespeichert; Anfang, Ende, ausgelassene Zeichenzahl und `output_path` bleiben für den Agenten sichtbar.
+
 Große Dateien werden weiterhin seitenweise gelesen. Erreicht `Read` seine interne Grenze von 1.000 Zeilen und enthält die Datei weitere Zeilen, nennt das Ergebnis jetzt den exakten nächsten `line_offset`. Beispiel: Ein Lesevorgang ab Zeile 2001 wird mit `line_offset=3001` fortgesetzt. Am Dateiende und bei einem bewusst kleineren Leseausschnitt erscheint kein Fortsetzungshinweis. Dadurch zieht der Agent keine Schlüsse aus einem unvollständigen Ausschnitt und liest die Datei nicht erneut ab der ersten Zeile.
 
 Das Telemetrieereignis `tool_result_offloaded` enthält ausschließlich `tool_name`, `output_size_chars`, `output_size_bytes` und `preview_size_chars`. Es enthält weder den Inhalt noch den Speicherpfad. Beispiel: Eine Ausgabe mit 80.000 Zeichen erzeugt eine Vorschau mit 2.000 Zeichen; die Telemetrie zeigt die Größenersparnis, ohne Nutzdaten zu protokollieren.
 
+Das Telemetrieereignis `tool_result_batch_offloaded` meldet ausschließlich die Zahl der Ergebnisse sowie die Zeichenzahlen vor und nach der Entlastung und die eingesparte Zeichenzahl. Es enthält weder Ergebnisinhalte noch Speicherpfade.
+
 Reguläre `Agent`-Teilaufgaben verwenden eine eigene `ContextMemory` und eine eigene `wire.jsonl` in einem getrennten Agentenverzeichnis. Der Hauptagent erhält nur die Ergebniszusammenfassung, sodass lange Teilaufgaben nicht den Hauptverlauf füllen. `TodoList` speichert Pläne weiterhin maschinenlesbar im Sitzungs-Wire; `blun handoff` übergibt sie zusammen mit prüfbaren Hashes zwischen CLI, Desktop und Web.
 
 ## Rein lesende Sitzungsdiagnose

package/bin/proactive-compaction-policy.cjs

@@ -0,0 +1,25 @@
+'use strict';
+
+const PROACTIVE_COMPACTION_TRIGGER_FRACTION = 0.5;
+
+function proactiveCompactionEligibility({ usedTokens, budgetTokens, hasShrinkableHistory, isCompacting }) {
+  const budget = Number(budgetTokens);
+  const thresholdTokens = Number.isFinite(budget) && budget > 0
+    ? Math.max(1, Math.floor(budget * PROACTIVE_COMPACTION_TRIGGER_FRACTION))
+    : undefined;
+
+  if (isCompacting === true) return { eligible: false, thresholdTokens, reason: 'already_compacting' };
+  if (thresholdTokens === undefined) return { eligible: false, thresholdTokens, reason: 'no_budget' };
+  if (!Number.isFinite(usedTokens) || usedTokens < thresholdTokens) {
+    return { eligible: false, thresholdTokens, reason: 'below_threshold' };
+  }
+  if (hasShrinkableHistory !== true) {
+    return { eligible: false, thresholdTokens, reason: 'nothing_to_compact' };
+  }
+  return { eligible: true, thresholdTokens, reason: 'eligible' };
+}
+
+module.exports = {
+  PROACTIVE_COMPACTION_TRIGGER_FRACTION,
+  proactiveCompactionEligibility,
+};

package/bin/tool-result-offload-policy.cjs

@@ -3,6 +3,9 @@
 const TOOL_RESULT_MAX_CHARS = 12_000;
 const TOOL_RESULT_PREVIEW_CHARS = 2_000;
 const TOOL_RESULT_OFFLOAD_MARKER = '[Tool result offloaded]';
+const TOOL_RESULT_BATCH_MAX_CHARS = TOOL_RESULT_MAX_CHARS;
+const TOOL_RESULT_BATCH_MIN_ITEM_CHARS = 3_000;
+const TOOL_RESULT_BATCH_REPLACEMENT_BUDGET_CHARS = 2_500;
 
 function shouldOffloadToolResult(textLength) {
   return Number.isFinite(textLength) && textLength > TOOL_RESULT_MAX_CHARS;
@@ -28,11 +31,46 @@ function isPersistedToolResultReference(content) {
   });
 }
 
+function selectToolResultBatchOffloads(textLengths) {
+  if (!Array.isArray(textLengths) || textLengths.length < 2) return [];
+
+  const normalized = textLengths.map((length) => (
+    Number.isFinite(length) && length > 0 ? Math.floor(length) : 0
+  ));
+  const totalChars = normalized.reduce((total, length) => total + length, 0);
+  if (totalChars <= TOOL_RESULT_BATCH_MAX_CHARS) return [];
+
+  let projectedChars = totalChars;
+  const selected = [];
+  const candidates = normalized
+    .map((length, index) => ({ index, length }))
+    .filter(({ length }) => (
+      length >= TOOL_RESULT_BATCH_MIN_ITEM_CHARS
+      && length <= TOOL_RESULT_MAX_CHARS
+      && length > TOOL_RESULT_BATCH_REPLACEMENT_BUDGET_CHARS
+    ))
+    .sort((left, right) => right.length - left.length || left.index - right.index);
+
+  for (const candidate of candidates) {
+    if (projectedChars <= TOOL_RESULT_BATCH_MAX_CHARS) break;
+    projectedChars -= candidate.length - TOOL_RESULT_BATCH_REPLACEMENT_BUDGET_CHARS;
+    selected.push(candidate.index);
+  }
+
+  return projectedChars <= TOOL_RESULT_BATCH_MAX_CHARS
+    ? selected.sort((left, right) => left - right)
+    : [];
+}
+
 module.exports = {
+  TOOL_RESULT_BATCH_MAX_CHARS,
+  TOOL_RESULT_BATCH_MIN_ITEM_CHARS,
+  TOOL_RESULT_BATCH_REPLACEMENT_BUDGET_CHARS,
   TOOL_RESULT_MAX_CHARS,
   TOOL_RESULT_PREVIEW_CHARS,
   TOOL_RESULT_OFFLOAD_MARKER,
   createToolResultPreview,
   isPersistedToolResultReference,
+  selectToolResultBatchOffloads,
   shouldOffloadToolResult,
 };

package/bin/turn-tool-performance-policy.cjs

@@ -10,6 +10,7 @@ const CORE_TOOL_NAMES = Object.freeze([
   'Grep',
   'Write',
   'TodoList',
+  'CompactConversation',
   'Glob',
   'TaskList',
   'Agent',

package/blun.mjs

@@ -28485,6 +28485,7 @@ var init_load = __esmMin((() => {
 var agent_default$1;
 var init_agent$3 = __esmMin((() => {
 	agent_default$1 = "name: agent\ndescription: Default BLUN King agent\n\nsystemPromptPath: ./system.md\npromptVars:\n  roleAdditional: ''\n\ntools:\n  - Read\n  - Write\n  - Edit\n  - Grep\n  - Glob\n  - Bash\n  - TaskList\n  - TaskOutput\n  - TaskStop\n  - CronCreate\n  - CronList\n  - CronDelete\n  - ReadMediaFile\n  - TodoList\n  - Skill\n  - WebSearch\n  - Agent\n  - AgentSwarm\n  - FetchURL\n  - GenerateImage\n  - GenerateVideo\n  - GenerateSpeech\n  - GetMedia\n  - AskUserQuestion\n  - MistakeRecord\n  - CodebaseSearch\n  - EnterPlanMode\n  - ExitPlanMode\n  - CreateGoal\n  - GetGoal\n  - SetGoalBudget\n  - UpdateGoal\n  - mcp__*\n\nsubagents:\n  coder:\n    description: General software engineering agent — the only subagent type with file-editing tools; use it for any delegated task that must modify code.\n  explore:\n    description: Fast codebase exploration with prompt-enforced read-only behavior.\n  plan:\n    description: Read-only implementation planning and architecture design.\n";
+	agent_default$1 = agent_default$1.replace("  - TodoList\n", "  - TodoList\n  - CompactConversation\n");
 }));
 //#endregion
 //#region ../../packages/agent-core/src/profile/default/coder.yaml?raw
@@ -75241,10 +75242,11 @@ function extractCompactionSummary(response) {
 	if (summary.trim().length === 0) throw new APIEmptyResponseError("The compaction response did not contain a non-empty summary.");
 	return summary;
 }
-var archiveCompactionHistory, buildCompactionArchiveNotice, capCompactionStageTarget, DEFAULT_COMPACTION_MAX_COMPLETION_TOKENS, COMPACTION_THINKING_EFFORT, COMPACTION_SUMMARY_RESERVE_RATIO, MAX_HIERARCHICAL_COMPACTION_PASSES, HIERARCHICAL_COMPACTION_PREFIX, CompactionTruncatedError, CompactionStallError, COMPACTION_STALL_MEASUREMENT_MULTIPLIER, REBUILT_AFTER_COMPACTION_INJECTION_VARIANTS, FullCompaction, MAX_COMPACTION_OVERFLOW_SHRINK_ATTEMPTS, COMPACTION_OVERFLOW_SHRINK_RATIOS;
+var archiveCompactionHistory, buildCompactionArchiveNotice, capCompactionStageTarget, proactiveCompactionEligibility, DEFAULT_COMPACTION_MAX_COMPLETION_TOKENS, COMPACTION_THINKING_EFFORT, COMPACTION_SUMMARY_RESERVE_RATIO, MAX_HIERARCHICAL_COMPACTION_PASSES, HIERARCHICAL_COMPACTION_PREFIX, CompactionTruncatedError, CompactionStallError, COMPACTION_STALL_MEASUREMENT_MULTIPLIER, REBUILT_AFTER_COMPACTION_INJECTION_VARIANTS, FullCompaction, MAX_COMPACTION_OVERFLOW_SHRINK_ATTEMPTS, COMPACTION_OVERFLOW_SHRINK_RATIOS;
 var init_full = __esmMin((() => {
 	({ archiveCompactionHistory, buildCompactionArchiveNotice } = createRequire(import.meta.url)("./bin/compaction-history-archive.cjs"));
 	({ capCompactionStageTarget } = createRequire(import.meta.url)("./bin/compaction-stage-policy.cjs"));
+	({ proactiveCompactionEligibility } = createRequire(import.meta.url)("./bin/proactive-compaction-policy.cjs"));
 	init_errors$8();
 	init_src$4();
 	init_errors$4();
@@ -75300,6 +75302,7 @@ var init_full = __esmMin((() => {
 		compactionTimingByProviderModel = /* @__PURE__ */ new Map();
 		lastCompactedState = null;
 		consecutiveOverflowCompactions = 0;
+		proactiveCompactionRequested = false;
 		strategy;
 		requiresShrinkableHistory;
 		constructor(agent, strategy) {
@@ -75329,6 +75332,27 @@ var init_full = __esmMin((() => {
 			const budget = this.strategy.compactionBudgetTokens;
 			return budget !== void 0 && Number.isFinite(budget) && budget > 0 ? Math.floor(budget) : void 0;
 		}
+		proactiveCompactionStatus() {
+			return proactiveCompactionEligibility({
+				usedTokens: this.estimateCurrentRequestTokens(),
+				budgetTokens: this.getCompactionBudgetTokens(),
+				hasShrinkableHistory: this.hasShrinkableHistory(this.agent.context.history),
+				isCompacting: this.isCompacting
+			});
+		}
+		isProactiveCompactionEligible() {
+			return this.proactiveCompactionStatus().eligible;
+		}
+		requestProactiveCompaction() {
+			const status = this.proactiveCompactionStatus();
+			if (!status.eligible) return status;
+			this.proactiveCompactionRequested = true;
+			this.agent.telemetry.track("proactive_compaction_requested", {
+				used_tokens: this.estimateCurrentRequestTokens(),
+				threshold_tokens: status.thresholdTokens
+			});
+			return status;
+		}
 		estimateCurrentRequestTokens(context = {}) {
 			const estimated = this.estimateProjectedRequestTokens(context);
 			return Math.max(this.tokenCountWithPending, estimated);
@@ -75406,6 +75430,7 @@ var init_full = __esmMin((() => {
 			this.compactionCountInTurn = 0;
 			this.lastCompactedState = null;
 			this.consecutiveOverflowCompactions = 0;
+			this.proactiveCompactionRequested = false;
 		}
 		async handleOverflowError(signal, error) {
 			this.consecutiveOverflowCompactions += 1;
@@ -75435,8 +75460,14 @@ var init_full = __esmMin((() => {
 			} });
 			return compacted;
 		}
-		async afterStep() {
+		async afterStep(signal) {
 			this.consecutiveOverflowCompactions = 0;
+			if (this.proactiveCompactionRequested) {
+				this.proactiveCompactionRequested = false;
+				if (!this.compacting) this.beginAutoCompaction();
+				await this.block(signal);
+				return;
+			}
 			if (this.strategy.checkAfterStep) this.checkAutoCompaction(false);
 		}
 		checkAutoCompaction(throwOnLimit = true, usedSize = this.tokenCountWithPending, messages = this.agent.context.history) {
@@ -78726,6 +78757,7 @@ var init_context$2 = __esmMin((() => {
 			if (removedMessages.size === 0) return 0;
 			this.agent.replayBuilder.removeLastMessages(removedMessages);
 			this.agent.microCompaction.reset(this._history.length);
+			this.agent.toolResultBatchOffload.reset(this._history);
 			this.agent.emitStatusUpdated();
 			return removedMessages.size;
 		}
@@ -78739,6 +78771,7 @@ var init_context$2 = __esmMin((() => {
 			this.deferredMessages = [];
 			this._lastAssistantAt = null;
 			this.agent.microCompaction.reset();
+			this.agent.toolResultBatchOffload.clear();
 			this.agent.injection.onContextClear();
 			this.agent.emitStatusUpdated();
 		}
@@ -78777,6 +78810,7 @@ var init_context$2 = __esmMin((() => {
 			this.pendingToolResultIds.clear();
 			this.deferredMessages = [];
 			this.agent.microCompaction.reset(this._history.length);
+			this.agent.toolResultBatchOffload.reset(this._history);
 			this.agent.emitStatusUpdated();
 			if (!this.agent.records.restoring && (stoppedAtBoundary || removedUserCount < count)) throw new BlunError(ErrorCodes.REQUEST_INVALID, formatUndoUnavailableMessage(count, removedUserCount, stoppedAtBoundary), { details: {
 				reason: "undo_limit",
@@ -78855,6 +78889,7 @@ var init_context$2 = __esmMin((() => {
 			this._tokenCount = result.tokensAfter;
 			this.tokenCountCoveredMessageCount = this._history.length;
 			this.agent.microCompaction.reset();
+			this.agent.toolResultBatchOffload.reset(this._history);
 			this.agent.injection.onContextCompacted();
 			this.agent.emitStatusUpdated();
 			return result;
@@ -78877,7 +78912,7 @@ var init_context$2 = __esmMin((() => {
 		}
 		project(messages, options) {
 			const anomalies = [];
-			const result = project(this.agent.microCompaction.compact(messages), {
+			const result = project(this.agent.microCompaction.compact(this.agent.toolResultBatchOffload.compact(messages)), {
 				...options,
 				onAnomaly: (anomaly) => {
 					anomalies.push(anomaly);
@@ -234797,6 +234832,9 @@ function restoreAgentRecord(agent, input) {
 		case "micro_compaction.apply":
 			agent.microCompaction.apply(input.cutoff);
 			return;
+		case "tool_result_batch_offload.apply":
+			agent.toolResultBatchOffload.apply(input.replacements);
+			return;
 		case "plan_mode.enter":
 			agent.planMode.restoreEnter(input);
 			return;
@@ -259984,6 +260022,11 @@ var init_tool_dedup = __esmMin((() => {
 async function budgetToolResultForModel(options) {
 	const text = persistableToolResultText(options.result.output);
 	if (text === void 0 || !shouldOffloadToolResult(text.length)) return options.result;
+	return persistToolResultForModel(options, text);
+}
+async function persistToolResultForModel(options, knownText) {
+	const text = knownText ?? persistableToolResultText(options.result.output);
+	if (text === void 0) return options.result;
 	if (options.result.truncated === true) return options.result;
 	if (options.homedir === void 0) return options.result;
 	const outputPath = await saveToolResult({
@@ -260047,7 +260090,7 @@ function renderPersistedToolResult(toolName, toolCallId, text, outputPath) {
 function safeToolResultFileStem(toolName, toolCallId) {
 	return `${toolName}-${toolCallId}`.replace(/[^a-zA-Z0-9._-]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 80) || "tool-result";
 }
-var TOOL_RESULT_MAX_CHARS, TOOL_RESULT_PREVIEW_CHARS, TOOL_RESULT_OFFLOAD_MARKER, shouldOffloadToolResult, createToolResultPreview, buildToolResultOffloadTelemetry;
+var TOOL_RESULT_MAX_CHARS, TOOL_RESULT_PREVIEW_CHARS, TOOL_RESULT_OFFLOAD_MARKER, shouldOffloadToolResult, createToolResultPreview, selectToolResultBatchOffloads, buildToolResultOffloadTelemetry;
 var init_tool_result_budget = __esmMin((() => {
 	init_dist$6();
 	const toolResultOffloadPolicy = createRequire(import.meta.url)("./bin/tool-result-offload-policy.cjs");
@@ -260057,7 +260100,110 @@ var init_tool_result_budget = __esmMin((() => {
 	TOOL_RESULT_OFFLOAD_MARKER = toolResultOffloadPolicy.TOOL_RESULT_OFFLOAD_MARKER;
 	shouldOffloadToolResult = toolResultOffloadPolicy.shouldOffloadToolResult;
 	createToolResultPreview = toolResultOffloadPolicy.createToolResultPreview;
-}));
+	selectToolResultBatchOffloads = toolResultOffloadPolicy.selectToolResultBatchOffloads;
+}));
+//#endregion
+//#region ../../packages/agent-core/src/agent/turn/tool-result-batch-offload.ts
+var ToolResultBatchOffload = class {
+	agent;
+	replacements = /* @__PURE__ */ new Map();
+	constructor(agent) {
+		this.agent = agent;
+	}
+	async detect() {
+		const history = this.agent.context.history;
+		const tail = [];
+		for (let index = history.length - 1; index >= 0; index -= 1) {
+			const message = history[index];
+			if (message?.role !== "tool") break;
+			tail.unshift(message);
+		}
+		const candidates = tail.map((message) => {
+			if (message.toolCallId === void 0 || this.replacements.has(message.toolCallId) || isPersistedToolResultReference(message.content)) return;
+			const text = persistableToolResultText(message.content);
+			if (text === void 0) return;
+			return {
+				message,
+				text,
+				toolName: this.toolNameFor(history, message.toolCallId)
+			};
+		}).filter((candidate) => candidate !== void 0);
+		const selected = selectToolResultBatchOffloads(candidates.map((candidate) => candidate.text.length));
+		if (selected.length === 0) return 0;
+		const replacements = [];
+		let charsBefore = 0;
+		let charsAfter = 0;
+		for (const index of selected) {
+			const candidate = candidates[index];
+			if (candidate === void 0) continue;
+			const original = {
+				output: candidate.message.content,
+				isError: candidate.message.isError
+			};
+			const persisted = await persistToolResultForModel({
+				homedir: this.agent.homedir,
+				toolName: candidate.toolName,
+				toolCallId: candidate.message.toolCallId,
+				result: original,
+				telemetry: this.agent.telemetry
+			}, candidate.text);
+			if (persisted === original || typeof persisted.output !== "string" || persisted.output.length >= candidate.text.length) continue;
+			const content = [{
+				type: "text",
+				text: persisted.output
+			}];
+			replacements.push({
+				toolCallId: candidate.message.toolCallId,
+				content
+			});
+			charsBefore += candidate.text.length;
+			charsAfter += persisted.output.length;
+		}
+		if (replacements.length === 0) return 0;
+		this.apply(replacements);
+		this.agent.telemetry.track("tool_result_batch_offloaded", {
+			result_count: replacements.length,
+			chars_before: charsBefore,
+			chars_after: charsAfter,
+			chars_saved: charsBefore - charsAfter
+		});
+		return replacements.length;
+	}
+	apply(replacements) {
+		for (const replacement of replacements) this.replacements.set(replacement.toolCallId, replacement.content);
+		this.agent.records.logRecord({
+			type: "tool_result_batch_offload.apply",
+			replacements
+		});
+	}
+	compact(messages) {
+		if (this.replacements.size === 0) return messages;
+		return messages.map((message) => {
+			if (message.role !== "tool" || message.toolCallId === void 0) return message;
+			const content = this.replacements.get(message.toolCallId);
+			return content === void 0 ? message : {
+				...message,
+				content
+			};
+		});
+	}
+	reset(history = this.agent.context?.history ?? []) {
+		const activeIds = new Set(history.filter((message) => message.role === "tool" && message.toolCallId !== void 0).map((message) => message.toolCallId));
+		for (const toolCallId of this.replacements.keys()) if (!activeIds.has(toolCallId)) this.replacements.delete(toolCallId);
+	}
+	clear() {
+		this.replacements.clear();
+	}
+	toolNameFor(history, toolCallId) {
+		for (let index = history.length - 1; index >= 0; index -= 1) {
+			const message = history[index];
+			if (message?.role !== "assistant" || !Array.isArray(message.toolCalls)) continue;
+			const call = message.toolCalls.find((candidate) => candidate.id === toolCallId);
+			if (call !== void 0) return call.name;
+		}
+		return "Tool";
+	}
+};
 //#endregion
 //#region ../../packages/agent-core/src/agent/turn/index.ts
 function blunExtractText(content) {
@@ -260979,7 +261125,9 @@ var init_turn = __esmMin((() => {
 				const loopControl = this.agent.blunConfig?.loopControl;
 				let stopForGoalBudget = false;
 				try {
-					const eligibleTools = blunToolsForOrigin(this.agent.injection.filterPersonalMemoryToolsForTurn(turnId, input, origin, this.agent.tools.loopTools), origin);
+					const originTools = blunToolsForOrigin(this.agent.injection.filterPersonalMemoryToolsForTurn(turnId, input, origin, this.agent.tools.loopTools), origin);
+					const compactConversationTool = originTools.find((tool) => tool.name === "CompactConversation");
+					const eligibleTools = originTools.filter((tool) => tool.name !== "CompactConversation" || this.agent.fullCompaction.isProactiveCompactionEligible());
 					const toolSelection = fastConversation ? {
 						tools: [...blunFastConversationTools(eligibleTools, input, pendingMediaJobIds)],
 						deferredToolCount: 0
@@ -261077,7 +261225,9 @@ var init_turn = __esmMin((() => {
 								previousStepToolOutcome = currentStepHadTool ? currentStepHadFailure ? "failure" : "success" : "none";
 								this.agent.usage.record(this.agent.activeResponderModel ?? model, usage, "turn");
 								if (stopForGoalBudget) this.setActiveSteerAcceptance(turnId, false);
-								await this.agent.fullCompaction.afterStep();
+								await this.agent.toolResultBatchOffload.detect();
+								await this.agent.fullCompaction.afterStep(signal);
+								if (compactConversationTool !== void 0 && this.agent.fullCompaction.isProactiveCompactionEligible() && !selectedTools.includes(compactConversationTool)) selectedTools.push(compactConversationTool);
 								deduper.endStep();
 								return stopForGoalBudget ? { stopTurn: true } : void 0;
 							},
@@ -261434,6 +261584,41 @@ var init_update_goal = __esmMin((() => {
 	};
 }));
 //#endregion
+//#region ../../packages/agent-core/src/tools/builtin/compact-conversation.ts
+var CompactConversationTool;
+var init_compact_conversation_tool = __esmMin((() => {
+	CompactConversationTool = class {
+		agent;
+		name = "CompactConversation";
+		description = "Compact older conversation messages into a concise continuation summary. Use after finishing a substantial phase, before switching to an unrelated task, or when a long conversation is becoming costly. The tool appears only after the context reaches the safe proactive threshold and takes no arguments.";
+		parameters = {
+			type: "object",
+			properties: {},
+			additionalProperties: false
+		};
+		constructor(agent) {
+			this.agent = agent;
+		}
+		resolveExecution(_args) {
+			return {
+				description: "Scheduling conversation compaction",
+				approvalRule: this.name,
+				execute: async () => {
+					const status = this.agent.fullCompaction.requestProactiveCompaction();
+					if (!status.eligible) return {
+						isError: false,
+						output: status.reason === "already_compacting" ? "Conversation compaction is already running." : "Nothing to compact yet; the conversation is within the safe proactive budget."
+					};
+					return {
+						isError: false,
+						output: `Conversation compaction scheduled at the end of this step (threshold: ${String(status.thresholdTokens)} estimated tokens).`
+					};
+				}
+			};
+		}
+	};
+}));
+//#endregion
 //#region ../../packages/agent-core/src/tools/builtin/planning/enter-plan-mode.md?raw
 var enter_plan_mode_default;
 var init_enter_plan_mode$1 = __esmMin((() => {
@@ -262870,6 +263055,7 @@ var init_tool$1 = __esmMin((() => {
 	init_profile();
 	init_skill$4();
 	init_builtin();
+	init_compact_conversation_tool();
 	init_types$3();
 	SHELL_FOREGROUND_TIMEOUT_S = 120;
 	ToolManager = class {
@@ -263263,6 +263449,7 @@ var init_tool$1 = __esmMin((() => {
 				goalToolsEnabled && new UpdateGoalTool(this.agent),
 				this.agent.rpc?.requestQuestion && new AskUserQuestionTool(this.agent),
 				new TodoListTool(this.toolStore),
+				new CompactConversationTool(this.agent),
 				new TaskListTool(background),
 				new TaskOutputTool(background),
 				new TaskStopTool(background),
@@ -263736,6 +263923,7 @@ var init_agent = __esmMin((() => {
 		records;
 		fullCompaction;
 		microCompaction;
+		toolResultBatchOffload;
 		context;
 		config;
 		turn;
@@ -263793,6 +263981,7 @@ var init_agent = __esmMin((() => {
 			}) : void 0));
 			this.fullCompaction = new FullCompaction(this, options.compactionStrategy);
 			this.microCompaction = new MicroCompaction(this, options.microCompaction);
+			this.toolResultBatchOffload = new ToolResultBatchOffload(this);
 			this.context = new ContextMemory(this);
 			this.config = new ConfigState(this);
 			this.turn = new TurnFlow(this);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blun-king-cli",
-  "version": "9.1.97",
+  "version": "9.1.99",
   "description": "BLUN CLI - your own AI agent with a Telegram channel. Get it done. With BLUN.",
   "license": "MIT",
   "bin": {