@appilots/sdk 0.11.0 → 0.11.3

package/dist/{chunk-IZEWWAA7.js → chunk-5UVMNKPT.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk55Y2AQE7_js = require('./chunk-55Y2AQE7.js');
+var chunkSUMIABJK_js = require('./chunk-SUMIABJK.js');
 var React = require('react');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -15,17 +15,17 @@ function getActiveRouteName(state) {
   return route.name;
 }
 function AppilotsNavigationContainer({ children }) {
-  const { emit } = chunk55Y2AQE7_js.useAppilotsContext();
+  const { emit } = chunkSUMIABJK_js.useAppilotsContext();
   const internalRef = React.useRef(null);
   const handleRef = React.useCallback(
     (instance) => {
       internalRef.current = instance;
-      chunk55Y2AQE7_js.setNavigationRef(instance);
+      chunkSUMIABJK_js.setNavigationRef(instance);
       const childRef = children.ref;
       if (typeof childRef === "function") childRef(instance);
       else if (childRef && typeof childRef === "object") childRef.current = instance;
       if (instance) {
-        chunk55Y2AQE7_js.appilotsDebugLog("NavigationContainer ref captured");
+        chunkSUMIABJK_js.appilotsDebugLog("NavigationContainer ref captured");
       }
     },
     [children]
@@ -34,8 +34,8 @@ function AppilotsNavigationContainer({ children }) {
     (state) => {
       const routeName = getActiveRouteName(state);
       if (routeName) {
-        chunk55Y2AQE7_js.appilotsDebugLog(`Screen changed \u2192 "${routeName}"`);
-        chunk55Y2AQE7_js.setCurrentScreen(routeName);
+        chunkSUMIABJK_js.appilotsDebugLog(`Screen changed \u2192 "${routeName}"`);
+        chunkSUMIABJK_js.setCurrentScreen(routeName);
         emit({
           type: "navigation:change",
           timestamp: Date.now(),
@@ -50,8 +50,8 @@ function AppilotsNavigationContainer({ children }) {
     const timer = setTimeout(() => {
       const route = internalRef.current?.getCurrentRoute?.();
       if (route?.name) {
-        chunk55Y2AQE7_js.appilotsDebugLog(`Initial screen \u2192 "${route.name}"`);
-        chunk55Y2AQE7_js.setCurrentScreen(route.name);
+        chunkSUMIABJK_js.appilotsDebugLog(`Initial screen \u2192 "${route.name}"`);
+        chunkSUMIABJK_js.setCurrentScreen(route.name);
         emit({
           type: "navigation:change",
           timestamp: Date.now(),

package/dist/{chunk-3K7ORC4X.mjs → chunk-JKLE5SLN.mjs}

@@ -1,4 +1,4 @@
-import { useAppilotsContext, setNavigationRef, appilotsDebugLog, setCurrentScreen } from './chunk-G6KI7KVH.mjs';
+import { useAppilotsContext, setNavigationRef, appilotsDebugLog, setCurrentScreen } from './chunk-ROXXCDIG.mjs';
 import React, { useRef, useCallback, useEffect } from 'react';
 
 function getActiveRouteName(state) {

package/dist/{chunk-G6KI7KVH.mjs → chunk-ROXXCDIG.mjs}

@@ -155,7 +155,7 @@ new RegExp(
 );
 var CREATE_EDIT_ROUTE_RE = new RegExp(`(${build(CREATE_EDIT_ROUTE)})`, "i");
 
-// ../shared/dist/chunk-43YQ52Q7.mjs
+// ../shared/dist/chunk-SWQOZWHP.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) {
   if (type === "password") return true;
@@ -1364,6 +1364,7 @@ function snapshotHasVisibleSubmitButton(snap) {
   );
 }
 function snapshotHasVisibleValidation(snap) {
+  if ((snap.inputs ?? []).some((input) => input.invalid === true)) return true;
   return (snap.texts ?? []).some(
     (text) => typeof text === "string" && FORM_VALIDATION_TEXT_RE.test(text)
   );
@@ -1509,6 +1510,8 @@ var ChatSessionMachine = class {
   /** Tear down timers and the escalation stream. Safe to call twice. */
   dispose() {
     this.disposed = true;
+    this.abortController?.abort();
+    this.currentTurn = null;
     this.closeEscalationStream();
   }
   setState(partial) {
@@ -1555,7 +1558,7 @@ var ChatSessionMachine = class {
   }
   // ── Escalation: request, stream, and message routing ─────────
   async requestHuman(reason = "user_requested") {
-    if (this.state.escalation) return;
+    if (this.disposed || this.state.escalation) return;
     try {
       const lastError = this.state.messages.slice().reverse().find((m) => m.role === "assistant" && m.id.startsWith("error_"));
       const result = await this.deps.client.requestEscalation(reason, lastError?.content);
@@ -1729,7 +1732,7 @@ var ChatSessionMachine = class {
   // ── Continuation: when all current-turn actions finish, ask the
   // model what to do next, given the outcomes + fresh snapshot.
   async runContinuation(turn) {
-    if (this.continuationInFlight) return;
+    if (this.disposed || this.continuationInFlight) return;
     this.continuationInFlight = true;
     try {
       this.setState({ isLoading: true, loadingStatusKey: "statusWaitingApp" });
@@ -1752,6 +1755,7 @@ var ChatSessionMachine = class {
         pressedComponentId: pressedId,
         navigateTargetScreen
       });
+      if (this.disposed || this.currentTurn !== turn) return;
       const loadingPending = settle.loadingPending;
       for (const id of settle.toolWithoutEffectIds) toolWithoutEffectIds.add(id);
       const context = this.deps.adapter.buildContext({ loadingPending });
@@ -1817,6 +1821,7 @@ var ChatSessionMachine = class {
         `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);
+      if (this.disposed) return;
       this.addAssistantMessage(response.message);
       this.deps.emit({
         type: "agent:message",
@@ -1904,7 +1909,7 @@ var ChatSessionMachine = class {
   }
   // ── Send / cancel / clear ────────────────────────────────────
   async sendMessage(content) {
-    if (!content.trim() || this.state.isLoading) return;
+    if (this.disposed || !content.trim() || this.state.isLoading) return;
     if (this.state.escalation) {
       await this.sendEscalationMessage(content.trim());
       return;
@@ -1931,7 +1936,7 @@ var ChatSessionMachine = class {
     const abortController = new AbortController();
     this.abortController = abortController;
     try {
-      const context = this.deps.adapter.buildContext();
+      const context = this.deps.adapter.buildContext({ newMission: true });
       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}}`
       );
@@ -2132,6 +2137,7 @@ var ActionQueueMachine = class {
   processed = /* @__PURE__ */ new Set();
   /** Guards against overlapping sequential runs. */
   draining = false;
+  disposed = false;
   /** Set when new work arrives while a drain is in flight. */
   drainRequested = false;
   /** Set while a drain is queued on the microtask queue. */
@@ -2146,6 +2152,12 @@ var ActionQueueMachine = class {
     this.rejectAction = this.rejectAction.bind(this);
   }
   // ── State plumbing ───────────────────────────────────────────
+  dispose() {
+    this.disposed = true;
+    this.drainRequested = false;
+    this.setActions([]);
+    this.listeners.clear();
+  }
   getState() {
     return this.state;
   }
@@ -2171,7 +2183,7 @@ var ActionQueueMachine = class {
   }
   // ── Event intake: new actions from the agent ─────────────────
   handleEvent(event) {
-    if (event.type !== "agent:action:start") return;
+    if (this.disposed || event.type !== "agent:action:start") return;
     const action = event.data?.action;
     if (!action?.id) return;
     appilotsDebugLog(
@@ -2198,7 +2210,7 @@ var ActionQueueMachine = class {
    * batching before its effect ran.)
    */
   scheduleDrain() {
-    if (!this.options.autoExecute) return;
+    if (this.disposed || !this.options.autoExecute) return;
     if (this.draining) {
       this.drainRequested = true;
       return;
@@ -2207,7 +2219,7 @@ var ActionQueueMachine = class {
     this.drainScheduled = true;
     queueMicrotask(() => {
       this.drainScheduled = false;
-      if (!this.options.autoExecute) return;
+      if (this.disposed || !this.options.autoExecute) return;
       if (this.draining) {
         this.drainRequested = true;
         return;
@@ -2330,6 +2342,7 @@ var ActionQueueMachine = class {
     let preNavScreen = null;
     let preNavSignature = null;
     for (const [index, action] of pending.entries()) {
+      if (this.disposed) return;
       if (action.type === "confirm") {
         continue;
       }
@@ -2449,6 +2462,7 @@ var ActionQueueMachine = class {
   }
   // ── Approve & execute an action ─────────────────────────────
   async approveAction(actionId) {
+    if (this.disposed) return false;
     const action = this.state.actions.find((a) => a.id === actionId);
     if (!action) return false;
     appilotsDebugLog(
@@ -3264,6 +3278,91 @@ function clampSnapshotToWireLimits(snapshot) {
   if (cut.dropped) snapshot.truncated = true;
   return snapshot;
 }
+var MAX_DELTA_FIELD_IDS = 12;
+function isFilled(input) {
+  if (typeof input.filled === "boolean") return input.filled;
+  return typeof input.value === "string" && input.value.length > 0;
+}
+function fingerprintSnapshot(snap) {
+  const texts = /* @__PURE__ */ new Set();
+  for (const text of snap.texts ?? []) {
+    if (typeof text !== "string") continue;
+    const trimmed = text.trim();
+    if (trimmed) texts.add(trimmed);
+  }
+  let visibleRows = 0;
+  let totalRows = 0;
+  for (const list of snap.lists ?? []) {
+    visibleRows += list.items?.length ?? 0;
+    if (typeof list.itemCount === "number") totalRows += list.itemCount;
+  }
+  const filledDeclaredFields = /* @__PURE__ */ new Set();
+  let anyInvalid = false;
+  for (const input of snap.inputs ?? []) {
+    if (input.invalid === true) anyInvalid = true;
+    if (input.provenance !== "declared") continue;
+    if (!input.id) continue;
+    if (isFilled(input)) filledDeclaredFields.add(input.id);
+  }
+  return {
+    route: snap.route ?? null,
+    modal: snap.modalOpen === true || !!snap.nativeDialog,
+    loading: snap.loading === true,
+    texts,
+    visibleRows,
+    totalRows,
+    filledDeclaredFields,
+    anyInvalid
+  };
+}
+function countMissing(from, inSet) {
+  let n = 0;
+  for (const value of from) if (!inSet.has(value)) n += 1;
+  return n;
+}
+function namesMissing(from, inSet) {
+  const out = [];
+  for (const value of from) if (!inSet.has(value)) out.push(value);
+  out.sort();
+  return out.slice(0, MAX_DELTA_FIELD_IDS);
+}
+function diffFingerprints(prev, next) {
+  const delta = {};
+  if (prev.route !== next.route) delta.routeChanged = true;
+  if (!prev.modal && next.modal) delta.modalOpened = true;
+  if (prev.modal && !next.modal) delta.modalClosed = true;
+  if (!prev.loading && next.loading) delta.loadingStarted = true;
+  if (prev.loading && !next.loading) delta.loadingFinished = true;
+  const added = countMissing(next.texts, prev.texts);
+  const removed = countMissing(prev.texts, next.texts);
+  if (added > 0) delta.textsAdded = added;
+  if (removed > 0) delta.textsRemoved = removed;
+  const visibleRowsDelta = next.visibleRows - prev.visibleRows;
+  if (visibleRowsDelta !== 0) delta.visibleRowsDelta = visibleRowsDelta;
+  const totalRowsDelta = next.totalRows - prev.totalRows;
+  if (totalRowsDelta !== 0) delta.totalRowsDelta = totalRowsDelta;
+  const newlyFilled = namesMissing(next.filledDeclaredFields, prev.filledDeclaredFields);
+  if (newlyFilled.length > 0) delta.fieldsNewlyFilled = newlyFilled;
+  const cleared = namesMissing(prev.filledDeclaredFields, next.filledDeclaredFields);
+  if (cleared.length > 0) delta.fieldsCleared = cleared;
+  if (!prev.anyInvalid && next.anyInvalid) delta.invalidAppeared = true;
+  if (Object.keys(delta).length === 0) delta.unchanged = true;
+  return delta;
+}
+function createSnapshotDeltaTracker() {
+  let previous;
+  return {
+    observe(snap) {
+      const next = fingerprintSnapshot(snap);
+      const delta = previous ? diffFingerprints(previous, next) : void 0;
+      previous = next;
+      return delta;
+    },
+    reset() {
+      previous = void 0;
+    }
+  };
+}
 
 // src/registry/ComponentRegistry.ts
 var ComponentRegistryImpl = class {
@@ -4465,6 +4564,37 @@ function rectForNode(node) {
   return _rectByNode.get(node);
 }
 
+// src/introspection/focusState.ts
+var _host2 = null;
+function setFocusHost(host) {
+  _host2 = host;
+}
+var HOST_SEARCH_DEPTH2 = 6;
+function isFiberFocused(fiber) {
+  const host = _host2;
+  if (!host || !fiber) return void 0;
+  let focused = null;
+  try {
+    focused = host.focusedInstance();
+  } catch {
+    return void 0;
+  }
+  if (!focused) return false;
+  const stack = [{ node: fiber, depth: 0 }];
+  while (stack.length > 0) {
+    const { node, depth } = stack.pop();
+    const current = node;
+    if (!current) continue;
+    if (current.stateNode && current.stateNode === focused) return true;
+    if (depth < HOST_SEARCH_DEPTH2 && current.child) {
+      stack.push({ node: current.child, depth: depth + 1 });
+      const sibling = current.child.sibling;
+      if (sibling) stack.push({ node: sibling, depth: depth + 1 });
+    }
+  }
+  return false;
+}
+
 // src/introspection/walkFiber.ts
 function getTypeName(type) {
   if (!type) return null;
@@ -4533,6 +4663,71 @@ function isAppilotsSensitiveMarked(props) {
   if (!props) return false;
   return props.__appilotsSensitive === true || props["data-appilots-sensitive"] === true || props.appilotsSensitive === true;
 }
+function booleanish(value) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true") return true;
+    if (normalized === "false") return false;
+  }
+  return void 0;
+}
+function firstBooleanish(props, keys) {
+  for (const key of keys) {
+    const resolved = booleanish(props?.[key]);
+    if (resolved !== void 0) return resolved;
+  }
+  return void 0;
+}
+function readRequiredProp(props) {
+  const direct = firstBooleanish(props, [
+    "required",
+    "aria-required",
+    "isRequired",
+    "accessibilityRequired"
+  ]);
+  if (direct !== void 0) return direct;
+  return booleanish(props?.accessibilityState?.required);
+}
+function readInvalidProp(props) {
+  const direct = firstBooleanish(props, ["invalid", "aria-invalid", "isInvalid", "hasError"]);
+  if (direct !== void 0) return direct;
+  const state = booleanish(props?.accessibilityState?.invalid);
+  if (state !== void 0) return state;
+  for (const key of ["error", "errorMessage", "errorText"]) {
+    const value = props?.[key];
+    const asBoolean = booleanish(value);
+    if (asBoolean !== void 0) return asBoolean;
+    if (typeof value === "string") return value.trim().length > 0;
+  }
+  return void 0;
+}
+var WRAPPER_PROP_SEARCH_DEPTH = 3;
+var WRAPPER_SUBTREE_BUDGET = 64;
+function wrapsExactlyOneInput(fiber) {
+  let seen = 0;
+  let visited = 0;
+  const stack = [fiber?.child];
+  while (stack.length > 0) {
+    if ((visited += 1) > WRAPPER_SUBTREE_BUDGET) return false;
+    const node = stack.pop();
+    if (!node) continue;
+    if (matchesName(node, "TextInput") && (seen += 1) > 1) return false;
+    if (node.child) stack.push(node.child);
+    if (node.sibling) stack.push(node.sibling);
+  }
+  return seen === 1;
+}
+function readWrapperProps(fiber) {
+  let node = fiber?.return;
+  for (let depth = 0; node && depth < WRAPPER_PROP_SEARCH_DEPTH; depth += 1, node = node.return) {
+    const props = node.memoizedProps;
+    if (!props) continue;
+    if (readInvalidProp(props) === void 0 && readRequiredProp(props) === void 0) continue;
+    return wrapsExactlyOneInput(node) ? props : void 0;
+  }
+  return void 0;
+}
 function stringProp(props, name) {
   const value = props?.[name];
   return typeof value === "string" && value.length > 0 ? value : void 0;
@@ -4588,6 +4783,8 @@ function isSwitchLike(fiber, props) {
 }
 function switchValue(props) {
   if (typeof props?.value === "boolean") return props.value;
+  const aria = props?.["aria-checked"];
+  if (typeof aria === "boolean") return aria;
   const checked = props?.accessibilityState?.checked;
   return checked === true;
 }
@@ -4981,6 +5178,11 @@ function walkSubtree(root, detectLists, startInModal = false) {
         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 filled = typeof rawValue === "string" ? rawValue.length > 0 : void 0;
+        const wrapper = readWrapperProps(fiber);
+        const required = readRequiredProp(props) ?? (wrapper ? readRequiredProp(wrapper) : void 0);
+        const invalid = readInvalidProp(props) ?? (wrapper ? readInvalidProp(wrapper) : void 0);
+        const focused = isFiberFocused(fiber);
         const identity = resolveIdentity(props, inferLabel(props));
         const geom = readGeometry(fiber);
         result.inputs.push(
@@ -4994,6 +5196,13 @@ function walkSubtree(root, detectLists, startInModal = false) {
               editable: props.editable !== false,
               secure: isSecure,
               type: inferInputType(props),
+              // Each one omitted rather than sent as `false` when the app
+              // says nothing: absent is UNKNOWN on all four, and the wire
+              // has to keep that apart from a declared negative.
+              ...required !== void 0 ? { required } : {},
+              ...invalid !== void 0 ? { invalid } : {},
+              ...filled !== void 0 ? { filled } : {},
+              ...focused !== void 0 ? { focused } : {},
               // 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.
@@ -5468,9 +5677,21 @@ function routesBelongToSameFeature(a, b) {
 // src/navigation/navigationState.ts
 var _currentScreen = null;
 var _navigationRef = null;
+var MAX_VISITED_SCREENS = 8;
+var _visited = [];
+function recordScreenVisit(screen) {
+  if (!screen) return;
+  if (_visited[_visited.length - 1] === screen) return;
+  _visited.push(screen);
+  if (_visited.length > MAX_VISITED_SCREENS) _visited.shift();
+}
+function getVisitedScreens() {
+  return [..._visited];
+}
 function setCurrentScreen(screen) {
   appilotsDebugLog(`setCurrentScreen: "${_currentScreen}" \u2192 "${screen}"`);
   _currentScreen = screen;
+  recordScreenVisit(screen);
 }
 function getCurrentScreen() {
   const activePath = getActiveRouteNames();
@@ -5484,6 +5705,7 @@ function getCurrentScreen() {
       }
       _currentScreen = deepest;
     }
+    recordScreenVisit(deepest);
     if (deepest) return deepest;
   }
   if (_navigationRef) {
@@ -5495,6 +5717,7 @@ function getCurrentScreen() {
         );
         _currentScreen = liveScreen;
       }
+      recordScreenVisit(liveScreen);
       return liveScreen;
     }
   }
@@ -5554,6 +5777,13 @@ function collectRouteNamesFromState(state, out = /* @__PURE__ */ new Set()) {
   }
   return out;
 }
+function backStackOf(state) {
+  const deepest = getDeepestNavigatorState(state);
+  const routes = deepest?.routes;
+  if (!Array.isArray(routes)) return [];
+  const index = typeof deepest.index === "number" ? deepest.index : routes.length - 1;
+  return routes.slice(0, index + 1).map((route) => route?.name).filter((name) => typeof name === "string" && name.length > 0);
+}
 function getDeepestNavigatorState(state) {
   if (!state) return void 0;
   const route = state.routes?.[state.index ?? 0];
@@ -5568,7 +5798,8 @@ function getNavigationStateSnapshot() {
       activePath: current,
       rootRouteNames: current,
       currentRouteNames: current,
-      routeNames: current
+      routeNames: current,
+      ...getVisitedScreens().length > 0 ? { visited: getVisitedScreens() } : {}
     } : null;
   }
   try {
@@ -5581,20 +5812,27 @@ function getNavigationStateSnapshot() {
         rootRouteNames: current,
         currentRouteNames: current,
         routeNames: current,
-        canGoBack: typeof _navigationRef.canGoBack === "function" ? _navigationRef.canGoBack() : void 0
+        canGoBack: typeof _navigationRef.canGoBack === "function" ? _navigationRef.canGoBack() : void 0,
+        ...getVisitedScreens().length > 0 ? { visited: getVisitedScreens() } : {}
       } : null;
     }
     const activePath = getActiveRouteNamesFromState(state);
     const currentRouteName = activePath[activePath.length - 1] ?? _currentScreen ?? void 0;
     const deepestState = getDeepestNavigatorState(state);
     const routeNames = Array.from(collectRouteNamesFromState(state));
+    const backStack = backStackOf(state);
     return {
       currentRouteName,
       activePath,
       rootRouteNames: routeNamesAtState(state),
       currentRouteNames: routeNamesAtState(deepestState),
       routeNames,
-      canGoBack: typeof _navigationRef.canGoBack === "function" ? _navigationRef.canGoBack() : void 0
+      canGoBack: typeof _navigationRef.canGoBack === "function" ? _navigationRef.canGoBack() : void 0,
+      // Both omitted when empty rather than sent as `[]`: an empty array
+      // reads as "we looked and there is nowhere to go back to", and on
+      // an app with no reachable navigator we did not look.
+      ...backStack.length > 0 ? { backStack } : {},
+      ...getVisitedScreens().length > 0 ? { visited: getVisitedScreens() } : {}
     };
   } catch {
     const current = _currentScreen ? [_currentScreen] : [];
@@ -5603,7 +5841,8 @@ function getNavigationStateSnapshot() {
       activePath: current,
       rootRouteNames: current,
       currentRouteNames: current,
-      routeNames: current
+      routeNames: current,
+      ...getVisitedScreens().length > 0 ? { visited: getVisitedScreens() } : {}
     } : null;
   }
 }
@@ -5757,13 +5996,37 @@ async function waitForLoadingSettle(opts = {}) {
   const stableTarget = opts.stableReads ?? 2;
   const pressedComponentId = opts.pressedComponentId ?? null;
   const fromScreen = opts.fromScreen ?? null;
+  const busyMaxMs = Math.max(maxMs, opts.busyMaxMs ?? 0);
   const startMs = Date.now();
-  const remaining = () => maxMs - (Date.now() - startMs);
   let probe = probeLoadingState(pressedComponentId, getCurrentScreen());
   let probeCount = 1;
   let stableCount = 1;
   let lastFingerprint = probe.fingerprint;
   let interval = initialPollMs;
+  let sawBusy = false;
+  let busySpent = false;
+  let extendedPastBudget = false;
+  let graceDeadlineMs;
+  const noteEvidence = () => {
+    const elapsedMs = Date.now() - startMs;
+    if (probe.loading) {
+      if (busySpent) return;
+      sawBusy = true;
+      if (elapsedMs > maxMs) extendedPastBudget = true;
+      return;
+    }
+    if (!sawBusy || busySpent) return;
+    if (extendedPastBudget) {
+      graceDeadlineMs = Math.min(busyMaxMs, elapsedMs + (stableTarget + 1) * pollMaxMs);
+    }
+    busySpent = true;
+  };
+  const remaining = () => {
+    const elapsedMs = Date.now() - startMs;
+    if (probe.loading && !busySpent) return busyMaxMs - elapsedMs;
+    return Math.max(maxMs, graceDeadlineMs ?? 0) - elapsedMs;
+  };
+  noteEvidence();
   const looksImmediatelyClean = !probe.loading && !probe.pressedDisabled && (!pressedComponentId || probe.pressedFound);
   if (looksImmediatelyClean) {
     await sleepMs(Math.min(80, Math.max(0, remaining())));
@@ -5780,6 +6043,7 @@ async function waitForLoadingSettle(opts = {}) {
       };
     }
     probe = recheck;
+    noteEvidence();
     lastFingerprint = recheck.fingerprint;
     stableCount = 1;
   }
@@ -5800,6 +6064,7 @@ async function waitForLoadingSettle(opts = {}) {
     }
     probe = probeLoadingState(pressedComponentId, currentScreen);
     probeCount++;
+    noteEvidence();
     const quiescent = !probe.loading && !probe.pressedDisabled && probe.fingerprint === lastFingerprint;
     if (quiescent) {
       stableCount++;
@@ -5831,7 +6096,7 @@ async function waitForLoadingSettle(opts = {}) {
 }
 
 // src/version.ts
-var SDK_VERSION2 = "0.11.0";
+var SDK_VERSION2 = "0.11.3";
 var FiberSentinel = class extends React2.Component {
   componentDidMount() {
     const fiber = this._reactInternals ?? this._reactInternalFiber ?? null;
@@ -5975,6 +6240,21 @@ function probeNameMangling(components) {
   return _lastProbe;
 }
 
+// src/platform/textInputFocus.ts
+function createTextInputFocusHost(textInput) {
+  const read = textInput?.State?.currentlyFocusedInput;
+  if (typeof read !== "function") return null;
+  return {
+    focusedInstance() {
+      try {
+        return textInput.State.currentlyFocusedInput() ?? null;
+      } catch {
+        return null;
+      }
+    }
+  };
+}
+
 // src/platform/fabricGeometry.ts
 function readRect(instance) {
   const candidate = instance;
@@ -6105,6 +6385,10 @@ function AppilotsProviderInner({
     setGeometryHost(createFabricGeometryHost(Dimensions));
     return () => setGeometryHost(null);
   }, []);
+  useEffect(() => {
+    setFocusHost(createTextInputFocusHost(TextInput));
+    return () => setFocusHost(null);
+  }, []);
   const trackNativeDialogs = config.trackNativeDialogs !== false;
   useEffect(() => {
     if (!trackNativeDialogs) return;
@@ -6204,4 +6488,4 @@ function clearScreenRegistry() {
   screenRegistry.clear();
 }
 
-export { ActionQueueMachine, AppilotsClient, AppilotsErrorBoundary, AppilotsProvider, AppilotsRegistryProvider, ChatSessionMachine, FORM_VALIDATION_TEXT_RE, FORM_WRITE_SUCCESS_TEXT_RE, OPTIONAL_STEP_AUTOMATION_HINT, RateLimitedError, SDK_VERSION2 as SDK_VERSION, TOUCHABLE_NAMES, _patchJsxRuntimes, actionPressTargetId, appilotsDebugLog, appilotsDebugWarn, attachElementIdsToChoiceGroups, clampSnapshotToWireLimits, clearAppilotsDebugTraces, clearScreenRegistry, componentRegistry, createComponentRegistry, createElementRegistry, createListRegistry, defaultDarkTheme, defaultLightTheme, deriveInteractionElements, describeAction, describeValue, elementRegistry, emptyDetectorCounts, enableAppilotsAutoTracking, findListItems, foldForCompare, geometryAvailability, geometryStats, getActiveRouteNames, getAllScreens, getAppilotsDebugTraces, getAutoTrackingState, getCurrentScreen, getCurrentScreenSignature, getDefaultRegistry, getFiberRoot, getGlobalConfig, getIntrospectionDiagnostics, getLastAnsweredNativeDialog, getLastWalkDiagnostics, getNameManglingProbe, getNavigationRef, getNavigationStateSnapshot, getOpenNativeDialog, getScreenMetadata, getTypeName, humanizeError, idLooselyMatches, initAppilots, isAlwaysListContainer, isAutoTrackingEnabled, isGenericSelectValue, isHeuristicListContainer, isListItemPressTarget, isModalFiber, isOptionalStepAutomationFailure, isReferenceable, isSwitchLike, listRegistry, looksDestructiveActionLabel, matchScore, mergeThemeTokens, normalize3, parseStableElementId, probeLoadingState, recordAppilotsDebugTrace, recordIntrospectionFailure, rectForNode, registerScreen, resolveBaseTheme, routesBelongToSameFeature, screenDepartedBaseline, setCurrentScreen, setNavigationRef, shouldSkipSubtree, snapshotShowsOpenCreateForm, subscribeAppilotsDebugTraces, switchValue, toWireElement, totalDetectorHits, useAppilotsContext, useResolvedRegistry, waitForLoadingSettle, waitForScreenSettle, walkFiber };
+export { ActionQueueMachine, AppilotsClient, AppilotsErrorBoundary, AppilotsProvider, AppilotsRegistryProvider, ChatSessionMachine, FORM_VALIDATION_TEXT_RE, FORM_WRITE_SUCCESS_TEXT_RE, OPTIONAL_STEP_AUTOMATION_HINT, RateLimitedError, SDK_VERSION2 as SDK_VERSION, TOUCHABLE_NAMES, _patchJsxRuntimes, actionPressTargetId, appilotsDebugLog, appilotsDebugWarn, attachElementIdsToChoiceGroups, clampSnapshotToWireLimits, clearAppilotsDebugTraces, clearScreenRegistry, componentRegistry, createComponentRegistry, createElementRegistry, createListRegistry, createSnapshotDeltaTracker, defaultDarkTheme, defaultLightTheme, deriveInteractionElements, describeAction, describeValue, elementRegistry, emptyDetectorCounts, enableAppilotsAutoTracking, findListItems, foldForCompare, geometryAvailability, geometryStats, getActiveRouteNames, getAllScreens, getAppilotsDebugTraces, getAutoTrackingState, getCurrentScreen, getCurrentScreenSignature, getDefaultRegistry, getFiberRoot, getGlobalConfig, getIntrospectionDiagnostics, getLastAnsweredNativeDialog, getLastWalkDiagnostics, getNameManglingProbe, getNavigationRef, getNavigationStateSnapshot, getOpenNativeDialog, getScreenMetadata, getTypeName, humanizeError, idLooselyMatches, initAppilots, isAlwaysListContainer, isAutoTrackingEnabled, isGenericSelectValue, isHeuristicListContainer, isListItemPressTarget, isModalFiber, isOptionalStepAutomationFailure, isReferenceable, isSwitchLike, listRegistry, looksDestructiveActionLabel, matchScore, mergeThemeTokens, normalize3, parseStableElementId, probeLoadingState, recordAppilotsDebugTrace, recordIntrospectionFailure, rectForNode, registerScreen, resolveBaseTheme, routesBelongToSameFeature, screenDepartedBaseline, setCurrentScreen, setNavigationRef, shouldSkipSubtree, snapshotShowsOpenCreateForm, subscribeAppilotsDebugTraces, switchValue, toWireElement, totalDetectorHits, useAppilotsContext, useResolvedRegistry, waitForLoadingSettle, waitForScreenSettle, walkFiber };