@appilots/sdk 0.11.0 → 0.11.3

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-BPZ0j71S.mjs';
+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-BR-33WMN.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-BPZ0j71S.js';
+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-BR-33WMN.js';
 import 'react';

package/dist/hooks/index.js

@@ -1,43 +1,43 @@
 'use strict';
 
-var chunk2YPEQTL2_js = require('../chunk-2YPEQTL2.js');
-require('../chunk-55Y2AQE7.js');
+var chunkUFMTRGML_js = require('../chunk-UFMTRGML.js');
+require('../chunk-SUMIABJK.js');
 
 
 
 Object.defineProperty(exports, "useAppilots", {
   enumerable: true,
-  get: function () { return chunk2YPEQTL2_js.useAppilots; }
+  get: function () { return chunkUFMTRGML_js.useAppilots; }
 });
 Object.defineProperty(exports, "useAppilotsActions", {
   enumerable: true,
-  get: function () { return chunk2YPEQTL2_js.useAppilotsActions; }
+  get: function () { return chunkUFMTRGML_js.useAppilotsActions; }
 });
 Object.defineProperty(exports, "useAppilotsChat", {
   enumerable: true,
-  get: function () { return chunk2YPEQTL2_js.useAppilotsChat; }
+  get: function () { return chunkUFMTRGML_js.useAppilotsChat; }
 });
 Object.defineProperty(exports, "useAppilotsField", {
   enumerable: true,
-  get: function () { return chunk2YPEQTL2_js.useAppilotsField; }
+  get: function () { return chunkUFMTRGML_js.useAppilotsField; }
 });
 Object.defineProperty(exports, "useAppilotsNavigation", {
   enumerable: true,
-  get: function () { return chunk2YPEQTL2_js.useAppilotsNavigation; }
+  get: function () { return chunkUFMTRGML_js.useAppilotsNavigation; }
 });
 Object.defineProperty(exports, "useAppilotsSlider", {
   enumerable: true,
-  get: function () { return chunk2YPEQTL2_js.useAppilotsSlider; }
+  get: function () { return chunkUFMTRGML_js.useAppilotsSlider; }
 });
 Object.defineProperty(exports, "useAppilotsTarget", {
   enumerable: true,
-  get: function () { return chunk2YPEQTL2_js.useAppilotsTarget; }
+  get: function () { return chunkUFMTRGML_js.useAppilotsTarget; }
 });
 Object.defineProperty(exports, "useAppilotsToggle", {
   enumerable: true,
-  get: function () { return chunk2YPEQTL2_js.useAppilotsToggle; }
+  get: function () { return chunkUFMTRGML_js.useAppilotsToggle; }
 });
 Object.defineProperty(exports, "useSuggestedPrompts", {
   enumerable: true,
-  get: function () { return chunk2YPEQTL2_js.useSuggestedPrompts; }
+  get: function () { return chunkUFMTRGML_js.useSuggestedPrompts; }
 });

package/dist/hooks/index.mjs

@@ -1,2 +1,2 @@
-export { useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts } from '../chunk-NA5H4IHH.mjs';
-import '../chunk-G6KI7KVH.mjs';
+export { useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts } from '../chunk-2ZDELL54.mjs';
+import '../chunk-ROXXCDIG.mjs';

package/dist/{index-BPZ0j71S.d.mts → index-BR-33WMN.d.mts}

@@ -250,7 +250,7 @@ interface UIInteractionPayload {
     componentId: string;
     /** Canonical server/LLM identifier. `componentId` is kept as SDK alias. */
     targetId?: string;
-    action: 'press' | 'longPress' | 'scroll' | 'swipe' | 'focus' | 'set_value';
+    action: 'press' | 'longPress' | 'toggle' | 'scroll' | 'swipe' | 'focus' | 'set_value';
     /**
      * Numeric value for `set_value` (sliders / adjustable controls).
      * The handler clamps to the slider's [min, max] and snaps to its step.
@@ -754,6 +754,45 @@ interface InputSnapshot {
      * field declares no such handler, so the form needs a button.
      */
     submitsOnReturn?: boolean;
+    /**
+     * The app is asking for this field before the form can be submitted.
+     *
+     * ABSENT MEANS UNKNOWN, not optional: most apps never declare it, and
+     * reading absence as "not required" would let the agent submit a form
+     * it could have known was incomplete.
+     */
+    required?: boolean;
+    /**
+     * The app is currently rejecting this field's value.
+     *
+     * This is the fact the agent used to recover by READING — the error
+     * copy next to the input ("Campo obrigatório", "Formato inválido").
+     * Carrying the fact as a boolean is what lets a redacted observation
+     * still support recovery, and it is cheaper than the sentence even
+     * when nothing is redacted.
+     *
+     * Absent means the app declares no validity state — never that the
+     * field is valid.
+     */
+    invalid?: boolean;
+    /**
+     * Whether the field currently holds anything.
+     *
+     * Deliberately its own field rather than an inference over `value`.
+     * The value belongs to the user and is the first thing a privacy
+     * policy withholds; the EXISTENCE of a value belongs to the agent and
+     * is what stops it from filling the same field twice on a later hop.
+     * Separating them is what lets the second survive without the first.
+     */
+    filled?: boolean;
+    /**
+     * This input has keyboard focus right now.
+     *
+     * Tells apart "empty because nobody typed" from "empty because the
+     * user is typing in it at this moment" — the difference between
+     * completing a form and interrupting someone mid-sentence.
+     */
+    focused?: boolean;
     /**
      * True when this input lives inside a currently-visible modal. When a
      * modal is open, only inModal elements can actually receive input —
@@ -1085,6 +1124,67 @@ interface InteractionElementEntry extends InteractionElementSnapshot {
      */
     rect?: ElementRect;
 }
+/**
+ * What changed between the previous observation and this one.
+ *
+ * The client holds both snapshots; the server only ever sees one. So the
+ * question the agent loop asks most often — "did the action I just took
+ * do anything?" — is one the client can answer as a FACT and the server
+ * can only guess at. Today it guesses: `effect: 'none'` on the turn trail
+ * is derived server-side from heuristics over a single snapshot.
+ *
+ * Everything here is shape, never content: counts, booleans, and field
+ * ids that the app declared itself. That is not an accident of design —
+ * it is what lets this survive a redacted or content-free observation
+ * intact, and it is why the most useful signal in the observation is also
+ * the cheapest one to send.
+ *
+ * ABSENT vs `unchanged: true` is the load-bearing distinction, and it is
+ * the same one `truncated` exists to make. Absent means there was no
+ * previous observation to compare against (the first capture of a
+ * mission). `unchanged: true` means we DID compare and nothing moved —
+ * which is the strongest evidence there is that an action did nothing.
+ */
+interface SnapshotDelta {
+    /** The active route is not the one the previous observation reported. */
+    routeChanged?: boolean;
+    /** A modal or native dialog is up now and was not before. */
+    modalOpened?: boolean;
+    /** A modal or native dialog was up before and is gone now. */
+    modalClosed?: boolean;
+    /** A loading indicator appeared. */
+    loadingStarted?: boolean;
+    /** A loading indicator that was showing is gone. */
+    loadingFinished?: boolean;
+    /** How many distinct visible texts are present now that were not before. */
+    textsAdded?: number;
+    /** How many distinct visible texts are gone. */
+    textsRemoved?: number;
+    /** Net change in mounted list rows, summed across every list. */
+    visibleRowsDelta?: number;
+    /**
+     * Net change in the lists' reported DATA totals, summed. This is the
+     * one that answers "did the record actually get created", because it
+     * moves even when virtualization keeps the new row unmounted.
+     */
+    totalRowsDelta?: number;
+    /**
+     * Fields that went from empty to filled. Declared ids only — a
+     * `derived` id is folded from visible copy, so publishing it here
+     * would smuggle content through a field that claims to carry none.
+     */
+    fieldsNewlyFilled?: string[];
+    /** Fields that went from filled to empty. Declared ids only. */
+    fieldsCleared?: string[];
+    /** Some field is reporting invalid that was not reporting it before. */
+    invalidAppeared?: boolean;
+    /**
+     * Nothing above fired: we compared two observations and the screen is
+     * structurally identical. Present only when every other field is
+     * absent, so a reader never has to check all of them to know.
+     */
+    unchanged?: boolean;
+}
 interface ScreenSnapshot {
     /** The currently active route name, if known */
     route: string | null;
@@ -1147,6 +1247,17 @@ interface ScreenSnapshot {
      * from a short one.
      */
     truncated?: boolean;
+    /**
+     * What moved since the previous observation. See {@link SnapshotDelta}
+     * — absent means there was nothing to compare against, which is a
+     * different statement from "nothing changed".
+     *
+     * Attached by the platform adapter rather than by the walker: the
+     * baseline has to be the last snapshot that was actually SENT, and
+     * `captureSnapshot` is also called for internal probes that never
+     * leave the device.
+     */
+    delta?: SnapshotDelta;
     /** Diagnostic counts for debugging */
     stats?: {
         visitedFibers: number;

package/dist/{index-BPZ0j71S.d.ts → index-BR-33WMN.d.ts}

@@ -250,7 +250,7 @@ interface UIInteractionPayload {
     componentId: string;
     /** Canonical server/LLM identifier. `componentId` is kept as SDK alias. */
     targetId?: string;
-    action: 'press' | 'longPress' | 'scroll' | 'swipe' | 'focus' | 'set_value';
+    action: 'press' | 'longPress' | 'toggle' | 'scroll' | 'swipe' | 'focus' | 'set_value';
     /**
      * Numeric value for `set_value` (sliders / adjustable controls).
      * The handler clamps to the slider's [min, max] and snaps to its step.
@@ -754,6 +754,45 @@ interface InputSnapshot {
      * field declares no such handler, so the form needs a button.
      */
     submitsOnReturn?: boolean;
+    /**
+     * The app is asking for this field before the form can be submitted.
+     *
+     * ABSENT MEANS UNKNOWN, not optional: most apps never declare it, and
+     * reading absence as "not required" would let the agent submit a form
+     * it could have known was incomplete.
+     */
+    required?: boolean;
+    /**
+     * The app is currently rejecting this field's value.
+     *
+     * This is the fact the agent used to recover by READING — the error
+     * copy next to the input ("Campo obrigatório", "Formato inválido").
+     * Carrying the fact as a boolean is what lets a redacted observation
+     * still support recovery, and it is cheaper than the sentence even
+     * when nothing is redacted.
+     *
+     * Absent means the app declares no validity state — never that the
+     * field is valid.
+     */
+    invalid?: boolean;
+    /**
+     * Whether the field currently holds anything.
+     *
+     * Deliberately its own field rather than an inference over `value`.
+     * The value belongs to the user and is the first thing a privacy
+     * policy withholds; the EXISTENCE of a value belongs to the agent and
+     * is what stops it from filling the same field twice on a later hop.
+     * Separating them is what lets the second survive without the first.
+     */
+    filled?: boolean;
+    /**
+     * This input has keyboard focus right now.
+     *
+     * Tells apart "empty because nobody typed" from "empty because the
+     * user is typing in it at this moment" — the difference between
+     * completing a form and interrupting someone mid-sentence.
+     */
+    focused?: boolean;
     /**
      * True when this input lives inside a currently-visible modal. When a
      * modal is open, only inModal elements can actually receive input —
@@ -1085,6 +1124,67 @@ interface InteractionElementEntry extends InteractionElementSnapshot {
      */
     rect?: ElementRect;
 }
+/**
+ * What changed between the previous observation and this one.
+ *
+ * The client holds both snapshots; the server only ever sees one. So the
+ * question the agent loop asks most often — "did the action I just took
+ * do anything?" — is one the client can answer as a FACT and the server
+ * can only guess at. Today it guesses: `effect: 'none'` on the turn trail
+ * is derived server-side from heuristics over a single snapshot.
+ *
+ * Everything here is shape, never content: counts, booleans, and field
+ * ids that the app declared itself. That is not an accident of design —
+ * it is what lets this survive a redacted or content-free observation
+ * intact, and it is why the most useful signal in the observation is also
+ * the cheapest one to send.
+ *
+ * ABSENT vs `unchanged: true` is the load-bearing distinction, and it is
+ * the same one `truncated` exists to make. Absent means there was no
+ * previous observation to compare against (the first capture of a
+ * mission). `unchanged: true` means we DID compare and nothing moved —
+ * which is the strongest evidence there is that an action did nothing.
+ */
+interface SnapshotDelta {
+    /** The active route is not the one the previous observation reported. */
+    routeChanged?: boolean;
+    /** A modal or native dialog is up now and was not before. */
+    modalOpened?: boolean;
+    /** A modal or native dialog was up before and is gone now. */
+    modalClosed?: boolean;
+    /** A loading indicator appeared. */
+    loadingStarted?: boolean;
+    /** A loading indicator that was showing is gone. */
+    loadingFinished?: boolean;
+    /** How many distinct visible texts are present now that were not before. */
+    textsAdded?: number;
+    /** How many distinct visible texts are gone. */
+    textsRemoved?: number;
+    /** Net change in mounted list rows, summed across every list. */
+    visibleRowsDelta?: number;
+    /**
+     * Net change in the lists' reported DATA totals, summed. This is the
+     * one that answers "did the record actually get created", because it
+     * moves even when virtualization keeps the new row unmounted.
+     */
+    totalRowsDelta?: number;
+    /**
+     * Fields that went from empty to filled. Declared ids only — a
+     * `derived` id is folded from visible copy, so publishing it here
+     * would smuggle content through a field that claims to carry none.
+     */
+    fieldsNewlyFilled?: string[];
+    /** Fields that went from filled to empty. Declared ids only. */
+    fieldsCleared?: string[];
+    /** Some field is reporting invalid that was not reporting it before. */
+    invalidAppeared?: boolean;
+    /**
+     * Nothing above fired: we compared two observations and the screen is
+     * structurally identical. Present only when every other field is
+     * absent, so a reader never has to check all of them to know.
+     */
+    unchanged?: boolean;
+}
 interface ScreenSnapshot {
     /** The currently active route name, if known */
     route: string | null;
@@ -1147,6 +1247,17 @@ interface ScreenSnapshot {
      * from a short one.
      */
     truncated?: boolean;
+    /**
+     * What moved since the previous observation. See {@link SnapshotDelta}
+     * — absent means there was nothing to compare against, which is a
+     * different statement from "nothing changed".
+     *
+     * Attached by the platform adapter rather than by the walker: the
+     * baseline has to be the last snapshot that was actually SENT, and
+     * `captureSnapshot` is also called for internal probes that never
+     * leave the device.
+     */
+    delta?: SnapshotDelta;
     /** Diagnostic counts for debugging */
     stats?: {
         visitedFibers: number;

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { P as PartialThemeTokens, A as AppilotsThemeTokens, a as AppilotsLocale, b as AgentAction, I as InteractionElementEntry, C as ComponentRegistry, c as AgentPermissions, S as ScreenSnapshot, F as FieldEntry, d as AppilotsEvent } from './index-BPZ0j71S.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, z as InteractionElementSnapshot, L as ListItemSnapshot, D as ListSnapshot, M as MessageRole, N as NavigationPayload, R as RateLimitedError, G as RemotePersonalization, 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-BPZ0j71S.mjs';
+import { P as PartialThemeTokens, A as AppilotsThemeTokens, a as AppilotsLocale, b as AgentAction, I as InteractionElementEntry, C as ComponentRegistry, c as AgentPermissions, S as ScreenSnapshot, F as FieldEntry, d as AppilotsEvent } from './index-BR-33WMN.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, z as InteractionElementSnapshot, L as ListItemSnapshot, D as ListSnapshot, M as MessageRole, N as NavigationPayload, R as RateLimitedError, G as RemotePersonalization, 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-BR-33WMN.mjs';
 import * as React$1 from 'react';
 import React__default from 'react';
 export { AppilotsNavigationContainer, NavigationConfig, ScreenMetadata, registerScreen, setCurrentScreen } from './navigation/index.mjs';
@@ -289,6 +289,31 @@ interface LegacyThemeShape {
     borderRadius?: number;
     fontFamily?: string;
 }
+/**
+ * testID contract — the SDK's e2e surface.
+ *
+ * Every control an integrator's e2e suite has to drive carries a stable
+ * `testID`, and the id is the ONLY handle we promise. Copy is not: the
+ * visible label and the `accessibilityLabel` both come from the i18n
+ * bundle, so a harness that matches on them has to try every locale the
+ * app ships and then guess.
+ *
+ * The close button was the hole. It had a localized `accessibilityLabel`
+ * and no id, so integrators matched its text in three languages and fell
+ * back to a swipe when none hit. `assistant-clear` was the same hole one
+ * button over.
+ *
+ * The id alone did not fix what found it, and it is worth knowing why:
+ * the run that failed was failing on REACHABILITY, not on matching — the
+ * sheet used to overflow off the top of the screen when the keyboard
+ * opened, taking this header with it, and a harness taps by coordinate.
+ * That is fixed in the styles below; see `chatContainer`.
+ *
+ * The ids live in `AppilotsChat.testIds.realTree.test.tsx` and are
+ * published in apps/docs (`sdk/test-ids`). Adding one is additive;
+ * renaming or removing one is a BREAKING change for every integrator's
+ * test suite, whether or not the TypeScript surface moved.
+ */
 /**
  * Public entry point.
  *
@@ -1259,6 +1284,6 @@ declare function executeAction(action: AgentAction, context: ExecutorContext): P
  * (`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.11.0";
+declare const SDK_VERSION = "0.11.3";
 
 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 AppilotsSelfCheckReport, type AppilotsStringKey, type AppilotsStrings, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, AppilotsThemeTokens, type AutoTrackingState, ChatIcon, type ChatIconProps, ComponentRegistry, ConfirmDialog, type ConfirmDialogProps, type ElementRegistry, type ExecutorContext, FieldEntry, HeadsetIcon, type HeadsetIconProps, InteractionElementEntry, type IntrospectionDiagnostics, type IntrospectionFailureReason, type ListEntry, type ListRegistry, type NameManglingProbe, PartialThemeTokens, SDK_VERSION, ScreenSnapshot, type SelfCheckRegistry, type SelfCheckWalk, type TailwindResolvedConfig, type WalkDetectorCounts, _patchJsxRuntimes, appilotsSelfCheck, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, detectDeviceLocale, elementRegistry, enableAppilotsAutoTracking, executeAction, getAutoTrackingState, 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 InteractionElementEntry, C as ComponentRegistry, c as AgentPermissions, S as ScreenSnapshot, F as FieldEntry, d as AppilotsEvent } from './index-BPZ0j71S.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, z as InteractionElementSnapshot, L as ListItemSnapshot, D as ListSnapshot, M as MessageRole, N as NavigationPayload, R as RateLimitedError, G as RemotePersonalization, 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-BPZ0j71S.js';
+import { P as PartialThemeTokens, A as AppilotsThemeTokens, a as AppilotsLocale, b as AgentAction, I as InteractionElementEntry, C as ComponentRegistry, c as AgentPermissions, S as ScreenSnapshot, F as FieldEntry, d as AppilotsEvent } from './index-BR-33WMN.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, z as InteractionElementSnapshot, L as ListItemSnapshot, D as ListSnapshot, M as MessageRole, N as NavigationPayload, R as RateLimitedError, G as RemotePersonalization, 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-BR-33WMN.js';
 import * as React$1 from 'react';
 import React__default from 'react';
 export { AppilotsNavigationContainer, NavigationConfig, ScreenMetadata, registerScreen, setCurrentScreen } from './navigation/index.js';
@@ -289,6 +289,31 @@ interface LegacyThemeShape {
     borderRadius?: number;
     fontFamily?: string;
 }
+/**
+ * testID contract — the SDK's e2e surface.
+ *
+ * Every control an integrator's e2e suite has to drive carries a stable
+ * `testID`, and the id is the ONLY handle we promise. Copy is not: the
+ * visible label and the `accessibilityLabel` both come from the i18n
+ * bundle, so a harness that matches on them has to try every locale the
+ * app ships and then guess.
+ *
+ * The close button was the hole. It had a localized `accessibilityLabel`
+ * and no id, so integrators matched its text in three languages and fell
+ * back to a swipe when none hit. `assistant-clear` was the same hole one
+ * button over.
+ *
+ * The id alone did not fix what found it, and it is worth knowing why:
+ * the run that failed was failing on REACHABILITY, not on matching — the
+ * sheet used to overflow off the top of the screen when the keyboard
+ * opened, taking this header with it, and a harness taps by coordinate.
+ * That is fixed in the styles below; see `chatContainer`.
+ *
+ * The ids live in `AppilotsChat.testIds.realTree.test.tsx` and are
+ * published in apps/docs (`sdk/test-ids`). Adding one is additive;
+ * renaming or removing one is a BREAKING change for every integrator's
+ * test suite, whether or not the TypeScript surface moved.
+ */
 /**
  * Public entry point.
  *
@@ -1259,6 +1284,6 @@ declare function executeAction(action: AgentAction, context: ExecutorContext): P
  * (`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.11.0";
+declare const SDK_VERSION = "0.11.3";
 
 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 AppilotsSelfCheckReport, type AppilotsStringKey, type AppilotsStrings, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, AppilotsThemeTokens, type AutoTrackingState, ChatIcon, type ChatIconProps, ComponentRegistry, ConfirmDialog, type ConfirmDialogProps, type ElementRegistry, type ExecutorContext, FieldEntry, HeadsetIcon, type HeadsetIconProps, InteractionElementEntry, type IntrospectionDiagnostics, type IntrospectionFailureReason, type ListEntry, type ListRegistry, type NameManglingProbe, PartialThemeTokens, SDK_VERSION, ScreenSnapshot, type SelfCheckRegistry, type SelfCheckWalk, type TailwindResolvedConfig, type WalkDetectorCounts, _patchJsxRuntimes, appilotsSelfCheck, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, detectDeviceLocale, elementRegistry, enableAppilotsAutoTracking, executeAction, getAutoTrackingState, getGlobalConfig, getIntrospectionDiagnostics, initAppilots, isAutoTrackingEnabled, listRegistry, resolveLocale, useAppilotsI18n, useAppilotsTheme, useResolvedRegistry };