@cadraos/sdk 0.3.6 → 0.3.8

package/dist/chat/index.d.cts

@@ -1624,6 +1624,14 @@ interface AgentChatProps {
     onClarification?: (data: ClarificationData) => void;
     /** Initial messages to populate the chat */
     initialMessages?: ChatMessage$1[];
+    /**
+     * Extra messages MERGED into the rendered list by timestamp on every render
+     * (interleaved chronologically, deduped by id). Use for durable turns that
+     * arrive out-of-band on a separate delivery plane — e.g. human-operator /
+     * system replies in a webchat handoff — so they don't dock at the bottom.
+     * Unlike `initialMessages`, these are NOT seeded into internal state.
+     */
+    injectedMessages?: ChatMessage$1[];
     /** Placeholder text for the input */
     placeholder?: string;
     /** Welcome message shown when chat is empty */
@@ -1787,7 +1795,7 @@ interface AgentChatProps {
  * />
  * ```
  */
-declare function AgentChat({ agentId, teamId, sessionId, adapter, onMessage, onError, onSessionCreated, onSessionStart, onToolCall, onToolResult, onClarification, initialMessages, placeholder, welcomeMessage, renderWelcome, maxHeight, className, theme, layout, enableAttachments, enableMarkdown, showToolCalls, toolCallVerbosity, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, hideHeader, renderAboveInput, renderBelowMessages, renderMessage, renderToolCall, messageVariant, showThinking, showDelegation, showImages, pollingInterval, pollingEnabled, onDelegation, onAttachmentsReady, hideAvatars, agentName, hideHeaderWhileEmpty, hideTypingIndicator, onInputChange, onInputControlReady, }: AgentChatProps): react_jsx_runtime.JSX.Element;
+declare function AgentChat({ agentId, teamId, sessionId, adapter, onMessage, onError, onSessionCreated, onSessionStart, onToolCall, onToolResult, onClarification, initialMessages, placeholder, welcomeMessage, renderWelcome, maxHeight, className, theme, layout, enableAttachments, enableMarkdown, showToolCalls, toolCallVerbosity, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, hideHeader, renderAboveInput, renderBelowMessages, renderMessage, renderToolCall, messageVariant, showThinking, showDelegation, showImages, pollingInterval, pollingEnabled, onDelegation, onAttachmentsReady, hideAvatars, agentName, hideHeaderWhileEmpty, hideTypingIndicator, onInputChange, onInputControlReady, injectedMessages, }: AgentChatProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Retry utility with exponential backoff

package/dist/chat/index.d.ts

@@ -1624,6 +1624,14 @@ interface AgentChatProps {
     onClarification?: (data: ClarificationData) => void;
     /** Initial messages to populate the chat */
     initialMessages?: ChatMessage$1[];
+    /**
+     * Extra messages MERGED into the rendered list by timestamp on every render
+     * (interleaved chronologically, deduped by id). Use for durable turns that
+     * arrive out-of-band on a separate delivery plane — e.g. human-operator /
+     * system replies in a webchat handoff — so they don't dock at the bottom.
+     * Unlike `initialMessages`, these are NOT seeded into internal state.
+     */
+    injectedMessages?: ChatMessage$1[];
     /** Placeholder text for the input */
     placeholder?: string;
     /** Welcome message shown when chat is empty */
@@ -1787,7 +1795,7 @@ interface AgentChatProps {
  * />
  * ```
  */
-declare function AgentChat({ agentId, teamId, sessionId, adapter, onMessage, onError, onSessionCreated, onSessionStart, onToolCall, onToolResult, onClarification, initialMessages, placeholder, welcomeMessage, renderWelcome, maxHeight, className, theme, layout, enableAttachments, enableMarkdown, showToolCalls, toolCallVerbosity, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, hideHeader, renderAboveInput, renderBelowMessages, renderMessage, renderToolCall, messageVariant, showThinking, showDelegation, showImages, pollingInterval, pollingEnabled, onDelegation, onAttachmentsReady, hideAvatars, agentName, hideHeaderWhileEmpty, hideTypingIndicator, onInputChange, onInputControlReady, }: AgentChatProps): react_jsx_runtime.JSX.Element;
+declare function AgentChat({ agentId, teamId, sessionId, adapter, onMessage, onError, onSessionCreated, onSessionStart, onToolCall, onToolResult, onClarification, initialMessages, placeholder, welcomeMessage, renderWelcome, maxHeight, className, theme, layout, enableAttachments, enableMarkdown, showToolCalls, toolCallVerbosity, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, hideHeader, renderAboveInput, renderBelowMessages, renderMessage, renderToolCall, messageVariant, showThinking, showDelegation, showImages, pollingInterval, pollingEnabled, onDelegation, onAttachmentsReady, hideAvatars, agentName, hideHeaderWhileEmpty, hideTypingIndicator, onInputChange, onInputControlReady, injectedMessages, }: AgentChatProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Retry utility with exponential backoff

package/dist/chat/index.js

@@ -682,6 +682,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;
@@ -821,6 +830,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 });
@@ -1110,6 +1121,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();
@@ -1359,7 +1402,6 @@ var AgentsAPI = class extends BaseResourceAPI {
     super(http, "/api/v1/agents");
     this.getStreamConfig = getStreamConfig;
   }
-  getStreamConfig;
   // ===== LIST Operations =====
   /**
    * List all agents in the organization
@@ -2265,7 +2307,6 @@ var SessionsAPI = class extends BaseResourceAPI {
     super(http, "/api/v1/sessions");
     this.getStreamConfig = getStreamConfig;
   }
-  getStreamConfig;
   // ===== LIST Operations =====
   /**
    * List all sessions in the organization
@@ -2585,7 +2626,6 @@ var KanbanAPI = class extends BaseResourceAPI {
     super(http, "/api/v1/kanban");
     this.getStreamConfig = getStreamConfig;
   }
-  getStreamConfig;
   // ===== BOARD =====
   /**
    * Get the current org's board (lanes in declared order). Auto-provisions
@@ -2787,7 +2827,6 @@ var RemoteAgentsAPI = class extends BaseResourceAPI {
     super(http, "/api/v1/remote-agents");
     this.getStreamConfig = getStreamConfig;
   }
-  getStreamConfig;
   /**
    * List all remote agents in the organization
    *
@@ -8591,7 +8630,8 @@ function AgentChat({
   hideHeaderWhileEmpty = false,
   hideTypingIndicator = false,
   onInputChange,
-  onInputControlReady
+  onInputControlReady,
+  injectedMessages
 }) {
   const {
     messages,
@@ -8655,8 +8695,9 @@ function AgentChat({
     },
     [enableAttachments, attachments, sendMessage]
   );
+  const renderedMessages = injectedMessages && injectedMessages.length > 0 ? [...messages, ...injectedMessages].filter((m, i, arr) => arr.findIndex((x) => x.id === m.id) === i).sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime()) : messages;
   const messageListProps = {
-    messages,
+    messages: renderedMessages,
     welcomeMessage: hideHeader ? void 0 : welcomeMessage,
     renderWelcome: hideHeader ? void 0 : renderWelcome,
     isLoading,