blun-king-cli 9.1.78 → 9.1.80

package/LIESMICH.txt

@@ -9,7 +9,7 @@ Installation
 ------------
 Die geprüfte Version exakt global installieren:
 
-  npm install -g blun-king-cli@9.1.77
+  npm install -g blun-king-cli@9.1.80
 
 Start
 -----
@@ -86,6 +86,14 @@ 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.
 
+## 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.
+
+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.
+
+Reguläre `Agent`-Teilaufgaben verwenden eine eigene `ContextMemory` und eine eigene `wire.jsonl` in einem getrennten Agentenverzeichnis. Der Hauptagent erhält nur die Ergebniszusammenfassung, sodass lange Teilaufgaben nicht den Hauptverlauf füllen. `TodoList` speichert Pläne weiterhin maschinenlesbar im Sitzungs-Wire; `blun handoff` übergibt sie zusammen mit prüfbaren Hashes zwischen CLI, Desktop und Web.
+
 Zug-Wächter
 -----------
 Läuft ein Zug 20 Minuten ohne neues Werkzeugergebnis, meldet die Konsole den
@@ -228,6 +236,13 @@ nicht geschrieben werden, protokolliert King compaction_history_archive_failed
 und lässt den normalen Verdichtungsweg verfügbar; ein Archivfehler löscht
 niemals den gespeicherten Sitzungsverlauf.
 
+Dauerhafte Checkpoints zwischen Arbeitsschritten
+-------------------------------------------------
+
+Bevor King den nächsten Modellschritt beginnt, schreibt er alle vorangegangenen Wire-Einträge dauerhaft auf den Datenträger. Nach dem Ende eines Zuges erfolgt eine weitere vollständige Sicherung, bevor der zugehörige Worker abgeschlossen wird. Das schließt beendete Modell- und Werkzeugschritte ein. Eine fortgesetzte Sitzung beginnt dadurch beim letzten abgeschlossenen Schritt und ist nicht auf noch ungesicherte Einträge im Arbeitsspeicher angewiesen.
+
+Beispiel: Wenn der Anbieter oder das Terminal nach einem abgeschlossenen Werkzeugaufruf, aber vor der nächsten Modellantwort ausfällt, kann die Sitzung neu gestartet oder fortgesetzt werden. Der vorangegangene Werkzeugeintrag wurde vor der nächsten Anfrage an den Anbieter in wire.jsonl synchronisiert und wird beim Fortsetzen wieder eingelesen. Der Checkpoint verkürzt keine Prompts und ersetzt nicht die wiederauffindbaren Verdichtungsarchive; er schützt die Übergabe zwischen zwei Arbeitsschritten.
+
 Aktualisieren
 -------------
 

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.69
+npm install -g blun-king-cli@9.1.80
 ```
 
 ## Reproduzierbares Staging und Packen
@@ -108,6 +108,14 @@ 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.
 
+## 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.
+
+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.
+
+Reguläre `Agent`-Teilaufgaben verwenden eine eigene `ContextMemory` und eine eigene `wire.jsonl` in einem getrennten Agentenverzeichnis. Der Hauptagent erhält nur die Ergebniszusammenfassung, sodass lange Teilaufgaben nicht den Hauptverlauf füllen. `TodoList` speichert Pläne weiterhin maschinenlesbar im Sitzungs-Wire; `blun handoff` übergibt sie zusammen mit prüfbaren Hashes zwischen CLI, Desktop und Web.
+
 ## Zug-Wächter
 
 Läuft ein Zug 20 Minuten ohne neues Werkzeugergebnis, meldet die Konsole den
@@ -246,6 +254,12 @@ Bevor eine erfolgreiche Vollverdichtung ältere Nachrichten ersetzt, schreibt Ki
 
 Eingebettete Bild-, Audio- und Videodaten werden im Archiv nicht doppelt gespeichert. Der ursprüngliche Sitzungs-Wire bleibt maßgeblich. Kann das Archiv nicht geschrieben werden, protokolliert King `compaction_history_archive_failed` und lässt den normalen Verdichtungsweg verfügbar; ein Archivfehler löscht niemals den gespeicherten Sitzungsverlauf.
 
+## Dauerhafte Checkpoints zwischen Arbeitsschritten
+
+Bevor King den nächsten Modellschritt beginnt, schreibt er alle vorangegangenen Wire-Einträge dauerhaft auf den Datenträger. Nach dem Ende eines Zuges erfolgt eine weitere vollständige Sicherung, bevor der zugehörige Worker abgeschlossen wird. Das schließt beendete Modell- und Werkzeugschritte ein. Eine fortgesetzte Sitzung beginnt dadurch beim letzten abgeschlossenen Schritt und ist nicht auf noch ungesicherte Einträge im Arbeitsspeicher angewiesen.
+
+Beispiel: Wenn der Anbieter oder das Terminal nach einem abgeschlossenen Werkzeugaufruf, aber vor der nächsten Modellantwort ausfällt, kann die Sitzung neu gestartet oder fortgesetzt werden. Der vorangegangene Werkzeugeintrag wurde vor der nächsten Anfrage an den Anbieter in `wire.jsonl` synchronisiert und wird beim Fortsetzen wieder eingelesen. Der Checkpoint verkürzt keine Prompts und ersetzt nicht die wiederauffindbaren Verdichtungsarchive; er schützt die Übergabe zwischen zwei Arbeitsschritten.
+
 ## Aktualisieren
 
 `blun update`, `king update` und die jeweilige Variante `upgrade` verwenden

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

@@ -0,0 +1,12 @@
+'use strict';
+
+function buildToolResultOffloadTelemetry(options) {
+  return {
+    tool_name: options.toolName,
+    output_size_chars: options.text.length,
+    output_size_bytes: Buffer.byteLength(options.text, 'utf8'),
+    preview_size_chars: Math.min(options.text.length, options.previewChars),
+  };
+}
+
+module.exports = { buildToolResultOffloadTelemetry };

package/blun.mjs

@@ -259897,6 +259897,11 @@ async function budgetToolResultForModel(options) {
 		toolCallId: options.toolCallId
 	}, text);
 	if (outputPath === void 0) return options.result;
+	options.telemetry?.track("tool_result_offloaded", buildToolResultOffloadTelemetry({
+		toolName: options.toolName,
+		text,
+		previewChars: TOOL_RESULT_PREVIEW_CHARS
+	}));
 	const output = renderPersistedToolResult(options.toolName, options.toolCallId, text, outputPath);
 	return options.result.isError === true ? {
 		...options.result,
@@ -259945,9 +259950,10 @@ 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;
+var TOOL_RESULT_MAX_CHARS, TOOL_RESULT_PREVIEW_CHARS, buildToolResultOffloadTelemetry;
 var init_tool_result_budget = __esmMin((() => {
 	init_dist$6();
+	({ buildToolResultOffloadTelemetry } = createRequire(import.meta.url)("./bin/tool-result-offload-telemetry.cjs"));
 	TOOL_RESULT_MAX_CHARS = 5e4;
 	TOOL_RESULT_PREVIEW_CHARS = 2e3;
 }));
@@ -260784,6 +260790,7 @@ var init_turn = __esmMin((() => {
 			this.currentStepByTurn.delete(turnId);
 			this.interruptedTelemetryTurnIds.delete(turnId);
 			this.stepFailureByTurn.delete(turnId);
+			await this.agent.records.flush();
 			return {
 				event: ended,
 				stopReason: completedStopReason,
@@ -260916,6 +260923,7 @@ var init_turn = __esmMin((() => {
 						},
 						hooks: {
 							beforeStep: async ({ signal: stepSignal, stepNumber }) => {
+								await this.agent.records.flush();
 								this.agent.microCompaction.detect();
 								await this.agent.injection.inject();
 								stepSignal.throwIfAborted();
@@ -261036,7 +261044,8 @@ var init_turn = __esmMin((() => {
 									homedir: this.agent.homedir,
 									toolName: ctx.toolCall.name,
 									toolCallId: ctx.toolCall.id,
-									result: finalResult
+									result: finalResult,
+									telemetry: this.agent.telemetry
 								});
 							}
 						}

package/package.json

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