@opperai/agents 0.7.1 → 0.8.0

package/dist/index.d.cts

@@ -984,6 +984,12 @@ interface BaseAgentConfig<TInput, TOutput> {
      * Custom memory implementation (defaults to InMemoryStore if enableMemory is true)
      */
     memory?: Memory;
+    /**
+     * Execute tool calls in parallel when the LLM returns multiple tool calls
+     * in a single response. When false (default), tools execute sequentially.
+     * @default false
+     */
+    parallelToolExecution?: boolean;
     /**
      * Additional metadata for the agent
      */
@@ -1054,6 +1060,10 @@ declare abstract class BaseAgent<TInput = unknown, TOutput = unknown> {
      * Whether streaming is enabled
      */
     readonly enableStreaming: boolean;
+    /**
+     * Whether to execute tool calls in parallel
+     */
+    readonly parallelToolExecution: boolean;
     /**
      * Memory instance for persistent storage (null if disabled or initialization failed)
      */
@@ -1494,6 +1504,10 @@ declare class Agent<TInput = unknown, TOutput = unknown> extends BaseAgent<TInpu
      * Execute all tool calls from a decision
      */
     private executeToolCalls;
+    /**
+     * Execute a single tool call with span tracking and error handling
+     */
+    private executeSingleToolCall;
     /**
      * Handle memory operations from a decision
      * Supports read and write operations with graceful degradation

package/dist/index.d.ts

@@ -984,6 +984,12 @@ interface BaseAgentConfig<TInput, TOutput> {
      * Custom memory implementation (defaults to InMemoryStore if enableMemory is true)
      */
     memory?: Memory;
+    /**
+     * Execute tool calls in parallel when the LLM returns multiple tool calls
+     * in a single response. When false (default), tools execute sequentially.
+     * @default false
+     */
+    parallelToolExecution?: boolean;
     /**
      * Additional metadata for the agent
      */
@@ -1054,6 +1060,10 @@ declare abstract class BaseAgent<TInput = unknown, TOutput = unknown> {
      * Whether streaming is enabled
      */
     readonly enableStreaming: boolean;
+    /**
+     * Whether to execute tool calls in parallel
+     */
+    readonly parallelToolExecution: boolean;
     /**
      * Memory instance for persistent storage (null if disabled or initialization failed)
      */
@@ -1494,6 +1504,10 @@ declare class Agent<TInput = unknown, TOutput = unknown> extends BaseAgent<TInpu
      * Execute all tool calls from a decision
      */
     private executeToolCalls;
+    /**
+     * Execute a single tool call with span tracking and error handling
+     */
+    private executeSingleToolCall;
     /**
      * Handle memory operations from a decision
      * Supports read and write operations with graceful degradation

package/dist/index.js

@@ -924,6 +924,10 @@ var BaseAgent = class {
    * Whether streaming is enabled
    */
   enableStreaming;
+  /**
+   * Whether to execute tool calls in parallel
+   */
+  parallelToolExecution;
   /**
    * Memory instance for persistent storage (null if disabled or initialization failed)
    */
@@ -988,6 +992,7 @@ var BaseAgent = class {
     this.outputSchema = config.outputSchema;
     this.enableMemory = config.enableMemory ?? false;
     this.enableStreaming = config.enableStreaming ?? false;
+    this.parallelToolExecution = config.parallelToolExecution ?? false;
     this.metadata = { ...config.metadata ?? {} };
     this.hooks = new HookManager();
     this.tools = /* @__PURE__ */ new Map();
@@ -1635,7 +1640,7 @@ var mergeSchemaDefaults = (schema, value) => {
 
 // package.json
 var package_default = {
-  version: "0.7.1"};
+  version: "0.8.0"};
 
 // src/utils/version.ts
 var SDK_NAME = "@opperai/agents";
@@ -2627,89 +2632,105 @@ The memory you write persists across all process() calls on this agent.`;
       return [];
     }
     this.log(`Executing ${decision.toolCalls.length} tool call(s)`);
+    if (this.parallelToolExecution && decision.toolCalls.length > 1) {
+      this.log("Executing tool calls in parallel");
+      return Promise.all(
+        decision.toolCalls.map(
+          (toolCall) => this.executeSingleToolCall(toolCall, context, parentSpanId)
+        )
+      );
+    }
     const results = [];
     for (const toolCall of decision.toolCalls) {
-      this.log(`Action: ${toolCall.toolName}`, {
-        parameters: toolCall.arguments
-      });
-      const startTime = /* @__PURE__ */ new Date();
-      const tool2 = this.tools.get(toolCall.toolName);
-      const isAgentTool = tool2?.metadata?.["isAgent"] === true;
-      const spanType = isAgentTool ? "\u{1F916} agent" : "\u{1F527} tool";
-      const toolSpan = await this.opperClient.createSpan({
-        name: `tool_${toolCall.toolName}`,
-        input: toolCall.arguments,
-        type: spanType,
-        ...parentSpanId ? { parentSpanId } : context.parentSpanId ? { parentSpanId: context.parentSpanId } : {}
-      });
-      try {
-        const result = await this.executeTool(
-          toolCall.toolName,
-          toolCall.arguments,
-          context,
-          { spanId: toolSpan.id }
-        );
-        if (result.usage) {
-          context.updateUsageWithSource(toolCall.toolName, result.usage);
-        }
-        const endTime = /* @__PURE__ */ new Date();
-        const durationMs = endTime.getTime() - startTime.getTime();
-        if (result.success) {
-          this.queueSpanUpdate(context, {
-            spanId: toolSpan.id,
-            output: result.output,
-            startTime,
-            endTime,
-            meta: { durationMs }
-          });
-        } else {
-          this.queueSpanUpdate(context, {
-            spanId: toolSpan.id,
-            error: result.error instanceof Error ? result.error.message : String(result.error),
-            startTime,
-            endTime,
-            meta: { durationMs }
-          });
-        }
-        const summary = {
-          toolName: toolCall.toolName,
-          success: result.success,
-          ...result.success && { output: result.output },
-          ...!result.success && {
-            error: result.error instanceof Error ? result.error.message : String(result.error)
-          }
-        };
-        results.push(ToolExecutionSummarySchema.parse(summary));
-        this.log(
-          `Tool ${toolCall.toolName} ${result.success ? "succeeded" : "failed"}`,
-          {
-            success: result.success,
-            durationMs
-          }
-        );
-      } catch (error) {
-        const endTime = /* @__PURE__ */ new Date();
-        const durationMs = endTime.getTime() - startTime.getTime();
+      results.push(
+        await this.executeSingleToolCall(toolCall, context, parentSpanId)
+      );
+    }
+    return results;
+  }
+  /**
+   * Execute a single tool call with span tracking and error handling
+   */
+  async executeSingleToolCall(toolCall, context, parentSpanId) {
+    this.log(`Action: ${toolCall.toolName}`, {
+      parameters: toolCall.arguments
+    });
+    const startTime = /* @__PURE__ */ new Date();
+    const tool2 = this.tools.get(toolCall.toolName);
+    const isAgentTool = tool2?.metadata?.["isAgent"] === true;
+    const spanType = isAgentTool ? "\u{1F916} agent" : "\u{1F527} tool";
+    const toolSpan = await this.opperClient.createSpan({
+      name: `tool_${toolCall.toolName}`,
+      input: toolCall.arguments,
+      type: spanType,
+      ...parentSpanId ? { parentSpanId } : context.parentSpanId ? { parentSpanId: context.parentSpanId } : {}
+    });
+    try {
+      const result = await this.executeTool(
+        toolCall.toolName,
+        toolCall.arguments,
+        context,
+        { spanId: toolSpan.id }
+      );
+      if (result.usage) {
+        context.updateUsageWithSource(toolCall.toolName, result.usage);
+      }
+      const endTime = /* @__PURE__ */ new Date();
+      const durationMs = endTime.getTime() - startTime.getTime();
+      if (result.success) {
         this.queueSpanUpdate(context, {
           spanId: toolSpan.id,
-          error: error instanceof Error ? error.message : String(error),
+          output: result.output,
           startTime,
           endTime,
           meta: { durationMs }
         });
-        const summary = {
-          toolName: toolCall.toolName,
-          success: false,
-          error: error instanceof Error ? error.message : String(error)
-        };
-        results.push(ToolExecutionSummarySchema.parse(summary));
-        this.logger.warn(`Tool ${toolCall.toolName} threw error`, {
-          error: error instanceof Error ? error.message : String(error),
-          durationMs
+      } else {
+        this.queueSpanUpdate(context, {
+          spanId: toolSpan.id,
+          error: result.error instanceof Error ? result.error.message : String(result.error),
+          startTime,
+          endTime,
+          meta: { durationMs }
         });
       }
+      const summary = {
+        toolName: toolCall.toolName,
+        success: result.success,
+        ...result.success && { output: result.output },
+        ...!result.success && {
+          error: result.error instanceof Error ? result.error.message : String(result.error)
+        }
+      };
+      this.log(
+        `Tool ${toolCall.toolName} ${result.success ? "succeeded" : "failed"}`,
+        {
+          success: result.success,
+          durationMs
+        }
+      );
+      return ToolExecutionSummarySchema.parse(summary);
+    } catch (error) {
+      const endTime = /* @__PURE__ */ new Date();
+      const durationMs = endTime.getTime() - startTime.getTime();
+      this.queueSpanUpdate(context, {
+        spanId: toolSpan.id,
+        error: error instanceof Error ? error.message : String(error),
+        startTime,
+        endTime,
+        meta: { durationMs }
+      });
+      const summary = {
+        toolName: toolCall.toolName,
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+      this.logger.warn(`Tool ${toolCall.toolName} threw error`, {
+        error: error instanceof Error ? error.message : String(error),
+        durationMs
+      });
+      return ToolExecutionSummarySchema.parse(summary);
     }
-    return results;
   }
   /**
    * Handle memory operations from a decision