blun-king-cli 9.1.467 → 9.1.468

package/bin/agent-api-runtime.mjs

@@ -6,7 +6,12 @@ const { createAgentApiToolBroker } = require('./agent-api-tool-broker.cjs');
 
 const CLIENT_TOOL_NAME_PATTERN = /^[A-Za-z0-9_-]{1,64}$/u;
 const INTERNAL_TOOL_PREFIX = 'client__';
-const NO_CLIENT_TOOLS_PREFIX = '__blun_agent_api_no_client_tools__';
+const AGENT_API_INTERNAL_TOOLS = Object.freeze([
+  'Agent',
+  'TaskList',
+  'TaskOutput',
+  'TaskStop',
+]);
 
 class AgentApiRuntimeError extends Error {
   constructor(code, message) {
@@ -112,10 +117,6 @@ function internalToolName(publicName, index) {
   return `${prefix}${publicName.slice(0, available)}${suffix}`;
 }
 
-function noClientToolsSentinel(sessionId, requestId) {
-  return `${NO_CLIENT_TOOLS_PREFIX}${shortHash(`${sessionId}\0${requestId}`, 16)}`;
-}
-
 function validateSession(session) {
   if (session === null || typeof session !== 'object') {
     throw runtimeError('AGENT_API_INVALID_SESSION', 'session must be an SDK session');
@@ -188,11 +189,10 @@ function createAgentApiRuntime(options = {}) {
         registeredNames.push(tool.internalName);
       }
 
-      await input.session.setAllowedTools(
-        registeredNames.length > 0
-          ? registeredNames
-          : [noClientToolsSentinel(sessionId, requestId)],
-      );
+      await input.session.setAllowedTools([
+        ...AGENT_API_INTERNAL_TOOLS,
+        ...registeredNames,
+      ]);
     } catch (error) {
       broker.abortRequest({
         sessionId,
@@ -244,9 +244,9 @@ function createAgentApiRuntime(options = {}) {
 }
 
 export {
+  AGENT_API_INTERNAL_TOOLS,
   AgentApiRuntimeError,
   CLIENT_TOOL_NAME_PATTERN,
-  NO_CLIENT_TOOLS_PREFIX,
   createAgentApiRuntime,
   normalizeClientToolDefinitions,
 };

package/bin/subagent-tool-policy.cjs

@@ -0,0 +1,60 @@
+'use strict';
+
+const NESTED_AGENT_LIFECYCLE_TOOLS = Object.freeze([
+  'Agent',
+  'TaskList',
+  'TaskOutput',
+  'TaskStop',
+]);
+
+function validateParentAllowedTools(parentTools) {
+  if (parentTools === null || typeof parentTools !== 'object') {
+    throw new TypeError('parentTools is required');
+  }
+  const allowed = parentTools.allowedTools;
+  if (allowed !== undefined && !Array.isArray(allowed)) {
+    throw new TypeError('parentTools.allowedTools must be an array or undefined');
+  }
+  return allowed;
+}
+
+function inheritSubagentLifecycleTools(parentTools, childTools) {
+  const allowed = validateParentAllowedTools(parentTools);
+  if (allowed === undefined) return [];
+  if (childTools === null || typeof childTools !== 'object'
+    || typeof childTools.data !== 'function'
+    || typeof childTools.setActiveTools !== 'function'
+    || typeof childTools.refreshBuiltinTools !== 'function') {
+    throw new TypeError('childTools lifecycle controls are required');
+  }
+
+  const toolData = childTools.data();
+  if (!Array.isArray(toolData)) throw new TypeError('childTools.data() must return an array');
+  const available = new Set(toolData.map((tool) => tool?.name).filter(Boolean));
+  const inherited = NESTED_AGENT_LIFECYCLE_TOOLS.filter((name) => (
+    allowed.includes(name) && available.has(name)
+  ));
+  if (inherited.length === 0) return [];
+
+  const active = toolData.filter((tool) => tool?.active === true).map((tool) => tool.name);
+  childTools.setActiveTools([...new Set([...active, ...inherited])]);
+  childTools.refreshBuiltinTools();
+  return inherited;
+}
+
+function inheritSubagentAllowedTools(parentTools, childTools) {
+  const allowed = validateParentAllowedTools(parentTools);
+  if (childTools === null || typeof childTools !== 'object'
+    || typeof childTools.setAllowedTools !== 'function') {
+    throw new TypeError('childTools.setAllowedTools is required');
+  }
+  const inherited = allowed === undefined ? undefined : [...allowed];
+  childTools.setAllowedTools(inherited);
+  return inherited;
+}
+
+module.exports = {
+  NESTED_AGENT_LIFECYCLE_TOOLS,
+  inheritSubagentAllowedTools,
+  inheritSubagentLifecycleTools,
+};

package/blun.mjs

@@ -252406,7 +252406,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, 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 DEFAULT_SUBAGENT_TIMEOUT_MS, resolveSubagentTimeoutMs, runAgentWithTimeoutContinuation, buildSubagentUsageDelta, inheritSubagentAllowedTools, inheritSubagentLifecycleTools, 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();
@@ -252420,6 +252420,7 @@ 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"));
+	({ inheritSubagentAllowedTools, inheritSubagentLifecycleTools } = createRequire(import.meta.url)("./bin/subagent-tool-policy.cjs"));
 	({
 		SUBAGENT_MAX_TOKENS_ERROR,
 		SUBAGENT_MAX_TOKENS_HANDOFF_PROMPT,
@@ -252729,6 +252730,8 @@ IMPORTANT:
 			const context = await prepareSystemPromptContext(this.session.systemContextKaos(child.kaos.getcwd()), this.session.options.blunHomeDir, { additionalDirs: child.getAdditionalDirs() });
 			child.useProfile(profile, context, this.session.options.blunHomeDir);
 			child.tools.inheritUserTools(parent.tools);
+			inheritSubagentLifecycleTools(parent.tools, child.tools);
+			inheritSubagentAllowedTools(parent.tools, child.tools);
 		}
 		async triggerSubagentStart(parent, profileName, prompt, signal) {
 			await parent.hooks?.trigger("SubagentStart", {

package/package.json

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