blun-king-cli 9.1.76 → 9.1.77

package/LIESMICH.txt

@@ -9,7 +9,7 @@ Installation
 ------------
 Die geprüfte Version exakt global installieren:
 
-  npm install -g blun-king-cli@9.1.69
+  npm install -g blun-king-cli@9.1.77
 
 Start
 -----
@@ -72,6 +72,20 @@ parallel geprüft und eingelesen. Die Skills werden weiterhin in der
 ursprünglichen, festen Reihenfolge registriert; Priorität und Verhalten bei
 doppelten Namen bleiben unverändert.
 
+Kontextentlastung bei langen Sitzungen
+--------------------------------------
+King bewahrt den vollständigen Verlauf weiterhin im Sitzungs-Wire auf. Erreicht
+der aktive Verlauf 75 Prozent des Modellfensters, ersetzt die Modellprojektion
+ältere große Werkzeugergebnisse durch einen kurzen Platzhalter. Die letzten 20
+Nachrichten bleiben unverändert. Solange der Prefix-Cache warm ist, wird der
+Schnitt höchstens nach jeweils 20 weiteren Nachrichten verschoben. Nach einer
+Stunde ohne Modellantwort darf er sofort nachziehen.
+
+Dabei werden keine gespeicherten Nachrichten geändert oder gelöscht. Fortsetzen,
+Exportieren und die sichtbare Historie behalten die ursprünglichen
+Werkzeugergebnisse. Das Telemetrieereignis `micro_compaction_finished` nennt den
+Auslöser, den Schnitt und die geschätzte Tokenzahl vor und nach der Entlastung.
+
 Zug-Wächter
 -----------
 Läuft ein Zug 20 Minuten ohne neues Werkzeugergebnis, meldet die Konsole den

package/README.md

@@ -94,6 +94,20 @@ parallel geprüft und eingelesen. Die Skills werden weiterhin in der
 ursprünglichen, festen Reihenfolge registriert; Priorität und Verhalten bei
 doppelten Namen bleiben unverändert.
 
+## Kontextentlastung bei langen Sitzungen
+
+King bewahrt den vollständigen Verlauf weiterhin im Sitzungs-Wire auf. Erreicht
+der aktive Verlauf 75 Prozent des Modellfensters, ersetzt die Modellprojektion
+ältere große Werkzeugergebnisse durch einen kurzen Platzhalter. Die letzten 20
+Nachrichten bleiben unverändert. Solange der Prefix-Cache warm ist, wird der
+Schnitt höchstens nach jeweils 20 weiteren Nachrichten verschoben. Nach einer
+Stunde ohne Modellantwort darf er sofort nachziehen.
+
+Dabei werden keine gespeicherten Nachrichten geändert oder gelöscht. Fortsetzen,
+Exportieren und die sichtbare Historie behalten die ursprünglichen
+Werkzeugergebnisse. Das Telemetrieereignis `micro_compaction_finished` nennt den
+Auslöser, den Schnitt und die geschätzte Tokenzahl vor und nach der Entlastung.
+
 ## Zug-Wächter
 
 Läuft ein Zug 20 Minuten ohne neues Werkzeugergebnis, meldet die Konsole den

package/bin/micro-compaction-policy.cjs

@@ -0,0 +1,75 @@
+'use strict';
+
+const MICRO_COMPACTION_PRESSURE_RATIO = 0.75;
+const MICRO_COMPACTION_MIN_ADVANCE_MESSAGES = 20;
+
+function selectMicroCompactionCutoff(options = {}) {
+  const historyLength = nonNegativeInteger(options.historyLength);
+  const currentCutoff = nonNegativeInteger(options.currentCutoff);
+  const keepRecentMessages = nonNegativeInteger(options.keepRecentMessages);
+  const nextCutoff = Math.max(0, historyLength - keepRecentMessages);
+  if (nextCutoff <= currentCutoff) return null;
+
+  const maxContextTokens = positiveFinite(options.maxContextTokens);
+  const contextTokens = nonNegativeFinite(options.contextTokens);
+  const contextUsageRatio = maxContextTokens === null
+    ? 1
+    : contextTokens / maxContextTokens;
+  const minContextUsageRatio = nonNegativeFinite(options.minContextUsageRatio);
+  if (contextUsageRatio < minContextUsageRatio) return null;
+
+  const now = finiteOr(options.now, Date.now());
+  const lastAssistantAt = finiteOrNull(options.lastAssistantAt);
+  const cacheAgeMs = lastAssistantAt === null ? null : Math.max(0, now - lastAssistantAt);
+  const cacheMissedThresholdMs = nonNegativeFinite(options.cacheMissedThresholdMs);
+  const cacheMissed = cacheAgeMs !== null && cacheAgeMs >= cacheMissedThresholdMs;
+  const underContextPressure = maxContextTokens !== null
+    && contextUsageRatio >= MICRO_COMPACTION_PRESSURE_RATIO;
+  if (!cacheMissed && !underContextPressure) return null;
+
+  if (
+    !cacheMissed
+    && currentCutoff > 0
+    && nextCutoff - currentCutoff < MICRO_COMPACTION_MIN_ADVANCE_MESSAGES
+  ) {
+    return null;
+  }
+
+  return {
+    cacheAgeMs,
+    contextUsageRatio,
+    cutoff: nextCutoff,
+    trigger: cacheMissed ? 'cache_miss' : 'context_pressure',
+  };
+}
+
+function finiteOr(value, fallback) {
+  const number = Number(value);
+  return Number.isFinite(number) ? number : fallback;
+}
+
+function finiteOrNull(value) {
+  if (value === null || value === undefined) return null;
+  const number = Number(value);
+  return Number.isFinite(number) ? number : null;
+}
+
+function nonNegativeFinite(value) {
+  const number = Number(value);
+  return Number.isFinite(number) && number >= 0 ? number : 0;
+}
+
+function nonNegativeInteger(value) {
+  return Math.floor(nonNegativeFinite(value));
+}
+
+function positiveFinite(value) {
+  const number = Number(value);
+  return Number.isFinite(number) && number > 0 ? number : null;
+}
+
+module.exports = {
+  MICRO_COMPACTION_MIN_ADVANCE_MESSAGES,
+  MICRO_COMPACTION_PRESSURE_RATIO,
+  selectMicroCompactionCutoff,
+};

package/blun.mjs

@@ -75889,8 +75889,9 @@ var init_full = __esmMin((() => {
 }));
 //#endregion
 //#region ../../packages/agent-core/src/agent/compaction/micro.ts
-var DEFAULT_CONFIG, MicroCompaction;
+var selectMicroCompactionCutoff, DEFAULT_CONFIG, MicroCompaction;
 var init_micro = __esmMin((() => {
+	({ selectMicroCompactionCutoff } = createRequire(import.meta.url)("./bin/micro-compaction-policy.cjs"));
 	init_tokens();
 	DEFAULT_CONFIG = {
 		keepRecentMessages: 20,
@@ -75920,9 +75921,67 @@ var init_micro = __esmMin((() => {
 			});
 			this.cutoff = cutoff;
 		}
-		detect() {}
+		detect() {
+			const config = this.config;
+			const { history, lastAssistantAt } = this.agent.context;
+			const maxContextTokens = this.agent.config.modelCapabilities.max_context_tokens;
+			const contextTokens = this.agent.context.tokenCountWithPending;
+			const selection = selectMicroCompactionCutoff({
+				historyLength: history.length,
+				currentCutoff: this.cutoff,
+				keepRecentMessages: config.keepRecentMessages,
+				contextTokens,
+				maxContextTokens,
+				lastAssistantAt,
+				now: Date.now(),
+				cacheMissedThresholdMs: config.cacheMissedThresholdMs,
+				minContextUsageRatio: config.minContextUsageRatio
+			});
+			if (selection === null) return;
+			const previousCutoff = this.cutoff;
+			const effect = this.measureEffect(history, selection.cutoff);
+			const previousEffect = this.measureEffect(history, previousCutoff);
+			if (effect.truncatedToolResultCount <= previousEffect.truncatedToolResultCount) return;
+			this.apply(selection.cutoff);
+			const rawContextTokens = estimateTokensForMessages(history);
+			const tokensBefore = rawContextTokens - previousEffect.truncatedToolResultTokensBefore + previousEffect.truncatedToolResultTokensAfter;
+			const tokensAfter = rawContextTokens - effect.truncatedToolResultTokensBefore + effect.truncatedToolResultTokensAfter;
+			this.agent.telemetry.track("micro_compaction_finished", {
+				trigger: selection.trigger,
+				keep_recent_messages: config.keepRecentMessages,
+				min_content_tokens: config.minContentTokens,
+				cache_missed_threshold_ms: config.cacheMissedThresholdMs,
+				truncated_marker: config.truncatedMarker,
+				min_context_usage_ratio: config.minContextUsageRatio,
+				context_usage_ratio: selection.contextUsageRatio,
+				truncated_tool_result_count: effect.truncatedToolResultCount,
+				truncated_tool_result_tokens_before: effect.truncatedToolResultTokensBefore,
+				truncated_tool_result_tokens_after: effect.truncatedToolResultTokensAfter,
+				tokens_before: tokensBefore,
+				tokens_after: tokensAfter,
+				previous_cutoff: previousCutoff,
+				cutoff: selection.cutoff,
+				message_count: history.length,
+				cache_age_ms: selection.cacheAgeMs,
+				thinking_effort: this.agent.config.thinkingEffort
+			});
+		}
 		compact(messages) {
-			return messages;
+			const config = this.config;
+			const result = [];
+			let i = 0;
+			for (const msg of messages) {
+				if (i < this.cutoff && msg.role === "tool" && msg.toolCallId !== void 0 && estimateTokensForContentParts(msg.content) >= config.minContentTokens) result.push({
+					...msg,
+					content: [{
+						type: "text",
+						text: config.truncatedMarker
+					}]
+				});
+				else result.push(msg);
+				i++;
+			}
+			return result;
 		}
 		measureEffect(messages, cutoff) {
 			let markerTokenCount;

package/package.json

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