blun-king-cli 9.1.105 → 9.1.107

package/LIESMICH.txt

@@ -9,7 +9,7 @@ Installation
 ------------
 Die geprüfte Version exakt global installieren:
 
-  npm install -g blun-king-cli@9.1.105
+  npm install -g blun-king-cli@9.1.106
 
 Start
 -----
@@ -107,6 +107,8 @@ Reguläre `Agent`-Teilaufgaben verwenden eine eigene `ContextMemory` und eine ei
 
 Version 9.1.105 ergänzt `TaskUpdate` für laufende Hintergrundagenten. King übergibt zusätzliche Anweisungen am nächsten sicheren Modellschritt an denselben aktiven Agenten, ohne ihn zu stoppen oder einen weiteren Agenten zu starten. Unbekannte und bereits beendete Aufgaben, Shell-Aufgaben sowie Agenten, die keine Aktualisierung mehr annehmen, werden unverändert abgewiesen.
 
+Version 9.1.106 erlaubt Agentenprofilen, Werkzeuge namentlich auszuschließen. King wendet diese Ausschlüsse erst an, nachdem dauerhaft geladene, dynamisch nachgeladene und MCP-Werkzeuge zusammengestellt wurden. Die Standardprofile `coder`, `explore` und `plan` können über Telegram weder antworten noch reagieren, Nachrichten bearbeiten oder Anhänge herunterladen; der Hauptagent bleibt unverändert. So senden delegierte Agenten keine Nachrichten am Hauptagenten vorbei, und ihre Modellanfragen enthalten weniger Werkzeugschemas. Nicht gefundene, namentlich angegebene Werkzeuge werden sichtbar gemeldet.
+
 Verliert ein delegierter Einzelagent oder ein Mitglied eines Agentenschwarms die Provider-Verbindung, erhält es eine leere Provider-Antwort, bricht sein Stream wegen Leerlaufs ab oder meldet der Server HTTP 408/500/502/503/504, setzt BLUN King denselben Agenten anhand seines dauerhaften Verlaufs fort. Bei Einzelagenten sowie bei Schwarm-Unterbrechungen außerhalb von HTTP 429 wartet die erste Fortsetzung zwei Sekunden und die zweite fünf Sekunden; danach bleibt der ursprüngliche Fehler sichtbar. HTTP 429 behält im Schwarm seine getrennte, längere Überlastungsregel. Authentifizierungs-, Zahlungs- oder Kontingent-, Richtlinien-, Kontext-, Werkzeug- und Codefehler sowie manuelle Abbrüche lösen keine automatische Fortsetzung aus. Jeder Fortsetzungsversuch verwendet die bestehende Agenten-ID, damit bereits abgeschlossene Arbeit nicht wiederholt wird.
 
 Rein lesende Sitzungsdiagnose

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.105
+npm install -g blun-king-cli@9.1.106
 ```
 
 ## Reproduzierbares Staging und Packen
@@ -115,6 +115,8 @@ Version 9.1.104 lässt Shell-Befehle im Vordergrund auch bei sehr großen Ausgab
 
 Version 9.1.105 ergänzt `TaskUpdate` für laufende Hintergrundagenten. King übergibt zusätzliche Anweisungen am nächsten sicheren Modellschritt an denselben aktiven Agenten, ohne ihn zu stoppen oder einen weiteren Agenten zu starten. Unbekannte und bereits beendete Aufgaben, Shell-Aufgaben sowie Agenten, die keine Aktualisierung mehr annehmen, werden unverändert abgewiesen.
 
+Version 9.1.106 erlaubt Agentenprofilen, Werkzeuge namentlich auszuschließen. King wendet diese Ausschlüsse erst an, nachdem dauerhaft geladene, dynamisch nachgeladene und MCP-Werkzeuge zusammengestellt wurden. Die Standardprofile `coder`, `explore` und `plan` können über Telegram weder antworten noch reagieren, Nachrichten bearbeiten oder Anhänge herunterladen; der Hauptagent bleibt unverändert. So senden delegierte Agenten keine Nachrichten am Hauptagenten vorbei, und ihre Modellanfragen enthalten weniger Werkzeugschemas. Nicht gefundene, namentlich angegebene Werkzeuge werden sichtbar gemeldet.
+
 Ab BLUN King 9.1.99 werden auch direkt aufeinanderfolgende reine Textergebnisse als Stapel betrachtet. Enthalten sie zusammen mehr als 12.000 Zeichen, obwohl kein einzelnes Ergebnis diese Grenze überschreitet, speichert King so viele der größten geeigneten Ergebnisse wie nötig in privaten Dateien. In der Modellprojektion verbleiben lesbare Verweise. Der unveränderte Sitzungsrohverlauf bleibt vollständig erhalten. Gemischte Medienergebnisse, einzelne Ergebnisse unter 3.000 Zeichen und Stapel bis einschließlich 12.000 Zeichen bleiben unverändert. Beispiel: Bei zwei Suchergebnissen mit 7.000 und 6.000 Zeichen wird das größere Ergebnis privat gespeichert; Anfang, Ende, ausgelassene Zeichenzahl und `output_path` bleiben für den Agenten sichtbar.
 
 Ab BLUN King 9.1.100 beendet eine begrenzte Grep-Inhaltssuche ripgrep, sobald der Versatz, die angeforderten Zeilen und eine zusätzliche Vorschauzeile vollständig vorliegen. Die Vorschauzeile belegt, ob eine weitere Seite existiert, ohne vorher bis zu 10 MB einzulesen. Unbegrenzte Suchen, Trefferzählungen und nach Änderungszeit sortierte Dateilisten laufen weiterhin vollständig durch.

package/bin/profile-tool-exclusion-policy.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+function normalizedExcludedToolNames(excludedNames) {
+  if (!Array.isArray(excludedNames)) return [];
+  return [...new Set(excludedNames
+    .map((name) => String(name || '').trim())
+    .filter(Boolean))];
+}
+
+function applyProfileToolExclusions(tools, excludedNames) {
+  const excluded = normalizedExcludedToolNames(excludedNames);
+  if (excluded.length === 0) return { tools, matched: [], unmatched: [] };
+
+  const excludedSet = new Set(excluded);
+  const matchedSet = new Set();
+  const filtered = [];
+  for (const tool of Array.isArray(tools) ? tools : []) {
+    const name = String(tool?.name || '');
+    if (excludedSet.has(name)) {
+      matchedSet.add(name);
+      continue;
+    }
+    filtered.push(tool);
+  }
+
+  return {
+    tools: filtered,
+    matched: excluded.filter((name) => matchedSet.has(name)),
+    unmatched: excluded.filter((name) => !matchedSet.has(name)),
+  };
+}
+
+module.exports = {
+  applyProfileToolExclusions,
+  normalizedExcludedToolNames,
+};
+

package/blun.mjs

@@ -21349,6 +21349,7 @@ var init_types$13 = __esmMin((() => {
 		systemPromptTemplate: string().optional(),
 		promptVars: record(string(), string()).optional(),
 		tools: array(string()).optional(),
+		excludedTools: array(string()).optional(),
 		whenToUse: string().optional(),
 		subagents: record(string(), RawSubagentProfileSchema).optional()
 	});
@@ -28341,6 +28342,7 @@ function resolveMergedProfile(name, profileMap, cache, stack) {
 			...profile.promptVars
 		},
 		tools: profile.tools !== void 0 ? [...profile.tools] : [...parent?.tools ?? []],
+		excludedTools: profile.excludedTools !== void 0 ? [...profile.excludedTools] : [...parent?.excludedTools ?? []],
 		whenToUse: profile.whenToUse ?? parent?.whenToUse,
 		subagents: cloneSubagents(profile.subagents)
 	};
@@ -28353,6 +28355,7 @@ function toResolvedProfile(merged) {
 		description: merged.description,
 		systemPrompt: createSystemPromptRenderer(merged),
 		tools: [...merged.tools],
+		excludedTools: [...merged.excludedTools],
 		whenToUse: merged.whenToUse
 	};
 }
@@ -28524,9 +28527,12 @@ var PROFILE_SOURCES, DEFAULT_INIT_PROMPT, DEFAULT_AGENT_PROFILES;
 var init_default$1 = __esmMin((() => {
 	init_agent$3();
 	init_coder();
+	coder_default = coder_default.replace("\nwhenToUse:", "\nexcludedTools:\n  - mcp__plugin-telegram_telegram__reply\n  - mcp__plugin-telegram_telegram__react\n  - mcp__plugin-telegram_telegram__edit_message\n  - mcp__plugin-telegram_telegram__download_attachment\n\nwhenToUse:");
 	init_explore();
+	explore_default = explore_default.replace("\nwhenToUse:", "\nexcludedTools:\n  - mcp__plugin-telegram_telegram__reply\n  - mcp__plugin-telegram_telegram__react\n  - mcp__plugin-telegram_telegram__edit_message\n  - mcp__plugin-telegram_telegram__download_attachment\n\nwhenToUse:");
 	init_init();
 	init_plan$1();
+	plan_default = plan_default.replace("\nwhenToUse:", "\nexcludedTools:\n  - mcp__plugin-telegram_telegram__reply\n  - mcp__plugin-telegram_telegram__react\n  - mcp__plugin-telegram_telegram__edit_message\n  - mcp__plugin-telegram_telegram__download_attachment\n\nwhenToUse:");
 	init_system();
 	init_load();
 	PROFILE_SOURCES = {
@@ -263333,7 +263339,7 @@ var init_builtin = __esmMin((() => {
 var init_types$3 = __esmMin((() => {}));
 //#endregion
 //#region ../../packages/agent-core/src/agent/tool/index.ts
-var import_picomatch, SHELL_FOREGROUND_TIMEOUT_S, ToolManager;
+var import_picomatch, profileToolExclusionPolicy, applyProfileToolExclusions, SHELL_FOREGROUND_TIMEOUT_S, ToolManager;
 var init_tool$1 = __esmMin((() => {
 	init_dist$4();
 	import_picomatch = /* @__PURE__ */ __toESM(require_picomatch(), 1);
@@ -263346,6 +263352,8 @@ var init_tool$1 = __esmMin((() => {
 	init_builtin();
 	init_compact_conversation_tool();
 	init_types$3();
+	profileToolExclusionPolicy = createRequire(import.meta.url)("./bin/profile-tool-exclusion-policy.cjs");
+	applyProfileToolExclusions = profileToolExclusionPolicy.applyProfileToolExclusions;
 	SHELL_FOREGROUND_TIMEOUT_S = 120;
 	ToolManager = class {
 		agent;
@@ -263361,6 +263369,8 @@ var init_tool$1 = __esmMin((() => {
 		store = {};
 		mcpToolStatusUnsubscribe;
 		allowedTools;
+		excludedTools = [];
+		reportedUnmatchedExclusions = /* @__PURE__ */ new Set();
 		/** Abort controllers for in-flight `!` shell commands, keyed by commandId so
 		*  the TUI can cancel (Esc / Ctrl+C) a running command. */
 		shellCommandControllers = /* @__PURE__ */ new Map();
@@ -263681,6 +263691,14 @@ var init_tool$1 = __esmMin((() => {
 		setAllowedTools(tools) {
 			this.allowedTools = tools !== void 0 && tools.length > 0 ? [...tools] : void 0;
 		}
+		setExcludedTools(names) {
+			this.excludedTools = [...new Set((Array.isArray(names) ? names : []).map((name) => String(name || "").trim()).filter(Boolean))];
+			this.reportedUnmatchedExclusions.clear();
+			this.agent.records.logRecord({
+				type: "tools.set_excluded_tools",
+				names: this.excludedTools
+			});
+		}
 		copyLoopToolsFrom(source) {
 			this.loopToolsOverride = source.loopTools;
 		}
@@ -263821,12 +263839,22 @@ var init_tool$1 = __esmMin((() => {
 			}
 		}
 		get loopTools() {
-			if (this.loopToolsOverride !== void 0) return this.loopToolsOverride;
-			const mcpNames = [...this.mcpTools.keys()].filter((name) => this.isMcpToolEnabled(name));
-			const hideGoalMutationTools = this.agent.goal.getGoal().goal === null;
-			const allowedTools = this.allowedTools;
-			const names = uniq([...this.enabledTools, ...mcpNames]).toSorted((a, b) => a.localeCompare(b)).filter((name) => !(hideGoalMutationTools && (name === "SetGoalBudget" || name === "UpdateGoal")));
-			return (allowedTools !== void 0 && allowedTools.length > 0 ? names.filter((name) => allowedTools.includes(name)) : names).map((name) => this.userTools.get(name) ?? this.mcpTools.get(name)?.tool ?? this.builtinTools.get(name)).filter((tool) => !!tool);
+			let selectedTools;
+			if (this.loopToolsOverride !== void 0) selectedTools = this.loopToolsOverride;
+			else {
+				const mcpNames = [...this.mcpTools.keys()].filter((name) => this.isMcpToolEnabled(name));
+				const hideGoalMutationTools = this.agent.goal.getGoal().goal === null;
+				const allowedTools = this.allowedTools;
+				const names = uniq([...this.enabledTools, ...mcpNames]).toSorted((a, b) => a.localeCompare(b)).filter((name) => !(hideGoalMutationTools && (name === "SetGoalBudget" || name === "UpdateGoal")));
+				selectedTools = (allowedTools !== void 0 && allowedTools.length > 0 ? names.filter((name) => allowedTools.includes(name)) : names).map((name) => this.userTools.get(name) ?? this.mcpTools.get(name)?.tool ?? this.builtinTools.get(name)).filter((tool) => !!tool);
+			}
+			const exclusion = applyProfileToolExclusions(selectedTools, this.excludedTools);
+			for (const name of exclusion.unmatched) if (!this.reportedUnmatchedExclusions.has(name)) {
+				this.reportedUnmatchedExclusions.add(name);
+				this.agent.log.warn("profile tool exclusion did not match a loaded tool", { name });
+				this.agent.telemetry.track("profile_tool_exclusion_unmatched", { tool_name: name });
+			}
+			return exclusion.tools;
 		}
 	};
 }));
@@ -264424,6 +264452,7 @@ var init_agent = __esmMin((() => {
 			this.setActiveProfile(profile, brandHome);
 			this.updateSystemPromptFromProfile(profile, context);
 			this.tools.setActiveTools(profile.tools);
+			this.tools.setExcludedTools(profile.excludedTools);
 		}
 		setActiveProfile(profile, brandHome) {
 			this.activeProfile = profile;
@@ -412820,27 +412849,45 @@ const STREAMING_ARGS_PREVIEW_MAX_CHARS = 64 * 1024;
 registerUiCatalogFragment({
 	en: {
 		"eventPayload.providerFiltered": "Provider filtered the response before visible output (finishReason={finishReason}{raw}).",
-		"eventPayload.modelEmptyResponse": "King ended twice without producing content. Please send the message again."
+		"eventPayload.modelEmptyResponse": "King ended twice without producing content. Please send the message again.",
+		"eventPayload.providerBusy": "King is busy right now. Please try again shortly.",
+		"eventPayload.providerUnavailable": "King could not complete this response. Please try again.",
+		"eventPayload.providerAuthRequired": "Your King connection needs to be renewed. Please sign in again."
 	},
 	de: {
 		"eventPayload.providerFiltered": "Der Anbieter hat die Antwort vor der sichtbaren Ausgabe gefiltert (finishReason={finishReason}{raw}).",
-		"eventPayload.modelEmptyResponse": "King hat die Antwort zweimal ohne Inhalt beendet. Bitte sende die Nachricht noch einmal."
+		"eventPayload.modelEmptyResponse": "King hat die Antwort zweimal ohne Inhalt beendet. Bitte sende die Nachricht noch einmal.",
+		"eventPayload.providerBusy": "King ist gerade ausgelastet. Bitte versuche es gleich noch einmal.",
+		"eventPayload.providerUnavailable": "King konnte diese Antwort nicht abschließen. Bitte versuche es noch einmal.",
+		"eventPayload.providerAuthRequired": "Die Verbindung zu King muss erneuert werden. Bitte melde dich erneut an."
 	},
 	es: {
 		"eventPayload.providerFiltered": "El proveedor filtró la respuesta antes de que se mostrara la salida (finishReason={finishReason}{raw}).",
-		"eventPayload.modelEmptyResponse": "King terminó dos veces sin generar contenido. Envía el mensaje de nuevo."
+		"eventPayload.modelEmptyResponse": "King terminó dos veces sin generar contenido. Envía el mensaje de nuevo.",
+		"eventPayload.providerBusy": "King está ocupado en este momento. Vuelve a intentarlo en unos instantes.",
+		"eventPayload.providerUnavailable": "King no ha podido completar esta respuesta. Vuelve a intentarlo.",
+		"eventPayload.providerAuthRequired": "Es necesario renovar la conexión con King. Vuelve a iniciar sesión."
 	},
 	fr: {
 		"eventPayload.providerFiltered": "Le fournisseur a filtré la réponse avant l’affichage de la sortie (finishReason={finishReason}{raw}).",
-		"eventPayload.modelEmptyResponse": "King a terminé deux fois sans produire de contenu. Envoyez à nouveau le message."
+		"eventPayload.modelEmptyResponse": "King a terminé deux fois sans produire de contenu. Envoyez à nouveau le message.",
+		"eventPayload.providerBusy": "King est occupé pour le moment. Réessayez dans quelques instants.",
+		"eventPayload.providerUnavailable": "King n’a pas pu terminer cette réponse. Réessayez.",
+		"eventPayload.providerAuthRequired": "La connexion à King doit être renouvelée. Reconnectez-vous."
 	},
 	sv: {
 		"eventPayload.providerFiltered": "Leverantören filtrerade svaret innan någon utdata visades (finishReason={finishReason}{raw}).",
-		"eventPayload.modelEmptyResponse": "King avslutade två gånger utan att skapa något innehåll. Skicka meddelandet igen."
+		"eventPayload.modelEmptyResponse": "King avslutade två gånger utan att skapa något innehåll. Skicka meddelandet igen.",
+		"eventPayload.providerBusy": "King är upptagen just nu. Försök igen om en liten stund.",
+		"eventPayload.providerUnavailable": "King kunde inte slutföra svaret. Försök igen.",
+		"eventPayload.providerAuthRequired": "Anslutningen till King behöver förnyas. Logga in igen."
 	},
 	cs: {
 		"eventPayload.providerFiltered": "Poskytovatel filtroval odpověď před viditelným výstupem (finishReason={finishReason}{raw}).",
-		"eventPayload.modelEmptyResponse": "King dvakrát ukončil odpověď bez obsahu. Odešlete zprávu znovu."
+		"eventPayload.modelEmptyResponse": "King dvakrát ukončil odpověď bez obsahu. Odešlete zprávu znovu.",
+		"eventPayload.providerBusy": "King je právě zaneprázdněný. Zkuste to za chvíli znovu.",
+		"eventPayload.providerUnavailable": "King nemohl tuto odpověď dokončit. Zkuste to znovu.",
+		"eventPayload.providerAuthRequired": "Připojení ke Kingovi je potřeba obnovit. Přihlaste se znovu."
 	}
 });
 //#endregion
@@ -412915,10 +412962,24 @@ function formatErrorMessage$2(error) {
 }
 function formatErrorPayload(error) {
 	if (error.code === "model.empty_response") return uiText("eventPayload.modelEmptyResponse");
+	if (error.code === "provider.rate_limit") return uiText("eventPayload.providerBusy");
+	if (error.code === "provider.api_error" || error.code === "provider.connection_error") return uiText("eventPayload.providerUnavailable");
+	if (error.code === "provider.auth_error") return uiText("eventPayload.providerAuthRequired");
 	const filteredMessage = formatProviderFilteredMessage(error.details);
-	if (filteredMessage !== void 0) return projectBlunIdentity(`[${error.code}] ${filteredMessage}`);
+	if (filteredMessage !== void 0) return projectBlunIdentity(filteredMessage);
 	return projectBlunIdentity(`[${error.code}] ${error.message}`);
 }
+
+const CUSTOMER_FACING_ERROR_CODES = /* @__PURE__ */ new Set([
+	"provider.rate_limit",
+	"provider.api_error",
+	"provider.connection_error",
+	"provider.auth_error",
+	"model.empty_response"
+]);
+function shouldShowErrorReportHint(event) {
+	return !CUSTOMER_FACING_ERROR_CODES.has(event.code);
+}
 function formatProviderFilteredMessage(details) {
 	const finishReason = stringDetail(details, "finishReason");
 	const rawFinishReason = stringDetail(details, "rawFinishReason");
@@ -497166,29 +497227,41 @@ var HelpPanelComponent = class extends Container {
 	focused = false;
 	opts;
 	scrollTop = 0;
+	selectedCommandIndex = 0;
+	showCommandDetail = false;
 	constructor(opts) {
 		super();
 		this.opts = opts;
 	}
 	handleInput(data) {
 		const printable = decodeKittyPrintable(data) ?? data;
-		if (matchesKey(data, Key.escape) || matchesKey(data, Key.enter) || printable === "q" || printable === "Q") {
+		if (matchesKey(data, Key.escape) || printable === "q" || printable === "Q") {
 			this.opts.onClose();
 			return;
 		}
+		const sortedCmds = [...this.opts.commands].toSorted(compareSlashCommandsForDisplay);
+		if (sortedCmds.length === 0) return;
+		if (matchesKey(data, Key.right) || matchesKey(data, Key.enter)) {
+			this.showCommandDetail = true;
+			return;
+		}
+		if (matchesKey(data, Key.left)) {
+			this.showCommandDetail = false;
+			return;
+		}
 		if (matchesKey(data, Key.up)) {
-			this.scrollTop = Math.max(0, this.scrollTop - 1);
+			this.selectedCommandIndex = Math.max(0, this.selectedCommandIndex - 1);
 			return;
 		}
 		if (matchesKey(data, Key.down)) {
-			this.scrollTop += 1;
+			this.selectedCommandIndex = Math.min(sortedCmds.length - 1, this.selectedCommandIndex + 1);
 			return;
 		}
 		if (matchesKey(data, Key.pageUp)) {
-			this.scrollTop = Math.max(0, this.scrollTop - 10);
+			this.selectedCommandIndex = Math.max(0, this.selectedCommandIndex - 10);
 			return;
 		}
-		if (matchesKey(data, Key.pageDown)) this.scrollTop += 10;
+		if (matchesKey(data, Key.pageDown)) this.selectedCommandIndex = Math.min(sortedCmds.length - 1, this.selectedCommandIndex + 10);
 	}
 	render(width) {
 		const accent = (text) => currentTheme.fg("primary", text);
@@ -497199,6 +497272,8 @@ var HelpPanelComponent = class extends Container {
 		const shortcuts = this.opts.shortcuts ?? DEFAULT_KEYBOARD_SHORTCUTS;
 		const kbdWidth = Math.max(8, ...shortcuts.map((s) => s.keys.length));
 		const sortedCmds = [...this.opts.commands].toSorted(compareSlashCommandsForDisplay);
+		this.selectedCommandIndex = Math.max(0, Math.min(this.selectedCommandIndex, Math.max(0, sortedCmds.length - 1)));
+		if (this.showCommandDetail && sortedCmds.length > 0) return this.renderCommandDetail(width, sortedCmds);
 		const cmdLabels = sortedCmds.map((c) => {
 			const aliases = c.aliases.length > 0 ? ` (${c.aliases.map((a) => "/" + a).join(", ")})` : "";
 			return `/${c.name}${aliases}`;
@@ -497215,7 +497290,10 @@ var HelpPanelComponent = class extends Container {
 			"",
 			`  ${currentTheme.bold(uiText("help.slashCommands"))}`,
 			...sortedCmds.map((cmd, i) => {
-				return `    ${slashColor((cmdLabels[i] ?? `/${cmd.name}`).padEnd(cmdWidth))}  ${dim(cmd.description)}`;
+				const marker = i === this.selectedCommandIndex ? accent("â–¶") : " ";
+				const label = (cmdLabels[i] ?? `/${cmd.name}`).padEnd(cmdWidth);
+				const commandText = i === this.selectedCommandIndex ? currentTheme.boldFg("primary", label) : slashColor(label);
+				return `  ${marker} ${commandText}  ${dim(cmd.description)}`;
 			}),
 			"",
 			accent("─".repeat(width))
@@ -497223,6 +497301,9 @@ var HelpPanelComponent = class extends Container {
 		const content = lines.slice(1, lines.length - 1);
 		const maxVisible = Math.max(5, this.opts.maxVisible ?? 24);
 		if (content.length > maxVisible) {
+			const selectedLine = 7 + shortcuts.length + this.selectedCommandIndex;
+			if (selectedLine < this.scrollTop) this.scrollTop = selectedLine;
+			if (selectedLine >= this.scrollTop + maxVisible) this.scrollTop = selectedLine - maxVisible + 1;
 			this.scrollTop = Math.max(0, Math.min(this.scrollTop, content.length - maxVisible));
 			const slice = content.slice(this.scrollTop, this.scrollTop + maxVisible);
 			const scrollInfo = muted(` ${uiText("help.scrollInfo", {
@@ -497240,6 +497321,27 @@ var HelpPanelComponent = class extends Container {
 		this.scrollTop = 0;
 		return lines.map((line) => truncateToWidth(line, width));
 	}
+	renderCommandDetail(width, sortedCmds) {
+		const accent = (text) => currentTheme.fg("primary", text);
+		const dim = (text) => currentTheme.fg("textDim", text);
+		const muted = (text) => currentTheme.fg("textMuted", text);
+		const command = sortedCmds[this.selectedCommandIndex];
+		if (command === void 0) return [];
+		const argumentHint = typeof command.argumentHint === "string" && command.argumentHint.length > 0 ? ` ${command.argumentHint}` : "";
+		const aliases = command.aliases.length > 0 ? command.aliases.map((alias) => `/${alias}`).join(", ") : "—";
+		const descriptionLines = wrapTextWithAnsi(dim(command.description), Math.max(10, width - 4)).map((line) => `  ${line}`);
+		return [
+			accent("─".repeat(width)),
+			currentTheme.boldFg("primary", ` /${command.name}${argumentHint}`),
+			"",
+			...descriptionLines,
+			"",
+			`  ${muted("=")} ${dim(aliases)}`,
+			"",
+			muted(`  ${this.selectedCommandIndex + 1}/${sortedCmds.length}  ·  ↑↓  ·  ←  ·  Esc / q`),
+			accent("─".repeat(width))
+		].map((line) => truncateToWidth(line, width));
+	}
 };
 function localizedShortcut(keys, descriptionKey) {
 	return {
@@ -506727,6 +506829,7 @@ var SessionEventHandler = class {
 		this.showErrorReportHint(event);
 	}
 	showErrorReportHint(event) {
+		if (!shouldShowErrorReportHint(event)) return;
 		const { appState } = this.host.state;
 		if (appState.sessionId.length === 0) return;
 		this.host.showStatus(errorReportHintLine({

package/package.json

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