@dexto/agent-management 1.6.0 → 1.6.2

package/dist/tool-factories/agent-spawner/runtime.js

@@ -1,18 +1,70 @@
-import { DextoRuntimeError, ErrorType } from "@dexto/core";
+import { randomUUID } from "crypto";
+import {
+  DextoRuntimeError,
+  ErrorType,
+  getReasoningProfile,
+  supportsReasoningVariant
+} from "@dexto/core";
 import { AgentRuntime } from "../../runtime/AgentRuntime.js";
 import { createDelegatingApprovalHandler } from "../../runtime/approval-delegation.js";
 import { loadAgentConfig } from "../../config/loader.js";
 import { getAgentRegistry } from "../../registry/registry.js";
 import { deriveDisplayName } from "../../registry/types.js";
-import { resolveBundledScript } from "../../utils/path.js";
+import { getDextoPath, resolveBundledScript } from "../../utils/path.js";
 import * as path from "path";
 import { resolveSubAgentLLM } from "./llm-resolution.js";
+const REASONING_VARIANT_FALLBACK_ORDER = [
+  "disabled",
+  "none",
+  "minimal",
+  "low",
+  "enabled",
+  "medium",
+  "high",
+  "max",
+  "xhigh"
+];
 class AgentSpawnerRuntime {
   runtime;
   parentId;
   parentAgent;
   config;
   logger;
+  selectLowestReasoningVariant(provider, model, preferredVariant) {
+    const profile = getReasoningProfile(provider, model);
+    if (!profile.capable || profile.supportedVariants.length === 0) {
+      return void 0;
+    }
+    if (supportsReasoningVariant(profile, preferredVariant)) {
+      return preferredVariant;
+    }
+    for (const variant of REASONING_VARIANT_FALLBACK_ORDER) {
+      if (supportsReasoningVariant(profile, variant)) {
+        return variant;
+      }
+    }
+    return profile.defaultVariant ?? profile.supportedVariants[0];
+  }
+  applySubAgentLlmPolicy(llm) {
+    const maxIterationsCap = this.config.subAgentMaxIterations;
+    const preferredReasoningVariant = this.config.subAgentReasoningVariant;
+    const reasoningVariant = this.selectLowestReasoningVariant(
+      llm.provider,
+      llm.model,
+      preferredReasoningVariant
+    );
+    const existingMaxIterations = llm.maxIterations;
+    const cappedMaxIterations = typeof existingMaxIterations === "number" ? Math.min(existingMaxIterations, maxIterationsCap) : maxIterationsCap;
+    const adjusted = {
+      ...llm,
+      maxIterations: cappedMaxIterations,
+      ...reasoningVariant !== void 0 ? { reasoning: { variant: reasoningVariant } } : { reasoning: void 0 }
+    };
+    this.logger.debug(
+      `[AgentSpawnerRuntime] Applied sub-agent LLM policy: maxIterations=${adjusted.maxIterations}, preferredReasoning=${preferredReasoningVariant}, selectedReasoning=${reasoningVariant ?? "none"}`
+    );
+    return adjusted;
+  }
   resolveBundledAgentConfig(agentId) {
     const baseDir = "agents";
     const normalizedPath = path.relative(baseDir, path.join(baseDir, agentId));
@@ -154,6 +206,10 @@ class AgentSpawnerRuntime {
     const tokenUsage = { input: 0, output: 0, total: 0 };
     let currentTool = "";
     const emitProgress = (tool, args) => {
+      const subAgentLogFilePath = this.getSubAgentLogFilePath({
+        runtimeAgentId: subAgentHandle.agentId,
+        sessionId
+      });
       this.parentAgent.emit("service:event", {
         service: "agent-spawner",
         event: "progress",
@@ -162,6 +218,8 @@ class AgentSpawnerRuntime {
         data: {
           task: input.task,
           agentId: input.agentId ?? "default",
+          runtimeAgentId: subAgentHandle.agentId,
+          ...subAgentLogFilePath ? { subAgentLogFilePath } : {},
           toolsCalled: toolCount,
           currentTool: tool,
           currentArgs: args,
@@ -201,6 +259,44 @@ class AgentSpawnerRuntime {
       subAgentHandle.agent.off("llm:response", responseHandler);
     };
   }
+  /**
+   * Ensure spawned agent inherits the parent's workspace context.
+   */
+  async applyParentWorkspace(agent) {
+    let parentWorkspace;
+    try {
+      parentWorkspace = await this.parentAgent.getWorkspace();
+    } catch (error) {
+      this.logger.warn(
+        `Failed to read parent workspace for sub-agent: ${error instanceof Error ? error.message : String(error)}`
+      );
+      return;
+    }
+    if (!parentWorkspace?.path) {
+      return;
+    }
+    try {
+      await agent.setWorkspace({
+        path: parentWorkspace.path,
+        ...parentWorkspace.name ? { name: parentWorkspace.name } : {}
+      });
+    } catch (error) {
+      this.logger.warn(
+        `Failed to apply parent workspace to sub-agent: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  getSubAgentLogFilePath(options) {
+    const { runtimeAgentId, sessionId } = options;
+    if (!sessionId) {
+      return null;
+    }
+    const safeSessionId = sessionId.replace(/[^a-zA-Z0-9._-]/g, "_");
+    return getDextoPath(
+      "logs",
+      path.join(this.parentId, `${safeSessionId}.subagent.${runtimeAgentId}.log`)
+    );
+  }
   /**
    * Check if an error is LLM-related (API errors, credit issues, model not found, etc.)
    */
@@ -222,7 +318,10 @@ class AgentSpawnerRuntime {
     let llmMode = "subagent";
     let cleanupProgressTracking;
     try {
-      const buildOptions = {};
+      const buildOptions = {
+        // Pre-generate the runtime agentId so we can deterministically route logs.
+        runtimeAgentId: `agent-${randomUUID().slice(0, 8)}`
+      };
       if (input.agentId !== void 0) {
         buildOptions.agentId = input.agentId;
       }
@@ -233,6 +332,7 @@ class AgentSpawnerRuntime {
       let handle;
       try {
         handle = await this.runtime.spawnAgent({
+          agentId: buildOptions.runtimeAgentId,
           agentConfig: subAgentConfig,
           ephemeral: true,
           group: this.parentId,
@@ -247,6 +347,7 @@ class AgentSpawnerRuntime {
               const delegatingHandler = createDelegatingApprovalHandler(
                 this.parentAgent.services.approvalManager,
                 agent.config.agentId ?? "unknown",
+                sessionId,
                 this.logger
               );
               agent.setApprovalHandler(delegatingHandler);
@@ -254,6 +355,7 @@ class AgentSpawnerRuntime {
           }
         });
         spawnedAgentId = handle.agentId;
+        await this.applyParentWorkspace(handle.agent);
       } catch (spawnError) {
         const isLlmError = this.isLLMError(spawnError);
         if (isLlmError && input.agentId && llmMode === "subagent") {
@@ -265,6 +367,7 @@ class AgentSpawnerRuntime {
           buildOptions.inheritLlm = true;
           subAgentConfig = await this.buildSubAgentConfig(buildOptions, sessionId);
           handle = await this.runtime.spawnAgent({
+            agentId: buildOptions.runtimeAgentId,
             agentConfig: subAgentConfig,
             ephemeral: true,
             group: this.parentId,
@@ -281,6 +384,7 @@ class AgentSpawnerRuntime {
                 const delegatingHandler = createDelegatingApprovalHandler(
                   this.parentAgent.services.approvalManager,
                   agent.config.agentId ?? "unknown",
+                  sessionId,
                   this.logger
                 );
                 agent.setApprovalHandler(delegatingHandler);
@@ -288,6 +392,7 @@ class AgentSpawnerRuntime {
             }
           });
           spawnedAgentId = handle.agentId;
+          await this.applyParentWorkspace(handle.agent);
         } else {
           throw spawnError;
         }
@@ -295,6 +400,23 @@ class AgentSpawnerRuntime {
       this.logger.info(
         `Spawned sub-agent '${spawnedAgentId}' for task: ${input.task}${autoApprove ? " (auto-approve)" : ""}${llmMode === "parent" ? " (using parent LLM)" : ""}`
       );
+      const subAgentLogFilePath = this.getSubAgentLogFilePath(
+        sessionId ? { runtimeAgentId: buildOptions.runtimeAgentId, sessionId } : { runtimeAgentId: buildOptions.runtimeAgentId }
+      );
+      if (subAgentLogFilePath) {
+        this.logger.info(`Sub-agent logs: ${subAgentLogFilePath}`);
+      }
+      if (sessionId) {
+        const parentSession = await this.parentAgent.getSession(sessionId);
+        if (parentSession) {
+          parentSession.logger.info("Sub-agent spawned", {
+            runtimeAgentId: spawnedAgentId,
+            registryAgentId: input.agentId ?? "default",
+            task: input.task,
+            ...subAgentLogFilePath ? { subAgentLogFilePath } : {}
+          });
+        }
+      }
       cleanupProgressTracking = this.setupProgressTracking(
         handle,
         input,
@@ -328,6 +450,7 @@ class AgentSpawnerRuntime {
           buildOptions.inheritLlm = true;
           subAgentConfig = await this.buildSubAgentConfig(buildOptions, sessionId);
           handle = await this.runtime.spawnAgent({
+            agentId: buildOptions.runtimeAgentId,
             agentConfig: subAgentConfig,
             ephemeral: true,
             group: this.parentId,
@@ -344,6 +467,7 @@ class AgentSpawnerRuntime {
                 const delegatingHandler = createDelegatingApprovalHandler(
                   this.parentAgent.services.approvalManager,
                   agent.config.agentId ?? "unknown",
+                  sessionId,
                   this.logger
                 );
                 agent.setApprovalHandler(delegatingHandler);
@@ -351,6 +475,7 @@ class AgentSpawnerRuntime {
             }
           });
           spawnedAgentId = handle.agentId;
+          await this.applyParentWorkspace(handle.agent);
           this.logger.info(
             `Re-spawned sub-agent '${spawnedAgentId}' for task: ${input.task} (using parent LLM)`
           );
@@ -410,13 +535,49 @@ class AgentSpawnerRuntime {
    * @param sessionId - Optional session ID to get session-specific LLM config
    */
   async buildSubAgentConfig(options, sessionId) {
-    const { agentId, inheritLlm, autoApprove } = options;
+    const { agentId, inheritLlm, autoApprove, runtimeAgentId } = options;
     const parentSettings = this.parentAgent.config;
     const currentParentLLM = this.parentAgent.getCurrentLLMConfig(sessionId);
     this.logger.debug(
       `[AgentSpawnerRuntime] Building sub-agent config with LLM: ${currentParentLLM.provider}/${currentParentLLM.model}` + (sessionId ? ` (sessionId: ${sessionId})` : " (no sessionId)")
     );
     const permissionsMode = autoApprove ? "auto-approve" : "manual";
+    const parentToolPolicies = parentSettings.permissions?.toolPolicies;
+    const mergeToolPolicies = (subAgentPolicies) => {
+      const alwaysAllow = [
+        ...parentToolPolicies?.alwaysAllow ?? [],
+        ...subAgentPolicies?.alwaysAllow ?? []
+      ];
+      const alwaysDeny = [
+        ...parentToolPolicies?.alwaysDeny ?? [],
+        ...subAgentPolicies?.alwaysDeny ?? []
+      ];
+      return {
+        alwaysAllow: Array.from(new Set(alwaysAllow)),
+        alwaysDeny: Array.from(new Set(alwaysDeny))
+      };
+    };
+    const inheritedLoggerConfig = await (async () => {
+      if (!sessionId) {
+        return void 0;
+      }
+      const session = await this.parentAgent.getSession(sessionId);
+      if (!session) {
+        return void 0;
+      }
+      const parentSessionLogPath = session.logger.getLogFilePath();
+      if (!parentSessionLogPath) {
+        return void 0;
+      }
+      const subAgentLogFilePath = this.getSubAgentLogFilePath({ runtimeAgentId, sessionId });
+      if (!subAgentLogFilePath) {
+        return void 0;
+      }
+      return {
+        level: session.logger.getLevel(),
+        transports: [{ type: "file", path: subAgentLogFilePath }]
+      };
+    })();
     if (agentId) {
       let configPath = null;
       try {
@@ -454,18 +615,16 @@ class AgentSpawnerRuntime {
           this.logger.debug(`Sub-agent LLM resolution: ${resolution.reason}`);
           llmConfig = resolution.llm;
         }
+        llmConfig = this.applySubAgentLlmPolicy(llmConfig);
         return {
           ...loadedConfig,
           llm: llmConfig,
           permissions: {
             ...loadedConfig.permissions,
-            mode: permissionsMode
+            mode: permissionsMode,
+            toolPolicies: mergeToolPolicies(loadedConfig.permissions?.toolPolicies)
           },
-          // Suppress sub-agent console logs entirely using silent transport
-          logger: {
-            level: "error",
-            transports: [{ type: "silent" }]
-          }
+          ...inheritedLoggerConfig !== void 0 && { logger: inheritedLoggerConfig }
         };
       }
       this.logger.warn(
@@ -473,19 +632,16 @@ class AgentSpawnerRuntime {
       );
     }
     const config = {
-      llm: { ...currentParentLLM },
+      llm: this.applySubAgentLlmPolicy({ ...currentParentLLM }),
       // Default system prompt for sub-agents
       systemPrompt: "You are a helpful sub-agent. Complete the task given to you efficiently and concisely.",
       permissions: {
-        mode: permissionsMode
+        mode: permissionsMode,
+        toolPolicies: mergeToolPolicies(void 0)
       },
       // Inherit MCP servers from parent so subagent has tool access
       mcpServers: parentSettings.mcpServers ? { ...parentSettings.mcpServers } : {},
-      // Suppress sub-agent console logs entirely using silent transport
-      logger: {
-        level: "error",
-        transports: [{ type: "silent" }]
-      }
+      ...inheritedLoggerConfig !== void 0 && { logger: inheritedLoggerConfig }
     };
     return config;
   }

package/dist/tool-factories/agent-spawner/schemas.cjs

@@ -19,17 +19,27 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var schemas_exports = {};
 __export(schemas_exports, {
   AgentSpawnerConfigSchema: () => AgentSpawnerConfigSchema,
+  DEFAULT_SUB_AGENT_MAX_ITERATIONS: () => DEFAULT_SUB_AGENT_MAX_ITERATIONS,
+  DEFAULT_SUB_AGENT_REASONING_VARIANT: () => DEFAULT_SUB_AGENT_REASONING_VARIANT,
   SpawnAgentInputSchema: () => SpawnAgentInputSchema
 });
 module.exports = __toCommonJS(schemas_exports);
 var import_zod = require("zod");
+const DEFAULT_SUB_AGENT_MAX_ITERATIONS = 100;
+const DEFAULT_SUB_AGENT_REASONING_VARIANT = "disabled";
 const AgentSpawnerConfigSchema = import_zod.z.object({
   /** Type discriminator for the factory */
   type: import_zod.z.literal("agent-spawner"),
   /** Maximum concurrent sub-agents this parent can spawn (default: 5) */
   maxConcurrentAgents: import_zod.z.number().int().positive().default(5).describe("Maximum concurrent sub-agents"),
-  /** Default timeout for task execution in milliseconds (default: 300000 = 5 min) */
-  defaultTimeout: import_zod.z.number().int().positive().default(3e5).describe("Default task timeout in milliseconds"),
+  /** Default timeout for task execution in milliseconds (default: 3600000 = 1 hour) */
+  defaultTimeout: import_zod.z.number().int().nonnegative().default(36e5).describe("Default task timeout in milliseconds (0 = no timeout)"),
+  subAgentMaxIterations: import_zod.z.number().int().positive().default(DEFAULT_SUB_AGENT_MAX_ITERATIONS).describe(
+    "Max outer-loop tool-call iterations for spawned sub-agents. Acts as a safety cap to prevent runaway exploration."
+  ),
+  subAgentReasoningVariant: import_zod.z.string().trim().min(1).default(DEFAULT_SUB_AGENT_REASONING_VARIANT).describe(
+    "Preferred reasoning variant for spawned sub-agents. Default is 'disabled'. If unsupported by the resolved model, Dexto falls back to the lowest available variant."
+  ),
   /** Whether spawning is enabled (default: true) */
   allowSpawning: import_zod.z.boolean().default(true).describe("Whether agent spawning is enabled"),
   /**
@@ -69,5 +79,7 @@ const SpawnAgentInputSchema = import_zod.z.object({
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentSpawnerConfigSchema,
+  DEFAULT_SUB_AGENT_MAX_ITERATIONS,
+  DEFAULT_SUB_AGENT_REASONING_VARIANT,
   SpawnAgentInputSchema
 });

package/dist/tool-factories/agent-spawner/schemas.d.ts

@@ -3,7 +3,10 @@
  *
  * Zod schemas for the agent spawner tools factory configuration and inputs.
  */
+import type { ReasoningVariant } from '@dexto/core';
 import { z } from 'zod';
+export declare const DEFAULT_SUB_AGENT_MAX_ITERATIONS = 100;
+export declare const DEFAULT_SUB_AGENT_REASONING_VARIANT: ReasoningVariant;
 /**
  * Configuration schema for the agent spawner tools factory.
  */
@@ -12,8 +15,10 @@ export declare const AgentSpawnerConfigSchema: z.ZodObject<{
     type: z.ZodLiteral<"agent-spawner">;
     /** Maximum concurrent sub-agents this parent can spawn (default: 5) */
     maxConcurrentAgents: z.ZodDefault<z.ZodNumber>;
-    /** Default timeout for task execution in milliseconds (default: 300000 = 5 min) */
+    /** Default timeout for task execution in milliseconds (default: 3600000 = 1 hour) */
     defaultTimeout: z.ZodDefault<z.ZodNumber>;
+    subAgentMaxIterations: z.ZodDefault<z.ZodNumber>;
+    subAgentReasoningVariant: z.ZodDefault<z.ZodString>;
     /** Whether spawning is enabled (default: true) */
     allowSpawning: z.ZodDefault<z.ZodBoolean>;
     /**
@@ -45,6 +50,8 @@ export declare const AgentSpawnerConfigSchema: z.ZodObject<{
     type: "agent-spawner";
     maxConcurrentAgents: number;
     defaultTimeout: number;
+    subAgentMaxIterations: number;
+    subAgentReasoningVariant: string;
     allowSpawning: boolean;
     allowedAgents?: string[] | undefined;
     autoApproveAgents?: string[] | undefined;
@@ -52,6 +59,8 @@ export declare const AgentSpawnerConfigSchema: z.ZodObject<{
     type: "agent-spawner";
     maxConcurrentAgents?: number | undefined;
     defaultTimeout?: number | undefined;
+    subAgentMaxIterations?: number | undefined;
+    subAgentReasoningVariant?: string | undefined;
     allowSpawning?: boolean | undefined;
     allowedAgents?: string[] | undefined;
     autoApproveAgents?: string[] | undefined;

package/dist/tool-factories/agent-spawner/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/agent-spawner/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,wBAAwB;IAE7B,yCAAyC;;IAGzC,uEAAuE;;IAQvE,mFAAmF;;IAQnF,kDAAkD;;IAGlD;;;;;;;;;;OAUG;;IAMH;;;;;;;;;;;OAWG;;;;;;;;;;;;;;;;EAOuD,CAAC;AAEnE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM3E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;IAE1B,gDAAgD;;IAGhD,8CAA8C;;IAM9C,qFAAqF;;;;;;;;;;EAGhF,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/agent-spawner/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,mCAAmC,EAAE,gBAA6B,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,wBAAwB;IAE7B,yCAAyC;;IAGzC,uEAAuE;;IAQvE,qFAAqF;;;;IA4BrF,kDAAkD;;IAGlD;;;;;;;;;;OAUG;;IAMH;;;;;;;;;;;OAWG;;;;;;;;;;;;;;;;;;;;EAOuD,CAAC;AAEnE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM3E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;IAE1B,gDAAgD;;IAGhD,8CAA8C;;IAM9C,qFAAqF;;;;;;;;;;EAGhF,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/tool-factories/agent-spawner/schemas.js

@@ -1,11 +1,19 @@
 import { z } from "zod";
+const DEFAULT_SUB_AGENT_MAX_ITERATIONS = 100;
+const DEFAULT_SUB_AGENT_REASONING_VARIANT = "disabled";
 const AgentSpawnerConfigSchema = z.object({
   /** Type discriminator for the factory */
   type: z.literal("agent-spawner"),
   /** Maximum concurrent sub-agents this parent can spawn (default: 5) */
   maxConcurrentAgents: z.number().int().positive().default(5).describe("Maximum concurrent sub-agents"),
-  /** Default timeout for task execution in milliseconds (default: 300000 = 5 min) */
-  defaultTimeout: z.number().int().positive().default(3e5).describe("Default task timeout in milliseconds"),
+  /** Default timeout for task execution in milliseconds (default: 3600000 = 1 hour) */
+  defaultTimeout: z.number().int().nonnegative().default(36e5).describe("Default task timeout in milliseconds (0 = no timeout)"),
+  subAgentMaxIterations: z.number().int().positive().default(DEFAULT_SUB_AGENT_MAX_ITERATIONS).describe(
+    "Max outer-loop tool-call iterations for spawned sub-agents. Acts as a safety cap to prevent runaway exploration."
+  ),
+  subAgentReasoningVariant: z.string().trim().min(1).default(DEFAULT_SUB_AGENT_REASONING_VARIANT).describe(
+    "Preferred reasoning variant for spawned sub-agents. Default is 'disabled'. If unsupported by the resolved model, Dexto falls back to the lowest available variant."
+  ),
   /** Whether spawning is enabled (default: true) */
   allowSpawning: z.boolean().default(true).describe("Whether agent spawning is enabled"),
   /**
@@ -44,5 +52,7 @@ const SpawnAgentInputSchema = z.object({
 }).strict();
 export {
   AgentSpawnerConfigSchema,
+  DEFAULT_SUB_AGENT_MAX_ITERATIONS,
+  DEFAULT_SUB_AGENT_REASONING_VARIANT,
   SpawnAgentInputSchema
 };

package/dist/tool-factories/agent-spawner/spawn-agent-tool.cjs

@@ -21,6 +21,7 @@ __export(spawn_agent_tool_exports, {
   createSpawnAgentTool: () => createSpawnAgentTool
 });
 module.exports = __toCommonJS(spawn_agent_tool_exports);
+var import_core = require("@dexto/core");
 var import_schemas = require("./schemas.js");
 function buildDescription(service) {
   const availableAgents = service.getAvailableAgents();
@@ -57,9 +58,17 @@ ${agentsList}
 function createSpawnAgentTool(service) {
   return {
     id: "spawn_agent",
-    displayName: "Agent",
     aliases: ["task"],
     description: buildDescription(service),
+    presentation: {
+      describeHeader: (input) => {
+        const agentLabel = input.agentId ? input.agentId.replace(/-agent$/, "") : null;
+        const title = agentLabel ? agentLabel.charAt(0).toUpperCase() + agentLabel.slice(1) : "Agent";
+        const task = typeof input.task === "string" ? input.task : "";
+        const argsText = task ? (0, import_core.truncateForHeader)(task, 120) : void 0;
+        return (0, import_core.createLocalToolCallHeader)({ title, ...argsText ? { argsText } : {} });
+      }
+    },
     inputSchema: import_schemas.SpawnAgentInputSchema,
     execute: async (input, context) => {
       const options = {

package/dist/tool-factories/agent-spawner/spawn-agent-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn-agent-tool.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/agent-spawner/spawn-agent-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA4CxD,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,mBAAmB,GAC7B,IAAI,CAAC,OAAO,qBAAqB,CAAC,CA0CpC"}
+{"version":3,"file":"spawn-agent-tool.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/agent-spawner/spawn-agent-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA4CxD,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,mBAAmB,GAC7B,IAAI,CAAC,OAAO,qBAAqB,CAAC,CAuDpC"}

package/dist/tool-factories/agent-spawner/spawn-agent-tool.js

@@ -1,3 +1,4 @@
+import { createLocalToolCallHeader, truncateForHeader } from "@dexto/core";
 import { SpawnAgentInputSchema } from "./schemas.js";
 function buildDescription(service) {
   const availableAgents = service.getAvailableAgents();
@@ -34,9 +35,17 @@ ${agentsList}
 function createSpawnAgentTool(service) {
   return {
     id: "spawn_agent",
-    displayName: "Agent",
     aliases: ["task"],
     description: buildDescription(service),
+    presentation: {
+      describeHeader: (input) => {
+        const agentLabel = input.agentId ? input.agentId.replace(/-agent$/, "") : null;
+        const title = agentLabel ? agentLabel.charAt(0).toUpperCase() + agentLabel.slice(1) : "Agent";
+        const task = typeof input.task === "string" ? input.task : "";
+        const argsText = task ? truncateForHeader(task, 120) : void 0;
+        return createLocalToolCallHeader({ title, ...argsText ? { argsText } : {} });
+      }
+    },
     inputSchema: SpawnAgentInputSchema,
     execute: async (input, context) => {
       const options = {