@robosystems/client 2.2.3 → 2.2.4

package/artifacts/OperatorClient.d.ts

@@ -95,6 +95,16 @@ export declare class OperatorClient {
      */
     close(): void;
 }
+/**
+ * A run that failed or was cancelled. `writes` lists what it had already
+ * changed on the graph before it stopped, so a caller can show a receipt
+ * rather than invite a retry that repeats them.
+ */
+export declare class OperatorRunError extends Error {
+    status: 'failed' | 'cancelled';
+    writes: Record<string, any>[];
+    constructor(message: string, status: 'failed' | 'cancelled', writes: Record<string, any>[]);
+}
 /**
  * Error thrown when agent execution is queued and maxWait is 0
  */

package/artifacts/OperatorClient.js

@@ -1,7 +1,7 @@
 'use client';
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueuedOperatorError = exports.OperatorClient = void 0;
+exports.QueuedOperatorError = exports.OperatorRunError = exports.OperatorClient = void 0;
 /**
  * Enhanced AI Operator Client with SSE support
  * Provides intelligent operator execution with automatic strategy selection
@@ -167,11 +167,11 @@ class OperatorClient {
             });
             sseClient.on(SSEClient_1.EventType.OPERATION_ERROR, (error) => {
                 finish();
-                reject(new Error(error.message || error.error));
+                reject(new OperatorRunError(error.message || error.error, 'failed', readWrites(error.error_details)));
             });
             sseClient.on(SSEClient_1.EventType.OPERATION_CANCELLED, () => {
                 finish();
-                reject(new Error('Agent execution cancelled'));
+                reject(new OperatorRunError('Agent execution cancelled', 'cancelled', []));
             });
             // Handle generic error event
             sseClient.on('error', (error) => {
@@ -225,9 +225,9 @@ class OperatorClient {
                 case 'completed':
                     return toOperatorResult(status.result || {});
                 case 'failed':
-                    throw new Error(status.error || status.message || 'Operator run failed');
+                    throw new OperatorRunError(status.error || status.message || 'Operator run failed', 'failed', readWrites(status));
                 case 'cancelled':
-                    throw new Error('Agent execution cancelled');
+                    throw new OperatorRunError('Agent execution cancelled', 'cancelled', readWrites(status.result));
                 default:
                     if (status.message) {
                         options.onProgress?.(status.message);
@@ -253,6 +253,26 @@ class OperatorClient {
     }
 }
 exports.OperatorClient = OperatorClient;
+/**
+ * A run that failed or was cancelled. `writes` lists what it had already
+ * changed on the graph before it stopped, so a caller can show a receipt
+ * rather than invite a retry that repeats them.
+ */
+class OperatorRunError extends Error {
+    constructor(message, status, writes) {
+        super(message);
+        this.status = status;
+        this.writes = writes;
+        this.name = 'OperatorRunError';
+    }
+}
+exports.OperatorRunError = OperatorRunError;
+const readWrites = (source) => {
+    const writes = source?.writes;
+    return Array.isArray(writes)
+        ? writes.filter((w) => !!w && typeof w === 'object')
+        : [];
+};
 /**
  * Error thrown when agent execution is queued and maxWait is 0
  */

package/artifacts/OperatorClient.ts

@@ -271,12 +271,18 @@ export class OperatorClient {
 
       sseClient.on(EventType.OPERATION_ERROR, (error) => {
         finish()
-        reject(new Error(error.message || error.error))
+        reject(
+          new OperatorRunError(
+            error.message || error.error,
+            'failed',
+            readWrites(error.error_details)
+          )
+        )
       })
 
       sseClient.on(EventType.OPERATION_CANCELLED, () => {
         finish()
-        reject(new Error('Agent execution cancelled'))
+        reject(new OperatorRunError('Agent execution cancelled', 'cancelled', []))
       })
 
       // Handle generic error event
@@ -345,9 +351,17 @@ export class OperatorClient {
         case 'completed':
           return toOperatorResult(status.result || {})
         case 'failed':
-          throw new Error(status.error || status.message || 'Operator run failed')
+          throw new OperatorRunError(
+            status.error || status.message || 'Operator run failed',
+            'failed',
+            readWrites(status)
+          )
         case 'cancelled':
-          throw new Error('Agent execution cancelled')
+          throw new OperatorRunError(
+            'Agent execution cancelled',
+            'cancelled',
+            readWrites(status.result)
+          )
         default:
           if (status.message) {
             options.onProgress?.(status.message)
@@ -379,6 +393,29 @@ export class OperatorClient {
   }
 }
 
+/**
+ * A run that failed or was cancelled. `writes` lists what it had already
+ * changed on the graph before it stopped, so a caller can show a receipt
+ * rather than invite a retry that repeats them.
+ */
+export class OperatorRunError extends Error {
+  constructor(
+    message: string,
+    public status: 'failed' | 'cancelled',
+    public writes: Record<string, any>[]
+  ) {
+    super(message)
+    this.name = 'OperatorRunError'
+  }
+}
+
+const readWrites = (source: unknown): Record<string, any>[] => {
+  const writes = (source as { writes?: unknown } | null | undefined)?.writes
+  return Array.isArray(writes)
+    ? writes.filter((w): w is Record<string, any> => !!w && typeof w === 'object')
+    : []
+}
+
 /**
  * Error thrown when agent execution is queued and maxWait is 0
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robosystems/client",
-  "version": "2.2.3",
+  "version": "2.2.4",
   "description": "TypeScript client library for the RoboSystems financial intelligence platform",
   "main": "index.js",
   "types": "index.d.ts",