blun-king-cli 9.1.85 → 9.1.87

package/LIESMICH.txt

@@ -9,7 +9,7 @@ Installation
 ------------
 Die geprüfte Version exakt global installieren:
 
-  npm install -g blun-king-cli@9.1.85
+  npm install -g blun-king-cli@9.1.87
 
 Start
 -----
@@ -50,6 +50,13 @@ FIFO-Warteschlange. Für diesen normalen Wartestatus erscheint kein
 
 Zuverlässiger King-Start
 -----------------------
+Bei einer ausdrücklich als wiederholbar gekennzeichneten Serverüberlastung
+(HTTP 429 mit x-should-retry: true) wartet BLUN King gemäß Retry-After und
+sendet dieselbe Anfrage höchstens zweimal erneut. Authentifizierungs-,
+Kontingent- und andere nicht wiederholbare Fehler brechen weiterhin sofort ab.
+Bleibt der Server nach den begrenzten Versuchen überlastet, erhält der Nutzer
+weiterhin die klare Fehlermeldung.
+
 Der Windows-Hilfsprozess für private Pfade übernimmt TEMP und TMP aus der
 Benutzersitzung. Dadurch arbeitet die ACL-Prüfung auch unter einem normalen
 Benutzerkonto. Bei einem Fehler wird die tatsächliche Ursache des
@@ -80,7 +87,7 @@ Dabei werden keine gespeicherten Nachrichten geändert oder gelöscht. Fortsetze
 
 ## Große Werkzeugausgaben und isolierte Teilagenten
 
-Große textbasierte Werkzeugergebnisse bleiben nicht mehr vollständig im Modellkontext. Ab 12.001 Zeichen speichert BLUN King das vollständige Ergebnis in einer privaten Datei im Sitzungsordner `tool-results`. Im Modellkontext verbleiben eine Vorschau mit 2.000 Zeichen und der `output_path`. Der Agent kann das vollständige Ergebnis anschließend mit `Read` seitenweise über diesen Pfad lesen. Ergebnisse bis einschließlich 12.000 Zeichen, gemischte Medienergebnisse und bereits gekürzte Ergebnisse bleiben unverändert. Auch eine spätere Mikroverdichtung bewahrt den Dateiverweis. Beispiel: Bei einem Suchergebnis mit 30.000 Zeichen enthalten die folgenden Modellanfragen nur noch die Vorschau und den lesbaren Pfad; der vollständige Text bleibt lokal verfügbar.
+Große textbasierte Werkzeugergebnisse bleiben nicht mehr vollständig im Modellkontext. Ab 12.001 Zeichen speichert BLUN King das vollständige Ergebnis in einer privaten Datei im Sitzungsordner `tool-results`. Im Modellkontext verbleiben die ersten 1.000 und die letzten 1.000 Zeichen, die genaue Zahl der ausgelassenen Zeichen und der `output_path`. Der Agent kann das vollständige Ergebnis anschließend mit `Read` seitenweise über diesen Pfad lesen. Ergebnisse bis einschließlich 12.000 Zeichen, gemischte Medienergebnisse und bereits gekürzte Ergebnisse bleiben unverändert. Auch eine spätere Mikroverdichtung bewahrt den Dateiverweis. Beispiel: Bei einem Suchergebnis mit 30.000 Zeichen sehen folgende Modellanfragen den Anfang und das abschließende Ergebnis oder den Fehler; der vollständige Text bleibt lokal verfügbar.
 
 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.
 

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.85
+npm install -g blun-king-cli@9.1.87
 ```
 
 ## Reproduzierbares Staging und Packen
@@ -72,6 +72,11 @@ Geistervorschlägen, Bash-Eingabe und einer noch offenen Mehrzeileneingabe.
 
 ## Zuverlässiger King-Start
 
+Bei einer vom Server ausdrücklich als wiederholbar gekennzeichneten
+Überlastung (`HTTP 429`, `x-should-retry: true`) wartet BLUN King entsprechend
+`Retry-After` und sendet dieselbe Anfrage höchstens zweimal erneut. Andere
+Fehler und dauerhaft überlastete Server bleiben klar begrenzt und sichtbar.
+
 Der Windows-Hilfsprozess für private Pfade übernimmt `TEMP` und `TMP` aus der
 Benutzersitzung. Dadurch kann der C#-Compiler für die ACL-Prüfung auch unter
 einem normalen Benutzerkonto arbeiten. Scheitert der Unterprozess, nennt die
@@ -102,7 +107,7 @@ Dabei werden keine gespeicherten Nachrichten geändert oder gelöscht. Fortsetze
 
 ## Große Werkzeugausgaben und isolierte Teilagenten
 
-Große textbasierte Werkzeugergebnisse bleiben nicht mehr vollständig im Modellkontext. Ab 12.001 Zeichen speichert BLUN King das vollständige Ergebnis in einer privaten Datei im Sitzungsordner `tool-results`. Im Modellkontext verbleiben eine Vorschau mit 2.000 Zeichen und der `output_path`. Der Agent kann das vollständige Ergebnis anschließend mit `Read` seitenweise über diesen Pfad lesen. Ergebnisse bis einschließlich 12.000 Zeichen, gemischte Medienergebnisse und bereits gekürzte Ergebnisse bleiben unverändert. Auch eine spätere Mikroverdichtung bewahrt den Dateiverweis. Beispiel: Bei einem Suchergebnis mit 30.000 Zeichen enthalten die folgenden Modellanfragen nur noch die Vorschau und den lesbaren Pfad; der vollständige Text bleibt lokal verfügbar.
+Große textbasierte Werkzeugergebnisse bleiben nicht mehr vollständig im Modellkontext. Ab 12.001 Zeichen speichert BLUN King das vollständige Ergebnis in einer privaten Datei im Sitzungsordner `tool-results`. Im Modellkontext verbleiben die ersten 1.000 und die letzten 1.000 Zeichen, die genaue Zahl der ausgelassenen Zeichen und der `output_path`. Der Agent kann das vollständige Ergebnis anschließend mit `Read` seitenweise über diesen Pfad lesen. Ergebnisse bis einschließlich 12.000 Zeichen, gemischte Medienergebnisse und bereits gekürzte Ergebnisse bleiben unverändert. Auch eine spätere Mikroverdichtung bewahrt den Dateiverweis. Beispiel: Bei einem Suchergebnis mit 30.000 Zeichen sehen folgende Modellanfragen den Anfang und das abschließende Ergebnis oder den Fehler; der vollständige Text bleibt lokal verfügbar.
 
 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.
 

package/bin/rate-limit-recovery-policy.cjs

@@ -1,6 +1,7 @@
 "use strict";
 
 const MAX_AUTOMATIC_RATE_LIMIT_RESUMES = 3;
+const MAX_EXPLICIT_RATE_LIMIT_RETRIES = 2;
 const RATE_LIMIT_RETRY_BASE_MS = 60_000;
 const RATE_LIMIT_COMPACTION_THRESHOLD_TOKENS = 64_000;
 
@@ -8,6 +9,16 @@ function isImmediateGenerateRetryAllowed(statusCode) {
   return statusCode !== 429 && [500, 502, 503, 504].includes(statusCode);
 }
 
+function resolveTransportRetryBudget(configuredMaxRetries, statusCode, shouldRetryHeader) {
+  if (!Number.isInteger(configuredMaxRetries) || configuredMaxRetries < 0) {
+    throw new Error("configuredMaxRetries must be a non-negative integer.");
+  }
+  const explicitRetry = typeof shouldRetryHeader === "string"
+    && shouldRetryHeader.trim().toLowerCase() === "true";
+  if (statusCode !== 429 || !explicitRetry) return configuredMaxRetries;
+  return Math.max(configuredMaxRetries, MAX_EXPLICIT_RATE_LIMIT_RETRIES);
+}
+
 function rateLimitRetryDelayMs(retryCount) {
   if (!Number.isInteger(retryCount) || retryCount < 1) {
     throw new Error("retryCount must be a positive integer.");
@@ -26,9 +37,11 @@ function shouldCompactBeforeRateLimitResume(estimatedRequestTokens) {
 
 module.exports = {
   MAX_AUTOMATIC_RATE_LIMIT_RESUMES,
+  MAX_EXPLICIT_RATE_LIMIT_RETRIES,
   RATE_LIMIT_RETRY_BASE_MS,
   isImmediateGenerateRetryAllowed,
   rateLimitRetryDelayMs,
+  resolveTransportRetryBudget,
   shouldCompactBeforeRateLimitResume,
   shouldStopAutomaticRateLimitResume,
 };

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

@@ -8,6 +8,15 @@ function shouldOffloadToolResult(textLength) {
   return Number.isFinite(textLength) && textLength > TOOL_RESULT_MAX_CHARS;
 }
 
+function createToolResultPreview(text) {
+  if (text.length <= TOOL_RESULT_PREVIEW_CHARS) return text;
+
+  const headChars = Math.ceil(TOOL_RESULT_PREVIEW_CHARS / 2);
+  const tailChars = TOOL_RESULT_PREVIEW_CHARS - headChars;
+  const omittedChars = text.length - headChars - tailChars;
+  return `${text.slice(0, headChars)}\n\n[... ${String(omittedChars)} characters omitted ...]\n\n${text.slice(-tailChars)}`;
+}
+
 function isPersistedToolResultReference(content) {
   if (!Array.isArray(content)) return false;
 
@@ -23,6 +32,7 @@ module.exports = {
   TOOL_RESULT_MAX_CHARS,
   TOOL_RESULT_PREVIEW_CHARS,
   TOOL_RESULT_OFFLOAD_MARKER,
+  createToolResultPreview,
   isPersistedToolResultReference,
   shouldOffloadToolResult,
 };

package/blun.mjs

@@ -1935,9 +1935,10 @@ function getRecord(value) {
 function getString(value) {
 	return typeof value === "string" && value.length > 0 ? value : void 0;
 }
-var DEFAULT_MAX_RETRIES$1, MAX_RETRY_DELAY_MS, FetchTransport, DONE;
+var DEFAULT_MAX_RETRIES$1, MAX_RETRY_DELAY_MS, resolveTransportRetryBudget, FetchTransport, DONE;
 var init_fetch_http_client = __esmMin((() => {
 	init_errors$10();
+	({ resolveTransportRetryBudget } = createRequire(import.meta.url)("./bin/rate-limit-recovery-policy.cjs"));
 	DEFAULT_MAX_RETRIES$1 = 2;
 	MAX_RETRY_DELAY_MS = 6e4;
 	FetchTransport = class {
@@ -1993,7 +1994,8 @@ var init_fetch_http_client = __esmMin((() => {
 				const startedAt = performance.now();
 				try {
 					const response = await this.fetch(`${this.baseUrl}${pathname}`, init);
-					const willRetry = attempt < maxRetries && shouldRetryResponse(response);
+					const retryBudget = resolveTransportRetryBudget(maxRetries, response.status, response.headers.get("x-should-retry"));
+					const willRetry = attempt < retryBudget && shouldRetryResponse(response);
 					notifyTransportAttempt(requestOptions?.onTransportAttempt, {
 						transportAttempt: attempt + 1,
 						...requestBytes === void 0 ? {} : { requestBytes },
@@ -260020,13 +260022,13 @@ function renderPersistedToolResult(toolName, toolCallId, text, outputPath) {
 		`output_path: ${outputPath}`,
 		"next_step: Use Read with output_path to page through the full output."
 	];
-	lines.push("", "[preview]", text.slice(0, TOOL_RESULT_PREVIEW_CHARS));
+	lines.push("", "[preview: head and tail]", createToolResultPreview(text));
 	return lines.join("\n");
 }
 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, TOOL_RESULT_OFFLOAD_MARKER, shouldOffloadToolResult, buildToolResultOffloadTelemetry;
+var TOOL_RESULT_MAX_CHARS, TOOL_RESULT_PREVIEW_CHARS, TOOL_RESULT_OFFLOAD_MARKER, shouldOffloadToolResult, createToolResultPreview, buildToolResultOffloadTelemetry;
 var init_tool_result_budget = __esmMin((() => {
 	init_dist$6();
 	const toolResultOffloadPolicy = createRequire(import.meta.url)("./bin/tool-result-offload-policy.cjs");
@@ -260035,6 +260037,7 @@ var init_tool_result_budget = __esmMin((() => {
 	TOOL_RESULT_PREVIEW_CHARS = toolResultOffloadPolicy.TOOL_RESULT_PREVIEW_CHARS;
 	TOOL_RESULT_OFFLOAD_MARKER = toolResultOffloadPolicy.TOOL_RESULT_OFFLOAD_MARKER;
 	shouldOffloadToolResult = toolResultOffloadPolicy.shouldOffloadToolResult;
+	createToolResultPreview = toolResultOffloadPolicy.createToolResultPreview;
 }));
 //#endregion
 //#region ../../packages/agent-core/src/agent/turn/index.ts

package/package.json

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