@sagepilot-ai/react-native-sdk 0.2.3 → 0.2.4

package/README.md

@@ -313,12 +313,34 @@ SagepilotChat.present();
 SagepilotChat.presentMessages();
 SagepilotChat.presentMessageComposer("I need help with my order");
 SagepilotChat.presentMessageComposer("Start a new request", { mode: "new" });
+SagepilotChat.presentMessageComposer("I need help with this order", { chatId: savedChatId });
 ```
 
 `presentMessageComposer(message)` pre-fills the composer and lets Sagepilot reuse an existing conversation when one is available. If there is no existing conversation, Sagepilot starts a new one when the customer sends the message.
 
 Use `{ mode: "new" }` only when the button or workflow should always start a fresh conversation.
 
+Pass `{ chatId }` when an app-owned surface should reopen a specific conversation, such as an order help button. The SDK sends this as the hosted widget `chat_id` and keeps the existing no-`chatId` behavior unchanged.
+
+To store the chat id when a customer creates a conversation from a screen-specific composer:
+
+```ts
+SagepilotChat.presentMessageComposer("I need help with this order", {
+  metadata: { orderId: "10212984" },
+  onConversationCreated: ({ chat_id, metadata }) => {
+    // Store metadata.orderId -> chat_id in your app.
+  }
+});
+```
+
+You can also subscribe globally:
+
+```ts
+const unsubscribe = SagepilotChat.onConversationCreated(({ chat_id }) => {
+  // Persist chat_id for later use.
+});
+```
+
 ## Identity
 
 Call `identify()` when you know the signed-in app user.
@@ -380,11 +402,12 @@ await SagepilotChat.destroy();
 
 - `SagepilotChat.present()`: opens the hosted chat home screen.
 - `SagepilotChat.presentMessages()`: opens the hosted conversations/messages screen.
-- `SagepilotChat.presentMessageComposer(message?, options?)`: opens the message composer and optionally pre-fills the composer text. By default, Sagepilot reuses an existing conversation when one is available. Pass `{ mode: "new" }` to force a fresh conversation. It does not auto-send.
+- `SagepilotChat.presentMessageComposer(message?, options?)`: opens the message composer and optionally pre-fills the composer text. By default, Sagepilot reuses an existing conversation when one is available. Pass `{ mode: "new" }` to force a fresh conversation, or `{ chatId }` to open a specific conversation. It does not auto-send.
 - `SagepilotChat.dismiss()`: closes the hosted chat modal.
 - `SagepilotChat.hide()`: alias for `dismiss()`.
 - `SagepilotChat.toggle()`: opens the chat when closed and closes it when open.
 - `SagepilotChat.isPresented()`: returns whether the hosted chat modal is open.
+- `SagepilotChat.onConversationCreated(callback)`: subscribes to hosted conversations created from the React Native widget and returns `chat_id` plus any composer metadata.
 - `SagepilotChatProvider`: renders the hosted Sagepilot chat inside a React Native modal WebView.
 
 When `SagepilotChatProvider` is mounted, the SDK preloads a hidden hosted WebView after `configure()` so the first visible open can reuse warmed network/cache state. Disable this with `behavior.preloadWebView: false`.

package/dist/index.d.mts

@@ -217,6 +217,16 @@ type SagepilotMobileState = SagepilotLifecycleState & {
 };
 type SagepilotMobileSubscription = () => void;
 type SagepilotMessageComposerMode = "auto" | "new";
+type SagepilotConversationCreatedEvent = {
+    chat_id: string;
+    workspace_id?: string;
+    channel_id?: string;
+    session_id?: string;
+    customer_id?: string;
+    message_id?: string;
+    created_at?: string;
+    metadata?: Record<string, unknown>;
+};
 type SagepilotMessageComposerOptions = {
     /**
      * auto: prefill the composer and let the hosted widget reuse an existing
@@ -224,6 +234,20 @@ type SagepilotMessageComposerOptions = {
      * new: force the hosted widget to start a fresh conversation.
      */
     mode?: SagepilotMessageComposerMode;
+    /**
+     * Opens a specific hosted conversation. This value is treated as an opaque
+     * conversation handle and is verified by the hosted customer session.
+     */
+    chatId?: string;
+    /**
+     * App-owned metadata returned to the conversation-created callback so callers
+     * can persist mappings such as order_id -> chat_id.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Fires when this composer invocation creates a new conversation.
+     */
+    onConversationCreated?: (event: SagepilotConversationCreatedEvent) => void;
 };
 type SagepilotChatHookState = {
     configured: boolean;
@@ -240,6 +264,7 @@ type SagepilotChatHookState = {
     identify: (identity: SagepilotIdentity) => Promise<SagepilotIdentifyResult>;
     logout: () => Promise<SagepilotLogoutResponse>;
     getUnreadCount: () => Promise<number>;
+    onConversationCreated: (callback: (event: SagepilotConversationCreatedEvent) => void) => SagepilotMobileSubscription;
 };
 type SagepilotChatProviderProps = {
     children?: ReactNode;
@@ -259,6 +284,7 @@ declare const SagepilotChat: {
         pending: boolean;
     };
     onIdentify: (callback: Callback<SagepilotIdentifyResult>) => SagepilotMobileSubscription;
+    onConversationCreated: (callback: Callback<SagepilotConversationCreatedEvent>) => SagepilotMobileSubscription;
     getUnreadCount: () => Promise<number>;
     onUnreadChange: (callback: Callback<SagepilotUnreadState>) => SagepilotMobileSubscription;
     startUnreadPolling: (intervalMs?: number) => () => void;
@@ -316,4 +342,4 @@ declare function SagepilotChatProvider({ children, closeLabel, loadingLabel }: S
 
 declare function useSagepilotChat(): SagepilotChatHookState;
 
-export { type SagepilotBiometricsAdapter, type SagepilotBootstrapChannelResponse, type SagepilotCacheStorage, SagepilotChat, SagepilotChatError, type SagepilotChatErrorCode, type SagepilotChatHookState, SagepilotChatProvider, type SagepilotChatProviderProps, type SagepilotDeviceInfo, type SagepilotDeviceInfoAdapter, type SagepilotIdentifyResult, type SagepilotIdentity, type SagepilotIdentityState, type SagepilotLifecycleState, type SagepilotLogoutResponse, type SagepilotMobileBehaviorConfig, type SagepilotMobileColorScheme, type SagepilotMobileConfig, type SagepilotMobileConfigureResult, type SagepilotMobileLauncherConfig, type SagepilotMobilePresentationConfig, type SagepilotMobilePresentationStyle, type SagepilotMobileResolvedLauncherConfig, type SagepilotMobileState, type SagepilotMobileSubscription, type SagepilotMobileThemeConfig, type SagepilotMobileThemeState, type SagepilotSessionState, type SagepilotTokenStorage, type SagepilotUnreadState, createAsyncStorageCacheStorage, createKeychainTokenStorage, useSagepilotChat };
+export { type SagepilotBiometricsAdapter, type SagepilotBootstrapChannelResponse, type SagepilotCacheStorage, SagepilotChat, SagepilotChatError, type SagepilotChatErrorCode, type SagepilotChatHookState, SagepilotChatProvider, type SagepilotChatProviderProps, type SagepilotConversationCreatedEvent, type SagepilotDeviceInfo, type SagepilotDeviceInfoAdapter, type SagepilotIdentifyResult, type SagepilotIdentity, type SagepilotIdentityState, type SagepilotLifecycleState, type SagepilotLogoutResponse, type SagepilotMessageComposerOptions, type SagepilotMobileBehaviorConfig, type SagepilotMobileColorScheme, type SagepilotMobileConfig, type SagepilotMobileConfigureResult, type SagepilotMobileLauncherConfig, type SagepilotMobilePresentationConfig, type SagepilotMobilePresentationStyle, type SagepilotMobileResolvedLauncherConfig, type SagepilotMobileState, type SagepilotMobileSubscription, type SagepilotMobileThemeConfig, type SagepilotMobileThemeState, type SagepilotSessionState, type SagepilotTokenStorage, type SagepilotUnreadState, createAsyncStorageCacheStorage, createKeychainTokenStorage, useSagepilotChat };

package/dist/index.d.ts

@@ -217,6 +217,16 @@ type SagepilotMobileState = SagepilotLifecycleState & {
 };
 type SagepilotMobileSubscription = () => void;
 type SagepilotMessageComposerMode = "auto" | "new";
+type SagepilotConversationCreatedEvent = {
+    chat_id: string;
+    workspace_id?: string;
+    channel_id?: string;
+    session_id?: string;
+    customer_id?: string;
+    message_id?: string;
+    created_at?: string;
+    metadata?: Record<string, unknown>;
+};
 type SagepilotMessageComposerOptions = {
     /**
      * auto: prefill the composer and let the hosted widget reuse an existing
@@ -224,6 +234,20 @@ type SagepilotMessageComposerOptions = {
      * new: force the hosted widget to start a fresh conversation.
      */
     mode?: SagepilotMessageComposerMode;
+    /**
+     * Opens a specific hosted conversation. This value is treated as an opaque
+     * conversation handle and is verified by the hosted customer session.
+     */
+    chatId?: string;
+    /**
+     * App-owned metadata returned to the conversation-created callback so callers
+     * can persist mappings such as order_id -> chat_id.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Fires when this composer invocation creates a new conversation.
+     */
+    onConversationCreated?: (event: SagepilotConversationCreatedEvent) => void;
 };
 type SagepilotChatHookState = {
     configured: boolean;
@@ -240,6 +264,7 @@ type SagepilotChatHookState = {
     identify: (identity: SagepilotIdentity) => Promise<SagepilotIdentifyResult>;
     logout: () => Promise<SagepilotLogoutResponse>;
     getUnreadCount: () => Promise<number>;
+    onConversationCreated: (callback: (event: SagepilotConversationCreatedEvent) => void) => SagepilotMobileSubscription;
 };
 type SagepilotChatProviderProps = {
     children?: ReactNode;
@@ -259,6 +284,7 @@ declare const SagepilotChat: {
         pending: boolean;
     };
     onIdentify: (callback: Callback<SagepilotIdentifyResult>) => SagepilotMobileSubscription;
+    onConversationCreated: (callback: Callback<SagepilotConversationCreatedEvent>) => SagepilotMobileSubscription;
     getUnreadCount: () => Promise<number>;
     onUnreadChange: (callback: Callback<SagepilotUnreadState>) => SagepilotMobileSubscription;
     startUnreadPolling: (intervalMs?: number) => () => void;
@@ -316,4 +342,4 @@ declare function SagepilotChatProvider({ children, closeLabel, loadingLabel }: S
 
 declare function useSagepilotChat(): SagepilotChatHookState;
 
-export { type SagepilotBiometricsAdapter, type SagepilotBootstrapChannelResponse, type SagepilotCacheStorage, SagepilotChat, SagepilotChatError, type SagepilotChatErrorCode, type SagepilotChatHookState, SagepilotChatProvider, type SagepilotChatProviderProps, type SagepilotDeviceInfo, type SagepilotDeviceInfoAdapter, type SagepilotIdentifyResult, type SagepilotIdentity, type SagepilotIdentityState, type SagepilotLifecycleState, type SagepilotLogoutResponse, type SagepilotMobileBehaviorConfig, type SagepilotMobileColorScheme, type SagepilotMobileConfig, type SagepilotMobileConfigureResult, type SagepilotMobileLauncherConfig, type SagepilotMobilePresentationConfig, type SagepilotMobilePresentationStyle, type SagepilotMobileResolvedLauncherConfig, type SagepilotMobileState, type SagepilotMobileSubscription, type SagepilotMobileThemeConfig, type SagepilotMobileThemeState, type SagepilotSessionState, type SagepilotTokenStorage, type SagepilotUnreadState, createAsyncStorageCacheStorage, createKeychainTokenStorage, useSagepilotChat };
+export { type SagepilotBiometricsAdapter, type SagepilotBootstrapChannelResponse, type SagepilotCacheStorage, SagepilotChat, SagepilotChatError, type SagepilotChatErrorCode, type SagepilotChatHookState, SagepilotChatProvider, type SagepilotChatProviderProps, type SagepilotConversationCreatedEvent, type SagepilotDeviceInfo, type SagepilotDeviceInfoAdapter, type SagepilotIdentifyResult, type SagepilotIdentity, type SagepilotIdentityState, type SagepilotLifecycleState, type SagepilotLogoutResponse, type SagepilotMessageComposerOptions, type SagepilotMobileBehaviorConfig, type SagepilotMobileColorScheme, type SagepilotMobileConfig, type SagepilotMobileConfigureResult, type SagepilotMobileLauncherConfig, type SagepilotMobilePresentationConfig, type SagepilotMobilePresentationStyle, type SagepilotMobileResolvedLauncherConfig, type SagepilotMobileState, type SagepilotMobileSubscription, type SagepilotMobileThemeConfig, type SagepilotMobileThemeState, type SagepilotSessionState, type SagepilotTokenStorage, type SagepilotUnreadState, createAsyncStorageCacheStorage, createKeychainTokenStorage, useSagepilotChat };

package/dist/index.js

@@ -56,7 +56,7 @@ var SagepilotChatError = class extends Error {
 
 // src/core/config/constants.ts
 var SDK_NAME = "@sagepilot-ai/react-native-sdk";
-var SDK_VERSION = "0.2.3";
+var SDK_VERSION = "0.2.4";
 var DEFAULT_HOST = "https://app.sagepilot.ai";
 var DEFAULT_WIDGET_HOST = "https://app.sagepilot.ai";
 var CUSTOMER_API_PREFIX = "/customer-api/v1";
@@ -505,6 +505,18 @@ function normalizeIdentity(identity) {
     user_hash: identity.userHash ?? identity.user_hash
   };
 }
+function readStringField(input, key) {
+  const value = input[key];
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+function normalizeOptionalString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function readRecordField(input, key) {
+  const value = input[key];
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  return value;
+}
 function toPublicSessionState(session) {
   return {
     session_id: session.session_id,
@@ -538,6 +550,7 @@ var SagepilotReactNativeChat = class {
     this.unreadPollTimer = null;
     this.stateCallbacks = /* @__PURE__ */ new Set();
     this.identifyCallbacks = /* @__PURE__ */ new Set();
+    this.conversationCreatedCallbacks = /* @__PURE__ */ new Set();
     this.unreadCallbacks = /* @__PURE__ */ new Set();
     this.readyCallbacks = /* @__PURE__ */ new Set();
     this.presentCallbacks = /* @__PURE__ */ new Set();
@@ -744,7 +757,15 @@ var SagepilotReactNativeChat = class {
   }
   presentMessageComposer(message, options) {
     this.requireConfigured();
-    this.hostedChatView = { screen: "composer", message, mode: options?.mode ?? "auto" };
+    const chatId = normalizeOptionalString(options?.chatId);
+    this.hostedChatView = {
+      screen: "composer",
+      message,
+      mode: options?.mode ?? "auto",
+      chatId,
+      metadata: options?.metadata,
+      onConversationCreated: options?.onConversationCreated
+    };
     return this.showHostedChat();
   }
   dismiss() {
@@ -793,6 +814,13 @@ var SagepilotReactNativeChat = class {
       this.dismissCallbacks.delete(callback);
     };
   }
+  onConversationCreated(callback) {
+    if (typeof callback !== "function") return () => void 0;
+    this.conversationCreatedCallbacks.add(callback);
+    return () => {
+      this.conversationCreatedCallbacks.delete(callback);
+    };
+  }
   onError(callback) {
     if (typeof callback !== "function") return () => void 0;
     this.errorCallbacks.add(callback);
@@ -844,7 +872,10 @@ var SagepilotReactNativeChat = class {
       url.searchParams.set("jwt", this.legacyWidgetJwt);
     }
     if (this.hostedChatView.screen === "composer") {
-      if (this.hostedChatView.mode === "new") {
+      if (this.hostedChatView.chatId) {
+        url.searchParams.set("chat_id", this.hostedChatView.chatId);
+      }
+      if (this.hostedChatView.mode === "new" && !this.hostedChatView.chatId) {
         url.searchParams.set("new", "true");
       }
       if (this.hostedChatView.message) {
@@ -872,13 +903,19 @@ var SagepilotReactNativeChat = class {
       "})();"
     ].join("\n");
   }
+  getActiveHostedChatId() {
+    if (this.hostedChatView.screen === "composer" && this.hostedChatView.chatId) {
+      return this.hostedChatView.chatId;
+    }
+    return this.session?.conversation_id ?? void 0;
+  }
   getHostedIdentityMessage() {
     if (!this.legacyWidgetJwt) return null;
     return {
       type: "identity_update",
       data: {
         jwt: this.legacyWidgetJwt,
-        chat_id: this.session?.conversation_id ?? void 0
+        chat_id: this.getActiveHostedChatId()
       }
     };
   }
@@ -897,17 +934,62 @@ var SagepilotReactNativeChat = class {
       }
       return true;
     }
+    if (message.type === "sagepilot:conversation_created") {
+      this.handleConversationCreated(message);
+      return true;
+    }
     if (message.type === "sagepilot:error") {
       this.emitError(message);
       return true;
     }
     return true;
   }
+  handleConversationCreated(message) {
+    const chatId = readStringField(message, "chat_id") ?? readStringField(message, "conversation_id");
+    if (!chatId) return;
+    void this.persistConversationId(chatId).catch((error) => this.emitError(error));
+    const bridgeMetadata = readRecordField(message, "metadata");
+    const composerMetadata = this.hostedChatView.screen === "composer" ? this.hostedChatView.metadata : void 0;
+    const metadata = {
+      ...composerMetadata ?? {},
+      ...bridgeMetadata ?? {}
+    };
+    const workspaceId = readStringField(message, "workspace_id") ?? this.workspaceId;
+    const channelId = readStringField(message, "channel_id") ?? this.channelId;
+    const sessionId = readStringField(message, "session_id") ?? this.session?.session_id;
+    const customerId = readStringField(message, "customer_id");
+    const messageId = readStringField(message, "message_id");
+    const createdAt = readStringField(message, "created_at");
+    const event = {
+      chat_id: chatId,
+      ...workspaceId ? { workspace_id: workspaceId } : {},
+      ...channelId ? { channel_id: channelId } : {},
+      ...sessionId ? { session_id: sessionId } : {},
+      ...customerId ? { customer_id: customerId } : {},
+      ...messageId ? { message_id: messageId } : {},
+      ...createdAt ? { created_at: createdAt } : {},
+      ...Object.keys(metadata).length > 0 ? { metadata } : {}
+    };
+    if (this.hostedChatView.screen === "composer") {
+      this.hostedChatView.onConversationCreated?.(event);
+    }
+    this.conversationCreatedCallbacks.forEach((callback) => callback(event));
+  }
+  async persistConversationId(conversationId) {
+    if (!this.session || !this.sessionManager) return;
+    if (this.session.conversation_id === conversationId) return;
+    this.session = await this.sessionManager.setSession({
+      ...this.session,
+      conversation_id: conversationId
+    });
+    this.emitState();
+  }
   destroy() {
     this.stopUnreadPolling();
     this.resetRuntimeState();
     this.emitState();
     this.identifyCallbacks.clear();
+    this.conversationCreatedCallbacks.clear();
     this.unreadCallbacks.clear();
     this.readyCallbacks.clear();
     this.presentCallbacks.clear();
@@ -1070,6 +1152,9 @@ var SagepilotChat = {
   logout: () => internalSagepilotChat.logout(),
   getIdentityState: () => internalSagepilotChat.getIdentityState(),
   onIdentify: (callback) => internalSagepilotChat.onIdentify(callback),
+  onConversationCreated: (callback) => {
+    return internalSagepilotChat.onConversationCreated(callback);
+  },
   getUnreadCount: () => internalSagepilotChat.getUnreadCount(),
   onUnreadChange: (callback) => internalSagepilotChat.onUnreadChange(callback),
   startUnreadPolling: (intervalMs) => internalSagepilotChat.startUnreadPolling(intervalMs),
@@ -1262,11 +1347,17 @@ function readUrlOrigin(url) {
 var hostedChatWebViewProps = {
   allowFileAccess: true,
   allowFileAccessFromFileURLs: true,
+  ...import_react_native.Platform.OS === "ios" ? {
+    automaticallyAdjustContentInsets: false,
+    contentInsetAdjustmentBehavior: "never",
+    hideKeyboardAccessoryView: true
+  } : null,
   bounces: false,
   domStorageEnabled: true,
   javaScriptEnabled: true,
   overScrollMode: "never",
-  scrollEnabled: import_react_native.Platform.OS !== "android",
+  // The hosted widget owns feed scrolling internally; outer WebView scrolling lets iOS focus-scroll the page over the keyboard.
+  scrollEnabled: false,
   setSupportMultipleWindows: false,
   sharedCookiesEnabled: true,
   thirdPartyCookiesEnabled: true
@@ -1580,6 +1671,9 @@ function useSagepilotChat() {
   }, []);
   const logout = (0, import_react2.useCallback)(() => SagepilotChat.logout(), []);
   const getUnreadCount = (0, import_react2.useCallback)(() => SagepilotChat.getUnreadCount(), []);
+  const onConversationCreated = (0, import_react2.useCallback)((callback) => {
+    return SagepilotChat.onConversationCreated(callback);
+  }, []);
   return {
     ...state,
     present,
@@ -1590,7 +1684,8 @@ function useSagepilotChat() {
     toggle,
     identify,
     logout,
-    getUnreadCount
+    getUnreadCount,
+    onConversationCreated
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.mjs

@@ -15,7 +15,7 @@ var SagepilotChatError = class extends Error {
 
 // src/core/config/constants.ts
 var SDK_NAME = "@sagepilot-ai/react-native-sdk";
-var SDK_VERSION = "0.2.3";
+var SDK_VERSION = "0.2.4";
 var DEFAULT_HOST = "https://app.sagepilot.ai";
 var DEFAULT_WIDGET_HOST = "https://app.sagepilot.ai";
 var CUSTOMER_API_PREFIX = "/customer-api/v1";
@@ -464,6 +464,18 @@ function normalizeIdentity(identity) {
     user_hash: identity.userHash ?? identity.user_hash
   };
 }
+function readStringField(input, key) {
+  const value = input[key];
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+function normalizeOptionalString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function readRecordField(input, key) {
+  const value = input[key];
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  return value;
+}
 function toPublicSessionState(session) {
   return {
     session_id: session.session_id,
@@ -497,6 +509,7 @@ var SagepilotReactNativeChat = class {
     this.unreadPollTimer = null;
     this.stateCallbacks = /* @__PURE__ */ new Set();
     this.identifyCallbacks = /* @__PURE__ */ new Set();
+    this.conversationCreatedCallbacks = /* @__PURE__ */ new Set();
     this.unreadCallbacks = /* @__PURE__ */ new Set();
     this.readyCallbacks = /* @__PURE__ */ new Set();
     this.presentCallbacks = /* @__PURE__ */ new Set();
@@ -703,7 +716,15 @@ var SagepilotReactNativeChat = class {
   }
   presentMessageComposer(message, options) {
     this.requireConfigured();
-    this.hostedChatView = { screen: "composer", message, mode: options?.mode ?? "auto" };
+    const chatId = normalizeOptionalString(options?.chatId);
+    this.hostedChatView = {
+      screen: "composer",
+      message,
+      mode: options?.mode ?? "auto",
+      chatId,
+      metadata: options?.metadata,
+      onConversationCreated: options?.onConversationCreated
+    };
     return this.showHostedChat();
   }
   dismiss() {
@@ -752,6 +773,13 @@ var SagepilotReactNativeChat = class {
       this.dismissCallbacks.delete(callback);
     };
   }
+  onConversationCreated(callback) {
+    if (typeof callback !== "function") return () => void 0;
+    this.conversationCreatedCallbacks.add(callback);
+    return () => {
+      this.conversationCreatedCallbacks.delete(callback);
+    };
+  }
   onError(callback) {
     if (typeof callback !== "function") return () => void 0;
     this.errorCallbacks.add(callback);
@@ -803,7 +831,10 @@ var SagepilotReactNativeChat = class {
       url.searchParams.set("jwt", this.legacyWidgetJwt);
     }
     if (this.hostedChatView.screen === "composer") {
-      if (this.hostedChatView.mode === "new") {
+      if (this.hostedChatView.chatId) {
+        url.searchParams.set("chat_id", this.hostedChatView.chatId);
+      }
+      if (this.hostedChatView.mode === "new" && !this.hostedChatView.chatId) {
         url.searchParams.set("new", "true");
       }
       if (this.hostedChatView.message) {
@@ -831,13 +862,19 @@ var SagepilotReactNativeChat = class {
       "})();"
     ].join("\n");
   }
+  getActiveHostedChatId() {
+    if (this.hostedChatView.screen === "composer" && this.hostedChatView.chatId) {
+      return this.hostedChatView.chatId;
+    }
+    return this.session?.conversation_id ?? void 0;
+  }
   getHostedIdentityMessage() {
     if (!this.legacyWidgetJwt) return null;
     return {
       type: "identity_update",
       data: {
         jwt: this.legacyWidgetJwt,
-        chat_id: this.session?.conversation_id ?? void 0
+        chat_id: this.getActiveHostedChatId()
       }
     };
   }
@@ -856,17 +893,62 @@ var SagepilotReactNativeChat = class {
       }
       return true;
     }
+    if (message.type === "sagepilot:conversation_created") {
+      this.handleConversationCreated(message);
+      return true;
+    }
     if (message.type === "sagepilot:error") {
       this.emitError(message);
       return true;
     }
     return true;
   }
+  handleConversationCreated(message) {
+    const chatId = readStringField(message, "chat_id") ?? readStringField(message, "conversation_id");
+    if (!chatId) return;
+    void this.persistConversationId(chatId).catch((error) => this.emitError(error));
+    const bridgeMetadata = readRecordField(message, "metadata");
+    const composerMetadata = this.hostedChatView.screen === "composer" ? this.hostedChatView.metadata : void 0;
+    const metadata = {
+      ...composerMetadata ?? {},
+      ...bridgeMetadata ?? {}
+    };
+    const workspaceId = readStringField(message, "workspace_id") ?? this.workspaceId;
+    const channelId = readStringField(message, "channel_id") ?? this.channelId;
+    const sessionId = readStringField(message, "session_id") ?? this.session?.session_id;
+    const customerId = readStringField(message, "customer_id");
+    const messageId = readStringField(message, "message_id");
+    const createdAt = readStringField(message, "created_at");
+    const event = {
+      chat_id: chatId,
+      ...workspaceId ? { workspace_id: workspaceId } : {},
+      ...channelId ? { channel_id: channelId } : {},
+      ...sessionId ? { session_id: sessionId } : {},
+      ...customerId ? { customer_id: customerId } : {},
+      ...messageId ? { message_id: messageId } : {},
+      ...createdAt ? { created_at: createdAt } : {},
+      ...Object.keys(metadata).length > 0 ? { metadata } : {}
+    };
+    if (this.hostedChatView.screen === "composer") {
+      this.hostedChatView.onConversationCreated?.(event);
+    }
+    this.conversationCreatedCallbacks.forEach((callback) => callback(event));
+  }
+  async persistConversationId(conversationId) {
+    if (!this.session || !this.sessionManager) return;
+    if (this.session.conversation_id === conversationId) return;
+    this.session = await this.sessionManager.setSession({
+      ...this.session,
+      conversation_id: conversationId
+    });
+    this.emitState();
+  }
   destroy() {
     this.stopUnreadPolling();
     this.resetRuntimeState();
     this.emitState();
     this.identifyCallbacks.clear();
+    this.conversationCreatedCallbacks.clear();
     this.unreadCallbacks.clear();
     this.readyCallbacks.clear();
     this.presentCallbacks.clear();
@@ -1029,6 +1111,9 @@ var SagepilotChat = {
   logout: () => internalSagepilotChat.logout(),
   getIdentityState: () => internalSagepilotChat.getIdentityState(),
   onIdentify: (callback) => internalSagepilotChat.onIdentify(callback),
+  onConversationCreated: (callback) => {
+    return internalSagepilotChat.onConversationCreated(callback);
+  },
   getUnreadCount: () => internalSagepilotChat.getUnreadCount(),
   onUnreadChange: (callback) => internalSagepilotChat.onUnreadChange(callback),
   startUnreadPolling: (intervalMs) => internalSagepilotChat.startUnreadPolling(intervalMs),
@@ -1231,11 +1316,17 @@ function readUrlOrigin(url) {
 var hostedChatWebViewProps = {
   allowFileAccess: true,
   allowFileAccessFromFileURLs: true,
+  ...Platform.OS === "ios" ? {
+    automaticallyAdjustContentInsets: false,
+    contentInsetAdjustmentBehavior: "never",
+    hideKeyboardAccessoryView: true
+  } : null,
   bounces: false,
   domStorageEnabled: true,
   javaScriptEnabled: true,
   overScrollMode: "never",
-  scrollEnabled: Platform.OS !== "android",
+  // The hosted widget owns feed scrolling internally; outer WebView scrolling lets iOS focus-scroll the page over the keyboard.
+  scrollEnabled: false,
   setSupportMultipleWindows: false,
   sharedCookiesEnabled: true,
   thirdPartyCookiesEnabled: true
@@ -1549,6 +1640,9 @@ function useSagepilotChat() {
   }, []);
   const logout = useCallback2(() => SagepilotChat.logout(), []);
   const getUnreadCount = useCallback2(() => SagepilotChat.getUnreadCount(), []);
+  const onConversationCreated = useCallback2((callback) => {
+    return SagepilotChat.onConversationCreated(callback);
+  }, []);
   return {
     ...state,
     present,
@@ -1559,7 +1653,8 @@ function useSagepilotChat() {
     toggle,
     identify,
     logout,
-    getUnreadCount
+    getUnreadCount,
+    onConversationCreated
   };
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sagepilot-ai/react-native-sdk",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Sagepilot AI React Native chat SDK",
   "keywords": [
     "sagepilot",