blun-king-cli 9.1.81 → 9.1.82

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.82
 
 Start
 -----
@@ -99,6 +99,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.82
 ```
 
 ## Reproduzierbares Staging und Packen
@@ -120,6 +120,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blun-king-cli",
-  "version": "9.1.81",
+  "version": "9.1.82",
   "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. 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]);
 }
@@ -290,6 +301,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 +403,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) {