@appilots/sdk 0.13.0 → 0.14.0

package/dist/index.d.mts

@@ -1,7 +1,8 @@
-import { A as AppilotsTraceEntry, a as AgentAction, b as AppilotsLocale, P as PartialThemeTokens, c as AppilotsThemeTokens, C as ComponentRegistry, d as AppilotsSessionStorage, e as AgentPermissions, F as FieldEntry, f as AppilotsEvent } from './index-CI4jmSoP.mjs';
-export { g as AgentActionType, h as AgentMessage, i as AppilotsClient, j as AppilotsClientOptions, k as AppilotsConfig, l as AppilotsElementProps, m as AppilotsEventHandler, n as AppilotsEventType, o as AppilotsProvider, p as AppilotsProviderProps, q as AppilotsUser, r as ChatMessage, s as ComponentEntry, t as ComponentKind, E as EscalationState, u as FormFillPayload, M as MessageRole, N as NavigationPayload, R as RateLimitedError, v as RemotePersonalization, S as SliderEntry, w as SuggestedPrompt, T as TargetEntry, x as ToggleEntry, U as UIInteractionPayload, y as UseAppilotsFieldOptions, z as UseAppilotsSliderOptions, B as UseAppilotsTargetOptions, D as UseAppilotsToggleOptions, G as UseSuggestedPromptsOptions, H as UseSuggestedPromptsReturn, I as componentRegistry, J as createComponentRegistry, K as defaultDarkTheme, L as defaultLightTheme, O as mergeThemeTokens, Q as useAppilots, V as useAppilotsActions, W as useAppilotsChat, X as useAppilotsContext, Y as useAppilotsField, Z as useAppilotsNavigation, _ as useAppilotsSlider, $ as useAppilotsTarget, a0 as useAppilotsToggle, a1 as useSuggestedPrompts } from './index-CI4jmSoP.mjs';
+import { A as AppilotsTraceEntry, a as AgentAction, b as AppilotsLocale, P as PartialThemeTokens, c as AppilotsThemeTokens, C as ComponentRegistry, d as AppilotsSessionStorage, e as AgentPermissions, F as FieldEntry, f as AppilotsEvent } from './index-wMMetyrj.mjs';
+export { g as AgentActionType, h as AgentMessage, i as AppilotsClient, j as AppilotsClientOptions, k as AppilotsConfig, l as AppilotsElementProps, m as AppilotsEventHandler, n as AppilotsEventType, o as AppilotsProvider, p as AppilotsProviderProps, q as AppilotsUser, r as ChatMessage, s as ComponentEntry, t as ComponentKind, E as EscalationState, u as FormFillPayload, M as MessageRole, N as NavigationPayload, R as RateLimitedError, v as RemotePersonalization, S as SliderEntry, w as SuggestedPrompt, T as TargetEntry, x as ToggleEntry, U as UIInteractionPayload, y as UseAppilotsFieldOptions, z as UseAppilotsSliderOptions, B as UseAppilotsTargetOptions, D as UseAppilotsToggleOptions, G as UseSuggestedPromptsOptions, H as UseSuggestedPromptsReturn, I as componentRegistry, J as createComponentRegistry, K as defaultDarkTheme, L as defaultLightTheme, O as mergeThemeTokens, Q as useAppilots, V as useAppilotsActions, W as useAppilotsChat, X as useAppilotsContext, Y as useAppilotsField, Z as useAppilotsNavigation, _ as useAppilotsSlider, $ as useAppilotsTarget, a0 as useAppilotsToggle, a1 as useSuggestedPrompts } from './index-wMMetyrj.mjs';
 import * as React$1 from 'react';
 import React__default from 'react';
+import { TouchableOpacity } from 'react-native';
 export { AppilotsNavigationContainer, NavigationConfig, ScreenMetadata, registerScreen, setCurrentScreen } from './navigation/index.mjs';
 
 /** Source facts, not an executable locator or proof of a business outcome. */
@@ -22,6 +23,87 @@ interface ControlEvidence {
 
 type ActionPresentationState = 'pending' | 'running' | 'success' | 'failed';
 
+/**
+ * The speech seam.
+ *
+ * The SDK ships no speech engine and never will. Every usable one on
+ * React Native is a native module — `@react-native-voice/voice`,
+ * `expo-speech-recognition`, a vendor SDK — and a dependency here would
+ * force native linking on every integrator, including the majority who
+ * will never turn voice on. Worse, it would pick their engine for them:
+ * the right one depends on the locale they need, whether recognition
+ * may leave the device, and what their app store review already covers.
+ *
+ * So this is an interface and nothing else, injected the same way
+ * `GeometryHost` and the `Alert` in `confirmedDestructiveAlert` are.
+ * Pass an adapter and the mic button appears; pass nothing and
+ * `resolveExperience` reports `input: 'voice'` as an unmet request
+ * rather than rendering a button that does nothing.
+ *
+ * It lives in client-core because the web SDK takes the same contract:
+ * its built-in Web Speech engine is one implementation of it, and a
+ * host that needs recognition to stay on-device (or a vendor engine)
+ * passes its own.
+ *
+ * Everything here is transcription only. Playing audio back is not
+ * modelled, because nothing in the loop produces audio.
+ */
+/** What the SDK needs to run a mic button (hold-to-talk or toggle). */
+interface SpeechHost {
+    /**
+     * Begin listening. Resolve once capture is actually running, so the
+     * UI can wait before telling the user to speak.
+     *
+     * Implementations own permissions: if the OS prompt has not been
+     * accepted, request it here and reject when refused.
+     */
+    start(options: SpeechStartOptions): Promise<void>;
+    /**
+     * Stop listening and resolve with the final transcript.
+     *
+     * Resolving with an empty string is the normal outcome for "the user
+     * pressed and said nothing" — it must not reject for that.
+     */
+    stop(): Promise<string>;
+    /** Abandon the capture. No transcript, no error. */
+    cancel(): Promise<void>;
+    /**
+     * Partial results while the user is still talking, if the engine has
+     * them. Return a disposer. Optional — a host without interim results
+     * simply shows the placeholder until `stop` resolves.
+     */
+    onPartial?(listener: (text: string) => void): () => void;
+    /**
+     * The engine ended the capture on its own — silence timeout, lost
+     * permission, network — without `stop` or `cancel` being called.
+     * `error` is set when it ended by failure. Return a disposer.
+     *
+     * Optional, but without it a UI cannot leave `listening` until the
+     * user presses again: the button would claim to record while the
+     * engine is not.
+     */
+    onEnd?(listener: (error?: unknown) => void): () => void;
+}
+interface SpeechStartOptions {
+    /**
+     * BCP-47 tag resolved from the chat's locale, so a pt-BR chat does
+     * not transcribe against a US English model. Hosts that only support
+     * one locale may ignore it.
+     */
+    locale: string;
+}
+/** Where a mic button is in its cycle. */
+type SpeechState = 'idle' | 'starting' | 'listening' | 'stopping' | 'error';
+/**
+ * Is this object usable as a host?
+ *
+ * Checked at the boundary rather than trusted from the type, because
+ * the value crosses from the host app's JavaScript — where it may have
+ * come from a config file, a lazy import that failed, or a version of
+ * an adapter predating a method.
+ */
+declare function isSpeechHost(value: unknown): value is SpeechHost;
+
 /**
  * Snapshot types — the platform-agnostic "view model" of what the user
  * is currently seeing on screen, sent to the AI agent so it has
@@ -710,61 +792,6 @@ declare function humanizeError(raw: string | undefined, _action?: AgentAction):
  */
 type AppilotsChatPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
 
-/**
- * The speech seam.
- *
- * The SDK ships no speech engine and never will. Every usable one on
- * React Native is a native module — `@react-native-voice/voice`,
- * `expo-speech-recognition`, a vendor SDK — and a dependency here would
- * force native linking on every integrator, including the majority who
- * will never turn voice on. Worse, it would pick their engine for them:
- * the right one depends on the locale they need, whether recognition
- * may leave the device, and what their app store review already covers.
- *
- * So this is an interface and nothing else, injected the same way
- * `GeometryHost` and the `Alert` in `confirmedDestructiveAlert` are.
- * Pass an adapter and the mic button appears; pass nothing and
- * `resolveExperience` reports `input: 'voice'` as an unmet request
- * rather than rendering a button that does nothing.
- *
- * Everything here is transcription only. Playing audio back is not
- * modelled, because nothing in the loop produces audio.
- */
-/** What the SDK needs to run a hold-to-talk button. */
-interface SpeechHost {
-    /**
-     * Begin listening. Resolve once capture is actually running, so the
-     * UI can wait before telling the user to speak.
-     *
-     * Implementations own permissions: if the OS prompt has not been
-     * accepted, request it here and reject when refused.
-     */
-    start(options: SpeechStartOptions): Promise<void>;
-    /**
-     * Stop listening and resolve with the final transcript.
-     *
-     * Resolving with an empty string is the normal outcome for "the user
-     * pressed and said nothing" — it must not reject for that.
-     */
-    stop(): Promise<string>;
-    /** Abandon the capture. No transcript, no error. */
-    cancel(): Promise<void>;
-    /**
-     * Partial results while the user is still talking, if the engine has
-     * them. Return a disposer. Optional — a host without interim results
-     * simply shows the placeholder until `stop` resolves.
-     */
-    onPartial?(listener: (text: string) => void): () => void;
-}
-interface SpeechStartOptions {
-    /**
-     * BCP-47 tag resolved from the chat's locale, so a pt-BR chat does
-     * not transcribe against a US English model. Hosts that only support
-     * one locale may ignore it.
-     */
-    locale: string;
-}
-
 /**
  * Pure resolution for the chat's *experience* config — the knobs that
  * decide what the user sees WHILE the agent drives the app, and how a
@@ -985,6 +1012,11 @@ interface AppilotsStrings {
     statusWaitingApp: string;
     /** Status shown while the assistant adjusts after a recoverable failure. */
     statusAdjusting: string;
+    /**
+     * Periodic status on long turns (visible and announced to screen
+     * readers). `{seconds}` is replaced with the elapsed time.
+     */
+    stillWorking: string;
     /** Footer line shown when poweredByVisible !== false. */
     poweredBy: string;
     /** Approve button on a pending action row in the breadcrumb. */
@@ -1007,6 +1039,8 @@ interface AppilotsStrings {
     confirmCancel: string;
     /** Last-resort name for an action with no description of its own. */
     confirmThisAction: string;
+    /** Shown and announced when a pending confirmation can no longer be approved. */
+    confirmExpired: string;
     /** Fallback humanised name for an unknown action type. */
     unknownAction: string;
     /** Generic friendly error when nothing else fits. */
@@ -1047,6 +1081,10 @@ interface AppilotsStrings {
     missionPaused: string;
     /** Pill label after the turn ends, before the user opens the sheet. */
     pillDone: string;
+    /** Announced when the turn stops to wait for the user's approval. */
+    a11yAwaitingApproval: string;
+    /** Announced when a turn in which the agent acted on the app ends. */
+    a11yTurnDone: string;
     /** A11y label for the hold-to-talk mic button at rest. */
     micStartA11y: string;
     /** A11y label while a capture is running. */
@@ -1319,6 +1357,8 @@ interface AgentPillProps {
     state: BreadcrumbState;
     /** Tap anywhere on the pill — raises the full sheet. */
     onExpand: () => void;
+    /** The expand control — where a screen reader's focus returns when the sheet collapses. */
+    expandRef?: React__default.Ref<React__default.ElementRef<typeof TouchableOpacity>>;
     /**
      * Stop button. Omit to hide it — there is nothing to cancel once the
      * turn has ended, and a dead button on a one-line surface is worse
@@ -1344,7 +1384,7 @@ interface AgentPillProps {
     fontFamily?: string;
     strings: AgentPillStrings;
 }
-declare function AgentPill({ label, state, onExpand, onStop, position, insets, colors, fontFamily, strings, }: AgentPillProps): React__default.JSX.Element;
+declare function AgentPill({ label, state, onExpand, expandRef, onStop, position, insets, colors, fontFamily, strings, }: AgentPillProps): React__default.JSX.Element;
 
 /**
  * Is this control actually on the screen right now?
@@ -1418,6 +1458,10 @@ type GeometryAvailability =
  * `pointerEvents="none"` throughout. The ring marks a control the user
  * can still press themselves — swallowing that press to draw decoration
  * over it would defeat the point of leaving the app touchable.
+ *
+ * Being invisible to touch and to the accessibility tree, the ring says
+ * nothing to a screen reader. The chat speaks the same fact instead,
+ * from the store's announcement channel (`subscribeSpotlightAnnouncement`).
  */
 
 interface SpotlightOverlayProps {
@@ -1473,6 +1517,8 @@ interface SpotlightTarget {
     seq: number;
 }
 type Listener$2 = (target: SpotlightTarget | null) => void;
+/** What the agent does to the control — picks the verb of the spoken announcement. */
+type SpotlightVerb = 'press' | 'toggle' | 'focus' | 'fill';
 /**
  * How long a ring stays up after the action it marks.
  *
@@ -1491,7 +1537,7 @@ declare function getSpotlightMode(): SpotlightMode;
  * measurable, so the previous ring does not linger over an unrelated
  * control and imply the agent is aiming at it.
  */
-declare function setSpotlightTarget(rect: Rect | null, label?: string): void;
+declare function setSpotlightTarget(rect: Rect | null, label?: string, verb?: SpotlightVerb): void;
 declare function getSpotlightTarget(): SpotlightTarget | null;
 /** Subscribe. Returns the unsubscribe. Does NOT fire on subscribe. */
 declare function subscribeSpotlight(listener: Listener$2): () => void;
@@ -1748,6 +1794,8 @@ interface ConfirmCardStrings {
     confirmApprove: string;
     confirmCancel: string;
     confirmThisAction: string;
+    /** Optional so hosts that built this object before it existed keep compiling. */
+    confirmExpired?: string;
 }
 
 interface ActionBreadcrumbProps {
@@ -1781,8 +1829,13 @@ interface ActionBreadcrumbProps {
     /** Required when `requireApprovalFor` returns true for any action. */
     onApprove?: (actionId: string) => void;
     onReject?: (actionId: string) => void;
+    /**
+     * Called when a confirm card leaves the screen (answered, expired or
+     * dropped), so the chat can hand screen-reader focus back to the composer.
+     */
+    onConfirmCardGone?: () => void;
 }
-declare function ActionBreadcrumb({ actions, primaryColor, textColor, fontFamily, palette, confirmStrings, locale, requireApprovalFor, onApprove, onReject, }: ActionBreadcrumbProps): React__default.JSX.Element | null;
+declare function ActionBreadcrumb({ actions, primaryColor, textColor, fontFamily, palette, confirmStrings, locale, requireApprovalFor, onApprove, onReject, onConfirmCardGone, }: ActionBreadcrumbProps): React__default.JSX.Element | null;
 
 interface ChatIconProps {
     /** Outer width/height in points. Default 24. */
@@ -2655,6 +2708,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.13.0";
+declare const SDK_VERSION = "0.14.0";
 
-export { ActionBreadcrumb, type ActionBreadcrumbProps, type ActionResult, AgentAction, AgentPermissions, AgentPill, type AgentPillProps, type AgentPillStrings, type AppilotsButtonProps, AppilotsChat, type AppilotsChatMode, type AppilotsChatPosition, type AppilotsChatProps, type AppilotsChatTheme, type AppilotsControl, type AppilotsEntryPoint, AppilotsEvent, type AppilotsExperience, AppilotsI18nProvider, type AppilotsI18nProviderProps, type AppilotsInputMode, type AppilotsInputProps, AppilotsLocale, type AppilotsPresence, type AppilotsRC, AppilotsRegistryProvider, type AppilotsSelfCheckReport, type AppilotsSpotlight, type AppilotsStringKey, type AppilotsStrings, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, AppilotsThemeTokens, AppilotsTraceEntry, type AutoTrackingState, type BreadcrumbItem, type BreadcrumbState, type ButtonSnapshot, ChatIcon, type ChatIconProps, type ChoiceGroupSnapshot, type ChoiceOptionSnapshot, ComponentRegistry, ConfirmDialog, type ConfirmDialogProps, DEFAULT_EXPERIENCE, type ElementRegistry, type ExecutorContext, type ExperienceCapabilities, type ExperienceDowngrade, type ExperienceResolution, FieldEntry, HeadsetIcon, type HeadsetIconProps, type InputSnapshot, type InteractionElementEntry, type InteractionElementListContext, type InteractionElementSnapshot, type IntrospectionDiagnostics, type IntrospectionFailureReason, type ListEntry, type ListItemSnapshot, type ListRegistry, type ListSnapshot, type NameManglingProbe, PartialThemeTokens, type PillStatus, type PillStatusStrings, REVEAL_MARGIN, type ResolvedExperience, type RevealInput, type RevealResult, SDK_VERSION, SPOTLIGHT_TTL_MS, type ScreenSnapshot, type ScrollMetrics, type SelfCheckRegistry, type SelfCheckWalk, type SpotlightMode, SpotlightOverlay, type SpotlightOverlayProps, type SpotlightTarget, type SurfaceState, type TailwindResolvedConfig, type ToggleSnapshot, type TurnActivity, type WalkDetectorCounts, _patchJsxRuntimes, appilotsListTotal, appilotsSelfCheck, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, clearAppilotsDebugTraces, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, describeAction, detectDeviceLocale, elementRegistry, enableAppilotsAutoTracking, executeAction, formatDowngrades, getAppilotsDebugTraces, getAutoTrackingState, getGlobalConfig, getIntrospectionDiagnostics, getSpotlightMode, getSpotlightTarget, humanizeError, initAppilots, isAutoTrackingEnabled, listRegistry, offsetToReveal, recordAppilotsDebugTrace, resolveExperience, resolveLocale, resolvePillStatus, resolveSurface, revealTarget, setSpotlightMode, setSpotlightTarget, shouldReopenOnTurnEnd, subscribeAppilotsDebugTraces, subscribeSpotlight, useAppilotsI18n, useAppilotsTheme, useResolvedRegistry, useSpotlight, usesPill };
+export { ActionBreadcrumb, type ActionBreadcrumbProps, type ActionResult, AgentAction, AgentPermissions, AgentPill, type AgentPillProps, type AgentPillStrings, type AppilotsButtonProps, AppilotsChat, type AppilotsChatMode, type AppilotsChatPosition, type AppilotsChatProps, type AppilotsChatTheme, type AppilotsControl, type AppilotsEntryPoint, AppilotsEvent, type AppilotsExperience, AppilotsI18nProvider, type AppilotsI18nProviderProps, type AppilotsInputMode, type AppilotsInputProps, AppilotsLocale, type AppilotsPresence, type AppilotsRC, AppilotsRegistryProvider, type AppilotsSelfCheckReport, type AppilotsSpotlight, type AppilotsStringKey, type AppilotsStrings, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, AppilotsThemeTokens, AppilotsTraceEntry, type AutoTrackingState, type BreadcrumbItem, type BreadcrumbState, type ButtonSnapshot, ChatIcon, type ChatIconProps, type ChoiceGroupSnapshot, type ChoiceOptionSnapshot, ComponentRegistry, ConfirmDialog, type ConfirmDialogProps, DEFAULT_EXPERIENCE, type ElementRegistry, type ExecutorContext, type ExperienceCapabilities, type ExperienceDowngrade, type ExperienceResolution, FieldEntry, HeadsetIcon, type HeadsetIconProps, type InputSnapshot, type InteractionElementEntry, type InteractionElementListContext, type InteractionElementSnapshot, type IntrospectionDiagnostics, type IntrospectionFailureReason, type ListEntry, type ListItemSnapshot, type ListRegistry, type ListSnapshot, type NameManglingProbe, PartialThemeTokens, type PillStatus, type PillStatusStrings, REVEAL_MARGIN, type ResolvedExperience, type RevealInput, type RevealResult, SDK_VERSION, SPOTLIGHT_TTL_MS, type ScreenSnapshot, type ScrollMetrics, type SelfCheckRegistry, type SelfCheckWalk, type SpeechHost, type SpeechStartOptions, type SpeechState, type SpotlightMode, SpotlightOverlay, type SpotlightOverlayProps, type SpotlightTarget, type SurfaceState, type TailwindResolvedConfig, type ToggleSnapshot, type TurnActivity, type WalkDetectorCounts, _patchJsxRuntimes, appilotsListTotal, appilotsSelfCheck, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, clearAppilotsDebugTraces, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, describeAction, detectDeviceLocale, elementRegistry, enableAppilotsAutoTracking, executeAction, formatDowngrades, getAppilotsDebugTraces, getAutoTrackingState, getGlobalConfig, getIntrospectionDiagnostics, getSpotlightMode, getSpotlightTarget, humanizeError, initAppilots, isAutoTrackingEnabled, isSpeechHost, listRegistry, offsetToReveal, recordAppilotsDebugTrace, resolveExperience, resolveLocale, resolvePillStatus, resolveSurface, revealTarget, setSpotlightMode, setSpotlightTarget, shouldReopenOnTurnEnd, subscribeAppilotsDebugTraces, subscribeSpotlight, useAppilotsI18n, useAppilotsTheme, useResolvedRegistry, useSpotlight, usesPill };

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-import { A as AppilotsTraceEntry, a as AgentAction, b as AppilotsLocale, P as PartialThemeTokens, c as AppilotsThemeTokens, C as ComponentRegistry, d as AppilotsSessionStorage, e as AgentPermissions, F as FieldEntry, f as AppilotsEvent } from './index-CI4jmSoP.js';
-export { g as AgentActionType, h as AgentMessage, i as AppilotsClient, j as AppilotsClientOptions, k as AppilotsConfig, l as AppilotsElementProps, m as AppilotsEventHandler, n as AppilotsEventType, o as AppilotsProvider, p as AppilotsProviderProps, q as AppilotsUser, r as ChatMessage, s as ComponentEntry, t as ComponentKind, E as EscalationState, u as FormFillPayload, M as MessageRole, N as NavigationPayload, R as RateLimitedError, v as RemotePersonalization, S as SliderEntry, w as SuggestedPrompt, T as TargetEntry, x as ToggleEntry, U as UIInteractionPayload, y as UseAppilotsFieldOptions, z as UseAppilotsSliderOptions, B as UseAppilotsTargetOptions, D as UseAppilotsToggleOptions, G as UseSuggestedPromptsOptions, H as UseSuggestedPromptsReturn, I as componentRegistry, J as createComponentRegistry, K as defaultDarkTheme, L as defaultLightTheme, O as mergeThemeTokens, Q as useAppilots, V as useAppilotsActions, W as useAppilotsChat, X as useAppilotsContext, Y as useAppilotsField, Z as useAppilotsNavigation, _ as useAppilotsSlider, $ as useAppilotsTarget, a0 as useAppilotsToggle, a1 as useSuggestedPrompts } from './index-CI4jmSoP.js';
+import { A as AppilotsTraceEntry, a as AgentAction, b as AppilotsLocale, P as PartialThemeTokens, c as AppilotsThemeTokens, C as ComponentRegistry, d as AppilotsSessionStorage, e as AgentPermissions, F as FieldEntry, f as AppilotsEvent } from './index-wMMetyrj.js';
+export { g as AgentActionType, h as AgentMessage, i as AppilotsClient, j as AppilotsClientOptions, k as AppilotsConfig, l as AppilotsElementProps, m as AppilotsEventHandler, n as AppilotsEventType, o as AppilotsProvider, p as AppilotsProviderProps, q as AppilotsUser, r as ChatMessage, s as ComponentEntry, t as ComponentKind, E as EscalationState, u as FormFillPayload, M as MessageRole, N as NavigationPayload, R as RateLimitedError, v as RemotePersonalization, S as SliderEntry, w as SuggestedPrompt, T as TargetEntry, x as ToggleEntry, U as UIInteractionPayload, y as UseAppilotsFieldOptions, z as UseAppilotsSliderOptions, B as UseAppilotsTargetOptions, D as UseAppilotsToggleOptions, G as UseSuggestedPromptsOptions, H as UseSuggestedPromptsReturn, I as componentRegistry, J as createComponentRegistry, K as defaultDarkTheme, L as defaultLightTheme, O as mergeThemeTokens, Q as useAppilots, V as useAppilotsActions, W as useAppilotsChat, X as useAppilotsContext, Y as useAppilotsField, Z as useAppilotsNavigation, _ as useAppilotsSlider, $ as useAppilotsTarget, a0 as useAppilotsToggle, a1 as useSuggestedPrompts } from './index-wMMetyrj.js';
 import * as React$1 from 'react';
 import React__default from 'react';
+import { TouchableOpacity } from 'react-native';
 export { AppilotsNavigationContainer, NavigationConfig, ScreenMetadata, registerScreen, setCurrentScreen } from './navigation/index.js';
 
 /** Source facts, not an executable locator or proof of a business outcome. */
@@ -22,6 +23,87 @@ interface ControlEvidence {
 
 type ActionPresentationState = 'pending' | 'running' | 'success' | 'failed';
 
+/**
+ * The speech seam.
+ *
+ * The SDK ships no speech engine and never will. Every usable one on
+ * React Native is a native module — `@react-native-voice/voice`,
+ * `expo-speech-recognition`, a vendor SDK — and a dependency here would
+ * force native linking on every integrator, including the majority who
+ * will never turn voice on. Worse, it would pick their engine for them:
+ * the right one depends on the locale they need, whether recognition
+ * may leave the device, and what their app store review already covers.
+ *
+ * So this is an interface and nothing else, injected the same way
+ * `GeometryHost` and the `Alert` in `confirmedDestructiveAlert` are.
+ * Pass an adapter and the mic button appears; pass nothing and
+ * `resolveExperience` reports `input: 'voice'` as an unmet request
+ * rather than rendering a button that does nothing.
+ *
+ * It lives in client-core because the web SDK takes the same contract:
+ * its built-in Web Speech engine is one implementation of it, and a
+ * host that needs recognition to stay on-device (or a vendor engine)
+ * passes its own.
+ *
+ * Everything here is transcription only. Playing audio back is not
+ * modelled, because nothing in the loop produces audio.
+ */
+/** What the SDK needs to run a mic button (hold-to-talk or toggle). */
+interface SpeechHost {
+    /**
+     * Begin listening. Resolve once capture is actually running, so the
+     * UI can wait before telling the user to speak.
+     *
+     * Implementations own permissions: if the OS prompt has not been
+     * accepted, request it here and reject when refused.
+     */
+    start(options: SpeechStartOptions): Promise<void>;
+    /**
+     * Stop listening and resolve with the final transcript.
+     *
+     * Resolving with an empty string is the normal outcome for "the user
+     * pressed and said nothing" — it must not reject for that.
+     */
+    stop(): Promise<string>;
+    /** Abandon the capture. No transcript, no error. */
+    cancel(): Promise<void>;
+    /**
+     * Partial results while the user is still talking, if the engine has
+     * them. Return a disposer. Optional — a host without interim results
+     * simply shows the placeholder until `stop` resolves.
+     */
+    onPartial?(listener: (text: string) => void): () => void;
+    /**
+     * The engine ended the capture on its own — silence timeout, lost
+     * permission, network — without `stop` or `cancel` being called.
+     * `error` is set when it ended by failure. Return a disposer.
+     *
+     * Optional, but without it a UI cannot leave `listening` until the
+     * user presses again: the button would claim to record while the
+     * engine is not.
+     */
+    onEnd?(listener: (error?: unknown) => void): () => void;
+}
+interface SpeechStartOptions {
+    /**
+     * BCP-47 tag resolved from the chat's locale, so a pt-BR chat does
+     * not transcribe against a US English model. Hosts that only support
+     * one locale may ignore it.
+     */
+    locale: string;
+}
+/** Where a mic button is in its cycle. */
+type SpeechState = 'idle' | 'starting' | 'listening' | 'stopping' | 'error';
+/**
+ * Is this object usable as a host?
+ *
+ * Checked at the boundary rather than trusted from the type, because
+ * the value crosses from the host app's JavaScript — where it may have
+ * come from a config file, a lazy import that failed, or a version of
+ * an adapter predating a method.
+ */
+declare function isSpeechHost(value: unknown): value is SpeechHost;
+
 /**
  * Snapshot types — the platform-agnostic "view model" of what the user
  * is currently seeing on screen, sent to the AI agent so it has
@@ -710,61 +792,6 @@ declare function humanizeError(raw: string | undefined, _action?: AgentAction):
  */
 type AppilotsChatPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
 
-/**
- * The speech seam.
- *
- * The SDK ships no speech engine and never will. Every usable one on
- * React Native is a native module — `@react-native-voice/voice`,
- * `expo-speech-recognition`, a vendor SDK — and a dependency here would
- * force native linking on every integrator, including the majority who
- * will never turn voice on. Worse, it would pick their engine for them:
- * the right one depends on the locale they need, whether recognition
- * may leave the device, and what their app store review already covers.
- *
- * So this is an interface and nothing else, injected the same way
- * `GeometryHost` and the `Alert` in `confirmedDestructiveAlert` are.
- * Pass an adapter and the mic button appears; pass nothing and
- * `resolveExperience` reports `input: 'voice'` as an unmet request
- * rather than rendering a button that does nothing.
- *
- * Everything here is transcription only. Playing audio back is not
- * modelled, because nothing in the loop produces audio.
- */
-/** What the SDK needs to run a hold-to-talk button. */
-interface SpeechHost {
-    /**
-     * Begin listening. Resolve once capture is actually running, so the
-     * UI can wait before telling the user to speak.
-     *
-     * Implementations own permissions: if the OS prompt has not been
-     * accepted, request it here and reject when refused.
-     */
-    start(options: SpeechStartOptions): Promise<void>;
-    /**
-     * Stop listening and resolve with the final transcript.
-     *
-     * Resolving with an empty string is the normal outcome for "the user
-     * pressed and said nothing" — it must not reject for that.
-     */
-    stop(): Promise<string>;
-    /** Abandon the capture. No transcript, no error. */
-    cancel(): Promise<void>;
-    /**
-     * Partial results while the user is still talking, if the engine has
-     * them. Return a disposer. Optional — a host without interim results
-     * simply shows the placeholder until `stop` resolves.
-     */
-    onPartial?(listener: (text: string) => void): () => void;
-}
-interface SpeechStartOptions {
-    /**
-     * BCP-47 tag resolved from the chat's locale, so a pt-BR chat does
-     * not transcribe against a US English model. Hosts that only support
-     * one locale may ignore it.
-     */
-    locale: string;
-}
-
 /**
  * Pure resolution for the chat's *experience* config — the knobs that
  * decide what the user sees WHILE the agent drives the app, and how a
@@ -985,6 +1012,11 @@ interface AppilotsStrings {
     statusWaitingApp: string;
     /** Status shown while the assistant adjusts after a recoverable failure. */
     statusAdjusting: string;
+    /**
+     * Periodic status on long turns (visible and announced to screen
+     * readers). `{seconds}` is replaced with the elapsed time.
+     */
+    stillWorking: string;
     /** Footer line shown when poweredByVisible !== false. */
     poweredBy: string;
     /** Approve button on a pending action row in the breadcrumb. */
@@ -1007,6 +1039,8 @@ interface AppilotsStrings {
     confirmCancel: string;
     /** Last-resort name for an action with no description of its own. */
     confirmThisAction: string;
+    /** Shown and announced when a pending confirmation can no longer be approved. */
+    confirmExpired: string;
     /** Fallback humanised name for an unknown action type. */
     unknownAction: string;
     /** Generic friendly error when nothing else fits. */
@@ -1047,6 +1081,10 @@ interface AppilotsStrings {
     missionPaused: string;
     /** Pill label after the turn ends, before the user opens the sheet. */
     pillDone: string;
+    /** Announced when the turn stops to wait for the user's approval. */
+    a11yAwaitingApproval: string;
+    /** Announced when a turn in which the agent acted on the app ends. */
+    a11yTurnDone: string;
     /** A11y label for the hold-to-talk mic button at rest. */
     micStartA11y: string;
     /** A11y label while a capture is running. */
@@ -1319,6 +1357,8 @@ interface AgentPillProps {
     state: BreadcrumbState;
     /** Tap anywhere on the pill — raises the full sheet. */
     onExpand: () => void;
+    /** The expand control — where a screen reader's focus returns when the sheet collapses. */
+    expandRef?: React__default.Ref<React__default.ElementRef<typeof TouchableOpacity>>;
     /**
      * Stop button. Omit to hide it — there is nothing to cancel once the
      * turn has ended, and a dead button on a one-line surface is worse
@@ -1344,7 +1384,7 @@ interface AgentPillProps {
     fontFamily?: string;
     strings: AgentPillStrings;
 }
-declare function AgentPill({ label, state, onExpand, onStop, position, insets, colors, fontFamily, strings, }: AgentPillProps): React__default.JSX.Element;
+declare function AgentPill({ label, state, onExpand, expandRef, onStop, position, insets, colors, fontFamily, strings, }: AgentPillProps): React__default.JSX.Element;
 
 /**
  * Is this control actually on the screen right now?
@@ -1418,6 +1458,10 @@ type GeometryAvailability =
  * `pointerEvents="none"` throughout. The ring marks a control the user
  * can still press themselves — swallowing that press to draw decoration
  * over it would defeat the point of leaving the app touchable.
+ *
+ * Being invisible to touch and to the accessibility tree, the ring says
+ * nothing to a screen reader. The chat speaks the same fact instead,
+ * from the store's announcement channel (`subscribeSpotlightAnnouncement`).
  */
 
 interface SpotlightOverlayProps {
@@ -1473,6 +1517,8 @@ interface SpotlightTarget {
     seq: number;
 }
 type Listener$2 = (target: SpotlightTarget | null) => void;
+/** What the agent does to the control — picks the verb of the spoken announcement. */
+type SpotlightVerb = 'press' | 'toggle' | 'focus' | 'fill';
 /**
  * How long a ring stays up after the action it marks.
  *
@@ -1491,7 +1537,7 @@ declare function getSpotlightMode(): SpotlightMode;
  * measurable, so the previous ring does not linger over an unrelated
  * control and imply the agent is aiming at it.
  */
-declare function setSpotlightTarget(rect: Rect | null, label?: string): void;
+declare function setSpotlightTarget(rect: Rect | null, label?: string, verb?: SpotlightVerb): void;
 declare function getSpotlightTarget(): SpotlightTarget | null;
 /** Subscribe. Returns the unsubscribe. Does NOT fire on subscribe. */
 declare function subscribeSpotlight(listener: Listener$2): () => void;
@@ -1748,6 +1794,8 @@ interface ConfirmCardStrings {
     confirmApprove: string;
     confirmCancel: string;
     confirmThisAction: string;
+    /** Optional so hosts that built this object before it existed keep compiling. */
+    confirmExpired?: string;
 }
 
 interface ActionBreadcrumbProps {
@@ -1781,8 +1829,13 @@ interface ActionBreadcrumbProps {
     /** Required when `requireApprovalFor` returns true for any action. */
     onApprove?: (actionId: string) => void;
     onReject?: (actionId: string) => void;
+    /**
+     * Called when a confirm card leaves the screen (answered, expired or
+     * dropped), so the chat can hand screen-reader focus back to the composer.
+     */
+    onConfirmCardGone?: () => void;
 }
-declare function ActionBreadcrumb({ actions, primaryColor, textColor, fontFamily, palette, confirmStrings, locale, requireApprovalFor, onApprove, onReject, }: ActionBreadcrumbProps): React__default.JSX.Element | null;
+declare function ActionBreadcrumb({ actions, primaryColor, textColor, fontFamily, palette, confirmStrings, locale, requireApprovalFor, onApprove, onReject, onConfirmCardGone, }: ActionBreadcrumbProps): React__default.JSX.Element | null;
 
 interface ChatIconProps {
     /** Outer width/height in points. Default 24. */
@@ -2655,6 +2708,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.13.0";
+declare const SDK_VERSION = "0.14.0";
 
-export { ActionBreadcrumb, type ActionBreadcrumbProps, type ActionResult, AgentAction, AgentPermissions, AgentPill, type AgentPillProps, type AgentPillStrings, type AppilotsButtonProps, AppilotsChat, type AppilotsChatMode, type AppilotsChatPosition, type AppilotsChatProps, type AppilotsChatTheme, type AppilotsControl, type AppilotsEntryPoint, AppilotsEvent, type AppilotsExperience, AppilotsI18nProvider, type AppilotsI18nProviderProps, type AppilotsInputMode, type AppilotsInputProps, AppilotsLocale, type AppilotsPresence, type AppilotsRC, AppilotsRegistryProvider, type AppilotsSelfCheckReport, type AppilotsSpotlight, type AppilotsStringKey, type AppilotsStrings, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, AppilotsThemeTokens, AppilotsTraceEntry, type AutoTrackingState, type BreadcrumbItem, type BreadcrumbState, type ButtonSnapshot, ChatIcon, type ChatIconProps, type ChoiceGroupSnapshot, type ChoiceOptionSnapshot, ComponentRegistry, ConfirmDialog, type ConfirmDialogProps, DEFAULT_EXPERIENCE, type ElementRegistry, type ExecutorContext, type ExperienceCapabilities, type ExperienceDowngrade, type ExperienceResolution, FieldEntry, HeadsetIcon, type HeadsetIconProps, type InputSnapshot, type InteractionElementEntry, type InteractionElementListContext, type InteractionElementSnapshot, type IntrospectionDiagnostics, type IntrospectionFailureReason, type ListEntry, type ListItemSnapshot, type ListRegistry, type ListSnapshot, type NameManglingProbe, PartialThemeTokens, type PillStatus, type PillStatusStrings, REVEAL_MARGIN, type ResolvedExperience, type RevealInput, type RevealResult, SDK_VERSION, SPOTLIGHT_TTL_MS, type ScreenSnapshot, type ScrollMetrics, type SelfCheckRegistry, type SelfCheckWalk, type SpotlightMode, SpotlightOverlay, type SpotlightOverlayProps, type SpotlightTarget, type SurfaceState, type TailwindResolvedConfig, type ToggleSnapshot, type TurnActivity, type WalkDetectorCounts, _patchJsxRuntimes, appilotsListTotal, appilotsSelfCheck, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, clearAppilotsDebugTraces, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, describeAction, detectDeviceLocale, elementRegistry, enableAppilotsAutoTracking, executeAction, formatDowngrades, getAppilotsDebugTraces, getAutoTrackingState, getGlobalConfig, getIntrospectionDiagnostics, getSpotlightMode, getSpotlightTarget, humanizeError, initAppilots, isAutoTrackingEnabled, listRegistry, offsetToReveal, recordAppilotsDebugTrace, resolveExperience, resolveLocale, resolvePillStatus, resolveSurface, revealTarget, setSpotlightMode, setSpotlightTarget, shouldReopenOnTurnEnd, subscribeAppilotsDebugTraces, subscribeSpotlight, useAppilotsI18n, useAppilotsTheme, useResolvedRegistry, useSpotlight, usesPill };
+export { ActionBreadcrumb, type ActionBreadcrumbProps, type ActionResult, AgentAction, AgentPermissions, AgentPill, type AgentPillProps, type AgentPillStrings, type AppilotsButtonProps, AppilotsChat, type AppilotsChatMode, type AppilotsChatPosition, type AppilotsChatProps, type AppilotsChatTheme, type AppilotsControl, type AppilotsEntryPoint, AppilotsEvent, type AppilotsExperience, AppilotsI18nProvider, type AppilotsI18nProviderProps, type AppilotsInputMode, type AppilotsInputProps, AppilotsLocale, type AppilotsPresence, type AppilotsRC, AppilotsRegistryProvider, type AppilotsSelfCheckReport, type AppilotsSpotlight, type AppilotsStringKey, type AppilotsStrings, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, AppilotsThemeTokens, AppilotsTraceEntry, type AutoTrackingState, type BreadcrumbItem, type BreadcrumbState, type ButtonSnapshot, ChatIcon, type ChatIconProps, type ChoiceGroupSnapshot, type ChoiceOptionSnapshot, ComponentRegistry, ConfirmDialog, type ConfirmDialogProps, DEFAULT_EXPERIENCE, type ElementRegistry, type ExecutorContext, type ExperienceCapabilities, type ExperienceDowngrade, type ExperienceResolution, FieldEntry, HeadsetIcon, type HeadsetIconProps, type InputSnapshot, type InteractionElementEntry, type InteractionElementListContext, type InteractionElementSnapshot, type IntrospectionDiagnostics, type IntrospectionFailureReason, type ListEntry, type ListItemSnapshot, type ListRegistry, type ListSnapshot, type NameManglingProbe, PartialThemeTokens, type PillStatus, type PillStatusStrings, REVEAL_MARGIN, type ResolvedExperience, type RevealInput, type RevealResult, SDK_VERSION, SPOTLIGHT_TTL_MS, type ScreenSnapshot, type ScrollMetrics, type SelfCheckRegistry, type SelfCheckWalk, type SpeechHost, type SpeechStartOptions, type SpeechState, type SpotlightMode, SpotlightOverlay, type SpotlightOverlayProps, type SpotlightTarget, type SurfaceState, type TailwindResolvedConfig, type ToggleSnapshot, type TurnActivity, type WalkDetectorCounts, _patchJsxRuntimes, appilotsListTotal, appilotsSelfCheck, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, clearAppilotsDebugTraces, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, describeAction, detectDeviceLocale, elementRegistry, enableAppilotsAutoTracking, executeAction, formatDowngrades, getAppilotsDebugTraces, getAutoTrackingState, getGlobalConfig, getIntrospectionDiagnostics, getSpotlightMode, getSpotlightTarget, humanizeError, initAppilots, isAutoTrackingEnabled, isSpeechHost, listRegistry, offsetToReveal, recordAppilotsDebugTrace, resolveExperience, resolveLocale, resolvePillStatus, resolveSurface, revealTarget, setSpotlightMode, setSpotlightTarget, shouldReopenOnTurnEnd, subscribeAppilotsDebugTraces, subscribeSpotlight, useAppilotsI18n, useAppilotsTheme, useResolvedRegistry, useSpotlight, usesPill };