@wireai/activation 0.12.2 → 0.13.2

package/dist/index.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var reactNative = require('react-native');
-var React18 = require('react');
+var React19 = require('react');
 var wireaiRn = require('wireai-rn');
 var jsxRuntime = require('react/jsx-runtime');
 var reactNativeSafeAreaContext = require('react-native-safe-area-context');
@@ -9,7 +9,7 @@ var zod = require('zod');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var React18__default = /*#__PURE__*/_interopDefault(React18);
+var React19__default = /*#__PURE__*/_interopDefault(React19);
 
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -464,33 +464,33 @@ var mergeTheme = (override) => {
     button: { ...defaultOnboardingTheme.button, ...override.button }
   };
 };
-var OnboardingThemeContext = React18.createContext(null);
+var OnboardingThemeContext = React19.createContext(null);
 var OnboardingThemeProvider = ({
   theme,
   children
 }) => {
-  const resolved = React18.useMemo(() => mergeTheme(theme), [theme]);
+  const resolved = React19.useMemo(() => mergeTheme(theme), [theme]);
   return /* @__PURE__ */ jsxRuntime.jsx(OnboardingThemeContext.Provider, { value: resolved, children });
 };
 var useOnboardingTheme = () => {
-  const ctx = React18.useContext(OnboardingThemeContext);
+  const ctx = React19.useContext(OnboardingThemeContext);
   return ctx != null ? ctx : mergeTheme();
 };
 var EMPTY_REGISTRY = {};
-var IllustrationContext = React18.createContext(EMPTY_REGISTRY);
+var IllustrationContext = React19.createContext(EMPTY_REGISTRY);
 var IllustrationProvider = ({
   registry,
   children
 }) => {
-  const value = React18.useMemo(() => registry != null ? registry : EMPTY_REGISTRY, [registry]);
+  const value = React19.useMemo(() => registry != null ? registry : EMPTY_REGISTRY, [registry]);
   return /* @__PURE__ */ jsxRuntime.jsx(IllustrationContext.Provider, { value, children });
 };
 var useIllustration = (name2) => {
-  const registry = React18.useContext(IllustrationContext);
+  const registry = React19.useContext(IllustrationContext);
   if (!name2) return void 0;
   return registry[name2];
 };
-var Glyph = ({ children }) => {
+var Disc = ({ children }) => {
   const t = useOnboardingTheme();
   return /* @__PURE__ */ jsxRuntime.jsx(
     reactNative.View,
@@ -499,11 +499,23 @@ var Glyph = ({ children }) => {
         styles.disc,
         { backgroundColor: t.colors.primarySoft, borderRadius: t.radius.full }
       ],
-      children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [styles.glyphText, { color: t.colors.primary }], allowFontScaling: false, children })
+      children
     }
   );
 };
+var Glyph = ({ children }) => {
+  const t = useOnboardingTheme();
+  return /* @__PURE__ */ jsxRuntime.jsx(Disc, { children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [styles.glyphText, { color: t.colors.primary }], allowFontScaling: false, children }) });
+};
 var MomentumGlyph = () => /* @__PURE__ */ jsxRuntime.jsx(Glyph, { children: "\u2197" });
+var NotificationsGlyph = () => {
+  const t = useOnboardingTheme();
+  return /* @__PURE__ */ jsxRuntime.jsx(Disc, { children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles.bell, children: [
+    /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: [styles.bellBody, { backgroundColor: t.colors.primary }] }),
+    /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: [styles.bellRim, { backgroundColor: t.colors.primary }] }),
+    /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: [styles.bellClapper, { backgroundColor: t.colors.primary }] })
+  ] }) });
+};
 var BeforeAfterGlyph = () => {
   const t = useOnboardingTheme();
   return /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles.row, children: [
@@ -530,7 +542,8 @@ var BeforeAfterGlyph = () => {
 };
 var defaultIllustrations = {
   momentum: /* @__PURE__ */ jsxRuntime.jsx(MomentumGlyph, {}),
-  "before-after": /* @__PURE__ */ jsxRuntime.jsx(BeforeAfterGlyph, {})
+  "before-after": /* @__PURE__ */ jsxRuntime.jsx(BeforeAfterGlyph, {}),
+  notifications: /* @__PURE__ */ jsxRuntime.jsx(NotificationsGlyph, {})
 };
 var styles = reactNative.StyleSheet.create({
   disc: {
@@ -558,19 +571,24 @@ var styles = reactNative.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 = React18.createContext(EMPTY_REGISTRY2);
+var IconContext = React19.createContext(EMPTY_REGISTRY2);
 var IconRegistryProvider = ({
   registry,
   children
 }) => {
-  const value = React18.useMemo(() => registry != null ? registry : EMPTY_REGISTRY2, [registry]);
+  const value = React19.useMemo(() => registry != null ? registry : EMPTY_REGISTRY2, [registry]);
   return /* @__PURE__ */ jsxRuntime.jsx(IconContext.Provider, { value, children });
 };
 var useHostIcon = (name2) => {
-  const registry = React18.useContext(IconContext);
+  const registry = React19.useContext(IconContext);
   if (!name2) return void 0;
   if (!Object.prototype.hasOwnProperty.call(registry, name2)) return void 0;
   return registry[name2];
@@ -729,8 +747,8 @@ var stateChangeDuration = (reduced, durationMs) => reduced ? 0 : durationMs;
 var loopEnabled = (reduced) => !reduced;
 var lastKnown = false;
 var useReducedMotion = () => {
-  const [reduced, setReduced] = React18.useState(lastKnown);
-  React18.useEffect(() => {
+  const [reduced, setReduced] = React19.useState(lastKnown);
+  React19.useEffect(() => {
     let mounted = true;
     reactNative.AccessibilityInfo.isReduceMotionEnabled().then((value) => {
       lastKnown = value;
@@ -752,8 +770,8 @@ var ROTATION_MS = 1800;
 var _AnimatedSparkle = ({ size = 30, color, variant = "spin" }) => {
   const t = useOnboardingTheme();
   const reduced = useReducedMotion();
-  const progress = React18.useRef(new reactNative.Animated.Value(0)).current;
-  React18.useEffect(() => {
+  const progress = React19.useRef(new reactNative.Animated.Value(0)).current;
+  React19.useEffect(() => {
     if (!loopEnabled(reduced)) {
       progress.setValue(0);
       return;
@@ -808,7 +826,7 @@ var _AnimatedSparkle = ({ size = 30, color, variant = "spin" }) => {
     }
   ) });
 };
-var AnimatedSparkle = React18__default.default.memo(_AnimatedSparkle);
+var AnimatedSparkle = React19__default.default.memo(_AnimatedSparkle);
 var styles2 = reactNative.StyleSheet.create({
   box: { alignItems: "center", justifyContent: "center" },
   glyph: {
@@ -820,8 +838,8 @@ var styles2 = reactNative.StyleSheet.create({
 var STAGE_SIZE = 96;
 var ORBIT_DOT = 9;
 var OrbitDot = ({ color, reduced }) => {
-  const spin = React18.useRef(new reactNative.Animated.Value(0)).current;
-  React18.useEffect(() => {
+  const spin = React19.useRef(new reactNative.Animated.Value(0)).current;
+  React19.useEffect(() => {
     if (!loopEnabled(reduced)) return;
     const loop = reactNative.Animated.loop(
       reactNative.Animated.timing(spin, {
@@ -844,8 +862,8 @@ var SkeletonLine = ({
   color,
   reduced
 }) => {
-  const pulse = React18.useRef(new reactNative.Animated.Value(1)).current;
-  React18.useEffect(() => {
+  const pulse = React19.useRef(new reactNative.Animated.Value(1)).current;
+  React19.useEffect(() => {
     if (!loopEnabled(reduced)) return;
     const loop = reactNative.Animated.loop(
       reactNative.Animated.sequence([
@@ -880,8 +898,8 @@ var _LoadingBlock = ({
 }) => {
   const t = useOnboardingTheme();
   const reduced = useReducedMotion();
-  const [showSkeleton, setShowSkeleton] = React18.useState(false);
-  React18.useEffect(() => {
+  const [showSkeleton, setShowSkeleton] = React19.useState(false);
+  React19.useEffect(() => {
     const timer = setTimeout(() => setShowSkeleton(true), SKELETON_DELAY_MS);
     return () => clearTimeout(timer);
   }, []);
@@ -911,7 +929,7 @@ var _LoadingBlock = ({
     )
   ] });
 };
-var LoadingBlock = React18__default.default.memo(_LoadingBlock);
+var LoadingBlock = React19__default.default.memo(_LoadingBlock);
 var styles3 = reactNative.StyleSheet.create({
   center: { flex: 1, alignItems: "center", justifyContent: "center" },
   // Absolutely-positioned label column, pinned just under the centered stage: its top
@@ -956,7 +974,7 @@ var _LoadingScreen = ({ title, hint }) => {
     }
   );
 };
-var LoadingScreen = React18__default.default.memo(_LoadingScreen);
+var LoadingScreen = React19__default.default.memo(_LoadingScreen);
 var styles4 = reactNative.StyleSheet.create({
   flex: { flex: 1 }
 });
@@ -975,8 +993,8 @@ var targetFor = (step, complete, approxScreens) => {
 var _StepProgress = ({ step, complete, approxScreens }) => {
   const t = useOnboardingTheme();
   const reduced = useReducedMotion();
-  const fill = React18.useRef(new reactNative.Animated.Value(targetFor(step, complete, approxScreens))).current;
-  React18.useEffect(() => {
+  const fill = React19.useRef(new reactNative.Animated.Value(targetFor(step, complete, approxScreens))).current;
+  React19.useEffect(() => {
     reactNative.Animated.timing(fill, {
       toValue: targetFor(step, complete, approxScreens),
       duration: scaledMs(stateChangeDuration(reduced, PROGRESS_MS)),
@@ -996,7 +1014,7 @@ var _StepProgress = ({ step, complete, approxScreens }) => {
     }
   ) });
 };
-var StepProgress = React18__default.default.memo(_StepProgress);
+var StepProgress = React19__default.default.memo(_StepProgress);
 var styles5 = reactNative.StyleSheet.create({
   track: { height: 6, width: "100%", overflow: "hidden" },
   fill: { height: 6 }
@@ -1012,7 +1030,7 @@ var _OnboardingScaffold = ({
   children
 }) => {
   const t = useOnboardingTheme();
-  const styles18 = React18.useMemo(() => makeStyles(t), [t]);
+  const styles18 = React19.useMemo(() => makeStyles(t), [t]);
   const hit = { top: 12, bottom: 12, left: 12, right: 12 };
   return /* @__PURE__ */ jsxRuntime.jsxs(
     reactNativeSafeAreaContext.SafeAreaView,
@@ -1036,7 +1054,7 @@ var _OnboardingScaffold = ({
     }
   );
 };
-var OnboardingScaffold = React18__default.default.memo(_OnboardingScaffold);
+var OnboardingScaffold = React19__default.default.memo(_OnboardingScaffold);
 function makeStyles(t) {
   return reactNative.StyleSheet.create({
     flex: { flex: 1 },
@@ -1057,8 +1075,8 @@ var _Button = ({
   const t = useOnboardingTheme();
   const reduced = useReducedMotion();
   const isPrimary = variant === "primary";
-  const pressT = React18.useRef(new reactNative.Animated.Value(0)).current;
-  const pressTo = React18.useCallback(
+  const pressT = React19.useRef(new reactNative.Animated.Value(0)).current;
+  const pressTo = React19.useCallback(
     (to) => {
       if (reduced) {
         reactNative.Animated.timing(pressT, {
@@ -1077,16 +1095,16 @@ var _Button = ({
     },
     [pressT, reduced]
   );
-  const lastPress = React18.useRef(0);
-  const handlePress = React18.useCallback(() => {
+  const lastPress = React19.useRef(0);
+  const handlePress = React19.useCallback(() => {
     if (!onPress) return;
     const now = Date.now();
     if (now - lastPress.current < 500) return;
     lastPress.current = now;
     onPress();
   }, [onPress]);
-  const handlePressIn = React18.useCallback(() => pressTo(1), [pressTo]);
-  const handlePressOut = React18.useCallback(() => pressTo(0), [pressTo]);
+  const handlePressIn = React19.useCallback(() => pressTo(1), [pressTo]);
+  const handlePressOut = React19.useCallback(() => pressTo(0), [pressTo]);
   const scale = pressT.interpolate({
     inputRange: [0, 1],
     outputRange: [1, reduced ? 1 : BUTTON_PRESS_SCALE]
@@ -1137,7 +1155,7 @@ var _Button = ({
     }
   );
 };
-var Button = React18__default.default.memo(_Button);
+var Button = React19__default.default.memo(_Button);
 var styles6 = reactNative.StyleSheet.create({
   base: { alignItems: "center", justifyContent: "center" },
   fill: { width: "100%" }
@@ -1155,7 +1173,7 @@ var _ErrorBlock = ({
     onRetry ? /* @__PURE__ */ jsxRuntime.jsx(Button, { title: retryLabel, onPress: onRetry, variant: "outline" }) : null
   ] });
 };
-var ErrorBlock = React18__default.default.memo(_ErrorBlock);
+var ErrorBlock = React19__default.default.memo(_ErrorBlock);
 var styles7 = reactNative.StyleSheet.create({
   center: { flex: 1, alignItems: "center", justifyContent: "center" }
 });
@@ -1168,7 +1186,7 @@ var _CardLayout = ({
   titleNode
 }) => {
   const t = useOnboardingTheme();
-  const styles18 = React18.useMemo(() => makeStyles2(t), [t]);
+  const styles18 = React19.useMemo(() => makeStyles2(t), [t]);
   const hasHeader = !!title || !!subtitle || !!titleNode;
   return /* @__PURE__ */ jsxRuntime.jsxs(reactNative.KeyboardAvoidingView, { style: styles18.fill, behavior: "padding", children: [
     hasHeader ? /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles18.header, children: [
@@ -1201,7 +1219,7 @@ var _CardLayout = ({
     footer ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: styles18.footer, children: footer }) : null
   ] });
 };
-var CardLayout = React18__default.default.memo(_CardLayout);
+var CardLayout = React19__default.default.memo(_CardLayout);
 function makeStyles2(t) {
   return reactNative.StyleSheet.create({
     fill: { flex: 1 },
@@ -1224,12 +1242,12 @@ var _CompletionView = ({
 }) => {
   const t = useOnboardingTheme();
   const reduced = useReducedMotion();
-  const [submitted, setSubmitted] = React18.useState(false);
-  const pop = React18.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
-  const burst = React18.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
-  const titleT = React18.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
-  const messageT = React18.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
-  React18.useEffect(() => {
+  const [submitted, setSubmitted] = React19.useState(false);
+  const pop = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  const burst = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  const titleT = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  const messageT = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  React19.useEffect(() => {
     if (reduced) {
       pop.setValue(1);
       burst.setValue(1);
@@ -1264,7 +1282,7 @@ var _CompletionView = ({
     anims.forEach((a) => a.start());
     return () => anims.forEach((a) => a.stop());
   }, [reduced, pop, burst, titleT, messageT]);
-  const handlePress = React18.useCallback(() => {
+  const handlePress = React19.useCallback(() => {
     if (submitted) return;
     setSubmitted(true);
     onContinue();
@@ -1326,7 +1344,7 @@ var _CompletionView = ({
     }
   );
 };
-var CompletionView = React18__default.default.memo(_CompletionView);
+var CompletionView = React19__default.default.memo(_CompletionView);
 var styles8 = reactNative.StyleSheet.create({
   center: { width: "100%", alignItems: "center", justifyContent: "center" },
   badgeStage: {
@@ -1348,13 +1366,13 @@ var _CardHandoff = ({
   children
 }) => {
   const reduced = useReducedMotion();
-  const [leaving, setLeaving] = React18.useState(null);
-  const enterT = React18.useRef(new reactNative.Animated.Value(0)).current;
-  const exitT = React18.useRef(new reactNative.Animated.Value(0)).current;
-  const prev = React18.useRef({ key: transitionKey, node: children, variant });
-  const running = React18.useRef({});
-  const mounted = React18.useRef(false);
-  React18.useEffect(() => {
+  const [leaving, setLeaving] = React19.useState(null);
+  const enterT = React19.useRef(new reactNative.Animated.Value(0)).current;
+  const exitT = React19.useRef(new reactNative.Animated.Value(0)).current;
+  const prev = React19.useRef({ key: transitionKey, node: children, variant });
+  const running = React19.useRef({});
+  const mounted = React19.useRef(false);
+  React19.useEffect(() => {
     var _a2, _b;
     const last = prev.current;
     prev.current = { key: transitionKey, node: children, variant };
@@ -1387,7 +1405,7 @@ var _CardHandoff = ({
     );
     running.current.enter = enter;
   });
-  React18.useEffect(
+  React19.useEffect(
     () => () => {
       var _a2, _b;
       (_a2 = running.current.enter) == null ? void 0 : _a2.stop();
@@ -1456,7 +1474,7 @@ var transformFor = (variant, t, reduced, layer, travel) => {
     }
   ];
 };
-var CardHandoff = React18__default.default.memo(_CardHandoff);
+var CardHandoff = React19__default.default.memo(_CardHandoff);
 var styles9 = reactNative.StyleSheet.create({
   fill: { flex: 1 }
 });
@@ -1480,7 +1498,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));
@@ -1501,45 +1519,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 {
   }
@@ -1550,7 +1594,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;
   }
@@ -1582,6 +1632,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 = reactNative.Easing.bezier(...WIRE_BEZIER);
+var RISE_PX = 10;
+var PERMISSION_CARD_NAME = "PermissionCard";
+var REQUEST_WATCHDOG_MS = 9e4;
+var schema = zod.z.object({
+  permission: zod.z.string().describe("Which OS permission this screen primes, e.g. 'notifications'"),
+  title: zod.z.string().describe("Headline for the ask"),
+  message: zod.z.string().describe("Why the app needs it, in the user's terms"),
+  primaryLabel: zod.z.string().describe("Primary button, the only control that can open the OS dialog"),
+  secondaryLabel: zod.z.string().describe("Secondary button, advances without spending the OS prompt"),
+  blockedTitle: zod.z.string().optional().describe("Headline once the permission is permanently refused"),
+  blockedMessage: zod.z.string().optional().describe("Rationale for the settings route"),
+  settingsLabel: zod.z.string().optional().describe("Primary button label on the blocked route"),
+  continueLabel: zod.z.string().optional().describe("Primary button label when there is nothing to ask"),
+  illustration: zod.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] = React19.useState(void 0);
+  const [busy, setBusy] = React19.useState(false);
+  const settledRef = React19.useRef(false);
+  const acceptedRef = React19.useRef(false);
+  const watchdogRef = React19.useRef(null);
+  const clearWatchdog = React19.useCallback(() => {
+    if (watchdogRef.current) {
+      clearTimeout(watchdogRef.current);
+      watchdogRef.current = null;
+    }
+  }, []);
+  React19.useEffect(() => clearWatchdog, [clearWatchdog]);
+  const onStageRef = React19.useRef(onStage);
+  onStageRef.current = onStage;
+  const onSettledRef = React19.useRef(onSettled);
+  onSettledRef.current = onSettled;
+  const getStatusRef = React19.useRef(getStatus);
+  getStatusRef.current = getStatus;
+  const shownRef = React19.useRef(false);
+  React19.useEffect(() => {
+    var _a2;
+    if (shownRef.current) return;
+    shownRef.current = true;
+    (_a2 = onStageRef.current) == null ? void 0 : _a2.call(onStageRef, "shown");
+  }, []);
+  React19.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 = React19.useRef(request);
+  requestRef.current = request;
+  React19.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 = React19.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 = React19.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 = React19.useCallback(() => {
+    var _a2;
+    if (settledRef.current || busy) return;
+    (_a2 = onStageRef.current) == null ? void 0 : _a2.call(onStageRef, "skipped");
+    settle("skipped");
+  }, [busy, settle]);
+  const popT = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  const titleT = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  const bodyT = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  React19.useEffect(() => {
+    if (reduced) {
+      popT.setValue(1);
+      titleT.setValue(1);
+      bodyT.setValue(1);
+      return;
+    }
+    const rise = (value, delay) => reactNative.Animated.timing(value, {
+      toValue: 1,
+      duration: scaledMs(INTERSTITIAL_HEAD_MS),
+      delay,
+      easing: easeWire4,
+      useNativeDriver: true
+    });
+    const anims = [
+      reactNative.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__ */ jsxRuntime.jsx(
+    CardLayout,
+    {
+      align: "center",
+      footer: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles10.footer, { gap: t.spacing.sm }], children: [
+        /* @__PURE__ */ jsxRuntime.jsx(Button, { title: primaryTitle, onPress: handlePrimary, variant: "primary", disabled: busy }),
+        showSecondary ? /* @__PURE__ */ jsxRuntime.jsx(
+          Button,
+          {
+            title: secondaryLabel,
+            onPress: handleSecondary,
+            variant: "outline",
+            disabled: busy
+          }
+        ) : null
+      ] }),
+      children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles10.center, { gap: t.spacing.md }], children: [
+        art ? /* @__PURE__ */ jsxRuntime.jsx(
+          reactNative.Animated.View,
+          {
+            style: [styles10.art, { opacity: popT, transform: [{ scale: popScale }] }],
+            children: art
+          }
+        ) : null,
+        /* @__PURE__ */ jsxRuntime.jsx(reactNative.Animated.View, { style: riseStyle(titleT), children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [headingStyle(t.fonts), { color: t.colors.text, textAlign: "center" }], children: shownTitle }) }),
+        /* @__PURE__ */ jsxRuntime.jsx(reactNative.Animated.View, { style: riseStyle(bodyT), children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted, textAlign: "center" }], children: shownMessage }) })
+      ] })
+    }
+  );
+};
+var PermissionCardView = React19__default.default.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 = reactNative.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 = {
@@ -1610,53 +2036,60 @@ 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 } = wireaiRn.useWireAIThread();
   const makeActions = wireaiRn.useWireAIAction(sendMessage);
-  const c = React18.useMemo(() => ({ ...DEFAULT_COPY, ...copy }), [copy]);
-  const onEventRef = React18.useRef(onEvent);
+  const c = React19.useMemo(() => ({ ...DEFAULT_COPY, ...copy }), [copy]);
+  const onEventRef = React19.useRef(onEvent);
   onEventRef.current = onEvent;
-  const onErrorRef = React18.useRef(onError);
+  const onErrorRef = React19.useRef(onError);
   onErrorRef.current = onError;
-  const onCompleteRef = React18.useRef(onComplete);
+  const onCompleteRef = React19.useRef(onComplete);
   onCompleteRef.current = onComplete;
-  const validatorsRef = React18.useRef(validators);
+  const validatorsRef = React19.useRef(validators);
   validatorsRef.current = validators;
-  const reportTargetRef = React18.useRef(reportTarget);
+  const reportTargetRef = React19.useRef(reportTarget);
   reportTargetRef.current = reportTarget;
-  const sessionIdRef = React18.useRef(sessionId);
+  const sessionIdRef = React19.useRef(sessionId);
   sessionIdRef.current = sessionId;
-  const clientContextRef = React18.useRef(clientContext);
+  const clientContextRef = React19.useRef(clientContext);
   clientContextRef.current = clientContext;
-  const lastScreenIndexRef = React18.useRef(-1);
-  const previewTimer = React18.useRef(null);
-  const started = React18.useRef(false);
-  const finished = React18.useRef(false);
-  const errored = React18.useRef(false);
-  const attempts = React18.useRef(0);
-  const degradedRef = React18.useRef(false);
-  const [degraded, setDegraded] = React18.useState(false);
-  const [timedOut, setTimedOut] = React18.useState(false);
-  const [validationError, setValidationError] = React18.useState();
-  const [validating, setValidating] = React18.useState(false);
-  const lastCard = React18.useMemo(
+  const lastScreenIndexRef = React19.useRef(-1);
+  const previewTimer = React19.useRef(null);
+  const started = React19.useRef(false);
+  const finished = React19.useRef(false);
+  const errored = React19.useRef(false);
+  const attempts = React19.useRef(0);
+  const degradedRef = React19.useRef(false);
+  const [degraded, setDegraded] = React19.useState(false);
+  const [timedOut, setTimedOut] = React19.useState(false);
+  const [validationError, setValidationError] = React19.useState();
+  const [validating, setValidating] = React19.useState(false);
+  const [locallySettledPermissions, setLocallySettledPermissions] = React19.useState([]);
+  const onPermissionSettledRef = React19.useRef(onPermissionSettled);
+  onPermissionSettledRef.current = onPermissionSettled;
+  const lastCard = React19.useMemo(
     () => [...messages].reverse().find((m) => {
       var _a3;
       return m.role === "assistant" && ((_a3 = m.response) == null ? void 0 : _a3.action) === "render";
     }),
     [messages]
   );
-  const renderedCount = React18.useMemo(
+  const renderedCount = React19.useMemo(
     () => messages.filter((m) => {
       var _a3;
       return m.role === "assistant" && ((_a3 = m.response) == null ? void 0 : _a3.action) === "render";
     }).length,
     [messages]
   );
-  const progress = React18.useMemo(() => readProgress(lastCard == null ? void 0 : lastCard.response), [lastCard]);
-  React18.useEffect(() => {
+  const progress = React19.useMemo(() => readProgress(lastCard == null ? void 0 : lastCard.response), [lastCard]);
+  React19.useEffect(() => {
     var _a3;
     if (started.current) return;
     started.current = true;
@@ -1666,12 +2099,12 @@ var OnboardingFlow = ({
       resumed ? { type: "resumed", contextId: sessionId } : { type: "started", contextId: sessionId }
     );
   }, [sendMessage, startMessage, resumed, sessionId]);
-  React18.useEffect(() => {
+  React19.useEffect(() => {
     if (lastCard) return;
     const timer = setTimeout(() => setTimedOut(true), startTimeoutMs);
     return () => clearTimeout(timer);
   }, [lastCard, startTimeoutMs]);
-  React18.useEffect(() => {
+  React19.useEffect(() => {
     var _a3, _b2, _c2, _d2;
     setValidationError(void 0);
     if (!(lastCard == null ? void 0 : lastCard.id)) return;
@@ -1689,7 +2122,7 @@ var OnboardingFlow = ({
       });
     }
   }, [lastCard == null ? void 0 : lastCard.id]);
-  React18.useEffect(() => {
+  React19.useEffect(() => {
     return () => {
       var _a3, _b2, _c2;
       if (finished.current || degradedRef.current) return;
@@ -1703,13 +2136,13 @@ var OnboardingFlow = ({
       });
     };
   }, []);
-  const restartThread = React18.useCallback(() => {
+  const restartThread = React19.useCallback(() => {
     setTimedOut(false);
     started.current = false;
     errored.current = false;
     reset();
   }, [reset]);
-  React18.useEffect(() => {
+  React19.useEffect(() => {
     var _a3, _b2, _c2, _d2, _e2, _f2, _g;
     if (errored.current) return;
     if (!error && !timedOut) return;
@@ -1736,22 +2169,52 @@ var OnboardingFlow = ({
       (_g = onErrorRef.current) == null ? void 0 : _g.call(onErrorRef, error != null ? error : new Error("Onboarding timed out"));
     }
   }, [error, timedOut, maxRetries]);
-  const handleFinish = React18.useCallback(() => {
+  const handleFinish = React19.useCallback(() => {
     if (finished.current) return;
     finished.current = true;
     onCompleteRef.current({ answers: deriveAnswers(messages), raw: messages });
   }, [messages]);
-  const handleRetry = React18.useCallback(() => {
+  const handleRetry = React19.useCallback(() => {
     attempts.current = 0;
     degradedRef.current = false;
     setDegraded(false);
     restartThread();
   }, [restartThread]);
-  const skipQuestion = React18.useCallback(() => {
+  const skipQuestion = React19.useCallback(() => {
     if (isLoading) return;
     sendMessage(SKIP_ONE_SENTINEL);
   }, [isLoading, sendMessage]);
-  const previewOnSelect = React18.useCallback((value) => {
+  const emitPermissionStage = React19.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 = React19.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 = React19.useCallback((value) => {
     const target = reportTargetRef.current;
     if (!(target == null ? void 0 : target.serverUrl)) return;
     if (Array.isArray(value) ? value.length === 0 : !value) return;
@@ -1763,15 +2226,15 @@ var OnboardingFlow = ({
       });
     }, 300);
   }, []);
-  React18.useEffect(() => () => {
+  React19.useEffect(() => () => {
     if (previewTimer.current) clearTimeout(previewTimer.current);
   }, []);
-  const wrappedActions = React18.useCallback(
+  const wrappedActions = React19.useCallback(
     (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) {
@@ -1796,7 +2259,7 @@ var OnboardingFlow = ({
       }
       return out;
     },
-    [makeActions, progress.key]
+    [makeActions, progress.key, progress.slot_id]
   );
   if (degraded) {
     if (fallbackFlow !== void 0) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: fallbackFlow });
@@ -1821,6 +2284,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__ */ jsxRuntime.jsx(OnboardingScaffold, { step, approxScreens: total, children: /* @__PURE__ */ jsxRuntime.jsx(CardHandoff, { transitionKey: `permission:${id}`, variant: "spring", children: /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsx(OnboardingScaffold, { step, complete: true, approxScreens: total, children: /* @__PURE__ */ jsxRuntime.jsx(
@@ -1879,8 +2372,8 @@ var OnboardingFlow = ({
     }
   );
 };
-var easeWire4 = reactNative.Easing.bezier(...WIRE_BEZIER);
-var schema = zod.z.object({
+var easeWire5 = reactNative.Easing.bezier(...WIRE_BEZIER);
+var schema2 = zod.z.object({
   title: zod.z.string().describe("Question or section header, e.g. 'Which season?'"),
   chips: zod.z.array(zod.z.string()).min(1).describe("List of option labels shown as chips, e.g. ['Spring','Summer','Autumn','Winter']"),
   multiSelect: zod.z.boolean().optional().describe("Allow multiple chips selected at once, default true"),
@@ -1890,9 +2383,9 @@ var schema = zod.z.object({
 var _ChipItem = ({ chip, isSelected, multiSelect, onToggle }) => {
   const t = useOnboardingTheme();
   const reduced = useReducedMotion();
-  const handlePress = React18.useCallback(() => onToggle(chip), [chip, onToggle]);
-  const pressScale = React18.useRef(new reactNative.Animated.Value(1)).current;
-  const pressTo = React18.useCallback(
+  const handlePress = React19.useCallback(() => onToggle(chip), [chip, onToggle]);
+  const pressScale = React19.useRef(new reactNative.Animated.Value(1)).current;
+  const pressTo = React19.useCallback(
     (to) => {
       if (reduced) return;
       reactNative.Animated.spring(pressScale, {
@@ -1904,21 +2397,21 @@ var _ChipItem = ({ chip, isSelected, multiSelect, onToggle }) => {
     },
     [pressScale, reduced]
   );
-  const handlePressIn = React18.useCallback(() => pressTo(CHIP_PRESS_SCALE), [pressTo]);
-  const handlePressOut = React18.useCallback(() => pressTo(1), [pressTo]);
-  const fillT = React18.useRef(new reactNative.Animated.Value(isSelected ? 1 : 0)).current;
-  React18.useEffect(() => {
+  const handlePressIn = React19.useCallback(() => pressTo(CHIP_PRESS_SCALE), [pressTo]);
+  const handlePressOut = React19.useCallback(() => pressTo(1), [pressTo]);
+  const fillT = React19.useRef(new reactNative.Animated.Value(isSelected ? 1 : 0)).current;
+  React19.useEffect(() => {
     const anim = reactNative.Animated.timing(fillT, {
       toValue: isSelected ? 1 : 0,
       duration: scaledMs(stateChangeDuration(reduced, CHIP_FILL_MS)),
-      easing: easeWire4,
+      easing: easeWire5,
       useNativeDriver: true
     });
     anim.start();
     return () => anim.stop();
   }, [isSelected, reduced, fillT]);
-  const checkT = React18.useRef(new reactNative.Animated.Value(isSelected ? 1 : 0)).current;
-  React18.useEffect(() => {
+  const checkT = React19.useRef(new reactNative.Animated.Value(isSelected ? 1 : 0)).current;
+  React19.useEffect(() => {
     if (!isSelected) {
       checkT.setValue(0);
       return;
@@ -1951,7 +2444,7 @@ var _ChipItem = ({ chip, isSelected, multiSelect, onToggle }) => {
         reactNative.Animated.View,
         {
           style: [
-            styles10.chip,
+            styles11.chip,
             {
               borderRadius: t.radius.full,
               paddingHorizontal: t.spacing.md,
@@ -1968,7 +2461,7 @@ var _ChipItem = ({ chip, isSelected, multiSelect, onToggle }) => {
                 pointerEvents: "none",
                 style: [
                   reactNative.StyleSheet.absoluteFill,
-                  styles10.fillOverlay,
+                  styles11.fillOverlay,
                   {
                     borderRadius: t.radius.full,
                     borderColor: t.colors.primary,
@@ -1982,7 +2475,7 @@ var _ChipItem = ({ chip, isSelected, multiSelect, onToggle }) => {
               reactNative.Animated.Text,
               {
                 style: [
-                  styles10.check,
+                  styles11.check,
                   { color: t.colors.onPrimary, opacity: checkT, transform: [{ scale: checkScale }] }
                 ],
                 children: "\u2713"
@@ -1993,7 +2486,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
@@ -2005,7 +2498,7 @@ var _ChipItem = ({ chip, isSelected, multiSelect, onToggle }) => {
     }
   );
 };
-var ChipItem = React18__default.default.memo(_ChipItem);
+var ChipItem = React19__default.default.memo(_ChipItem);
 var _ChipSelectCard = ({
   title,
   chips,
@@ -2016,12 +2509,12 @@ var _ChipSelectCard = ({
   onSelectionChange
 }) => {
   const t = useOnboardingTheme();
-  const [selected, setSelected] = React18.useState([]);
-  const [submitted, setSubmitted] = React18.useState(false);
-  React18.useEffect(() => {
+  const [selected, setSelected] = React19.useState([]);
+  const [submitted, setSubmitted] = React19.useState(false);
+  React19.useEffect(() => {
     if (!submitted && selected.length) onSelectionChange == null ? void 0 : onSelectionChange(multiSelect ? selected : selected[0]);
   }, [selected, submitted, multiSelect, onSelectionChange]);
-  const toggle = React18.useCallback(
+  const toggle = React19.useCallback(
     (chip) => {
       if (submitted) return;
       if (multiSelect) {
@@ -2036,7 +2529,7 @@ var _ChipSelectCard = ({
     },
     [submitted, multiSelect, maxSelections]
   );
-  const handleSubmit = React18.useCallback(() => {
+  const handleSubmit = React19.useCallback(() => {
     if (!selected.length || !onSelect || submitted) return;
     setSubmitted(true);
     onSelect(multiSelect ? selected : selected[0]);
@@ -2055,7 +2548,7 @@ var _ChipSelectCard = ({
           disabled: selected.length === 0 || submitted
         }
       ),
-      children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: [styles10.chipsRow, { gap: t.spacing.sm + t.spacing.xs }], children: chips.map((chip) => /* @__PURE__ */ jsxRuntime.jsx(
+      children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: [styles11.chipsRow, { gap: t.spacing.sm + t.spacing.xs }], children: chips.map((chip) => /* @__PURE__ */ jsxRuntime.jsx(
         ChipItem,
         {
           chip,
@@ -2071,18 +2564,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__default.default.memo(_ChipSelectCard),
-  propsSchema: schema,
+  component: React19__default.default.memo(_ChipSelectCard),
+  propsSchema: schema2,
   defaultProps: { multiSelect: true, submitLabel: "Continue" }
 };
-var styles10 = reactNative.StyleSheet.create({
+var styles11 = reactNative.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 = zod.z.object({
+var schema3 = zod.z.object({
   label: zod.z.string().describe("Input field label / the question being asked"),
   hint: zod.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."
@@ -2107,14 +2600,14 @@ var _TextInputCard = ({
   lines = 6
 }) => {
   const t = useOnboardingTheme();
-  const styles18 = React18.useMemo(() => makeStyles3(t), [t]);
+  const styles18 = React19.useMemo(() => makeStyles3(t), [t]);
   const { height: screenHeight } = reactNative.useWindowDimensions();
-  const [value, setValue] = React18.useState("");
-  const [submitted, setSubmitted] = React18.useState(false);
+  const [value, setValue] = React19.useState("");
+  const [submitted, setSubmitted] = React19.useState(false);
   const locked = submitted && !validationError;
   const APPROX_ROW_HEIGHT = 26;
   const minHeight = multiline ? Math.min(Math.max(lines, 4) * APPROX_ROW_HEIGHT + t.spacing.md * 2, screenHeight * 0.4) : 52;
-  const handleSubmit = React18.useCallback(() => {
+  const handleSubmit = React19.useCallback(() => {
     if (value.trim() && onSubmit && !locked) {
       setSubmitted(true);
       onSubmit(value.trim());
@@ -2168,8 +2661,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__default.default.memo(_TextInputCard),
-  propsSchema: schema2,
+  component: React19__default.default.memo(_TextInputCard),
+  propsSchema: schema3,
   defaultProps: { submitLabel: "Submit", multiline: true, lines: 6 }
 };
 function makeStyles3(t) {
@@ -2324,7 +2817,7 @@ var _WireIcon = ({ name: name2, size = 20, color, requireModule }) => {
     return /* @__PURE__ */ jsxRuntime.jsx(
       reactNative.View,
       {
-        style: styles11.decorative,
+        style: styles12.decorative,
         accessible: false,
         importantForAccessibility: "no-hide-descendants",
         children: hostIcon
@@ -2338,7 +2831,7 @@ var _WireIcon = ({ name: name2, size = 20, color, requireModule }) => {
   return /* @__PURE__ */ jsxRuntime.jsx(
     reactNative.View,
     {
-      style: styles11.decorative,
+      style: styles12.decorative,
       accessible: false,
       importantForAccessibility: "no-hide-descendants",
       children: /* @__PURE__ */ jsxRuntime.jsx(
@@ -2353,9 +2846,9 @@ var _WireIcon = ({ name: name2, size = 20, color, requireModule }) => {
     }
   );
 };
-var WireIcon = React18__default.default.memo(_WireIcon);
+var WireIcon = React19__default.default.memo(_WireIcon);
 WireIcon.displayName = "WireIcon";
-var styles11 = reactNative.StyleSheet.create({
+var styles12 = reactNative.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: {}
@@ -2369,8 +2862,8 @@ var optionObjectSchema = zod.z.object({
 var coerceOptions = (arr) => Array.isArray(arr) ? arr.map((item) => typeof item === "string" ? { value: item, label: item } : item) : arr;
 var optionsField = (description) => zod.z.preprocess(coerceOptions, zod.z.array(optionObjectSchema).min(1)).describe(description);
 var normalizeOptions = (options) => options.map((opt) => typeof opt === "string" ? { value: opt, label: opt } : opt);
-var easeWire5 = reactNative.Easing.bezier(...WIRE_BEZIER);
-var schema3 = zod.z.object({
+var easeWire6 = reactNative.Easing.bezier(...WIRE_BEZIER);
+var schema4 = zod.z.object({
   title: zod.z.string().describe("Question or prompt for the user"),
   options: optionsField("List of choices"),
   submitLabel: zod.z.string().optional().describe("Submit button label, default: Continue"),
@@ -2379,9 +2872,9 @@ var schema3 = zod.z.object({
 var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
   const t = useOnboardingTheme();
   const reduced = useReducedMotion();
-  const handlePress = React18.useCallback(() => onToggle(opt.value), [opt.value, onToggle]);
-  const pressScale = React18.useRef(new reactNative.Animated.Value(1)).current;
-  const pressTo = React18.useCallback(
+  const handlePress = React19.useCallback(() => onToggle(opt.value), [opt.value, onToggle]);
+  const pressScale = React19.useRef(new reactNative.Animated.Value(1)).current;
+  const pressTo = React19.useCallback(
     (to) => {
       if (reduced) return;
       reactNative.Animated.spring(pressScale, {
@@ -2393,21 +2886,21 @@ var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
     },
     [pressScale, reduced]
   );
-  const handlePressIn = React18.useCallback(() => pressTo(ROW_PRESS_SCALE), [pressTo]);
-  const handlePressOut = React18.useCallback(() => pressTo(1), [pressTo]);
-  const selectT = React18.useRef(new reactNative.Animated.Value(isSelected ? 1 : 0)).current;
-  React18.useEffect(() => {
+  const handlePressIn = React19.useCallback(() => pressTo(ROW_PRESS_SCALE), [pressTo]);
+  const handlePressOut = React19.useCallback(() => pressTo(1), [pressTo]);
+  const selectT = React19.useRef(new reactNative.Animated.Value(isSelected ? 1 : 0)).current;
+  React19.useEffect(() => {
     const anim = reactNative.Animated.timing(selectT, {
       toValue: isSelected ? 1 : 0,
       duration: scaledMs(stateChangeDuration(reduced, SELECT_FILL_MS)),
-      easing: easeWire5,
+      easing: easeWire6,
       useNativeDriver: true
     });
     anim.start();
     return () => anim.stop();
   }, [isSelected, reduced, selectT]);
-  const checkT = React18.useRef(new reactNative.Animated.Value(isSelected ? 1 : 0)).current;
-  React18.useEffect(() => {
+  const checkT = React19.useRef(new reactNative.Animated.Value(isSelected ? 1 : 0)).current;
+  React19.useEffect(() => {
     if (!isSelected) {
       checkT.setValue(0);
       return;
@@ -2440,7 +2933,7 @@ var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
         reactNative.Animated.View,
         {
           style: [
-            styles12.option,
+            styles13.option,
             {
               padding: t.spacing.md,
               borderRadius: t.radius.md,
@@ -2457,7 +2950,7 @@ var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
                 pointerEvents: "none",
                 style: [
                   reactNative.StyleSheet.absoluteFill,
-                  styles12.selectedOverlay,
+                  styles13.selectedOverlay,
                   {
                     borderRadius: t.radius.md,
                     borderColor: t.colors.primary,
@@ -2471,7 +2964,7 @@ var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
               reactNative.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" }
                 ],
@@ -2479,7 +2972,7 @@ var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
                   reactNative.Animated.Text,
                   {
                     style: [
-                      styles12.check,
+                      styles13.check,
                       { color: t.colors.onPrimary, opacity: checkT, transform: [{ scale: checkScale }] }
                     ],
                     children: "\u2713"
@@ -2495,7 +2988,7 @@ var _OptionRow = ({ opt, isSelected, multiSelect, onToggle }) => {
     }
   );
 };
-var OptionRow = React18__default.default.memo(_OptionRow);
+var OptionRow = React19__default.default.memo(_OptionRow);
 var _SelectionCard = ({
   title,
   options,
@@ -2505,13 +2998,13 @@ var _SelectionCard = ({
   onSelectionChange
 }) => {
   const t = useOnboardingTheme();
-  const opts = React18__default.default.useMemo(() => normalizeOptions(options), [options]);
-  const [selected, setSelected] = React18.useState([]);
-  const [submitted, setSubmitted] = React18.useState(false);
-  React18.useEffect(() => {
+  const opts = React19__default.default.useMemo(() => normalizeOptions(options), [options]);
+  const [selected, setSelected] = React19.useState([]);
+  const [submitted, setSubmitted] = React19.useState(false);
+  React19.useEffect(() => {
     if (!submitted && selected.length) onSelectionChange == null ? void 0 : onSelectionChange(multiSelect ? selected : selected[0]);
   }, [selected, submitted, multiSelect, onSelectionChange]);
-  const toggle = React18.useCallback(
+  const toggle = React19.useCallback(
     (value) => {
       if (submitted) return;
       if (multiSelect) {
@@ -2522,7 +3015,7 @@ var _SelectionCard = ({
     },
     [submitted, multiSelect]
   );
-  const handleSubmit = React18.useCallback(() => {
+  const handleSubmit = React19.useCallback(() => {
     if (!selected.length || !onSelect || submitted) return;
     setSubmitted(true);
     onSelect(multiSelect ? selected : selected[0]);
@@ -2556,18 +3049,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__default.default.memo(_SelectionCard),
-  propsSchema: schema3,
+  component: React19__default.default.memo(_SelectionCard),
+  propsSchema: schema4,
   defaultProps: { submitLabel: "Continue", multiSelect: false }
 };
-var styles12 = reactNative.StyleSheet.create({
+var styles13 = reactNative.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 = reactNative.Easing.bezier(...WIRE_BEZIER);
-var schema4 = zod.z.object({
+var easeWire7 = reactNative.Easing.bezier(...WIRE_BEZIER);
+var schema5 = zod.z.object({
   title: zod.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."
@@ -2578,9 +3071,9 @@ var schema4 = zod.z.object({
 var _OptionCard = ({ opt, isSelected, multiSelect, onToggle }) => {
   const t = useOnboardingTheme();
   const reduced = useReducedMotion();
-  const handlePress = React18.useCallback(() => onToggle(opt.value), [opt.value, onToggle]);
-  const pressScale = React18.useRef(new reactNative.Animated.Value(1)).current;
-  const pressTo = React18.useCallback(
+  const handlePress = React19.useCallback(() => onToggle(opt.value), [opt.value, onToggle]);
+  const pressScale = React19.useRef(new reactNative.Animated.Value(1)).current;
+  const pressTo = React19.useCallback(
     (to) => {
       if (reduced) return;
       reactNative.Animated.spring(pressScale, {
@@ -2592,14 +3085,14 @@ var _OptionCard = ({ opt, isSelected, multiSelect, onToggle }) => {
     },
     [pressScale, reduced]
   );
-  const handlePressIn = React18.useCallback(() => pressTo(ROW_PRESS_SCALE), [pressTo]);
-  const handlePressOut = React18.useCallback(() => pressTo(1), [pressTo]);
-  const selectT = React18.useRef(new reactNative.Animated.Value(isSelected ? 1 : 0)).current;
-  React18.useEffect(() => {
+  const handlePressIn = React19.useCallback(() => pressTo(ROW_PRESS_SCALE), [pressTo]);
+  const handlePressOut = React19.useCallback(() => pressTo(1), [pressTo]);
+  const selectT = React19.useRef(new reactNative.Animated.Value(isSelected ? 1 : 0)).current;
+  React19.useEffect(() => {
     const anim = reactNative.Animated.timing(selectT, {
       toValue: isSelected ? 1 : 0,
       duration: scaledMs(stateChangeDuration(reduced, SELECT_FILL_MS)),
-      easing: easeWire6,
+      easing: easeWire7,
       useNativeDriver: true
     });
     anim.start();
@@ -2614,12 +3107,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__ */ jsxRuntime.jsxs(
         reactNative.Animated.View,
         {
           style: [
-            styles13.card,
+            styles14.card,
             {
               padding: t.spacing.md,
               borderRadius: t.radius.lg,
@@ -2636,7 +3129,7 @@ var _OptionCard = ({ opt, isSelected, multiSelect, onToggle }) => {
                 pointerEvents: "none",
                 style: [
                   reactNative.StyleSheet.absoluteFill,
-                  styles13.selectedOverlay,
+                  styles14.selectedOverlay,
                   {
                     borderRadius: t.radius.lg,
                     borderColor: t.colors.primary,
@@ -2654,7 +3147,7 @@ var _OptionCard = ({ opt, isSelected, multiSelect, onToggle }) => {
     }
   );
 };
-var OptionCard = React18__default.default.memo(_OptionCard);
+var OptionCard = React19__default.default.memo(_OptionCard);
 var _CardGridSelectCard = ({
   title,
   options,
@@ -2664,13 +3157,13 @@ var _CardGridSelectCard = ({
   onSelectionChange
 }) => {
   const t = useOnboardingTheme();
-  const opts = React18__default.default.useMemo(() => normalizeOptions(options), [options]);
-  const [selected, setSelected] = React18.useState([]);
-  const [submitted, setSubmitted] = React18.useState(false);
-  React18.useEffect(() => {
+  const opts = React19__default.default.useMemo(() => normalizeOptions(options), [options]);
+  const [selected, setSelected] = React19.useState([]);
+  const [submitted, setSubmitted] = React19.useState(false);
+  React19.useEffect(() => {
     if (!submitted && selected.length) onSelectionChange == null ? void 0 : onSelectionChange(multiSelect ? selected : selected[0]);
   }, [selected, submitted, multiSelect, onSelectionChange]);
-  const toggle = React18.useCallback(
+  const toggle = React19.useCallback(
     (value) => {
       if (submitted) return;
       if (multiSelect) {
@@ -2683,7 +3176,7 @@ var _CardGridSelectCard = ({
     },
     [submitted, multiSelect]
   );
-  const handleSubmit = React18.useCallback(() => {
+  const handleSubmit = React19.useCallback(() => {
     if (!selected.length || !onSelect || submitted) return;
     setSubmitted(true);
     onSelect(multiSelect ? selected : selected[0]);
@@ -2701,7 +3194,7 @@ var _CardGridSelectCard = ({
           disabled: selected.length === 0 || submitted
         }
       ),
-      children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: [styles13.grid, { gap: t.spacing.sm }], children: opts.map((opt) => /* @__PURE__ */ jsxRuntime.jsx(
+      children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: [styles14.grid, { gap: t.spacing.sm }], children: opts.map((opt) => /* @__PURE__ */ jsxRuntime.jsx(
         OptionCard,
         {
           opt,
@@ -2717,19 +3210,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__default.default.memo(_CardGridSelectCard),
-  propsSchema: schema4,
+  component: React19__default.default.memo(_CardGridSelectCard),
+  propsSchema: schema5,
   defaultProps: { submitLabel: "Continue", multiSelect: true }
 };
-var styles13 = reactNative.StyleSheet.create({
+var styles14 = reactNative.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 = reactNative.Easing.bezier(...WIRE_BEZIER);
-var schema5 = zod.z.object({
+var easeWire8 = reactNative.Easing.bezier(...WIRE_BEZIER);
+var schema6 = zod.z.object({
   status: zod.z.enum(["success", "warning", "error", "info"]).describe("Status type"),
   title: zod.z.string().describe("Status title"),
   message: zod.z.string().optional().describe("Supporting message"),
@@ -2747,8 +3240,8 @@ var _StatusCard = ({ status, title, message, ctaLabel, onContinue, onPress, onSu
   var _a2;
   const t = useOnboardingTheme();
   const reduced = useReducedMotion();
-  const [submitted, setSubmitted] = React18.useState(false);
-  const color = React18.useMemo(() => {
+  const [submitted, setSubmitted] = React19.useState(false);
+  const color = React19.useMemo(() => {
     switch (status) {
       case "success":
         return t.colors.success;
@@ -2760,9 +3253,9 @@ var _StatusCard = ({ status, title, message, ctaLabel, onContinue, onPress, onSu
         return t.colors.info;
     }
   }, [status, t.colors]);
-  const popT = React18.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
-  const copyT = React18.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
-  React18.useEffect(() => {
+  const popT = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  const copyT = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  React19.useEffect(() => {
     if (reduced) {
       popT.setValue(1);
       copyT.setValue(1);
@@ -2779,7 +3272,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
       })
     ];
@@ -2788,7 +3281,7 @@ var _StatusCard = ({ status, title, message, ctaLabel, onContinue, onPress, onSu
   }, [reduced, popT, copyT]);
   const popScale = popT.interpolate({ inputRange: [0, 1], outputRange: [STATUS_POP_SCALE_FROM, 1] });
   const copyRise = copyT.interpolate({ inputRange: [0, 1], outputRange: [10, 0] });
-  const handleContinue = React18.useCallback(() => {
+  const handleContinue = React19.useCallback(() => {
     if (!submitted) {
       setSubmitted(true);
       if (onContinue) onContinue();
@@ -2801,8 +3294,8 @@ var _StatusCard = ({ status, title, message, ctaLabel, onContinue, onPress, onSu
     {
       align: "center",
       footer: ctaLabel ? /* @__PURE__ */ jsxRuntime.jsx(Button, { title: ctaLabel, onPress: handleContinue, variant: "primary", disabled: submitted }) : void 0,
-      children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles14.center, { gap: t.spacing.sm }], children: [
-        /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles14.titleRow, { gap: t.spacing.sm }], children: [
+      children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles15.center, { gap: t.spacing.sm }], children: [
+        /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles15.titleRow, { gap: t.spacing.sm }], children: [
           /* @__PURE__ */ jsxRuntime.jsx(
             reactNative.Animated.Text,
             {
@@ -2846,14 +3339,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__default.default.memo(_StatusCard),
-  propsSchema: schema5
+  component: React19__default.default.memo(_StatusCard),
+  propsSchema: schema6
 };
-var styles14 = reactNative.StyleSheet.create({
+var styles15 = reactNative.StyleSheet.create({
   center: { width: "100%", alignItems: "center", justifyContent: "center" },
   titleRow: { flexDirection: "row", alignItems: "center", justifyContent: "center" }
 });
-var schema6 = zod.z.object({
+var schema7 = zod.z.object({
   label: zod.z.string().describe("What is being counted, e.g. 'Number of days' or 'Travellers'"),
   min: zod.z.number().optional().describe("Minimum value, default 1"),
   max: zod.z.number().optional().describe("Maximum value, default 30"),
@@ -2874,22 +3367,22 @@ var _NumberStepperCard = ({
   onSubmit
 }) => {
   const t = useOnboardingTheme();
-  const styles18 = React18.useMemo(() => makeStyles4(t), [t]);
+  const styles18 = React19.useMemo(() => makeStyles4(t), [t]);
   const safeMin = safeNum(min, 1);
   const safeMaxRaw = safeNum(max, 30);
   const safeMax = safeMaxRaw < safeMin ? safeMin : safeMaxRaw;
   const safeStepRaw = safeNum(step, 1);
   const safeStep = safeStepRaw > 0 ? safeStepRaw : 1;
   const safeDefault = safeNum(defaultValue, safeMin);
-  const [value, setValue] = React18.useState(Math.min(Math.max(safeDefault, safeMin), safeMax));
-  const [submitted, setSubmitted] = React18.useState(false);
-  const handleDecrement = React18.useCallback(() => {
+  const [value, setValue] = React19.useState(Math.min(Math.max(safeDefault, safeMin), safeMax));
+  const [submitted, setSubmitted] = React19.useState(false);
+  const handleDecrement = React19.useCallback(() => {
     if (!submitted) setValue((v) => Math.max(v - safeStep, safeMin));
   }, [submitted, safeStep, safeMin]);
-  const handleIncrement = React18.useCallback(() => {
+  const handleIncrement = React19.useCallback(() => {
     if (!submitted) setValue((v) => Math.min(v + safeStep, safeMax));
   }, [submitted, safeStep, safeMax]);
-  const handleSubmit = React18.useCallback(() => {
+  const handleSubmit = React19.useCallback(() => {
     if (!submitted) {
       setSubmitted(true);
       onSubmit == null ? void 0 : onSubmit(value);
@@ -2924,8 +3417,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__default.default.memo(_NumberStepperCard),
-  propsSchema: schema6,
+  component: React19__default.default.memo(_NumberStepperCard),
+  propsSchema: schema7,
   defaultProps: { min: 1, max: 30, defaultValue: 1, step: 1, submitLabel: "Confirm" }
 };
 function makeStyles4(t) {
@@ -2936,9 +3429,9 @@ function makeStyles4(t) {
     valueBox: { alignItems: "center", minWidth: 80 }
   });
 }
-var easeWire8 = reactNative.Easing.bezier(...WIRE_BEZIER);
-var RISE_PX = 10;
-var schema7 = zod.z.object({
+var easeWire9 = reactNative.Easing.bezier(...WIRE_BEZIER);
+var RISE_PX2 = 10;
+var schema8 = zod.z.object({
   title: zod.z.string().describe("Short, warm headline for the value/momentum moment"),
   body: zod.z.string().optional().describe("One or two supporting lines that reflect the user's answers back and build momentum"),
   items: zod.z.array(zod.z.string()).max(4).optional().describe(
@@ -2962,9 +3455,9 @@ var _WorkItem = ({
   reduced
 }) => {
   const t = useOnboardingTheme();
-  const rowT = React18.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
-  const checkT = React18.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
-  React18.useEffect(() => {
+  const rowT = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  const checkT = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  React19.useEffect(() => {
     if (reduced) {
       rowT.setValue(1);
       checkT.setValue(1);
@@ -2975,7 +3468,7 @@ var _WorkItem = ({
         toValue: 1,
         duration: scaledMs(INTERSTITIAL_ITEM_MS),
         delay: scaledMs(interstitialItemDelay(index)),
-        easing: easeWire8,
+        easing: easeWire9,
         useNativeDriver: true
       }),
       reactNative.Animated.spring(checkT, {
@@ -2989,7 +3482,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]
@@ -2997,20 +3490,20 @@ var _WorkItem = ({
   return /* @__PURE__ */ jsxRuntime.jsxs(
     reactNative.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__ */ jsxRuntime.jsx(
           reactNative.View,
           {
             style: [
-              styles15.itemBadge,
+              styles16.itemBadge,
               { backgroundColor: t.colors.primarySoft, borderRadius: t.radius.full }
             ],
             children: /* @__PURE__ */ jsxRuntime.jsx(
               reactNative.Animated.Text,
               {
                 style: [
-                  styles15.itemCheck,
+                  styles16.itemCheck,
                   { color: t.colors.primary, opacity: checkT, transform: [{ scale: checkScale }] }
                 ],
                 children: "\u2713"
@@ -3018,12 +3511,12 @@ var _WorkItem = ({
             )
           }
         ),
-        /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [bodyStyle(t.fonts), styles15.itemText, { color: t.colors.text }], children: text })
+        /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [bodyStyle(t.fonts), styles16.itemText, { color: t.colors.text }], children: text })
       ]
     }
   );
 };
-var WorkItem = React18__default.default.memo(_WorkItem);
+var WorkItem = React19__default.default.memo(_WorkItem);
 var _InterstitialCard = ({
   title,
   body,
@@ -3039,17 +3532,17 @@ var _InterstitialCard = ({
   const reduced = useReducedMotion();
   const node = useIllustration(illustration);
   const fallbackNode = useIllustration(illustrationFallback);
-  const [submitted, setSubmitted] = React18.useState(false);
-  const [imgFailed, setImgFailed] = React18.useState(false);
-  const [canAdvance, setCanAdvance] = React18.useState(false);
-  React18.useEffect(() => {
+  const [submitted, setSubmitted] = React19.useState(false);
+  const [imgFailed, setImgFailed] = React19.useState(false);
+  const [canAdvance, setCanAdvance] = React19.useState(false);
+  React19.useEffect(() => {
     const timer = setTimeout(() => setCanAdvance(true), MIN_DISPLAY_MS);
     return () => clearTimeout(timer);
   }, []);
-  const artT = React18.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
-  const titleT = React18.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
-  const bodyT = React18.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
-  React18.useEffect(() => {
+  const artT = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  const titleT = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  const bodyT = React19.useRef(new reactNative.Animated.Value(reduced ? 1 : 0)).current;
+  React19.useEffect(() => {
     if (reduced) {
       artT.setValue(1);
       titleT.setValue(1);
@@ -3060,7 +3553,7 @@ var _InterstitialCard = ({
       toValue: 1,
       duration: scaledMs(INTERSTITIAL_HEAD_MS),
       delay,
-      easing: easeWire8,
+      easing: easeWire9,
       useNativeDriver: true
     });
     const anims = [
@@ -3073,9 +3566,9 @@ 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 = React18.useCallback(() => {
+  const handleContinue = React19.useCallback(() => {
     if (submitted || !canAdvance) return;
     setSubmitted(true);
     if (onSubmit) onSubmit("continue");
@@ -3096,18 +3589,18 @@ var _InterstitialCard = ({
           disabled: submitted || !canAdvance
         }
       ),
-      children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles15.center, { gap: t.spacing.md }], children: [
-        /* @__PURE__ */ jsxRuntime.jsx(reactNative.Animated.View, { style: [styles15.fullWidth, riseStyle(artT)], children: showImage ? /* @__PURE__ */ jsxRuntime.jsx(
+      children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles16.center, { gap: t.spacing.md }], children: [
+        /* @__PURE__ */ jsxRuntime.jsx(reactNative.Animated.View, { style: [styles16.fullWidth, riseStyle(artT)], children: showImage ? /* @__PURE__ */ jsxRuntime.jsx(
           reactNative.Image,
           {
             source: { uri: imageUrl },
-            style: styles15.image,
+            style: styles16.image,
             resizeMode: "contain",
             onError: () => setImgFailed(true)
           }
-        ) : art ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: styles15.art, children: art }) : null }),
+        ) : art ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: styles16.art, children: art }) : null }),
         /* @__PURE__ */ jsxRuntime.jsx(reactNative.Animated.View, { style: riseStyle(titleT), children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [headingStyle(t.fonts), { color: t.colors.text, textAlign: "center" }], children: title }) }),
-        (items == null ? void 0 : items.length) ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: [styles15.items, { gap: t.spacing.md, marginTop: t.spacing.sm }], children: items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(WorkItem, { text: item, index: i, reduced }, `${item}-${i}`)) }) : body ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.Animated.View, { style: riseStyle(bodyT), children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted, textAlign: "center" }], children: body }) }) : null
+        (items == null ? void 0 : items.length) ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: [styles16.items, { gap: t.spacing.md, marginTop: t.spacing.sm }], children: items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(WorkItem, { text: item, index: i, reduced }, `${item}-${i}`)) }) : body ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.Animated.View, { style: riseStyle(bodyT), children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted, textAlign: "center" }], children: body }) }) : null
       ] })
     }
   );
@@ -3115,11 +3608,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__default.default.memo(_InterstitialCard),
-  propsSchema: schema7,
+  component: React19__default.default.memo(_InterstitialCard),
+  propsSchema: schema8,
   defaultProps: { ctaLabel: "Continue", illustrationFallback: "momentum" }
 };
-var styles15 = reactNative.StyleSheet.create({
+var styles16 = reactNative.StyleSheet.create({
   center: { width: "100%", alignItems: "center", justifyContent: "center" },
   fullWidth: { width: "100%", alignItems: "center" },
   art: { alignItems: "center", justifyContent: "center" },
@@ -3317,6 +3810,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"}`;
@@ -3339,24 +3859,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 = {}) => {
@@ -3376,14 +3909,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;
@@ -3407,13 +3946,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"
@@ -3510,27 +4042,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;
@@ -3611,9 +4136,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;
@@ -3640,69 +4197,99 @@ var WireOnboarding = ({
   retainSessionOnComplete,
   userContext,
   userId,
-  autoJoinKey = true
+  autoJoinKey = true,
+  permissionScreens
 }) => {
-  var _a2, _b, _c;
-  const boundUserId = React18.useMemo(() => sanitizeUserId(userId), [userId]);
-  const device = React18.useMemo(() => {
+  var _a2, _b, _c, _d, _e, _f;
+  const boundUserId = React19.useMemo(() => sanitizeUserId(userId), [userId]);
+  const device = React19.useMemo(() => {
     const collected = collectDeviceContext();
     return config.appVersion ? { ...collected, appVersion: config.appVersion } : collected;
   }, [config.appVersion]);
   const userContextKey = userContext ? JSON.stringify(userContext) : "";
-  const userContextStable = React18.useMemo(
+  const userContextStable = React19.useMemo(
     () => userContextKey ? JSON.parse(userContextKey) : void 0,
     [userContextKey]
   );
-  const missingJoinKey = typeof (userContextStable == null ? void 0 : userContextStable.device_key) !== "string" || !userContextStable.device_key.trim();
+  const hostJoinIdentity = React19.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] = React18.useState(void 0);
-  React18.useEffect(() => {
-    if (!wantsAutoJoin || autoJoinValue !== void 0 || !storage) return;
+  const [autoJoinOutcome, setAutoJoinOutcome] = React19.useState(void 0);
+  React19.useEffect(() => {
+    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;
-  const effectiveUserContext = React18.useMemo(
+  }, [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 = React19.useMemo(
     () => injectedJoinKey ? { ...userContextStable, ...activationJoinContext(injectedJoinKey) } : userContextStable,
     [userContextStable, injectedJoinKey]
   );
+  const frozenWireContextRef = React19.useRef(null);
+  if (!autoJoinPending && frozenWireContextRef.current === null) {
+    frozenWireContextRef.current = effectiveUserContext ? JSON.stringify(effectiveUserContext) : "";
+  }
+  const startupUserContextKey = (_b = frozenWireContextRef.current) != null ? _b : "";
+  const startupUserContext = React19.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.";
-  React18.useEffect(() => {
+  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.";
+  React19.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);
+  React19.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());
-  React18.useEffect(() => {
+  React19.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]);
-  const clientContext = React18.useMemo(
+  const clientContext = React19.useMemo(
     () => ({ device, userContext: effectiveUserContext, userId: boundUserId }),
     [device, effectiveUserContext, boundUserId]
   );
-  const [session, setSession] = React18.useState(
+  const [session, setSession] = React19.useState(
     () => storage ? null : { id: makeSessionId(), resumed: false }
   );
   const storageKey = persistKey != null ? persistKey : sessionStorageKey(config.appId);
-  React18.useEffect(() => {
+  const permissionsKey = permissionStorageKey(config.appId);
+  React19.useEffect(() => {
     if (!storage || session) return;
     let cancelled = false;
     void loadPersistedSession(storage, storageKey, sessionTtlMs).then((loaded) => {
@@ -3712,20 +4299,51 @@ var WireOnboarding = ({
       cancelled = true;
     };
   }, [storage, storageKey, sessionTtlMs, session]);
-  const handleComplete = React18.useCallback(
+  const handleComplete = React19.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] = React19.useState(void 0);
+  React19.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 = React19.useRef(void 0);
+  settledPermissionsRef.current = settledPermissions;
+  const handlePermissionSettled = React19.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 = React18.useRef(boundUserId);
+  const startupUserIdRef = React19.useRef(boundUserId);
   const metadataKey = config.metadata ? JSON.stringify(config.metadata) : "";
-  const metadataStable = React18.useMemo(() => metadataKey ? JSON.parse(metadataKey) : void 0, [metadataKey]);
+  const metadataStable = React19.useMemo(() => metadataKey ? JSON.parse(metadataKey) : void 0, [metadataKey]);
   const componentNamesKey = (components != null ? components : onboardingComponents).map((c) => c.name).join(",");
-  const componentsStable = React18.useMemo(() => components != null ? components : onboardingComponents, [componentNamesKey]);
-  const llm = React18.useMemo(() => {
+  const componentsStable = React19.useMemo(() => components != null ? components : onboardingComponents, [componentNamesKey]);
+  const llm = React19.useMemo(() => {
     const baseUrl = config.serverUrl.replace(/\/$/, "");
     return {
       provider: "a2a",
@@ -3743,7 +4361,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
@@ -3752,14 +4372,14 @@ var WireOnboarding = ({
       },
       timeoutMs: 6e4
     };
-  }, [config.serverUrl, config.appId, config.apiKey, metadataStable, sessionId, componentsStable, device, effectiveUserContext]);
-  const reportTarget = React18.useMemo(
+  }, [config.serverUrl, config.appId, config.apiKey, metadataStable, sessionId, componentsStable, device, startupUserContext]);
+  const reportTarget = React19.useMemo(
     () => ({ serverUrl: config.serverUrl, apiKey: config.apiKey }),
     [config.serverUrl, config.apiKey]
   );
-  const identifiedRef = React18.useRef(void 0);
-  const identifySeededRef = React18.useRef(false);
-  React18.useEffect(() => {
+  const identifiedRef = React19.useRef(void 0);
+  const identifySeededRef = React19.useRef(false);
+  React19.useEffect(() => {
     if (!session || !sessionId) return;
     if (!identifySeededRef.current) {
       identifySeededRef.current = true;
@@ -3778,8 +4398,8 @@ var WireOnboarding = ({
     return /* @__PURE__ */ jsxRuntime.jsx(OnboardingThemeProvider, { theme, children: /* @__PURE__ */ jsxRuntime.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
       }
     ) });
   }
@@ -3800,7 +4420,11 @@ var WireOnboarding = ({
       reportTarget,
       sessionId,
       resumed: session.resumed,
-      clientContext
+      clientContext,
+      permissionScreens,
+      settledPermissions,
+      permissionsPending: wantsPermissionMemory && settledPermissions === void 0,
+      onPermissionSettled: handlePermissionSettled
     }
   ) }) }) }) });
 };
@@ -3814,16 +4438,16 @@ function DemoOnboarding({
   onComplete,
   renderTrigger
 }) {
-  const [open, setOpen] = React18.useState(false);
-  const [runId, setRunId] = React18.useState(0);
-  const t = React18.useMemo(() => mergeTheme(theme != null ? theme : {}), [theme]);
-  const styles18 = React18.useMemo(() => makeStyles5(t), [t]);
-  const openDemo = React18.useCallback(() => {
+  const [open, setOpen] = React19.useState(false);
+  const [runId, setRunId] = React19.useState(0);
+  const t = React19.useMemo(() => mergeTheme(theme != null ? theme : {}), [theme]);
+  const styles18 = React19.useMemo(() => makeStyles5(t), [t]);
+  const openDemo = React19.useCallback(() => {
     setRunId((n) => n + 1);
     setOpen(true);
   }, []);
-  const close = React18.useCallback(() => setOpen(false), []);
-  const finish = React18.useCallback(
+  const close = React19.useCallback(() => setOpen(false), []);
+  const finish = React19.useCallback(
     (result) => {
       onComplete == null ? void 0 : onComplete(result);
       setOpen(false);
@@ -3929,20 +4553,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__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles16.center, { gap: t.spacing.sm, padding: t.spacing.lg }], children: [
-    /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [headingStyle(t.fonts), { color: t.colors.success, textAlign: "center" }], children: title }),
-    /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted, textAlign: "center" }], children: message })
-  ] });
-};
-var DoneBlock = React18__default.default.memo(_DoneBlock);
-var styles16 = reactNative.StyleSheet.create({
-  center: { flex: 1, alignItems: "center", justifyContent: "center" }
-});
 
 // src/motion/centeredModalMotion.ts
 var CENTERED_MODAL_ANIM = {
@@ -3955,13 +4565,13 @@ var CENTERED_MODAL_ANIM = {
   /** Peak dim of the backdrop at progress 1. */
   backdropOpacity: 0.55
 };
-var _CenteredModal = React18.forwardRef(
+var _CenteredModal = React19.forwardRef(
   ({ theme, dismissible = true, onDismiss, children }, ref) => {
-    const progress = React18.useRef(new reactNative.Animated.Value(0)).current;
-    const [open, setOpen] = React18.useState(true);
-    const closingRef = React18.useRef(false);
+    const progress = React19.useRef(new reactNative.Animated.Value(0)).current;
+    const [open, setOpen] = React19.useState(true);
+    const closingRef = React19.useRef(false);
     const reduced = useReducedMotion();
-    React18.useEffect(() => {
+    React19.useEffect(() => {
       const anim = reduced ? reactNative.Animated.timing(progress, {
         toValue: 1,
         duration: REDUCED_FADE_MS,
@@ -3975,7 +4585,7 @@ var _CenteredModal = React18.forwardRef(
       anim.start();
       return () => anim.stop();
     }, [progress, reduced]);
-    const close = React18.useCallback(() => {
+    const close = React19.useCallback(() => {
       if (closingRef.current) return;
       closingRef.current = true;
       reactNative.Animated.timing(progress, {
@@ -3988,15 +4598,15 @@ var _CenteredModal = React18.forwardRef(
         onDismiss();
       });
     }, [progress, onDismiss, reduced]);
-    React18.useImperativeHandle(ref, () => ({ close }), [close]);
-    React18.useEffect(() => {
+    React19.useImperativeHandle(ref, () => ({ close }), [close]);
+    React19.useEffect(() => {
       const sub = reactNative.BackHandler.addEventListener("hardwareBackPress", () => {
         if (dismissible) close();
         return true;
       });
       return () => sub.remove();
     }, [dismissible, close]);
-    const onBackdrop = React18.useCallback(() => {
+    const onBackdrop = React19.useCallback(() => {
       if (dismissible) close();
     }, [dismissible, close]);
     const backdropOpacity = progress.interpolate({
@@ -4058,7 +4668,7 @@ var _CenteredModal = React18.forwardRef(
   }
 );
 _CenteredModal.displayName = "CenteredModal";
-var CenteredModal = React18__default.default.memo(_CenteredModal);
+var CenteredModal = React19__default.default.memo(_CenteredModal);
 var styles17 = reactNative.StyleSheet.create({
   fill: { flex: 1 },
   backdrop: { position: "absolute", top: 0, left: 0, right: 0, bottom: 0, backgroundColor: "#000" },
@@ -4188,16 +4798,16 @@ var fetchWireFeatures = async (config) => {
   }
 };
 var useStableValue = (value, isEqual) => {
-  const ref = React18.useRef(value);
+  const ref = React19.useRef(value);
   if (!isEqual(ref.current, value)) ref.current = value;
   return ref.current;
 };
 var sameFetchKey = (a, b) => (a == null ? void 0 : a.serverUrl) === (b == null ? void 0 : b.serverUrl) && (a == null ? void 0 : a.apiKey) === (b == null ? void 0 : b.apiKey) && (a == null ? void 0 : a.appId) === (b == null ? void 0 : b.appId);
 var useWireFeatures = (config) => {
   const stableConfig = useStableValue(config, sameFetchKey);
-  const [flags, setFlags] = React18.useState(defaultWireFeatures);
+  const [flags, setFlags] = React19.useState(defaultWireFeatures);
   const canFetch = !!(stableConfig == null ? void 0 : stableConfig.serverUrl) && !!(stableConfig == null ? void 0 : stableConfig.apiKey);
-  React18.useEffect(() => {
+  React19.useEffect(() => {
     if (!canFetch) {
       setFlags((prev) => featuresEqual(prev, defaultWireFeatures) ? prev : defaultWireFeatures);
       return;
@@ -4216,7 +4826,7 @@ var useWireFeatures = (config) => {
 var CONTEXT_SYMBOL = /* @__PURE__ */ Symbol.for("wireai.features.context");
 var globalObj = global;
 if (!globalObj[CONTEXT_SYMBOL]) {
-  globalObj[CONTEXT_SYMBOL] = React18.createContext(null);
+  globalObj[CONTEXT_SYMBOL] = React19.createContext(null);
 }
 var WireFeaturesContext = globalObj[CONTEXT_SYMBOL];
 var WireFeaturesProvider = ({
@@ -4226,11 +4836,11 @@ var WireFeaturesProvider = ({
 }) => {
   const fetched = useWireFeatures(flags ? void 0 : config);
   const value = flags != null ? flags : fetched;
-  const stable = React18.useMemo(() => value, [value]);
+  const stable = React19.useMemo(() => value, [value]);
   return /* @__PURE__ */ jsxRuntime.jsx(WireFeaturesContext.Provider, { value: stable, children });
 };
 WireFeaturesProvider.displayName = "WireFeaturesProvider";
-var useWireFeaturesContext = () => React18.useContext(WireFeaturesContext);
+var useWireFeaturesContext = () => React19.useContext(WireFeaturesContext);
 var useResolvedFeatures = (options) => {
   var _a2, _b, _c;
   const ctx = useWireFeaturesContext();
@@ -4245,11 +4855,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;
@@ -4260,7 +4865,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;
@@ -4315,6 +4920,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;
@@ -4368,15 +4978,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).
@@ -4422,15 +5034,15 @@ var createWireActivation = (config) => {
     getRevalidationVersion: getActivationRevalidationVersion
   };
 };
-var useActivationRevalidation = () => React18.useSyncExternalStore(
+var useActivationRevalidation = () => React19.useSyncExternalStore(
   subscribeActivationRevalidation,
   getActivationRevalidationVersion,
   getActivationRevalidationVersion
 );
 var useWireActivation = (config) => {
   var _a2;
-  const ref = React18.useRef(void 0);
-  const prevKeys = React18.useRef("");
+  const ref = React19.useRef(void 0);
+  const prevKeys = React19.useRef("");
   const currentKeys = [
     config.serverUrl,
     config.apiKey,
@@ -4655,9 +5267,9 @@ var reportSessionStart = (opts) => {
 };
 var BACKGROUND_SESSION_MS = 30 * 60 * 1e3;
 var useSessionStart = (config, options = {}) => {
-  const latest = React18.useRef({ config, options });
+  const latest = React19.useRef({ config, options });
   latest.current = { config, options };
-  React18.useEffect(() => {
+  React19.useEffect(() => {
     const resolveDeviceKey = (cfg, opts) => {
       const host = typeof opts.deviceKey === "string" && opts.deviceKey.trim() ? opts.deviceKey : void 0;
       if (host) return host;
@@ -4810,6 +5422,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) => {
@@ -4841,7 +5477,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;
@@ -5006,10 +5643,10 @@ var createEventQueue = (options) => {
 
 // src/session-analytics/useLifecycleEvents.ts
 var useLifecycleEvents = (config, options = {}) => {
-  const latest = React18.useRef({ config, options });
+  const latest = React19.useRef({ config, options });
   latest.current = { config, options };
-  const queueRef = React18.useRef(void 0);
-  React18.useEffect(() => {
+  const queueRef = React19.useRef(void 0);
+  React19.useEffect(() => {
     const resolveSink = () => {
       var _a2, _b;
       const { config: cfg, options: opts } = latest.current;
@@ -5031,7 +5668,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 });
@@ -5118,24 +5761,29 @@ exports.CenteredModal = CenteredModal;
 exports.ChipSelectCard = ChipSelectCard;
 exports.CompletionView = CompletionView;
 exports.DEFAULT_FEATURES_TTL_MS = DEFAULT_FEATURES_TTL_MS;
+exports.DEFAULT_PERMISSION_COPY = DEFAULT_PERMISSION_COPY;
+exports.DEFAULT_PERMISSION_PLACEMENT = DEFAULT_PERMISSION_PLACEMENT;
 exports.DEFAULT_SESSION_TTL_MS = DEFAULT_SESSION_TTL_MS;
 exports.DemoOnboarding = DemoOnboarding;
-exports.DoneBlock = DoneBlock;
 exports.EXTRA_KEY_PREFIX = EXTRA_KEY_PREFIX;
 exports.ErrorBlock = ErrorBlock;
 exports.FIRST_OPEN_EVENT = FIRST_OPEN_EVENT;
+exports.GENERIC_PERMISSION_COPY = GENERIC_PERMISSION_COPY;
 exports.IconRegistryProvider = IconRegistryProvider;
 exports.IllustrationProvider = IllustrationProvider;
 exports.InterstitialCard = InterstitialCard;
 exports.LoadingBlock = LoadingBlock;
 exports.LoadingScreen = LoadingScreen;
+exports.NOTIFICATIONS_PERMISSION_COPY = NOTIFICATIONS_PERMISSION_COPY;
 exports.NumberStepperCard = NumberStepperCard;
 exports.OnboardingButton = Button;
 exports.OnboardingFlow = OnboardingFlow;
 exports.OnboardingScaffold = OnboardingScaffold;
 exports.OnboardingThemeProvider = OnboardingThemeProvider;
+exports.PERMISSION_CARD_NAME = PERMISSION_CARD_NAME;
 exports.PLAN_TIER_CONTEXT_KEY = PLAN_TIER_CONTEXT_KEY;
-exports.RESERVED_USER_CONTEXT_KEYS = RESERVED_USER_CONTEXT_KEYS;
+exports.PermissionCard = PermissionCard;
+exports.PermissionCardView = PermissionCardView;
 exports.SESSION_STARTED_EVENT = SESSION_STARTED_EVENT;
 exports.SelectionCard = SelectionCard;
 exports.StatusCard = StatusCard;
@@ -5146,6 +5794,7 @@ exports.WIRE_ENV_VARS = WIRE_ENV_VARS;
 exports.WIRE_ICON_GLYPHS = WIRE_ICON_GLYPHS;
 exports.WIRE_ICON_NAMES = WIRE_ICON_NAMES;
 exports.WIRE_ONBOARDING_EVENTS = WIRE_ONBOARDING_EVENTS;
+exports.WIRE_PERMISSION_EVENTS = WIRE_PERMISSION_EVENTS;
 exports.WIRE_PURCHASE_EVENTS = WIRE_PURCHASE_EVENTS;
 exports.WireFeaturesProvider = WireFeaturesProvider;
 exports.WireIcon = WireIcon;
@@ -5157,6 +5806,7 @@ exports.attributionMetadata = attributionMetadata;
 exports.bumpActivationRevalidation = bumpActivationRevalidation;
 exports.clearPersistedSession = clearPersistedSession;
 exports.clearPiiFromContext = clearPiiFromContext;
+exports.clearSettledPermissions = clearSettledPermissions;
 exports.clearUserContext = clearUserContext;
 exports.collectDeviceContext = collectDeviceContext;
 exports.createRevenueCatBridge = createRevenueCatBridge;
@@ -5179,13 +5829,17 @@ exports.firstOpenStorageKey = firstOpenStorageKey;
 exports.getActivationRevalidationVersion = getActivationRevalidationVersion;
 exports.getCurrentSessionId = getCurrentSessionId;
 exports.hashEmailFnv1a = hashEmailFnv1a;
+exports.hostIdentity = hostIdentity;
 exports.hydrateAutoDeviceKey = hydrateAutoDeviceKey;
+exports.hydrateDeviceIdentity = hydrateDeviceIdentity;
 exports.identifyOnboarding = identifyOnboarding;
 exports.isFeaturesFresh = isFeaturesFresh;
 exports.isOnboardingEnabled = isOnboardingEnabled;
+exports.isPermissionDue = isPermissionDue;
 exports.isUserCancelled = isUserCancelled;
 exports.isWireScalar = isWireScalar;
 exports.loadPersistedSession = loadPersistedSession;
+exports.loadSettledPermissions = loadSettledPermissions;
 exports.looksLikeEmail = looksLikeEmail;
 exports.lookupIconGlyph = lookupIconGlyph;
 exports.makeSessionId = makeSessionId;
@@ -5193,11 +5847,18 @@ exports.mergeTheme = mergeTheme;
 exports.mintDeviceId = mintDeviceId;
 exports.motionSpec = motionSpec_exports;
 exports.namespaceExtra = namespaceExtra;
+exports.normalizeAfterCard = normalizeAfterCard;
+exports.normalizePermissionStatus = normalizePermissionStatus;
 exports.onboardingComponents = onboardingComponents;
 exports.parseWireFeatures = parseWireFeatures;
 exports.peekPersistedSession = peekPersistedSession;
+exports.permissionEventName = permissionEventName;
+exports.permissionEventProps = permissionEventProps;
+exports.permissionScreenId = permissionScreenId;
+exports.permissionStorageKey = permissionStorageKey;
 exports.readCachedFeatures = readCachedFeatures;
 exports.readProgress = readProgress;
+exports.readSettledPermissions = readSettledPermissions;
 exports.reportClientEvent = reportClientEvent;
 exports.reportClientEventAwait = reportClientEventAwait;
 exports.reportClientEvents = reportClientEvents;
@@ -5208,12 +5869,17 @@ exports.resetActivationRevalidation = resetActivationRevalidation;
 exports.resetAutoDeviceKeys = resetAutoDeviceKeys;
 exports.resetCurrentSessionId = resetCurrentSessionId;
 exports.resetFirstOpenLatch = resetFirstOpenLatch;
+exports.resetIdentityProvenance = resetIdentityProvenance;
 exports.resetSessionStartGuard = resetSessionStartGuard;
 exports.resolveAutoDeviceKey = resolveAutoDeviceKey;
+exports.resolveIdentity = resolveIdentity;
+exports.resolvePermissionCopy = resolvePermissionCopy;
 exports.resolvePlanTier = resolvePlanTier;
 exports.resolveUserContext = resolveUserContext;
 exports.sanitizeUserId = sanitizeUserId;
 exports.savePersistedSession = savePersistedSession;
+exports.saveSettledPermissions = saveSettledPermissions;
+exports.selectDuePermissionScreen = selectDuePermissionScreen;
 exports.sessionStorageKey = sessionStorageKey;
 exports.setCurrentSessionId = setCurrentSessionId;
 exports.subscribeActivationRevalidation = subscribeActivationRevalidation;