blun-king-cli 9.1.96 → 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.96
+  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.96
+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
@@ -30427,6 +30428,7 @@ var init_input_schema = __esmMin((() => {
 var todo_list_default;
 var init_todo_list$1 = __esmMin((() => {
 	todo_list_default = "Use this tool to maintain a structured TODO list as you work through a multi-step task. Use it proactively and often when progress tracking helps the current work. This is especially useful in long-running investigations and implementation tasks with several tool calls; in plan mode, write the plan to the plan file rather than tracking it here.\n\n**When to use:**\n- Multi-step tasks that span several tool calls\n- Tracking investigation progress across a large codebase search\n- Planning a sequence of edits before making them\n- After receiving new multi-step instructions, capture the requirements as todos\n- Before starting a tracked task, mark exactly one item as `in_progress`\n- Immediately after finishing a tracked task, record its truthful terminal state; do not batch completions at the end\n\n**When NOT to use:**\n- Single-shot answers that complete in one or two tool calls\n- Trivial requests where tracking adds no clarity\n- Purely conversational or informational replies\n\n**Avoid churn:**\n- Do not re-call this tool when nothing meaningful has changed since the last call — update the list only after real progress.\n- When unsure of the current state, call query mode first (omit `todos`) to check the list before deciding what to update.\n- If no available tool can move any task forward, tell the user where you are stuck instead of repeatedly re-ordering the same todos.\n\n**How to use:**\n- Call with `todos: [...]` to replace the full list. Statuses: pending / in_progress / done / blocked / waiting_approval / aborted.\n- Call with no `todos` argument to retrieve the current list without changing it.\n- Call with `todos: []` to clear the list.\n- Keep titles short and actionable (e.g. \"Read session-control.ts\", \"Add planMode flag to TurnManager\").\n- Update statuses as you make progress.\n- When work is underway, keep exactly one task `in_progress`.\n- Use `done` only when fully accomplished. Use `blocked` with the reason and the action that would unblock it, `waiting_approval` with the prepared result that awaits approval, and `aborted` with the last reached state.\n- Never mark a task `done` if tests are failing, implementation is partial, unresolved errors remain, or required files/dependencies could not be found.\n";
+	todo_list_default = "Maintain a structured TODO list when it adds clarity to multi-step work; skip it for conversation or a single-shot task. In plan mode, use the plan file instead.\n\nCall with `todos: [...]` to replace the full list. Statuses are `pending`, `in_progress`, `done`, `blocked`, `waiting_approval`, and `aborted`. Omit `todos` to query the current list; use `todos: []` to clear it.\n\nKeep titles short and actionable. Capture the real requirements, keep exactly one item `in_progress` while tracked work is active, and update a status immediately after real progress instead of batching or rewriting an unchanged list. Use `done` only for fully verified work. A `blocked` item names the reason and the action that can unblock it; `waiting_approval` names the prepared result awaiting approval; `aborted` records the last reached state. Before finishing, reconcile every tracked item truthfully. If no available tool can move the work forward, report the blocker to the user instead of churning the list.";
 }));
 //#endregion
 //#region ../../packages/agent-core/src/tools/builtin/state/todo-list.ts
@@ -75240,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();
@@ -75299,6 +75302,7 @@ var init_full = __esmMin((() => {
 		compactionTimingByProviderModel = /* @__PURE__ */ new Map();
 		lastCompactedState = null;
 		consecutiveOverflowCompactions = 0;
+		proactiveCompactionRequested = false;
 		strategy;
 		requiresShrinkableHistory;
 		constructor(agent, strategy) {
@@ -75328,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);
@@ -75405,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;
@@ -75434,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) {
@@ -260978,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
@@ -261076,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;
 							},
@@ -261433,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((() => {
@@ -262869,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 {
@@ -263262,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.96",
+  "version": "9.1.98",
   "description": "BLUN CLI - your own AI agent with a Telegram channel. Get it done. With BLUN.",
   "license": "MIT",
   "bin": {