@sagepilot-ai/react-native-sdk 0.2.5 → 0.3.1

package/dist/index.mjs

@@ -1,3 +1,6 @@
+// src/public/SdkClient.ts
+import { Platform } from "react-native";
+
 // src/core/errors/SagepilotChatError.ts
 var SagepilotChatError = class extends Error {
   constructor(code, message, options = {}) {
@@ -15,7 +18,7 @@ var SagepilotChatError = class extends Error {
 
 // src/core/config/constants.ts
 var SDK_NAME = "@sagepilot-ai/react-native-sdk";
-var SDK_VERSION = "0.2.5";
+var SDK_VERSION = "0.3.1";
 var DEFAULT_HOST = "https://app.sagepilot.ai";
 var DEFAULT_WIDGET_HOST = "https://app.sagepilot.ai";
 var CUSTOMER_API_PREFIX = "/customer-api/v1";
@@ -324,6 +327,34 @@ async function resolveDeviceInfo(adapter) {
   return adapter.getDeviceInfo();
 }
 
+// src/core/storage/cache.ts
+function createAsyncStorageCacheStorage(asyncStorage) {
+  return {
+    getItem: (key) => asyncStorage.getItem(key),
+    setItem: (key, value) => asyncStorage.setItem(key, value),
+    removeItem: (key) => asyncStorage.removeItem(key)
+  };
+}
+function createJsonCache(storage, namespace) {
+  return {
+    async get(key) {
+      const value = await storage.getItem(`${namespace}:${key}`);
+      if (!value) return null;
+      try {
+        return JSON.parse(value);
+      } catch {
+        return null;
+      }
+    },
+    async set(key, value) {
+      await storage.setItem(`${namespace}:${key}`, JSON.stringify(value));
+    },
+    async remove(key) {
+      await storage.removeItem(`${namespace}:${key}`);
+    }
+  };
+}
+
 // src/resources/channels.ts
 function bootstrapChannel(http, host, channelId) {
   return http.request(
@@ -407,6 +438,9 @@ function fetchUnreadCount(http, host, channelId, sessionId, authorizationHeader)
 }
 
 // src/public/SdkClient.ts
+var PRESENTATION_CACHE_NAMESPACE = "sagepilot_rn_presentation";
+var PRESENTATION_CACHE_KEY = "state";
+var PRESENTATION_RESTORE_MAX_AGE_MS = 15 * 60 * 1e3;
 var DEFAULT_MOBILE_LAUNCHER_CONFIG = {
   label: "Chat",
   buttonColor: "#173c2d",
@@ -476,6 +510,10 @@ function readRecordField(input, key) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
   return value;
 }
+function isFreshPresentationState(updatedAt) {
+  if (typeof updatedAt !== "number" || !Number.isFinite(updatedAt)) return false;
+  return Date.now() - updatedAt <= PRESENTATION_RESTORE_MAX_AGE_MS;
+}
 function toPublicSessionState(session) {
   return {
     session_id: session.session_id,
@@ -565,6 +603,7 @@ var SagepilotReactNativeChat = class {
       this.channel = channel;
       this.session = session;
       this.isConfigured = true;
+      await this.restorePresentationFromCache();
       this.emitReady();
       this.emitState();
       if (config.behavior?.enableUnreadPolling ?? true) {
@@ -704,12 +743,14 @@ var SagepilotReactNativeChat = class {
     this.hostedChatView = { screen: "home" };
     if (this.presented) {
       this.emitState();
+      this.persistPresentationState();
       return true;
     }
     this.presented = true;
     this.setUnreadCount(0);
     this.presentCallbacks.forEach((callback) => callback(this.getLifecycleState()));
     this.emitState();
+    this.persistPresentationState();
     return true;
   }
   presentMessages() {
@@ -737,6 +778,7 @@ var SagepilotReactNativeChat = class {
     this.emitUnreadChange();
     this.dismissCallbacks.forEach((callback) => callback(this.getLifecycleState()));
     this.emitState();
+    this.persistPresentationState();
     return true;
   }
   hide() {
@@ -871,6 +913,10 @@ var SagepilotReactNativeChat = class {
     }
     return this.session?.conversation_id ?? void 0;
   }
+  /** Returns the chat id that is explicitly part of the current hosted URL. */
+  getHostedRouteChatId() {
+    return this.hostedChatView.screen === "composer" ? this.hostedChatView.chatId : void 0;
+  }
   getHostedIdentityMessage() {
     if (!this.legacyWidgetJwt) return null;
     return {
@@ -881,6 +927,34 @@ var SagepilotReactNativeChat = class {
       }
     };
   }
+  /** Captures the hosted route that should receive a picked attachment batch. */
+  getHostedAttachmentTarget() {
+    return {
+      chatId: this.getActiveHostedChatId(),
+      routeChatId: this.getHostedRouteChatId(),
+      hostedChatView: this.serializeHostedChatView(this.hostedChatView)
+    };
+  }
+  /** Restores the hosted route for a queued attachment batch before delivery. */
+  restoreHostedAttachmentTarget(target) {
+    if (Platform.OS !== "android") return false;
+    if (!target) return false;
+    const hostedChatView = this.readPersistedHostedChatView(target.hostedChatView);
+    if (!hostedChatView) return false;
+    const currentChatId = this.getActiveHostedChatId();
+    const targetChatId = normalizeOptionalString(target.chatId);
+    const routeChatId = normalizeOptionalString(target.routeChatId) ?? (hostedChatView.screen === "composer" ? normalizeOptionalString(hostedChatView.chatId) : void 0);
+    const nextHostedChatView = routeChatId && hostedChatView.screen === "composer" ? this.withPinnedChatId(hostedChatView, routeChatId) : hostedChatView;
+    if (this.presented && (!targetChatId || currentChatId === targetChatId) && this.areHostedChatViewsEqual(this.hostedChatView, nextHostedChatView)) {
+      return false;
+    }
+    this.hostedChatView = nextHostedChatView;
+    this.presented = true;
+    this.setUnreadCount(0);
+    this.emitState();
+    this.persistPresentationState();
+    return true;
+  }
   handleHostedBridgeMessage(message) {
     if (!message) return false;
     if (message.type === "close_widget") {
@@ -948,6 +1022,7 @@ var SagepilotReactNativeChat = class {
   }
   destroy() {
     this.stopUnreadPolling();
+    this.persistPresentationState({ cleanShutdown: true, presented: false });
     this.resetRuntimeState();
     this.emitState();
     this.identifyCallbacks.clear();
@@ -1103,8 +1178,86 @@ var SagepilotReactNativeChat = class {
       this.presentCallbacks.forEach((callback) => callback(this.getLifecycleState()));
     }
     this.emitState();
+    this.persistPresentationState();
     return true;
   }
+  /** Returns the dedicated cache used for hosted-chat presentation recovery. */
+  getPresentationCache() {
+    const cacheStorage = this.runtimeOptions?.cacheStorage;
+    if (!cacheStorage) return null;
+    return createJsonCache(cacheStorage, PRESENTATION_CACHE_NAMESPACE);
+  }
+  /** Removes callback-only fields so the hosted route can be safely serialized. */
+  serializeHostedChatView(view) {
+    if (view.screen !== "composer") return view;
+    return {
+      screen: "composer",
+      message: view.message,
+      mode: view.mode,
+      chatId: view.chatId,
+      metadata: view.metadata
+    };
+  }
+  /** Validates a persisted hosted view before using it to rebuild a widget URL. */
+  readPersistedHostedChatView(view) {
+    if (!view || typeof view !== "object") return null;
+    const record = view;
+    if (record.screen === "home") return { screen: "home" };
+    if (record.screen === "messages") return { screen: "messages" };
+    if (record.screen !== "composer") return null;
+    const mode = record.mode === "new" ? "new" : "auto";
+    return {
+      screen: "composer",
+      message: typeof record.message === "string" ? record.message : void 0,
+      mode,
+      chatId: typeof record.chatId === "string" && record.chatId ? record.chatId : void 0,
+      metadata: readRecordField(record, "metadata")
+    };
+  }
+  /** Forces a persisted hosted route to target the exact chat that owns a pending attachment. */
+  withPinnedChatId(view, chatId) {
+    if (view.screen === "composer") {
+      return {
+        ...view,
+        chatId
+      };
+    }
+    return {
+      screen: "composer",
+      mode: "auto",
+      chatId
+    };
+  }
+  /** Compares hosted route state without relying on object identity. */
+  areHostedChatViewsEqual(first, second) {
+    return JSON.stringify(this.serializeHostedChatView(first)) === JSON.stringify(this.serializeHostedChatView(second));
+  }
+  /** Persists presentation state without blocking customer-facing SDK methods. */
+  persistPresentationState(options) {
+    const cache = this.getPresentationCache();
+    if (!cache) return;
+    const state = {
+      presented: options?.presented ?? this.presented,
+      hostedChatView: this.serializeHostedChatView(this.hostedChatView),
+      updatedAt: Date.now(),
+      cleanShutdown: options?.cleanShutdown
+    };
+    void cache.set(PRESENTATION_CACHE_KEY, state).catch(() => void 0);
+  }
+  /** Restores Android presentation state after configure without resetting the hosted route to Home. */
+  async restorePresentationFromCache() {
+    const cache = this.getPresentationCache();
+    if (!cache || Platform.OS !== "android") return;
+    const persisted = await cache.get(PRESENTATION_CACHE_KEY).catch(() => null);
+    if (persisted?.cleanShutdown) return;
+    if (!isFreshPresentationState(persisted?.updatedAt)) return;
+    if (!persisted?.presented) return;
+    const hostedChatView = this.readPersistedHostedChatView(persisted.hostedChatView);
+    if (!hostedChatView) return;
+    this.hostedChatView = hostedChatView;
+    this.presented = true;
+    this.setUnreadCount(0);
+  }
 };
 var internalSagepilotChat = new SagepilotReactNativeChat();
 var SagepilotChat = {
@@ -1141,34 +1294,6 @@ var SagepilotChat = {
   destroy: () => internalSagepilotChat.destroy()
 };
 
-// src/core/storage/cache.ts
-function createAsyncStorageCacheStorage(asyncStorage) {
-  return {
-    getItem: (key) => asyncStorage.getItem(key),
-    setItem: (key, value) => asyncStorage.setItem(key, value),
-    removeItem: (key) => asyncStorage.removeItem(key)
-  };
-}
-function createJsonCache(storage, namespace) {
-  return {
-    async get(key) {
-      const value = await storage.getItem(`${namespace}:${key}`);
-      if (!value) return null;
-      try {
-        return JSON.parse(value);
-      } catch {
-        return null;
-      }
-    },
-    async set(key, value) {
-      await storage.setItem(`${namespace}:${key}`, JSON.stringify(value));
-    },
-    async remove(key) {
-      await storage.removeItem(`${namespace}:${key}`);
-    }
-  };
-}
-
 // src/core/storage/fileStore.ts
 var DEFAULT_DIRECTORY_NAME = "sagepilot-attachments";
 function sanitizeKey(key) {
@@ -1226,21 +1351,29 @@ function createSagepilotFileStore(blobUtil, options = {}) {
 }
 
 // src/core/native/filePicker.ts
-import { PermissionsAndroid, Platform } from "react-native";
-var DEFAULT_IMAGE_MAX_DIMENSION = 1920;
-var DEFAULT_IMAGE_QUALITY = 0.8;
-var DEFAULT_IMAGE_MIME_TYPE = "image/jpeg";
-var DEFAULT_DOCUMENT_MIME_TYPE = "application/octet-stream";
-var DEFAULT_IMAGE_SELECTION_LIMIT = 5;
-var DEFAULT_DOCUMENT_MAX_FILE_SIZE_BYTES = 20 * 1024 * 1024;
-var DEFAULT_IMAGE_MAX_FILE_SIZE_BYTES = 15 * 1024 * 1024;
+import { Alert, Linking, PermissionsAndroid, Platform as Platform2 } from "react-native";
+
+// src/core/native/filePickerShared.ts
 var SagepilotFilePickerError = class extends Error {
+  /** Creates a typed picker error that can be surfaced over the widget bridge. */
   constructor(code, message) {
     super(message);
     this.name = "SagepilotFilePickerError";
     this.code = code;
   }
 };
+var SAGEPILOT_DEFAULT_IMAGE_MAX_DIMENSION = 1920;
+var SAGEPILOT_DEFAULT_IMAGE_QUALITY = 0.8;
+var SAGEPILOT_DEFAULT_IMAGE_MAX_FILE_SIZE_BYTES = 15 * 1024 * 1024;
+
+// src/core/native/filePicker.ts
+var DEFAULT_IMAGE_MAX_DIMENSION = SAGEPILOT_DEFAULT_IMAGE_MAX_DIMENSION;
+var DEFAULT_IMAGE_QUALITY = SAGEPILOT_DEFAULT_IMAGE_QUALITY;
+var DEFAULT_IMAGE_MIME_TYPE = "image/jpeg";
+var DEFAULT_DOCUMENT_MIME_TYPE = "application/octet-stream";
+var DEFAULT_IMAGE_SELECTION_LIMIT = 5;
+var DEFAULT_DOCUMENT_MAX_FILE_SIZE_BYTES = 20 * 1024 * 1024;
+var DEFAULT_IMAGE_MAX_FILE_SIZE_BYTES = SAGEPILOT_DEFAULT_IMAGE_MAX_FILE_SIZE_BYTES;
 function bytesToMb(bytes) {
   return Math.round(bytes / (1024 * 1024) * 10) / 10;
 }
@@ -1250,8 +1383,30 @@ function estimateBase64ByteSize(dataBase64) {
 function stripFileScheme(uri) {
   return uri.startsWith("file://") ? uri.replace("file://", "") : uri;
 }
-async function ensureAndroidCameraPermission() {
-  if (Platform.OS !== "android") return;
+async function promptOpenSagepilotCameraSettings() {
+  if (Platform2.OS !== "android") return;
+  await new Promise((resolve) => {
+    Alert.alert(
+      "Camera access is off",
+      "Enable camera access for this app in Settings to take a photo.",
+      [
+        {
+          text: "Not now",
+          style: "cancel",
+          onPress: resolve
+        },
+        {
+          text: "Open Settings",
+          onPress: () => {
+            Linking.openSettings().finally(resolve);
+          }
+        }
+      ]
+    );
+  });
+}
+async function ensureSagepilotAndroidCameraPermission() {
+  if (Platform2.OS !== "android") return;
   let result;
   try {
     result = await PermissionsAndroid.request(PermissionsAndroid.PERMISSIONS.CAMERA);
@@ -1259,6 +1414,7 @@ async function ensureAndroidCameraPermission() {
     return;
   }
   if (result === PermissionsAndroid.RESULTS.NEVER_ASK_AGAIN) {
+    await promptOpenSagepilotCameraSettings();
     throw new SagepilotFilePickerError(
       "permission_denied",
       "Camera access is turned off. Enable it for this app in Settings to take a photo."
@@ -1271,6 +1427,9 @@ async function ensureAndroidCameraPermission() {
     );
   }
 }
+function canUseCameraSource(imagePicker) {
+  return Boolean(imagePicker);
+}
 function mapImagePickerErrorCode(errorCode) {
   switch (errorCode) {
     case "permission":
@@ -1347,7 +1506,8 @@ function createSagepilotFilePicker(options) {
   const documentMaxFileSizeBytes = options.documentMaxFileSizeBytes ?? DEFAULT_DOCUMENT_MAX_FILE_SIZE_BYTES;
   const imageMaxFileSizeBytes = options.imageMaxFileSizeBytes ?? DEFAULT_IMAGE_MAX_FILE_SIZE_BYTES;
   const sources = [];
-  if (imagePicker) sources.push("camera", "library");
+  if (canUseCameraSource(imagePicker)) sources.push("camera");
+  if (imagePicker) sources.push("library");
   if (documentsPicker) sources.push("documents");
   if (sources.length === 0) return void 0;
   const imageOptions = {
@@ -1359,8 +1519,10 @@ function createSagepilotFilePicker(options) {
     saveToPhotos: false
   };
   async function pickFromCamera() {
-    if (!imagePicker) return [];
-    await ensureAndroidCameraPermission();
+    await ensureSagepilotAndroidCameraPermission();
+    if (!imagePicker) {
+      throw new SagepilotFilePickerError("camera_unavailable", "The camera picker is not available in this build.");
+    }
     return imageAssetsToPickedFiles(await imagePicker.launchCamera(imageOptions), imageMaxFileSizeBytes);
   }
   async function pickFromLibrary(multiple) {
@@ -1431,13 +1593,14 @@ function createSagepilotFilePicker(options) {
 
 // src/ui/SagepilotChatProvider.ts
 import { createElement, useCallback, useEffect, useRef, useState } from "react";
+import { Camera, FileText, Images, X } from "lucide-react-native";
 import {
   ActivityIndicator,
   AppState,
   KeyboardAvoidingView,
-  Linking,
+  Linking as Linking2,
   Modal,
-  Platform as Platform2,
+  Platform as Platform3,
   Pressable,
   SafeAreaView,
   StyleSheet,
@@ -1448,8 +1611,11 @@ import { WebView } from "react-native-webview";
 
 // src/core/webview/mobileBridge.ts
 var FILE_PICKER_PROTOCOL_VERSION = 2;
+function buildBridgeCapabilitiesPayload(capabilities) {
+  return { ...capabilities, filePickerProtocol: FILE_PICKER_PROTOCOL_VERSION };
+}
 function buildBridgeCapabilitiesScript(capabilities) {
-  const payload = { ...capabilities, filePickerProtocol: FILE_PICKER_PROTOCOL_VERSION };
+  const payload = buildBridgeCapabilitiesPayload(capabilities);
   return [
     "(function(){",
     "try {",
@@ -1498,9 +1664,23 @@ function parseHostedBridgeMessage(rawData) {
     return null;
   }
 }
-var mobileWebViewBridgeScript = `
+function buildMobileWebViewBridgeScript(capabilities) {
+  const payload = buildBridgeCapabilitiesPayload(capabilities);
+  return `
   (function () {
-    if (window.__sagepilotRnBridgeInstalled) return true;
+    var bridgeCapabilities = ${JSON.stringify(payload)};
+    var applyBridgeCapabilities = function () {
+      try {
+        if (window.SagepilotMobileBridge) {
+          window.SagepilotMobileBridge.capabilities = Object.assign({}, window.SagepilotMobileBridge.capabilities, bridgeCapabilities);
+        }
+      } catch (error) {}
+    };
+
+    if (window.__sagepilotRnBridgeInstalled) {
+      applyBridgeCapabilities();
+      return true;
+    }
     window.__sagepilotRnBridgeInstalled = true;
 
     var ensureViewport = function () {
@@ -1541,9 +1721,11 @@ var mobileWebViewBridgeScript = `
     };
 
     window.SagepilotMobileBridge = {
+      capabilities: bridgeCapabilities,
       postMessage: sendToReactNative,
       ready: function () { sendToReactNative({ type: "sagepilot:ready" }); }
     };
+    applyBridgeCapabilities();
 
     document.addEventListener("click", function (event) {
       try {
@@ -1584,6 +1766,7 @@ var mobileWebViewBridgeScript = `
     return true;
   })();
 `;
+}
 
 // src/specs/SagepilotInsetsViewNativeComponent.ts
 import codegenNativeComponent from "react-native/Libraries/Utilities/codegenNativeComponent";
@@ -1600,13 +1783,17 @@ function readPresentationState() {
     presentation: internalSagepilotChat.getConfig()?.presentation
   };
 }
+function getBridgeCapabilities() {
+  return {
+    nativeFilePicker: Boolean(internalSagepilotChat.getConfig()?.filePicker)
+  };
+}
 function getInjectedWebViewScript() {
+  const capabilities = getBridgeCapabilities();
   return [
     internalSagepilotChat.getHostedAuthScript(),
-    mobileWebViewBridgeScript,
-    buildBridgeCapabilitiesScript({
-      nativeFilePicker: Boolean(internalSagepilotChat.getConfig()?.filePicker)
-    })
+    buildMobileWebViewBridgeScript(capabilities),
+    buildBridgeCapabilitiesScript(capabilities)
   ].filter(Boolean).join("\n");
 }
 var FILE_PICKER_SOURCE_LABELS = {
@@ -1614,6 +1801,21 @@ var FILE_PICKER_SOURCE_LABELS = {
   library: "Choose from gallery",
   documents: "Browse files"
 };
+var FILE_PICKER_SOURCE_DESCRIPTIONS = {
+  camera: "Use the in-app camera",
+  library: "Photos and videos on this device",
+  documents: "PDFs, documents, and Drive files"
+};
+var FILE_PICKER_SOURCE_ICONS = {
+  camera: Camera,
+  library: Images,
+  documents: FileText
+};
+var FILE_PICKER_SOURCE_ICON_COLORS = {
+  camera: "#0284c7",
+  library: "#16a34a",
+  documents: "#7c3aed"
+};
 var DELIVERY_RETRY_MS = 1500;
 var DELIVERY_LEGACY_FALLBACK_ATTEMPTS = 2;
 var DELIVERY_MAX_ATTEMPTS = 8;
@@ -1623,6 +1825,7 @@ var PENDING_FILES_CACHE_KEY = "pending_batch";
 var LIVENESS_HEARTBEAT_STALE_MS = 4e3;
 var LIVENESS_PONG_TIMEOUT_MS = 1500;
 var LIVENESS_MAX_PING_ATTEMPTS = 2;
+var LIVENESS_PICKER_GRACE_MS = 8e3;
 var LIVENESS_MAX_REMOUNTS = 2;
 var batchSequence = 0;
 function nextBatchId() {
@@ -1636,6 +1839,29 @@ function totalBase64Bytes(files) {
 function storageKeyFor(batchId, index) {
   return `${batchId}_${index}.bin`;
 }
+function renderFilePickerSourceIcon(source) {
+  const Icon = FILE_PICKER_SOURCE_ICONS[source];
+  return createElement(
+    View,
+    { style: getFilePickerSourceIconStyle(source) },
+    createElement(Icon, {
+      color: FILE_PICKER_SOURCE_ICON_COLORS[source],
+      size: 23,
+      strokeWidth: 2.35
+    })
+  );
+}
+function getFilePickerSourceIconStyle(source) {
+  if (source === "camera") return [styles.sheetOptionIcon, styles.cameraOptionIcon];
+  if (source === "library") return [styles.sheetOptionIcon, styles.libraryOptionIcon];
+  return [styles.sheetOptionIcon, styles.documentsOptionIcon];
+}
+function getSheetOptionStyle(pressed) {
+  return [styles.sheetOption, pressed && styles.sheetOptionPressed];
+}
+function getSheetCancelStyle(pressed) {
+  return [styles.sheetCancelButton, pressed && styles.sheetCancelButtonPressed];
+}
 function buildDispatchScript(messageLiteral) {
   return [
     "(function(){",
@@ -1647,8 +1873,14 @@ function buildDispatchScript(messageLiteral) {
     "})();"
   ].join("\n");
 }
-function buildFilesPickedScript(files, batchId) {
-  return buildDispatchScript(`{ type: "sagepilot:files_picked", batch_id: ${JSON.stringify(batchId)}, files: ${JSON.stringify(files)} }`);
+function buildFilesPickedScript(batch) {
+  return buildDispatchScript(JSON.stringify({
+    type: "sagepilot:files_picked",
+    batch_id: batch.batchId,
+    chat_id: batch.target?.chatId,
+    conversation_id: batch.target?.chatId,
+    files: batch.files
+  }));
 }
 function buildFilePickerErrorScript(message, code) {
   return buildDispatchScript(
@@ -1695,7 +1927,7 @@ function isInternalWebViewScheme(url) {
 var hostedChatWebViewProps = {
   allowFileAccess: true,
   allowFileAccessFromFileURLs: true,
-  ...Platform2.OS === "ios" ? {
+  ...Platform3.OS === "ios" ? {
     automaticallyAdjustContentInsets: false,
     contentInsetAdjustmentBehavior: "never",
     hideKeyboardAccessoryView: true
@@ -1710,7 +1942,7 @@ var hostedChatWebViewProps = {
   sharedCookiesEnabled: true,
   thirdPartyCookiesEnabled: true
 };
-var AndroidInsetsView = Platform2.OS === "android" ? SagepilotInsetsViewNativeComponent_default : View;
+var AndroidInsetsView = Platform3.OS === "android" ? SagepilotInsetsViewNativeComponent_default : View;
 var emptyAndroidInsets = { top: 0, bottom: 0 };
 function SagepilotChatProvider({
   children,
@@ -1729,6 +1961,9 @@ function SagepilotChatProvider({
   const deliveryAttemptsRef = useRef(0);
   const pendingPingRef = useRef(null);
   const pingTimeoutRef = useRef(null);
+  const livenessResumeTimerRef = useRef(null);
+  const livenessPausedUntilRef = useRef(0);
+  const pickerInFlightRef = useRef(false);
   const livenessRemountCountRef = useRef(0);
   const appStateRef = useRef(AppState.currentState);
   const didReconcileRef = useRef(false);
@@ -1751,6 +1986,7 @@ function SagepilotChatProvider({
     if (hasFileStore) {
       const manifest = queue.filter((batch) => batch.storageKeys && batch.storageKeys.length === batch.files.length).map((batch) => ({
         batchId: batch.batchId,
+        target: batch.target,
         files: batch.files.map((file, index) => ({
           file_name: file.file_name,
           mime_type: file.mime_type,
@@ -1769,6 +2005,7 @@ function SagepilotChatProvider({
     if (totalBytes <= PERSIST_MAX_TOTAL_BYTES) {
       const manifest = queue.map((batch) => ({
         batchId: batch.batchId,
+        target: batch.target,
         files: batch.files.map((file) => ({
           file_name: file.file_name,
           mime_type: file.mime_type,
@@ -1810,12 +2047,17 @@ function SagepilotChatProvider({
     }
     const batch = pendingBatchesRef.current[0];
     if (!batch) return;
+    if (internalSagepilotChat.restoreHostedAttachmentTarget(batch.target)) {
+      widgetReadyRef.current = false;
+      deliveryTimerRef.current = setTimeout(() => pumpDelivery(), DELIVERY_RETRY_MS);
+      return;
+    }
     deliveryAttemptsRef.current += 1;
     const attempts = deliveryAttemptsRef.current;
     const ref = nativeWebViewRef.current;
     const shouldDeliver = ref && (widgetReadyRef.current || attempts >= DELIVERY_LEGACY_FALLBACK_ATTEMPTS);
     if (shouldDeliver && ref) {
-      ref.injectJavaScript(buildFilesPickedScript(batch.files, batch.batchId));
+      ref.injectJavaScript(buildFilesPickedScript(batch));
     }
     if (attempts < DELIVERY_MAX_ATTEMPTS) {
       deliveryTimerRef.current = setTimeout(() => pumpDelivery(), DELIVERY_RETRY_MS);
@@ -1846,22 +2088,38 @@ function SagepilotChatProvider({
     const batchId = nextBatchId();
     const hasFileStore = Boolean(internalSagepilotChat.getConfig()?.fileStore);
     const storageKeys = hasFileStore ? files.map((_, index) => storageKeyFor(batchId, index)) : void 0;
-    const batch = { batchId, files, storageKeys };
+    const batch = {
+      batchId,
+      files,
+      storageKeys,
+      target: internalSagepilotChat.getHostedAttachmentTarget()
+    };
     pendingBatchesRef.current = [...pendingBatchesRef.current, batch];
     ensureDelivery();
     writeManifest();
     void writeBatchBytes(batch);
   }, [ensureDelivery, writeManifest, writeBatchBytes]);
-  const recoverNativeWebView = useCallback(() => {
+  const recoverNativeWebView = useCallback((_reasonOrEvent) => {
     widgetReadyRef.current = false;
     setNativeWebViewKey((key) => key + 1);
   }, []);
   const recoverPreloadWebView = useCallback(() => {
     setPreloadWebViewKey((key) => key + 1);
   }, []);
+  const pauseLivenessAfterPicker = useCallback((durationMs) => {
+    if (Platform3.OS !== "android") return;
+    livenessPausedUntilRef.current = Math.max(livenessPausedUntilRef.current, Date.now() + durationMs);
+  }, []);
   const runNativeFilePicker = useCallback((source, multiple) => {
     const filePicker = internalSagepilotChat.getConfig()?.filePicker;
-    if (!filePicker) return;
+    if (!filePicker) {
+      return;
+    }
+    if (pickerInFlightRef.current) {
+      return;
+    }
+    pauseLivenessAfterPicker(6e4);
+    pickerInFlightRef.current = true;
     filePicker.pickFiles({ source, multiple }).then((files) => {
       if (files.length === 0) {
         nativeWebViewRef.current?.injectJavaScript(buildFilePickerCancelledScript());
@@ -1871,13 +2129,18 @@ function SagepilotChatProvider({
     }).catch((error) => {
       const { message, code } = readFilePickerError(error);
       nativeWebViewRef.current?.injectJavaScript(buildFilePickerErrorScript(message, code));
+    }).finally(() => {
+      pickerInFlightRef.current = false;
+      pauseLivenessAfterPicker(LIVENESS_PICKER_GRACE_MS);
     });
-  }, [queuePickedFiles]);
+  }, [pauseLivenessAfterPicker, queuePickedFiles]);
   const openNativeFilePicker = useCallback((multiple) => {
     const filePicker = internalSagepilotChat.getConfig()?.filePicker;
-    if (!filePicker || filePicker.sources.length === 0) return;
+    if (!filePicker || filePicker.sources.length === 0) {
+      return;
+    }
     const [onlySource] = filePicker.sources;
-    if (filePicker.sources.length === 1 && onlySource) {
+    if (filePicker.sources.length === 1 && onlySource && onlySource !== "camera") {
       runNativeFilePicker(onlySource, multiple);
       return;
     }
@@ -1930,7 +2193,8 @@ function SagepilotChatProvider({
           restored.push({
             batchId: batch.batchId,
             files,
-            storageKeys: storageKeys.length === files.length ? storageKeys : void 0
+            storageKeys: storageKeys.length === files.length ? storageKeys : void 0,
+            target: batch.target
           });
         }
       }
@@ -1951,6 +2215,19 @@ function SagepilotChatProvider({
       cancelled = true;
     };
   }, [getPendingCache, startDelivery, writeManifest]);
+  const clearPing = useCallback(() => {
+    pendingPingRef.current = null;
+    if (pingTimeoutRef.current) {
+      clearTimeout(pingTimeoutRef.current);
+      pingTimeoutRef.current = null;
+    }
+  }, []);
+  const clearDeferredLivenessProbe = useCallback(() => {
+    if (livenessResumeTimerRef.current) {
+      clearTimeout(livenessResumeTimerRef.current);
+      livenessResumeTimerRef.current = null;
+    }
+  }, []);
   useEffect(() => {
     return () => {
       if (deliveryTimerRef.current) {
@@ -1961,19 +2238,23 @@ function SagepilotChatProvider({
         clearTimeout(pingTimeoutRef.current);
         pingTimeoutRef.current = null;
       }
+      clearDeferredLivenessProbe();
     };
-  }, []);
-  const clearPing = useCallback(() => {
-    pendingPingRef.current = null;
-    if (pingTimeoutRef.current) {
-      clearTimeout(pingTimeoutRef.current);
-      pingTimeoutRef.current = null;
-    }
-  }, []);
+  }, [clearDeferredLivenessProbe]);
   const runLivenessProbe = useCallback(() => {
-    if (Platform2.OS !== "android") return;
+    if (Platform3.OS !== "android") return;
     const ref = nativeWebViewRef.current;
     if (!ref || !internalSagepilotChat.isPresented()) return;
+    const pauseRemainingMs = livenessPausedUntilRef.current - Date.now();
+    if (pickerInFlightRef.current || pauseRemainingMs > 0) {
+      const retryDelayMs = pickerInFlightRef.current ? 500 : Math.max(0, pauseRemainingMs);
+      clearDeferredLivenessProbe();
+      livenessResumeTimerRef.current = setTimeout(() => {
+        livenessResumeTimerRef.current = null;
+        runLivenessProbe();
+      }, retryDelayMs);
+      return;
+    }
     setAndroidRepaintTick((tick) => tick + 1);
     const attempts = (pendingPingRef.current?.attempts ?? 0) + 1;
     const nonce = `${Date.now().toString(36)}_${attempts}`;
@@ -1983,12 +2264,12 @@ function SagepilotChatProvider({
     pingTimeoutRef.current = setTimeout(() => {
       if (attempts >= LIVENESS_MAX_PING_ATTEMPTS) {
         clearPing();
-        recoverNativeWebView();
+        recoverNativeWebView("liveness_timeout");
         return;
       }
       runLivenessProbe();
     }, LIVENESS_PONG_TIMEOUT_MS);
-  }, [clearPing, recoverNativeWebView]);
+  }, [clearDeferredLivenessProbe, clearPing, recoverNativeWebView]);
   useEffect(() => {
     const subscription = AppState.addEventListener("change", (nextState) => {
       const prev = appStateRef.current;
@@ -2018,11 +2299,11 @@ function SagepilotChatProvider({
   const presentationStyle = state.presentation?.style ?? "sheet";
   const isFullScreenModal = presentationStyle === "fullScreen";
   const animationType = presentationStyle === "fullScreen" || presentationStyle === "push" ? "slide" : "fade";
-  const ModalContainer = Platform2.OS === "ios" && isFullScreenModal ? SafeAreaView : View;
-  const NativeModalContainer = Platform2.OS === "android" ? AndroidInsetsView : ModalContainer;
-  const ChatContentContainer = Platform2.OS === "ios" ? KeyboardAvoidingView : View;
-  const nativeModalContainerProps = Platform2.OS === "android" ? { style: styles.container, onInsetsChange: handleAndroidInsetsChange } : { style: styles.container };
-  const chatContentContainerProps = Platform2.OS === "ios" ? {
+  const ModalContainer = Platform3.OS === "ios" && isFullScreenModal ? SafeAreaView : View;
+  const NativeModalContainer = Platform3.OS === "android" ? AndroidInsetsView : ModalContainer;
+  const ChatContentContainer = Platform3.OS === "ios" ? KeyboardAvoidingView : View;
+  const nativeModalContainerProps = Platform3.OS === "android" ? { style: styles.container, onInsetsChange: handleAndroidInsetsChange } : { style: styles.container };
+  const chatContentContainerProps = Platform3.OS === "ios" ? {
     behavior: "padding",
     enabled: true,
     keyboardVerticalOffset: 0,
@@ -2030,7 +2311,7 @@ function SagepilotChatProvider({
   } : {
     style: [
       styles.modalContent,
-      Platform2.OS === "android" ? {
+      Platform3.OS === "android" ? {
         paddingTop: androidModalInsets.top,
         paddingBottom: androidModalInsets.bottom
       } : null
@@ -2062,7 +2343,7 @@ function SagepilotChatProvider({
           clearPing();
           if (livenessRemountCountRef.current < LIVENESS_MAX_REMOUNTS) {
             livenessRemountCountRef.current += 1;
-            recoverNativeWebView();
+            recoverNativeWebView("liveness_dead_pong");
           }
         } else {
           livenessRemountCountRef.current = 0;
@@ -2084,7 +2365,12 @@ function SagepilotChatProvider({
     if (!script || !nativeWebViewRef.current) return;
     nativeWebViewRef.current.injectJavaScript(script);
   };
+  const injectNativeBridgeToNativeWebView = () => {
+    if (!nativeWebViewRef.current) return;
+    nativeWebViewRef.current.injectJavaScript(getInjectedWebViewScript());
+  };
   const handleNativeWebViewLoadEnd = () => {
+    injectNativeBridgeToNativeWebView();
     postIdentityToNativeWebView();
     widgetReadyRef.current = false;
     startDelivery();
@@ -2098,11 +2384,11 @@ function SagepilotChatProvider({
     if (widgetOrigin && readUrlOrigin(url) === widgetOrigin) {
       return true;
     }
-    Linking.openURL(url).catch(() => void 0);
+    Linking2.openURL(url).catch(() => void 0);
     return false;
   }, [state.conversationUrl, state.preloadUrl]);
   useEffect(() => {
-    if (Platform2.OS !== "web" || typeof window === "undefined") return;
+    if (Platform3.OS !== "web" || typeof window === "undefined") return;
     const trustedWidgetOrigin = readUrlOrigin(state.conversationUrl);
     if (!trustedWidgetOrigin) return;
     const handleWindowMessage = (event) => {
@@ -2113,14 +2399,14 @@ function SagepilotChatProvider({
     return () => window.removeEventListener("message", handleWindowMessage);
   }, [state.conversationUrl]);
   useEffect(() => {
-    if (Platform2.OS !== "web" || !state.isPresented) return;
+    if (Platform3.OS !== "web" || !state.isPresented) return;
     postIdentityToWebFrame();
   }, [state.isPresented, state.conversationUrl, state.configured]);
   useEffect(() => {
-    if (Platform2.OS === "web" || !state.isPresented) return;
+    if (Platform3.OS === "web" || !state.isPresented) return;
     postIdentityToNativeWebView();
   }, [state.isPresented, state.conversationUrl, state.configured]);
-  if (Platform2.OS === "web") {
+  if (Platform3.OS === "web") {
     return createElement(
       View,
       { style: styles.root },
@@ -2182,8 +2468,8 @@ function SagepilotChatProvider({
         visible: state.configured && state.isPresented,
         animationType,
         presentationStyle: isFullScreenModal ? "fullScreen" : "pageSheet",
-        statusBarTranslucent: Platform2.OS === "android",
-        navigationBarTranslucent: Platform2.OS === "android",
+        statusBarTranslucent: Platform3.OS === "android",
+        navigationBarTranslucent: Platform3.OS === "android",
         onRequestClose: () => internalSagepilotChat.dismiss()
       },
       createElement(
@@ -2214,7 +2500,7 @@ function SagepilotChatProvider({
             // The imperceptible opacity toggle forces the Android WebView
             // surface to re-composite on resume, clearing the blank-but-alive
             // surface bug without a reload (see runLivenessProbe).
-            style: Platform2.OS === "android" ? [styles.webview, { opacity: 1 - androidRepaintTick % 2 * 1e-3 }] : styles.webview,
+            style: Platform3.OS === "android" ? [styles.webview, { opacity: 1 - androidRepaintTick % 2 * 1e-3 }] : styles.webview,
             startInLoadingState: true,
             injectedJavaScriptBeforeContentLoaded: getInjectedWebViewScript(),
             onMessage: handleWebViewMessage,
@@ -2252,6 +2538,7 @@ function SagepilotChatProvider({
         createElement(
           View,
           { style: styles.sheetCard },
+          createElement(View, { style: styles.sheetHandle }),
           createElement(Text, { style: styles.sheetTitle }, "Add attachment"),
           ...(internalSagepilotChat.getConfig()?.filePicker?.sources ?? []).map(
             (source) => createElement(
@@ -2259,19 +2546,29 @@ function SagepilotChatProvider({
               {
                 key: source,
                 accessibilityRole: "button",
-                style: styles.sheetButton,
+                android_ripple: { color: "rgba(15, 23, 42, 0.06)" },
+                hitSlop: 4,
+                style: ({ pressed }) => getSheetOptionStyle(pressed),
                 onPress: () => handleSourceChoice(source)
               },
-              createElement(Text, { style: styles.sheetButtonText }, FILE_PICKER_SOURCE_LABELS[source])
+              renderFilePickerSourceIcon(source),
+              createElement(
+                View,
+                { style: styles.sheetOptionText },
+                createElement(Text, { style: styles.sheetButtonText }, FILE_PICKER_SOURCE_LABELS[source]),
+                createElement(Text, { style: styles.sheetButtonDescription }, FILE_PICKER_SOURCE_DESCRIPTIONS[source])
+              )
             )
           ),
           createElement(
             Pressable,
             {
               accessibilityRole: "button",
-              style: [styles.sheetButton, styles.sheetCancelButton],
+              android_ripple: { color: "rgba(15, 23, 42, 0.06)" },
+              style: ({ pressed }) => getSheetCancelStyle(pressed),
               onPress: () => setSourceChooser(null)
             },
+            createElement(X, { color: "#334155", size: 18, strokeWidth: 2.5, style: styles.sheetCancelIcon }),
             createElement(Text, { style: styles.sheetCancelText }, "Cancel")
           )
         )
@@ -2377,43 +2674,109 @@ var styles = StyleSheet.create({
   },
   sheetBackdrop: {
     flex: 1,
+    alignItems: "center",
     justifyContent: "flex-end",
-    backgroundColor: "rgba(17, 24, 39, 0.36)"
+    backgroundColor: "rgba(15, 23, 42, 0.48)"
   },
   sheetCard: {
+    width: "100%",
+    maxWidth: 540,
     backgroundColor: "#ffffff",
-    borderTopLeftRadius: 16,
-    borderTopRightRadius: 16,
-    paddingTop: 8,
-    paddingBottom: 24,
-    paddingHorizontal: 8
+    borderTopLeftRadius: 26,
+    borderTopRightRadius: 26,
+    paddingTop: 10,
+    paddingBottom: 18,
+    paddingHorizontal: 14,
+    shadowColor: "#0f172a",
+    shadowOpacity: 0.22,
+    shadowRadius: 28,
+    shadowOffset: { width: 0, height: -10 },
+    elevation: 18
+  },
+  sheetHandle: {
+    alignSelf: "center",
+    width: 42,
+    height: 5,
+    borderRadius: 999,
+    backgroundColor: "#d1d5db",
+    marginBottom: 14
   },
   sheetTitle: {
-    textAlign: "center",
-    color: "#6b7280",
-    fontSize: 13,
-    fontWeight: "600",
-    paddingVertical: 10
+    color: "#111827",
+    fontSize: 17,
+    fontWeight: "700",
+    paddingBottom: 12,
+    paddingHorizontal: 4
+  },
+  sheetOption: {
+    minHeight: 70,
+    flexDirection: "row",
+    alignItems: "center",
+    borderRadius: 18,
+    paddingHorizontal: 12,
+    marginBottom: 6,
+    backgroundColor: "#ffffff"
+  },
+  sheetOptionPressed: {
+    backgroundColor: "#f8fafc",
+    transform: [{ scale: 0.985 }]
   },
-  sheetButton: {
-    minHeight: 52,
+  sheetOptionIcon: {
+    width: 46,
+    height: 46,
+    borderRadius: 16,
+    marginRight: 14,
     alignItems: "center",
     justifyContent: "center",
-    borderRadius: 12
+    position: "relative",
+    overflow: "hidden"
+  },
+  sheetOptionText: {
+    flex: 1,
+    justifyContent: "center"
   },
   sheetButtonText: {
-    color: "#111827",
+    color: "#0f172a",
     fontSize: 16,
-    fontWeight: "500"
+    fontWeight: "700"
+  },
+  sheetButtonDescription: {
+    color: "#64748b",
+    fontSize: 13,
+    fontWeight: "500",
+    marginTop: 3
+  },
+  cameraOptionIcon: {
+    backgroundColor: "#e0f2fe"
+  },
+  libraryOptionIcon: {
+    backgroundColor: "#ecfdf5"
+  },
+  documentsOptionIcon: {
+    backgroundColor: "#f5f3ff"
   },
   sheetCancelButton: {
-    marginTop: 6,
-    backgroundColor: "#f3f4f6"
+    minHeight: 56,
+    flexDirection: "row",
+    alignItems: "center",
+    justifyContent: "center",
+    borderRadius: 18,
+    marginTop: 8,
+    backgroundColor: "#f1f5f9"
+  },
+  sheetCancelButtonPressed: {
+    backgroundColor: "#e2e8f0",
+    transform: [{ scale: 0.985 }]
+  },
+  sheetCancelIcon: {
+    width: 18,
+    height: 18,
+    marginRight: 8
   },
   sheetCancelText: {
-    color: "#111827",
+    color: "#0f172a",
     fontSize: 16,
-    fontWeight: "600"
+    fontWeight: "700"
   }
 });
 
@@ -2467,6 +2830,9 @@ function useSagepilotChat() {
   };
 }
 export {
+  SAGEPILOT_DEFAULT_IMAGE_MAX_DIMENSION,
+  SAGEPILOT_DEFAULT_IMAGE_MAX_FILE_SIZE_BYTES,
+  SAGEPILOT_DEFAULT_IMAGE_QUALITY,
   SagepilotChat,
   SagepilotChatError,
   SagepilotChatProvider,
@@ -2475,5 +2841,7 @@ export {
   createKeychainTokenStorage,
   createSagepilotFilePicker,
   createSagepilotFileStore,
+  ensureSagepilotAndroidCameraPermission,
+  promptOpenSagepilotCameraSettings,
   useSagepilotChat
 };