blun-king-cli 9.1.83 → 9.1.85

package/LIESMICH.txt

@@ -9,7 +9,7 @@ Installation
 ------------
 Die geprüfte Version exakt global installieren:
 
-  npm install -g blun-king-cli@9.1.83
+  npm install -g blun-king-cli@9.1.85
 
 Start
 -----
@@ -80,7 +80,7 @@ Dabei werden keine gespeicherten Nachrichten geändert oder gelöscht. Fortsetze
 
 ## Große Werkzeugausgaben und isolierte Teilagenten
 
-Werkzeugausgaben mit mehr als 50.000 Zeichen werden vollständig unter `<agent-home>/tool-results/` gespeichert. Im Modellkontext bleiben nur eine Vorschau der ersten 2.000 Zeichen, der genaue `output_path` und der Hinweis, die Datei bei Bedarf mit `Read` zu öffnen. Dadurch bleibt die vollständige Ausgabe wiederauffindbar, ohne in jedem weiteren Modellschritt erneut als großer Textblock mitzufahren.
+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 eine Vorschau mit 2.000 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 enthalten die folgenden Modellanfragen nur noch die Vorschau und den lesbaren Pfad; der vollständige Text bleibt lokal verfügbar.
 
 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.
 
@@ -227,6 +227,13 @@ sodass auch kurze Schritte wie Rendern und Speichern in der Produktionskette
 sichtbar sind. Aktualisierte Vorschaubilder werden erneuert; Medienpfade und
 Webadressen sind als Terminalverweise anklickbar.
 
+Gestufte Verdichtung für große Sitzungen
+-----------------------------------------
+
+Eine Vollverdichtung verwendet jetzt pro Zusammenfassungsstufe höchstens 64.000 geschätzte Eingabe-Token als Zielwert. Die feste Sicherheitsgrenze des aktiven Modells bleibt unverändert. King teilt den älteren Verlauf an gültigen Nachrichtengrenzen, fasst jeden chronologischen Abschnitt zusammen und übernimmt diese Zusammenfassung in die nächste Stufe. Dabei wird kein noch nicht zusammengefasster Verlauf verworfen. Ist eine einzelne unteilbare Nachricht größer als der Stufenzielwert, bleibt die bestehende feste Sicherheitsgrenze der Rückfallweg.
+
+Beispiel: Ein auf 256.000 Token geschätzter Verdichtungsauftrag wird in mehreren kleineren Stufen verarbeitet, statt als eine einzige große Anbieteranfrage. Die genaue Stufenzahl hängt von den Nachrichtengrenzen und den erzeugten Zwischenzusammenfassungen ab. Der Protokolleintrag `compaction stage request` nennt `targetInputTokens`; das Telemetrieereignis `compaction_finished` nennt `stage_count`. Das private Verlaufsarchiv und der ursprüngliche Sitzungs-Wire bleiben vollständig.
+
 Wiederauffindbarer Verdichtungsverlauf
 --------------------------------------
 

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.83
+npm install -g blun-king-cli@9.1.85
 ```
 
 ## Reproduzierbares Staging und Packen
@@ -102,7 +102,7 @@ Dabei werden keine gespeicherten Nachrichten geändert oder gelöscht. Fortsetze
 
 ## Große Werkzeugausgaben und isolierte Teilagenten
 
-Werkzeugausgaben mit mehr als 50.000 Zeichen werden vollständig unter `<agent-home>/tool-results/` gespeichert. Im Modellkontext bleiben nur eine Vorschau der ersten 2.000 Zeichen, der genaue `output_path` und der Hinweis, die Datei bei Bedarf mit `Read` zu öffnen. Dadurch bleibt die vollständige Ausgabe wiederauffindbar, ohne in jedem weiteren Modellschritt erneut als großer Textblock mitzufahren.
+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 eine Vorschau mit 2.000 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 enthalten die folgenden Modellanfragen nur noch die Vorschau und den lesbaren Pfad; der vollständige Text bleibt lokal verfügbar.
 
 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.
 
@@ -255,6 +255,12 @@ sodass auch kurze Schritte wie Rendern und Speichern in der Produktionskette
 sichtbar sind. Aktualisierte Vorschaubilder werden erneuert; Medienpfade und
 Webadressen sind als Terminalverweise anklickbar.
 
+## Gestufte Verdichtung für große Sitzungen
+
+Eine Vollverdichtung verwendet jetzt pro Zusammenfassungsstufe höchstens 64.000 geschätzte Eingabe-Token als Zielwert. Die feste Sicherheitsgrenze des aktiven Modells bleibt unverändert. King teilt den älteren Verlauf an gültigen Nachrichtengrenzen, fasst jeden chronologischen Abschnitt zusammen und übernimmt diese Zusammenfassung in die nächste Stufe. Dabei wird kein noch nicht zusammengefasster Verlauf verworfen. Ist eine einzelne unteilbare Nachricht größer als der Stufenzielwert, bleibt die bestehende feste Sicherheitsgrenze der Rückfallweg.
+
+Beispiel: Ein auf 256.000 Token geschätzter Verdichtungsauftrag wird in mehreren kleineren Stufen verarbeitet, statt als eine einzige große Anbieteranfrage. Die genaue Stufenzahl hängt von den Nachrichtengrenzen und den erzeugten Zwischenzusammenfassungen ab. Der Protokolleintrag `compaction stage request` nennt `targetInputTokens`; das Telemetrieereignis `compaction_finished` nennt `stage_count`. Das private Verlaufsarchiv und der ursprüngliche Sitzungs-Wire bleiben vollständig.
+
 ## Wiederauffindbarer Verdichtungsverlauf
 
 Bevor eine erfolgreiche Vollverdichtung ältere Nachrichten ersetzt, schreibt King den verdrängten Verlauf in ein privates Markdown-Archiv unter `~/.blun/conversation-history/`. Die Verdichtungszusammenfassung enthält den genauen `history_path`, sodass der Agent mit `Read` Einzelheiten wiederfinden kann, die nicht in der Zusammenfassung stehen.

package/bin/compaction-stage-policy.cjs

@@ -0,0 +1,13 @@
+"use strict";
+
+const DEFAULT_COMPACTION_STAGE_MAX_TOKENS = 64_000;
+
+function capCompactionStageTarget(safeRequestLimitTokens) {
+  if (!Number.isFinite(safeRequestLimitTokens) || safeRequestLimitTokens <= 0) return 0;
+  return Math.min(Math.floor(safeRequestLimitTokens), DEFAULT_COMPACTION_STAGE_MAX_TOKENS);
+}
+
+module.exports = {
+  DEFAULT_COMPACTION_STAGE_MAX_TOKENS,
+  capCompactionStageTarget,
+};

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

@@ -0,0 +1,28 @@
+'use strict';
+
+const TOOL_RESULT_MAX_CHARS = 12_000;
+const TOOL_RESULT_PREVIEW_CHARS = 2_000;
+const TOOL_RESULT_OFFLOAD_MARKER = '[Tool result offloaded]';
+
+function shouldOffloadToolResult(textLength) {
+  return Number.isFinite(textLength) && textLength > TOOL_RESULT_MAX_CHARS;
+}
+
+function isPersistedToolResultReference(content) {
+  if (!Array.isArray(content)) return false;
+
+  return content.some((part) => {
+    if (part?.type !== 'text' || typeof part.text !== 'string') return false;
+    if (!part.text.includes('\noutput_path: ')) return false;
+    return part.text.startsWith(`${TOOL_RESULT_OFFLOAD_MARKER}\n`)
+      || /^Tool output exceeded \d+ characters; showing a preview only\.\n/u.test(part.text);
+  });
+}
+
+module.exports = {
+  TOOL_RESULT_MAX_CHARS,
+  TOOL_RESULT_PREVIEW_CHARS,
+  TOOL_RESULT_OFFLOAD_MARKER,
+  isPersistedToolResultReference,
+  shouldOffloadToolResult,
+};

package/blun.mjs

@@ -75237,9 +75237,10 @@ 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, 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, 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"));
 	init_errors$8();
 	init_src$4();
 	init_errors$4();
@@ -75578,14 +75579,15 @@ var init_full = __esmMin((() => {
 				while (true) {
 					const compactionRequestLimit = this.getEffectiveMaxContextTokens();
 					const safeCompactionRequestLimit = compactionRequestLimit > 0 ? Math.max(1, Math.floor(compactionRequestLimit * (1 - COMPACTION_SUMMARY_RESERVE_RATIO))) : compactionRequestLimit;
+					const targetCompactionRequestLimit = capCompactionStageTarget(safeCompactionRequestLimit);
 					let messages = buildRequestMessages(historyForModel, instruction);
 					let estimatedCompactionRequestTokens = this.estimateRequestTokens(messages, this.agent.effectiveSystemPrompt, compactionTools);
 					initialCompactionRequestTokens ??= estimatedCompactionRequestTokens;
 					let hierarchicalChunkEnd;
-					if (safeCompactionRequestLimit > 0 && estimatedCompactionRequestTokens >= safeCompactionRequestLimit) {
+					if (targetCompactionRequestLimit > 0 && estimatedCompactionRequestTokens >= targetCompactionRequestLimit) {
 						if (historyForModel.length > 1) {
 							const chunkInstruction = `${instruction}\n\nThis request contains only the oldest chronological segment. Summarize every fact needed by a later merge pass. Do not assume later messages are visible.`;
-							const chunk = selectHierarchicalCompactionChunk(historyForModel, safeCompactionRequestLimit, safeCompactionRequestLimit, (candidate) => {
+							const chunk = selectHierarchicalCompactionChunk(historyForModel, targetCompactionRequestLimit, safeCompactionRequestLimit, (candidate) => {
 								const candidateMessages = buildRequestMessages(candidate, chunkInstruction);
 								return {
 									messages: candidateMessages,
@@ -75598,7 +75600,7 @@ var init_full = __esmMin((() => {
 								estimatedCompactionRequestTokens = chunk.estimatedTokens;
 							}
 						}
-						if (hierarchicalChunkEnd === void 0) throw new BlunError(ErrorCodes.CONTEXT_OVERFLOW, `Compaction stopped before upload: the conversation (${String(tokensBefore)} tokens) could not be divided into a request below the active model window (${String(compactionRequestLimit)} tokens).`, { details: {
+						if (hierarchicalChunkEnd === void 0 && estimatedCompactionRequestTokens >= safeCompactionRequestLimit) throw new BlunError(ErrorCodes.CONTEXT_OVERFLOW, `Compaction stopped before upload: the conversation (${String(tokensBefore)} tokens) could not be divided into a request below the active model window (${String(compactionRequestLimit)} tokens).`, { details: {
 							contextBrakeBlocked: true,
 							estimatedRequestTokens: estimatedCompactionRequestTokens,
 							maxContextTokens: compactionRequestLimit,
@@ -75623,6 +75625,7 @@ var init_full = __esmMin((() => {
 						activeContextTokens: this.estimateProjectedRequestTokens(),
 						estimatedInputTokens: estimatedCompactionRequestTokens,
 						windowUsagePercent,
+						targetInputTokens: targetCompactionRequestLimit,
 						safeInputLimitTokens: safeCompactionRequestLimit,
 						maxContextTokens: compactionRequestLimit
 					});
@@ -75809,6 +75812,7 @@ var init_full = __esmMin((() => {
 					retry_count: retryCount,
 					round: 1,
 					thinking_effort: COMPACTION_THINKING_EFFORT,
+					stage_count: hierarchicalPassCount + 1,
 					...usage === null ? {} : {
 						input_tokens: inputTotal(usage),
 						output_tokens: usage.output
@@ -75907,9 +75911,10 @@ var init_full = __esmMin((() => {
 }));
 //#endregion
 //#region ../../packages/agent-core/src/agent/compaction/micro.ts
-var selectMicroCompactionCutoff, DEFAULT_CONFIG, MicroCompaction;
+var selectMicroCompactionCutoff, isPersistedToolResultReference, DEFAULT_CONFIG, MicroCompaction;
 var init_micro = __esmMin((() => {
 	({ selectMicroCompactionCutoff } = createRequire(import.meta.url)("./bin/micro-compaction-policy.cjs"));
+	({ isPersistedToolResultReference } = createRequire(import.meta.url)("./bin/tool-result-offload-policy.cjs"));
 	init_tokens();
 	DEFAULT_CONFIG = {
 		keepRecentMessages: 20,
@@ -75996,7 +76001,7 @@ var init_micro = __esmMin((() => {
 			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({
+				if (i < this.cutoff && msg.role === "tool" && msg.toolCallId !== void 0 && !isPersistedToolResultReference(msg.content) && estimateTokensForContentParts(msg.content) >= config.minContentTokens) result.push({
 					...msg,
 					content: [{
 						type: "text",
@@ -76041,7 +76046,7 @@ var init_micro = __esmMin((() => {
 			const serializedArgumentsMarker = JSON.stringify({ _blun_compacted: this.config.truncatedArgumentsMarker });
 			for (let i = 0; i < messages.length && i < cutoff; i++) {
 				const message = messages[i];
-				if (message?.role === "tool" && message.toolCallId !== void 0) {
+				if (message?.role === "tool" && message.toolCallId !== void 0 && !isPersistedToolResultReference(message.content)) {
 					const contentTokens = estimateTokensForContentParts(message.content);
 					if (contentTokens >= this.config.minContentTokens) {
 						markerTokenCount ??= estimateTokensForContentParts([{
@@ -259957,7 +259962,7 @@ var init_tool_dedup = __esmMin((() => {
 //#region ../../packages/agent-core/src/agent/turn/tool-result-budget.ts
 async function budgetToolResultForModel(options) {
 	const text = persistableToolResultText(options.result.output);
-	if (text === void 0 || text.length <= TOOL_RESULT_MAX_CHARS) return options.result;
+	if (text === void 0 || !shouldOffloadToolResult(text.length)) return options.result;
 	if (options.result.truncated === true) return options.result;
 	if (options.homedir === void 0) return options.result;
 	const outputPath = await saveToolResult({
@@ -259996,7 +260001,8 @@ async function saveToolResult(options, text) {
 		const outputPath = join$4(dir, `${safeToolResultFileStem(options.toolName, options.toolCallId)}-${randomUUID()}.txt`);
 		await writeFile(outputPath, text, {
 			encoding: "utf8",
-			flag: "wx"
+			flag: "wx",
+			mode: 384
 		});
 		return outputPath;
 	} catch {
@@ -260005,6 +260011,7 @@ async function saveToolResult(options, text) {
 }
 function renderPersistedToolResult(toolName, toolCallId, text, outputPath) {
 	const lines = [
+		TOOL_RESULT_OFFLOAD_MARKER,
 		`Tool output exceeded ${String(TOOL_RESULT_MAX_CHARS)} characters; showing a preview only.`,
 		`tool_name: ${toolName}`,
 		`tool_call_id: ${toolCallId}`,
@@ -260019,12 +260026,15 @@ 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, buildToolResultOffloadTelemetry;
+var TOOL_RESULT_MAX_CHARS, TOOL_RESULT_PREVIEW_CHARS, TOOL_RESULT_OFFLOAD_MARKER, shouldOffloadToolResult, buildToolResultOffloadTelemetry;
 var init_tool_result_budget = __esmMin((() => {
 	init_dist$6();
+	const toolResultOffloadPolicy = createRequire(import.meta.url)("./bin/tool-result-offload-policy.cjs");
 	({ buildToolResultOffloadTelemetry } = createRequire(import.meta.url)("./bin/tool-result-offload-telemetry.cjs"));
-	TOOL_RESULT_MAX_CHARS = 5e4;
-	TOOL_RESULT_PREVIEW_CHARS = 2e3;
+	TOOL_RESULT_MAX_CHARS = toolResultOffloadPolicy.TOOL_RESULT_MAX_CHARS;
+	TOOL_RESULT_PREVIEW_CHARS = toolResultOffloadPolicy.TOOL_RESULT_PREVIEW_CHARS;
+	TOOL_RESULT_OFFLOAD_MARKER = toolResultOffloadPolicy.TOOL_RESULT_OFFLOAD_MARKER;
+	shouldOffloadToolResult = toolResultOffloadPolicy.shouldOffloadToolResult;
 }));
 //#endregion
 //#region ../../packages/agent-core/src/agent/turn/index.ts

package/package.json

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