@appilots/sdk 0.3.0 → 0.4.1

package/dist/{chunk-BKFO4DHW.mjs → chunk-L2A4EZ6V.mjs}

@@ -1,5 +1,5 @@
-import { getFiberRoot, getCurrentScreen, getActiveRouteNames, elementRegistry, useAppilotsContext, recordAppilotsDebugTrace, getCurrentScreenSignature, fingerprintAction, turnHasConfirmActions, waitForScreenSettle, screenDepartedBaseline, routesBelongToSameFeature, appilotsDebugWarn, waitForLoadingSettle, actionPressTargetId, isListItemPressTarget, probeLoadingState, buildContinuationFailureMessage, StreamTransportError, StreamAbortError, getDefaultRegistry, getNavigationRef, getScreenMetadata, setCurrentScreen, useResolvedRegistry, listRegistry, componentRegistry, getNavigationStateSnapshot, metadataMatchesComponentId, isOptionalStepAutomationFailure, OPTIONAL_STEP_AUTOMATION_HINT, normalize2, matchScore, getAllScreens, looksDestructiveActionLabel, isGenericSelectValue } from './chunk-QMSMXTED.mjs';
-import { useRef, useState, useCallback, useEffect } from 'react';
+import { getFiberRoot, getCurrentScreen, getActiveRouteNames, 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-4GUPZDWT.mjs';
+import { useMemo, useRef, useSyncExternalStore, useEffect, useCallback, useState } from 'react';
 import { Alert } from 'react-native';
 
 // src/introspection/walkFiber.ts
@@ -654,225 +654,6 @@ 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/interactionGraph.ts
-function normalizePart(value) {
-  return String(value ?? "").toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48);
-}
-function hashString(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);
-}
-function stableElementId(parts) {
-  const raw = parts.filter((p) => p !== void 0 && String(p).length > 0).join("|");
-  const readable = parts.map(normalizePart).filter(Boolean).join(":").slice(0, 120);
-  return `el:${readable}:${hashString(raw)}`;
-}
-function parseStableElementId(id) {
-  if (typeof id !== "string") return null;
-  const trimmed = id.trim();
-  if (!/^el:/i.test(trimmed)) return null;
-  const parts = trimmed.split(":");
-  if (parts.length < 3) return null;
-  const hash = parts[parts.length - 1];
-  const segments = parts.slice(1, -1);
-  if (segments.length === 0) return null;
-  const role = segments[0];
-  const result = { role, segments, hash };
-  if (role === "option" && segments.length >= 4) {
-    result.listId = segments[segments.length - 2];
-    result.itemKey = segments[segments.length - 1];
-  }
-  return result;
-}
-function uniqueTexts(texts) {
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const text of texts) {
-    const t = typeof text === "string" ? text.trim() : "";
-    if (!t || seen.has(t)) continue;
-    seen.add(t);
-    out.push(t);
-  }
-  return out;
-}
-function labelForListItem(item) {
-  return uniqueTexts([
-    ...item.texts ?? [],
-    ...(item.buttons ?? []).map((button) => button.label ?? button.id)
-  ]).slice(0, 2).join(" \xB7 ") || void 0;
-}
-function listItemElement(route, list, item) {
-  const texts = uniqueTexts([
-    ...item.texts ?? [],
-    ...(item.buttons ?? []).map((button) => button.label ?? button.id)
-  ]);
-  const label = labelForListItem(item);
-  const key = item.itemKey ?? item.reactKey ?? label ?? item.syntheticId;
-  const id = stableElementId([
-    "option",
-    route ?? "unknown",
-    list.id ?? list.label ?? `list-${list.index}`,
-    key
-  ]);
-  const inModal = (item.buttons ?? []).some((button) => button.inModal) || (item.inputs ?? []).some((input) => input.inModal) || (item.toggles ?? []).some((toggle) => toggle.inModal);
-  return {
-    id,
-    role: "option",
-    label,
-    texts,
-    actions: ["press"],
-    disabled: false,
-    source: "list",
-    targetId: item.syntheticId,
-    ...inModal ? { inModal: true } : {},
-    listContext: {
-      listIndex: list.index,
-      listId: list.id,
-      listLabel: list.label,
-      itemIndex: item.index,
-      itemKey: item.itemKey,
-      reactKey: item.reactKey,
-      syntheticId: item.syntheticId
-    }
-  };
-}
-function buttonElement(route, button, index) {
-  const label = button.label ?? button.id;
-  const id = stableElementId([
-    "button",
-    route ?? "unknown",
-    button.id ?? label ?? `button-${index}`
-  ]);
-  return {
-    id,
-    role: "button",
-    label,
-    texts: uniqueTexts([label]),
-    actions: ["press"],
-    disabled: button.disabled,
-    selected: button.selected,
-    source: "button",
-    targetId: button.id ?? button.label,
-    ...button.inModal ? { inModal: true } : {}
-  };
-}
-function inputElement(route, input, index) {
-  const label = input.label ?? input.placeholder ?? input.id;
-  const id = stableElementId([
-    "input",
-    route ?? "unknown",
-    input.id ?? label ?? `input-${index}`
-  ]);
-  return {
-    id,
-    role: "input",
-    label,
-    texts: uniqueTexts([label, input.placeholder]),
-    actions: ["focus", "setValue"],
-    disabled: input.editable === false,
-    source: "input",
-    targetId: input.id ?? input.label ?? input.placeholder,
-    ...input.inModal ? { inModal: true } : {}
-  };
-}
-function toggleElement(route, toggle, index) {
-  const label = toggle.label ?? toggle.id;
-  const id = stableElementId([
-    "toggle",
-    route ?? "unknown",
-    toggle.id ?? label ?? `toggle-${index}`
-  ]);
-  return {
-    id,
-    role: "toggle",
-    label,
-    texts: uniqueTexts([label]),
-    actions: ["toggle", "press"],
-    selected: toggle.value,
-    source: "toggle",
-    targetId: toggle.id ?? toggle.label,
-    ...toggle.inModal ? { inModal: true } : {}
-  };
-}
-function sliderElement(route, slider, index) {
-  const label = slider.label ?? slider.id;
-  const id = stableElementId([
-    "slider",
-    route ?? "unknown",
-    slider.id ?? label ?? `slider-${index}`
-  ]);
-  return {
-    id,
-    role: "slider",
-    label,
-    texts: uniqueTexts([label]),
-    actions: ["setValue"],
-    disabled: slider.disabled,
-    source: "slider",
-    targetId: slider.id ?? slider.label,
-    ...slider.inModal ? { inModal: true } : {}
-  };
-}
-function deriveInteractionElements(snapshot) {
-  const elements = [];
-  const seen = /* @__PURE__ */ new Set();
-  const push = (element) => {
-    if (!element.id || seen.has(element.id)) return;
-    seen.add(element.id);
-    elements.push(element);
-  };
-  for (const list of snapshot.lists ?? []) {
-    for (const item of list.items ?? []) {
-      push(listItemElement(snapshot.route, list, item));
-    }
-  }
-  for (const [index, button] of (snapshot.buttons ?? []).entries()) {
-    push(buttonElement(snapshot.route, button, index));
-  }
-  for (const [index, input] of (snapshot.inputs ?? []).entries()) {
-    push(inputElement(snapshot.route, input, index));
-  }
-  for (const [index, toggle] of (snapshot.toggles ?? []).entries()) {
-    push(toggleElement(snapshot.route, toggle, index));
-  }
-  for (const [index, slider] of (snapshot.sliders ?? []).entries()) {
-    push(sliderElement(snapshot.route, slider, index));
-  }
-  return elements;
-}
-function findElementForChoice(elements, option) {
-  if (option.targetId) {
-    const byTarget = elements.find((element) => element.targetId === option.targetId);
-    if (byTarget) return byTarget;
-  }
-  const optionLabel = normalizePart(option.label ?? option.texts?.join(" "));
-  if (!optionLabel) return void 0;
-  return elements.find((element) => {
-    if (element.role !== "option" && element.role !== "button") return false;
-    const label = normalizePart(element.label ?? element.texts.join(" "));
-    return label === optionLabel || label.includes(optionLabel) || optionLabel.includes(label);
-  });
-}
-function attachElementIdsToChoiceGroups(choiceGroups, elements) {
-  return choiceGroups.map((group) => ({
-    ...group,
-    options: group.options.map((option) => {
-      const element = findElementForChoice(elements, option);
-      if (!element) return option;
-      const handle = element.listContext?.syntheticId ?? element.id;
-      return {
-        ...option,
-        syntheticId: handle,
-        targetId: handle
-      };
-    })
-  }));
-}
-
 // src/introspection/captureSnapshot.ts
 function normalizeSliderKey(value) {
   return (value ?? "").toLowerCase().replace(/^slider[-_]/, "");
@@ -1207,843 +988,29 @@ function findInteractiveByIdentifier(query, options = {}) {
     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 (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);
-        if (kind === "field") bestHandle = wrapTextInput(fiber);
-        else if (kind === "toggle") bestHandle = wrapSwitch(fiber);
-        else bestHandle = wrapTouchable(fiber, findChildText2(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}`
-    );
-  } else {
-    console.log(`[Appilots] findInteractiveByIdentifier: query="${query}" \u2192 no match`);
-  }
-  return bestHandle;
-}
-
-// src/hooks/visibleMessages.ts
-var INTERNAL_MARKER_RE = /^\[(?:Permission policy notice|Recovery exhausted|User rejected the proposed action)[^\]]*\]:\s*/i;
-var TECHNICAL_TRACE_RE = /(^|\n)\s*(?:Results:|[-*]\s*[✓✗]\s+|(?:press|click|tap|navigate|form_fill|ui_interaction|scroll_list)\b|(?:Cliquei|Clicked)\s+em\s+(?:el:|list-\d+-item-\d+|[A-Za-z]+:))/i;
-var TECHNICAL_SELECTOR_RE = /\b(?:el:[^\s]+|list-\d+-item-\d+|[A-Za-z][\w-]*:(?!\/\/)[^\s]+|(?:testID|test-id|accessibilityId|accessibility-id)[:=_-][^\s]+)/i;
-function sanitizeVisibleAssistantContent(content) {
-  return content.split("\n").map((line) => line.replace(INTERNAL_MARKER_RE, "").trimEnd()).filter((line) => !INTERNAL_MARKER_RE.test(line)).join("\n").trim();
-}
-function humanizeAssistantFallback(content) {
-  let text = sanitizeVisibleAssistantContent(content).replace(/\blist-\d+-item-\d+\b/gi, "o item da lista").replace(/\bel:[^\s".]+/gi, "o elemento").replace(
-    /"\s*(?:press|click|tap|navigate|form_fill|ui_interaction|scroll_list)\s+on\s+[^"]+"/gi,
-    '"a a\xE7\xE3o solicitada"'
-  ).replace(/\bsubscription-cancel-[^\s"]+/gi, "cancelamento de assinatura").trim();
-  if (text.length < 16) return null;
-  const probe = {
-    role: "assistant",
-    content: text};
-  if (isInternalTraceMessage(probe)) return null;
-  return text;
-}
-function isInternalTraceMessage(message) {
-  if (message.role !== "assistant") return false;
-  const content = message.content.trim();
-  if (!content) return true;
-  return TECHNICAL_TRACE_RE.test(content) || TECHNICAL_SELECTOR_RE.test(content);
-}
-
-// src/executor/formWriteEffect.ts
-var CREATE_FORM_ROUTE_RE = /vehiclecreate|subscriptioncreate|vehicleedit|subscriptionedit|maintenancecreate|create|cadastr|register|novo|edit/i;
-var SUBMIT_BUTTON_RE = /cadastrar|registrar|salvar|submit|register|guardar|enviar|confirmar|save/i;
-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;
-function normalize3(value) {
-  return value.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
-}
-function routeHintsCreateForm(routeNames) {
-  return routeNames.some((name) => CREATE_FORM_ROUTE_RE.test(normalize3(name)));
-}
-function snapshotHasSubmitControl(snap) {
-  return (snap.buttons ?? []).some(
-    (btn) => SUBMIT_BUTTON_RE.test(normalize3(`${btn.label ?? btn.id ?? ""}`))
-  );
-}
-function snapshotHasVisibleSubmitButton(snap) {
-  return (snap.buttons ?? []).some(
-    (btn) => !btn.disabled && SUBMIT_BUTTON_RE.test(normalize3(`${btn.label ?? btn.id ?? ""}`))
-  );
-}
-function snapshotHasVisibleValidation(snap) {
-  return (snap.texts ?? []).some((text) => typeof text === "string" && FORM_VALIDATION_TEXT_RE.test(text));
-}
-function snapshotShowsOpenCreateForm(snap, activePath = []) {
-  if (!snap) return false;
-  const routeNames = [
-    ...typeof snap.route === "string" && snap.route ? [snap.route] : [],
-    ...activePath
-  ];
-  const hasFormInputs = (snap.inputs?.length ?? 0) > 0;
-  const hasValidation = snapshotHasVisibleValidation(snap);
-  const hasFormContext = routeHintsCreateForm(routeNames) || hasFormInputs || hasValidation;
-  if (!hasFormContext) return false;
-  if (snap.loading === true) return true;
-  if (snapshotHasVisibleSubmitButton(snap)) return true;
-  if (snapshotHasSubmitControl(snap) && hasFormInputs) return true;
-  if (hasValidation) return true;
-  return false;
-}
-function formFillLackedWriteEffect(action, snap, activePath = []) {
-  if (action.type !== "form_fill") return false;
-  if (!snapshotShowsOpenCreateForm(snap, activePath)) return false;
-  const payload = action.payload;
-  if (payload?.submitAfterFill === true) return true;
-  return Array.isArray(payload?.fields) && payload.fields.length > 0;
-}
-
-// src/hooks/useAppilotsChat.ts
-var ESCALATION_RECONNECT_MAX_MS = 3e4;
-function resolveScreenMetadata() {
-  const activePath = getActiveRouteNames();
-  for (let i = activePath.length - 1; i >= 0; i--) {
-    const name = activePath[i];
-    const meta = name ? getScreenMetadata(name) : void 0;
-    if (meta && (Array.isArray(meta.fields) && meta.fields.length > 0 || Array.isArray(meta.actions) && meta.actions.length > 0)) {
-      return meta;
-    }
-  }
-  const screen = getCurrentScreen();
-  return screen ? getScreenMetadata(screen) : void 0;
-}
-function buildAgentContext(extras = {}) {
-  const context = {};
-  context.platform = "react-native";
-  const screen = getCurrentScreen();
-  if (screen) context.currentScreen = screen;
-  const navigationState = getNavigationStateSnapshot();
-  if (navigationState) context.navigationState = navigationState;
-  const screenMeta = resolveScreenMetadata();
-  if (screenMeta) context.screenMetadata = screenMeta;
-  try {
-    context.snapshot = captureSnapshot();
-  } catch (err) {
-    appilotsDebugWarn("buildAgentContext: captureSnapshot failed", err);
-  }
-  const registry = componentRegistry.snapshot();
-  const filtered = screen ? registry.filter((c) => !c.screen || c.screen === screen) : registry;
-  if (filtered.length > 0) context.registeredComponents = filtered;
-  const registeredLists = listRegistry.snapshot();
-  if (registeredLists.length > 0) {
-    context.registeredLists = registeredLists.map(
-      ({ scrollToIndex, scrollToOffset, getScrollMetrics, dataPreview, ...rest }) => rest
-    );
-  }
-  if (extras.loadingPending === true) context.loadingPending = true;
-  return context;
-}
-function extractPressedComponentId(actions) {
-  for (let i = actions.length - 1; i >= 0; i--) {
-    const a = actions[i];
-    if (!a || a.type !== "ui_interaction") continue;
-    const p = a.payload;
-    const interaction = p?.action ?? "press";
-    if (interaction !== "press" && interaction !== "longPress") continue;
-    const id = p?.componentId;
-    if (typeof id === "string" && id.length > 0) return id;
-  }
-  return null;
-}
-function extractNavigateTargetScreen(actions) {
-  for (let i = actions.length - 1; i >= 0; i--) {
-    const a = actions[i];
-    if (!a || a.type !== "navigate") continue;
-    const screenName = a.payload?.screenName;
-    if (typeof screenName === "string" && screenName.length > 0) return screenName;
-  }
-  return null;
-}
-function idLooselyMatches(candidate, target) {
-  if (!candidate || !target) return false;
-  if (candidate === target) return true;
-  const c = candidate.toLowerCase();
-  const t = target.toLowerCase();
-  if (c === t) return true;
-  return c.endsWith(`-${t}`) || c.endsWith(`_${t}`) || t.endsWith(`-${c}`) || t.endsWith(`_${c}`);
-}
-function resolveActionHints(screen, pressedComponentId, actionPayload) {
-  if (actionPayload && typeof actionPayload === "object") {
-    const inline = actionPayload._appilotsInferred;
-    if (inline && typeof inline === "object") {
-      return inline;
-    }
-  }
-  if (!screen || !pressedComponentId) return void 0;
-  const meta = getScreenMetadata(screen);
-  const actions = meta?.actions;
-  if (!actions || actions.length === 0) return void 0;
-  for (const a of actions) {
-    if (typeof a === "string") continue;
-    if (idLooselyMatches(a.id, pressedComponentId)) {
-      const inferred = a.appilotsInferred;
-      if (inferred && typeof inferred === "object") return inferred;
-      return void 0;
-    }
-  }
-  return void 0;
-}
-function summarizeAction(action) {
-  const p = action.payload;
-  switch (action.type) {
-    case "navigate":
-      return `navigate to ${p?.screenName ?? "?"}`;
-    case "form_fill": {
-      const fields = p?.fields ?? [];
-      if (fields.length === 0) return "form_fill (no fields)";
-      const parts = fields.slice(0, 3).map((f) => `${f.fieldId}=${JSON.stringify(f.value)}`);
-      const extra = fields.length > 3 ? ` +${fields.length - 3} more` : "";
-      return `form_fill ${parts.join(", ")}${extra}`;
-    }
-    case "ui_interaction":
-      return `${p?.action ?? "press"} on ${p?.componentId ?? "?"}`;
-    case "scroll_list": {
-      const target = typeof p?.toIndex === "number" ? `to item #${p.toIndex}` : p?.direction ?? "down";
-      return `scroll_list ${p?.listId ? `"${p.listId}" ` : ""}${target}`;
-    }
-    case "confirm":
-      return `confirm: ${p?.message ?? p?.title ?? ""}`;
-    default:
-      return action.type;
-  }
-}
-var MAX_RECOVERY_ATTEMPTS_PER_ACTION = 2;
-var POST_ACTION_LOADING_MAX_MS = 6e3;
-function useAppilotsChat(options = {}) {
-  const { client, emit, subscribe } = useAppilotsContext();
-  const errorPrefix = options.errorPrefix ?? "Algo deu errado";
-  const streamingEnabled = options.streaming !== false;
-  const abortRef = useRef(null);
-  const [messages, setMessages] = useState([]);
-  const [pendingActions, setPendingActions] = useState([]);
-  const [isLoading, setIsLoading] = useState(false);
-  const [loadingStatusKey, setLoadingStatusKey] = useState("thinking");
-  const [error, setError] = useState(null);
-  const messageIdCounter = useRef(0);
-  const [escalation, setEscalation] = useState(null);
-  const escalationRef = useRef(null);
-  escalationRef.current = escalation;
-  const [escalationStreamEpoch, setEscalationStreamEpoch] = useState(0);
-  const escalationReconnectAttemptRef = useRef(0);
-  const escalationReconnectTimerRef = useRef(null);
-  const escalationSinceRef = useRef(void 0);
-  const seenHumanMessageIdsRef = useRef(/* @__PURE__ */ new Set());
-  const escalationStrings = options.escalationStrings;
-  const currentTurnRef = useRef(null);
-  const continuationInFlightRef = useRef(false);
-  const recoveryCountByFingerprintRef = useRef(/* @__PURE__ */ new Map());
-  const pendingActionsRef = useRef([]);
-  pendingActionsRef.current = pendingActions;
-  const messagesRef = useRef([]);
-  messagesRef.current = messages;
-  const addAssistantMessage = useCallback((message) => {
-    const visibleContent = message.role === "assistant" ? sanitizeVisibleAssistantContent(message.content) : message.content;
-    const candidate = { ...message, content: visibleContent };
-    if (isInternalTraceMessage(candidate)) {
-      recordAppilotsDebugTrace({
-        type: "agent:trace",
-        timestamp: Date.now(),
-        messageId: candidate.id,
-        summary: "Suppressed internal assistant trace from visible chat",
-        data: { role: candidate.role, content: message.content }
-      });
-      const fallback = humanizeAssistantFallback(message.content);
-      if (fallback) {
-        setMessages((prev) => [...prev, { ...candidate, content: fallback }]);
-      }
-      return;
-    }
-    setMessages((prev) => [...prev, candidate]);
-  }, []);
-  const appendLocalSystemMessage = useCallback(
-    (content, metadata) => {
-      if (!content) return;
-      setMessages((prev) => [
-        ...prev,
-        {
-          id: `system_${++messageIdCounter.current}`,
-          role: "system",
-          content,
-          timestamp: Date.now(),
-          ...metadata ? { metadata } : {}
-        }
-      ]);
-    },
-    []
-  );
-  const requestHuman = useCallback(
-    async (reason = "user_requested") => {
-      if (escalationRef.current) return;
-      try {
-        const lastError = messagesRef.current.slice().reverse().find((m) => m.role === "assistant" && m.id.startsWith("error_"));
-        const result = await client.requestEscalation(reason, lastError?.content);
-        setEscalation({ id: result.escalationId, status: result.status });
-        escalationReconnectAttemptRef.current = 0;
-        appendLocalSystemMessage(escalationStrings?.requested ?? "");
-        emit({
-          type: "chat:escalation:start",
-          timestamp: Date.now(),
-          data: { escalationId: result.escalationId, reason }
-        });
-      } catch (err) {
-        setError(err instanceof Error ? err.message : "Failed to request a human");
-      }
-    },
-    [client, emit, appendLocalSystemMessage, escalationStrings]
-  );
-  useEffect(() => {
-    if (!escalation?.id) return;
-    const escalationId = escalation.id;
-    const close = client.openEscalationStream(escalationId, {
-      since: escalationSinceRef.current,
-      onHumanMessage: (message) => {
-        escalationReconnectAttemptRef.current = 0;
-        if (seenHumanMessageIdsRef.current.has(message.id)) return;
-        seenHumanMessageIdsRef.current.add(message.id);
-        escalationSinceRef.current = message.createdAt;
-        setMessages((prev) => [
-          ...prev,
-          {
-            id: message.id,
-            role: "human_agent",
-            content: message.content,
-            timestamp: Date.now()
-          }
-        ]);
-        emit({
-          type: "chat:escalation:message",
-          timestamp: Date.now(),
-          data: { escalationId, messageId: message.id }
-        });
-      },
-      onStatus: (status, operatorName) => {
-        escalationReconnectAttemptRef.current = 0;
-        if (status === "active") {
-          setEscalation((prev) => {
-            if (!prev || prev.id !== escalationId) return prev;
-            if (prev.status === "active") return prev;
-            appendLocalSystemMessage(escalationStrings?.connected ?? "");
-            return { ...prev, status: "active", operatorName };
-          });
-        } else if (status === "resolved") {
-          appendLocalSystemMessage(escalationStrings?.resolved ?? "");
-          setEscalation(null);
-          emit({
-            type: "chat:escalation:end",
-            timestamp: Date.now(),
-            data: { escalationId }
-          });
-        }
-      },
-      onClose: () => {
-        if (!escalationRef.current || escalationRef.current.id !== escalationId) return;
-        const attempt = ++escalationReconnectAttemptRef.current;
-        const delay = Math.min(
-          ESCALATION_RECONNECT_MAX_MS,
-          1e3 * 2 ** Math.min(attempt, 5)
-        );
-        escalationReconnectTimerRef.current = setTimeout(() => {
-          setEscalationStreamEpoch((n) => n + 1);
-        }, delay);
-      }
-    });
-    return () => {
-      if (escalationReconnectTimerRef.current) {
-        clearTimeout(escalationReconnectTimerRef.current);
-        escalationReconnectTimerRef.current = null;
-      }
-      close();
-    };
-  }, [client, emit, appendLocalSystemMessage, escalationStrings, escalation?.id, escalationStreamEpoch]);
-  const sendEscalationMessage = useCallback(
-    async (content) => {
-      const current = escalationRef.current;
-      if (!current) return;
-      const userMessage = {
-        id: `local_${++messageIdCounter.current}`,
-        role: "user",
-        content,
-        timestamp: Date.now()
-      };
-      setMessages((prev) => [...prev, userMessage]);
-      try {
-        await client.sendEscalationMessage(current.id, content);
-      } catch (err) {
-        setError(err instanceof Error ? err.message : "Failed to send message");
-      }
-    },
-    [client]
-  );
-  const beginTurn = useCallback(
-    (assistantMessageId, actions, hop) => {
-      if (!actions || actions.length === 0) {
-        currentTurnRef.current = null;
-        return;
-      }
-      const stamped = actions.map((a) => ({ ...a, messageId: assistantMessageId }));
-      setPendingActions((prev) => [...prev, ...stamped]);
-      const turn = {
-        messageId: assistantMessageId,
-        actionIds: new Set(stamped.map((a) => a.id)),
-        results: /* @__PURE__ */ new Map(),
-        reportedIds: /* @__PURE__ */ new Set(),
-        hop,
-        hadNavigate: stamped.some((a) => a.type === "navigate"),
-        // Snapshot the current screen NOW, before any navigate
-        // dispatches. waitForScreenSettle will use this as the
-        // baseline to detect that the navigate completed.
-        preNavigateScreen: getCurrentScreen(),
-        // Full route+params signature — lets settle detect navigate
-        // to the same route name with different params.
-        preNavigateSignature: getCurrentScreenSignature()
-      };
-      const originScreen = getCurrentScreen() ?? void 0;
-      for (const a of stamped) {
-        turn.results.set(a.id, {
-          type: a.type,
-          success: false,
-          summary: summarizeAction(a),
-          fingerprint: fingerprintAction(a, originScreen)
-        });
-      }
-      currentTurnRef.current = turn;
-      for (const action of stamped) {
-        emit({
-          type: "agent:action:start",
-          timestamp: Date.now(),
-          data: { action }
-        });
-      }
-      if (turnHasConfirmActions(stamped)) {
-        setIsLoading(false);
-        setLoadingStatusKey("thinking");
-      }
-    },
-    [emit]
-  );
-  const registerSynthesizedTurnAction = useCallback((action) => {
-    const turn = currentTurnRef.current;
-    if (!turn || turn.actionIds.has(action.id)) return;
-    const stamped = { ...action, messageId: turn.messageId };
-    turn.actionIds.add(stamped.id);
-    turn.results.set(stamped.id, {
-      type: stamped.type,
-      success: false,
-      summary: summarizeAction(stamped),
-      fingerprint: fingerprintAction(stamped, getCurrentScreen() ?? void 0)
-    });
-    setPendingActions((prev) => {
-      if (prev.some((candidate) => candidate.id === stamped.id)) return prev;
-      return [...prev, stamped];
-    });
-    if (stamped.type === "confirm") {
-      setIsLoading(false);
-      setLoadingStatusKey("thinking");
-    }
-  }, []);
-  const runContinuation = useCallback(
-    async (turn) => {
-      if (continuationInFlightRef.current) return;
-      continuationInFlightRef.current = true;
-      try {
-        setIsLoading(true);
-        setLoadingStatusKey("statusWaitingApp");
-        const toolWithoutEffectIds = /* @__PURE__ */ new Set();
-        let loadingPending = false;
-        const turnActions = pendingActionsRef.current.filter(
-          (a) => turn.actionIds.has(a.id)
-        );
-        const pressedId = extractPressedComponentId(turnActions);
-        const navigateTargetScreen = extractNavigateTargetScreen(turnActions);
-        if (turn.hadNavigate) {
-          const settle = await waitForScreenSettle({
-            expectingChange: true,
-            fromScreen: turn.preNavigateScreen ?? null,
-            fromSignature: turn.preNavigateSignature ?? null,
-            targetScreen: navigateTargetScreen,
-            maxMs: 3500
-          });
-          console.log(
-            `[Appilots] runContinuation: post-navigate settle done \u2014 screen="${settle.screen}" transitioned=${settle.transitioned} timedOut=${settle.timedOut} waitedMs=${settle.waitedMs}`
-          );
-          const navigationMoved = settle.transitioned || screenDepartedBaseline(turn.preNavigateScreen ?? null, turn.preNavigateSignature ?? null) || !!navigateTargetScreen && !!settle.screen && routesBelongToSameFeature(settle.screen, navigateTargetScreen);
-          if (!navigationMoved) {
-            appilotsDebugWarn(
-              `tool-without-effect: navigate emitted but screen did not change (stayed at "${turn.preNavigateScreen ?? "unknown"}", waitedMs=${settle.waitedMs}). Likely causes: target screenName missing from MCP doc, nested-nav path absent, or React Navigation rejected the route.`
-            );
-            for (const actionId of turn.actionIds) {
-              const r = turn.results.get(actionId);
-              if (r && r.type === "navigate") {
-                toolWithoutEffectIds.add(actionId);
-              }
-            }
-          }
-          const loadSettle = await waitForLoadingSettle({
-            fromScreen: settle.screen ?? null,
-            maxMs: 3e3
-          });
-          console.log(
-            `[Appilots] runContinuation: post-navigate loading settle \u2014 settled=${loadSettle.settled} loadingPending=${loadSettle.loadingPending} probes=${loadSettle.probeCount} waitedMs=${loadSettle.waitedMs}`
-          );
-          if (loadSettle.loadingPending) loadingPending = true;
-        } else {
-          const pressedAction = turnActions.find(
-            (a) => a.type === "ui_interaction" && a.payload?.componentId === pressedId
-          );
-          const hints = resolveActionHints(
-            getCurrentScreen(),
-            pressedId,
-            pressedAction?.payload
-          );
-          const settleCapMs = hints?.isAsyncTrigger === true ? 1e4 : POST_ACTION_LOADING_MAX_MS;
-          const loadSettle = await waitForLoadingSettle({
-            pressedComponentId: pressedId,
-            fromScreen: getCurrentScreen(),
-            maxMs: settleCapMs
-          });
-          console.log(
-            `[Appilots] runContinuation: 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) => {
-            const target = actionPressTargetId(action);
-            return target ? isListItemPressTarget(target) : false;
-          });
-          if (listPressActions.length > 0) {
-            const baselineFingerprint = probeLoadingState(
-              pressedId,
-              getCurrentScreen()
-            ).fingerprint;
-            const postPressSettle = await waitForScreenSettle({
-              expectingChange: true,
-              fromScreen: turn.preNavigateScreen ?? null,
-              fromSignature: turn.preNavigateSignature ?? null,
-              maxMs: 2500
-            });
-            await waitForLoadingSettle({
-              pressedComponentId: pressedId,
-              fromScreen: getCurrentScreen(),
-              maxMs: 4e3
-            });
-            const afterFingerprint = probeLoadingState(
-              pressedId,
-              getCurrentScreen()
-            ).fingerprint;
-            console.log(
-              `[Appilots] runContinuation: 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) {
-                const result = turn.results.get(action.id);
-                if (result?.success) {
-                  toolWithoutEffectIds.add(action.id);
-                }
-              }
-            }
-          }
-        }
-        const context = buildAgentContext({ loadingPending });
-        const snap = context.snapshot;
-        const activePath = context.navigationState?.activePath ?? [];
-        for (const action of turnActions) {
-          const result = turn.results.get(action.id);
-          if (result?.success && formFillLackedWriteEffect(action, snap, activePath)) {
-            toolWithoutEffectIds.add(action.id);
-            appilotsDebugWarn(
-              `tool-without-effect: form_fill succeeded but create form is still open (actionId="${action.id}")`
-            );
-          }
-        }
-        const results = Array.from(turn.actionIds).map((actionId) => {
-          const r = turn.results.get(actionId);
-          if (!r) {
-            return {
-              actionId,
-              type: "unknown",
-              success: false,
-              error: "no result reported",
-              summary: actionId,
-              diagnose: void 0,
-              recoveryAttempt: 0,
-              recoveryExhausted: false,
-              toolWithoutEffect: false,
-              effect: "unknown"
-            };
-          }
-          const hasToolWithoutEffect = toolWithoutEffectIds.has(actionId);
-          let recoveryAttempt = 0;
-          let recoveryExhausted = false;
-          if (!r.success || hasToolWithoutEffect) {
-            const counts = recoveryCountByFingerprintRef.current;
-            const previous = counts.get(r.fingerprint) ?? 0;
-            const next = previous + 1;
-            counts.set(r.fingerprint, next);
-            recoveryAttempt = next;
-            recoveryExhausted = next >= MAX_RECOVERY_ATTEMPTS_PER_ACTION;
-          }
-          return {
-            actionId,
-            type: r.type,
-            success: r.success,
-            error: r.error,
-            summary: r.summary,
-            diagnose: r.diagnose,
-            recoveryAttempt,
-            recoveryExhausted,
-            toolWithoutEffect: hasToolWithoutEffect,
-            effect: hasToolWithoutEffect ? "none" : r.effect,
-            userVisibleStatusKey: r.userVisibleStatusKey
-          };
-        });
-        const exhausted = results.filter((r) => r.recoveryExhausted);
-        setLoadingStatusKey(
-          results.some((r) => !r.success || r.toolWithoutEffect) ? "statusAdjusting" : "statusAnalyzing"
-        );
-        console.log(
-          `[Appilots] useAppilotsChat: running continuation hop=${turn.hop} (${results.filter((r) => r.success).length}/${results.length} succeeded` + (exhausted.length > 0 ? `, ${exhausted.length} recovery-exhausted` : "") + ")"
-        );
-        const response = await client.continueAgent(results, context, turn.hop);
-        addAssistantMessage(response.message);
-        emit({
-          type: "agent:message",
-          timestamp: Date.now(),
-          data: { message: response.message, usage: response.usage }
-        });
-        if (response.isDone || !response.actions || response.actions.length === 0) {
-          currentTurnRef.current = null;
-          setIsLoading(false);
-          setLoadingStatusKey("thinking");
-          return;
-        }
-        beginTurn(response.message.id, response.actions, response.hop);
-      } catch (err) {
-        const raw = err instanceof Error ? err.message : "Continuation failed";
-        appilotsDebugWarn("useAppilotsChat: continuation failed \u2014", raw);
-        const recentUserTexts = messagesRef.current.filter((m) => m.role === "user").slice(-4).map((m) => m.content);
-        const friendly = buildContinuationFailureMessage(raw, recentUserTexts);
-        addAssistantMessage({
-          id: `error_${++messageIdCounter.current}`,
-          role: "assistant",
-          content: friendly,
-          timestamp: Date.now()
-        });
-        if (!escalationRef.current && escalationStrings?.offer) {
-          appendLocalSystemMessage(escalationStrings.offer, { escalationOffer: true });
-        }
-        if (turn) {
-          setPendingActions(
-            (prev) => prev.map(
-              (a) => turn.actionIds.has(a.id) && (a.status === "pending" || a.status === "executing") ? { ...a, status: "failed", error: friendly } : a
-            )
-          );
-          for (const actionId of turn.actionIds) {
-            if (turn.reportedIds.has(actionId)) continue;
-            emit({
-              type: "agent:action:error",
-              timestamp: Date.now(),
-              data: { actionId, error: friendly, abandoned: true }
-            });
-          }
-        }
-        currentTurnRef.current = null;
-        setIsLoading(false);
-        setLoadingStatusKey("thinking");
-      } finally {
-        continuationInFlightRef.current = false;
-      }
-    },
-    [client, emit, addAssistantMessage, beginTurn]
-  );
-  useEffect(() => {
-    return subscribe((event) => {
-      if (event.type === "agent:action:start") {
-        const action = event.data?.action;
-        if (!action?.id || action.type !== "confirm") return;
-        const injectedBy = action.payload?.injectedBy;
-        if (injectedBy !== "sdk-local") return;
-        registerSynthesizedTurnAction(action);
-        return;
-      }
-      if (event.type !== "agent:action:complete" && event.type !== "agent:action:error") return;
-      const turn = currentTurnRef.current;
-      if (!turn) return;
-      const actionId = event.data?.actionId;
-      if (!actionId || !turn.actionIds.has(actionId)) return;
-      if (turn.reportedIds.has(actionId)) return;
-      const success = event.type === "agent:action:complete";
-      const errorMsg = event.data?.error || void 0;
-      const diagnose = event.data?.diagnose;
-      const effect = event.data?.effect;
-      const userVisibleStatusKey = event.data?.userVisibleStatusKey;
-      const existing = turn.results.get(actionId);
-      if (existing) {
-        existing.success = success;
-        existing.error = errorMsg;
-        existing.diagnose = diagnose;
-        existing.effect = effect;
-        existing.userVisibleStatusKey = userVisibleStatusKey;
-      }
-      turn.reportedIds.add(actionId);
-      if (turn.reportedIds.size >= turn.actionIds.size) {
-        void runContinuation(turn);
-      }
-    });
-  }, [subscribe, runContinuation, registerSynthesizedTurnAction]);
-  const sendMessage = useCallback(
-    async (content) => {
-      if (!content.trim() || isLoading) return;
-      if (escalationRef.current) {
-        await sendEscalationMessage(content.trim());
-        return;
-      }
-      setError(null);
-      setIsLoading(true);
-      setLoadingStatusKey("statusAnalyzing");
-      currentTurnRef.current = null;
-      recoveryCountByFingerprintRef.current = /* @__PURE__ */ new Map();
-      const userMessage = {
-        id: `local_${++messageIdCounter.current}`,
-        role: "user",
-        content: content.trim(),
-        timestamp: Date.now()
-      };
-      setMessages((prev) => [...prev, userMessage]);
-      const streamingId = `streaming_${++messageIdCounter.current}`;
-      let streamedVisible = false;
-      const removeStreamingPlaceholder = () => {
-        if (!streamedVisible) return;
-        streamedVisible = false;
-        setMessages((prev) => prev.filter((m) => m.id !== streamingId));
-      };
-      const abortController = new AbortController();
-      abortRef.current = abortController;
-      try {
-        const context = buildAgentContext();
-        console.log(
-          `[Appilots] useAppilotsChat sendMessage: context \u2014 currentScreen="${context.currentScreen ?? "unknown"}", snapshot={texts:${context.snapshot?.texts?.length ?? 0}, inputs:${context.snapshot?.inputs?.length ?? 0}, buttons:${context.snapshot?.buttons?.length ?? 0}, elements:${context.snapshot?.elements?.length ?? 0}, lists:${context.snapshot?.lists?.length ?? 0}, listItems:${(context.snapshot?.lists ?? []).reduce((acc, l) => acc + (l.items?.length ?? 0), 0)}, choiceGroups:${context.snapshot?.choiceGroups?.length ?? 0}}`
-        );
-        let response;
-        if (streamingEnabled) {
-          try {
-            response = await client.sendMessageStream(content.trim(), context, {
-              signal: abortController.signal,
-              onTextDelta: (_chunk, fullText) => {
-                const visible = sanitizeVisibleAssistantContent(fullText);
-                if (!streamedVisible) {
-                  streamedVisible = true;
-                  setMessages((prev) => [
-                    ...prev,
-                    { id: streamingId, role: "assistant", content: visible, timestamp: Date.now() }
-                  ]);
-                } else {
-                  setMessages(
-                    (prev) => prev.map((m) => m.id === streamingId ? { ...m, content: visible } : m)
-                  );
-                }
-              }
-            });
-          } catch (err) {
-            if (err instanceof StreamTransportError) {
-              console.warn(`[Appilots] streaming unavailable, falling back to JSON: ${err.message}`);
-              response = await client.sendMessage(content.trim(), context);
-            } else {
-              throw err;
-            }
-          }
-        } else {
-          response = await client.sendMessage(content.trim(), context);
-        }
-        console.log(
-          `[Appilots] useAppilotsChat sendMessage: response received \u2014 actions=${response.actions?.length ?? 0}, hasSummary=${!!response.summaryMessage}`
-        );
-        removeStreamingPlaceholder();
-        addAssistantMessage(response.message);
-        beginTurn(response.message.id, response.actions, 1);
-        if (response.summaryMessage) {
-          addAssistantMessage(response.summaryMessage);
-        }
-        emit({
-          type: "agent:message",
-          timestamp: Date.now(),
-          data: { message: response.message, usage: response.usage }
-        });
-        if (!response.actions || response.actions.length === 0) {
-          setIsLoading(false);
-          setLoadingStatusKey("thinking");
-        }
-      } catch (err) {
-        if (err instanceof StreamAbortError || err instanceof Error && err.name === "AbortError") {
-          setIsLoading(false);
-          setLoadingStatusKey("thinking");
-          return;
-        }
-        removeStreamingPlaceholder();
-        const errorMessage = err instanceof Error ? err.message : "Failed to send message";
-        setError(errorMessage);
-        const errorMsg = {
-          id: `error_${++messageIdCounter.current}`,
-          role: "assistant",
-          content: `${errorPrefix}: ${errorMessage}`,
-          timestamp: Date.now()
-        };
-        addAssistantMessage(errorMsg);
-        setIsLoading(false);
-        setLoadingStatusKey("thinking");
-      } finally {
-        if (abortRef.current === abortController) {
-          abortRef.current = null;
-        }
+    else if (matchesName2(fiber, "Switch")) kind = "toggle";
+    else if (isPressableTarget2(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);
+        if (kind === "field") bestHandle = wrapTextInput(fiber);
+        else if (kind === "toggle") bestHandle = wrapSwitch(fiber);
+        else bestHandle = wrapTouchable(fiber, findChildText2(fiber));
       }
-    },
-    [client, emit, isLoading, addAssistantMessage, beginTurn, errorPrefix, streamingEnabled]
-  );
-  const cancelMessage = useCallback(() => {
-    abortRef.current?.abort();
-  }, []);
-  const clearMessages = useCallback(() => {
-    setMessages([]);
-    setPendingActions([]);
-    setError(null);
-    setIsLoading(false);
-    setLoadingStatusKey("thinking");
-    currentTurnRef.current = null;
-    continuationInFlightRef.current = false;
-    recoveryCountByFingerprintRef.current = /* @__PURE__ */ new Map();
-    if (escalationRef.current) {
-      void client.abandonEscalation(escalationRef.current.id);
     }
-    setEscalation(null);
-    escalationSinceRef.current = void 0;
-    seenHumanMessageIdsRef.current = /* @__PURE__ */ new Set();
-    escalationReconnectAttemptRef.current = 0;
-    client.destroySession();
-  }, [client]);
-  const clearError = useCallback(() => setError(null), []);
-  return {
-    messages,
-    isLoading,
-    loadingStatusKey,
-    error,
-    pendingActions,
-    escalation,
-    requestHuman,
-    sendMessage,
-    cancelMessage,
-    clearMessages,
-    clearError
-  };
+    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}`
+    );
+  } else {
+    console.log(`[Appilots] findInteractiveByIdentifier: query="${query}" \u2192 no match`);
+  }
+  return bestHandle;
 }
 
 // src/executor/handlers/navigateHandler.ts
@@ -2229,7 +1196,7 @@ function markedItemIndexFromFiber(fiber) {
   const value = fiber?.memoizedProps?.__appilotsItemIndex;
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
-function normalize4(value) {
+function normalize2(value) {
   return String(value ?? "").toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "");
 }
 function hasPressHandler3(fiber) {
@@ -2488,9 +1455,9 @@ function pressResolvedListItem(list, itemFiber, listIndex, itemIndex) {
   }
 }
 function itemTextScore(item, locator) {
-  const needles = [locator.label, ...locator.texts ?? []].map(normalize4).filter((text) => text.length >= 2);
+  const needles = [locator.label, ...locator.texts ?? []].map(normalize2).filter((text) => text.length >= 2);
   if (needles.length === 0) return 0;
-  const haystack = collectTexts(item).map(normalize4).filter(Boolean);
+  const haystack = collectTexts(item).map(normalize2).filter(Boolean);
   if (haystack.length === 0) return 0;
   let score = 0;
   for (const needle of needles) {
@@ -2508,11 +1475,11 @@ function scoreItemCandidate(item, zeroBasedIndex, locator) {
   const markedIndex = markedItemIndexFromFiber(item);
   if (locator.itemKey) {
     if (itemKey === locator.itemKey) score += 1e3;
-    else if (itemKey && normalize4(itemKey) === normalize4(locator.itemKey)) score += 950;
+    else if (itemKey && normalize2(itemKey) === normalize2(locator.itemKey)) score += 950;
   }
   if (locator.reactKey) {
     if (reactKey === locator.reactKey) score += 900;
-    else if (reactKey && normalize4(reactKey) === normalize4(locator.reactKey)) score += 850;
+    else if (reactKey && normalize2(reactKey) === normalize2(locator.reactKey)) score += 850;
   }
   if (locator.itemIndex && zeroBasedIndex === locator.itemIndex - 1) score += 750;
   if (locator.itemIndex && markedIndex !== void 0 && (markedIndex === locator.itemIndex || markedIndex === locator.itemIndex - 1)) {
@@ -2523,8 +1490,8 @@ function scoreItemCandidate(item, zeroBasedIndex, locator) {
 }
 function candidateLists(containers, locator) {
   if (locator.listId) {
-    const normalizedId = normalize4(locator.listId);
-    const matches = containers.map((list, listIndex) => ({ list, listIndex })).filter(({ list }) => normalize4(list.listId) === normalizedId);
+    const normalizedId = normalize2(locator.listId);
+    const matches = containers.map((list, listIndex) => ({ list, listIndex })).filter(({ list }) => normalize2(list.listId) === normalizedId);
     if (matches.length > 0) return matches;
   }
   if (typeof locator.listIndex === "number") {
@@ -2532,8 +1499,8 @@ function candidateLists(containers, locator) {
     return list ? [{ list, listIndex: locator.listIndex }] : [];
   }
   if (locator.listLabel) {
-    const normalizedLabel = normalize4(locator.listLabel);
-    const matches = containers.map((list, listIndex) => ({ list, listIndex })).filter(({ list }) => normalize4(list.listLabel).includes(normalizedLabel));
+    const normalizedLabel = normalize2(locator.listLabel);
+    const matches = containers.map((list, listIndex) => ({ list, listIndex })).filter(({ list }) => normalize2(list.listLabel).includes(normalizedLabel));
     if (matches.length > 0) return matches;
   }
   return containers.map((list, listIndex) => ({ list, listIndex }));
@@ -2869,7 +1836,7 @@ 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 normalize5(value) {
+function normalize4(value) {
   return value.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]/g, "");
 }
 function resolveScreenForFormFields() {
@@ -2909,14 +1876,14 @@ function collectKnownFormFields(registry) {
   return registryFields;
 }
 function fieldHaystack(field) {
-  return normalize5(`${field.id} ${field.label ?? ""}`);
+  return normalize4(`${field.id} ${field.label ?? ""}`);
 }
 function isMisplacedFieldId(fieldId, knownIds) {
   const trimmed = fieldId.trim();
   if (!trimmed) return true;
   if (LIST_ORDINAL_RE.test(trimmed)) return true;
   if (/^\d+$/.test(trimmed)) return true;
-  const normalized = normalize5(trimmed);
+  const normalized = normalize4(trimmed);
   if (knownIds.has(normalized)) return false;
   for (const known of knownIds) {
     if (known.length >= 4 && (known.includes(normalized) || normalized.includes(known))) {
@@ -2926,18 +1893,18 @@ function isMisplacedFieldId(fieldId, knownIds) {
   return true;
 }
 function valueMatchesOption(field, rawValue) {
-  const value = normalize5(String(rawValue ?? ""));
+  const value = normalize4(String(rawValue ?? ""));
   if (!value || !Array.isArray(field.options)) return false;
   return field.options.some((option) => {
-    const label = normalize5(option.label ?? "");
-    const optionValue = normalize5(option.value ?? "");
+    const label = normalize4(option.label ?? "");
+    const optionValue = normalize4(option.value ?? "");
     return label === value || optionValue === value || value.includes(label) || value.includes(optionValue);
   });
 }
 function inferFieldIdForValue(rawValue, fields, used) {
   const value = String(rawValue ?? "").trim();
   if (!value) return void 0;
-  const normalizedValue = normalize5(value);
+  const normalizedValue = normalize4(value);
   for (const field of fields) {
     if (used.has(field.id)) continue;
     if (valueMatchesOption(field, value)) return field.id;
@@ -2974,7 +1941,7 @@ function inferFieldIdForValue(rawValue, fields, used) {
   }
   const nextText = fields.find((field) => {
     if (used.has(field.id)) return false;
-    const type = normalize5(field.type ?? "text");
+    const type = normalize4(field.type ?? "text");
     return type === "text" || type === "input" || type === "number" || type === "";
   });
   return nextText?.id;
@@ -2982,7 +1949,7 @@ function inferFieldIdForValue(rawValue, fields, used) {
 function rewriteMisplacedFormFillFields(fields, registry) {
   const knownFields = collectKnownFormFields(registry);
   if (knownFields.length === 0) return fields;
-  const knownIds = new Set(knownFields.map((field) => normalize5(field.id)));
+  const knownIds = new Set(knownFields.map((field) => normalize4(field.id)));
   const needsRewrite = fields.some((field) => isMisplacedFieldId(field.fieldId, knownIds));
   if (!needsRewrite) return fields;
   const used = /* @__PURE__ */ new Set();
@@ -3002,7 +1969,7 @@ function rewriteMisplacedFormFillFields(fields, registry) {
 }
 
 // src/executor/formValidation.ts
-var FORM_VALIDATION_TEXT_RE2 = /(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_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 sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var FIELD_HINTS = [
@@ -3022,7 +1989,7 @@ function inferValidationFieldId(message) {
 function readVisibleFormValidation(snap) {
   if (!snap) return void 0;
   for (const text of snap.texts ?? []) {
-    if (!text?.trim() || !FORM_VALIDATION_TEXT_RE2.test(text)) continue;
+    if (!text?.trim() || !FORM_VALIDATION_TEXT_RE.test(text)) continue;
     return { fieldId: inferValidationFieldId(text), message: text };
   }
   return void 0;
@@ -3668,18 +2635,18 @@ function uiInteractionHandler(payload, context) {
 // src/executor/formSubmitResolve.ts
 var SUBMIT_LABEL_HINT_RE = /\b(submit|save|send|continue|next|sign\s*in|log\s*in|register|salvar|enviar|entrar|cadastrar|continuar|proximo|próximo|avancar|avançar|confirmar|guardar|registrarse|iniciar\s+sesi[óo]n|enregistrer|envoyer|valider|soumettre|confirmer|se\s+connecter|s['e]\s*inscrire)\b/i;
 var AGENT_CHROME_TARGET_RE = /\b(fechar|close|dismiss|cancelar|cancel|limpar|clear|chat\s+do\s+assistente|assistant\s+chat)\b/i;
-function normalize6(value) {
+function normalize5(value) {
   return value.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
 }
 function isAgentChromeTarget(id, label) {
-  const hay = normalize6(`${id ?? ""} ${label ?? ""}`);
+  const hay = normalize5(`${id ?? ""} ${label ?? ""}`);
   return AGENT_CHROME_TARGET_RE.test(hay);
 }
 function isSubmitLikeTarget(id, label) {
   if (!id && !label) return false;
   if (isAgentChromeTarget(id, label)) return false;
-  const idNorm = normalize6(id ?? "");
-  normalize6(label ?? "");
+  const idNorm = normalize5(id ?? "");
+  normalize5(label ?? "");
   if (/^submit[-_]/i.test(id ?? "")) return true;
   if (submitLabelHintsSubmit(label ?? "")) return true;
   if (submitLabelHintsSubmit(id ?? "")) return true;
@@ -3778,7 +2745,7 @@ function readVisibleValidation(fieldId, label) {
     );
     for (const text of texts) {
       const lower = text.toLowerCase();
-      if (FORM_VALIDATION_TEXT_RE2.test(lower)) {
+      if (FORM_VALIDATION_TEXT_RE.test(lower)) {
         for (const needle of needles) {
           if (lower.includes(needle.toLowerCase())) return text;
         }
@@ -3798,15 +2765,15 @@ function selectValueApplied(fieldId, requestedValue, currentValue, registry) {
   if (!requested) return false;
   const meta = getMetadataField(fieldId, registry);
   const options = Array.isArray(meta?.options) ? meta.options : [];
-  const requestedNorm = normalize2(requested);
-  const currentNorm = normalize2(currentValue);
+  const requestedNorm = normalize3(requested);
+  const currentNorm = normalize3(currentValue);
   if (currentNorm === requestedNorm) return true;
   for (const option of options) {
     const value = typeof option?.value === "string" ? option.value : "";
     const label = typeof option?.label === "string" ? option.label : "";
-    if (normalize2(value) === requestedNorm && normalize2(label) === currentNorm) return true;
-    if (normalize2(label) === requestedNorm && normalize2(label) === currentNorm) return true;
-    if (normalize2(value) === requestedNorm && normalize2(value) === currentNorm) return true;
+    if (normalize3(value) === requestedNorm && normalize3(label) === currentNorm) return true;
+    if (normalize3(label) === requestedNorm && normalize3(label) === currentNorm) return true;
+    if (normalize3(value) === requestedNorm && normalize3(value) === currentNorm) return true;
   }
   return false;
 }
@@ -3820,14 +2787,14 @@ function getMetadataField(fieldId, registry) {
       if (comp.kind === "field" && comp.screen) screens.add(comp.screen);
     }
   }
-  const needle = normalize2(fieldId);
+  const needle = normalize3(fieldId);
   for (const screenName of screens) {
     const screenMeta = getScreenMetadata(screenName);
     const fields = Array.isArray(screenMeta?.fields) ? screenMeta.fields : [];
     const match = fields.find((field) => {
       if (!field || typeof field !== "object") return false;
-      const id = typeof field.id === "string" ? normalize2(field.id) : "";
-      const label = typeof field.label === "string" ? normalize2(field.label) : "";
+      const id = typeof field.id === "string" ? normalize3(field.id) : "";
+      const label = typeof field.label === "string" ? normalize3(field.label) : "";
       return id === needle || label === needle;
     });
     if (match) return match;
@@ -3839,11 +2806,11 @@ function resolveSelectOption(fieldId, value, registry) {
   if (!requested) return void 0;
   const meta = getMetadataField(fieldId, registry);
   const options = Array.isArray(meta?.options) ? meta.options : [];
-  const requestedNorm = normalize2(requested);
+  const requestedNorm = normalize3(requested);
   for (const option of options) {
     const optionValue = typeof option?.value === "string" ? option.value : "";
     const optionLabel = typeof option?.label === "string" ? option.label : "";
-    if (normalize2(optionValue) === requestedNorm || normalize2(optionLabel) === requestedNorm) {
+    if (normalize3(optionValue) === requestedNorm || normalize3(optionLabel) === requestedNorm) {
       return { value: optionValue, label: optionLabel };
     }
   }
@@ -3898,7 +2865,7 @@ async function tryPressSelectOption(fieldId, value, registry, options = {}) {
 }
 function normalizeFieldType(type) {
   if (typeof type !== "string") return void 0;
-  const normalized = normalize2(type);
+  const normalized = normalize3(type);
   if (normalized === "select" || normalized === "picker" || normalized === "dropdown") return "select";
   if (normalized === "toggle" || normalized === "switch" || normalized === "checkbox") return "toggle";
   if (normalized === "date") return "date";
@@ -3926,7 +2893,7 @@ function fieldCueTerms(fieldId, label) {
   );
   const terms = /* @__PURE__ */ new Set();
   for (const value of raw) {
-    const normalized = normalize2(value);
+    const normalized = normalize3(value);
     if (normalized.length >= 3 && normalized !== "id") terms.add(normalized);
   }
   return [...terms];
@@ -3937,15 +2904,15 @@ function snapshotHasFieldCue(snap, fieldId, label) {
   const visible = [
     ...snap.texts ?? [],
     ...(snap.buttons ?? []).map((b) => b.label ?? b.id ?? "")
-  ].map((text) => normalize2(text)).filter(Boolean);
+  ].map((text) => normalize3(text)).filter(Boolean);
   return visible.some((text) => terms.some((term) => text.includes(term) || term.includes(text)));
 }
 function scoreCandidateText(value, texts) {
-  const valueNorm = normalize2(String(value ?? ""));
+  const valueNorm = normalize3(String(value ?? ""));
   if (!valueNorm) return 0;
   let best = 0;
   for (const text of texts) {
-    const textNorm = normalize2(text);
+    const textNorm = normalize3(text);
     if (!textNorm) continue;
     best = Math.max(best, matchScore(valueNorm, textNorm));
   }
@@ -3973,7 +2940,7 @@ function buildChoiceCandidates(snap, fieldId, value, allowFirstVisibleWhenNoCue,
     const groupCueScore = Math.max(
       globalCueScore,
       ...groupTexts.map((text) => {
-        const normalized = normalize2(text);
+        const normalized = normalize3(text);
         return fieldCueTerms(fieldId, fieldLabel).some(
           (term) => normalized.includes(term) || term.includes(normalized)
         ) ? 80 : 0;
@@ -4010,7 +2977,7 @@ function buildChoiceCandidates(snap, fieldId, value, allowFirstVisibleWhenNoCue,
       const elementCueScore = Math.max(
         fieldCueVisible && elements.length <= 12 ? 50 : 0,
         ...cueTexts.map((text) => {
-          const normalized = normalize2(text);
+          const normalized = normalize3(text);
           return fieldTerms.some(
             (term) => normalized.includes(term) || term.includes(normalized)
           ) ? 80 : 0;
@@ -4098,7 +3065,7 @@ async function selectVisibleChoiceAsync(fieldId, value, registry, options) {
 }
 function isContinuationButton(label) {
   if (!label) return false;
-  return /^(next|continue|proximo|prox|continuar|avancar|avançar)$/i.test(normalize2(label));
+  return /^(next|continue|proximo|prox|continuar|avancar|avançar)$/i.test(normalize3(label));
 }
 function pressContinuationButton(registry) {
   const snap = captureSnapshot();
@@ -4132,14 +3099,14 @@ function findField(fieldId, registry) {
     }
   }
   const currentScreenForTieBreak = getCurrentScreen();
-  const needle = normalize2(fieldId);
+  const needle = normalize3(fieldId);
   let bestComp;
   let bestScore = 0;
   let bestOnCurrentScreen = false;
   for (const comp of snapshot) {
     if (comp.kind !== "field") continue;
-    const candidates = [normalize2(comp.id)];
-    if (comp.label) candidates.push(normalize2(comp.label));
+    const candidates = [normalize3(comp.id)];
+    if (comp.label) candidates.push(normalize3(comp.label));
     let candidateScore = 0;
     for (const cand of candidates) {
       const s = matchScore(needle, cand);
@@ -4170,12 +3137,12 @@ function findField(fieldId, registry) {
       );
       if (metaField && typeof metaField === "object" && metaField.label) {
         const metaLabel = metaField.label;
-        const metaNeedle = normalize2(metaLabel);
+        const metaNeedle = normalize3(metaLabel);
         let mBest;
         let mBestScore = 0;
         for (const comp of snapshot) {
           if (comp.kind !== "field" || !comp.label) continue;
-          const score = matchScore(metaNeedle, normalize2(comp.label));
+          const score = matchScore(metaNeedle, normalize3(comp.label));
           if (score > mBestScore) {
             mBestScore = score;
             mBest = comp;
@@ -4300,7 +3267,9 @@ async function formFillHandler(payload, context) {
     const fieldEntry = findField(fieldId, registry);
     if (fieldEntry) {
       try {
-        console.log(`[Appilots] formFillHandler: found field "${fieldId}" via registry, calling setValue("${value}")`);
+        appilotsDebugLog(
+          `formFillHandler: found field "${fieldId}" via registry, calling setValue(<${String(value).length} chars>)`
+        );
         const beforeValue = effectiveFieldType === "date" ? fieldEntry.getValue?.() ?? "" : void 0;
         fieldEntry.focus?.();
         fieldEntry.setValue(String(value));
@@ -4330,7 +3299,7 @@ async function formFillHandler(payload, context) {
           }
           if (!selectValueApplied(fieldId, value, after, registry)) {
             appilotsDebugWarn(
-              `formFillHandler: select field "${fieldId}" setValue("${value}") did not stick (current="${after}"), trying visible choice fallback`
+              `formFillHandler: select field "${fieldId}" setValue did not stick (wrote <${String(value).length} chars>, current is <${String(after ?? "").length} chars>), trying visible choice fallback`
             );
             const selectResult = await selectVisibleChoice(fieldId, value, registry, {
               allowFirstVisibleWhenNoCue: !selectedChoiceThisBatch
@@ -4993,79 +3962,156 @@ async function executeAction(action, context) {
   });
   return result;
 }
-var DEFAULT_PERMISSIONS2 = {
-  canNavigate: true,
-  canFillForms: true,
-  canInteractUI: true,
-  canSubmitForms: true
-};
-function readPayload(action) {
-  return action.payload ?? {};
-}
-function isStructuredRisky(value) {
-  return value === true || value === "destructive" || value === "danger" || value === "high";
+var POST_ACTION_LOADING_MAX_MS = 6e3;
+function resolveScreenMetadata() {
+  const activePath = getActiveRouteNames();
+  for (let i = activePath.length - 1; i >= 0; i--) {
+    const name = activePath[i];
+    const meta = name ? getScreenMetadata(name) : void 0;
+    if (meta && (Array.isArray(meta.fields) && meta.fields.length > 0 || Array.isArray(meta.actions) && meta.actions.length > 0)) {
+      return meta;
+    }
+  }
+  const screen = getCurrentScreen();
+  return screen ? getScreenMetadata(screen) : void 0;
 }
-function actionMetadataRequiresConfirmation(meta) {
-  if (meta.requiresConfirmation === true || meta.destructive === true || meta.effect === "destructive" || meta.riskLevel === "high" || meta.risk === "destructive") {
-    return { required: true, label: meta.label, source: "screen-metadata" };
+function buildAgentContext(extras = {}) {
+  const context = {};
+  context.platform = "react-native";
+  const screen = getCurrentScreen();
+  if (screen) context.currentScreen = screen;
+  const navigationState = getNavigationStateSnapshot();
+  if (navigationState) context.navigationState = navigationState;
+  const screenMeta = resolveScreenMetadata();
+  if (screenMeta) context.screenMetadata = screenMeta;
+  try {
+    context.snapshot = captureSnapshot();
+  } catch (err) {
+    appilotsDebugWarn("buildAgentContext: captureSnapshot failed", err);
+  }
+  const registry = componentRegistry.snapshot();
+  const filtered = screen ? registry.filter((c) => !c.screen || c.screen === screen) : registry;
+  if (filtered.length > 0) context.registeredComponents = filtered;
+  const registeredLists = listRegistry.snapshot();
+  if (registeredLists.length > 0) {
+    context.registeredLists = registeredLists.map(
+      ({ scrollToIndex, scrollToOffset, getScrollMetrics, dataPreview, ...rest }) => rest
+    );
   }
-  return { required: false };
+  if (extras.loadingPending === true) context.loadingPending = true;
+  return context;
 }
-function payloadRequiresConfirmation(action) {
-  const payload = readPayload(action);
-  if (action.destructive === true || payload.destructive === true || payload.requiresConfirmation === true || isStructuredRisky(payload.effect) || isStructuredRisky(payload.risk) || isStructuredRisky(payload.riskLevel) || isStructuredRisky(payload.actionRisk)) {
-    return {
-      required: true,
-      label: typeof payload.actionDescription === "string" && payload.actionDescription || typeof payload.label === "string" && payload.label || void 0,
-      source: "action-policy"
-    };
+function resolveActionHints(screen, pressedComponentId, actionPayload) {
+  if (actionPayload && typeof actionPayload === "object") {
+    const inline = actionPayload._appilotsInferred;
+    if (inline && typeof inline === "object") {
+      return inline;
+    }
   }
-  const policy = payload._appilotsPolicy;
-  if (policy && typeof policy === "object") {
-    const p = policy;
-    if (p.requiresConfirmation === true || isStructuredRisky(p.effect) || isStructuredRisky(p.risk) || isStructuredRisky(p.riskLevel)) {
-      return {
-        required: true,
-        label: typeof p.summary === "string" ? p.summary : void 0,
-        source: "inline-policy"
-      };
+  if (!screen || !pressedComponentId) return void 0;
+  const meta = getScreenMetadata(screen);
+  const actions = meta?.actions;
+  if (!actions || actions.length === 0) return void 0;
+  for (const a of actions) {
+    if (typeof a === "string") continue;
+    if (idLooselyMatches(a.id, pressedComponentId)) {
+      const inferred = a.appilotsInferred;
+      if (inferred && typeof inferred === "object") return inferred;
+      return void 0;
     }
   }
-  return { required: false };
-}
-function isConfirmGateFor(confirm, target) {
-  if (confirm.type !== "confirm") return false;
-  const payload = readPayload(confirm);
-  const injectedBy = payload.injectedBy;
-  return payload.gatedActionId === target.id && (injectedBy === "permissions" || injectedBy === "sdk-local");
-}
-function toDestructiveConfirmPayload(confirm, policy, fallbackLabel) {
-  const payload = readPayload(confirm);
-  const existingDescription = typeof payload.actionDescription === "string" && payload.actionDescription ? payload.actionDescription : void 0;
-  const labelText = policy.label ?? existingDescription ?? fallbackLabel ?? "esta a\xE7\xE3o";
-  return {
-    ...payload,
-    title: "A\xE7\xE3o destrutiva",
-    message: `Tem certeza que deseja "${labelText}"?`,
-    actionDescription: labelText,
-    severity: "danger",
-    destructive: true,
-    confirmLabel: typeof payload.confirmLabel === "string" && payload.confirmLabel ? payload.confirmLabel : "Sim, executar",
-    cancelLabel: typeof payload.cancelLabel === "string" && payload.cancelLabel ? payload.cancelLabel : "Cancelar"
-  };
-}
-function confirmNeedsDestructiveUpgrade(confirm) {
-  const payload = readPayload(confirm);
-  return confirm.destructive !== true || payload.destructive !== true || payload.severity !== "danger";
+  return void 0;
 }
-function actionHasCompletedConfirmGate(action, actions) {
-  return actions.some((candidate) => {
-    if (!isConfirmGateFor(candidate, action)) return false;
-    if (candidate.status !== "completed") return false;
-    const payload = readPayload(candidate);
-    return payload.destructive === true || payload.severity === "danger";
-  });
+async function settleTurn(input) {
+  const toolWithoutEffectIds = /* @__PURE__ */ new Set();
+  let loadingPending = false;
+  const { turnActions, pressedComponentId: pressedId, navigateTargetScreen } = input;
+  const successById = new Map(input.results.map((r) => [r.actionId, r.success]));
+  const typeById = new Map(input.results.map((r) => [r.actionId, r.type]));
+  if (input.hadNavigate) {
+    const settle = await waitForScreenSettle({
+      expectingChange: true,
+      fromScreen: input.preNavigateScreen ?? null,
+      fromSignature: input.preNavigateSignature ?? null,
+      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}`
+    );
+    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.`
+      );
+      for (const [actionId, type] of typeById) {
+        if (type === "navigate") toolWithoutEffectIds.add(actionId);
+      }
+    }
+    const loadSettle = await waitForLoadingSettle({
+      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}`
+    );
+    if (loadSettle.loadingPending) loadingPending = true;
+  } else {
+    const pressedAction = turnActions.find(
+      (a) => a.type === "ui_interaction" && a.payload?.componentId === pressedId
+    );
+    const hints = resolveActionHints(getCurrentScreen(), pressedId, pressedAction?.payload);
+    const settleCapMs = hints?.isAsyncTrigger === true ? 1e4 : POST_ACTION_LOADING_MAX_MS;
+    const loadSettle = await waitForLoadingSettle({
+      pressedComponentId: pressedId,
+      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)" : ""}`
+    );
+    if (loadSettle.loadingPending) loadingPending = true;
+    const listPressActions = turnActions.filter((action) => {
+      const target = actionPressTargetId(action);
+      return target ? isListItemPressTarget(target) : false;
+    });
+    if (listPressActions.length > 0) {
+      const baselineFingerprint = probeLoadingState(pressedId, getCurrentScreen()).fingerprint;
+      const postPressSettle = await waitForScreenSettle({
+        expectingChange: true,
+        fromScreen: input.preNavigateScreen ?? null,
+        fromSignature: input.preNavigateSignature ?? null,
+        maxMs: 2500
+      });
+      await waitForLoadingSettle({
+        pressedComponentId: pressedId,
+        fromScreen: getCurrentScreen(),
+        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}`
+      );
+      if (!postPressSettle.transitioned && baselineFingerprint === afterFingerprint) {
+        for (const action of listPressActions) {
+          if (successById.get(action.id)) {
+            toolWithoutEffectIds.add(action.id);
+          }
+        }
+      }
+    }
+  }
+  return { loadingPending, toolWithoutEffectIds };
 }
+var reactNativeChatAdapter = {
+  buildContext: buildAgentContext,
+  getCurrentScreen,
+  getCurrentScreenSignature,
+  settleTurn
+};
 async function runWithConfirmedDestructiveContext(enabled, fn) {
   if (!enabled) return fn();
   const originalAlert = Alert.alert;
@@ -5095,321 +4141,120 @@ async function runWithConfirmedDestructiveContext(enabled, fn) {
     Alert.alert = originalAlert;
   }
 }
-function useAppilotsActions(options = {}) {
-  const { client, subscribe, config, emit } = useAppilotsContext();
-  const [actions, setActions] = useState([]);
-  const { navigationRef, autoExecute = false } = options;
-  const actionsRef = useRef([]);
-  actionsRef.current = actions;
-  const navRefStable = useRef(navigationRef);
-  navRefStable.current = navigationRef;
-  useEffect(() => {
-    const unsubscribe = subscribe((event) => {
-      if (event.type === "agent:action:start") {
-        const action = event.data?.action;
-        if (!action?.id) return;
-        console.log(
-          `[Appilots] useAppilotsActions: received agent:action:start event, action id="${action.id}", type="${action.type}"`
-        );
-        setActions((prev) => {
-          if (prev.some((a) => a.id === action.id)) return prev;
-          return [...prev, action];
-        });
-      }
-    });
-    return unsubscribe;
-  }, [subscribe]);
-  const processedRef = useRef(/* @__PURE__ */ new Set());
-  useEffect(() => {
-    if (!autoExecute) return;
-    const pending = actions.filter(
-      (a) => a.status === "pending" && !processedRef.current.has(a.id)
-    );
-    console.log(`[Appilots] useAppilotsActions: autoExecute check \u2014 ${pending.length} pending action(s) to process`);
-    const findGatingConfirm = (target) => {
-      return actions.find((a) => {
-        if (a.type !== "confirm") return false;
-        const payload = a.payload;
-        const injectedBy = payload?.injectedBy;
-        return payload?.gatedActionId === target.id && (injectedBy === "permissions" || injectedBy === "sdk-local");
-      });
-    };
-    const ensureLocalConfirmIfNeeded = (target) => {
-      if (target.type !== "ui_interaction") return false;
-      const payload = target.payload;
-      const componentId = typeof payload?.componentId === "string" && payload.componentId || typeof payload?.targetId === "string" && payload.targetId || "";
-      let policy = payloadRequiresConfirmation(target);
-      if (!policy.required && componentId) {
-        const screen = getCurrentScreen();
-        const meta = screen ? getScreenMetadata(screen) : void 0;
-        const actionsMeta = meta?.actions;
-        if (actionsMeta && Array.isArray(actionsMeta)) {
-          const match = actionsMeta.find((a) => {
-            if (typeof a === "string") return false;
-            return metadataMatchesComponentId(a.id, componentId);
-          });
-          if (match && typeof match !== "string") {
-            policy = actionMetadataRequiresConfirmation(match);
-          }
-        }
-      }
-      const existingGate = findGatingConfirm(target);
-      if (existingGate) {
-        if (policy.required && confirmNeedsDestructiveUpgrade(existingGate)) {
-          setActions(
-            (prev) => prev.map(
-              (a) => a.id === existingGate.id ? {
-                ...a,
-                destructive: true,
-                payload: toDestructiveConfirmPayload(
-                  a,
-                  policy,
-                  componentId || target.id
-                )
-              } : a
-            )
-          );
-        }
-        return false;
-      }
-      if (!policy.required) return false;
-      const confirmId = `confirm-local-${target.id}`;
-      setActions((prev) => {
-        const existingGate2 = prev.some((a) => {
-          if (a.type !== "confirm") return false;
-          const p = a.payload;
-          if (!p || p.gatedActionId !== target.id) return false;
-          return p.injectedBy === "permissions" || p.injectedBy === "sdk-local";
-        });
-        if (existingGate2) {
-          const gateToUpgrade = prev.find(
-            (a) => isConfirmGateFor(a, target) && confirmNeedsDestructiveUpgrade(a)
-          );
-          if (!gateToUpgrade) return prev;
-          return prev.map(
-            (a) => a.id === gateToUpgrade.id ? {
-              ...a,
-              destructive: true,
-              payload: toDestructiveConfirmPayload(
-                a,
-                policy,
-                componentId || target.id
-              )
-            } : a
-          );
-        }
-        if (prev.some((a) => a.id === confirmId)) return prev;
-        console.log(
-          `[Appilots] useAppilotsActions: action "${componentId || target.id}" requires confirmation (${policy.source ?? "local-policy"}) \u2014 synthesising local confirm (id="${confirmId}")`
-        );
-        const synth = {
-          id: confirmId,
-          type: "confirm",
-          payload: toDestructiveConfirmPayload(
-            {
-              payload: {
-                gatedActionId: target.id,
-                gatedActionType: target.type,
-                injectedBy: "sdk-local"
-              },
-              messageId: target.messageId
-            },
-            policy,
-            componentId || "esta a\xE7\xE3o"
-          ),
-          status: "pending",
-          messageId: target.messageId
-        };
-        emit({
-          type: "agent:action:start",
-          timestamp: Date.now(),
-          data: { action: synth }
-        });
-        const idx = prev.findIndex((a) => a.id === target.id);
-        if (idx < 0) return [...prev, synth];
-        return [...prev.slice(0, idx), synth, ...prev.slice(idx)];
-      });
-      return true;
-    };
-    const executeSequentially = async () => {
-      let lastWasNavigate = false;
-      let preNavScreen = null;
-      let preNavSignature = null;
-      for (const action of pending) {
-        if (action.type === "confirm") {
-          continue;
-        }
-        if (ensureLocalConfirmIfNeeded(action)) {
-          continue;
-        }
-        const gate = findGatingConfirm(action);
-        if (gate) {
-          if (gate.status === "pending" || gate.status === "executing") {
-            console.log(
-              `[Appilots] useAppilotsActions: action id="${action.id}" is gated by confirm id="${gate.id}" (status=${gate.status}); waiting for user decision`
-            );
-            continue;
-          }
-          if (gate.status === "failed") {
-            console.log(
-              `[Appilots] useAppilotsActions: confirm id="${gate.id}" was rejected; skipping gated action id="${action.id}"`
-            );
-            processedRef.current.add(action.id);
-            setActions(
-              (prev) => prev.map(
-                (a) => a.id === action.id ? { ...a, status: "failed", error: "Confirm canceled by user" } : a
-              )
-            );
-            try {
-              await client.completeAction(action.id, false, "Confirm canceled by user");
-            } catch {
-            }
-            emit({
-              type: "agent:action:error",
-              timestamp: Date.now(),
-              data: {
-                actionId: action.id,
-                actionType: action.type,
-                success: false,
-                error: "Confirm canceled by user"
-              }
-            });
-            continue;
-          }
-        }
-        if (lastWasNavigate) {
-          const settle = await waitForScreenSettle({
-            expectingChange: true,
-            fromScreen: preNavScreen,
-            fromSignature: preNavSignature,
-            maxMs: 3500
-          });
-          console.log(
-            `[Appilots] useAppilotsActions: post-navigate settle done \u2014 screen="${settle.screen}" transitioned=${settle.transitioned} timedOut=${settle.timedOut} waitedMs=${settle.waitedMs}`
-          );
-        }
-        console.log(`[Appilots] useAppilotsActions: auto-executing action id="${action.id}" type="${action.type}"`);
-        processedRef.current.add(action.id);
-        if (action.type === "navigate") {
-          preNavScreen = getCurrentScreen();
-          preNavSignature = getCurrentScreenSignature();
-        }
-        const succeeded = await approveActionImpl(action.id);
-        if (!succeeded) {
-          appilotsDebugWarn(
-            `useAppilotsActions: stopping current action batch after failed action id="${action.id}"`
-          );
-          break;
-        }
-        lastWasNavigate = action.type === "navigate";
-      }
-    };
-    void executeSequentially();
-  }, [actions, autoExecute]);
-  const approveActionImpl = useCallback(
-    async (actionId) => {
-      const action = actionsRef.current.find((a) => a.id === actionId);
-      if (!action) return false;
-      console.log(`[Appilots] useAppilotsActions: action status transition: pending \u2192 executing (id="${actionId}", type="${action.type}")`);
-      setActions(
-        (prev) => prev.map((a) => a.id === actionId ? { ...a, status: "executing" } : a)
+function createReactNativeActionRunner(getOptions) {
+  return {
+    async execute(action, { confirmedDestructive }) {
+      const { permissions, emit, navigationRef } = getOptions();
+      const navRef = navigationRef?.current ? navigationRef : { current: getNavigationRef() };
+      return runWithConfirmedDestructiveContext(
+        confirmedDestructive,
+        () => executeAction(action, {
+          navigationRef: navRef,
+          permissions,
+          emit
+        })
       );
-      try {
-        const navRef = navRefStable.current?.current ? navRefStable.current : { current: getNavigationRef() };
-        const confirmedDestructive = actionHasCompletedConfirmGate(
-          action,
-          actionsRef.current
-        );
-        const result = await runWithConfirmedDestructiveContext(
-          confirmedDestructive,
-          () => executeAction(
-            { ...action, status: "executing" },
-            {
-              navigationRef: navRef,
-              permissions: config.permissions ?? DEFAULT_PERMISSIONS2,
-              emit
-            }
-          )
-        );
-        if (result.success) {
-          console.log(`[Appilots] useAppilotsActions: action status transition: executing \u2192 completed (id="${actionId}", type="${action.type}")`);
-          setActions(
-            (prev) => prev.map((a) => a.id === actionId ? { ...a, status: "completed" } : a)
-          );
-          try {
-            await client.completeAction(actionId, true);
-          } catch {
-          }
-          return true;
-        } else {
-          appilotsDebugWarn(
-            `useAppilotsActions: action status transition: executing \u2192 failed (id="${actionId}", type="${action.type}", error="${result.error}")`
-          );
-          setActions(
-            (prev) => prev.map(
-              (a) => a.id === actionId ? { ...a, status: "failed", error: result.error } : a
-            )
-          );
-          try {
-            await client.completeAction(
-              actionId,
-              false,
-              result.error,
-              result.diagnose
-            );
-          } catch {
-          }
-          return false;
-        }
-      } catch (err) {
-        const errorMsg = err instanceof Error ? err.message : "Action failed";
-        appilotsDebugWarn(
-          `useAppilotsActions: action status transition: executing \u2192 failed (exception) (id="${actionId}", error="${errorMsg}")`
-        );
-        setActions(
-          (prev) => prev.map(
-            (a) => a.id === actionId ? { ...a, status: "failed", error: errorMsg } : a
-          )
-        );
-        try {
-          await client.completeAction(actionId, false, errorMsg);
-        } catch {
-        }
-        return false;
-      }
     },
-    [client, config.permissions, emit]
-  );
-  const rejectAction = useCallback(
-    async (actionId) => {
-      setActions(
-        (prev) => prev.map(
-          (a) => a.id === actionId ? { ...a, status: "failed", error: "Rejected by user" } : a
-        )
-      );
-      const action = actionsRef.current.find((a) => a.id === actionId);
-      emit({
-        type: "agent:action:error",
-        timestamp: Date.now(),
-        data: {
-          actionId,
-          actionType: action?.type,
-          success: false,
-          error: "Rejected by user"
-        }
-      });
-      try {
-        await client.completeAction(actionId, false, "Rejected by user");
-      } catch {
-      }
+    getCurrentScreen,
+    getCurrentScreenSignature,
+    getScreenActionsMetadata(screen) {
+      return getScreenMetadata(screen)?.actions;
     },
+    waitForScreenSettle
+  };
+}
+
+// src/hooks/useAppilotsChat.ts
+function useAppilotsChat(options = {}) {
+  const { client, emit, subscribe } = useAppilotsContext();
+  const machine = useMemo(
+    () => new ChatSessionMachine(
+      { client, adapter: reactNativeChatAdapter, emit, warn: appilotsDebugWarn },
+      options
+    ),
+    // A new machine per client/provider instance — options are pushed in
+    // below so changing copy never resets the transcript.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [client, emit]
+  );
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  machine.setOptions(options);
+  const state = useSyncExternalStore(machine.subscribeState, machine.getState, machine.getState);
+  useEffect(() => subscribe(machine.handleEvent), [subscribe, machine]);
+  useEffect(() => () => machine.dispose(), [machine]);
+  const requestHuman = useCallback(
+    (reason) => machine.requestHuman(reason),
+    [machine]
+  );
+  const sendMessage = useCallback((content) => machine.sendMessage(content), [machine]);
+  const cancelMessage = useCallback(() => machine.cancelMessage(), [machine]);
+  const clearMessages = useCallback(() => machine.clearMessages(), [machine]);
+  const clearError = useCallback(() => machine.clearError(), [machine]);
+  return {
+    messages: state.messages,
+    isLoading: state.isLoading,
+    loadingStatusKey: state.loadingStatusKey,
+    error: state.error,
+    pendingActions: state.pendingActions,
+    escalation: state.escalation,
+    requestHuman,
+    sendMessage,
+    cancelMessage,
+    clearMessages,
+    clearError
+  };
+}
+var DEFAULT_PERMISSIONS2 = {
+  canNavigate: true,
+  canFillForms: true,
+  canInteractUI: true,
+  canSubmitForms: true
+};
+function useAppilotsActions(options = {}) {
+  const { client, subscribe, config, emit } = useAppilotsContext();
+  const { navigationRef, autoExecute = false } = options;
+  const runnerOptionsRef = useRef({
+    permissions: config.permissions ?? DEFAULT_PERMISSIONS2,
+    emit,
+    navigationRef
+  });
+  runnerOptionsRef.current = {
+    permissions: config.permissions ?? DEFAULT_PERMISSIONS2,
+    emit,
+    navigationRef
+  };
+  const machine = useMemo(
+    () => new ActionQueueMachine(
+      {
+        client,
+        adapter: createReactNativeActionRunner(() => runnerOptionsRef.current),
+        emit,
+        warn: appilotsDebugWarn
+      },
+      { autoExecute }
+    ),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
     [client, emit]
   );
+  machine.setOptions({ autoExecute });
+  const state = useSyncExternalStore(machine.subscribeState, machine.getState, machine.getState);
+  useEffect(() => subscribe(machine.handleEvent), [subscribe, machine]);
+  useEffect(() => {
+    if (autoExecute) machine.scheduleDrain();
+  }, [autoExecute, machine, state.actions]);
+  const approveAction = useCallback(
+    (actionId) => machine.approveAction(actionId),
+    [machine]
+  );
+  const rejectAction = useCallback((actionId) => machine.rejectAction(actionId), [machine]);
   return {
-    pendingActions: actions.filter((a) => a.status === "pending"),
-    executingActions: actions.filter((a) => a.status === "executing"),
-    completedActions: actions.filter((a) => a.status === "completed" || a.status === "failed"),
-    approveAction: approveActionImpl,
+    pendingActions: state.actions.filter((a) => a.status === "pending"),
+    executingActions: state.actions.filter((a) => a.status === "executing"),
+    completedActions: state.actions.filter(
+      (a) => a.status === "completed" || a.status === "failed"
+    ),
+    approveAction,
     rejectAction
   };
 }