@appilots/sdk 0.11.1 → 0.13.0

package/dist/{chunk-X4MPSZL3.js → chunk-AJDHZRBN.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkKZ2BLMS4_js = require('./chunk-KZ2BLMS4.js');
+var chunkUZ2D4BVX_js = require('./chunk-UZ2D4BVX.js');
 var React = require('react');
 var reactNative = require('react-native');
 
@@ -8,6 +8,261 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var React__default = /*#__PURE__*/_interopDefault(React);
 
+// 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 (reactNative.Platform.OS === "ios") {
+      const manager = reactNative.NativeModules?.SettingsManager;
+      const settings = manager?.getConstants?.()?.settings ?? manager?.settings;
+      const languages = Array.isArray(settings?.AppleLanguages) ? settings.AppleLanguages : [];
+      for (const language of languages) {
+        const locale = chunkUZ2D4BVX_js.normalizeAppilotsLocale(language);
+        if (locale) return locale;
+      }
+      raw = settings?.AppleLocale;
+    } else if (reactNative.Platform.OS === "android") {
+      const manager = reactNative.NativeModules?.I18nManager;
+      raw = manager?.getConstants?.()?.localeIdentifier ?? manager?.localeIdentifier;
+    }
+    if (!raw || typeof raw !== "string") return null;
+    return chunkUZ2D4BVX_js.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 = React.createContext(null);
+function AppilotsI18nProvider({ locale, overrides, children }) {
+  const value = React.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__default.default.createElement(I18nContext.Provider, { value }, children);
+}
+function useAppilotsI18n() {
+  const ctx = React.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) {
   return (value ?? "").toLowerCase().replace(/^slider[-_]/, "");
@@ -23,9 +278,9 @@ function fiberSliderMatches(fiber, registryId, registryLabel) {
 function reconcileSliders(snapshot) {
   const fiberSliders = snapshot.sliders;
   const out = [];
-  for (const { id, kind } of chunkKZ2BLMS4_js.componentRegistry.snapshot()) {
+  for (const { id, kind } of chunkUZ2D4BVX_js.componentRegistry.snapshot()) {
     if (kind !== "slider") continue;
-    const entry = chunkKZ2BLMS4_js.componentRegistry.getSlider(id);
+    const entry = chunkUZ2D4BVX_js.componentRegistry.getSlider(id);
     if (!entry) continue;
     const fiber = fiberSliders.find((s) => fiberSliderMatches(s, id, entry.label));
     const visible = !!fiber || typeof entry.screen === "string" && entry.screen === snapshot.route;
@@ -53,7 +308,7 @@ function normalizeFieldKey(value) {
 }
 function canonicalizeRegisteredFields(snapshot) {
   const claimed = /* @__PURE__ */ new Set();
-  for (const { id, kind, label } of chunkKZ2BLMS4_js.componentRegistry.snapshot()) {
+  for (const { id, kind, label } of chunkUZ2D4BVX_js.componentRegistry.snapshot()) {
     if (kind !== "field") continue;
     if (snapshot.inputs.some((input) => input.id === id)) continue;
     const registryLabel = (label ?? "").toLowerCase();
@@ -72,7 +327,7 @@ function canonicalizeRegisteredFields(snapshot) {
   }
 }
 function mergeRegisteredLists(snapshot) {
-  const registered = chunkKZ2BLMS4_js.listRegistry.snapshot();
+  const registered = chunkUZ2D4BVX_js.listRegistry.snapshot();
   if (registered.length === 0) return;
   const byId = /* @__PURE__ */ new Map();
   for (const list of snapshot.lists) {
@@ -80,20 +335,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 = chunkUZ2D4BVX_js.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;
       }
@@ -110,6 +380,7 @@ function mergeRegisteredLists(snapshot) {
       containerType: entry.component,
       source: "registry",
       itemCount: entry.itemCount,
+      totalItemCount: entry.totalItemCount,
       visibleItemCount: 0,
       refreshing: entry.refreshing,
       empty: entry.empty,
@@ -121,7 +392,7 @@ function mergeRegisteredLists(snapshot) {
   }
 }
 function mergeRegisteredScrollables(snapshot) {
-  const registered = chunkKZ2BLMS4_js.listRegistry.snapshot().filter((e) => e.kind === "scroll");
+  const registered = chunkUZ2D4BVX_js.listRegistry.snapshot().filter((e) => e.kind === "scroll");
   if (registered.length === 0) return;
   const listsById = /* @__PURE__ */ new Map();
   for (const list of snapshot.lists) {
@@ -154,7 +425,7 @@ function mergeRegisteredScrollables(snapshot) {
   if (out.length > 0) snapshot.scrollables = out;
 }
 function mergeNativeDialog(snapshot) {
-  const dialog = chunkKZ2BLMS4_js.getOpenNativeDialog();
+  const dialog = chunkUZ2D4BVX_js.getOpenNativeDialog();
   if (!dialog) return;
   snapshot.nativeDialog = {
     id: dialog.id,
@@ -169,21 +440,58 @@ function mergeNativeDialog(snapshot) {
 }
 var MIN_FIBERS_FOR_BLINDNESS = 200;
 function recordBlindWalk() {
-  const walk = chunkKZ2BLMS4_js.getLastWalkDiagnostics();
+  const walk = chunkUZ2D4BVX_js.getLastWalkDiagnostics();
   if (!walk) return;
   if (walk.visitedFibers < MIN_FIBERS_FOR_BLINDNESS) return;
-  if (chunkKZ2BLMS4_js.totalDetectorHits(walk.detectors) > 0) return;
-  chunkKZ2BLMS4_js.recordIntrospectionFailure("walk-recognized-nothing", null);
+  if (chunkUZ2D4BVX_js.totalDetectorHits(walk.detectors) > 0) return;
+  chunkUZ2D4BVX_js.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 chunkUZ2D4BVX_js.componentRegistry.snapshot()) {
+    if (kind !== "field") continue;
+    const key = normalizeFieldKey(id);
+    if (!key || present.has(key)) continue;
+    const entry = chunkUZ2D4BVX_js.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 && !chunkUZ2D4BVX_js.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 = chunkKZ2BLMS4_js.getFiberRoot();
+  const root = chunkUZ2D4BVX_js.getFiberRoot();
   if (!root) {
-    chunkKZ2BLMS4_js.appilotsDebugWarn(
+    chunkUZ2D4BVX_js.appilotsDebugWarn(
       "captureSnapshot: fiber root not captured yet. Ensure <AppilotsProvider> has rendered before calling this."
     );
-    chunkKZ2BLMS4_js.recordIntrospectionFailure("never-mounted", null);
+    chunkUZ2D4BVX_js.recordIntrospectionFailure("never-mounted", null);
     return {
-      route: chunkKZ2BLMS4_js.getCurrentScreen(),
+      route: chunkUZ2D4BVX_js.getCurrentScreen(),
       texts: [],
       inputs: [],
       buttons: [],
@@ -197,9 +505,9 @@ function captureSnapshot() {
     };
   }
   const start = Date.now();
-  const snapshot = chunkKZ2BLMS4_js.walkFiber(root);
+  const snapshot = chunkUZ2D4BVX_js.walkFiber(root);
   recordBlindWalk();
-  const activePath = chunkKZ2BLMS4_js.getActiveRouteNames();
+  const activePath = chunkUZ2D4BVX_js.getActiveRouteNames();
   const deepestRoute = activePath[activePath.length - 1];
   if (deepestRoute) snapshot.route = deepestRoute;
   mergeRegisteredLists(snapshot);
@@ -207,15 +515,16 @@ function captureSnapshot() {
   mergeNativeDialog(snapshot);
   reconcileSliders(snapshot);
   canonicalizeRegisteredFields(snapshot);
-  chunkKZ2BLMS4_js.clampSnapshotToWireLimits(snapshot);
-  const entries = chunkKZ2BLMS4_js.deriveInteractionElements(snapshot, { rectOf: chunkKZ2BLMS4_js.rectForNode });
+  mergeRegisteredFieldValues(snapshot);
+  chunkUZ2D4BVX_js.clampSnapshotToWireLimits(snapshot);
+  const entries = chunkUZ2D4BVX_js.deriveInteractionElements(snapshot, { rectOf: chunkUZ2D4BVX_js.rectForNode });
   const rectById = new Map(
     entries.flatMap((entry) => entry.rect ? [[entry.id, entry.rect]] : [])
   );
-  snapshot.elements = entries.map(chunkKZ2BLMS4_js.toWireElement);
-  snapshot.choiceGroups = chunkKZ2BLMS4_js.attachElementIdsToChoiceGroups(snapshot.choiceGroups, snapshot.elements);
-  chunkKZ2BLMS4_js.clampSnapshotToWireLimits(snapshot);
-  chunkKZ2BLMS4_js.elementRegistry.replaceAll(
+  snapshot.elements = entries.map(chunkUZ2D4BVX_js.toWireElement);
+  snapshot.choiceGroups = chunkUZ2D4BVX_js.attachElementIdsToChoiceGroups(snapshot.choiceGroups, snapshot.elements);
+  chunkUZ2D4BVX_js.clampSnapshotToWireLimits(snapshot);
+  chunkUZ2D4BVX_js.elementRegistry.replaceAll(
     snapshot.elements.map((element) => {
       const rect = rectById.get(element.id);
       return rect ? { ...element, rect } : element;
@@ -227,10 +536,10 @@ function captureSnapshot() {
     (acc, l) => acc + (typeof l.itemCount === "number" ? l.itemCount : 0),
     0
   );
-  chunkKZ2BLMS4_js.appilotsDebugLog(
+  chunkUZ2D4BVX_js.appilotsDebugLog(
     `captureSnapshot: route="${snapshot.route}" texts=${snapshot.texts.length} inputs=${snapshot.inputs.length} buttons=${snapshot.buttons.length} toggles=${snapshot.toggles.length} sliders=${snapshot.sliders.length} loading=${snapshot.loading} modal=${snapshot.modalOpen} lists=${snapshot.lists.length}(visibleItems=${totalListItems}, dataItems=${totalListDataItems}) choices=${snapshot.choiceGroups.length} elements=${snapshot.elements.length} ` + (snapshot.truncated ? "truncated=true " : "") + `(walked ${snapshot.stats?.visitedFibers ?? 0} fibers, skipped ${snapshot.stats?.skippedHidden ?? 0} hidden, ${elapsed}ms)`
   );
-  chunkKZ2BLMS4_js.appilotsDebugLog(
+  chunkUZ2D4BVX_js.appilotsDebugLog(
     `captureSnapshot detail: lists=[${snapshot.lists.map((l) => `${l.containerType}:${l.id ?? l.label ?? "?"}(rows=${l.items.length})`).join(", ")}] inputs=[${snapshot.inputs.map((i) => i.id ?? i.label ?? "?").slice(0, 12).join(", ")}] buttons=[${snapshot.buttons.map((b) => b.id ?? b.label ?? "?").slice(0, 15).join(", ")}]`
   );
   return snapshot;
@@ -241,10 +550,10 @@ function registryCounts() {
     toggles: 0,
     sliders: 0,
     targets: 0,
-    lists: chunkKZ2BLMS4_js.listRegistry.snapshot().length,
-    elements: chunkKZ2BLMS4_js.elementRegistry.size
+    lists: chunkUZ2D4BVX_js.listRegistry.snapshot().length,
+    elements: chunkUZ2D4BVX_js.elementRegistry.size
   };
-  for (const { kind } of chunkKZ2BLMS4_js.componentRegistry.snapshot()) {
+  for (const { kind } of chunkUZ2D4BVX_js.componentRegistry.snapshot()) {
     if (kind === "field") counts.fields++;
     else if (kind === "toggle") counts.toggles++;
     else if (kind === "slider") counts.sliders++;
@@ -253,26 +562,26 @@ function registryCounts() {
   return counts;
 }
 function appilotsSelfCheck() {
-  const root = chunkKZ2BLMS4_js.getFiberRoot();
+  const root = chunkUZ2D4BVX_js.getFiberRoot();
   const start = Date.now();
-  if (root) chunkKZ2BLMS4_js.walkFiber(root);
+  if (root) chunkUZ2D4BVX_js.walkFiber(root);
   const elapsedMs = Date.now() - start;
-  const walk = chunkKZ2BLMS4_js.getLastWalkDiagnostics();
+  const walk = chunkUZ2D4BVX_js.getLastWalkDiagnostics();
   return {
-    sdkVersion: chunkKZ2BLMS4_js.SDK_VERSION,
+    sdkVersion: chunkUZ2D4BVX_js.SDK_VERSION,
     reactVersion: React__default.default.version ?? null,
-    route: chunkKZ2BLMS4_js.getCurrentScreen() || null,
-    introspection: chunkKZ2BLMS4_js.getIntrospectionDiagnostics(),
-    autoTracking: chunkKZ2BLMS4_js.getAutoTrackingState(),
+    route: chunkUZ2D4BVX_js.getCurrentScreen() || null,
+    introspection: chunkUZ2D4BVX_js.getIntrospectionDiagnostics(),
+    autoTracking: chunkUZ2D4BVX_js.getAutoTrackingState(),
     walk: {
       visitedFibers: root ? walk?.visitedFibers ?? 0 : 0,
       skippedHidden: root ? walk?.skippedHidden ?? 0 : 0,
       elapsedMs
     },
-    detectors: root ? walk?.detectors ?? chunkKZ2BLMS4_js.emptyDetectorCounts() : chunkKZ2BLMS4_js.emptyDetectorCounts(),
+    detectors: root ? walk?.detectors ?? chunkUZ2D4BVX_js.emptyDetectorCounts() : chunkUZ2D4BVX_js.emptyDetectorCounts(),
     registry: registryCounts(),
-    nameMangling: chunkKZ2BLMS4_js.getNameManglingProbe(),
-    geometry: { availability: chunkKZ2BLMS4_js.geometryAvailability(), ...chunkKZ2BLMS4_js.geometryStats() }
+    nameMangling: chunkUZ2D4BVX_js.getNameManglingProbe(),
+    geometry: { availability: chunkUZ2D4BVX_js.geometryAvailability(), ...chunkUZ2D4BVX_js.geometryStats() }
   };
 }
 
@@ -285,7 +594,7 @@ function declaredState(props) {
   return typeof checked === "boolean" ? checked : void 0;
 }
 function isReactNativeSwitch(fiber) {
-  return chunkKZ2BLMS4_js.getTypeName(fiber?.type) === "Switch" || chunkKZ2BLMS4_js.getTypeName(fiber?.elementType) === "Switch";
+  return chunkUZ2D4BVX_js.getTypeName(fiber?.type) === "Switch" || chunkUZ2D4BVX_js.getTypeName(fiber?.elementType) === "Switch";
 }
 var SWITCH_FLIP_HANDLERS = ["onValueChange", "onChange", "onPress"];
 function flipSwitchFiber(fiber, next) {
@@ -309,6 +618,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;
@@ -383,7 +697,7 @@ function shouldSkipSubtree2(fiber) {
   const typeName = getTypeName2(fiber.type) ?? getTypeName2(fiber.elementType);
   if (typeName && SELF_REFERENTIAL_COMPONENTS.has(typeName)) return true;
   if (isAppilotsSkipMarked(props)) return true;
-  if (chunkKZ2BLMS4_js.isModalFiber(fiber) && props.visible === false) return true;
+  if (chunkUZ2D4BVX_js.isModalFiber(fiber) && props.visible === false) return true;
   if (matchesName(fiber, "Screen") && props.activityState === 0) return true;
   const style = props.style;
   if (style) {
@@ -393,9 +707,14 @@ function shouldSkipSubtree2(fiber) {
   }
   return false;
 }
-var normalize = chunkKZ2BLMS4_js.foldForCompare;
+var normalize = chunkUZ2D4BVX_js.foldForCompare;
 function scoreMatchDetail(fiber, queryNorm, queryRaw) {
   const props = fiber.memoizedProps ?? {};
+  if (chunkUZ2D4BVX_js.isSourceControlId(queryRaw)) {
+    const matches = chunkUZ2D4BVX_js.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")
@@ -414,11 +733,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);
@@ -428,12 +747,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: () => chunkUZ2D4BVX_js.endTextInputEditing(getProps()),
     setValue: (value) => {
       const { onChangeText, onChange } = getProps();
       if (typeof onChangeText === "function") {
@@ -468,7 +793,7 @@ function wrapSwitch(fiber) {
     // `accessibilityRole="switch"`) has only the former, and reporting
     // `false` for a control that is on is worse than reporting nothing:
     // the caller inverts this to decide where to move.
-    getValue: () => chunkKZ2BLMS4_js.switchValue(getProps()),
+    getValue: () => chunkUZ2D4BVX_js.switchValue(getProps()),
     setValue: (value) => {
       const boolVal = typeof value === "boolean" ? value : value === "true" || value === true;
       const flipped = flipSwitchFiber(fiber, boolVal);
@@ -514,18 +839,18 @@ 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;
 }
 function findInteractiveByIdentifier(query, options = {}) {
-  const root = chunkKZ2BLMS4_js.getFiberRoot();
+  const root = chunkUZ2D4BVX_js.getFiberRoot();
   if (!root) {
-    chunkKZ2BLMS4_js.appilotsDebugWarn("findInteractiveByIdentifier: fiber root not captured yet");
+    chunkUZ2D4BVX_js.appilotsDebugWarn("findInteractiveByIdentifier: fiber root not captured yet");
     return null;
   }
   const queryNorm = normalize(query);
@@ -538,18 +863,20 @@ 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;
     if (matchesName(fiber, "TextInput")) kind = "field";
-    else if (chunkKZ2BLMS4_js.isSwitchLike(fiber, props)) kind = "toggle";
+    else if (chunkUZ2D4BVX_js.isSwitchLike(fiber, props)) kind = "toggle";
     else if (isPressableTarget(fiber)) kind = "target";
     if (kind && (!options.kind || options.kind === kind)) {
       const detail = scoreMatchDetail(fiber, queryNorm, queryRaw);
@@ -558,7 +885,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;
@@ -567,14 +894,18 @@ 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 (chunkUZ2D4BVX_js.isSourceControlId(queryRaw)) {
+          const bound = chunkUZ2D4BVX_js.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)) {
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `findInteractiveByIdentifier: query="${query}" \u2192 best match scored ${bestScore}, below the requested floor of ${options.minScore} \u2014 refusing it`
     );
     return null;
@@ -582,23 +913,138 @@ 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 = () => chunkUZ2D4BVX_js.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;
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `findInteractiveByIdentifier: query="${query}" \u2192 kind=${bestHandle.kind} label="${bestHandle.label ?? bestId}" score=${bestScore} named=${bestNamed} disabled=${bestDisabled} tied=${independent.length}`
     );
   } else {
-    chunkKZ2BLMS4_js.appilotsDebugLog(`findInteractiveByIdentifier: query="${query}" \u2192 no match`);
+    chunkUZ2D4BVX_js.appilotsDebugLog(`findInteractiveByIdentifier: query="${query}" \u2192 no match`);
   }
   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) {
+    chunkUZ2D4BVX_js.appilotsDebugLog(
+      `setSpotlightTarget: cleared${label ? ` (was about to mark "${label}")` : ""}`
+    );
+    if (current === null) return;
+    current = null;
+    emit();
+    return;
+  }
+  current = { rect, label, seq: ++seq };
+  chunkUZ2D4BVX_js.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 = chunkUZ2D4BVX_js.getGeometryHost();
+  if (!host) return { rect, scrolled: false };
+  if (chunkUZ2D4BVX_js.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) {
+    chunkUZ2D4BVX_js.appilotsDebugLog(`revealTarget: "${scrollable.id}" refused scrollToOffset(${target})`);
+    return { rect, scrolled: false };
+  }
+  const delta = target - metrics.offset;
+  chunkUZ2D4BVX_js.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 = chunkUZ2D4BVX_js.getCurrentScreen();
+  const candidates = chunkUZ2D4BVX_js.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) {
+    chunkUZ2D4BVX_js.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() {
@@ -641,43 +1087,52 @@ 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);
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `safeNavigate: using path-based navigation \u2014 root="${root}", nested=${JSON.stringify(nestedParams)}`
     );
     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.`
     );
   }
-  chunkKZ2BLMS4_js.appilotsDebugLog(
+  chunkUZ2D4BVX_js.appilotsDebugLog(
     `safeNavigate: screen exists in nested navigator, attempting direct navigation to "${screenName}"`
   );
   nav.navigate(screenName, params);
 }
 function navigateHandler(payload, context) {
-  chunkKZ2BLMS4_js.appilotsDebugLog(
+  chunkUZ2D4BVX_js.appilotsDebugLog(
     // Params carry record ids and, on some screens, the user's own
     // data — the count answers "were params passed?" and nothing else.
-    `navigateHandler called: screenName="${payload.screenName}" action="${payload.navigationAction}" params=${chunkKZ2BLMS4_js.describeValue(payload.params)}`
+    `navigateHandler called: screenName="${payload.screenName}" action="${payload.navigationAction}" params=${chunkUZ2D4BVX_js.describeValue(payload.params)}`
   );
   const { navigationRef, permissions } = context;
   const nav = navigationRef.current;
   if (!permissions.canNavigate) {
     return {
       success: false,
-      error: "Navigation is not permitted",
-      diagnose: { category: "unknown", screen: payload.screenName }
+      error: chunkUZ2D4BVX_js.permissionDeniedMessage("Navigation", "canNavigate"),
+      diagnose: { category: "unknown", screen: payload.screenName, recoverable: false }
     };
   }
   const isGoBack = payload.navigationAction === "goBack";
@@ -762,12 +1217,12 @@ function navigateHandler(payload, context) {
           diagnose: { category: "unknown", screen: payload.screenName }
         };
     }
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `navigateHandler: navigation succeeded for "${payload.screenName}" (action="${payload.navigationAction}")`
     );
     return { success: true };
   } catch (err) {
-    chunkKZ2BLMS4_js.appilotsDebugWarn(
+    chunkUZ2D4BVX_js.appilotsDebugWarn(
       `navigateHandler: navigation failed for "${payload.screenName}": ${err?.message}`
     );
     const msg = String(err?.message ?? "Navigation failed");
@@ -815,18 +1270,18 @@ function markedItemIndexFromFiber(fiber) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
 function normalize2(value) {
-  return chunkKZ2BLMS4_js.foldForCompare(String(value ?? ""));
+  return chunkUZ2D4BVX_js.foldForCompare(String(value ?? ""));
 }
 function hasPressHandler2(fiber) {
   const props = fiber?.memoizedProps ?? {};
   return typeof props.onPress === "function" || typeof props.onPressIn === "function";
 }
 function isPressableFiber(fiber) {
-  const typeName = chunkKZ2BLMS4_js.getTypeName(fiber.type) ?? chunkKZ2BLMS4_js.getTypeName(fiber.elementType) ?? "";
-  return chunkKZ2BLMS4_js.TOUCHABLE_NAMES.has(typeName) || hasPressHandler2(fiber);
+  const typeName = chunkUZ2D4BVX_js.getTypeName(fiber.type) ?? chunkUZ2D4BVX_js.getTypeName(fiber.elementType) ?? "";
+  return chunkUZ2D4BVX_js.TOUCHABLE_NAMES.has(typeName) || hasPressHandler2(fiber);
 }
 function findListContainers(options = {}) {
-  const root = chunkKZ2BLMS4_js.getFiberRoot();
+  const root = chunkUZ2D4BVX_js.getFiberRoot();
   if (!root) return [];
   const containers = [];
   const visited = /* @__PURE__ */ new WeakSet();
@@ -837,17 +1292,17 @@ function findListContainers(options = {}) {
     if (!fiber || visited.has(fiber)) continue;
     visited.add(fiber);
     if (fiber.sibling) stack.push(fiber.sibling);
-    if (chunkKZ2BLMS4_js.shouldSkipSubtree(fiber)) continue;
-    if (chunkKZ2BLMS4_js.isAlwaysListContainer(fiber) || chunkKZ2BLMS4_js.isHeuristicListContainer(fiber)) {
-      const minItems = chunkKZ2BLMS4_js.isAlwaysListContainer(fiber) || options.allowSingleHeuristic ? 1 : 2;
-      const items = chunkKZ2BLMS4_js.findListItems(fiber, minItems);
+    if (chunkUZ2D4BVX_js.shouldSkipSubtree(fiber)) continue;
+    if (chunkUZ2D4BVX_js.isAlwaysListContainer(fiber) || chunkUZ2D4BVX_js.isHeuristicListContainer(fiber)) {
+      const minItems = chunkUZ2D4BVX_js.isAlwaysListContainer(fiber) || options.allowSingleHeuristic ? 1 : 2;
+      const items = chunkUZ2D4BVX_js.findListItems(fiber, minItems);
       if (items && items.length >= minItems) {
         containers.push({
           container: fiber,
           items,
           listId: listIdFromContainer(fiber),
           listLabel: listLabelFromContainer(fiber),
-          containerType: chunkKZ2BLMS4_js.getTypeName(fiber.type) ?? chunkKZ2BLMS4_js.getTypeName(fiber.elementType) ?? "List"
+          containerType: chunkUZ2D4BVX_js.getTypeName(fiber.type) ?? chunkUZ2D4BVX_js.getTypeName(fiber.elementType) ?? "List"
         });
         continue;
       }
@@ -866,7 +1321,7 @@ function findFirstTouchable(item) {
     const { fiber, includeSibling } = stack.pop();
     if (!fiber || visited.has(fiber)) continue;
     visited.add(fiber);
-    if (chunkKZ2BLMS4_js.shouldSkipSubtree(fiber)) continue;
+    if (chunkUZ2D4BVX_js.shouldSkipSubtree(fiber)) continue;
     if (isPressableFiber(fiber)) {
       const props = fiber.memoizedProps ?? {};
       if (typeof props.onPress === "function" || typeof props.onPressIn === "function") {
@@ -893,7 +1348,7 @@ function findTouchableFibers(item) {
     const { fiber, includeSibling } = stack.pop();
     if (!fiber || visited.has(fiber)) continue;
     visited.add(fiber);
-    if (chunkKZ2BLMS4_js.shouldSkipSubtree(fiber)) continue;
+    if (chunkUZ2D4BVX_js.shouldSkipSubtree(fiber)) continue;
     const props = fiber.memoizedProps ?? {};
     if (isPressableFiber(fiber) && (typeof props.onPress === "function" || typeof props.onPressIn === "function")) {
       found.push(fiber);
@@ -937,7 +1392,7 @@ function findFirstText(fiber) {
     const node = stack.pop();
     if (!node || visited.has(node)) continue;
     visited.add(node);
-    const typeName = chunkKZ2BLMS4_js.getTypeName(node.type) ?? chunkKZ2BLMS4_js.getTypeName(node.elementType) ?? "";
+    const typeName = chunkUZ2D4BVX_js.getTypeName(node.type) ?? chunkUZ2D4BVX_js.getTypeName(node.elementType) ?? "";
     if (typeName === "Text") {
       const text = textFromChildren(node.memoizedProps?.children).trim();
       if (text) return text;
@@ -956,7 +1411,7 @@ function collectTexts(fiber) {
     const node = stack.pop();
     if (!node || visited.has(node)) continue;
     visited.add(node);
-    const typeName = chunkKZ2BLMS4_js.getTypeName(node.type) ?? chunkKZ2BLMS4_js.getTypeName(node.elementType) ?? "";
+    const typeName = chunkUZ2D4BVX_js.getTypeName(node.type) ?? chunkUZ2D4BVX_js.getTypeName(node.elementType) ?? "";
     if (typeName === "Text") {
       const text = textFromChildren(node.memoizedProps?.children).trim();
       if (text) out.push(text);
@@ -968,10 +1423,10 @@ function collectTexts(fiber) {
 }
 function hasUsefulTouchableIdentity(fiber) {
   const props = fiber?.memoizedProps ?? {};
-  if (chunkKZ2BLMS4_js.isReferenceable(props.testID)) return true;
-  if (chunkKZ2BLMS4_js.isReferenceable(props.accessibilityLabel)) return true;
-  if (chunkKZ2BLMS4_js.isReferenceable(props.label)) return true;
-  return chunkKZ2BLMS4_js.isReferenceable(findFirstText(fiber));
+  if (chunkUZ2D4BVX_js.isReferenceable(props.testID)) return true;
+  if (chunkUZ2D4BVX_js.isReferenceable(props.accessibilityLabel)) return true;
+  if (chunkUZ2D4BVX_js.isReferenceable(props.label)) return true;
+  return chunkUZ2D4BVX_js.isReferenceable(findFirstText(fiber));
 }
 function describeTouchable(fiber) {
   const props = fiber?.memoizedProps ?? {};
@@ -982,10 +1437,10 @@ function describeTouchable(fiber) {
 }
 function touchableLooksDestructive(fiber) {
   const descriptor = describeTouchable(fiber);
-  if (descriptor && chunkKZ2BLMS4_js.looksDestructiveActionLabel(descriptor)) return true;
+  if (descriptor && chunkUZ2D4BVX_js.looksDestructiveActionLabel(descriptor)) return true;
   const props = fiber?.memoizedProps ?? {};
   const haystack = [props.testID, props.accessibilityLabel, props.accessibilityHint, props.label].filter((value) => typeof value === "string").join(" ");
-  return chunkKZ2BLMS4_js.looksDestructiveActionLabel(haystack);
+  return chunkUZ2D4BVX_js.looksDestructiveActionLabel(haystack);
 }
 function describeItemCandidate(listIndex, zeroBasedIndex, item) {
   const syntheticId = `list-${listIndex}-item-${zeroBasedIndex + 1}`;
@@ -1034,8 +1489,10 @@ function pressResolvedListItem(list, itemFiber, listIndex, itemIndex) {
       (candidate) => candidate !== touchable && containsFiber(touchable, candidate)
     );
     if (primaryWrapsNestedTargets) {
-      chunkKZ2BLMS4_js.appilotsDebugLog(
-        `listItemDispatch: item "list-${listIndex}-item-${itemIndex}" has nested pressables; pressing outer row target`
+      const outer = describeTouchable(touchable) ?? "?";
+      const nested = safeIdentifiableTouchables.filter((candidate) => candidate !== touchable && containsFiber(touchable, candidate)).map((candidate) => describeTouchable(candidate) ?? "?").slice(0, 6);
+      chunkUZ2D4BVX_js.appilotsDebugLog(
+        `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);
@@ -1069,14 +1526,14 @@ function pressResolvedListItem(list, itemFiber, listIndex, itemIndex) {
     }
     return {
       ok: true,
-      containerType: chunkKZ2BLMS4_js.getTypeName(container.type) ?? chunkKZ2BLMS4_js.getTypeName(container.elementType) ?? list.containerType
+      containerType: chunkUZ2D4BVX_js.getTypeName(container.type) ?? chunkUZ2D4BVX_js.getTypeName(container.elementType) ?? list.containerType
     };
   } catch (err) {
     return {
       ok: false,
       reason: "press-threw",
       error: err?.message ?? "press handler threw",
-      containerType: chunkKZ2BLMS4_js.getTypeName(container.type) ?? chunkKZ2BLMS4_js.getTypeName(container.elementType) ?? list.containerType
+      containerType: chunkUZ2D4BVX_js.getTypeName(container.type) ?? chunkUZ2D4BVX_js.getTypeName(container.elementType) ?? list.containerType
     };
   }
 }
@@ -1102,10 +1559,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)) {
@@ -1132,7 +1591,7 @@ function candidateLists(containers, locator) {
   return containers.map((list, listIndex) => ({ list, listIndex }));
 }
 function pressListItemAtOrdinal(listIndex, itemIndex) {
-  if (!chunkKZ2BLMS4_js.getFiberRoot()) return { ok: false, reason: "no-fiber-root" };
+  if (!chunkUZ2D4BVX_js.getFiberRoot()) return { ok: false, reason: "no-fiber-root" };
   const containers = findListContainers({ allowSingleHeuristic: true });
   if (listIndex < 0 || listIndex >= containers.length) {
     return { ok: false, reason: "list-not-found" };
@@ -1146,7 +1605,7 @@ function pressListItemAtOrdinal(listIndex, itemIndex) {
   return pressResolvedListItem(list, items[zeroBased], listIndex, itemIndex);
 }
 function resolveListItemByIdentity(locator) {
-  if (!chunkKZ2BLMS4_js.getFiberRoot()) return { ok: false, result: { ok: false, reason: "no-fiber-root" } };
+  if (!chunkUZ2D4BVX_js.getFiberRoot()) return { ok: false, result: { ok: false, reason: "no-fiber-root" } };
   const parsed = locator.syntheticId ? parseSyntheticListItemId(locator.syntheticId) : null;
   const effective = parsed ? { ...locator, listIndex: parsed.listIndex, itemIndex: parsed.itemIndex } : locator;
   const containers = findListContainers({ allowSingleHeuristic: true });
@@ -1175,7 +1634,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,
@@ -1207,9 +1666,9 @@ function findSwitchFibers(item) {
     const { fiber, includeSibling } = stack.pop();
     if (!fiber || visited.has(fiber)) continue;
     visited.add(fiber);
-    if (chunkKZ2BLMS4_js.shouldSkipSubtree(fiber)) continue;
+    if (chunkUZ2D4BVX_js.shouldSkipSubtree(fiber)) continue;
     const props = fiber.memoizedProps ?? {};
-    if (chunkKZ2BLMS4_js.isSwitchLike(fiber, props)) {
+    if (chunkUZ2D4BVX_js.isSwitchLike(fiber, props)) {
       if (props.__appilotsInternal !== true) found.push(fiber);
       if (includeSibling && fiber.sibling) {
         stack.push({ fiber: fiber.sibling, includeSibling: true });
@@ -1243,11 +1702,11 @@ function toggleListItemByIdentity(locator, options) {
   }
   const target = switches[0];
   const props = target?.memoizedProps ?? {};
-  const current = chunkKZ2BLMS4_js.switchValue(props);
-  if (options?.expected !== void 0 && current === options.expected) {
-    return { ok: true, containerType: list.containerType, value: current, noop: true };
+  const current2 = chunkUZ2D4BVX_js.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 {
@@ -1264,7 +1723,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);
@@ -1282,7 +1741,7 @@ function screenDiagnose(targetId, category = "component-not-found") {
   return {
     category,
     targetId,
-    screen: chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0
+    screen: chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0
   };
 }
 function isPressLike(action) {
@@ -1302,10 +1761,10 @@ function elementLookupKey(value) {
   return canonicalElementId(value).toLowerCase().replace(/[\s_]+/g, "-");
 }
 function findRegisteredElement(elementId) {
-  const direct = chunkKZ2BLMS4_js.elementRegistry.get(elementId) ?? chunkKZ2BLMS4_js.elementRegistry.get(canonicalElementId(elementId));
+  const direct = chunkUZ2D4BVX_js.elementRegistry.get(elementId) ?? chunkUZ2D4BVX_js.elementRegistry.get(canonicalElementId(elementId));
   if (direct) return direct;
   const wanted = elementLookupKey(elementId);
-  return chunkKZ2BLMS4_js.elementRegistry.snapshot().find((element) => elementLookupKey(element.id) === wanted);
+  return chunkUZ2D4BVX_js.elementRegistry.snapshot().find((element) => elementLookupKey(element.id) === wanted);
 }
 function resolveInteractionElement(elementId) {
   return getLatestElement(elementId);
@@ -1425,7 +1884,7 @@ function dispatchIdentifiedToggle(targetId, action) {
         diagnose: { ...screenDiagnose(targetId, "unknown"), recoverable: true }
       };
     }
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `elementDispatch: "${action}" on "${targetId}" names a switch \u2014 flipping it instead of pressing, so the verb cannot land on an ancestor`
     );
     try {
@@ -1459,6 +1918,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();
@@ -1509,6 +1974,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,
@@ -1527,6 +1999,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,
@@ -1634,7 +2113,7 @@ function dispatchToggleElement(element, registry) {
 }
 function dispatchStructuredElementId(identifier, action) {
   if (!isElementIdentifier(identifier) || !isPressLike(action)) return null;
-  const parsed = chunkKZ2BLMS4_js.parseStableElementId(identifier);
+  const parsed = chunkUZ2D4BVX_js.parseStableElementId(identifier);
   if (!parsed || parsed.role !== "option") return null;
   if (!parsed.itemKey && !parsed.listId) return null;
   const pressed = pressListItemByIdentity({
@@ -1644,7 +2123,7 @@ function dispatchStructuredElementId(identifier, action) {
     texts: parsed.itemKey ? [parsed.itemKey] : void 0
   });
   if (pressed.ok) {
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `elementDispatch: resolved stale el id "${identifier}" via structural identity (listId="${parsed.listId}", itemKey="${parsed.itemKey}")`
     );
     return { success: true };
@@ -1675,20 +2154,20 @@ function normalize4(value) {
   return value.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]/g, "");
 }
 function resolveScreenForFormFields() {
-  const activePath = chunkKZ2BLMS4_js.getActiveRouteNames();
+  const activePath = chunkUZ2D4BVX_js.getActiveRouteNames();
   for (let i = activePath.length - 1; i >= 0; i--) {
     const name = activePath[i];
-    const meta = name ? chunkKZ2BLMS4_js.getScreenMetadata(name) : void 0;
+    const meta = name ? chunkUZ2D4BVX_js.getScreenMetadata(name) : void 0;
     if (name && Array.isArray(meta?.fields) && meta.fields.length > 0) return name;
   }
-  return chunkKZ2BLMS4_js.getCurrentScreen();
+  return chunkUZ2D4BVX_js.getCurrentScreen();
 }
 function collectKnownFormFields(registry) {
   const registryFields = registry.snapshot().filter((entry) => entry.kind === "field" || entry.kind === "slider").map((entry) => ({ id: entry.id, label: entry.label }));
   if (registryFields.length >= 2) return registryFields;
   const screen = resolveScreenForFormFields();
   if (screen) {
-    const metaFields = chunkKZ2BLMS4_js.getScreenMetadata(screen)?.fields;
+    const metaFields = chunkUZ2D4BVX_js.getScreenMetadata(screen)?.fields;
     if (Array.isArray(metaFields) && metaFields.length > 0) {
       return metaFields.filter((field) => !!field && typeof field.id === "string").map((field) => ({
         id: field.id,
@@ -1698,7 +2177,7 @@ function collectKnownFormFields(registry) {
       }));
     }
   }
-  for (const meta of chunkKZ2BLMS4_js.getAllScreens()) {
+  for (const meta of chunkUZ2D4BVX_js.getAllScreens()) {
     if (Array.isArray(meta.fields) && meta.fields.length > 0) {
       return meta.fields.filter((field) => !!field && typeof field.id === "string").map((field) => ({
         id: field.id,
@@ -1811,7 +2290,7 @@ function rewriteMisplacedFormFillFields(fields, registry) {
     const inferred = inferFieldIdForValue(String(field.value ?? ""), knownFields, used);
     if (!inferred) return field;
     used.add(inferred);
-    chunkKZ2BLMS4_js.appilotsDebugWarn(
+    chunkUZ2D4BVX_js.appilotsDebugWarn(
       `formFieldRewrite: ${field.fieldId} \u2192 ${inferred} (value=${JSON.stringify(field.value)})`
     );
     return { ...field, fieldId: inferred };
@@ -1819,8 +2298,8 @@ function rewriteMisplacedFormFillFields(fields, registry) {
 }
 
 // src/executor/formValidation.ts
-var FORM_VALIDATION_TEXT_RE2 = chunkKZ2BLMS4_js.FORM_VALIDATION_TEXT_RE;
-var FORM_SUCCESS_TEXT_RE = chunkKZ2BLMS4_js.FORM_WRITE_SUCCESS_TEXT_RE;
+var FORM_VALIDATION_TEXT_RE2 = chunkUZ2D4BVX_js.FORM_VALIDATION_TEXT_RE;
+var FORM_SUCCESS_TEXT_RE = chunkUZ2D4BVX_js.FORM_WRITE_SUCCESS_TEXT_RE;
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function inferValidationFieldId(message, inputs) {
   const haystack = normalizeText(message);
@@ -1844,12 +2323,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) => chunkUZ2D4BVX_js.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() || !chunkUZ2D4BVX_js.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) {
@@ -1857,20 +2342,23 @@ function readVisibleFormSuccess(snap) {
   return (snap.texts ?? []).find((text) => text?.trim() && FORM_SUCCESS_TEXT_RE.test(text));
 }
 function submitAsyncStillPending(submitTargetId) {
-  const probe = chunkKZ2BLMS4_js.probeLoadingState(submitTargetId ?? null, chunkKZ2BLMS4_js.getCurrentScreen());
+  const probe = chunkUZ2D4BVX_js.probeLoadingState(submitTargetId ?? null, chunkUZ2D4BVX_js.getCurrentScreen());
   if (probe.loading) return true;
   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 (!chunkKZ2BLMS4_js.snapshotShowsOpenCreateForm(snap, activePath)) {
-    return { status: "success" };
+  if (!chunkUZ2D4BVX_js.snapshotShowsOpenCreateForm(snap, activePath)) {
+    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;
 }
@@ -1885,8 +2373,8 @@ async function waitForPostSubmitOutcome(options) {
       continue;
     }
     const snap2 = captureSnapshot();
-    const activePath2 = chunkKZ2BLMS4_js.getActiveRouteNames();
-    const outcome2 = evaluatePostSubmitSnapshot(snap2, activePath2);
+    const activePath2 = chunkUZ2D4BVX_js.getActiveRouteNames();
+    const outcome2 = evaluatePostSubmitSnapshot(snap2, activePath2, options?.beforeTexts);
     if (outcome2) return outcome2;
     await sleep(pollMs);
   }
@@ -1897,8 +2385,8 @@ async function waitForPostSubmitOutcome(options) {
     };
   }
   const snap = captureSnapshot();
-  const activePath = chunkKZ2BLMS4_js.getActiveRouteNames();
-  const outcome = evaluatePostSubmitSnapshot(snap, activePath);
+  const activePath = chunkUZ2D4BVX_js.getActiveRouteNames();
+  const outcome = evaluatePostSubmitSnapshot(snap, activePath, options?.beforeTexts);
   if (outcome) return outcome;
   return {
     status: "failure",
@@ -1906,91 +2394,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 {
@@ -2003,16 +2406,16 @@ function findSnapshotButton(targetId) {
   }
 }
 function buildUiDiagnose(targetId, cause) {
-  const activePath = chunkKZ2BLMS4_js.getActiveRouteNames();
-  const screen = activePath[activePath.length - 1] ?? chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0;
+  const activePath = chunkUZ2D4BVX_js.getActiveRouteNames();
+  const screen = activePath[activePath.length - 1] ?? chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0;
   const screenPath = activePath.length > 1 ? activePath.join("/") : screen;
   const diagnose = {
     category: cause === "not-found" ? "component-not-found" : cause === "disabled" ? "disabled" : "unknown",
     targetId,
     screen: screenPath
   };
-  if (chunkKZ2BLMS4_js.isOptionalStepAutomationFailure(targetId, screenPath, activePath)) {
-    diagnose.visibleMessage = chunkKZ2BLMS4_js.OPTIONAL_STEP_AUTOMATION_HINT;
+  if (chunkUZ2D4BVX_js.isOptionalStepAutomationFailure(targetId, screenPath, activePath)) {
+    diagnose.visibleMessage = chunkUZ2D4BVX_js.OPTIONAL_STEP_AUTOMATION_HINT;
     diagnose.recoverable = true;
   }
   return diagnose;
@@ -2063,6 +2466,7 @@ function stripComponentPrefix(componentId) {
   return null;
 }
 function resolveComponentId(componentId, registry, action) {
+  if (chunkUZ2D4BVX_js.isSourceControlId(componentId)) return componentId;
   if (registry.getTarget(componentId) || registry.getToggle(componentId) || registry.getField(componentId) || registry.getSlider(componentId)) {
     return componentId;
   }
@@ -2070,15 +2474,16 @@ function resolveComponentId(componentId, registry, action) {
   const snapshot = registry.snapshot();
   for (const comp of snapshot) {
     if (comp.id.toLowerCase() === lower) {
-      chunkKZ2BLMS4_js.appilotsDebugLog(
+      chunkUZ2D4BVX_js.appilotsDebugLog(
         `resolveComponentId: case-insensitive match "${componentId}" \u2192 "${comp.id}"`
       );
       return comp.id;
     }
   }
-  const currentScreen = chunkKZ2BLMS4_js.getCurrentScreen();
+  if (isPositionalControlId(componentId)) return componentId;
+  const currentScreen = chunkUZ2D4BVX_js.getCurrentScreen();
   if (currentScreen) {
-    const screenMeta = chunkKZ2BLMS4_js.getScreenMetadata(currentScreen);
+    const screenMeta = chunkUZ2D4BVX_js.getScreenMetadata(currentScreen);
     const actions = screenMeta?.actions;
     if (actions && Array.isArray(actions)) {
       const metaAction = actions.find(
@@ -2087,14 +2492,14 @@ function resolveComponentId(componentId, registry, action) {
       if (metaAction && typeof metaAction === "object" && metaAction.label) {
         const metaLabel = metaAction.label;
         const normalizedMetaLabel = metaLabel.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]/g, "");
-        chunkKZ2BLMS4_js.appilotsDebugLog(
+        chunkUZ2D4BVX_js.appilotsDebugLog(
           `resolveComponentId: found screen metadata for "${componentId}" \u2192 label="${metaLabel}"`
         );
         for (const comp of snapshot) {
           if (!comp.label) continue;
           const compLabel = comp.label.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]/g, "");
           if (compLabel === normalizedMetaLabel || compLabel.includes(normalizedMetaLabel) || normalizedMetaLabel.includes(compLabel)) {
-            chunkKZ2BLMS4_js.appilotsDebugLog(
+            chunkUZ2D4BVX_js.appilotsDebugLog(
               `resolveComponentId: FOUND via metadata: "${componentId}" \u2192 "${comp.id}" (label="${comp.label}")`
             );
             return comp.id;
@@ -2109,9 +2514,9 @@ function resolveComponentId(componentId, registry, action) {
     label: c.label,
     kind: c.kind
   }));
-  const match = resolveTarget(componentId, candidates, { action });
+  const match = chunkUZ2D4BVX_js.resolveTarget(componentId, candidates, { action });
   if (match.status === "matched") {
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `resolveComponentId: matched "${componentId}" -> "${match.id}" (tier=${match.tier})`
     );
     return match.id;
@@ -2201,7 +2606,7 @@ function setValueHandler(rawComponentId, requested, registry) {
     try {
       slider.setValue(applied);
       if (applied !== requestedValue) {
-        chunkKZ2BLMS4_js.appilotsDebugLog(
+        chunkUZ2D4BVX_js.appilotsDebugLog(
           `uiInteractionHandler: set_value snapped ${requestedValue} \u2192 ${applied} for "${componentId}" (step=${step})`
         );
       }
@@ -2236,7 +2641,7 @@ function checkModalOcclusion(rawComponentId, action) {
     return null;
   }
   if (typeof rawComponentId !== "string" || rawComponentId.trim().length === 0) return null;
-  const dialog = chunkKZ2BLMS4_js.getOpenNativeDialog();
+  const dialog = chunkUZ2D4BVX_js.getOpenNativeDialog();
   if (dialog) {
     const needle = normalizeIdent(rawComponentId);
     if (dialog.buttons.some((b) => normalizeIdent(b.label) === needle)) return null;
@@ -2246,16 +2651,16 @@ function checkModalOcclusion(rawComponentId, action) {
       diagnose: {
         category: "ambiguous-target",
         targetId: rawComponentId,
-        screen: chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0,
+        screen: chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0,
         candidates: dialog.buttons.map((b) => b.label).slice(0, 8)
       }
     };
   }
-  const fiberRoot = chunkKZ2BLMS4_js.getFiberRoot();
+  const fiberRoot = chunkUZ2D4BVX_js.getFiberRoot();
   if (!fiberRoot) return null;
   let snap;
   try {
-    snap = chunkKZ2BLMS4_js.walkFiber(fiberRoot);
+    snap = chunkUZ2D4BVX_js.walkFiber(fiberRoot);
   } catch {
     return null;
   }
@@ -2317,15 +2722,18 @@ function checkModalOcclusion(rawComponentId, action) {
 }
 function uiInteractionHandler(payload, context) {
   const { permissions } = context;
-  const registry = context.registry ?? chunkKZ2BLMS4_js.componentRegistry;
+  const registry = context.registry ?? chunkUZ2D4BVX_js.componentRegistry;
   if (!permissions.canInteractUI) {
     return {
       success: false,
-      error: "UI interaction is not permitted",
-      diagnose: buildUiDiagnose(
-        payload.componentId ?? payload.targetId ?? "",
-        "unknown"
-      )
+      error: chunkUZ2D4BVX_js.permissionDeniedMessage("UI interaction", "canInteractUI"),
+      diagnose: {
+        ...buildUiDiagnose(
+          payload.componentId ?? payload.targetId ?? "",
+          "unknown"
+        ),
+        recoverable: false
+      }
     };
   }
   const { action } = payload;
@@ -2339,7 +2747,7 @@ function uiInteractionHandler(payload, context) {
   if (sliderId) {
     const smuggled = payload.value ?? payload.params?.value;
     if (smuggled !== void 0) {
-      chunkKZ2BLMS4_js.appilotsDebugLog(
+      chunkUZ2D4BVX_js.appilotsDebugLog(
         `uiInteractionHandler: "${actionStr}" on slider "${sliderId}" carried value=${JSON.stringify(smuggled)} \u2014 routing to set_value`
       );
       return setValueHandler(rawComponentId, smuggled, registry);
@@ -2350,23 +2758,23 @@ function uiInteractionHandler(payload, context) {
       diagnose: { ...buildUiDiagnose(sliderId, "unknown"), recoverable: true }
     };
   }
-  const openDialog = chunkKZ2BLMS4_js.getOpenNativeDialog();
+  const openDialog = chunkUZ2D4BVX_js.getOpenNativeDialog();
   const isPressVerb = actionStr === "press" || actionStr === "tap" || actionStr === "click";
   if (openDialog && isPressVerb) {
     const needle = normalizeIdent(rawComponentId);
     const button = openDialog.buttons.find((b) => normalizeIdent(b.label) === needle);
     if (button) {
       button.press();
-      chunkKZ2BLMS4_js.appilotsDebugLog(`uiInteractionHandler: pressed native dialog button "${button.label}"`);
+      chunkUZ2D4BVX_js.appilotsDebugLog(`uiInteractionHandler: pressed native dialog button "${button.label}"`);
       return { success: true, effect: "changed" };
     }
   }
   if (!openDialog && isPressVerb) {
-    const answered = chunkKZ2BLMS4_js.getLastAnsweredNativeDialog();
+    const answered = chunkUZ2D4BVX_js.getLastAnsweredNativeDialog();
     const needle = normalizeIdent(rawComponentId);
     if (answered && needle) {
       if (answered.answeredWith && normalizeIdent(answered.answeredWith) === needle) {
-        chunkKZ2BLMS4_js.appilotsDebugLog(
+        chunkUZ2D4BVX_js.appilotsDebugLog(
           `uiInteractionHandler: native dialog button "${answered.answeredWith}" was already pressed and the dialog is closed \u2014 treating the repeat as done`
         );
         return { success: true, effect: "completed" };
@@ -2378,7 +2786,7 @@ function uiInteractionHandler(payload, context) {
           diagnose: {
             category: "component-not-found",
             targetId: rawComponentId,
-            screen: chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0,
+            screen: chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0,
             recoverable: false
           }
         };
@@ -2387,7 +2795,7 @@ function uiInteractionHandler(payload, context) {
   }
   const occluded = checkModalOcclusion(rawComponentId, actionStr);
   if (occluded) {
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `uiInteractionHandler: blocked "${actionStr}" on "${rawComponentId}" \u2014 target is behind an open modal`
     );
     return occluded;
@@ -2395,7 +2803,7 @@ function uiInteractionHandler(payload, context) {
   if (typeof rawComponentId === "string" && rawComponentId.trim().toLowerCase().startsWith("el:")) {
     const result = dispatchElementOrTarget(rawComponentId, registry, actionStr);
     if (result.success) {
-      chunkKZ2BLMS4_js.appilotsDebugLog(
+      chunkUZ2D4BVX_js.appilotsDebugLog(
         `uiInteractionHandler: interaction element dispatch succeeded for "${rawComponentId}"`
       );
     }
@@ -2403,17 +2811,17 @@ function uiInteractionHandler(payload, context) {
   }
   const ordinal = parseSyntheticListItemId(rawComponentId);
   if (ordinal && (action === "press" || actionStr === "tap" || actionStr === "click" || actionStr === "longPress")) {
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `uiInteractionHandler: dispatching synthetic list ordinal \u2014 componentId="${rawComponentId}" list=${ordinal.listIndex} item=${ordinal.itemIndex}`
     );
     const result = pressListItemAtOrdinal(ordinal.listIndex, ordinal.itemIndex);
     if (result.ok) {
-      chunkKZ2BLMS4_js.appilotsDebugLog(
+      chunkUZ2D4BVX_js.appilotsDebugLog(
         `uiInteractionHandler: synthetic ordinal press succeeded (container=${result.containerType ?? "List"})`
       );
       return { success: true };
     }
-    const screen = chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0;
+    const screen = chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0;
     if (result.reason === "list-not-found" || result.reason === "item-not-found") {
       return {
         success: false,
@@ -2454,7 +2862,7 @@ function uiInteractionHandler(payload, context) {
     };
   }
   const componentId = resolveComponentId(rawComponentId, registry, actionStr);
-  chunkKZ2BLMS4_js.appilotsDebugLog(
+  chunkUZ2D4BVX_js.appilotsDebugLog(
     `uiInteractionHandler: resolved componentId="${payload.componentId}" \u2192 "${componentId}"`
   );
   const target = registry.getTarget(componentId);
@@ -2507,7 +2915,7 @@ function uiInteractionHandler(payload, context) {
       return { success: false, error: err?.message ?? "Focus failed" };
     }
   }
-  chunkKZ2BLMS4_js.appilotsDebugLog(
+  chunkUZ2D4BVX_js.appilotsDebugLog(
     `uiInteractionHandler: registry miss for "${componentId}", falling back to fiber tree`
   );
   const namedToggle = dispatchIdentifiedToggle(componentId, actionStr);
@@ -2519,7 +2927,7 @@ function uiInteractionHandler(payload, context) {
     try {
       if (actionStr === "press" && handle.kind === "target" && handle.press) {
         handle.press();
-        chunkKZ2BLMS4_js.appilotsDebugLog(
+        chunkUZ2D4BVX_js.appilotsDebugLog(
           `uiInteractionHandler: fiber fallback press succeeded for "${componentId}"`
         );
         return { success: true };
@@ -2555,6 +2963,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;
@@ -2582,7 +3012,7 @@ function submitLabelHintsSubmit(label) {
   return SUBMIT_LABEL_HINT_RE.test(trimmed);
 }
 function screenDeclaresSubmitAction(screenName) {
-  const meta = chunkKZ2BLMS4_js.getScreenMetadata(screenName);
+  const meta = chunkUZ2D4BVX_js.getScreenMetadata(screenName);
   return Array.isArray(meta?.actions) && meta.actions.some(
     (action) => typeof action === "object" && action !== null && action.type === "submit"
   );
@@ -2615,7 +3045,7 @@ function resolveFormScreensForSubmit(screen, activePath, registry) {
   } else {
     push(screen);
   }
-  push(chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0);
+  push(chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0);
   const withSubmit = [];
   const rest = [];
   for (const name of ordered) {
@@ -2633,7 +3063,7 @@ function collectSubmitTargetCandidates(screens, registry) {
     candidates.push(id);
   };
   for (const screenName of screens) {
-    const meta = chunkKZ2BLMS4_js.getScreenMetadata(screenName);
+    const meta = chunkUZ2D4BVX_js.getScreenMetadata(screenName);
     const submitMeta = Array.isArray(meta?.actions) ? meta.actions.find(
       (action) => typeof action === "object" && action !== null && action.type === "submit"
     ) : void 0;
@@ -2677,8 +3107,8 @@ function readVisibleValidation(fieldId, label) {
   return void 0;
 }
 function resolveScreenContext() {
-  const activePath = chunkKZ2BLMS4_js.getActiveRouteNames();
-  const screen = activePath[activePath.length - 1] ?? chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0;
+  const activePath = chunkUZ2D4BVX_js.getActiveRouteNames();
+  const screen = activePath[activePath.length - 1] ?? chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0;
   return { screen, activePath };
 }
 function selectValueApplied(fieldId, requestedValue, currentValue, registry) {
@@ -2686,36 +3116,36 @@ function selectValueApplied(fieldId, requestedValue, currentValue, registry) {
   if (!requested) return false;
   const meta = getMetadataField(fieldId, registry);
   const options = Array.isArray(meta?.options) ? meta.options : [];
-  const requestedNorm = chunkKZ2BLMS4_js.normalize3(requested);
-  const currentNorm = chunkKZ2BLMS4_js.normalize3(currentValue);
+  const requestedNorm = chunkUZ2D4BVX_js.normalize3(requested);
+  const currentNorm = chunkUZ2D4BVX_js.normalize3(currentValue);
   if (currentNorm === requestedNorm) return true;
   for (const option of options) {
     const value = typeof option?.value === "string" ? option.value : "";
     const label = typeof option?.label === "string" ? option.label : "";
-    if (chunkKZ2BLMS4_js.normalize3(value) === requestedNorm && chunkKZ2BLMS4_js.normalize3(label) === currentNorm) return true;
-    if (chunkKZ2BLMS4_js.normalize3(label) === requestedNorm && chunkKZ2BLMS4_js.normalize3(label) === currentNorm) return true;
-    if (chunkKZ2BLMS4_js.normalize3(value) === requestedNorm && chunkKZ2BLMS4_js.normalize3(value) === currentNorm) return true;
+    if (chunkUZ2D4BVX_js.normalize3(value) === requestedNorm && chunkUZ2D4BVX_js.normalize3(label) === currentNorm) return true;
+    if (chunkUZ2D4BVX_js.normalize3(label) === requestedNorm && chunkUZ2D4BVX_js.normalize3(label) === currentNorm) return true;
+    if (chunkUZ2D4BVX_js.normalize3(value) === requestedNorm && chunkUZ2D4BVX_js.normalize3(value) === currentNorm) return true;
   }
   return false;
 }
 function getMetadataField(fieldId, registry) {
   const screens = /* @__PURE__ */ new Set();
-  for (const name of chunkKZ2BLMS4_js.getActiveRouteNames()) screens.add(name);
-  const current = chunkKZ2BLMS4_js.getCurrentScreen();
-  if (current) screens.add(current);
+  for (const name of chunkUZ2D4BVX_js.getActiveRouteNames()) screens.add(name);
+  const current2 = chunkUZ2D4BVX_js.getCurrentScreen();
+  if (current2) screens.add(current2);
   if (registry) {
     for (const comp of registry.snapshot()) {
       if (comp.kind === "field" && comp.screen) screens.add(comp.screen);
     }
   }
-  const needle = chunkKZ2BLMS4_js.normalize3(fieldId);
+  const needle = chunkUZ2D4BVX_js.normalize3(fieldId);
   for (const screenName of screens) {
-    const screenMeta = chunkKZ2BLMS4_js.getScreenMetadata(screenName);
+    const screenMeta = chunkUZ2D4BVX_js.getScreenMetadata(screenName);
     const fields = Array.isArray(screenMeta?.fields) ? screenMeta.fields : [];
     const match = fields.find((field) => {
       if (!field || typeof field !== "object") return false;
-      const id = typeof field.id === "string" ? chunkKZ2BLMS4_js.normalize3(field.id) : "";
-      const label = typeof field.label === "string" ? chunkKZ2BLMS4_js.normalize3(field.label) : "";
+      const id = typeof field.id === "string" ? chunkUZ2D4BVX_js.normalize3(field.id) : "";
+      const label = typeof field.label === "string" ? chunkUZ2D4BVX_js.normalize3(field.label) : "";
       return id === needle || label === needle;
     });
     if (match) return match;
@@ -2727,11 +3157,11 @@ function resolveSelectOption(fieldId, value, registry) {
   if (!requested) return void 0;
   const meta = getMetadataField(fieldId, registry);
   const options = Array.isArray(meta?.options) ? meta.options : [];
-  const requestedNorm = chunkKZ2BLMS4_js.normalize3(requested);
+  const requestedNorm = chunkUZ2D4BVX_js.normalize3(requested);
   for (const option of options) {
     const optionValue = typeof option?.value === "string" ? option.value : "";
     const optionLabel = typeof option?.label === "string" ? option.label : "";
-    if (chunkKZ2BLMS4_js.normalize3(optionValue) === requestedNorm || chunkKZ2BLMS4_js.normalize3(optionLabel) === requestedNorm) {
+    if (chunkUZ2D4BVX_js.normalize3(optionValue) === requestedNorm || chunkUZ2D4BVX_js.normalize3(optionLabel) === requestedNorm) {
       return { value: optionValue, label: optionLabel };
     }
   }
@@ -2743,7 +3173,7 @@ async function tryOpenSelectModal(fieldId, registry) {
     if (!target) continue;
     try {
       target.press();
-      await sleep2(180);
+      await sleep3(180);
       return true;
     } catch {
     }
@@ -2781,12 +3211,12 @@ async function tryPressSelectOption(fieldId, value, registry, options = {}) {
   return {
     success: false,
     error: `No pressable option found for select field "${fieldId}"`,
-    diagnose: { category: "component-not-found", fieldId, screen: chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0 }
+    diagnose: { category: "component-not-found", fieldId, screen: chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0 }
   };
 }
 function normalizeFieldType(type) {
   if (typeof type !== "string") return void 0;
-  const normalized = chunkKZ2BLMS4_js.normalize3(type);
+  const normalized = chunkUZ2D4BVX_js.normalize3(type);
   if (normalized === "select" || normalized === "picker" || normalized === "dropdown")
     return "select";
   if (normalized === "toggle" || normalized === "switch" || normalized === "checkbox")
@@ -2816,7 +3246,7 @@ function fieldCueTerms(fieldId, label) {
   );
   const terms = /* @__PURE__ */ new Set();
   for (const value of raw) {
-    const normalized = chunkKZ2BLMS4_js.normalize3(value);
+    const normalized = chunkUZ2D4BVX_js.normalize3(value);
     if (normalized.length >= 3 && normalized !== "id") terms.add(normalized);
   }
   return [...terms];
@@ -2824,17 +3254,17 @@ function fieldCueTerms(fieldId, label) {
 function snapshotHasFieldCue(snap, fieldId, label) {
   const terms = fieldCueTerms(fieldId, label);
   if (terms.length === 0) return false;
-  const visible = [...snap.texts ?? [], ...(snap.buttons ?? []).map((b) => b.label ?? b.id ?? "")].map((text) => chunkKZ2BLMS4_js.normalize3(text)).filter(Boolean);
+  const visible = [...snap.texts ?? [], ...(snap.buttons ?? []).map((b) => b.label ?? b.id ?? "")].map((text) => chunkUZ2D4BVX_js.normalize3(text)).filter(Boolean);
   return visible.some((text) => terms.some((term) => text.includes(term) || term.includes(text)));
 }
 function scoreCandidateText(value, texts) {
-  const valueNorm = chunkKZ2BLMS4_js.normalize3(String(value ?? ""));
+  const valueNorm = chunkUZ2D4BVX_js.normalize3(String(value ?? ""));
   if (!valueNorm) return 0;
   let best = 0;
   for (const text of texts) {
-    const textNorm = chunkKZ2BLMS4_js.normalize3(text);
+    const textNorm = chunkUZ2D4BVX_js.normalize3(text);
     if (!textNorm) continue;
-    best = Math.max(best, chunkKZ2BLMS4_js.matchScore(valueNorm, textNorm));
+    best = Math.max(best, chunkUZ2D4BVX_js.matchScore(valueNorm, textNorm));
   }
   return best;
 }
@@ -2848,7 +3278,7 @@ function optionTexts(option) {
 function buildChoiceCandidates(snap, fieldId, value, allowFirstVisibleWhenNoCue, registry) {
   const fieldLabel = getFieldLabel(fieldId, registry);
   const fieldCueVisible = snapshotHasFieldCue(snap, fieldId, fieldLabel);
-  const genericValue = chunkKZ2BLMS4_js.isGenericSelectValue(value);
+  const genericValue = chunkUZ2D4BVX_js.isGenericSelectValue(value);
   const candidates = [];
   let order = 0;
   const choiceGroups = snap.choiceGroups ?? [];
@@ -2860,7 +3290,7 @@ function buildChoiceCandidates(snap, fieldId, value, allowFirstVisibleWhenNoCue,
     const groupCueScore = Math.max(
       globalCueScore,
       ...groupTexts.map((text) => {
-        const normalized = chunkKZ2BLMS4_js.normalize3(text);
+        const normalized = chunkUZ2D4BVX_js.normalize3(text);
         return fieldCueTerms(fieldId, fieldLabel).some(
           (term) => normalized.includes(term) || term.includes(normalized)
         ) ? 80 : 0;
@@ -2897,7 +3327,7 @@ function buildChoiceCandidates(snap, fieldId, value, allowFirstVisibleWhenNoCue,
       const elementCueScore = Math.max(
         fieldCueVisible && elements.length <= 12 ? 50 : 0,
         ...cueTexts.map((text) => {
-          const normalized = chunkKZ2BLMS4_js.normalize3(text);
+          const normalized = chunkUZ2D4BVX_js.normalize3(text);
           return fieldTerms.some((term) => normalized.includes(term) || term.includes(normalized)) ? 80 : 0;
         })
       );
@@ -2955,7 +3385,7 @@ async function selectVisibleChoiceAsync(fieldId, value, registry, options) {
     return {
       success: false,
       error: err?.message ?? "Could not capture visible choices",
-      diagnose: { category: "unknown", fieldId, screen: chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0 }
+      diagnose: { category: "unknown", fieldId, screen: chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0 }
     };
   }
   const candidates = buildChoiceCandidates(
@@ -2973,7 +3403,7 @@ async function selectVisibleChoiceAsync(fieldId, value, registry, options) {
       diagnose: {
         category: "component-not-found",
         fieldId,
-        screen: chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0
+        screen: chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0
       }
     };
   }
@@ -2987,7 +3417,7 @@ async function selectVisibleChoiceAsync(fieldId, value, registry, options) {
 }
 function isContinuationButton(label) {
   if (!label) return false;
-  return /^(next|continue|proximo|prox|continuar|avancar|avançar)$/i.test(chunkKZ2BLMS4_js.normalize3(label));
+  return /^(next|continue|proximo|prox|continuar|avancar|avançar)$/i.test(chunkUZ2D4BVX_js.normalize3(label));
 }
 function pressContinuationButton(registry) {
   const snap = captureSnapshot();
@@ -3000,40 +3430,40 @@ function pressContinuationButton(registry) {
     return {
       success: false,
       error: "No enabled continuation button is visible",
-      diagnose: { category: "component-not-found", screen: chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0 }
+      diagnose: { category: "component-not-found", screen: chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0 }
     };
   }
   return pressTargetByIdOrLabel(id, registry);
 }
 function findField(fieldId, registry) {
-  chunkKZ2BLMS4_js.appilotsDebugLog(`findField: searching for fieldId="${fieldId}"`);
+  chunkUZ2D4BVX_js.appilotsDebugLog(`findField: searching for fieldId="${fieldId}"`);
   const exact = registry.getField(fieldId);
   if (exact) {
-    chunkKZ2BLMS4_js.appilotsDebugLog(`findField: FOUND exact match for fieldId="${fieldId}"`);
+    chunkUZ2D4BVX_js.appilotsDebugLog(`findField: FOUND exact match for fieldId="${fieldId}"`);
     return exact;
   }
   const lower = fieldId.toLowerCase();
   const snapshot = registry.snapshot();
   for (const comp of snapshot) {
     if (comp.kind === "field" && comp.id.toLowerCase() === lower) {
-      chunkKZ2BLMS4_js.appilotsDebugLog(
+      chunkUZ2D4BVX_js.appilotsDebugLog(
         `findField: FOUND case-insensitive match: registered="${comp.id}" for searched="${fieldId}"`
       );
       return registry.getField(comp.id);
     }
   }
-  const currentScreenForTieBreak = chunkKZ2BLMS4_js.getCurrentScreen();
-  const needle = chunkKZ2BLMS4_js.normalize3(fieldId);
+  const currentScreenForTieBreak = chunkUZ2D4BVX_js.getCurrentScreen();
+  const needle = chunkUZ2D4BVX_js.normalize3(fieldId);
   let bestComp;
   let bestScore = 0;
   let bestOnCurrentScreen = false;
   for (const comp of snapshot) {
     if (comp.kind !== "field") continue;
-    const candidates = [chunkKZ2BLMS4_js.normalize3(comp.id)];
-    if (comp.label) candidates.push(chunkKZ2BLMS4_js.normalize3(comp.label));
+    const candidates = [chunkUZ2D4BVX_js.normalize3(comp.id)];
+    if (comp.label) candidates.push(chunkUZ2D4BVX_js.normalize3(comp.label));
     let candidateScore = 0;
     for (const cand of candidates) {
-      const s = chunkKZ2BLMS4_js.matchScore(needle, cand);
+      const s = chunkUZ2D4BVX_js.matchScore(needle, cand);
       if (s > candidateScore) candidateScore = s;
     }
     if (candidateScore === 0) continue;
@@ -3046,14 +3476,14 @@ function findField(fieldId, registry) {
     }
   }
   if (bestComp && bestScore >= 75) {
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `findField: scored match "${fieldId}" -> "${bestComp.id}" (label="${bestComp.label}", score=${bestScore})`
     );
     return registry.getField(bestComp.id);
   }
-  const currentScreen = chunkKZ2BLMS4_js.getCurrentScreen();
+  const currentScreen = chunkUZ2D4BVX_js.getCurrentScreen();
   if (currentScreen) {
-    const screenMeta = chunkKZ2BLMS4_js.getScreenMetadata(currentScreen);
+    const screenMeta = chunkUZ2D4BVX_js.getScreenMetadata(currentScreen);
     const fields = screenMeta?.fields;
     if (fields && Array.isArray(fields)) {
       const metaField = fields.find(
@@ -3061,19 +3491,19 @@ function findField(fieldId, registry) {
       );
       if (metaField && typeof metaField === "object" && metaField.label) {
         const metaLabel = metaField.label;
-        const metaNeedle = chunkKZ2BLMS4_js.normalize3(metaLabel);
+        const metaNeedle = chunkUZ2D4BVX_js.normalize3(metaLabel);
         let mBest;
         let mBestScore = 0;
         for (const comp of snapshot) {
           if (comp.kind !== "field" || !comp.label) continue;
-          const score = chunkKZ2BLMS4_js.matchScore(metaNeedle, chunkKZ2BLMS4_js.normalize3(comp.label));
+          const score = chunkUZ2D4BVX_js.matchScore(metaNeedle, chunkUZ2D4BVX_js.normalize3(comp.label));
           if (score > mBestScore) {
             mBestScore = score;
             mBest = comp;
           }
         }
         if (mBest && mBestScore >= 60) {
-          chunkKZ2BLMS4_js.appilotsDebugLog(
+          chunkUZ2D4BVX_js.appilotsDebugLog(
             `findField: FOUND via screen metadata translation: fieldId="${fieldId}" -> metaLabel="${metaLabel}" -> registered="${mBest.id}" (score=${mBestScore})`
           );
           return registry.getField(mBest.id);
@@ -3082,34 +3512,34 @@ function findField(fieldId, registry) {
     }
   }
   if (bestComp && bestScore >= 40) {
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `findField: weak substring match "${fieldId}" -> "${bestComp.id}" (label="${bestComp.label}", score=${bestScore})`
     );
     return registry.getField(bestComp.id);
   }
-  chunkKZ2BLMS4_js.appilotsDebugWarn(
+  chunkUZ2D4BVX_js.appilotsDebugWarn(
     `findField: NOT FOUND \u2014 fieldId="${fieldId}" not in registry. Available fields: ${snapshot.filter((c) => c.kind === "field").map((c) => `"${c.id}" (label: ${c.label})`).join(", ") || "none"}`
   );
   return void 0;
 }
 function findToggle(fieldId, registry) {
-  chunkKZ2BLMS4_js.appilotsDebugLog(`findToggle: searching for fieldId="${fieldId}"`);
+  chunkUZ2D4BVX_js.appilotsDebugLog(`findToggle: searching for fieldId="${fieldId}"`);
   const exact = registry.getToggle(fieldId);
   if (exact) {
-    chunkKZ2BLMS4_js.appilotsDebugLog(`findToggle: FOUND exact match for "${fieldId}"`);
+    chunkUZ2D4BVX_js.appilotsDebugLog(`findToggle: FOUND exact match for "${fieldId}"`);
     return exact;
   }
   const lower = fieldId.toLowerCase();
   const snapshot = registry.snapshot();
   for (const comp of snapshot) {
     if (comp.kind === "toggle" && comp.id.toLowerCase() === lower) {
-      chunkKZ2BLMS4_js.appilotsDebugLog(
+      chunkUZ2D4BVX_js.appilotsDebugLog(
         `findToggle: FOUND case-insensitive match: registered="${comp.id}" for searched="${fieldId}"`
       );
       return registry.getToggle(comp.id);
     }
   }
-  chunkKZ2BLMS4_js.appilotsDebugWarn(
+  chunkUZ2D4BVX_js.appilotsDebugWarn(
     `findToggle: NOT FOUND \u2014 fieldId="${fieldId}" not in registry. Available toggles: ${snapshot.filter((c) => c.kind === "toggle").map((c) => `"${c.id}"`).join(", ") || "none"}`
   );
   return void 0;
@@ -3120,7 +3550,7 @@ function findSlider(fieldId, registry) {
   const lower = fieldId.toLowerCase();
   for (const comp of registry.snapshot()) {
     if (comp.kind === "slider" && comp.id.toLowerCase() === lower) {
-      chunkKZ2BLMS4_js.appilotsDebugLog(
+      chunkUZ2D4BVX_js.appilotsDebugLog(
         `findSlider: FOUND case-insensitive match: registered="${comp.id}" for searched="${fieldId}"`
       );
       return registry.getSlider(comp.id);
@@ -3128,17 +3558,17 @@ 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 ?? chunkKZ2BLMS4_js.componentRegistry;
+  const registry = context.registry ?? chunkUZ2D4BVX_js.componentRegistry;
   const { screen, activePath } = resolveScreenContext();
   const screenPath = activePath.length > 1 ? activePath.join("/") : screen;
   if (!permissions.canFillForms) {
     return {
       success: false,
-      error: "Form filling is not permitted",
-      diagnose: { category: "unknown", screen: screenPath }
+      error: chunkUZ2D4BVX_js.permissionDeniedMessage("Form filling", "canFillForms"),
+      diagnose: { category: "unknown", screen: screenPath, recoverable: false }
     };
   }
   if (!payload.fields || payload.fields.length === 0) {
@@ -3150,11 +3580,11 @@ async function formFillHandler(payload, context) {
   }
   const registrySnapshot = registry.snapshot();
   if (registrySnapshot.length === 0) {
-    chunkKZ2BLMS4_js.appilotsDebugWarn(
+    chunkUZ2D4BVX_js.appilotsDebugWarn(
       "formFillHandler: registry is EMPTY \u2014 auto-tracking may not be active. Ensure enableAppilotsAutoTracking() runs before components mount."
     );
   } else {
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `[Appilots formFillHandler] Registry has ${registrySnapshot.length} components:`,
       registrySnapshot.map((c) => `${c.kind}:${c.id}`).join(", ")
     );
@@ -3162,7 +3592,7 @@ async function formFillHandler(payload, context) {
   const fieldResults = [];
   let allSuccess = true;
   let selectedChoiceThisBatch = false;
-  chunkKZ2BLMS4_js.appilotsDebugLog(`formFillHandler: processing ${payload.fields.length} fields`);
+  chunkUZ2D4BVX_js.appilotsDebugLog(`formFillHandler: processing ${payload.fields.length} fields`);
   const availableFieldIds = () => registry.snapshot().filter((comp) => comp.kind === "field").map((comp) => `${comp.id}${comp.label ? ` (${comp.label})` : ""}`).slice(0, 8);
   const isElementIdField = (field) => typeof field.fieldId === "string" && field.fieldId.trim().toLowerCase().startsWith("el:");
   for (const field of payload.fields.filter(isElementIdField)) {
@@ -3189,20 +3619,57 @@ async function formFillHandler(payload, context) {
     const { fieldId, fieldType, value } = field;
     const effectiveFieldType = getEffectiveFieldType(fieldId, fieldType, registry);
     let selectFailure;
-    chunkKZ2BLMS4_js.appilotsDebugLog(
-      `formFillHandler: looking up fieldId="${fieldId}" fieldType="${fieldType}" effectiveFieldType="${effectiveFieldType}" value=${chunkKZ2BLMS4_js.describeValue(value)}`
+    chunkUZ2D4BVX_js.appilotsDebugLog(
+      `formFillHandler: looking up fieldId="${fieldId}" fieldType="${fieldType}" effectiveFieldType="${effectiveFieldType}" value=${chunkUZ2D4BVX_js.describeValue(value)}`
     );
     const fieldEntry = findField(fieldId, registry);
     if (fieldEntry) {
       try {
-        chunkKZ2BLMS4_js.appilotsDebugLog(
+        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;
+        }
+        chunkUZ2D4BVX_js.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,
@@ -3222,11 +3689,11 @@ 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)) {
-            chunkKZ2BLMS4_js.appilotsDebugWarn(
+            chunkUZ2D4BVX_js.appilotsDebugWarn(
               `formFillHandler: select field "${fieldId}" setValue did not stick (wrote <${String(value).length} chars>, current is <${String(after ?? "").length} chars>), trying visible choice fallback`
             );
             const selectResult = await selectVisibleChoice(fieldId, value, registry, {
@@ -3343,7 +3810,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
           });
@@ -3351,24 +3818,50 @@ async function formFillHandler(payload, context) {
       }
       if (selectResult.success) {
         selectedChoiceThisBatch = true;
-        chunkKZ2BLMS4_js.appilotsDebugLog(
+        chunkUZ2D4BVX_js.appilotsDebugLog(
           `formFillHandler: selected visible option for "${fieldId}"` + (selectResult.selectedLabel ? ` \u2192 "${selectResult.selectedLabel}"` : "")
         );
-        await sleep2(120);
+        await sleep3(120);
         fieldResults.push({ fieldId, success: true });
         continue;
       }
       selectFailure = selectResult;
     }
-    chunkKZ2BLMS4_js.appilotsDebugLog(`formFillHandler: registry miss for "${fieldId}", falling back to fiber tree`);
+    chunkUZ2D4BVX_js.appilotsDebugLog(`formFillHandler: registry miss for "${fieldId}", falling back to fiber tree`);
     const handle = findInteractiveByIdentifier(fieldId, {
       kind: effectiveFieldType === "toggle" ? "toggle" : "field"
     });
     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);
-        chunkKZ2BLMS4_js.appilotsDebugLog(
+        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;
+        }
+        chunkUZ2D4BVX_js.appilotsDebugLog(
           `formFillHandler: fiber fallback succeeded for "${fieldId}" \u2192 label="${handle.label}"`
         );
         fieldResults.push({ fieldId, success: true });
@@ -3405,13 +3898,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);
-      chunkKZ2BLMS4_js.appilotsDebugWarn(
+      chunkUZ2D4BVX_js.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,
@@ -3422,7 +3927,7 @@ async function formFillHandler(payload, context) {
         registry
       );
       if (!submitResult.success) {
-        chunkKZ2BLMS4_js.appilotsDebugWarn(`formFillHandler: submitAfterFill failed \u2014 ${submitResult.error}`);
+        chunkUZ2D4BVX_js.appilotsDebugWarn(`formFillHandler: submitAfterFill failed \u2014 ${submitResult.error}`);
         return {
           success: false,
           error: submitResult.error,
@@ -3431,10 +3936,11 @@ async function formFillHandler(payload, context) {
         };
       }
       const postSubmit = await waitForPostSubmitOutcome({
-        submitTargetId: submitResult.pressedTargetId
+        submitTargetId: submitResult.pressedTargetId,
+        beforeTexts: beforeSubmitTexts
       });
       if (postSubmit.status === "pending") {
-        chunkKZ2BLMS4_js.appilotsDebugWarn(`formFillHandler: submit still pending \u2014 ${postSubmit.message}`);
+        chunkUZ2D4BVX_js.appilotsDebugWarn(`formFillHandler: submit still pending \u2014 ${postSubmit.message}`);
         return {
           success: false,
           error: postSubmit.message,
@@ -3443,7 +3949,7 @@ async function formFillHandler(payload, context) {
         };
       }
       if (postSubmit.status === "failure") {
-        chunkKZ2BLMS4_js.appilotsDebugWarn(
+        chunkUZ2D4BVX_js.appilotsDebugWarn(
           `formFillHandler: submit rejected by visible validation \u2014 ${postSubmit.message}`
         );
         return {
@@ -3458,7 +3964,10 @@ async function formFillHandler(payload, context) {
           }
         };
       }
-      chunkKZ2BLMS4_js.appilotsDebugLog("formFillHandler: submitAfterFill \u2014 submit completed");
+      if (postSubmit.status === "unverified") {
+        return { success: true, fieldResults, effect: "unknown" };
+      }
+      chunkUZ2D4BVX_js.appilotsDebugLog("formFillHandler: submitAfterFill \u2014 submit completed");
     }
   }
   const aggregatedDiagnose = aggregateFieldDiagnoses(fieldResults, screenPath);
@@ -3470,17 +3979,17 @@ async function formFillHandler(payload, context) {
   };
 }
 function pressSubmitButton(context, registry) {
-  const activePath = context.activePath ?? chunkKZ2BLMS4_js.getActiveRouteNames();
+  const activePath = context.activePath ?? chunkUZ2D4BVX_js.getActiveRouteNames();
   const hintScreen = context.screen ?? context.screenPath;
   const formScreens = resolveFormScreensForSubmit(hintScreen, activePath, registry);
-  const resolvedScreen = formScreens.find((name) => screenDeclaresSubmit(name)) ?? formScreens[0] ?? hintScreen ?? chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0;
+  const resolvedScreen = formScreens.find((name) => screenDeclaresSubmit(name)) ?? formScreens[0] ?? hintScreen ?? chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0;
   const candidates = collectSubmitTargetCandidates(formScreens, registry);
   for (const candidate of candidates) {
     const target = registry.getTarget(candidate);
     if (target) {
       try {
         target.press();
-        chunkKZ2BLMS4_js.appilotsDebugLog(
+        chunkUZ2D4BVX_js.appilotsDebugLog(
           `formFillHandler: submitAfterFill \u2014 pressed registry target "${candidate}"` + (resolvedScreen ? ` on screen "${resolvedScreen}"` : "")
         );
         return { success: true, pressedTargetId: candidate };
@@ -3494,7 +4003,7 @@ function pressSubmitButton(context, registry) {
     }
   }
   for (const screenName of formScreens) {
-    const screenMeta = chunkKZ2BLMS4_js.getScreenMetadata(screenName);
+    const screenMeta = chunkUZ2D4BVX_js.getScreenMetadata(screenName);
     const submitMeta = Array.isArray(screenMeta?.actions) ? screenMeta.actions.find(
       (action) => typeof action === "object" && action !== null && action.type === "submit"
     ) : void 0;
@@ -3505,7 +4014,7 @@ function pressSubmitButton(context, registry) {
       if (handle?.press) {
         try {
           handle.press();
-          chunkKZ2BLMS4_js.appilotsDebugLog(`formFillHandler: submitAfterFill \u2014 fiber fallback "${submitLabel}"`);
+          chunkUZ2D4BVX_js.appilotsDebugLog(`formFillHandler: submitAfterFill \u2014 fiber fallback "${submitLabel}"`);
           return { success: true, pressedTargetId: submitId ?? submitLabel };
         } catch (err) {
           return {
@@ -3527,7 +4036,7 @@ function pressSubmitButton(context, registry) {
     if (id) {
       const pressed = pressTargetByIdOrLabel(id, registry);
       if (pressed.success) {
-        chunkKZ2BLMS4_js.appilotsDebugLog(`formFillHandler: submitAfterFill \u2014 pressed visible heuristic "${id}"`);
+        chunkUZ2D4BVX_js.appilotsDebugLog(`formFillHandler: submitAfterFill \u2014 pressed visible heuristic "${id}"`);
         return { success: true, pressedTargetId: id };
       }
     }
@@ -3541,7 +4050,7 @@ function pressSubmitButton(context, registry) {
     if (target) {
       try {
         target.press();
-        chunkKZ2BLMS4_js.appilotsDebugLog(
+        chunkUZ2D4BVX_js.appilotsDebugLog(
           `formFillHandler: submitAfterFill \u2014 pressed by label heuristic "${comp.label}"`
         );
         return { success: true, pressedTargetId: comp.id };
@@ -3557,7 +4066,7 @@ function pressSubmitButton(context, registry) {
   for (const fieldId of [...context.filledFieldIds ?? []].reverse()) {
     const handle = findInteractiveByIdentifier(fieldId, { kind: "field" });
     if (handle?.submitFromKeyboard?.()) {
-      chunkKZ2BLMS4_js.appilotsDebugLog(`formFillHandler: submitAfterFill \u2014 return key on "${fieldId}"`);
+      chunkUZ2D4BVX_js.appilotsDebugLog(`formFillHandler: submitAfterFill \u2014 return key on "${fieldId}"`);
       return { success: true, pressedTargetId: fieldId };
     }
   }
@@ -3595,7 +4104,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 (!chunkUZ2D4BVX_js.probeLoadingState(void 0, chunkUZ2D4BVX_js.getCurrentScreen()).loading) return;
+  const deadline = Date.now() + PAGINATION_MAX_WAIT_MS;
+  while (Date.now() < deadline) {
+    await sleep4(PAGINATION_POLL_MS);
+    if (!chunkUZ2D4BVX_js.probeLoadingState(void 0, chunkUZ2D4BVX_js.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, "");
 }
@@ -3603,12 +4126,12 @@ function buildDiagnose(category, targetId, candidates) {
   return {
     category,
     targetId,
-    screen: chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0,
+    screen: chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0,
     ...candidates && candidates.length > 0 ? { candidates: candidates.slice(0, 8) } : {}
   };
 }
 function resolveListEntry(listId) {
-  const entries = chunkKZ2BLMS4_js.listRegistry.snapshot();
+  const entries = chunkUZ2D4BVX_js.listRegistry.snapshot();
   if (entries.length === 0) return {};
   if (listId) {
     const wanted = normalizeId2(listId);
@@ -3631,13 +4154,26 @@ function pageOffset(metrics, direction) {
   }
   return next;
 }
+async function finishScroll(entry, before) {
+  await settleAfterScroll();
+  const current2 = chunkUZ2D4BVX_js.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: chunkUZ2D4BVX_js.permissionDeniedMessage("UI interaction", "canInteractUI"),
+      diagnose: { ...buildDiagnose("unknown", payload.listId), recoverable: false }
     };
   }
   const toIndex = typeof payload.toIndex === "number" ? payload.toIndex : void 0;
@@ -3665,6 +4201,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 {
@@ -3680,17 +4225,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 {
@@ -3700,10 +4244,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,
@@ -3717,6 +4272,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 = chunkUZ2D4BVX_js.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 (chunkUZ2D4BVX_js.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) {
@@ -3734,12 +4342,12 @@ 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 chunkKZ2BLMS4_js.componentRegistry.snapshot()) {
+  for (const { id, kind } of chunkUZ2D4BVX_js.componentRegistry.snapshot()) {
     if (kind !== "field") continue;
-    const entry = chunkKZ2BLMS4_js.componentRegistry.getField(id);
+    const entry = chunkUZ2D4BVX_js.componentRegistry.getField(id);
     if (!entry || !DISCRETE_FIELD_TYPES.has(entry.fieldType ?? "")) continue;
     try {
       sigs.push(`${id}:${hashFieldValue(String(entry.getValue() ?? ""))}`);
@@ -3748,34 +4356,46 @@ function discreteFieldSignature() {
   }
   return sigs.sort().join(",");
 }
-async function waitForPostInteractionSettle(payload) {
+function capturePreInteractionBaseline(payload) {
+  const targetId = targetIdFromPayload(payload);
+  const screen = chunkUZ2D4BVX_js.getCurrentScreen();
+  const probe = chunkUZ2D4BVX_js.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 = chunkKZ2BLMS4_js.getCurrentScreen();
-  const baseline = chunkKZ2BLMS4_js.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 = chunkKZ2BLMS4_js.probeLoadingState(targetId || null, chunkKZ2BLMS4_js.getCurrentScreen());
+  const afterPress = chunkUZ2D4BVX_js.probeLoadingState(targetId || null, chunkUZ2D4BVX_js.getCurrentScreen());
   const modalOrLoading = afterPress.modalOpen || afterPress.loading || afterPress.pressedDisabled;
   const fingerprintChanged = afterPress.fingerprint !== baseline.fingerprint;
   const verdict = () => {
     if (!readable) return { effect: "unknown" };
-    const settled = chunkKZ2BLMS4_js.probeLoadingState(targetId || null, chunkKZ2BLMS4_js.getCurrentScreen());
+    const settled = chunkUZ2D4BVX_js.probeLoadingState(targetId || null, chunkUZ2D4BVX_js.getCurrentScreen());
     if (settled.fingerprint === "") return { effect: "unknown" };
     if (discreteFieldSignature() !== baselineFields) return { effect: "changed" };
     return { effect: settled.fingerprint !== baseline.fingerprint ? "changed" : "none" };
   };
-  const capMs = chunkKZ2BLMS4_js.isListItemPressTarget(targetId) ? 5e3 : 1e4;
+  const declared = declaredBudgetMs(resolveActionHints(fromScreen, targetId || null, payload));
+  const capMs = declared ?? (chunkUZ2D4BVX_js.isListItemPressTarget(targetId) ? 5e3 : 1e4);
   if (modalOrLoading || fingerprintChanged) {
-    await chunkKZ2BLMS4_js.waitForLoadingSettle({
+    await chunkUZ2D4BVX_js.waitForLoadingSettle({
       pressedComponentId: targetId || null,
       fromScreen,
       maxMs: capMs
     });
     return verdict();
   }
-  if (chunkKZ2BLMS4_js.isListItemPressTarget(targetId)) {
-    await chunkKZ2BLMS4_js.waitForLoadingSettle({
+  if (chunkUZ2D4BVX_js.isListItemPressTarget(targetId)) {
+    await chunkUZ2D4BVX_js.waitForLoadingSettle({
       fromScreen,
       maxMs: 3e3
     });
@@ -3784,19 +4404,13 @@ 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,
     error: message,
     diagnose: {
       category: "validation",
-      screen: chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0,
+      screen: chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0,
       ...ids ?? {}
     }
   });
@@ -3857,10 +4471,10 @@ function isDestructivePayload(payload) {
   return !!params && typeof params === "object" && params.destructive === true;
 }
 async function executeAction(action, context) {
-  chunkKZ2BLMS4_js.appilotsDebugLog(
+  chunkUZ2D4BVX_js.appilotsDebugLog(
     `executeAction called: type="${action.type}", id="${action.id}", payload=${JSON.stringify(action.payload)}`
   );
-  const permissions = context.permissions ?? DEFAULT_PERMISSIONS;
+  const permissions = chunkUZ2D4BVX_js.resolveAgentPermissions(context.permissions);
   context.emit({
     type: "agent:action:start",
     timestamp: Date.now(),
@@ -3886,7 +4500,7 @@ async function executeAction(action, context) {
   let result;
   const validationFailure = validateActionPayload(action);
   if (validationFailure) {
-    chunkKZ2BLMS4_js.appilotsDebugWarn(
+    chunkUZ2D4BVX_js.appilotsDebugWarn(
       `executeAction: payload validation failed for type="${action.type}" id="${action.id}": ${validationFailure.error}`
     );
     context.emit({
@@ -3913,17 +4527,18 @@ async function executeAction(action, context) {
       case "form_fill":
         result = await formFillHandler(action.payload, {
           permissions,
-          registry: context.registry ?? chunkKZ2BLMS4_js.getDefaultRegistry()
+          registry: context.registry ?? chunkUZ2D4BVX_js.getDefaultRegistry()
         });
         break;
       case "ui_interaction": {
         const payload = action.payload;
+        const baseline = capturePreInteractionBaseline(payload);
         result = uiInteractionHandler(payload, {
           permissions,
-          registry: context.registry ?? chunkKZ2BLMS4_js.getDefaultRegistry()
+          registry: context.registry ?? chunkUZ2D4BVX_js.getDefaultRegistry()
         });
         if (result.success) {
-          const settle = await waitForPostInteractionSettle(payload);
+          const settle = await waitForPostInteractionSettle(payload, baseline);
           result.effect = result.effect ?? effectFor(payload, settle.effect);
         }
         break;
@@ -3949,7 +4564,7 @@ async function executeAction(action, context) {
         };
     }
   } catch (err) {
-    chunkKZ2BLMS4_js.appilotsDebugWarn(
+    chunkUZ2D4BVX_js.appilotsDebugWarn(
       `executeAction: exception during action type="${action.type}" id="${action.id}": ${err?.message}`
     );
     result = {
@@ -3957,7 +4572,7 @@ async function executeAction(action, context) {
       error: err?.message ?? "Action execution failed unexpectedly"
     };
   }
-  chunkKZ2BLMS4_js.appilotsDebugLog(
+  chunkUZ2D4BVX_js.appilotsDebugLog(
     `executeAction result: type="${action.type}", id="${action.id}", success=${result.success}, error=${result.error ?? "none"}`
   );
   context.emit({
@@ -4011,18 +4626,28 @@ var _patchedAlert = (title, message, buttons, options) => {
     return suppression.originalAlert(title, message, buttons, options);
   }
   suppression.consumed = true;
-  chunkKZ2BLMS4_js.appilotsDebugLog("Suppressing native Alert during already-confirmed destructive agent action");
+  const report = (handlerCompleted) => suppression.onHandled?.({
+    title: title.slice(0, 300),
+    message: message?.slice(0, 1e3),
+    buttonLabel: button.text?.slice(0, 160),
+    handlerCompleted
+  });
+  chunkUZ2D4BVX_js.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;
@@ -4043,6 +4668,7 @@ async function runWithConfirmedDestructiveContext(enabled, host, fn) {
     depth: 1,
     consumed: false,
     pending: null,
+    onHandled,
     timer: null
   };
   _active = suppression;
@@ -4062,138 +4688,153 @@ async function runWithConfirmedDestructiveContext(enabled, host, fn) {
 }
 
 // src/platform/reactNativeAdapter.ts
-var POST_ACTION_LOADING_MAX_MS = 6e3;
+var deltaTracker = chunkUZ2D4BVX_js.createSnapshotDeltaTracker();
 function resolveScreenMetadata() {
-  const activePath = chunkKZ2BLMS4_js.getActiveRouteNames();
+  const activePath = chunkUZ2D4BVX_js.getActiveRouteNames();
   for (let i = activePath.length - 1; i >= 0; i--) {
     const name = activePath[i];
-    const meta = name ? chunkKZ2BLMS4_js.getScreenMetadata(name) : void 0;
+    const meta = name ? chunkUZ2D4BVX_js.getScreenMetadata(name) : void 0;
     if (meta && (Array.isArray(meta.fields) && meta.fields.length > 0 || Array.isArray(meta.actions) && meta.actions.length > 0)) {
       return meta;
     }
   }
-  const screen = chunkKZ2BLMS4_js.getCurrentScreen();
-  return screen ? chunkKZ2BLMS4_js.getScreenMetadata(screen) : void 0;
+  const screen = chunkUZ2D4BVX_js.getCurrentScreen();
+  return screen ? chunkUZ2D4BVX_js.getScreenMetadata(screen) : void 0;
 }
 function buildAgentContext(extras = {}) {
+  if (extras.newMission === true) {
+    deltaTracker.reset();
+    for (const entry of chunkUZ2D4BVX_js.listRegistry.snapshot()) entry.exploration?.reset();
+  }
   const context = {};
   context.platform = "react-native";
-  const screen = chunkKZ2BLMS4_js.getCurrentScreen();
+  context.missionProtocol = 1;
+  context.deviceLocale = detectDeviceLocale() ?? "en";
+  const screen = chunkUZ2D4BVX_js.getCurrentScreen();
   if (screen) context.currentScreen = screen;
-  const navigationState = chunkKZ2BLMS4_js.getNavigationStateSnapshot();
+  const navigationState = chunkUZ2D4BVX_js.getNavigationStateSnapshot();
   if (navigationState) context.navigationState = navigationState;
   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 ? chunkUZ2D4BVX_js.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) {
-    chunkKZ2BLMS4_js.appilotsDebugWarn("buildAgentContext: captureSnapshot failed", err);
+    chunkUZ2D4BVX_js.appilotsDebugWarn("buildAgentContext: captureSnapshot failed", err);
   }
-  const registry = chunkKZ2BLMS4_js.componentRegistry.snapshot();
+  const registry = chunkUZ2D4BVX_js.componentRegistry.snapshot();
   const filtered = screen ? registry.filter((c) => !c.screen || c.screen === screen) : registry;
   if (filtered.length > 0) context.registeredComponents = filtered;
-  const registeredLists = chunkKZ2BLMS4_js.listRegistry.snapshot();
+  const registeredLists = chunkUZ2D4BVX_js.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 = chunkKZ2BLMS4_js.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 (chunkKZ2BLMS4_js.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(
+    chunkUZ2D4BVX_js.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 chunkKZ2BLMS4_js.waitForScreenSettle({
+    const settle = await chunkUZ2D4BVX_js.waitForScreenSettle({
       expectingChange: true,
       fromScreen: input.preNavigateScreen ?? null,
       fromSignature: input.preNavigateSignature ?? null,
       targetScreen: navigateTargetScreen,
       maxMs: 3500
     });
-    chunkKZ2BLMS4_js.appilotsDebugLog(
+    chunkUZ2D4BVX_js.appilotsDebugLog(
       `settleTurn: post-navigate settle done \u2014 screen="${settle.screen}" transitioned=${settle.transitioned} timedOut=${settle.timedOut} waitedMs=${settle.waitedMs}`
     );
-    const navigationMoved = settle.transitioned || chunkKZ2BLMS4_js.screenDepartedBaseline(input.preNavigateScreen ?? null, input.preNavigateSignature ?? null) || !!navigateTargetScreen && !!settle.screen && chunkKZ2BLMS4_js.routesBelongToSameFeature(settle.screen, navigateTargetScreen);
+    const navigationMoved = settle.transitioned || chunkUZ2D4BVX_js.screenDepartedBaseline(input.preNavigateScreen ?? null, input.preNavigateSignature ?? null) || !!navigateTargetScreen && !!settle.screen && chunkUZ2D4BVX_js.routesBelongToSameFeature(settle.screen, navigateTargetScreen);
     if (!navigationMoved) {
-      chunkKZ2BLMS4_js.appilotsDebugWarn(
+      chunkUZ2D4BVX_js.appilotsDebugWarn(
         `tool-without-effect: navigate emitted but screen did not change (stayed at "${input.preNavigateScreen ?? "unknown"}", waitedMs=${settle.waitedMs}). Likely causes: target screenName missing from MCP doc, nested-nav path absent, or React Navigation rejected the route.`
       );
       for (const [actionId, type] of typeById) {
         if (type === "navigate") toolWithoutEffectIds.add(actionId);
       }
     }
-    const loadSettle = await chunkKZ2BLMS4_js.waitForLoadingSettle({
+    const postNavigateCapMs = resolvePostNavigateCapMs(hints);
+    const loadSettle = await chunkUZ2D4BVX_js.waitForLoadingSettle({
       fromScreen: settle.screen ?? null,
-      maxMs: 3e3
+      maxMs: postNavigateCapMs
     });
-    chunkKZ2BLMS4_js.appilotsDebugLog(
-      `settleTurn: post-navigate loading settle \u2014 settled=${loadSettle.settled} loadingPending=${loadSettle.loadingPending} probes=${loadSettle.probeCount} waitedMs=${loadSettle.waitedMs}`
+    chunkUZ2D4BVX_js.appilotsDebugLog(
+      `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(chunkKZ2BLMS4_js.getCurrentScreen(), pressedId, pressedAction?.payload);
-    const settleCapMs = hints?.isAsyncTrigger === true ? 1e4 : POST_ACTION_LOADING_MAX_MS;
-    const loadSettle = await chunkKZ2BLMS4_js.waitForLoadingSettle({
+    const settleCapMs = resolveSettleCapMs(hints);
+    const busyMaxMs = resolveBusyCeilingMs(hints);
+    const loadSettle = await chunkUZ2D4BVX_js.waitForLoadingSettle({
       pressedComponentId: pressedId,
-      fromScreen: chunkKZ2BLMS4_js.getCurrentScreen(),
-      maxMs: settleCapMs
+      fromScreen: chunkUZ2D4BVX_js.getCurrentScreen(),
+      maxMs: settleCapMs,
+      ...busyMaxMs !== void 0 ? { busyMaxMs } : {}
     });
-    chunkKZ2BLMS4_js.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)" : ""}`
+    chunkUZ2D4BVX_js.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}${capSource}${busyMaxMs !== void 0 ? ` busyCap=${busyMaxMs}` : ""}`
     );
     if (loadSettle.loadingPending) loadingPending = true;
     const listPressActions = turnActions.filter((action) => {
-      const target = chunkKZ2BLMS4_js.actionPressTargetId(action);
-      return target ? chunkKZ2BLMS4_js.isListItemPressTarget(target) : false;
+      const target = chunkUZ2D4BVX_js.actionPressTargetId(action);
+      return target ? chunkUZ2D4BVX_js.isListItemPressTarget(target) : false;
     });
     if (listPressActions.length > 0) {
-      const baselineFingerprint = chunkKZ2BLMS4_js.probeLoadingState(pressedId, chunkKZ2BLMS4_js.getCurrentScreen()).fingerprint;
-      const postPressSettle = await chunkKZ2BLMS4_js.waitForScreenSettle({
+      const baselineFingerprint = chunkUZ2D4BVX_js.probeLoadingState(pressedId, chunkUZ2D4BVX_js.getCurrentScreen()).fingerprint;
+      const postPressSettle = await chunkUZ2D4BVX_js.waitForScreenSettle({
         expectingChange: true,
         fromScreen: input.preNavigateScreen ?? null,
         fromSignature: input.preNavigateSignature ?? null,
         maxMs: 2500
       });
-      await chunkKZ2BLMS4_js.waitForLoadingSettle({
+      await chunkUZ2D4BVX_js.waitForLoadingSettle({
         pressedComponentId: pressedId,
-        fromScreen: chunkKZ2BLMS4_js.getCurrentScreen(),
+        fromScreen: chunkUZ2D4BVX_js.getCurrentScreen(),
         maxMs: 4e3
       });
-      const afterFingerprint = chunkKZ2BLMS4_js.probeLoadingState(pressedId, chunkKZ2BLMS4_js.getCurrentScreen()).fingerprint;
-      chunkKZ2BLMS4_js.appilotsDebugLog(
+      const afterFingerprint = chunkUZ2D4BVX_js.probeLoadingState(pressedId, chunkUZ2D4BVX_js.getCurrentScreen()).fingerprint;
+      chunkUZ2D4BVX_js.appilotsDebugLog(
         `settleTurn: post-list-press settle \u2014 screen="${postPressSettle.screen}" transitioned=${postPressSettle.transitioned} timedOut=${postPressSettle.timedOut} waitedMs=${postPressSettle.waitedMs}`
       );
       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,46 +4846,68 @@ async function settleTurn(input) {
 }
 var reactNativeChatAdapter = {
   buildContext: buildAgentContext,
-  getCurrentScreen: chunkKZ2BLMS4_js.getCurrentScreen,
-  getCurrentScreenSignature: chunkKZ2BLMS4_js.getCurrentScreenSignature,
+  getCurrentScreen: chunkUZ2D4BVX_js.getCurrentScreen,
+  getCurrentScreenSignature: chunkUZ2D4BVX_js.getCurrentScreenSignature,
   settleTurn
 };
 function createReactNativeActionRunner(getOptions) {
   return {
+    buildMissionContext: () => reactNativeChatAdapter.buildContext(),
     async execute(action, { confirmedDestructive }) {
-      const { permissions, emit, navigationRef, suppressNativeConfirm } = getOptions();
-      const navRef = navigationRef?.current ? navigationRef : { current: chunkKZ2BLMS4_js.getNavigationRef() };
-      return runWithConfirmedDestructiveContext(
+      const { permissions, emit: emit2, navigationRef, suppressNativeConfirm } = getOptions();
+      const navRef = navigationRef?.current ? navigationRef : { current: chunkUZ2D4BVX_js.getNavigationRef() };
+      let receipt;
+      let terminal;
+      const result = await runWithConfirmedDestructiveContext(
         confirmedDestructive && suppressNativeConfirm !== false,
         reactNative.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: chunkKZ2BLMS4_js.getCurrentScreen,
-    getCurrentScreenSignature: chunkKZ2BLMS4_js.getCurrentScreenSignature,
+    getCurrentScreen: chunkUZ2D4BVX_js.getCurrentScreen,
+    getCurrentScreenSignature: chunkUZ2D4BVX_js.getCurrentScreenSignature,
     getScreenActionsMetadata(screen) {
-      return chunkKZ2BLMS4_js.getScreenMetadata(screen)?.actions;
+      return chunkUZ2D4BVX_js.getScreenMetadata(screen)?.actions;
     },
-    waitForScreenSettle: chunkKZ2BLMS4_js.waitForScreenSettle
+    waitForScreenSettle: chunkUZ2D4BVX_js.waitForScreenSettle
   };
 }
 
 // src/hooks/useAppilotsChat.ts
 function useAppilotsChat(options = {}) {
-  const { client, emit, subscribe } = chunkKZ2BLMS4_js.useAppilotsContext();
+  const { client, emit: emit2, subscribe } = chunkUZ2D4BVX_js.useAppilotsContext();
   const machine = React.useMemo(
-    () => new chunkKZ2BLMS4_js.ChatSessionMachine(
-      { client, adapter: reactNativeChatAdapter, emit, warn: chunkKZ2BLMS4_js.appilotsDebugWarn },
+    () => new chunkUZ2D4BVX_js.ChatSessionMachine(
+      { client, adapter: reactNativeChatAdapter, emit: emit2, warn: chunkUZ2D4BVX_js.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 = React.useRef(options);
   optionsRef.current = options;
@@ -4252,6 +4915,14 @@ function useAppilotsChat(options = {}) {
   const state = React.useSyncExternalStore(machine.subscribeState, machine.getState, machine.getState);
   React.useEffect(() => subscribe(machine.handleEvent), [subscribe, machine]);
   React.useEffect(() => () => machine.dispose(), [machine]);
+  React.useEffect(() => {
+    void machine.restoreMission();
+    const subscription = reactNative.AppState?.addEventListener?.("change", (next) => {
+      if (next !== "active" && machine.getState().mission?.status === "running")
+        void machine.pauseMission();
+    });
+    return () => subscription?.remove();
+  }, [machine]);
   const requestHuman = React.useCallback(
     (reason) => machine.requestHuman(reason),
     [machine]
@@ -4261,7 +4932,13 @@ function useAppilotsChat(options = {}) {
   const clearMessages = React.useCallback(() => machine.clearMessages(), [machine]);
   const clearError = React.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,
@@ -4274,39 +4951,33 @@ function useAppilotsChat(options = {}) {
     clearError
   };
 }
-var DEFAULT_PERMISSIONS2 = {
-  canNavigate: true,
-  canFillForms: true,
-  canInteractUI: true,
-  canSubmitForms: true
-};
 function useAppilotsActions(options = {}) {
-  const { client, subscribe, config, emit } = chunkKZ2BLMS4_js.useAppilotsContext();
+  const { client, subscribe, config, emit: emit2 } = chunkUZ2D4BVX_js.useAppilotsContext();
   const { navigationRef, autoExecute = false } = options;
   const runnerOptionsRef = React.useRef({
-    permissions: config.permissions ?? DEFAULT_PERMISSIONS2,
-    emit,
+    permissions: chunkUZ2D4BVX_js.resolveAgentPermissions(config.permissions),
+    emit: emit2,
     navigationRef,
     suppressNativeConfirm: config.suppressNativeConfirm
   });
   runnerOptionsRef.current = {
-    permissions: config.permissions ?? DEFAULT_PERMISSIONS2,
-    emit,
+    permissions: chunkUZ2D4BVX_js.resolveAgentPermissions(config.permissions),
+    emit: emit2,
     navigationRef,
     suppressNativeConfirm: config.suppressNativeConfirm
   };
   const machine = React.useMemo(
-    () => new chunkKZ2BLMS4_js.ActionQueueMachine(
+    () => new chunkUZ2D4BVX_js.ActionQueueMachine(
       {
         client,
         adapter: createReactNativeActionRunner(() => runnerOptionsRef.current),
-        emit,
-        warn: chunkKZ2BLMS4_js.appilotsDebugWarn
+        emit: emit2,
+        warn: chunkUZ2D4BVX_js.appilotsDebugWarn
       },
       { autoExecute }
     ),
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    [client, emit]
+    [client, emit2]
   );
   machine.setOptions({ autoExecute });
   const state = React.useSyncExternalStore(machine.subscribeState, machine.getState, machine.getState);
@@ -4358,7 +5029,7 @@ function shouldShowSuggestedPrompts(args) {
 
 // src/hooks/useSuggestedPrompts.ts
 function useSuggestedPrompts(options) {
-  const { client } = chunkKZ2BLMS4_js.useAppilotsContext();
+  const { client } = chunkUZ2D4BVX_js.useAppilotsContext();
   const { enabled, limit = 4 } = options;
   const [prompts, setPrompts] = React.useState([]);
   const [isLoading, setIsLoading] = React.useState(false);
@@ -4368,8 +5039,8 @@ function useSuggestedPrompts(options) {
     if (!enabled) return;
     const requestId = ++requestIdRef.current;
     let cancelled = false;
-    const screen = chunkKZ2BLMS4_js.getCurrentScreen() ?? void 0;
-    const localDev = screen ? (chunkKZ2BLMS4_js.getScreenMetadata(screen)?.suggestedPrompts ?? []).map((text) => ({
+    const screen = chunkUZ2D4BVX_js.getCurrentScreen() ?? void 0;
+    const localDev = screen ? (chunkUZ2D4BVX_js.getScreenMetadata(screen)?.suggestedPrompts ?? []).map((text) => ({
       text,
       source: "dev-defined"
     })) : [];
@@ -4383,7 +5054,7 @@ function useSuggestedPrompts(options) {
       if (cancelled || requestIdRef.current !== requestId) return;
       setPrompts(mergePromptSources(localDev, data, limit));
     }).catch((err) => {
-      chunkKZ2BLMS4_js.appilotsDebugWarn("useSuggestedPrompts: fetch failed", err);
+      chunkUZ2D4BVX_js.appilotsDebugWarn("useSuggestedPrompts: fetch failed", err);
     }).finally(() => {
       if (cancelled || requestIdRef.current !== requestId) return;
       setIsLoading(false);
@@ -4394,11 +5065,11 @@ function useSuggestedPrompts(options) {
   }, [client, enabled, limit, refreshTick]);
   React.useEffect(() => {
     if (!enabled) return;
-    let lastScreen = chunkKZ2BLMS4_js.getCurrentScreen();
+    let lastScreen = chunkUZ2D4BVX_js.getCurrentScreen();
     const interval = setInterval(() => {
-      const current = chunkKZ2BLMS4_js.getCurrentScreen();
-      if (current !== lastScreen) {
-        lastScreen = current;
+      const current2 = chunkUZ2D4BVX_js.getCurrentScreen();
+      if (current2 !== lastScreen) {
+        lastScreen = current2;
         setRefreshTick((t) => t + 1);
       }
     }, 800);
@@ -4411,22 +5082,22 @@ function useSuggestedPrompts(options) {
   };
 }
 function useAppilotsNavigation() {
-  const { emit } = chunkKZ2BLMS4_js.useAppilotsContext();
+  const { emit: emit2 } = chunkUZ2D4BVX_js.useAppilotsContext();
   const [currentScreen, setCurrentScreenState] = React.useState(null);
   const [navigationHistory, setNavigationHistory] = React.useState([]);
   const navigationRef = React.useRef(null);
   const setCurrentScreen2 = React.useCallback(
     (screenName) => {
       setCurrentScreenState(screenName);
-      chunkKZ2BLMS4_js.setCurrentScreen(screenName);
+      chunkUZ2D4BVX_js.setCurrentScreen(screenName);
       setNavigationHistory((prev) => [...prev, screenName]);
-      emit({
+      emit2({
         type: "navigation:change",
         timestamp: Date.now(),
         data: { screenName }
       });
     },
-    [emit]
+    [emit2]
   );
   React.useEffect(() => {
     const nav = navigationRef.current;
@@ -4449,7 +5120,7 @@ function useAppilotsNavigation() {
 
 // src/hooks/useAppilots.ts
 function useAppilots() {
-  const { config, client } = chunkKZ2BLMS4_js.useAppilotsContext();
+  const { config, client } = chunkUZ2D4BVX_js.useAppilotsContext();
   const chat = useAppilotsChat();
   const navigation = useAppilotsNavigation();
   const actions = useAppilotsActions();
@@ -4476,9 +5147,14 @@ function useAppilots() {
     rejectAction: actions.rejectAction
   };
 }
+function useAppilotsElementProps(id) {
+  return React.useMemo(() => ({ testID: id }), [id]);
+}
+
+// src/hooks/useAppilotsField.ts
 function useAppilotsField(id, options) {
   const { value, onChangeText, ref, fieldType, label, screen } = options;
-  const registry = chunkKZ2BLMS4_js.useResolvedRegistry();
+  const registry = chunkUZ2D4BVX_js.useResolvedRegistry();
   const valueRef = React.useRef(value);
   const onChangeRef = React.useRef(onChangeText);
   valueRef.current = value;
@@ -4503,10 +5179,11 @@ 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;
-  const registry = chunkKZ2BLMS4_js.useResolvedRegistry();
+  const registry = chunkUZ2D4BVX_js.useResolvedRegistry();
   const onPressRef = React.useRef(onPress);
   const onLongPressRef = React.useRef(onLongPress);
   const onScrollToRef = React.useRef(onScrollTo);
@@ -4530,10 +5207,11 @@ 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;
-  const registry = chunkKZ2BLMS4_js.useResolvedRegistry();
+  const registry = chunkUZ2D4BVX_js.useResolvedRegistry();
   const valueRef = React.useRef(value);
   const onChangeRef = React.useRef(onValueChange);
   valueRef.current = value;
@@ -4553,10 +5231,11 @@ 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;
-  const registry = chunkKZ2BLMS4_js.useResolvedRegistry();
+  const registry = chunkUZ2D4BVX_js.useResolvedRegistry();
   const valueRef = React.useRef(value);
   const onChangeRef = React.useRef(onValueChange);
   valueRef.current = value;
@@ -4579,16 +5258,30 @@ function useAppilotsSlider(id, options) {
       registry.unregister(id);
     };
   }, [id, registry, getValue, setValue, min, max, step, label, screen]);
+  return useAppilotsElementProps(id);
 }
 
+exports.AppilotsI18nProvider = AppilotsI18nProvider;
+exports.REVEAL_MARGIN = REVEAL_MARGIN;
+exports.SPOTLIGHT_TTL_MS = SPOTLIGHT_TTL_MS;
 exports.appilotsSelfCheck = appilotsSelfCheck;
 exports.captureSnapshot = captureSnapshot;
+exports.detectDeviceLocale = detectDeviceLocale;
 exports.executeAction = executeAction;
+exports.getSpotlightMode = getSpotlightMode;
+exports.getSpotlightTarget = getSpotlightTarget;
+exports.offsetToReveal = offsetToReveal;
+exports.resolveLocale = resolveLocale;
+exports.revealTarget = revealTarget;
+exports.setSpotlightMode = setSpotlightMode;
+exports.setSpotlightTarget = setSpotlightTarget;
 exports.shouldShowSuggestedPrompts = shouldShowSuggestedPrompts;
+exports.subscribeSpotlight = subscribeSpotlight;
 exports.useAppilots = useAppilots;
 exports.useAppilotsActions = useAppilotsActions;
 exports.useAppilotsChat = useAppilotsChat;
 exports.useAppilotsField = useAppilotsField;
+exports.useAppilotsI18n = useAppilotsI18n;
 exports.useAppilotsNavigation = useAppilotsNavigation;
 exports.useAppilotsSlider = useAppilotsSlider;
 exports.useAppilotsTarget = useAppilotsTarget;