@dexto/agent-management 1.5.1 → 1.5.3

package/dist/tool-provider/spawn-agent-tool.js

@@ -0,0 +1,65 @@
+import { SpawnAgentInputSchema } from "./schemas.js";
+function buildDescription(service) {
+  const availableAgents = service.getAvailableAgents();
+  if (availableAgents.length === 0) {
+    return `Spawn a sub-agent to handle a specific task. The sub-agent executes the task and returns the result.
+
+No specialized agents are configured. The sub-agent will inherit your LLM with a minimal config.
+
+## Parameters
+- **task**: Short description for UI/logs (e.g., "Search for authentication code")
+- **instructions**: Detailed instructions for the sub-agent`;
+  }
+  const agentsList = availableAgents.map((agent) => {
+    const tags = agent.tags?.length ? ` [${agent.tags.slice(0, 3).join(", ")}]` : "";
+    return `### ${agent.id}
+${agent.description}${tags}`;
+  }).join("\n\n");
+  return `Spawn a specialized sub-agent to handle a task. The sub-agent executes independently and returns the result.
+
+## Available Agents
+
+${agentsList}
+
+## Parameters
+- **task**: Short description for UI/logs (e.g., "Explore authentication flow")
+- **instructions**: Detailed instructions sent to the sub-agent
+- **agentId**: Agent ID from the list above (e.g., "${availableAgents[0]?.id ?? "explore-agent"}")
+
+## Notes
+- Sub-agents have their own tools, LLM, and conversation context
+- Read-only agents (like explore-agent) have auto-approved tool calls for speed
+- If a sub-agent's LLM fails, it automatically falls back to your LLM`;
+}
+function createSpawnAgentTool(service) {
+  return {
+    id: "spawn_agent",
+    description: buildDescription(service),
+    inputSchema: SpawnAgentInputSchema,
+    execute: async (input, context) => {
+      const validatedInput = input;
+      const options = {
+        task: validatedInput.task,
+        instructions: validatedInput.instructions
+      };
+      if (validatedInput.agentId !== void 0) {
+        options.agentId = validatedInput.agentId;
+      }
+      if (context?.toolCallId !== void 0) {
+        options.toolCallId = context.toolCallId;
+      }
+      if (context?.sessionId !== void 0) {
+        options.sessionId = context.sessionId;
+      }
+      const result = await service.spawnAndExecute(options);
+      if (result.success) {
+        return result.response ?? "Task completed successfully.";
+      } else {
+        return `Error: ${result.error ?? "Unknown error"}`;
+      }
+    }
+  };
+}
+export {
+  createSpawnAgentTool
+};

package/dist/tool-provider/tool-provider.cjs

@@ -0,0 +1,44 @@
+"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 tool_provider_exports = {};
+__export(tool_provider_exports, {
+  agentSpawnerToolsProvider: () => agentSpawnerToolsProvider
+});
+module.exports = __toCommonJS(tool_provider_exports);
+var import_schemas = require("./schemas.js");
+var import_runtime_service = require("./runtime-service.js");
+var import_spawn_agent_tool = require("./spawn-agent-tool.js");
+const agentSpawnerToolsProvider = {
+  type: "agent-spawner",
+  configSchema: import_schemas.AgentSpawnerConfigSchema,
+  create: (config, context) => {
+    const { logger, agent } = context;
+    const service = new import_runtime_service.RuntimeService(agent, config, logger);
+    return [(0, import_spawn_agent_tool.createSpawnAgentTool)(service)];
+  },
+  metadata: {
+    displayName: "Agent Spawner",
+    description: "Spawn sub-agents for task delegation",
+    category: "agents"
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  agentSpawnerToolsProvider
+});

package/dist/tool-provider/tool-provider.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Agent Spawner Tool Provider
+ *
+ * Custom tool provider that enables agents to spawn sub-agents for task delegation.
+ */
+import type { CustomToolProvider } from '@dexto/core';
+import { type AgentSpawnerConfig } from './schemas.js';
+/**
+ * Agent Spawner Tools Provider
+ *
+ * Provides the spawn_agent tool for task delegation to sub-agents.
+ *
+ * Configuration:
+ * ```yaml
+ * tools:
+ *   customTools:
+ *     - type: agent-spawner
+ *       maxConcurrentAgents: 5
+ *       defaultTimeout: 300000
+ *       allowSpawning: true
+ * ```
+ */
+export declare const agentSpawnerToolsProvider: CustomToolProvider<'agent-spawner', AgentSpawnerConfig>;
+//# sourceMappingURL=tool-provider.d.ts.map

package/dist/tool-provider/tool-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-provider.d.ts","sourceRoot":"","sources":["../../src/tool-provider/tool-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,aAAa,CAAC;AACpE,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAIjF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAAkB,CAAC,eAAe,EAAE,kBAAkB,CAmB7F,CAAC"}

package/dist/tool-provider/tool-provider.js

@@ -0,0 +1,20 @@
+import { AgentSpawnerConfigSchema } from "./schemas.js";
+import { RuntimeService } from "./runtime-service.js";
+import { createSpawnAgentTool } from "./spawn-agent-tool.js";
+const agentSpawnerToolsProvider = {
+  type: "agent-spawner",
+  configSchema: AgentSpawnerConfigSchema,
+  create: (config, context) => {
+    const { logger, agent } = context;
+    const service = new RuntimeService(agent, config, logger);
+    return [createSpawnAgentTool(service)];
+  },
+  metadata: {
+    displayName: "Agent Spawner",
+    description: "Spawn sub-agents for task delegation",
+    category: "agents"
+  }
+};
+export {
+  agentSpawnerToolsProvider
+};

package/dist/tool-provider/types.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/tool-provider/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Agent Spawner Tool Types
+ *
+ * Type definitions for tool inputs and outputs.
+ */
+/**
+ * Output from spawn_agent tool
+ */
+export interface SpawnAgentOutput {
+    /** Whether the task completed successfully */
+    success: boolean;
+    /** Final response from the sub-agent */
+    response?: string;
+    /** Error message if the task failed */
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tool-provider/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tool-provider/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IAEjB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/agent-management",
-  "version": "1.5.1",
+  "version": "1.5.3",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -16,7 +16,7 @@
   "dependencies": {
     "yaml": "^2.7.1",
     "zod": "^3.25.0",
-    "@dexto/core": "1.5.1"
+    "@dexto/core": "1.5.3"
   },
   "devDependencies": {
     "@types/node": "^22.13.5"