@dexto/agent-management 1.5.2 → 1.5.4

package/dist/runtime/schemas.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Agent Runtime Schemas
+ *
+ * Zod schemas for validating runtime configuration and inputs.
+ */
+import { z } from 'zod';
+export declare const DEFAULT_MAX_AGENTS = 20;
+export declare const DEFAULT_TASK_TIMEOUT = 300000;
+/**
+ * Schema for AgentRuntime configuration
+ */
+export declare const AgentRuntimeConfigSchema: z.ZodObject<{
+    maxAgents: z.ZodDefault<z.ZodNumber>;
+    defaultTaskTimeout: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    maxAgents: number;
+    defaultTaskTimeout: number;
+}, {
+    maxAgents?: number | undefined;
+    defaultTaskTimeout?: number | undefined;
+}>;
+export type ValidatedAgentRuntimeConfig = z.output<typeof AgentRuntimeConfigSchema>;
+/**
+ * Schema for SpawnConfig
+ * Note: agentConfig is not validated here as it uses the core AgentConfigSchema
+ */
+export declare const SpawnConfigSchema: z.ZodObject<{
+    agentConfig: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    ephemeral: z.ZodDefault<z.ZodBoolean>;
+    agentId: z.ZodOptional<z.ZodString>;
+    group: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    agentConfig: Record<string, unknown>;
+    ephemeral: boolean;
+    agentId?: string | undefined;
+    group?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    agentConfig: Record<string, unknown>;
+    agentId?: string | undefined;
+    ephemeral?: boolean | undefined;
+    group?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export type ValidatedSpawnConfig = z.output<typeof SpawnConfigSchema>;
+/**
+ * Schema for AgentStatus
+ */
+export declare const AgentStatusSchema: z.ZodEnum<["starting", "idle", "running", "stopping", "stopped", "error"]>;
+export type ValidatedAgentStatus = z.output<typeof AgentStatusSchema>;
+/**
+ * Schema for AgentFilter
+ */
+export declare const AgentFilterSchema: z.ZodObject<{
+    group: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["starting", "idle", "running", "stopping", "stopped", "error"]>, z.ZodArray<z.ZodEnum<["starting", "idle", "running", "stopping", "stopped", "error"]>, "many">]>>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    status?: "error" | "starting" | "idle" | "running" | "stopping" | "stopped" | ("error" | "starting" | "idle" | "running" | "stopping" | "stopped")[] | undefined;
+    ephemeral?: boolean | undefined;
+    group?: string | undefined;
+}, {
+    status?: "error" | "starting" | "idle" | "running" | "stopping" | "stopped" | ("error" | "starting" | "idle" | "running" | "stopping" | "stopped")[] | undefined;
+    ephemeral?: boolean | undefined;
+    group?: string | undefined;
+}>;
+export type ValidatedAgentFilter = z.output<typeof AgentFilterSchema>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/runtime/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAM3C;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;EAiBc,CAAC;AAEpD,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAMpF;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EA2BsB,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAMtE;;GAEG;AACH,eAAO,MAAM,iBAAiB,4EAO5B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAMtE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAYoB,CAAC;AAEnD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/runtime/schemas.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+const DEFAULT_MAX_AGENTS = 20;
+const DEFAULT_TASK_TIMEOUT = 3e5;
+const AgentRuntimeConfigSchema = z.object({
+  maxAgents: z.number().int().positive().default(DEFAULT_MAX_AGENTS).describe("Maximum total agents managed by this runtime"),
+  defaultTaskTimeout: z.number().int().positive().default(DEFAULT_TASK_TIMEOUT).describe("Default task timeout in milliseconds")
+}).strict().describe("Configuration for the AgentRuntime");
+const SpawnConfigSchema = z.object({
+  agentConfig: z.record(z.unknown()).describe("Base agent configuration"),
+  ephemeral: z.boolean().default(true).describe("Whether agent should be destroyed after task completion"),
+  agentId: z.string().min(1).optional().describe("Optional custom agent ID (auto-generated if not provided)"),
+  group: z.string().min(1).optional().describe("Optional group identifier for logical grouping"),
+  metadata: z.record(z.unknown()).optional().describe("Optional metadata for tracking relationships or context")
+}).strict().describe("Configuration for spawning an agent");
+const AgentStatusSchema = z.enum([
+  "starting",
+  "idle",
+  "running",
+  "stopping",
+  "stopped",
+  "error"
+]);
+const AgentFilterSchema = z.object({
+  group: z.string().optional().describe("Filter by group"),
+  status: z.union([AgentStatusSchema, z.array(AgentStatusSchema)]).optional().describe("Filter by status"),
+  ephemeral: z.boolean().optional().describe("Filter by ephemeral flag")
+}).strict().describe("Filter options for listing agents");
+export {
+  AgentFilterSchema,
+  AgentRuntimeConfigSchema,
+  AgentStatusSchema,
+  DEFAULT_MAX_AGENTS,
+  DEFAULT_TASK_TIMEOUT,
+  SpawnConfigSchema
+};

package/dist/runtime/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/runtime/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Agent Runtime Types
+ *
+ * Type definitions for the general-purpose agent runtime system that manages
+ * the lifecycle of multiple agent instances.
+ */
+import type { DextoAgent, AgentConfig } from '@dexto/core';
+/**
+ * Configuration for spawning an agent
+ */
+export interface SpawnConfig {
+    /** Base agent config (LLM, system prompt, tools, etc.) */
+    agentConfig: AgentConfig;
+    /** Whether agent should be destroyed after task completion (default: true) */
+    ephemeral?: boolean;
+    /** Optional custom agent ID (auto-generated if not provided) */
+    agentId?: string;
+    /** Optional group identifier for logical grouping (e.g., parent agent ID) */
+    group?: string;
+    /** Optional metadata for tracking relationships or context */
+    metadata?: Record<string, unknown>;
+    /**
+     * Optional callback invoked after agent is created but before it starts.
+     * Use this to configure approval handlers or other pre-start setup.
+     */
+    onBeforeStart?: (agent: DextoAgent) => void | Promise<void>;
+}
+/**
+ * Status of a managed agent
+ */
+export type AgentStatus = 'starting' | 'idle' | 'running' | 'stopping' | 'stopped' | 'error';
+/**
+ * Handle to an agent managed by the runtime
+ */
+export interface AgentHandle {
+    /** Unique identifier for this agent */
+    agentId: string;
+    /** The DextoAgent instance */
+    agent: DextoAgent;
+    /** Current status of the agent */
+    status: AgentStatus;
+    /** Whether this agent should be destroyed after task completion */
+    ephemeral: boolean;
+    /** When this agent was created */
+    createdAt: Date;
+    /** Session ID for the agent's conversation */
+    sessionId: string;
+    /** Optional group identifier (e.g., parent agent ID for sub-agents) */
+    group?: string;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+    /** Optional error message if status is 'error' */
+    error?: string;
+}
+/**
+ * Result from executing a task on an agent
+ */
+export interface TaskResult {
+    /** Whether the task completed successfully */
+    success: boolean;
+    /** Final response from the agent */
+    response?: string;
+    /** Error message if the task failed */
+    error?: string;
+    /** ID of the agent that executed the task */
+    agentId: string;
+    /** Token usage for the task */
+    tokenUsage?: {
+        input: number;
+        output: number;
+        total: number;
+    };
+}
+/**
+ * Configuration for the AgentRuntime
+ */
+export interface AgentRuntimeConfig {
+    /** Maximum total agents managed by this runtime (default: 20) */
+    maxAgents?: number;
+    /** Default task timeout in milliseconds (default: 300000 = 5 min) */
+    defaultTaskTimeout?: number;
+}
+/**
+ * Filter options for listing agents
+ */
+export interface AgentFilter {
+    /** Filter by group */
+    group?: string;
+    /** Filter by status */
+    status?: AgentStatus | AgentStatus[];
+    /** Filter by ephemeral flag */
+    ephemeral?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,35 @@
+"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 error_codes_exports = {};
+__export(error_codes_exports, {
+  AgentSpawnerErrorCode: () => AgentSpawnerErrorCode
+});
+module.exports = __toCommonJS(error_codes_exports);
+var AgentSpawnerErrorCode = /* @__PURE__ */ ((AgentSpawnerErrorCode2) => {
+  AgentSpawnerErrorCode2["SPAWNING_DISABLED"] = "agent_spawner_spawning_disabled";
+  AgentSpawnerErrorCode2["SPAWN_FAILED"] = "agent_spawner_spawn_failed";
+  AgentSpawnerErrorCode2["AGENT_NOT_FOUND"] = "agent_spawner_agent_not_found";
+  AgentSpawnerErrorCode2["TASK_FAILED"] = "agent_spawner_task_failed";
+  AgentSpawnerErrorCode2["INVALID_CONFIG"] = "agent_spawner_invalid_config";
+  return AgentSpawnerErrorCode2;
+})(AgentSpawnerErrorCode || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentSpawnerErrorCode
+});

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

@@ -0,0 +1,11 @@
+/**
+ * Agent Spawner Tool Error Codes
+ */
+export declare enum AgentSpawnerErrorCode {
+    SPAWNING_DISABLED = "agent_spawner_spawning_disabled",
+    SPAWN_FAILED = "agent_spawner_spawn_failed",
+    AGENT_NOT_FOUND = "agent_spawner_agent_not_found",
+    TASK_FAILED = "agent_spawner_task_failed",
+    INVALID_CONFIG = "agent_spawner_invalid_config"
+}
+//# sourceMappingURL=error-codes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/tool-provider/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/error-codes.js

@@ -0,0 +1,11 @@
+var AgentSpawnerErrorCode = /* @__PURE__ */ ((AgentSpawnerErrorCode2) => {
+  AgentSpawnerErrorCode2["SPAWNING_DISABLED"] = "agent_spawner_spawning_disabled";
+  AgentSpawnerErrorCode2["SPAWN_FAILED"] = "agent_spawner_spawn_failed";
+  AgentSpawnerErrorCode2["AGENT_NOT_FOUND"] = "agent_spawner_agent_not_found";
+  AgentSpawnerErrorCode2["TASK_FAILED"] = "agent_spawner_task_failed";
+  AgentSpawnerErrorCode2["INVALID_CONFIG"] = "agent_spawner_invalid_config";
+  return AgentSpawnerErrorCode2;
+})(AgentSpawnerErrorCode || {});
+export {
+  AgentSpawnerErrorCode
+};

package/dist/tool-provider/errors.cjs

@@ -0,0 +1,81 @@
+"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 errors_exports = {};
+__export(errors_exports, {
+  AgentSpawnerError: () => AgentSpawnerError
+});
+module.exports = __toCommonJS(errors_exports);
+var import_core = require("@dexto/core");
+var import_error_codes = require("./error-codes.js");
+class AgentSpawnerError {
+  static spawningDisabled() {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.AgentSpawnerErrorCode.SPAWNING_DISABLED,
+      import_core.ErrorScope.TOOLS,
+      import_core.ErrorType.USER,
+      "Agent spawning is disabled in configuration",
+      {},
+      "Enable spawning in the agent-spawner tool configuration"
+    );
+  }
+  static spawnFailed(cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.AgentSpawnerErrorCode.SPAWN_FAILED,
+      import_core.ErrorScope.TOOLS,
+      import_core.ErrorType.SYSTEM,
+      `Failed to spawn sub-agent: ${cause}`,
+      { cause },
+      "Check the configuration and try again"
+    );
+  }
+  static agentNotFound(agentId) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.AgentSpawnerErrorCode.AGENT_NOT_FOUND,
+      import_core.ErrorScope.TOOLS,
+      import_core.ErrorType.NOT_FOUND,
+      `Sub-agent '${agentId}' not found`,
+      { agentId },
+      "Ensure the agent ID is correct and the agent is still active"
+    );
+  }
+  static taskFailed(agentId, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.AgentSpawnerErrorCode.TASK_FAILED,
+      import_core.ErrorScope.TOOLS,
+      import_core.ErrorType.SYSTEM,
+      `Task execution failed for agent '${agentId}': ${cause}`,
+      { agentId, cause },
+      "Check the task requirements and try again"
+    );
+  }
+  static invalidConfig(message) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.AgentSpawnerErrorCode.INVALID_CONFIG,
+      import_core.ErrorScope.TOOLS,
+      import_core.ErrorType.USER,
+      `Invalid agent spawner configuration: ${message}`,
+      {},
+      "Check the configuration and ensure all required fields are provided"
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentSpawnerError
+});

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

@@ -0,0 +1,19 @@
+import { DextoRuntimeError } from '@dexto/core';
+/**
+ * Agent Spawner error factory methods
+ */
+export declare class AgentSpawnerError {
+    static spawningDisabled(): DextoRuntimeError<{}>;
+    static spawnFailed(cause: string): DextoRuntimeError<{
+        cause: string;
+    }>;
+    static agentNotFound(agentId: string): DextoRuntimeError<{
+        agentId: string;
+    }>;
+    static taskFailed(agentId: string, cause: string): DextoRuntimeError<{
+        agentId: string;
+        cause: string;
+    }>;
+    static invalidConfig(message: string): DextoRuntimeError<{}>;
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/tool-provider/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-provider/errors.js

@@ -0,0 +1,57 @@
+import { DextoRuntimeError, ErrorScope, ErrorType } from "@dexto/core";
+import { AgentSpawnerErrorCode } from "./error-codes.js";
+class AgentSpawnerError {
+  static spawningDisabled() {
+    return new DextoRuntimeError(
+      AgentSpawnerErrorCode.SPAWNING_DISABLED,
+      ErrorScope.TOOLS,
+      ErrorType.USER,
+      "Agent spawning is disabled in configuration",
+      {},
+      "Enable spawning in the agent-spawner tool configuration"
+    );
+  }
+  static spawnFailed(cause) {
+    return new DextoRuntimeError(
+      AgentSpawnerErrorCode.SPAWN_FAILED,
+      ErrorScope.TOOLS,
+      ErrorType.SYSTEM,
+      `Failed to spawn sub-agent: ${cause}`,
+      { cause },
+      "Check the configuration and try again"
+    );
+  }
+  static agentNotFound(agentId) {
+    return new DextoRuntimeError(
+      AgentSpawnerErrorCode.AGENT_NOT_FOUND,
+      ErrorScope.TOOLS,
+      ErrorType.NOT_FOUND,
+      `Sub-agent '${agentId}' not found`,
+      { agentId },
+      "Ensure the agent ID is correct and the agent is still active"
+    );
+  }
+  static taskFailed(agentId, cause) {
+    return new DextoRuntimeError(
+      AgentSpawnerErrorCode.TASK_FAILED,
+      ErrorScope.TOOLS,
+      ErrorType.SYSTEM,
+      `Task execution failed for agent '${agentId}': ${cause}`,
+      { agentId, cause },
+      "Check the task requirements and try again"
+    );
+  }
+  static invalidConfig(message) {
+    return new DextoRuntimeError(
+      AgentSpawnerErrorCode.INVALID_CONFIG,
+      ErrorScope.TOOLS,
+      ErrorType.USER,
+      `Invalid agent spawner configuration: ${message}`,
+      {},
+      "Check the configuration and ensure all required fields are provided"
+    );
+  }
+}
+export {
+  AgentSpawnerError
+};

package/dist/tool-provider/index.cjs

@@ -0,0 +1,46 @@
+"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, {
+  AgentSpawnerConfigSchema: () => import_schemas.AgentSpawnerConfigSchema,
+  AgentSpawnerError: () => import_errors.AgentSpawnerError,
+  AgentSpawnerErrorCode: () => import_error_codes.AgentSpawnerErrorCode,
+  RuntimeService: () => import_runtime_service.RuntimeService,
+  SpawnAgentInputSchema: () => import_schemas2.SpawnAgentInputSchema,
+  agentSpawnerToolsProvider: () => import_tool_provider.agentSpawnerToolsProvider,
+  createSpawnAgentTool: () => import_spawn_agent_tool.createSpawnAgentTool
+});
+module.exports = __toCommonJS(tool_provider_exports);
+var import_tool_provider = require("./tool-provider.js");
+var import_schemas = require("./schemas.js");
+var import_runtime_service = require("./runtime-service.js");
+var import_spawn_agent_tool = require("./spawn-agent-tool.js");
+var import_schemas2 = require("./schemas.js");
+var import_errors = require("./errors.js");
+var import_error_codes = require("./error-codes.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentSpawnerConfigSchema,
+  AgentSpawnerError,
+  AgentSpawnerErrorCode,
+  RuntimeService,
+  SpawnAgentInputSchema,
+  agentSpawnerToolsProvider,
+  createSpawnAgentTool
+});

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

@@ -0,0 +1,16 @@
+/**
+ * Agent Spawner Tool Provider
+ *
+ * Enables agents to spawn sub-agents for task delegation.
+ */
+export { agentSpawnerToolsProvider } from './tool-provider.js';
+export { AgentSpawnerConfigSchema } from './schemas.js';
+export type { AgentSpawnerConfig } from './schemas.js';
+export { RuntimeService } from './runtime-service.js';
+export { createSpawnAgentTool } from './spawn-agent-tool.js';
+export { SpawnAgentInputSchema } from './schemas.js';
+export type { SpawnAgentInput } from './schemas.js';
+export type { SpawnAgentOutput } from './types.js';
+export { AgentSpawnerError } from './errors.js';
+export { AgentSpawnerErrorCode } from './error-codes.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool-provider/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAG/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/tool-provider/index.js

@@ -0,0 +1,16 @@
+import { agentSpawnerToolsProvider } from "./tool-provider.js";
+import { AgentSpawnerConfigSchema } from "./schemas.js";
+import { RuntimeService } from "./runtime-service.js";
+import { createSpawnAgentTool } from "./spawn-agent-tool.js";
+import { SpawnAgentInputSchema } from "./schemas.js";
+import { AgentSpawnerError } from "./errors.js";
+import { AgentSpawnerErrorCode } from "./error-codes.js";
+export {
+  AgentSpawnerConfigSchema,
+  AgentSpawnerError,
+  AgentSpawnerErrorCode,
+  RuntimeService,
+  SpawnAgentInputSchema,
+  agentSpawnerToolsProvider,
+  createSpawnAgentTool
+};