@cadraos/sdk 0.3.5 → 0.3.7

package/dist/index.d.cts

@@ -41,6 +41,8 @@ interface HttpClientConfig {
     retry: RetryConfig;
     /** Custom headers */
     headers?: Record<string, string>;
+    /** Optional fetch implementation — inject `expo/fetch` for React Native streaming. Defaults to global fetch. */
+    fetch?: typeof fetch;
 }
 /**
  * Request options
@@ -986,6 +988,8 @@ interface RemoteAgentCreateInput {
     name: string;
     description?: string;
     adapterType: string;
+    /** Bind the agent to a specific runner (e.g. a Cadra Desktop install). */
+    defaultRunnerId?: number | null;
     executionTargetKind?: RemoteAgentExecutionTargetKind;
     adapterConfig?: Record<string, unknown>;
     inputSchema?: Record<string, unknown>;
@@ -996,6 +1000,8 @@ interface RemoteAgentUpdateInput {
     name?: string;
     description?: string;
     adapterType?: string;
+    /** Re-bind the agent to a specific runner. */
+    defaultRunnerId?: number | null;
     executionTargetKind?: RemoteAgentExecutionTargetKind;
     adapterConfig?: Record<string, unknown>;
     inputSchema?: Record<string, unknown>;
@@ -1541,6 +1547,8 @@ interface ExecutionStreamControllerOptions {
     orgId: number;
     /** Function to get execution status (for polling fallback) */
     getExecution: (executionId: string) => Promise<AgentExecution>;
+    /** Optional fetch implementation — inject `expo/fetch` for React Native streaming. Defaults to global fetch. */
+    fetch?: typeof fetch;
     /** Streaming configuration */
     config?: Partial<StreamingConfig>;
     /** Whether polling fallback is enabled (default: true) */
@@ -1880,6 +1888,8 @@ interface StreamConfig {
     token?: string;
     tokenProvider?: () => Promise<string>;
     orgId: number;
+    /** Optional fetch implementation — inject `expo/fetch` for React Native streaming. Defaults to global fetch. */
+    fetch?: typeof fetch;
 }
 
 /**
@@ -3207,6 +3217,8 @@ interface CadraClientOptionsApiKey {
     maxRetries?: number;
     /** Custom headers to include in all requests */
     headers?: Record<string, string>;
+    /** Optional fetch implementation — inject `expo/fetch` for React Native streaming. Defaults to global fetch. */
+    fetch?: typeof fetch;
 }
 /**
  * Client options for OAuth token authentication
@@ -3224,6 +3236,8 @@ interface CadraClientOptionsToken {
     maxRetries?: number;
     /** Custom headers to include in all requests */
     headers?: Record<string, string>;
+    /** Optional fetch implementation — inject `expo/fetch` for React Native streaming. Defaults to global fetch. */
+    fetch?: typeof fetch;
 }
 /**
  * Client options for token provider authentication
@@ -3241,6 +3255,8 @@ interface CadraClientOptionsTokenProvider {
     maxRetries?: number;
     /** Custom headers to include in all requests */
     headers?: Record<string, string>;
+    /** Optional fetch implementation — inject `expo/fetch` for React Native streaming. Defaults to global fetch. */
+    fetch?: typeof fetch;
 }
 /**
  * All client options

package/dist/index.d.ts

@@ -41,6 +41,8 @@ interface HttpClientConfig {
     retry: RetryConfig;
     /** Custom headers */
     headers?: Record<string, string>;
+    /** Optional fetch implementation — inject `expo/fetch` for React Native streaming. Defaults to global fetch. */
+    fetch?: typeof fetch;
 }
 /**
  * Request options
@@ -986,6 +988,8 @@ interface RemoteAgentCreateInput {
     name: string;
     description?: string;
     adapterType: string;
+    /** Bind the agent to a specific runner (e.g. a Cadra Desktop install). */
+    defaultRunnerId?: number | null;
     executionTargetKind?: RemoteAgentExecutionTargetKind;
     adapterConfig?: Record<string, unknown>;
     inputSchema?: Record<string, unknown>;
@@ -996,6 +1000,8 @@ interface RemoteAgentUpdateInput {
     name?: string;
     description?: string;
     adapterType?: string;
+    /** Re-bind the agent to a specific runner. */
+    defaultRunnerId?: number | null;
     executionTargetKind?: RemoteAgentExecutionTargetKind;
     adapterConfig?: Record<string, unknown>;
     inputSchema?: Record<string, unknown>;
@@ -1541,6 +1547,8 @@ interface ExecutionStreamControllerOptions {
     orgId: number;
     /** Function to get execution status (for polling fallback) */
     getExecution: (executionId: string) => Promise<AgentExecution>;
+    /** Optional fetch implementation — inject `expo/fetch` for React Native streaming. Defaults to global fetch. */
+    fetch?: typeof fetch;
     /** Streaming configuration */
     config?: Partial<StreamingConfig>;
     /** Whether polling fallback is enabled (default: true) */
@@ -1880,6 +1888,8 @@ interface StreamConfig {
     token?: string;
     tokenProvider?: () => Promise<string>;
     orgId: number;
+    /** Optional fetch implementation — inject `expo/fetch` for React Native streaming. Defaults to global fetch. */
+    fetch?: typeof fetch;
 }
 
 /**
@@ -3207,6 +3217,8 @@ interface CadraClientOptionsApiKey {
     maxRetries?: number;
     /** Custom headers to include in all requests */
     headers?: Record<string, string>;
+    /** Optional fetch implementation — inject `expo/fetch` for React Native streaming. Defaults to global fetch. */
+    fetch?: typeof fetch;
 }
 /**
  * Client options for OAuth token authentication
@@ -3224,6 +3236,8 @@ interface CadraClientOptionsToken {
     maxRetries?: number;
     /** Custom headers to include in all requests */
     headers?: Record<string, string>;
+    /** Optional fetch implementation — inject `expo/fetch` for React Native streaming. Defaults to global fetch. */
+    fetch?: typeof fetch;
 }
 /**
  * Client options for token provider authentication
@@ -3241,6 +3255,8 @@ interface CadraClientOptionsTokenProvider {
     maxRetries?: number;
     /** Custom headers to include in all requests */
     headers?: Record<string, string>;
+    /** Optional fetch implementation — inject `expo/fetch` for React Native streaming. Defaults to global fetch. */
+    fetch?: typeof fetch;
 }
 /**
  * All client options

package/dist/index.js

@@ -293,7 +293,8 @@ var HttpClient = class {
       const controller = new AbortController();
       const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
       try {
-        const response = await fetch(url, {
+        const doFetch = this.config.fetch ?? fetch;
+        const response = await doFetch(url, {
           method: options.method,
           headers,
           body: options.body !== void 0 ? JSON.stringify(options.body) : void 0,
@@ -425,7 +426,8 @@ var SSEClient = class {
     console.log("[SDK:SSE] Auth header:", this.config.authHeader ? `${this.config.authHeader.substring(0, 30)}...` : "MISSING");
     console.log("[SDK:SSE] Org ID:", this.config.orgId);
     try {
-      const response = await fetch(this.config.url, {
+      const doFetch = this.config.fetch ?? fetch;
+      const response = await doFetch(this.config.url, {
         method: "GET",
         headers: {
           "Authorization": this.config.authHeader,
@@ -673,6 +675,15 @@ var ExecutionStreamControllerImpl = class {
   sseClient = null;
   status = "connecting";
   reconnectAttempts = 0;
+  // CAD-39 / webchat dual-plane create-connect race. `hasConnected` flips true on
+  // the first successful SSE open; `notFoundRetries` bounds retries of a 404
+  // encountered BEFORE we ever connect (the run row is persisted slightly AFTER
+  // the client opens the stream — the norm on the webchat path where msg-api owns
+  // the executionId and cadra persists the agent_executions row via an async
+  // worker callback). See handleConnectionError.
+  hasConnected = false;
+  notFoundRetries = 0;
+  maxConnectRaceRetries = 3;
   seenEventIds = /* @__PURE__ */ new Set();
   _lastEventId = null;
   activityTimeoutId = null;
@@ -801,6 +812,7 @@ var ExecutionStreamControllerImpl = class {
       url,
       authHeader: `Bearer ${authToken}`,
       orgId: this.options.orgId,
+      fetch: this.options.fetch,
       onEvent: (event) => this.handleEvent(event),
       onError: (error) => {
         console.error("[SDK:StreamController] SSE error:", error);
@@ -811,6 +823,8 @@ var ExecutionStreamControllerImpl = class {
         if (connected) {
           this.status = "connected";
           this.reconnectAttempts = 0;
+          this.hasConnected = true;
+          this.notFoundRetries = 0;
           this.resetActivityTimeout();
         }
         this.emit("connectionChange", { connected, usingFallback: false });
@@ -1100,6 +1114,38 @@ var ExecutionStreamControllerImpl = class {
       return;
     }
     const msg = error instanceof Error ? error.message : String(error);
+    const isNotFound = /\b404\b/.test(msg);
+    const isAuthFailure = /\b40[13]\b/.test(msg) || /INVALID_API_KEY|INVALID_REQUEST/.test(msg);
+    if (isNotFound && !isAuthFailure && !this.hasConnected) {
+      if (this.notFoundRetries < this.maxConnectRaceRetries) {
+        this.notFoundRetries++;
+        this.status = "reconnecting";
+        const delay = Math.min(
+          this.config.reconnectBaseDelayMs * this.notFoundRetries,
+          this.config.reconnectMaxDelayMs
+        );
+        await new Promise((resolve) => setTimeout(resolve, delay));
+        if (this.status === "closed") {
+          return;
+        }
+        try {
+          await this.connectSSE();
+        } catch (retryError) {
+          await this.handleConnectionError(retryError);
+        }
+        return;
+      }
+      if (this.pollingEnabled) {
+        if (this.sseClient) {
+          this.sseClient.disconnect();
+          this.sseClient = null;
+        }
+        this.status = "fallback_polling";
+        this.emit("connectionChange", { connected: false, usingFallback: true });
+        this.startPolling();
+        return;
+      }
+    }
     if (/\b4\d\d\b/.test(msg) || /INVALID_API_KEY|INVALID_REQUEST/.test(msg)) {
       if (this.sseClient) {
         this.sseClient.disconnect();
@@ -1478,6 +1524,7 @@ var AgentsAPI = class extends BaseResourceAPI {
       apiKey: config.apiKey,
       tokenProvider: config.tokenProvider,
       orgId: config.orgId,
+      fetch: config.fetch,
       getExecution: (id) => this.getExecution(id)
     });
     console.log("[SDK:Agents] Stream controller created - caller must call connect() after registering listeners");
@@ -1524,6 +1571,7 @@ var AgentsAPI = class extends BaseResourceAPI {
       apiKey: config.apiKey,
       tokenProvider: config.tokenProvider,
       orgId: config.orgId,
+      fetch: config.fetch,
       getExecution: (id) => this.getExecution(id)
     });
     console.log("[SDK:Agents] Stream controller created for existing execution - caller must call connect() after registering listeners");
@@ -2372,6 +2420,7 @@ var SessionsAPI = class extends BaseResourceAPI {
       baseUrl: config.baseUrl,
       apiKey: config.apiKey,
       orgId: config.orgId,
+      fetch: config.fetch,
       getExecution: (id) => this.getExecution(id)
     });
     await controller.connect();
@@ -3026,7 +3075,8 @@ var CadraClient = class {
       baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
       orgId: options.orgId,
       timeout: options.timeout ?? DEFAULT_TIMEOUT,
-      headers: options.headers
+      headers: options.headers,
+      fetch: options.fetch
     };
     if ("apiKey" in options) {
       this.config.apiKey = options.apiKey;
@@ -3047,7 +3097,8 @@ var CadraClient = class {
       orgId: this.config.orgId,
       timeout: this.config.timeout,
       retry: retryConfig,
-      headers: this.config.headers
+      headers: this.config.headers,
+      fetch: this.config.fetch
     };
     this.httpClient = new HttpClient(httpConfig);
     const getStreamConfig = () => ({
@@ -3055,7 +3106,8 @@ var CadraClient = class {
       apiKey: this.config.apiKey,
       token: this.config.token,
       tokenProvider: this.config.tokenProvider,
-      orgId: this.config.orgId
+      orgId: this.config.orgId,
+      fetch: this.config.fetch
     });
     this.agents = new AgentsAPI(this.httpClient, getStreamConfig);
     this.skills = new SkillsAPI(this.httpClient);