@appilots/sdk 0.13.0 → 0.14.0

package/dist/index.mjs

@@ -1,11 +1,11 @@
-export { AppilotsNavigationContainer } from './chunk-L3SY3Q4K.mjs';
-import { subscribeSpotlight, getSpotlightTarget, AppilotsI18nProvider, useAppilotsI18n, useAppilotsChat, useAppilotsActions, setSpotlightMode, shouldShowSuggestedPrompts, useSuggestedPrompts } from './chunk-UYBKXULM.mjs';
-export { AppilotsI18nProvider, REVEAL_MARGIN, SPOTLIGHT_TTL_MS, appilotsSelfCheck, captureSnapshot, detectDeviceLocale, executeAction, getSpotlightMode, getSpotlightTarget, offsetToReveal, resolveLocale, revealTarget, setSpotlightMode, setSpotlightTarget, subscribeSpotlight, useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsI18n, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts } from './chunk-UYBKXULM.mjs';
-import { defaultLightTheme, describeAction, isRectOnScreen, mergeThemeTokens, resolveBaseTheme, useAppilotsContext, AppilotsErrorBoundary, subscribeGeometryHost, geometryAvailability, isGeometryResolved, needsWideChatLayout, componentRegistry, appilotsDebugWarn, enhancePlainAssistantContent, looksLikeMarkdown, parseMarkdownBlocks, parseInlineMarkdown, getFiberRoot, shouldSkipSubtree, isModalFiber } from './chunk-HRWBK35Y.mjs';
-export { AppilotsClient, AppilotsProvider, AppilotsRegistryProvider, RateLimitedError, SDK_VERSION, _patchJsxRuntimes, clearAppilotsDebugTraces, componentRegistry, createComponentRegistry, createElementRegistry, createListRegistry, defaultDarkTheme, defaultLightTheme, describeAction, elementRegistry, enableAppilotsAutoTracking, getAppilotsDebugTraces, getAutoTrackingState, getGlobalConfig, getIntrospectionDiagnostics, humanizeError, initAppilots, isAutoTrackingEnabled, listRegistry, mergeThemeTokens, recordAppilotsDebugTrace, registerScreen, setCurrentScreen, subscribeAppilotsDebugTraces, useAppilotsContext, useResolvedRegistry } from './chunk-HRWBK35Y.mjs';
+export { AppilotsNavigationContainer } from './chunk-N66DUP54.mjs';
+import { subscribeSpotlight, getSpotlightTarget, AppilotsI18nProvider, useAppilotsI18n, useAppilotsChat, useAppilotsActions, setSpotlightMode, shouldShowSuggestedPrompts, useSuggestedPrompts, subscribeSpotlightAnnouncement } from './chunk-6JWU3NBT.mjs';
+export { AppilotsI18nProvider, REVEAL_MARGIN, SPOTLIGHT_TTL_MS, appilotsSelfCheck, captureSnapshot, detectDeviceLocale, executeAction, getSpotlightMode, getSpotlightTarget, offsetToReveal, resolveLocale, revealTarget, setSpotlightMode, setSpotlightTarget, subscribeSpotlight, useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsI18n, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts } from './chunk-6JWU3NBT.mjs';
+import { defaultLightTheme, describeAction, confirmExpiresAt, isRectOnScreen, mergeThemeTokens, resolveBaseTheme, useAppilotsContext, AppilotsErrorBoundary, isSpeechHost, subscribeGeometryHost, geometryAvailability, isGeometryResolved, needsWideChatLayout, componentRegistry, startStillWorkingTimer, appilotsDebugWarn, enhancePlainAssistantContent, looksLikeMarkdown, parseMarkdownBlocks, parseInlineMarkdown, getFiberRoot, shouldSkipSubtree, isModalFiber } from './chunk-AKAMWKO6.mjs';
+export { AppilotsClient, AppilotsProvider, AppilotsRegistryProvider, RateLimitedError, SDK_VERSION, _patchJsxRuntimes, clearAppilotsDebugTraces, componentRegistry, createComponentRegistry, createElementRegistry, createListRegistry, defaultDarkTheme, defaultLightTheme, describeAction, elementRegistry, enableAppilotsAutoTracking, getAppilotsDebugTraces, getAutoTrackingState, getGlobalConfig, getIntrospectionDiagnostics, humanizeError, initAppilots, isAutoTrackingEnabled, isSpeechHost, listRegistry, mergeThemeTokens, recordAppilotsDebugTrace, registerScreen, setCurrentScreen, subscribeAppilotsDebugTraces, useAppilotsContext, useResolvedRegistry } from './chunk-AKAMWKO6.mjs';
 import * as React8 from 'react';
-import React8__default, { createContext, useRef, useEffect, useCallback, useSyncExternalStore, useMemo, useContext, useState } from 'react';
-import { StyleSheet, Dimensions, Platform, View, Animated, Text, TouchableOpacity, ActivityIndicator, useColorScheme, FlatList, Image, TextInput, KeyboardAvoidingView, Modal, Linking } from 'react-native';
+import React8__default, { createContext, useRef, useEffect, useState, useCallback, useSyncExternalStore, useMemo, useContext } from 'react';
+import { StyleSheet, Dimensions, Platform, View, Animated, Text, TouchableOpacity, AccessibilityInfo, ActivityIndicator, useColorScheme, useWindowDimensions, FlatList, Image, TextInput, KeyboardAvoidingView, Modal, Linking } from 'react-native';
 import { SafeAreaInsetsContext } from 'react-native-safe-area-context';
 import Svg, { Path } from 'react-native-svg';
 
@@ -116,13 +116,15 @@ var PT_BR_CONFIRM_FALLBACK = {
   confirmDestructiveApprove: "Sim, executar",
   confirmApprove: "Confirmar",
   confirmCancel: "Cancelar",
-  confirmThisAction: "esta a\xE7\xE3o"
+  confirmThisAction: "esta a\xE7\xE3o",
+  confirmExpired: "Esta confirma\xE7\xE3o expirou. Pe\xE7a de novo ao assistente para continuar."
 };
 function deriveConfirmCardContent(action, palette = DEFAULT_BREADCRUMB_PALETTE, strings) {
   const payload = action.payload ?? {};
   const isDestructive = isDestructiveAction(action);
   const copy = { ...PT_BR_CONFIRM_FALLBACK, ...strings ?? {} };
-  const actionName = typeof payload.actionDescription === "string" && payload.actionDescription || copy.confirmThisAction;
+  const described = typeof payload.actionDescription === "string" ? payload.actionDescription : "";
+  const actionName = described || copy.confirmThisAction;
   const message = typeof payload.message === "string" && payload.message || copy.confirmMessage.replace("{action}", actionName);
   const title = typeof payload.title === "string" && payload.title || (isDestructive ? copy.confirmDestructiveTitle : copy.confirmTitle);
   const confirmLabel = typeof payload.confirmLabel === "string" && payload.confirmLabel || (isDestructive ? copy.confirmDestructiveApprove : copy.confirmApprove);
@@ -133,6 +135,10 @@ function deriveConfirmCardContent(action, palette = DEFAULT_BREADCRUMB_PALETTE,
     message,
     confirmLabel,
     cancelLabel,
+    // A bare "Confirm" heard out of context says nothing about what it does.
+    confirmA11yLabel: described ? `${confirmLabel}: ${described}` : confirmLabel,
+    cancelA11yLabel: described ? `${cancelLabel}: ${described}` : cancelLabel,
+    expiredMessage: copy.confirmExpired ?? PT_BR_CONFIRM_FALLBACK.confirmExpired,
     glyph: isDestructive ? "\u26A0" : "?",
     actionColor: isDestructive ? palette.error : palette.primary,
     cardBackground: palette.surface,
@@ -142,6 +148,79 @@ function deriveConfirmCardContent(action, palette = DEFAULT_BREADCRUMB_PALETTE,
     cancelTextColor: palette.textSecondary
   };
 }
+var TARGET_ANNOUNCEMENT = {
+  "pt-BR": {
+    press: "Tocando em {label}",
+    toggle: "Alternando {label}",
+    focus: "Selecionando {label}",
+    fill: "Preenchendo {label}"
+  },
+  en: {
+    press: "Tapping {label}",
+    toggle: "Toggling {label}",
+    focus: "Selecting {label}",
+    fill: "Filling in {label}"
+  },
+  es: {
+    press: "Tocando {label}",
+    toggle: "Cambiando {label}",
+    focus: "Seleccionando {label}",
+    fill: "Rellenando {label}"
+  },
+  fr: {
+    press: "Appui sur {label}",
+    toggle: "Bascule de {label}",
+    focus: "S\xE9lection de {label}",
+    fill: "Saisie de {label}"
+  }
+};
+function targetAnnouncement(verb, label, locale = "pt-BR") {
+  return (TARGET_ANNOUNCEMENT[locale] ?? TARGET_ANNOUNCEMENT["pt-BR"])[verb].replace(
+    "{label}",
+    label
+  );
+}
+function executorNamesTarget(action) {
+  if (action.type === "form_fill") return true;
+  if (action.type !== "ui_interaction") return false;
+  const interaction = action.payload?.action;
+  return !["scroll", "scroll_to"].includes(String(interaction ?? "press"));
+}
+function actionAnnouncement(action, locale, named) {
+  const { state, label } = describeAction(action, locale);
+  if (state === "failed") return label;
+  const executorNames = executorNamesTarget(action);
+  if (state === "running") return executorNames ? null : label;
+  if (state === "success") return executorNames && !named ? label : null;
+  return null;
+}
+var reduceMotion = false;
+var listeners = /* @__PURE__ */ new Set();
+var subscription;
+function set(value) {
+  if (value === reduceMotion) return;
+  reduceMotion = value;
+  for (const listener of listeners) listener();
+}
+function subscribe(onChange) {
+  listeners.add(onChange);
+  if (!subscription) {
+    subscription = AccessibilityInfo.addEventListener("reduceMotionChanged", set);
+    AccessibilityInfo.isReduceMotionEnabled().then(set, () => {
+    });
+  }
+  return () => {
+    listeners.delete(onChange);
+    if (listeners.size === 0) {
+      subscription?.remove();
+      subscription = void 0;
+    }
+  };
+}
+var get = () => reduceMotion;
+function useReduceMotion() {
+  return useSyncExternalStore(subscribe, get, get);
+}
 
 // src/components/ActionBreadcrumb.tsx
 function ActionBreadcrumb({
@@ -154,7 +233,8 @@ function ActionBreadcrumb({
   locale,
   requireApprovalFor,
   onApprove,
-  onReject
+  onReject,
+  onConfirmCardGone
 }) {
   if (actions.length === 0) return null;
   const resolvedPalette = {
@@ -176,7 +256,8 @@ function ActionBreadcrumb({
       locale,
       needsApproval: requireApprovalFor?.(action) ?? false,
       onApprove,
-      onReject
+      onReject,
+      onConfirmCardGone
     }
   )));
 }
@@ -191,7 +272,8 @@ function BreadcrumbRow(props) {
         fontFamily: props.fontFamily,
         confirmStrings: props.confirmStrings,
         onApprove: props.onApprove,
-        onReject: props.onReject
+        onReject: props.onReject,
+        onGone: props.onConfirmCardGone
       }
     );
   }
@@ -213,40 +295,39 @@ function RegularBreadcrumbRow({
   const fade = useRef(new Animated.Value(0)).current;
   const pulse = useRef(new Animated.Value(1)).current;
   const lastState = useRef(state);
+  const reduceMotion2 = useReduceMotion();
   useEffect(() => {
+    if (reduceMotion2) {
+      fade.setValue(1);
+      return;
+    }
     Animated.timing(fade, {
       toValue: 1,
       duration: 180,
       useNativeDriver: true
     }).start();
-  }, [fade]);
+  }, [fade, reduceMotion2]);
   useEffect(() => {
     if (lastState.current === state) return;
     lastState.current = state;
+    if (reduceMotion2) return;
     pulse.setValue(0.4);
     Animated.timing(pulse, {
       toValue: 1,
       duration: 220,
       useNativeDriver: true
     }).start();
-  }, [state, pulse]);
+  }, [state, pulse, reduceMotion2]);
   const isDestructive = isDestructiveAction(action);
-  return /* @__PURE__ */ React8__default.createElement(Animated.View, { style: [styles.row, { opacity: fade }] }, /* @__PURE__ */ React8__default.createElement(
-    Animated.View,
+  return /* @__PURE__ */ React8__default.createElement(Animated.View, { style: [styles.row, { opacity: fade }] }, /* @__PURE__ */ React8__default.createElement(Animated.View, { style: [styles.labelGroup, { opacity: pulse }] }, /* @__PURE__ */ React8__default.createElement(StateIcon, { state, tone, primaryColor }), /* @__PURE__ */ React8__default.createElement(
+    Text,
     {
-      style: { opacity: pulse, flexDirection: "row", alignItems: "flex-start", flex: 1 }
+      style: [styles.label, { color: state === "failed" ? tone.color : textColor, fontFamily }],
+      accessibilityLabel: `${state}: ${label}`
     },
-    /* @__PURE__ */ React8__default.createElement(StateIcon, { state, tone, primaryColor }),
-    /* @__PURE__ */ React8__default.createElement(
-      Text,
-      {
-        style: [styles.label, { color: state === "failed" ? tone.color : textColor, fontFamily }],
-        accessibilityLabel: `${state}: ${label}`
-      },
-      label,
-      isDestructive && /* @__PURE__ */ React8__default.createElement(Text, { style: [styles.destructiveTag, { color: palette.error }] }, " \u26A0 destrutiva")
-    )
-  ), needsApproval && action.status === "pending" && onApprove && onReject && /* @__PURE__ */ React8__default.createElement(View, { style: styles.approvalButtons }, /* @__PURE__ */ React8__default.createElement(
+    label,
+    isDestructive && /* @__PURE__ */ React8__default.createElement(Text, { style: [styles.destructiveTag, { color: palette.error }] }, " \u26A0 destrutiva")
+  )), needsApproval && action.status === "pending" && onApprove && onReject && /* @__PURE__ */ React8__default.createElement(View, { style: styles.approvalButtons }, /* @__PURE__ */ React8__default.createElement(
     TouchableOpacity,
     {
       onPress: () => onReject(action.id),
@@ -268,13 +349,15 @@ function RegularBreadcrumbRow({
     /* @__PURE__ */ React8__default.createElement(Text, { style: styles.approveBtnText }, "Aprovar")
   )));
 }
+var MIN_TOUCH_TARGET = 44;
 function ConfirmCard({
   action,
   palette,
   fontFamily,
   confirmStrings,
   onApprove,
-  onReject
+  onReject,
+  onGone
 }) {
   const {
     isDestructive,
@@ -282,6 +365,9 @@ function ConfirmCard({
     message,
     confirmLabel,
     cancelLabel,
+    confirmA11yLabel,
+    cancelA11yLabel,
+    expiredMessage,
     glyph,
     actionColor,
     cardBackground,
@@ -290,6 +376,23 @@ function ConfirmCard({
     cancelBackground,
     cancelTextColor
   } = deriveConfirmCardContent(action, palette, confirmStrings);
+  const summaryRef = useRef(null);
+  const expiresAt = confirmExpiresAt(action);
+  const [expired, setExpired] = useState(() => expiresAt !== void 0 && expiresAt <= Date.now());
+  const onGoneRef = useRef(onGone);
+  onGoneRef.current = onGone;
+  useEffect(() => {
+    if (summaryRef.current) AccessibilityInfo.sendAccessibilityEvent(summaryRef.current, "focus");
+    return () => onGoneRef.current?.();
+  }, []);
+  useEffect(() => {
+    if (expiresAt === void 0 || expired) return;
+    const timer = setTimeout(() => setExpired(true), expiresAt - Date.now());
+    return () => clearTimeout(timer);
+  }, [expiresAt, expired]);
+  useEffect(() => {
+    if (expired) AccessibilityInfo.announceForAccessibility(expiredMessage);
+  }, [expired, expiredMessage]);
   return /* @__PURE__ */ React8__default.createElement(
     View,
     {
@@ -297,26 +400,46 @@ function ConfirmCard({
         confirmCardStyles.card,
         { backgroundColor: cardBackground, borderColor: cardBorderColor }
       ],
-      testID: "assistant-confirm-card"
+      testID: "assistant-confirm-card",
+      onAccessibilityEscape: () => onReject?.(action.id)
     },
-    /* @__PURE__ */ React8__default.createElement(View, { style: confirmCardStyles.headerRow }, /* @__PURE__ */ React8__default.createElement(Text, { style: [confirmCardStyles.glyph, { color: actionColor }] }, glyph), /* @__PURE__ */ React8__default.createElement(
+    /* @__PURE__ */ React8__default.createElement(
+      View,
+      {
+        ref: summaryRef,
+        accessible: true,
+        accessibilityLabel: `${title}. ${message}`,
+        accessibilityLiveRegion: "polite"
+      },
+      /* @__PURE__ */ React8__default.createElement(View, { style: confirmCardStyles.headerRow }, /* @__PURE__ */ React8__default.createElement(Text, { style: [confirmCardStyles.glyph, { color: actionColor }] }, glyph), /* @__PURE__ */ React8__default.createElement(
+        Text,
+        {
+          style: [
+            confirmCardStyles.title,
+            { color: isDestructive ? palette.error : palette.text, fontFamily }
+          ]
+        },
+        title
+      )),
+      /* @__PURE__ */ React8__default.createElement(Text, { style: [confirmCardStyles.message, { color: messageColor, fontFamily }] }, message)
+    ),
+    expired && /* @__PURE__ */ React8__default.createElement(
       Text,
       {
-        style: [
-          confirmCardStyles.title,
-          { color: isDestructive ? palette.error : palette.text, fontFamily }
-        ]
+        style: [confirmCardStyles.expired, { color: palette.error, fontFamily }],
+        accessibilityLiveRegion: "assertive",
+        testID: "assistant-confirm-expired"
       },
-      title
-    )),
-    /* @__PURE__ */ React8__default.createElement(Text, { style: [confirmCardStyles.message, { color: messageColor, fontFamily }] }, message),
+      expiredMessage
+    ),
     /* @__PURE__ */ React8__default.createElement(View, { style: confirmCardStyles.buttons }, /* @__PURE__ */ React8__default.createElement(
       TouchableOpacity,
       {
         onPress: () => onReject?.(action.id),
         style: [confirmCardStyles.btn, { backgroundColor: cancelBackground }],
         activeOpacity: 0.7,
-        accessibilityLabel: cancelLabel,
+        accessibilityRole: "button",
+        accessibilityLabel: cancelA11yLabel,
         testID: "assistant-confirm-reject"
       },
       /* @__PURE__ */ React8__default.createElement(Text, { style: [confirmCardStyles.cancelText, { color: cancelTextColor, fontFamily }] }, cancelLabel)
@@ -324,13 +447,17 @@ function ConfirmCard({
       TouchableOpacity,
       {
         onPress: () => onApprove?.(action.id),
+        disabled: expired,
         style: [
           confirmCardStyles.btn,
           confirmCardStyles.confirmBtn,
-          { backgroundColor: actionColor }
+          { backgroundColor: actionColor },
+          expired && confirmCardStyles.disabledBtn
         ],
         activeOpacity: 0.7,
-        accessibilityLabel: confirmLabel,
+        accessibilityRole: "button",
+        accessibilityState: { disabled: expired },
+        accessibilityLabel: confirmA11yLabel,
         testID: "assistant-confirm-approve"
       },
       /* @__PURE__ */ React8__default.createElement(Text, { style: [confirmCardStyles.confirmText, { fontFamily }] }, confirmLabel)
@@ -367,18 +494,33 @@ var confirmCardStyles = StyleSheet.create({
     // color set inline — theme-driven (textSecondary).
     marginBottom: 12
   },
+  // Wraps: on one line the two buttons ran off the LEFT edge at iOS AX5
+  // and Cancel was unreachable — on the one card that gates something
+  // irreversible.
   buttons: {
     flexDirection: "row",
+    flexWrap: "wrap",
     gap: 8,
     justifyContent: "flex-end"
   },
   btn: {
+    minHeight: MIN_TOUCH_TARGET,
+    maxWidth: "100%",
+    justifyContent: "center",
     paddingHorizontal: 14,
     paddingVertical: 8,
     borderRadius: 10,
     minWidth: 96,
     alignItems: "center"
   },
+  disabledBtn: {
+    opacity: 0.4
+  },
+  expired: {
+    fontSize: 13,
+    fontWeight: "600",
+    marginBottom: 12
+  },
   cancelText: {
     fontSize: 13,
     fontWeight: "600"
@@ -398,7 +540,11 @@ function StateIcon({
   tone,
   primaryColor
 }) {
-  return /* @__PURE__ */ React8__default.createElement(View, { style: [styles.iconCircle, { backgroundColor: tone.iconBg }] }, state === "running" ? /* @__PURE__ */ React8__default.createElement(ActivityIndicator, { size: "small", color: primaryColor }) : /* @__PURE__ */ React8__default.createElement(Text, { style: [styles.iconGlyph, { color: tone.color }] }, iconGlyphFor(state)));
+  return /* @__PURE__ */ React8__default.createElement(View, { style: [styles.iconCircle, { backgroundColor: tone.iconBg }] }, state === "running" ? /* @__PURE__ */ React8__default.createElement(ActivityIndicator, { size: "small", color: primaryColor }) : (
+    // Decorative, inside a fixed circle: capped so it cannot clip. The
+    // state is also in the row's accessibilityLabel.
+    /* @__PURE__ */ React8__default.createElement(Text, { maxFontSizeMultiplier: 1.3, style: [styles.iconGlyph, { color: tone.color }] }, iconGlyphFor(state))
+  ));
 }
 var styles = StyleSheet.create({
   container: {
@@ -406,12 +552,26 @@ var styles = StyleSheet.create({
     marginBottom: 8,
     paddingVertical: 4
   },
+  // Wraps so Approve/Reject drop below the label at large text sizes. On
+  // one line they squeezed the label to zero width (iOS AX5): the user was
+  // asked to approve an action they could not read.
   row: {
     flexDirection: "row",
+    flexWrap: "wrap",
+    gap: 8,
     alignItems: "center",
     paddingVertical: 6,
     paddingHorizontal: 4
   },
+  labelGroup: {
+    flexDirection: "row",
+    alignItems: "flex-start",
+    flexGrow: 1,
+    flexShrink: 1,
+    flexBasis: 0,
+    // What forces the wrap: the label keeps at least half the row.
+    minWidth: "50%"
+  },
   iconCircle: {
     width: 22,
     height: 22,
@@ -439,9 +599,11 @@ var styles = StyleSheet.create({
   approvalButtons: {
     flexDirection: "row",
     gap: 6,
-    marginLeft: 8
+    marginLeft: "auto"
   },
   btn: {
+    minHeight: MIN_TOUCH_TARGET,
+    justifyContent: "center",
     paddingHorizontal: 10,
     paddingVertical: 5,
     borderRadius: 8
@@ -505,6 +667,7 @@ var APPILOTS_SKIP_PROPS = {
 };
 
 // src/components/AgentPill.tsx
+var PILL_MAX_FONT_SCALE = 1.5;
 function toneFor(state, colors) {
   switch (state) {
     case "success":
@@ -519,6 +682,7 @@ function AgentPill({
   label,
   state,
   onExpand,
+  expandRef,
   onStop,
   position,
   insets,
@@ -527,15 +691,20 @@ function AgentPill({
   strings
 }) {
   const atTop = position === "top-left" || position === "top-right";
+  const reduceMotion2 = useReduceMotion();
   const enter = useRef(new Animated.Value(0)).current;
   useEffect(() => {
+    if (reduceMotion2) {
+      enter.setValue(1);
+      return;
+    }
     Animated.spring(enter, {
       toValue: 1,
       useNativeDriver: true,
       tension: 70,
       friction: 12
     }).start();
-  }, [enter]);
+  }, [enter, reduceMotion2]);
   const translateY = enter.interpolate({
     inputRange: [0, 1],
     outputRange: [atTop ? -80 : 80, 0]
@@ -556,6 +725,7 @@ function AgentPill({
       TouchableOpacity,
       {
         ...APPILOTS_SKIP_PROPS,
+        ref: expandRef,
         testID: "appilots-agent-pill",
         accessibilityRole: "button",
         accessibilityLabel: strings.expandA11y,
@@ -568,7 +738,8 @@ function AgentPill({
         Text,
         {
           testID: "appilots-agent-pill-label",
-          numberOfLines: 1,
+          numberOfLines: 2,
+          maxFontSizeMultiplier: PILL_MAX_FONT_SCALE,
           style: [styles2.label, { color: colors.text, fontFamily }]
         },
         label
@@ -640,15 +811,21 @@ function SpotlightOverlay({
   fontFamily,
   window: win
 }) {
-  const pulse = useRef(new Animated.Value(0)).current;
+  const reduceMotion2 = useReduceMotion();
+  const pulse = useRef(new Animated.Value(reduceMotion2 ? 1 : 0)).current;
   useEffect(() => {
+    if (reduceMotion2) {
+      pulse.stopAnimation();
+      pulse.setValue(1);
+      return;
+    }
     pulse.setValue(0);
     Animated.timing(pulse, {
       toValue: 1,
       duration: 220,
       useNativeDriver: true
     }).start();
-  }, [seq, pulse]);
+  }, [seq, pulse, reduceMotion2]);
   if (!isRectOnScreen(rect, win)) return null;
   const frame = {
     left: rect.x - PADDING,
@@ -739,11 +916,11 @@ var NEVER = () => () => {
 };
 var NULL_TARGET = () => null;
 function useSpotlight(enabled) {
-  const subscribe = useCallback(
+  const subscribe2 = useCallback(
     (onChange) => enabled ? subscribeSpotlight(onChange) : NEVER(),
     [enabled]
   );
-  return useSyncExternalStore(subscribe, enabled ? getSpotlightTarget : NULL_TARGET, NULL_TARGET);
+  return useSyncExternalStore(subscribe2, enabled ? getSpotlightTarget : NULL_TARGET, NULL_TARGET);
 }
 
 // src/components/pillStatus.ts
@@ -763,12 +940,74 @@ function resolvePillStatus(actions, busy, strings) {
   }
   return { label: strings.working, state: "running" };
 }
-
-// src/components/speech.ts
-function isSpeechHost(value) {
-  if (!value || typeof value !== "object") return false;
-  const candidate = value;
-  return typeof candidate.start === "function" && typeof candidate.stop === "function" && typeof candidate.cancel === "function";
+var STREAMING_PREFIX = "streaming_";
+function announce(message) {
+  if (Platform.OS === "ios" && AccessibilityInfo.announceForAccessibilityWithOptions) {
+    AccessibilityInfo.announceForAccessibilityWithOptions(message, { queue: true });
+  } else {
+    AccessibilityInfo.announceForAccessibility(message);
+  }
+}
+var speakable = (content) => content.replace(/[*`#]+/g, "").trim();
+function useChatAnnouncements({
+  messages,
+  actions,
+  awaitingApproval,
+  acting,
+  locale,
+  strings
+}) {
+  const seenMessages = useRef(null);
+  if (!seenMessages.current) seenMessages.current = new Set(messages.map((m) => m.id));
+  const seenActions = useRef(null);
+  if (!seenActions.current) seenActions.current = new Map(actions.map((a) => [a.id, a.status]));
+  const prev = useRef({ awaitingApproval, acting });
+  const namedSinceSettle = useRef(false);
+  const localeRef = useRef(locale);
+  localeRef.current = locale;
+  useEffect(
+    () => subscribeSpotlightAnnouncement((label, verb) => {
+      namedSinceSettle.current = true;
+      announce(targetAnnouncement(verb, label, localeRef.current));
+    }),
+    []
+  );
+  useEffect(() => {
+    const out = [];
+    for (const message of messages) {
+      if (message.role === "user" || message.id.startsWith(STREAMING_PREFIX)) continue;
+      if (seenMessages.current.has(message.id)) continue;
+      seenMessages.current.add(message.id);
+      const text = speakable(message.content);
+      if (text) out.push(text);
+    }
+    for (const action of actions) {
+      if (action.type === "confirm") continue;
+      if (seenActions.current.get(action.id) === action.status) continue;
+      seenActions.current.set(action.id, action.status);
+      const line = actionAnnouncement(action, locale, namedSinceSettle.current);
+      if (action.status === "completed" || action.status === "failed") {
+        namedSinceSettle.current = false;
+      }
+      if (line) out.push(line);
+    }
+    if (awaitingApproval && !prev.current.awaitingApproval) out.push(strings.a11yAwaitingApproval);
+    if (prev.current.acting && !acting) out.push(strings.a11yTurnDone);
+    prev.current = { awaitingApproval, acting };
+    for (const line of out) announce(line);
+  }, [messages, actions, awaitingApproval, acting, locale, strings]);
+}
+function useStillWorking(active, template) {
+  const [seconds, setSeconds] = useState(0);
+  useEffect(() => {
+    setSeconds(0);
+    if (!active) return;
+    return startStillWorkingTimer((elapsed) => {
+      setSeconds(elapsed);
+      AccessibilityInfo.announceForAccessibility(template.replace("{seconds}", String(elapsed)));
+    });
+  }, [active, template]);
+  return seconds;
 }
 function useVoiceInput({
   host,
@@ -841,6 +1080,15 @@ function useVoiceInput({
     });
     return dispose;
   }, [host, state]);
+  useEffect(() => {
+    if (!host?.onEnd) return;
+    if (state !== "listening") return;
+    return host.onEnd((error) => {
+      if (!mounted.current) return;
+      setPartial("");
+      setState(error ? "error" : "idle");
+    });
+  }, [host, state]);
   return { state, partial, start, stop, cancel };
 }
 
@@ -894,7 +1142,7 @@ function resolveExperience(requested, caps) {
       field: "input",
       from: input.join("+"),
       to: input.filter((mode) => mode !== "voice").join("+") || "text",
-      reason: 'input:"voice" needs a SpeechHost passed to <AppilotsChat speech={...} />. The SDK ships no speech engine of its own \u2014 see docs/experience.md.'
+      reason: 'input:"voice" needs a SpeechHost passed to <AppilotsChat speech={...} />. The SDK ships no speech engine of its own \u2014 see https://docs.appilots.com/docs/guides/voice-input.'
     });
     input = input.filter((mode) => mode !== "voice");
   }
@@ -1290,9 +1538,13 @@ function isImageSource(value) {
   return typeof value === "number" || /^https?:\/\//i.test(value.trim());
 }
 var { height: SCREEN_HEIGHT, width: SCREEN_WIDTH } = Dimensions.get("window");
+var A11Y_FOCUS_DELAY_MS = 500;
 var CHAT_HORIZONTAL_PADDING = 16;
 var BUBBLE_HORIZONTAL_PADDING = 14;
 var ASSISTANT_CONTENT_WIDTH = SCREEN_WIDTH - CHAT_HORIZONTAL_PADDING * 2 - BUBBLE_HORIZONTAL_PADDING * 2;
+var MIN_TOUCH_TARGET2 = 44;
+var LARGE_TEXT_FONT_SCALE = 1.6;
+var INPUT_MAX_HEIGHT = 120;
 function AppilotsChat(props) {
   const { degraded } = useAppilotsContext();
   if (degraded) return null;
@@ -1402,6 +1654,7 @@ function AppilotsChatInner({
     return void 0;
   }, [messages]);
   const insets = useSafeAreaInsetsOrDefault();
+  const { fontScale } = useWindowDimensions();
   const [internalVisible, setInternalVisible] = useState(mode === "inline");
   const [inputText, setInputText] = useState("");
   const flatListRef = useRef(null);
@@ -1439,9 +1692,19 @@ function AppilotsChatInner({
     },
     [autoExecute]
   );
-  const awaitingUser = pendingActions.some((action) => requireApproval(action)) || escalation?.status === "pending" || escalation?.status === "active";
+  const awaitingApproval = pendingActions.some((action) => requireApproval(action));
+  const awaitingUser = awaitingApproval || escalation?.status === "pending" || escalation?.status === "active";
   const busy = isLoading || executingActions.length > 0;
+  const stillWorkingSeconds = useStillWorking(busy && !awaitingUser, strings.stillWorking);
   const acting = busy && hasStartedActing;
+  useChatAnnouncements({
+    messages,
+    actions: allActions,
+    awaitingApproval,
+    acting,
+    locale: resolvedLocale,
+    strings
+  });
   const hostModalOpen = useHostModalOpen(
     usesPill(presence) && (busy || wantsSheet || unreadResult)
   );
@@ -1516,6 +1779,19 @@ function AppilotsChatInner({
       friction: 11
     }).start();
   }, [isVisible, slideAnim, mode]);
+  const titleRef = useRef(null);
+  const launcherRef = useRef(null);
+  const pillRef = useRef(null);
+  const wasVisibleRef = useRef(isVisible);
+  useEffect(() => {
+    if (mode === "inline" || wasVisibleRef.current === isVisible) return;
+    wasVisibleRef.current = isVisible;
+    const timer = setTimeout(() => {
+      const target = isVisible ? titleRef.current : pillRef.current ?? launcherRef.current;
+      if (target) AccessibilityInfo.sendAccessibilityEvent(target, "focus");
+    }, A11Y_FOCUS_DELAY_MS);
+    return () => clearTimeout(timer);
+  }, [isVisible, mode]);
   useEffect(() => {
     if (messages.length > 0) {
       setTimeout(() => flatListRef.current?.scrollToEnd({ animated: true }), 100);
@@ -1658,6 +1934,10 @@ function AppilotsChatInner({
     },
     [theme, lastAssistantMessageId, escalation, requestHuman, strings]
   );
+  const composerRef = useRef(null);
+  const returnFocusToComposer = useCallback(() => {
+    if (composerRef.current) AccessibilityInfo.sendAccessibilityEvent(composerRef.current, "focus");
+  }, []);
   const renderBreadcrumb = useCallback(
     (actions) => /* @__PURE__ */ React8__default.createElement(
       ActionBreadcrumb,
@@ -1674,7 +1954,8 @@ function AppilotsChatInner({
           confirmDestructiveApprove: strings.confirmDestructiveApprove,
           confirmApprove: strings.confirmApprove,
           confirmCancel: strings.confirmCancel,
-          confirmThisAction: strings.confirmThisAction
+          confirmThisAction: strings.confirmThisAction,
+          confirmExpired: strings.confirmExpired
         },
         palette: {
           textSecondary: theme.colors.textSecondary,
@@ -1686,7 +1967,8 @@ function AppilotsChatInner({
         },
         requireApprovalFor: requireApproval,
         onApprove: approveAction,
-        onReject: rejectAction
+        onReject: rejectAction,
+        onConfirmCardGone: returnFocusToComposer
       }
     ),
     [
@@ -1703,7 +1985,8 @@ function AppilotsChatInner({
       resolvedLocale,
       requireApproval,
       approveAction,
-      rejectAction
+      rejectAction,
+      returnFocusToComposer
     ]
   );
   const resolvedHeaderTitle = resolvedTitle ?? t("chatTitle");
@@ -1746,6 +2029,7 @@ function AppilotsChatInner({
         mode === "fullscreen" && styles5.chatContainerFullscreen,
         mode === "sidebar" && styles5.chatContainerSidebar,
         mode === "inline" && styles5.chatContainerInline,
+        mode === "bubble" && fontScale >= LARGE_TEXT_FONT_SCALE && styles5.chatContainerFullscreen,
         {
           backgroundColor: theme.colors.background,
           borderTopLeftRadius: theme.radii.lg,
@@ -1756,6 +2040,8 @@ function AppilotsChatInner({
     /* @__PURE__ */ React8__default.createElement(View, { style: [styles5.header, { borderBottomColor: theme.colors.border }] }, /* @__PURE__ */ React8__default.createElement(View, { style: styles5.headerLeft }, renderAvatar(), /* @__PURE__ */ React8__default.createElement(
       Text,
       {
+        ref: titleRef,
+        accessibilityRole: "header",
         style: [
           styles5.headerTitle,
           {
@@ -1882,8 +2168,7 @@ function AppilotsChatInner({
                 color: theme.colors.textSecondary,
                 fontFamily: theme.typography.fontFamily
               }
-            ],
-            numberOfLines: 2
+            ]
           },
           resolvedEmptySubtitle
         ), showSuggestedPrompts && suggestedPrompts.length > 0 && /* @__PURE__ */ React8__default.createElement(View, { style: styles5.chipsContainer, testID: "assistant-suggested-prompts" }, suggestedPrompts.map((prompt) => /* @__PURE__ */ React8__default.createElement(
@@ -1912,8 +2197,7 @@ function AppilotsChatInner({
                   fontFamily: theme.typography.fontFamily,
                   fontSize: theme.typography.fontSizeSm
                 }
-              ],
-              numberOfLines: 1
+              ]
             },
             prompt.text
           )
@@ -1935,16 +2219,17 @@ function AppilotsChatInner({
                 { color: theme.colors.textSecondary, fontFamily: theme.typography.fontFamily }
               ]
             },
-            strings[loadingStatusKey] ?? strings.thinking
+            stillWorkingSeconds ? strings.stillWorking.replace("{seconds}", String(stillWorkingSeconds)) : strings[loadingStatusKey] ?? strings.thinking
           )
         ) : null
       }
     ),
-    mission && !["completed", "cancelled"].includes(mission.status) && /* @__PURE__ */ React8__default.createElement(View, { style: { padding: 12, gap: 8 }, testID: "appilots-mission-controls" }, /* @__PURE__ */ React8__default.createElement(Text, { style: { color: theme.colors.text }, testID: "appilots-mission-progress" }, mission.progressText, mission.status === "paused" ? ` \xB7 ${strings.missionPaused}` : ""), /* @__PURE__ */ React8__default.createElement(View, { style: { flexDirection: "row", gap: 12 } }, mission.status === "running" ? /* @__PURE__ */ React8__default.createElement(
+    mission && !["completed", "cancelled"].includes(mission.status) && /* @__PURE__ */ React8__default.createElement(View, { style: { padding: 12, gap: 8 }, testID: "appilots-mission-controls" }, /* @__PURE__ */ React8__default.createElement(Text, { style: { color: theme.colors.text }, testID: "appilots-mission-progress" }, mission.progressText, mission.status === "paused" ? ` \xB7 ${strings.missionPaused}` : ""), /* @__PURE__ */ React8__default.createElement(View, { style: styles5.missionButtons }, mission.status === "running" ? /* @__PURE__ */ React8__default.createElement(
       TouchableOpacity,
       {
         onPress: () => void pauseMission(),
         testID: "appilots-mission-pause",
+        style: styles5.missionButton,
         accessibilityRole: "button"
       },
       /* @__PURE__ */ React8__default.createElement(Text, { style: { color: theme.colors.text } }, strings.missionPause)
@@ -1954,6 +2239,7 @@ function AppilotsChatInner({
         onPress: () => void resumeMission(),
         disabled: isLoading,
         testID: "appilots-mission-resume",
+        style: styles5.missionButton,
         accessibilityRole: "button"
       },
       /* @__PURE__ */ React8__default.createElement(Text, { style: { color: theme.colors.text } }, strings.missionResume)
@@ -1962,6 +2248,7 @@ function AppilotsChatInner({
       {
         onPress: () => void cancelMission(),
         testID: "appilots-mission-cancel",
+        style: styles5.missionButton,
         accessibilityRole: "button"
       },
       /* @__PURE__ */ React8__default.createElement(Text, { style: { color: theme.colors.text } }, strings.missionCancel)
@@ -1980,6 +2267,7 @@ function AppilotsChatInner({
       /* @__PURE__ */ React8__default.createElement(
         TextInput,
         {
+          ref: composerRef,
           style: [
             styles5.input,
             {
@@ -1988,7 +2276,12 @@ function AppilotsChatInner({
               borderRadius: theme.radii.md,
               fontFamily: theme.typography.fontFamily,
               fontSize: theme.typography.fontSizeBase,
-              lineHeight: theme.typography.fontSizeBase * 1.35
+              lineHeight: theme.typography.fontSizeBase * 1.35,
+              // The 120pt cap is ~5 lines at default size and barely one at
+              // iOS AX5, where even the placeholder was cut. It grows with
+              // the text, but never past a quarter of the screen, so the
+              // keyboard still leaves room for the transcript.
+              maxHeight: Math.min(INPUT_MAX_HEIGHT * fontScale, SCREEN_HEIGHT * 0.25)
             }
           ],
           placeholder: resolvedPlaceholder,
@@ -2083,6 +2376,7 @@ function AppilotsChatInner({
         TouchableOpacity,
         {
           ...APPILOTS_SKIP_PROPS,
+          ref: launcherRef,
           onPress: openChat,
           activeOpacity: 0.8,
           accessibilityRole: "button",
@@ -2096,6 +2390,7 @@ function AppilotsChatInner({
       TouchableOpacity,
       {
         ...APPILOTS_SKIP_PROPS,
+        ref: launcherRef,
         style: [
           styles5.fab,
           fabPositionStyle,
@@ -2148,6 +2443,7 @@ function AppilotsChatInner({
       },
       strings: { expandA11y: strings.pillExpandA11y, stopA11y: strings.pillStopA11y },
       onExpand: openChat,
+      expandRef: pillRef,
       onStop: busy ? cancelMessage : void 0
     }
   ), /* @__PURE__ */ React8__default.createElement(SheetHost, { useModal: presence === "sheet", visible: isVisible, onRequestClose: closeChat }, /* @__PURE__ */ React8__default.createElement(
@@ -2155,6 +2451,7 @@ function AppilotsChatInner({
     {
       ...APPILOTS_SKIP_PROPS,
       pointerEvents: presence === "sheet" ? "auto" : "box-none",
+      onAccessibilityEscape: closeChat,
       style: [
         mode === "fullscreen" ? styles5.modalContainerFullscreen : styles5.modalContainer,
         mode === "sidebar" && styles5.modalContainerSidebar,
@@ -2205,6 +2502,7 @@ function SheetHost({
     {
       ...APPILOTS_SKIP_PROPS,
       pointerEvents: "box-none",
+      accessibilityViewIsModal: true,
       style: [StyleSheet.absoluteFill, styles5.sheetOverlay]
     },
     children
@@ -2303,8 +2601,13 @@ var styles5 = StyleSheet.create({
     maxHeight: "100%",
     flex: 1
   },
+  // Wraps instead of squeezing: at large text sizes the title alone is
+  // wider than the row, and without the wrap it pushed Clear and ✕ off the
+  // right edge — the chat could not be closed (measured at iOS AX5).
   header: {
     flexDirection: "row",
+    flexWrap: "wrap",
+    rowGap: 4,
     alignItems: "center",
     justifyContent: "space-between",
     paddingHorizontal: 16,
@@ -2314,7 +2617,8 @@ var styles5 = StyleSheet.create({
   headerLeft: {
     flexDirection: "row",
     alignItems: "center",
-    gap: 8
+    gap: 8,
+    flexShrink: 1
   },
   headerDot: {
     width: 8,
@@ -2333,24 +2637,30 @@ var styles5 = StyleSheet.create({
     justifyContent: "center"
   },
   headerTitle: {
-    fontWeight: "600"
+    fontWeight: "600",
+    flexShrink: 1
   },
   headerActions: {
     flexDirection: "row",
     alignItems: "center",
-    gap: 12
+    gap: 4,
+    // Stays right-aligned when the header wraps it onto its own line.
+    marginLeft: "auto"
   },
   headerButton: {
+    minWidth: MIN_TOUCH_TARGET2,
+    minHeight: MIN_TOUCH_TARGET2,
     paddingHorizontal: 8,
-    paddingVertical: 4
+    alignItems: "center",
+    justifyContent: "center"
   },
   headerButtonText: {
     fontSize: 13
   },
   closeButton: {
-    width: 28,
-    height: 28,
-    borderRadius: 14,
+    minWidth: MIN_TOUCH_TARGET2,
+    minHeight: MIN_TOUCH_TARGET2,
+    borderRadius: MIN_TOUCH_TARGET2 / 2,
     alignItems: "center",
     justifyContent: "center"
   },
@@ -2432,6 +2742,8 @@ var styles5 = StyleSheet.create({
     maxWidth: 320
   },
   chip: {
+    minHeight: MIN_TOUCH_TARGET2,
+    justifyContent: "center",
     paddingHorizontal: 16,
     paddingVertical: 10,
     borderWidth: 1,
@@ -2494,16 +2806,16 @@ var styles5 = StyleSheet.create({
   },
   input: {
     flex: 1,
-    minHeight: 38,
-    maxHeight: 120,
+    minHeight: MIN_TOUCH_TARGET2,
+    maxHeight: INPUT_MAX_HEIGHT,
     paddingHorizontal: 16,
     paddingTop: Platform.OS === "ios" ? 9 : 8,
     paddingBottom: Platform.OS === "ios" ? 9 : 8,
     textAlignVertical: "top"
   },
   sendButton: {
-    width: 38,
-    height: 38,
+    minWidth: MIN_TOUCH_TARGET2,
+    minHeight: MIN_TOUCH_TARGET2,
     alignItems: "center",
     justifyContent: "center"
   },
@@ -2512,6 +2824,15 @@ var styles5 = StyleSheet.create({
     fontSize: 18,
     fontWeight: "700"
   },
+  missionButtons: {
+    flexDirection: "row",
+    flexWrap: "wrap",
+    columnGap: 12
+  },
+  missionButton: {
+    minHeight: MIN_TOUCH_TARGET2,
+    justifyContent: "center"
+  },
   poweredByContainer: {
     alignItems: "center",
     paddingVertical: 4