blun-king-cli 9.1.423 → 9.1.425

package/bin/mistake-relevance-policy.cjs

@@ -14,7 +14,8 @@ const NON_ACTIONABLE_USER_ORIGINS = new Set([
   'skill_activation',
 ]);
 const STOP_WORDS = new Set([
-  'aber', 'alle', 'alles', 'auch', 'eine', 'einem', 'einen', 'einer', 'eines',
+  'aber', 'alle', 'alles', 'auch', 'das', 'dem', 'den', 'der', 'des', 'die',
+  'ein', 'eine', 'einem', 'einen', 'einer', 'eines',
   'fuer', 'haben', 'hier', 'immer', 'jetzt', 'kann', 'machen', 'mehr', 'mich',
   'nicht', 'noch', 'oder', 'sein', 'sind', 'soll', 'und', 'uns', 'von', 'was',
   'wenn', 'werden', 'wie', 'with', 'that', 'this', 'from', 'have', 'into',
@@ -22,8 +23,36 @@ const STOP_WORDS = new Set([
 ]);
 const REUSABLE_HEADING = /\b(rule|regel|condition|bedingung|countercheck|gegenprobe|trigger|ausloeser|auslöser)\b/iu;
 
+const SEMANTIC_SIGNAL_RULES = Object.freeze([
+  ['problem:reliability', /\b(?:error|failure|failed|broken|crash(?:ed)?|timeout|unavailable|corrupt(?:ed)?|dropped|missing|lost|fehler|scheiter\w*|absturz|ausfall|kaputt|defekt|fehlend|verloren|unerreichbar|abbruch)\b/iu],
+  ['problem:delivery', /\b(?:deliver\w*|receiv\w*|message\w*|repl(?:y|ies)|inbox|outbox|send(?:ing|s|t)?|consum\w*|zustell\w*|empfang\w*|nachricht\w*|meldung\w*|senden|bekomm\w*|antwort\w*)\b/iu],
+  ['problem:stagnation', /\b(?:loop\w*|repeat\w*|stuck|hang(?:ing)?|freeze|frozen|idle|no progress|stop(?:s|ped)? consuming|schleife\w*|wiederhol\w*|hang\w*|stillstand|leerlauf|kein fortschritt|taub)\b/iu],
+  ['problem:performance', /\b(?:slow|latency|bottleneck|throughput|memory pressure|cpu|vram|langsam\w*|latenz|durchsatz|engpass|speicherdruck)\b/iu],
+  ['problem:protocol', /\b(?:schema|contract|payload|protocol|format|version mismatch|manifest mismatch|vertrag|protokoll|versionskonflikt)\b/iu],
+  ['problem:capability', /\b(?:capabilit\w*|missing tool|not available|unsupported|fahigkeit\w*|werkzeug fehlt|nicht verfugbar)\b/iu],
+  ['area:orchestration', /\b(?:agent\w*|worker\w*|queue\w*|checkpoint\w*|heartbeat\w*|delegat\w*|owner\w*|responsib\w*|task\w*|turn\w*|busy|group\w*|channel\w*|arbeiter\w*|warteschlange\w*|prufpunkt\w*|herzschlag\w*|zustandig\w*|auftrag\w*|zug\w*|beschaftigt|gruppe\w*|gruppen\w*|kanal\w*)\b/iu],
+  ['area:memory', /\b(?:memory|recall|remember\w*|context|history|resume|checkpoint|mnemo|gedachtnis|erinner\w*|kontext|verlauf|wiederaufnahme)\b/iu],
+  ['area:release', /\b(?:release\w*|rollout\w*|update\w*|updater\w*|npm|package\w*|manifest\w*|version\w*|veroffentlich\w*|paket\w*|integrity|integritat)\b/iu],
+  ['area:media', /\b(?:image\w*|video\w*|audio\w*|portrait\w*|render\w*|pixel\w*|media|bild\w*|foto\w*|gesicht\w*|stimme\w*)\b/iu],
+  ['risk:validation', /\b(?:verif\w*|validat\w*|test\w*|check\w*|gate\w*|rollback\w*|canary|proof|evidence|sha(?:256|512)?|measur\w*|inspect\w*|(?:ge)?pruf\w*|gegenprobe\w*|beleg\w*|evidenz\w*|mess\w*|kontroll\w*)\b/iu],
+  ['action:repair', /\b(?:fix\w*|repair\w*|restore\w*|recover\w*|reparier\w*|beheb\w*|wiederherstell\w*)\b/iu],
+  ['action:investigate', /\b(?:inspect\w*|diagnos\w*|measure\w*|trace\w*|check\w*|(?:ge)?pruf\w*|mess\w*|untersuch\w*)\b/iu],
+]);
+
 function normalizeText(value) {
-  return String(value || '').normalize('NFKD').replace(/\p{M}/gu, '').toLowerCase();
+  return String(value || '')
+    .normalize('NFKD')
+    .replace(/\p{M}/gu, '')
+    .replace(/\u00df/gu, 'ss')
+    .toLowerCase();
+}
+
+function semanticSignalTags(value) {
+  const normalized = normalizeText(value);
+  if (!normalized) return [];
+  return SEMANTIC_SIGNAL_RULES
+    .filter(([, pattern]) => pattern.test(normalized))
+    .map(([tag]) => tag);
 }
 
 function terms(value) {
@@ -100,15 +129,25 @@ function isReusableSection(section) {
   return REUSABLE_HEADING.test(`${section.heading}\n${section.body}`);
 }
 
-function scoreSection(section, queryTerms) {
+function scoreSection(section, queryTerms, queryTags) {
   const heading = normalizeText(`${section.parent} ${section.heading}`);
   const body = normalizeText(section.body);
   let score = isReusableSection(section) ? 1 : 0;
+  let lexicalMatches = 0;
   for (const term of queryTerms) {
-    if (heading.includes(term)) score += 6;
-    if (body.includes(term)) score += 4;
+    if (heading.includes(term)) {
+      score += 6;
+      lexicalMatches += 1;
+    }
+    if (body.includes(term)) {
+      score += 4;
+      lexicalMatches += 1;
+    }
   }
-  return score;
+  const sectionTags = new Set(semanticSignalTags(`${heading}\n${body}`));
+  const semanticMatches = queryTags.filter((tag) => sectionTags.has(tag));
+  score += semanticMatches.length * 2;
+  return { lexicalMatches, score, semanticMatches };
 }
 
 function compactSection(section, maxChars) {
@@ -144,16 +183,24 @@ function selectRelevantMistakeSources(sources, query, options = {}) {
     }))
   ));
   const queryTerms = terms(query);
+  const queryTags = semanticSignalTags(query);
   const ranked = sections.map((section) => {
     const reusable = isReusableSection(section);
-    const score = scoreSection(section, queryTerms);
+    const { lexicalMatches, score, semanticMatches } = scoreSection(section, queryTerms, queryTags);
     return {
       ...section,
-      matched: score > (reusable ? 1 : 0),
+      lexicalMatches,
       reusable,
       score,
+      semanticMatches,
     };
   });
+  const hasLexicalMatch = ranked.some((section) => section.lexicalMatches > 0);
+  for (const section of ranked) {
+    section.matched = hasLexicalMatch
+      ? section.lexicalMatches > 0
+      : section.semanticMatches.length > 0;
+  }
   const hasMatch = ranked.some((section) => section.matched);
   ranked.sort((left, right) => {
     if (hasMatch && right.score !== left.score) return right.score - left.score;
@@ -188,6 +235,11 @@ function selectRelevantMistakeSources(sources, query, options = {}) {
   selected.sort((left, right) => left.ordinal - right.ordinal);
   const text = [header, ...selected.map((section) => section.rendered)].join('\n\n').slice(0, maxChars);
   return {
+    selected: selected.map((section) => ({
+      heading: section.heading,
+      reference: normalizedSources[section.sourceIndex]?.reference || '',
+      semanticMatches: section.semanticMatches || [],
+    })),
     selectedChars: text.length,
     selectedSections: selected.length,
     text,
@@ -209,6 +261,7 @@ module.exports = {
   RECENT_USER_MESSAGES,
   isLowInformationMistakeTurn,
   recentUserText,
+  semanticSignalTags,
   selectRelevantMistakeContent,
   selectRelevantMistakeSources,
 };

package/bin/subagent-max-tokens-handoff-policy.cjs

@@ -0,0 +1,55 @@
+"use strict";
+
+const MAX_SUBAGENT_HANDOFF_ATTEMPTS = 1;
+const MAX_PARTIAL_HANDOFF_CHARS = 6000;
+const SUBAGENT_MAX_TOKENS_ERROR =
+  "Subagent turn failed before completing its final summary: reason=max_tokens";
+const SUBAGENT_MAX_TOKENS_HANDOFF_PROMPT = [
+  "Your previous turn reached max_tokens before its final handoff.",
+  "Do not call any tools and do not repeat completed work.",
+  "Return one concise recovery handoff of at most 1200 words with:",
+  "1. completed work and concrete findings",
+  "2. exact files changed or created",
+  "3. checks already run and their actual results",
+  "4. unfinished work or blockers",
+  "5. the exact next action for the parent or this same agent",
+  "State clearly that the task is incomplete when anything remains.",
+].join("\n");
+
+function shouldRequestSubagentHandoff(stopReason, attempts) {
+  return stopReason === "max_tokens"
+    && Number.isSafeInteger(attempts)
+    && attempts >= 0
+    && attempts < MAX_SUBAGENT_HANDOFF_ATTEMPTS;
+}
+
+function boundedPartialHandoff(partialSummary) {
+  const normalized = typeof partialSummary === "string" ? partialSummary.trim() : "";
+  if (normalized.length <= MAX_PARTIAL_HANDOFF_CHARS) return normalized;
+  return `${normalized.slice(0, MAX_PARTIAL_HANDOFF_CHARS)}\n[partial handoff truncated]`;
+}
+
+function buildSubagentMaxTokensFailure(partialSummary) {
+  const partial = boundedPartialHandoff(partialSummary);
+  const lines = [
+    `${SUBAGENT_MAX_TOKENS_ERROR}.`,
+    "The automatic concise handoff also reached max_tokens.",
+  ];
+  if (partial.length > 0) {
+    lines.push("", "[partial_handoff]", partial, "[/partial_handoff]");
+  }
+  lines.push(
+    "",
+    "Resume the same subagent instead of starting the task again; its context and completed tool work are preserved.",
+  );
+  return lines.join("\n");
+}
+
+module.exports = {
+  MAX_PARTIAL_HANDOFF_CHARS,
+  MAX_SUBAGENT_HANDOFF_ATTEMPTS,
+  SUBAGENT_MAX_TOKENS_ERROR,
+  SUBAGENT_MAX_TOKENS_HANDOFF_PROMPT,
+  buildSubagentMaxTokensFailure,
+  shouldRequestSubagentHandoff,
+};

package/blun.mjs

@@ -252261,7 +252261,21 @@ async function runChildTurnToCompletion(child, signal) {
 		if (typeof statusCode === "number") error.statusCode = statusCode;
 		throw error;
 	}
-	if (completion.stopReason === "max_tokens") throw new Error(`${SUBAGENT_MAX_TOKENS_ERROR}.`);
+	return completion.stopReason;
+}
+async function completeChildTurnWithMaxTokensHandoff(child, signal) {
+	let stopReason = await runChildTurnToCompletion(child, signal);
+	let handoffAttempts = 0;
+	while (shouldRequestSubagentHandoff(stopReason, handoffAttempts)) {
+		handoffAttempts += 1;
+		signal.throwIfAborted();
+		if (child.turn.prompt([{
+			type: "text",
+			text: SUBAGENT_MAX_TOKENS_HANDOFF_PROMPT
+		}], SUBAGENT_PROMPT_ORIGIN) === null) throw new Error("Subagent could not start its max_tokens recovery handoff.");
+		stopReason = await runChildTurnToCompletion(child, signal);
+	}
+	if (stopReason === "max_tokens") throw new Error(buildSubagentMaxTokensFailure(lastAssistantText(child)));
 }
 function providerRateLimitErrorFromPayload(error) {
 	const requestId = typeof error.details?.["requestId"] === "string" ? error.details["requestId"] : null;
@@ -252280,7 +252294,7 @@ function shouldSuppressQueuedAttemptFailureEvent(options, error) {
 	if (isProviderRateLimitError(error)) return true;
 	return isAbortError$4(error) || options.signal.aborted;
 }
-var DEFAULT_SUBAGENT_TIMEOUT_MS, resolveSubagentTimeoutMs, runAgentWithTimeoutContinuation, buildSubagentUsageDelta, SUMMARY_MIN_LENGTH, SUMMARY_CONTINUATION_ATTEMPTS, HOOK_TEXT_PREVIEW_LENGTH, SUBAGENT_MAX_TOKENS_ERROR, TOOL_CALL_DISABLED_MESSAGE, SUBAGENT_PROMPT_ORIGIN, SIDE_QUESTION_SYSTEM_REMINDER, SessionSubagentHost;
+var DEFAULT_SUBAGENT_TIMEOUT_MS, resolveSubagentTimeoutMs, runAgentWithTimeoutContinuation, buildSubagentUsageDelta, SUBAGENT_MAX_TOKENS_ERROR, SUBAGENT_MAX_TOKENS_HANDOFF_PROMPT, buildSubagentMaxTokensFailure, shouldRequestSubagentHandoff, SUMMARY_MIN_LENGTH, SUMMARY_CONTINUATION_ATTEMPTS, HOOK_TEXT_PREVIEW_LENGTH, TOOL_CALL_DISABLED_MESSAGE, SUBAGENT_PROMPT_ORIGIN, SIDE_QUESTION_SYSTEM_REMINDER, SessionSubagentHost;
 var init_subagent_host = __esmMin((() => {
 	init_src$4();
 	init_errors$8();
@@ -252294,10 +252308,15 @@ var init_subagent_host = __esmMin((() => {
 	init_summary_continuation();
 	({ DEFAULT_SUBAGENT_TIMEOUT_MS, resolveSubagentTimeoutMs, runAgentWithTimeoutContinuation } = createRequire(import.meta.url)("./bin/subagent-timeout-policy.cjs"));
 	({ buildSubagentUsageDelta } = createRequire(import.meta.url)("./bin/subagent-usage-rollup-policy.cjs"));
+	({
+		SUBAGENT_MAX_TOKENS_ERROR,
+		SUBAGENT_MAX_TOKENS_HANDOFF_PROMPT,
+		buildSubagentMaxTokensFailure,
+		shouldRequestSubagentHandoff
+	} = createRequire(import.meta.url)("./bin/subagent-max-tokens-handoff-policy.cjs"));
 	SUMMARY_MIN_LENGTH = 200;
 	SUMMARY_CONTINUATION_ATTEMPTS = 1;
 	HOOK_TEXT_PREVIEW_LENGTH = 500;
-	SUBAGENT_MAX_TOKENS_ERROR = "Subagent turn failed before completing its final summary: reason=max_tokens";
 	TOOL_CALL_DISABLED_MESSAGE = "Tool calls are disabled for side questions. Answer with text only.";
 	SUBAGENT_PROMPT_ORIGIN = {
 		kind: "system_trigger",
@@ -252561,7 +252580,7 @@ IMPORTANT:
 			return this.waitForChildCompletion(parent, childId, child, profileName, options);
 		}
 		async waitForChildCompletion(parent, childId, child, profileName, options) {
-			await runChildTurnToCompletion(child, options.signal);
+			await completeChildTurnWithMaxTokensHandoff(child, options.signal);
 			let result = lastAssistantText(child);
 			let remainingContinuations = SUMMARY_CONTINUATION_ATTEMPTS;
 			while (remainingContinuations > 0 && result.length < SUMMARY_MIN_LENGTH) {
@@ -252571,7 +252590,7 @@ IMPORTANT:
 					type: "text",
 					text: summary_continuation_default
 				}], SUBAGENT_PROMPT_ORIGIN);
-				await runChildTurnToCompletion(child, options.signal);
+				await completeChildTurnWithMaxTokensHandoff(child, options.signal);
 				result = lastAssistantText(child);
 			}
 			const usage = child.usage.data().total;
@@ -252709,7 +252728,7 @@ function formatForegroundAgentFailure(handle, message, timedOut) {
 		"",
 		`subagent error: ${message}`
 	];
-	if (timedOut) lines.push(`resume_hint: Continue with Agent(resume="${handle.agentId}", prompt="continue"). Use agent_id only; do not set subagent_type. The subagent retains its prior context; redo any unfinished tool call if its result was lost.`);
+	if (timedOut || message.includes(SUBAGENT_MAX_TOKENS_ERROR)) lines.push(`resume_hint: Continue with Agent(resume="${handle.agentId}", prompt="continue"). Use agent_id only; do not set subagent_type. The subagent retains its prior context; redo any unfinished tool call if its result was lost.`);
 	return lines.join("\n");
 }
 function launchErrorMessage(error, signal) {

package/package.json

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