@appilots/sdk 0.6.0 → 0.8.0

package/dist/{chunk-DR75QTYK.mjs → chunk-ZSEACJKU.mjs}

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

package/dist/hooks/index.d.mts

@@ -1,2 +1,2 @@
-export { J as SuggestedPrompt, Q as UseAppilotsFieldOptions, V as UseAppilotsSliderOptions, W as UseAppilotsTargetOptions, X as UseAppilotsToggleOptions, Y as UseSuggestedPromptsOptions, Z as UseSuggestedPromptsReturn, a9 as useAppilots, aa as useAppilotsActions, ab as useAppilotsChat, ad as useAppilotsField, ae as useAppilotsNavigation, af as useAppilotsSlider, ag as useAppilotsTarget, ah as useAppilotsToggle, ai as useSuggestedPrompts } from '../index-nI-s3Exg.mjs';
+export { H as SuggestedPrompt, O as UseAppilotsFieldOptions, Q as UseAppilotsSliderOptions, V as UseAppilotsTargetOptions, W as UseAppilotsToggleOptions, X as UseSuggestedPromptsOptions, Y as UseSuggestedPromptsReturn, a8 as useAppilots, a9 as useAppilotsActions, aa as useAppilotsChat, ac as useAppilotsField, ad as useAppilotsNavigation, ae as useAppilotsSlider, af as useAppilotsTarget, ag as useAppilotsToggle, ah as useSuggestedPrompts } from '../index-BdYY-dvG.mjs';
 import 'react';

package/dist/hooks/index.d.ts

@@ -1,2 +1,2 @@
-export { J as SuggestedPrompt, Q as UseAppilotsFieldOptions, V as UseAppilotsSliderOptions, W as UseAppilotsTargetOptions, X as UseAppilotsToggleOptions, Y as UseSuggestedPromptsOptions, Z as UseSuggestedPromptsReturn, a9 as useAppilots, aa as useAppilotsActions, ab as useAppilotsChat, ad as useAppilotsField, ae as useAppilotsNavigation, af as useAppilotsSlider, ag as useAppilotsTarget, ah as useAppilotsToggle, ai as useSuggestedPrompts } from '../index-nI-s3Exg.js';
+export { H as SuggestedPrompt, O as UseAppilotsFieldOptions, Q as UseAppilotsSliderOptions, V as UseAppilotsTargetOptions, W as UseAppilotsToggleOptions, X as UseSuggestedPromptsOptions, Y as UseSuggestedPromptsReturn, a8 as useAppilots, a9 as useAppilotsActions, aa as useAppilotsChat, ac as useAppilotsField, ad as useAppilotsNavigation, ae as useAppilotsSlider, af as useAppilotsTarget, ag as useAppilotsToggle, ah as useSuggestedPrompts } from '../index-BdYY-dvG.js';
 import 'react';

package/dist/hooks/index.js

@@ -1,43 +1,43 @@
 'use strict';
 
-var chunkHFRIB4YN_js = require('../chunk-HFRIB4YN.js');
-require('../chunk-DZ7QRFHD.js');
+var chunkN7EAOLBP_js = require('../chunk-N7EAOLBP.js');
+require('../chunk-AYWMBMSN.js');
 
 
 
 Object.defineProperty(exports, "useAppilots", {
   enumerable: true,
-  get: function () { return chunkHFRIB4YN_js.useAppilots; }
+  get: function () { return chunkN7EAOLBP_js.useAppilots; }
 });
 Object.defineProperty(exports, "useAppilotsActions", {
   enumerable: true,
-  get: function () { return chunkHFRIB4YN_js.useAppilotsActions; }
+  get: function () { return chunkN7EAOLBP_js.useAppilotsActions; }
 });
 Object.defineProperty(exports, "useAppilotsChat", {
   enumerable: true,
-  get: function () { return chunkHFRIB4YN_js.useAppilotsChat; }
+  get: function () { return chunkN7EAOLBP_js.useAppilotsChat; }
 });
 Object.defineProperty(exports, "useAppilotsField", {
   enumerable: true,
-  get: function () { return chunkHFRIB4YN_js.useAppilotsField; }
+  get: function () { return chunkN7EAOLBP_js.useAppilotsField; }
 });
 Object.defineProperty(exports, "useAppilotsNavigation", {
   enumerable: true,
-  get: function () { return chunkHFRIB4YN_js.useAppilotsNavigation; }
+  get: function () { return chunkN7EAOLBP_js.useAppilotsNavigation; }
 });
 Object.defineProperty(exports, "useAppilotsSlider", {
   enumerable: true,
-  get: function () { return chunkHFRIB4YN_js.useAppilotsSlider; }
+  get: function () { return chunkN7EAOLBP_js.useAppilotsSlider; }
 });
 Object.defineProperty(exports, "useAppilotsTarget", {
   enumerable: true,
-  get: function () { return chunkHFRIB4YN_js.useAppilotsTarget; }
+  get: function () { return chunkN7EAOLBP_js.useAppilotsTarget; }
 });
 Object.defineProperty(exports, "useAppilotsToggle", {
   enumerable: true,
-  get: function () { return chunkHFRIB4YN_js.useAppilotsToggle; }
+  get: function () { return chunkN7EAOLBP_js.useAppilotsToggle; }
 });
 Object.defineProperty(exports, "useSuggestedPrompts", {
   enumerable: true,
-  get: function () { return chunkHFRIB4YN_js.useSuggestedPrompts; }
+  get: function () { return chunkN7EAOLBP_js.useSuggestedPrompts; }
 });

package/dist/hooks/index.mjs

@@ -1,2 +1,2 @@
-export { useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts } from '../chunk-KUFWRJC4.mjs';
-import '../chunk-R4D34FEW.mjs';
+export { useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts } from '../chunk-MHWVRZYF.mjs';
+import '../chunk-C2KVVJ5K.mjs';

package/dist/{index-nI-s3Exg.d.mts → index-BdYY-dvG.d.mts}

@@ -303,11 +303,13 @@ interface EscalationState {
 /**
  * Mirrors `introspectionDiagnosticsSchema` on the wire. Declared here
  * rather than imported so client-core stays free of the server's
- * validator package.
+ * validator package — which means the two must be kept in step by hand.
+ * Adding a reason to one and not the other is a typecheck failure at
+ * the SDK, not a silent wire mismatch.
  */
 interface IntrospectionDiagnosticsInput {
     captured: boolean;
-    failureReason?: 'sentinel-missing-internals' | 'never-mounted' | null;
+    failureReason?: 'sentinel-missing-internals' | 'never-mounted' | 'render-crashed' | null;
     reactVersion?: string | null;
     failureCount?: number;
 }
@@ -347,6 +349,20 @@ interface AppilotsClientOptions {
      * essential for OTA-updated fleets where multiple app versions coexist.
      */
     appVersion?: string;
+    /**
+     * The version of the SDK package driving this client, sent as
+     * `X-Appilots-Sdk-Version`. Each platform SDK passes its OWN published
+     * version (`@appilots/sdk`, `@appilots/web-sdk`); `@appilots/client-core`
+     * is private and never published, so its version means nothing to a
+     * customer and is only the fallback for a caller that constructs
+     * `AppilotsClient` directly.
+     *
+     * This is the server's only evidence of which SDKs are in the field,
+     * and therefore the only input to "is this field safe to tighten yet?"
+     * (issue #312). Leaving it wrong is not cosmetic: it makes the
+     * backward-compatibility promise in CLAUDE.md unverifiable.
+     */
+    sdkVersion?: string;
     /**
      * Who the app's current user is. `id` becomes the session's
      * externalUserId; `name`/`identifiers` are upserted into the
@@ -904,6 +920,18 @@ interface ScreenSnapshot {
      * prefer these ids over synthetic ordinal handles.
      */
     elements: InteractionElementSnapshot[];
+    /**
+     * Set when the walker's output exceeded the wire contract and
+     * `clampSnapshotToWireLimits` dropped part of it (see
+     * `introspection/wireLimits.ts`). Absent means the observation is
+     * complete.
+     *
+     * The server surfaces this to the model: a screen whose text was cut
+     * at 500 entries must not be read as a screen with only 500 things on
+     * it. Without the flag a truncated observation is indistinguishable
+     * from a short one.
+     */
+    truncated?: boolean;
     /** Diagnostic counts for debugging */
     stats?: {
         visitedFibers: number;
@@ -981,13 +1009,6 @@ declare function describeAction(action: AgentAction): BreadcrumbItem;
  */
 declare function humanizeError(raw: string | undefined, _action?: AgentAction): string | undefined;
 
-/**
- * SDK version — bumped by changesets on release. Lives in its own module
- * so runtime code (AppilotsClient) can import it without pulling the whole
- * public barrel in and creating an import cycle.
- */
-declare const SDK_VERSION = "0.1.0";
-
 interface AppilotsConfig {
     /** Project ID from the Appilots dashboard */
     projectId: string;
@@ -1025,6 +1046,19 @@ interface AppilotsConfig {
      * @default true
      */
     fetchPersonalization?: boolean;
+    /**
+     * While running a destructive action the user already approved on the
+     * chat's confirm card, suppress the app's OWN `Alert.alert`
+     * confirmation once — otherwise they answer the same question twice
+     * and the second dialog is one the agent cannot press.
+     *
+     * Doing that means briefly replacing a global that belongs to your
+     * app, so it is opt-outable: set `false` to keep `Alert.alert`
+     * untouched at all times and show your own dialog instead. See
+     * `platform/confirmedDestructiveAlert.ts` for the exact window.
+     * @default true
+     */
+    suppressNativeConfirm?: boolean;
 }
 interface AppilotsProviderProps {
     /**
@@ -1049,8 +1083,26 @@ interface AppilotsContextValue {
      * and re-renders once this lands (accepted cold-start flash).
      */
     remotePersonalization: RemotePersonalization | null;
+    /**
+     * True when the provider crashed and the error boundary degraded it.
+     * The host app is still mounted and still has a context (so its
+     * `useAppilots()` calls don't throw), but nothing is wired: `client`
+     * rejects, `emit`/`subscribe` are inert, and `AppilotsChat` renders
+     * nothing. Consumers that show their own assistant affordance should
+     * branch on this.
+     */
+    degraded?: boolean;
 }
-declare function AppilotsProvider({ config: configProp, children, client: externalClient }: AppilotsProviderProps): React__default.JSX.Element;
+/**
+ * Public entry point. Its only job is to keep an exception thrown by
+ * anything Appilots renders from unmounting the host app's tree.
+ *
+ * The fallback deliberately re-renders `children` under a degraded
+ * context instead of a "something went wrong" screen: the children ARE
+ * the customer's app, and replacing them would be the same outage the
+ * boundary is here to prevent, just with nicer wording.
+ */
+declare function AppilotsProvider({ config, children, client }: AppilotsProviderProps): React__default.JSX.Element;
 declare function useAppilotsContext(): AppilotsContextValue;
 
 /**
@@ -1594,4 +1646,4 @@ interface UseSuggestedPromptsReturn {
  */
 declare function useSuggestedPrompts(options: UseSuggestedPromptsOptions): UseSuggestedPromptsReturn;
 
-export { componentRegistry as $, type AppilotsThemeTokens as A, type BreadcrumbItem as B, type ComponentRegistry as C, type RemotePersonalization as D, type EscalationState as E, type FieldEntry as F, SDK_VERSION as G, type SliderEntry as H, type InteractionElementSnapshot as I, type SuggestedPrompt as J, type ToggleEntry as K, type ListItemSnapshot as L, type MessageRole as M, type NavigationPayload as N, type ToggleSnapshot as O, type PartialThemeTokens as P, type UseAppilotsFieldOptions as Q, RateLimitedError as R, type ScreenSnapshot as S, type TargetEntry as T, type UIInteractionPayload as U, type UseAppilotsSliderOptions as V, type UseAppilotsTargetOptions as W, type UseAppilotsToggleOptions as X, type UseSuggestedPromptsOptions as Y, type UseSuggestedPromptsReturn as Z, clearAppilotsDebugTraces as _, type AppilotsLocale as a, createComponentRegistry as a0, defaultDarkTheme as a1, defaultLightTheme as a2, describeAction as a3, getAppilotsDebugTraces as a4, humanizeError as a5, mergeThemeTokens as a6, recordAppilotsDebugTrace as a7, subscribeAppilotsDebugTraces as a8, useAppilots as a9, useAppilotsActions as aa, useAppilotsChat as ab, useAppilotsContext as ac, useAppilotsField as ad, useAppilotsNavigation as ae, useAppilotsSlider as af, useAppilotsTarget as ag, useAppilotsToggle as ah, useSuggestedPrompts as ai, type AgentAction as b, type AgentPermissions as c, type AppilotsEvent as d, type AgentActionType as e, type AgentMessage as f, AppilotsClient as g, type AppilotsClientOptions as h, type AppilotsConfig as i, type AppilotsEventHandler as j, type AppilotsEventType as k, AppilotsProvider as l, type AppilotsProviderProps as m, type AppilotsTraceEntry as n, type AppilotsUser as o, type BreadcrumbState as p, type ButtonSnapshot as q, type ChatMessage as r, type ChoiceGroupSnapshot as s, type ChoiceOptionSnapshot as t, type ComponentEntry as u, type ComponentKind as v, type FormFillPayload as w, type InputSnapshot as x, type InteractionElementListContext as y, type ListSnapshot as z };
+export { createComponentRegistry as $, type AppilotsThemeTokens as A, type BreadcrumbItem as B, type ComponentRegistry as C, type RemotePersonalization as D, type EscalationState as E, type FieldEntry as F, type SliderEntry as G, type SuggestedPrompt as H, type InteractionElementSnapshot as I, type ToggleEntry as J, type ToggleSnapshot as K, type ListItemSnapshot as L, type MessageRole as M, type NavigationPayload as N, type UseAppilotsFieldOptions as O, type PartialThemeTokens as P, type UseAppilotsSliderOptions as Q, RateLimitedError as R, type ScreenSnapshot as S, type TargetEntry as T, type UIInteractionPayload as U, type UseAppilotsTargetOptions as V, type UseAppilotsToggleOptions as W, type UseSuggestedPromptsOptions as X, type UseSuggestedPromptsReturn as Y, clearAppilotsDebugTraces as Z, componentRegistry as _, type AppilotsLocale as a, defaultDarkTheme as a0, defaultLightTheme as a1, describeAction as a2, getAppilotsDebugTraces as a3, humanizeError as a4, mergeThemeTokens as a5, recordAppilotsDebugTrace as a6, subscribeAppilotsDebugTraces as a7, useAppilots as a8, useAppilotsActions as a9, useAppilotsChat as aa, useAppilotsContext as ab, useAppilotsField as ac, useAppilotsNavigation as ad, useAppilotsSlider as ae, useAppilotsTarget as af, useAppilotsToggle as ag, useSuggestedPrompts as ah, type AgentAction as b, type AgentPermissions as c, type AppilotsEvent as d, type AgentActionType as e, type AgentMessage as f, AppilotsClient as g, type AppilotsClientOptions as h, type AppilotsConfig as i, type AppilotsEventHandler as j, type AppilotsEventType as k, AppilotsProvider as l, type AppilotsProviderProps as m, type AppilotsTraceEntry as n, type AppilotsUser as o, type BreadcrumbState as p, type ButtonSnapshot as q, type ChatMessage as r, type ChoiceGroupSnapshot as s, type ChoiceOptionSnapshot as t, type ComponentEntry as u, type ComponentKind as v, type FormFillPayload as w, type InputSnapshot as x, type InteractionElementListContext as y, type ListSnapshot as z };

package/dist/{index-nI-s3Exg.d.ts → index-BdYY-dvG.d.ts}

@@ -303,11 +303,13 @@ interface EscalationState {
 /**
  * Mirrors `introspectionDiagnosticsSchema` on the wire. Declared here
  * rather than imported so client-core stays free of the server's
- * validator package.
+ * validator package — which means the two must be kept in step by hand.
+ * Adding a reason to one and not the other is a typecheck failure at
+ * the SDK, not a silent wire mismatch.
  */
 interface IntrospectionDiagnosticsInput {
     captured: boolean;
-    failureReason?: 'sentinel-missing-internals' | 'never-mounted' | null;
+    failureReason?: 'sentinel-missing-internals' | 'never-mounted' | 'render-crashed' | null;
     reactVersion?: string | null;
     failureCount?: number;
 }
@@ -347,6 +349,20 @@ interface AppilotsClientOptions {
      * essential for OTA-updated fleets where multiple app versions coexist.
      */
     appVersion?: string;
+    /**
+     * The version of the SDK package driving this client, sent as
+     * `X-Appilots-Sdk-Version`. Each platform SDK passes its OWN published
+     * version (`@appilots/sdk`, `@appilots/web-sdk`); `@appilots/client-core`
+     * is private and never published, so its version means nothing to a
+     * customer and is only the fallback for a caller that constructs
+     * `AppilotsClient` directly.
+     *
+     * This is the server's only evidence of which SDKs are in the field,
+     * and therefore the only input to "is this field safe to tighten yet?"
+     * (issue #312). Leaving it wrong is not cosmetic: it makes the
+     * backward-compatibility promise in CLAUDE.md unverifiable.
+     */
+    sdkVersion?: string;
     /**
      * Who the app's current user is. `id` becomes the session's
      * externalUserId; `name`/`identifiers` are upserted into the
@@ -904,6 +920,18 @@ interface ScreenSnapshot {
      * prefer these ids over synthetic ordinal handles.
      */
     elements: InteractionElementSnapshot[];
+    /**
+     * Set when the walker's output exceeded the wire contract and
+     * `clampSnapshotToWireLimits` dropped part of it (see
+     * `introspection/wireLimits.ts`). Absent means the observation is
+     * complete.
+     *
+     * The server surfaces this to the model: a screen whose text was cut
+     * at 500 entries must not be read as a screen with only 500 things on
+     * it. Without the flag a truncated observation is indistinguishable
+     * from a short one.
+     */
+    truncated?: boolean;
     /** Diagnostic counts for debugging */
     stats?: {
         visitedFibers: number;
@@ -981,13 +1009,6 @@ declare function describeAction(action: AgentAction): BreadcrumbItem;
  */
 declare function humanizeError(raw: string | undefined, _action?: AgentAction): string | undefined;
 
-/**
- * SDK version — bumped by changesets on release. Lives in its own module
- * so runtime code (AppilotsClient) can import it without pulling the whole
- * public barrel in and creating an import cycle.
- */
-declare const SDK_VERSION = "0.1.0";
-
 interface AppilotsConfig {
     /** Project ID from the Appilots dashboard */
     projectId: string;
@@ -1025,6 +1046,19 @@ interface AppilotsConfig {
      * @default true
      */
     fetchPersonalization?: boolean;
+    /**
+     * While running a destructive action the user already approved on the
+     * chat's confirm card, suppress the app's OWN `Alert.alert`
+     * confirmation once — otherwise they answer the same question twice
+     * and the second dialog is one the agent cannot press.
+     *
+     * Doing that means briefly replacing a global that belongs to your
+     * app, so it is opt-outable: set `false` to keep `Alert.alert`
+     * untouched at all times and show your own dialog instead. See
+     * `platform/confirmedDestructiveAlert.ts` for the exact window.
+     * @default true
+     */
+    suppressNativeConfirm?: boolean;
 }
 interface AppilotsProviderProps {
     /**
@@ -1049,8 +1083,26 @@ interface AppilotsContextValue {
      * and re-renders once this lands (accepted cold-start flash).
      */
     remotePersonalization: RemotePersonalization | null;
+    /**
+     * True when the provider crashed and the error boundary degraded it.
+     * The host app is still mounted and still has a context (so its
+     * `useAppilots()` calls don't throw), but nothing is wired: `client`
+     * rejects, `emit`/`subscribe` are inert, and `AppilotsChat` renders
+     * nothing. Consumers that show their own assistant affordance should
+     * branch on this.
+     */
+    degraded?: boolean;
 }
-declare function AppilotsProvider({ config: configProp, children, client: externalClient }: AppilotsProviderProps): React__default.JSX.Element;
+/**
+ * Public entry point. Its only job is to keep an exception thrown by
+ * anything Appilots renders from unmounting the host app's tree.
+ *
+ * The fallback deliberately re-renders `children` under a degraded
+ * context instead of a "something went wrong" screen: the children ARE
+ * the customer's app, and replacing them would be the same outage the
+ * boundary is here to prevent, just with nicer wording.
+ */
+declare function AppilotsProvider({ config, children, client }: AppilotsProviderProps): React__default.JSX.Element;
 declare function useAppilotsContext(): AppilotsContextValue;
 
 /**
@@ -1594,4 +1646,4 @@ interface UseSuggestedPromptsReturn {
  */
 declare function useSuggestedPrompts(options: UseSuggestedPromptsOptions): UseSuggestedPromptsReturn;
 
-export { componentRegistry as $, type AppilotsThemeTokens as A, type BreadcrumbItem as B, type ComponentRegistry as C, type RemotePersonalization as D, type EscalationState as E, type FieldEntry as F, SDK_VERSION as G, type SliderEntry as H, type InteractionElementSnapshot as I, type SuggestedPrompt as J, type ToggleEntry as K, type ListItemSnapshot as L, type MessageRole as M, type NavigationPayload as N, type ToggleSnapshot as O, type PartialThemeTokens as P, type UseAppilotsFieldOptions as Q, RateLimitedError as R, type ScreenSnapshot as S, type TargetEntry as T, type UIInteractionPayload as U, type UseAppilotsSliderOptions as V, type UseAppilotsTargetOptions as W, type UseAppilotsToggleOptions as X, type UseSuggestedPromptsOptions as Y, type UseSuggestedPromptsReturn as Z, clearAppilotsDebugTraces as _, type AppilotsLocale as a, createComponentRegistry as a0, defaultDarkTheme as a1, defaultLightTheme as a2, describeAction as a3, getAppilotsDebugTraces as a4, humanizeError as a5, mergeThemeTokens as a6, recordAppilotsDebugTrace as a7, subscribeAppilotsDebugTraces as a8, useAppilots as a9, useAppilotsActions as aa, useAppilotsChat as ab, useAppilotsContext as ac, useAppilotsField as ad, useAppilotsNavigation as ae, useAppilotsSlider as af, useAppilotsTarget as ag, useAppilotsToggle as ah, useSuggestedPrompts as ai, type AgentAction as b, type AgentPermissions as c, type AppilotsEvent as d, type AgentActionType as e, type AgentMessage as f, AppilotsClient as g, type AppilotsClientOptions as h, type AppilotsConfig as i, type AppilotsEventHandler as j, type AppilotsEventType as k, AppilotsProvider as l, type AppilotsProviderProps as m, type AppilotsTraceEntry as n, type AppilotsUser as o, type BreadcrumbState as p, type ButtonSnapshot as q, type ChatMessage as r, type ChoiceGroupSnapshot as s, type ChoiceOptionSnapshot as t, type ComponentEntry as u, type ComponentKind as v, type FormFillPayload as w, type InputSnapshot as x, type InteractionElementListContext as y, type ListSnapshot as z };
+export { createComponentRegistry as $, type AppilotsThemeTokens as A, type BreadcrumbItem as B, type ComponentRegistry as C, type RemotePersonalization as D, type EscalationState as E, type FieldEntry as F, type SliderEntry as G, type SuggestedPrompt as H, type InteractionElementSnapshot as I, type ToggleEntry as J, type ToggleSnapshot as K, type ListItemSnapshot as L, type MessageRole as M, type NavigationPayload as N, type UseAppilotsFieldOptions as O, type PartialThemeTokens as P, type UseAppilotsSliderOptions as Q, RateLimitedError as R, type ScreenSnapshot as S, type TargetEntry as T, type UIInteractionPayload as U, type UseAppilotsTargetOptions as V, type UseAppilotsToggleOptions as W, type UseSuggestedPromptsOptions as X, type UseSuggestedPromptsReturn as Y, clearAppilotsDebugTraces as Z, componentRegistry as _, type AppilotsLocale as a, defaultDarkTheme as a0, defaultLightTheme as a1, describeAction as a2, getAppilotsDebugTraces as a3, humanizeError as a4, mergeThemeTokens as a5, recordAppilotsDebugTrace as a6, subscribeAppilotsDebugTraces as a7, useAppilots as a8, useAppilotsActions as a9, useAppilotsChat as aa, useAppilotsContext as ab, useAppilotsField as ac, useAppilotsNavigation as ad, useAppilotsSlider as ae, useAppilotsTarget as af, useAppilotsToggle as ag, useSuggestedPrompts as ah, type AgentAction as b, type AgentPermissions as c, type AppilotsEvent as d, type AgentActionType as e, type AgentMessage as f, AppilotsClient as g, type AppilotsClientOptions as h, type AppilotsConfig as i, type AppilotsEventHandler as j, type AppilotsEventType as k, AppilotsProvider as l, type AppilotsProviderProps as m, type AppilotsTraceEntry as n, type AppilotsUser as o, type BreadcrumbState as p, type ButtonSnapshot as q, type ChatMessage as r, type ChoiceGroupSnapshot as s, type ChoiceOptionSnapshot as t, type ComponentEntry as u, type ComponentKind as v, type FormFillPayload as w, type InputSnapshot as x, type InteractionElementListContext as y, type ListSnapshot as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { P as PartialThemeTokens, A as AppilotsThemeTokens, a as AppilotsLocale, b as AgentAction, I as InteractionElementSnapshot, C as ComponentRegistry, c as AgentPermissions, S as ScreenSnapshot, F as FieldEntry, d as AppilotsEvent } from './index-nI-s3Exg.mjs';
-export { e as AgentActionType, f as AgentMessage, g as AppilotsClient, h as AppilotsClientOptions, i as AppilotsConfig, j as AppilotsEventHandler, k as AppilotsEventType, l as AppilotsProvider, m as AppilotsProviderProps, n as AppilotsTraceEntry, o as AppilotsUser, B as BreadcrumbItem, p as BreadcrumbState, q as ButtonSnapshot, r as ChatMessage, s as ChoiceGroupSnapshot, t as ChoiceOptionSnapshot, u as ComponentEntry, v as ComponentKind, E as EscalationState, w as FormFillPayload, x as InputSnapshot, y as InteractionElementListContext, L as ListItemSnapshot, z as ListSnapshot, M as MessageRole, N as NavigationPayload, R as RateLimitedError, D as RemotePersonalization, G as SDK_VERSION, H as SliderEntry, J as SuggestedPrompt, T as TargetEntry, K as ToggleEntry, O as ToggleSnapshot, U as UIInteractionPayload, Q as UseAppilotsFieldOptions, V as UseAppilotsSliderOptions, W as UseAppilotsTargetOptions, X as UseAppilotsToggleOptions, Y as UseSuggestedPromptsOptions, Z as UseSuggestedPromptsReturn, _ as clearAppilotsDebugTraces, $ as componentRegistry, a0 as createComponentRegistry, a1 as defaultDarkTheme, a2 as defaultLightTheme, a3 as describeAction, a4 as getAppilotsDebugTraces, a5 as humanizeError, a6 as mergeThemeTokens, a7 as recordAppilotsDebugTrace, a8 as subscribeAppilotsDebugTraces, a9 as useAppilots, aa as useAppilotsActions, ab as useAppilotsChat, ac as useAppilotsContext, ad as useAppilotsField, ae as useAppilotsNavigation, af as useAppilotsSlider, ag as useAppilotsTarget, ah as useAppilotsToggle, ai as useSuggestedPrompts } from './index-nI-s3Exg.mjs';
+import { P as PartialThemeTokens, A as AppilotsThemeTokens, a as AppilotsLocale, b as AgentAction, I as InteractionElementSnapshot, C as ComponentRegistry, c as AgentPermissions, S as ScreenSnapshot, F as FieldEntry, d as AppilotsEvent } from './index-BdYY-dvG.mjs';
+export { e as AgentActionType, f as AgentMessage, g as AppilotsClient, h as AppilotsClientOptions, i as AppilotsConfig, j as AppilotsEventHandler, k as AppilotsEventType, l as AppilotsProvider, m as AppilotsProviderProps, n as AppilotsTraceEntry, o as AppilotsUser, B as BreadcrumbItem, p as BreadcrumbState, q as ButtonSnapshot, r as ChatMessage, s as ChoiceGroupSnapshot, t as ChoiceOptionSnapshot, u as ComponentEntry, v as ComponentKind, E as EscalationState, w as FormFillPayload, x as InputSnapshot, y as InteractionElementListContext, L as ListItemSnapshot, z as ListSnapshot, M as MessageRole, N as NavigationPayload, R as RateLimitedError, D as RemotePersonalization, G as SliderEntry, H as SuggestedPrompt, T as TargetEntry, J as ToggleEntry, K as ToggleSnapshot, U as UIInteractionPayload, O as UseAppilotsFieldOptions, Q as UseAppilotsSliderOptions, V as UseAppilotsTargetOptions, W as UseAppilotsToggleOptions, X as UseSuggestedPromptsOptions, Y as UseSuggestedPromptsReturn, Z as clearAppilotsDebugTraces, _ as componentRegistry, $ as createComponentRegistry, a0 as defaultDarkTheme, a1 as defaultLightTheme, a2 as describeAction, a3 as getAppilotsDebugTraces, a4 as humanizeError, a5 as mergeThemeTokens, a6 as recordAppilotsDebugTrace, a7 as subscribeAppilotsDebugTraces, a8 as useAppilots, a9 as useAppilotsActions, aa as useAppilotsChat, ab as useAppilotsContext, ac as useAppilotsField, ad as useAppilotsNavigation, ae as useAppilotsSlider, af as useAppilotsTarget, ag as useAppilotsToggle, ah as useSuggestedPrompts } from './index-BdYY-dvG.mjs';
 import * as React$1 from 'react';
 import React__default from 'react';
 export { A as AppilotsNavigationContainer, N as NavigationConfig, b as ScreenMetadata, r as registerScreen } from './registerScreen-D1oGm28T.mjs';
@@ -276,12 +276,15 @@ interface LegacyThemeShape {
     fontFamily?: string;
 }
 /**
- * Outer wrapper — sets up Theme + i18n providers so the inner component
- * (and the ConfirmDialog) all read from the same resolved tokens. This
- * lets a developer mount AppilotsChat without also wrapping their app
- * in a `<AppilotsThemeProvider>` manually.
+ * Public entry point.
+ *
+ * The chat is a leaf in the host app's tree, so its failure barrier is
+ * the simple case: nothing of the customer's app is inside it, and the
+ * degraded state can just be "no assistant". Rendering an error card
+ * inside somebody else's product would be worse than rendering nothing
+ * — they did not ask us to put a broken box on their screen.
  */
-declare function AppilotsChat(props: AppilotsChatProps): React__default.JSX.Element;
+declare function AppilotsChat(props: AppilotsChatProps): React__default.JSX.Element | null;
 /**
  * Re-exports kept for backwards compatibility — the legacy
  * `AppilotsChatTheme` type used to live on this module. Prefer
@@ -703,9 +706,12 @@ declare function captureSnapshot(): ScreenSnapshot;
  * AppilotsFiberRoot. The fiber reference is set during the first render
  * and is used by captureSnapshot() to walk the React tree on demand.
  *
- * Fiber nodes are mutable: React updates their .child/.sibling pointers
- * as the tree re-renders. Storing a reference once is sufficient — we
- * always see the latest tree when we walk.
+ * Fiber nodes are mutable, but the ROOT is not a single node: React
+ * double-buffers the tree, keeping two HostRoot fibers and swapping
+ * which one is live at every commit. Holding one of them — which is what
+ * the sentinel captures — means every other commit walks the previous
+ * render's tree. `getFiberRoot()` resolves through the container to the
+ * currently committed root instead; see `resolveCurrentRoot`.
  */
 /**
  * Why capture failed, when it did.
@@ -716,8 +722,11 @@ declare function captureSnapshot(): ScreenSnapshot;
  *   other way — the app renders fine and only introspection is blind.
  * - `never-mounted`: something asked for a snapshot before
  *   `<AppilotsProvider>` committed (or outside it entirely).
+ * - `render-crashed`: the SDK's own render surface threw and the error
+ *   boundary degraded it. Unlike the other two this is OUR bug, not a
+ *   host-app integration problem — see `recordRenderFailure`.
  */
-type IntrospectionFailureReason = 'sentinel-missing-internals' | 'never-mounted';
+type IntrospectionFailureReason = 'sentinel-missing-internals' | 'never-mounted' | 'render-crashed';
 interface IntrospectionDiagnostics {
     /** True once a root fiber has been captured. */
     captured: boolean;
@@ -958,4 +967,13 @@ interface ExecutorContext {
 }
 declare function executeAction(action: AgentAction, context: ExecutorContext): Promise<ActionResult>;
 
-export { ActionBreadcrumb, type ActionBreadcrumbProps, type ActionResult, AgentAction, AgentPermissions, type AppilotsButtonProps, AppilotsChat, type AppilotsChatMode, type AppilotsChatPosition, type AppilotsChatProps, type AppilotsChatTheme, AppilotsEvent, AppilotsI18nProvider, type AppilotsI18nProviderProps, type AppilotsInputProps, AppilotsLocale, type AppilotsRC, AppilotsRegistryProvider, type AppilotsStringKey, type AppilotsStrings, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, AppilotsThemeTokens, ChatIcon, type ChatIconProps, ComponentRegistry, ConfirmDialog, type ConfirmDialogProps, type ElementRegistry, type ExecutorContext, FieldEntry, HeadsetIcon, type HeadsetIconProps, type InteractionElementEntry, InteractionElementSnapshot, type IntrospectionDiagnostics, type IntrospectionFailureReason, type ListEntry, type ListRegistry, PartialThemeTokens, ScreenSnapshot, type TailwindResolvedConfig, _patchJsxRuntimes, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, detectDeviceLocale, elementRegistry, enableAppilotsAutoTracking, executeAction, getGlobalConfig, getIntrospectionDiagnostics, initAppilots, isAutoTrackingEnabled, listRegistry, resolveLocale, useAppilotsI18n, useAppilotsTheme, useResolvedRegistry };
+/**
+ * GENERATED by scripts/release/sync-sdk-versions.mjs — do not edit.
+ *
+ * The version `@appilots/sdk` reports on the wire
+ * (`X-Appilots-Sdk-Version`). Kept identical to package.json by the
+ * release flow; `version.test.ts` fails if the two ever disagree.
+ */
+declare const SDK_VERSION = "0.8.0";
+
+export { ActionBreadcrumb, type ActionBreadcrumbProps, type ActionResult, AgentAction, AgentPermissions, type AppilotsButtonProps, AppilotsChat, type AppilotsChatMode, type AppilotsChatPosition, type AppilotsChatProps, type AppilotsChatTheme, AppilotsEvent, AppilotsI18nProvider, type AppilotsI18nProviderProps, type AppilotsInputProps, AppilotsLocale, type AppilotsRC, AppilotsRegistryProvider, type AppilotsStringKey, type AppilotsStrings, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, AppilotsThemeTokens, ChatIcon, type ChatIconProps, ComponentRegistry, ConfirmDialog, type ConfirmDialogProps, type ElementRegistry, type ExecutorContext, FieldEntry, HeadsetIcon, type HeadsetIconProps, type InteractionElementEntry, InteractionElementSnapshot, type IntrospectionDiagnostics, type IntrospectionFailureReason, type ListEntry, type ListRegistry, PartialThemeTokens, SDK_VERSION, ScreenSnapshot, type TailwindResolvedConfig, _patchJsxRuntimes, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, detectDeviceLocale, elementRegistry, enableAppilotsAutoTracking, executeAction, getGlobalConfig, getIntrospectionDiagnostics, initAppilots, isAutoTrackingEnabled, listRegistry, resolveLocale, useAppilotsI18n, useAppilotsTheme, useResolvedRegistry };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PartialThemeTokens, A as AppilotsThemeTokens, a as AppilotsLocale, b as AgentAction, I as InteractionElementSnapshot, C as ComponentRegistry, c as AgentPermissions, S as ScreenSnapshot, F as FieldEntry, d as AppilotsEvent } from './index-nI-s3Exg.js';
-export { e as AgentActionType, f as AgentMessage, g as AppilotsClient, h as AppilotsClientOptions, i as AppilotsConfig, j as AppilotsEventHandler, k as AppilotsEventType, l as AppilotsProvider, m as AppilotsProviderProps, n as AppilotsTraceEntry, o as AppilotsUser, B as BreadcrumbItem, p as BreadcrumbState, q as ButtonSnapshot, r as ChatMessage, s as ChoiceGroupSnapshot, t as ChoiceOptionSnapshot, u as ComponentEntry, v as ComponentKind, E as EscalationState, w as FormFillPayload, x as InputSnapshot, y as InteractionElementListContext, L as ListItemSnapshot, z as ListSnapshot, M as MessageRole, N as NavigationPayload, R as RateLimitedError, D as RemotePersonalization, G as SDK_VERSION, H as SliderEntry, J as SuggestedPrompt, T as TargetEntry, K as ToggleEntry, O as ToggleSnapshot, U as UIInteractionPayload, Q as UseAppilotsFieldOptions, V as UseAppilotsSliderOptions, W as UseAppilotsTargetOptions, X as UseAppilotsToggleOptions, Y as UseSuggestedPromptsOptions, Z as UseSuggestedPromptsReturn, _ as clearAppilotsDebugTraces, $ as componentRegistry, a0 as createComponentRegistry, a1 as defaultDarkTheme, a2 as defaultLightTheme, a3 as describeAction, a4 as getAppilotsDebugTraces, a5 as humanizeError, a6 as mergeThemeTokens, a7 as recordAppilotsDebugTrace, a8 as subscribeAppilotsDebugTraces, a9 as useAppilots, aa as useAppilotsActions, ab as useAppilotsChat, ac as useAppilotsContext, ad as useAppilotsField, ae as useAppilotsNavigation, af as useAppilotsSlider, ag as useAppilotsTarget, ah as useAppilotsToggle, ai as useSuggestedPrompts } from './index-nI-s3Exg.js';
+import { P as PartialThemeTokens, A as AppilotsThemeTokens, a as AppilotsLocale, b as AgentAction, I as InteractionElementSnapshot, C as ComponentRegistry, c as AgentPermissions, S as ScreenSnapshot, F as FieldEntry, d as AppilotsEvent } from './index-BdYY-dvG.js';
+export { e as AgentActionType, f as AgentMessage, g as AppilotsClient, h as AppilotsClientOptions, i as AppilotsConfig, j as AppilotsEventHandler, k as AppilotsEventType, l as AppilotsProvider, m as AppilotsProviderProps, n as AppilotsTraceEntry, o as AppilotsUser, B as BreadcrumbItem, p as BreadcrumbState, q as ButtonSnapshot, r as ChatMessage, s as ChoiceGroupSnapshot, t as ChoiceOptionSnapshot, u as ComponentEntry, v as ComponentKind, E as EscalationState, w as FormFillPayload, x as InputSnapshot, y as InteractionElementListContext, L as ListItemSnapshot, z as ListSnapshot, M as MessageRole, N as NavigationPayload, R as RateLimitedError, D as RemotePersonalization, G as SliderEntry, H as SuggestedPrompt, T as TargetEntry, J as ToggleEntry, K as ToggleSnapshot, U as UIInteractionPayload, O as UseAppilotsFieldOptions, Q as UseAppilotsSliderOptions, V as UseAppilotsTargetOptions, W as UseAppilotsToggleOptions, X as UseSuggestedPromptsOptions, Y as UseSuggestedPromptsReturn, Z as clearAppilotsDebugTraces, _ as componentRegistry, $ as createComponentRegistry, a0 as defaultDarkTheme, a1 as defaultLightTheme, a2 as describeAction, a3 as getAppilotsDebugTraces, a4 as humanizeError, a5 as mergeThemeTokens, a6 as recordAppilotsDebugTrace, a7 as subscribeAppilotsDebugTraces, a8 as useAppilots, a9 as useAppilotsActions, aa as useAppilotsChat, ab as useAppilotsContext, ac as useAppilotsField, ad as useAppilotsNavigation, ae as useAppilotsSlider, af as useAppilotsTarget, ag as useAppilotsToggle, ah as useSuggestedPrompts } from './index-BdYY-dvG.js';
 import * as React$1 from 'react';
 import React__default from 'react';
 export { A as AppilotsNavigationContainer, N as NavigationConfig, b as ScreenMetadata, r as registerScreen } from './registerScreen-D1oGm28T.js';
@@ -276,12 +276,15 @@ interface LegacyThemeShape {
     fontFamily?: string;
 }
 /**
- * Outer wrapper — sets up Theme + i18n providers so the inner component
- * (and the ConfirmDialog) all read from the same resolved tokens. This
- * lets a developer mount AppilotsChat without also wrapping their app
- * in a `<AppilotsThemeProvider>` manually.
+ * Public entry point.
+ *
+ * The chat is a leaf in the host app's tree, so its failure barrier is
+ * the simple case: nothing of the customer's app is inside it, and the
+ * degraded state can just be "no assistant". Rendering an error card
+ * inside somebody else's product would be worse than rendering nothing
+ * — they did not ask us to put a broken box on their screen.
  */
-declare function AppilotsChat(props: AppilotsChatProps): React__default.JSX.Element;
+declare function AppilotsChat(props: AppilotsChatProps): React__default.JSX.Element | null;
 /**
  * Re-exports kept for backwards compatibility — the legacy
  * `AppilotsChatTheme` type used to live on this module. Prefer
@@ -703,9 +706,12 @@ declare function captureSnapshot(): ScreenSnapshot;
  * AppilotsFiberRoot. The fiber reference is set during the first render
  * and is used by captureSnapshot() to walk the React tree on demand.
  *
- * Fiber nodes are mutable: React updates their .child/.sibling pointers
- * as the tree re-renders. Storing a reference once is sufficient — we
- * always see the latest tree when we walk.
+ * Fiber nodes are mutable, but the ROOT is not a single node: React
+ * double-buffers the tree, keeping two HostRoot fibers and swapping
+ * which one is live at every commit. Holding one of them — which is what
+ * the sentinel captures — means every other commit walks the previous
+ * render's tree. `getFiberRoot()` resolves through the container to the
+ * currently committed root instead; see `resolveCurrentRoot`.
  */
 /**
  * Why capture failed, when it did.
@@ -716,8 +722,11 @@ declare function captureSnapshot(): ScreenSnapshot;
  *   other way — the app renders fine and only introspection is blind.
  * - `never-mounted`: something asked for a snapshot before
  *   `<AppilotsProvider>` committed (or outside it entirely).
+ * - `render-crashed`: the SDK's own render surface threw and the error
+ *   boundary degraded it. Unlike the other two this is OUR bug, not a
+ *   host-app integration problem — see `recordRenderFailure`.
  */
-type IntrospectionFailureReason = 'sentinel-missing-internals' | 'never-mounted';
+type IntrospectionFailureReason = 'sentinel-missing-internals' | 'never-mounted' | 'render-crashed';
 interface IntrospectionDiagnostics {
     /** True once a root fiber has been captured. */
     captured: boolean;
@@ -958,4 +967,13 @@ interface ExecutorContext {
 }
 declare function executeAction(action: AgentAction, context: ExecutorContext): Promise<ActionResult>;
 
-export { ActionBreadcrumb, type ActionBreadcrumbProps, type ActionResult, AgentAction, AgentPermissions, type AppilotsButtonProps, AppilotsChat, type AppilotsChatMode, type AppilotsChatPosition, type AppilotsChatProps, type AppilotsChatTheme, AppilotsEvent, AppilotsI18nProvider, type AppilotsI18nProviderProps, type AppilotsInputProps, AppilotsLocale, type AppilotsRC, AppilotsRegistryProvider, type AppilotsStringKey, type AppilotsStrings, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, AppilotsThemeTokens, ChatIcon, type ChatIconProps, ComponentRegistry, ConfirmDialog, type ConfirmDialogProps, type ElementRegistry, type ExecutorContext, FieldEntry, HeadsetIcon, type HeadsetIconProps, type InteractionElementEntry, InteractionElementSnapshot, type IntrospectionDiagnostics, type IntrospectionFailureReason, type ListEntry, type ListRegistry, PartialThemeTokens, ScreenSnapshot, type TailwindResolvedConfig, _patchJsxRuntimes, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, detectDeviceLocale, elementRegistry, enableAppilotsAutoTracking, executeAction, getGlobalConfig, getIntrospectionDiagnostics, initAppilots, isAutoTrackingEnabled, listRegistry, resolveLocale, useAppilotsI18n, useAppilotsTheme, useResolvedRegistry };
+/**
+ * GENERATED by scripts/release/sync-sdk-versions.mjs — do not edit.
+ *
+ * The version `@appilots/sdk` reports on the wire
+ * (`X-Appilots-Sdk-Version`). Kept identical to package.json by the
+ * release flow; `version.test.ts` fails if the two ever disagree.
+ */
+declare const SDK_VERSION = "0.8.0";
+
+export { ActionBreadcrumb, type ActionBreadcrumbProps, type ActionResult, AgentAction, AgentPermissions, type AppilotsButtonProps, AppilotsChat, type AppilotsChatMode, type AppilotsChatPosition, type AppilotsChatProps, type AppilotsChatTheme, AppilotsEvent, AppilotsI18nProvider, type AppilotsI18nProviderProps, type AppilotsInputProps, AppilotsLocale, type AppilotsRC, AppilotsRegistryProvider, type AppilotsStringKey, type AppilotsStrings, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, AppilotsThemeTokens, ChatIcon, type ChatIconProps, ComponentRegistry, ConfirmDialog, type ConfirmDialogProps, type ElementRegistry, type ExecutorContext, FieldEntry, HeadsetIcon, type HeadsetIconProps, type InteractionElementEntry, InteractionElementSnapshot, type IntrospectionDiagnostics, type IntrospectionFailureReason, type ListEntry, type ListRegistry, PartialThemeTokens, SDK_VERSION, ScreenSnapshot, type TailwindResolvedConfig, _patchJsxRuntimes, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, detectDeviceLocale, elementRegistry, enableAppilotsAutoTracking, executeAction, getGlobalConfig, getIntrospectionDiagnostics, initAppilots, isAutoTrackingEnabled, listRegistry, resolveLocale, useAppilotsI18n, useAppilotsTheme, useResolvedRegistry };