@appilots/sdk 0.2.0 → 0.3.0

package/dist/index.d.mts

@@ -1,7 +1,9 @@
-import { P as PartialThemeTokens, A as AppilotsThemeTokens, a as AppilotsLocale, b as AgentAction, C as ComponentRegistry, c as AgentPermissions, d as AppilotsTraceEntry, F as FieldEntry, e as AppilotsEvent } from './index-BDb1WVNo.mjs';
-export { f as AgentActionType, g as AgentMessage, h as AppilotsClient, i as AppilotsClientOptions, j as AppilotsConfig, k as AppilotsEventHandler, l as AppilotsEventType, m as AppilotsI18nProvider, n as AppilotsI18nProviderProps, o as AppilotsProvider, p as AppilotsProviderProps, q as AppilotsStringKey, r as AppilotsStrings, s as AppilotsUser, t as ChatMessage, u as ComponentEntry, v as ComponentKind, E as EscalationState, w as FormFillPayload, M as MessageRole, N as NavigationPayload, R as RemotePersonalization, S as SliderEntry, x as SuggestedPrompt, T as TargetEntry, y as ToggleEntry, U as UIInteractionPayload, z as UseAppilotsFieldOptions, B as UseAppilotsSliderOptions, D as UseAppilotsTargetOptions, G as UseAppilotsToggleOptions, H as UseSuggestedPromptsOptions, I as UseSuggestedPromptsReturn, J as componentRegistry, K as createComponentRegistry, L as defaultDarkTheme, O as defaultLightTheme, Q as detectDeviceLocale, V as mergeThemeTokens, W as resolveLocale, X as useAppilots, Y as useAppilotsActions, Z as useAppilotsChat, _ as useAppilotsContext, $ as useAppilotsField, a0 as useAppilotsI18n, a1 as useAppilotsNavigation, a2 as useAppilotsSlider, a3 as useAppilotsTarget, a4 as useAppilotsToggle, a5 as useSuggestedPrompts } from './index-BDb1WVNo.mjs';
+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 * 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 {
@@ -78,6 +80,110 @@ declare const appilotsTheme: {
     fromTailwind: typeof appilotsThemeFromTailwind;
 };
 
+/**
+ * i18n keys — the canonical list of every translatable string in the
+ * SDK chat UI. Adding UI copy means adding a key here AND a value in
+ * every bundle under `./bundles/` (TypeScript will fail the bundle if a
+ * key is missing). BACKLOG 4.1.
+ */
+interface AppilotsStrings {
+    /** Default chat header title when the dev hasn't supplied one. */
+    chatTitle: string;
+    /** Header button that wipes the conversation. */
+    clearButton: string;
+    /** Placeholder for the message input. */
+    inputPlaceholder: string;
+    /** Empty state heading. */
+    emptyTitle: string;
+    /** Empty state subtitle / one-liner under the heading. */
+    emptySubtitle: string;
+    /** "Thinking..." placeholder shown while the assistant is replying. */
+    thinking: string;
+    /** Status shown while the assistant is planning from the current screen. */
+    statusAnalyzing: string;
+    /** Status shown while the SDK waits for the app to settle after an action. */
+    statusWaitingApp: string;
+    /** Status shown while the assistant adjusts after a recoverable failure. */
+    statusAdjusting: string;
+    /** Footer line shown when poweredByVisible !== false. */
+    poweredBy: string;
+    /** Approve button on a pending action row in the breadcrumb. */
+    approve: string;
+    /** Reject button on a pending action row in the breadcrumb. */
+    reject: string;
+    /** Generic "cancelled by the user" message after a reject. */
+    cancelledByUser: string;
+    /** Fallback humanised name for an unknown action type. */
+    unknownAction: string;
+    /** Generic friendly error when nothing else fits. */
+    somethingWentWrong: string;
+    /** Open chat accessibility label for the floating bubble. */
+    openChatA11y: string;
+    /** Close chat accessibility label. */
+    closeChatA11y: string;
+    /** A11y label for the stop-generation button (OKR-008 KR4). */
+    stopGeneratingA11y: string;
+    /** A11y label for the "talk to a human" header button. */
+    talkToHumanA11y: string;
+    /** Sender label above a human operator's bubble. */
+    humanAgentLabel: string;
+    /** System line right after the user (or the offer chip) escalates. */
+    escalationRequested: string;
+    /** System line when an operator claims the conversation. */
+    escalationConnected: string;
+    /** System line when the operator resolves — AI takes over again. */
+    escalationResolved: string;
+    /** System line offering the handoff after the agent gives up. */
+    escalationOffer: string;
+    /** Label of the tappable chip under the offer line. */
+    escalationOfferChip: string;
+    /** Thin banner under the header while waiting in the queue. */
+    escalationPendingBanner: string;
+    /** Thin banner under the header while connected to an operator. */
+    escalationActiveBanner: string;
+}
+type AppilotsStringKey = keyof AppilotsStrings;
+
+/**
+ * Best-effort device-locale detection. Returns the closest supported
+ * locale or `null` if we can't tell. Designed to never throw — RN's
+ * native modules are platform-specific and can be missing in test
+ * harnesses.
+ */
+declare function detectDeviceLocale(): AppilotsLocale | null;
+/**
+ * Resolve the locale to use given the prop and the device default.
+ * Order: explicit prop → device-detected → DEFAULT_LOCALE.
+ */
+declare function resolveLocale(prop?: AppilotsLocale | null): AppilotsLocale;
+interface I18nContextValue {
+    locale: AppilotsLocale;
+    strings: AppilotsStrings;
+    /**
+     * Helper to read a single key. Components can also destructure
+     * `strings` directly if they need many in one render.
+     */
+    t: (key: AppilotsStringKey) => string;
+}
+interface AppilotsI18nProviderProps {
+    /** Force a locale. Falls through to device detection when omitted. */
+    locale?: AppilotsLocale | null;
+    /**
+     * Per-key overrides to merge on top of the bundle. Useful when the
+     * dev wants to rename only "Powered by Appilots" while keeping the
+     * rest in the default language.
+     */
+    overrides?: Partial<AppilotsStrings> | null;
+    children: React__default.ReactNode;
+}
+declare function AppilotsI18nProvider({ locale, overrides, children, }: AppilotsI18nProviderProps): React__default.JSX.Element;
+/**
+ * Read the locale + strings from context. Falls back to the default
+ * locale bundle if no provider is mounted, so components don't need a
+ * provider to be safe — they just lose the dev's overrides.
+ */
+declare function useAppilotsI18n(): I18nContextValue;
+
 /**
  * Layout modes for the chat (BACKLOG 4.1).
  *  - `bubble`     — floating action button + bottom sheet modal (default)
@@ -218,52 +324,6 @@ interface ConfirmDialogProps {
 /** @deprecated No-op. See file header. */
 declare function ConfirmDialog(_props?: ConfirmDialogProps): React__default.ReactElement | null;
 
-/**
- * Human-readable labels and error messages for the action breadcrumb.
- *
- * Strings are PT-BR hardcoded for now. i18n is planned for backlog item
- * 4.1 (Personalização) — when that lands, these strings move into the
- * locale bundles.
- *
- * Two responsibilities:
- *   1. `describeAction(action)` — turns a typed AgentAction into a label
- *      that varies by lifecycle state (pending/running/done/failed).
- *   2. `humanizeError(raw, action)` — sanitises the raw error string from
- *      the executor into a short user-facing reason. Stack traces and
- *      protocol errors are collapsed into "algo deu errado" so users
- *      aren't shown technical noise.
- */
-
-type BreadcrumbState = 'pending' | 'running' | 'success' | 'failed';
-interface BreadcrumbItem {
-    /** What to render on the line. */
-    label: string;
-    /** Lifecycle state — drives icon + colour in the breadcrumb. */
-    state: BreadcrumbState;
-}
-/**
- * Map an AgentAction + its current status to a breadcrumb item ready to
- * render. The function is intentionally defensive — both the native-tools
- * and JSON-fallback code paths feed actions through here, and the JSON
- * path is loose with payload shapes, so every field access has to assume
- * `unknown`.
- */
-declare function describeAction(action: AgentAction): BreadcrumbItem;
-/**
- * Convert the executor's raw error string into a short, user-facing
- * reason that fits inside parentheses on the breadcrumb line. Returns
- * `undefined` when there's no useful information to show — caller can
- * then drop the parenthetical entirely.
- *
- * Heuristics:
- *   - Apply known-pattern rewrites (rejected, not found, network, etc.)
- *   - If the result looks technical (stack frame, HTTP status, JSON
- *     dump) or is suspiciously long, fall back to "algo deu errado".
- *   - Trim and lowercase the first letter so it reads naturally inside
- *     the parens after the action verb.
- */
-declare function humanizeError(raw: string | undefined, _action?: AgentAction): string | undefined;
-
 /**
  * Pure presentation logic for ActionBreadcrumb, extracted from the RN
  * component (same pattern as `humanizeAction.ts` / `chatTimeline.ts`)
@@ -900,14 +960,6 @@ declare function _patchJsxRuntimes(jsxRuntime: any, jsxDevRuntime: any): void;
  */
 declare function isAutoTrackingEnabled(): boolean;
 
-type TraceListener = (entries: AppilotsTraceEntry[]) => void;
-declare function recordAppilotsDebugTrace(entry: Omit<AppilotsTraceEntry, 'id'> & {
-    id?: string;
-}): void;
-declare function getAppilotsDebugTraces(): AppilotsTraceEntry[];
-declare function clearAppilotsDebugTraces(): void;
-declare function subscribeAppilotsDebugTraces(listener: TraceListener): () => void;
-
 /**
  * captureSnapshot — the public entry point for runtime UI introspection.
  *
@@ -1146,11 +1198,4 @@ interface ExecutorContext {
 }
 declare function executeAction(action: AgentAction, context: ExecutorContext): Promise<ActionResult>;
 
-/**
- * SDK version — bumped by changesets on release. Lives in its own module
- * so runtime code (AppilotsClient) can import it without pulling the whole
- * public barrel in and creating an import cycle.
- */
-declare const SDK_VERSION = "0.1.0";
-
-export { ActionBreadcrumb, type ActionBreadcrumbProps, type ActionResult, AgentAction, AgentPermissions, type AppilotsButtonProps, AppilotsChat, type AppilotsChatMode, type AppilotsChatPosition, type AppilotsChatProps, type AppilotsChatTheme, AppilotsEvent, type AppilotsInputProps, AppilotsLocale, type AppilotsRC, AppilotsRegistryProvider, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, AppilotsThemeTokens, AppilotsTraceEntry, type BreadcrumbItem, type BreadcrumbState, 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, PartialThemeTokens, SDK_VERSION, type ScreenSnapshot, type TailwindResolvedConfig, type ToggleSnapshot, _patchJsxRuntimes, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, clearAppilotsDebugTraces, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, describeAction, elementRegistry, enableAppilotsAutoTracking, executeAction, getAppilotsDebugTraces, getGlobalConfig, humanizeError, initAppilots, isAutoTrackingEnabled, listRegistry, recordAppilotsDebugTrace, subscribeAppilotsDebugTraces, useAppilotsTheme, useResolvedRegistry };
+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 };

package/dist/index.d.ts

@@ -1,7 +1,9 @@
-import { P as PartialThemeTokens, A as AppilotsThemeTokens, a as AppilotsLocale, b as AgentAction, C as ComponentRegistry, c as AgentPermissions, d as AppilotsTraceEntry, F as FieldEntry, e as AppilotsEvent } from './index-BDb1WVNo.js';
-export { f as AgentActionType, g as AgentMessage, h as AppilotsClient, i as AppilotsClientOptions, j as AppilotsConfig, k as AppilotsEventHandler, l as AppilotsEventType, m as AppilotsI18nProvider, n as AppilotsI18nProviderProps, o as AppilotsProvider, p as AppilotsProviderProps, q as AppilotsStringKey, r as AppilotsStrings, s as AppilotsUser, t as ChatMessage, u as ComponentEntry, v as ComponentKind, E as EscalationState, w as FormFillPayload, M as MessageRole, N as NavigationPayload, R as RemotePersonalization, S as SliderEntry, x as SuggestedPrompt, T as TargetEntry, y as ToggleEntry, U as UIInteractionPayload, z as UseAppilotsFieldOptions, B as UseAppilotsSliderOptions, D as UseAppilotsTargetOptions, G as UseAppilotsToggleOptions, H as UseSuggestedPromptsOptions, I as UseSuggestedPromptsReturn, J as componentRegistry, K as createComponentRegistry, L as defaultDarkTheme, O as defaultLightTheme, Q as detectDeviceLocale, V as mergeThemeTokens, W as resolveLocale, X as useAppilots, Y as useAppilotsActions, Z as useAppilotsChat, _ as useAppilotsContext, $ as useAppilotsField, a0 as useAppilotsI18n, a1 as useAppilotsNavigation, a2 as useAppilotsSlider, a3 as useAppilotsTarget, a4 as useAppilotsToggle, a5 as useSuggestedPrompts } from './index-BDb1WVNo.js';
+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 * 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 {
@@ -78,6 +80,110 @@ declare const appilotsTheme: {
     fromTailwind: typeof appilotsThemeFromTailwind;
 };
 
+/**
+ * i18n keys — the canonical list of every translatable string in the
+ * SDK chat UI. Adding UI copy means adding a key here AND a value in
+ * every bundle under `./bundles/` (TypeScript will fail the bundle if a
+ * key is missing). BACKLOG 4.1.
+ */
+interface AppilotsStrings {
+    /** Default chat header title when the dev hasn't supplied one. */
+    chatTitle: string;
+    /** Header button that wipes the conversation. */
+    clearButton: string;
+    /** Placeholder for the message input. */
+    inputPlaceholder: string;
+    /** Empty state heading. */
+    emptyTitle: string;
+    /** Empty state subtitle / one-liner under the heading. */
+    emptySubtitle: string;
+    /** "Thinking..." placeholder shown while the assistant is replying. */
+    thinking: string;
+    /** Status shown while the assistant is planning from the current screen. */
+    statusAnalyzing: string;
+    /** Status shown while the SDK waits for the app to settle after an action. */
+    statusWaitingApp: string;
+    /** Status shown while the assistant adjusts after a recoverable failure. */
+    statusAdjusting: string;
+    /** Footer line shown when poweredByVisible !== false. */
+    poweredBy: string;
+    /** Approve button on a pending action row in the breadcrumb. */
+    approve: string;
+    /** Reject button on a pending action row in the breadcrumb. */
+    reject: string;
+    /** Generic "cancelled by the user" message after a reject. */
+    cancelledByUser: string;
+    /** Fallback humanised name for an unknown action type. */
+    unknownAction: string;
+    /** Generic friendly error when nothing else fits. */
+    somethingWentWrong: string;
+    /** Open chat accessibility label for the floating bubble. */
+    openChatA11y: string;
+    /** Close chat accessibility label. */
+    closeChatA11y: string;
+    /** A11y label for the stop-generation button (OKR-008 KR4). */
+    stopGeneratingA11y: string;
+    /** A11y label for the "talk to a human" header button. */
+    talkToHumanA11y: string;
+    /** Sender label above a human operator's bubble. */
+    humanAgentLabel: string;
+    /** System line right after the user (or the offer chip) escalates. */
+    escalationRequested: string;
+    /** System line when an operator claims the conversation. */
+    escalationConnected: string;
+    /** System line when the operator resolves — AI takes over again. */
+    escalationResolved: string;
+    /** System line offering the handoff after the agent gives up. */
+    escalationOffer: string;
+    /** Label of the tappable chip under the offer line. */
+    escalationOfferChip: string;
+    /** Thin banner under the header while waiting in the queue. */
+    escalationPendingBanner: string;
+    /** Thin banner under the header while connected to an operator. */
+    escalationActiveBanner: string;
+}
+type AppilotsStringKey = keyof AppilotsStrings;
+
+/**
+ * Best-effort device-locale detection. Returns the closest supported
+ * locale or `null` if we can't tell. Designed to never throw — RN's
+ * native modules are platform-specific and can be missing in test
+ * harnesses.
+ */
+declare function detectDeviceLocale(): AppilotsLocale | null;
+/**
+ * Resolve the locale to use given the prop and the device default.
+ * Order: explicit prop → device-detected → DEFAULT_LOCALE.
+ */
+declare function resolveLocale(prop?: AppilotsLocale | null): AppilotsLocale;
+interface I18nContextValue {
+    locale: AppilotsLocale;
+    strings: AppilotsStrings;
+    /**
+     * Helper to read a single key. Components can also destructure
+     * `strings` directly if they need many in one render.
+     */
+    t: (key: AppilotsStringKey) => string;
+}
+interface AppilotsI18nProviderProps {
+    /** Force a locale. Falls through to device detection when omitted. */
+    locale?: AppilotsLocale | null;
+    /**
+     * Per-key overrides to merge on top of the bundle. Useful when the
+     * dev wants to rename only "Powered by Appilots" while keeping the
+     * rest in the default language.
+     */
+    overrides?: Partial<AppilotsStrings> | null;
+    children: React__default.ReactNode;
+}
+declare function AppilotsI18nProvider({ locale, overrides, children, }: AppilotsI18nProviderProps): React__default.JSX.Element;
+/**
+ * Read the locale + strings from context. Falls back to the default
+ * locale bundle if no provider is mounted, so components don't need a
+ * provider to be safe — they just lose the dev's overrides.
+ */
+declare function useAppilotsI18n(): I18nContextValue;
+
 /**
  * Layout modes for the chat (BACKLOG 4.1).
  *  - `bubble`     — floating action button + bottom sheet modal (default)
@@ -218,52 +324,6 @@ interface ConfirmDialogProps {
 /** @deprecated No-op. See file header. */
 declare function ConfirmDialog(_props?: ConfirmDialogProps): React__default.ReactElement | null;
 
-/**
- * Human-readable labels and error messages for the action breadcrumb.
- *
- * Strings are PT-BR hardcoded for now. i18n is planned for backlog item
- * 4.1 (Personalização) — when that lands, these strings move into the
- * locale bundles.
- *
- * Two responsibilities:
- *   1. `describeAction(action)` — turns a typed AgentAction into a label
- *      that varies by lifecycle state (pending/running/done/failed).
- *   2. `humanizeError(raw, action)` — sanitises the raw error string from
- *      the executor into a short user-facing reason. Stack traces and
- *      protocol errors are collapsed into "algo deu errado" so users
- *      aren't shown technical noise.
- */
-
-type BreadcrumbState = 'pending' | 'running' | 'success' | 'failed';
-interface BreadcrumbItem {
-    /** What to render on the line. */
-    label: string;
-    /** Lifecycle state — drives icon + colour in the breadcrumb. */
-    state: BreadcrumbState;
-}
-/**
- * Map an AgentAction + its current status to a breadcrumb item ready to
- * render. The function is intentionally defensive — both the native-tools
- * and JSON-fallback code paths feed actions through here, and the JSON
- * path is loose with payload shapes, so every field access has to assume
- * `unknown`.
- */
-declare function describeAction(action: AgentAction): BreadcrumbItem;
-/**
- * Convert the executor's raw error string into a short, user-facing
- * reason that fits inside parentheses on the breadcrumb line. Returns
- * `undefined` when there's no useful information to show — caller can
- * then drop the parenthetical entirely.
- *
- * Heuristics:
- *   - Apply known-pattern rewrites (rejected, not found, network, etc.)
- *   - If the result looks technical (stack frame, HTTP status, JSON
- *     dump) or is suspiciously long, fall back to "algo deu errado".
- *   - Trim and lowercase the first letter so it reads naturally inside
- *     the parens after the action verb.
- */
-declare function humanizeError(raw: string | undefined, _action?: AgentAction): string | undefined;
-
 /**
  * Pure presentation logic for ActionBreadcrumb, extracted from the RN
  * component (same pattern as `humanizeAction.ts` / `chatTimeline.ts`)
@@ -900,14 +960,6 @@ declare function _patchJsxRuntimes(jsxRuntime: any, jsxDevRuntime: any): void;
  */
 declare function isAutoTrackingEnabled(): boolean;
 
-type TraceListener = (entries: AppilotsTraceEntry[]) => void;
-declare function recordAppilotsDebugTrace(entry: Omit<AppilotsTraceEntry, 'id'> & {
-    id?: string;
-}): void;
-declare function getAppilotsDebugTraces(): AppilotsTraceEntry[];
-declare function clearAppilotsDebugTraces(): void;
-declare function subscribeAppilotsDebugTraces(listener: TraceListener): () => void;
-
 /**
  * captureSnapshot — the public entry point for runtime UI introspection.
  *
@@ -1146,11 +1198,4 @@ interface ExecutorContext {
 }
 declare function executeAction(action: AgentAction, context: ExecutorContext): Promise<ActionResult>;
 
-/**
- * SDK version — bumped by changesets on release. Lives in its own module
- * so runtime code (AppilotsClient) can import it without pulling the whole
- * public barrel in and creating an import cycle.
- */
-declare const SDK_VERSION = "0.1.0";
-
-export { ActionBreadcrumb, type ActionBreadcrumbProps, type ActionResult, AgentAction, AgentPermissions, type AppilotsButtonProps, AppilotsChat, type AppilotsChatMode, type AppilotsChatPosition, type AppilotsChatProps, type AppilotsChatTheme, AppilotsEvent, type AppilotsInputProps, AppilotsLocale, type AppilotsRC, AppilotsRegistryProvider, type AppilotsSwitchProps, AppilotsThemeProvider, type AppilotsThemeProviderProps, AppilotsThemeTokens, AppilotsTraceEntry, type BreadcrumbItem, type BreadcrumbState, 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, PartialThemeTokens, SDK_VERSION, type ScreenSnapshot, type TailwindResolvedConfig, type ToggleSnapshot, _patchJsxRuntimes, appilotsTheme, appilotsThemeFromTailwind, captureSnapshot, clearAppilotsDebugTraces, createAppilotsButton, createAppilotsInput, createAppilotsSwitch, createElementRegistry, createListRegistry, describeAction, elementRegistry, enableAppilotsAutoTracking, executeAction, getAppilotsDebugTraces, getGlobalConfig, humanizeError, initAppilots, isAutoTrackingEnabled, listRegistry, recordAppilotsDebugTrace, subscribeAppilotsDebugTraces, useAppilotsTheme, useResolvedRegistry };
+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 };