@dexto/agent-management 1.6.0 → 1.6.2

package/dist/runtime/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,0DAA0D;IAC1D,WAAW,EAAE,WAAW,CAAC;IAEzB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,KAAK,EAAE,UAAU,CAAC;IAElB,kCAAkC;IAClC,MAAM,EAAE,WAAW,CAAC;IAEpB,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;IAEnB,kCAAkC;IAClC,SAAS,EAAE,IAAI,CAAC;IAEhB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAElB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IAEjB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,UAAU,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uBAAuB;IACvB,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IAErC,+BAA+B;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,0DAA0D;IAC1D,WAAW,EAAE,WAAW,CAAC;IAEzB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,KAAK,EAAE,UAAU,CAAC;IAElB,kCAAkC;IAClC,MAAM,EAAE,WAAW,CAAC;IAEpB,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;IAEnB,kCAAkC;IAClC,SAAS,EAAE,IAAI,CAAC;IAEhB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAElB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IAEjB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,UAAU,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uBAAuB;IACvB,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IAErC,+BAA+B;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB"}

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

@@ -22,16 +22,17 @@ __export(factory_exports, {
 });
 module.exports = __toCommonJS(factory_exports);
 var import_core = require("@dexto/core");
+var import_core2 = require("@dexto/core");
 var import_orchestration = require("@dexto/orchestration");
 var import_schemas = require("./schemas.js");
 var import_runtime = require("./runtime.js");
 var import_spawn_agent_tool = require("./spawn-agent-tool.js");
 function requireAgentContext(context) {
   if (!context.agent) {
-    throw import_core.ToolError.configInvalid("agent-spawner tools require ToolExecutionContext.agent");
+    throw import_core2.ToolError.configInvalid("agent-spawner tools require ToolExecutionContext.agent");
   }
   if (!context.services) {
-    throw import_core.ToolError.configInvalid("agent-spawner tools require ToolExecutionContext.services");
+    throw import_core2.ToolError.configInvalid("agent-spawner tools require ToolExecutionContext.services");
   }
   return { agent: context.agent, logger: context.logger, toolServices: context.services };
 }
@@ -227,58 +228,94 @@ const agentSpawnerToolsFactory = {
     return [
       {
         id: "spawn_agent",
-        displayName: "Agent",
         description: "Spawn a sub-agent to handle a task and return its result.",
         inputSchema: import_schemas.SpawnAgentInputSchema,
         execute: (input, context) => ensureToolsInitialized(context).spawnAgent.execute(input, context),
-        generatePreview: async (input, context) => {
-          const tool = ensureToolsInitialized(context).spawnAgent;
-          if (!tool.generatePreview) {
-            return null;
+        presentation: {
+          describeHeader: (input) => {
+            const agentId = typeof input.agentId === "string" ? input.agentId : void 0;
+            const agentLabel = agentId ? agentId.replace(/-agent$/, "") : void 0;
+            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 } : {}
+            });
+          },
+          preview: async (input, context) => {
+            const tool = ensureToolsInitialized(context).spawnAgent;
+            const previewFn = tool.presentation?.preview;
+            if (!previewFn) {
+              return null;
+            }
+            return await previewFn(input, context);
           }
-          return await tool.generatePreview(input, context);
         }
       },
       {
         id: "wait_for",
-        displayName: "Wait",
         description: "Wait for background task(s) to complete.",
         inputSchema: import_orchestration.WaitForInputSchema,
         execute: (input, context) => ensureToolsInitialized(context).waitFor.execute(input, context),
-        generatePreview: async (input, context) => {
-          const tool = ensureToolsInitialized(context).waitFor;
-          if (!tool.generatePreview) {
-            return null;
+        presentation: {
+          describeHeader: (input) => {
+            const argsText = input.taskId ? (0, import_core.truncateForHeader)(input.taskId, 80) : input.taskIds && input.taskIds.length > 0 ? (0, import_core.truncateForHeader)(`${input.taskIds.length} tasks`, 80) : void 0;
+            return (0, import_core.createLocalToolCallHeader)({
+              title: "Wait",
+              ...argsText ? { argsText } : {}
+            });
+          },
+          preview: async (input, context) => {
+            const tool = ensureToolsInitialized(context).waitFor;
+            const previewFn = tool.presentation?.preview;
+            if (!previewFn) {
+              return null;
+            }
+            return await previewFn(input, context);
           }
-          return await tool.generatePreview(input, context);
         }
       },
       {
         id: "check_task",
-        displayName: "Check Task",
         description: "Check the status of a background task.",
         inputSchema: import_orchestration.CheckTaskInputSchema,
         execute: (input, context) => ensureToolsInitialized(context).checkTask.execute(input, context),
-        generatePreview: async (input, context) => {
-          const tool = ensureToolsInitialized(context).checkTask;
-          if (!tool.generatePreview) {
-            return null;
+        presentation: {
+          describeHeader: (input) => {
+            const argsText = (0, import_core.truncateForHeader)(input.taskId, 80);
+            return (0, import_core.createLocalToolCallHeader)({
+              title: "Check Task",
+              ...argsText ? { argsText } : {}
+            });
+          },
+          preview: async (input, context) => {
+            const tool = ensureToolsInitialized(context).checkTask;
+            const previewFn = tool.presentation?.preview;
+            if (!previewFn) {
+              return null;
+            }
+            return await previewFn(input, context);
           }
-          return await tool.generatePreview(input, context);
         }
       },
       {
         id: "list_tasks",
-        displayName: "List Tasks",
         description: "List background tasks and their statuses.",
         inputSchema: import_orchestration.ListTasksInputSchema,
         execute: (input, context) => ensureToolsInitialized(context).listTasks.execute(input, context),
-        generatePreview: async (input, context) => {
-          const tool = ensureToolsInitialized(context).listTasks;
-          if (!tool.generatePreview) {
-            return null;
+        presentation: {
+          describeHeader: () => (0, import_core.createLocalToolCallHeader)({
+            title: "List Tasks"
+          }),
+          preview: async (input, context) => {
+            const tool = ensureToolsInitialized(context).listTasks;
+            const previewFn = tool.presentation?.preview;
+            if (!previewFn) {
+              return null;
+            }
+            return await previewFn(input, context);
           }
-          return await tool.generatePreview(input, context);
         }
       }
     ];

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/agent-spawner/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAevD,OAAO,EAGH,KAAK,kBAAkB,EAC1B,MAAM,cAAc,CAAC;AAkCtB,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,kBAAkB,CA8SpE,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/agent-spawner/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAiBvD,OAAO,EAGH,KAAK,kBAAkB,EAC1B,MAAM,cAAc,CAAC;AAqCtB,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,kBAAkB,CA8VpE,CAAC"}

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

@@ -1,3 +1,4 @@
+import { createLocalToolCallHeader, truncateForHeader } from "@dexto/core";
 import { ToolError } from "@dexto/core";
 import {
   ConditionEngine,
@@ -217,58 +218,94 @@ const agentSpawnerToolsFactory = {
     return [
       {
         id: "spawn_agent",
-        displayName: "Agent",
         description: "Spawn a sub-agent to handle a task and return its result.",
         inputSchema: SpawnAgentInputSchema,
         execute: (input, context) => ensureToolsInitialized(context).spawnAgent.execute(input, context),
-        generatePreview: async (input, context) => {
-          const tool = ensureToolsInitialized(context).spawnAgent;
-          if (!tool.generatePreview) {
-            return null;
+        presentation: {
+          describeHeader: (input) => {
+            const agentId = typeof input.agentId === "string" ? input.agentId : void 0;
+            const agentLabel = agentId ? agentId.replace(/-agent$/, "") : void 0;
+            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 } : {}
+            });
+          },
+          preview: async (input, context) => {
+            const tool = ensureToolsInitialized(context).spawnAgent;
+            const previewFn = tool.presentation?.preview;
+            if (!previewFn) {
+              return null;
+            }
+            return await previewFn(input, context);
           }
-          return await tool.generatePreview(input, context);
         }
       },
       {
         id: "wait_for",
-        displayName: "Wait",
         description: "Wait for background task(s) to complete.",
         inputSchema: WaitForInputSchema,
         execute: (input, context) => ensureToolsInitialized(context).waitFor.execute(input, context),
-        generatePreview: async (input, context) => {
-          const tool = ensureToolsInitialized(context).waitFor;
-          if (!tool.generatePreview) {
-            return null;
+        presentation: {
+          describeHeader: (input) => {
+            const argsText = input.taskId ? truncateForHeader(input.taskId, 80) : input.taskIds && input.taskIds.length > 0 ? truncateForHeader(`${input.taskIds.length} tasks`, 80) : void 0;
+            return createLocalToolCallHeader({
+              title: "Wait",
+              ...argsText ? { argsText } : {}
+            });
+          },
+          preview: async (input, context) => {
+            const tool = ensureToolsInitialized(context).waitFor;
+            const previewFn = tool.presentation?.preview;
+            if (!previewFn) {
+              return null;
+            }
+            return await previewFn(input, context);
           }
-          return await tool.generatePreview(input, context);
         }
       },
       {
         id: "check_task",
-        displayName: "Check Task",
         description: "Check the status of a background task.",
         inputSchema: CheckTaskInputSchema,
         execute: (input, context) => ensureToolsInitialized(context).checkTask.execute(input, context),
-        generatePreview: async (input, context) => {
-          const tool = ensureToolsInitialized(context).checkTask;
-          if (!tool.generatePreview) {
-            return null;
+        presentation: {
+          describeHeader: (input) => {
+            const argsText = truncateForHeader(input.taskId, 80);
+            return createLocalToolCallHeader({
+              title: "Check Task",
+              ...argsText ? { argsText } : {}
+            });
+          },
+          preview: async (input, context) => {
+            const tool = ensureToolsInitialized(context).checkTask;
+            const previewFn = tool.presentation?.preview;
+            if (!previewFn) {
+              return null;
+            }
+            return await previewFn(input, context);
           }
-          return await tool.generatePreview(input, context);
         }
       },
       {
         id: "list_tasks",
-        displayName: "List Tasks",
         description: "List background tasks and their statuses.",
         inputSchema: ListTasksInputSchema,
         execute: (input, context) => ensureToolsInitialized(context).listTasks.execute(input, context),
-        generatePreview: async (input, context) => {
-          const tool = ensureToolsInitialized(context).listTasks;
-          if (!tool.generatePreview) {
-            return null;
+        presentation: {
+          describeHeader: () => createLocalToolCallHeader({
+            title: "List Tasks"
+          }),
+          preview: async (input, context) => {
+            const tool = ensureToolsInitialized(context).listTasks;
+            const previewFn = tool.presentation?.preview;
+            if (!previewFn) {
+              return null;
+            }
+            return await previewFn(input, context);
           }
-          return await tool.generatePreview(input, context);
         }
       }
     ];

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

@@ -31,6 +31,7 @@ __export(runtime_exports, {
   AgentSpawnerRuntime: () => AgentSpawnerRuntime
 });
 module.exports = __toCommonJS(runtime_exports);
+var import_crypto = require("crypto");
 var import_core = require("@dexto/core");
 var import_AgentRuntime = require("../../runtime/AgentRuntime.js");
 var import_approval_delegation = require("../../runtime/approval-delegation.js");
@@ -40,12 +41,58 @@ var import_types = require("../../registry/types.js");
 var import_path = require("../../utils/path.js");
 var path = __toESM(require("path"), 1);
 var import_llm_resolution = require("./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 = (0, import_core.getReasoningProfile)(provider, model);
+    if (!profile.capable || profile.supportedVariants.length === 0) {
+      return void 0;
+    }
+    if ((0, import_core.supportsReasoningVariant)(profile, preferredVariant)) {
+      return preferredVariant;
+    }
+    for (const variant of REASONING_VARIANT_FALLBACK_ORDER) {
+      if ((0, import_core.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));
@@ -187,6 +234,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",
@@ -195,6 +246,8 @@ class AgentSpawnerRuntime {
         data: {
           task: input.task,
           agentId: input.agentId ?? "default",
+          runtimeAgentId: subAgentHandle.agentId,
+          ...subAgentLogFilePath ? { subAgentLogFilePath } : {},
           toolsCalled: toolCount,
           currentTool: tool,
           currentArgs: args,
@@ -234,6 +287,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 (0, import_path.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.)
    */
@@ -255,7 +346,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-${(0, import_crypto.randomUUID)().slice(0, 8)}`
+      };
       if (input.agentId !== void 0) {
         buildOptions.agentId = input.agentId;
       }
@@ -266,6 +360,7 @@ class AgentSpawnerRuntime {
       let handle;
       try {
         handle = await this.runtime.spawnAgent({
+          agentId: buildOptions.runtimeAgentId,
           agentConfig: subAgentConfig,
           ephemeral: true,
           group: this.parentId,
@@ -280,6 +375,7 @@ class AgentSpawnerRuntime {
               const delegatingHandler = (0, import_approval_delegation.createDelegatingApprovalHandler)(
                 this.parentAgent.services.approvalManager,
                 agent.config.agentId ?? "unknown",
+                sessionId,
                 this.logger
               );
               agent.setApprovalHandler(delegatingHandler);
@@ -287,6 +383,7 @@ class AgentSpawnerRuntime {
           }
         });
         spawnedAgentId = handle.agentId;
+        await this.applyParentWorkspace(handle.agent);
       } catch (spawnError) {
         const isLlmError = this.isLLMError(spawnError);
         if (isLlmError && input.agentId && llmMode === "subagent") {
@@ -298,6 +395,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,
@@ -314,6 +412,7 @@ class AgentSpawnerRuntime {
                 const delegatingHandler = (0, import_approval_delegation.createDelegatingApprovalHandler)(
                   this.parentAgent.services.approvalManager,
                   agent.config.agentId ?? "unknown",
+                  sessionId,
                   this.logger
                 );
                 agent.setApprovalHandler(delegatingHandler);
@@ -321,6 +420,7 @@ class AgentSpawnerRuntime {
             }
           });
           spawnedAgentId = handle.agentId;
+          await this.applyParentWorkspace(handle.agent);
         } else {
           throw spawnError;
         }
@@ -328,6 +428,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,
@@ -361,6 +478,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,
@@ -377,6 +495,7 @@ class AgentSpawnerRuntime {
                 const delegatingHandler = (0, import_approval_delegation.createDelegatingApprovalHandler)(
                   this.parentAgent.services.approvalManager,
                   agent.config.agentId ?? "unknown",
+                  sessionId,
                   this.logger
                 );
                 agent.setApprovalHandler(delegatingHandler);
@@ -384,6 +503,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)`
           );
@@ -443,13 +563,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 {
@@ -487,18 +643,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(
@@ -506,19 +660,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/runtime.d.ts

@@ -12,7 +12,7 @@
  */
 import type { DextoAgent, Logger, TaskForker } from '@dexto/core';
 import type { AgentRegistryEntry } from '../../registry/types.js';
-import type { AgentSpawnerConfig } from './schemas.js';
+import { type AgentSpawnerConfig } from './schemas.js';
 import type { SpawnAgentOutput } from './types.js';
 export declare class AgentSpawnerRuntime implements TaskForker {
     private runtime;
@@ -20,6 +20,8 @@ export declare class AgentSpawnerRuntime implements TaskForker {
     private parentAgent;
     private config;
     private logger;
+    private selectLowestReasoningVariant;
+    private applySubAgentLlmPolicy;
     private resolveBundledAgentConfig;
     private createFallbackRegistryEntry;
     constructor(parentAgent: DextoAgent, config: AgentSpawnerConfig, logger: Logger);
@@ -85,6 +87,11 @@ export declare class AgentSpawnerRuntime implements TaskForker {
      * @returns Cleanup function to unsubscribe from events
      */
     private setupProgressTracking;
+    /**
+     * Ensure spawned agent inherits the parent's workspace context.
+     */
+    private applyParentWorkspace;
+    private getSubAgentLogFilePath;
     /**
      * Check if an error is LLM-related (API errors, credit issues, model not found, etc.)
      */

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

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/agent-spawner/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMlE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,qBAAa,mBAAoB,YAAW,UAAU;IAClD,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,yBAAyB;IAyBjC,OAAO,CAAC,2BAA2B;gBAYvB,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM;IAuB/E;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;;;;;;;;;;;;;OAcG;IACG,eAAe,CAAC,KAAK,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8C7B;;;;;;;;;;OAUG;IACG,IAAI,CAAC,OAAO,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAIpE;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAwG7B;;OAEG;IACH,OAAO,CAAC,UAAU;IAsBlB;;OAEG;YACW,oBAAoB;IAyPlC;;;;;;;OAOG;YACW,mBAAmB;IAmHjC;;;OAGG;IACH,kBAAkB,IAAI,kBAAkB,EAAE;IA6B1C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAIjC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/agent-spawner/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWlE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAenD,qBAAa,mBAAoB,YAAW,UAAU;IAClD,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,4BAA4B;IAuBpC,OAAO,CAAC,sBAAsB;IA8B9B,OAAO,CAAC,yBAAyB;IAyBjC,OAAO,CAAC,2BAA2B;gBAYvB,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM;IAuB/E;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;;;;;;;;;;;;;OAcG;IACG,eAAe,CAAC,KAAK,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8C7B;;;;;;;;;;OAUG;IACG,IAAI,CAAC,OAAO,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAIpE;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IA+G7B;;OAEG;YACW,oBAAoB;IA2BlC,OAAO,CAAC,sBAAsB;IAuB9B;;OAEG;IACH,OAAO,CAAC,UAAU;IAsBlB;;OAEG;YACW,oBAAoB;IA4RlC;;;;;;;OAOG;YACW,mBAAmB;IAmKjC;;;OAGG;IACH,kBAAkB,IAAI,kBAAkB,EAAE;IA6B1C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAIjC"}