blun-king-cli 9.1.77 → 9.1.79

package/LIESMICH.txt

@@ -213,6 +213,28 @@ sodass auch kurze Schritte wie Rendern und Speichern in der Produktionskette
 sichtbar sind. Aktualisierte Vorschaubilder werden erneuert; Medienpfade und
 Webadressen sind als Terminalverweise anklickbar.
 
+Wiederauffindbarer Verdichtungsverlauf
+--------------------------------------
+
+Bevor eine erfolgreiche Vollverdichtung ältere Nachrichten ersetzt, schreibt
+King den verdrängten Verlauf in ein privates Markdown-Archiv unter
+~/.blun/conversation-history/. Die Verdichtungszusammenfassung enthält den
+genauen history_path, sodass der Agent mit Read Einzelheiten wiederfinden kann,
+die nicht in der Zusammenfassung stehen.
+
+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
 -------------
 

package/README.md

@@ -240,6 +240,18 @@ sodass auch kurze Schritte wie Rendern und Speichern in der Produktionskette
 sichtbar sind. Aktualisierte Vorschaubilder werden erneuert; Medienpfade und
 Webadressen sind als Terminalverweise anklickbar.
 
+## Wiederauffindbarer Verdichtungsverlauf
+
+Bevor eine erfolgreiche Vollverdichtung ältere Nachrichten ersetzt, schreibt King den verdrängten Verlauf in ein privates Markdown-Archiv unter `~/.blun/conversation-history/`. Die Verdichtungszusammenfassung enthält den genauen `history_path`, sodass der Agent mit `Read` Einzelheiten wiederfinden kann, die nicht in der Zusammenfassung stehen.
+
+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/compaction-history-archive.cjs

@@ -0,0 +1,112 @@
+'use strict';
+
+const { randomUUID } = require('node:crypto');
+const { mkdir, writeFile } = require('node:fs/promises');
+const path = require('node:path');
+
+const COMPACTION_HISTORY_DIR = 'conversation-history';
+const INLINE_MEDIA_NOTICE = '[inline media payload omitted; original remains in session wire]';
+
+async function archiveCompactionHistory(options = {}) {
+  const homedir = requiredString(options.homedir, 'homedir');
+  const messages = Array.isArray(options.messages) ? options.messages : [];
+  const now = finiteNumber(options.now, Date.now());
+  const id = safeFilePart(options.id || randomUUID());
+  const dir = path.join(homedir, COMPACTION_HISTORY_DIR);
+  const timestamp = new Date(now).toISOString().replace(/[:.]/g, '-');
+  const outputPath = path.join(dir, `compaction-${timestamp}-${id}.md`);
+
+  await mkdir(dir, { recursive: true, mode: 0o700 });
+  await writeFile(outputPath, serializeCompactionHistory(messages, { now }), {
+    encoding: 'utf8',
+    flag: 'wx',
+    mode: 0o600,
+  });
+  return outputPath;
+}
+
+function serializeCompactionHistory(messages, options = {}) {
+  const now = finiteNumber(options.now, Date.now());
+  const lines = [
+    '# BLUN conversation history archive',
+    '',
+    `Archived at: ${new Date(now).toISOString()}`,
+    `Messages: ${messages.length}`,
+    '',
+    'This file contains the messages displaced by a full context compaction.',
+    'Inline media payloads are omitted here; the original session wire remains authoritative.',
+  ];
+
+  for (let index = 0; index < messages.length; index += 1) {
+    const message = sanitizeMessage(messages[index]);
+    lines.push(
+      '',
+      `## Message ${index + 1}: ${typeof message?.role === 'string' ? message.role : 'unknown'}`,
+      '',
+      '```json',
+      JSON.stringify(message, null, 2),
+      '```',
+    );
+  }
+  lines.push('');
+  return lines.join('\n');
+}
+
+function buildCompactionArchiveNotice(historyPath) {
+  return [
+    '<system-reminder>',
+    'The complete messages displaced by this compaction were archived locally.',
+    `history_path: ${historyPath}`,
+    'next_step: Use Read with history_path to recover exact details that the summary omitted.',
+    '</system-reminder>',
+  ].join('\n');
+}
+
+function sanitizeMessage(message) {
+  if (message === null || typeof message !== 'object') return message;
+  if (!Array.isArray(message.content)) return message;
+  return {
+    ...message,
+    content: message.content.map(sanitizeContentPart),
+  };
+}
+
+function sanitizeContentPart(part) {
+  if (part === null || typeof part !== 'object') return part;
+  if (part.type === 'image_url' && isInlineMediaUrl(part.imageUrl?.url)) {
+    return { type: 'text', text: INLINE_MEDIA_NOTICE };
+  }
+  if (part.type === 'audio_url' && isInlineMediaUrl(part.audioUrl?.url)) {
+    return { type: 'text', text: INLINE_MEDIA_NOTICE };
+  }
+  if (part.type === 'video_url' && isInlineMediaUrl(part.videoUrl?.url)) {
+    return { type: 'text', text: INLINE_MEDIA_NOTICE };
+  }
+  return part;
+}
+
+function isInlineMediaUrl(value) {
+  return typeof value === 'string' && /^data:(?:image|audio|video)\//i.test(value);
+}
+
+function requiredString(value, name) {
+  if (typeof value === 'string' && value.length > 0) return value;
+  throw new TypeError(`${name} must be a non-empty string`);
+}
+
+function safeFilePart(value) {
+  const cleaned = String(value).replace(/[^a-zA-Z0-9._-]+/g, '_').replace(/^_+|_+$/g, '').slice(0, 96);
+  return cleaned || randomUUID();
+}
+
+function finiteNumber(value, fallback) {
+  const number = Number(value);
+  return Number.isFinite(number) ? number : fallback;
+}
+
+module.exports = {
+  COMPACTION_HISTORY_DIR,
+  archiveCompactionHistory,
+  buildCompactionArchiveNotice,
+  serializeCompactionHistory,
+};

package/blun.mjs

@@ -75237,8 +75237,9 @@ function extractCompactionSummary(response) {
 	if (summary.trim().length === 0) throw new APIEmptyResponseError("The compaction response did not contain a non-empty summary.");
 	return summary;
 }
-var 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, 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"));
 	init_errors$8();
 	init_src$4();
 	init_errors$4();
@@ -75773,7 +75774,24 @@ var init_full = __esmMin((() => {
 					return;
 				}
 				const rawSummary = this.postProcessSummary(summary ?? "");
-				const contextSummary = buildCompactionSummaryText(rawSummary);
+				let contextSummary = buildCompactionSummaryText(rawSummary);
+				let historyPath;
+				try {
+					historyPath = await archiveCompactionHistory({
+						homedir: this.agent.blunHomeDir,
+						messages: originalHistory
+					});
+					contextSummary = `${contextSummary}\n\n${buildCompactionArchiveNotice(historyPath)}`;
+					this.agent.telemetry.track("compaction_history_archived", {
+						history_path: historyPath,
+						message_count: originalHistory.length
+					});
+				} catch (error) {
+					this.agent.telemetry.track("compaction_history_archive_failed", {
+						message_count: originalHistory.length,
+						error_type: error instanceof Error ? error.name : "Unknown"
+					});
+				}
 				const result = this.agent.context.applyCompaction({
 					summary: rawSummary,
 					contextSummary,
@@ -260766,6 +260784,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,
@@ -260898,6 +260917,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();

package/package.json

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