@appilots/sdk 0.11.1 → 0.11.3

package/dist/.build-meta.json

@@ -1,5 +1,5 @@
 {
-  "sourceHash": "6574aab0f4f8f43f",
-  "gitSha": "cdbfa225c28ac0cf0bf495bb8a8ec0c55d4dc1d1",
-  "builtAt": "2026-08-26T01:42:57.571Z"
+  "sourceHash": "d9adc8d175451d3a",
+  "gitSha": "9f1ad6d77e946ec908370319d90e8733cd4f1f31",
+  "builtAt": "2026-09-06T04:46:03.208Z"
 }

package/dist/{chunk-GSHE45YX.mjs → chunk-2ZDELL54.mjs}

@@ -1,4 +1,4 @@
-import { getFiberRoot, appilotsDebugWarn, recordIntrospectionFailure, getCurrentScreen, walkFiber, getActiveRouteNames, clampSnapshotToWireLimits, deriveInteractionElements, rectForNode, toWireElement, attachElementIdsToChoiceGroups, elementRegistry, appilotsDebugLog, getLastWalkDiagnostics, SDK_VERSION, geometryStats, geometryAvailability, getNameManglingProbe, emptyDetectorCounts, getAutoTrackingState, getIntrospectionDiagnostics, getDefaultRegistry, useAppilotsContext, ChatSessionMachine, getCurrentScreenSignature, ActionQueueMachine, getScreenMetadata, setCurrentScreen, useResolvedRegistry, totalDetectorHits, listRegistry, getOpenNativeDialog, componentRegistry, getLastAnsweredNativeDialog, probeLoadingState, isListItemPressTarget, waitForLoadingSettle, describeValue, waitForScreenSettle, screenDepartedBaseline, routesBelongToSameFeature, actionPressTargetId, getNavigationStateSnapshot, getNavigationRef, isOptionalStepAutomationFailure, OPTIONAL_STEP_AUTOMATION_HINT, isSwitchLike, normalize3, matchScore, FORM_VALIDATION_TEXT_RE, idLooselyMatches, parseStableElementId, shouldSkipSubtree, isAlwaysListContainer, isHeuristicListContainer, findListItems, getTypeName, foldForCompare, isModalFiber, switchValue, getAllScreens, snapshotShowsOpenCreateForm, isReferenceable, looksDestructiveActionLabel, isGenericSelectValue, FORM_WRITE_SUCCESS_TEXT_RE, TOUCHABLE_NAMES } from './chunk-PQZ64CCE.mjs';
+import { createSnapshotDeltaTracker, getFiberRoot, appilotsDebugWarn, recordIntrospectionFailure, getCurrentScreen, walkFiber, getActiveRouteNames, clampSnapshotToWireLimits, deriveInteractionElements, rectForNode, toWireElement, attachElementIdsToChoiceGroups, elementRegistry, appilotsDebugLog, getLastWalkDiagnostics, SDK_VERSION, geometryStats, geometryAvailability, getNameManglingProbe, emptyDetectorCounts, getAutoTrackingState, getIntrospectionDiagnostics, getDefaultRegistry, useAppilotsContext, ChatSessionMachine, getCurrentScreenSignature, ActionQueueMachine, getScreenMetadata, setCurrentScreen, useResolvedRegistry, totalDetectorHits, listRegistry, getOpenNativeDialog, componentRegistry, getLastAnsweredNativeDialog, probeLoadingState, isListItemPressTarget, waitForLoadingSettle, describeValue, waitForScreenSettle, screenDepartedBaseline, routesBelongToSameFeature, actionPressTargetId, getNavigationStateSnapshot, getNavigationRef, isOptionalStepAutomationFailure, OPTIONAL_STEP_AUTOMATION_HINT, isSwitchLike, idLooselyMatches, normalize3, matchScore, FORM_VALIDATION_TEXT_RE, parseStableElementId, shouldSkipSubtree, isAlwaysListContainer, isHeuristicListContainer, findListItems, getTypeName, foldForCompare, isModalFiber, switchValue, getAllScreens, snapshotShowsOpenCreateForm, isReferenceable, looksDestructiveActionLabel, isGenericSelectValue, FORM_WRITE_SUCCESS_TEXT_RE, TOUCHABLE_NAMES } from './chunk-ROXXCDIG.mjs';
 import React, { useMemo, useRef, useSyncExternalStore, useEffect, useCallback, useState } from 'react';
 import { Alert } from 'react-native';
 
@@ -3399,6 +3399,14 @@ async function formFillHandler(payload, context) {
     allSuccess = false;
   }
   if (payload.submitAfterFill === true) {
+    if (!permissions.canSubmitForms) {
+      return {
+        success: false,
+        error: "Form submission is not permitted",
+        fieldResults,
+        diagnose: { category: "unknown", screen: screenPath }
+      };
+    }
     if (!allSuccess) {
       const failedIds = fieldResults.filter((result) => !result.success).map((result) => result.fieldId);
       appilotsDebugWarn(
@@ -3406,6 +3414,9 @@ async function formFillHandler(payload, context) {
       );
     } else {
       await sleep2(120);
+      if (!permissions.canSubmitForms) {
+        return { success: false, error: "Form submission is not permitted", fieldResults };
+      }
       const submitResult = pressSubmitButton(
         {
           screen,
@@ -3711,6 +3722,59 @@ async function confirmHandler(_actionId, _payload) {
   return { success: true, effect: "unknown" };
 }
 
+// src/platform/asyncBudget.ts
+var POST_ACTION_LOADING_MAX_MS = 6e3;
+var INFERRED_ASYNC_LOADING_MAX_MS = 1e4;
+var POST_NAVIGATE_LOADING_MAX_MS = 3e3;
+var MAX_DECLARED_ASYNC_BUDGET_MS = 12e4;
+var ASYNC_BUSY_CEILING_MS = MAX_DECLARED_ASYNC_BUDGET_MS;
+function declaredBudgetMs(hints) {
+  const declared = hints?.asyncBudgetMs;
+  if (typeof declared !== "number" || !Number.isFinite(declared) || declared <= 0) return void 0;
+  return Math.min(declared, MAX_DECLARED_ASYNC_BUDGET_MS);
+}
+function resolveSettleCapMs(hints) {
+  const declared = declaredBudgetMs(hints);
+  if (declared !== void 0) return declared;
+  return hints?.isAsyncTrigger === true ? INFERRED_ASYNC_LOADING_MAX_MS : POST_ACTION_LOADING_MAX_MS;
+}
+function resolveBusyCeilingMs(hints) {
+  return declaredBudgetMs(hints) === void 0 ? ASYNC_BUSY_CEILING_MS : void 0;
+}
+function resolvePostNavigateCapMs(hints) {
+  return Math.max(POST_NAVIGATE_LOADING_MAX_MS, declaredBudgetMs(hints) ?? 0);
+}
+function resolveActionHints(screen, pressedComponentId, actionPayload) {
+  if (actionPayload && typeof actionPayload === "object") {
+    const payload = actionPayload;
+    const inline = payload._appilotsInferred;
+    const declared = payload._appilotsAsyncBudgetMs;
+    if (inline && typeof inline === "object") {
+      const hints = { ...inline };
+      if (typeof declared === "number") hints.asyncBudgetMs = declared;
+      return hints;
+    }
+    if (typeof declared === "number") return { asyncBudgetMs: declared };
+  }
+  if (!screen || !pressedComponentId) return void 0;
+  const meta = getScreenMetadata(screen);
+  const actions = meta?.actions;
+  if (!actions || actions.length === 0) return void 0;
+  for (const a of actions) {
+    if (typeof a === "string") continue;
+    if (idLooselyMatches(a.id, pressedComponentId)) {
+      const inferred = a.appilotsInferred;
+      const declared = a.asyncBudgetMs;
+      const hints = {
+        ...inferred && typeof inferred === "object" ? inferred : {},
+        ...typeof declared === "number" ? { asyncBudgetMs: declared } : {}
+      };
+      return Object.keys(hints).length > 0 ? hints : void 0;
+    }
+  }
+  return void 0;
+}
+
 // src/executor/postInteractionSettle.ts
 var sleepMs = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function targetIdFromPayload(payload) {
@@ -3759,7 +3823,8 @@ async function waitForPostInteractionSettle(payload) {
     if (discreteFieldSignature() !== baselineFields) return { effect: "changed" };
     return { effect: settled.fingerprint !== baseline.fingerprint ? "changed" : "none" };
   };
-  const capMs = isListItemPressTarget(targetId) ? 5e3 : 1e4;
+  const declared = declaredBudgetMs(resolveActionHints(fromScreen, targetId || null, payload));
+  const capMs = declared ?? (isListItemPressTarget(targetId) ? 5e3 : 1e4);
   if (modalOrLoading || fingerprintChanged) {
     await waitForLoadingSettle({
       pressedComponentId: targetId || null,
@@ -4056,7 +4121,7 @@ async function runWithConfirmedDestructiveContext(enabled, host, fn) {
 }
 
 // src/platform/reactNativeAdapter.ts
-var POST_ACTION_LOADING_MAX_MS = 6e3;
+var deltaTracker = createSnapshotDeltaTracker();
 function resolveScreenMetadata() {
   const activePath = getActiveRouteNames();
   for (let i = activePath.length - 1; i >= 0; i--) {
@@ -4070,6 +4135,7 @@ function resolveScreenMetadata() {
   return screen ? getScreenMetadata(screen) : void 0;
 }
 function buildAgentContext(extras = {}) {
+  if (extras.newMission === true) deltaTracker.reset();
   const context = {};
   context.platform = "react-native";
   const screen = getCurrentScreen();
@@ -4079,7 +4145,10 @@ function buildAgentContext(extras = {}) {
   const screenMeta = resolveScreenMetadata();
   if (screenMeta) context.screenMetadata = screenMeta;
   try {
-    context.snapshot = captureSnapshot();
+    const snapshot = captureSnapshot();
+    const delta = deltaTracker.observe(snapshot);
+    if (delta) snapshot.delta = delta;
+    context.snapshot = snapshot;
   } catch (err) {
     appilotsDebugWarn("buildAgentContext: captureSnapshot failed", err);
   }
@@ -4095,33 +4164,21 @@ function buildAgentContext(extras = {}) {
   if (extras.loadingPending === true) context.loadingPending = true;
   return context;
 }
-function resolveActionHints(screen, pressedComponentId, actionPayload) {
-  if (actionPayload && typeof actionPayload === "object") {
-    const inline = actionPayload._appilotsInferred;
-    if (inline && typeof inline === "object") {
-      return inline;
-    }
-  }
-  if (!screen || !pressedComponentId) return void 0;
-  const meta = getScreenMetadata(screen);
-  const actions = meta?.actions;
-  if (!actions || actions.length === 0) return void 0;
-  for (const a of actions) {
-    if (typeof a === "string") continue;
-    if (idLooselyMatches(a.id, pressedComponentId)) {
-      const inferred = a.appilotsInferred;
-      if (inferred && typeof inferred === "object") return inferred;
-      return void 0;
-    }
-  }
-  return void 0;
-}
 async function settleTurn(input) {
   const toolWithoutEffectIds = /* @__PURE__ */ new Set();
   let loadingPending = false;
   const { turnActions, pressedComponentId: pressedId, navigateTargetScreen } = input;
   const successById = new Map(input.results.map((r) => [r.actionId, r.success]));
   const typeById = new Map(input.results.map((r) => [r.actionId, r.type]));
+  const pressedAction = turnActions.find(
+    (a) => a.type === "ui_interaction" && a.payload?.componentId === pressedId
+  );
+  const hints = resolveActionHints(
+    getCurrentScreen(),
+    pressedId,
+    pressedAction?.payload
+  );
+  const capSource = typeof hints?.asyncBudgetMs === "number" && hints.asyncBudgetMs > 0 ? " (app-declared)" : hints?.isAsyncTrigger ? " (mcp-inferred)" : "";
   if (input.hadNavigate) {
     const settle = await waitForScreenSettle({
       expectingChange: true,
@@ -4142,27 +4199,26 @@ async function settleTurn(input) {
         if (type === "navigate") toolWithoutEffectIds.add(actionId);
       }
     }
+    const postNavigateCapMs = resolvePostNavigateCapMs(hints);
     const loadSettle = await waitForLoadingSettle({
       fromScreen: settle.screen ?? null,
-      maxMs: 3e3
+      maxMs: postNavigateCapMs
     });
     appilotsDebugLog(
-      `settleTurn: post-navigate loading settle \u2014 settled=${loadSettle.settled} loadingPending=${loadSettle.loadingPending} probes=${loadSettle.probeCount} waitedMs=${loadSettle.waitedMs}`
+      `settleTurn: post-navigate loading settle \u2014 settled=${loadSettle.settled} loadingPending=${loadSettle.loadingPending} probes=${loadSettle.probeCount} waitedMs=${loadSettle.waitedMs} cap=${postNavigateCapMs}${capSource}`
     );
     if (loadSettle.loadingPending) loadingPending = true;
   } else {
-    const pressedAction = turnActions.find(
-      (a) => a.type === "ui_interaction" && a.payload?.componentId === pressedId
-    );
-    const hints = resolveActionHints(getCurrentScreen(), pressedId, pressedAction?.payload);
-    const settleCapMs = hints?.isAsyncTrigger === true ? 1e4 : POST_ACTION_LOADING_MAX_MS;
+    const settleCapMs = resolveSettleCapMs(hints);
+    const busyMaxMs = resolveBusyCeilingMs(hints);
     const loadSettle = await waitForLoadingSettle({
       pressedComponentId: pressedId,
       fromScreen: getCurrentScreen(),
-      maxMs: settleCapMs
+      maxMs: settleCapMs,
+      ...busyMaxMs !== void 0 ? { busyMaxMs } : {}
     });
     appilotsDebugLog(
-      `settleTurn: post-action loading settle \u2014 pressedId="${pressedId ?? ""}" settled=${loadSettle.settled} transitioned=${loadSettle.transitioned} loadingPending=${loadSettle.loadingPending} probes=${loadSettle.probeCount} waitedMs=${loadSettle.waitedMs} cap=${settleCapMs}${hints?.isAsyncTrigger ? " (mcp-inferred)" : ""}`
+      `settleTurn: post-action loading settle \u2014 pressedId="${pressedId ?? ""}" settled=${loadSettle.settled} transitioned=${loadSettle.transitioned} loadingPending=${loadSettle.loadingPending} probes=${loadSettle.probeCount} waitedMs=${loadSettle.waitedMs} cap=${settleCapMs}${capSource}${busyMaxMs !== void 0 ? ` busyCap=${busyMaxMs}` : ""}`
     );
     if (loadSettle.loadingPending) loadingPending = true;
     const listPressActions = turnActions.filter((action) => {

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

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkKZ2BLMS4_js = require('./chunk-KZ2BLMS4.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 } = chunkKZ2BLMS4_js.useAppilotsContext();
+  const { emit } = chunkSUMIABJK_js.useAppilotsContext();
   const internalRef = React.useRef(null);
   const handleRef = React.useCallback(
     (instance) => {
       internalRef.current = instance;
-      chunkKZ2BLMS4_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) {
-        chunkKZ2BLMS4_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) {
-        chunkKZ2BLMS4_js.appilotsDebugLog(`Screen changed \u2192 "${routeName}"`);
-        chunkKZ2BLMS4_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) {
-        chunkKZ2BLMS4_js.appilotsDebugLog(`Initial screen \u2192 "${route.name}"`);
-        chunkKZ2BLMS4_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-LLH7QCSX.mjs → chunk-JKLE5SLN.mjs}

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