blun-king-cli 9.1.97 → 9.1.98

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.98
 
 Start
 -----
@@ -85,6 +85,8 @@ 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.

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.98
 ```
 
 ## Reproduzierbares Staging und Packen
@@ -105,6 +105,8 @@ 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.

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/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) {
@@ -260979,7 +261010,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 +261110,8 @@ 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.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 +261468,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 +262939,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 +263333,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),

package/package.json

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