@appilots/sdk 0.4.0 → 0.5.0

package/dist/hooks/index.d.mts

@@ -1,2 +1,2 @@
-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-Cb0D6uKH.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-GvF_FlwO.mjs';
 import 'react';

package/dist/hooks/index.d.ts

@@ -1,2 +1,2 @@
-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-Cb0D6uKH.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-GvF_FlwO.js';
 import 'react';

package/dist/hooks/index.js

@@ -1,43 +1,43 @@
 'use strict';
 
-var chunkY7EA6R2G_js = require('../chunk-Y7EA6R2G.js');
-require('../chunk-V3TUIIT2.js');
+var chunkZWQUIDBZ_js = require('../chunk-ZWQUIDBZ.js');
+require('../chunk-PQHZTAFG.js');
 
 
 
 Object.defineProperty(exports, "useAppilots", {
   enumerable: true,
-  get: function () { return chunkY7EA6R2G_js.useAppilots; }
+  get: function () { return chunkZWQUIDBZ_js.useAppilots; }
 });
 Object.defineProperty(exports, "useAppilotsActions", {
   enumerable: true,
-  get: function () { return chunkY7EA6R2G_js.useAppilotsActions; }
+  get: function () { return chunkZWQUIDBZ_js.useAppilotsActions; }
 });
 Object.defineProperty(exports, "useAppilotsChat", {
   enumerable: true,
-  get: function () { return chunkY7EA6R2G_js.useAppilotsChat; }
+  get: function () { return chunkZWQUIDBZ_js.useAppilotsChat; }
 });
 Object.defineProperty(exports, "useAppilotsField", {
   enumerable: true,
-  get: function () { return chunkY7EA6R2G_js.useAppilotsField; }
+  get: function () { return chunkZWQUIDBZ_js.useAppilotsField; }
 });
 Object.defineProperty(exports, "useAppilotsNavigation", {
   enumerable: true,
-  get: function () { return chunkY7EA6R2G_js.useAppilotsNavigation; }
+  get: function () { return chunkZWQUIDBZ_js.useAppilotsNavigation; }
 });
 Object.defineProperty(exports, "useAppilotsSlider", {
   enumerable: true,
-  get: function () { return chunkY7EA6R2G_js.useAppilotsSlider; }
+  get: function () { return chunkZWQUIDBZ_js.useAppilotsSlider; }
 });
 Object.defineProperty(exports, "useAppilotsTarget", {
   enumerable: true,
-  get: function () { return chunkY7EA6R2G_js.useAppilotsTarget; }
+  get: function () { return chunkZWQUIDBZ_js.useAppilotsTarget; }
 });
 Object.defineProperty(exports, "useAppilotsToggle", {
   enumerable: true,
-  get: function () { return chunkY7EA6R2G_js.useAppilotsToggle; }
+  get: function () { return chunkZWQUIDBZ_js.useAppilotsToggle; }
 });
 Object.defineProperty(exports, "useSuggestedPrompts", {
   enumerable: true,
-  get: function () { return chunkY7EA6R2G_js.useSuggestedPrompts; }
+  get: function () { return chunkZWQUIDBZ_js.useSuggestedPrompts; }
 });

package/dist/hooks/index.mjs

@@ -1,2 +1,2 @@
-export { useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts } from '../chunk-42WI3UDB.mjs';
-import '../chunk-JBOLV5AM.mjs';
+export { useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts } from '../chunk-3D7PHOV7.mjs';
+import '../chunk-BIEF6MNR.mjs';

package/dist/{index-Cb0D6uKH.d.mts → index-GvF_FlwO.d.mts}

@@ -281,7 +281,7 @@ interface AgentPermissions {
     blockedScreens?: string[];
     allowedActions?: AgentActionType[];
 }
-type AppilotsEventType = 'agent:action:start' | 'agent:action:complete' | 'agent:action:error' | 'agent:message' | 'navigation:change' | 'chat:open' | 'chat:close' | 'chat:escalation:start' | 'chat:escalation:message' | 'chat:escalation:end';
+type AppilotsEventType = 'agent:action:start' | 'agent:action:complete' | 'agent:action:error' | 'agent:message' | 'navigation:change' | 'chat:open' | 'chat:close' | 'chat:escalation:start' | 'chat:escalation:message' | 'chat:escalation:end' | 'sdk:introspection:unavailable';
 interface AppilotsEvent {
     type: AppilotsEventType;
     timestamp: number;
@@ -300,6 +300,17 @@ interface EscalationState {
     operatorName?: string;
 }
 
+/**
+ * Mirrors `introspectionDiagnosticsSchema` on the wire. Declared here
+ * rather than imported so client-core stays free of the server's
+ * validator package.
+ */
+interface IntrospectionDiagnosticsInput {
+    captured: boolean;
+    failureReason?: 'sentinel-missing-internals' | 'never-mounted' | null;
+    reactVersion?: string | null;
+    failureCount?: number;
+}
 interface AppilotsClientOptions {
     projectId: string;
     apiBaseUrl?: string;
@@ -318,6 +329,17 @@ interface AppilotsClientOptions {
      * from your app's package.json so it stays in lockstep with releases.
      */
     mcpVersion?: string;
+    /**
+     * Reports whether the platform binding could read the host app's UI
+     * tree. Called once per message; return `null` (or omit the option)
+     * when there is nothing to report.
+     *
+     * Only a FAILED reading is put on the wire. When introspection is
+     * dead every observation is empty but perfectly well-formed, so the
+     * server cannot tell a blind session from a user looking at empty
+     * screens — this is the only signal that distinguishes them.
+     */
+    introspectionReporter?: () => IntrospectionDiagnosticsInput | null | undefined;
     /**
      * The host app's version (e.g. from package.json or
      * react-native-device-info). Sent as `X-App-Version` on every request
@@ -417,6 +439,7 @@ declare class AppilotsClient {
     private readonly timeout;
     private readonly debug;
     private readonly mcpVersion;
+    private readonly introspectionReporter;
     private readonly user;
     private sessionId;
     /** Guard so identify fires at most once per client instance. */
@@ -434,6 +457,13 @@ declare class AppilotsClient {
     private identifyConfiguredUser;
     destroySession(): Promise<void>;
     getSessionId(): string | null;
+    /**
+     * Wire fragment for introspection health. Empty on the happy path —
+     * a working client sends nothing, so the field costs a byte only
+     * when something is actually wrong. Never throws: a broken reporter
+     * must not take the message down with it.
+     */
+    private introspectionFragment;
     sendMessage(content: string, context?: SendMessageContext): Promise<SendMessageResponse>;
     /**
      * Streaming variant of `sendMessage` — consumes the server's SSE

package/dist/{index-Cb0D6uKH.d.ts → index-GvF_FlwO.d.ts}

@@ -281,7 +281,7 @@ interface AgentPermissions {
     blockedScreens?: string[];
     allowedActions?: AgentActionType[];
 }
-type AppilotsEventType = 'agent:action:start' | 'agent:action:complete' | 'agent:action:error' | 'agent:message' | 'navigation:change' | 'chat:open' | 'chat:close' | 'chat:escalation:start' | 'chat:escalation:message' | 'chat:escalation:end';
+type AppilotsEventType = 'agent:action:start' | 'agent:action:complete' | 'agent:action:error' | 'agent:message' | 'navigation:change' | 'chat:open' | 'chat:close' | 'chat:escalation:start' | 'chat:escalation:message' | 'chat:escalation:end' | 'sdk:introspection:unavailable';
 interface AppilotsEvent {
     type: AppilotsEventType;
     timestamp: number;
@@ -300,6 +300,17 @@ interface EscalationState {
     operatorName?: string;
 }
 
+/**
+ * Mirrors `introspectionDiagnosticsSchema` on the wire. Declared here
+ * rather than imported so client-core stays free of the server's
+ * validator package.
+ */
+interface IntrospectionDiagnosticsInput {
+    captured: boolean;
+    failureReason?: 'sentinel-missing-internals' | 'never-mounted' | null;
+    reactVersion?: string | null;
+    failureCount?: number;
+}
 interface AppilotsClientOptions {
     projectId: string;
     apiBaseUrl?: string;
@@ -318,6 +329,17 @@ interface AppilotsClientOptions {
      * from your app's package.json so it stays in lockstep with releases.
      */
     mcpVersion?: string;
+    /**
+     * Reports whether the platform binding could read the host app's UI
+     * tree. Called once per message; return `null` (or omit the option)
+     * when there is nothing to report.
+     *
+     * Only a FAILED reading is put on the wire. When introspection is
+     * dead every observation is empty but perfectly well-formed, so the
+     * server cannot tell a blind session from a user looking at empty
+     * screens — this is the only signal that distinguishes them.
+     */
+    introspectionReporter?: () => IntrospectionDiagnosticsInput | null | undefined;
     /**
      * The host app's version (e.g. from package.json or
      * react-native-device-info). Sent as `X-App-Version` on every request
@@ -417,6 +439,7 @@ declare class AppilotsClient {
     private readonly timeout;
     private readonly debug;
     private readonly mcpVersion;
+    private readonly introspectionReporter;
     private readonly user;
     private sessionId;
     /** Guard so identify fires at most once per client instance. */
@@ -434,6 +457,13 @@ declare class AppilotsClient {
     private identifyConfiguredUser;
     destroySession(): Promise<void>;
     getSessionId(): string | null;
+    /**
+     * Wire fragment for introspection health. Empty on the happy path —
+     * a working client sends nothing, so the field costs a byte only
+     * when something is actually wrong. Never throws: a broken reporter
+     * must not take the message down with it.
+     */
+    private introspectionFragment;
     sendMessage(content: string, context?: SendMessageContext): Promise<SendMessageResponse>;
     /**
      * Streaming variant of `sendMessage` — consumes the server's SSE

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-Cb0D6uKH.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 RemotePersonalization, D as SDK_VERSION, 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-Cb0D6uKH.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-GvF_FlwO.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 RemotePersonalization, D as SDK_VERSION, 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-GvF_FlwO.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';
@@ -698,6 +698,43 @@ declare function isAutoTrackingEnabled(): boolean;
 
 declare function captureSnapshot(): ScreenSnapshot;
 
+/**
+ * fiberRoot — module-level holder for the root fiber captured by
+ * 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.
+ */
+/**
+ * Why capture failed, when it did.
+ *
+ * - `sentinel-missing-internals`: the class sentinel mounted but its
+ *   instance had neither `_reactInternals` nor `_reactInternalFiber`.
+ *   This is the React-version incompatibility we cannot detect any
+ *   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).
+ */
+type IntrospectionFailureReason = 'sentinel-missing-internals' | 'never-mounted';
+interface IntrospectionDiagnostics {
+    /** True once a root fiber has been captured. */
+    captured: boolean;
+    /** Set on the first failure and kept, even if a later attempt succeeds. */
+    failureReason: IntrospectionFailureReason | null;
+    /** React version seen at failure time — the field we actually want in a bug report. */
+    reactVersion: string | null;
+    /** How many times a capture attempt has failed. */
+    failureCount: number;
+}
+/**
+ * Introspection health, for host apps that want to ship it to their own
+ * crash/analytics tooling. `captured: false` with a `failureReason`
+ * means every snapshot this session is empty.
+ */
+declare function getIntrospectionDiagnostics(): IntrospectionDiagnostics;
+
 /**
  * createAppilotsInput — HOC factory that wraps any TextInput-like component
  * and auto-registers it with the ComponentRegistry.
@@ -921,4 +958,4 @@ 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 ListEntry, type ListRegistry, PartialThemeTokens, ScreenSnapshot, type TailwindResolvedConfig, _patchJsxRuntimes, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, detectDeviceLocale, elementRegistry, enableAppilotsAutoTracking, executeAction, getGlobalConfig, initAppilots, isAutoTrackingEnabled, listRegistry, resolveLocale, useAppilotsI18n, useAppilotsTheme, useResolvedRegistry };
+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 };

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-Cb0D6uKH.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 RemotePersonalization, D as SDK_VERSION, 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-Cb0D6uKH.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-GvF_FlwO.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 RemotePersonalization, D as SDK_VERSION, 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-GvF_FlwO.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';
@@ -698,6 +698,43 @@ declare function isAutoTrackingEnabled(): boolean;
 
 declare function captureSnapshot(): ScreenSnapshot;
 
+/**
+ * fiberRoot — module-level holder for the root fiber captured by
+ * 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.
+ */
+/**
+ * Why capture failed, when it did.
+ *
+ * - `sentinel-missing-internals`: the class sentinel mounted but its
+ *   instance had neither `_reactInternals` nor `_reactInternalFiber`.
+ *   This is the React-version incompatibility we cannot detect any
+ *   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).
+ */
+type IntrospectionFailureReason = 'sentinel-missing-internals' | 'never-mounted';
+interface IntrospectionDiagnostics {
+    /** True once a root fiber has been captured. */
+    captured: boolean;
+    /** Set on the first failure and kept, even if a later attempt succeeds. */
+    failureReason: IntrospectionFailureReason | null;
+    /** React version seen at failure time — the field we actually want in a bug report. */
+    reactVersion: string | null;
+    /** How many times a capture attempt has failed. */
+    failureCount: number;
+}
+/**
+ * Introspection health, for host apps that want to ship it to their own
+ * crash/analytics tooling. `captured: false` with a `failureReason`
+ * means every snapshot this session is empty.
+ */
+declare function getIntrospectionDiagnostics(): IntrospectionDiagnostics;
+
 /**
  * createAppilotsInput — HOC factory that wraps any TextInput-like component
  * and auto-registers it with the ComponentRegistry.
@@ -921,4 +958,4 @@ 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 ListEntry, type ListRegistry, PartialThemeTokens, ScreenSnapshot, type TailwindResolvedConfig, _patchJsxRuntimes, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, detectDeviceLocale, elementRegistry, enableAppilotsAutoTracking, executeAction, getGlobalConfig, initAppilots, isAutoTrackingEnabled, listRegistry, resolveLocale, useAppilotsI18n, useAppilotsTheme, useResolvedRegistry };
+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 };