@appilots/sdk 0.3.0 → 0.4.1

package/dist/index.d.mts

@@ -1,9 +1,7 @@
-import { C as ComponentRegistry, F as FieldEntry } from './index-BYVRBzjJ.mjs';
-export { A as AppilotsConfig, a as AppilotsProvider, b as AppilotsProviderProps, c as ComponentEntry, d as ComponentKind, S as SliderEntry, e as SuggestedPrompt, T as TargetEntry, f as ToggleEntry, U as UseAppilotsFieldOptions, g as UseAppilotsSliderOptions, h as UseAppilotsTargetOptions, i as UseAppilotsToggleOptions, j as UseSuggestedPromptsOptions, k as UseSuggestedPromptsReturn, l as componentRegistry, m as createComponentRegistry, u as useAppilots, n as useAppilotsActions, o as useAppilotsChat, p as useAppilotsContext, q as useAppilotsField, r as useAppilotsNavigation, s as useAppilotsSlider, t as useAppilotsTarget, v as useAppilotsToggle, w as useSuggestedPrompts } from './index-BYVRBzjJ.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-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 * as React$1 from 'react';
 import React__default from 'react';
-import { PartialThemeTokens, AppilotsThemeTokens, AppilotsLocale, AgentAction, AgentPermissions, AppilotsEvent } from '@appilots/client-core';
-export { AgentAction, AgentActionType, AgentMessage, AgentPermissions, AppilotsClient, AppilotsClientOptions, AppilotsEvent, AppilotsEventHandler, AppilotsEventType, AppilotsLocale, AppilotsThemeTokens, AppilotsTraceEntry, AppilotsUser, BreadcrumbItem, BreadcrumbState, ChatMessage, EscalationState, FormFillPayload, MessageRole, NavigationPayload, PartialThemeTokens, RemotePersonalization, SDK_VERSION, UIInteractionPayload, clearAppilotsDebugTraces, defaultDarkTheme, defaultLightTheme, describeAction, getAppilotsDebugTraces, humanizeError, mergeThemeTokens, recordAppilotsDebugTrace, subscribeAppilotsDebugTraces } from '@appilots/client-core';
 export { A as AppilotsNavigationContainer, N as NavigationConfig, b as ScreenMetadata, r as registerScreen } from './registerScreen-D1oGm28T.mjs';
 
 interface AppilotsThemeProviderProps {
@@ -463,7 +461,7 @@ declare function HeadsetIcon({ size, color }: HeadsetIconProps): React$1.JSX.Ele
  * registers that metadata here so snapshots can describe collections
  * without relying only on structural guesses.
  */
-interface ListDataPreviewEntry$1 {
+interface ListDataPreviewEntry {
     /** 0-based index in the list's backing data. */
     index: number;
     /** Stable key from keyExtractor / item.id when available. */
@@ -500,7 +498,7 @@ interface ListEntry {
      * the auto-tracking wrapper from `props.data` so the agent can see
      * rows that virtualization keeps unmounted.
      */
-    dataPreview?: ListDataPreviewEntry$1[];
+    dataPreview?: ListDataPreviewEntry[];
     /** Scroll so the 0-based data index becomes visible. Returns false when unsupported. */
     scrollToIndex?: (index: number) => boolean;
     /** Scroll to an absolute pixel offset. Returns false when unsupported. */
@@ -525,281 +523,6 @@ declare class ListRegistryImpl {
 declare const listRegistry: ListRegistry;
 declare function createListRegistry(): ListRegistry;
 
-/**
- * Snapshot types — the shape of data captured from the React fiber tree.
- *
- * This is the runtime "view model" of what the user is currently seeing
- * on screen, sent to the AI agent so it has accurate visible state.
- */
-interface InputSnapshot {
-    /** Best identifier — testID, accessibilityLabel, or placeholder */
-    id?: string;
-    /** Human-readable label inferred from accessibilityLabel, label prop, or sibling Text */
-    label?: string;
-    /** Current value (only present for controlled inputs) */
-    value?: string;
-    /** Placeholder text */
-    placeholder?: string;
-    /** Whether the input is editable */
-    editable?: boolean;
-    /** Whether the input is secure (password field) */
-    secure?: boolean;
-    /** Inferred type based on keyboardType / secureTextEntry */
-    type?: 'text' | 'email' | 'number' | 'phone' | 'password';
-    /**
-     * True when this input lives inside a currently-visible Modal. When a
-     * modal is open, only inModal elements can actually receive touches —
-     * everything else is behind the overlay.
-     */
-    inModal?: boolean;
-}
-interface ButtonSnapshot {
-    /** Best identifier — testID, accessibilityLabel, or inferred from child text */
-    id?: string;
-    /** Human-readable label — usually the visible text inside the button */
-    label?: string;
-    /** Whether the button is disabled */
-    disabled?: boolean;
-    /**
-     * Whether the button currently appears selected/active — read from
-     * `accessibilityState.selected`. Set by grouped, mutually-exclusive
-     * controls (SegmentedControl, RadioGroup) where each option is its
-     * own pressable target; absent/false for ordinary buttons.
-     */
-    selected?: boolean;
-    /** True when this button lives inside a currently-visible Modal. */
-    inModal?: boolean;
-}
-interface ToggleSnapshot {
-    /** Best identifier — testID or accessibilityLabel */
-    id?: string;
-    /** Human-readable label */
-    label?: string;
-    /** Current on/off state */
-    value?: boolean;
-    /** True when this toggle lives inside a currently-visible Modal. */
-    inModal?: boolean;
-}
-interface SliderSnapshot {
-    /** Registry id (the id apps pass to useAppilotsSlider) — the executable handle. */
-    id?: string;
-    /** Human-readable label */
-    label?: string;
-    /** Current numeric value */
-    value?: number;
-    /** Lower bound the executor clamps to */
-    min?: number;
-    /** Upper bound the executor clamps to */
-    max?: number;
-    /** Step the executor snaps to (omitted = continuous) */
-    step?: number;
-    /** Whether the slider is currently disabled */
-    disabled?: boolean;
-    /** True when this slider lives inside a currently-visible Modal. */
-    inModal?: boolean;
-}
-interface ListItemSnapshot {
-    /** 1-indexed position within the parent list (matches "selecione o terceiro"). */
-    index: number;
-    /**
-     * 0-based index of this row in the list's backing DATA, when the
-     * auto-tracking wrapper stamped it (`__appilotsItemIndex`). For
-     * scrolled/virtualized lists this differs from `index`: the first
-     * MOUNTED row might be data item 42. Lets the prompt show absolute
-     * positions ("#43 of 100") so ordinal references stay correct.
-     */
-    dataIndex?: number;
-    /**
-     * React key of the cell, if present (typically the item's domain id
-     * from keyExtractor). Useful for the LLM when the user references an
-     * item by name and we want to surface a deterministic handle for
-     * future tap-by-ordinal resolution (Phase B).
-     */
-    reactKey?: string;
-    /** Runtime key supplied by auto-tracked list renderItem, if available. */
-    itemKey?: string;
-    /**
-     * Texts captured from this item's subtree (vehicle name, plate,
-     * tags, etc.). Per-item to preserve row association — the flat
-     * `snapshot.texts` lost it.
-     */
-    texts: string[];
-    /** Buttons inside this item — e.g. an inline "Edit" button on a row. */
-    buttons: ButtonSnapshot[];
-    /** Inputs inside this item — rare but possible (inline edit row). */
-    inputs: InputSnapshot[];
-    /** Toggles inside this item. */
-    toggles: ToggleSnapshot[];
-    /**
-     * Synthetic id assigned by the walker. Stable within a single
-     * snapshot; format `list-<L>-item-<I>` (0-indexed L, 1-indexed I).
-     * Used by Phase B's tap-by-ordinal resolution in uiInteractionHandler.
-     */
-    syntheticId: string;
-}
-interface ListSnapshot {
-    /** 0-indexed list ordinal — multiple lists on one screen get 0, 1, 2... */
-    index: number;
-    /** Runtime list id when auto-tracking or explicit props provide one. */
-    id?: string;
-    /**
-     * The container component name as observed in the fiber tree.
-     * Common values: 'FlatList', 'SectionList', 'VirtualizedList',
-     * 'FlashList', 'ScrollView' (when detected by N≥2 keyed children).
-     */
-    containerType: string;
-    /** Source that identified this list. */
-    source?: 'fiber' | 'auto-tracked' | 'registry';
-    /** Total data-set count when the list component exposes it. */
-    itemCount?: number;
-    /** Number of row items captured in this snapshot. */
-    visibleItemCount?: number;
-    /** True when the list reports a refresh/loading state. */
-    refreshing?: boolean;
-    /** True when total item count is known and zero. */
-    empty?: boolean;
-    /** Human-readable label if the app supplied one. */
-    label?: string;
-    /**
-     * Items in visible order. Real list components may expose one mounted
-     * item when virtualization or an overlay limits the visible window;
-     * heuristic ScrollView lists still require at least two list-like items.
-     */
-    items: ListItemSnapshot[];
-    /**
-     * Lightweight text projection of the list's FULL data set (capped),
-     * captured by the auto-tracking wrapper from `props.data`. Lets the
-     * agent see/search rows that virtualization keeps unmounted. Each
-     * entry: 0-based data index, stable key (keyExtractor), short text.
-     */
-    dataPreview?: ListDataPreviewEntry[];
-    /** Current vertical scroll offset in px, when the SDK could read it. */
-    scrollOffsetY?: number;
-    /** True when there is scrollable content above the viewport. */
-    canScrollUp?: boolean;
-    /** True when there is scrollable content below the viewport. */
-    canScrollDown?: boolean;
-}
-interface ListDataPreviewEntry {
-    /** 0-based index in the list's backing data. */
-    index: number;
-    /** Stable key from keyExtractor / item.id when available. */
-    key?: string;
-    /** Short human-readable projection of the item (capped length). */
-    text: string;
-}
-interface ChoiceOptionSnapshot {
-    /** 1-indexed option position within this group. */
-    index: number;
-    /** Stable-enough id for the current snapshot/action turn. */
-    syntheticId: string;
-    /** Best target id if this option is backed by a pressable component. */
-    targetId?: string;
-    /** Human-readable option label. */
-    label?: string;
-    /** Text segments that belong to this option. */
-    texts: string[];
-    /** Whether this option appears selected. */
-    selected?: boolean;
-    /** Whether this option appears disabled. */
-    disabled?: boolean;
-}
-interface ChoiceGroupSnapshot {
-    /** 0-indexed group ordinal on the current screen. */
-    index: number;
-    /** Runtime id when known, usually inherited from a list/collection. */
-    id?: string;
-    /** Human-readable label when known. */
-    label?: string;
-    /** Source that produced this choice group. */
-    source?: 'list' | 'buttons' | 'heuristic';
-    /** Visible options in order. */
-    options: ChoiceOptionSnapshot[];
-}
-interface InteractionElementListContext {
-    listIndex?: number;
-    listId?: string;
-    listLabel?: string;
-    itemIndex?: number;
-    itemKey?: string;
-    reactKey?: string;
-    syntheticId?: string;
-}
-interface InteractionElementSnapshot {
-    /** Stable id for the current screen/content, preferred for tool calls. */
-    id: string;
-    /** Semantic UI role. */
-    role: 'option' | 'button' | 'input' | 'toggle' | 'slider' | 'listItem';
-    /** Human-readable label. */
-    label?: string;
-    /** Text segments associated with this element. */
-    texts: string[];
-    /** Actions supported by this element. */
-    actions: Array<'press' | 'focus' | 'toggle' | 'setValue'>;
-    /** Whether the element is currently disabled. */
-    disabled?: boolean;
-    /** Whether the element appears selected. */
-    selected?: boolean;
-    /** Source that produced the element. */
-    source?: 'list' | 'button' | 'input' | 'toggle' | 'slider' | 'choice';
-    /** Legacy/fallback target id, if any. */
-    targetId?: string;
-    /** Context for row/list options. */
-    listContext?: InteractionElementListContext;
-    /**
-     * True when the underlying component lives inside a currently-visible
-     * Modal — the only targets actually touchable while the overlay is up.
-     */
-    inModal?: boolean;
-}
-interface ScreenSnapshot {
-    /** The currently active route name, if known */
-    route: string | null;
-    /** All visible static text (text content of <Text> components) */
-    texts: string[];
-    /** All TextInput components currently rendered (and visible) */
-    inputs: InputSnapshot[];
-    /** All button-like components (TouchableOpacity, Pressable, etc.) */
-    buttons: ButtonSnapshot[];
-    /** All Switch components */
-    toggles: ToggleSnapshot[];
-    /**
-     * Sliders / adjustable numeric controls. Populated from the
-     * ComponentRegistry (useAppilotsSlider) by captureSnapshot — the
-     * registry is the only source that knows min/max/step AND can
-     * execute set_value, so observation and execution stay in contract.
-     */
-    sliders: SliderSnapshot[];
-    /** Whether an ActivityIndicator is visible (signals loading state) */
-    loading: boolean;
-    /** Whether a Modal is currently open */
-    modalOpen: boolean;
-    /**
-     * Lists detected in the visible tree. Each list's items have their
-     * own per-item texts/buttons/inputs/toggles, NOT duplicated in the
-     * flat top-level arrays — that's the whole reason this field exists,
-     * to preserve row association the flat shape destroys.
-     */
-    lists: ListSnapshot[];
-    /**
-     * Choice groups detected from visible cards/rows/chips/buttons.
-     * These are used for select-like flows where no TextInput exists:
-     * choose an option by pressing a row/card, then advance.
-     */
-    choiceGroups: ChoiceGroupSnapshot[];
-    /**
-     * Interaction graph: visible actionable elements with stable ids,
-     * semantic roles, labels, and execution fallbacks. Agents should
-     * prefer these ids over synthetic ordinal handles.
-     */
-    elements: InteractionElementSnapshot[];
-    /** Diagnostic counts for debugging */
-    stats?: {
-        visitedFibers: number;
-        skippedHidden: number;
-    };
-}
-
 type InteractionElementEntry = InteractionElementSnapshot;
 type Listener = (id: string, entry: InteractionElementEntry | null) => void;
 type ElementRegistry = ElementRegistryImpl;
@@ -1198,4 +921,4 @@ interface ExecutorContext {
 }
 declare function executeAction(action: AgentAction, context: ExecutorContext): Promise<ActionResult>;
 
-export { ActionBreadcrumb, type ActionBreadcrumbProps, type ActionResult, type AppilotsButtonProps, AppilotsChat, type AppilotsChatMode, type AppilotsChatPosition, type AppilotsChatProps, type AppilotsChatTheme, AppilotsI18nProvider, type AppilotsI18nProviderProps, type AppilotsInputProps, type AppilotsRC, AppilotsRegistryProvider, type AppilotsStringKey, type AppilotsStrings, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, type ButtonSnapshot, ChatIcon, type ChatIconProps, type ChoiceGroupSnapshot, type ChoiceOptionSnapshot, ComponentRegistry, ConfirmDialog, type ConfirmDialogProps, type ElementRegistry, type ExecutorContext, FieldEntry, HeadsetIcon, type HeadsetIconProps, type InputSnapshot, type InteractionElementEntry, type InteractionElementListContext, type InteractionElementSnapshot, type ListEntry, type ListItemSnapshot, type ListRegistry, type ListSnapshot, type ScreenSnapshot, type TailwindResolvedConfig, type ToggleSnapshot, _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 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 };

package/dist/index.d.ts

@@ -1,9 +1,7 @@
-import { C as ComponentRegistry, F as FieldEntry } from './index-BYVRBzjJ.js';
-export { A as AppilotsConfig, a as AppilotsProvider, b as AppilotsProviderProps, c as ComponentEntry, d as ComponentKind, S as SliderEntry, e as SuggestedPrompt, T as TargetEntry, f as ToggleEntry, U as UseAppilotsFieldOptions, g as UseAppilotsSliderOptions, h as UseAppilotsTargetOptions, i as UseAppilotsToggleOptions, j as UseSuggestedPromptsOptions, k as UseSuggestedPromptsReturn, l as componentRegistry, m as createComponentRegistry, u as useAppilots, n as useAppilotsActions, o as useAppilotsChat, p as useAppilotsContext, q as useAppilotsField, r as useAppilotsNavigation, s as useAppilotsSlider, t as useAppilotsTarget, v as useAppilotsToggle, w as useSuggestedPrompts } from './index-BYVRBzjJ.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-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 * as React$1 from 'react';
 import React__default from 'react';
-import { PartialThemeTokens, AppilotsThemeTokens, AppilotsLocale, AgentAction, AgentPermissions, AppilotsEvent } from '@appilots/client-core';
-export { AgentAction, AgentActionType, AgentMessage, AgentPermissions, AppilotsClient, AppilotsClientOptions, AppilotsEvent, AppilotsEventHandler, AppilotsEventType, AppilotsLocale, AppilotsThemeTokens, AppilotsTraceEntry, AppilotsUser, BreadcrumbItem, BreadcrumbState, ChatMessage, EscalationState, FormFillPayload, MessageRole, NavigationPayload, PartialThemeTokens, RemotePersonalization, SDK_VERSION, UIInteractionPayload, clearAppilotsDebugTraces, defaultDarkTheme, defaultLightTheme, describeAction, getAppilotsDebugTraces, humanizeError, mergeThemeTokens, recordAppilotsDebugTrace, subscribeAppilotsDebugTraces } from '@appilots/client-core';
 export { A as AppilotsNavigationContainer, N as NavigationConfig, b as ScreenMetadata, r as registerScreen } from './registerScreen-D1oGm28T.js';
 
 interface AppilotsThemeProviderProps {
@@ -463,7 +461,7 @@ declare function HeadsetIcon({ size, color }: HeadsetIconProps): React$1.JSX.Ele
  * registers that metadata here so snapshots can describe collections
  * without relying only on structural guesses.
  */
-interface ListDataPreviewEntry$1 {
+interface ListDataPreviewEntry {
     /** 0-based index in the list's backing data. */
     index: number;
     /** Stable key from keyExtractor / item.id when available. */
@@ -500,7 +498,7 @@ interface ListEntry {
      * the auto-tracking wrapper from `props.data` so the agent can see
      * rows that virtualization keeps unmounted.
      */
-    dataPreview?: ListDataPreviewEntry$1[];
+    dataPreview?: ListDataPreviewEntry[];
     /** Scroll so the 0-based data index becomes visible. Returns false when unsupported. */
     scrollToIndex?: (index: number) => boolean;
     /** Scroll to an absolute pixel offset. Returns false when unsupported. */
@@ -525,281 +523,6 @@ declare class ListRegistryImpl {
 declare const listRegistry: ListRegistry;
 declare function createListRegistry(): ListRegistry;
 
-/**
- * Snapshot types — the shape of data captured from the React fiber tree.
- *
- * This is the runtime "view model" of what the user is currently seeing
- * on screen, sent to the AI agent so it has accurate visible state.
- */
-interface InputSnapshot {
-    /** Best identifier — testID, accessibilityLabel, or placeholder */
-    id?: string;
-    /** Human-readable label inferred from accessibilityLabel, label prop, or sibling Text */
-    label?: string;
-    /** Current value (only present for controlled inputs) */
-    value?: string;
-    /** Placeholder text */
-    placeholder?: string;
-    /** Whether the input is editable */
-    editable?: boolean;
-    /** Whether the input is secure (password field) */
-    secure?: boolean;
-    /** Inferred type based on keyboardType / secureTextEntry */
-    type?: 'text' | 'email' | 'number' | 'phone' | 'password';
-    /**
-     * True when this input lives inside a currently-visible Modal. When a
-     * modal is open, only inModal elements can actually receive touches —
-     * everything else is behind the overlay.
-     */
-    inModal?: boolean;
-}
-interface ButtonSnapshot {
-    /** Best identifier — testID, accessibilityLabel, or inferred from child text */
-    id?: string;
-    /** Human-readable label — usually the visible text inside the button */
-    label?: string;
-    /** Whether the button is disabled */
-    disabled?: boolean;
-    /**
-     * Whether the button currently appears selected/active — read from
-     * `accessibilityState.selected`. Set by grouped, mutually-exclusive
-     * controls (SegmentedControl, RadioGroup) where each option is its
-     * own pressable target; absent/false for ordinary buttons.
-     */
-    selected?: boolean;
-    /** True when this button lives inside a currently-visible Modal. */
-    inModal?: boolean;
-}
-interface ToggleSnapshot {
-    /** Best identifier — testID or accessibilityLabel */
-    id?: string;
-    /** Human-readable label */
-    label?: string;
-    /** Current on/off state */
-    value?: boolean;
-    /** True when this toggle lives inside a currently-visible Modal. */
-    inModal?: boolean;
-}
-interface SliderSnapshot {
-    /** Registry id (the id apps pass to useAppilotsSlider) — the executable handle. */
-    id?: string;
-    /** Human-readable label */
-    label?: string;
-    /** Current numeric value */
-    value?: number;
-    /** Lower bound the executor clamps to */
-    min?: number;
-    /** Upper bound the executor clamps to */
-    max?: number;
-    /** Step the executor snaps to (omitted = continuous) */
-    step?: number;
-    /** Whether the slider is currently disabled */
-    disabled?: boolean;
-    /** True when this slider lives inside a currently-visible Modal. */
-    inModal?: boolean;
-}
-interface ListItemSnapshot {
-    /** 1-indexed position within the parent list (matches "selecione o terceiro"). */
-    index: number;
-    /**
-     * 0-based index of this row in the list's backing DATA, when the
-     * auto-tracking wrapper stamped it (`__appilotsItemIndex`). For
-     * scrolled/virtualized lists this differs from `index`: the first
-     * MOUNTED row might be data item 42. Lets the prompt show absolute
-     * positions ("#43 of 100") so ordinal references stay correct.
-     */
-    dataIndex?: number;
-    /**
-     * React key of the cell, if present (typically the item's domain id
-     * from keyExtractor). Useful for the LLM when the user references an
-     * item by name and we want to surface a deterministic handle for
-     * future tap-by-ordinal resolution (Phase B).
-     */
-    reactKey?: string;
-    /** Runtime key supplied by auto-tracked list renderItem, if available. */
-    itemKey?: string;
-    /**
-     * Texts captured from this item's subtree (vehicle name, plate,
-     * tags, etc.). Per-item to preserve row association — the flat
-     * `snapshot.texts` lost it.
-     */
-    texts: string[];
-    /** Buttons inside this item — e.g. an inline "Edit" button on a row. */
-    buttons: ButtonSnapshot[];
-    /** Inputs inside this item — rare but possible (inline edit row). */
-    inputs: InputSnapshot[];
-    /** Toggles inside this item. */
-    toggles: ToggleSnapshot[];
-    /**
-     * Synthetic id assigned by the walker. Stable within a single
-     * snapshot; format `list-<L>-item-<I>` (0-indexed L, 1-indexed I).
-     * Used by Phase B's tap-by-ordinal resolution in uiInteractionHandler.
-     */
-    syntheticId: string;
-}
-interface ListSnapshot {
-    /** 0-indexed list ordinal — multiple lists on one screen get 0, 1, 2... */
-    index: number;
-    /** Runtime list id when auto-tracking or explicit props provide one. */
-    id?: string;
-    /**
-     * The container component name as observed in the fiber tree.
-     * Common values: 'FlatList', 'SectionList', 'VirtualizedList',
-     * 'FlashList', 'ScrollView' (when detected by N≥2 keyed children).
-     */
-    containerType: string;
-    /** Source that identified this list. */
-    source?: 'fiber' | 'auto-tracked' | 'registry';
-    /** Total data-set count when the list component exposes it. */
-    itemCount?: number;
-    /** Number of row items captured in this snapshot. */
-    visibleItemCount?: number;
-    /** True when the list reports a refresh/loading state. */
-    refreshing?: boolean;
-    /** True when total item count is known and zero. */
-    empty?: boolean;
-    /** Human-readable label if the app supplied one. */
-    label?: string;
-    /**
-     * Items in visible order. Real list components may expose one mounted
-     * item when virtualization or an overlay limits the visible window;
-     * heuristic ScrollView lists still require at least two list-like items.
-     */
-    items: ListItemSnapshot[];
-    /**
-     * Lightweight text projection of the list's FULL data set (capped),
-     * captured by the auto-tracking wrapper from `props.data`. Lets the
-     * agent see/search rows that virtualization keeps unmounted. Each
-     * entry: 0-based data index, stable key (keyExtractor), short text.
-     */
-    dataPreview?: ListDataPreviewEntry[];
-    /** Current vertical scroll offset in px, when the SDK could read it. */
-    scrollOffsetY?: number;
-    /** True when there is scrollable content above the viewport. */
-    canScrollUp?: boolean;
-    /** True when there is scrollable content below the viewport. */
-    canScrollDown?: boolean;
-}
-interface ListDataPreviewEntry {
-    /** 0-based index in the list's backing data. */
-    index: number;
-    /** Stable key from keyExtractor / item.id when available. */
-    key?: string;
-    /** Short human-readable projection of the item (capped length). */
-    text: string;
-}
-interface ChoiceOptionSnapshot {
-    /** 1-indexed option position within this group. */
-    index: number;
-    /** Stable-enough id for the current snapshot/action turn. */
-    syntheticId: string;
-    /** Best target id if this option is backed by a pressable component. */
-    targetId?: string;
-    /** Human-readable option label. */
-    label?: string;
-    /** Text segments that belong to this option. */
-    texts: string[];
-    /** Whether this option appears selected. */
-    selected?: boolean;
-    /** Whether this option appears disabled. */
-    disabled?: boolean;
-}
-interface ChoiceGroupSnapshot {
-    /** 0-indexed group ordinal on the current screen. */
-    index: number;
-    /** Runtime id when known, usually inherited from a list/collection. */
-    id?: string;
-    /** Human-readable label when known. */
-    label?: string;
-    /** Source that produced this choice group. */
-    source?: 'list' | 'buttons' | 'heuristic';
-    /** Visible options in order. */
-    options: ChoiceOptionSnapshot[];
-}
-interface InteractionElementListContext {
-    listIndex?: number;
-    listId?: string;
-    listLabel?: string;
-    itemIndex?: number;
-    itemKey?: string;
-    reactKey?: string;
-    syntheticId?: string;
-}
-interface InteractionElementSnapshot {
-    /** Stable id for the current screen/content, preferred for tool calls. */
-    id: string;
-    /** Semantic UI role. */
-    role: 'option' | 'button' | 'input' | 'toggle' | 'slider' | 'listItem';
-    /** Human-readable label. */
-    label?: string;
-    /** Text segments associated with this element. */
-    texts: string[];
-    /** Actions supported by this element. */
-    actions: Array<'press' | 'focus' | 'toggle' | 'setValue'>;
-    /** Whether the element is currently disabled. */
-    disabled?: boolean;
-    /** Whether the element appears selected. */
-    selected?: boolean;
-    /** Source that produced the element. */
-    source?: 'list' | 'button' | 'input' | 'toggle' | 'slider' | 'choice';
-    /** Legacy/fallback target id, if any. */
-    targetId?: string;
-    /** Context for row/list options. */
-    listContext?: InteractionElementListContext;
-    /**
-     * True when the underlying component lives inside a currently-visible
-     * Modal — the only targets actually touchable while the overlay is up.
-     */
-    inModal?: boolean;
-}
-interface ScreenSnapshot {
-    /** The currently active route name, if known */
-    route: string | null;
-    /** All visible static text (text content of <Text> components) */
-    texts: string[];
-    /** All TextInput components currently rendered (and visible) */
-    inputs: InputSnapshot[];
-    /** All button-like components (TouchableOpacity, Pressable, etc.) */
-    buttons: ButtonSnapshot[];
-    /** All Switch components */
-    toggles: ToggleSnapshot[];
-    /**
-     * Sliders / adjustable numeric controls. Populated from the
-     * ComponentRegistry (useAppilotsSlider) by captureSnapshot — the
-     * registry is the only source that knows min/max/step AND can
-     * execute set_value, so observation and execution stay in contract.
-     */
-    sliders: SliderSnapshot[];
-    /** Whether an ActivityIndicator is visible (signals loading state) */
-    loading: boolean;
-    /** Whether a Modal is currently open */
-    modalOpen: boolean;
-    /**
-     * Lists detected in the visible tree. Each list's items have their
-     * own per-item texts/buttons/inputs/toggles, NOT duplicated in the
-     * flat top-level arrays — that's the whole reason this field exists,
-     * to preserve row association the flat shape destroys.
-     */
-    lists: ListSnapshot[];
-    /**
-     * Choice groups detected from visible cards/rows/chips/buttons.
-     * These are used for select-like flows where no TextInput exists:
-     * choose an option by pressing a row/card, then advance.
-     */
-    choiceGroups: ChoiceGroupSnapshot[];
-    /**
-     * Interaction graph: visible actionable elements with stable ids,
-     * semantic roles, labels, and execution fallbacks. Agents should
-     * prefer these ids over synthetic ordinal handles.
-     */
-    elements: InteractionElementSnapshot[];
-    /** Diagnostic counts for debugging */
-    stats?: {
-        visitedFibers: number;
-        skippedHidden: number;
-    };
-}
-
 type InteractionElementEntry = InteractionElementSnapshot;
 type Listener = (id: string, entry: InteractionElementEntry | null) => void;
 type ElementRegistry = ElementRegistryImpl;
@@ -1198,4 +921,4 @@ interface ExecutorContext {
 }
 declare function executeAction(action: AgentAction, context: ExecutorContext): Promise<ActionResult>;
 
-export { ActionBreadcrumb, type ActionBreadcrumbProps, type ActionResult, type AppilotsButtonProps, AppilotsChat, type AppilotsChatMode, type AppilotsChatPosition, type AppilotsChatProps, type AppilotsChatTheme, AppilotsI18nProvider, type AppilotsI18nProviderProps, type AppilotsInputProps, type AppilotsRC, AppilotsRegistryProvider, type AppilotsStringKey, type AppilotsStrings, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, type ButtonSnapshot, ChatIcon, type ChatIconProps, type ChoiceGroupSnapshot, type ChoiceOptionSnapshot, ComponentRegistry, ConfirmDialog, type ConfirmDialogProps, type ElementRegistry, type ExecutorContext, FieldEntry, HeadsetIcon, type HeadsetIconProps, type InputSnapshot, type InteractionElementEntry, type InteractionElementListContext, type InteractionElementSnapshot, type ListEntry, type ListItemSnapshot, type ListRegistry, type ListSnapshot, type ScreenSnapshot, type TailwindResolvedConfig, type ToggleSnapshot, _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 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 };