@appilots/sdk 0.8.0 → 0.11.0

package/dist/{chunk-AYWMBMSN.js → chunk-55Y2AQE7.js}

@@ -14,6 +14,153 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
+// ../shared/dist/chunk-UEMUBXFH.mjs
+var DEFAULT_API_BASE_URL = "https://api.appilots.com";
+var APPILOTS_API_PATH_PREFIX = "/api/v1";
+function normalizeApiBaseUrl(configured) {
+  const raw = (configured ?? DEFAULT_API_BASE_URL).trim().replace(/\/+$/, "");
+  if (!raw) return `${DEFAULT_API_BASE_URL}${APPILOTS_API_PATH_PREFIX}`;
+  if (new RegExp(`${APPILOTS_API_PATH_PREFIX}(/|$)`).test(raw)) return raw;
+  return `${raw}${APPILOTS_API_PATH_PREFIX}`;
+}
+
+// ../shared/dist/screen-text/index.mjs
+function build(table, extra = []) {
+  return [...Object.values(table).flat(), ...extra].join("|");
+}
+var VALIDATION = {
+  pt: [
+    "inv[a\xE1]lid",
+    "obrigat[o\xF3]ri",
+    "j[a\xE1]\\s+existe",
+    "duplicad",
+    "muito\\s+curto",
+    "n[a\xE3]o\\s+(?:foi|pode)",
+    "deve\\s+ser",
+    "selecione",
+    "escolha",
+    "preencha",
+    "corrija"
+  ],
+  en: [
+    "invalid",
+    "required",
+    "already\\s+exists",
+    "too\\s+short",
+    "must\\s+be",
+    "select\\s+(?:the|a|an)",
+    "please\\s+(?:enter|choose|select|fill)",
+    "can'?t\\s+be\\s+(?:empty|blank)",
+    "cannot\\s+be\\s+(?:empty|blank)"
+  ],
+  es: [
+    "obligatori",
+    "ya\\s+existe",
+    "demasiado\\s+corto",
+    "debe\\s+ser",
+    "seleccione",
+    "elija",
+    "complet[ae]\\s+(?:el|los|este)",
+    "no\\s+puede\\s+(?:estar|quedar)\\s+vac"
+  ],
+  fr: [
+    "invalide",
+    "obligatoire",
+    "existe\\s+d[e\xE9]j[a\xE0]",
+    "trop\\s+court",
+    "doit\\s+[\xEAe]tre",
+    "s[e\xE9]lectionnez",
+    "choisissez",
+    "veuillez\\s+(?:saisir|choisir|remplir|s[e\xE9]lectionner)",
+    "ne\\s+peut\\s+pas\\s+[\xEAe]tre\\s+vide"
+  ]
+};
+var VALIDATION_SHARED = ["format[oa]?\\b", "\\bformat\\b"];
+var WRITE_SUCCESS = {
+  pt: [
+    "cadastrad[oa]s?\\s+com\\s+sucesso",
+    "registrad[oa]s?\\s+com\\s+sucesso",
+    "salv[oa]s?\\s+com\\s+sucesso",
+    "criad[oa]s?\\s+com\\s+sucesso",
+    "atualizad[oa]s?\\s+com\\s+sucesso",
+    "foi\\s+cadastrad[oa]",
+    "foi\\s+registrad[oa]",
+    "foi\\s+salv[oa]",
+    "foi\\s+criad[oa]"
+  ],
+  en: [
+    "successfully\\s+(?:registered|saved|created|updated|added)",
+    "(?:has\\s+been|was)\\s+(?:registered|saved|created|updated|added)"
+  ],
+  es: [
+    "registrad[oa]s?\\s+(?:exitosamente|correctamente|con\\s+[e\xE9]xito)",
+    "guardad[oa]s?\\s+(?:correctamente|con\\s+[e\xE9]xito)",
+    "cread[oa]s?\\s+(?:correctamente|con\\s+[e\xE9]xito)",
+    "se\\s+ha\\s+(?:guardado|creado|registrado|actualizado)"
+  ],
+  fr: [
+    "(?:enregistr|cr[e\xE9]|ajout|mis\\s+[a\xE0]\\s+jour)[e\xE9]?e?s?\\s+avec\\s+succ[e\xE8]s",
+    "a\\s+[e\xE9]t[e\xE9]\\s+(?:enregistr|cr[e\xE9]|ajout|sauvegard)[e\xE9]e?"
+  ]
+};
+var COMPLETION_CLAIM = {
+  pt: [
+    "j[a\xE1]\\s+(?:cadastrei|registrei|salvei|criei)",
+    "conclu[i\xED]\\s+o\\s+cadastro",
+    "cadastro\\s+(?:foi\\s+)?(?:conclu[i\xED]do|realizado|feito)"
+  ],
+  en: [
+    "i(?:'|\u2019)?ve\\s+(?:registered|saved|created|added)",
+    "i\\s+have\\s+(?:registered|saved|created|added)"
+  ],
+  es: ["ya\\s+(?:lo\\s+|la\\s+)?(?:registr[e\xE9]|guard[e\xE9]|cre[e\xE9])"],
+  fr: ["j(?:e\\s+l(?:'|\u2019)ai|(?:'|\u2019)ai)\\s+(?:enregistr|cr[e\xE9]|ajout|sauvegard)[e\xE9]"]
+};
+var SUBMIT_CONTROL = {
+  pt: ["cadastrar", "registrar", "salvar", "enviar", "confirmar"],
+  en: ["submit", "register", "save", "confirm"],
+  es: ["guardar", "registrar", "enviar", "confirmar", "aceptar"],
+  fr: ["enregistrer", "soumettre", "envoyer", "confirmer", "valider"]
+};
+var SUBMIT_LABEL_EXTRA = {
+  pt: ["criar", "adicionar", "concluir", "finalizar"],
+  en: ["create", "add", "done", "finish", "continue"],
+  es: ["crear", "a[\xF1n]adir", "agregar", "continuar", "finalizar"],
+  fr: ["cr[e\xE9]er", "ajouter", "terminer", "continuer"]
+};
+var CREATE_EDIT_ROUTE = {
+  pt: ["cadastr", "criar", "novo", "nova", "registr", "edit"],
+  en: ["create", "edit", "form", "new", "add"],
+  es: ["crear", "nuevo", "nueva", "editar", "alta"],
+  fr: ["cr[e\xE9]er", "nouveau", "nouvelle", "modifier", "ajout"]
+};
+var WRITE_INTENT = {
+  pt: ["cadastr\\w*", "registr\\w*", "cria\\w*", "adiciona\\w*", "salv\\w*"],
+  en: [
+    "creat(?:e|es|ed|ing|ion)",
+    "save[sd]?",
+    "saving",
+    "add(?:s|ed|ing)?",
+    "submit\\w*",
+    "register\\w*"
+  ],
+  es: ["crea\\w*", "guarda\\w*", "a[n\xF1]ad\\w*", "agrega\\w*", "registra\\w*"],
+  fr: ["cr[e\xE9][e\xE9]\\w*", "enregistr\\w*", "ajout\\w*", "sauvegard\\w*", "soumet\\w*"]
+};
+var FORM_VALIDATION_TEXT_RE = new RegExp(`(${build(VALIDATION, VALIDATION_SHARED)})`, "i");
+var FORM_WRITE_SUCCESS_TEXT_RE = new RegExp(`\\b(${build(WRITE_SUCCESS)})`, "i");
+new RegExp(`\\b(${build(WRITE_INTENT)})\\b`, "i");
+new RegExp(
+  `\\b(${build(WRITE_SUCCESS)}|${build(COMPLETION_CLAIM)})`,
+  "i"
+);
+var SUBMIT_CONTROL_RE = new RegExp(`(${build(SUBMIT_CONTROL)})`, "i");
+new RegExp(
+  `(${build(SUBMIT_CONTROL)}|${build(SUBMIT_LABEL_EXTRA)})`,
+  "i"
+);
+var CREATE_EDIT_ROUTE_RE = new RegExp(`(${build(CREATE_EDIT_ROUTE)})`, "i");
+
 // ../shared/dist/chunk-43YQ52Q7.mjs
 var SENSITIVE_FIELD_NAME_RE = /(\b|_|-)(password|senha|contrase[ñn]a|mot[\s_-]*de[\s_-]*passe|passwd|pwd|secret|token|api[\s_-]*key|access[\s_-]*key|private[\s_-]*key|cvv|cvc|cvn|cvc2|cid|pin(?:[\s_-]*code)?|otp|one[\s_-]*time[\s_-]*code|2fa|mfa|security[\s_-]*code|c[óo]digo[\s_-]*seguran[çc]a|c[óo]digo[\s_-]*verifica[çc][ãa]o|verification[\s_-]*code)(\b|_|-)/i;
 function isSensitiveFieldName(id, label, placeholder, type) {
@@ -28,6 +175,39 @@ function isSensitiveFieldName(id, label, placeholder, type) {
 
 // ../client-core/dist/index.mjs
 var SDK_VERSION = "0.1.0";
+var _enabled;
+var _resolve;
+function setAppilotsDebugEnabled(enabled) {
+  _enabled = enabled;
+}
+function setAppilotsDebugResolver(resolve) {
+  _resolve = resolve;
+}
+function isAppilotsDebugEnabled() {
+  if (_enabled !== void 0) return _enabled;
+  try {
+    return _resolve?.() === true;
+  } catch {
+    return false;
+  }
+}
+function appilotsDebugLog(...args) {
+  if (!isAppilotsDebugEnabled()) return;
+  console.log("[Appilots]", ...args);
+}
+function appilotsDebugWarn(...args) {
+  if (!isAppilotsDebugEnabled()) return;
+  console.log("[Appilots]", ...args);
+}
+function describeValue(value) {
+  if (value === void 0) return "undefined";
+  if (value === null) return "null";
+  if (typeof value === "string") return `string(len=${value.length})`;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (Array.isArray(value)) return `array(len=${value.length})`;
+  if (typeof value === "object") return `object(keys=${Object.keys(value).length})`;
+  return typeof value;
+}
 var StreamTransportError = class extends Error {
   constructor(message) {
     super(message);
@@ -58,6 +238,13 @@ function parseRetryAfter(...candidates) {
   return 60;
 }
 var CONTINUATION_TIMEOUT_MS = 15e4;
+function safeJson(text) {
+  try {
+    return JSON.parse(text || "{}");
+  } catch {
+    return null;
+  }
+}
 var AppilotsClient = class {
   baseUrl;
   projectId;
@@ -72,7 +259,7 @@ var AppilotsClient = class {
   identified = false;
   constructor(options) {
     this.projectId = options.projectId;
-    this.baseUrl = (options.apiBaseUrl ?? "https://api.appilots.com").replace(/\/$/, "");
+    this.baseUrl = normalizeApiBaseUrl(options.apiBaseUrl);
     this.timeout = options.timeout ?? 6e4;
     this.debug = options.debug ?? false;
     this.mcpVersion = options.mcpVersion;
@@ -91,8 +278,25 @@ var AppilotsClient = class {
       ...options.headers
     };
   }
+  /**
+   * A 404 on an `/agent/*` path is almost never a missing record — those
+   * routes are static. It means the request reached SOMETHING that is not
+   * this API, or reached it at the wrong mount point, and the server's own
+   * message ("Route not found") tells the integrator nothing about which.
+   *
+   * The symptom is unmistakable once you have seen it: every message
+   * fails, including a plain "hello" that needs no tool at all, because
+   * nothing ever reaches the agent. Left as-is it reads like the agent is
+   * broken.
+   */
+  explainIfMisroutedBaseUrl(status, json, fallback) {
+    if (status !== 404) return fallback;
+    const code = json?.error?.code;
+    if (code !== "NOT_FOUND") return fallback;
+    return `${fallback} \u2014 the Appilots API answered 404 for every path under ${this.baseUrl}. That usually means apiBaseUrl points somewhere this API is not mounted. The hosted API is https://api.appilots.com${APPILOTS_API_PATH_PREFIX}; a local stack is http://localhost:4000${APPILOTS_API_PATH_PREFIX}.`;
+  }
   log(...args) {
-    if (this.debug) console.log("[AppilotsClient]", ...args);
+    if (this.debug) appilotsDebugLog("[AppilotsClient]", ...args);
   }
   describeNonJsonResponse(url, response, body) {
     const contentType = response.headers?.get?.("content-type") ?? "unknown content-type";
@@ -126,13 +330,10 @@ var AppilotsClient = class {
         if (response.status === 429) {
           throw new RateLimitedError(
             errorMsg,
-            parseRetryAfter(
-              json?.error?.retryAfterSeconds,
-              response.headers?.get?.("retry-after")
-            )
+            parseRetryAfter(json?.error?.retryAfterSeconds, response.headers?.get?.("retry-after"))
           );
         }
-        throw new Error(errorMsg);
+        throw new Error(this.explainIfMisroutedBaseUrl(response.status, json, errorMsg));
       }
       return json.data ?? json;
     } finally {
@@ -247,7 +448,11 @@ var AppilotsClient = class {
       content: data.message.summary,
       timestamp: Date.now()
     } : void 0;
-    this.log("Response received:", { messageId: message.id, actions: actions?.length ?? 0, hasSummary: !!summaryMessage });
+    this.log("Response received:", {
+      messageId: message.id,
+      actions: actions?.length ?? 0,
+      hasSummary: !!summaryMessage
+    });
     return {
       sessionId: this.sessionId,
       message,
@@ -388,17 +593,17 @@ var AppilotsClient = class {
             fail(
               new RateLimitedError(
                 message2,
-                parseRetryAfter(
-                  retryAfterSeconds,
-                  xhr.getResponseHeader?.("retry-after")
-                )
+                parseRetryAfter(retryAfterSeconds, xhr.getResponseHeader?.("retry-after"))
               )
             );
             return;
           }
-          fail(
-            sawAnyEvent ? new Error(message2) : new StreamTransportError(message2)
+          const explained = this.explainIfMisroutedBaseUrl(
+            xhr.status,
+            safeJson(xhr.responseText),
+            message2
           );
+          fail(sawAnyEvent ? new Error(explained) : new StreamTransportError(explained));
           return;
         }
         if (!doneEvent) {
@@ -580,7 +785,9 @@ var AppilotsClient = class {
         };
       case "navigate":
         return {
-          screenName: payload.screenName ?? "",
+          // No `?? ''` here: an empty string would make a goBack look
+          // like a navigate to a nameless screen further down (#398).
+          screenName: typeof payload.screenName === "string" ? payload.screenName : void 0,
           params: payload.params,
           navigationAction: payload.navigationAction ?? "navigate",
           path: Array.isArray(payload.path) ? payload.path : void 0
@@ -1113,8 +1320,15 @@ function subscribeAppilotsDebugTraces(listener) {
   };
 }
 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;
+var INTERNAL_ID_SRC = 'el:[^\\s".]+|list-\\d+-item-\\d+';
+var TECHNICAL_FIELD_SRC = "\\b(?:targetId|componentId|screenName|actionId|fieldId|elementId|testID|test-id|accessibilityId|accessibility-id)\\s*[:=_-]\\s*\\S+";
+var TECHNICAL_SELECTOR_RE = new RegExp(`${INTERNAL_ID_SRC}|${TECHNICAL_FIELD_SRC}`, "i");
+var TOOL_NAME_SRC = "(?:form_fill|ui_interaction|scroll_list)\\b";
+var TOOL_VERB_WITH_ID_SRC = `(?:press|click|tap|navigate)\\w*\\b[^\\n]{0,40}?(?:${INTERNAL_ID_SRC})`;
+var TECHNICAL_TRACE_RE = new RegExp(
+  `(^|\\n)\\s*(?:Results:|[-*]\\s*[\u2713\u2717]\\s+|${TOOL_NAME_SRC}|${TOOL_VERB_WITH_ID_SRC}|(?:Cliquei|Clicked)\\s+em\\s+(?:${INTERNAL_ID_SRC}|[A-Za-z][\\w-]*:))`,
+  "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();
 }
@@ -1122,7 +1336,7 @@ 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();
+  ).trim();
   if (text.length < 16) return null;
   const probe = {
     role: "assistant",
@@ -1137,9 +1351,8 @@ function isInternalTraceMessage(message) {
   if (!content) return true;
   return TECHNICAL_TRACE_RE.test(content) || TECHNICAL_SELECTOR_RE.test(content);
 }
-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;
+var CREATE_FORM_ROUTE_RE = CREATE_EDIT_ROUTE_RE;
+var SUBMIT_BUTTON_RE = SUBMIT_CONTROL_RE;
 function normalize2(value) {
   return value.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
 }
@@ -1157,7 +1370,9 @@ function snapshotHasVisibleSubmitButton(snap) {
   );
 }
 function snapshotHasVisibleValidation(snap) {
-  return (snap.texts ?? []).some((text) => typeof text === "string" && FORM_VALIDATION_TEXT_RE.test(text));
+  return (snap.texts ?? []).some(
+    (text) => typeof text === "string" && FORM_VALIDATION_TEXT_RE.test(text)
+  );
 }
 function snapshotShowsOpenCreateForm(snap, activePath = []) {
   if (!snap) return false;
@@ -1574,9 +1789,10 @@ var ChatSessionMachine = class {
           };
         }
         const hasToolWithoutEffect = toolWithoutEffectIds.has(actionId);
+        const observedNoEffect = hasToolWithoutEffect || r.effect === "none";
         let recoveryAttempt = 0;
         let recoveryExhausted = false;
-        if (!r.success || hasToolWithoutEffect) {
+        if (!r.skipped && (!r.success || observedNoEffect)) {
           const previous = this.recoveryCountByFingerprint.get(r.fingerprint) ?? 0;
           const next = previous + 1;
           this.recoveryCountByFingerprint.set(r.fingerprint, next);
@@ -1593,16 +1809,18 @@ var ChatSessionMachine = class {
           recoveryAttempt,
           recoveryExhausted,
           toolWithoutEffect: hasToolWithoutEffect,
-          effect: hasToolWithoutEffect ? "none" : r.effect,
+          effect: observedNoEffect ? "none" : r.effect,
           userVisibleStatusKey: r.userVisibleStatusKey
         };
       });
       const exhausted = results.filter((r) => r.recoveryExhausted);
       this.setState({
-        loadingStatusKey: results.some((r) => !r.success || r.toolWithoutEffect) ? "statusAdjusting" : "statusAnalyzing"
+        loadingStatusKey: results.some(
+          (r) => !r.success || r.toolWithoutEffect || r.effect === "none"
+        ) ? "statusAdjusting" : "statusAnalyzing"
       });
-      console.log(
-        `[Appilots] ChatSessionMachine: running continuation hop=${turn.hop} (${results.filter((r) => r.success).length}/${results.length} succeeded` + (exhausted.length > 0 ? `, ${exhausted.length} recovery-exhausted` : "") + ")"
+      appilotsDebugLog(
+        `ChatSessionMachine: running continuation hop=${turn.hop} (${results.filter((r) => r.success).length}/${results.length} succeeded` + (exhausted.length > 0 ? `, ${exhausted.length} recovery-exhausted` : "") + ")"
       );
       const response = await this.deps.client.continueAgent(results, context, turn.hop);
       this.addAssistantMessage(response.message);
@@ -1675,6 +1893,7 @@ var ChatSessionMachine = class {
     const diagnose = event.data?.diagnose;
     const effect = event.data?.effect;
     const userVisibleStatusKey = event.data?.userVisibleStatusKey;
+    const skipped = event.data?.skipped === true;
     const existing = turn.results.get(actionId);
     if (existing) {
       existing.success = success;
@@ -1682,6 +1901,7 @@ var ChatSessionMachine = class {
       existing.diagnose = diagnose;
       existing.effect = effect;
       existing.userVisibleStatusKey = userVisibleStatusKey;
+      existing.skipped = skipped;
     }
     turn.reportedIds.add(actionId);
     if (turn.reportedIds.size >= turn.actionIds.size) {
@@ -1718,8 +1938,8 @@ var ChatSessionMachine = class {
     this.abortController = abortController;
     try {
       const context = this.deps.adapter.buildContext();
-      console.log(
-        `[Appilots] ChatSessionMachine 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}}`
+      appilotsDebugLog(
+        `ChatSessionMachine 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) {
@@ -1747,9 +1967,7 @@ var ChatSessionMachine = class {
           });
         } catch (err) {
           if (err instanceof StreamTransportError) {
-            console.warn(
-              `[Appilots] streaming unavailable, falling back to JSON: ${err.message}`
-            );
+            appilotsDebugWarn(`streaming unavailable, falling back to JSON: ${err.message}`);
             response = await this.deps.client.sendMessage(content.trim(), context);
           } else {
             throw err;
@@ -1758,8 +1976,8 @@ var ChatSessionMachine = class {
       } else {
         response = await this.deps.client.sendMessage(content.trim(), context);
       }
-      console.log(
-        `[Appilots] ChatSessionMachine sendMessage: response received \u2014 actions=${response.actions?.length ?? 0}, hasSummary=${!!response.summaryMessage}`
+      appilotsDebugLog(
+        `ChatSessionMachine sendMessage: response received \u2014 actions=${response.actions?.length ?? 0}, hasSummary=${!!response.summaryMessage}`
       );
       removeStreamingPlaceholder();
       this.addAssistantMessage(response.message);
@@ -1849,7 +2067,11 @@ function isStructuredRisky(value) {
 }
 function actionMetadataRequiresConfirmation(meta) {
   if (meta.requiresConfirmation === true || meta.destructive === true || meta.effect === "destructive" || meta.riskLevel === "high" || meta.risk === "destructive") {
-    return { required: true, label: typeof meta.label === "string" ? meta.label : void 0, source: "screen-metadata" };
+    return {
+      required: true,
+      label: typeof meta.label === "string" ? meta.label : void 0,
+      source: "screen-metadata"
+    };
   }
   return { required: false };
 }
@@ -1890,13 +2112,9 @@ function toDestructiveConfirmPayload(confirm, policy, fallbackLabel) {
   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"
+    destructive: true
   };
 }
 function confirmNeedsDestructiveUpgrade(confirm) {
@@ -1962,8 +2180,8 @@ var ActionQueueMachine = class {
     if (event.type !== "agent:action:start") return;
     const action = event.data?.action;
     if (!action?.id) return;
-    console.log(
-      `[Appilots] ActionQueueMachine: received agent:action:start event, action id="${action.id}", type="${action.type}"`
+    appilotsDebugLog(
+      `ActionQueueMachine: received agent:action:start event, action id="${action.id}", type="${action.type}"`
     );
     if (this.state.actions.some((a) => a.id === action.id)) return;
     this.setActions([...this.state.actions, action]);
@@ -2064,8 +2282,8 @@ var ActionQueueMachine = class {
     if (!policy.required) return false;
     const confirmId = `confirm-local-${target.id}`;
     if (this.state.actions.some((a) => a.id === confirmId)) return true;
-    console.log(
-      `[Appilots] ActionQueueMachine: action "${componentId || target.id}" requires confirmation (${policy.source ?? "local-policy"}) \u2014 synthesising local confirm (id="${confirmId}")`
+    appilotsDebugLog(
+      `ActionQueueMachine: action "${componentId || target.id}" requires confirmation (${policy.source ?? "local-policy"}) \u2014 synthesising local confirm (id="${confirmId}")`
     );
     const synth = {
       id: confirmId,
@@ -2111,13 +2329,13 @@ var ActionQueueMachine = class {
     const pending = this.state.actions.filter(
       (a) => a.status === "pending" && !this.processed.has(a.id)
     );
-    console.log(
-      `[Appilots] ActionQueueMachine: autoExecute check \u2014 ${pending.length} pending action(s) to process`
+    appilotsDebugLog(
+      `ActionQueueMachine: autoExecute check \u2014 ${pending.length} pending action(s) to process`
     );
     let lastWasNavigate = false;
     let preNavScreen = null;
     let preNavSignature = null;
-    for (const action of pending) {
+    for (const [index, action] of pending.entries()) {
       if (action.type === "confirm") {
         continue;
       }
@@ -2127,14 +2345,14 @@ var ActionQueueMachine = class {
       const gate = findGatingConfirm(action, this.state.actions);
       if (gate) {
         if (gate.status === "pending" || gate.status === "executing") {
-          console.log(
-            `[Appilots] ActionQueueMachine: action id="${action.id}" is gated by confirm id="${gate.id}" (status=${gate.status}); waiting for user decision`
+          appilotsDebugLog(
+            `ActionQueueMachine: 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] ActionQueueMachine: confirm id="${gate.id}" was rejected; skipping gated action id="${action.id}"`
+          appilotsDebugLog(
+            `ActionQueueMachine: confirm id="${gate.id}" was rejected; skipping gated action id="${action.id}"`
           );
           this.processed.add(action.id);
           this.updateActions(
@@ -2166,12 +2384,12 @@ var ActionQueueMachine = class {
           fromSignature: preNavSignature,
           maxMs: 3500
         });
-        console.log(
-          `[Appilots] ActionQueueMachine: post-navigate settle done \u2014 screen="${settle.screen}" transitioned=${settle.transitioned} timedOut=${settle.timedOut} waitedMs=${settle.waitedMs}`
+        appilotsDebugLog(
+          `ActionQueueMachine: post-navigate settle done \u2014 screen="${settle.screen}" transitioned=${settle.transitioned} timedOut=${settle.timedOut} waitedMs=${settle.waitedMs}`
         );
       }
-      console.log(
-        `[Appilots] ActionQueueMachine: auto-executing action id="${action.id}" type="${action.type}"`
+      appilotsDebugLog(
+        `ActionQueueMachine: auto-executing action id="${action.id}" type="${action.type}"`
       );
       this.processed.add(action.id);
       if (action.type === "navigate") {
@@ -2180,20 +2398,67 @@ var ActionQueueMachine = class {
       }
       const succeeded = await this.approveAction(action.id);
       if (!succeeded) {
+        const failed = this.state.actions.find((candidate) => candidate.id === action.id);
         this.warn(
           `ActionQueueMachine: stopping current action batch after failed action id="${action.id}"`
         );
+        await this.skipRemainingBatchActions(pending.slice(index + 1), action, failed?.error);
         break;
       }
       lastWasNavigate = action.type === "navigate";
     }
   }
+  /**
+   * A turn is an all-terminal contract: ChatSessionMachine cannot ask the
+   * server for the next step until every action in the current batch has
+   * reported a completion or an error. When an early action fails we must
+   * not execute dependent actions, but leaving them `pending` deadlocks the
+   * whole turn. Mark the untouched suffix as failed/skipped and emit the
+   * same terminal event a real executor would have emitted.
+   */
+  async skipRemainingBatchActions(remaining, failedAction, failureReason) {
+    const skipped = remaining.filter((candidate) => {
+      const current = this.state.actions.find((action) => action.id === candidate.id);
+      if (current?.status !== "pending" || this.processed.has(candidate.id)) return false;
+      if (candidate.type === "confirm") return false;
+      const gate = findGatingConfirm(candidate, this.state.actions);
+      if (gate && (gate.status === "pending" || gate.status === "executing")) return false;
+      return true;
+    });
+    if (skipped.length === 0) return;
+    const reason = `Skipped because previous action "${failedAction.id}" failed` + (failureReason ? `: ${failureReason}` : "");
+    const skippedIds = new Set(skipped.map((action) => action.id));
+    for (const action of skipped) this.processed.add(action.id);
+    this.updateActions(
+      (prev) => prev.map(
+        (action) => skippedIds.has(action.id) ? { ...action, status: "failed", error: reason } : action
+      )
+    );
+    for (const action of skipped) {
+      try {
+        await this.deps.client.completeAction(action.id, false, reason);
+      } catch {
+      }
+      this.deps.emit({
+        type: "agent:action:error",
+        timestamp: Date.now(),
+        data: {
+          actionId: action.id,
+          actionType: action.type,
+          success: false,
+          error: reason,
+          skipped: true,
+          blockedByActionId: failedAction.id
+        }
+      });
+    }
+  }
   // ── Approve & execute an action ─────────────────────────────
   async approveAction(actionId) {
     const action = this.state.actions.find((a) => a.id === actionId);
     if (!action) return false;
-    console.log(
-      `[Appilots] ActionQueueMachine: action status transition: pending \u2192 executing (id="${actionId}", type="${action.type}")`
+    appilotsDebugLog(
+      `ActionQueueMachine: action status transition: pending \u2192 executing (id="${actionId}", type="${action.type}")`
     );
     this.updateActions(
       (prev) => prev.map((a) => a.id === actionId ? { ...a, status: "executing" } : a)
@@ -2205,8 +2470,8 @@ var ActionQueueMachine = class {
         { confirmedDestructive }
       );
       if (result.success) {
-        console.log(
-          `[Appilots] ActionQueueMachine: action status transition: executing \u2192 completed (id="${actionId}", type="${action.type}")`
+        appilotsDebugLog(
+          `ActionQueueMachine: action status transition: executing \u2192 completed (id="${actionId}", type="${action.type}")`
         );
         this.updateActions(
           (prev) => prev.map((a) => a.id === actionId ? { ...a, status: "completed" } : a)
@@ -2285,9 +2550,7 @@ var ActionQueueMachine = class {
     return this.state.actions.filter((a) => a.status === "executing");
   }
   get completedActions() {
-    return this.state.actions.filter(
-      (a) => a.status === "completed" || a.status === "failed"
-    );
+    return this.state.actions.filter((a) => a.status === "completed" || a.status === "failed");
   }
 };
 function normalize3(s) {
@@ -2316,13 +2579,11 @@ function normalizeId(value) {
 function isOptionalCosmeticTargetId(targetId) {
   if (typeof targetId !== "string" || !targetId.trim()) return false;
   const id = normalizeId(targetId);
-  return /foto|photo|avatar|icone|icon|emoji|sheetaction|sheet-action|btn-foto/.test(id) || id.includes("photo-sheet");
+  return /sheetaction|sheet-action|photo-sheet|actionsheet|action-sheet/.test(id);
 }
 function routeLooksLikeFormContext(route) {
   const haystack = normalizeId(route ?? "");
-  return /create|edit|form|cadastr|register|novo|vehiclecreate|subscriptioncreate|vehicleedit|subscriptioncreate/.test(
-    haystack
-  );
+  return /create|edit|form|cadastr|criar|register|registr|novo|nova/.test(haystack);
 }
 function screenPathParts(screen) {
   if (!screen) return [];
@@ -2697,6 +2958,7 @@ function listItemElement(route, list, item) {
     list.id ?? list.label ?? `list-${list.index}`,
     key
   ]);
+  const provenance = item.itemKey || item.reactKey ? "declared" : label ? "derived" : "positional";
   const inModal = (item.buttons ?? []).some((button) => button.inModal) || (item.inputs ?? []).some((input) => input.inModal) || (item.toggles ?? []).some((toggle) => toggle.inModal);
   return {
     id,
@@ -2706,6 +2968,7 @@ function listItemElement(route, list, item) {
     actions: ["press"],
     disabled: false,
     source: "list",
+    provenance,
     targetId: item.syntheticId,
     ...inModal ? { inModal: true } : {},
     listContext: {
@@ -2735,17 +2998,14 @@ function buttonElement(route, button, index) {
     disabled: button.disabled,
     selected: button.selected,
     source: "button",
+    ...button.provenance ? { provenance: button.provenance } : {},
     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}`
-  ]);
+  const id = stableElementId(["input", route ?? "unknown", input.id ?? label ?? `input-${index}`]);
   return {
     id,
     role: "input",
@@ -2754,6 +3014,7 @@ function inputElement(route, input, index) {
     actions: ["focus", "setValue"],
     disabled: input.editable === false,
     source: "input",
+    ...input.provenance ? { provenance: input.provenance } : {},
     targetId: input.id ?? input.label ?? input.placeholder,
     ...input.inModal ? { inModal: true } : {}
   };
@@ -2773,10 +3034,45 @@ function toggleElement(route, toggle, index) {
     actions: ["toggle", "press"],
     selected: toggle.value,
     source: "toggle",
+    ...toggle.provenance ? { provenance: toggle.provenance } : {},
     targetId: toggle.id ?? toggle.label,
     ...toggle.inModal ? { inModal: true } : {}
   };
 }
+function listItemToggleElement(route, list, item, toggle, toggleIndex) {
+  const rowLabel = labelForListItem(item);
+  const label = toggle.label ?? rowLabel ?? toggle.id;
+  const key = item.itemKey ?? item.reactKey ?? rowLabel ?? item.syntheticId;
+  const id = stableElementId([
+    "toggle",
+    route ?? "unknown",
+    list.id ?? list.label ?? `list-${list.index}`,
+    key,
+    toggle.id ?? `toggle-${toggleIndex}`
+  ]);
+  return {
+    id,
+    role: "toggle",
+    label,
+    // The row's texts are what the user actually says out loud.
+    texts: uniqueTexts([label, ...item.texts ?? []]),
+    actions: ["toggle", "press"],
+    selected: toggle.value,
+    source: "list",
+    ...toggle.provenance ? { provenance: toggle.provenance } : {},
+    targetId: toggle.id,
+    listContext: {
+      listIndex: list.index,
+      listId: list.id,
+      listLabel: list.label,
+      itemIndex: item.index,
+      itemKey: item.itemKey,
+      reactKey: item.reactKey,
+      syntheticId: item.syntheticId
+    },
+    ...toggle.inModal ? { inModal: true } : {}
+  };
+}
 function sliderElement(route, slider, index) {
   const label = slider.label ?? slider.id;
   const id = stableElementId([
@@ -2792,37 +3088,48 @@ function sliderElement(route, slider, index) {
     actions: ["setValue"],
     disabled: slider.disabled,
     source: "slider",
+    ...slider.provenance ? { provenance: slider.provenance } : {},
     targetId: slider.id ?? slider.label,
     ...slider.inModal ? { inModal: true } : {}
   };
 }
-function deriveInteractionElements(snapshot) {
+function deriveInteractionElements(snapshot, options) {
   const elements = [];
   const seen = /* @__PURE__ */ new Set();
-  const push = (element) => {
+  const rectOf = options?.rectOf;
+  const push = (element, node) => {
     if (!element.id || seen.has(element.id)) return;
     seen.add(element.id);
-    elements.push(element);
+    const rect = rectOf && node !== void 0 ? rectOf(node) : void 0;
+    elements.push(rect ? { ...element, rect } : element);
   };
   for (const list of snapshot.lists ?? []) {
     for (const item of list.items ?? []) {
-      push(listItemElement(snapshot.route, list, item));
+      push(listItemElement(snapshot.route, list, item), item);
+      for (const [toggleIndex, toggle] of (item.toggles ?? []).entries()) {
+        push(listItemToggleElement(snapshot.route, list, item, toggle, toggleIndex), toggle);
+      }
     }
   }
   for (const [index, button] of (snapshot.buttons ?? []).entries()) {
-    push(buttonElement(snapshot.route, button, index));
+    push(buttonElement(snapshot.route, button, index), button);
   }
   for (const [index, input] of (snapshot.inputs ?? []).entries()) {
-    push(inputElement(snapshot.route, input, index));
+    push(inputElement(snapshot.route, input, index), input);
   }
   for (const [index, toggle] of (snapshot.toggles ?? []).entries()) {
-    push(toggleElement(snapshot.route, toggle, index));
+    push(toggleElement(snapshot.route, toggle, index), toggle);
   }
   for (const [index, slider] of (snapshot.sliders ?? []).entries()) {
-    push(sliderElement(snapshot.route, slider, index));
+    push(sliderElement(snapshot.route, slider, index), slider);
   }
   return elements;
 }
+function toWireElement(entry) {
+  if (entry.rect === void 0) return entry;
+  const { rect: _rect, ...wire } = entry;
+  return wire;
+}
 function findElementForChoice(elements, option) {
   if (option.targetId) {
     const byTarget = elements.find((element) => element.targetId === option.targetId);
@@ -2863,6 +3170,7 @@ var WIRE_LIMITS = {
   listItems: 500,
   listDataPreview: 500,
   listDataPreviewTextLength: 500,
+  scrollables: 20,
   choiceGroups: 100,
   choiceOptions: 200,
   elements: 1e3,
@@ -2943,6 +3251,9 @@ function clampSnapshotToWireLimits(snapshot) {
   snapshot.lists = (cut.array(snapshot.lists, WIRE_LIMITS.lists) ?? []).map(
     (list) => clampList(cut, list)
   );
+  if (snapshot.scrollables) {
+    snapshot.scrollables = cut.array(snapshot.scrollables, WIRE_LIMITS.scrollables);
+  }
   snapshot.choiceGroups = (cut.array(snapshot.choiceGroups, WIRE_LIMITS.choiceGroups) ?? []).map(
     (group) => clampChoiceGroup(cut, group)
   );
@@ -2970,7 +3281,9 @@ var ComponentRegistryImpl = class {
    */
   register(id, entry) {
     this.components.set(id, entry);
-    console.log(`[Appilots] ComponentRegistry.register: id="${id}" kind="${entry.kind}" \u2014 total count: ${this.components.size}`);
+    appilotsDebugLog(
+      `ComponentRegistry.register: id="${id}" kind="${entry.kind}" \u2014 total count: ${this.components.size}`
+    );
     this.notify(id, entry);
   }
   /**
@@ -2978,7 +3291,9 @@ var ComponentRegistryImpl = class {
    */
   unregister(id) {
     this.components.delete(id);
-    console.log(`[Appilots] ComponentRegistry.unregister: id="${id}" \u2014 total count: ${this.components.size}`);
+    appilotsDebugLog(
+      `ComponentRegistry.unregister: id="${id}" \u2014 total count: ${this.components.size}`
+    );
     this.notify(id, null);
   }
   /**
@@ -3082,14 +3397,14 @@ var ListRegistryImpl = class {
   listeners = /* @__PURE__ */ new Set();
   register(id, entry) {
     this.lists.set(id, entry);
-    console.log(
-      `[Appilots] ListRegistry.register: id="${id}" component="${entry.component}" items=${entry.itemCount ?? "unknown"} \u2014 total count: ${this.lists.size}`
+    appilotsDebugLog(
+      `ListRegistry.register: id="${id}" component="${entry.component}" items=${entry.itemCount ?? "unknown"} \u2014 total count: ${this.lists.size}`
     );
     this.notify(id, entry);
   }
   unregister(id) {
     this.lists.delete(id);
-    console.log(`[Appilots] ListRegistry.unregister: id="${id}" \u2014 total count: ${this.lists.size}`);
+    appilotsDebugLog(`ListRegistry.unregister: id="${id}" \u2014 total count: ${this.lists.size}`);
     this.notify(id, null);
   }
   get(id) {
@@ -3135,7 +3450,7 @@ var ElementRegistryImpl = class {
       next.set(element.id, element);
     }
     this.elements = next;
-    console.log(`[Appilots] ElementRegistry.replaceAll: elements=${this.elements.size}`);
+    appilotsDebugLog(`ElementRegistry.replaceAll: elements=${this.elements.size}`);
   }
   register(id, entry) {
     this.elements.set(id, entry);
@@ -3276,20 +3591,20 @@ function extractId(props) {
   if (raw && typeof raw === "string") {
     const normalized = normalizeId2(raw);
     if (normalized && normalized.length > 0) {
-      console.log(`[Appilots] extractId: raw="${raw}" \u2192 normalized="${normalized}"`);
+      appilotsDebugLog(`extractId: raw="${raw}" \u2192 normalized="${normalized}"`);
       return normalized;
     }
-    console.log(`[Appilots] extractId: raw="${raw}" normalized to empty string, falling back`);
+    appilotsDebugLog(`extractId: raw="${raw}" normalized to empty string, falling back`);
   }
   const hint = deriveSemanticInputId(props);
   if (hint) {
-    console.warn(
-      `[Appilots] extractId: no testID/nativeID/accessibilityLabel/name/placeholder/autoComplete on input \u2014 falling back to semantic hint "${hint}". Add testID to make this field reliably addressable.`
+    appilotsDebugWarn(
+      `extractId: no testID/nativeID/accessibilityLabel/name/placeholder/autoComplete on input \u2014 falling back to semantic hint "${hint}". Add testID to make this field reliably addressable.`
     );
     return hint;
   }
-  console.log(
-    "[Appilots] extractId: no identifiable prop found (testID/nativeID/accessibilityLabel/name/placeholder/autoComplete missing); skipping registration"
+  appilotsDebugLog(
+    "extractId: no identifiable prop found (testID/nativeID/accessibilityLabel/name/placeholder/autoComplete missing); skipping registration"
   );
   return null;
 }
@@ -3307,15 +3622,17 @@ var TrackedTextInput = React2__default.default.forwardRef(function TrackedTextIn
   onChangeRef.current = props.onChangeText;
   React2__default.default.useEffect(() => {
     if (!id) {
-      console.log("[Appilots] TrackedTextInput useEffect: no id extracted, skipping registration");
+      appilotsDebugLog("TrackedTextInput useEffect: no id extracted, skipping registration");
       return;
     }
-    console.log(`[Appilots] TrackedTextInput useEffect: registering field id="${id}" label="${extractLabel(props)}"`);
+    appilotsDebugLog(
+      `TrackedTextInput useEffect: registering field id="${id}" label="${extractLabel(props)}"`
+    );
     const entry = {
       kind: "field",
       getValue: () => valueRef.current,
       setValue: (v) => {
-        console.log(`[Appilots] TrackedTextInput setValue called: id="${id}" value="${v}"`);
+        appilotsDebugLog(`TrackedTextInput setValue: id="${id}" value=${describeValue(v)}`);
         onChangeRef.current?.(v);
         inputRef.current?.setNativeProps?.({ text: v });
       },
@@ -3325,15 +3642,18 @@ var TrackedTextInput = React2__default.default.forwardRef(function TrackedTextIn
     };
     registry.register(id, entry);
     return () => {
-      console.log(`[Appilots] TrackedTextInput useEffect cleanup: unregistering field id="${id}"`);
+      appilotsDebugLog(`TrackedTextInput useEffect cleanup: unregistering field id="${id}"`);
       registry.unregister(id);
     };
   }, [id]);
-  const mergedRef = React2__default.default.useCallback((instance) => {
-    inputRef.current = instance;
-    if (typeof forwardedRef === "function") forwardedRef(instance);
-    else if (forwardedRef && typeof forwardedRef === "object") forwardedRef.current = instance;
-  }, [forwardedRef]);
+  const mergedRef = React2__default.default.useCallback(
+    (instance) => {
+      inputRef.current = instance;
+      if (typeof forwardedRef === "function") forwardedRef(instance);
+      else if (forwardedRef && typeof forwardedRef === "object") forwardedRef.current = instance;
+    },
+    [forwardedRef]
+  );
   return _originalCreateElement(reactNative.TextInput, { ...props, ref: mergedRef });
 });
 var TrackedSwitch = React2__default.default.forwardRef(function TrackedSwitch2(props, forwardedRef) {
@@ -3345,22 +3665,24 @@ var TrackedSwitch = React2__default.default.forwardRef(function TrackedSwitch2(p
   onChangeRef.current = props.onValueChange;
   React2__default.default.useEffect(() => {
     if (!id) {
-      console.log("[Appilots] TrackedSwitch useEffect: no id extracted, skipping registration");
+      appilotsDebugLog("TrackedSwitch useEffect: no id extracted, skipping registration");
       return;
     }
-    console.log(`[Appilots] TrackedSwitch useEffect: registering toggle id="${id}" label="${extractLabel(props)}"`);
+    appilotsDebugLog(
+      `TrackedSwitch useEffect: registering toggle id="${id}" label="${extractLabel(props)}"`
+    );
     const entry = {
       kind: "toggle",
       getValue: () => valueRef.current,
       setValue: (v) => {
-        console.log(`[Appilots] TrackedSwitch setValue called: id="${id}" value=${v}`);
+        appilotsDebugLog(`TrackedSwitch setValue called: id="${id}" value=${v}`);
         onChangeRef.current?.(v);
       },
       label: extractLabel(props)
     };
     registry.register(id, entry);
     return () => {
-      console.log(`[Appilots] TrackedSwitch useEffect cleanup: unregistering toggle id="${id}"`);
+      appilotsDebugLog(`TrackedSwitch useEffect cleanup: unregistering toggle id="${id}"`);
       registry.unregister(id);
     };
   }, [id]);
@@ -3380,21 +3702,25 @@ function getTrackedPressable(OriginalComponent) {
         return;
       }
       if (!id || !props.onPress) {
-        console.log(`[Appilots] TrackedPressable useEffect: skipping registration (id=${id}, hasOnPress=${!!props.onPress})`);
+        appilotsDebugLog(
+          `TrackedPressable useEffect: skipping registration (id=${id}, hasOnPress=${!!props.onPress})`
+        );
         return;
       }
-      console.log(`[Appilots] TrackedPressable useEffect: registering target id="${id}" label="${extractLabel(props)}"`);
+      appilotsDebugLog(
+        `TrackedPressable useEffect: registering target id="${id}" label="${extractLabel(props)}"`
+      );
       const entry = {
         kind: "target",
         press: () => {
-          console.log(`[Appilots] TrackedPressable press called: id="${id}"`);
+          appilotsDebugLog(`TrackedPressable press called: id="${id}"`);
           onPressRef.current?.();
         },
         label: extractLabel(props)
       };
       registry.register(id, entry);
       return () => {
-        console.log(`[Appilots] TrackedPressable useEffect cleanup: unregistering target id="${id}"`);
+        appilotsDebugLog(`TrackedPressable useEffect cleanup: unregistering target id="${id}"`);
         registry.unregister(id);
       };
     }, [id, !!props.onPress]);
@@ -3403,12 +3729,7 @@ function getTrackedPressable(OriginalComponent) {
   _pressableWrapperCache.set(OriginalComponent, cached);
   return cached;
 }
-var LIST_COMPONENT_NAMES = /* @__PURE__ */ new Set([
-  "FlatList",
-  "SectionList",
-  "VirtualizedList",
-  "FlashList"
-]);
+var LIST_COMPONENT_NAMES = /* @__PURE__ */ new Set(["FlatList", "SectionList", "VirtualizedList", "FlashList"]);
 var _listWrapperCache = /* @__PURE__ */ new Map();
 var _generatedListIdCounter = 0;
 function componentDisplayName(type) {
@@ -3462,12 +3783,10 @@ var PREVIEW_TEXT_KEYS = [
   "label",
   "description",
   "descricao",
-  "plate",
-  "placa",
-  "model",
-  "modelo",
   "email",
-  "username"
+  "username",
+  "code",
+  "codigo"
 ];
 function projectItemText(item) {
   if (item == null) return "";
@@ -3563,10 +3882,7 @@ function getTrackedList(OriginalComponent, componentName) {
     const itemCount = resolveItemCount(props);
     const refreshing = props.refreshing === true;
     const label = listLabel(props);
-    const dataPreview = React2__default.default.useMemo(
-      () => buildDataPreview(props),
-      [props.data, props.sections]
-    );
+    const dataPreview = React2__default.default.useMemo(() => buildDataPreview(props), [props.data, props.sections]);
     const mergedRef = React2__default.default.useCallback(
       (instance) => {
         instanceRef.current = instance;
@@ -3601,7 +3917,7 @@ function getTrackedList(OriginalComponent, componentName) {
             }
             return false;
           } catch (err) {
-            console.warn(`[Appilots] TrackedList scrollToIndex failed for "${listId}":`, err);
+            appilotsDebugWarn(`TrackedList scrollToIndex failed for "${listId}":`, err);
             return false;
           }
         },
@@ -3620,7 +3936,7 @@ function getTrackedList(OriginalComponent, componentName) {
             }
             return false;
           } catch (err) {
-            console.warn(`[Appilots] TrackedList scrollToOffset failed for "${listId}":`, err);
+            appilotsDebugWarn(`TrackedList scrollToOffset failed for "${listId}":`, err);
             return false;
           }
         },
@@ -3664,26 +3980,148 @@ function getTrackedList(OriginalComponent, componentName) {
   _listWrapperCache.set(OriginalComponent, cached);
   return cached;
 }
-var _enabled = false;
+var SCROLLABLE_COMPONENT_NAMES = /* @__PURE__ */ new Set(["ScrollView", "KeyboardAwareScrollView"]);
+var _scrollWrapperCache = /* @__PURE__ */ new Map();
+var _generatedScrollIdCounter = 0;
+function extractScrollId(props, componentName) {
+  const raw = props?.appilotsScrollId ?? props?.testID ?? props?.accessibilityLabel;
+  if (typeof raw === "string" && raw.trim().length > 0) return raw.trim();
+  _generatedScrollIdCounter += 1;
+  return `${componentName.toLowerCase()}-${_generatedScrollIdCounter}`;
+}
+function chain(appHandler, ours) {
+  return ((...args) => {
+    if (typeof appHandler === "function") {
+      try {
+        appHandler(...args);
+      } catch (err) {
+        appilotsDebugWarn("TrackedScrollView: app scroll handler threw:", err);
+      }
+    }
+    ours(...args);
+  });
+}
+function getTrackedScrollView(OriginalComponent, componentName) {
+  let cached = _scrollWrapperCache.get(OriginalComponent);
+  if (cached) return cached;
+  cached = React2__default.default.forwardRef(function TrackedScrollView(props, forwardedRef) {
+    const idRef = React2__default.default.useRef(null);
+    if (!idRef.current) idRef.current = extractScrollId(props, componentName);
+    const scrollId = idRef.current;
+    const instanceRef = React2__default.default.useRef(null);
+    const metricsRef = React2__default.default.useRef({
+      offset: 0,
+      visibleLength: 0,
+      contentLength: 0
+    });
+    const horizontal = props.horizontal === true;
+    const mergedRef = React2__default.default.useCallback(
+      (instance) => {
+        instanceRef.current = instance;
+        if (typeof forwardedRef === "function") forwardedRef(instance);
+        else if (forwardedRef && typeof forwardedRef === "object") forwardedRef.current = instance;
+      },
+      [forwardedRef]
+    );
+    const label = typeof props.appilotsScrollLabel === "string" ? props.appilotsScrollLabel : typeof props.accessibilityLabel === "string" ? props.accessibilityLabel : void 0;
+    React2__default.default.useEffect(() => {
+      listRegistry.register(scrollId, {
+        kind: "scroll",
+        id: scrollId,
+        component: componentName,
+        label,
+        scrollToOffset: (offset) => {
+          const instance = instanceRef.current;
+          if (!instance) return false;
+          try {
+            const scrollTo = typeof instance.scrollTo === "function" ? instance.scrollTo.bind(instance) : typeof instance.getScrollResponder === "function" ? instance.getScrollResponder()?.scrollTo?.bind(instance.getScrollResponder()) : void 0;
+            if (typeof scrollTo !== "function") return false;
+            scrollTo(horizontal ? { x: offset, animated: true } : { y: offset, animated: true });
+            metricsRef.current = { ...metricsRef.current, offset };
+            return true;
+          } catch (err) {
+            appilotsDebugWarn(`TrackedScrollView scrollTo failed for "${scrollId}":`, err);
+            return false;
+          }
+        },
+        getScrollMetrics: () => {
+          const m = metricsRef.current;
+          return m.contentLength > 0 ? { ...m } : void 0;
+        }
+      });
+      return () => {
+        listRegistry.unregister(scrollId);
+      };
+    }, [scrollId, label, horizontal]);
+    const onScroll = React2__default.default.useMemo(
+      () => chain(props.onScroll, (event) => {
+        const n = event?.nativeEvent;
+        if (!n) return;
+        const offset = horizontal ? n.contentOffset?.x : n.contentOffset?.y;
+        const visible = horizontal ? n.layoutMeasurement?.width : n.layoutMeasurement?.height;
+        const content = horizontal ? n.contentSize?.width : n.contentSize?.height;
+        metricsRef.current = {
+          offset: typeof offset === "number" ? offset : metricsRef.current.offset,
+          visibleLength: typeof visible === "number" ? visible : metricsRef.current.visibleLength,
+          contentLength: typeof content === "number" ? content : metricsRef.current.contentLength
+        };
+      }),
+      [props.onScroll, horizontal]
+    );
+    const onLayout = React2__default.default.useMemo(
+      () => chain(props.onLayout, (event) => {
+        const size = horizontal ? event?.nativeEvent?.layout?.width : event?.nativeEvent?.layout?.height;
+        if (typeof size === "number") {
+          metricsRef.current = { ...metricsRef.current, visibleLength: size };
+        }
+      }),
+      [props.onLayout, horizontal]
+    );
+    const onContentSizeChange = React2__default.default.useMemo(
+      () => chain(props.onContentSizeChange, (w, h) => {
+        const size = horizontal ? w : h;
+        if (typeof size === "number") {
+          metricsRef.current = { ...metricsRef.current, contentLength: size };
+        }
+      }),
+      [props.onContentSizeChange, horizontal]
+    );
+    return _originalCreateElement(OriginalComponent, {
+      ...props,
+      ref: mergedRef,
+      // Without a throttle iOS fires `onScroll` once per gesture, which
+      // is enough to stay roughly in sync but leaves the offset stale
+      // mid-fling. 16ms is RN's own recommendation for live metrics.
+      scrollEventThrottle: props.scrollEventThrottle ?? 16,
+      onScroll,
+      onLayout,
+      onContentSizeChange,
+      __appilotsScrollId: scrollId
+    });
+  });
+  _scrollWrapperCache.set(OriginalComponent, cached);
+  return cached;
+}
+var _enabled2 = false;
 function enableAppilotsAutoTracking(options) {
-  if (_enabled) return;
-  _enabled = true;
+  if (_enabled2) return;
+  _enabled2 = true;
   const { trackPressable = true, debug = false } = options ?? {};
   if (debug) {
     componentRegistry.subscribe((id, entry) => {
       if (entry) {
-        console.log(`[Appilots] Registered ${entry.kind}: "${id}" (${entry.label ?? "no label"})`);
+        appilotsDebugLog(`Registered ${entry.kind}: "${id}" (${entry.label ?? "no label"})`);
       } else {
-        console.log(`[Appilots] Unregistered: "${id}"`);
+        appilotsDebugLog(`Unregistered: "${id}"`);
       }
     });
     listRegistry.subscribe((id, entry) => {
       if (entry) {
-        console.log(
-          `[Appilots] Registered list: "${id}" (${entry.component}, items=${entry.itemCount ?? "unknown"})`
+        appilotsDebugLog(
+          `Registered list: "${id}" (${entry.component}, items=${entry.itemCount ?? "unknown"})`
         );
       } else {
-        console.log(`[Appilots] Unregistered list: "${id}"`);
+        appilotsDebugLog(`Unregistered list: "${id}"`);
       }
     });
   }
@@ -3691,12 +4129,14 @@ function enableAppilotsAutoTracking(options) {
   _originalCreateElement = originalCreateElement;
   function isComponent(type, target, name) {
     if (type === target) {
-      console.log(`[Appilots] isComponent: matched "${name}" by reference equality`);
+      appilotsDebugLog(`isComponent: matched "${name}" by reference equality`);
       return true;
     }
     const dn = type?.displayName || type?.name || "";
     if (dn === name) {
-      console.log(`[Appilots] isComponent: matched "${name}" by displayName/name (reference equality failed \u2014 possible monorepo issue)`);
+      appilotsDebugLog(
+        `isComponent: matched "${name}" by displayName/name (reference equality failed \u2014 possible monorepo issue)`
+      );
       return true;
     }
     return false;
@@ -3705,24 +4145,36 @@ function enableAppilotsAutoTracking(options) {
     if (!props || !type || props.__appilotsInternal) return null;
     const displayName = componentDisplayName(type);
     if (LIST_COMPONENT_NAMES.has(displayName)) {
-      console.log(`[Appilots] intercepted list component "${displayName}"`);
+      appilotsDebugLog(`intercepted list component "${displayName}"`);
       return { type: getTrackedList(type, displayName), props };
     }
+    if (SCROLLABLE_COMPONENT_NAMES.has(displayName)) {
+      appilotsDebugLog(`intercepted scrollable "${displayName}"`);
+      return { type: getTrackedScrollView(type, displayName), props };
+    }
     if (isComponent(type, reactNative.TextInput, "TextInput")) {
       if (props.testID || props.accessibilityLabel || props.placeholder) {
-        console.log(`[Appilots] intercepted TextInput (testID="${props.testID}", label="${props.accessibilityLabel}", placeholder="${props.placeholder}")`);
+        appilotsDebugLog(
+          // Ids, not the user-facing copy: a placeholder is the app's
+          // own text and often the most identifying string on screen.
+          `intercepted TextInput (testID="${props.testID ?? "?"}" hasLabel=${!!props.accessibilityLabel} hasPlaceholder=${!!props.placeholder})`
+        );
         return { type: TrackedTextInput, props };
       }
     }
     if (isComponent(type, reactNative.Switch, "Switch")) {
       if (props.testID || props.accessibilityLabel) {
-        console.log(`[Appilots] intercepted Switch (testID="${props.testID}", label="${props.accessibilityLabel}")`);
+        appilotsDebugLog(
+          `intercepted Switch (testID="${props.testID}", label="${props.accessibilityLabel}")`
+        );
         return { type: TrackedSwitch, props };
       }
     }
     if (isComponent(type, reactNative.TouchableOpacity, "TouchableOpacity") || trackPressable && isComponent(type, reactNative.Pressable, "Pressable")) {
       if ((props.testID || props.accessibilityLabel) && props.onPress) {
-        console.log(`[Appilots] intercepted Pressable/TouchableOpacity (testID="${props.testID}", label="${props.accessibilityLabel}")`);
+        appilotsDebugLog(
+          `intercepted Pressable/TouchableOpacity (testID="${props.testID}", label="${props.accessibilityLabel}")`
+        );
         return { type: getTrackedPressable(type), props };
       }
     }
@@ -3736,14 +4188,17 @@ function enableAppilotsAutoTracking(options) {
     }
     return originalCreateElement(type, props, ...children);
   };
-  console.log("[Appilots] Auto-tracking: React.createElement patched");
+  _createElementPatched = true;
+  appilotsDebugLog("Auto-tracking: React.createElement patched");
   try {
     const jsxRuntime = __require("react/jsx-runtime");
     if (jsxRuntime) {
       _patchJsxRuntimeModule(jsxRuntime);
     }
   } catch (e) {
-    console.log("[Appilots] Auto-tracking: react/jsx-runtime not available internally (will be patched by metro shim)");
+    appilotsDebugLog(
+      "Auto-tracking: react/jsx-runtime not available internally (will be patched by metro shim)"
+    );
   }
   try {
     const jsxDevRuntime = __require("react/jsx-dev-runtime");
@@ -3751,11 +4206,14 @@ function enableAppilotsAutoTracking(options) {
       _patchJsxDevRuntimeModule(jsxDevRuntime);
     }
   } catch (e) {
-    console.log("[Appilots] Auto-tracking: react/jsx-dev-runtime not available internally (will be patched by metro shim)");
+    appilotsDebugLog(
+      "Auto-tracking: react/jsx-dev-runtime not available internally (will be patched by metro shim)"
+    );
   }
 }
 var _jsxRuntimePatched = false;
 var _jsxDevRuntimePatched = false;
+var _createElementPatched = false;
 function _patchJsxRuntimeModule(jsxRuntime) {
   if (_jsxRuntimePatched || !isInterceptionActive() || !jsxRuntime) return;
   _jsxRuntimePatched = true;
@@ -3769,7 +4227,7 @@ function _patchJsxRuntimeModule(jsxRuntime) {
       }
       return origJsx(type, props, key);
     };
-    console.log("[Appilots] Auto-tracking: react/jsx-runtime jsx() patched");
+    appilotsDebugLog("Auto-tracking: react/jsx-runtime jsx() patched");
   }
   if (origJsxs) {
     jsxRuntime.jsxs = function(type, props, key) {
@@ -3779,7 +4237,7 @@ function _patchJsxRuntimeModule(jsxRuntime) {
       }
       return origJsxs(type, props, key);
     };
-    console.log("[Appilots] Auto-tracking: react/jsx-runtime jsxs() patched");
+    appilotsDebugLog("Auto-tracking: react/jsx-runtime jsxs() patched");
   }
 }
 function _patchJsxDevRuntimeModule(jsxDevRuntime) {
@@ -3794,58 +4252,75 @@ function _patchJsxDevRuntimeModule(jsxDevRuntime) {
       }
       return origJsxDEV(type, props, key, isStaticChildren, source, self);
     };
-    console.log("[Appilots] Auto-tracking: react/jsx-dev-runtime jsxDEV() patched");
+    appilotsDebugLog("Auto-tracking: react/jsx-dev-runtime jsxDEV() patched");
   }
 }
 function _patchJsxRuntimes(jsxRuntime, jsxDevRuntime) {
   if (!isInterceptionActive()) {
-    console.warn("[Appilots] _patchJsxRuntimes called but auto-tracking is not enabled");
+    appilotsDebugWarn("_patchJsxRuntimes called but auto-tracking is not enabled");
     return;
   }
-  console.log("[Appilots] _patchJsxRuntimes: patching from app context (metro shim)");
+  appilotsDebugLog("_patchJsxRuntimes: patching from app context (metro shim)");
   if (jsxRuntime) _patchJsxRuntimeModule(jsxRuntime);
   if (jsxDevRuntime) _patchJsxDevRuntimeModule(jsxDevRuntime);
 }
 function isAutoTrackingEnabled() {
-  return _enabled;
+  return _enabled2;
+}
+function getAutoTrackingState() {
+  return {
+    enabled: _enabled2,
+    createElementPatched: _createElementPatched,
+    jsxRuntimePatched: _jsxRuntimePatched,
+    jsxDevRuntimePatched: _jsxDevRuntimePatched,
+    interceptionActive: isInterceptionActive()
+  };
 }
 
 // src/core/initAppilots.ts
 var _globalConfig = null;
 var _autoConfigAttempted = false;
 function initAppilots(config) {
-  console.log(`[Appilots] initAppilots called with config: projectId="${config.projectId}", apiBaseUrl="${config.apiBaseUrl ?? config.apiUrl ?? "default"}", debug=${config.debug ?? false}, autoTracking=${JSON.stringify(config.autoTracking ?? {})}`);
-  if (config.apiUrl && !config.apiBaseUrl) {
-    config.apiBaseUrl = config.apiUrl;
+  appilotsDebugLog(
+    `initAppilots called with config: projectId="${config.projectId}", apiBaseUrl="${config.apiBaseUrl ?? config.apiUrl ?? "default"}", debug=${config.debug ?? false}, autoTracking=${JSON.stringify(config.autoTracking ?? {})}`
+  );
+  if (!config.apiBaseUrl) {
+    config.apiBaseUrl = config.apiUrl ?? config.serverUrl;
   }
   _globalConfig = config;
   const autoTrackingEnabled = config.autoTracking?.enabled !== false;
   if (autoTrackingEnabled) {
-    console.log("[Appilots] initAppilots: auto-tracking is enabled, calling enableAppilotsAutoTracking()");
+    appilotsDebugLog(
+      "initAppilots: auto-tracking is enabled, calling enableAppilotsAutoTracking()"
+    );
     enableAppilotsAutoTracking({
       trackPressable: config.autoTracking?.trackPressable ?? true,
       debug: config.debug ?? false
     });
   } else {
-    console.log("[Appilots] initAppilots: auto-tracking is explicitly disabled");
+    appilotsDebugLog("initAppilots: auto-tracking is explicitly disabled");
   }
 }
 function tryAutoConfig() {
   if (_globalConfig || _autoConfigAttempted) {
-    console.log(`[Appilots] tryAutoConfig: skipping (alreadyConfigured=${!!_globalConfig}, alreadyAttempted=${_autoConfigAttempted})`);
+    appilotsDebugLog(
+      `tryAutoConfig: skipping (alreadyConfigured=${!!_globalConfig}, alreadyAttempted=${_autoConfigAttempted})`
+    );
     return;
   }
   _autoConfigAttempted = true;
   try {
     const rc = globalThis.__APPILOTS_RC__;
     if (rc && typeof rc === "object" && rc.projectId) {
-      console.log(`[Appilots] tryAutoConfig: found globalThis.__APPILOTS_RC__ with projectId="${rc.projectId}"`);
+      appilotsDebugLog(
+        `tryAutoConfig: found globalThis.__APPILOTS_RC__ with projectId="${rc.projectId}"`
+      );
       initAppilots(rc);
     } else {
-      console.log("[Appilots] tryAutoConfig: globalThis.__APPILOTS_RC__ not found or missing projectId");
+      appilotsDebugLog("tryAutoConfig: globalThis.__APPILOTS_RC__ not found or missing projectId");
     }
   } catch {
-    console.warn("[Appilots] tryAutoConfig: error reading globalThis.__APPILOTS_RC__");
+    appilotsDebugWarn("tryAutoConfig: error reading globalThis.__APPILOTS_RC__");
   }
 }
 function getGlobalConfig() {
@@ -3862,7 +4337,7 @@ var _diagnostics = {
 };
 function setFiberRoot(fiber) {
   if (_fiberRoot !== fiber) {
-    console.log(`[Appilots] Introspection: fiber root captured (type=${typeName(fiber)})`);
+    appilotsDebugLog(`Introspection: fiber root captured (type=${typeName(fiber)})`);
     _fiberRoot = fiber;
   }
   _diagnostics.captured = true;
@@ -3899,262 +4374,976 @@ function typeName(fiber) {
   if (!t) return "unknown";
   if (typeof t === "string") return t;
   if (typeof t === "function") return t.displayName ?? t.name ?? "anonymous";
-  if (typeof t === "object") return t.displayName ?? t.render?.displayName ?? t.render?.name ?? "forwardRef/memo";
+  if (typeof t === "object")
+    return t.displayName ?? t.render?.displayName ?? t.render?.name ?? "forwardRef/memo";
   return String(t);
 }
 
-// src/version.ts
-var SDK_VERSION2 = "0.8.0";
-var FiberSentinel = class extends React2__default.default.Component {
-  componentDidMount() {
-    const fiber = this._reactInternals ?? this._reactInternalFiber ?? null;
-    if (!fiber) {
-      const reactVersion = React2__default.default.version ?? null;
-      console.warn(
-        `[Appilots] FiberSentinel: this._reactInternals is undefined; snapshot capture will fall back to render-time owner. React version may be incompatible (react=${reactVersion}).`
-      );
-      recordIntrospectionFailure("sentinel-missing-internals", reactVersion);
-      this.props.onUnavailable?.({ reactVersion });
-      return;
+// src/introspection/textPolicy.ts
+function isReferenceable(text) {
+  return typeof text === "string" && /[\p{L}\p{N}]/u.test(text);
+}
+function foldLatinDiacritics(text) {
+  return text.normalize("NFD").replace(/[\u0300-\u036f]/g, "").normalize("NFC");
+}
+function foldForCompare(text) {
+  if (!text) return "";
+  return foldLatinDiacritics(text.toLowerCase()).replace(/[^\p{L}\p{N}]/gu, "");
+}
+function labelToId(label) {
+  if (!label) return "";
+  return foldLatinDiacritics(label.toLowerCase()).replace(/[^\p{L}\p{N}\s]/gu, "").trim().replace(/\s+(.)/gu, (_, c) => c.toUpperCase()).replace(/\s+/gu, "");
+}
+
+// src/introspection/geometry.ts
+var _host = null;
+var _asked = 0;
+var _answered = 0;
+function setGeometryHost(host) {
+  _host = host;
+  _asked = 0;
+  _answered = 0;
+}
+function geometryAvailability() {
+  if (!_host) return "unavailable";
+  if (_asked > 0 && _answered === 0) return "silent";
+  return "available";
+}
+function geometryStats() {
+  return { asked: _asked, answered: _answered };
+}
+function isUsableRect(rect) {
+  return !!rect && Number.isFinite(rect.x) && Number.isFinite(rect.y) && Number.isFinite(rect.width) && Number.isFinite(rect.height);
+}
+var HOST_SEARCH_DEPTH = 6;
+function rectOfFiber(fiber) {
+  const host = _host;
+  if (!host || !fiber) return null;
+  const stack = [{ node: fiber, depth: 0 }];
+  let consulted = false;
+  while (stack.length > 0) {
+    const { node, depth } = stack.pop();
+    const current = node;
+    if (!current) continue;
+    if (current.stateNode) {
+      consulted = true;
+      let rect = null;
+      try {
+        rect = host.rectOf(current.stateNode);
+      } catch {
+        rect = null;
+      }
+      if (isUsableRect(rect)) {
+        _asked += 1;
+        _answered += 1;
+        return rect;
+      }
+    }
+    if (depth < HOST_SEARCH_DEPTH && current.child) {
+      stack.push({ node: current.child, depth: depth + 1 });
+      const sibling = current.child.sibling;
+      if (sibling) stack.push({ node: sibling, depth: depth + 1 });
     }
-    let top = fiber;
-    while (top.return) top = top.return;
-    setFiberRoot(top);
-  }
-  render() {
-    return this.props.children ?? null;
-  }
-};
-function AppilotsFiberRoot({
-  children,
-  onUnavailable
-}) {
-  const Internals = React2__default.default.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED_IN_THIS_VERSION_OF_REACT;
-  const ownerFiber = Internals?.ReactCurrentOwner?.current;
-  if (ownerFiber && !getFiberRoot()) {
-    setFiberRoot(ownerFiber);
   }
-  return /* @__PURE__ */ React2__default.default.createElement(FiberSentinel, { onUnavailable }, children);
+  if (consulted) _asked += 1;
+  return null;
 }
-
-// src/debug/logger.ts
-var debugOverride;
-function setAppilotsDebugEnabled(enabled) {
-  debugOverride = enabled;
+function isRectOnScreen(rect, window) {
+  if (rect.width <= 0 || rect.height <= 0) return false;
+  if (rect.x >= window.width || rect.y >= window.height) return false;
+  if (rect.x + rect.width <= 0 || rect.y + rect.height <= 0) return false;
+  return true;
 }
-function isDebugEnabled() {
-  if (debugOverride !== void 0) return debugOverride;
-  return getGlobalConfig()?.debug === true;
+var _rectByNode = /* @__PURE__ */ new WeakMap();
+function readGeometry(fiber) {
+  const host = _host;
+  if (!host) return { rect: null, fields: {} };
+  const rect = rectOfFiber(fiber);
+  if (!rect) return { rect: null, fields: {} };
+  return { rect, fields: { onScreen: isRectOnScreen(rect, host.window) } };
 }
-function appilotsDebugLog(...args) {
-  if (!isDebugEnabled()) return;
-  console.log("[Appilots]", ...args);
+function withRect(node, reading) {
+  if (reading.rect) _rectByNode.set(node, reading.rect);
+  return node;
 }
-function appilotsDebugWarn(...args) {
-  if (!isDebugEnabled()) return;
-  console.log("[Appilots]", ...args);
+function rectForNode(node) {
+  if (!node || typeof node !== "object") return void 0;
+  return _rectByNode.get(node);
 }
-var AppilotsErrorBoundary = class extends React2__default.default.Component {
-  state = { degraded: false, escalate: null };
-  /**
-   * Instance field rather than state: `componentDidCatch` needs to know
-   * whether THIS is the first failure, and by the time it runs
-   * `getDerivedStateFromError` has already flipped `state.degraded`.
-   */
-  hasDegradedOnce = false;
-  static getDerivedStateFromError() {
-    return { degraded: true };
+
+// 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;
   }
-  componentDidCatch(error, info) {
-    if (this.hasDegradedOnce) {
-      this.setState({ escalate: error ?? new Error("Appilots: re-thrown host render error") });
-      return;
-    }
-    this.hasDegradedOnce = true;
-    console.error(
-      `[Appilots] The Appilots ${this.props.surface} threw while rendering and has been disabled for the rest of this session. Your app keeps running \u2014 this is an Appilots bug, not a bug in your code. Please report it with the stack below: https://github.com/Axtern-Labs/Appilots/issues`,
-      error
-    );
-    try {
-      this.props.onError?.(error, info?.componentStack ?? null);
-    } catch {
+  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);
   }
-  render() {
-    if (this.state.escalate !== null) throw this.state.escalate;
-    if (this.state.degraded) return this.props.fallback;
-    return this.props.children;
+  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("");
   }
-};
-
-// src/context/AppilotsProvider.tsx
-var AppilotsContext = React2.createContext(null);
-function createInertClient() {
-  const unavailable = () => Promise.reject(
-    new Error("Appilots is unavailable: the SDK degraded after a render error.")
-  );
-  return new Proxy({}, {
-    get: (_target, prop) => {
-      if (prop === "then" || typeof prop === "symbol") return void 0;
-      return unavailable;
+  return "";
+}
+function findChildText(fiber) {
+  const stack = [];
+  if (fiber.child) stack.push(fiber.child);
+  const visited = /* @__PURE__ */ new WeakSet();
+  const texts = [];
+  const glyphs = [];
+  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 (isReferenceable(trimmed)) {
+        texts.push(trimmed);
+        if (texts.length >= 3) break;
+      } else if (trimmed && glyphs.length < 3) {
+        glyphs.push(trimmed);
+      }
+    }
+    if (node.sibling) stack.push(node.sibling);
+    if (node.child) stack.push(node.child);
+  }
+  if (texts.length > 0) return texts.join(" \xB7 ");
+  return glyphs.length > 0 ? glyphs.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 typeName2 = getTypeName(fiber.type) ?? getTypeName(fiber.elementType);
+  if (typeName2 && SELF_REFERENTIAL_COMPONENTS.has(typeName2)) 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;
+    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 resolveIdentity(props, label) {
+  const declared = stringProp(props, "testID") ?? stringProp(props, "accessibilityLabel");
+  if (declared) return { id: declared, provenance: "declared" };
+  const derived = labelToId(label);
+  if (derived) return { id: derived, provenance: "derived" };
+  return { provenance: "positional" };
+}
+function isSwitchLike(fiber, props) {
+  if (props?.accessibilityRole === "switch" || props?.role === "switch") return true;
+  return matchesName(fiber, "Switch");
+}
+function switchValue(props) {
+  if (typeof props?.value === "boolean") return props.value;
+  const checked = props?.accessibilityState?.checked;
+  return checked === true;
+}
+function nearbyLabelForSwitch(fiber) {
+  let parent = fiber?.return;
+  for (let depth = 0; parent && depth < 3; depth++, parent = parent.return) {
+    const text = findChildText(parent);
+    if (text && isReferenceable(text)) return text;
+  }
+  return 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 looksLikeListContainerByProps(props) {
+  if (!props || typeof props !== "object") return false;
+  if (typeof props.renderItem !== "function") return false;
+  if (Array.isArray(props.sections)) return true;
+  if (Array.isArray(props.data)) return true;
+  return typeof props.getItemCount === "function" && typeof props.getItem === "function";
+}
+function isAlwaysListContainer(fiber) {
+  for (const name of ALWAYS_LIST_NAMES) {
+    if (matchesName(fiber, name)) return true;
+  }
+  return looksLikeListContainerByProps(fiber?.memoizedProps);
+}
+function isHeuristicListContainer(fiber) {
+  for (const name of HEURISTIC_LIST_NAMES) {
+    if (matchesName(fiber, name)) return true;
+  }
+  return false;
+}
+function isKnownListCell(fiber) {
+  const typeName2 = getTypeName(fiber.type) ?? getTypeName(fiber.elementType);
+  return !!typeName2 && LIST_CELL_NAMES.has(typeName2);
+}
+var MODAL_HOST_NAMES = /* @__PURE__ */ new Set(["RCTModalHostView", "ModalHostView"]);
+function isModalHostFiber(fiber) {
+  const type = fiber?.type;
+  return typeof type === "string" && MODAL_HOST_NAMES.has(type);
+}
+function isModalFiber(fiber) {
+  return matchesName(fiber, "Modal") || isModalHostFiber(fiber);
+}
+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") ?? // A ScrollView that turned out to hold keyed rows is BOTH: the
+  // walker sees a list, auto-tracking registered a scrollable. Sharing
+  // the id lets the two merge instead of describing one surface twice.
+  stringProp(props, "__appilotsScrollId");
+}
+function explicitListIdFromProps(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 (isAlwaysListContainer(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 createDegradedContext(config) {
+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 emptyDetectorCounts() {
   return {
-    config: config ?? { projectId: "" },
-    client: createInertClient(),
-    subscribe: () => () => {
-    },
-    emit: () => {
-    },
-    remotePersonalization: null,
-    degraded: true
+    Text: 0,
+    TextInput: 0,
+    Switch: 0,
+    ActivityIndicator: 0,
+    Modal: 0,
+    adjustable: 0,
+    pressable: 0,
+    listContainers: 0
   };
 }
-function AppilotsProvider({ config, children, client }) {
-  return /* @__PURE__ */ React2__default.default.createElement(
-    AppilotsErrorBoundary,
-    {
-      surface: "provider",
-      onError: reportProviderRenderFailure,
-      fallback: /* @__PURE__ */ React2__default.default.createElement(AppilotsContext.Provider, { value: createDegradedContext(config ?? null) }, children)
-    },
-    /* @__PURE__ */ React2__default.default.createElement(AppilotsProviderInner, { config, client }, children)
-  );
+function totalDetectorHits(counts) {
+  return counts.Text + counts.TextInput + counts.Switch + counts.ActivityIndicator + counts.Modal + counts.adjustable + counts.pressable + counts.listContainers;
 }
-function reportProviderRenderFailure() {
-  recordRenderFailure(readReactVersion());
+function addDetectorCounts(into, from) {
+  into.Text += from.Text;
+  into.TextInput += from.TextInput;
+  into.Switch += from.Switch;
+  into.ActivityIndicator += from.ActivityIndicator;
+  into.Modal += from.Modal;
+  into.adjustable += from.adjustable;
+  into.pressable += from.pressable;
+  into.listContainers += from.listContainers;
 }
-function readReactVersion() {
-  const version = React2__default.default.version;
-  return typeof version === "string" ? version : null;
+var _lastWalk = null;
+function getLastWalkDiagnostics() {
+  return _lastWalk ? { ..._lastWalk, detectors: { ..._lastWalk.detectors } } : null;
 }
-function AppilotsProviderInner({ config: configProp, children, client: externalClient }) {
-  console.log(`[Appilots] AppilotsProvider initializing \u2014 config source: ${configProp ? "prop" : "auto (globalThis.__APPILOTS_RC__)"}`);
-  tryAutoConfig();
-  const globalConfig = getGlobalConfig();
-  console.log(`[Appilots] AppilotsProvider: configProp=${!!configProp}, globalConfig=${!!globalConfig}`);
-  const config = configProp ?? (globalConfig ? {
-    projectId: globalConfig.projectId,
-    apiBaseUrl: globalConfig.apiBaseUrl,
-    apiKey: globalConfig.apiKey,
-    permissions: globalConfig.permissions,
-    debug: globalConfig.debug,
-    appVersion: globalConfig.appVersion,
-    mcpVersion: globalConfig.mcpVersion,
-    fetchPersonalization: globalConfig.fetchPersonalization,
-    suppressNativeConfirm: globalConfig.suppressNativeConfirm
-  } : null);
-  if (!config?.projectId) {
-    throw new Error(
-      "AppilotsProvider: No config found. Add withAppilots() to your metro.config.js and create a .appilotsrc file, or pass a config prop directly."
-    );
+function walkSubtree(root, detectLists, startInModal = false) {
+  const result = {
+    texts: [],
+    inputs: [],
+    buttons: [],
+    toggles: [],
+    sliders: [],
+    visitedFibers: 0,
+    skippedHidden: 0,
+    loading: false,
+    modalOpen: false,
+    lists: [],
+    detectors: emptyDetectorCounts()
+  };
+  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, ancestorPress } = 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) {
+        result.detectors.listContainers++;
+        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;
+            addDetectorCounts(result.detectors, itemResult.detectors);
+            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");
+            const syntheticId = `list-${listIndex}-item-${i + 1}`;
+            return {
+              index: i + 1,
+              dataIndex,
+              reactKey,
+              itemKey,
+              syntheticId,
+              texts: dedupeStringsInternal(itemResult.texts),
+              // Scope the row's ordinals by its own synthetic id, so an
+              // unnamed control in row 3 cannot collide with one in row 1
+              // or with a screen-level one.
+              buttons: dedupeButtonsInternal(itemResult.buttons, `${syntheticId}-`),
+              inputs: dedupeInputsInternal(itemResult.inputs, `${syntheticId}-`),
+              toggles: dedupeTogglesInternal(itemResult.toggles, `${syntheticId}-`)
+            };
+          });
+          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);
+        const declaresList = meta.itemCount !== void 0 || meta.refreshing || meta.empty || !!explicitListIdFromProps(fiber.memoizedProps);
+        if (declaresList) {
+          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")) {
+      result.detectors.Text++;
+      const text = extractTextFromChildren(props.children);
+      if (text && text.trim().length > 0) {
+        result.texts.push(text.trim());
+      }
+    } else if (matchesName(fiber, "TextInput")) {
+      result.detectors.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;
+        const identity = resolveIdentity(props, inferLabel(props));
+        const geom = readGeometry(fiber);
+        result.inputs.push(
+          withRect(
+            {
+              id: identity.id,
+              provenance: identity.provenance,
+              label: inferLabel(props),
+              value: safeValue,
+              placeholder: props.placeholder,
+              editable: props.editable !== false,
+              secure: isSecure,
+              type: inferInputType(props),
+              // A field whose return key submits (#398). On a search box or
+              // a one-field login this IS the submit, and without the flag
+              // the screen looks like a form with no way to send it.
+              ...typeof props.onSubmitEditing === "function" ? { submitsOnReturn: true } : {},
+              ...inModal ? { inModal: true } : {},
+              ...geom.fields
+            },
+            geom
+          )
+        );
+      }
+    } else if (props.accessibilityRole === "adjustable") {
+      result.detectors.adjustable++;
+      if (props.__appilotsInternal !== true) {
+        const av = props.accessibilityValue ?? {};
+        const sliderLabel = props.accessibilityLabel ?? props.testID;
+        const sliderIdentity = resolveIdentity(props, sliderLabel);
+        const geom = readGeometry(fiber);
+        result.sliders.push(
+          withRect(
+            {
+              id: sliderIdentity.id,
+              provenance: sliderIdentity.provenance,
+              label: sliderLabel,
+              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 } : {},
+              ...geom.fields
+            },
+            geom
+          )
+        );
+      }
+    } else if (isSwitchLike(fiber, props)) {
+      result.detectors.Switch++;
+      if (props.__appilotsInternal !== true) {
+        const label = props.accessibilityLabel ?? props.testID ?? nearbyLabelForSwitch(fiber);
+        const toggleIdentity = resolveIdentity(props, label);
+        const geom = readGeometry(fiber);
+        result.toggles.push(
+          withRect(
+            {
+              // Same fallback the branch below has always had for buttons.
+              // Without it every unnamed switch arrived as `id: undefined`
+              // and dedupeToggles merged them all into one (#385).
+              id: toggleIdentity.id,
+              provenance: toggleIdentity.provenance,
+              label,
+              value: switchValue(props),
+              ...inModal ? { inModal: true } : {},
+              ...geom.fields
+            },
+            geom
+          )
+        );
+      }
+      continue;
+    } else if (isPressableTarget(fiber)) {
+      result.detectors.pressable++;
+      const isRepeatOfAncestor = typeof props.onPress === "function" && props.onPress === ancestorPress;
+      if (props.__appilotsInternal !== true && !isRepeatOfAncestor) {
+        const label = findChildText(fiber);
+        const state = props.accessibilityState ?? {};
+        const on = state.checked === true || state.selected === true;
+        const buttonIdentity = resolveIdentity(props, label);
+        const geom = readGeometry(fiber);
+        result.buttons.push(
+          withRect(
+            {
+              id: buttonIdentity.id,
+              provenance: buttonIdentity.provenance,
+              label,
+              disabled: !!props.disabled,
+              ...on ? { selected: true } : {},
+              ...inModal ? { inModal: true } : {},
+              ...geom.fields
+            },
+            geom
+          )
+        );
+      }
+      if (fiber.child) {
+        stack.push({
+          fiber: fiber.child,
+          inModal,
+          // Children of this pressable inherit its handler, so a nested
+          // fiber forwarding the SAME `onPress` is recognized as a repeat.
+          ancestorPress: typeof props.onPress === "function" ? props.onPress : ancestorPress
+        });
+      }
+      continue;
+    } else if (matchesName(fiber, "ActivityIndicator")) {
+      result.detectors.ActivityIndicator++;
+      result.loading = true;
+    } else if (isModalFiber(fiber)) {
+      result.detectors.Modal++;
+      result.modalOpen = true;
+      if (fiber.child) stack.push({ fiber: fiber.child, inModal: true });
+      continue;
+    }
+    if (fiber.child) stack.push({ fiber: fiber.child, inModal });
   }
-  React2.useEffect(() => {
-    setAppilotsDebugEnabled(config.debug === true);
-  }, [config.debug]);
-  const listenersRef = React2.useRef(/* @__PURE__ */ new Set());
-  const subscribe = React2.useCallback((handler) => {
-    listenersRef.current.add(handler);
-    return () => {
-      listenersRef.current.delete(handler);
-    };
-  }, []);
-  const emit = React2.useCallback((event) => {
-    recordAppilotsEventTrace(event);
-    listenersRef.current.forEach((handler) => handler(event));
-  }, []);
-  const handleIntrospectionUnavailable = React2.useCallback(
-    ({ reactVersion }) => {
-      emit({
-        type: "sdk:introspection:unavailable",
-        timestamp: Date.now(),
-        data: { reason: "sentinel-missing-internals", reactVersion }
-      });
-    },
-    [emit]
-  );
-  const client = React2.useMemo(
-    () => externalClient ?? new AppilotsClient({
-      projectId: config.projectId,
-      apiBaseUrl: config.apiBaseUrl,
-      apiKey: config.apiKey,
-      debug: config.debug,
-      appVersion: config.appVersion,
-      mcpVersion: config.mcpVersion,
-      // This package's published version, so the server knows which
-      // SDK is actually in the field (issue #312).
-      sdkVersion: SDK_VERSION2,
-      user: config.user,
-      // Only reports a FAILED reading; the happy path sends nothing.
-      introspectionReporter: getIntrospectionDiagnostics
-    }),
-    [config.projectId, config.apiBaseUrl, config.apiKey, config.debug, config.appVersion, config.mcpVersion, config.user, externalClient]
+  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;
+  snapshot.stats.identity = tallyIdentity(snapshot);
+  _lastWalk = {
+    visitedFibers: sub.visitedFibers,
+    skippedHidden: sub.skippedHidden,
+    detectors: sub.detectors
+  };
+  return snapshot;
+}
+function tallyIdentity(snapshot) {
+  const tally = { declared: 0, derived: 0, positional: 0 };
+  const count = (entries2) => {
+    for (const entry of entries2) {
+      if (entry.provenance) tally[entry.provenance] += 1;
+    }
+  };
+  count(snapshot.inputs);
+  count(snapshot.buttons);
+  count(snapshot.toggles);
+  count(snapshot.sliders);
+  for (const list of snapshot.lists) {
+    for (const item of list.items) {
+      count(item.buttons);
+      count(item.inputs);
+      count(item.toggles);
+    }
+  }
+  return tally;
+}
+function dedupeButtonsInternal(buttons, scope = "") {
+  return dedupeButtons(buttons, scope);
+}
+function dedupeInputsInternal(inputs, scope = "") {
+  return dedupeInputs(inputs, scope);
+}
+function dedupeTogglesInternal(toggles, scope = "") {
+  return dedupeToggles(toggles, scope);
+}
+function dedupeStringsInternal(strings) {
+  return dedupeStrings(strings);
+}
+function isCommandLikeLabel(label) {
+  if (!label) return true;
+  const normalized = labelToId(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
   );
-  const fetchPersonalizationEnabled = config.fetchPersonalization !== false;
-  const [remotePersonalization, setRemotePersonalization] = React2.useState(null);
-  React2.useEffect(() => {
-    if (!fetchPersonalizationEnabled) return;
-    let cancelled = false;
-    client.getPersonalization().then((data) => {
-      if (!cancelled) setRemotePersonalization(data);
-    }).catch(() => {
+}
+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
+      };
     });
-    return () => {
-      cancelled = true;
+    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) => isReferenceable(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
     };
-  }, [client, fetchPersonalizationEnabled]);
-  const value = React2.useMemo(
-    () => ({ config, client, subscribe, emit, remotePersonalization }),
-    [config, client, subscribe, emit, remotePersonalization]
-  );
-  return /* @__PURE__ */ React2__default.default.createElement(AppilotsContext.Provider, { value }, /* @__PURE__ */ React2__default.default.createElement(AppilotsFiberRoot, { onUnavailable: handleIntrospectionUnavailable }, children));
+  });
+  if (buttonOptions.length >= 2) {
+    groups.push({
+      index: groups.length,
+      id: "visible-options",
+      label: "Visible options",
+      source: "buttons",
+      options: buttonOptions
+    });
+  }
+  return groups;
 }
-function useAppilotsContext() {
-  const context = React2.useContext(AppilotsContext);
-  if (!context) {
-    throw new Error("useAppilotsContext must be used within an <AppilotsProvider>");
+function positionalId(scope, kind, ordinal) {
+  return `${scope}${kind}-${ordinal}`;
+}
+function dedupeButtons(buttons, scope = "") {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  let unnamed = 0;
+  for (const b of buttons) {
+    const idTrim = b.id?.trim();
+    const labelTrim = b.label?.trim();
+    if (!idTrim && !isReferenceable(labelTrim)) {
+      unnamed += 1;
+      out.push({ ...b, id: positionalId(scope, "btn", unnamed), provenance: "positional" });
+      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 context;
+  return out;
+}
+function dedupeInputs(inputs, scope = "") {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  let unnamed = 0;
+  for (const i of inputs) {
+    if (!i.id?.trim() && !i.label?.trim() && !i.placeholder?.trim()) {
+      unnamed += 1;
+      out.push({ ...i, id: positionalId(scope, "input", unnamed), provenance: "positional" });
+      continue;
+    }
+    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, scope = "") {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  let unnamed = 0;
+  for (const s of sliders) {
+    if (!s.id?.trim() && !s.label?.trim()) {
+      unnamed += 1;
+      out.push({ ...s, id: positionalId(scope, "slider", unnamed), provenance: "positional" });
+      continue;
+    }
+    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, scope = "") {
+  let unnamed = 0;
+  return toggles.map((t) => {
+    if (t.id?.trim()) return t;
+    unnamed += 1;
+    return { ...t, id: positionalId(scope, "toggle", unnamed), provenance: "positional" };
+  });
+}
+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;
 }
 
 // src/introspection/probeLoadingState.ts
-function getTypeName(type) {
+function getTypeName2(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);
+    if (type.type) return getTypeName2(type.type);
   }
   return null;
 }
-function matchesName(fiber, name) {
-  return getTypeName(fiber.type) === name || getTypeName(fiber.elementType) === name;
+function matchesName2(fiber, name) {
+  return getTypeName2(fiber.type) === name || getTypeName2(fiber.elementType) === name;
 }
 var SKELETON_NAME_RE = /skeleton|shimmer|contentloader/i;
 function looksLikeSkeleton(fiber) {
-  const name = getTypeName(fiber.type) ?? getTypeName(fiber.elementType);
+  const name = getTypeName2(fiber.type) ?? getTypeName2(fiber.elementType);
   return !!name && SKELETON_NAME_RE.test(name);
 }
-var SELF_REFERENTIAL_COMPONENTS = /* @__PURE__ */ new Set([
+var SELF_REFERENTIAL_COMPONENTS2 = /* @__PURE__ */ new Set([
   "AppilotsChat",
   "AppilotsChatInner",
   "ActionBreadcrumb",
   "ConfirmDialog"
 ]);
-function shouldSkipSubtree(fiber) {
+function shouldSkipSubtree2(fiber) {
   const props = fiber.memoizedProps;
   if (!props) return false;
-  const typeName2 = getTypeName(fiber.type) ?? getTypeName(fiber.elementType);
-  if (typeName2 && SELF_REFERENTIAL_COMPONENTS.has(typeName2)) return true;
+  const typeName2 = getTypeName2(fiber.type) ?? getTypeName2(fiber.elementType);
+  if (typeName2 && SELF_REFERENTIAL_COMPONENTS2.has(typeName2)) return true;
   if (props.__appilotsSkip === true || props["data-appilots-skip"] === true || props.appilotsSkip === true) {
     return true;
   }
-  if (matchesName(fiber, "Modal") && props.visible === false) return true;
-  if (matchesName(fiber, "Screen") && props.activityState === 0) return true;
+  if (isModalFiber(fiber) && props.visible === false) return true;
+  if (matchesName2(fiber, "Screen") && props.activityState === 0) return true;
   const style = props.style;
   if (style) {
     const flat = Array.isArray(style) ? Object.assign({}, ...style.filter(Boolean)) : style;
@@ -4163,7 +5352,7 @@ function shouldSkipSubtree(fiber) {
   }
   return false;
 }
-var TOUCHABLE_NAMES = /* @__PURE__ */ new Set([
+var TOUCHABLE_NAMES2 = /* @__PURE__ */ new Set([
   "TouchableOpacity",
   "TouchableHighlight",
   "TouchableWithoutFeedback",
@@ -4171,7 +5360,7 @@ var TOUCHABLE_NAMES = /* @__PURE__ */ new Set([
   "Pressable"
 ]);
 function isTouchable(fiber) {
-  return TOUCHABLE_NAMES.has(getTypeName(fiber.type) ?? "") || TOUCHABLE_NAMES.has(getTypeName(fiber.elementType) ?? "");
+  return TOUCHABLE_NAMES2.has(getTypeName2(fiber.type) ?? "") || TOUCHABLE_NAMES2.has(getTypeName2(fiber.elementType) ?? "");
 }
 function pickId(props) {
   return props?.testID ?? props?.accessibilityLabel ?? void 0;
@@ -4207,31 +5396,34 @@ function probeLoadingState(pressedComponentId, route) {
     visited.add(fiber);
     result.visitedFibers++;
     if (fiber.sibling) stack.push(fiber.sibling);
-    if (shouldSkipSubtree(fiber)) continue;
+    if (shouldSkipSubtree2(fiber)) continue;
     const props = fiber.memoizedProps ?? {};
-    if (matchesName(fiber, "ActivityIndicator") || looksLikeSkeleton(fiber)) {
+    if (matchesName2(fiber, "ActivityIndicator") || looksLikeSkeleton(fiber)) {
       result.loading = true;
-    } else if (matchesName(fiber, "Modal")) {
+    } else if (isModalFiber(fiber)) {
       result.modalOpen = true;
+    } else if (isSwitchLike(fiber, props)) {
+      const id = pickId(props);
+      toggleSigs.push(`${id ?? "?"}:${switchValue(props) ? 1 : 0}`);
     } else if (isTouchable(fiber)) {
       if (props.__appilotsInternal !== true) {
         const id = pickId(props);
         const disabled = !!props.disabled;
-        buttonSigs.push(`${id ?? "?"}:${disabled ? 1 : 0}`);
+        const state = props.accessibilityState ?? {};
+        const on = state.checked === true || state.selected === true;
+        buttonSigs.push(`${id ?? "?"}:${disabled ? 1 : 0}:${on ? 1 : 0}`);
         if (pressedComponentId && idMatches(id, pressedComponentId)) {
           result.pressedFound = true;
           if (disabled) result.pressedDisabled = true;
         }
       }
-    } else if (matchesName(fiber, "TextInput")) {
+    } else if (matchesName2(fiber, "TextInput")) {
       if (props.__appilotsInternal !== true) {
         const id = pickId(props);
         const editable = props.editable !== false;
-        inputSigs.push(`${id ?? "?"}:${editable ? 1 : 0}`);
+        const filled = typeof props.value === "string" && props.value.length > 0;
+        inputSigs.push(`${id ?? "?"}:${editable ? 1 : 0}:${filled ? 1 : 0}`);
       }
-    } else if (matchesName(fiber, "Switch")) {
-      const id = pickId(props);
-      toggleSigs.push(`${id ?? "?"}:${props.value ? 1 : 0}`);
     }
     if (fiber.child) stack.push(fiber.child);
   }
@@ -4242,11 +5434,48 @@ function probeLoadingState(pressedComponentId, route) {
   return result;
 }
 
+// ../shared/dist/routes/index.mjs
+var CONTAINER_SUFFIXES = [
+  "screen",
+  "route",
+  "page",
+  "view",
+  "tab",
+  "stack",
+  "drawer",
+  "navigator"
+];
+var CONTENT_SUFFIXES = ["list", "details", "detail", "create", "edit", "new", "form", "index"];
+var MIN_STEM_LENGTH = 3;
+function fold(name) {
+  return name.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "");
+}
+function stripSuffixes(folded, suffixes) {
+  for (const suffix of suffixes) {
+    if (!folded.endsWith(suffix)) continue;
+    const stem = folded.slice(0, -suffix.length);
+    if (stem.length >= MIN_STEM_LENGTH) return stem;
+  }
+  return folded;
+}
+function normalizeRouteFamily(name) {
+  const all = [...CONTAINER_SUFFIXES, ...CONTENT_SUFFIXES];
+  let stem = stripSuffixes(stripSuffixes(fold(name), all), all);
+  if (stem.endsWith("s") && stem.length - 1 >= MIN_STEM_LENGTH) stem = stem.slice(0, -1);
+  return stem;
+}
+function routesBelongToSameFeature(a, b) {
+  const na = normalizeRouteFamily(a);
+  const nb = normalizeRouteFamily(b);
+  if (!na || !nb) return false;
+  return na === nb;
+}
+
 // src/navigation/navigationState.ts
 var _currentScreen = null;
 var _navigationRef = null;
 function setCurrentScreen(screen) {
-  console.log(`[Appilots] setCurrentScreen: "${_currentScreen}" \u2192 "${screen}"`);
+  appilotsDebugLog(`setCurrentScreen: "${_currentScreen}" \u2192 "${screen}"`);
   _currentScreen = screen;
 }
 function getCurrentScreen() {
@@ -4255,8 +5484,8 @@ function getCurrentScreen() {
     const deepest = activePath[activePath.length - 1] ?? null;
     if (deepest && deepest !== _currentScreen) {
       if (_currentScreen) {
-        console.log(
-          `[Appilots] getCurrentScreen: active path differs from cached \u2014 deepest="${deepest}", cached="${_currentScreen}". Updating cache.`
+        appilotsDebugLog(
+          `getCurrentScreen: active path differs from cached \u2014 deepest="${deepest}", cached="${_currentScreen}". Updating cache.`
         );
       }
       _currentScreen = deepest;
@@ -4267,7 +5496,9 @@ function getCurrentScreen() {
     const liveScreen = getActiveRouteFromRef(_navigationRef);
     if (liveScreen) {
       if (liveScreen !== _currentScreen) {
-        console.log(`[Appilots] getCurrentScreen: live reading differs from cached \u2014 live="${liveScreen}", cached="${_currentScreen}". Updating cache.`);
+        appilotsDebugLog(
+          `getCurrentScreen: live reading differs from cached \u2014 live="${liveScreen}", cached="${_currentScreen}". Updating cache.`
+        );
         _currentScreen = liveScreen;
       }
       return liveScreen;
@@ -4311,7 +5542,9 @@ function getActiveRouteNames() {
 function routeNamesAtState(state) {
   if (!state) return [];
   if (Array.isArray(state.routeNames)) {
-    return state.routeNames.filter((name) => typeof name === "string" && name.length > 0);
+    return state.routeNames.filter(
+      (name) => typeof name === "string" && name.length > 0
+    );
   }
   if (Array.isArray(state.routes)) {
     return state.routes.map((route) => route?.name).filter((name) => typeof name === "string" && name.length > 0);
@@ -4428,16 +5661,6 @@ function getActiveRouteFromRef(navRef) {
   }
 }
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-function normalizeRouteFamily(name) {
-  return name.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/(tab|list|screen|details?|navigator)$/i, "");
-}
-function routesBelongToSameFeature(a, b) {
-  const na = normalizeRouteFamily(a);
-  const nb = normalizeRouteFamily(b);
-  if (!na || !nb) return false;
-  if (na === nb) return true;
-  return na.startsWith(nb) || nb.startsWith(na);
-}
 function navigationTargetReached(target, fromScreen) {
   const cur = getCurrentScreen();
   const path = getActiveRouteNames();
@@ -4613,6 +5836,365 @@ async function waitForLoadingSettle(opts = {}) {
   };
 }
 
+// src/version.ts
+var SDK_VERSION2 = "0.11.0";
+var FiberSentinel = class extends React2__default.default.Component {
+  componentDidMount() {
+    const fiber = this._reactInternals ?? this._reactInternalFiber ?? null;
+    if (!fiber) {
+      const reactVersion = React2__default.default.version ?? null;
+      appilotsDebugWarn(
+        `FiberSentinel: this._reactInternals is undefined; snapshot capture will fall back to render-time owner. React version may be incompatible (react=${reactVersion}).`
+      );
+      recordIntrospectionFailure("sentinel-missing-internals", reactVersion);
+      this.props.onUnavailable?.({ reactVersion });
+      return;
+    }
+    let top = fiber;
+    while (top.return) top = top.return;
+    setFiberRoot(top);
+  }
+  render() {
+    return this.props.children ?? null;
+  }
+};
+function AppilotsFiberRoot({
+  children,
+  onUnavailable
+}) {
+  const Internals = React2__default.default.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED_IN_THIS_VERSION_OF_REACT;
+  const ownerFiber = Internals?.ReactCurrentOwner?.current;
+  if (ownerFiber && !getFiberRoot()) {
+    setFiberRoot(ownerFiber);
+  }
+  return /* @__PURE__ */ React2__default.default.createElement(FiberSentinel, { onUnavailable }, children);
+}
+
+// src/debug/logger.ts
+setAppilotsDebugResolver(() => getGlobalConfig()?.debug === true);
+function setAppilotsDebugEnabled2(enabled) {
+  setAppilotsDebugEnabled(enabled);
+}
+
+// src/platform/nativeDialogTracking.ts
+var DEFAULT_BUTTON_LABEL = "OK";
+var ANSWERED_DIALOG_MEMORY_MS = 15e3;
+var _open = null;
+var _lastAnswered = null;
+var _counter = 0;
+var _installed = null;
+function getOpenNativeDialog() {
+  return _open;
+}
+function getLastAnsweredNativeDialog() {
+  if (!_lastAnswered) return null;
+  if (Date.now() - _lastAnswered.at > ANSWERED_DIALOG_MEMORY_MS) return null;
+  return _lastAnswered;
+}
+function labelOf(button, index) {
+  const text = typeof button?.text === "string" ? button.text.trim() : "";
+  if (text.length > 0) return text;
+  return index === 0 ? DEFAULT_BUTTON_LABEL : `Button ${index + 1}`;
+}
+function installNativeDialogTracking(host) {
+  if (_installed) return;
+  const original = host.alert;
+  const patched = (title, message, buttons, options) => {
+    const id = `native-dialog-${_counter += 1}`;
+    const source = Array.isArray(buttons) && buttons.length > 0 ? buttons : [{ text: DEFAULT_BUTTON_LABEL }];
+    const close = (dialogId, answeredWith) => {
+      if (_open?.id !== dialogId) return;
+      _lastAnswered = {
+        id: dialogId,
+        ...tracked.title ? { title: tracked.title } : {},
+        buttons: tracked.buttons.map((button) => button.label),
+        ...answeredWith ? { answeredWith } : {},
+        at: Date.now()
+      };
+      _open = null;
+    };
+    const tracked = {
+      id,
+      title: typeof title === "string" && title.trim().length > 0 ? title.trim() : void 0,
+      message: typeof message === "string" && message.trim().length > 0 ? message.trim() : void 0,
+      buttons: []
+    };
+    const wrapped = source.map((button, index) => ({
+      ...button,
+      onPress: (value) => {
+        close(id, labelOf(button, index));
+        button.onPress?.(value);
+      }
+    }));
+    tracked.buttons = source.map((button, index) => ({
+      label: labelOf(button, index),
+      ...button.style ? { style: button.style } : {},
+      press: () => {
+        wrapped[index]?.onPress?.();
+      }
+    }));
+    _open = tracked;
+    const opts = options;
+    const patchedOptions = opts && typeof opts === "object" ? {
+      ...opts,
+      onDismiss: () => {
+        close(id);
+        opts.onDismiss?.();
+      }
+    } : options;
+    return original(title, message, wrapped, patchedOptions);
+  };
+  host.alert = patched;
+  _installed = { host, original, patched };
+}
+function uninstallNativeDialogTracking() {
+  if (!_installed) return;
+  if (_installed.host.alert === _installed.patched) {
+    _installed.host.alert = _installed.original;
+  }
+  _installed = null;
+  _open = null;
+  _lastAnswered = null;
+}
+
+// src/introspection/nameMangling.ts
+var _lastProbe = null;
+function getNameManglingProbe() {
+  return _lastProbe;
+}
+function probeNameMangling(components) {
+  const observed = {};
+  let mangled = false;
+  for (const [expected, component] of Object.entries(components)) {
+    if (component === void 0) continue;
+    const actual = getTypeName(component) ?? null;
+    observed[expected] = actual;
+    if (actual !== expected) mangled = true;
+  }
+  _lastProbe = { mangled, observed };
+  if (mangled) {
+    recordIntrospectionFailure("names-mangled", null);
+    console.warn(
+      "[Appilots] This bundle renamed React Native components: " + Object.entries(observed).filter(([expectedName, actual]) => actual !== expectedName).map(([expectedName, actual]) => `${expectedName} \u2192 ${actual ?? "unknown"}`).join(", ") + ". Detection falls back to accessibility roles and component shape, which covers switches, modals and lists but is less precise. To restore names, keep `keep_fnames`/`keep_classnames` in your Metro minifierConfig \u2014 `withAppilots()` sets them for you."
+    );
+  }
+  return _lastProbe;
+}
+
+// src/platform/fabricGeometry.ts
+function readRect(instance) {
+  const candidate = instance;
+  const read = candidate?.getBoundingClientRect ?? candidate?.unstable_getBoundingClientRect;
+  if (typeof read !== "function") return null;
+  const rect = read.call(candidate);
+  if (!rect) return null;
+  return { x: rect.x, y: rect.y, width: rect.width, height: rect.height };
+}
+function createFabricGeometryHost(dimensions) {
+  const fabric = globalThis.nativeFabricUIManager;
+  if (!fabric) return null;
+  return {
+    get window() {
+      return dimensions.get("window");
+    },
+    rectOf: readRect
+  };
+}
+var AppilotsErrorBoundary = class extends React2__default.default.Component {
+  state = { degraded: false, escalate: null };
+  /**
+   * Instance field rather than state: `componentDidCatch` needs to know
+   * whether THIS is the first failure, and by the time it runs
+   * `getDerivedStateFromError` has already flipped `state.degraded`.
+   */
+  hasDegradedOnce = false;
+  static getDerivedStateFromError() {
+    return { degraded: true };
+  }
+  componentDidCatch(error, info) {
+    if (this.hasDegradedOnce) {
+      this.setState({ escalate: error ?? new Error("Appilots: re-thrown host render error") });
+      return;
+    }
+    this.hasDegradedOnce = true;
+    console.error(
+      `[Appilots] The Appilots ${this.props.surface} threw while rendering and has been disabled for the rest of this session. Your app keeps running \u2014 this is an Appilots bug, not a bug in your code. Please report it with the stack below: https://github.com/Axtern-Labs/Appilots/issues`,
+      error
+    );
+    try {
+      this.props.onError?.(error, info?.componentStack ?? null);
+    } catch {
+    }
+  }
+  render() {
+    if (this.state.escalate !== null) throw this.state.escalate;
+    if (this.state.degraded) return this.props.fallback;
+    return this.props.children;
+  }
+};
+
+// src/context/AppilotsProvider.tsx
+var AppilotsContext = React2.createContext(null);
+function createInertClient() {
+  const unavailable = () => Promise.reject(new Error("Appilots is unavailable: the SDK degraded after a render error."));
+  return new Proxy({}, {
+    get: (_target, prop) => {
+      if (prop === "then" || typeof prop === "symbol") return void 0;
+      return unavailable;
+    }
+  });
+}
+function createDegradedContext(config) {
+  return {
+    config: config ?? { projectId: "" },
+    client: createInertClient(),
+    subscribe: () => () => {
+    },
+    emit: () => {
+    },
+    remotePersonalization: null,
+    degraded: true
+  };
+}
+function AppilotsProvider({ config, children, client }) {
+  return /* @__PURE__ */ React2__default.default.createElement(
+    AppilotsErrorBoundary,
+    {
+      surface: "provider",
+      onError: reportProviderRenderFailure,
+      fallback: /* @__PURE__ */ React2__default.default.createElement(AppilotsContext.Provider, { value: createDegradedContext(config ?? null) }, children)
+    },
+    /* @__PURE__ */ React2__default.default.createElement(AppilotsProviderInner, { config, client }, children)
+  );
+}
+function reportProviderRenderFailure() {
+  recordRenderFailure(readReactVersion());
+}
+function readReactVersion() {
+  const version = React2__default.default.version;
+  return typeof version === "string" ? version : null;
+}
+function AppilotsProviderInner({
+  config: configProp,
+  children,
+  client: externalClient
+}) {
+  appilotsDebugLog(
+    `AppilotsProvider initializing \u2014 config source: ${configProp ? "prop" : "auto (globalThis.__APPILOTS_RC__)"}`
+  );
+  tryAutoConfig();
+  const globalConfig = getGlobalConfig();
+  appilotsDebugLog(`AppilotsProvider: configProp=${!!configProp}, globalConfig=${!!globalConfig}`);
+  const config = configProp ?? (globalConfig ? {
+    projectId: globalConfig.projectId,
+    apiBaseUrl: globalConfig.apiBaseUrl,
+    apiKey: globalConfig.apiKey,
+    permissions: globalConfig.permissions,
+    debug: globalConfig.debug,
+    appVersion: globalConfig.appVersion,
+    mcpVersion: globalConfig.mcpVersion,
+    fetchPersonalization: globalConfig.fetchPersonalization,
+    suppressNativeConfirm: globalConfig.suppressNativeConfirm
+  } : null);
+  if (!config?.projectId) {
+    throw new Error(
+      "AppilotsProvider: No config found. Add withAppilots() to your metro.config.js and create a .appilotsrc file, or pass a config prop directly."
+    );
+  }
+  React2.useEffect(() => {
+    setAppilotsDebugEnabled2(config.debug === true);
+  }, [config.debug]);
+  React2.useEffect(() => {
+    probeNameMangling({ Switch: reactNative.Switch, Modal: reactNative.Modal, Text: reactNative.Text });
+  }, []);
+  React2.useEffect(() => {
+    setGeometryHost(createFabricGeometryHost(reactNative.Dimensions));
+    return () => setGeometryHost(null);
+  }, []);
+  const trackNativeDialogs = config.trackNativeDialogs !== false;
+  React2.useEffect(() => {
+    if (!trackNativeDialogs) return;
+    installNativeDialogTracking(reactNative.Alert);
+    return () => {
+      uninstallNativeDialogTracking();
+    };
+  }, [trackNativeDialogs]);
+  const listenersRef = React2.useRef(/* @__PURE__ */ new Set());
+  const subscribe = React2.useCallback((handler) => {
+    listenersRef.current.add(handler);
+    return () => {
+      listenersRef.current.delete(handler);
+    };
+  }, []);
+  const emit = React2.useCallback((event) => {
+    recordAppilotsEventTrace(event);
+    listenersRef.current.forEach((handler) => handler(event));
+  }, []);
+  const handleIntrospectionUnavailable = React2.useCallback(
+    ({ reactVersion }) => {
+      emit({
+        type: "sdk:introspection:unavailable",
+        timestamp: Date.now(),
+        data: { reason: "sentinel-missing-internals", reactVersion }
+      });
+    },
+    [emit]
+  );
+  const client = React2.useMemo(
+    () => externalClient ?? new AppilotsClient({
+      projectId: config.projectId,
+      apiBaseUrl: config.apiBaseUrl,
+      apiKey: config.apiKey,
+      debug: config.debug,
+      appVersion: config.appVersion,
+      mcpVersion: config.mcpVersion,
+      // This package's published version, so the server knows which
+      // SDK is actually in the field (issue #312).
+      sdkVersion: SDK_VERSION2,
+      user: config.user,
+      // Only reports a FAILED reading; the happy path sends nothing.
+      introspectionReporter: getIntrospectionDiagnostics
+    }),
+    [
+      config.projectId,
+      config.apiBaseUrl,
+      config.apiKey,
+      config.debug,
+      config.appVersion,
+      config.mcpVersion,
+      config.user,
+      externalClient
+    ]
+  );
+  const fetchPersonalizationEnabled = config.fetchPersonalization !== false;
+  const [remotePersonalization, setRemotePersonalization] = React2.useState(
+    null
+  );
+  React2.useEffect(() => {
+    if (!fetchPersonalizationEnabled) return;
+    let cancelled = false;
+    client.getPersonalization().then((data) => {
+      if (!cancelled) setRemotePersonalization(data);
+    }).catch(() => {
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [client, fetchPersonalizationEnabled]);
+  const value = React2.useMemo(
+    () => ({ config, client, subscribe, emit, remotePersonalization }),
+    [config, client, subscribe, emit, remotePersonalization]
+  );
+  return /* @__PURE__ */ React2__default.default.createElement(AppilotsContext.Provider, { value }, /* @__PURE__ */ React2__default.default.createElement(AppilotsFiberRoot, { onUnavailable: handleIntrospectionUnavailable }, children));
+}
+function useAppilotsContext() {
+  const context = React2.useContext(AppilotsContext);
+  if (!context) {
+    throw new Error("useAppilotsContext must be used within an <AppilotsProvider>");
+  }
+  return context;
+}
+
 // src/navigation/registerScreen.ts
 var screenRegistry = /* @__PURE__ */ new Map();
 function registerScreen(metadata) {
@@ -4634,9 +6216,12 @@ exports.AppilotsErrorBoundary = AppilotsErrorBoundary;
 exports.AppilotsProvider = AppilotsProvider;
 exports.AppilotsRegistryProvider = AppilotsRegistryProvider;
 exports.ChatSessionMachine = ChatSessionMachine;
+exports.FORM_VALIDATION_TEXT_RE = FORM_VALIDATION_TEXT_RE;
+exports.FORM_WRITE_SUCCESS_TEXT_RE = FORM_WRITE_SUCCESS_TEXT_RE;
 exports.OPTIONAL_STEP_AUTOMATION_HINT = OPTIONAL_STEP_AUTOMATION_HINT;
 exports.RateLimitedError = RateLimitedError;
 exports.SDK_VERSION = SDK_VERSION2;
+exports.TOUCHABLE_NAMES = TOUCHABLE_NAMES;
 exports._patchJsxRuntimes = _patchJsxRuntimes;
 exports.actionPressTargetId = actionPressTargetId;
 exports.appilotsDebugLog = appilotsDebugLog;
@@ -4653,27 +6238,44 @@ exports.defaultDarkTheme = defaultDarkTheme;
 exports.defaultLightTheme = defaultLightTheme;
 exports.deriveInteractionElements = deriveInteractionElements;
 exports.describeAction = describeAction;
+exports.describeValue = describeValue;
 exports.elementRegistry = elementRegistry;
+exports.emptyDetectorCounts = emptyDetectorCounts;
 exports.enableAppilotsAutoTracking = enableAppilotsAutoTracking;
+exports.findListItems = findListItems;
+exports.foldForCompare = foldForCompare;
+exports.geometryAvailability = geometryAvailability;
+exports.geometryStats = geometryStats;
 exports.getActiveRouteNames = getActiveRouteNames;
 exports.getAllScreens = getAllScreens;
 exports.getAppilotsDebugTraces = getAppilotsDebugTraces;
+exports.getAutoTrackingState = getAutoTrackingState;
 exports.getCurrentScreen = getCurrentScreen;
 exports.getCurrentScreenSignature = getCurrentScreenSignature;
 exports.getDefaultRegistry = getDefaultRegistry;
 exports.getFiberRoot = getFiberRoot;
 exports.getGlobalConfig = getGlobalConfig;
 exports.getIntrospectionDiagnostics = getIntrospectionDiagnostics;
+exports.getLastAnsweredNativeDialog = getLastAnsweredNativeDialog;
+exports.getLastWalkDiagnostics = getLastWalkDiagnostics;
+exports.getNameManglingProbe = getNameManglingProbe;
 exports.getNavigationRef = getNavigationRef;
 exports.getNavigationStateSnapshot = getNavigationStateSnapshot;
+exports.getOpenNativeDialog = getOpenNativeDialog;
 exports.getScreenMetadata = getScreenMetadata;
+exports.getTypeName = getTypeName;
 exports.humanizeError = humanizeError;
 exports.idLooselyMatches = idLooselyMatches;
 exports.initAppilots = initAppilots;
+exports.isAlwaysListContainer = isAlwaysListContainer;
 exports.isAutoTrackingEnabled = isAutoTrackingEnabled;
 exports.isGenericSelectValue = isGenericSelectValue;
+exports.isHeuristicListContainer = isHeuristicListContainer;
 exports.isListItemPressTarget = isListItemPressTarget;
+exports.isModalFiber = isModalFiber;
 exports.isOptionalStepAutomationFailure = isOptionalStepAutomationFailure;
+exports.isReferenceable = isReferenceable;
+exports.isSwitchLike = isSwitchLike;
 exports.listRegistry = listRegistry;
 exports.looksDestructiveActionLabel = looksDestructiveActionLabel;
 exports.matchScore = matchScore;
@@ -4683,15 +6285,21 @@ exports.parseStableElementId = parseStableElementId;
 exports.probeLoadingState = probeLoadingState;
 exports.recordAppilotsDebugTrace = recordAppilotsDebugTrace;
 exports.recordIntrospectionFailure = recordIntrospectionFailure;
+exports.rectForNode = rectForNode;
 exports.registerScreen = registerScreen;
 exports.resolveBaseTheme = resolveBaseTheme;
 exports.routesBelongToSameFeature = routesBelongToSameFeature;
 exports.screenDepartedBaseline = screenDepartedBaseline;
 exports.setCurrentScreen = setCurrentScreen;
 exports.setNavigationRef = setNavigationRef;
+exports.shouldSkipSubtree = shouldSkipSubtree;
 exports.snapshotShowsOpenCreateForm = snapshotShowsOpenCreateForm;
 exports.subscribeAppilotsDebugTraces = subscribeAppilotsDebugTraces;
+exports.switchValue = switchValue;
+exports.toWireElement = toWireElement;
+exports.totalDetectorHits = totalDetectorHits;
 exports.useAppilotsContext = useAppilotsContext;
 exports.useResolvedRegistry = useResolvedRegistry;
 exports.waitForLoadingSettle = waitForLoadingSettle;
 exports.waitForScreenSettle = waitForScreenSettle;
+exports.walkFiber = walkFiber;