@appilots/sdk 0.11.0 → 0.11.3

package/dist/navigation/index.d.mts

@@ -83,6 +83,33 @@ interface ScreenActionMetadata {
      * between sdk and mcp-generator packages.
      */
     appilotsInferred?: AppilotsInferredAction;
+    /**
+     * How long this action's work takes, in milliseconds, as DECLARED by
+     * the app. The SDK waits this long for the UI to settle after pressing
+     * it, instead of the agnostic default.
+     *
+     * There is no constant that fits: an app operation runs from ~100ms to
+     * minutes, and when the wait is too short the agent photographs a
+     * loading screen with no controls on it and plans against nothing. The
+     * app is the only party that knows, so it says so:
+     *
+     * ```tsx
+     * registerScreen({
+     *   name: 'Wizard',
+     *   actions: [{ id: 'gerar', label: 'Gerar', type: 'submit', asyncBudgetMs: 90_000 }],
+     * });
+     * ```
+     *
+     * Omitting it is supported and common: the SDK then falls back on its
+     * defaults (6s, or 10s when the generator inferred the handler is
+     * async) AND on what it can see — while the screen keeps a loading
+     * indicator up, the wait runs on to a safety ceiling. So declaring is
+     * how an app says "this one is QUICK, do not wait on my spinner", or
+     * gives a number for work that shows no indicator at all. The value is
+     * clamped to `MAX_DECLARED_ASYNC_BUDGET_MS`: a declaration is a
+     * request, not a licence to hang the session.
+     */
+    asyncBudgetMs?: number;
 }
 /**
  * Inferred metadata about an action's expected async behavior.
@@ -156,12 +183,6 @@ declare function getAllScreens(): ScreenMetadata[];
 /** Clear the screen registry (useful for testing) */
 declare function clearScreenRegistry(): void;
 
-/**
- * Global navigation state — lightweight singleton so any part of the SDK
- * can read the current screen without needing a React context or hook.
- *
- * Updated by AppilotsNavigationContainer and read by useAppilotsChat().
- */
 /**
  * Tell the SDK which screen the user is on.
  *
@@ -199,6 +220,21 @@ interface RuntimeNavigationStateSnapshot {
     routeNames: string[];
     /** Whether React Navigation reports that goBack() can currently run. */
     canGoBack?: boolean;
+    /**
+     * The stack a back press pops through, oldest first, ending on the
+     * current screen. Empty when no navigator is reachable.
+     *
+     * `canGoBack` says a back exists; this says where it goes.
+     */
+    backStack?: string[];
+    /**
+     * Screens the user has been on this session, oldest first, capped and
+     * with consecutive repeats collapsed.
+     *
+     * Different from `backStack`: a popped screen leaves the stack and
+     * stays here, and a tab switch never touches the stack at all.
+     */
+    visited?: string[];
 }
 /**
  * Snapshot the runtime navigation tree in a small, serializable shape.

package/dist/navigation/index.d.ts

@@ -83,6 +83,33 @@ interface ScreenActionMetadata {
      * between sdk and mcp-generator packages.
      */
     appilotsInferred?: AppilotsInferredAction;
+    /**
+     * How long this action's work takes, in milliseconds, as DECLARED by
+     * the app. The SDK waits this long for the UI to settle after pressing
+     * it, instead of the agnostic default.
+     *
+     * There is no constant that fits: an app operation runs from ~100ms to
+     * minutes, and when the wait is too short the agent photographs a
+     * loading screen with no controls on it and plans against nothing. The
+     * app is the only party that knows, so it says so:
+     *
+     * ```tsx
+     * registerScreen({
+     *   name: 'Wizard',
+     *   actions: [{ id: 'gerar', label: 'Gerar', type: 'submit', asyncBudgetMs: 90_000 }],
+     * });
+     * ```
+     *
+     * Omitting it is supported and common: the SDK then falls back on its
+     * defaults (6s, or 10s when the generator inferred the handler is
+     * async) AND on what it can see — while the screen keeps a loading
+     * indicator up, the wait runs on to a safety ceiling. So declaring is
+     * how an app says "this one is QUICK, do not wait on my spinner", or
+     * gives a number for work that shows no indicator at all. The value is
+     * clamped to `MAX_DECLARED_ASYNC_BUDGET_MS`: a declaration is a
+     * request, not a licence to hang the session.
+     */
+    asyncBudgetMs?: number;
 }
 /**
  * Inferred metadata about an action's expected async behavior.
@@ -156,12 +183,6 @@ declare function getAllScreens(): ScreenMetadata[];
 /** Clear the screen registry (useful for testing) */
 declare function clearScreenRegistry(): void;
 
-/**
- * Global navigation state — lightweight singleton so any part of the SDK
- * can read the current screen without needing a React context or hook.
- *
- * Updated by AppilotsNavigationContainer and read by useAppilotsChat().
- */
 /**
  * Tell the SDK which screen the user is on.
  *
@@ -199,6 +220,21 @@ interface RuntimeNavigationStateSnapshot {
     routeNames: string[];
     /** Whether React Navigation reports that goBack() can currently run. */
     canGoBack?: boolean;
+    /**
+     * The stack a back press pops through, oldest first, ending on the
+     * current screen. Empty when no navigator is reachable.
+     *
+     * `canGoBack` says a back exists; this says where it goes.
+     */
+    backStack?: string[];
+    /**
+     * Screens the user has been on this session, oldest first, capped and
+     * with consecutive repeats collapsed.
+     *
+     * Different from `backStack`: a popped screen leaves the stack and
+     * stays here, and a tab switch never touches the stack at all.
+     */
+    visited?: string[];
 }
 /**
  * Snapshot the runtime navigation tree in a small, serializable shape.

package/dist/navigation/index.js

@@ -1,51 +1,51 @@
 'use strict';
 
-var chunkIZEWWAA7_js = require('../chunk-IZEWWAA7.js');
-var chunk55Y2AQE7_js = require('../chunk-55Y2AQE7.js');
+var chunk5UVMNKPT_js = require('../chunk-5UVMNKPT.js');
+var chunkSUMIABJK_js = require('../chunk-SUMIABJK.js');
 
 
 
 Object.defineProperty(exports, "AppilotsNavigationContainer", {
   enumerable: true,
-  get: function () { return chunkIZEWWAA7_js.AppilotsNavigationContainer; }
+  get: function () { return chunk5UVMNKPT_js.AppilotsNavigationContainer; }
 });
 Object.defineProperty(exports, "clearScreenRegistry", {
   enumerable: true,
-  get: function () { return chunk55Y2AQE7_js.clearScreenRegistry; }
+  get: function () { return chunkSUMIABJK_js.clearScreenRegistry; }
 });
 Object.defineProperty(exports, "getActiveRouteNames", {
   enumerable: true,
-  get: function () { return chunk55Y2AQE7_js.getActiveRouteNames; }
+  get: function () { return chunkSUMIABJK_js.getActiveRouteNames; }
 });
 Object.defineProperty(exports, "getAllScreens", {
   enumerable: true,
-  get: function () { return chunk55Y2AQE7_js.getAllScreens; }
+  get: function () { return chunkSUMIABJK_js.getAllScreens; }
 });
 Object.defineProperty(exports, "getCurrentScreen", {
   enumerable: true,
-  get: function () { return chunk55Y2AQE7_js.getCurrentScreen; }
+  get: function () { return chunkSUMIABJK_js.getCurrentScreen; }
 });
 Object.defineProperty(exports, "getNavigationRef", {
   enumerable: true,
-  get: function () { return chunk55Y2AQE7_js.getNavigationRef; }
+  get: function () { return chunkSUMIABJK_js.getNavigationRef; }
 });
 Object.defineProperty(exports, "getNavigationStateSnapshot", {
   enumerable: true,
-  get: function () { return chunk55Y2AQE7_js.getNavigationStateSnapshot; }
+  get: function () { return chunkSUMIABJK_js.getNavigationStateSnapshot; }
 });
 Object.defineProperty(exports, "getScreenMetadata", {
   enumerable: true,
-  get: function () { return chunk55Y2AQE7_js.getScreenMetadata; }
+  get: function () { return chunkSUMIABJK_js.getScreenMetadata; }
 });
 Object.defineProperty(exports, "registerScreen", {
   enumerable: true,
-  get: function () { return chunk55Y2AQE7_js.registerScreen; }
+  get: function () { return chunkSUMIABJK_js.registerScreen; }
 });
 Object.defineProperty(exports, "setCurrentScreen", {
   enumerable: true,
-  get: function () { return chunk55Y2AQE7_js.setCurrentScreen; }
+  get: function () { return chunkSUMIABJK_js.setCurrentScreen; }
 });
 Object.defineProperty(exports, "setNavigationRef", {
   enumerable: true,
-  get: function () { return chunk55Y2AQE7_js.setNavigationRef; }
+  get: function () { return chunkSUMIABJK_js.setNavigationRef; }
 });

package/dist/navigation/index.mjs

@@ -1,2 +1,2 @@
-export { AppilotsNavigationContainer } from '../chunk-3K7ORC4X.mjs';
-export { clearScreenRegistry, getActiveRouteNames, getAllScreens, getCurrentScreen, getNavigationRef, getNavigationStateSnapshot, getScreenMetadata, registerScreen, setCurrentScreen, setNavigationRef } from '../chunk-G6KI7KVH.mjs';
+export { AppilotsNavigationContainer } from '../chunk-JKLE5SLN.mjs';
+export { clearScreenRegistry, getActiveRouteNames, getAllScreens, getCurrentScreen, getNavigationRef, getNavigationStateSnapshot, getScreenMetadata, registerScreen, setCurrentScreen, setNavigationRef } from '../chunk-ROXXCDIG.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appilots/sdk",
-  "version": "0.11.0",
+  "version": "0.11.3",
   "description": "AI-powered chat component and navigation SDK for React Native apps",
   "main": "dist/index.js",
   "module": "dist/index.mjs",