@opperai/agents 0.6.0 → 0.7.0

package/dist/index.d.cts

@@ -561,6 +561,15 @@ interface IterationSummary {
     }>;
     results: unknown[];
 }
+interface PendingSpanUpdate {
+    spanId: string;
+    output?: unknown;
+    error?: string;
+    startTime?: Date;
+    endTime?: Date;
+    meta?: Record<string, unknown>;
+    name?: string;
+}
 declare class AgentContext {
     readonly agentName: string;
     readonly sessionId: string;
@@ -573,6 +582,7 @@ declare class AgentContext {
     metadata: Record<string, unknown>;
     readonly startedAt: number;
     updatedAt: number;
+    pendingSpanUpdates: PendingSpanUpdate[];
     constructor(options: AgentContextOptions);
     updateUsage(delta: Usage): void;
     /**
@@ -1786,6 +1796,8 @@ declare class Agent<TInput = unknown, TOutput = unknown> extends BaseAgent<TInpu
      * Serialize input for passing to LLM or spans
      */
     private serializeInput;
+    private queueSpanUpdate;
+    private flushPendingSpanUpdates;
     /**
      * Main agent loop: think → tool execution → memory handling → repeat until complete
      */
@@ -2587,4 +2599,4 @@ declare class ToolRunner {
     };
 }
 
-export { type AfterToolPayload, Agent, type AgentConfig, AgentContext, type AgentContextOptions, type AgentContextSnapshot, type AgentDecision, AgentDecisionSchema, type AgentEndPayload, type AgentEventListener, type AgentEventName, type AgentEventPayload, type AgentEventPayloadMap, AgentEvents, type AgentLogger, type AgentStartPayload, type AgentThought, BaseAgent, type BaseAgentConfig, type BaseUsage, BaseUsageSchema, type BeforeToolPayload, ConsoleLogger, type CreateSpanOptions, DEFAULT_MODEL, DEFAULT_RETRY_CONFIG, type ExecutionCycle, ExecutionCycleSchema, type ExecutionThought, type Failure, type HookEventName, HookEvents, type HookHandler, HookManager, type HookPayload, type HookPayloadMap, type HookRegistration, InMemoryStore, type IterationSummary, type JsonSchemaOptions, type LlmCallPayload, type LlmCallType, type LlmResponsePayload, LogLevel, type LoopEndPayload, type LoopStartPayload, MCPClient, type MCPClientOptions, type MCPServerConfig, type MCPServerConfigInput, MCPServerConfigSchema, type MCPTool, MCPToolProvider, type MCPToolProviderOptions, MCPconfig, type MaybePromise, type Memory, type MemoryCatalogEntry, type MemoryEntry, type MemoryEntryMetadata, MemoryEntryMetadataSchema, MemoryEntrySchema, type MemoryErrorPayload, type MemoryReadPayload, type MemoryUpdate, MemoryUpdateSchema, type MemoryWritePayload, type OpperCallOptions, type OpperCallResponse, OpperClient, type OpperClientConfig, type OpperSpan, type OpperStreamChunk, type OpperStreamEvent, type OpperStreamResponse, Result, type RetryConfig, STREAM_ROOT_PATH, type Schema, SchemaValidationError, type SchemaValidationOptions, SilentLogger, StreamAssembler, type StreamAssemblerOptions, type StreamChunkPayload, type StreamEndPayload, type StreamErrorPayload, type StreamFeedResult, type StreamFinalizeResult, type StreamStartPayload, type Success, type ThinkEndPayload, type Thought, ThoughtSchema, type Tool, type ToolCall, type ToolCallRecord, ToolCallRecordSchema, ToolCallSchema, type ToolDefinition, type ToolErrorPayload, type ToolExample, type ToolExecutionContext, type ToolExecutionSummary, ToolExecutionSummarySchema, type ToolFailure, type ToolFunction, ToolMetadataSchema, type ToolOptions, type ToolProvider, type ToolResult, type ToolResultData, ToolResultFactory, ToolResultFailureSchema, type ToolResultInit, ToolResultSchema, ToolResultSuccessSchema, type ToolRunOptions, ToolRunner, type ToolSuccess, type UnregisterHook, type Usage, UsageSchema, type VisualizationOptions, addUsage, coerceToolDefinition, createAgentDecisionWithOutputSchema, createEmptyUsage, createFunctionTool, createHookManager, createInMemoryStore, createMCPServerConfig, createOpperClient, createStreamAssembler, createToolCallRecord, err, extractTools, generateAgentFlowDiagram, getDefaultLogger, getSchemaDefault, isSchemaValid, isToolProvider, mcp, mergeSchemaDefaults, normalizeToolEntries, ok, schemaToJson, setDefaultLogger, tool, validateSchema, validateToolInput, zodSchemaToJsonSchema };
+export { type AfterToolPayload, Agent, type AgentConfig, AgentContext, type AgentContextOptions, type AgentContextSnapshot, type AgentDecision, AgentDecisionSchema, type AgentEndPayload, type AgentEventListener, type AgentEventName, type AgentEventPayload, type AgentEventPayloadMap, AgentEvents, type AgentLogger, type AgentStartPayload, type AgentThought, BaseAgent, type BaseAgentConfig, type BaseUsage, BaseUsageSchema, type BeforeToolPayload, ConsoleLogger, type CreateSpanOptions, DEFAULT_MODEL, DEFAULT_RETRY_CONFIG, type ExecutionCycle, ExecutionCycleSchema, type ExecutionThought, type Failure, type HookEventName, HookEvents, type HookHandler, HookManager, type HookPayload, type HookPayloadMap, type HookRegistration, InMemoryStore, type IterationSummary, type JsonSchemaOptions, type LlmCallPayload, type LlmCallType, type LlmResponsePayload, LogLevel, type LoopEndPayload, type LoopStartPayload, MCPClient, type MCPClientOptions, type MCPServerConfig, type MCPServerConfigInput, MCPServerConfigSchema, type MCPTool, MCPToolProvider, type MCPToolProviderOptions, MCPconfig, type MaybePromise, type Memory, type MemoryCatalogEntry, type MemoryEntry, type MemoryEntryMetadata, MemoryEntryMetadataSchema, MemoryEntrySchema, type MemoryErrorPayload, type MemoryReadPayload, type MemoryUpdate, MemoryUpdateSchema, type MemoryWritePayload, type OpperCallOptions, type OpperCallResponse, OpperClient, type OpperClientConfig, type OpperSpan, type OpperStreamChunk, type OpperStreamEvent, type OpperStreamResponse, type PendingSpanUpdate, Result, type RetryConfig, STREAM_ROOT_PATH, type Schema, SchemaValidationError, type SchemaValidationOptions, SilentLogger, StreamAssembler, type StreamAssemblerOptions, type StreamChunkPayload, type StreamEndPayload, type StreamErrorPayload, type StreamFeedResult, type StreamFinalizeResult, type StreamStartPayload, type Success, type ThinkEndPayload, type Thought, ThoughtSchema, type Tool, type ToolCall, type ToolCallRecord, ToolCallRecordSchema, ToolCallSchema, type ToolDefinition, type ToolErrorPayload, type ToolExample, type ToolExecutionContext, type ToolExecutionSummary, ToolExecutionSummarySchema, type ToolFailure, type ToolFunction, ToolMetadataSchema, type ToolOptions, type ToolProvider, type ToolResult, type ToolResultData, ToolResultFactory, ToolResultFailureSchema, type ToolResultInit, ToolResultSchema, ToolResultSuccessSchema, type ToolRunOptions, ToolRunner, type ToolSuccess, type UnregisterHook, type Usage, UsageSchema, type VisualizationOptions, addUsage, coerceToolDefinition, createAgentDecisionWithOutputSchema, createEmptyUsage, createFunctionTool, createHookManager, createInMemoryStore, createMCPServerConfig, createOpperClient, createStreamAssembler, createToolCallRecord, err, extractTools, generateAgentFlowDiagram, getDefaultLogger, getSchemaDefault, isSchemaValid, isToolProvider, mcp, mergeSchemaDefaults, normalizeToolEntries, ok, schemaToJson, setDefaultLogger, tool, validateSchema, validateToolInput, zodSchemaToJsonSchema };

package/dist/index.d.ts

@@ -561,6 +561,15 @@ interface IterationSummary {
     }>;
     results: unknown[];
 }
+interface PendingSpanUpdate {
+    spanId: string;
+    output?: unknown;
+    error?: string;
+    startTime?: Date;
+    endTime?: Date;
+    meta?: Record<string, unknown>;
+    name?: string;
+}
 declare class AgentContext {
     readonly agentName: string;
     readonly sessionId: string;
@@ -573,6 +582,7 @@ declare class AgentContext {
     metadata: Record<string, unknown>;
     readonly startedAt: number;
     updatedAt: number;
+    pendingSpanUpdates: PendingSpanUpdate[];
     constructor(options: AgentContextOptions);
     updateUsage(delta: Usage): void;
     /**
@@ -1786,6 +1796,8 @@ declare class Agent<TInput = unknown, TOutput = unknown> extends BaseAgent<TInpu
      * Serialize input for passing to LLM or spans
      */
     private serializeInput;
+    private queueSpanUpdate;
+    private flushPendingSpanUpdates;
     /**
      * Main agent loop: think → tool execution → memory handling → repeat until complete
      */
@@ -2587,4 +2599,4 @@ declare class ToolRunner {
     };
 }
 
-export { type AfterToolPayload, Agent, type AgentConfig, AgentContext, type AgentContextOptions, type AgentContextSnapshot, type AgentDecision, AgentDecisionSchema, type AgentEndPayload, type AgentEventListener, type AgentEventName, type AgentEventPayload, type AgentEventPayloadMap, AgentEvents, type AgentLogger, type AgentStartPayload, type AgentThought, BaseAgent, type BaseAgentConfig, type BaseUsage, BaseUsageSchema, type BeforeToolPayload, ConsoleLogger, type CreateSpanOptions, DEFAULT_MODEL, DEFAULT_RETRY_CONFIG, type ExecutionCycle, ExecutionCycleSchema, type ExecutionThought, type Failure, type HookEventName, HookEvents, type HookHandler, HookManager, type HookPayload, type HookPayloadMap, type HookRegistration, InMemoryStore, type IterationSummary, type JsonSchemaOptions, type LlmCallPayload, type LlmCallType, type LlmResponsePayload, LogLevel, type LoopEndPayload, type LoopStartPayload, MCPClient, type MCPClientOptions, type MCPServerConfig, type MCPServerConfigInput, MCPServerConfigSchema, type MCPTool, MCPToolProvider, type MCPToolProviderOptions, MCPconfig, type MaybePromise, type Memory, type MemoryCatalogEntry, type MemoryEntry, type MemoryEntryMetadata, MemoryEntryMetadataSchema, MemoryEntrySchema, type MemoryErrorPayload, type MemoryReadPayload, type MemoryUpdate, MemoryUpdateSchema, type MemoryWritePayload, type OpperCallOptions, type OpperCallResponse, OpperClient, type OpperClientConfig, type OpperSpan, type OpperStreamChunk, type OpperStreamEvent, type OpperStreamResponse, Result, type RetryConfig, STREAM_ROOT_PATH, type Schema, SchemaValidationError, type SchemaValidationOptions, SilentLogger, StreamAssembler, type StreamAssemblerOptions, type StreamChunkPayload, type StreamEndPayload, type StreamErrorPayload, type StreamFeedResult, type StreamFinalizeResult, type StreamStartPayload, type Success, type ThinkEndPayload, type Thought, ThoughtSchema, type Tool, type ToolCall, type ToolCallRecord, ToolCallRecordSchema, ToolCallSchema, type ToolDefinition, type ToolErrorPayload, type ToolExample, type ToolExecutionContext, type ToolExecutionSummary, ToolExecutionSummarySchema, type ToolFailure, type ToolFunction, ToolMetadataSchema, type ToolOptions, type ToolProvider, type ToolResult, type ToolResultData, ToolResultFactory, ToolResultFailureSchema, type ToolResultInit, ToolResultSchema, ToolResultSuccessSchema, type ToolRunOptions, ToolRunner, type ToolSuccess, type UnregisterHook, type Usage, UsageSchema, type VisualizationOptions, addUsage, coerceToolDefinition, createAgentDecisionWithOutputSchema, createEmptyUsage, createFunctionTool, createHookManager, createInMemoryStore, createMCPServerConfig, createOpperClient, createStreamAssembler, createToolCallRecord, err, extractTools, generateAgentFlowDiagram, getDefaultLogger, getSchemaDefault, isSchemaValid, isToolProvider, mcp, mergeSchemaDefaults, normalizeToolEntries, ok, schemaToJson, setDefaultLogger, tool, validateSchema, validateToolInput, zodSchemaToJsonSchema };
+export { type AfterToolPayload, Agent, type AgentConfig, AgentContext, type AgentContextOptions, type AgentContextSnapshot, type AgentDecision, AgentDecisionSchema, type AgentEndPayload, type AgentEventListener, type AgentEventName, type AgentEventPayload, type AgentEventPayloadMap, AgentEvents, type AgentLogger, type AgentStartPayload, type AgentThought, BaseAgent, type BaseAgentConfig, type BaseUsage, BaseUsageSchema, type BeforeToolPayload, ConsoleLogger, type CreateSpanOptions, DEFAULT_MODEL, DEFAULT_RETRY_CONFIG, type ExecutionCycle, ExecutionCycleSchema, type ExecutionThought, type Failure, type HookEventName, HookEvents, type HookHandler, HookManager, type HookPayload, type HookPayloadMap, type HookRegistration, InMemoryStore, type IterationSummary, type JsonSchemaOptions, type LlmCallPayload, type LlmCallType, type LlmResponsePayload, LogLevel, type LoopEndPayload, type LoopStartPayload, MCPClient, type MCPClientOptions, type MCPServerConfig, type MCPServerConfigInput, MCPServerConfigSchema, type MCPTool, MCPToolProvider, type MCPToolProviderOptions, MCPconfig, type MaybePromise, type Memory, type MemoryCatalogEntry, type MemoryEntry, type MemoryEntryMetadata, MemoryEntryMetadataSchema, MemoryEntrySchema, type MemoryErrorPayload, type MemoryReadPayload, type MemoryUpdate, MemoryUpdateSchema, type MemoryWritePayload, type OpperCallOptions, type OpperCallResponse, OpperClient, type OpperClientConfig, type OpperSpan, type OpperStreamChunk, type OpperStreamEvent, type OpperStreamResponse, type PendingSpanUpdate, Result, type RetryConfig, STREAM_ROOT_PATH, type Schema, SchemaValidationError, type SchemaValidationOptions, SilentLogger, StreamAssembler, type StreamAssemblerOptions, type StreamChunkPayload, type StreamEndPayload, type StreamErrorPayload, type StreamFeedResult, type StreamFinalizeResult, type StreamStartPayload, type Success, type ThinkEndPayload, type Thought, ThoughtSchema, type Tool, type ToolCall, type ToolCallRecord, ToolCallRecordSchema, ToolCallSchema, type ToolDefinition, type ToolErrorPayload, type ToolExample, type ToolExecutionContext, type ToolExecutionSummary, ToolExecutionSummarySchema, type ToolFailure, type ToolFunction, ToolMetadataSchema, type ToolOptions, type ToolProvider, type ToolResult, type ToolResultData, ToolResultFactory, ToolResultFailureSchema, type ToolResultInit, ToolResultSchema, ToolResultSuccessSchema, type ToolRunOptions, ToolRunner, type ToolSuccess, type UnregisterHook, type Usage, UsageSchema, type VisualizationOptions, addUsage, coerceToolDefinition, createAgentDecisionWithOutputSchema, createEmptyUsage, createFunctionTool, createHookManager, createInMemoryStore, createMCPServerConfig, createOpperClient, createStreamAssembler, createToolCallRecord, err, extractTools, generateAgentFlowDiagram, getDefaultLogger, getSchemaDefault, isSchemaValid, isToolProvider, mcp, mergeSchemaDefaults, normalizeToolEntries, ok, schemaToJson, setDefaultLogger, tool, validateSchema, validateToolInput, zodSchemaToJsonSchema };

package/dist/index.js

@@ -242,6 +242,7 @@ var init_context = __esm({
       metadata;
       startedAt;
       updatedAt;
+      pendingSpanUpdates = [];
       constructor(options) {
         const now = Date.now();
         this.agentName = options.agentName;
@@ -1634,7 +1635,7 @@ var mergeSchemaDefaults = (schema, value) => {
 
 // package.json
 var package_default = {
-  version: "0.6.0"};
+  version: "0.7.0"};
 
 // src/utils/version.ts
 var SDK_NAME = "@opperai/agents";
@@ -2144,6 +2145,30 @@ var Agent = class extends BaseAgent {
     }
     return String(input);
   }
+  queueSpanUpdate(context, update) {
+    context.pendingSpanUpdates.push(update);
+  }
+  async flushPendingSpanUpdates(context) {
+    const updates = context.pendingSpanUpdates.splice(
+      0,
+      context.pendingSpanUpdates.length
+    );
+    if (updates.length === 0) {
+      return;
+    }
+    await Promise.allSettled(
+      updates.map((update) => {
+        const options = {
+          ...update.error !== void 0 && { error: update.error },
+          ...update.startTime && { startTime: update.startTime },
+          ...update.endTime && { endTime: update.endTime },
+          ...update.meta && { meta: update.meta },
+          ...update.name && { name: update.name }
+        };
+        return this.opperClient.updateSpan(update.spanId, update.output, options);
+      })
+    );
+  }
   /**
    * Main agent loop: think → tool execution → memory handling → repeat until complete
    */
@@ -2205,7 +2230,9 @@ var Agent = class extends BaseAgent {
               }
             }
             const executionEndTime2 = /* @__PURE__ */ new Date();
-            await this.opperClient.updateSpan(parentSpan.id, finalResult, {
+            this.queueSpanUpdate(context, {
+              spanId: parentSpan.id,
+              output: finalResult,
               startTime: executionStartTime,
               endTime: executionEndTime2,
               meta: {
@@ -2260,7 +2287,9 @@ var Agent = class extends BaseAgent {
       }
       const result = await this.generateFinalResult(input, context);
       const executionEndTime = /* @__PURE__ */ new Date();
-      await this.opperClient.updateSpan(parentSpan.id, result, {
+      this.queueSpanUpdate(context, {
+        spanId: parentSpan.id,
+        output: result,
         startTime: executionStartTime,
         endTime: executionEndTime,
         meta: {
@@ -2270,7 +2299,8 @@ var Agent = class extends BaseAgent {
       return result;
     } catch (error) {
       const executionEndTime = /* @__PURE__ */ new Date();
-      await this.opperClient.updateSpan(parentSpan.id, void 0, {
+      this.queueSpanUpdate(context, {
+        spanId: parentSpan.id,
         error: error instanceof Error ? error.message : String(error),
         startTime: executionStartTime,
         endTime: executionEndTime,
@@ -2279,6 +2309,8 @@ var Agent = class extends BaseAgent {
         }
       });
       throw error;
+    } finally {
+      await this.flushPendingSpanUpdates(context);
     }
   }
   /**
@@ -2322,7 +2354,8 @@ var Agent = class extends BaseAgent {
         response
       });
       if (response.spanId) {
-        await this.opperClient.updateSpan(response.spanId, void 0, {
+        this.queueSpanUpdate(context, {
+          spanId: response.spanId,
           name: "think"
         });
       }
@@ -2433,7 +2466,8 @@ var Agent = class extends BaseAgent {
         parsed: decision
       });
       if (streamSpanId) {
-        await this.opperClient.updateSpan(streamSpanId, void 0, {
+        this.queueSpanUpdate(context, {
+          spanId: streamSpanId,
           name: "think"
         });
       }
@@ -2619,13 +2653,16 @@ The memory you write persists across all process() calls on this agent.`;
         const endTime = /* @__PURE__ */ new Date();
         const durationMs = endTime.getTime() - startTime.getTime();
         if (result.success) {
-          await this.opperClient.updateSpan(toolSpan.id, result.output, {
+          this.queueSpanUpdate(context, {
+            spanId: toolSpan.id,
+            output: result.output,
             startTime,
             endTime,
             meta: { durationMs }
           });
         } else {
-          await this.opperClient.updateSpan(toolSpan.id, void 0, {
+          this.queueSpanUpdate(context, {
+            spanId: toolSpan.id,
             error: result.error instanceof Error ? result.error.message : String(result.error),
             startTime,
             endTime,
@@ -2651,7 +2688,8 @@ The memory you write persists across all process() calls on this agent.`;
       } catch (error) {
         const endTime = /* @__PURE__ */ new Date();
         const durationMs = endTime.getTime() - startTime.getTime();
-        await this.opperClient.updateSpan(toolSpan.id, void 0, {
+        this.queueSpanUpdate(context, {
+          spanId: toolSpan.id,
           error: error instanceof Error ? error.message : String(error),
           startTime,
           endTime,
@@ -2712,7 +2750,9 @@ The memory you write persists across all process() calls on this agent.`;
           const memoryData = await this.memory.read(keys);
           const endTime = /* @__PURE__ */ new Date();
           const durationMs = endTime.getTime() - startTime.getTime();
-          await this.opperClient.updateSpan(memoryReadSpan.id, memoryData, {
+          this.queueSpanUpdate(context, {
+            spanId: memoryReadSpan.id,
+            output: memoryData,
             startTime,
             endTime,
             meta: { durationMs }
@@ -2779,15 +2819,13 @@ The memory you write persists across all process() calls on this agent.`;
         }
         const endTime = /* @__PURE__ */ new Date();
         const durationMs = endTime.getTime() - startTime.getTime();
-        await this.opperClient.updateSpan(
-          memoryWriteSpan.id,
-          `Successfully wrote ${updateEntries.length} keys`,
-          {
-            startTime,
-            endTime,
-            meta: { durationMs }
-          }
-        );
+        this.queueSpanUpdate(context, {
+          spanId: memoryWriteSpan.id,
+          output: `Successfully wrote ${updateEntries.length} keys`,
+          startTime,
+          endTime,
+          meta: { durationMs }
+        });
         this.log(`Wrote ${updateEntries.length} memory entries`);
         summaries.push(
           ToolExecutionSummarySchema.parse({