@opperai/agents 0.4.0 → 0.5.0

package/dist/index.d.cts

@@ -574,7 +574,9 @@ declare class AgentContext {
      */
     cleanupBreakdownIfOnlyParent(parentAgentName: string): void;
     addCycle(cycle: ExecutionCycle): ExecutionCycle;
-    recordToolCall(call: Omit<ToolCallRecord, "id">): ToolCallRecord;
+    recordToolCall(call: Omit<ToolCallRecord, "id"> & {
+        id?: string;
+    }): ToolCallRecord;
     getContextSize(): number;
     getLastNCycles(count?: number): ExecutionCycle[];
     getLastIterationsSummary(count?: number): IterationSummary[];
@@ -706,6 +708,7 @@ interface HookPayloadMap {
         context: AgentContext;
         tool: Tool<unknown, unknown>;
         input: unknown;
+        toolCallId: string;
     };
     [HookEvents.AfterTool]: {
         context: AgentContext;
@@ -718,6 +721,7 @@ interface HookPayloadMap {
         toolName: string;
         tool?: Tool<unknown, unknown>;
         error: unknown;
+        toolCallId: string;
     };
     [HookEvents.MemoryRead]: {
         context: AgentContext;
@@ -1557,6 +1561,12 @@ declare class OpperClient {
     constructor(apiKey?: string, options?: {
         logger?: AgentLogger;
         retryConfig?: Partial<RetryConfig>;
+        /**
+         * Override the default Opper API server URL.
+         * Useful for local development or self-hosted deployments.
+         * Example: "http://127.0.0.1:8000/v2"
+         */
+        baseUrl?: string;
     });
     /**
      * Make a call to Opper with retry logic
@@ -1607,6 +1617,12 @@ declare class OpperClient {
 declare function createOpperClient(apiKey?: string, options?: {
     logger?: AgentLogger;
     retryConfig?: Partial<RetryConfig>;
+    /**
+     * Override the default Opper API server URL.
+     * Useful for local development or self-hosted deployments.
+     * Example: "http://127.0.0.1:8000/v2"
+     */
+    baseUrl?: string;
 }): OpperClient;
 
 /**

package/dist/index.d.ts

@@ -574,7 +574,9 @@ declare class AgentContext {
      */
     cleanupBreakdownIfOnlyParent(parentAgentName: string): void;
     addCycle(cycle: ExecutionCycle): ExecutionCycle;
-    recordToolCall(call: Omit<ToolCallRecord, "id">): ToolCallRecord;
+    recordToolCall(call: Omit<ToolCallRecord, "id"> & {
+        id?: string;
+    }): ToolCallRecord;
     getContextSize(): number;
     getLastNCycles(count?: number): ExecutionCycle[];
     getLastIterationsSummary(count?: number): IterationSummary[];
@@ -706,6 +708,7 @@ interface HookPayloadMap {
         context: AgentContext;
         tool: Tool<unknown, unknown>;
         input: unknown;
+        toolCallId: string;
     };
     [HookEvents.AfterTool]: {
         context: AgentContext;
@@ -718,6 +721,7 @@ interface HookPayloadMap {
         toolName: string;
         tool?: Tool<unknown, unknown>;
         error: unknown;
+        toolCallId: string;
     };
     [HookEvents.MemoryRead]: {
         context: AgentContext;
@@ -1557,6 +1561,12 @@ declare class OpperClient {
     constructor(apiKey?: string, options?: {
         logger?: AgentLogger;
         retryConfig?: Partial<RetryConfig>;
+        /**
+         * Override the default Opper API server URL.
+         * Useful for local development or self-hosted deployments.
+         * Example: "http://127.0.0.1:8000/v2"
+         */
+        baseUrl?: string;
     });
     /**
      * Make a call to Opper with retry logic
@@ -1607,6 +1617,12 @@ declare class OpperClient {
 declare function createOpperClient(apiKey?: string, options?: {
     logger?: AgentLogger;
     retryConfig?: Partial<RetryConfig>;
+    /**
+     * Override the default Opper API server URL.
+     * Useful for local development or self-hosted deployments.
+     * Example: "http://127.0.0.1:8000/v2"
+     */
+    baseUrl?: string;
 }): OpperClient;
 
 /**

package/dist/index.js

@@ -1007,7 +1007,7 @@ var BaseAgent = class {
     }
     this.opperConfig = {
       apiKey: config.opperConfig?.apiKey ?? process.env["OPPER_API_KEY"],
-      baseUrl: config.opperConfig?.baseUrl,
+      baseUrl: config.opperConfig?.baseUrl ?? process.env["OPPER_BASE_URL"],
       ...config.opperConfig
     };
     this.memory = this.initializeMemory(config);
@@ -1270,6 +1270,7 @@ var BaseAgent = class {
    * @returns Tool execution result
    */
   async executeTool(toolName, input, context, options) {
+    const toolCallId = randomUUID();
     const tool2 = this.tools.get(toolName);
     if (!tool2) {
       const failure = ToolResultFactory.failure(
@@ -1278,6 +1279,7 @@ var BaseAgent = class {
       );
       const timestamp = Date.now();
       context.recordToolCall({
+        id: toolCallId,
         toolName,
         input,
         success: false,
@@ -1289,7 +1291,8 @@ var BaseAgent = class {
       await this.triggerHook(HookEvents.ToolError, {
         context,
         toolName,
-        error: failure.error
+        error: failure.error,
+        toolCallId
       });
       return failure;
     }
@@ -1304,11 +1307,13 @@ var BaseAgent = class {
       await this.triggerHook(HookEvents.BeforeTool, {
         context,
         tool: tool2,
-        input
+        input,
+        toolCallId
       });
       const result = await tool2.execute(input, executionContext);
       const finishedAt = Date.now();
       const record = context.recordToolCall({
+        id: toolCallId,
         toolName: tool2.name,
         input,
         ...result.success && { output: result.output },
@@ -1320,6 +1325,15 @@ var BaseAgent = class {
         finishedAt,
         metadata: {}
       });
+      if (!result.success) {
+        await this.triggerHook(HookEvents.ToolError, {
+          context,
+          tool: tool2,
+          toolName: tool2.name,
+          error: result.error,
+          toolCallId
+        });
+      }
       await this.triggerHook(HookEvents.AfterTool, {
         context,
         tool: tool2,
@@ -1337,6 +1351,7 @@ var BaseAgent = class {
         }
       );
       const record = context.recordToolCall({
+        id: toolCallId,
         toolName: tool2.name,
         input,
         success: false,
@@ -1349,7 +1364,8 @@ var BaseAgent = class {
         context,
         tool: tool2,
         toolName: tool2.name,
-        error
+        error,
+        toolCallId
       });
       await this.triggerHook(HookEvents.AfterTool, {
         context,
@@ -1618,7 +1634,7 @@ var mergeSchemaDefaults = (schema, value) => {
 
 // package.json
 var package_default = {
-  version: "0.4.0"};
+  version: "0.5.0"};
 
 // src/utils/version.ts
 var SDK_NAME = "@opperai/agents";
@@ -1666,7 +1682,8 @@ var OpperClient = class {
   constructor(apiKey, options = {}) {
     this.client = new Opper({
       httpBearer: apiKey ?? process.env["OPPER_HTTP_BEARER"] ?? "",
-      userAgent: getUserAgent()
+      userAgent: getUserAgent(),
+      ...options.baseUrl && { serverURL: options.baseUrl }
     });
     this.logger = options.logger ?? getDefaultLogger();
     this.retryConfig = {
@@ -2111,7 +2128,8 @@ var Agent = class extends BaseAgent {
       }
     }
     this.opperClient = config.opperClient ?? new OpperClient(this.opperConfig.apiKey, {
-      logger: this.logger
+      logger: this.logger,
+      ...this.opperConfig.baseUrl && { baseUrl: this.opperConfig.baseUrl }
     });
   }
   /**
@@ -3379,6 +3397,11 @@ var mcp = (...configs) => {
 
 // src/utils/tool-decorators.ts
 init_tool();
+var isToolResult = (value) => {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return typeof obj["success"] === "boolean" && typeof obj["toolName"] === "string" && ("output" in obj || "error" in obj);
+};
 var reflectWithMetadata = Reflect;
 var ReflectMetadata = {
   define: (metadataKey, metadataValue, target, propertyKey) => {
@@ -3508,6 +3531,9 @@ function createFunctionTool(fn, options = {}) {
         } else {
           result = await Promise.resolve(fn(input, context));
         }
+        if (isToolResult(result)) {
+          return result;
+        }
         return ToolResultFactory.success(name, result, {
           startedAt,
           finishedAt: Date.now(),