@dexto/agent-management 1.6.0 → 1.6.1

package/dist/runtime/types.d.ts

@@ -78,7 +78,7 @@ export interface TaskResult {
 export interface AgentRuntimeConfig {
     /** Maximum total agents managed by this runtime (default: 20) */
     maxAgents?: number;
-    /** Default task timeout in milliseconds (default: 300000 = 5 min) */
+    /** Default task timeout in milliseconds (default: 300000 = 5 min, 0 = no timeout) */
     defaultTaskTimeout?: number;
 }
 /**

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");
@@ -187,6 +188,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 +200,8 @@ class AgentSpawnerRuntime {
         data: {
           task: input.task,
           agentId: input.agentId ?? "default",
+          runtimeAgentId: subAgentHandle.agentId,
+          ...subAgentLogFilePath ? { subAgentLogFilePath } : {},
           toolsCalled: toolCount,
           currentTool: tool,
           currentArgs: args,
@@ -234,6 +241,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 +300,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 +314,7 @@ class AgentSpawnerRuntime {
       let handle;
       try {
         handle = await this.runtime.spawnAgent({
+          agentId: buildOptions.runtimeAgentId,
           agentConfig: subAgentConfig,
           ephemeral: true,
           group: this.parentId,
@@ -280,6 +329,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 +337,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 +349,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 +366,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 +374,7 @@ class AgentSpawnerRuntime {
             }
           });
           spawnedAgentId = handle.agentId;
+          await this.applyParentWorkspace(handle.agent);
         } else {
           throw spawnError;
         }
@@ -328,6 +382,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 +432,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 +449,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 +457,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 +517,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 {
@@ -492,13 +602,10 @@ class AgentSpawnerRuntime {
           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(
@@ -510,15 +617,12 @@ class AgentSpawnerRuntime {
       // 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

@@ -85,6 +85,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;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;IA+G7B;;OAEG;YACW,oBAAoB;IA2BlC,OAAO,CAAC,sBAAsB;IAuB9B;;OAEG;IACH,OAAO,CAAC,UAAU;IAsBlB;;OAEG;YACW,oBAAoB;IA4RlC;;;;;;;OAOG;YACW,mBAAmB;IAiKjC;;;OAGG;IACH,kBAAkB,IAAI,kBAAkB,EAAE;IA6B1C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAIjC"}