@appilots/sdk 0.8.0 → 0.10.0

package/dist/{chunk-MHWVRZYF.mjs → chunk-XHR65V2W.mjs}

@@ -1,659 +1,7 @@
-import { getFiberRoot, recordIntrospectionFailure, getCurrentScreen, getActiveRouteNames, clampSnapshotToWireLimits, deriveInteractionElements, attachElementIdsToChoiceGroups, elementRegistry, appilotsDebugWarn, getDefaultRegistry, useAppilotsContext, ChatSessionMachine, getCurrentScreenSignature, ActionQueueMachine, getScreenMetadata, setCurrentScreen, useResolvedRegistry, listRegistry, componentRegistry, probeLoadingState, isListItemPressTarget, waitForLoadingSettle, appilotsDebugLog, waitForScreenSettle, screenDepartedBaseline, routesBelongToSameFeature, actionPressTargetId, getNavigationStateSnapshot, getNavigationRef, isOptionalStepAutomationFailure, OPTIONAL_STEP_AUTOMATION_HINT, normalize3, matchScore, idLooselyMatches, parseStableElementId, getAllScreens, snapshotShowsOpenCreateForm, looksDestructiveActionLabel, isGenericSelectValue } from './chunk-C2KVVJ5K.mjs';
-import { useMemo, useRef, useSyncExternalStore, useEffect, useCallback, useState } from 'react';
+import { getFiberRoot, appilotsDebugWarn, recordIntrospectionFailure, getCurrentScreen, walkFiber, getActiveRouteNames, clampSnapshotToWireLimits, deriveInteractionElements, rectForNode, toWireElement, attachElementIdsToChoiceGroups, elementRegistry, appilotsDebugLog, getLastWalkDiagnostics, SDK_VERSION, geometryStats, geometryAvailability, getNameManglingProbe, emptyDetectorCounts, getAutoTrackingState, getIntrospectionDiagnostics, getDefaultRegistry, useAppilotsContext, ChatSessionMachine, getCurrentScreenSignature, ActionQueueMachine, getScreenMetadata, setCurrentScreen, useResolvedRegistry, totalDetectorHits, listRegistry, getOpenNativeDialog, componentRegistry, getLastAnsweredNativeDialog, probeLoadingState, isListItemPressTarget, waitForLoadingSettle, describeValue, waitForScreenSettle, screenDepartedBaseline, routesBelongToSameFeature, actionPressTargetId, getNavigationStateSnapshot, getNavigationRef, isOptionalStepAutomationFailure, OPTIONAL_STEP_AUTOMATION_HINT, normalize3, matchScore, FORM_VALIDATION_TEXT_RE, idLooselyMatches, parseStableElementId, shouldSkipSubtree, isAlwaysListContainer, isHeuristicListContainer, findListItems, getTypeName, foldForCompare, isModalFiber, getAllScreens, snapshotShowsOpenCreateForm, switchValue, isReferenceable, looksDestructiveActionLabel, isGenericSelectValue, FORM_WRITE_SUCCESS_TEXT_RE, isSwitchLike, TOUCHABLE_NAMES } from './chunk-AHHDOUVX.mjs';
+import React, { useMemo, useRef, useSyncExternalStore, useEffect, useCallback, useState } from 'react';
 import { Alert } from 'react-native';
 
-// src/introspection/walkFiber.ts
-function getTypeName(type) {
-  if (!type) return null;
-  if (typeof type === "string") return type;
-  if (typeof type === "function") {
-    return type.displayName ?? type.name ?? null;
-  }
-  if (typeof type === "object") {
-    if (type.displayName) return type.displayName;
-    if (type.render) {
-      return type.render.displayName ?? type.render.name ?? null;
-    }
-    if (type.type) return getTypeName(type.type);
-  }
-  return null;
-}
-function matchesName(fiber, name) {
-  return getTypeName(fiber.type) === name || getTypeName(fiber.elementType) === name;
-}
-function extractTextFromChildren(children) {
-  if (children == null) return "";
-  if (typeof children === "string") return children;
-  if (typeof children === "number") return String(children);
-  if (Array.isArray(children)) {
-    return children.map((c) => extractTextFromChildren(c)).filter(Boolean).join("");
-  }
-  return "";
-}
-function hasMeaningfulText(text) {
-  return !!text && /[\p{L}\p{N}]/u.test(text);
-}
-function findChildText(fiber) {
-  const stack = [];
-  if (fiber.child) stack.push(fiber.child);
-  const visited = /* @__PURE__ */ new WeakSet();
-  const texts = [];
-  while (stack.length > 0) {
-    const node = stack.pop();
-    if (!node || visited.has(node)) continue;
-    visited.add(node);
-    if (matchesName(node, "Text")) {
-      const text = extractTextFromChildren(node.memoizedProps?.children);
-      const trimmed = text.trim();
-      if (hasMeaningfulText(trimmed)) {
-        texts.push(trimmed);
-        if (texts.length >= 3) break;
-      }
-    }
-    if (node.sibling) stack.push(node.sibling);
-    if (node.child) stack.push(node.child);
-  }
-  return texts.length > 0 ? texts.join(" \xB7 ") : void 0;
-}
-var SELF_REFERENTIAL_COMPONENTS = /* @__PURE__ */ new Set([
-  "AppilotsChat",
-  "AppilotsChatInner",
-  "ActionBreadcrumb",
-  "ConfirmDialog"
-]);
-function isAppilotsSkipMarked(props) {
-  if (!props) return false;
-  return props.__appilotsSkip === true || props["data-appilots-skip"] === true || props.appilotsSkip === true;
-}
-function isAppilotsSensitiveMarked(props) {
-  if (!props) return false;
-  return props.__appilotsSensitive === true || props["data-appilots-sensitive"] === true || props.appilotsSensitive === true;
-}
-function stringProp(props, name) {
-  const value = props?.[name];
-  return typeof value === "string" && value.length > 0 ? value : void 0;
-}
-function numberProp(props, name) {
-  const value = props?.[name];
-  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
-}
-function shouldSkipSubtree(fiber) {
-  const props = fiber.memoizedProps;
-  if (!props) return false;
-  const typeName = getTypeName(fiber.type) ?? getTypeName(fiber.elementType);
-  if (typeName && SELF_REFERENTIAL_COMPONENTS.has(typeName)) return true;
-  if (isAppilotsSkipMarked(props)) return true;
-  if (matchesName(fiber, "Modal") && props.visible === false) return true;
-  if (matchesName(fiber, "Screen") && props.activityState === 0) return true;
-  const style = props.style;
-  if (style) {
-    const flat = Array.isArray(style) ? Object.assign({}, ...style.filter(Boolean)) : style;
-    if (flat?.display === "none") return true;
-    if (flat?.opacity === 0 && props.pointerEvents === "none") return true;
-  }
-  return false;
-}
-function inferInputType(props) {
-  if (props.secureTextEntry || isAppilotsSensitiveMarked(props)) return "password";
-  switch (props.keyboardType) {
-    case "email-address":
-      return "email";
-    case "numeric":
-    case "number-pad":
-    case "decimal-pad":
-      return "number";
-    case "phone-pad":
-      return "phone";
-    default:
-      return "text";
-  }
-}
-function inferLabel(props) {
-  return props.accessibilityLabel ?? props.label ?? props.placeholder ?? props.testID;
-}
-function bestId(props) {
-  return props.testID ?? props.accessibilityLabel ?? void 0;
-}
-var ALWAYS_LIST_NAMES = /* @__PURE__ */ new Set([
-  "FlatList",
-  "SectionList",
-  "VirtualizedList",
-  // Shopify's high-perf FlatList replacement — same usage shape, same
-  // virtualization, same per-item key.
-  "FlashList"
-]);
-var HEURISTIC_LIST_NAMES = /* @__PURE__ */ new Set(["ScrollView"]);
-var LIST_CELL_NAMES = /* @__PURE__ */ new Set([
-  "CellRenderer",
-  "CellRendererComponent",
-  "VirtualizedListCellContextProvider"
-]);
-function isAlwaysListContainer(fiber) {
-  for (const name of ALWAYS_LIST_NAMES) {
-    if (matchesName(fiber, name)) return true;
-  }
-  return false;
-}
-function isHeuristicListContainer(fiber) {
-  for (const name of HEURISTIC_LIST_NAMES) {
-    if (matchesName(fiber, name)) return true;
-  }
-  return false;
-}
-function isKnownListCell(fiber) {
-  const typeName = getTypeName(fiber.type) ?? getTypeName(fiber.elementType);
-  return !!typeName && LIST_CELL_NAMES.has(typeName);
-}
-function isModalFiber(fiber) {
-  return matchesName(fiber, "Modal");
-}
-function isVisibleModalFiber(fiber) {
-  return isModalFiber(fiber) && fiber?.memoizedProps?.visible !== false;
-}
-function collectVisibleModalFibers(container, excludeRoots = []) {
-  const excluded = /* @__PURE__ */ new WeakSet();
-  for (const rootFiber of excludeRoots) {
-    if (rootFiber) excluded.add(rootFiber);
-  }
-  const found = [];
-  const visited = /* @__PURE__ */ new WeakSet();
-  const stack = [];
-  if (container?.child) stack.push(container.child);
-  while (stack.length > 0) {
-    const node = stack.pop();
-    if (!node || visited.has(node)) continue;
-    visited.add(node);
-    if (node.sibling) stack.push(node.sibling);
-    if (excluded.has(node) || shouldSkipSubtree(node)) continue;
-    if (isVisibleModalFiber(node)) {
-      found.push(node);
-      continue;
-    }
-    if (node.child) stack.push(node.child);
-  }
-  return found;
-}
-function isMarkedListItem(fiber, listId) {
-  const props = fiber?.memoizedProps;
-  if (!props || props.__appilotsListItem !== true) return false;
-  if (!listId) return true;
-  return props.__appilotsListId === listId;
-}
-function listIdFromProps(props) {
-  return stringProp(props, "__appilotsListId") ?? stringProp(props, "appilotsListId");
-}
-function listMetadataFromProps(props) {
-  const id = listIdFromProps(props);
-  const itemCount = numberProp(props, "__appilotsItemCount");
-  const label = stringProp(props, "__appilotsListLabel") ?? stringProp(props, "accessibilityLabel") ?? stringProp(props, "testID");
-  const refreshing = props?.refreshing === true || props?.__appilotsRefreshing === true;
-  const empty = props?.__appilotsEmpty === true || typeof itemCount === "number" && itemCount === 0;
-  return {
-    id,
-    itemCount,
-    refreshing,
-    empty,
-    label,
-    source: id ? "auto-tracked" : void 0
-  };
-}
-function hasRenderableContent(fiber) {
-  const stack = [fiber];
-  const visited = /* @__PURE__ */ new WeakSet();
-  while (stack.length > 0) {
-    const node = stack.pop();
-    if (!node || visited.has(node)) continue;
-    visited.add(node);
-    if (shouldSkipSubtree(node) || isModalFiber(node)) continue;
-    const props = node.memoizedProps ?? {};
-    if (matchesName(node, "Text")) {
-      const text = extractTextFromChildren(props.children);
-      if (text && text.trim().length > 0) return true;
-    }
-    if (matchesName(node, "TextInput") || matchesName(node, "Switch")) {
-      return true;
-    }
-    if (TOUCHABLE_NAMES.has(getTypeName(node.type) ?? "") || TOUCHABLE_NAMES.has(getTypeName(node.elementType) ?? "")) {
-      return true;
-    }
-    if (node.sibling) stack.push(node.sibling);
-    if (node.child) stack.push(node.child);
-  }
-  return false;
-}
-function findListCellsByType(container, minItems) {
-  const cells = [];
-  const visited = /* @__PURE__ */ new WeakSet();
-  const stack = [];
-  if (container?.child) stack.push(container.child);
-  while (stack.length > 0) {
-    const node = stack.pop();
-    if (!node || visited.has(node)) continue;
-    visited.add(node);
-    if (node.sibling) stack.push(node.sibling);
-    if (shouldSkipSubtree(node) || isModalFiber(node)) continue;
-    if (isKnownListCell(node) && hasRenderableContent(node)) {
-      cells.push(node);
-      continue;
-    }
-    if (node.child) stack.push(node.child);
-  }
-  return cells.length >= minItems ? cells : null;
-}
-function findMarkedListItems(container, minItems, listId) {
-  const items = [];
-  const visited = /* @__PURE__ */ new WeakSet();
-  const stack = [];
-  if (container?.child) stack.push(container.child);
-  while (stack.length > 0) {
-    const node = stack.pop();
-    if (!node || visited.has(node)) continue;
-    visited.add(node);
-    if (node.sibling) stack.push(node.sibling);
-    if (shouldSkipSubtree(node) || isModalFiber(node)) continue;
-    if (isMarkedListItem(node, listId)) {
-      items.push(node);
-      continue;
-    }
-    if (node.child) stack.push(node.child);
-  }
-  if (items.length < minItems) return null;
-  items.sort((a, b) => {
-    const ai = numberProp(a.memoizedProps, "__appilotsItemIndex");
-    const bi = numberProp(b.memoizedProps, "__appilotsItemIndex");
-    if (ai === void 0 && bi === void 0) return 0;
-    if (ai === void 0) return 1;
-    if (bi === void 0) return -1;
-    return ai - bi;
-  });
-  return items;
-}
-function hasAuthoredReactKey(fiber) {
-  const key = fiber?.key;
-  if (key === null || key === void 0 || key === "") return false;
-  const s = String(key);
-  if (s.startsWith(".") && !s.startsWith(".$")) return false;
-  return true;
-}
-function findKeyedSiblingItems(container, minItems) {
-  if (!container) return null;
-  let current = container;
-  const visited = /* @__PURE__ */ new WeakSet();
-  while (current && !visited.has(current)) {
-    visited.add(current);
-    const siblings = [];
-    let cur = current.child;
-    while (cur) {
-      if (!isModalFiber(cur)) siblings.push(cur);
-      cur = cur.sibling;
-    }
-    if (siblings.length === 0) return null;
-    const keyed = siblings.filter(hasAuthoredReactKey);
-    if (keyed.length >= minItems) {
-      return keyed;
-    }
-    if (siblings.length > 1) {
-      return null;
-    }
-    current = siblings[0];
-  }
-  return null;
-}
-function findListItems(container, minItems = 2, preferCells = false) {
-  if (!container) return null;
-  const listId = listIdFromProps(container.memoizedProps);
-  const markedItems = findMarkedListItems(container, minItems, listId);
-  if (markedItems) return markedItems;
-  if (preferCells) {
-    const cells = findListCellsByType(container, minItems);
-    if (cells) return cells;
-  }
-  if (minItems <= 1) {
-    const multiItemLevel = findKeyedSiblingItems(container, 2);
-    if (multiItemLevel) return multiItemLevel;
-  }
-  return findKeyedSiblingItems(container, minItems) ?? findListCellsByType(container, minItems);
-}
-var TOUCHABLE_NAMES = /* @__PURE__ */ new Set([
-  "TouchableOpacity",
-  "TouchableHighlight",
-  "TouchableWithoutFeedback",
-  "TouchableNativeFeedback",
-  "Pressable"
-]);
-function hasPressHandler(fiber) {
-  const props = fiber?.memoizedProps ?? {};
-  return typeof props.onPress === "function" || typeof props.onPressIn === "function";
-}
-function isPressableTarget(fiber) {
-  return TOUCHABLE_NAMES.has(getTypeName(fiber.type) ?? "") || TOUCHABLE_NAMES.has(getTypeName(fiber.elementType) ?? "") || hasPressHandler(fiber);
-}
-function walkSubtree(root, detectLists, startInModal = false) {
-  const result = {
-    texts: [],
-    inputs: [],
-    buttons: [],
-    toggles: [],
-    sliders: [],
-    visitedFibers: 0,
-    skippedHidden: 0,
-    loading: false,
-    modalOpen: false,
-    lists: []
-  };
-  if (!root) return result;
-  const visited = /* @__PURE__ */ new WeakSet();
-  const stack = [];
-  if (root.child) stack.push({ fiber: root.child, inModal: startInModal });
-  while (stack.length > 0) {
-    const { fiber, inModal } = stack.pop();
-    if (!fiber || visited.has(fiber)) continue;
-    visited.add(fiber);
-    result.visitedFibers++;
-    if (fiber.sibling) stack.push({ fiber: fiber.sibling, inModal });
-    if (shouldSkipSubtree(fiber)) {
-      result.skippedHidden++;
-      continue;
-    }
-    if (detectLists) {
-      const isAlways = isAlwaysListContainer(fiber);
-      const isHeuristic = !isAlways && isHeuristicListContainer(fiber);
-      if (isAlways || isHeuristic) {
-        const minItems = isAlways ? 1 : 2;
-        const items = findListItems(fiber, minItems, isAlways);
-        if (items && items.length >= minItems) {
-          const containerType = getTypeName(fiber.type) ?? getTypeName(fiber.elementType) ?? "List";
-          const listIndex = result.lists.length;
-          const itemSnapshots = items.map((itemFiber, i) => {
-            const itemResult = walkSubtree(itemFiber, false, inModal);
-            result.visitedFibers += itemResult.visitedFibers;
-            result.skippedHidden += itemResult.skippedHidden;
-            if (itemResult.loading) result.loading = true;
-            if (itemResult.modalOpen) result.modalOpen = true;
-            const reactKey = typeof itemFiber.key === "string" || typeof itemFiber.key === "number" ? String(itemFiber.key) : typeof itemFiber.memoizedProps?.__appilotsItemKey === "string" || typeof itemFiber.memoizedProps?.__appilotsItemKey === "number" ? String(itemFiber.memoizedProps.__appilotsItemKey) : void 0;
-            const itemKey = typeof itemFiber.memoizedProps?.__appilotsItemKey === "string" || typeof itemFiber.memoizedProps?.__appilotsItemKey === "number" ? String(itemFiber.memoizedProps.__appilotsItemKey) : void 0;
-            const dataIndex = numberProp(itemFiber.memoizedProps, "__appilotsItemIndex");
-            return {
-              index: i + 1,
-              dataIndex,
-              reactKey,
-              itemKey,
-              syntheticId: `list-${listIndex}-item-${i + 1}`,
-              texts: dedupeStringsInternal(itemResult.texts),
-              buttons: dedupeButtonsInternal(itemResult.buttons),
-              inputs: dedupeInputsInternal(itemResult.inputs),
-              toggles: dedupeTogglesInternal(itemResult.toggles)
-            };
-          });
-          const meta2 = listMetadataFromProps(fiber.memoizedProps);
-          result.lists.push({
-            index: listIndex,
-            id: meta2.id,
-            containerType,
-            source: meta2.source ?? "fiber",
-            itemCount: meta2.itemCount,
-            visibleItemCount: itemSnapshots.length,
-            refreshing: meta2.refreshing,
-            empty: meta2.empty,
-            label: meta2.label,
-            items: itemSnapshots
-          });
-          for (const modalFiber of collectVisibleModalFibers(fiber, items)) {
-            result.modalOpen = true;
-            if (modalFiber.child) stack.push({ fiber: modalFiber.child, inModal: true });
-          }
-          continue;
-        }
-        const meta = listMetadataFromProps(fiber.memoizedProps);
-        if (meta.id || meta.itemCount !== void 0 || meta.refreshing || meta.empty) {
-          const containerType = getTypeName(fiber.type) ?? getTypeName(fiber.elementType) ?? "List";
-          result.lists.push({
-            index: result.lists.length,
-            id: meta.id,
-            containerType,
-            source: meta.source ?? "auto-tracked",
-            itemCount: meta.itemCount,
-            visibleItemCount: 0,
-            refreshing: meta.refreshing,
-            empty: meta.empty,
-            label: meta.label,
-            items: []
-          });
-          for (const modalFiber of collectVisibleModalFibers(fiber)) {
-            result.modalOpen = true;
-            if (modalFiber.child) stack.push({ fiber: modalFiber.child, inModal: true });
-          }
-          continue;
-        }
-      }
-    }
-    const props = fiber.memoizedProps ?? {};
-    if (matchesName(fiber, "Text")) {
-      const text = extractTextFromChildren(props.children);
-      if (text && text.trim().length > 0) {
-        result.texts.push(text.trim());
-      }
-    } else if (matchesName(fiber, "TextInput")) {
-      if (props.__appilotsInternal !== true) {
-        const isSecure = !!props.secureTextEntry || isAppilotsSensitiveMarked(props);
-        const rawValue = typeof props.value === "string" ? props.value : void 0;
-        const safeValue = isSecure ? rawValue && rawValue.length > 0 ? "<hidden>" : void 0 : rawValue;
-        result.inputs.push({
-          id: bestId(props),
-          label: inferLabel(props),
-          value: safeValue,
-          placeholder: props.placeholder,
-          editable: props.editable !== false,
-          secure: isSecure,
-          type: inferInputType(props),
-          ...inModal ? { inModal: true } : {}
-        });
-      }
-    } else if (props.accessibilityRole === "adjustable") {
-      if (props.__appilotsInternal !== true) {
-        const av = props.accessibilityValue ?? {};
-        result.sliders.push({
-          id: bestId(props),
-          label: props.accessibilityLabel ?? props.testID,
-          value: typeof av.now === "number" ? av.now : void 0,
-          min: typeof av.min === "number" ? av.min : void 0,
-          max: typeof av.max === "number" ? av.max : void 0,
-          ...inModal ? { inModal: true } : {}
-        });
-      }
-    } else if (isPressableTarget(fiber)) {
-      if (props.__appilotsInternal !== true) {
-        const label = findChildText(fiber);
-        const selected = props.accessibilityState?.selected === true;
-        result.buttons.push({
-          id: bestId(props) ?? (label ? normalizeLabel(label) : void 0),
-          label,
-          disabled: !!props.disabled,
-          ...selected ? { selected: true } : {},
-          ...inModal ? { inModal: true } : {}
-        });
-      }
-    } else if (matchesName(fiber, "Switch")) {
-      result.toggles.push({
-        id: bestId(props),
-        label: props.accessibilityLabel ?? props.testID,
-        value: !!props.value,
-        ...inModal ? { inModal: true } : {}
-      });
-    } else if (matchesName(fiber, "ActivityIndicator")) {
-      result.loading = true;
-    } else if (matchesName(fiber, "Modal")) {
-      result.modalOpen = true;
-      if (fiber.child) stack.push({ fiber: fiber.child, inModal: true });
-      continue;
-    }
-    if (fiber.child) stack.push({ fiber: fiber.child, inModal });
-  }
-  return result;
-}
-function walkFiber(root) {
-  const snapshot = {
-    route: getCurrentScreen(),
-    texts: [],
-    inputs: [],
-    buttons: [],
-    toggles: [],
-    // Sliders come from the ComponentRegistry (useAppilotsSlider) —
-    // captureSnapshot merges them so observation only ever advertises
-    // sliders the executor can actually set (min/max/step + setValue).
-    sliders: [],
-    loading: false,
-    modalOpen: false,
-    lists: [],
-    choiceGroups: [],
-    elements: [],
-    stats: { visitedFibers: 0, skippedHidden: 0 }
-  };
-  if (!root) return snapshot;
-  const sub = walkSubtree(root, true);
-  snapshot.texts = dedupeStringsInternal(sub.texts);
-  snapshot.inputs = dedupeInputsInternal(sub.inputs);
-  snapshot.buttons = dedupeButtonsInternal(sub.buttons);
-  snapshot.toggles = dedupeTogglesInternal(sub.toggles);
-  snapshot.sliders = dedupeSliders(sub.sliders);
-  snapshot.loading = sub.loading;
-  snapshot.modalOpen = sub.modalOpen;
-  snapshot.lists = sub.lists;
-  snapshot.choiceGroups = deriveChoiceGroups(snapshot);
-  snapshot.stats.visitedFibers = sub.visitedFibers;
-  snapshot.stats.skippedHidden = sub.skippedHidden;
-  return snapshot;
-}
-function dedupeButtonsInternal(buttons) {
-  return dedupeButtons(buttons);
-}
-function dedupeInputsInternal(inputs) {
-  return dedupeInputs(inputs);
-}
-function dedupeTogglesInternal(toggles) {
-  return dedupeToggles(toggles);
-}
-function dedupeStringsInternal(strings) {
-  return dedupeStrings(strings);
-}
-function isCommandLikeLabel(label) {
-  if (!label) return true;
-  const normalized = normalizeLabel(label);
-  if (!normalized) return true;
-  return /^(proximo|prox|next|continuar|continue|voltar|back|confirmar|confirm|cancelar|cancel|salvar|save|enviar|submit|ok|limpar|clear|fechar|close|adicionar|add|novo|nova|new)$/i.test(
-    normalized
-  );
-}
-function deriveChoiceGroups(snapshot) {
-  const groups = [];
-  for (const list of snapshot.lists) {
-    const options = list.items.filter((item) => item.texts.length > 0 || item.buttons.length > 0).map((item, i) => {
-      const texts = item.texts.length > 0 ? item.texts : item.buttons.map((b) => b.label ?? b.id ?? "").filter((text) => text.length > 0);
-      return {
-        index: i + 1,
-        syntheticId: `${list.id ?? `list-${list.index}`}-choice-${i + 1}`,
-        targetId: item.syntheticId,
-        label: texts.slice(0, 2).join(" \xB7 "),
-        texts,
-        disabled: false
-      };
-    });
-    if (options.length > 0) {
-      groups.push({
-        index: groups.length,
-        id: list.id,
-        label: list.label,
-        source: "list",
-        options
-      });
-    }
-  }
-  const buttonOptions = snapshot.buttons.filter((button) => !button.disabled).filter((button) => hasMeaningfulText(button.label ?? button.id)).filter((button) => !isCommandLikeLabel(button.label ?? button.id)).map((button, i) => {
-    const label = button.label ?? button.id ?? "";
-    return {
-      index: i + 1,
-      syntheticId: `choice-buttons-option-${i + 1}`,
-      targetId: button.id ?? button.label,
-      label,
-      texts: [label],
-      selected: !!button.selected,
-      disabled: !!button.disabled
-    };
-  });
-  if (buttonOptions.length >= 2) {
-    groups.push({
-      index: groups.length,
-      id: "visible-options",
-      label: "Visible options",
-      source: "buttons",
-      options: buttonOptions
-    });
-  }
-  return groups;
-}
-function dedupeButtons(buttons) {
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const b of buttons) {
-    const idTrim = b.id?.trim();
-    const labelTrim = b.label?.trim();
-    if (!idTrim && (!labelTrim || !/[a-z0-9]/i.test(labelTrim))) continue;
-    const key = `${idTrim ?? ""}|${labelTrim ?? ""}|${b.disabled ? 1 : 0}|${b.inModal ? 1 : 0}|${b.selected ? 1 : 0}`;
-    if (seen.has(key)) continue;
-    seen.add(key);
-    out.push(b);
-  }
-  return out;
-}
-function dedupeInputs(inputs) {
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const i of inputs) {
-    const key = `${i.id ?? ""}|${i.label ?? ""}|${i.placeholder ?? ""}|${i.inModal ? 1 : 0}`;
-    if (seen.has(key)) continue;
-    seen.add(key);
-    out.push(i);
-  }
-  return out;
-}
-function dedupeSliders(sliders) {
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const s of sliders) {
-    const key = `${s.id ?? ""}|${s.label ?? ""}|${s.inModal ? 1 : 0}`;
-    if (seen.has(key)) continue;
-    seen.add(key);
-    out.push(s);
-  }
-  return out;
-}
-function dedupeToggles(toggles) {
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const t of toggles) {
-    const key = `${t.id ?? ""}|${t.label ?? ""}|${t.inModal ? 1 : 0}`;
-    if (seen.has(key)) continue;
-    seen.add(key);
-    out.push(t);
-  }
-  return out;
-}
-function dedupeStrings(strings) {
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const s of strings) {
-    const trimmed = s.trim();
-    if (!trimmed) continue;
-    if (seen.has(trimmed)) continue;
-    seen.add(trimmed);
-    out.push(trimmed);
-  }
-  return out;
-}
-function normalizeLabel(label) {
-  return label.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9\s]/g, "").trim().replace(/\s+(.)/g, (_, c) => c.toUpperCase()).replace(/\s+/g, "");
-}
-
 // src/introspection/captureSnapshot.ts
 function normalizeSliderKey(value) {
   return (value ?? "").toLowerCase().replace(/^slider[-_]/, "");
@@ -694,6 +42,29 @@ function reconcileSliders(snapshot) {
   }
   snapshot.sliders = out;
 }
+function normalizeFieldKey(value) {
+  return (value ?? "").toLowerCase().replace(/^(input|field)[-_]/, "");
+}
+function canonicalizeRegisteredFields(snapshot) {
+  const claimed = /* @__PURE__ */ new Set();
+  for (const { id, kind, label } of componentRegistry.snapshot()) {
+    if (kind !== "field") continue;
+    if (snapshot.inputs.some((input) => input.id === id)) continue;
+    const registryLabel = (label ?? "").toLowerCase();
+    const registryKey = normalizeFieldKey(id);
+    const candidates = snapshot.inputs.filter((input) => {
+      if (claimed.has(input)) return false;
+      const inputLabel = (input.label ?? "").toLowerCase();
+      if (registryLabel && inputLabel && inputLabel === registryLabel) return true;
+      const inputKey = normalizeFieldKey(input.id);
+      return !!inputKey && !!registryKey && inputKey === registryKey;
+    });
+    if (candidates.length !== 1) continue;
+    const match = candidates[0];
+    claimed.add(match);
+    match.id = id;
+  }
+}
 function mergeRegisteredLists(snapshot) {
   const registered = listRegistry.snapshot();
   if (registered.length === 0) return;
@@ -702,6 +73,7 @@ function mergeRegisteredLists(snapshot) {
     if (list.id) byId.set(list.id, list);
   }
   for (const entry of registered) {
+    if (entry.kind === "scroll") continue;
     const metrics = entry.getScrollMetrics?.();
     const scrollFacts = metrics ? {
       scrollOffsetY: Math.max(0, Math.round(metrics.offset)),
@@ -742,11 +114,66 @@ function mergeRegisteredLists(snapshot) {
     });
   }
 }
+function mergeRegisteredScrollables(snapshot) {
+  const registered = listRegistry.snapshot().filter((e) => e.kind === "scroll");
+  if (registered.length === 0) return;
+  const listsById = /* @__PURE__ */ new Map();
+  for (const list of snapshot.lists) {
+    if (list.id) listsById.set(list.id, list);
+  }
+  const out = [];
+  for (const entry of registered) {
+    const metrics = entry.getScrollMetrics?.();
+    const facts = metrics ? {
+      scrollOffsetY: Math.max(0, Math.round(metrics.offset)),
+      canScrollUp: metrics.offset > 8,
+      canScrollDown: metrics.offset + metrics.visibleLength < metrics.contentLength - 8
+    } : void 0;
+    const asList = listsById.get(entry.id);
+    if (asList) {
+      if (facts) {
+        asList.scrollOffsetY = asList.scrollOffsetY ?? facts.scrollOffsetY;
+        asList.canScrollUp = asList.canScrollUp ?? facts.canScrollUp;
+        asList.canScrollDown = asList.canScrollDown ?? facts.canScrollDown;
+      }
+      continue;
+    }
+    out.push({
+      id: entry.id,
+      containerType: entry.component,
+      ...entry.label ? { label: entry.label } : {},
+      ...facts ?? {}
+    });
+  }
+  if (out.length > 0) snapshot.scrollables = out;
+}
+function mergeNativeDialog(snapshot) {
+  const dialog = getOpenNativeDialog();
+  if (!dialog) return;
+  snapshot.nativeDialog = {
+    id: dialog.id,
+    ...dialog.title ? { title: dialog.title } : {},
+    ...dialog.message ? { message: dialog.message } : {},
+    buttons: dialog.buttons.map((b) => ({
+      label: b.label,
+      ...b.style ? { style: b.style } : {}
+    }))
+  };
+  snapshot.modalOpen = true;
+}
+var MIN_FIBERS_FOR_BLINDNESS = 200;
+function recordBlindWalk() {
+  const walk = getLastWalkDiagnostics();
+  if (!walk) return;
+  if (walk.visitedFibers < MIN_FIBERS_FOR_BLINDNESS) return;
+  if (totalDetectorHits(walk.detectors) > 0) return;
+  recordIntrospectionFailure("walk-recognized-nothing", null);
+}
 function captureSnapshot() {
   const root = getFiberRoot();
   if (!root) {
-    console.warn(
-      "[Appilots] captureSnapshot: fiber root not captured yet. Ensure <AppilotsProvider> has rendered before calling this."
+    appilotsDebugWarn(
+      "captureSnapshot: fiber root not captured yet. Ensure <AppilotsProvider> has rendered before calling this."
     );
     recordIntrospectionFailure("never-mounted", null);
     return {
@@ -765,36 +192,83 @@ function captureSnapshot() {
   }
   const start = Date.now();
   const snapshot = walkFiber(root);
+  recordBlindWalk();
   const activePath = getActiveRouteNames();
   const deepestRoute = activePath[activePath.length - 1];
   if (deepestRoute) snapshot.route = deepestRoute;
   mergeRegisteredLists(snapshot);
+  mergeRegisteredScrollables(snapshot);
+  mergeNativeDialog(snapshot);
   reconcileSliders(snapshot);
+  canonicalizeRegisteredFields(snapshot);
   clampSnapshotToWireLimits(snapshot);
-  snapshot.elements = deriveInteractionElements(snapshot);
-  snapshot.choiceGroups = attachElementIdsToChoiceGroups(
-    snapshot.choiceGroups,
-    snapshot.elements
+  const entries = deriveInteractionElements(snapshot, { rectOf: rectForNode });
+  const rectById = new Map(
+    entries.flatMap((entry) => entry.rect ? [[entry.id, entry.rect]] : [])
   );
+  snapshot.elements = entries.map(toWireElement);
+  snapshot.choiceGroups = attachElementIdsToChoiceGroups(snapshot.choiceGroups, snapshot.elements);
   clampSnapshotToWireLimits(snapshot);
-  elementRegistry.replaceAll(snapshot.elements);
-  const elapsed = Date.now() - start;
-  const totalListItems = snapshot.lists.reduce(
-    (acc, l) => acc + l.items.length,
-    0
+  elementRegistry.replaceAll(
+    snapshot.elements.map((element) => {
+      const rect = rectById.get(element.id);
+      return rect ? { ...element, rect } : element;
+    })
   );
+  const elapsed = Date.now() - start;
+  const totalListItems = snapshot.lists.reduce((acc, l) => acc + l.items.length, 0);
   const totalListDataItems = snapshot.lists.reduce(
     (acc, l) => acc + (typeof l.itemCount === "number" ? l.itemCount : 0),
     0
   );
-  console.log(
-    `[Appilots] 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)`
+  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)`
   );
-  console.log(
-    `[Appilots] captureSnapshot detail: lists=[${snapshot.lists.map((l) => `${l.containerType}:${l.id ?? l.label ?? "?"}(${l.items.map((it) => it.texts[0] ?? it.buttons[0]?.id ?? "?").join("|")})`).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(", ")}]`
+  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;
 }
+function registryCounts() {
+  const counts = {
+    fields: 0,
+    toggles: 0,
+    sliders: 0,
+    targets: 0,
+    lists: listRegistry.snapshot().length,
+    elements: elementRegistry.size
+  };
+  for (const { kind } of componentRegistry.snapshot()) {
+    if (kind === "field") counts.fields++;
+    else if (kind === "toggle") counts.toggles++;
+    else if (kind === "slider") counts.sliders++;
+    else if (kind === "target") counts.targets++;
+  }
+  return counts;
+}
+function appilotsSelfCheck() {
+  const root = getFiberRoot();
+  const start = Date.now();
+  if (root) walkFiber(root);
+  const elapsedMs = Date.now() - start;
+  const walk = getLastWalkDiagnostics();
+  return {
+    sdkVersion: SDK_VERSION,
+    reactVersion: React.version ?? null,
+    route: getCurrentScreen() || null,
+    introspection: getIntrospectionDiagnostics(),
+    autoTracking: getAutoTrackingState(),
+    walk: {
+      visitedFibers: root ? walk?.visitedFibers ?? 0 : 0,
+      skippedHidden: root ? walk?.skippedHidden ?? 0 : 0,
+      elapsedMs
+    },
+    detectors: root ? walk?.detectors ?? emptyDetectorCounts() : emptyDetectorCounts(),
+    registry: registryCounts(),
+    nameMangling: getNameManglingProbe(),
+    geometry: { availability: geometryAvailability(), ...geometryStats() }
+  };
+}
 
 // src/introspection/findInteractive.ts
 function getTypeName2(type) {
@@ -808,7 +282,7 @@ function getTypeName2(type) {
   }
   return null;
 }
-function matchesName2(fiber, name) {
+function matchesName(fiber, name) {
   return getTypeName2(fiber.type) === name || getTypeName2(fiber.elementType) === name;
 }
 var TOUCHABLE_NAMES2 = /* @__PURE__ */ new Set([
@@ -821,33 +295,33 @@ var TOUCHABLE_NAMES2 = /* @__PURE__ */ new Set([
 function isTouchable(fiber) {
   return TOUCHABLE_NAMES2.has(getTypeName2(fiber.type) ?? "") || TOUCHABLE_NAMES2.has(getTypeName2(fiber.elementType) ?? "");
 }
-function hasPressHandler2(fiber) {
+function hasPressHandler(fiber) {
   const props = fiber?.memoizedProps ?? {};
   return typeof props.onPress === "function" || typeof props.onPressIn === "function";
 }
-function isPressableTarget2(fiber) {
-  return isTouchable(fiber) || hasPressHandler2(fiber);
+function isPressableTarget(fiber) {
+  return isTouchable(fiber) || hasPressHandler(fiber);
 }
-var SELF_REFERENTIAL_COMPONENTS2 = /* @__PURE__ */ new Set([
+var SELF_REFERENTIAL_COMPONENTS = /* @__PURE__ */ new Set([
   "AppilotsChat",
   "AppilotsChatInner",
   "ActionBreadcrumb",
   "ConfirmDialog"
 ]);
-function isAppilotsSkipMarked2(props) {
+function isAppilotsSkipMarked(props) {
   if (!props) return false;
   return props.__appilotsSkip === true || props["data-appilots-skip"] === true || props.appilotsSkip === true;
 }
-function extractTextFromChildren2(children) {
+function extractTextFromChildren(children) {
   if (children == null) return "";
   if (typeof children === "string") return children;
   if (typeof children === "number") return String(children);
   if (Array.isArray(children)) {
-    return children.map(extractTextFromChildren2).filter(Boolean).join("");
+    return children.map(extractTextFromChildren).filter(Boolean).join("");
   }
   return "";
 }
-function findChildText2(fiber) {
+function findChildText(fiber) {
   const stack = [];
   if (fiber.child) stack.push(fiber.child);
   const visited = /* @__PURE__ */ new WeakSet();
@@ -855,8 +329,8 @@ function findChildText2(fiber) {
     const node = stack.pop();
     if (!node || visited.has(node)) continue;
     visited.add(node);
-    if (matchesName2(node, "Text")) {
-      const text = extractTextFromChildren2(node.memoizedProps?.children);
+    if (matchesName(node, "Text")) {
+      const text = extractTextFromChildren(node.memoizedProps?.children);
       if (text && text.trim().length > 0) return text.trim();
     }
     if (node.sibling) stack.push(node.sibling);
@@ -868,10 +342,10 @@ function shouldSkipSubtree2(fiber) {
   const props = fiber.memoizedProps;
   if (!props) return false;
   const typeName = getTypeName2(fiber.type) ?? getTypeName2(fiber.elementType);
-  if (typeName && SELF_REFERENTIAL_COMPONENTS2.has(typeName)) return true;
-  if (isAppilotsSkipMarked2(props)) return true;
-  if (matchesName2(fiber, "Modal") && props.visible === false) return true;
-  if (matchesName2(fiber, "Screen") && props.activityState === 0) return true;
+  if (typeName && SELF_REFERENTIAL_COMPONENTS.has(typeName)) return true;
+  if (isAppilotsSkipMarked(props)) return true;
+  if (isModalFiber(fiber) && props.visible === false) return true;
+  if (matchesName(fiber, "Screen") && props.activityState === 0) return true;
   const style = props.style;
   if (style) {
     const flat = Array.isArray(style) ? Object.assign({}, ...style.filter(Boolean)) : style;
@@ -880,20 +354,19 @@ function shouldSkipSubtree2(fiber) {
   }
   return false;
 }
-function normalize(s) {
-  if (!s) return "";
-  return s.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]/g, "");
-}
+var normalize = foldForCompare;
 function scoreMatch(fiber, queryNorm, queryRaw) {
   const props = fiber.memoizedProps ?? {};
   const candidates = [];
   if (typeof props.testID === "string") candidates.push({ val: props.testID, weight: 100 });
-  if (typeof props.accessibilityLabel === "string") candidates.push({ val: props.accessibilityLabel, weight: 95 });
+  if (typeof props.accessibilityLabel === "string")
+    candidates.push({ val: props.accessibilityLabel, weight: 95 });
   if (typeof props.label === "string") candidates.push({ val: props.label, weight: 90 });
-  if (typeof props.placeholder === "string") candidates.push({ val: props.placeholder, weight: 70 });
+  if (typeof props.placeholder === "string")
+    candidates.push({ val: props.placeholder, weight: 70 });
   if (typeof props.title === "string") candidates.push({ val: props.title, weight: 85 });
-  if (isPressableTarget2(fiber)) {
-    const childText = findChildText2(fiber);
+  if (isPressableTarget(fiber)) {
+    const childText = findChildText(fiber);
     if (childText) candidates.push({ val: childText, weight: 80 });
   }
   let best = 0;
@@ -902,7 +375,8 @@ function scoreMatch(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 (vNorm.includes(queryNorm) || queryNorm.includes(vNorm)) best = Math.max(best, weight - 20);
+    else if (queryNorm && (vNorm.includes(queryNorm) || queryNorm.includes(vNorm)))
+      best = Math.max(best, weight - 20);
   }
   if (best > 0 && props.disabled === true) {
     best = Math.max(1, best - 60);
@@ -933,6 +407,12 @@ function wrapTextInput(fiber) {
       if (node && typeof node.focus === "function") {
         node.focus();
       }
+    },
+    submitFromKeyboard: () => {
+      const { onSubmitEditing, value } = getProps();
+      if (typeof onSubmitEditing !== "function") return false;
+      onSubmitEditing({ nativeEvent: { text: value ?? "" } });
+      return true;
     }
   };
 }
@@ -972,14 +452,14 @@ function wrapTouchable(fiber, label) {
 function findInteractiveByIdentifier(query, options = {}) {
   const root = getFiberRoot();
   if (!root) {
-    console.warn("[Appilots] findInteractiveByIdentifier: fiber root not captured yet");
+    appilotsDebugWarn("findInteractiveByIdentifier: fiber root not captured yet");
     return null;
   }
   const queryNorm = normalize(query);
   const queryRaw = query;
   let bestScore = 0;
   let bestHandle = null;
-  let bestId2;
+  let bestId;
   const visited = /* @__PURE__ */ new WeakSet();
   const stack = [];
   if (root.child) stack.push(root.child);
@@ -990,40 +470,50 @@ function findInteractiveByIdentifier(query, options = {}) {
     if (fiber.sibling) stack.push(fiber.sibling);
     if (shouldSkipSubtree2(fiber)) continue;
     let kind = null;
-    if (matchesName2(fiber, "TextInput")) kind = "field";
-    else if (matchesName2(fiber, "Switch")) kind = "toggle";
-    else if (isPressableTarget2(fiber)) kind = "target";
+    if (matchesName(fiber, "TextInput")) kind = "field";
+    else if (matchesName(fiber, "Switch")) kind = "toggle";
+    else if (isPressableTarget(fiber)) kind = "target";
     if (kind && (!options.kind || options.kind === kind)) {
       const score = scoreMatch(fiber, queryNorm, queryRaw);
       if (score > bestScore) {
         bestScore = score;
         const props = fiber.memoizedProps ?? {};
-        bestId2 = props.testID ?? props.accessibilityLabel ?? props.placeholder ?? (kind === "target" ? findChildText2(fiber) : void 0);
+        bestId = props.testID ?? props.accessibilityLabel ?? props.placeholder ?? (kind === "target" ? findChildText(fiber) : void 0);
         if (kind === "field") bestHandle = wrapTextInput(fiber);
         else if (kind === "toggle") bestHandle = wrapSwitch(fiber);
-        else bestHandle = wrapTouchable(fiber, findChildText2(fiber));
+        else bestHandle = wrapTouchable(fiber, findChildText(fiber));
       }
     }
     if (fiber.child) stack.push(fiber.child);
   }
   if (bestHandle) {
-    console.log(
-      `[Appilots] findInteractiveByIdentifier: query="${query}" \u2192 kind=${bestHandle.kind} label="${bestHandle.label ?? bestId2}" score=${bestScore}`
+    appilotsDebugLog(
+      `findInteractiveByIdentifier: query="${query}" \u2192 kind=${bestHandle.kind} label="${bestHandle.label ?? bestId}" score=${bestScore}`
     );
   } else {
-    console.log(`[Appilots] findInteractiveByIdentifier: query="${query}" \u2192 no match`);
+    appilotsDebugLog(`findInteractiveByIdentifier: query="${query}" \u2192 no match`);
   }
   return bestHandle;
 }
 
 // src/executor/handlers/navigateHandler.ts
+var _reportedMissingNavRef = false;
+function reportMissingNavigationRef() {
+  if (_reportedMissingNavRef) return;
+  _reportedMissingNavRef = true;
+  console.error(
+    "[Appilots] Navigation is not wired. The SDK never received a navigation ref, so every navigate the agent attempts will fail.\n  Fix: wrap your NavigationContainer with <AppilotsNavigationContainer>:\n    <AppilotsProvider config={...}>\n      <AppilotsNavigationContainer>\n        <NavigationContainer>{/* your navigators */}</NavigationContainer>\n      </AppilotsNavigationContainer>\n      <AppilotsChat />\n    </AppilotsProvider>\n  Docs: https://docs.appilots.com/getting-started/quick-start"
+  );
+}
 function categorizeNavigationError(message) {
   if (/screen named|was not handled by any navigator|no route|not found|not registered in any navigator|couldn'?t find a route|route .* (?:doesn'?t|does not) exist/i.test(
     message
   )) {
     return "component-not-found";
   }
-  if (/couldn'?t find a navigation object|navigator (?:is )?not (?:rendered|ready)|not been (?:mounted|rendered)/i.test(message)) {
+  if (/couldn'?t find a navigation object|navigator (?:is )?not (?:rendered|ready)|not been (?:mounted|rendered)/i.test(
+    message
+  )) {
     return "screen-timeout";
   }
   return "unknown";
@@ -1050,7 +540,9 @@ function screenExistsAnywhere(state, screenName) {
 function safeNavigate(nav, screenName, params, path) {
   if (path && path.length > 0) {
     const { root, nestedParams } = buildNestedParams(path, screenName, params);
-    console.log(`[Appilots] safeNavigate: using path-based navigation \u2014 root="${root}", nested=${JSON.stringify(nestedParams)}`);
+    appilotsDebugLog(
+      `safeNavigate: using path-based navigation \u2014 root="${root}", nested=${JSON.stringify(nestedParams)}`
+    );
     nav.navigate(root, nestedParams);
     return;
   }
@@ -1065,11 +557,17 @@ function safeNavigate(nav, screenName, params, path) {
       `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.`
     );
   }
-  console.log(`[Appilots] safeNavigate: screen exists in nested navigator, attempting direct navigation to "${screenName}"`);
+  appilotsDebugLog(
+    `safeNavigate: screen exists in nested navigator, attempting direct navigation to "${screenName}"`
+  );
   nav.navigate(screenName, params);
 }
 function navigateHandler(payload, context) {
-  console.log(`[Appilots] navigateHandler called: screenName="${payload.screenName}", action="${payload.navigationAction}", params=${JSON.stringify(payload.params ?? {})}`);
+  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=${describeValue(payload.params)}`
+  );
   const { navigationRef, permissions } = context;
   const nav = navigationRef.current;
   if (!permissions.canNavigate) {
@@ -1079,14 +577,15 @@ function navigateHandler(payload, context) {
       diagnose: { category: "unknown", screen: payload.screenName }
     };
   }
-  if (permissions.blockedScreens?.includes(payload.screenName)) {
+  const isGoBack = payload.navigationAction === "goBack";
+  if (!isGoBack && permissions.blockedScreens?.includes(payload.screenName)) {
     return {
       success: false,
       error: `Navigation to "${payload.screenName}" is blocked`,
       diagnose: { category: "unknown", screen: payload.screenName }
     };
   }
-  if (permissions.allowedScreens && permissions.allowedScreens.length > 0 && !permissions.allowedScreens.includes(payload.screenName)) {
+  if (!isGoBack && permissions.allowedScreens && permissions.allowedScreens.length > 0 && !permissions.allowedScreens.includes(payload.screenName)) {
     return {
       success: false,
       error: `Navigation to "${payload.screenName}" is not in allowed screens`,
@@ -1094,10 +593,11 @@ function navigateHandler(payload, context) {
     };
   }
   if (!nav) {
+    reportMissingNavigationRef();
     return {
       success: false,
-      error: "Navigation ref is not available",
-      diagnose: { category: "screen-timeout", screen: payload.screenName }
+      error: "Navigation is not wired: <AppilotsNavigationContainer> is missing, so the SDK never received the navigation ref. Wrap your <NavigationContainer> with it. This cannot be retried \u2014 it needs a change in the host app.",
+      diagnose: { category: "unknown", screen: payload.screenName }
     };
   }
   if (!nav.isReady || typeof nav.isReady === "function" && !nav.isReady()) {
@@ -1108,7 +608,15 @@ function navigateHandler(payload, context) {
     };
   }
   try {
-    const { screenName, params, navigationAction, path } = payload;
+    const { params, navigationAction, path } = payload;
+    if (!isGoBack && !payload.screenName) {
+      return {
+        success: false,
+        error: `Navigation action "${navigationAction ?? "navigate"}" requires a screenName.`,
+        diagnose: { category: "unknown" }
+      };
+    }
+    const screenName = payload.screenName;
     switch (navigationAction) {
       case "navigate":
         safeNavigate(nav, screenName, params ?? {}, path);
@@ -1151,10 +659,14 @@ function navigateHandler(payload, context) {
           diagnose: { category: "unknown", screen: payload.screenName }
         };
     }
-    console.log(`[Appilots] navigateHandler: navigation succeeded for "${payload.screenName}" (action="${payload.navigationAction}")`);
+    appilotsDebugLog(
+      `navigateHandler: navigation succeeded for "${payload.screenName}" (action="${payload.navigationAction}")`
+    );
     return { success: true };
   } catch (err) {
-    console.warn(`[Appilots] navigateHandler: navigation failed for "${payload.screenName}": ${err?.message}`);
+    appilotsDebugWarn(
+      `navigateHandler: navigation failed for "${payload.screenName}": ${err?.message}`
+    );
     const msg = String(err?.message ?? "Navigation failed");
     const category = categorizeNavigationError(msg);
     return {
@@ -1177,7 +689,7 @@ function parseSyntheticListItemId(id) {
   if (listIndex < 0 || itemIndex < 1) return null;
   return { listIndex, itemIndex };
 }
-function stringProp2(props, key) {
+function stringProp(props, key) {
   const value = props?.[key];
   if (typeof value === "string" && value.trim()) return value.trim();
   if (typeof value === "number") return String(value);
@@ -1185,30 +697,30 @@ function stringProp2(props, key) {
 }
 function listIdFromContainer(container) {
   const props = container?.memoizedProps ?? {};
-  return stringProp2(props, "__appilotsListId") ?? stringProp2(props, "appilotsListId") ?? stringProp2(props, "testID") ?? stringProp2(props, "accessibilityLabel");
+  return stringProp(props, "__appilotsListId") ?? stringProp(props, "appilotsListId") ?? stringProp(props, "testID") ?? stringProp(props, "accessibilityLabel");
 }
 function listLabelFromContainer(container) {
   const props = container?.memoizedProps ?? {};
-  return stringProp2(props, "__appilotsListLabel") ?? stringProp2(props, "accessibilityLabel") ?? stringProp2(props, "aria-label") ?? stringProp2(props, "label");
+  return stringProp(props, "__appilotsListLabel") ?? stringProp(props, "accessibilityLabel") ?? stringProp(props, "aria-label") ?? stringProp(props, "label");
 }
 function itemKeyFromFiber(fiber) {
   const props = fiber?.memoizedProps ?? {};
-  return stringProp2(props, "__appilotsItemKey") ?? (fiber?.key !== void 0 && fiber?.key !== null ? String(fiber.key) : void 0);
+  return stringProp(props, "__appilotsItemKey") ?? (fiber?.key !== void 0 && fiber?.key !== null ? String(fiber.key) : void 0);
 }
 function markedItemIndexFromFiber(fiber) {
   const value = fiber?.memoizedProps?.__appilotsItemIndex;
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
 function normalize2(value) {
-  return String(value ?? "").toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "");
+  return foldForCompare(String(value ?? ""));
 }
-function hasPressHandler3(fiber) {
+function hasPressHandler2(fiber) {
   const props = fiber?.memoizedProps ?? {};
   return typeof props.onPress === "function" || typeof props.onPressIn === "function";
 }
 function isPressableFiber(fiber) {
   const typeName = getTypeName(fiber.type) ?? getTypeName(fiber.elementType) ?? "";
-  return TOUCHABLE_NAMES.has(typeName) || hasPressHandler3(fiber);
+  return TOUCHABLE_NAMES.has(typeName) || hasPressHandler2(fiber);
 }
 function findListContainers(options = {}) {
   const root = getFiberRoot();
@@ -1353,13 +865,10 @@ function collectTexts(fiber) {
 }
 function hasUsefulTouchableIdentity(fiber) {
   const props = fiber?.memoizedProps ?? {};
-  if (typeof props.testID === "string" && /[a-z0-9]/i.test(props.testID)) return true;
-  if (typeof props.accessibilityLabel === "string" && /[a-z0-9]/i.test(props.accessibilityLabel)) {
-    return true;
-  }
-  if (typeof props.label === "string" && /[a-z0-9]/i.test(props.label)) return true;
-  const label = findFirstText(fiber);
-  return !!label && /[a-z0-9]/i.test(label);
+  if (isReferenceable(props.testID)) return true;
+  if (isReferenceable(props.accessibilityLabel)) return true;
+  if (isReferenceable(props.label)) return true;
+  return isReferenceable(findFirstText(fiber));
 }
 function describeTouchable(fiber) {
   const props = fiber?.memoizedProps ?? {};
@@ -1372,12 +881,7 @@ function touchableLooksDestructive(fiber) {
   const descriptor = describeTouchable(fiber);
   if (descriptor && looksDestructiveActionLabel(descriptor)) return true;
   const props = fiber?.memoizedProps ?? {};
-  const haystack = [
-    props.testID,
-    props.accessibilityLabel,
-    props.accessibilityHint,
-    props.label
-  ].filter((value) => typeof value === "string").join(" ");
+  const haystack = [props.testID, props.accessibilityLabel, props.accessibilityHint, props.label].filter((value) => typeof value === "string").join(" ");
   return looksDestructiveActionLabel(haystack);
 }
 function describeItemCandidate(listIndex, zeroBasedIndex, item) {
@@ -1411,8 +915,8 @@ function pressResolvedListItem(list, itemFiber, listIndex, itemIndex) {
       (candidate) => candidate !== touchable && containsFiber(touchable, candidate)
     );
     if (primaryWrapsNestedTargets) {
-      console.log(
-        `[Appilots] listItemDispatch: item "list-${listIndex}-item-${itemIndex}" has nested pressables; pressing outer row target`
+      appilotsDebugLog(
+        `listItemDispatch: item "list-${listIndex}-item-${itemIndex}" has nested pressables; pressing outer row target`
       );
     } else {
       const candidates = safeIdentifiableTouchables.map(describeTouchable).filter((d) => !!d).slice(0, 8);
@@ -1522,14 +1026,14 @@ function pressListItemAtOrdinal(listIndex, itemIndex) {
   }
   return pressResolvedListItem(list, items[zeroBased], listIndex, itemIndex);
 }
-function pressListItemByIdentity(locator) {
-  if (!getFiberRoot()) return { ok: false, reason: "no-fiber-root" };
+function resolveListItemByIdentity(locator) {
+  if (!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 });
   const lists = candidateLists(containers, effective);
   if (lists.length === 0) {
-    return { ok: false, reason: "list-not-found" };
+    return { ok: false, result: { ok: false, reason: "list-not-found" } };
   }
   const scoredCandidates = [];
   for (const { list, listIndex } of lists) {
@@ -1540,7 +1044,14 @@ function pressListItemByIdentity(locator) {
     }
   }
   if (scoredCandidates.length === 0) {
-    return { ok: false, reason: "item-not-found", containerType: lists[0]?.list.containerType };
+    return {
+      ok: false,
+      result: {
+        ok: false,
+        reason: "item-not-found",
+        containerType: lists[0]?.list.containerType
+      }
+    };
   }
   scoredCandidates.sort((a, b) => b.score - a.score);
   const best = scoredCandidates[0];
@@ -1549,13 +1060,104 @@ function pressListItemByIdentity(locator) {
     const candidates = tiedCandidates.map((c) => describeItemCandidate(c.listIndex, c.itemIndex - 1, c.item)).slice(0, 8);
     return {
       ok: false,
-      reason: "ambiguous-items",
-      error: "Multiple visible list items matched the requested target with equal confidence." + (candidates.length > 0 ? ` Candidates: ${candidates.join(", ")}.` : ""),
-      containerType: best.list.containerType,
+      result: {
+        ok: false,
+        reason: "ambiguous-items",
+        error: "Multiple visible list items matched the requested target with equal confidence." + (candidates.length > 0 ? ` Candidates: ${candidates.join(", ")}.` : ""),
+        containerType: best.list.containerType,
+        candidates
+      }
+    };
+  }
+  return {
+    ok: true,
+    list: best.list,
+    item: best.item,
+    listIndex: best.listIndex,
+    itemIndex: best.itemIndex
+  };
+}
+function findSwitchFibers(item) {
+  if (!item) return [];
+  const found = [];
+  const visited = /* @__PURE__ */ new WeakSet();
+  const stack = [
+    { fiber: item, includeSibling: false }
+  ];
+  while (stack.length > 0) {
+    const { fiber, includeSibling } = stack.pop();
+    if (!fiber || visited.has(fiber)) continue;
+    visited.add(fiber);
+    if (shouldSkipSubtree(fiber)) continue;
+    const props = fiber.memoizedProps ?? {};
+    if (isSwitchLike(fiber, props)) {
+      if (props.__appilotsInternal !== true) found.push(fiber);
+      if (includeSibling && fiber.sibling) {
+        stack.push({ fiber: fiber.sibling, includeSibling: true });
+      }
+      continue;
+    }
+    if (includeSibling && fiber.sibling) {
+      stack.push({ fiber: fiber.sibling, includeSibling: true });
+    }
+    if (fiber.child) stack.push({ fiber: fiber.child, includeSibling: true });
+  }
+  return found;
+}
+function toggleListItemByIdentity(locator, options) {
+  const resolved = resolveListItemByIdentity(locator);
+  if (!resolved.ok) return resolved.result;
+  const { list, item } = resolved;
+  const switches = findSwitchFibers(item);
+  if (switches.length === 0) {
+    return { ok: false, reason: "no-touchable", containerType: list.containerType };
+  }
+  if (switches.length > 1) {
+    const candidates = switches.map((fiber, index) => describeTouchable(fiber) ?? `switch-${index + 1}`).slice(0, 8);
+    return {
+      ok: false,
+      reason: "ambiguous-touchables",
+      error: 'This row exposes more than one switch, so flipping "the" switch would be a guess.' + (candidates.length > 0 ? ` Candidates: ${candidates.join(", ")}.` : ""),
+      containerType: list.containerType,
       candidates
     };
   }
-  return pressResolvedListItem(best.list, best.item, best.listIndex, best.itemIndex);
+  const target = switches[0];
+  const props = target?.memoizedProps ?? {};
+  const current = switchValue(props);
+  if (options?.expected !== void 0 && current === options.expected) {
+    return { ok: true, containerType: list.containerType, value: current };
+  }
+  const onValueChange = props.onValueChange ?? props.onChange;
+  if (typeof onValueChange !== "function") {
+    return {
+      ok: false,
+      reason: "no-touchable",
+      error: "The row has a switch but it exposes no onValueChange handler.",
+      containerType: list.containerType
+    };
+  }
+  try {
+    onValueChange(!current);
+  } catch (err) {
+    return {
+      ok: false,
+      reason: "press-threw",
+      error: err?.message ?? "switch handler threw",
+      containerType: list.containerType
+    };
+  }
+  return { ok: true, containerType: list.containerType, value: !current };
+}
+function pressListItemByIdentity(locator) {
+  const resolved = resolveListItemByIdentity(locator);
+  if (!resolved.ok) return resolved.result;
+  return pressResolvedListItem(
+    resolved.list,
+    resolved.item,
+    resolved.listIndex,
+    resolved.itemIndex
+  );
 }
 
 // src/executor/handlers/elementDispatch.ts
@@ -1784,6 +1386,46 @@ function dispatchElement(element, registry, action) {
     };
   }
   if (element.role === "toggle" && (action === "toggle" || isPressLike(action))) {
+    if (element.listContext) {
+      const toggled = toggleListItemByIdentity(
+        {
+          listIndex: element.listContext.listIndex,
+          listId: element.listContext.listId,
+          listLabel: element.listContext.listLabel,
+          itemIndex: element.listContext.itemIndex,
+          itemKey: element.listContext.itemKey,
+          reactKey: element.listContext.reactKey,
+          syntheticId: element.listContext.syntheticId,
+          label: element.label,
+          texts: element.texts
+        },
+        // The observation's `selected` is the state BEFORE this action.
+        // Passing the desired end state makes the flip idempotent: a
+        // retry or a recovery hop must not undo the work and call it
+        // success. A toggle only knows how to invert, so without this the
+        // second attempt silently returns the row to where it started.
+        typeof element.selected === "boolean" ? { expected: !element.selected } : void 0
+      );
+      if (toggled.ok) {
+        return {
+          success: true,
+          // Grounded: read back off the fiber after the handler ran, not
+          // inferred from "the call did not throw".
+          effect: "changed"
+        };
+      }
+      return {
+        success: false,
+        error: toggled.error ?? `Could not flip the switch in row "${element.label ?? element.id}" (${toggled.reason})`,
+        diagnose: {
+          ...screenDiagnose(
+            element.id,
+            toggled.reason === "ambiguous-touchables" || toggled.reason === "ambiguous-items" ? "ambiguous-target" : "component-not-found"
+          ),
+          ...toggled.candidates && toggled.candidates.length > 0 ? { candidates: toggled.candidates } : {}
+        }
+      };
+    }
     const targetId = element.targetId ?? element.label ?? element.id;
     return dispatchLegacyTarget(targetId, registry, "toggle");
   }
@@ -1813,8 +1455,8 @@ function dispatchStructuredElementId(identifier, action) {
     texts: parsed.itemKey ? [parsed.itemKey] : void 0
   });
   if (pressed.ok) {
-    console.log(
-      `[Appilots] elementDispatch: resolved stale el id "${identifier}" via structural identity (listId="${parsed.listId}", itemKey="${parsed.itemKey}")`
+    appilotsDebugLog(
+      `elementDispatch: resolved stale el id "${identifier}" via structural identity (listId="${parsed.listId}", itemKey="${parsed.itemKey}")`
     );
     return { success: true };
   }
@@ -1838,7 +1480,6 @@ function pressElementOrTarget(identifier, registry) {
 
 // src/executor/formFieldRewrite.ts
 var LIST_ORDINAL_RE = /^list-\d+-item-\d+$/i;
-var PLATE_RE = /^[A-Z]{3}-?\d[A-Z0-9]\d{2}$/i;
 function normalize4(value) {
   return value.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]/g, "");
 }
@@ -1878,9 +1519,6 @@ function collectKnownFormFields(registry) {
   }
   return registryFields;
 }
-function fieldHaystack(field) {
-  return normalize4(`${field.id} ${field.label ?? ""}`);
-}
 function isMisplacedFieldId(fieldId, knownIds) {
   const trimmed = fieldId.trim();
   if (!trimmed) return true;
@@ -1904,50 +1542,68 @@ function valueMatchesOption(field, rawValue) {
     return label === value || optionValue === value || value.includes(label) || value.includes(optionValue);
   });
 }
+var NUMERIC_FIELD_TYPES = /* @__PURE__ */ new Set([
+  "number",
+  "numeric",
+  "integer",
+  "int",
+  "decimal",
+  "float",
+  "range",
+  "slider",
+  "tel",
+  "phone"
+]);
+var DATE_FIELD_TYPES = /* @__PURE__ */ new Set(["date", "datetime", "datetimelocal", "time", "month"]);
+var EMAIL_FIELD_TYPES = /* @__PURE__ */ new Set(["email"]);
+var CHOICE_FIELD_TYPES = /* @__PURE__ */ new Set([
+  "select",
+  "picker",
+  "dropdown",
+  "combobox",
+  "radio",
+  "checkbox",
+  "switch",
+  "toggle",
+  "segmented",
+  "boolean"
+]);
+function readValueShape(rawValue) {
+  const value = String(rawValue ?? "").trim();
+  if (!value) return "text";
+  if (/^-?\d+(?:[.,]\d+)?$/.test(value)) return "number";
+  if (/^\S+@\S+\.\S+$/.test(value)) return "email";
+  if (/^\d{4}-\d{2}-\d{2}(?:[T\s]\d{2}:\d{2}(?::\d{2})?)?$/.test(value)) return "date";
+  if (/^\d{1,2}[/-]\d{1,2}[/-]\d{2,4}$/.test(value)) return "date";
+  return "text";
+}
+function fieldTypeMatchesShape(field, shape) {
+  const type = normalize4(field.type ?? "text");
+  if (CHOICE_FIELD_TYPES.has(type)) return false;
+  if (shape === "number") return NUMERIC_FIELD_TYPES.has(type);
+  if (shape === "date") return DATE_FIELD_TYPES.has(type);
+  if (shape === "email") return EMAIL_FIELD_TYPES.has(type);
+  return false;
+}
+function fieldAcceptsFreeText(field, shape) {
+  const type = normalize4(field.type ?? "text");
+  if (CHOICE_FIELD_TYPES.has(type)) return false;
+  if (NUMERIC_FIELD_TYPES.has(type)) return shape === "number";
+  if (DATE_FIELD_TYPES.has(type)) return shape === "date";
+  if (EMAIL_FIELD_TYPES.has(type)) return shape === "email";
+  return true;
+}
 function inferFieldIdForValue(rawValue, fields, used) {
   const value = String(rawValue ?? "").trim();
   if (!value) return void 0;
-  const normalizedValue = normalize4(value);
-  for (const field of fields) {
-    if (used.has(field.id)) continue;
+  const available = fields.filter((field) => field.id && !used.has(field.id));
+  for (const field of available) {
     if (valueMatchesOption(field, value)) return field.id;
   }
-  if (PLATE_RE.test(value)) {
-    const field = fields.find((f) => /placa|plate/.test(fieldHaystack(f)) && !used.has(f.id));
-    if (field) return field.id;
-  }
-  if (/^(19|20)\d{2}$/.test(value)) {
-    const field = fields.find((f) => /ano|year/.test(fieldHaystack(f)) && !used.has(f.id));
-    if (field) return field.id;
-  }
-  if (/^\d+$/.test(value)) {
-    const mileage = fields.find((f) => /quilometragem|mileage|km/.test(fieldHaystack(f)) && !used.has(f.id));
-    if (mileage) return mileage.id;
-    const year = fields.find((f) => /ano|year/.test(fieldHaystack(f)) && !used.has(f.id));
-    if (year) return year.id;
-  }
-  if (/preto|branco|azul|vermelho|prata|black|white|red|blue|silver|gray|grey/.test(normalizedValue)) {
-    const cor = fields.find((f) => /cor|color/.test(fieldHaystack(f)) && !used.has(f.id));
-    if (cor) return cor.id;
-  }
-  const marca = fields.find((f) => /marca|brand|make/.test(fieldHaystack(f)) && !used.has(f.id));
-  if (marca && !/model/i.test(normalizedValue)) return marca.id;
-  const modelo = fields.find((f) => /modelo|model/.test(fieldHaystack(f)) && !used.has(f.id));
-  if (modelo) return modelo.id;
-  const tipo = fields.find((f) => /\btipo\b|type|vehicletype/.test(fieldHaystack(f)) && !used.has(f.id));
-  if (tipo && /carro|car|moto|truck|van|flex|gasoline|diesel|hybrid|electric|el[eé]trico/.test(normalizedValue)) {
-    return tipo.id;
-  }
-  const combustivel = fields.find((f) => /combustivel|fuel/.test(fieldHaystack(f)) && !used.has(f.id));
-  if (combustivel && /flex|gasoline|diesel|hybrid|electric|el[eé]trico/.test(normalizedValue)) {
-    return combustivel.id;
-  }
-  const nextText = fields.find((field) => {
-    if (used.has(field.id)) return false;
-    const type = normalize4(field.type ?? "text");
-    return type === "text" || type === "input" || type === "number" || type === "";
-  });
-  return nextText?.id;
+  const shape = readValueShape(value);
+  const typed = available.find((field) => fieldTypeMatchesShape(field, shape));
+  if (typed) return typed.id;
+  return available.find((field) => fieldAcceptsFreeText(field, shape))?.id;
 }
 function rewriteMisplacedFormFillFields(fields, registry) {
   const knownFields = collectKnownFormFields(registry);
@@ -1972,28 +1628,36 @@ function rewriteMisplacedFormFillFields(fields, registry) {
 }
 
 // src/executor/formValidation.ts
-var FORM_VALIDATION_TEXT_RE = /(inv[aá]lid|obrigat[oó]ri|required|invalid|j[aá]\s+existe|already\s+exists|duplicad|formato|format|too\s+short|muito\s+curto|n[aã]o\s+(?:foi|pode)|must\s+be|deve\s+ser|selecione|escolha|select\s+(?:the|a|o|an))/i;
-var FORM_SUCCESS_TEXT_RE = /\b(cadastrad[oa]s?\s+com\s+sucesso|registrad[oa]s?\s+com\s+sucesso|salv[oa]\s+com\s+sucesso|foi\s+cadastrad[oa]|foi\s+registrad[oa]|foi\s+salv[oa]|successfully\s+(?:registered|saved|created)|(?:has\s+been|was)\s+(?:registered|saved|created))\b/i;
+var FORM_VALIDATION_TEXT_RE2 = FORM_VALIDATION_TEXT_RE;
+var FORM_SUCCESS_TEXT_RE = FORM_WRITE_SUCCESS_TEXT_RE;
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-var FIELD_HINTS = [
-  { re: /placa|plate|matr[ií]cula/i, fieldId: "placa" },
-  { re: /marca|brand/i, fieldId: "marca" },
-  { re: /modelo|model/i, fieldId: "modelo" },
-  { re: /\bcor\b|color|colour/i, fieldId: "cor" },
-  { re: /\bano\b|year/i, fieldId: "ano" },
-  { re: /email|e-mail|correo/i, fieldId: "email" }
-];
-function inferValidationFieldId(message) {
-  for (const hint of FIELD_HINTS) {
-    if (hint.re.test(message)) return hint.fieldId;
+function inferValidationFieldId(message, inputs) {
+  const haystack = normalizeText(message);
+  if (!haystack || !inputs?.length) return void 0;
+  let best;
+  for (const input of inputs) {
+    const id = input?.id;
+    if (!id) continue;
+    for (const naming of [input.label, input.placeholder, id]) {
+      const needle = normalizeText(naming ?? "");
+      if (needle.length < 3) continue;
+      if (!containsWord(haystack, needle)) continue;
+      if (!best || needle.length > best.length) best = { id, length: needle.length };
+    }
   }
-  return void 0;
+  return best?.id;
+}
+function normalizeText(value) {
+  return String(value ?? "").normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
+}
+function containsWord(haystack, needle) {
+  return ` ${haystack} `.includes(` ${needle} `);
 }
 function readVisibleFormValidation(snap) {
   if (!snap) return void 0;
   for (const text of snap.texts ?? []) {
-    if (!text?.trim() || !FORM_VALIDATION_TEXT_RE.test(text)) continue;
-    return { fieldId: inferValidationFieldId(text), message: text };
+    if (!text?.trim() || !FORM_VALIDATION_TEXT_RE2.test(text)) continue;
+    return { fieldId: inferValidationFieldId(text, snap.inputs), message: text };
   }
   return void 0;
 }
@@ -2215,7 +1879,9 @@ function resolveComponentId(componentId, registry, action) {
   const snapshot = registry.snapshot();
   for (const comp of snapshot) {
     if (comp.id.toLowerCase() === lower) {
-      console.log(`[Appilots] resolveComponentId: case-insensitive match "${componentId}" \u2192 "${comp.id}"`);
+      appilotsDebugLog(
+        `resolveComponentId: case-insensitive match "${componentId}" \u2192 "${comp.id}"`
+      );
       return comp.id;
     }
   }
@@ -2230,12 +1896,16 @@ 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, "");
-        console.log(`[Appilots] resolveComponentId: found screen metadata for "${componentId}" \u2192 label="${metaLabel}"`);
+        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)) {
-            console.log(`[Appilots] resolveComponentId: FOUND via metadata: "${componentId}" \u2192 "${comp.id}" (label="${comp.label}")`);
+            appilotsDebugLog(
+              `resolveComponentId: FOUND via metadata: "${componentId}" \u2192 "${comp.id}" (label="${comp.label}")`
+            );
             return comp.id;
           }
         }
@@ -2250,8 +1920,8 @@ function resolveComponentId(componentId, registry, action) {
   }));
   const match = resolveTarget(componentId, candidates, { action });
   if (match.status === "matched") {
-    console.log(
-      `[Appilots] resolveComponentId: matched "${componentId}" -> "${match.id}" (tier=${match.tier})`
+    appilotsDebugLog(
+      `resolveComponentId: matched "${componentId}" -> "${match.id}" (tier=${match.tier})`
     );
     return match.id;
   }
@@ -2340,8 +2010,8 @@ function setValueHandler(rawComponentId, requested, registry) {
     try {
       slider.setValue(applied);
       if (applied !== requestedValue) {
-        console.log(
-          `[Appilots] uiInteractionHandler: set_value snapped ${requestedValue} \u2192 ${applied} for "${componentId}" (step=${step})`
+        appilotsDebugLog(
+          `uiInteractionHandler: set_value snapped ${requestedValue} \u2192 ${applied} for "${componentId}" (step=${step})`
         );
       }
       return { success: true, effect: "changed" };
@@ -2375,6 +2045,21 @@ function checkModalOcclusion(rawComponentId, action) {
     return null;
   }
   if (typeof rawComponentId !== "string" || rawComponentId.trim().length === 0) return null;
+  const dialog = getOpenNativeDialog();
+  if (dialog) {
+    const needle = normalizeIdent(rawComponentId);
+    if (dialog.buttons.some((b) => normalizeIdent(b.label) === needle)) return null;
+    return {
+      success: false,
+      error: `"${rawComponentId}" is behind a native dialog${dialog.title ? ` ("${dialog.title}")` : ""} and cannot receive touches. Answer the dialog first \u2014 press one of: ` + dialog.buttons.map((b) => b.label).join(", "),
+      diagnose: {
+        category: "ambiguous-target",
+        targetId: rawComponentId,
+        screen: getCurrentScreen() ?? void 0,
+        candidates: dialog.buttons.map((b) => b.label).slice(0, 8)
+      }
+    };
+  }
   const fiberRoot = getFiberRoot();
   if (!fiberRoot) return null;
   let snap;
@@ -2406,9 +2091,12 @@ function checkModalOcclusion(rawComponentId, action) {
       modalOptionLabels.push(button.label ?? button.id);
     }
   }
-  for (const toggle of snap.toggles ?? []) add(toggle.inModal ? inModal : outside, toggle.id, toggle.label);
-  for (const input of snap.inputs ?? []) add(input.inModal ? inModal : outside, input.id, input.label);
-  for (const slider of snap.sliders ?? []) add(slider.inModal ? inModal : outside, slider.id, slider.label);
+  for (const toggle of snap.toggles ?? [])
+    add(toggle.inModal ? inModal : outside, toggle.id, toggle.label);
+  for (const input of snap.inputs ?? [])
+    add(input.inModal ? inModal : outside, input.id, input.label);
+  for (const slider of snap.sliders ?? [])
+    add(slider.inModal ? inModal : outside, slider.id, slider.label);
   for (const list of snap.lists ?? []) {
     for (const item of list.items ?? []) {
       const itemInModal = (item.buttons ?? []).some((b) => b.inModal) || (item.inputs ?? []).some((i) => i.inModal) || (item.toggles ?? []).some((t) => t.inModal);
@@ -2443,7 +2131,10 @@ function uiInteractionHandler(payload, context) {
     return {
       success: false,
       error: "UI interaction is not permitted",
-      diagnose: buildUiDiagnose(payload.componentId ?? payload.targetId ?? "", "unknown")
+      diagnose: buildUiDiagnose(
+        payload.componentId ?? payload.targetId ?? "",
+        "unknown"
+      )
     };
   }
   const { action } = payload;
@@ -2457,8 +2148,8 @@ function uiInteractionHandler(payload, context) {
   if (sliderId) {
     const smuggled = payload.value ?? payload.params?.value;
     if (smuggled !== void 0) {
-      console.log(
-        `[Appilots] uiInteractionHandler: "${actionStr}" on slider "${sliderId}" carried value=${JSON.stringify(smuggled)} \u2014 routing to set_value`
+      appilotsDebugLog(
+        `uiInteractionHandler: "${actionStr}" on slider "${sliderId}" carried value=${JSON.stringify(smuggled)} \u2014 routing to set_value`
       );
       return setValueHandler(rawComponentId, smuggled, registry);
     }
@@ -2468,18 +2159,53 @@ function uiInteractionHandler(payload, context) {
       diagnose: { ...buildUiDiagnose(sliderId, "unknown"), recoverable: true }
     };
   }
+  const openDialog = 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();
+      appilotsDebugLog(`uiInteractionHandler: pressed native dialog button "${button.label}"`);
+      return { success: true, effect: "changed" };
+    }
+  }
+  if (!openDialog && isPressVerb) {
+    const answered = getLastAnsweredNativeDialog();
+    const needle = normalizeIdent(rawComponentId);
+    if (answered && needle) {
+      if (answered.answeredWith && normalizeIdent(answered.answeredWith) === needle) {
+        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" };
+      }
+      if (answered.buttons.some((label) => normalizeIdent(label) === needle)) {
+        return {
+          success: false,
+          error: `The dialog${answered.title ? ` ("${answered.title}")` : ""} was already answered with "${answered.answeredWith ?? "dismiss"}", so "${rawComponentId}" is no longer on screen. Read the current screen before acting again.`,
+          diagnose: {
+            category: "component-not-found",
+            targetId: rawComponentId,
+            screen: getCurrentScreen() ?? void 0,
+            recoverable: false
+          }
+        };
+      }
+    }
+  }
   const occluded = checkModalOcclusion(rawComponentId, actionStr);
   if (occluded) {
-    console.log(
-      `[Appilots] uiInteractionHandler: blocked "${actionStr}" on "${rawComponentId}" \u2014 target is behind an open modal`
+    appilotsDebugLog(
+      `uiInteractionHandler: blocked "${actionStr}" on "${rawComponentId}" \u2014 target is behind an open modal`
     );
     return occluded;
   }
   if (typeof rawComponentId === "string" && rawComponentId.trim().toLowerCase().startsWith("el:")) {
     const result = dispatchElementOrTarget(rawComponentId, registry, actionStr);
     if (result.success) {
-      console.log(
-        `[Appilots] uiInteractionHandler: interaction element dispatch succeeded for "${rawComponentId}"`
+      appilotsDebugLog(
+        `uiInteractionHandler: interaction element dispatch succeeded for "${rawComponentId}"`
       );
       return { success: true };
     }
@@ -2487,13 +2213,13 @@ function uiInteractionHandler(payload, context) {
   }
   const ordinal = parseSyntheticListItemId(rawComponentId);
   if (ordinal && (action === "press" || actionStr === "tap" || actionStr === "click" || actionStr === "longPress")) {
-    console.log(
-      `[Appilots] uiInteractionHandler: dispatching synthetic list ordinal \u2014 componentId="${rawComponentId}" list=${ordinal.listIndex} item=${ordinal.itemIndex}`
+    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) {
-      console.log(
-        `[Appilots] uiInteractionHandler: synthetic ordinal press succeeded (container=${result.containerType ?? "List"})`
+      appilotsDebugLog(
+        `uiInteractionHandler: synthetic ordinal press succeeded (container=${result.containerType ?? "List"})`
       );
       return { success: true };
     }
@@ -2538,7 +2264,9 @@ function uiInteractionHandler(payload, context) {
     };
   }
   const componentId = resolveComponentId(rawComponentId, registry, actionStr);
-  console.log(`[Appilots] uiInteractionHandler: resolved componentId="${payload.componentId}" \u2192 "${componentId}"`);
+  appilotsDebugLog(
+    `uiInteractionHandler: resolved componentId="${payload.componentId}" \u2192 "${componentId}"`
+  );
   const target = registry.getTarget(componentId);
   if (target) {
     try {
@@ -2589,7 +2317,9 @@ function uiInteractionHandler(payload, context) {
       return { success: false, error: err?.message ?? "Focus failed" };
     }
   }
-  console.log(`[Appilots] uiInteractionHandler: registry miss for "${componentId}", falling back to fiber tree`);
+  appilotsDebugLog(
+    `uiInteractionHandler: registry miss for "${componentId}", falling back to fiber tree`
+  );
   const handle = findInteractiveByIdentifier(componentId, {
     kind: actionStr === "toggle" ? "toggle" : actionStr === "focus" ? "field" : "target"
   });
@@ -2597,7 +2327,9 @@ function uiInteractionHandler(payload, context) {
     try {
       if (actionStr === "press" && handle.kind === "target" && handle.press) {
         handle.press();
-        console.log(`[Appilots] uiInteractionHandler: fiber fallback press succeeded for "${componentId}"`);
+        appilotsDebugLog(
+          `uiInteractionHandler: fiber fallback press succeeded for "${componentId}"`
+        );
         return { success: true };
       }
       if (actionStr === "press" && handle.kind === "toggle" && handle.setValue) {
@@ -2743,12 +2475,10 @@ function readVisibleValidation(fieldId, label) {
   try {
     const snap = captureSnapshot();
     const texts = snap.texts ?? [];
-    const needles = [fieldId, label].filter(
-      (s) => !!s && s.length > 0
-    );
+    const needles = [fieldId, label].filter((s) => !!s && s.length > 0);
     for (const text of texts) {
       const lower = text.toLowerCase();
-      if (FORM_VALIDATION_TEXT_RE.test(lower)) {
+      if (FORM_VALIDATION_TEXT_RE2.test(lower)) {
         for (const needle of needles) {
           if (lower.includes(needle.toLowerCase())) return text;
         }
@@ -2869,8 +2599,10 @@ async function tryPressSelectOption(fieldId, value, registry, options = {}) {
 function normalizeFieldType(type) {
   if (typeof type !== "string") return void 0;
   const normalized = normalize3(type);
-  if (normalized === "select" || normalized === "picker" || normalized === "dropdown") return "select";
-  if (normalized === "toggle" || normalized === "switch" || normalized === "checkbox") return "toggle";
+  if (normalized === "select" || normalized === "picker" || normalized === "dropdown")
+    return "select";
+  if (normalized === "toggle" || normalized === "switch" || normalized === "checkbox")
+    return "toggle";
   if (normalized === "date") return "date";
   if (normalized === "number" || normalized === "numeric") return "number";
   if (normalized === "custom") return "custom";
@@ -2904,10 +2636,7 @@ 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) => normalize3(text)).filter(Boolean);
+  const visible = [...snap.texts ?? [], ...(snap.buttons ?? []).map((b) => b.label ?? b.id ?? "")].map((text) => normalize3(text)).filter(Boolean);
   return visible.some((text) => terms.some((term) => text.includes(term) || term.includes(text)));
 }
 function scoreCandidateText(value, texts) {
@@ -2981,9 +2710,7 @@ function buildChoiceCandidates(snap, fieldId, value, allowFirstVisibleWhenNoCue,
         fieldCueVisible && elements.length <= 12 ? 50 : 0,
         ...cueTexts.map((text) => {
           const normalized = normalize3(text);
-          return fieldTerms.some(
-            (term) => normalized.includes(term) || term.includes(normalized)
-          ) ? 80 : 0;
+          return fieldTerms.some((term) => normalized.includes(term) || term.includes(normalized)) ? 80 : 0;
         })
       );
       const valueScore = genericValue ? 0 : scoreCandidateText(value, texts);
@@ -3055,7 +2782,11 @@ async function selectVisibleChoiceAsync(fieldId, value, registry, options) {
     return {
       success: false,
       error: `No visible option found for select field "${fieldId}"`,
-      diagnose: { category: "component-not-found", fieldId, screen: getCurrentScreen() ?? void 0 }
+      diagnose: {
+        category: "component-not-found",
+        fieldId,
+        screen: getCurrentScreen() ?? void 0
+      }
     };
   }
   const pressed = pressTargetByIdOrLabel(candidate.targetId, registry);
@@ -3087,17 +2818,19 @@ function pressContinuationButton(registry) {
   return pressTargetByIdOrLabel(id, registry);
 }
 function findField(fieldId, registry) {
-  console.log(`[Appilots] findField: searching for fieldId="${fieldId}"`);
+  appilotsDebugLog(`findField: searching for fieldId="${fieldId}"`);
   const exact = registry.getField(fieldId);
   if (exact) {
-    console.log(`[Appilots] findField: FOUND exact match for fieldId="${fieldId}"`);
+    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) {
-      console.log(`[Appilots] findField: FOUND case-insensitive match: registered="${comp.id}" for searched="${fieldId}"`);
+      appilotsDebugLog(
+        `findField: FOUND case-insensitive match: registered="${comp.id}" for searched="${fieldId}"`
+      );
       return registry.getField(comp.id);
     }
   }
@@ -3125,8 +2858,8 @@ function findField(fieldId, registry) {
     }
   }
   if (bestComp && bestScore >= 75) {
-    console.log(
-      `[Appilots] findField: scored match "${fieldId}" -> "${bestComp.id}" (label="${bestComp.label}", score=${bestScore})`
+    appilotsDebugLog(
+      `findField: scored match "${fieldId}" -> "${bestComp.id}" (label="${bestComp.label}", score=${bestScore})`
     );
     return registry.getField(bestComp.id);
   }
@@ -3152,8 +2885,8 @@ function findField(fieldId, registry) {
           }
         }
         if (mBest && mBestScore >= 60) {
-          console.log(
-            `[Appilots] findField: FOUND via screen metadata translation: fieldId="${fieldId}" -> metaLabel="${metaLabel}" -> registered="${mBest.id}" (score=${mBestScore})`
+          appilotsDebugLog(
+            `findField: FOUND via screen metadata translation: fieldId="${fieldId}" -> metaLabel="${metaLabel}" -> registered="${mBest.id}" (score=${mBestScore})`
           );
           return registry.getField(mBest.id);
         }
@@ -3161,8 +2894,8 @@ function findField(fieldId, registry) {
     }
   }
   if (bestComp && bestScore >= 40) {
-    console.log(
-      `[Appilots] findField: weak substring match "${fieldId}" -> "${bestComp.id}" (label="${bestComp.label}", score=${bestScore})`
+    appilotsDebugLog(
+      `findField: weak substring match "${fieldId}" -> "${bestComp.id}" (label="${bestComp.label}", score=${bestScore})`
     );
     return registry.getField(bestComp.id);
   }
@@ -3172,17 +2905,19 @@ function findField(fieldId, registry) {
   return void 0;
 }
 function findToggle(fieldId, registry) {
-  console.log(`[Appilots] findToggle: searching for fieldId="${fieldId}"`);
+  appilotsDebugLog(`findToggle: searching for fieldId="${fieldId}"`);
   const exact = registry.getToggle(fieldId);
   if (exact) {
-    console.log(`[Appilots] findToggle: FOUND exact match for "${fieldId}"`);
+    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) {
-      console.log(`[Appilots] findToggle: FOUND case-insensitive match: registered="${comp.id}" for searched="${fieldId}"`);
+      appilotsDebugLog(
+        `findToggle: FOUND case-insensitive match: registered="${comp.id}" for searched="${fieldId}"`
+      );
       return registry.getToggle(comp.id);
     }
   }
@@ -3197,7 +2932,9 @@ function findSlider(fieldId, registry) {
   const lower = fieldId.toLowerCase();
   for (const comp of registry.snapshot()) {
     if (comp.kind === "slider" && comp.id.toLowerCase() === lower) {
-      console.log(`[Appilots] findSlider: FOUND case-insensitive match: registered="${comp.id}" for searched="${fieldId}"`);
+      appilotsDebugLog(
+        `findSlider: FOUND case-insensitive match: registered="${comp.id}" for searched="${fieldId}"`
+      );
       return registry.getSlider(comp.id);
     }
   }
@@ -3229,7 +2966,7 @@ async function formFillHandler(payload, context) {
       "formFillHandler: registry is EMPTY \u2014 auto-tracking may not be active. Ensure enableAppilotsAutoTracking() runs before components mount."
     );
   } else {
-    console.log(
+    appilotsDebugLog(
       `[Appilots formFillHandler] Registry has ${registrySnapshot.length} components:`,
       registrySnapshot.map((c) => `${c.kind}:${c.id}`).join(", ")
     );
@@ -3237,7 +2974,7 @@ async function formFillHandler(payload, context) {
   const fieldResults = [];
   let allSuccess = true;
   let selectedChoiceThisBatch = false;
-  console.log(`[Appilots] formFillHandler: processing ${payload.fields.length} fields`);
+  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)) {
@@ -3264,8 +3001,8 @@ async function formFillHandler(payload, context) {
     const { fieldId, fieldType, value } = field;
     const effectiveFieldType = getEffectiveFieldType(fieldId, fieldType, registry);
     let selectFailure;
-    console.log(
-      `[Appilots] formFillHandler: looking up fieldId="${fieldId}" fieldType="${fieldType}" effectiveFieldType="${effectiveFieldType}" value="${value}"`
+    appilotsDebugLog(
+      `formFillHandler: looking up fieldId="${fieldId}" fieldType="${fieldType}" effectiveFieldType="${effectiveFieldType}" value=${describeValue(value)}`
     );
     const fieldEntry = findField(fieldId, registry);
     if (fieldEntry) {
@@ -3316,7 +3053,11 @@ async function formFillHandler(payload, context) {
               fieldId,
               success: false,
               error: selectResult.error ?? `Select value "${String(value)}" was not applied for "${fieldId}"`,
-              diagnose: selectResult.diagnose ?? { category: "component-not-found", fieldId, screen: screenPath }
+              diagnose: selectResult.diagnose ?? {
+                category: "component-not-found",
+                fieldId,
+                screen: screenPath
+              }
             });
             allSuccess = false;
             continue;
@@ -3371,7 +3112,9 @@ async function formFillHandler(payload, context) {
           continue;
         }
         try {
-          sliderEntry.setValue(snapSliderValue(numeric, sliderEntry.min, sliderEntry.max, sliderEntry.step));
+          sliderEntry.setValue(
+            snapSliderValue(numeric, sliderEntry.min, sliderEntry.max, sliderEntry.step)
+          );
           fieldResults.push({ fieldId, success: true });
         } catch (err) {
           fieldResults.push({
@@ -3420,8 +3163,8 @@ async function formFillHandler(payload, context) {
       }
       if (selectResult.success) {
         selectedChoiceThisBatch = true;
-        console.log(
-          `[Appilots] formFillHandler: selected visible option for "${fieldId}"` + (selectResult.selectedLabel ? ` \u2192 "${selectResult.selectedLabel}"` : "")
+        appilotsDebugLog(
+          `formFillHandler: selected visible option for "${fieldId}"` + (selectResult.selectedLabel ? ` \u2192 "${selectResult.selectedLabel}"` : "")
         );
         await sleep2(120);
         fieldResults.push({ fieldId, success: true });
@@ -3429,7 +3172,7 @@ async function formFillHandler(payload, context) {
       }
       selectFailure = selectResult;
     }
-    console.log(`[Appilots] formFillHandler: registry miss for "${fieldId}", falling back to fiber tree`);
+    appilotsDebugLog(`formFillHandler: registry miss for "${fieldId}", falling back to fiber tree`);
     const handle = findInteractiveByIdentifier(fieldId, {
       kind: effectiveFieldType === "toggle" ? "toggle" : "field"
     });
@@ -3437,7 +3180,9 @@ async function formFillHandler(payload, context) {
       try {
         handle.focus?.();
         handle.setValue(value);
-        console.log(`[Appilots] formFillHandler: fiber fallback succeeded for "${fieldId}" \u2192 label="${handle.label}"`);
+        appilotsDebugLog(
+          `formFillHandler: fiber fallback succeeded for "${fieldId}" \u2192 label="${handle.label}"`
+        );
         fieldResults.push({ fieldId, success: true });
         continue;
       } catch (err) {
@@ -3479,7 +3224,15 @@ async function formFillHandler(payload, context) {
       );
     } else {
       await sleep2(120);
-      const submitResult = pressSubmitButton({ screen, screenPath, activePath }, registry);
+      const submitResult = pressSubmitButton(
+        {
+          screen,
+          screenPath,
+          activePath,
+          filledFieldIds: fieldResults.filter((r) => r.success).map((r) => r.fieldId)
+        },
+        registry
+      );
       if (!submitResult.success) {
         appilotsDebugWarn(`formFillHandler: submitAfterFill failed \u2014 ${submitResult.error}`);
         return {
@@ -3517,7 +3270,7 @@ async function formFillHandler(payload, context) {
           }
         };
       }
-      console.log("[Appilots] formFillHandler: submitAfterFill \u2014 submit completed");
+      appilotsDebugLog("formFillHandler: submitAfterFill \u2014 submit completed");
     }
   }
   const aggregatedDiagnose = aggregateFieldDiagnoses(fieldResults, screenPath);
@@ -3539,8 +3292,8 @@ function pressSubmitButton(context, registry) {
     if (target) {
       try {
         target.press();
-        console.log(
-          `[Appilots] formFillHandler: submitAfterFill \u2014 pressed registry target "${candidate}"` + (resolvedScreen ? ` on screen "${resolvedScreen}"` : "")
+        appilotsDebugLog(
+          `formFillHandler: submitAfterFill \u2014 pressed registry target "${candidate}"` + (resolvedScreen ? ` on screen "${resolvedScreen}"` : "")
         );
         return { success: true, pressedTargetId: candidate };
       } catch (err) {
@@ -3564,9 +3317,7 @@ function pressSubmitButton(context, registry) {
       if (handle?.press) {
         try {
           handle.press();
-          console.log(
-            `[Appilots] formFillHandler: submitAfterFill \u2014 fiber fallback "${submitLabel}"`
-          );
+          appilotsDebugLog(`formFillHandler: submitAfterFill \u2014 fiber fallback "${submitLabel}"`);
           return { success: true, pressedTargetId: submitId ?? submitLabel };
         } catch (err) {
           return {
@@ -3588,9 +3339,7 @@ function pressSubmitButton(context, registry) {
     if (id) {
       const pressed = pressTargetByIdOrLabel(id, registry);
       if (pressed.success) {
-        console.log(
-          `[Appilots] formFillHandler: submitAfterFill \u2014 pressed visible heuristic "${id}"`
-        );
+        appilotsDebugLog(`formFillHandler: submitAfterFill \u2014 pressed visible heuristic "${id}"`);
         return { success: true, pressedTargetId: id };
       }
     }
@@ -3604,8 +3353,8 @@ function pressSubmitButton(context, registry) {
     if (target) {
       try {
         target.press();
-        console.log(
-          `[Appilots] formFillHandler: submitAfterFill \u2014 pressed by label heuristic "${comp.label}"`
+        appilotsDebugLog(
+          `formFillHandler: submitAfterFill \u2014 pressed by label heuristic "${comp.label}"`
         );
         return { success: true, pressedTargetId: comp.id };
       } catch (err) {
@@ -3617,9 +3366,16 @@ function pressSubmitButton(context, registry) {
       }
     }
   }
+  for (const fieldId of [...context.filledFieldIds ?? []].reverse()) {
+    const handle = findInteractiveByIdentifier(fieldId, { kind: "field" });
+    if (handle?.submitFromKeyboard?.()) {
+      appilotsDebugLog(`formFillHandler: submitAfterFill \u2014 return key on "${fieldId}"`);
+      return { success: true, pressedTargetId: fieldId };
+    }
+  }
   return {
     success: false,
-    error: 'submitAfterFill requested but no submit button was found (declare it via registerScreen({ actions: [{ type: "submit", ... }] }) for reliable behavior)',
+    error: 'submitAfterFill requested but the screen has no submit button and no field that submits on return (declare it via registerScreen({ actions: [{ type: "submit", ... }] }) for reliable behavior)',
     diagnose: { category: "component-not-found", screen: resolvedScreen }
   };
 }
@@ -3673,6 +3429,8 @@ function resolveListEntry(listId) {
     return { candidates: entries.map((e) => e.id) };
   }
   if (entries.length === 1) return { entry: entries[0] };
+  const lists = entries.filter((e) => e.kind === "list");
+  if (lists.length === 1) return { entry: lists[0] };
   return { candidates: entries.map((e) => e.id) };
 }
 function pageOffset(metrics, direction) {
@@ -3712,7 +3470,7 @@ async function scrollListHandler(payload, context) {
   }
   const { entry, candidates } = resolveListEntry(payload.listId);
   if (!entry) {
-    const detail = candidates && candidates.length > 0 ? payload.listId ? `List "${payload.listId}" is not registered. Known lists: ${candidates.join(", ")}` : `Multiple lists are on screen \u2014 specify listId. Known lists: ${candidates.join(", ")}` : "No scrollable list is registered on the current screen (enableAppilotsAutoTracking() may be off).";
+    const detail = candidates && candidates.length > 0 ? payload.listId ? `List "${payload.listId}" is not registered. Known lists: ${candidates.join(", ")}` : `Multiple lists are on screen \u2014 specify listId. Known lists: ${candidates.join(", ")}` : "Nothing scrollable is registered on the current screen (enableAppilotsAutoTracking() may be off).";
     return {
       success: false,
       error: detail,
@@ -3720,6 +3478,13 @@ async function scrollListHandler(payload, context) {
     };
   }
   if (toIndex !== void 0) {
+    if (entry.kind === "scroll") {
+      return {
+        success: false,
+        error: `"${entry.id}" is a scrollable screen, not a list \u2014 it has no numbered items. Use direction "down"/"up" to page through it.`,
+        diagnose: buildDiagnose("validation", entry.id)
+      };
+    }
     if (typeof entry.itemCount === "number" && toIndex > entry.itemCount) {
       return {
         success: false,
@@ -3754,14 +3519,14 @@ async function scrollListHandler(payload, context) {
   }
   return {
     success: false,
-    error: `List "${entry.id}" does not expose a scrollable handle`,
+    error: `"${entry.id}" does not expose a scrollable handle`,
     diagnose: buildDiagnose("unknown", entry.id)
   };
 }
 
 // src/executor/handlers/confirmHandler.ts
 async function confirmHandler(_actionId, _payload) {
-  return { success: true };
+  return { success: true, effect: "unknown" };
 }
 
 // src/executor/postInteractionSettle.ts
@@ -3773,14 +3538,45 @@ function targetIdFromPayload(payload) {
   if (typeof targetId === "string" && targetId.trim()) return targetId.trim();
   return "";
 }
+function hashFieldValue(value) {
+  let hash = 2166136261;
+  for (let i = 0; i < value.length; i++) {
+    hash ^= value.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(36);
+}
+var DISCRETE_FIELD_TYPES = /* @__PURE__ */ new Set(["select", "date"]);
+function discreteFieldSignature() {
+  const sigs = [];
+  for (const { id, kind } of componentRegistry.snapshot()) {
+    if (kind !== "field") continue;
+    const entry = componentRegistry.getField(id);
+    if (!entry || !DISCRETE_FIELD_TYPES.has(entry.fieldType ?? "")) continue;
+    try {
+      sigs.push(`${id}:${hashFieldValue(String(entry.getValue() ?? ""))}`);
+    } catch {
+    }
+  }
+  return sigs.sort().join(",");
+}
 async function waitForPostInteractionSettle(payload) {
   const targetId = targetIdFromPayload(payload);
   const fromScreen = getCurrentScreen();
   const baseline = probeLoadingState(targetId || null, fromScreen);
+  const baselineFields = discreteFieldSignature();
+  const readable = baseline.fingerprint !== "";
   await sleepMs(100);
   const afterPress = probeLoadingState(targetId || null, getCurrentScreen());
   const modalOrLoading = afterPress.modalOpen || afterPress.loading || afterPress.pressedDisabled;
   const fingerprintChanged = afterPress.fingerprint !== baseline.fingerprint;
+  const verdict = () => {
+    if (!readable) return { effect: "unknown" };
+    const settled = probeLoadingState(targetId || null, getCurrentScreen());
+    if (settled.fingerprint === "") return { effect: "unknown" };
+    if (discreteFieldSignature() !== baselineFields) return { effect: "changed" };
+    return { effect: settled.fingerprint !== baseline.fingerprint ? "changed" : "none" };
+  };
   const capMs = isListItemPressTarget(targetId) ? 5e3 : 1e4;
   if (modalOrLoading || fingerprintChanged) {
     await waitForLoadingSettle({
@@ -3788,7 +3584,7 @@ async function waitForPostInteractionSettle(payload) {
       fromScreen,
       maxMs: capMs
     });
-    return;
+    return verdict();
   }
   if (isListItemPressTarget(targetId)) {
     await waitForLoadingSettle({
@@ -3796,6 +3592,7 @@ async function waitForPostInteractionSettle(payload) {
       maxMs: 3e3
     });
   }
+  return verdict();
 }
 
 // src/executor/ActionExecutor.ts
@@ -3850,10 +3647,9 @@ function validateActionPayload(action) {
       const hasIndex = typeof payload.toIndex === "number";
       const hasDirection = payload.direction === "up" || payload.direction === "down";
       if (!hasIndex && !hasDirection) {
-        return invalid(
-          'scroll_list action needs toIndex (1-based) or direction ("up"/"down")',
-          { targetId: typeof payload.listId === "string" ? payload.listId : void 0 }
-        );
+        return invalid('scroll_list action needs toIndex (1-based) or direction ("up"/"down")', {
+          targetId: typeof payload.listId === "string" ? payload.listId : void 0
+        });
       }
       return null;
     }
@@ -3861,20 +3657,44 @@ function validateActionPayload(action) {
       return null;
   }
 }
+function effectFor(payload, observed) {
+  if (observed === "none" && isDestructivePayload(payload)) return "unknown";
+  return observed;
+}
+function isDestructivePayload(payload) {
+  if (!payload || typeof payload !== "object") return false;
+  const p = payload;
+  if (p.destructive === true) return true;
+  const params = p.params;
+  return !!params && typeof params === "object" && params.destructive === true;
+}
 async function executeAction(action, context) {
-  console.log(`[Appilots] executeAction called: type="${action.type}", id="${action.id}", payload=${JSON.stringify(action.payload)}`);
+  appilotsDebugLog(
+    `executeAction called: type="${action.type}", id="${action.id}", payload=${JSON.stringify(action.payload)}`
+  );
   const permissions = context.permissions ?? DEFAULT_PERMISSIONS;
-  if (permissions.allowedActions && permissions.allowedActions.length > 0 && !permissions.allowedActions.includes(action.type)) {
-    return {
-      success: false,
-      error: `Action type "${action.type}" is not in the allowed actions list`
-    };
-  }
   context.emit({
     type: "agent:action:start",
     timestamp: Date.now(),
     data: { actionId: action.id, actionType: action.type }
   });
+  if (permissions.allowedActions && permissions.allowedActions.length > 0 && !permissions.allowedActions.includes(action.type)) {
+    const result2 = {
+      success: false,
+      error: `Action type "${action.type}" is not in the allowed actions list`
+    };
+    context.emit({
+      type: "agent:action:error",
+      timestamp: Date.now(),
+      data: {
+        actionId: action.id,
+        actionType: action.type,
+        success: false,
+        error: result2.error
+      }
+    });
+    return result2;
+  }
   let result;
   const validationFailure = validateActionPayload(action);
   if (validationFailure) {
@@ -3908,25 +3728,25 @@ async function executeAction(action, context) {
           registry: context.registry ?? getDefaultRegistry()
         });
         break;
-      case "ui_interaction":
-        result = uiInteractionHandler(action.payload, {
+      case "ui_interaction": {
+        const payload = action.payload;
+        result = uiInteractionHandler(payload, {
           permissions,
           registry: context.registry ?? getDefaultRegistry()
         });
         if (result.success) {
-          await waitForPostInteractionSettle(action.payload);
+          const settle = await waitForPostInteractionSettle(payload);
+          result.effect = result.effect ?? effectFor(payload, settle.effect);
         }
         break;
+      }
       case "scroll_list":
         result = await scrollListHandler(action.payload, {
           permissions
         });
         break;
       case "confirm":
-        result = await confirmHandler(
-          action.id,
-          action.payload
-        );
+        result = await confirmHandler(action.id, action.payload);
         break;
       case "custom":
         result = {
@@ -3949,7 +3769,9 @@ async function executeAction(action, context) {
       error: err?.message ?? "Action execution failed unexpectedly"
     };
   }
-  console.log(`[Appilots] executeAction result: type="${action.type}", id="${action.id}", success=${result.success}, error=${result.error ?? "none"}`);
+  appilotsDebugLog(
+    `executeAction result: type="${action.type}", id="${action.id}", success=${result.success}, error=${result.error ?? "none"}`
+  );
   context.emit({
     type: result.success ? "agent:action:complete" : "agent:action:error",
     timestamp: Date.now(),
@@ -4001,9 +3823,7 @@ var _patchedAlert = (title, message, buttons, options) => {
     return suppression.originalAlert(title, message, buttons, options);
   }
   suppression.consumed = true;
-  console.log(
-    "[Appilots] Suppressing native Alert during already-confirmed destructive agent action"
-  );
+  appilotsDebugLog("Suppressing native Alert during already-confirmed destructive agent action");
   try {
     suppression.pending = Promise.resolve(button.onPress()).then(() => void 0).catch((err) => reportHandlerFailure(err));
   } catch (err) {
@@ -4128,13 +3948,10 @@ async function settleTurn(input) {
       targetScreen: navigateTargetScreen,
       maxMs: 3500
     });
-    console.log(
-      `[Appilots] settleTurn: post-navigate settle done \u2014 screen="${settle.screen}" transitioned=${settle.transitioned} timedOut=${settle.timedOut} waitedMs=${settle.waitedMs}`
+    appilotsDebugLog(
+      `settleTurn: post-navigate settle done \u2014 screen="${settle.screen}" transitioned=${settle.transitioned} timedOut=${settle.timedOut} waitedMs=${settle.waitedMs}`
     );
-    const navigationMoved = settle.transitioned || screenDepartedBaseline(
-      input.preNavigateScreen ?? null,
-      input.preNavigateSignature ?? null
-    ) || !!navigateTargetScreen && !!settle.screen && routesBelongToSameFeature(settle.screen, navigateTargetScreen);
+    const navigationMoved = settle.transitioned || screenDepartedBaseline(input.preNavigateScreen ?? null, input.preNavigateSignature ?? null) || !!navigateTargetScreen && !!settle.screen && routesBelongToSameFeature(settle.screen, navigateTargetScreen);
     if (!navigationMoved) {
       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.`
@@ -4147,8 +3964,8 @@ async function settleTurn(input) {
       fromScreen: settle.screen ?? null,
       maxMs: 3e3
     });
-    console.log(
-      `[Appilots] settleTurn: post-navigate loading settle \u2014 settled=${loadSettle.settled} loadingPending=${loadSettle.loadingPending} probes=${loadSettle.probeCount} waitedMs=${loadSettle.waitedMs}`
+    appilotsDebugLog(
+      `settleTurn: post-navigate loading settle \u2014 settled=${loadSettle.settled} loadingPending=${loadSettle.loadingPending} probes=${loadSettle.probeCount} waitedMs=${loadSettle.waitedMs}`
     );
     if (loadSettle.loadingPending) loadingPending = true;
   } else {
@@ -4162,8 +3979,8 @@ async function settleTurn(input) {
       fromScreen: getCurrentScreen(),
       maxMs: settleCapMs
     });
-    console.log(
-      `[Appilots] 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)" : ""}`
+    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)" : ""}`
     );
     if (loadSettle.loadingPending) loadingPending = true;
     const listPressActions = turnActions.filter((action) => {
@@ -4184,8 +4001,8 @@ async function settleTurn(input) {
         maxMs: 4e3
       });
       const afterFingerprint = probeLoadingState(pressedId, getCurrentScreen()).fingerprint;
-      console.log(
-        `[Appilots] settleTurn: post-list-press settle \u2014 screen="${postPressSettle.screen}" transitioned=${postPressSettle.transitioned} timedOut=${postPressSettle.timedOut} waitedMs=${postPressSettle.waitedMs}`
+      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) {
@@ -4378,7 +4195,7 @@ function useSuggestedPrompts(options) {
       if (cancelled || requestIdRef.current !== requestId) return;
       setPrompts(mergePromptSources(localDev, data, limit));
     }).catch((err) => {
-      console.warn("[Appilots] useSuggestedPrompts: fetch failed", err);
+      appilotsDebugWarn("useSuggestedPrompts: fetch failed", err);
     }).finally(() => {
       if (cancelled || requestIdRef.current !== requestId) return;
       setIsLoading(false);
@@ -4576,4 +4393,4 @@ function useAppilotsSlider(id, options) {
   }, [id, registry, getValue, setValue, min, max, step, label, screen]);
 }
 
-export { captureSnapshot, executeAction, shouldShowSuggestedPrompts, useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts };
+export { appilotsSelfCheck, captureSnapshot, executeAction, shouldShowSuggestedPrompts, useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts };