@voltagent/core 1.1.33 → 1.1.34

package/dist/index.d.mts

@@ -4590,6 +4590,48 @@ declare class Agent {
      * Get Memory instance if available
      */
     getMemory(): Memory | false | undefined;
+    /**
+     * Convert this agent into a tool that can be used by other agents.
+     * This enables supervisor/coordinator patterns where one agent can delegate
+     * work to other specialized agents.
+     *
+     * @param options - Optional configuration for the tool
+     * @param options.name - Custom name for the tool (defaults to `${agent.id}_tool`)
+     * @param options.description - Custom description (defaults to agent's purpose or auto-generated)
+     * @param options.parametersSchema - Custom input schema (defaults to { prompt: string })
+     *
+     * @returns A Tool instance that executes this agent
+     *
+     * @example
+     * ```typescript
+     * const writerAgent = new Agent({
+     *   id: "writer",
+     *   purpose: "Writes blog posts",
+     *   // ... other config
+     * });
+     *
+     * const editorAgent = new Agent({
+     *   id: "editor",
+     *   purpose: "Edits content",
+     *   // ... other config
+     * });
+     *
+     * // Supervisor agent that uses both as tools
+     * const supervisorAgent = new Agent({
+     *   id: "supervisor",
+     *   instructions: "First call writer, then editor",
+     *   tools: [
+     *     writerAgent.toTool(),
+     *     editorAgent.toTool()
+     *   ]
+     * });
+     * ```
+     */
+    toTool(options?: {
+        name?: string;
+        description?: string;
+        parametersSchema?: z.ZodObject<any>;
+    }): Tool<any, any>;
     /**
      * Check if working memory is supported
      */

package/dist/index.d.ts

@@ -4590,6 +4590,48 @@ declare class Agent {
      * Get Memory instance if available
      */
     getMemory(): Memory | false | undefined;
+    /**
+     * Convert this agent into a tool that can be used by other agents.
+     * This enables supervisor/coordinator patterns where one agent can delegate
+     * work to other specialized agents.
+     *
+     * @param options - Optional configuration for the tool
+     * @param options.name - Custom name for the tool (defaults to `${agent.id}_tool`)
+     * @param options.description - Custom description (defaults to agent's purpose or auto-generated)
+     * @param options.parametersSchema - Custom input schema (defaults to { prompt: string })
+     *
+     * @returns A Tool instance that executes this agent
+     *
+     * @example
+     * ```typescript
+     * const writerAgent = new Agent({
+     *   id: "writer",
+     *   purpose: "Writes blog posts",
+     *   // ... other config
+     * });
+     *
+     * const editorAgent = new Agent({
+     *   id: "editor",
+     *   purpose: "Edits content",
+     *   // ... other config
+     * });
+     *
+     * // Supervisor agent that uses both as tools
+     * const supervisorAgent = new Agent({
+     *   id: "supervisor",
+     *   instructions: "First call writer, then editor",
+     *   tools: [
+     *     writerAgent.toTool(),
+     *     editorAgent.toTool()
+     *   ]
+     * });
+     * ```
+     */
+    toTool(options?: {
+        name?: string;
+        description?: string;
+        parametersSchema?: z.ZodObject<any>;
+    }): Tool<any, any>;
     /**
      * Check if working memory is supported
      */

package/dist/index.js

@@ -16615,6 +16615,68 @@ ${toolkit.instructions}`;
     }
     return this.memory ?? this.memoryManager.getMemory();
   }
+  /**
+   * Convert this agent into a tool that can be used by other agents.
+   * This enables supervisor/coordinator patterns where one agent can delegate
+   * work to other specialized agents.
+   *
+   * @param options - Optional configuration for the tool
+   * @param options.name - Custom name for the tool (defaults to `${agent.id}_tool`)
+   * @param options.description - Custom description (defaults to agent's purpose or auto-generated)
+   * @param options.parametersSchema - Custom input schema (defaults to { prompt: string })
+   *
+   * @returns A Tool instance that executes this agent
+   *
+   * @example
+   * ```typescript
+   * const writerAgent = new Agent({
+   *   id: "writer",
+   *   purpose: "Writes blog posts",
+   *   // ... other config
+   * });
+   *
+   * const editorAgent = new Agent({
+   *   id: "editor",
+   *   purpose: "Edits content",
+   *   // ... other config
+   * });
+   *
+   * // Supervisor agent that uses both as tools
+   * const supervisorAgent = new Agent({
+   *   id: "supervisor",
+   *   instructions: "First call writer, then editor",
+   *   tools: [
+   *     writerAgent.toTool(),
+   *     editorAgent.toTool()
+   *   ]
+   * });
+   * ```
+   */
+  toTool(options) {
+    const toolName = options?.name || `${this.id}_tool`;
+    const toolDescription = options?.description || this.purpose || `Executes the ${this.name} agent to complete a task`;
+    const parametersSchema = options?.parametersSchema || import_zod3.z.object({
+      prompt: import_zod3.z.string().describe("The prompt or task to send to the agent")
+    });
+    return createTool({
+      name: toolName,
+      description: toolDescription,
+      parameters: parametersSchema,
+      execute: /* @__PURE__ */ __name(async (args, context8) => {
+        const prompt = args.prompt || args;
+        const result = await this.generateText(prompt, {
+          // Pass through the operation context if available
+          parentOperationContext: context8,
+          conversationId: context8?.conversationId,
+          userId: context8?.userId
+        });
+        return {
+          text: result.text,
+          usage: result.usage
+        };
+      }, "execute")
+    });
+  }
   /**
    * Check if working memory is supported
    */