@dexto/agent-management 1.5.8 → 1.6.1

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,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE3D;;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-provider → tool-factories/agent-spawner}/error-codes.d.ts

@@ -1,5 +1,5 @@
 /**
- * Agent Spawner Tool Error Codes
+ * Agent Spawner Tools Factory Error Codes
  */
 export declare enum AgentSpawnerErrorCode {
     SPAWNING_DISABLED = "agent_spawner_spawning_disabled",

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/agent-spawner/error-codes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,qBAAqB;IAE7B,iBAAiB,oCAAoC;IACrD,YAAY,+BAA+B;IAG3C,eAAe,kCAAkC;IAGjD,WAAW,8BAA8B;IAGzC,cAAc,iCAAiC;CAClD"}

package/dist/{tool-provider → tool-factories/agent-spawner}/errors.d.ts

@@ -1,6 +1,6 @@
 import { DextoRuntimeError } from '@dexto/core';
 /**
- * Agent Spawner error factory methods
+ * Agent Spawner tools factory error methods
  */
 export declare class AgentSpawnerError {
     static spawningDisabled(): DextoRuntimeError<{}>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/tool-factories/agent-spawner/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAyB,MAAM,aAAa,CAAC;AAGvE;;GAEG;AACH,qBAAa,iBAAiB;IAC1B,MAAM,CAAC,gBAAgB;IAWvB,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM;;;IAWhC,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM;;;IAWpC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAWhD,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM;CAUvC"}

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

@@ -0,0 +1,327 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var factory_exports = {};
+__export(factory_exports, {
+  agentSpawnerToolsFactory: () => agentSpawnerToolsFactory
+});
+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_core2.ToolError.configInvalid("agent-spawner tools require ToolExecutionContext.agent");
+  }
+  if (!context.services) {
+    throw import_core2.ToolError.configInvalid("agent-spawner tools require ToolExecutionContext.services");
+  }
+  return { agent: context.agent, logger: context.logger, toolServices: context.services };
+}
+const agentSpawnerToolsFactory = {
+  configSchema: import_schemas.AgentSpawnerConfigSchema,
+  metadata: {
+    displayName: "Agent Spawner",
+    description: "Spawn sub-agents for task delegation",
+    category: "agents"
+  },
+  create: (config) => {
+    let state;
+    const attachTaskForker = (options) => {
+      const { toolServices, taskForker, logger } = options;
+      if (toolServices.taskForker !== taskForker) {
+        toolServices.taskForker = taskForker;
+        logger.debug(
+          "AgentSpawnerRuntime attached as taskForker for context:fork skill support"
+        );
+      }
+    };
+    const ensureToolsInitialized = (context) => {
+      const { agent, logger, toolServices } = requireAgentContext(context);
+      if (state && state.agent === agent && !state.abortController.signal.aborted) {
+        attachTaskForker({ toolServices, taskForker: state.runtime, logger });
+        return state.tools;
+      }
+      if (state && !state.abortController.signal.aborted) {
+        state.abortController.abort();
+      }
+      if (state) {
+        state.runtime.cleanup().catch(() => void 0);
+      }
+      state = void 0;
+      const signalBus = new import_orchestration.SignalBus();
+      const taskRegistry = new import_orchestration.TaskRegistry(signalBus);
+      const conditionEngine = new import_orchestration.ConditionEngine(taskRegistry, signalBus, logger);
+      const spawnerRuntime = new import_runtime.AgentSpawnerRuntime(agent, config, logger);
+      attachTaskForker({ toolServices, taskForker: spawnerRuntime, logger });
+      const taskSessions = /* @__PURE__ */ new Map();
+      const emitTasksUpdate = (sessionId) => {
+        const tasks = taskRegistry.list({
+          status: ["running", "completed", "failed", "cancelled"]
+        });
+        const scopedTasks = sessionId ? tasks.filter((task) => taskSessions.get(task.taskId) === sessionId) : tasks;
+        const runningCount = scopedTasks.filter((task) => task.status === "running").length;
+        agent.emit("service:event", {
+          service: "orchestration",
+          event: "tasks-updated",
+          sessionId: sessionId ?? "",
+          data: {
+            runningCount,
+            tasks: scopedTasks.map((task) => ({
+              taskId: task.taskId,
+              status: task.status,
+              ...task.description !== void 0 && {
+                description: task.description
+              }
+            }))
+          }
+        });
+      };
+      const triggerBackgroundCompletion = (taskId, sessionId) => {
+        if (!sessionId) {
+          return;
+        }
+        agent.emit("tool:background-completed", {
+          toolCallId: taskId,
+          sessionId
+        });
+        const taskInfo = taskRegistry.getInfo(taskId);
+        const resultText = (() => {
+          if (taskInfo?.status === "failed") {
+            return taskInfo.error ?? "Unknown error.";
+          }
+          if (taskInfo?.result !== void 0) {
+            if (typeof taskInfo.result === "string") {
+              return taskInfo.result;
+            }
+            try {
+              return JSON.stringify(taskInfo.result, null, 2);
+            } catch {
+              return String(taskInfo.result ?? "<unserializable result>");
+            }
+          }
+          return "No result available.";
+        })();
+        const sanitizeCdata = (value) => value.replace(/\]\]>/g, "]]]]><![CDATA[>");
+        const safeDescription = taskInfo?.description ? sanitizeCdata(taskInfo.description) : null;
+        const safeResultText = sanitizeCdata(resultText);
+        const descriptionTag = safeDescription ? `  <description><![CDATA[${safeDescription}]]></description>
+` : "";
+        const statusTag = taskInfo?.status ? `  <status>${taskInfo.status}</status>
+` : "";
+        const content = [
+          {
+            type: "text",
+            text: `<background-task-completion>
+  <origin>task</origin>
+  <note>The following response was reported by the background task (not user input).</note>
+  <taskId>${taskId}</taskId>
+` + statusTag + descriptionTag + `  <result><![CDATA[${safeResultText}]]></result>
+</background-task-completion>`
+          }
+        ];
+        agent.isSessionBusy(sessionId).then((isBusy) => {
+          if (isBusy) {
+            agent.queueMessage(sessionId, {
+              content,
+              kind: "background"
+            }).catch(() => void 0);
+          } else {
+            agent.emit("run:invoke", {
+              sessionId,
+              content,
+              source: "external",
+              metadata: { taskId }
+            });
+            agent.generate(content, sessionId).catch(() => void 0);
+          }
+        }).catch(() => {
+        });
+      };
+      const handleBackground = (event) => {
+        const taskId = event.toolCallId;
+        if (taskRegistry.has(taskId)) {
+          return;
+        }
+        if (event.sessionId) {
+          taskSessions.set(taskId, event.sessionId);
+        }
+        try {
+          taskRegistry.register(
+            {
+              type: "generic",
+              taskId,
+              description: event.description ?? `Tool ${event.toolName}`,
+              promise: event.promise
+            },
+            {
+              ...event.timeoutMs !== void 0 && { timeout: event.timeoutMs },
+              ...event.notifyOnComplete !== void 0 && {
+                notify: event.notifyOnComplete
+              }
+            }
+          );
+        } catch (error) {
+          taskSessions.delete(taskId);
+          event.promise.catch(() => void 0);
+          logger.warn(
+            `Failed to register background task ${taskId}: ${error instanceof Error ? error.message : String(error)}`,
+            { color: "yellow" }
+          );
+          return;
+        }
+        emitTasksUpdate(event.sessionId);
+        event.promise.finally(() => {
+          taskSessions.delete(taskId);
+          emitTasksUpdate(event.sessionId);
+          triggerBackgroundCompletion(taskId, event.sessionId);
+        });
+      };
+      const abortController = new AbortController();
+      agent.on("tool:background", handleBackground, {
+        signal: abortController.signal
+      });
+      agent.on(
+        "agent:stopped",
+        () => {
+          spawnerRuntime.cleanup().catch(() => void 0);
+          abortController.abort();
+        },
+        { signal: abortController.signal }
+      );
+      const spawnAgentTool = (0, import_spawn_agent_tool.createSpawnAgentTool)(spawnerRuntime);
+      const waitForTool = (0, import_orchestration.createWaitForTool)(conditionEngine);
+      const checkTaskTool = (0, import_orchestration.createCheckTaskTool)(taskRegistry);
+      const listTasksTool = (0, import_orchestration.createListTasksTool)(taskRegistry);
+      const tools = {
+        spawnAgent: spawnAgentTool,
+        waitFor: waitForTool,
+        checkTask: checkTaskTool,
+        listTasks: listTasksTool
+      };
+      state = {
+        agent,
+        abortController,
+        runtime: spawnerRuntime,
+        tools
+      };
+      return tools;
+    };
+    return [
+      {
+        id: "spawn_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),
+        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);
+          }
+        }
+      },
+      {
+        id: "wait_for",
+        description: "Wait for background task(s) to complete.",
+        inputSchema: import_orchestration.WaitForInputSchema,
+        execute: (input, context) => ensureToolsInitialized(context).waitFor.execute(input, context),
+        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);
+          }
+        }
+      },
+      {
+        id: "check_task",
+        description: "Check the status of a background task.",
+        inputSchema: import_orchestration.CheckTaskInputSchema,
+        execute: (input, context) => ensureToolsInitialized(context).checkTask.execute(input, context),
+        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);
+          }
+        }
+      },
+      {
+        id: "list_tasks",
+        description: "List background tasks and their statuses.",
+        inputSchema: import_orchestration.ListTasksInputSchema,
+        execute: (input, context) => ensureToolsInitialized(context).listTasks.execute(input, context),
+        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);
+          }
+        }
+      }
+    ];
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  agentSpawnerToolsFactory
+});

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

@@ -0,0 +1,4 @@
+import type { ToolFactory } from '@dexto/agent-config';
+import { type AgentSpawnerConfig } from './schemas.js';
+export declare const agentSpawnerToolsFactory: ToolFactory<AgentSpawnerConfig>;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,316 @@
+import { createLocalToolCallHeader, truncateForHeader } from "@dexto/core";
+import { ToolError } from "@dexto/core";
+import {
+  ConditionEngine,
+  SignalBus,
+  TaskRegistry,
+  createCheckTaskTool,
+  createListTasksTool,
+  createWaitForTool,
+  WaitForInputSchema,
+  CheckTaskInputSchema,
+  ListTasksInputSchema
+} from "@dexto/orchestration";
+import {
+  AgentSpawnerConfigSchema,
+  SpawnAgentInputSchema
+} from "./schemas.js";
+import { AgentSpawnerRuntime } from "./runtime.js";
+import { createSpawnAgentTool } from "./spawn-agent-tool.js";
+function requireAgentContext(context) {
+  if (!context.agent) {
+    throw ToolError.configInvalid("agent-spawner tools require ToolExecutionContext.agent");
+  }
+  if (!context.services) {
+    throw ToolError.configInvalid("agent-spawner tools require ToolExecutionContext.services");
+  }
+  return { agent: context.agent, logger: context.logger, toolServices: context.services };
+}
+const agentSpawnerToolsFactory = {
+  configSchema: AgentSpawnerConfigSchema,
+  metadata: {
+    displayName: "Agent Spawner",
+    description: "Spawn sub-agents for task delegation",
+    category: "agents"
+  },
+  create: (config) => {
+    let state;
+    const attachTaskForker = (options) => {
+      const { toolServices, taskForker, logger } = options;
+      if (toolServices.taskForker !== taskForker) {
+        toolServices.taskForker = taskForker;
+        logger.debug(
+          "AgentSpawnerRuntime attached as taskForker for context:fork skill support"
+        );
+      }
+    };
+    const ensureToolsInitialized = (context) => {
+      const { agent, logger, toolServices } = requireAgentContext(context);
+      if (state && state.agent === agent && !state.abortController.signal.aborted) {
+        attachTaskForker({ toolServices, taskForker: state.runtime, logger });
+        return state.tools;
+      }
+      if (state && !state.abortController.signal.aborted) {
+        state.abortController.abort();
+      }
+      if (state) {
+        state.runtime.cleanup().catch(() => void 0);
+      }
+      state = void 0;
+      const signalBus = new SignalBus();
+      const taskRegistry = new TaskRegistry(signalBus);
+      const conditionEngine = new ConditionEngine(taskRegistry, signalBus, logger);
+      const spawnerRuntime = new AgentSpawnerRuntime(agent, config, logger);
+      attachTaskForker({ toolServices, taskForker: spawnerRuntime, logger });
+      const taskSessions = /* @__PURE__ */ new Map();
+      const emitTasksUpdate = (sessionId) => {
+        const tasks = taskRegistry.list({
+          status: ["running", "completed", "failed", "cancelled"]
+        });
+        const scopedTasks = sessionId ? tasks.filter((task) => taskSessions.get(task.taskId) === sessionId) : tasks;
+        const runningCount = scopedTasks.filter((task) => task.status === "running").length;
+        agent.emit("service:event", {
+          service: "orchestration",
+          event: "tasks-updated",
+          sessionId: sessionId ?? "",
+          data: {
+            runningCount,
+            tasks: scopedTasks.map((task) => ({
+              taskId: task.taskId,
+              status: task.status,
+              ...task.description !== void 0 && {
+                description: task.description
+              }
+            }))
+          }
+        });
+      };
+      const triggerBackgroundCompletion = (taskId, sessionId) => {
+        if (!sessionId) {
+          return;
+        }
+        agent.emit("tool:background-completed", {
+          toolCallId: taskId,
+          sessionId
+        });
+        const taskInfo = taskRegistry.getInfo(taskId);
+        const resultText = (() => {
+          if (taskInfo?.status === "failed") {
+            return taskInfo.error ?? "Unknown error.";
+          }
+          if (taskInfo?.result !== void 0) {
+            if (typeof taskInfo.result === "string") {
+              return taskInfo.result;
+            }
+            try {
+              return JSON.stringify(taskInfo.result, null, 2);
+            } catch {
+              return String(taskInfo.result ?? "<unserializable result>");
+            }
+          }
+          return "No result available.";
+        })();
+        const sanitizeCdata = (value) => value.replace(/\]\]>/g, "]]]]><![CDATA[>");
+        const safeDescription = taskInfo?.description ? sanitizeCdata(taskInfo.description) : null;
+        const safeResultText = sanitizeCdata(resultText);
+        const descriptionTag = safeDescription ? `  <description><![CDATA[${safeDescription}]]></description>
+` : "";
+        const statusTag = taskInfo?.status ? `  <status>${taskInfo.status}</status>
+` : "";
+        const content = [
+          {
+            type: "text",
+            text: `<background-task-completion>
+  <origin>task</origin>
+  <note>The following response was reported by the background task (not user input).</note>
+  <taskId>${taskId}</taskId>
+` + statusTag + descriptionTag + `  <result><![CDATA[${safeResultText}]]></result>
+</background-task-completion>`
+          }
+        ];
+        agent.isSessionBusy(sessionId).then((isBusy) => {
+          if (isBusy) {
+            agent.queueMessage(sessionId, {
+              content,
+              kind: "background"
+            }).catch(() => void 0);
+          } else {
+            agent.emit("run:invoke", {
+              sessionId,
+              content,
+              source: "external",
+              metadata: { taskId }
+            });
+            agent.generate(content, sessionId).catch(() => void 0);
+          }
+        }).catch(() => {
+        });
+      };
+      const handleBackground = (event) => {
+        const taskId = event.toolCallId;
+        if (taskRegistry.has(taskId)) {
+          return;
+        }
+        if (event.sessionId) {
+          taskSessions.set(taskId, event.sessionId);
+        }
+        try {
+          taskRegistry.register(
+            {
+              type: "generic",
+              taskId,
+              description: event.description ?? `Tool ${event.toolName}`,
+              promise: event.promise
+            },
+            {
+              ...event.timeoutMs !== void 0 && { timeout: event.timeoutMs },
+              ...event.notifyOnComplete !== void 0 && {
+                notify: event.notifyOnComplete
+              }
+            }
+          );
+        } catch (error) {
+          taskSessions.delete(taskId);
+          event.promise.catch(() => void 0);
+          logger.warn(
+            `Failed to register background task ${taskId}: ${error instanceof Error ? error.message : String(error)}`,
+            { color: "yellow" }
+          );
+          return;
+        }
+        emitTasksUpdate(event.sessionId);
+        event.promise.finally(() => {
+          taskSessions.delete(taskId);
+          emitTasksUpdate(event.sessionId);
+          triggerBackgroundCompletion(taskId, event.sessionId);
+        });
+      };
+      const abortController = new AbortController();
+      agent.on("tool:background", handleBackground, {
+        signal: abortController.signal
+      });
+      agent.on(
+        "agent:stopped",
+        () => {
+          spawnerRuntime.cleanup().catch(() => void 0);
+          abortController.abort();
+        },
+        { signal: abortController.signal }
+      );
+      const spawnAgentTool = createSpawnAgentTool(spawnerRuntime);
+      const waitForTool = createWaitForTool(conditionEngine);
+      const checkTaskTool = createCheckTaskTool(taskRegistry);
+      const listTasksTool = createListTasksTool(taskRegistry);
+      const tools = {
+        spawnAgent: spawnAgentTool,
+        waitFor: waitForTool,
+        checkTask: checkTaskTool,
+        listTasks: listTasksTool
+      };
+      state = {
+        agent,
+        abortController,
+        runtime: spawnerRuntime,
+        tools
+      };
+      return tools;
+    };
+    return [
+      {
+        id: "spawn_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),
+        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);
+          }
+        }
+      },
+      {
+        id: "wait_for",
+        description: "Wait for background task(s) to complete.",
+        inputSchema: WaitForInputSchema,
+        execute: (input, context) => ensureToolsInitialized(context).waitFor.execute(input, context),
+        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);
+          }
+        }
+      },
+      {
+        id: "check_task",
+        description: "Check the status of a background task.",
+        inputSchema: CheckTaskInputSchema,
+        execute: (input, context) => ensureToolsInitialized(context).checkTask.execute(input, context),
+        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);
+          }
+        }
+      },
+      {
+        id: "list_tasks",
+        description: "List background tasks and their statuses.",
+        inputSchema: ListTasksInputSchema,
+        execute: (input, context) => ensureToolsInitialized(context).listTasks.execute(input, context),
+        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);
+          }
+        }
+      }
+    ];
+  }
+};
+export {
+  agentSpawnerToolsFactory
+};