@appilots/sdk 0.11.1 → 0.13.0

package/dist/{chunk-GSHE45YX.mjs → chunk-UYBKXULM.mjs}

@@ -1,6 +1,261 @@
-import { getFiberRoot, appilotsDebugWarn, recordIntrospectionFailure, getCurrentScreen, walkFiber, getActiveRouteNames, clampSnapshotToWireLimits, deriveInteractionElements, rectForNode, toWireElement, attachElementIdsToChoiceGroups, elementRegistry, appilotsDebugLog, getLastWalkDiagnostics, SDK_VERSION, geometryStats, geometryAvailability, getNameManglingProbe, emptyDetectorCounts, getAutoTrackingState, getIntrospectionDiagnostics, getDefaultRegistry, useAppilotsContext, ChatSessionMachine, getCurrentScreenSignature, ActionQueueMachine, getScreenMetadata, setCurrentScreen, useResolvedRegistry, totalDetectorHits, listRegistry, getOpenNativeDialog, componentRegistry, getLastAnsweredNativeDialog, probeLoadingState, isListItemPressTarget, waitForLoadingSettle, describeValue, waitForScreenSettle, screenDepartedBaseline, routesBelongToSameFeature, actionPressTargetId, getNavigationStateSnapshot, getNavigationRef, isOptionalStepAutomationFailure, OPTIONAL_STEP_AUTOMATION_HINT, isSwitchLike, normalize3, matchScore, FORM_VALIDATION_TEXT_RE, idLooselyMatches, parseStableElementId, shouldSkipSubtree, isAlwaysListContainer, isHeuristicListContainer, findListItems, getTypeName, foldForCompare, isModalFiber, switchValue, getAllScreens, snapshotShowsOpenCreateForm, isReferenceable, looksDestructiveActionLabel, isGenericSelectValue, FORM_WRITE_SUCCESS_TEXT_RE, TOUCHABLE_NAMES } from './chunk-PQZ64CCE.mjs';
-import React, { useMemo, useRef, useSyncExternalStore, useEffect, useCallback, useState } from 'react';
-import { Alert } from 'react-native';
+import { createSnapshotDeltaTracker, normalizeAppilotsLocale, getFiberRoot, appilotsDebugWarn, recordIntrospectionFailure, getCurrentScreen, walkFiber, getActiveRouteNames, clampSnapshotToWireLimits, deriveInteractionElements, rectForNode, toWireElement, attachElementIdsToChoiceGroups, elementRegistry, appilotsDebugLog, getLastWalkDiagnostics, SDK_VERSION, geometryStats, geometryAvailability, getNameManglingProbe, emptyDetectorCounts, getAutoTrackingState, getIntrospectionDiagnostics, getGeometryHost, isRectOnScreen, listRegistry, resolveAgentPermissions, getDefaultRegistry, useAppilotsContext, ChatSessionMachine, getCurrentScreenSignature, ActionQueueMachine, getScreenMetadata, setCurrentScreen, useResolvedRegistry, totalDetectorHits, getOpenNativeDialog, componentRegistry, permissionDeniedMessage, probeLoadingState, getLastAnsweredNativeDialog, isListItemPressTarget, waitForLoadingSettle, describeValue, waitForScreenSettle, screenDepartedBaseline, routesBelongToSameFeature, actionPressTargetId, getNavigationStateSnapshot, getNavigationRef, isOptionalStepAutomationFailure, OPTIONAL_STEP_AUTOMATION_HINT, isSourceControlId, resolveTarget, isSwitchLike, sourceControlTarget, rectOfFiber, idLooselyMatches, normalize3, matchScore, FORM_VALIDATION_TEXT_RE, parseStableElementId, shouldSkipSubtree, isAlwaysListContainer, isHeuristicListContainer, findListItems, getTypeName, foldForCompare, isModalFiber, sourceControlId, endTextInputEditing, switchValue, getAllScreens, snapshotShowsOpenCreateForm, isReferenceable, looksDestructiveActionLabel, isGenericSelectValue, SUBMIT_CONTROL_RE, isVisibleValidationText, FORM_WRITE_SUCCESS_TEXT_RE, TOUCHABLE_NAMES } from './chunk-HRWBK35Y.mjs';
+import React, { createContext, useMemo, useContext, useRef, useSyncExternalStore, useEffect, useCallback, useState } from 'react';
+import { Platform, NativeModules, AppState, Alert } from 'react-native';
+
+// src/i18n/bundles/pt-BR.ts
+var ptBR = {
+  chatTitle: "Assistente Appilots",
+  clearButton: "Limpar",
+  inputPlaceholder: "Digite uma mensagem...",
+  emptyTitle: "Como posso ajudar?",
+  emptySubtitle: "Navego, preencho formul\xE1rios e executo a\xE7\xF5es neste app.",
+  thinking: "Pensando...",
+  statusAnalyzing: "Analisando a tela...",
+  statusWaitingApp: "Aguardando o app responder...",
+  statusAdjusting: "Ajustando o plano...",
+  poweredBy: "Powered by Appilots",
+  approve: "Aprovar",
+  reject: "Rejeitar",
+  cancelledByUser: "Cancelado pelo usu\xE1rio",
+  confirmDestructiveTitle: "A\xE7\xE3o destrutiva",
+  confirmTitle: "Confirma\xE7\xE3o necess\xE1ria",
+  confirmMessage: 'Tem certeza que deseja "{action}"?',
+  confirmDestructiveApprove: "Sim, executar",
+  confirmApprove: "Confirmar",
+  confirmCancel: "Cancelar",
+  confirmThisAction: "esta a\xE7\xE3o",
+  unknownAction: "A\xE7\xE3o desconhecida",
+  somethingWentWrong: "Algo deu errado",
+  openChatA11y: "Abrir chat do assistente",
+  closeChatA11y: "Fechar chat do assistente",
+  stopGeneratingA11y: "Parar gera\xE7\xE3o",
+  talkToHumanA11y: "Falar com um atendente humano",
+  humanAgentLabel: "Atendente",
+  escalationRequested: "Certo! Chamei um atendente humano. Voc\xEA pode continuar usando o app normalmente enquanto isso.",
+  escalationConnected: "Um atendente entrou na conversa.",
+  escalationResolved: "O atendimento humano foi encerrado. Voltei a te ajudar por aqui.",
+  escalationOffer: "Se preferir, posso chamar uma pessoa para ajudar.",
+  escalationOfferChip: "Falar com um atendente",
+  escalationPendingBanner: "Aguardando um atendente...",
+  escalationActiveBanner: "Voc\xEA est\xE1 falando com um atendente",
+  pillWorking: "Trabalhando...",
+  pillExpandA11y: "Abrir a conversa do assistente",
+  pillStopA11y: "Parar o assistente",
+  missionPause: "Pausar",
+  missionResume: "Retomar tarefa",
+  missionCancel: "Cancelar tarefa",
+  missionPaused: "Pausada",
+  pillDone: "Pronto \u2014 toque para ver",
+  micStartA11y: "Segurar para falar",
+  micStopA11y: "Soltar para enviar",
+  micListening: "Ouvindo..."
+};
+
+// src/i18n/bundles/en.ts
+var en = {
+  chatTitle: "Appilots Assistant",
+  clearButton: "Clear",
+  inputPlaceholder: "Type a message...",
+  emptyTitle: "How can I help?",
+  emptySubtitle: "I navigate, fill forms, and run actions in this app.",
+  thinking: "Thinking...",
+  statusAnalyzing: "Reading the screen...",
+  statusWaitingApp: "Waiting for the app...",
+  statusAdjusting: "Adjusting the plan...",
+  poweredBy: "Powered by Appilots",
+  approve: "Approve",
+  reject: "Reject",
+  cancelledByUser: "Cancelled by user",
+  confirmDestructiveTitle: "Destructive action",
+  confirmTitle: "Confirmation needed",
+  confirmMessage: 'Are you sure you want to "{action}"?',
+  confirmDestructiveApprove: "Yes, do it",
+  confirmApprove: "Confirm",
+  confirmCancel: "Cancel",
+  confirmThisAction: "this action",
+  unknownAction: "Unknown action",
+  somethingWentWrong: "Something went wrong",
+  openChatA11y: "Open assistant chat",
+  closeChatA11y: "Close assistant chat",
+  stopGeneratingA11y: "Stop generating",
+  talkToHumanA11y: "Talk to a human agent",
+  humanAgentLabel: "Agent",
+  escalationRequested: "Done! I've called a human agent. You can keep using the app normally in the meantime.",
+  escalationConnected: "A human agent joined the conversation.",
+  escalationResolved: "The human handoff has ended. I'm back to help you here.",
+  escalationOffer: "If you prefer, I can bring in a person to help.",
+  escalationOfferChip: "Talk to a human",
+  escalationPendingBanner: "Waiting for a human agent...",
+  escalationActiveBanner: "You're talking to a human agent",
+  pillWorking: "Working...",
+  pillExpandA11y: "Open the assistant conversation",
+  pillStopA11y: "Stop the assistant",
+  missionPause: "Pause",
+  missionResume: "Resume task",
+  missionCancel: "Cancel task",
+  missionPaused: "Paused",
+  pillDone: "Done \u2014 tap to read",
+  micStartA11y: "Hold to talk",
+  micStopA11y: "Release to send",
+  micListening: "Listening..."
+};
+
+// src/i18n/bundles/es.ts
+var es = {
+  chatTitle: "Asistente Appilots",
+  clearButton: "Limpiar",
+  inputPlaceholder: "Escribe un mensaje...",
+  emptyTitle: "\xBFEn qu\xE9 puedo ayudarte?",
+  emptySubtitle: "Navego, relleno formularios y ejecuto acciones en esta app.",
+  thinking: "Pensando...",
+  statusAnalyzing: "Analizando la pantalla...",
+  statusWaitingApp: "Esperando a la app...",
+  statusAdjusting: "Ajustando el plan...",
+  poweredBy: "Hecho con Appilots",
+  approve: "Aprobar",
+  reject: "Rechazar",
+  cancelledByUser: "Cancelado por el usuario",
+  confirmDestructiveTitle: "Acci\xF3n destructiva",
+  confirmTitle: "Confirmaci\xF3n necesaria",
+  confirmMessage: '\xBFSeguro que quieres "{action}"?',
+  confirmDestructiveApprove: "S\xED, ejecutar",
+  confirmApprove: "Confirmar",
+  confirmCancel: "Cancelar",
+  confirmThisAction: "esta acci\xF3n",
+  unknownAction: "Acci\xF3n desconocida",
+  somethingWentWrong: "Algo sali\xF3 mal",
+  openChatA11y: "Abrir chat del asistente",
+  closeChatA11y: "Cerrar chat del asistente",
+  stopGeneratingA11y: "Detener generaci\xF3n",
+  talkToHumanA11y: "Hablar con un agente humano",
+  humanAgentLabel: "Agente",
+  escalationRequested: "\xA1Listo! Llam\xE9 a un agente humano. Mientras tanto puedes seguir usando la app con normalidad.",
+  escalationConnected: "Un agente humano se uni\xF3 a la conversaci\xF3n.",
+  escalationResolved: "La atenci\xF3n humana termin\xF3. Vuelvo a ayudarte por aqu\xED.",
+  escalationOffer: "Si prefieres, puedo llamar a una persona para ayudarte.",
+  escalationOfferChip: "Hablar con un agente",
+  escalationPendingBanner: "Esperando a un agente...",
+  escalationActiveBanner: "Est\xE1s hablando con un agente humano",
+  pillWorking: "Trabajando...",
+  pillExpandA11y: "Abrir la conversaci\xF3n del asistente",
+  pillStopA11y: "Detener el asistente",
+  missionPause: "Pausar",
+  missionResume: "Reanudar tarea",
+  missionCancel: "Cancelar tarea",
+  missionPaused: "Pausada",
+  pillDone: "Listo \u2014 toca para ver",
+  micStartA11y: "Mantener para hablar",
+  micStopA11y: "Soltar para enviar",
+  micListening: "Escuchando..."
+};
+
+// src/i18n/bundles/fr.ts
+var fr = {
+  chatTitle: "Assistant Appilots",
+  clearButton: "Effacer",
+  inputPlaceholder: "\xC9crivez un message\u2026",
+  emptyTitle: "Comment puis-je vous aider ?",
+  emptySubtitle: "Je navigue, remplis les formulaires et effectue des actions dans cette application.",
+  thinking: "R\xE9flexion en cours\u2026",
+  statusAnalyzing: "Lecture de l\u2019\xE9cran\u2026",
+  statusWaitingApp: "En attente de l\u2019application\u2026",
+  statusAdjusting: "Ajustement du plan\u2026",
+  poweredBy: "Propuls\xE9 par Appilots",
+  approve: "Approuver",
+  reject: "Refuser",
+  cancelledByUser: "Annul\xE9 par l\u2019utilisateur",
+  confirmDestructiveTitle: "Action destructive",
+  confirmTitle: "Confirmation requise",
+  confirmMessage: "Voulez-vous vraiment \xAB {action} \xBB ?",
+  confirmDestructiveApprove: "Oui, ex\xE9cuter",
+  confirmApprove: "Confirmer",
+  confirmCancel: "Annuler",
+  confirmThisAction: "cette action",
+  unknownAction: "Action inconnue",
+  somethingWentWrong: "Une erreur est survenue",
+  openChatA11y: "Ouvrir la conversation avec l\u2019assistant",
+  closeChatA11y: "Fermer la conversation",
+  stopGeneratingA11y: "Arr\xEAter la g\xE9n\xE9ration",
+  talkToHumanA11y: "Parler \xE0 un conseiller",
+  humanAgentLabel: "Conseiller",
+  escalationRequested: "J\u2019ai contact\xE9 un conseiller. Vous pouvez continuer \xE0 utiliser l\u2019application en attendant.",
+  escalationConnected: "Un conseiller a rejoint la conversation.",
+  escalationResolved: "L\u2019intervention du conseiller est termin\xE9e. Je peux \xE0 nouveau vous aider.",
+  escalationOffer: "Si vous pr\xE9f\xE9rez, je peux faire appel \xE0 un conseiller.",
+  escalationOfferChip: "Parler \xE0 un conseiller",
+  escalationPendingBanner: "En attente d\u2019un conseiller\u2026",
+  escalationActiveBanner: "Vous discutez avec un conseiller",
+  pillWorking: "En cours\u2026",
+  pillExpandA11y: "Ouvrir la conversation avec l\u2019assistant",
+  pillStopA11y: "Arr\xEAter l\u2019assistant",
+  missionPause: "Mettre en pause",
+  missionResume: "Reprendre la t\xE2che",
+  missionCancel: "Annuler la t\xE2che",
+  missionPaused: "En pause",
+  pillDone: "Termin\xE9 \u2014 touchez pour lire",
+  micStartA11y: "Maintenez pour parler",
+  micStopA11y: "Rel\xE2chez pour envoyer",
+  micListening: "\xC9coute en cours\u2026"
+};
+
+// src/i18n/I18nProvider.tsx
+var BUNDLES = {
+  "pt-BR": ptBR,
+  en,
+  es,
+  fr
+};
+var DEFAULT_LOCALE = "en";
+function detectDeviceLocale() {
+  try {
+    let raw;
+    if (Platform.OS === "ios") {
+      const manager = NativeModules?.SettingsManager;
+      const settings = manager?.getConstants?.()?.settings ?? manager?.settings;
+      const languages = Array.isArray(settings?.AppleLanguages) ? settings.AppleLanguages : [];
+      for (const language of languages) {
+        const locale = normalizeAppilotsLocale(language);
+        if (locale) return locale;
+      }
+      raw = settings?.AppleLocale;
+    } else if (Platform.OS === "android") {
+      const manager = NativeModules?.I18nManager;
+      raw = manager?.getConstants?.()?.localeIdentifier ?? manager?.localeIdentifier;
+    }
+    if (!raw || typeof raw !== "string") return null;
+    return normalizeAppilotsLocale(raw) ?? null;
+  } catch {
+    return null;
+  }
+}
+function resolveLocale(prop) {
+  if (prop && BUNDLES[prop]) return prop;
+  const detected = detectDeviceLocale();
+  if (detected && BUNDLES[detected]) return detected;
+  return DEFAULT_LOCALE;
+}
+var I18nContext = createContext(null);
+function AppilotsI18nProvider({ locale, overrides, children }) {
+  const value = useMemo(() => {
+    const resolved = resolveLocale(locale ?? null);
+    const merged = overrides ? { ...BUNDLES[resolved], ...overrides } : BUNDLES[resolved];
+    return {
+      locale: resolved,
+      strings: merged,
+      t: (key) => merged[key]
+    };
+  }, [locale, overrides]);
+  return /* @__PURE__ */ React.createElement(I18nContext.Provider, { value }, children);
+}
+function useAppilotsI18n() {
+  const ctx = useContext(I18nContext);
+  if (ctx) return ctx;
+  return {
+    locale: DEFAULT_LOCALE,
+    strings: BUNDLES[DEFAULT_LOCALE],
+    t: (key) => BUNDLES[DEFAULT_LOCALE][key]
+  };
+}
 
 // src/introspection/captureSnapshot.ts
 function normalizeSliderKey(value) {
@@ -74,20 +329,35 @@ function mergeRegisteredLists(snapshot) {
   }
   for (const entry of registered) {
     if (entry.kind === "scroll") continue;
+    const existing = byId.get(entry.id);
+    if (!existing && !(entry.screen && entry.screen === snapshot.route)) continue;
     const metrics = entry.getScrollMetrics?.();
     const scrollFacts = metrics ? {
       scrollOffsetY: Math.max(0, Math.round(metrics.offset)),
       canScrollUp: metrics.offset > 8,
       canScrollDown: metrics.offset + metrics.visibleLength < metrics.contentLength - 8
     } : void 0;
-    const existing = byId.get(entry.id);
     if (existing) {
       existing.itemCount = existing.itemCount ?? entry.itemCount;
+      existing.totalItemCount = existing.totalItemCount ?? entry.totalItemCount;
       existing.refreshing = existing.refreshing ?? entry.refreshing;
       existing.empty = existing.empty ?? entry.empty;
       existing.label = existing.label ?? entry.label;
       existing.source = existing.source ?? "auto-tracked";
       existing.visibleItemCount = existing.items.length;
+      const viewport = entry.measureViewport?.();
+      if (viewport && viewport.width > 0 && viewport.height > 0) {
+        let measured = 0;
+        let inViewport = 0;
+        for (const item of existing.items) {
+          const rect = rectForNode(item);
+          if (!rect) continue;
+          measured++;
+          item.onScreen = rect.width > 0 && rect.height > 0 && rect.x < viewport.x + viewport.width && rect.x + rect.width > viewport.x && rect.y < viewport.y + viewport.height && rect.y + rect.height > viewport.y;
+          if (item.onScreen) inViewport++;
+        }
+        if (measured === existing.items.length) existing.viewportItemCount = inViewport;
+      }
       if (entry.dataPreview && entry.dataPreview.length > 0) {
         existing.dataPreview = entry.dataPreview;
       }
@@ -104,6 +374,7 @@ function mergeRegisteredLists(snapshot) {
       containerType: entry.component,
       source: "registry",
       itemCount: entry.itemCount,
+      totalItemCount: entry.totalItemCount,
       visibleItemCount: 0,
       refreshing: entry.refreshing,
       empty: entry.empty,
@@ -169,6 +440,43 @@ function recordBlindWalk() {
   if (totalDetectorHits(walk.detectors) > 0) return;
   recordIntrospectionFailure("walk-recognized-nothing", null);
 }
+function mergeRegisteredFieldValues(snapshot) {
+  const present = new Set(snapshot.inputs.map((i) => normalizeFieldKey(i.id)));
+  const onScreenIds = [
+    ...snapshot.buttons.map((b) => (b.id ?? "").toLowerCase()),
+    ...snapshot.toggles.map((t) => (t.id ?? "").toLowerCase())
+  ].filter(Boolean);
+  const onScreenLabels = new Set(
+    [...snapshot.buttons.map((b) => b.label), ...snapshot.texts].filter((l) => !!l).map((l) => l.toLowerCase())
+  );
+  for (const { id, kind, screen, label } of componentRegistry.snapshot()) {
+    if (kind !== "field") continue;
+    const key = normalizeFieldKey(id);
+    if (!key || present.has(key)) continue;
+    const entry = componentRegistry.getField(id);
+    if (!entry) continue;
+    const fieldType = entry.fieldType ?? "";
+    if (fieldType === "text" || fieldType === "") continue;
+    const declaresRoute = typeof screen === "string" && screen === snapshot.route;
+    if (screen && !declaresRoute && !getActiveRouteNames().includes(screen)) continue;
+    const idEvidence = onScreenIds.some((candidate) => candidate.split(/[^a-z0-9]+/).includes(key));
+    const labelEvidence = !!entry.label && onScreenLabels.has(entry.label.toLowerCase());
+    if (!declaresRoute && !idEvidence && !labelEvidence) continue;
+    let value;
+    try {
+      value = String(entry.getValue() ?? "");
+    } catch {
+      continue;
+    }
+    snapshot.inputs.push({
+      id,
+      label: entry.label ?? label,
+      value,
+      type: fieldType
+    });
+    present.add(key);
+  }
+}
 function captureSnapshot() {
   const root = getFiberRoot();
   if (!root) {
@@ -201,6 +509,7 @@ function captureSnapshot() {
   mergeNativeDialog(snapshot);
   reconcileSliders(snapshot);
   canonicalizeRegisteredFields(snapshot);
+  mergeRegisteredFieldValues(snapshot);
   clampSnapshotToWireLimits(snapshot);
   const entries = deriveInteractionElements(snapshot, { rectOf: rectForNode });
   const rectById = new Map(
@@ -303,6 +612,11 @@ function flipSwitchFiber(fiber, next) {
   return { ok: true, via: handler.via };
 }
 
+// src/introspection/positionalIdentity.ts
+function isPositionalControlId(value) {
+  return /^(?:list-\d+-item-\d+-)?(?:btn|input|slider|toggle)-\d+$/i.test(value.trim());
+}
+
 // src/introspection/findInteractive.ts
 function getTypeName2(type) {
   if (!type) return null;
@@ -390,6 +704,11 @@ function shouldSkipSubtree2(fiber) {
 var normalize = foldForCompare;
 function scoreMatchDetail(fiber, queryNorm, queryRaw) {
   const props = fiber.memoizedProps ?? {};
+  if (isSourceControlId(queryRaw)) {
+    const matches = sourceControlId(fiber) === queryRaw;
+    const disabled = props.disabled === true || props.accessibilityState?.disabled === true;
+    return { score: matches ? disabled ? 60 : 120 : 0, named: matches, disabled };
+  }
   const candidates = [];
   if (typeof props.testID === "string") candidates.push({ val: props.testID, weight: 100 });
   if (typeof props.accessibilityLabel === "string")
@@ -408,11 +727,11 @@ function scoreMatchDetail(fiber, queryNorm, queryRaw) {
     if (!vNorm) continue;
     if (val === queryRaw) best = Math.max(best, weight + 20);
     else if (vNorm === queryNorm) best = Math.max(best, weight + 10);
-    else if (queryNorm && (vNorm.includes(queryNorm) || queryNorm.includes(vNorm)))
+    else if (!isPositionalControlId(queryRaw) && queryNorm && (vNorm.includes(queryNorm) || queryNorm.includes(vNorm)))
       best = Math.max(best, weight - 20);
   }
   const named = best >= IDENTITY_MATCH_SCORE;
-  const disabledProp = props.disabled === true;
+  const disabledProp = props.disabled === true || props.editable === false || props.readOnly === true;
   const disabledA11y = typeof props.accessibilityState === "object" && props.accessibilityState !== null && props.accessibilityState.disabled === true;
   if (best > 0 && disabledProp) {
     best = Math.max(1, best - 60);
@@ -422,12 +741,18 @@ function scoreMatchDetail(fiber, queryNorm, queryRaw) {
   }
   return { score: best, named, disabled: disabledProp || disabledA11y };
 }
+var inputIdentities = /* @__PURE__ */ new WeakMap();
 function wrapTextInput(fiber) {
+  const identity = inputIdentities.get(fiber) ?? (fiber.alternate && inputIdentities.get(fiber.alternate)) ?? {};
+  inputIdentities.set(fiber, identity);
+  if (fiber.alternate) inputIdentities.set(fiber.alternate, identity);
   const getProps = () => fiber.memoizedProps ?? {};
   return {
     kind: "field",
+    controlIdentity: identity,
     label: getProps().accessibilityLabel ?? getProps().label ?? getProps().placeholder ?? getProps().testID,
     getValue: () => getProps().value,
+    finishEditing: () => endTextInputEditing(getProps()),
     setValue: (value) => {
       const { onChangeText, onChange } = getProps();
       if (typeof onChangeText === "function") {
@@ -508,10 +833,10 @@ function describeCandidate(fiber, kind) {
   const props = fiber?.memoizedProps ?? {};
   return props.testID ?? props.accessibilityLabel ?? props.placeholder ?? (kind === "target" ? findChildText(fiber) : void 0);
 }
-function isDescendantOf(fiber, ancestor) {
+function isDescendantOf(fiber, ancestor, parents) {
   if (!fiber || !ancestor) return false;
-  let node = fiber.return;
-  for (let depth = 0; node && depth < 200; depth++, node = node.return) {
+  let node = parents.get(fiber);
+  for (let depth = 0; node && depth < 200; depth++, node = parents.get(node)) {
     if (node === ancestor) return true;
   }
   return false;
@@ -532,13 +857,15 @@ function findInteractiveByIdentifier(query, options = {}) {
   let bestDisabled = false;
   let tied = [];
   const visited = /* @__PURE__ */ new WeakSet();
+  const parents = /* @__PURE__ */ new WeakMap();
   const stack = [];
-  if (root.child) stack.push(root.child);
+  if (root.child) stack.push({ fiber: root.child, parent: root });
   while (stack.length > 0) {
-    const fiber = stack.pop();
+    const { fiber, parent } = stack.pop();
     if (!fiber || visited.has(fiber)) continue;
     visited.add(fiber);
-    if (fiber.sibling) stack.push(fiber.sibling);
+    parents.set(fiber, parent);
+    if (fiber.sibling) stack.push({ fiber: fiber.sibling, parent });
     if (shouldSkipSubtree2(fiber)) continue;
     const props = fiber.memoizedProps ?? {};
     let kind = null;
@@ -552,7 +879,7 @@ function findInteractiveByIdentifier(query, options = {}) {
         if (score > bestScore) tied = [{ fiber, kind }];
         else if (score === bestScore) tied.push({ fiber, kind });
       }
-      const beatsBest = score > bestScore || score > 0 && score === bestScore && isDescendantOf(fiber, bestFiber);
+      const beatsBest = score > bestScore || score > 0 && score === bestScore && isDescendantOf(fiber, bestFiber, parents);
       if (beatsBest) {
         bestScore = score;
         bestFiber = fiber;
@@ -561,11 +888,15 @@ function findInteractiveByIdentifier(query, options = {}) {
         bestId = describeCandidate(fiber, kind);
         if (kind === "field") bestHandle = wrapTextInput(fiber);
         else if (kind === "toggle") bestHandle = wrapSwitch(fiber);
-        else bestHandle = wrapTouchable(fiber, findChildText(fiber));
+        else if (isSourceControlId(queryRaw)) {
+          const bound = sourceControlTarget(fiber);
+          if (!bound || bound.disabled) bestHandle = null;
+          else bestHandle = wrapTouchable(bound.fiber, findChildText(fiber));
+        } else bestHandle = wrapTouchable(fiber, findChildText(fiber));
       }
     }
     if (kind === "toggle") continue;
-    if (fiber.child) stack.push(fiber.child);
+    if (fiber.child) stack.push({ fiber: fiber.child, parent: fiber });
   }
   if (bestHandle && bestScore < (options.minScore ?? 0)) {
     appilotsDebugLog(
@@ -576,12 +907,14 @@ function findInteractiveByIdentifier(query, options = {}) {
   if (bestHandle) {
     const independent = tied.filter(
       (candidate) => !tied.some(
-        (other) => other.fiber !== candidate.fiber && isDescendantOf(other.fiber, candidate.fiber)
+        (other) => other.fiber !== candidate.fiber && isDescendantOf(other.fiber, candidate.fiber, parents)
       )
     );
     bestHandle.matchCount = independent.length;
     bestHandle.named = bestNamed;
     bestHandle.disabled = bestDisabled;
+    const measured = bestFiber;
+    bestHandle.measure = () => rectOfFiber(measured);
     const candidates = independent.map(({ fiber, kind }) => describeCandidate(fiber, kind)).filter((id) => typeof id === "string" && id.length > 0).slice(0, 8);
     if (candidates.length > 0) bestHandle.matchCandidates = candidates;
     appilotsDebugLog(
@@ -593,6 +926,119 @@ function findInteractiveByIdentifier(query, options = {}) {
   return bestHandle;
 }
 
+// src/introspection/spotlightTarget.ts
+var listeners = /* @__PURE__ */ new Set();
+var current = null;
+var seq = 0;
+var expiry = null;
+var SPOTLIGHT_TTL_MS = 1200;
+var mode = "off";
+function setSpotlightMode(next) {
+  mode = next;
+}
+function getSpotlightMode() {
+  return mode;
+}
+function emit() {
+  for (const listener of listeners) listener(current);
+}
+function setSpotlightTarget(rect, label) {
+  if (expiry) {
+    clearTimeout(expiry);
+    expiry = null;
+  }
+  if (!rect) {
+    appilotsDebugLog(
+      `setSpotlightTarget: cleared${label ? ` (was about to mark "${label}")` : ""}`
+    );
+    if (current === null) return;
+    current = null;
+    emit();
+    return;
+  }
+  current = { rect, label, seq: ++seq };
+  appilotsDebugLog(
+    `setSpotlightTarget: seq=${current.seq} label="${label ?? ""}" rect=${Math.round(rect.x)},${Math.round(rect.y)} ${Math.round(rect.width)}x${Math.round(rect.height)}`
+  );
+  emit();
+  expiry = setTimeout(() => {
+    expiry = null;
+    current = null;
+    emit();
+  }, SPOTLIGHT_TTL_MS);
+}
+function getSpotlightTarget() {
+  return current;
+}
+function subscribeSpotlight(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+// src/introspection/scrollIntoView.ts
+var REVEAL_MARGIN = 24;
+function offsetToReveal({ rect, viewport, metrics }) {
+  const maxOffset = Math.max(0, metrics.contentLength - metrics.visibleLength);
+  const viewTop = viewport.top + REVEAL_MARGIN;
+  const viewBottom = viewport.top + viewport.height - REVEAL_MARGIN;
+  const tallerThanViewport = rect.height > viewport.height - REVEAL_MARGIN * 2;
+  let delta;
+  if (tallerThanViewport) {
+    if (rect.y >= viewTop && rect.y <= viewBottom) return null;
+    delta = rect.y - viewTop;
+  } else if (rect.y < viewTop) {
+    delta = rect.y - viewTop;
+  } else if (rect.y + rect.height > viewBottom) {
+    delta = rect.y + rect.height - viewBottom;
+  } else {
+    return null;
+  }
+  const target = clamp(metrics.offset + delta, 0, maxOffset);
+  if (Math.abs(target - metrics.offset) < 1) return null;
+  return target;
+}
+function clamp(value, min, max) {
+  return Math.min(max, Math.max(min, value));
+}
+
+// src/introspection/revealTarget.ts
+function revealTarget(rect) {
+  const host = getGeometryHost();
+  if (!host) return { rect, scrolled: false };
+  if (isRectOnScreen(rect, host.window)) return { rect, scrolled: false };
+  const scrollable = resolveScrollable();
+  if (!scrollable) return { rect, scrolled: false };
+  const metrics = scrollable.getScrollMetrics?.();
+  if (!metrics) return { rect, scrolled: false };
+  const box = scrollable.measureViewport?.();
+  const viewport = box ? { top: box.y, height: box.height } : { top: 0, height: host.window.height };
+  const target = offsetToReveal({ rect, viewport, metrics });
+  if (target === null) return { rect, scrolled: false };
+  const moved = scrollable.scrollToOffset?.(target) ?? false;
+  if (!moved) {
+    appilotsDebugLog(`revealTarget: "${scrollable.id}" refused scrollToOffset(${target})`);
+    return { rect, scrolled: false };
+  }
+  const delta = target - metrics.offset;
+  appilotsDebugLog(
+    `revealTarget: scrolled "${scrollable.id}" by ${Math.round(delta)}px (${Math.round(metrics.offset)} \u2192 ${Math.round(target)})`
+  );
+  return { rect: { ...rect, y: rect.y - delta }, scrolled: true };
+}
+function resolveScrollable() {
+  const screen = getCurrentScreen();
+  const candidates = listRegistry.snapshot().filter((entry) => entry.scrollToOffset && entry.getScrollMetrics).filter((entry) => !screen || !entry.screen || entry.screen === screen);
+  if (candidates.length === 1) return candidates[0];
+  if (candidates.length > 1) {
+    appilotsDebugLog(
+      `revealTarget: ${candidates.length} scrollables on "${screen ?? "?"}" \u2014 cannot tell which holds the target, so not scrolling.`
+    );
+  }
+  return null;
+}
+
 // src/executor/handlers/navigateHandler.ts
 var _reportedMissingNavRef = false;
 function reportMissingNavigationRef() {
@@ -635,7 +1081,18 @@ function screenExistsAnywhere(state, screenName) {
   return false;
 }
 function safeNavigate(nav, screenName, params, path) {
+  const state = nav.getState?.();
+  const rootState = nav.getRootState?.() ?? state;
   if (path && path.length > 0) {
+    if (Array.isArray(rootState?.routeNames) && !screenExistsAnywhere(rootState, path[0]) && !state?.routeNames?.includes(path[0])) {
+      if (state?.routeNames?.includes(screenName)) {
+        nav.navigate(screenName, params);
+        return;
+      }
+      throw new Error(
+        `Route "${path[0]}" is not registered in any navigator. Cannot resolve the supplied path to "${screenName}".`
+      );
+    }
     const { root, nestedParams } = buildNestedParams(path, screenName, params);
     appilotsDebugLog(
       `safeNavigate: using path-based navigation \u2014 root="${root}", nested=${JSON.stringify(nestedParams)}`
@@ -643,12 +1100,10 @@ function safeNavigate(nav, screenName, params, path) {
     nav.navigate(root, nestedParams);
     return;
   }
-  const state = nav.getState?.();
   if (state?.routeNames?.includes(screenName)) {
     nav.navigate(screenName, params);
     return;
   }
-  const rootState = nav.getRootState?.() ?? state;
   if (!screenExistsAnywhere(rootState, screenName)) {
     throw new Error(
       `Screen "${screenName}" is not registered in any navigator. The screen may have been removed, may live inside a flow that is not currently mounted (e.g. Auth stack after login), or the MCP doc is stale.`
@@ -670,8 +1125,8 @@ function navigateHandler(payload, context) {
   if (!permissions.canNavigate) {
     return {
       success: false,
-      error: "Navigation is not permitted",
-      diagnose: { category: "unknown", screen: payload.screenName }
+      error: permissionDeniedMessage("Navigation", "canNavigate"),
+      diagnose: { category: "unknown", screen: payload.screenName, recoverable: false }
     };
   }
   const isGoBack = payload.navigationAction === "goBack";
@@ -1028,8 +1483,10 @@ function pressResolvedListItem(list, itemFiber, listIndex, itemIndex) {
       (candidate) => candidate !== touchable && containsFiber(touchable, candidate)
     );
     if (primaryWrapsNestedTargets) {
+      const outer = describeTouchable(touchable) ?? "?";
+      const nested = safeIdentifiableTouchables.filter((candidate) => candidate !== touchable && containsFiber(touchable, candidate)).map((candidate) => describeTouchable(candidate) ?? "?").slice(0, 6);
       appilotsDebugLog(
-        `listItemDispatch: item "list-${listIndex}-item-${itemIndex}" has nested pressables; pressing outer row target`
+        `listItemDispatch: item "list-${listIndex}-item-${itemIndex}" has nested pressables; pressing outer row target [outer=${outer}] [nested=${nested.join(", ")}] [outerHasOnPress=${typeof touchable?.memoizedProps?.onPress === "function"}]`
       );
     } else {
       const candidates = safeIdentifiableTouchables.map(describeTouchable).filter((d) => !!d).slice(0, 8);
@@ -1096,10 +1553,12 @@ function scoreItemCandidate(item, zeroBasedIndex, locator) {
   if (locator.itemKey) {
     if (itemKey === locator.itemKey) score += 1e3;
     else if (itemKey && normalize2(itemKey) === normalize2(locator.itemKey)) score += 950;
+    else return 0;
   }
   if (locator.reactKey) {
     if (reactKey === locator.reactKey) score += 900;
     else if (reactKey && normalize2(reactKey) === normalize2(locator.reactKey)) score += 850;
+    else if (!locator.itemKey) return 0;
   }
   if (locator.itemIndex && zeroBasedIndex === locator.itemIndex - 1) score += 750;
   if (locator.itemIndex && markedIndex !== void 0 && (markedIndex === locator.itemIndex || markedIndex === locator.itemIndex - 1)) {
@@ -1169,7 +1628,7 @@ function resolveListItemByIdentity(locator) {
   scoredCandidates.sort((a, b) => b.score - a.score);
   const best = scoredCandidates[0];
   const tiedCandidates = scoredCandidates.filter((c) => c.score === best.score);
-  if (tiedCandidates.length > 1 && best.score < 750) {
+  if (tiedCandidates.length > 1 && (best.score < 750 || Boolean(effective.itemKey || effective.reactKey))) {
     const candidates = tiedCandidates.map((c) => describeItemCandidate(c.listIndex, c.itemIndex - 1, c.item)).slice(0, 8);
     return {
       ok: false,
@@ -1237,11 +1696,11 @@ function toggleListItemByIdentity(locator, options) {
   }
   const target = switches[0];
   const props = target?.memoizedProps ?? {};
-  const current = switchValue(props);
-  if (options?.expected !== void 0 && current === options.expected) {
-    return { ok: true, containerType: list.containerType, value: current, noop: true };
+  const current2 = switchValue(props);
+  if (options?.expected !== void 0 && current2 === options.expected) {
+    return { ok: true, containerType: list.containerType, value: current2, noop: true };
   }
-  const flipped = flipSwitchFiber(target, !current);
+  const flipped = flipSwitchFiber(target, !current2);
   if (!flipped.ok) {
     if (flipped.reason === "no-handler") {
       return {
@@ -1258,7 +1717,7 @@ function toggleListItemByIdentity(locator, options) {
       containerType: list.containerType
     };
   }
-  return { ok: true, containerType: list.containerType, value: !current };
+  return { ok: true, containerType: list.containerType, value: !current2 };
 }
 function pressListItemByIdentity(locator) {
   const resolved = resolveListItemByIdentity(locator);
@@ -1453,6 +1912,12 @@ function dispatchFiberTarget(targetId, action) {
       diagnose: screenDiagnose(targetId)
     };
   }
+  const measured = handle.measure?.() ?? null;
+  if (measured && getSpotlightMode() === "guided") {
+    setSpotlightTarget(revealTarget(measured).rect, handle.label);
+  } else {
+    setSpotlightTarget(measured, handle.label);
+  }
   try {
     if (isPressLike(action) && handle.kind === "target" && handle.press) {
       handle.press();
@@ -1503,6 +1968,13 @@ function dispatchLegacyTarget(targetId, registry, action) {
   };
 }
 function dispatchElement(element, registry, action) {
+  if (element.dispatchable === false) {
+    return {
+      success: false,
+      error: `Element "${element.id}" is observation-only and has no exact live control binding.`,
+      diagnose: { ...screenDiagnose(element.id, "ambiguous-target"), recoverable: false }
+    };
+  }
   if (element.disabled === true) {
     return {
       success: false,
@@ -1521,6 +1993,13 @@ function dispatchElement(element, registry, action) {
       texts: element.texts
     });
     if (pressed.ok) return { success: true };
+    if (!pressed.refusal && (element.listContext.itemKey || element.listContext.reactKey)) {
+      return {
+        success: false,
+        error: pressed.error ?? `The observed list entity "${element.label ?? element.id}" could not be resolved. Reobserve; do not substitute its old position.`,
+        diagnose: { ...screenDiagnose(element.id, "ambiguous-target"), recoverable: true }
+      };
+    }
     if (pressed.refusal) {
       return {
         success: false,
@@ -1838,12 +2317,18 @@ function normalizeText(value) {
 function containsWord(haystack, needle) {
   return ` ${haystack} `.includes(` ${needle} `);
 }
-function readVisibleFormValidation(snap) {
+function readVisibleFormValidation(snap, beforeTexts) {
   if (!snap) return void 0;
+  const invalid = snap.inputs?.find((input) => input.invalid === true);
+  const hasSubmitControl = snap.buttons?.some(
+    (button) => SUBMIT_CONTROL_RE.test(button.label ?? button.id ?? "")
+  );
   for (const text of snap.texts ?? []) {
-    if (!text?.trim() || !FORM_VALIDATION_TEXT_RE2.test(text)) continue;
+    if (!text?.trim() || !isVisibleValidationText(text, { invalid: !!invalid, hasSubmitControl, beforeTexts }))
+      continue;
     return { fieldId: inferValidationFieldId(text, snap.inputs), message: text };
   }
+  if (invalid) return { fieldId: invalid.id, message: "The app marks this field as invalid." };
   return void 0;
 }
 function readVisibleFormSuccess(snap) {
@@ -1856,15 +2341,18 @@ function submitAsyncStillPending(submitTargetId) {
   if (submitTargetId && probe.pressedFound && probe.pressedDisabled) return true;
   return false;
 }
-function evaluatePostSubmitSnapshot(snap, activePath) {
-  const validation = readVisibleFormValidation(snap);
+function evaluatePostSubmitSnapshot(snap, activePath, beforeTexts) {
+  const validation = readVisibleFormValidation(snap, beforeTexts);
   if (validation) {
     return { status: "failure", fieldId: validation.fieldId, message: validation.message };
   }
   const successText = readVisibleFormSuccess(snap);
   if (successText) return { status: "success", message: successText };
   if (!snapshotShowsOpenCreateForm(snap, activePath)) {
-    return { status: "success" };
+    return {
+      status: "unverified",
+      message: "The form closed without a visible success receipt. Inspect the resulting record before claiming the goal is complete."
+    };
   }
   return void 0;
 }
@@ -1880,7 +2368,7 @@ async function waitForPostSubmitOutcome(options) {
     }
     const snap2 = captureSnapshot();
     const activePath2 = getActiveRouteNames();
-    const outcome2 = evaluatePostSubmitSnapshot(snap2, activePath2);
+    const outcome2 = evaluatePostSubmitSnapshot(snap2, activePath2, options?.beforeTexts);
     if (outcome2) return outcome2;
     await sleep(pollMs);
   }
@@ -1892,7 +2380,7 @@ async function waitForPostSubmitOutcome(options) {
   }
   const snap = captureSnapshot();
   const activePath = getActiveRouteNames();
-  const outcome = evaluatePostSubmitSnapshot(snap, activePath);
+  const outcome = evaluatePostSubmitSnapshot(snap, activePath, options?.beforeTexts);
   if (outcome) return outcome;
   return {
     status: "failure",
@@ -1900,91 +2388,6 @@ async function waitForPostSubmitOutcome(options) {
   };
 }
 
-// ../shared/dist/chunk-ERITSWKE.mjs
-var DEFAULT_FUZZY_FLOOR = 4;
-function normalizeId(value) {
-  return String(value ?? "").normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9]/g, "");
-}
-var KIND_PREFIX_WORDS = "button|switch|toggle|input|field|link|btn|slider";
-var KEBAB_SNAKE_PREFIX_RE = new RegExp(`^(?:${KIND_PREFIX_WORDS})[-_]`, "i");
-var CAMEL_PREFIX_RE = new RegExp(`^(?:${KIND_PREFIX_WORDS})(?=[A-Z])`, "");
-function stripKindPrefix(id) {
-  const raw = String(id ?? "");
-  if (KEBAB_SNAKE_PREFIX_RE.test(raw)) return raw.replace(KEBAB_SNAKE_PREFIX_RE, "");
-  if (CAMEL_PREFIX_RE.test(raw)) return raw.replace(CAMEL_PREFIX_RE, "");
-  return raw;
-}
-function actionAllowsKind(action, kind) {
-  if (!action || !kind) return true;
-  switch (action) {
-    case "press":
-    case "longPress":
-      return kind !== "field" && kind !== "input" && kind !== "slider";
-    case "set_value":
-      return kind === "slider" || kind === "field" || kind === "input";
-    case "focus":
-      return kind === "field" || kind === "input";
-    case "toggle":
-      return kind === "toggle";
-    default:
-      return true;
-  }
-}
-function distinctIds(candidates) {
-  return [...new Set(candidates.map((c) => c.id))];
-}
-function resolveTarget(requested, candidates, opts = {}) {
-  const floor = opts.fuzzyFloor ?? DEFAULT_FUZZY_FLOOR;
-  const nReq = normalizeId(requested);
-  if (!nReq || candidates.length === 0) {
-    return { status: "unverified", reason: "not-found" };
-  }
-  for (const c of candidates) {
-    if (normalizeId(c.id) === nReq) {
-      return { status: "matched", id: c.id, tier: "exact" };
-    }
-  }
-  const labelExact = distinctIds(
-    candidates.filter((c) => c.label && normalizeId(c.label) === nReq)
-  );
-  if (labelExact.length === 1) return { status: "matched", id: labelExact[0], tier: "exact" };
-  if (labelExact.length > 1) return { status: "unverified", reason: "ambiguous" };
-  const nReqStripped = normalizeId(stripKindPrefix(requested));
-  for (const c of candidates) {
-    const nId = normalizeId(c.id);
-    const nIdStripped = normalizeId(stripKindPrefix(c.id));
-    if (nReqStripped && (nReqStripped === nId || nReqStripped === nIdStripped) || nIdStripped && nIdStripped === nReq) {
-      return { status: "matched", id: c.id, tier: "prefix" };
-    }
-  }
-  if (opts.destructive) {
-    return { status: "unverified", reason: "destructive-inexact" };
-  }
-  if (nReq.length < floor) {
-    return { status: "unverified", reason: "not-found" };
-  }
-  const fuzzy = candidates.filter((c) => {
-    for (const s of [c.id, c.label]) {
-      if (!s) continue;
-      const ns = normalizeId(s);
-      if (ns.length >= floor && (ns.includes(nReq) || nReq.includes(ns))) return true;
-    }
-    return false;
-  });
-  if (fuzzy.length === 0) {
-    return { status: "unverified", reason: "not-found" };
-  }
-  const typed = fuzzy.filter((c) => actionAllowsKind(opts.action, c.kind));
-  if (typed.length === 0) {
-    return { status: "unverified", reason: "type-mismatch" };
-  }
-  const ids = distinctIds(typed);
-  if (ids.length > 1) {
-    return { status: "unverified", reason: "ambiguous" };
-  }
-  return { status: "matched", id: ids[0], tier: "fuzzy" };
-}
-
 // src/executor/handlers/uiInteractionHandler.ts
 function findSnapshotButton(targetId) {
   try {
@@ -2057,6 +2460,7 @@ function stripComponentPrefix(componentId) {
   return null;
 }
 function resolveComponentId(componentId, registry, action) {
+  if (isSourceControlId(componentId)) return componentId;
   if (registry.getTarget(componentId) || registry.getToggle(componentId) || registry.getField(componentId) || registry.getSlider(componentId)) {
     return componentId;
   }
@@ -2070,6 +2474,7 @@ function resolveComponentId(componentId, registry, action) {
       return comp.id;
     }
   }
+  if (isPositionalControlId(componentId)) return componentId;
   const currentScreen = getCurrentScreen();
   if (currentScreen) {
     const screenMeta = getScreenMetadata(currentScreen);
@@ -2315,11 +2720,14 @@ function uiInteractionHandler(payload, context) {
   if (!permissions.canInteractUI) {
     return {
       success: false,
-      error: "UI interaction is not permitted",
-      diagnose: buildUiDiagnose(
-        payload.componentId ?? payload.targetId ?? "",
-        "unknown"
-      )
+      error: permissionDeniedMessage("UI interaction", "canInteractUI"),
+      diagnose: {
+        ...buildUiDiagnose(
+          payload.componentId ?? payload.targetId ?? "",
+          "unknown"
+        ),
+        recoverable: false
+      }
     };
   }
   const { action } = payload;
@@ -2549,6 +2957,28 @@ function uiInteractionHandler(payload, context) {
   };
 }
 
+// src/executor/completeTextEdit.ts
+var sleep2 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function completeTextEdit(fieldId, expected, registered, origin, resolveRegistered) {
+  await sleep2(80);
+  const current2 = findInteractiveByIdentifier(fieldId, { kind: "field" });
+  if (origin?.controlIdentity && current2?.controlIdentity !== origin.controlIdentity) return false;
+  if (registered && resolveRegistered && resolveRegistered() !== registered) return false;
+  if (registered?.finishEditing) registered.finishEditing();
+  else if (current2 && (current2.matchCount ?? 1) === 1 && !current2.disabled)
+    current2.finishEditing?.();
+  const started = Date.now();
+  do {
+    await sleep2(80);
+    const live = findInteractiveByIdentifier(fieldId, { kind: "field" });
+    if (origin?.controlIdentity && live?.controlIdentity !== origin.controlIdentity) return false;
+    if (registered && resolveRegistered && resolveRegistered() !== registered) return false;
+    const value = registered ? registered.getValue() : live?.getValue?.();
+    if (value !== void 0 && value !== null && String(value) === String(expected)) return true;
+  } while (Date.now() - started < 480);
+  return false;
+}
+
 // src/executor/formSubmitResolve.ts
 var SUBMIT_LABEL_HINT_RE = /\b(submit|save|send|continue|next|sign\s*in|log\s*in|register|salvar|enviar|entrar|cadastrar|continuar|proximo|próximo|avancar|avançar|confirmar|guardar|registrarse|iniciar\s+sesi[óo]n|enregistrer|envoyer|valider|soumettre|confirmer|se\s+connecter|s['e]\s*inscrire)\b/i;
 var AGENT_CHROME_TARGET_RE = /\b(fechar|close|dismiss|cancelar|cancel|limpar|clear|chat\s+do\s+assistente|assistant\s+chat)\b/i;
@@ -2695,8 +3125,8 @@ function selectValueApplied(fieldId, requestedValue, currentValue, registry) {
 function getMetadataField(fieldId, registry) {
   const screens = /* @__PURE__ */ new Set();
   for (const name of getActiveRouteNames()) screens.add(name);
-  const current = getCurrentScreen();
-  if (current) screens.add(current);
+  const current2 = getCurrentScreen();
+  if (current2) screens.add(current2);
   if (registry) {
     for (const comp of registry.snapshot()) {
       if (comp.kind === "field" && comp.screen) screens.add(comp.screen);
@@ -2737,7 +3167,7 @@ async function tryOpenSelectModal(fieldId, registry) {
     if (!target) continue;
     try {
       target.press();
-      await sleep2(180);
+      await sleep3(180);
       return true;
     } catch {
     }
@@ -3122,7 +3552,7 @@ function findSlider(fieldId, registry) {
   }
   return void 0;
 }
-var sleep2 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var sleep3 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 async function formFillHandler(payload, context) {
   const { permissions } = context;
   const registry = context.registry ?? componentRegistry;
@@ -3131,8 +3561,8 @@ async function formFillHandler(payload, context) {
   if (!permissions.canFillForms) {
     return {
       success: false,
-      error: "Form filling is not permitted",
-      diagnose: { category: "unknown", screen: screenPath }
+      error: permissionDeniedMessage("Form filling", "canFillForms"),
+      diagnose: { category: "unknown", screen: screenPath, recoverable: false }
     };
   }
   if (!payload.fields || payload.fields.length === 0) {
@@ -3189,14 +3619,51 @@ async function formFillHandler(payload, context) {
     const fieldEntry = findField(fieldId, registry);
     if (fieldEntry) {
       try {
+        const nativeField = findInteractiveByIdentifier(fieldId, { kind: "field" });
+        if (nativeField?.disabled || (nativeField?.matchCount ?? 1) > 1) {
+          fieldResults.push({
+            fieldId,
+            success: false,
+            error: nativeField?.disabled ? "The field is disabled" : "The field identifier matches multiple controls",
+            diagnose: {
+              category: nativeField?.disabled ? "disabled" : "ambiguous-target",
+              fieldId,
+              screen: screenPath
+            }
+          });
+          allSuccess = false;
+          continue;
+        }
         appilotsDebugLog(
           `formFillHandler: found field "${fieldId}" via registry, calling setValue(<${String(value).length} chars>)`
         );
         const beforeValue = effectiveFieldType === "date" ? fieldEntry.getValue?.() ?? "" : void 0;
         fieldEntry.focus?.();
         fieldEntry.setValue(String(value));
+        if (effectiveFieldType === "text" || effectiveFieldType === "number") {
+          if (!await completeTextEdit(
+            fieldId,
+            value,
+            fieldEntry,
+            nativeField,
+            () => findField(fieldId, registry)
+          )) {
+            fieldResults.push({
+              fieldId,
+              success: false,
+              error: "The field did not retain the requested value after editing ended. Inspect its current value before retrying.",
+              diagnose: { category: "validation", fieldId, screen: screenPath }
+            });
+            allSuccess = false;
+            continue;
+          }
+        }
         if (effectiveFieldType === "date") {
-          const afterValue = fieldEntry.getValue?.() ?? "";
+          let afterValue = fieldEntry.getValue?.() ?? "";
+          if (afterValue === beforeValue) {
+            await sleep3(80);
+            afterValue = fieldEntry.getValue?.() ?? "";
+          }
           if (afterValue === beforeValue) {
             fieldResults.push({
               fieldId,
@@ -3216,7 +3683,7 @@ async function formFillHandler(payload, context) {
         if (effectiveFieldType === "select") {
           let after = fieldEntry.getValue?.() ?? "";
           if (!selectValueApplied(fieldId, value, after, registry)) {
-            await sleep2(80);
+            await sleep3(80);
             after = fieldEntry.getValue?.() ?? "";
           }
           if (!selectValueApplied(fieldId, value, after, registry)) {
@@ -3337,7 +3804,7 @@ async function formFillHandler(payload, context) {
       if (!selectResult.success && selectedChoiceThisBatch) {
         const nextResult = pressContinuationButton(registry);
         if (nextResult.success) {
-          await sleep2(180);
+          await sleep3(180);
           selectResult = await selectVisibleChoice(fieldId, value, registry, {
             allowFirstVisibleWhenNoCue: true
           });
@@ -3348,7 +3815,7 @@ async function formFillHandler(payload, context) {
         appilotsDebugLog(
           `formFillHandler: selected visible option for "${fieldId}"` + (selectResult.selectedLabel ? ` \u2192 "${selectResult.selectedLabel}"` : "")
         );
-        await sleep2(120);
+        await sleep3(120);
         fieldResults.push({ fieldId, success: true });
         continue;
       }
@@ -3360,8 +3827,34 @@ async function formFillHandler(payload, context) {
     });
     if (handle?.setValue) {
       try {
+        if (handle.disabled || (handle.matchCount ?? 1) > 1) {
+          fieldResults.push({
+            fieldId,
+            success: false,
+            error: handle.disabled ? "The field is disabled" : "The field identifier matches multiple controls",
+            diagnose: {
+              category: handle.disabled ? "disabled" : "ambiguous-target",
+              fieldId,
+              screen: screenPath,
+              candidates: handle.matchCandidates
+            }
+          });
+          allSuccess = false;
+          continue;
+        }
+        setSpotlightTarget(handle.measure?.() ?? null, handle.label);
         handle.focus?.();
         handle.setValue(value);
+        if (handle.kind === "field" && !await completeTextEdit(fieldId, value, void 0, handle)) {
+          fieldResults.push({
+            fieldId,
+            success: false,
+            error: "The field did not retain the requested value after editing ended. Inspect its current value before retrying.",
+            diagnose: { category: "validation", fieldId, screen: screenPath }
+          });
+          allSuccess = false;
+          continue;
+        }
         appilotsDebugLog(
           `formFillHandler: fiber fallback succeeded for "${fieldId}" \u2192 label="${handle.label}"`
         );
@@ -3399,13 +3892,25 @@ async function formFillHandler(payload, context) {
     allSuccess = false;
   }
   if (payload.submitAfterFill === true) {
+    if (!permissions.canSubmitForms) {
+      return {
+        success: false,
+        error: "Form submission is not permitted",
+        fieldResults,
+        diagnose: { category: "unknown", screen: screenPath }
+      };
+    }
     if (!allSuccess) {
       const failedIds = fieldResults.filter((result) => !result.success).map((result) => result.fieldId);
       appilotsDebugWarn(
         "formFillHandler: submitAfterFill=true requested but some fields failed; NOT submitting" + (failedIds.length > 0 ? ` (failed: ${failedIds.join(", ")})` : "")
       );
     } else {
-      await sleep2(120);
+      await sleep3(120);
+      if (!permissions.canSubmitForms) {
+        return { success: false, error: "Form submission is not permitted", fieldResults };
+      }
+      const beforeSubmitTexts = captureSnapshot().texts;
       const submitResult = pressSubmitButton(
         {
           screen,
@@ -3425,7 +3930,8 @@ async function formFillHandler(payload, context) {
         };
       }
       const postSubmit = await waitForPostSubmitOutcome({
-        submitTargetId: submitResult.pressedTargetId
+        submitTargetId: submitResult.pressedTargetId,
+        beforeTexts: beforeSubmitTexts
       });
       if (postSubmit.status === "pending") {
         appilotsDebugWarn(`formFillHandler: submit still pending \u2014 ${postSubmit.message}`);
@@ -3452,6 +3958,9 @@ async function formFillHandler(payload, context) {
           }
         };
       }
+      if (postSubmit.status === "unverified") {
+        return { success: true, fieldResults, effect: "unknown" };
+      }
       appilotsDebugLog("formFillHandler: submitAfterFill \u2014 submit completed");
     }
   }
@@ -3589,7 +4098,21 @@ function aggregateFieldDiagnoses(results, screen) {
 var FALLBACK_PAGE_PX = 600;
 var PAGE_FRACTION = 0.85;
 var POST_SCROLL_MOUNT_MS = 400;
-var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
+var PAGINATION_MAX_WAIT_MS = 4e3;
+var PAGINATION_POLL_MS = 150;
+var sleep4 = (ms) => new Promise((r) => setTimeout(r, ms));
+async function settleAfterScroll() {
+  await sleep4(POST_SCROLL_MOUNT_MS);
+  if (!probeLoadingState(void 0, getCurrentScreen()).loading) return;
+  const deadline = Date.now() + PAGINATION_MAX_WAIT_MS;
+  while (Date.now() < deadline) {
+    await sleep4(PAGINATION_POLL_MS);
+    if (!probeLoadingState(void 0, getCurrentScreen()).loading) {
+      await sleep4(POST_SCROLL_MOUNT_MS);
+      return;
+    }
+  }
+}
 function normalizeId2(value) {
   return String(value ?? "").toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "");
 }
@@ -3625,13 +4148,26 @@ function pageOffset(metrics, direction) {
   }
   return next;
 }
+async function finishScroll(entry, before) {
+  await settleAfterScroll();
+  const current2 = listRegistry.get(entry.id) ?? entry;
+  const after = current2.getScrollMetrics?.();
+  const grew = typeof entry.itemCount === "number" && typeof current2.itemCount === "number" && current2.itemCount > entry.itemCount;
+  const moved = grew || !!(before && after && (Math.abs(after.offset - before.offset) > 2 || after.contentLength > before.contentLength + 2));
+  const outcome = moved ? "moved" : before && after ? "no-progress" : "unverified";
+  current2.exploration?.recordScroll(outcome);
+  return {
+    success: true,
+    effect: moved ? "changed" : outcome === "no-progress" ? "none" : "unknown"
+  };
+}
 async function scrollListHandler(payload, context) {
   const { permissions } = context;
   if (!permissions.canInteractUI) {
     return {
       success: false,
-      error: "UI interaction is not permitted",
-      diagnose: buildDiagnose("unknown", payload.listId)
+      error: permissionDeniedMessage("UI interaction", "canInteractUI"),
+      diagnose: { ...buildDiagnose("unknown", payload.listId), recoverable: false }
     };
   }
   const toIndex = typeof payload.toIndex === "number" ? payload.toIndex : void 0;
@@ -3659,6 +4195,15 @@ async function scrollListHandler(payload, context) {
       diagnose: buildDiagnose("component-not-found", payload.listId, candidates)
     };
   }
+  const exploration = entry.exploration?.snapshot();
+  if (exploration && (exploration.remainingScrollSteps === 0 || exploration.consecutiveNoProgress >= 2)) {
+    return {
+      success: false,
+      effect: "none",
+      error: "List exploration stopped: scroll budget exhausted or repeated no progress. Use the current loaded count/coverage and report any remaining uncertainty; do not repeat this scroll.",
+      diagnose: { ...buildDiagnose("validation", entry.id), recoverable: false }
+    };
+  }
   if (toIndex !== void 0) {
     if (entry.kind === "scroll") {
       return {
@@ -3674,17 +4219,16 @@ async function scrollListHandler(payload, context) {
         diagnose: buildDiagnose("validation", entry.id)
       };
     }
+    const before = entry.getScrollMetrics?.();
     const zeroBased = toIndex - 1;
     if (entry.scrollToIndex?.(zeroBased)) {
-      await sleep3(POST_SCROLL_MOUNT_MS);
-      return { success: true };
+      return finishScroll(entry, before);
     }
     const metrics2 = entry.getScrollMetrics?.();
     if (metrics2 && metrics2.contentLength > 0 && typeof entry.itemCount === "number" && entry.itemCount > 0) {
       const estimated = zeroBased / entry.itemCount * metrics2.contentLength;
       if (entry.scrollToOffset?.(Math.max(0, estimated))) {
-        await sleep3(POST_SCROLL_MOUNT_MS);
-        return { success: true };
+        return finishScroll(entry, before);
       }
     }
     return {
@@ -3694,10 +4238,21 @@ async function scrollListHandler(payload, context) {
     };
   }
   const metrics = entry.getScrollMetrics?.();
+  if (!metrics && exploration?.lastScroll === "unverified") {
+    return {
+      success: false,
+      effect: "unknown",
+      error: "Scroll offset is still unavailable after one probe. Cannot safely page again; do not infer the end or repeat the same absolute offset.",
+      diagnose: { ...buildDiagnose("validation", entry.id), recoverable: false }
+    };
+  }
   const target = pageOffset(metrics, direction);
+  if (metrics && Math.abs(target - metrics.offset) <= 2) {
+    entry.exploration?.recordScroll("boundary");
+    return { success: true, effect: "none" };
+  }
   if (entry.scrollToOffset?.(target)) {
-    await sleep3(POST_SCROLL_MOUNT_MS);
-    return { success: true };
+    return finishScroll(entry, metrics);
   }
   return {
     success: false,
@@ -3711,6 +4266,59 @@ async function confirmHandler(_actionId, _payload) {
   return { success: true, effect: "unknown" };
 }
 
+// src/platform/asyncBudget.ts
+var POST_ACTION_LOADING_MAX_MS = 6e3;
+var INFERRED_ASYNC_LOADING_MAX_MS = 1e4;
+var POST_NAVIGATE_LOADING_MAX_MS = 3e3;
+var MAX_DECLARED_ASYNC_BUDGET_MS = 12e4;
+var ASYNC_BUSY_CEILING_MS = MAX_DECLARED_ASYNC_BUDGET_MS;
+function declaredBudgetMs(hints) {
+  const declared = hints?.asyncBudgetMs;
+  if (typeof declared !== "number" || !Number.isFinite(declared) || declared <= 0) return void 0;
+  return Math.min(declared, MAX_DECLARED_ASYNC_BUDGET_MS);
+}
+function resolveSettleCapMs(hints) {
+  const declared = declaredBudgetMs(hints);
+  if (declared !== void 0) return declared;
+  return hints?.isAsyncTrigger === true ? INFERRED_ASYNC_LOADING_MAX_MS : POST_ACTION_LOADING_MAX_MS;
+}
+function resolveBusyCeilingMs(hints) {
+  return declaredBudgetMs(hints) === void 0 ? ASYNC_BUSY_CEILING_MS : void 0;
+}
+function resolvePostNavigateCapMs(hints) {
+  return Math.max(POST_NAVIGATE_LOADING_MAX_MS, declaredBudgetMs(hints) ?? 0);
+}
+function resolveActionHints(screen, pressedComponentId, actionPayload) {
+  if (actionPayload && typeof actionPayload === "object") {
+    const payload = actionPayload;
+    const inline = payload._appilotsInferred;
+    const declared = payload._appilotsAsyncBudgetMs;
+    if (inline && typeof inline === "object") {
+      const hints = { ...inline };
+      if (typeof declared === "number") hints.asyncBudgetMs = declared;
+      return hints;
+    }
+    if (typeof declared === "number") return { asyncBudgetMs: declared };
+  }
+  if (!screen || !pressedComponentId) return void 0;
+  const meta = getScreenMetadata(screen);
+  const actions = meta?.actions;
+  if (!actions || actions.length === 0) return void 0;
+  for (const a of actions) {
+    if (typeof a === "string") continue;
+    if (idLooselyMatches(a.id, pressedComponentId)) {
+      const inferred = a.appilotsInferred;
+      const declared = a.asyncBudgetMs;
+      const hints = {
+        ...inferred && typeof inferred === "object" ? inferred : {},
+        ...typeof declared === "number" ? { asyncBudgetMs: declared } : {}
+      };
+      return Object.keys(hints).length > 0 ? hints : void 0;
+    }
+  }
+  return void 0;
+}
+
 // src/executor/postInteractionSettle.ts
 var sleepMs = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function targetIdFromPayload(payload) {
@@ -3728,7 +4336,7 @@ function hashFieldValue(value) {
   }
   return (hash >>> 0).toString(36);
 }
-var DISCRETE_FIELD_TYPES = /* @__PURE__ */ new Set(["select", "date"]);
+var DISCRETE_FIELD_TYPES = /* @__PURE__ */ new Set(["select", "date", "number"]);
 function discreteFieldSignature() {
   const sigs = [];
   for (const { id, kind } of componentRegistry.snapshot()) {
@@ -3742,12 +4350,23 @@ function discreteFieldSignature() {
   }
   return sigs.sort().join(",");
 }
-async function waitForPostInteractionSettle(payload) {
+function capturePreInteractionBaseline(payload) {
+  const targetId = targetIdFromPayload(payload);
+  const screen = getCurrentScreen();
+  const probe = probeLoadingState(targetId || null, screen);
+  return {
+    fingerprint: probe.fingerprint,
+    fields: discreteFieldSignature(),
+    screen,
+    readable: probe.fingerprint !== ""
+  };
+}
+async function waitForPostInteractionSettle(payload, preBaseline) {
   const targetId = targetIdFromPayload(payload);
-  const fromScreen = getCurrentScreen();
-  const baseline = probeLoadingState(targetId || null, fromScreen);
-  const baselineFields = discreteFieldSignature();
-  const readable = baseline.fingerprint !== "";
+  const baseline = preBaseline ?? capturePreInteractionBaseline(payload);
+  const fromScreen = baseline.screen;
+  const baselineFields = baseline.fields;
+  const readable = baseline.readable;
   await sleepMs(100);
   const afterPress = probeLoadingState(targetId || null, getCurrentScreen());
   const modalOrLoading = afterPress.modalOpen || afterPress.loading || afterPress.pressedDisabled;
@@ -3759,7 +4378,8 @@ async function waitForPostInteractionSettle(payload) {
     if (discreteFieldSignature() !== baselineFields) return { effect: "changed" };
     return { effect: settled.fingerprint !== baseline.fingerprint ? "changed" : "none" };
   };
-  const capMs = isListItemPressTarget(targetId) ? 5e3 : 1e4;
+  const declared = declaredBudgetMs(resolveActionHints(fromScreen, targetId || null, payload));
+  const capMs = declared ?? (isListItemPressTarget(targetId) ? 5e3 : 1e4);
   if (modalOrLoading || fingerprintChanged) {
     await waitForLoadingSettle({
       pressedComponentId: targetId || null,
@@ -3778,12 +4398,6 @@ async function waitForPostInteractionSettle(payload) {
 }
 
 // src/executor/ActionExecutor.ts
-var DEFAULT_PERMISSIONS = {
-  canNavigate: true,
-  canFillForms: true,
-  canInteractUI: true,
-  canSubmitForms: true
-};
 function validateActionPayload(action) {
   const invalid = (message, ids) => ({
     success: false,
@@ -3854,7 +4468,7 @@ async function executeAction(action, context) {
   appilotsDebugLog(
     `executeAction called: type="${action.type}", id="${action.id}", payload=${JSON.stringify(action.payload)}`
   );
-  const permissions = context.permissions ?? DEFAULT_PERMISSIONS;
+  const permissions = resolveAgentPermissions(context.permissions);
   context.emit({
     type: "agent:action:start",
     timestamp: Date.now(),
@@ -3912,12 +4526,13 @@ async function executeAction(action, context) {
         break;
       case "ui_interaction": {
         const payload = action.payload;
+        const baseline = capturePreInteractionBaseline(payload);
         result = uiInteractionHandler(payload, {
           permissions,
           registry: context.registry ?? getDefaultRegistry()
         });
         if (result.success) {
-          const settle = await waitForPostInteractionSettle(payload);
+          const settle = await waitForPostInteractionSettle(payload, baseline);
           result.effect = result.effect ?? effectFor(payload, settle.effect);
         }
         break;
@@ -4005,18 +4620,28 @@ var _patchedAlert = (title, message, buttons, options) => {
     return suppression.originalAlert(title, message, buttons, options);
   }
   suppression.consumed = true;
+  const report = (handlerCompleted) => suppression.onHandled?.({
+    title: title.slice(0, 300),
+    message: message?.slice(0, 1e3),
+    buttonLabel: button.text?.slice(0, 160),
+    handlerCompleted
+  });
   appilotsDebugLog("Suppressing native Alert during already-confirmed destructive agent action");
   try {
-    suppression.pending = Promise.resolve(button.onPress()).then(() => void 0).catch((err) => reportHandlerFailure(err));
+    suppression.pending = Promise.resolve(button.onPress()).then(() => report(true)).catch((err) => {
+      reportHandlerFailure(err);
+      report(false);
+    });
   } catch (err) {
     reportHandlerFailure(err);
     suppression.pending = null;
+    report(false);
   }
 };
 function reportHandlerFailure(err) {
   console.error("[Appilots] The app\u2019s Alert handler threw while being auto-confirmed", err);
 }
-async function runWithConfirmedDestructiveContext(enabled, host, fn) {
+async function runWithConfirmedDestructiveContext(enabled, host, fn, onHandled) {
   if (!enabled) return fn();
   if (_active) {
     _active.depth += 1;
@@ -4037,6 +4662,7 @@ async function runWithConfirmedDestructiveContext(enabled, host, fn) {
     depth: 1,
     consumed: false,
     pending: null,
+    onHandled,
     timer: null
   };
   _active = suppression;
@@ -4056,7 +4682,7 @@ async function runWithConfirmedDestructiveContext(enabled, host, fn) {
 }
 
 // src/platform/reactNativeAdapter.ts
-var POST_ACTION_LOADING_MAX_MS = 6e3;
+var deltaTracker = createSnapshotDeltaTracker();
 function resolveScreenMetadata() {
   const activePath = getActiveRouteNames();
   for (let i = activePath.length - 1; i >= 0; i--) {
@@ -4070,8 +4696,14 @@ function resolveScreenMetadata() {
   return screen ? getScreenMetadata(screen) : void 0;
 }
 function buildAgentContext(extras = {}) {
+  if (extras.newMission === true) {
+    deltaTracker.reset();
+    for (const entry of listRegistry.snapshot()) entry.exploration?.reset();
+  }
   const context = {};
   context.platform = "react-native";
+  context.missionProtocol = 1;
+  context.deviceLocale = detectDeviceLocale() ?? "en";
   const screen = getCurrentScreen();
   if (screen) context.currentScreen = screen;
   const navigationState = getNavigationStateSnapshot();
@@ -4079,7 +4711,16 @@ function buildAgentContext(extras = {}) {
   const screenMeta = resolveScreenMetadata();
   if (screenMeta) context.screenMetadata = screenMeta;
   try {
-    context.snapshot = captureSnapshot();
+    const snapshot = captureSnapshot();
+    for (const list of snapshot.lists) {
+      const memory = list.id ? listRegistry.get(list.id)?.exploration : void 0;
+      if (!memory) continue;
+      memory.observe(list.items);
+      list.exploration = memory.snapshot();
+    }
+    const delta = deltaTracker.observe(snapshot);
+    if (delta) snapshot.delta = delta;
+    context.snapshot = snapshot;
   } catch (err) {
     appilotsDebugWarn("buildAgentContext: captureSnapshot failed", err);
   }
@@ -4088,40 +4729,40 @@ function buildAgentContext(extras = {}) {
   if (filtered.length > 0) context.registeredComponents = filtered;
   const registeredLists = listRegistry.snapshot();
   if (registeredLists.length > 0) {
-    context.registeredLists = registeredLists.map(
-      ({ scrollToIndex, scrollToOffset, getScrollMetrics, dataPreview, ...rest }) => rest
+    const snapshot = context.snapshot;
+    const activeIds = new Set(
+      [...snapshot?.lists ?? [], ...snapshot?.scrollables ?? []].map((l) => l.id)
     );
+    context.registeredLists = registeredLists.filter((entry) => activeIds.has(entry.id)).map(({ id, kind, component, itemCount, totalItemCount, label, refreshing, empty }) => ({
+      id,
+      kind,
+      component,
+      itemCount,
+      totalItemCount,
+      label,
+      refreshing,
+      empty
+    }));
   }
   if (extras.loadingPending === true) context.loadingPending = true;
   return context;
 }
-function resolveActionHints(screen, pressedComponentId, actionPayload) {
-  if (actionPayload && typeof actionPayload === "object") {
-    const inline = actionPayload._appilotsInferred;
-    if (inline && typeof inline === "object") {
-      return inline;
-    }
-  }
-  if (!screen || !pressedComponentId) return void 0;
-  const meta = getScreenMetadata(screen);
-  const actions = meta?.actions;
-  if (!actions || actions.length === 0) return void 0;
-  for (const a of actions) {
-    if (typeof a === "string") continue;
-    if (idLooselyMatches(a.id, pressedComponentId)) {
-      const inferred = a.appilotsInferred;
-      if (inferred && typeof inferred === "object") return inferred;
-      return void 0;
-    }
-  }
-  return void 0;
-}
 async function settleTurn(input) {
   const toolWithoutEffectIds = /* @__PURE__ */ new Set();
   let loadingPending = false;
   const { turnActions, pressedComponentId: pressedId, navigateTargetScreen } = input;
   const successById = new Map(input.results.map((r) => [r.actionId, r.success]));
+  const effectById = new Map(input.results.map((r) => [r.actionId, r.effect]));
   const typeById = new Map(input.results.map((r) => [r.actionId, r.type]));
+  const pressedAction = turnActions.find(
+    (a) => a.type === "ui_interaction" && a.payload?.componentId === pressedId
+  );
+  const hints = resolveActionHints(
+    getCurrentScreen(),
+    pressedId,
+    pressedAction?.payload
+  );
+  const capSource = typeof hints?.asyncBudgetMs === "number" && hints.asyncBudgetMs > 0 ? " (app-declared)" : hints?.isAsyncTrigger ? " (mcp-inferred)" : "";
   if (input.hadNavigate) {
     const settle = await waitForScreenSettle({
       expectingChange: true,
@@ -4142,27 +4783,26 @@ async function settleTurn(input) {
         if (type === "navigate") toolWithoutEffectIds.add(actionId);
       }
     }
+    const postNavigateCapMs = resolvePostNavigateCapMs(hints);
     const loadSettle = await waitForLoadingSettle({
       fromScreen: settle.screen ?? null,
-      maxMs: 3e3
+      maxMs: postNavigateCapMs
     });
     appilotsDebugLog(
-      `settleTurn: post-navigate loading settle \u2014 settled=${loadSettle.settled} loadingPending=${loadSettle.loadingPending} probes=${loadSettle.probeCount} waitedMs=${loadSettle.waitedMs}`
+      `settleTurn: post-navigate loading settle \u2014 settled=${loadSettle.settled} loadingPending=${loadSettle.loadingPending} probes=${loadSettle.probeCount} waitedMs=${loadSettle.waitedMs} cap=${postNavigateCapMs}${capSource}`
     );
     if (loadSettle.loadingPending) loadingPending = true;
   } else {
-    const pressedAction = turnActions.find(
-      (a) => a.type === "ui_interaction" && a.payload?.componentId === pressedId
-    );
-    const hints = resolveActionHints(getCurrentScreen(), pressedId, pressedAction?.payload);
-    const settleCapMs = hints?.isAsyncTrigger === true ? 1e4 : POST_ACTION_LOADING_MAX_MS;
+    const settleCapMs = resolveSettleCapMs(hints);
+    const busyMaxMs = resolveBusyCeilingMs(hints);
     const loadSettle = await waitForLoadingSettle({
       pressedComponentId: pressedId,
       fromScreen: getCurrentScreen(),
-      maxMs: settleCapMs
+      maxMs: settleCapMs,
+      ...busyMaxMs !== void 0 ? { busyMaxMs } : {}
     });
     appilotsDebugLog(
-      `settleTurn: post-action loading settle \u2014 pressedId="${pressedId ?? ""}" settled=${loadSettle.settled} transitioned=${loadSettle.transitioned} loadingPending=${loadSettle.loadingPending} probes=${loadSettle.probeCount} waitedMs=${loadSettle.waitedMs} cap=${settleCapMs}${hints?.isAsyncTrigger ? " (mcp-inferred)" : ""}`
+      `settleTurn: post-action loading settle \u2014 pressedId="${pressedId ?? ""}" settled=${loadSettle.settled} transitioned=${loadSettle.transitioned} loadingPending=${loadSettle.loadingPending} probes=${loadSettle.probeCount} waitedMs=${loadSettle.waitedMs} cap=${settleCapMs}${capSource}${busyMaxMs !== void 0 ? ` busyCap=${busyMaxMs}` : ""}`
     );
     if (loadSettle.loadingPending) loadingPending = true;
     const listPressActions = turnActions.filter((action) => {
@@ -4188,6 +4828,7 @@ async function settleTurn(input) {
       );
       if (!postPressSettle.transitioned && baselineFingerprint === afterFingerprint) {
         for (const action of listPressActions) {
+          if (effectById.get(action.id) === "changed") continue;
           if (successById.get(action.id)) {
             toolWithoutEffectIds.add(action.id);
           }
@@ -4205,18 +4846,40 @@ var reactNativeChatAdapter = {
 };
 function createReactNativeActionRunner(getOptions) {
   return {
+    buildMissionContext: () => reactNativeChatAdapter.buildContext(),
     async execute(action, { confirmedDestructive }) {
-      const { permissions, emit, navigationRef, suppressNativeConfirm } = getOptions();
+      const { permissions, emit: emit2, navigationRef, suppressNativeConfirm } = getOptions();
       const navRef = navigationRef?.current ? navigationRef : { current: getNavigationRef() };
-      return runWithConfirmedDestructiveContext(
+      let receipt;
+      let terminal;
+      const result = await runWithConfirmedDestructiveContext(
         confirmedDestructive && suppressNativeConfirm !== false,
         Alert,
         () => executeAction(action, {
           navigationRef: navRef,
           permissions,
-          emit
-        })
+          emit: (event) => {
+            if (confirmedDestructive && (event.type === "agent:action:complete" || event.type === "agent:action:error"))
+              terminal = event;
+            else emit2(event);
+          }
+        }),
+        (handled) => {
+          receipt = handled;
+        }
       );
+      const failed = receipt?.handlerCompleted === false;
+      if (terminal)
+        emit2({
+          ...terminal,
+          type: failed ? "agent:action:error" : terminal.type,
+          data: {
+            ...terminal.data,
+            ...receipt ? { nativeConfirmation: receipt } : {},
+            ...failed ? { success: false, error: "Native confirmation callback failed" } : {}
+          }
+        });
+      return failed ? { ...result, success: false, error: "Native confirmation callback failed" } : result;
     },
     getCurrentScreen,
     getCurrentScreenSignature,
@@ -4229,16 +4892,16 @@ function createReactNativeActionRunner(getOptions) {
 
 // src/hooks/useAppilotsChat.ts
 function useAppilotsChat(options = {}) {
-  const { client, emit, subscribe } = useAppilotsContext();
+  const { client, emit: emit2, subscribe } = useAppilotsContext();
   const machine = useMemo(
     () => new ChatSessionMachine(
-      { client, adapter: reactNativeChatAdapter, emit, warn: appilotsDebugWarn },
+      { client, adapter: reactNativeChatAdapter, emit: emit2, warn: appilotsDebugWarn },
       options
     ),
     // A new machine per client/provider instance — options are pushed in
     // below so changing copy never resets the transcript.
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    [client, emit]
+    [client, emit2]
   );
   const optionsRef = useRef(options);
   optionsRef.current = options;
@@ -4246,6 +4909,14 @@ function useAppilotsChat(options = {}) {
   const state = useSyncExternalStore(machine.subscribeState, machine.getState, machine.getState);
   useEffect(() => subscribe(machine.handleEvent), [subscribe, machine]);
   useEffect(() => () => machine.dispose(), [machine]);
+  useEffect(() => {
+    void machine.restoreMission();
+    const subscription = AppState?.addEventListener?.("change", (next) => {
+      if (next !== "active" && machine.getState().mission?.status === "running")
+        void machine.pauseMission();
+    });
+    return () => subscription?.remove();
+  }, [machine]);
   const requestHuman = useCallback(
     (reason) => machine.requestHuman(reason),
     [machine]
@@ -4255,7 +4926,13 @@ function useAppilotsChat(options = {}) {
   const clearMessages = useCallback(() => machine.clearMessages(), [machine]);
   const clearError = useCallback(() => machine.clearError(), [machine]);
   return {
+    mission: state.mission,
+    pauseMission: () => machine.pauseMission(),
+    resumeMission: () => machine.resumeMission(),
+    cancelMission: () => machine.cancelMission(),
+    hasStartedActing: state.hasStartedActing,
     messages: state.messages,
+    replyLocale: state.replyLocale,
     isLoading: state.isLoading,
     loadingStatusKey: state.loadingStatusKey,
     error: state.error,
@@ -4268,24 +4945,18 @@ function useAppilotsChat(options = {}) {
     clearError
   };
 }
-var DEFAULT_PERMISSIONS2 = {
-  canNavigate: true,
-  canFillForms: true,
-  canInteractUI: true,
-  canSubmitForms: true
-};
 function useAppilotsActions(options = {}) {
-  const { client, subscribe, config, emit } = useAppilotsContext();
+  const { client, subscribe, config, emit: emit2 } = useAppilotsContext();
   const { navigationRef, autoExecute = false } = options;
   const runnerOptionsRef = useRef({
-    permissions: config.permissions ?? DEFAULT_PERMISSIONS2,
-    emit,
+    permissions: resolveAgentPermissions(config.permissions),
+    emit: emit2,
     navigationRef,
     suppressNativeConfirm: config.suppressNativeConfirm
   });
   runnerOptionsRef.current = {
-    permissions: config.permissions ?? DEFAULT_PERMISSIONS2,
-    emit,
+    permissions: resolveAgentPermissions(config.permissions),
+    emit: emit2,
     navigationRef,
     suppressNativeConfirm: config.suppressNativeConfirm
   };
@@ -4294,13 +4965,13 @@ function useAppilotsActions(options = {}) {
       {
         client,
         adapter: createReactNativeActionRunner(() => runnerOptionsRef.current),
-        emit,
+        emit: emit2,
         warn: appilotsDebugWarn
       },
       { autoExecute }
     ),
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    [client, emit]
+    [client, emit2]
   );
   machine.setOptions({ autoExecute });
   const state = useSyncExternalStore(machine.subscribeState, machine.getState, machine.getState);
@@ -4390,9 +5061,9 @@ function useSuggestedPrompts(options) {
     if (!enabled) return;
     let lastScreen = getCurrentScreen();
     const interval = setInterval(() => {
-      const current = getCurrentScreen();
-      if (current !== lastScreen) {
-        lastScreen = current;
+      const current2 = getCurrentScreen();
+      if (current2 !== lastScreen) {
+        lastScreen = current2;
         setRefreshTick((t) => t + 1);
       }
     }, 800);
@@ -4405,7 +5076,7 @@ function useSuggestedPrompts(options) {
   };
 }
 function useAppilotsNavigation() {
-  const { emit } = useAppilotsContext();
+  const { emit: emit2 } = useAppilotsContext();
   const [currentScreen, setCurrentScreenState] = useState(null);
   const [navigationHistory, setNavigationHistory] = useState([]);
   const navigationRef = useRef(null);
@@ -4414,13 +5085,13 @@ function useAppilotsNavigation() {
       setCurrentScreenState(screenName);
       setCurrentScreen(screenName);
       setNavigationHistory((prev) => [...prev, screenName]);
-      emit({
+      emit2({
         type: "navigation:change",
         timestamp: Date.now(),
         data: { screenName }
       });
     },
-    [emit]
+    [emit2]
   );
   useEffect(() => {
     const nav = navigationRef.current;
@@ -4470,6 +5141,11 @@ function useAppilots() {
     rejectAction: actions.rejectAction
   };
 }
+function useAppilotsElementProps(id) {
+  return useMemo(() => ({ testID: id }), [id]);
+}
+
+// src/hooks/useAppilotsField.ts
 function useAppilotsField(id, options) {
   const { value, onChangeText, ref, fieldType, label, screen } = options;
   const registry = useResolvedRegistry();
@@ -4497,6 +5173,7 @@ function useAppilotsField(id, options) {
       registry.unregister(id);
     };
   }, [id, registry, getValue, setValue, focus, ref, fieldType, label, screen]);
+  return useAppilotsElementProps(id);
 }
 function useAppilotsTarget(id, options) {
   const { onPress, onLongPress, onScrollTo, label, screen } = options;
@@ -4524,6 +5201,7 @@ function useAppilotsTarget(id, options) {
       registry.unregister(id);
     };
   }, [id, registry, press, longPress, scrollTo, onLongPress, onScrollTo, label, screen]);
+  return useAppilotsElementProps(id);
 }
 function useAppilotsToggle(id, options) {
   const { value, onValueChange, label, screen } = options;
@@ -4547,6 +5225,7 @@ function useAppilotsToggle(id, options) {
       registry.unregister(id);
     };
   }, [id, registry, getValue, setValue, label, screen]);
+  return useAppilotsElementProps(id);
 }
 function useAppilotsSlider(id, options) {
   const { value, onValueChange, min, max, step, label, screen } = options;
@@ -4573,6 +5252,7 @@ function useAppilotsSlider(id, options) {
       registry.unregister(id);
     };
   }, [id, registry, getValue, setValue, min, max, step, label, screen]);
+  return useAppilotsElementProps(id);
 }
 
-export { appilotsSelfCheck, captureSnapshot, executeAction, shouldShowSuggestedPrompts, useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts };
+export { AppilotsI18nProvider, REVEAL_MARGIN, SPOTLIGHT_TTL_MS, appilotsSelfCheck, captureSnapshot, detectDeviceLocale, executeAction, getSpotlightMode, getSpotlightTarget, offsetToReveal, resolveLocale, revealTarget, setSpotlightMode, setSpotlightTarget, shouldShowSuggestedPrompts, subscribeSpotlight, useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsI18n, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts };