blun-king-cli 9.1.81 → 9.1.83

package/LIESMICH.txt

@@ -9,7 +9,7 @@ Installation
 ------------
 Die geprüfte Version exakt global installieren:
 
-  npm install -g blun-king-cli@9.1.81
+  npm install -g blun-king-cli@9.1.83
 
 Start
 -----
@@ -74,17 +74,9 @@ 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.
+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 sowie große Argumente abgeschlossener Werkzeugaufrufe durch kurze Platzhalter. Werkzeugargumente werden nur entlastet, wenn ein zugehöriges Werkzeugergebnis vorliegt und die gespeicherten Argumente gültiges JSON sind. 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 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.
 
 ## Große Werkzeugausgaben und isolierte Teilagenten
 
@@ -99,6 +91,8 @@ Rein lesende Sitzungsdiagnose
 
 Der mitgelieferte Standardskill `blun-session-inspector` untersucht den nur ergänzten Sitzungs-Wire und die zugehörigen Telemetriedateien, ohne eine Sitzung zu verändern. Er meldet Modellschritte, Werkzeugaufrufe, Zähler zum Tokenverbrauch, Voll- und Mikroverdichtungen, fehlgeschlagene Verdichtungen sowie ausgelagerte Werkzeugergebnisse. Prompts, Systemanweisungen, Werkzeugargumente, Werkzeugergebnisse, private Pfade und verborgenes Denken erscheinen nicht in der Standardausgabe.
 
+Zusätzlich liest der Inspektor das sitzungseigene BLUN-Protokoll und meldet, wie viele Werkzeugschemata verfügbar, ausgewählt und zurückgestellt waren, wie viele geschätzte Schema-Token vermieden wurden und warum die Werkzeugmenge reduziert wurde. Andere Protokollinhalte werden weder ausgegeben noch ausgewertet.
+
 Beispiele:
 
   node "$SKILL_DIR/scripts/inspect-session.cjs" --list 20

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.81
+npm install -g blun-king-cli@9.1.83
 ```
 
 ## Reproduzierbares Staging und Packen
@@ -96,17 +96,9 @@ 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.
+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 sowie große Argumente abgeschlossener Werkzeugaufrufe durch kurze Platzhalter. Werkzeugargumente werden nur entlastet, wenn ein zugehöriges Werkzeugergebnis vorliegt und die gespeicherten Argumente gültiges JSON sind. 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.
+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.
 
 ## Große Werkzeugausgaben und isolierte Teilagenten
 
@@ -120,6 +112,8 @@ Reguläre `Agent`-Teilaufgaben verwenden eine eigene `ContextMemory` und eine ei
 
 Der mitgelieferte Standardskill `blun-session-inspector` untersucht den nur ergänzten Sitzungs-Wire und die zugehörigen Telemetriedateien, ohne eine Sitzung zu verändern. Er meldet Modellschritte, Werkzeugaufrufe, Zähler zum Tokenverbrauch, Voll- und Mikroverdichtungen, fehlgeschlagene Verdichtungen sowie ausgelagerte Werkzeugergebnisse. Prompts, Systemanweisungen, Werkzeugargumente, Werkzeugergebnisse, private Pfade und verborgenes Denken erscheinen nicht in der Standardausgabe.
 
+Zusätzlich liest der Inspektor das sitzungseigene BLUN-Protokoll und meldet, wie viele Werkzeugschemata verfügbar, ausgewählt und zurückgestellt waren, wie viele geschätzte Schema-Token vermieden wurden und warum die Werkzeugmenge reduziert wurde. Andere Protokollinhalte werden weder ausgegeben noch ausgewertet.
+
 Beispiele:
 
 ```text

package/blun.mjs

@@ -75916,6 +75916,7 @@ var init_micro = __esmMin((() => {
 		minContentTokens: 100,
 		cacheMissedThresholdMs: 3600 * 1e3,
 		truncatedMarker: "[Old tool result content cleared]",
+		truncatedArgumentsMarker: "[Old tool call arguments cleared]",
 		minContextUsageRatio: .5
 	};
 	MicroCompaction = class {
@@ -75959,22 +75960,26 @@ var init_micro = __esmMin((() => {
 			const previousCutoff = this.cutoff;
 			const effect = this.measureEffect(history, selection.cutoff);
 			const previousEffect = this.measureEffect(history, previousCutoff);
-			if (effect.truncatedToolResultCount <= previousEffect.truncatedToolResultCount) return;
+			if (effect.truncatedToolResultCount <= previousEffect.truncatedToolResultCount && effect.truncatedToolArgumentCount <= previousEffect.truncatedToolArgumentCount) return;
 			this.apply(selection.cutoff);
 			const rawContextTokens = estimateTokensForMessages(history);
-			const tokensBefore = rawContextTokens - previousEffect.truncatedToolResultTokensBefore + previousEffect.truncatedToolResultTokensAfter;
-			const tokensAfter = rawContextTokens - effect.truncatedToolResultTokensBefore + effect.truncatedToolResultTokensAfter;
+			const tokensBefore = rawContextTokens - previousEffect.truncatedToolResultTokensBefore + previousEffect.truncatedToolResultTokensAfter - previousEffect.truncatedToolArgumentTokensBefore + previousEffect.truncatedToolArgumentTokensAfter;
+			const tokensAfter = rawContextTokens - effect.truncatedToolResultTokensBefore + effect.truncatedToolResultTokensAfter - effect.truncatedToolArgumentTokensBefore + effect.truncatedToolArgumentTokensAfter;
 			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,
+				truncated_arguments_marker: config.truncatedArgumentsMarker,
 				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,
+				truncated_tool_argument_count: effect.truncatedToolArgumentCount,
+				truncated_tool_argument_tokens_before: effect.truncatedToolArgumentTokensBefore,
+				truncated_tool_argument_tokens_after: effect.truncatedToolArgumentTokensAfter,
 				tokens_before: tokensBefore,
 				tokens_after: tokensAfter,
 				previous_cutoff: previousCutoff,
@@ -75986,6 +75991,8 @@ var init_micro = __esmMin((() => {
 		}
 		compact(messages) {
 			const config = this.config;
+			const completedToolCallIds = new Set(messages.filter((message) => message?.role === "tool" && message.toolCallId !== void 0).map((message) => message.toolCallId));
+			const serializedArgumentsMarker = JSON.stringify({ _blun_compacted: config.truncatedArgumentsMarker });
 			const result = [];
 			let i = 0;
 			for (const msg of messages) {
@@ -75996,6 +76003,26 @@ var init_micro = __esmMin((() => {
 						text: config.truncatedMarker
 					}]
 				});
+				else if (i < this.cutoff && msg.role === "assistant" && Array.isArray(msg.toolCalls)) {
+					let changed = false;
+					const toolCalls = msg.toolCalls.map((call) => {
+						if (!completedToolCallIds.has(call.id) || typeof call.arguments !== "string" || this.toolArgumentTokens(call.arguments) < config.minContentTokens) return call;
+						try {
+							JSON.parse(call.arguments);
+						} catch {
+							return call;
+						}
+						changed = true;
+						return {
+							...call,
+							arguments: serializedArgumentsMarker
+						};
+					});
+					result.push(changed ? {
+						...msg,
+						toolCalls
+					} : msg);
+				}
 				else result.push(msg);
 				i++;
 			}
@@ -76003,28 +76030,70 @@ var init_micro = __esmMin((() => {
 		}
 		measureEffect(messages, cutoff) {
 			let markerTokenCount;
+			let argumentsMarkerTokenCount;
 			let truncatedToolResultCount = 0;
 			let truncatedToolResultTokensBefore = 0;
 			let truncatedToolResultTokensAfter = 0;
+			let truncatedToolArgumentCount = 0;
+			let truncatedToolArgumentTokensBefore = 0;
+			let truncatedToolArgumentTokensAfter = 0;
+			const completedToolCallIds = new Set(messages.filter((message) => message?.role === "tool" && message.toolCallId !== void 0).map((message) => message.toolCallId));
+			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) continue;
-				const contentTokens = estimateTokensForContentParts(message.content);
-				if (contentTokens < this.config.minContentTokens) continue;
-				markerTokenCount ??= estimateTokensForContentParts([{
-					type: "text",
-					text: this.config.truncatedMarker
-				}]);
-				truncatedToolResultCount += 1;
-				truncatedToolResultTokensBefore += contentTokens;
-				truncatedToolResultTokensAfter += markerTokenCount;
+				if (message?.role === "tool" && message.toolCallId !== void 0) {
+					const contentTokens = estimateTokensForContentParts(message.content);
+					if (contentTokens >= this.config.minContentTokens) {
+						markerTokenCount ??= estimateTokensForContentParts([{
+							type: "text",
+							text: this.config.truncatedMarker
+						}]);
+						truncatedToolResultCount += 1;
+						truncatedToolResultTokensBefore += contentTokens;
+						truncatedToolResultTokensAfter += markerTokenCount;
+					}
+				}
+				if (message?.role !== "assistant" || !Array.isArray(message.toolCalls)) continue;
+				for (const call of message.toolCalls) {
+					if (!completedToolCallIds.has(call.id) || typeof call.arguments !== "string") continue;
+					try {
+						JSON.parse(call.arguments);
+					} catch {
+						continue;
+					}
+					const argumentTokens = this.toolArgumentTokens(call.arguments);
+					if (argumentTokens < this.config.minContentTokens) continue;
+					argumentsMarkerTokenCount ??= this.toolArgumentTokens(serializedArgumentsMarker);
+					truncatedToolArgumentCount += 1;
+					truncatedToolArgumentTokensBefore += argumentTokens;
+					truncatedToolArgumentTokensAfter += argumentsMarkerTokenCount;
+				}
 			}
 			return {
 				truncatedToolResultCount,
 				truncatedToolResultTokensBefore,
-				truncatedToolResultTokensAfter
+				truncatedToolResultTokensAfter,
+				truncatedToolArgumentCount,
+				truncatedToolArgumentTokensBefore,
+				truncatedToolArgumentTokensAfter
 			};
 		}
+		toolArgumentTokens(argumentsValue) {
+			return estimateTokensForMessages([{
+				role: "assistant",
+				content: [],
+				toolCalls: [{
+					type: "function",
+					id: "",
+					name: "",
+					arguments: argumentsValue
+				}]
+			}]) - estimateTokensForMessages([{
+				role: "assistant",
+				content: [],
+				toolCalls: []
+			}]);
+		}
 	};
 }));
 //#endregion

package/package.json

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

package/standard-skills/blun-session-inspector/SKILL.md

@@ -9,6 +9,8 @@ compatibility: designed for BLUN Code
 
 Use the bundled script instead of manually reading `wire.jsonl` or telemetry files. It reports counts and timing metadata without returning prompts, system instructions, tool arguments, tool results, private paths, or hidden reasoning.
 
+In addition to wire and telemetry counts, the summary reads only structured `turn request tools` fields from the session's own BLUN log. It reports eligible, selected, and deferred schema counts, estimated schema tokens avoided, and suppression reasons. Micro-compaction telemetry also reports how many completed tool-call arguments were relieved and the estimated argument tokens saved. Argument contents are never returned. Other log lines are ignored and never emitted.
+
 Resolve `SKILL_DIR` to the directory containing this file. Do not assume a user-specific installation path.
 
 List recent sessions:

package/standard-skills/blun-session-inspector/scripts/inspect-session.cjs

@@ -139,6 +139,17 @@ function numberValue(value) {
   return Number.isFinite(Number(value)) ? Number(value) : 0;
 }
 
+function emptyTokenSeries() {
+  return { total: 0, min: null, max: null, last: null };
+}
+
+function addTokenValue(series, value) {
+  series.total += value;
+  series.min = series.min === null ? value : Math.min(series.min, value);
+  series.max = series.max === null ? value : Math.max(series.max, value);
+  series.last = value;
+}
+
 function usageValue(usage, camelName, snakeName) {
   return numberValue(usage?.[camelName] ?? usage?.[snakeName]);
 }
@@ -267,6 +278,8 @@ async function summarizeTelemetry(telemetryDir, sessionId, warnings) {
     offloaded_tool_results: 0,
     offloaded_output_chars: 0,
     truncated_tool_results: 0,
+    truncated_tool_arguments: 0,
+    truncated_tool_argument_tokens_saved: 0,
   };
   if (!fs.existsSync(telemetryDir)) return summary;
 
@@ -279,6 +292,10 @@ async function summarizeTelemetry(telemetryDir, sessionId, warnings) {
       if (record.event === 'micro_compaction_finished') {
         summary.micro_compactions += 1;
         summary.truncated_tool_results += numberValue(record.properties?.truncated_tool_result_count);
+        summary.truncated_tool_arguments += numberValue(record.properties?.truncated_tool_argument_count);
+        summary.truncated_tool_argument_tokens_saved += Math.max(0,
+          numberValue(record.properties?.truncated_tool_argument_tokens_before)
+            - numberValue(record.properties?.truncated_tool_argument_tokens_after));
       } else if (record.event === 'compaction_failed') {
         summary.full_compaction_failures += 1;
       } else if (record.event === 'tool_result_offloaded') {
@@ -290,6 +307,61 @@ async function summarizeTelemetry(telemetryDir, sessionId, warnings) {
   return summary;
 }
 
+async function summarizeToolSchemas(logPath) {
+  const summary = {
+    requests: 0,
+    deferred_requests: 0,
+    suppression_reasons: [],
+    eligible_schema_tokens: emptyTokenSeries(),
+    selected_schema_tokens: emptyTokenSeries(),
+    estimated_schema_tokens_avoided: 0,
+    last: null,
+  };
+  if (!fs.existsSync(logPath)) return summary;
+
+  const reasonCounts = new Map();
+  const input = fs.createReadStream(logPath, { encoding: 'utf8' });
+  const lines = readline.createInterface({ input, crlfDelay: Infinity });
+  for await (const line of lines) {
+    if (!line.includes('turn request tools')) continue;
+    const values = Object.fromEntries(
+      [...line.matchAll(/\b(toolSuppressionReason|eligibleToolCount|selectedToolCount|deferredToolCount|eligibleToolSchemaTokens|selectedToolSchemaTokens)=([^\s]+)/gu)]
+        .map((match) => [match[1], match[2]]),
+    );
+    const numericKeys = [
+      'eligibleToolCount',
+      'selectedToolCount',
+      'deferredToolCount',
+      'eligibleToolSchemaTokens',
+      'selectedToolSchemaTokens',
+    ];
+    if (!values.toolSuppressionReason || !numericKeys.every((key) => /^\d+$/u.test(values[key] || ''))) continue;
+
+    const eligibleToolCount = Number(values.eligibleToolCount);
+    const selectedToolCount = Number(values.selectedToolCount);
+    const deferredToolCount = Number(values.deferredToolCount);
+    const eligibleSchemaTokens = Number(values.eligibleToolSchemaTokens);
+    const selectedSchemaTokens = Number(values.selectedToolSchemaTokens);
+    summary.requests += 1;
+    if (deferredToolCount > 0) summary.deferred_requests += 1;
+    reasonCounts.set(values.toolSuppressionReason, (reasonCounts.get(values.toolSuppressionReason) || 0) + 1);
+    addTokenValue(summary.eligible_schema_tokens, eligibleSchemaTokens);
+    addTokenValue(summary.selected_schema_tokens, selectedSchemaTokens);
+    summary.estimated_schema_tokens_avoided += Math.max(0, eligibleSchemaTokens - selectedSchemaTokens);
+    summary.last = {
+      eligible_tool_count: eligibleToolCount,
+      selected_tool_count: selectedToolCount,
+      deferred_tool_count: deferredToolCount,
+      eligible_schema_tokens: eligibleSchemaTokens,
+      selected_schema_tokens: selectedSchemaTokens,
+    };
+  }
+  summary.suppression_reasons = [...reasonCounts.entries()]
+    .map(([reason, requests]) => ({ reason, requests }))
+    .sort((left, right) => right.requests - left.requests || left.reason.localeCompare(right.reason));
+  return summary;
+}
+
 function listSessions(options, profileRoot, sessions, warnings) {
   const listed = sessions
     .filter((entry) => {
@@ -337,6 +409,7 @@ async function inspectSession(options, profileRoot, sessions, inheritedWarnings)
     agents,
     totals: combineAgents(agents),
     telemetry: await summarizeTelemetry(path.join(options.blunHome, 'telemetry'), entry.sessionId, warnings),
+    tool_schemas: await summarizeToolSchemas(path.join(entry.sessionDir, 'logs', 'blun.log')),
     warnings,
   };
   if (options.includeMetadata) {