@wireai/activation 0.12.2 → 0.13.2

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { StyleSheet, Easing, Animated, BackHandler, Modal, Pressable, Text, View, TouchableOpacity, KeyboardAvoidingView, ScrollView, useWindowDimensions, TextInput, Image, AccessibilityInfo, Platform, Dimensions, I18nManager, AppState, NativeModules, TurboModuleRegistry } from 'react-native';
-import React18, { createContext, forwardRef, useRef, useState, useEffect, useCallback, useImperativeHandle, useMemo, useContext, useSyncExternalStore } from 'react';
+import React19, { createContext, forwardRef, useRef, useState, useEffect, useCallback, useImperativeHandle, useMemo, useContext, useSyncExternalStore } from 'react';
 import { useWireAIThread, useWireAIAction, ComponentRenderer, WireAIProvider } from 'wireai-rn';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { SafeAreaView } from 'react-native-safe-area-context';
@@ -484,7 +484,7 @@ var useIllustration = (name2) => {
   if (!name2) return void 0;
   return registry[name2];
 };
-var Glyph = ({ children }) => {
+var Disc = ({ children }) => {
   const t = useOnboardingTheme();
   return /* @__PURE__ */ jsx(
     View,
@@ -493,11 +493,23 @@ var Glyph = ({ children }) => {
         styles.disc,
         { backgroundColor: t.colors.primarySoft, borderRadius: t.radius.full }
       ],
-      children: /* @__PURE__ */ jsx(Text, { style: [styles.glyphText, { color: t.colors.primary }], allowFontScaling: false, children })
+      children
     }
   );
 };
+var Glyph = ({ children }) => {
+  const t = useOnboardingTheme();
+  return /* @__PURE__ */ jsx(Disc, { children: /* @__PURE__ */ jsx(Text, { style: [styles.glyphText, { color: t.colors.primary }], allowFontScaling: false, children }) });
+};
 var MomentumGlyph = () => /* @__PURE__ */ jsx(Glyph, { children: "\u2197" });
+var NotificationsGlyph = () => {
+  const t = useOnboardingTheme();
+  return /* @__PURE__ */ jsx(Disc, { children: /* @__PURE__ */ jsxs(View, { style: styles.bell, children: [
+    /* @__PURE__ */ jsx(View, { style: [styles.bellBody, { backgroundColor: t.colors.primary }] }),
+    /* @__PURE__ */ jsx(View, { style: [styles.bellRim, { backgroundColor: t.colors.primary }] }),
+    /* @__PURE__ */ jsx(View, { style: [styles.bellClapper, { backgroundColor: t.colors.primary }] })
+  ] }) });
+};
 var BeforeAfterGlyph = () => {
   const t = useOnboardingTheme();
   return /* @__PURE__ */ jsxs(View, { style: styles.row, children: [
@@ -524,7 +536,8 @@ var BeforeAfterGlyph = () => {
 };
 var defaultIllustrations = {
   momentum: /* @__PURE__ */ jsx(MomentumGlyph, {}),
-  "before-after": /* @__PURE__ */ jsx(BeforeAfterGlyph, {})
+  "before-after": /* @__PURE__ */ jsx(BeforeAfterGlyph, {}),
+  notifications: /* @__PURE__ */ jsx(NotificationsGlyph, {})
 };
 var styles = StyleSheet.create({
   disc: {
@@ -552,7 +565,12 @@ var styles = StyleSheet.create({
   arrow: {
     fontSize: 28,
     fontWeight: "700"
-  }
+  },
+  // The bell: a domed body over a wider rim, with the clapper hanging below it.
+  bell: { alignItems: "center", justifyContent: "center" },
+  bellBody: { width: 34, height: 30, borderTopLeftRadius: 17, borderTopRightRadius: 17 },
+  bellRim: { width: 44, height: 5, borderRadius: 3, marginTop: 2 },
+  bellClapper: { width: 9, height: 9, borderRadius: 5, marginTop: 3 }
 });
 var EMPTY_REGISTRY2 = {};
 var IconContext = createContext(EMPTY_REGISTRY2);
@@ -802,7 +820,7 @@ var _AnimatedSparkle = ({ size = 30, color, variant = "spin" }) => {
     }
   ) });
 };
-var AnimatedSparkle = React18.memo(_AnimatedSparkle);
+var AnimatedSparkle = React19.memo(_AnimatedSparkle);
 var styles2 = StyleSheet.create({
   box: { alignItems: "center", justifyContent: "center" },
   glyph: {
@@ -905,7 +923,7 @@ var _LoadingBlock = ({
     )
   ] });
 };
-var LoadingBlock = React18.memo(_LoadingBlock);
+var LoadingBlock = React19.memo(_LoadingBlock);
 var styles3 = StyleSheet.create({
   center: { flex: 1, alignItems: "center", justifyContent: "center" },
   // Absolutely-positioned label column, pinned just under the centered stage: its top
@@ -950,7 +968,7 @@ var _LoadingScreen = ({ title, hint }) => {
     }
   );
 };
-var LoadingScreen = React18.memo(_LoadingScreen);
+var LoadingScreen = React19.memo(_LoadingScreen);
 var styles4 = StyleSheet.create({
   flex: { flex: 1 }
 });
@@ -990,7 +1008,7 @@ var _StepProgress = ({ step, complete, approxScreens }) => {
     }
   ) });
 };
-var StepProgress = React18.memo(_StepProgress);
+var StepProgress = React19.memo(_StepProgress);
 var styles5 = StyleSheet.create({
   track: { height: 6, width: "100%", overflow: "hidden" },
   fill: { height: 6 }
@@ -1030,7 +1048,7 @@ var _OnboardingScaffold = ({
     }
   );
 };
-var OnboardingScaffold = React18.memo(_OnboardingScaffold);
+var OnboardingScaffold = React19.memo(_OnboardingScaffold);
 function makeStyles(t) {
   return StyleSheet.create({
     flex: { flex: 1 },
@@ -1131,7 +1149,7 @@ var _Button = ({
     }
   );
 };
-var Button = React18.memo(_Button);
+var Button = React19.memo(_Button);
 var styles6 = StyleSheet.create({
   base: { alignItems: "center", justifyContent: "center" },
   fill: { width: "100%" }
@@ -1149,7 +1167,7 @@ var _ErrorBlock = ({
     onRetry ? /* @__PURE__ */ jsx(Button, { title: retryLabel, onPress: onRetry, variant: "outline" }) : null
   ] });
 };
-var ErrorBlock = React18.memo(_ErrorBlock);
+var ErrorBlock = React19.memo(_ErrorBlock);
 var styles7 = StyleSheet.create({
   center: { flex: 1, alignItems: "center", justifyContent: "center" }
 });
@@ -1195,7 +1213,7 @@ var _CardLayout = ({
     footer ? /* @__PURE__ */ jsx(View, { style: styles18.footer, children: footer }) : null
   ] });
 };
-var CardLayout = React18.memo(_CardLayout);
+var CardLayout = React19.memo(_CardLayout);
 function makeStyles2(t) {
   return StyleSheet.create({
     fill: { flex: 1 },
@@ -1320,7 +1338,7 @@ var _CompletionView = ({
     }
   );
 };
-var CompletionView = React18.memo(_CompletionView);
+var CompletionView = React19.memo(_CompletionView);
 var styles8 = StyleSheet.create({
   center: { width: "100%", alignItems: "center", justifyContent: "center" },
   badgeStage: {
@@ -1450,7 +1468,7 @@ var transformFor = (variant, t, reduced, layer, travel) => {
     }
   ];
 };
-var CardHandoff = React18.memo(_CardHandoff);
+var CardHandoff = React19.memo(_CardHandoff);
 var styles9 = StyleSheet.create({
   fill: { flex: 1 }
 });
@@ -1474,7 +1492,7 @@ var deriveAnswers = (messages) => {
     const props = (_a2 = r.props) != null ? _a2 : {};
     const progress = props.progress;
     const questionText = (_c = (_b = props.title) != null ? _b : props.label) != null ? _c : props.question;
-    const key = (progress == null ? void 0 : progress.key) || questionText;
+    const key = (progress == null ? void 0 : progress.slot_id) || (progress == null ? void 0 : progress.key) || questionText;
     const reply = messages[i + 1];
     if (key && (reply == null ? void 0 : reply.role) === "user") {
       out[key] = tryParse(stripPrefix(reply.content));
@@ -1495,45 +1513,71 @@ var readProgress = (response) => {
     step: typeof p.step === "number" ? p.step : void 0,
     total: typeof p.total === "number" ? p.total : void 0,
     key: typeof p.key === "string" ? p.key : void 0,
+    // Whitelisted the same way as every other field: an old backend simply omits it.
+    slot_id: typeof p.slot_id === "string" ? p.slot_id : void 0,
     skippable: typeof p.skippable === "boolean" ? p.skippable : void 0
   };
 };
 
 // src/analytics/reportClientEvent.ts
 var makeSessionId = () => `wire_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+var toWireEvents = (events) => events.map((event) => {
+  if (typeof event.ts !== "number") return event;
+  const { ts, ...rest } = event;
+  if (!Number.isFinite(ts)) return rest;
+  try {
+    return { ...rest, ts: new Date(ts).toISOString() };
+  } catch {
+    return rest;
+  }
+});
 var buildEventsRequest = (target, events) => {
   if (!(target == null ? void 0 : target.serverUrl) || events.length === 0) return null;
   try {
     const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
     const headers = { "Content-Type": "application/json" };
     if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
-    return { url, init: { method: "POST", headers, body: JSON.stringify({ events }) } };
+    const body = JSON.stringify({ events: toWireEvents(events) });
+    return { url, init: { method: "POST", headers, body } };
   } catch {
     return null;
   }
 };
-var warnOnSkippedEvents = (res) => {
-  if (typeof __DEV__ === "undefined" || !__DEV__) return;
-  if (typeof console === "undefined" || !console.warn) return;
+var readEventsAck = async (res) => {
   try {
     const json = res == null ? void 0 : res.json;
-    if (typeof json !== "function") return;
-    void Promise.resolve(json.call(res)).then((body) => {
-      const skipped = body == null ? void 0 : body.skipped;
-      if (typeof skipped !== "number" || skipped <= 0) return;
-      console.warn(
-        `[wireai] the server ACCEPTED the /v1/events POST but DISCARDED ${skipped} event(s) (skipped in the response body) \u2014 they are gone, not retried. The usual cause is an event with a missing or empty session_id.`
-      );
-    }).catch(() => {
-    });
+    if (typeof json !== "function") return void 0;
+    const body = await Promise.resolve(json.call(res));
+    const skipped = body == null ? void 0 : body.skipped;
+    if (typeof skipped !== "number" || !Number.isFinite(skipped)) return void 0;
+    const reasons = Array.isArray(body == null ? void 0 : body.errors) ? body.errors.map((e) => {
+      const entry = e;
+      const reason = entry == null ? void 0 : entry.reason;
+      if (typeof reason !== "string") return void 0;
+      const field = entry == null ? void 0 : entry.field;
+      return typeof field === "string" && field.length > 0 ? `${reason} (field: ${field})` : reason;
+    }).filter((r) => typeof r === "string") : [];
+    return { written: typeof (body == null ? void 0 : body.written) === "number" ? body.written : void 0, skipped, reasons };
   } catch {
+    return void 0;
   }
 };
+var describeDiscarded = (ack) => `[wireai] the server ACCEPTED the /v1/events POST but DISCARDED ${ack.skipped} event(s) (skipped in the response body) \u2014 they are gone, not retried. The server reported: skipped=${ack.skipped}${ack.written !== void 0 ? `, written=${ack.written}` : ""}` + (ack.reasons.length > 0 ? `, reasons: ${ack.reasons.join(", ")}.` : ". It gave no reason (the endpoint folds every rejection into one count), so check the server's ingest log for this request rather than guessing.");
+var warnOnSkippedEvents = (res) => {
+  if (typeof __DEV__ === "undefined" || !__DEV__) return;
+  if (typeof console === "undefined" || !console.warn) return;
+  void readEventsAck(res).then((ack) => {
+    if (!ack || ack.skipped <= 0) return;
+    console.warn(describeDiscarded(ack));
+  });
+};
 var reportClientEvents = (target, events) => {
   try {
     const req = buildEventsRequest(target, events);
     if (!req) return;
-    void fetch(req.url, req.init).catch(() => {
+    void fetch(req.url, req.init).then((res) => {
+      warnOnSkippedEvents(res);
+    }).catch(() => {
     });
   } catch {
   }
@@ -1544,7 +1588,13 @@ var reportClientEventsAwait = async (target, events) => {
     const req = buildEventsRequest(target, events);
     if (!req) return false;
     const res = await fetch(req.url, req.init);
-    return Boolean(res && res.ok);
+    if (!res || !res.ok) return false;
+    const ack = await readEventsAck(res);
+    if (!ack || ack.skipped <= 0) return true;
+    if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+      console.warn(describeDiscarded(ack));
+    }
+    return false;
   } catch {
     return false;
   }
@@ -1576,6 +1626,382 @@ var sendPreview = (target, { sessionId, userMessage }) => {
   } catch {
   }
 };
+
+// src/permissions/permissionEvents.ts
+var WIRE_PERMISSION_EVENTS = {
+  /** The priming screen became visible. The denominator for every rate below. */
+  screenShown: "wire_permission_screen_shown",
+  /** The user tapped the primary, so the OS dialog is about to open. The rationale worked. */
+  primerAccepted: "wire_permission_primer_accepted",
+  /** The OS granted it. */
+  granted: "wire_permission_granted",
+  /** The OS refused it (a permanently blocked answer reports here too, with `status: "blocked"`). */
+  denied: "wire_permission_denied",
+  /** The user took the secondary. The one native prompt was NOT spent. */
+  skipped: "wire_permission_skipped",
+  /** A blocked user was redirected to the OS settings page. */
+  settingsOpened: "wire_permission_settings_opened"
+};
+var permissionEventName = (stage) => {
+  switch (stage) {
+    case "shown":
+      return WIRE_PERMISSION_EVENTS.screenShown;
+    case "accepted":
+      return WIRE_PERMISSION_EVENTS.primerAccepted;
+    case "granted":
+      return WIRE_PERMISSION_EVENTS.granted;
+    case "denied":
+      return WIRE_PERMISSION_EVENTS.denied;
+    case "skipped":
+      return WIRE_PERMISSION_EVENTS.skipped;
+    case "settings":
+      return WIRE_PERMISSION_EVENTS.settingsOpened;
+    default: {
+      const _exhaustive = stage;
+      return _exhaustive;
+    }
+  }
+};
+var permissionEventProps = (permission, status) => status ? { permission, status } : { permission };
+var normalizePermissionStatus = (value) => value === "granted" || value === "denied" || value === "blocked" ? value : "denied";
+
+// src/haptics/haptics.ts
+var play = async (tone) => {
+  try {
+    const mod = await import('expo-haptics');
+    if (!mod) return false;
+    if (tone === "selection") ;
+    if (tone === "light") ;
+    await mod.notificationAsync(mod.NotificationFeedbackType.Success);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var playHaptic = (tone) => {
+  void play(tone);
+};
+
+// src/utils/warnInDev.ts
+var warnInDev = (message) => {
+  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+    console.warn(message);
+    return true;
+  }
+  return false;
+};
+var easeWire4 = Easing.bezier(...WIRE_BEZIER);
+var RISE_PX = 10;
+var PERMISSION_CARD_NAME = "PermissionCard";
+var REQUEST_WATCHDOG_MS = 9e4;
+var schema = z.object({
+  permission: z.string().describe("Which OS permission this screen primes, e.g. 'notifications'"),
+  title: z.string().describe("Headline for the ask"),
+  message: z.string().describe("Why the app needs it, in the user's terms"),
+  primaryLabel: z.string().describe("Primary button, the only control that can open the OS dialog"),
+  secondaryLabel: z.string().describe("Secondary button, advances without spending the OS prompt"),
+  blockedTitle: z.string().optional().describe("Headline once the permission is permanently refused"),
+  blockedMessage: z.string().optional().describe("Rationale for the settings route"),
+  settingsLabel: z.string().optional().describe("Primary button label on the blocked route"),
+  continueLabel: z.string().optional().describe("Primary button label when there is nothing to ask"),
+  illustration: z.string().optional().describe("Name of an app-provided illustration (defaults to the permission name)")
+});
+var _PermissionCard = ({
+  permission,
+  title,
+  message,
+  primaryLabel,
+  secondaryLabel,
+  blockedTitle,
+  blockedMessage,
+  settingsLabel,
+  continueLabel,
+  illustration,
+  request,
+  getStatus,
+  openSettings,
+  onStage,
+  onSettled
+}) => {
+  const t = useOnboardingTheme();
+  const reduced = useReducedMotion();
+  const art = useIllustration(illustration != null ? illustration : permission);
+  const [status, setStatus] = useState(void 0);
+  const [busy, setBusy] = useState(false);
+  const settledRef = useRef(false);
+  const acceptedRef = useRef(false);
+  const watchdogRef = useRef(null);
+  const clearWatchdog = useCallback(() => {
+    if (watchdogRef.current) {
+      clearTimeout(watchdogRef.current);
+      watchdogRef.current = null;
+    }
+  }, []);
+  useEffect(() => clearWatchdog, [clearWatchdog]);
+  const onStageRef = useRef(onStage);
+  onStageRef.current = onStage;
+  const onSettledRef = useRef(onSettled);
+  onSettledRef.current = onSettled;
+  const getStatusRef = useRef(getStatus);
+  getStatusRef.current = getStatus;
+  const shownRef = useRef(false);
+  useEffect(() => {
+    var _a2;
+    if (shownRef.current) return;
+    shownRef.current = true;
+    (_a2 = onStageRef.current) == null ? void 0 : _a2.call(onStageRef, "shown");
+  }, []);
+  useEffect(() => {
+    const probe = getStatusRef.current;
+    if (!probe) return;
+    let cancelled = false;
+    try {
+      void Promise.resolve(probe()).then((value) => {
+        if (!cancelled) setStatus(normalizePermissionStatus(value));
+      }).catch(() => {
+      });
+    } catch {
+    }
+    return () => {
+      cancelled = true;
+    };
+  }, []);
+  const requestRef = useRef(request);
+  requestRef.current = request;
+  useEffect(() => {
+    if (requestRef.current) return;
+    warnInDev(
+      `[wireai] <WireOnboarding> got a permission screen for "${permission}" with no \`request\` function, so it cannot open the OS dialog and renders as a plain continue. Pass request: () => Promise<'granted' | 'denied' | 'blocked'> (5 lines around expo-notifications, see the README).`
+    );
+  }, [permission]);
+  const settle = useCallback((outcome) => {
+    var _a2;
+    if (settledRef.current) return;
+    settledRef.current = true;
+    clearWatchdog();
+    (_a2 = onSettledRef.current) == null ? void 0 : _a2.call(onSettledRef, outcome);
+  }, [clearWatchdog]);
+  const primaryAction = status === "blocked" ? "settings" : status === "granted" || !request ? "continue" : "ask";
+  const handlePrimary = useCallback(() => {
+    var _a2, _b, _c, _d;
+    if (settledRef.current || busy) return;
+    if (primaryAction === "settings") {
+      (_a2 = onStageRef.current) == null ? void 0 : _a2.call(onStageRef, "settings", "blocked");
+      try {
+        void Promise.resolve(openSettings == null ? void 0 : openSettings()).catch(() => {
+        });
+      } catch {
+      }
+      settle("blocked");
+      return;
+    }
+    if (primaryAction === "continue") {
+      if (status === "granted") {
+        (_b = onStageRef.current) == null ? void 0 : _b.call(onStageRef, "granted", "granted");
+        settle("granted");
+      } else {
+        (_c = onStageRef.current) == null ? void 0 : _c.call(onStageRef, "skipped");
+        settle("skipped");
+      }
+      return;
+    }
+    if (!acceptedRef.current) {
+      acceptedRef.current = true;
+      (_d = onStageRef.current) == null ? void 0 : _d.call(onStageRef, "accepted");
+    }
+    setBusy(true);
+    const finish = (value) => {
+      var _a3, _b2;
+      if (settledRef.current) return;
+      clearWatchdog();
+      const resolved = normalizePermissionStatus(value);
+      setBusy(false);
+      setStatus(resolved);
+      if (resolved === "granted") {
+        playHaptic("success");
+        (_a3 = onStageRef.current) == null ? void 0 : _a3.call(onStageRef, "granted", "granted");
+      } else {
+        (_b2 = onStageRef.current) == null ? void 0 : _b2.call(onStageRef, "denied", resolved);
+      }
+      settle(resolved);
+    };
+    clearWatchdog();
+    watchdogRef.current = setTimeout(() => {
+      watchdogRef.current = null;
+      if (settledRef.current) return;
+      setBusy(false);
+      warnInDev(
+        `[wireai] the \`request\` for the "${permission}" permission screen has not settled after ${Math.round(REQUEST_WATCHDOG_MS / 1e3)}s, so the kit handed the controls back rather than leaving the user on a dead-end screen. It recorded NO outcome, because a pending request is not a denial. Make sure your request resolves to 'granted' | 'denied' | 'blocked' on every branch, including the one where the user dismisses the OS dialog.`
+      );
+    }, REQUEST_WATCHDOG_MS);
+    try {
+      void Promise.resolve(request == null ? void 0 : request()).then(finish, () => finish("denied"));
+    } catch {
+      finish("denied");
+    }
+  }, [busy, primaryAction, status, request, openSettings, settle, clearWatchdog, permission]);
+  const handleSecondary = useCallback(() => {
+    var _a2;
+    if (settledRef.current || busy) return;
+    (_a2 = onStageRef.current) == null ? void 0 : _a2.call(onStageRef, "skipped");
+    settle("skipped");
+  }, [busy, settle]);
+  const popT = useRef(new Animated.Value(reduced ? 1 : 0)).current;
+  const titleT = useRef(new Animated.Value(reduced ? 1 : 0)).current;
+  const bodyT = useRef(new Animated.Value(reduced ? 1 : 0)).current;
+  useEffect(() => {
+    if (reduced) {
+      popT.setValue(1);
+      titleT.setValue(1);
+      bodyT.setValue(1);
+      return;
+    }
+    const rise = (value, delay) => Animated.timing(value, {
+      toValue: 1,
+      duration: scaledMs(INTERSTITIAL_HEAD_MS),
+      delay,
+      easing: easeWire4,
+      useNativeDriver: true
+    });
+    const anims = [
+      Animated.spring(popT, {
+        toValue: 1,
+        friction: STATUS_POP_SPRING.friction,
+        tension: STATUS_POP_SPRING.tension,
+        useNativeDriver: true
+      }),
+      rise(titleT, scaledMs(INTERSTITIAL_HEAD_STAGGER_MS)),
+      rise(bodyT, scaledMs(INTERSTITIAL_HEAD_STAGGER_MS * 2))
+    ];
+    anims.forEach((a) => a.start());
+    return () => anims.forEach((a) => a.stop());
+  }, [reduced, popT, titleT, bodyT]);
+  const popScale = popT.interpolate({
+    inputRange: [0, 1],
+    outputRange: [STATUS_POP_SCALE_FROM, 1]
+  });
+  const riseStyle = (value) => ({
+    opacity: value,
+    transform: [
+      { translateY: value.interpolate({ inputRange: [0, 1], outputRange: [RISE_PX, 0] }) }
+    ]
+  });
+  const blocked = status === "blocked";
+  const shownTitle = blocked ? blockedTitle != null ? blockedTitle : title : title;
+  const shownMessage = blocked ? blockedMessage != null ? blockedMessage : message : message;
+  const primaryTitle = primaryAction === "settings" ? settingsLabel != null ? settingsLabel : primaryLabel : primaryAction === "continue" ? continueLabel != null ? continueLabel : primaryLabel : primaryLabel;
+  const showSecondary = status !== "granted";
+  return /* @__PURE__ */ jsx(
+    CardLayout,
+    {
+      align: "center",
+      footer: /* @__PURE__ */ jsxs(View, { style: [styles10.footer, { gap: t.spacing.sm }], children: [
+        /* @__PURE__ */ jsx(Button, { title: primaryTitle, onPress: handlePrimary, variant: "primary", disabled: busy }),
+        showSecondary ? /* @__PURE__ */ jsx(
+          Button,
+          {
+            title: secondaryLabel,
+            onPress: handleSecondary,
+            variant: "outline",
+            disabled: busy
+          }
+        ) : null
+      ] }),
+      children: /* @__PURE__ */ jsxs(View, { style: [styles10.center, { gap: t.spacing.md }], children: [
+        art ? /* @__PURE__ */ jsx(
+          Animated.View,
+          {
+            style: [styles10.art, { opacity: popT, transform: [{ scale: popScale }] }],
+            children: art
+          }
+        ) : null,
+        /* @__PURE__ */ jsx(Animated.View, { style: riseStyle(titleT), children: /* @__PURE__ */ jsx(Text, { style: [headingStyle(t.fonts), { color: t.colors.text, textAlign: "center" }], children: shownTitle }) }),
+        /* @__PURE__ */ jsx(Animated.View, { style: riseStyle(bodyT), children: /* @__PURE__ */ jsx(Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted, textAlign: "center" }], children: shownMessage }) })
+      ] })
+    }
+  );
+};
+var PermissionCardView = React19.memo(_PermissionCard);
+var PermissionCard = {
+  name: PERMISSION_CARD_NAME,
+  description: "A priming screen shown BEFORE an OS permission dialog: it explains why the app wants the permission and asks only on the primary tap. Never first, never last. The user is never blocked by it: the secondary advances the flow with the OS prompt unspent.",
+  component: PermissionCardView,
+  propsSchema: schema
+};
+var styles10 = StyleSheet.create({
+  center: { width: "100%", alignItems: "center", justifyContent: "center" },
+  art: { alignItems: "center", justifyContent: "center" },
+  footer: { width: "100%", alignItems: "center" }
+});
+
+// src/permissions/placement.ts
+var DEFAULT_PERMISSION_PLACEMENT = "beforeEnd";
+var normalizeAfterCard = (value) => Number.isFinite(value) ? Math.max(0, Math.floor(value)) : 0;
+var targetIndex = (placement) => {
+  if (placement === "beforeEnd") return void 0;
+  if (placement === "start") return 0;
+  return normalizeAfterCard(placement.afterCard);
+};
+var isPermissionDue = (placement, position) => {
+  if (position.cardIndex < 0) return false;
+  const target = targetIndex(placement);
+  if (target === void 0) return position.isTerminal;
+  return position.cardIndex >= target || position.isTerminal;
+};
+var permissionScreenId = (screen, index) => {
+  var _a2;
+  return (_a2 = screen.id) != null ? _a2 : `${screen.permission}:${index}`;
+};
+var selectDuePermissionScreen = (screens, settled, position) => {
+  var _a2;
+  if (!screens || screens.length === 0) return void 0;
+  for (let index = 0; index < screens.length; index++) {
+    const screen = screens[index];
+    if (!screen) continue;
+    const id = permissionScreenId(screen, index);
+    if (settled.includes(id)) continue;
+    if (isPermissionDue((_a2 = screen.placement) != null ? _a2 : DEFAULT_PERMISSION_PLACEMENT, position)) {
+      return { screen, id };
+    }
+  }
+  return void 0;
+};
+
+// src/permissions/permissionCopy.ts
+var NOTIFICATIONS_PERMISSION_COPY = {
+  title: "Want a nudge at the right moment?",
+  message: "Turn notifications on and we will remind you when it actually helps. No daily noise, and you can turn them off any time.",
+  primaryLabel: "Enable notifications",
+  secondaryLabel: "Maybe later",
+  blockedTitle: "Notifications are switched off",
+  blockedMessage: "Notifications are turned off for this app, so we cannot ask from here. You can switch them back on in Settings.",
+  settingsLabel: "Open settings",
+  continueLabel: "Continue"
+};
+var GENERIC_PERMISSION_COPY = {
+  title: "One quick permission",
+  message: "We need your permission for this part to work. You can change it any time.",
+  primaryLabel: "Allow",
+  secondaryLabel: "Maybe later",
+  blockedTitle: "Permission is switched off",
+  blockedMessage: "This permission is turned off for this app, so we cannot ask from here. You can switch it back on in Settings.",
+  settingsLabel: "Open settings",
+  continueLabel: "Continue"
+};
+var DEFAULT_PERMISSION_COPY = {
+  notifications: NOTIFICATIONS_PERMISSION_COPY
+};
+var resolvePermissionCopy = (permission, overrides) => {
+  var _a2;
+  const base = (_a2 = DEFAULT_PERMISSION_COPY[permission]) != null ? _a2 : GENERIC_PERMISSION_COPY;
+  if (!overrides) return base;
+  const merged = { ...base };
+  for (const key of Object.keys(overrides)) {
+    const value = overrides[key];
+    if (typeof value === "string" && value.length > 0) merged[key] = value;
+  }
+  return merged;
+};
 var SKIP_ONE_SENTINEL = "__wireai_skip__";
 var ANSWER_CALLBACKS = ["onSubmit", "onSelect", "onConfirm", "onPress"];
 var DEFAULT_COPY = {
@@ -1604,7 +2030,11 @@ var OnboardingFlow = ({
   reportTarget,
   sessionId,
   resumed = false,
-  clientContext
+  clientContext,
+  permissionScreens,
+  settledPermissions,
+  permissionsPending = false,
+  onPermissionSettled
 }) => {
   var _a2, _b, _c, _d, _e, _f;
   const { messages, error, isLoading, sendMessage, reset } = useWireAIThread();
@@ -1635,6 +2065,9 @@ var OnboardingFlow = ({
   const [timedOut, setTimedOut] = useState(false);
   const [validationError, setValidationError] = useState();
   const [validating, setValidating] = useState(false);
+  const [locallySettledPermissions, setLocallySettledPermissions] = useState([]);
+  const onPermissionSettledRef = useRef(onPermissionSettled);
+  onPermissionSettledRef.current = onPermissionSettled;
   const lastCard = useMemo(
     () => [...messages].reverse().find((m) => {
       var _a3;
@@ -1745,6 +2178,36 @@ var OnboardingFlow = ({
     if (isLoading) return;
     sendMessage(SKIP_ONE_SENTINEL);
   }, [isLoading, sendMessage]);
+  const emitPermissionStage = useCallback(
+    (permission, stage, status) => {
+      var _a3, _b2, _c2, _d2;
+      (_a3 = onEventRef.current) == null ? void 0 : _a3.call(onEventRef, { type: "permission", permission, stage, status });
+      reportClientEvent(reportTargetRef.current, {
+        event_type: "app_event",
+        session_id: sessionIdRef.current,
+        question_key: permissionEventName(stage),
+        component: PERMISSION_CARD_NAME,
+        screen_index: lastScreenIndexRef.current >= 0 ? lastScreenIndexRef.current : void 0,
+        meta: JSON.stringify(permissionEventProps(permission, status)),
+        device: (_b2 = clientContextRef.current) == null ? void 0 : _b2.device,
+        user_context: (_c2 = clientContextRef.current) == null ? void 0 : _c2.userContext,
+        user_id: (_d2 = clientContextRef.current) == null ? void 0 : _d2.userId
+      });
+    },
+    []
+  );
+  const settlePermission = useCallback(
+    (id, screen, outcome) => {
+      var _a3, _b2;
+      setLocallySettledPermissions((prev) => prev.includes(id) ? prev : [...prev, id]);
+      (_a3 = onPermissionSettledRef.current) == null ? void 0 : _a3.call(onPermissionSettledRef, id, outcome);
+      try {
+        (_b2 = screen.onResult) == null ? void 0 : _b2.call(screen, screen.permission, outcome);
+      } catch {
+      }
+    },
+    []
+  );
   const previewOnSelect = useCallback((value) => {
     const target = reportTargetRef.current;
     if (!(target == null ? void 0 : target.serverUrl)) return;
@@ -1764,8 +2227,8 @@ var OnboardingFlow = ({
     (messageId) => {
       var _a3;
       const base = makeActions(messageId);
-      const key = progress.key;
-      const validator = key ? (_a3 = validatorsRef.current) == null ? void 0 : _a3[key] : void 0;
+      const validators2 = validatorsRef.current;
+      const validator = (_a3 = progress.slot_id ? validators2 == null ? void 0 : validators2[progress.slot_id] : void 0) != null ? _a3 : progress.key ? validators2 == null ? void 0 : validators2[progress.key] : void 0;
       if (!validator) return base;
       const out = { ...base };
       for (const name2 of ANSWER_CALLBACKS) {
@@ -1790,7 +2253,7 @@ var OnboardingFlow = ({
       }
       return out;
     },
-    [makeActions, progress.key]
+    [makeActions, progress.key, progress.slot_id]
   );
   if (degraded) {
     if (fallbackFlow !== void 0) return /* @__PURE__ */ jsx(Fragment, { children: fallbackFlow });
@@ -1815,6 +2278,36 @@ var OnboardingFlow = ({
   const step = (_a2 = progress.step) != null ? _a2 : renderedCount;
   const total = (_b = progress.total) != null ? _b : approxScreens;
   const isTerminal = response.action === "render" && response.component === "StatusCard";
+  const duePermission = permissionsPending ? void 0 : selectDuePermissionScreen(
+    permissionScreens,
+    settledPermissions ? [...settledPermissions, ...locallySettledPermissions] : locallySettledPermissions,
+    { cardIndex: renderedCount - 1, isTerminal }
+  );
+  if (duePermission) {
+    const { screen, id } = duePermission;
+    const copy2 = resolvePermissionCopy(screen.permission, screen.copy);
+    return /* @__PURE__ */ jsx(OnboardingScaffold, { step, approxScreens: total, children: /* @__PURE__ */ jsx(CardHandoff, { transitionKey: `permission:${id}`, variant: "spring", children: /* @__PURE__ */ jsx(
+      PermissionCardView,
+      {
+        permission: screen.permission,
+        title: copy2.title,
+        message: copy2.message,
+        primaryLabel: copy2.primaryLabel,
+        secondaryLabel: copy2.secondaryLabel,
+        blockedTitle: copy2.blockedTitle,
+        blockedMessage: copy2.blockedMessage,
+        settingsLabel: copy2.settingsLabel,
+        continueLabel: copy2.continueLabel,
+        illustration: screen.illustration,
+        request: screen.request,
+        getStatus: screen.getStatus,
+        openSettings: screen.openSettings,
+        onStage: (stage, status) => emitPermissionStage(screen.permission, stage, status),
+        onSettled: (outcome) => settlePermission(id, screen, outcome)
+      },
+      id
+    ) }) });
+  }
   if (isTerminal) {
     const props = (_c = response.props) != null ? _c : {};
     return /* @__PURE__ */ jsx(OnboardingScaffold, { step, complete: true, approxScreens: total, children: /* @__PURE__ */ jsx(
@@ -1873,8 +2366,8 @@ var OnboardingFlow = ({
     }
   );
 };
-var easeWire4 = Easing.bezier(...WIRE_BEZIER);
-var schema = z.object({
+var easeWire5 = Easing.bezier(...WIRE_BEZIER);
+var schema2 = z.object({
   title: z.string().describe("Question or section header, e.g. 'Which season?'"),
   chips: z.array(z.string()).min(1).describe("List of option labels shown as chips, e.g. ['Spring','Summer','Autumn','Winter']"),
   multiSelect: z.boolean().optional().describe("Allow multiple chips selected at once, default true"),
@@ -1905,7 +2398,7 @@ var _ChipItem = ({ chip, isSelected, multiSelect, onToggle }) => {
     const anim = Animated.timing(fillT, {
       toValue: isSelected ? 1 : 0,
       duration: scaledMs(stateChangeDuration(reduced, CHIP_FILL_MS)),
-      easing: easeWire4,
+      easing: easeWire5,
       useNativeDriver: true
     });
     anim.start();
@@ -1945,7 +2438,7 @@ var _ChipItem = ({ chip, isSelected, multiSelect, onToggle }) => {
         Animated.View,
         {
           style: [
-            styles10.chip,
+            styles11.chip,
             {
               borderRadius: t.radius.full,
               paddingHorizontal: t.spacing.md,
@@ -1962,7 +2455,7 @@ var _ChipItem = ({ chip, isSelected, multiSelect, onToggle }) => {
                 pointerEvents: "none",
                 style: [
                   StyleSheet.absoluteFill,
-                  styles10.fillOverlay,
+                  styles11.fillOverlay,
                   {
                     borderRadius: t.radius.full,
                     borderColor: t.colors.primary,
@@ -1976,7 +2469,7 @@ var _ChipItem = ({ chip, isSelected, multiSelect, onToggle }) => {
               Animated.Text,
               {
                 style: [
-                  styles10.check,
+                  styles11.check,
                   { color: t.colors.onPrimary, opacity: checkT, transform: [{ scale: checkScale }] }
                 ],
                 children: "\u2713"
@@ -1987,7 +2480,7 @@ var _ChipItem = ({ chip, isSelected, multiSelect, onToggle }) => {
               {
                 style: [
                   captionStyle(t.fonts),
-                  styles10.chipLabel,
+                  styles11.chipLabel,
                   { color: isSelected ? t.colors.onPrimary : t.colors.textMuted }
                 ],
                 children: chip
@@ -1999,7 +2492,7 @@ var _ChipItem = ({ chip, isSelected, multiSelect, onToggle }) => {
     }
   );
 };
-var ChipItem = React18.memo(_ChipItem);
+var ChipItem = React19.memo(_ChipItem);
 var _ChipSelectCard = ({
   title,
   chips,
@@ -2049,7 +2542,7 @@ var _ChipSelectCard = ({
           disabled: selected.length === 0 || submitted
         }
       ),
-      children: /* @__PURE__ */ jsx(View, { style: [styles10.chipsRow, { gap: t.spacing.sm + t.spacing.xs }], children: chips.map((chip) => /* @__PURE__ */ jsx(
+      children: /* @__PURE__ */ jsx(View, { style: [styles11.chipsRow, { gap: t.spacing.sm + t.spacing.xs }], children: chips.map((chip) => /* @__PURE__ */ jsx(
         ChipItem,
         {
           chip,
@@ -2065,18 +2558,18 @@ var _ChipSelectCard = ({
 var ChipSelectCard = {
   name: "ChipSelectCard",
   description: "Use for compact short labels: seasons, activities, travel styles, moods, categories. Ideal for 4\u201312 single-word or two-word options. Use SelectionCard instead when options need descriptions; use CardGridSelectCard for a smaller set (2\u20136) of visual choices that each deserve an icon.",
-  component: React18.memo(_ChipSelectCard),
-  propsSchema: schema,
+  component: React19.memo(_ChipSelectCard),
+  propsSchema: schema2,
   defaultProps: { multiSelect: true, submitLabel: "Continue" }
 };
-var styles10 = StyleSheet.create({
+var styles11 = StyleSheet.create({
   chipsRow: { flexDirection: "row", flexWrap: "wrap" },
   chip: { borderWidth: 1.5, flexDirection: "row", alignItems: "center", gap: 6, overflow: "hidden" },
   fillOverlay: { borderWidth: 1.5 },
   chipLabel: { fontWeight: "600" },
   check: { fontSize: 13, fontWeight: "800", lineHeight: 15 }
 });
-var schema2 = z.object({
+var schema3 = z.object({
   label: z.string().describe("Input field label / the question being asked"),
   hint: z.string().optional().describe(
     "One short line under the question giving context: what the answer is used for or why you ask. Add it whenever the question alone might be unclear."
@@ -2162,8 +2655,8 @@ var _TextInputCard = ({
 var TextInputCard = {
   name: "TextInputCard",
   description: "Use when the user needs to type a free-text answer: an open-ended goal, notes, feedback, a name, a destination, a search query. Multi-line by default (great for open-ended goals); set multiline:false for a short single-line field like a name. Use NumberStepperCard for numeric ranges with known bounds.",
-  component: React18.memo(_TextInputCard),
-  propsSchema: schema2,
+  component: React19.memo(_TextInputCard),
+  propsSchema: schema3,
   defaultProps: { submitLabel: "Submit", multiline: true, lines: 6 }
 };
 function makeStyles3(t) {
@@ -2318,7 +2811,7 @@ var _WireIcon = ({ name: name2, size = 20, color, requireModule }) => {
     return /* @__PURE__ */ jsx(
       View,
       {
-        style: styles11.decorative,
+        style: styles12.decorative,
         accessible: false,
         importantForAccessibility: "no-hide-descendants",
         children: hostIcon
@@ -2332,7 +2825,7 @@ var _WireIcon = ({ name: name2, size = 20, color, requireModule }) => {
   return /* @__PURE__ */ jsx(
     View,
     {
-      style: styles11.decorative,
+      style: styles12.decorative,
       accessible: false,
       importantForAccessibility: "no-hide-descendants",
       children: /* @__PURE__ */ jsx(
@@ -2347,9 +2840,9 @@ var _WireIcon = ({ name: name2, size = 20, color, requireModule }) => {
     }
   );
 };
-var WireIcon = React18.memo(_WireIcon);
+var WireIcon = React19.memo(_WireIcon);
 WireIcon.displayName = "WireIcon";
-var styles11 = StyleSheet.create({
+var styles12 = StyleSheet.create({
   // No size/margin of its own: the glyph decides its footprint, so an absent icon and a
   // present one differ by exactly the glyph — never by a wrapper.
   decorative: {}
@@ -2363,8 +2856,8 @@ var optionObjectSchema = z.object({
 var coerceOptions = (arr) => Array.isArray(arr) ? arr.map((item) => typeof item === "string" ? { value: item, label: item } : item) : arr;
 var optionsField = (description) => z.preprocess(coerceOptions, z.array(optionObjectSchema).min(1)).describe(description);
 var normalizeOptions = (options) => options.map((opt) => typeof opt === "string" ? { value: opt, label: opt } : opt);
-var easeWire5 = Easing.bezier(...WIRE_BEZIER);
-var schema3 = z.object({
+var easeWire6 = Easing.bezier(...WIRE_BEZIER);
+var schema4 = z.object({
   title: z.string().describe("Question or prompt for the user"),
   options: optionsField("List of choices"),
   submitLabel: z.string().optional().describe("Submit button label, default: Continue"),
@@ -2394,7 +2887,7 @@ var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
     const anim = Animated.timing(selectT, {
       toValue: isSelected ? 1 : 0,
       duration: scaledMs(stateChangeDuration(reduced, SELECT_FILL_MS)),
-      easing: easeWire5,
+      easing: easeWire6,
       useNativeDriver: true
     });
     anim.start();
@@ -2434,7 +2927,7 @@ var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
         Animated.View,
         {
           style: [
-            styles12.option,
+            styles13.option,
             {
               padding: t.spacing.md,
               borderRadius: t.radius.md,
@@ -2451,7 +2944,7 @@ var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
                 pointerEvents: "none",
                 style: [
                   StyleSheet.absoluteFill,
-                  styles12.selectedOverlay,
+                  styles13.selectedOverlay,
                   {
                     borderRadius: t.radius.md,
                     borderColor: t.colors.primary,
@@ -2465,7 +2958,7 @@ var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
               View,
               {
                 style: [
-                  styles12.indicator,
+                  styles13.indicator,
                   { borderRadius: t.radius.full },
                   isSelected ? { borderColor: t.colors.primary, backgroundColor: t.colors.primary } : { borderColor: t.colors.borderStrong, backgroundColor: "transparent" }
                 ],
@@ -2473,7 +2966,7 @@ var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
                   Animated.Text,
                   {
                     style: [
-                      styles12.check,
+                      styles13.check,
                       { color: t.colors.onPrimary, opacity: checkT, transform: [{ scale: checkScale }] }
                     ],
                     children: "\u2713"
@@ -2489,7 +2982,7 @@ var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
     }
   );
 };
-var OptionRow = React18.memo(_OptionRow);
+var OptionRow = React19.memo(_OptionRow);
 var _SelectionCard = ({
   title,
   options,
@@ -2499,7 +2992,7 @@ var _SelectionCard = ({
   onSelectionChange
 }) => {
   const t = useOnboardingTheme();
-  const opts = React18.useMemo(() => normalizeOptions(options), [options]);
+  const opts = React19.useMemo(() => normalizeOptions(options), [options]);
   const [selected, setSelected] = useState([]);
   const [submitted, setSubmitted] = useState(false);
   useEffect(() => {
@@ -2550,18 +3043,18 @@ var _SelectionCard = ({
 var SelectionCard = {
   name: "SelectionCard",
   description: "Use for mutually exclusive (radio) or multi-select (checkbox) choices from 2\u20138 options, as a vertical list of rows. Best when options are wordy or need reading. Options may carry an optional `icon` from the vocabulary to make the list scannable. Use ChipSelectCard instead when options are short single words; use CardGridSelectCard when the options are visual and each has an obvious icon (occasions, channels, categories).",
-  component: React18.memo(_SelectionCard),
-  propsSchema: schema3,
+  component: React19.memo(_SelectionCard),
+  propsSchema: schema4,
   defaultProps: { submitLabel: "Continue", multiSelect: false }
 };
-var styles12 = StyleSheet.create({
+var styles13 = StyleSheet.create({
   option: { borderWidth: 1.5, flexDirection: "row", alignItems: "center", overflow: "hidden" },
   selectedOverlay: { borderWidth: 1.5 },
   indicator: { width: 24, height: 24, borderWidth: 2, alignItems: "center", justifyContent: "center" },
   check: { fontSize: 13, fontWeight: "800", lineHeight: 15 }
 });
-var easeWire6 = Easing.bezier(...WIRE_BEZIER);
-var schema4 = z.object({
+var easeWire7 = Easing.bezier(...WIRE_BEZIER);
+var schema5 = z.object({
   title: z.string().describe("Question or prompt for the user, e.g. 'What brings you here?'"),
   options: optionsField(
     "The choices, 2-6 of them. Give EVERY option an `icon` from the vocabulary \u2014 the icon is the point of this card, and an option without one renders as a bare label next to icon-bearing neighbours. Keep labels short (1-3 words) so they fit a half-width card."
@@ -2593,7 +3086,7 @@ var _OptionCard = ({ opt, isSelected, multiSelect, onToggle }) => {
     const anim = Animated.timing(selectT, {
       toValue: isSelected ? 1 : 0,
       duration: scaledMs(stateChangeDuration(reduced, SELECT_FILL_MS)),
-      easing: easeWire6,
+      easing: easeWire7,
       useNativeDriver: true
     });
     anim.start();
@@ -2608,12 +3101,12 @@ var _OptionCard = ({ opt, isSelected, multiSelect, onToggle }) => {
       accessibilityRole: multiSelect ? "checkbox" : "radio",
       accessibilityState: multiSelect ? { checked: isSelected } : { selected: isSelected },
       accessibilityLabel: opt.label,
-      style: styles13.cell,
+      style: styles14.cell,
       children: /* @__PURE__ */ jsxs(
         Animated.View,
         {
           style: [
-            styles13.card,
+            styles14.card,
             {
               padding: t.spacing.md,
               borderRadius: t.radius.lg,
@@ -2630,7 +3123,7 @@ var _OptionCard = ({ opt, isSelected, multiSelect, onToggle }) => {
                 pointerEvents: "none",
                 style: [
                   StyleSheet.absoluteFill,
-                  styles13.selectedOverlay,
+                  styles14.selectedOverlay,
                   {
                     borderRadius: t.radius.lg,
                     borderColor: t.colors.primary,
@@ -2648,7 +3141,7 @@ var _OptionCard = ({ opt, isSelected, multiSelect, onToggle }) => {
     }
   );
 };
-var OptionCard = React18.memo(_OptionCard);
+var OptionCard = React19.memo(_OptionCard);
 var _CardGridSelectCard = ({
   title,
   options,
@@ -2658,7 +3151,7 @@ var _CardGridSelectCard = ({
   onSelectionChange
 }) => {
   const t = useOnboardingTheme();
-  const opts = React18.useMemo(() => normalizeOptions(options), [options]);
+  const opts = React19.useMemo(() => normalizeOptions(options), [options]);
   const [selected, setSelected] = useState([]);
   const [submitted, setSubmitted] = useState(false);
   useEffect(() => {
@@ -2695,7 +3188,7 @@ var _CardGridSelectCard = ({
           disabled: selected.length === 0 || submitted
         }
       ),
-      children: /* @__PURE__ */ jsx(View, { style: [styles13.grid, { gap: t.spacing.sm }], children: opts.map((opt) => /* @__PURE__ */ jsx(
+      children: /* @__PURE__ */ jsx(View, { style: [styles14.grid, { gap: t.spacing.sm }], children: opts.map((opt) => /* @__PURE__ */ jsx(
         OptionCard,
         {
           opt,
@@ -2711,19 +3204,19 @@ var _CardGridSelectCard = ({
 var CardGridSelectCard = {
   name: "CardGridSelectCard",
   description: "Use for VISUAL, icon-led choices shown as a 2-column grid of tappable cards (icon on top, short label beneath). Ideal for 2\u20136 concrete options that each have an obvious icon \u2014 occasions, channels, goals, categories \u2014 e.g. 'What brings you here?' or 'Where did you hear about us?'. Multi-select by default. Every option should carry an `icon`. Use SelectionCard instead when options need descriptions or have no natural icon; use ChipSelectCard for many short word-like tags.",
-  component: React18.memo(_CardGridSelectCard),
-  propsSchema: schema4,
+  component: React19.memo(_CardGridSelectCard),
+  propsSchema: schema5,
   defaultProps: { submitLabel: "Continue", multiSelect: true }
 };
-var styles13 = StyleSheet.create({
+var styles14 = StyleSheet.create({
   grid: { flexDirection: "row", flexWrap: "wrap" },
   // Two per row: ~47% basis leaves room for the gap, flexGrow fills the remainder exactly.
   cell: { flexBasis: "47%", flexGrow: 1 },
   card: { borderWidth: 1.5, alignItems: "flex-start", overflow: "hidden" },
   selectedOverlay: { borderWidth: 1.5 }
 });
-var easeWire7 = Easing.bezier(...WIRE_BEZIER);
-var schema5 = z.object({
+var easeWire8 = Easing.bezier(...WIRE_BEZIER);
+var schema6 = z.object({
   status: z.enum(["success", "warning", "error", "info"]).describe("Status type"),
   title: z.string().describe("Status title"),
   message: z.string().optional().describe("Supporting message"),
@@ -2773,7 +3266,7 @@ var _StatusCard = ({ status, title, message, ctaLabel, onContinue, onPress, onSu
         toValue: 1,
         duration: scaledMs(STATUS_COPY_MS),
         delay: scaledMs(STATUS_COPY_STAGGER_MS),
-        easing: easeWire7,
+        easing: easeWire8,
         useNativeDriver: true
       })
     ];
@@ -2795,8 +3288,8 @@ var _StatusCard = ({ status, title, message, ctaLabel, onContinue, onPress, onSu
     {
       align: "center",
       footer: ctaLabel ? /* @__PURE__ */ jsx(Button, { title: ctaLabel, onPress: handleContinue, variant: "primary", disabled: submitted }) : void 0,
-      children: /* @__PURE__ */ jsxs(View, { style: [styles14.center, { gap: t.spacing.sm }], children: [
-        /* @__PURE__ */ jsxs(View, { style: [styles14.titleRow, { gap: t.spacing.sm }], children: [
+      children: /* @__PURE__ */ jsxs(View, { style: [styles15.center, { gap: t.spacing.sm }], children: [
+        /* @__PURE__ */ jsxs(View, { style: [styles15.titleRow, { gap: t.spacing.sm }], children: [
           /* @__PURE__ */ jsx(
             Animated.Text,
             {
@@ -2840,14 +3333,14 @@ var _StatusCard = ({ status, title, message, ctaLabel, onContinue, onPress, onSu
 var StatusCard = {
   name: "StatusCard",
   description: "Use ONLY for real outcomes: booking confirmed, data saved, action completed. NEVER for 'you just viewed X' acknowledgments. Always include ctaLabel so the user can continue after seeing the status.",
-  component: React18.memo(_StatusCard),
-  propsSchema: schema5
+  component: React19.memo(_StatusCard),
+  propsSchema: schema6
 };
-var styles14 = StyleSheet.create({
+var styles15 = StyleSheet.create({
   center: { width: "100%", alignItems: "center", justifyContent: "center" },
   titleRow: { flexDirection: "row", alignItems: "center", justifyContent: "center" }
 });
-var schema6 = z.object({
+var schema7 = z.object({
   label: z.string().describe("What is being counted, e.g. 'Number of days' or 'Travellers'"),
   min: z.number().optional().describe("Minimum value, default 1"),
   max: z.number().optional().describe("Maximum value, default 30"),
@@ -2918,8 +3411,8 @@ var _NumberStepperCard = ({
 var NumberStepperCard = {
   name: "NumberStepperCard",
   description: "Use for any bounded numeric input: days, people, portions, budget tiers, ratings. Best for ranges 1\u201399. Set unit (e.g. 'days', 'people') for clarity.",
-  component: React18.memo(_NumberStepperCard),
-  propsSchema: schema6,
+  component: React19.memo(_NumberStepperCard),
+  propsSchema: schema7,
   defaultProps: { min: 1, max: 30, defaultValue: 1, step: 1, submitLabel: "Confirm" }
 };
 function makeStyles4(t) {
@@ -2930,9 +3423,9 @@ function makeStyles4(t) {
     valueBox: { alignItems: "center", minWidth: 80 }
   });
 }
-var easeWire8 = Easing.bezier(...WIRE_BEZIER);
-var RISE_PX = 10;
-var schema7 = z.object({
+var easeWire9 = Easing.bezier(...WIRE_BEZIER);
+var RISE_PX2 = 10;
+var schema8 = z.object({
   title: z.string().describe("Short, warm headline for the value/momentum moment"),
   body: z.string().optional().describe("One or two supporting lines that reflect the user's answers back and build momentum"),
   items: z.array(z.string()).max(4).optional().describe(
@@ -2969,7 +3462,7 @@ var _WorkItem = ({
         toValue: 1,
         duration: scaledMs(INTERSTITIAL_ITEM_MS),
         delay: scaledMs(interstitialItemDelay(index)),
-        easing: easeWire8,
+        easing: easeWire9,
         useNativeDriver: true
       }),
       Animated.spring(checkT, {
@@ -2983,7 +3476,7 @@ var _WorkItem = ({
     anims.forEach((a) => a.start());
     return () => anims.forEach((a) => a.stop());
   }, [reduced, index, rowT, checkT]);
-  const rise = rowT.interpolate({ inputRange: [0, 1], outputRange: [RISE_PX, 0] });
+  const rise = rowT.interpolate({ inputRange: [0, 1], outputRange: [RISE_PX2, 0] });
   const checkScale = checkT.interpolate({
     inputRange: [0, 1],
     outputRange: [INTERSTITIAL_CHECK_SCALE_FROM, 1]
@@ -2991,20 +3484,20 @@ var _WorkItem = ({
   return /* @__PURE__ */ jsxs(
     Animated.View,
     {
-      style: [styles15.itemRow, { gap: t.spacing.sm + t.spacing.xs, opacity: rowT, transform: [{ translateY: rise }] }],
+      style: [styles16.itemRow, { gap: t.spacing.sm + t.spacing.xs, opacity: rowT, transform: [{ translateY: rise }] }],
       children: [
         /* @__PURE__ */ jsx(
           View,
           {
             style: [
-              styles15.itemBadge,
+              styles16.itemBadge,
               { backgroundColor: t.colors.primarySoft, borderRadius: t.radius.full }
             ],
             children: /* @__PURE__ */ jsx(
               Animated.Text,
               {
                 style: [
-                  styles15.itemCheck,
+                  styles16.itemCheck,
                   { color: t.colors.primary, opacity: checkT, transform: [{ scale: checkScale }] }
                 ],
                 children: "\u2713"
@@ -3012,12 +3505,12 @@ var _WorkItem = ({
             )
           }
         ),
-        /* @__PURE__ */ jsx(Text, { style: [bodyStyle(t.fonts), styles15.itemText, { color: t.colors.text }], children: text })
+        /* @__PURE__ */ jsx(Text, { style: [bodyStyle(t.fonts), styles16.itemText, { color: t.colors.text }], children: text })
       ]
     }
   );
 };
-var WorkItem = React18.memo(_WorkItem);
+var WorkItem = React19.memo(_WorkItem);
 var _InterstitialCard = ({
   title,
   body,
@@ -3054,7 +3547,7 @@ var _InterstitialCard = ({
       toValue: 1,
       duration: scaledMs(INTERSTITIAL_HEAD_MS),
       delay,
-      easing: easeWire8,
+      easing: easeWire9,
       useNativeDriver: true
     });
     const anims = [
@@ -3067,7 +3560,7 @@ var _InterstitialCard = ({
   }, [reduced, artT, titleT, bodyT]);
   const riseStyle = (value) => ({
     opacity: value,
-    transform: [{ translateY: value.interpolate({ inputRange: [0, 1], outputRange: [RISE_PX, 0] }) }]
+    transform: [{ translateY: value.interpolate({ inputRange: [0, 1], outputRange: [RISE_PX2, 0] }) }]
   });
   const handleContinue = useCallback(() => {
     if (submitted || !canAdvance) return;
@@ -3090,18 +3583,18 @@ var _InterstitialCard = ({
           disabled: submitted || !canAdvance
         }
       ),
-      children: /* @__PURE__ */ jsxs(View, { style: [styles15.center, { gap: t.spacing.md }], children: [
-        /* @__PURE__ */ jsx(Animated.View, { style: [styles15.fullWidth, riseStyle(artT)], children: showImage ? /* @__PURE__ */ jsx(
+      children: /* @__PURE__ */ jsxs(View, { style: [styles16.center, { gap: t.spacing.md }], children: [
+        /* @__PURE__ */ jsx(Animated.View, { style: [styles16.fullWidth, riseStyle(artT)], children: showImage ? /* @__PURE__ */ jsx(
           Image,
           {
             source: { uri: imageUrl },
-            style: styles15.image,
+            style: styles16.image,
             resizeMode: "contain",
             onError: () => setImgFailed(true)
           }
-        ) : art ? /* @__PURE__ */ jsx(View, { style: styles15.art, children: art }) : null }),
+        ) : art ? /* @__PURE__ */ jsx(View, { style: styles16.art, children: art }) : null }),
         /* @__PURE__ */ jsx(Animated.View, { style: riseStyle(titleT), children: /* @__PURE__ */ jsx(Text, { style: [headingStyle(t.fonts), { color: t.colors.text, textAlign: "center" }], children: title }) }),
-        (items == null ? void 0 : items.length) ? /* @__PURE__ */ jsx(View, { style: [styles15.items, { gap: t.spacing.md, marginTop: t.spacing.sm }], children: items.map((item, i) => /* @__PURE__ */ jsx(WorkItem, { text: item, index: i, reduced }, `${item}-${i}`)) }) : body ? /* @__PURE__ */ jsx(Animated.View, { style: riseStyle(bodyT), children: /* @__PURE__ */ jsx(Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted, textAlign: "center" }], children: body }) }) : null
+        (items == null ? void 0 : items.length) ? /* @__PURE__ */ jsx(View, { style: [styles16.items, { gap: t.spacing.md, marginTop: t.spacing.sm }], children: items.map((item, i) => /* @__PURE__ */ jsx(WorkItem, { text: item, index: i, reduced }, `${item}-${i}`)) }) : body ? /* @__PURE__ */ jsx(Animated.View, { style: riseStyle(bodyT), children: /* @__PURE__ */ jsx(Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted, textAlign: "center" }], children: body }) }) : null
       ] })
     }
   );
@@ -3109,11 +3602,11 @@ var _InterstitialCard = ({
 var InterstitialCard = {
   name: "InterstitialCard",
   description: "Use ONCE mid-flow (never first, never last) as a momentum/value screen between questions \u2014 an illustration + a warm line that reflects answers back, like Duolingo/Cal-AI. NOT a question; the user just taps Continue. Set `illustration` to an app-registered artwork name. Prefer `items` (2-3 short ticked lines, each reflecting a real answer) when you have the signal. Skip it if you don't have enough signal to make the line specific.",
-  component: React18.memo(_InterstitialCard),
-  propsSchema: schema7,
+  component: React19.memo(_InterstitialCard),
+  propsSchema: schema8,
   defaultProps: { ctaLabel: "Continue", illustrationFallback: "momentum" }
 };
-var styles15 = StyleSheet.create({
+var styles16 = StyleSheet.create({
   center: { width: "100%", alignItems: "center", justifyContent: "center" },
   fullWidth: { width: "100%", alignItems: "center" },
   art: { alignItems: "center", justifyContent: "center" },
@@ -3311,6 +3804,33 @@ var collectDeviceContext = () => {
   return ctx;
 };
 
+// src/identity/identityRecord.ts
+var IDENTITY_PROVENANCE_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:identityProvenance");
+var provenanceGlobal = globalThis;
+var provenanceRegistry = () => {
+  const existing = provenanceGlobal[IDENTITY_PROVENANCE_SLOT];
+  if (existing) return existing;
+  const created = { host: /* @__PURE__ */ new Map() };
+  provenanceGlobal[IDENTITY_PROVENANCE_SLOT] = created;
+  return created;
+};
+var provenanceKey = (space, scope) => `${space}:${scope != null ? scope : "default"}`;
+var resolveIdentity = (input) => {
+  var _a2;
+  if (typeof input.value !== "string") return void 0;
+  const value = input.value.trim();
+  if (!value) return void 0;
+  const durable = (_a2 = input.durable) != null ? _a2 : input.source === "host";
+  if (input.source === "host") {
+    provenanceRegistry().host.set(provenanceKey(input.space, input.scope), value);
+  }
+  return { value, space: input.space, source: input.source, durable };
+};
+var hostIdentity = (space, scope) => provenanceRegistry().host.get(provenanceKey(space, scope));
+var resetIdentityProvenance = () => {
+  provenanceRegistry().host.clear();
+};
+
 // src/context/deviceId.ts
 var AUTO_DEVICE_ID_PREFIX = "wdev_";
 var deviceIdStorageKey = (appId) => `wireai:analytics:deviceKey:${appId != null ? appId : "default"}`;
@@ -3333,24 +3853,37 @@ var startHydration = (registry, appId, storage, minted) => {
   const existing = registry.pending.get(appId);
   if (existing) return existing;
   const slot = deviceIdStorageKey(appId);
-  const settled = () => {
+  const degraded = () => {
     var _a2;
-    return (_a2 = registry.keys.get(appId)) != null ? _a2 : minted;
+    return { value: (_a2 = registry.keys.get(appId)) != null ? _a2 : minted, durable: false };
   };
+  const adopted = (value) => ({ value, durable: true });
   let run;
   try {
     run = Promise.resolve(storage.getItem(slot)).then((saved) => {
       const persisted = typeof saved === "string" && saved.trim() ? saved.trim() : void 0;
       if (persisted) {
         registry.keys.set(appId, persisted);
-        return persisted;
+        return adopted(persisted);
       }
-      return Promise.resolve(storage.setItem(slot, minted)).then(settled, settled);
-    }).catch(settled);
+      return Promise.resolve(storage.setItem(slot, minted)).then(
+        () => {
+          var _a2;
+          return adopted((_a2 = registry.keys.get(appId)) != null ? _a2 : minted);
+        },
+        degraded
+      );
+    }).catch(degraded);
   } catch {
-    run = Promise.resolve(settled());
+    run = Promise.resolve(degraded());
   }
   registry.pending.set(appId, run);
+  void run.then((outcome) => {
+    var _a2;
+    if (outcome.durable) return;
+    (_a2 = registry.pending) == null ? void 0 : _a2.delete(appId);
+    registry.hydrating.delete(appId);
+  });
   return run;
 };
 var resolveAutoDeviceKey = (opts = {}) => {
@@ -3370,14 +3903,20 @@ var resolveAutoDeviceKey = (opts = {}) => {
   return (_b = registry.keys.get(appId)) != null ? _b : id;
 };
 var hydrateAutoDeviceKey = async (opts = {}) => {
+  var _a2, _b;
+  return (_b = (_a2 = await hydrateDeviceIdentity(opts)) == null ? void 0 : _a2.value) != null ? _b : resolveAutoDeviceKey(opts);
+};
+var hydrateDeviceIdentity = async (opts = {}) => {
   var _a2, _b, _c;
   const id = resolveAutoDeviceKey(opts);
-  if (!opts.storage) return id;
-  const registry = autoDeviceKeyRegistry();
   const appId = (_a2 = opts.appId) != null ? _a2 : "default";
+  const record = (value, durable) => resolveIdentity({ value, space: "device", source: "auto", durable, scope: appId });
+  if (!opts.storage) return record(id, false);
+  const registry = autoDeviceKeyRegistry();
   const pending = (_b = registry.pending) == null ? void 0 : _b.get(appId);
-  if (pending) await pending;
-  return (_c = registry.keys.get(appId)) != null ? _c : id;
+  if (!pending) return record((_c = registry.keys.get(appId)) != null ? _c : id, false);
+  const outcome = await pending;
+  return record(outcome.value, outcome.durable);
 };
 var resetAutoDeviceKeys = () => {
   var _a2;
@@ -3401,13 +3940,6 @@ var getCurrentSessionId = () => globalSlot[CURRENT_SESSION_ID_SLOT];
 var resetCurrentSessionId = () => {
   globalSlot[CURRENT_SESSION_ID_SLOT] = void 0;
 };
-var warnInDev = (message) => {
-  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
-    console.warn(message);
-    return true;
-  }
-  return false;
-};
 var MINT_WARNING = "[wireai] No app-open session was registered, so a session id was minted for this event (the server drops an event that has no session_id, and still answers 200). Mount useLifecycleEvents at your app root so events correlate to a real app-open.";
 var MINT_WARNED_SLOT = /* @__PURE__ */ Symbol.for(
   "@wireai/activation:currentSessionIdMintWarned"
@@ -3504,27 +4036,20 @@ var identifyOnboarding = async (opts) => {
       contextId = stored == null ? void 0 : stored.id;
     }
   }
-  if (!contextId) contextId = getCurrentSessionId();
+  let space = "onboarding";
+  if (!contextId && opts.allowAppSessionFallback) {
+    contextId = getCurrentSessionId();
+    space = "app_session";
+  }
   if (!contextId) return false;
   reportClientEvent(
     { serverUrl: opts.config.serverUrl, apiKey: opts.config.apiKey },
     { event_type: "identify", session_id: contextId, user_id: userId }
   );
-  return true;
+  return space;
 };
 
 // src/context/userContext.ts
-var RESERVED_USER_CONTEXT_KEYS = [
-  "device_key",
-  "app_version",
-  "app_build",
-  "network_type",
-  "session_count",
-  "returning",
-  "platform",
-  "user_email",
-  "user_email_hashed"
-];
 var EXTRA_KEY_PREFIX = "custom.";
 var isWireScalar = (value) => {
   const t = typeof value;
@@ -3605,9 +4130,41 @@ var resolveUserContext = (ctx = {}, opts = {}) => {
   if (Object.keys(bucket).length > 0) result.userContext = bucket;
   return result;
 };
-var warnInDev2 = (message) => {
-  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
-    console.warn(message);
+
+// src/permissions/permissionMemory.ts
+var permissionStorageKey = (appId) => `wireai:permissions:${appId}`;
+var readSettledPermissions = (raw, sessionId) => {
+  if (!raw || !sessionId) return [];
+  try {
+    const parsed = JSON.parse(raw);
+    if (typeof parsed !== "object" || parsed === null) return [];
+    const record = parsed;
+    if (record.sessionId !== sessionId || !Array.isArray(record.ids)) return [];
+    return record.ids.filter((id) => typeof id === "string" && id.length > 0);
+  } catch {
+    return [];
+  }
+};
+var loadSettledPermissions = async (storage, key, sessionId) => {
+  try {
+    return readSettledPermissions(await withTimeout(storage.getItem(key), READ_TIMEOUT_MS), sessionId);
+  } catch {
+    return [];
+  }
+};
+var saveSettledPermissions = (storage, key, sessionId, ids) => {
+  try {
+    const record = { sessionId, ids: [...ids] };
+    void storage.setItem(key, JSON.stringify(record)).catch(() => {
+    });
+  } catch {
+  }
+};
+var clearSettledPermissions = (storage, key) => {
+  try {
+    void storage.removeItem(key).catch(() => {
+    });
+  } catch {
   }
 };
 var AUTO_JOIN_HYDRATION_TIMEOUT_MS = 1500;
@@ -3634,9 +4191,10 @@ var WireOnboarding = ({
   retainSessionOnComplete,
   userContext,
   userId,
-  autoJoinKey = true
+  autoJoinKey = true,
+  permissionScreens
 }) => {
-  var _a2, _b, _c;
+  var _a2, _b, _c, _d, _e, _f;
   const boundUserId = useMemo(() => sanitizeUserId(userId), [userId]);
   const device = useMemo(() => {
     const collected = collectDeviceContext();
@@ -3647,44 +4205,72 @@ var WireOnboarding = ({
     () => userContextKey ? JSON.parse(userContextKey) : void 0,
     [userContextKey]
   );
-  const missingJoinKey = typeof (userContextStable == null ? void 0 : userContextStable.device_key) !== "string" || !userContextStable.device_key.trim();
+  const hostJoinIdentity = useMemo(
+    () => resolveIdentity({
+      value: userContextStable == null ? void 0 : userContextStable.device_key,
+      space: "device",
+      source: "host",
+      scope: config.appId
+    }),
+    [userContextStable, config.appId]
+  );
+  const missingJoinKey = !hostJoinIdentity;
   const autoJoinPossible = Boolean(storage) && autoJoinKey !== false;
   const wantsAutoJoin = missingJoinKey && autoJoinPossible;
-  const [autoJoinValue, setAutoJoinValue] = useState(void 0);
+  const [autoJoinOutcome, setAutoJoinOutcome] = useState(void 0);
   useEffect(() => {
-    if (!wantsAutoJoin || autoJoinValue !== void 0 || !storage) return;
+    if (!wantsAutoJoin || autoJoinOutcome !== void 0 || !storage) return;
     let cancelled = false;
     const timer = setTimeout(() => {
-      if (!cancelled) setAutoJoinValue(null);
+      if (!cancelled) setAutoJoinOutcome({ key: null, reason: "timeout" });
     }, AUTO_JOIN_HYDRATION_TIMEOUT_MS);
-    void hydrateAutoDeviceKey({ appId: config.appId, storage }).then((key) => {
+    void hydrateDeviceIdentity({ appId: config.appId, storage }).then((identity) => {
       if (cancelled) return;
       clearTimeout(timer);
-      setAutoJoinValue(key || null);
+      setAutoJoinOutcome(
+        (identity == null ? void 0 : identity.durable) ? { key: identity.value } : { key: null, reason: "not-durable" }
+      );
     });
     return () => {
       cancelled = true;
       clearTimeout(timer);
     };
-  }, [wantsAutoJoin, autoJoinValue, config.appId, storage]);
-  const injectedJoinKey = wantsAutoJoin && typeof autoJoinValue === "string" ? autoJoinValue : void 0;
-  const autoJoinPending = wantsAutoJoin && autoJoinValue === void 0;
+  }, [wantsAutoJoin, autoJoinOutcome, config.appId, storage]);
+  const injectedJoinKey = wantsAutoJoin ? (_a2 = autoJoinOutcome == null ? void 0 : autoJoinOutcome.key) != null ? _a2 : void 0 : void 0;
+  const autoJoinPending = wantsAutoJoin && autoJoinOutcome === void 0;
   const effectiveUserContext = useMemo(
     () => injectedJoinKey ? { ...userContextStable, ...activationJoinContext(injectedJoinKey) } : userContextStable,
     [userContextStable, injectedJoinKey]
   );
+  const frozenWireContextRef = useRef(null);
+  if (!autoJoinPending && frozenWireContextRef.current === null) {
+    frozenWireContextRef.current = effectiveUserContext ? JSON.stringify(effectiveUserContext) : "";
+  }
+  const startupUserContextKey = (_b = frozenWireContextRef.current) != null ? _b : "";
+  const startupUserContext = useMemo(
+    () => startupUserContextKey ? JSON.parse(startupUserContextKey) : void 0,
+    [startupUserContextKey]
+  );
   const warnMissingJoinKey = missingJoinKey && !injectedJoinKey && !autoJoinPending;
-  const autoJoinReason = autoJoinKey === false ? "you passed autoJoinKey={false}." : !storage ? "it got no `storage` prop, and without persistence its key would be different on every launch, which corrupts min_sessions instead of merely leaving the join empty." : "your `storage` adapter did not answer in time.";
+  const autoJoinReason = autoJoinKey === false ? "you passed autoJoinKey={false}." : !storage ? "it got no `storage` prop, and without persistence its key would be different on every launch, which corrupts min_sessions instead of merely leaving the join empty." : (autoJoinOutcome == null ? void 0 : autoJoinOutcome.key) === null && autoJoinOutcome.reason === "not-durable" ? "your `storage` adapter answered but could not persist the key (the read or the write failed), so the key would be different on every launch, which corrupts min_sessions instead of merely leaving the join empty. Check the adapter you passed as `storage`." : "your `storage` adapter did not answer in time.";
   useEffect(() => {
     if (!warnMissingJoinKey) return;
-    warnInDev2(
+    warnInDev(
       "[wireai] <WireOnboarding> got no user_context.device_key, so this onboarding session can never be joined to the app's later events and the `activated` funnel will read zero. Pass userContext={activationJoinContext(deviceKey)} \u2014 and if your app owns no device id, userContext={activationJoinContext(resolveAutoDeviceKey({ appId, storage }))} returns the SAME id the analytics side stamps. Never hand-write userContext={{ deviceKey }}. The kit did NOT auto-inject its own key here because " + autoJoinReason
     );
   }, [warnMissingJoinKey, autoJoinReason]);
+  const hostKeyElsewhere = missingJoinKey ? hostIdentity("device", config.appId) : void 0;
+  const warnHostKeyElsewhere = Boolean(hostKeyElsewhere) && Boolean(injectedJoinKey);
+  useEffect(() => {
+    if (!warnHostKeyElsewhere) return;
+    warnInDev(
+      `[wireai] <WireOnboarding> got no user_context.device_key, so the kit injected its own \u2014 but another surface in this app was constructed WITH a host-supplied device key ("${hostKeyElsewhere}"). Your app events carry that id and this onboarding session carries the kit's, so the two land in disjoint id spaces and the \`activated\` funnel still reads zero. Pass the SAME id here: userContext={activationJoinContext(deviceKey)}.`
+    );
+  }, [warnHostKeyElsewhere, hostKeyElsewhere]);
   const misspelledJoinKey = missingJoinKey && typeof (userContextStable == null ? void 0 : userContextStable.deviceKey) === "string" && Boolean(userContextStable.deviceKey.trim());
   useEffect(() => {
     if (!misspelledJoinKey || !injectedJoinKey) return;
-    warnInDev2(
+    warnInDev(
       "[wireai] <WireOnboarding> got userContext={{ deviceKey }}, which is NOT the wire key \u2014 the server's device lookup reads `device_key`. The kit auto-injected its own device_key so this session is at least self-consistent, but your app's own events carry YOUR id, so the two still will not join and the `activated` funnel stays zero. Pass userContext={activationJoinContext(deviceKey)} instead."
     );
   }, [misspelledJoinKey, injectedJoinKey]);
@@ -3696,6 +4282,7 @@ var WireOnboarding = ({
     () => storage ? null : { id: makeSessionId(), resumed: false }
   );
   const storageKey = persistKey != null ? persistKey : sessionStorageKey(config.appId);
+  const permissionsKey = permissionStorageKey(config.appId);
   useEffect(() => {
     if (!storage || session) return;
     let cancelled = false;
@@ -3708,12 +4295,43 @@ var WireOnboarding = ({
   }, [storage, storageKey, sessionTtlMs, session]);
   const handleComplete = useCallback(
     (result) => {
-      if (storage && shouldClearOnComplete(retainSessionOnComplete)) clearPersistedSession(storage, storageKey);
+      if (storage && shouldClearOnComplete(retainSessionOnComplete)) {
+        clearPersistedSession(storage, storageKey);
+        clearSettledPermissions(storage, permissionsKey);
+      }
       onComplete(result);
     },
-    [storage, storageKey, retainSessionOnComplete, onComplete]
+    [storage, storageKey, permissionsKey, retainSessionOnComplete, onComplete]
+  );
+  const sessionId = (_c = session == null ? void 0 : session.id) != null ? _c : "";
+  const wantsPermissionMemory = Boolean(storage) && ((_d = permissionScreens == null ? void 0 : permissionScreens.length) != null ? _d : 0) > 0;
+  const [settledPermissions, setSettledPermissions] = useState(void 0);
+  useEffect(() => {
+    if (!wantsPermissionMemory || !storage || !sessionId || settledPermissions !== void 0) return;
+    let cancelled = false;
+    void loadSettledPermissions(storage, permissionsKey, sessionId).then((ids) => {
+      if (!cancelled) setSettledPermissions(ids);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [wantsPermissionMemory, storage, permissionsKey, sessionId, settledPermissions]);
+  const settledPermissionsRef = useRef(void 0);
+  settledPermissionsRef.current = settledPermissions;
+  const handlePermissionSettled = useCallback(
+    (id) => {
+      var _a3;
+      const current = (_a3 = settledPermissionsRef.current) != null ? _a3 : [];
+      if (current.includes(id)) return;
+      const next = [...current, id];
+      settledPermissionsRef.current = next;
+      setSettledPermissions(next);
+      if (storage && wantsPermissionMemory && sessionId) {
+        saveSettledPermissions(storage, permissionsKey, sessionId, next);
+      }
+    },
+    [storage, wantsPermissionMemory, permissionsKey, sessionId]
   );
-  const sessionId = (_a2 = session == null ? void 0 : session.id) != null ? _a2 : "";
   const startupUserIdRef = useRef(boundUserId);
   const metadataKey = config.metadata ? JSON.stringify(config.metadata) : "";
   const metadataStable = useMemo(() => metadataKey ? JSON.parse(metadataKey) : void 0, [metadataKey]);
@@ -3737,7 +4355,9 @@ var WireOnboarding = ({
         // Device snapshot + host-injected user context ride the session-start metadata so the
         // backend can segment the funnel. Old servers ignore these unknown keys (backward compat).
         device,
-        ...effectiveUserContext ? { userContext: effectiveUserContext } : {},
+        // The FROZEN wire context, never the live one — see the freeze note above. A change here
+        // recreates the A2A adapter and drops `contextId`.
+        ...startupUserContext ? { userContext: startupUserContext } : {},
         // The session-start user id (from the ref) rides the session-start metadata so the
         // server binds the session to a real user at creation. Reading the ref — not
         // `boundUserId` — keeps this memo off the userId dependency, so a mid-session change
@@ -3746,7 +4366,7 @@ var WireOnboarding = ({
       },
       timeoutMs: 6e4
     };
-  }, [config.serverUrl, config.appId, config.apiKey, metadataStable, sessionId, componentsStable, device, effectiveUserContext]);
+  }, [config.serverUrl, config.appId, config.apiKey, metadataStable, sessionId, componentsStable, device, startupUserContext]);
   const reportTarget = useMemo(
     () => ({ serverUrl: config.serverUrl, apiKey: config.apiKey }),
     [config.serverUrl, config.apiKey]
@@ -3772,8 +4392,8 @@ var WireOnboarding = ({
     return /* @__PURE__ */ jsx(OnboardingThemeProvider, { theme, children: /* @__PURE__ */ jsx(
       LoadingScreen,
       {
-        title: (_b = copy == null ? void 0 : copy.restoringTitle) != null ? _b : DEFAULT_COPY.restoringTitle,
-        hint: (_c = copy == null ? void 0 : copy.restoringHint) != null ? _c : DEFAULT_COPY.restoringHint
+        title: (_e = copy == null ? void 0 : copy.restoringTitle) != null ? _e : DEFAULT_COPY.restoringTitle,
+        hint: (_f = copy == null ? void 0 : copy.restoringHint) != null ? _f : DEFAULT_COPY.restoringHint
       }
     ) });
   }
@@ -3794,7 +4414,11 @@ var WireOnboarding = ({
       reportTarget,
       sessionId,
       resumed: session.resumed,
-      clientContext
+      clientContext,
+      permissionScreens,
+      settledPermissions,
+      permissionsPending: wantsPermissionMemory && settledPermissions === void 0,
+      onPermissionSettled: handlePermissionSettled
     }
   ) }) }) }) });
 };
@@ -3923,20 +4547,6 @@ var themeFromBrand = (input) => {
     button: { ...base.button, ...extra.button }
   };
 };
-var _DoneBlock = ({
-  title = "You're all set",
-  message = "Personalizing your experience\u2026"
-}) => {
-  const t = useOnboardingTheme();
-  return /* @__PURE__ */ jsxs(View, { style: [styles16.center, { gap: t.spacing.sm, padding: t.spacing.lg }], children: [
-    /* @__PURE__ */ jsx(Text, { style: [headingStyle(t.fonts), { color: t.colors.success, textAlign: "center" }], children: title }),
-    /* @__PURE__ */ jsx(Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted, textAlign: "center" }], children: message })
-  ] });
-};
-var DoneBlock = React18.memo(_DoneBlock);
-var styles16 = StyleSheet.create({
-  center: { flex: 1, alignItems: "center", justifyContent: "center" }
-});
 
 // src/motion/centeredModalMotion.ts
 var CENTERED_MODAL_ANIM = {
@@ -4052,7 +4662,7 @@ var _CenteredModal = forwardRef(
   }
 );
 _CenteredModal.displayName = "CenteredModal";
-var CenteredModal = React18.memo(_CenteredModal);
+var CenteredModal = React19.memo(_CenteredModal);
 var styles17 = StyleSheet.create({
   fill: { flex: 1 },
   backdrop: { position: "absolute", top: 0, left: 0, right: 0, bottom: 0, backgroundColor: "#000" },
@@ -4239,11 +4849,6 @@ var WIRE_ENV_VARS = [
   "EXPO_PUBLIC_WIREAI_SERVER_URL",
   "EXPO_PUBLIC_WIREAI_APP_ID"
 ];
-var warnInDev3 = (message) => {
-  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
-    console.warn(message);
-  }
-};
 var wireConfigFromEnv = (overrides) => {
   var _a2, _b, _c, _d, _e;
   const apiKey = (_a2 = overrides == null ? void 0 : overrides.apiKey) != null ? _a2 : process.env.EXPO_PUBLIC_WIREAI_API_KEY;
@@ -4254,7 +4859,7 @@ var wireConfigFromEnv = (overrides) => {
       apiKey ? void 0 : "EXPO_PUBLIC_WIREAI_API_KEY",
       serverUrl ? void 0 : "EXPO_PUBLIC_WIREAI_SERVER_URL"
     ].filter(Boolean);
-    warnInDev3(
+    warnInDev(
       `[wireai] wireConfigFromEnv() returned null: ${missing.join(" and ")} ${missing.length > 1 ? "are" : "is"} missing. The kit is now FULLY DISABLED (no onboarding, no analytics, no gates) and nothing else will report an error. Set the var(s) in your env / EAS secrets.`
     );
     return null;
@@ -4309,6 +4914,11 @@ var toAnalyticsEvent = (event) => {
       };
     case "fallback":
       return { name: WIRE_ONBOARDING_EVENTS.fallback, params: { reason: event.reason } };
+    case "permission":
+      return {
+        name: permissionEventName(event.stage),
+        params: permissionEventProps(event.permission, event.status)
+      };
     default: {
       const _exhaustive = event;
       return _exhaustive;
@@ -4362,15 +4972,17 @@ var resetActivationRevalidation = () => {
 };
 
 // src/activation/wireActivation.ts
-var clean = (value) => {
-  if (typeof value !== "string") return void 0;
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : void 0;
-};
+var clean = cleanString;
 var createWireActivation = (config) => {
   var _a2, _b;
   const target = { serverUrl: config.serverUrl, apiKey: config.apiKey };
   const explicitDeviceKey = (_b = clean(config.deviceKey)) != null ? _b : clean((_a2 = config.userContext) == null ? void 0 : _a2.deviceKey);
+  resolveIdentity({
+    value: explicitDeviceKey,
+    space: "device",
+    source: "host",
+    scope: config.appId
+  });
   const autoDeviceKeyOptions = {
     appId: config.appId,
     // An explicit key opts out of minting AND persisting (unchanged contract).
@@ -4804,6 +5416,30 @@ var DEFAULTS = {
   maxRetries: 6
 };
 var READ_TIMEOUT_MS4 = 1500;
+var QUEUE_KEY_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:eventQueueKeys");
+var queueKeyGlobal = globalThis;
+var claimedQueueKeys = () => {
+  const existing = queueKeyGlobal[QUEUE_KEY_SLOT];
+  if (existing) return existing;
+  const created = /* @__PURE__ */ new Set();
+  queueKeyGlobal[QUEUE_KEY_SLOT] = created;
+  return created;
+};
+var claimQueueKey = (preferred, explicit) => {
+  const claimed = claimedQueueKeys();
+  if (explicit || !claimed.has(preferred)) {
+    claimed.add(preferred);
+    return preferred;
+  }
+  let ordinal = 2;
+  while (claimed.has(`${preferred}#${ordinal}`)) ordinal++;
+  const key = `${preferred}#${ordinal}`;
+  claimed.add(key);
+  warnInDev(
+    `[wireai] a second event queue was created for the same appId, and "${preferred}" is already claimed by a live one. Two queues sharing one storage slot overwrite each other's backlog, delete each other's pending events when one drains to empty, and double-send on relaunch, so this queue was given "${key}" instead. Prefer ONE analytics instance per app; if you really need two, pass an explicit \`storageKey\` to each so the slots are yours to reason about.`
+  );
+  return key;
+};
 var withTimeout4 = (p, ms) => {
   let timer;
   const timeout = new Promise((resolve) => {
@@ -4835,7 +5471,8 @@ var createEventQueue = (options) => {
   var _a2, _b, _c, _d, _e, _f, _g;
   const target = options.target;
   const storage = options.storage;
-  const key = (_b = options.storageKey) != null ? _b : `wireai:evtq:${(_a2 = options.appId) != null ? _a2 : "default"}`;
+  const defaultKey = (_b = options.storageKey) != null ? _b : `wireai:evtq:${(_a2 = options.appId) != null ? _a2 : "default"}`;
+  const key = storage ? claimQueueKey(defaultKey, options.storageKey !== void 0) : defaultKey;
   const maxSize = (_c = options.maxSize) != null ? _c : DEFAULTS.maxSize;
   const batchSize = (_d = options.batchSize) != null ? _d : DEFAULTS.batchSize;
   const baseBackoffMs = (_e = options.baseBackoffMs) != null ? _e : DEFAULTS.baseBackoffMs;
@@ -5025,7 +5662,13 @@ var useLifecycleEvents = (config, options = {}) => {
       return (cfg == null ? void 0 : cfg.serverUrl) ? { serverUrl: cfg.serverUrl, apiKey: (_a2 = cfg.apiKey) != null ? _a2 : "" } : void 0;
     };
     const resolveDeviceKey = (cfg, opts) => {
-      const host = typeof opts.deviceKey === "string" && opts.deviceKey.trim() ? opts.deviceKey : void 0;
+      var _a2;
+      const host = (_a2 = resolveIdentity({
+        value: opts.deviceKey,
+        space: "device",
+        source: "host",
+        scope: cfg == null ? void 0 : cfg.appId
+      })) == null ? void 0 : _a2.value;
       if (host) return host;
       if (!(cfg == null ? void 0 : cfg.storage)) return void 0;
       return resolveAutoDeviceKey({ appId: cfg.appId, storage: cfg.storage });
@@ -5103,6 +5746,6 @@ var useLifecycleEvents = (config, options = {}) => {
   }, []);
 };
 
-export { AUTO_DEVICE_ID_PREFIX, AnimatedSparkle, BACKGROUND_SESSION_MS, CardGridSelectCard, CardHandoff, CenteredModal, ChipSelectCard, CompletionView, DEFAULT_FEATURES_TTL_MS, DEFAULT_SESSION_TTL_MS, DemoOnboarding, DoneBlock, EXTRA_KEY_PREFIX, ErrorBlock, FIRST_OPEN_EVENT, IconRegistryProvider, IllustrationProvider, InterstitialCard, LoadingBlock, LoadingScreen, NumberStepperCard, Button as OnboardingButton, OnboardingFlow, OnboardingScaffold, OnboardingThemeProvider, PLAN_TIER_CONTEXT_KEY, RESERVED_USER_CONTEXT_KEYS, SESSION_STARTED_EVENT, SelectionCard, StatusCard, StepProgress, TextInputCard, USER_ID_MAX_LENGTH, WIRE_ENV_VARS, WIRE_ICON_GLYPHS, WIRE_ICON_NAMES, WIRE_ONBOARDING_EVENTS, WIRE_PURCHASE_EVENTS, WireFeaturesProvider, WireIcon, WireOnboarding, activationJoinContext, activeEntitlement, analyticsUserIdStorageKey, attributionMetadata, bumpActivationRevalidation, clearPersistedSession, clearPiiFromContext, clearUserContext, collectDeviceContext, createRevenueCatBridge, createWireActivation, defaultIllustrations, defaultOnboardingTheme, defaultWireFeatures, deriveAnswers, describeEntitlement, describeFailure, describePackage, detectAppVersion, detectNativeModel, deviceIdStorageKey, ensureCurrentSessionId, featuresCacheKey, featuresEqual, fetchWireFeatures, firstOpenStorageKey, getActivationRevalidationVersion, getCurrentSessionId, hashEmailFnv1a, hydrateAutoDeviceKey, identifyOnboarding, isFeaturesFresh, isOnboardingEnabled, isUserCancelled, isWireScalar, loadPersistedSession, looksLikeEmail, lookupIconGlyph, makeSessionId, mergeTheme, mintDeviceId, motionSpec_exports as motionSpec, namespaceExtra, onboardingComponents, parseWireFeatures, peekPersistedSession, readCachedFeatures, readProgress, reportClientEvent, reportClientEventAwait, reportClientEvents, reportClientEventsAwait, reportFirstOpen, reportSessionStart, resetActivationRevalidation, resetAutoDeviceKeys, resetCurrentSessionId, resetFirstOpenLatch, resetSessionStartGuard, resolveAutoDeviceKey, resolvePlanTier, resolveUserContext, sanitizeUserId, savePersistedSession, sessionStorageKey, setCurrentSessionId, subscribeActivationRevalidation, themeFromBrand, toAnalyticsEvent, useActivationRevalidation, useHostIcon, useIllustration, useLifecycleEvents, useOnboardingTheme, useReducedMotion, useResolvedFeatures, useSessionStart, useWireActivation, useWireFeatures, useWireFeaturesContext, wireConfigFromEnv, wireLifecycleEvents, writeCachedFeatures };
+export { AUTO_DEVICE_ID_PREFIX, AnimatedSparkle, BACKGROUND_SESSION_MS, CardGridSelectCard, CardHandoff, CenteredModal, ChipSelectCard, CompletionView, DEFAULT_FEATURES_TTL_MS, DEFAULT_PERMISSION_COPY, DEFAULT_PERMISSION_PLACEMENT, DEFAULT_SESSION_TTL_MS, DemoOnboarding, EXTRA_KEY_PREFIX, ErrorBlock, FIRST_OPEN_EVENT, GENERIC_PERMISSION_COPY, IconRegistryProvider, IllustrationProvider, InterstitialCard, LoadingBlock, LoadingScreen, NOTIFICATIONS_PERMISSION_COPY, NumberStepperCard, Button as OnboardingButton, OnboardingFlow, OnboardingScaffold, OnboardingThemeProvider, PERMISSION_CARD_NAME, PLAN_TIER_CONTEXT_KEY, PermissionCard, PermissionCardView, SESSION_STARTED_EVENT, SelectionCard, StatusCard, StepProgress, TextInputCard, USER_ID_MAX_LENGTH, WIRE_ENV_VARS, WIRE_ICON_GLYPHS, WIRE_ICON_NAMES, WIRE_ONBOARDING_EVENTS, WIRE_PERMISSION_EVENTS, WIRE_PURCHASE_EVENTS, WireFeaturesProvider, WireIcon, WireOnboarding, activationJoinContext, activeEntitlement, analyticsUserIdStorageKey, attributionMetadata, bumpActivationRevalidation, clearPersistedSession, clearPiiFromContext, clearSettledPermissions, clearUserContext, collectDeviceContext, createRevenueCatBridge, createWireActivation, defaultIllustrations, defaultOnboardingTheme, defaultWireFeatures, deriveAnswers, describeEntitlement, describeFailure, describePackage, detectAppVersion, detectNativeModel, deviceIdStorageKey, ensureCurrentSessionId, featuresCacheKey, featuresEqual, fetchWireFeatures, firstOpenStorageKey, getActivationRevalidationVersion, getCurrentSessionId, hashEmailFnv1a, hostIdentity, hydrateAutoDeviceKey, hydrateDeviceIdentity, identifyOnboarding, isFeaturesFresh, isOnboardingEnabled, isPermissionDue, isUserCancelled, isWireScalar, loadPersistedSession, loadSettledPermissions, looksLikeEmail, lookupIconGlyph, makeSessionId, mergeTheme, mintDeviceId, motionSpec_exports as motionSpec, namespaceExtra, normalizeAfterCard, normalizePermissionStatus, onboardingComponents, parseWireFeatures, peekPersistedSession, permissionEventName, permissionEventProps, permissionScreenId, permissionStorageKey, readCachedFeatures, readProgress, readSettledPermissions, reportClientEvent, reportClientEventAwait, reportClientEvents, reportClientEventsAwait, reportFirstOpen, reportSessionStart, resetActivationRevalidation, resetAutoDeviceKeys, resetCurrentSessionId, resetFirstOpenLatch, resetIdentityProvenance, resetSessionStartGuard, resolveAutoDeviceKey, resolveIdentity, resolvePermissionCopy, resolvePlanTier, resolveUserContext, sanitizeUserId, savePersistedSession, saveSettledPermissions, selectDuePermissionScreen, sessionStorageKey, setCurrentSessionId, subscribeActivationRevalidation, themeFromBrand, toAnalyticsEvent, useActivationRevalidation, useHostIcon, useIllustration, useLifecycleEvents, useOnboardingTheme, useReducedMotion, useResolvedFeatures, useSessionStart, useWireActivation, useWireFeatures, useWireFeaturesContext, wireConfigFromEnv, wireLifecycleEvents, writeCachedFeatures };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map