blun-king-cli 9.1.498 → 9.1.500

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 9.1.500 - 2026-08-30 - Golden Release
+
+- Marks the complete cross-platform BLUN King package as the Golden Release for Windows, Linux, and macOS.
+- Keeps the runtime behavior and verified TodoList, Telegram queue, session-loop, context-efficiency, AgentSpine, and managed vision changes from 9.1.499 byte-identical.
+- Gives the 9.1.500 heading a dedicated gold treatment in the public changelog without changing the styling of earlier releases.
+
+## 9.1.499 - 2026-08-30
+
+- Replaces image, audio, and video payloads older than the newest twelve conversation messages with short model-facing references while preserving the complete original session wire and every recent media attachment.
+- Reduces Fredrik's measured repeated model input by 85,748 characters, approximately 21,437 estimated tokens per subsequent work step, without changing the current image, message text, or persisted history.
+- Runs overdue TodoList maintenance as its own low-effort model step before the ninth work batch and exposes only TodoList during that step, preventing the normal workflow from hitting a visible red policy error first.
+- Keeps fresh user steers ahead of TodoList housekeeping while preserving the hard policy gate as a fallback for an actually invalid update.
+
 ## 9.1.498 - 2026-08-30
 
 - Shows prompt-cache hit rate plus cache-read and cache-write tokens per model in `/usage`.

package/LIESMICH.txt

@@ -9,7 +9,7 @@ Installation
 ------------
 Die geprüfte Version exakt global installieren:
 
-  npm install -g blun-king-cli@9.1.498
+  npm install -g blun-king-cli@9.1.500
 
 Start
 -----
@@ -65,6 +65,23 @@ geschriebenen Entwurf zu löschen. Das gilt auch bei
 Autovervollständigung, Geistervorschlägen, Bash-Eingabe und einer offenen
 Mehrzeileneingabe.
 
+Version 9.1.500 ist die Golden Release fuer Windows, Linux und macOS. Sie traegt
+den vollstaendigen Funktionsstand von 9.1.499 unveraendert und wird im
+oeffentlichen Changelog mit einer eigenen goldenen Ueberschrift gekennzeichnet.
+
+Version 9.1.499 ersetzt Bild-, Audio- und Videodaten ausserhalb der neuesten zwoelf
+Gespraechsnachrichten ausschliesslich in der wiederholten Modellprojektion durch
+kurze Verweise. Aktuelle Medien, Nachrichtentext und vollstaendiger Sitzungsrohverlauf
+bleiben unveraendert. In Fredriks gemessenem Wiederaufnahme-Checkpoint spart der
+Schnitt 85.748 Zeichen beziehungsweise rund 21.437 geschaetzte Eingabetoken je
+weiterem Werkzeugschritt.
+
+Faellige Todo-Pflege laeuft in 9.1.499 vor dem naechsten Sachwerkzeug als eigener
+kleiner Modellschritt. In diesem Schritt bietet die Laufzeit ausschliesslich
+TodoList an; erst nach einer gueltigen Aktualisierung werden Datei-, Such- und
+Shell-Werkzeuge wieder freigegeben. Dadurch entsteht im normalen Ablauf kein
+roter Zwischenfehler. Frische Benutzernachrichten behalten Vorrang.
+
 Version 9.1.498 zeigt in /usage die gemessene Prompt-Cache-Trefferquote sowie
 gelesene und geschriebene Cache-Token je Modell. /tokens ist ein kurzer Alias
 fuer die bereits vorhandene detaillierte Kontextdiagnose; /offload ruft die

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.498
+npm install -g blun-king-cli@9.1.500
 ```
 
 ## Reproduzierbares Staging und Packen
@@ -81,6 +81,23 @@ konkurrierenden Start zurückgewiesen und bleiben an der Spitze der
 FIFO-Warteschlange. Für diesen normalen Wartestatus erscheint kein
 `turn.agent_busy`-Fehler.
 
+Version 9.1.500 ist die Golden Release fuer Windows, Linux und macOS. Sie traegt
+den vollstaendigen Funktionsstand von 9.1.499 unveraendert und wird im
+oeffentlichen Changelog mit einer eigenen goldenen Ueberschrift gekennzeichnet.
+
+Version 9.1.499 ersetzt Bild-, Audio- und Videodaten außerhalb der neuesten zwölf
+Gesprächsnachrichten ausschließlich in der wiederholten Modellprojektion durch
+kurze Verweise. Aktuelle Medien, Nachrichtentext und vollständiger Sitzungsrohverlauf
+bleiben unverändert. In Fredriks gemessenem Wiederaufnahme-Checkpoint spart der
+Schnitt 85.748 Zeichen beziehungsweise rund 21.437 geschätzte Eingabetoken je
+weiterem Werkzeugschritt.
+
+Faellige Todo-Pflege laeuft in 9.1.499 vor dem naechsten Sachwerkzeug als eigener
+kleiner Modellschritt. In diesem Schritt bietet die Laufzeit ausschliesslich
+`TodoList` an; erst nach einer gueltigen Aktualisierung werden Datei-, Such- und
+Shell-Werkzeuge wieder freigegeben. Dadurch entsteht im normalen Ablauf kein
+roter Zwischenfehler. Frische Benutzernachrichten behalten Vorrang.
+
 Version 9.1.498 zeigt in `/usage` die gemessene Prompt-Cache-Trefferquote sowie
 gelesene und geschriebene Cache-Token je Modell. `/tokens` ist ein kurzer Alias
 fuer die bereits vorhandene detaillierte Kontextdiagnose; `/offload` ruft die

package/bin/historical-media-projection-policy.cjs

@@ -0,0 +1,48 @@
+'use strict';
+
+const HISTORICAL_MEDIA_KEEP_RECENT_MESSAGES = 12;
+const HISTORICAL_MEDIA_PLACEHOLDERS = Object.freeze({
+  image_url: '[historical image omitted from active model context; original remains in session wire]',
+  audio_url: '[historical audio omitted from active model context; original remains in session wire]',
+  video_url: '[historical video omitted from active model context; original remains in session wire]',
+});
+
+function projectHistoricalMediaParts(messages, options = {}) {
+  if (!Array.isArray(messages) || messages.length === 0) return messages;
+  const keepRecentMessages = nonNegativeInteger(
+    options.keepRecentMessages,
+    HISTORICAL_MEDIA_KEEP_RECENT_MESSAGES,
+  );
+  const historicalEnd = Math.max(0, messages.length - keepRecentMessages);
+  let changed = false;
+
+  const projected = messages.map((message, messageIndex) => {
+    if (messageIndex >= historicalEnd || !Array.isArray(message?.content)) return message;
+    let nextContent;
+    for (let partIndex = 0; partIndex < message.content.length; partIndex += 1) {
+      const part = message.content[partIndex];
+      const placeholder = HISTORICAL_MEDIA_PLACEHOLDERS[part?.type];
+      if (placeholder === undefined) {
+        nextContent?.push(part);
+        continue;
+      }
+      nextContent ??= message.content.slice(0, partIndex);
+      nextContent.push({ type: 'text', text: placeholder });
+      changed = true;
+    }
+    return nextContent === undefined ? message : { ...message, content: nextContent };
+  });
+
+  return changed ? projected : messages;
+}
+
+function nonNegativeInteger(value, fallback) {
+  const number = Number(value);
+  return Number.isInteger(number) && number >= 0 ? number : fallback;
+}
+
+module.exports = {
+  HISTORICAL_MEDIA_KEEP_RECENT_MESSAGES,
+  HISTORICAL_MEDIA_PLACEHOLDERS,
+  projectHistoricalMediaParts,
+};

package/blun.mjs

@@ -79049,7 +79049,8 @@ var init_context$2 = __esmMin((() => {
 		project(messages, options) {
 			const anomalies = [];
 			const userOffloaded = this.agent.userMessageOffload.compact(messages);
-			const historicalUserReferencesProjected = compactHistoricalPersistedUserMessageReferences(userOffloaded);
+			const historicalMediaProjected = projectHistoricalMediaParts(userOffloaded);
+			const historicalUserReferencesProjected = compactHistoricalPersistedUserMessageReferences(historicalMediaProjected);
 			const duplicateUserMessagesProjected = dedupeRepeatedUserMessages(historicalUserReferencesProjected);
 			const historicalTelegramProjected = projectHistoricalUnaddressedTelegramMessages(duplicateUserMessagesProjected);
 			const assistantOffloaded = this.agent.assistantMessageOffload.compact(historicalTelegramProjected);
@@ -261279,7 +261280,7 @@ function renderPersistedUserMessage(text, outputPath) {
 		createUserMessagePreview(text)
 	].join("\n");
 }
-var USER_MESSAGE_MAX_CHARS, USER_MESSAGE_OFFLOAD_MARKER, shouldOffloadUserMessage, shouldOffloadHistoricalUserMessage, createUserMessagePreview, compactHistoricalPersistedUserMessageReferences;
+var USER_MESSAGE_MAX_CHARS, USER_MESSAGE_OFFLOAD_MARKER, shouldOffloadUserMessage, shouldOffloadHistoricalUserMessage, createUserMessagePreview, compactHistoricalPersistedUserMessageReferences, projectHistoricalMediaParts;
 var init_user_message_offload = __esmMin((() => {
 	const policy = createRequire(import.meta.url)("./bin/user-message-offload-policy.cjs");
 	USER_MESSAGE_MAX_CHARS = policy.USER_MESSAGE_MAX_CHARS;
@@ -261287,8 +261288,9 @@ var init_user_message_offload = __esmMin((() => {
 	shouldOffloadUserMessage = policy.shouldOffloadUserMessage;
 	shouldOffloadHistoricalUserMessage = policy.shouldOffloadHistoricalUserMessage;
 	createUserMessagePreview = policy.createUserMessagePreview;
-	compactHistoricalPersistedUserMessageReferences = policy.compactHistoricalPersistedUserMessageReferences;
-}));
+		compactHistoricalPersistedUserMessageReferences = policy.compactHistoricalPersistedUserMessageReferences;
+		({ projectHistoricalMediaParts } = createRequire(import.meta.url)("./bin/historical-media-projection-policy.cjs"));
+	}));
 var UserMessageOffload = class {
 	agent;
 	replacements = /* @__PURE__ */ new Map();
@@ -262784,6 +262786,24 @@ var init_turn = __esmMin((() => {
 								currentStepHadFailure = false;
 								const pendingSteers = this.matchingSteers(turnId);
 								if (pendingSteers.length === 0) {
+									const todoMaintenanceMode = goalTodoMaintenanceMode(this.agent);
+									if (todoMaintenanceMode !== null) {
+										const todoTool = eligibleTools.find((tool) => tool.name === "TodoList");
+										if (todoTool === void 0) return {
+											block: true,
+											reason: "TodoList maintenance is due, but the TodoList tool is unavailable."
+										};
+										this.agent.log.info("proactive TodoList maintenance step", {
+											stepNumber,
+											mode: todoMaintenanceMode,
+											workCallsSinceRefresh: this.agent.goalTodoPolicyState?.workCallsSinceRefresh ?? 0
+										});
+										const todoSystemPrompt = buildGoalTodoMaintenanceSystemPrompt(this.agent, turnSystemPrompt ?? this.agent.effectiveSystemPrompt, todoMaintenanceMode);
+										return {
+											llm: this.agent.llmForTurn("low", todoSystemPrompt),
+											tools: [todoTool]
+										};
+									}
 									if (workStepThinkingEffort === void 0) return;
 									this.agent.log.info("work step thinking effort", {
 										stepNumber,
@@ -423194,6 +423214,7 @@ async function handleGoalCommand(host, args) {
 }
 const IDEA_CONTRACT_MARKER = "Work as a self-directing employee:";
 const IDEA_ALLOWED_CHANNELS = Object.freeze([]);
+const GOAL_TODO_REFRESH_WORK_CALL_LIMIT = 8;
 const IDEA_TERMINAL_TODO_STATUSES = Object.freeze([
 	"done",
 	"blocked",
@@ -423221,6 +423242,30 @@ function validInitialIdeaPlan(value) {
 	}
 	return active === 1;
 }
+function goalTodoMaintenanceMode(agent) {
+	if (isIdeaGoal(agent)) return null;
+	const todos = ideaTodos(agent);
+	if (todos.length === 0) return agent.goal.getActiveGoal() === null ? null : "initial";
+	const progress = agent.goalTodoPolicyState ??= {
+		workCallsSinceRefresh: 0,
+		refreshRequired: false
+	};
+	return progress.refreshRequired || progress.workCallsSinceRefresh >= GOAL_TODO_REFRESH_WORK_CALL_LIMIT ? "refresh" : null;
+}
+function buildGoalTodoMaintenanceSystemPrompt(agent, basePrompt, mode) {
+	const todos = ideaTodos(agent);
+	const visibleTodoList = todos.length === 0 ? "The visible TodoList is empty." : ["Current visible TodoList:", ...todos.map((todo) => `- [${String(todo?.status ?? "pending")}] ${String(todo?.title ?? "").trim()}`)].join("\n");
+	const action = mode === "initial" ? "Create the visible task-specific TodoList now. Keep exactly one item in_progress and every later item pending." : "Update the visible TodoList now, before any more task work. Mark only evidenced steps done, keep the actual current step in_progress, and leave later steps pending. If the current title is stale, refine it to the concrete verified substep.";
+	return `<todo-maintenance>
+TODO MAINTENANCE IS THE ONLY ACTION FOR THIS STEP.
+${action}
+Call TodoList as the first and only tool. Do not call a work, search, file, shell, web, messaging, or goal tool in this step. Do not merely describe the update.
+
+${visibleTodoList}
+</todo-maintenance>
+
+${basePrompt}`;
+}
 function enforceGoalTodoPolicy(agent, context) {
 	if (isIdeaGoal(agent)) return;
 	if (TELEGRAM_DELIVERY_TOOL_RE.test(String(context.toolCall.name ?? ""))) return;
@@ -423295,7 +423340,7 @@ function enforceGoalTodoPolicy(agent, context) {
 	}
 	if (context.toolCall.id === context.toolCalls[0]?.id) {
 		progress.workCallsSinceRefresh += 1;
-		if (progress.workCallsSinceRefresh > 8) progress.refreshRequired = true;
+		if (progress.workCallsSinceRefresh > GOAL_TODO_REFRESH_WORK_CALL_LIMIT) progress.refreshRequired = true;
 	}
 	if (!progress.refreshRequired) return;
 	return {

package/package.json

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