blun-king-cli 9.1.424 → 9.1.425

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.424",
+  "version": "9.1.425",
   "description": "BLUN CLI - your own AI agent with a Telegram channel. Get it done. With BLUN.",
   "license": "MIT",
   "bin": {