@carbon/ai-chat 1.2.1 → 1.3.0-rc.1

package/dist/es-custom/serverEntry.js

@@ -1,4 +1,4 @@
-export { B as BusEventType, g as ButtonItemKind, h as ButtonItemType, b as CancellationReason, c as CarbonTheme, n as ChainOfThoughtStepStatus, C as CornersType, E as ErrorType, F as FeedbackInteractionType, f as FileStatusValue, m as HumanAgentMessageType, H as HumanAgentsOnlineStatus, I as IFrameItemDisplayOption, o as MessageErrorState, i as MessageInputType, j as MessageResponseTypes, M as MessageSendSource, d as MinimizeButtonIconType, O as OnErrorType, k as OptionItemPreference, P as PageObjectId, S as ScreenShareState, U as UserType, a as ViewChangeReason, V as ViewType, l as WidthOptions, W as WriteableElementName, e as enLanguagePack } from "./chat.PageObjectId.js";
+export { B as BusEventType, g as ButtonItemKind, h as ButtonItemType, b as CancellationReason, c as CarbonTheme, n as ChainOfThoughtStepStatus, C as CornersType, E as ErrorType, F as FeedbackInteractionType, f as FileStatusValue, m as HumanAgentMessageType, H as HumanAgentsOnlineStatus, I as IFrameItemDisplayOption, o as MessageErrorState, i as MessageInputType, j as MessageResponseTypes, M as MessageSendSource, d as MinimizeButtonIconType, O as OnErrorType, k as OptionItemPreference, p as PageObjectId, P as PanelType, S as ScreenShareState, U as UserType, a as ViewChangeReason, V as ViewType, l as WidthOptions, W as WriteableElementName, e as enLanguagePack } from "./chat.PageObjectId.js";
 
 var LayoutCustomProperties;
 

package/dist/es-custom/web-components/cds-aichat-container/index.js

@@ -70,8 +70,6 @@ import "lit/directive.js";
 
 import "@carbon/web-components/es-custom/components/list/index.js";
 
-import "lodash-es/debounce.js";
-
 import "@carbon/web-components/es-custom/components/data-table/index.js";
 
 import "@carbon/web-components/es-custom/components/checkbox/index.js";
@@ -148,6 +146,10 @@ import "@carbon/web-components/es-custom/components/skeleton-text/skeleton-text.
 
 import "@carbon/web-components/es-custom/components/skeleton-placeholder/skeleton-placeholder.js";
 
+import "@carbon/icons/es/chevron--down/16.js";
+
+import "@carbon/icons/es/chevron--up/16.js";
+
 import "@carbon/icons/es/touch--interaction/16.js";
 
 import "@carbon/icons/es/send/16.js";
@@ -162,14 +164,12 @@ import "@carbon/icons/es/chevron--left/16.js";
 
 import "@carbon/icons/es/chevron--right/16.js";
 
+import "lodash-es/debounce.js";
+
 import "@carbon/icons/es/link/16.js";
 
 import "@carbon/icons/es/maximize/16.js";
 
-import "@carbon/icons/es/chevron--down/16.js";
-
-import "@carbon/icons/es/chevron--up/16.js";
-
 import "@carbon/web-components/es-custom/components/tag/operational-tag.js";
 
 import "@carbon/icons/es/checkmark/32.js";

package/dist/es-custom/web-components/cds-aichat-custom-element/index.js

@@ -72,8 +72,6 @@ import "lit/directive.js";
 
 import "@carbon/web-components/es-custom/components/list/index.js";
 
-import "lodash-es/debounce.js";
-
 import "@carbon/web-components/es-custom/components/data-table/index.js";
 
 import "@carbon/web-components/es-custom/components/checkbox/index.js";
@@ -150,6 +148,10 @@ import "@carbon/web-components/es-custom/components/skeleton-text/skeleton-text.
 
 import "@carbon/web-components/es-custom/components/skeleton-placeholder/skeleton-placeholder.js";
 
+import "@carbon/icons/es/chevron--down/16.js";
+
+import "@carbon/icons/es/chevron--up/16.js";
+
 import "@carbon/icons/es/touch--interaction/16.js";
 
 import "@carbon/icons/es/send/16.js";
@@ -164,14 +166,12 @@ import "@carbon/icons/es/chevron--left/16.js";
 
 import "@carbon/icons/es/chevron--right/16.js";
 
+import "lodash-es/debounce.js";
+
 import "@carbon/icons/es/link/16.js";
 
 import "@carbon/icons/es/maximize/16.js";
 
-import "@carbon/icons/es/chevron--down/16.js";
-
-import "@carbon/icons/es/chevron--up/16.js";
-
 import "@carbon/web-components/es-custom/components/tag/operational-tag.js";
 
 import "@carbon/icons/es/checkmark/32.js";

package/dist/types/aiChatEntry.d.ts

@@ -1,5 +1,5 @@
-import { C as ChatContainerProps, B as BusEventViewPreChange, a as ChatInstance, b as BusEventViewChange } from './serverEntry-Cad3Ek2W.js';
-export { ar as AdditionalDataToAgent, as as AgentAvailability, aO as AudioItem, aJ as BaseGenericItem, aP as BaseMessageInput, p as BusEvent, y as BusEventChatReady, z as BusEventChunkUserDefinedResponse, A as BusEventClosePanelButtonClicked, D as BusEventCustomPanelClose, G as BusEventCustomPanelOpen, H as BusEventCustomPanelPreClose, J as BusEventCustomPanelPreOpen, K as BusEventFeedback, M as BusEventHistoryBegin, O as BusEventHistoryEnd, q as BusEventHumanAgentAreAnyAgentsOnline, r as BusEventHumanAgentEndChat, s as BusEventHumanAgentPreEndChat, t as BusEventHumanAgentPreReceive, u as BusEventHumanAgentPreSend, v as BusEventHumanAgentPreStartChat, w as BusEventHumanAgentReceive, x as BusEventHumanAgentSend, Q as BusEventMessageItemCustom, R as BusEventPreReceive, U as BusEventPreReset, X as BusEventPreSend, Y as BusEventReceive, Z as BusEventReset, _ as BusEventSend, $ as BusEventType, a0 as BusEventUserDefinedResponse, aQ as ButtonItem, aR as ButtonItemKind, aS as ButtonItemType, a8 as CancellationReason, ab as CarbonTheme, aT as CardItem, aU as CarouselItem, bN as CdsAiChatContainerAttributes, bO as CdsAiChatCustomElementAttributes, bz as ChainOfThoughtStep, bA as ChainOfThoughtStepStatus, h as ChangeFunction, d as ChatHeaderConfig, a9 as ChatInstanceMessaging, i as ChatInstanceNotifications, j as ChatInstanceServiceDeskActions, aV as Chunk, aW as CompleteItemChunk, aX as ConnectToHumanAgentItem, aY as ConnectToHumanAgentItemTransferInfo, au as ConnectingErrorInfo, aZ as ConversationalSearchItem, a_ as ConversationalSearchItemCitation, o as CornersType, ac as CustomMenuOption, e as CustomPanelConfigOptions, f as CustomPanelInstance, g as CustomPanels, aa as CustomSendMessageOptions, a$ as DateItem, ap as DeepPartial, ad as DisclaimerPublicConfig, av as DisconnectedErrorInfo, aw as EndChatInfo, ax as ErrorType, E as EventBusHandler, k as EventHandlers, b0 as EventInput, b1 as EventInputData, a1 as FeedbackInteractionType, ay as FileStatusValue, az as FileUpload, F as FileUploadCapabilities, b2 as FinalResponseChunk, b3 as GenericItem, b4 as GenericItemMessageFeedbackCategories, bB as GenericItemMessageFeedbackOptions, bC as GenericItemMessageOptions, b5 as GridItem, af as HeaderConfig, bJ as HistoryItem, a4 as HomeScreenConfig, a5 as HomeScreenStarterButton, a6 as HomeScreenStarterButtons, a7 as HomeScreenState, b6 as HorizontalCellAlignment, by as HumanAgentMessageType, at as HumanAgentsOnlineStatus, b7 as IFrameItem, b8 as IFrameItemDisplayOption, b9 as ImageItem, I as IncreaseOrDecrease, ba as InlineErrorItem, ag as InputConfig, bb as ItemStreamingMetadata, ah as LanguagePack, bL as LauncherCallToActionConfig, bM as LauncherConfig, ai as LayoutConfig, L as LayoutCustomProperties, bc as MediaItem, bd as MediaItemDimensions, bD as Message, bK as MessageErrorState, bG as MessageHistoryFeedback, be as MessageInput, bf as MessageInputType, bg as MessageItemPanelInfo, bh as MessageOutput, bi as MessageRequest, aM as MessageRequestHistory, bj as MessageResponse, aL as MessageResponseHistory, aK as MessageResponseOptions, bk as MessageResponseTypes, a2 as MessageSendSource, aj as MinimizeButtonIconType, N as NotificationMessage, aq as ObjectMap, ak as OnErrorData, al as OnErrorType, bl as OptionItem, bm as OptionItemPreference, bS as PageObjectId, bn as PartialItemChunk, bE as PartialOrCompleteItemChunk, bF as PartialResponse, bo as PauseItem, ao as PersistedHumanAgentState, P as PersistedState, l as PublicChatHumanAgentState, m as PublicChatState, am as PublicConfig, an as PublicConfigMessaging, bP as RenderUserDefinedResponse, bQ as RenderUserDefinedState, bR as RenderWriteableElementResponse, aN as ResponseUserProfile, aA as ScreenShareState, bH as SearchResult, S as SendOptions, aB as ServiceDesk, aC as ServiceDeskCallback, aD as ServiceDeskCapabilities, aE as ServiceDeskErrorInfo, aF as ServiceDeskFactoryParameters, aG as ServiceDeskPublicConfig, bx as SingleOption, aH as StartChatOptions, bp as StreamChunk, bT as TestId, bq as TextItem, T as TypeAndHandler, br as UserDefinedItem, aI as UserMessageErrorInfo, bI as UserType, bs as VerticalCellAlignment, bt as VideoItem, a3 as ViewChangeReason, V as ViewState, c as ViewType, bu as WidthOptions, bv as WithBodyAndFooter, bw as WithWidthOptions, W as WriteableElementName, n as WriteableElements, ae as enLanguagePack } from './serverEntry-Cad3Ek2W.js';
+import { C as ChatContainerProps, B as BusEventViewPreChange, a as ChatInstance, b as BusEventViewChange } from './serverEntry-BMoPx5K4.js';
+export { ay as AdditionalDataToAgent, az as AgentAvailability, aV as AudioItem, aQ as BaseGenericItem, aW as BaseMessageInput, v as BusEvent, K as BusEventChatReady, M as BusEventChunkUserDefinedResponse, O as BusEventClosePanelButtonClicked, Q as BusEventCustomPanelClose, R as BusEventCustomPanelOpen, U as BusEventCustomPanelPreClose, X as BusEventCustomPanelPreOpen, Y as BusEventFeedback, Z as BusEventHistoryBegin, _ as BusEventHistoryEnd, w as BusEventHumanAgentAreAnyAgentsOnline, x as BusEventHumanAgentEndChat, y as BusEventHumanAgentPreEndChat, z as BusEventHumanAgentPreReceive, A as BusEventHumanAgentPreSend, G as BusEventHumanAgentPreStartChat, H as BusEventHumanAgentReceive, J as BusEventHumanAgentSend, $ as BusEventMessageItemCustom, a0 as BusEventPreReceive, a1 as BusEventPreReset, a2 as BusEventPreSend, a3 as BusEventReceive, a4 as BusEventReset, a5 as BusEventSend, a6 as BusEventType, a7 as BusEventUserDefinedResponse, aX as ButtonItem, aY as ButtonItemKind, aZ as ButtonItemType, af as CancellationReason, ai as CarbonTheme, a_ as CardItem, a$ as CarouselItem, bX as CdsAiChatContainerAttributes, bY as CdsAiChatCustomElementAttributes, bJ as ChainOfThoughtStep, bK as ChainOfThoughtStepStatus, j as ChangeFunction, e as ChatHeaderConfig, k as ChatInstanceInput, ag as ChatInstanceMessaging, l as ChatInstanceNotifications, m as ChatInstanceServiceDeskActions, b0 as Chunk, b1 as CompleteItemChunk, b2 as ConnectToHumanAgentItem, b3 as ConnectToHumanAgentItemTransferInfo, aB as ConnectingErrorInfo, b4 as ConversationalSearchItem, b5 as ConversationalSearchItemCitation, u as CornersType, aj as CustomMenuOption, f as CustomPanelConfigOptions, g as CustomPanelInstance, i as CustomPanelOpenOptions, h as CustomPanels, ah as CustomSendMessageOptions, b6 as DateItem, aw as DeepPartial, D as DefaultCustomPanelConfigOptions, ak as DisclaimerPublicConfig, aC as DisconnectedErrorInfo, aD as EndChatInfo, aE as ErrorType, E as EventBusHandler, n as EventHandlers, b7 as EventInput, b8 as EventInputData, a8 as FeedbackInteractionType, aF as FileStatusValue, aG as FileUpload, F as FileUploadCapabilities, b9 as FinalResponseChunk, ba as GenericItem, bb as GenericItemMessageFeedbackCategories, bL as GenericItemMessageFeedbackOptions, bM as GenericItemMessageOptions, bc as GridItem, am as HeaderConfig, bT as HistoryItem, ab as HomeScreenConfig, ac as HomeScreenStarterButton, ad as HomeScreenStarterButtons, ae as HomeScreenState, bd as HorizontalCellAlignment, bI as HumanAgentMessageType, aA as HumanAgentsOnlineStatus, be as IFrameItem, bf as IFrameItemDisplayOption, bg as ImageItem, I as IncreaseOrDecrease, bh as InlineErrorItem, an as InputConfig, bi as ItemStreamingMetadata, ao as LanguagePack, bV as LauncherCallToActionConfig, bW as LauncherConfig, ap as LayoutConfig, L as LayoutCustomProperties, bn as MediaFileAccessibility, bj as MediaItem, bk as MediaItemDimensions, bl as MediaSubtitleTrack, bm as MediaTranscript, bN as Message, bU as MessageErrorState, bQ as MessageHistoryFeedback, bo as MessageInput, bp as MessageInputType, bq as MessageItemPanelInfo, br as MessageOutput, bs as MessageRequest, aT as MessageRequestHistory, bt as MessageResponse, aS as MessageResponseHistory, aR as MessageResponseOptions, bu as MessageResponseTypes, a9 as MessageSendSource, aq as MinimizeButtonIconType, N as NotificationMessage, ax as ObjectMap, ar as OnErrorData, as as OnErrorType, bv as OptionItem, bw as OptionItemPreference, c0 as PageObjectId, P as PanelType, bx as PartialItemChunk, bO as PartialOrCompleteItemChunk, bP as PartialResponse, by as PauseItem, av as PersistedHumanAgentState, d as PersistedState, r as PublicChatHumanAgentState, s as PublicChatState, at as PublicConfig, au as PublicConfigMessaging, p as PublicCustomPanelsState, q as PublicDefaultCustomPanelState, o as PublicInputState, bZ as RenderUserDefinedResponse, b_ as RenderUserDefinedState, b$ as RenderWriteableElementResponse, aU as ResponseUserProfile, aH as ScreenShareState, bR as SearchResult, S as SendOptions, aI as ServiceDesk, aJ as ServiceDeskCallback, aK as ServiceDeskCapabilities, aL as ServiceDeskErrorInfo, aM as ServiceDeskFactoryParameters, aN as ServiceDeskPublicConfig, bH as SingleOption, aO as StartChatOptions, bz as StreamChunk, c1 as TestId, bA as TextItem, T as TypeAndHandler, bB as UserDefinedItem, aP as UserMessageErrorInfo, bS as UserType, bC as VerticalCellAlignment, bD as VideoItem, aa as ViewChangeReason, V as ViewState, c as ViewType, bE as WidthOptions, bF as WithBodyAndFooter, bG as WithWidthOptions, W as WriteableElementName, t as WriteableElements, al as enLanguagePack } from './serverEntry-BMoPx5K4.js';
 import React from 'react';
 import '@carbon/web-components/es/components/notification/defs.js';
 import '@carbon/web-components/es/components/button/defs.js';

package/dist/types/{serverEntry-Cad3Ek2W.d.ts → serverEntry-BMoPx5K4.d.ts}

@@ -69,6 +69,17 @@ declare enum ViewType {
      */
     MAIN_WINDOW = "mainWindow"
 }
+/**
+ * Describes the different panel types that Carbon AI Chat supports.
+ *
+ * @category Instance
+ */
+declare enum PanelType {
+    /**
+     * Opens the panel so that it overlays the main chat content.
+     */
+    DEFAULT = "default"
+}
 /**
  * This manager handles fetching an instance for manipulating the custom panel.
  *
@@ -78,7 +89,7 @@ interface CustomPanels {
     /**
      * Gets a custom panel instance.
      */
-    getPanel: () => CustomPanelInstance;
+    getPanel: (panel?: PanelType) => CustomPanelInstance;
 }
 /**
  * The custom panel instance for controlling and manipulating a custom panel in Carbon AI Chat.
@@ -95,69 +106,104 @@ interface CustomPanelInstance {
      *
      * @param options Custom panel options.
      */
-    open: (options?: CustomPanelConfigOptions) => void;
+    open: (options?: CustomPanelOpenOptions) => void;
     /**
      * Closes the custom panel.
      */
     close: () => void;
 }
 /**
- * Describes general config options for a Carbon AI Chat panel. These options are also part of the
- * {@link BasePanelComponentProps}, except the options here are also shared with {@link CustomPanelConfigOptions}.
- *
- * Any options specific to either the BasePanelComponent or CustomPanelConfigOptions should be added to the respective
- * interface.
+ * Options that change how the custom panel looks. When a header is shown, it inherits styling and behavior from the
+ * configured {@link HeaderConfig} (title, assistant name, AI slug, minimize button style, overflow menu, etc.) unless
+ * explicitly overridden below.
  *
  * @category Instance
+ *
+ * @deprecated Use {@link DefaultCustomPanelConfigOptions} for default panels.
+ *
  */
-interface BasePanelConfigOptions {
+interface CustomPanelConfigOptions {
     /**
-     * The panel title which is left blank by default.
+     * The panel title displayed in the custom panel header. Left blank by default which causes the configured chat header
+     * title/name to be shown instead. When a back button is visible the inherited header stays on screen above the panel
+     * so this title acts like a breadcrumb; when the back button is hidden, the header fills the panel chrome and this
+     * title becomes the primary heading within the overlay.
      */
     title?: string;
     /**
-     * Indicates if the close button in the custom panel should be hidden.
+     * Indicates if the close/minimize button in the custom panel should be hidden.
      */
     hideCloseButton?: boolean;
     /**
-     * Indicates if the panel header should be hidden.
+     * Indicates if the panel header should be hidden. Hiding the header removes the inherited title, AI slug, minimize
+     * button, and back button chrome entirely. Leave this undefined to animate the panel in with the standard header; set
+     * it to true when you need a chrome-free experience (for example, when the panel content provides its own close
+     * controls or you want the panel to cover the chat header without animating the header into view).
      */
     hidePanelHeader?: boolean;
     /**
-     * Indicates if the back button in the custom panel should be hidden.
+     * Indicates if the back button in the custom panel should be hidden. When {@link hidePanelHeader} is true, the back
+     * button is hidden automatically. When the back button is visible the panel opens beneath the chat header so users
+     * can always access the assistant-level header controls while the panel is active.
      */
     hideBackButton?: boolean;
     /**
-     * This callback is called when the close button is clicked. This is called even if {@link disableDefaultCloseAction}
-     * is set to true.
+     * Called when the header's close/minimize button is clicked. By default Carbon AI Chat will run its normal close
+     * behavior (which collapses the experience) before this callback fires; set {@link disableDefaultCloseAction} to true
+     * if you plan to intercept the event and manage closing yourself. The callback still fires even when the default
+     * action is disabled.
      */
     onClickClose?: () => void;
     /**
-     * Called when the restart button is clicked.
+     * Called when the restart button in the header is clicked. Use this to trigger a conversation reset or your own
+     * telemetry when the restart control is surfaced.
      */
     onClickRestart?: () => void;
     /**
-     * This callback is called when the back button is clicked.
+     * Called after the header's back button is clicked. The panel automatically closes before this callback is invoked,
+     * so you can safely run follow-up logic or analytics once the panel has been dismissed.
      */
     onClickBack?: () => void;
+    /**
+     * Determines if the panel open/close animation should be turned off.
+     */
+    disableAnimation?: boolean;
+    /**
+     * Disables the default action that is taken when the close button is clicked. Normally clicking the close/minimize
+     * button will run Carbon AI Chat's standard close routine (after verifying no view change is in progress). Set this
+     * to true when you want to keep the experience open or handle closing asynchronously; you'll need to perform the
+     * desired close work inside {@link onClickClose}.
+     */
+    disableDefaultCloseAction?: boolean;
 }
 /**
- * Options that change how the custom panel looks.
+ * Options supported by the default custom panel implementation.
  *
- * @category Instance
+ * When {@link hideBackButton} is set to true, any {@link title} value defined here will override the title/name in
+ * the main chat header.
  */
-interface CustomPanelConfigOptions extends BasePanelConfigOptions {
+interface DefaultCustomPanelConfigOptions {
     /**
-     * Determines if the panel open/close animation should be turned off.
+     * The panel title displayed in the custom panel header. When a back button is visible the inherited header remains
+     * on screen above the panel so this title acts like a breadcrumb; when the back button is hidden, the header fills
+     * the panel chrome and this title becomes the primary heading within the overlay.
+     */
+    title?: string;
+    /**
+     * Determines if the panel open/close animation should be turned off. By default, the panel will animate up from the
+     * bottom of the chat window.
      */
     disableAnimation?: boolean;
     /**
-     * Disables the default action that is taken when the close button is clicked. The default
-     * action closes Carbon AI Chat and disabling this will cause the button to not do anything. You can override the button
-     * behavior by using the {@link onClickClose} callback.
+     * Indicates if the back button in the custom panel should be hidden.
      */
-    disableDefaultCloseAction?: boolean;
+    hideBackButton?: boolean;
 }
+/**
+ * Options accepted by {@link CustomPanelInstance.open}. Legacy consumers may continue to pass
+ * {@link CustomPanelConfigOptions} until the next major release.
+ */
+type CustomPanelOpenOptions = CustomPanelConfigOptions | DefaultCustomPanelConfigOptions;
 
 /*
  *  Copyright IBM Corp. 2025
@@ -998,6 +1044,82 @@ interface MediaItemDimensions {
      */
     base_height?: number;
 }
+/**
+ * Represents a single subtitle/caption track for video content.
+ * Uses WebVTT format for accessibility. Rendered as native HTML5 track elements.
+ *
+ * @category Messaging
+ */
+interface MediaSubtitleTrack {
+    /**
+     * URL pointing to the WebVTT subtitle file.
+     */
+    src: string;
+    /**
+     * The language code (e.g., "en", "es", "fr").
+     * Used for the track's srclang attribute.
+     */
+    language: string;
+    /**
+     * Human-readable label for the track (e.g., "English", "Spanish").
+     * Displayed in the browser's subtitle menu.
+     */
+    label: string;
+    /**
+     * The kind of text track.
+     * - "subtitles": Translation of dialogue (default)
+     * - "captions": Transcription including sound effects
+     * - "descriptions": Audio descriptions for visually impaired
+     */
+    kind?: "subtitles" | "captions" | "descriptions";
+    /**
+     * Whether this track should be enabled by default.
+     * Only one track should be default.
+     */
+    default?: boolean;
+}
+/**
+ * Represents a text transcript for audio content.
+ * Displayed as readable text below the audio player for accessibility.
+ *
+ * @category Messaging
+ */
+interface MediaTranscript {
+    /**
+     * Full text transcript of the audio content.
+     * Supports markdown for formatting.
+     */
+    text: string;
+    /**
+     * Language of the transcript (e.g., "en", "es", "fr").
+     */
+    language?: string;
+    /**
+     * Optional label for the transcript (e.g., "English Transcript").
+     */
+    label?: string;
+}
+/**
+ * Accessibility features for raw media files (not embedded platforms).
+ * These features only apply when using direct file URLs (e.g., .mp4, .mp3).
+ *
+ * For embedded platforms (YouTube, Vimeo, SoundCloud, Mixcloud, etc.),
+ * rely on the platform's built-in accessibility features instead.
+ *
+ * @category Messaging
+ */
+interface MediaFileAccessibility {
+    /**
+     * Subtitle/caption tracks for video files.
+     * Supports WebVTT format rendered as native HTML5 track elements.
+     */
+    subtitle_tracks?: MediaSubtitleTrack[];
+    /**
+     * Text transcript for audio files.
+     * Displayed as expandable text below the audio player.
+     */
+    transcript?: MediaTranscript;
+}
 /**
  * The different ways an iframe item may be displayed.
  *
@@ -1045,6 +1167,11 @@ interface MediaItem<TUserDefinedType = Record<string, unknown>> extends BaseGene
      * Settings that control the dimensions for the media item.
      */
     dimensions?: MediaItemDimensions;
+    /**
+     * Accessibility features for raw media files.
+     * Only applies to direct file URLs (e.g., .mp4, .mp3), not embedded platforms.
+     */
+    file_accessibility?: MediaFileAccessibility;
 }
 /**
  * Citations for text generated by an AI to provide the user with relevant source information and context.
@@ -2190,6 +2317,10 @@ declare enum BusEventType {
      * Fired after the view changes (e.g. when the chat window closes).
      */
     VIEW_CHANGE = "view:change",
+    /**
+     * Fired when a button response item with button_type "custom_event" is clicked.
+     * Provides the originating button item and the full message payload to handlers.
+     */
     MESSAGE_ITEM_CUSTOM = "messageItemCustom",
     /**
      * Fired when a userDefined message is received.
@@ -2889,7 +3020,8 @@ interface ChatInstanceMessaging {
     removeMessages: (messageIDs: string[]) => Promise<void>;
     /**
      * Clears the current conversation. This will trigger a restart of the conversation but will not start a new
-     * conversation (hydration).
+     * conversation (hydration). It will also clear any loading indicators UNLESS you have set
+     * {@link PublicConfigMessaging.messageLoadingIndicatorTimeoutSecs} to 0.
      */
     clearConversation: () => Promise<void>;
     /**
@@ -2900,8 +3032,8 @@ interface ChatInstanceMessaging {
     /**
      * Restarts the conversation with the assistant. This does not make any changes to a conversation with a human agent.
      * This will clear all the current assistant messages from the main assistant view and cancel any outstanding
-     * messages. This will also clear the current assistant session which will force a new session to start on the
-     * next message.
+     * messages. It will also clear any loading indicators UNLESS you have set
+     * {@link PublicConfigMessaging.messageLoadingIndicatorTimeoutSecs} to 0.
      */
     restartConversation: () => Promise<void>;
 }
@@ -2958,13 +3090,67 @@ interface ChatInstance extends EventHandlers, ChatActions {
     customPanels?: CustomPanels;
 }
 /**
- * This is the state made available by calling getState. This is a public method that returns immutable values.
+ * This is the state made available by calling {@link ChatInstance.getState}. This is a public method that returns immutable values.
  *
  * @category Instance
  */
+interface PublicInputState {
+    /**
+     * @experimental Raw text currently queued in the input before being sent to customSendMessage.
+     */
+    rawValue: string;
+}
+/**
+ * Represents public state for each supported custom panel variant.
+ */
+interface PublicDefaultCustomPanelState {
+    /** Indicates if the default custom panel overlay is currently open. */
+    isOpen: boolean;
+}
+interface PublicCustomPanelsState {
+    /** State for the default overlay-style custom panel. */
+    default: PublicDefaultCustomPanelState;
+}
 type PublicChatState = Readonly<Omit<PersistedState, "humanAgentState"> & {
+    /**
+     * Current human agent state.
+     */
     humanAgent: PublicChatHumanAgentState;
+    /**
+     * Counter that indicates if a message is loading and a loading indicator should be displayed.
+     * If "0" then we do not show loading indicator.
+     */
+    isMessageLoadingCounter: number;
+    /**
+     * Optional string to display next to the loading indicator.
+     */
+    isMessageLoadingText?: string;
+    /**
+     * Counter that indicates if the chat is hydrating and a full screen loading state should be displayed.
+     */
+    isHydratingCounter: number;
+    /**
+     * @experimental State representing the main input surface.
+     */
+    input: PublicInputState;
+    /**
+     * @experimental State for any surfaced custom panels.
+     */
+    customPanels: PublicCustomPanelsState;
 }>;
+interface ChatInstanceInput {
+    /**
+     * @experimental Updates the raw text queued in the input before it is sent to customSendMessage.
+     * Use this when you want to manipulate the canonical value while leaving
+     * presentation up to the default renderer or, in the future, a custom slot implementation.
+     *
+     * @example
+     * ```ts
+     * instance.input.updateRawValue((prev) => `${prev} @celeste`);
+     * ```
+     */
+    updateRawValue: (updater: (previous: string) => string) => void;
+}
 /**
  * Current connection state of the human agent experience.
  *
@@ -3065,19 +3251,16 @@ interface ChatActions {
      */
     writeableElements: Partial<WriteableElements>;
     /**
-     * Sets the input field to be invisible. Helpful for when
-     * you want to force input into a button, etc.
+     * @deprecated Configure via {@link InputConfig.isVisible}.
      */
     updateInputFieldVisibility: (isVisible: boolean) => void;
     /**
-     * Changes the state of Carbon AI Chat to allow or disallow input. This includes the input field as well as inputs like
-     * buttons and dropdowns.
+     * @deprecated Configure via {@link InputConfig.isDisabled}
+     * or {@link PublicConfig.isReadonly}.
      */
     updateInputIsDisabled: (isDisabled: boolean) => void;
     /**
-     * Updates the visibility of the custom unread indicator that appears on the launcher. This indicator appears as a
-     * small empty circle on the launcher. If there are any unread messages from a human agent, this indicator will be
-     * shown with a number regardless of the custom setting of this flag.
+     * @deprecated Configure via {@link LauncherConfig.showUnreadIndicator}.
      */
     updateAssistantUnreadIndicatorVisibility: (isVisible: boolean) => void;
     /**
@@ -3102,15 +3285,25 @@ interface ChatActions {
      */
     doAutoScroll: () => void;
     /**
-     * Either increases or decreases the internal counter that indicates whether the "assistant is loading" indicator is
-     * shown. If the count is greater than zero, then the indicator is shown. Values of "increase" or "decrease" will
-     * increase or decrease the value. Any other value will log an error.
+     * @param direction Either increases or decreases the internal counter that indicates whether the "message is loading"
+     * indicator is shown. If the count is greater than zero, then the indicator is shown. Values of "increase" or "decrease" will
+     * increase or decrease the value. "reset" will set the value back to 0. You may pass undefined as the first value
+     * if you just wish to update the message.
+     *
+     * You can access the current value via {@link ChatInstance.getState}.
+     *
+     * @param message You can also, optionally, pass a plain text string as the second argument. It will display next to the loading indicator for
+     * you to give meaningful feedback while the message is loading (or simple strings like "Thinking...", etc). The most
+     * recent value will be used. So if you call it with a string value and then again with no value, the value will be
+     * replaced with undefined and stop showing in the UI.
      */
-    updateIsMessageLoadingCounter: (direction: IncreaseOrDecrease) => void;
+    updateIsMessageLoadingCounter: (direction: IncreaseOrDecrease, message?: string) => void;
     /**
      * Either increases or decreases the internal counter that indicates whether the hydration fullscreen loading state is
      * shown. If the count is greater than zero, then the indicator is shown. Values of "increase" or "decrease" will
-     * increase or decrease the value. Any other value will log an error.
+     * increase or decrease the value. "reset" will set the value back to 0.
+     *
+     * You can access the current value via {@link ChatInstance.getState}.
      */
     updateIsChatLoadingCounter: (direction: IncreaseOrDecrease) => void;
     /**
@@ -3119,6 +3312,10 @@ interface ChatActions {
      * @experimental
      */
     notifications: ChatInstanceNotifications;
+    /**
+     * Actions for mutating the chat input contents.
+     */
+    input: ChatInstanceInput;
     /**
      * Actions that are related to a service desk integration.
      */
@@ -3134,7 +3331,7 @@ interface ChatActions {
 /**
  * @category Instance
  */
-type IncreaseOrDecrease = "increase" | "decrease";
+type IncreaseOrDecrease = "increase" | "decrease" | "reset" | undefined;
 /**
  * This interface represents the options for when a MessageRequest is sent to the server with the send method.
  *
@@ -3377,6 +3574,10 @@ interface LauncherConfig {
      * If the launcher is visible. Defaults to true.
      */
     isOn?: boolean;
+    /**
+     * Controls whether the unread indicator dot shows even when no human-agent unread count exists.
+     */
+    showUnreadIndicator?: boolean;
     /**
      * Properties specific to the mobile launcher.
      */
@@ -3456,6 +3657,7 @@ declare const enLanguagePack: {
     launcher_mobileGreeting: string;
     launcher_ariaIsExpanded: string;
     launcher_closeButton: string;
+    media_transcript_label: string;
     messages_youSaid: string;
     messages_assistantSaid: string;
     messages_agentSaid: string;
@@ -3784,6 +3986,16 @@ interface InputConfig {
      * The maximum number of characters allowed in the input field. Defaults to 10000.
      */
     maxInputCharacters?: number;
+    /**
+     * Controls whether the main input surface is visible when the chat loads.
+     * Defaults to true.
+     */
+    isVisible?: boolean;
+    /**
+     * If true, the main input surface starts in a disabled (read-only) state.
+     * Equivalent to {@link PublicConfig.isReadonly}, but scoped just to the assistant input.
+     */
+    isDisabled?: boolean;
 }
 /**
  * Configuration for the main header of the chat.
@@ -3791,6 +4003,11 @@ interface InputConfig {
  * @category Config
  */
 interface HeaderConfig {
+    /**
+     * If the chat should supply its own header. Can be false if you have a fullscreen chat or one embedded into a page and
+     * you want to only make use of the main application header. Defaults to true.
+     */
+    isOn?: boolean;
     /**
      * Indicates the icon to use for the close button in the header.
      */
@@ -3871,15 +4088,16 @@ interface PublicConfigMessaging {
     /**
      * Changes the timeout used by the message service when making message calls. The timeout is in seconds. The
      * default is 150 seconds. After this time, an error will be shown in the client and an Abort signal will be sent
-     * to customSendMessage. If set to 0, the chat will never timeout.
+     * to customSendMessage. If set to 0, the chat will never timeout.  This is tied to either {@link ChatInstanceMessaging.addMessage} or
+     * {@link ChatInstanceMessaging.addMessageChunk} being called after this message was sent. If neither of those methods
+     * are called with in the window defined here, the chat will timeout (unless the value is set to 0).
      */
     messageTimeoutSecs?: number;
     /**
      * Controls how long AI chat should wait before showing the loading indicator. If set to 0, the chat will never show
-     * the loading indicator. This is tied to either {@link ChatInstanceMessaging.addMessage} or
-     * {@link ChatInstanceMessaging.addMessageChunk} being called after this message was sent.
-     *
-     * If set to 0, the chat will never automatically show a loading indicator.
+     * the loading indicator on its own. This is tied to either {@link ChatInstanceMessaging.addMessage} or
+     * {@link ChatInstanceMessaging.addMessageChunk} being called after this message was sent. If neither of those methods
+     * are called with in the window defined here, the loading indicator will be shown.
      */
     messageLoadingIndicatorTimeoutSecs?: number;
     /**
@@ -4426,5 +4644,5 @@ declare enum PageObjectId {
  */
 type TestId = PageObjectId;
 
-export { BusEventType as $, LayoutCustomProperties as L, WriteableElementName as W, FeedbackInteractionType as a1, MessageSendSource as a2, ViewChangeReason as a3, CancellationReason as a8, ScreenShareState as aA, ButtonItemKind as aR, ButtonItemType as aS, CarbonTheme as ab, enLanguagePack as ae, MinimizeButtonIconType as aj, OnErrorType as al, HumanAgentsOnlineStatus as at, ErrorType as ax, FileStatusValue as ay, IFrameItemDisplayOption as b8, ChainOfThoughtStepStatus as bA, UserType as bI, MessageErrorState as bK, PageObjectId as bS, MessageInputType as bf, MessageResponseTypes as bk, OptionItemPreference as bm, WidthOptions as bu, HumanAgentMessageType as by, ViewType as c, CornersType as o };
-export type { BusEventClosePanelButtonClicked as A, BusEventViewPreChange as B, ChatContainerProps as C, BusEventCustomPanelClose as D, EventBusHandler as E, FileUploadCapabilities as F, BusEventCustomPanelOpen as G, BusEventCustomPanelPreClose as H, IncreaseOrDecrease as I, BusEventCustomPanelPreOpen as J, BusEventFeedback as K, BusEventHistoryBegin as M, NotificationMessage as N, BusEventHistoryEnd as O, PersistedState as P, BusEventMessageItemCustom as Q, BusEventPreReceive as R, SendOptions as S, TypeAndHandler as T, BusEventPreReset as U, ViewState as V, BusEventPreSend as X, BusEventReceive as Y, BusEventReset as Z, BusEventSend as _, ChatInstance as a, DateItem as a$, BusEventUserDefinedResponse as a0, HomeScreenConfig as a4, HomeScreenStarterButton as a5, HomeScreenStarterButtons as a6, HomeScreenState as a7, ChatInstanceMessaging as a9, ServiceDesk as aB, ServiceDeskCallback as aC, ServiceDeskCapabilities as aD, ServiceDeskErrorInfo as aE, ServiceDeskFactoryParameters as aF, ServiceDeskPublicConfig as aG, StartChatOptions as aH, UserMessageErrorInfo as aI, BaseGenericItem as aJ, MessageResponseOptions as aK, MessageResponseHistory as aL, MessageRequestHistory as aM, ResponseUserProfile as aN, AudioItem as aO, BaseMessageInput as aP, ButtonItem as aQ, CardItem as aT, CarouselItem as aU, Chunk as aV, CompleteItemChunk as aW, ConnectToHumanAgentItem as aX, ConnectToHumanAgentItemTransferInfo as aY, ConversationalSearchItem as aZ, ConversationalSearchItemCitation as a_, CustomSendMessageOptions as aa, CustomMenuOption as ac, DisclaimerPublicConfig as ad, HeaderConfig as af, InputConfig as ag, LanguagePack as ah, LayoutConfig as ai, OnErrorData as ak, PublicConfig as am, PublicConfigMessaging as an, PersistedHumanAgentState as ao, DeepPartial as ap, ObjectMap as aq, AdditionalDataToAgent as ar, AgentAvailability as as, ConnectingErrorInfo as au, DisconnectedErrorInfo as av, EndChatInfo as aw, FileUpload as az, BusEventViewChange as b, EventInput as b0, EventInputData as b1, FinalResponseChunk as b2, GenericItem as b3, GenericItemMessageFeedbackCategories as b4, GridItem as b5, HorizontalCellAlignment as b6, IFrameItem as b7, ImageItem as b9, GenericItemMessageFeedbackOptions as bB, GenericItemMessageOptions as bC, Message as bD, PartialOrCompleteItemChunk as bE, PartialResponse as bF, MessageHistoryFeedback as bG, SearchResult as bH, HistoryItem as bJ, LauncherCallToActionConfig as bL, LauncherConfig as bM, CdsAiChatContainerAttributes as bN, CdsAiChatCustomElementAttributes as bO, RenderUserDefinedResponse as bP, RenderUserDefinedState as bQ, RenderWriteableElementResponse as bR, TestId as bT, InlineErrorItem as ba, ItemStreamingMetadata as bb, MediaItem as bc, MediaItemDimensions as bd, MessageInput as be, MessageItemPanelInfo as bg, MessageOutput as bh, MessageRequest as bi, MessageResponse as bj, OptionItem as bl, PartialItemChunk as bn, PauseItem as bo, StreamChunk as bp, TextItem as bq, UserDefinedItem as br, VerticalCellAlignment as bs, VideoItem as bt, WithBodyAndFooter as bv, WithWidthOptions as bw, SingleOption as bx, ChainOfThoughtStep as bz, ChatHeaderConfig as d, CustomPanelConfigOptions as e, CustomPanelInstance as f, CustomPanels as g, ChangeFunction as h, ChatInstanceNotifications as i, ChatInstanceServiceDeskActions as j, EventHandlers as k, PublicChatHumanAgentState as l, PublicChatState as m, WriteableElements as n, BusEvent as p, BusEventHumanAgentAreAnyAgentsOnline as q, BusEventHumanAgentEndChat as r, BusEventHumanAgentPreEndChat as s, BusEventHumanAgentPreReceive as t, BusEventHumanAgentPreSend as u, BusEventHumanAgentPreStartChat as v, BusEventHumanAgentReceive as w, BusEventHumanAgentSend as x, BusEventChatReady as y, BusEventChunkUserDefinedResponse as z };
+export { LayoutCustomProperties as L, PanelType as P, WriteableElementName as W, BusEventType as a6, FeedbackInteractionType as a8, MessageSendSource as a9, HumanAgentsOnlineStatus as aA, ErrorType as aE, FileStatusValue as aF, ScreenShareState as aH, ButtonItemKind as aY, ButtonItemType as aZ, ViewChangeReason as aa, CancellationReason as af, CarbonTheme as ai, enLanguagePack as al, MinimizeButtonIconType as aq, OnErrorType as as, WidthOptions as bE, HumanAgentMessageType as bI, ChainOfThoughtStepStatus as bK, UserType as bS, MessageErrorState as bU, IFrameItemDisplayOption as bf, MessageInputType as bp, MessageResponseTypes as bu, OptionItemPreference as bw, ViewType as c, PageObjectId as c0, CornersType as u };
+export type { BusEventMessageItemCustom as $, BusEventHumanAgentPreSend as A, BusEventViewPreChange as B, ChatContainerProps as C, DefaultCustomPanelConfigOptions as D, EventBusHandler as E, FileUploadCapabilities as F, BusEventHumanAgentPreStartChat as G, BusEventHumanAgentReceive as H, IncreaseOrDecrease as I, BusEventHumanAgentSend as J, BusEventChatReady as K, BusEventChunkUserDefinedResponse as M, NotificationMessage as N, BusEventClosePanelButtonClicked as O, BusEventCustomPanelClose as Q, BusEventCustomPanelOpen as R, SendOptions as S, TypeAndHandler as T, BusEventCustomPanelPreClose as U, ViewState as V, BusEventCustomPanelPreOpen as X, BusEventFeedback as Y, BusEventHistoryBegin as Z, BusEventHistoryEnd as _, ChatInstance as a, CarouselItem as a$, BusEventPreReceive as a0, BusEventPreReset as a1, BusEventPreSend as a2, BusEventReceive as a3, BusEventReset as a4, BusEventSend as a5, BusEventUserDefinedResponse as a7, ConnectingErrorInfo as aB, DisconnectedErrorInfo as aC, EndChatInfo as aD, FileUpload as aG, ServiceDesk as aI, ServiceDeskCallback as aJ, ServiceDeskCapabilities as aK, ServiceDeskErrorInfo as aL, ServiceDeskFactoryParameters as aM, ServiceDeskPublicConfig as aN, StartChatOptions as aO, UserMessageErrorInfo as aP, BaseGenericItem as aQ, MessageResponseOptions as aR, MessageResponseHistory as aS, MessageRequestHistory as aT, ResponseUserProfile as aU, AudioItem as aV, BaseMessageInput as aW, ButtonItem as aX, CardItem as a_, HomeScreenConfig as ab, HomeScreenStarterButton as ac, HomeScreenStarterButtons as ad, HomeScreenState as ae, ChatInstanceMessaging as ag, CustomSendMessageOptions as ah, CustomMenuOption as aj, DisclaimerPublicConfig as ak, HeaderConfig as am, InputConfig as an, LanguagePack as ao, LayoutConfig as ap, OnErrorData as ar, PublicConfig as at, PublicConfigMessaging as au, PersistedHumanAgentState as av, DeepPartial as aw, ObjectMap as ax, AdditionalDataToAgent as ay, AgentAvailability as az, BusEventViewChange as b, RenderWriteableElementResponse as b$, Chunk as b0, CompleteItemChunk as b1, ConnectToHumanAgentItem as b2, ConnectToHumanAgentItemTransferInfo as b3, ConversationalSearchItem as b4, ConversationalSearchItemCitation as b5, DateItem as b6, EventInput as b7, EventInputData as b8, FinalResponseChunk as b9, TextItem as bA, UserDefinedItem as bB, VerticalCellAlignment as bC, VideoItem as bD, WithBodyAndFooter as bF, WithWidthOptions as bG, SingleOption as bH, ChainOfThoughtStep as bJ, GenericItemMessageFeedbackOptions as bL, GenericItemMessageOptions as bM, Message as bN, PartialOrCompleteItemChunk as bO, PartialResponse as bP, MessageHistoryFeedback as bQ, SearchResult as bR, HistoryItem as bT, LauncherCallToActionConfig as bV, LauncherConfig as bW, CdsAiChatContainerAttributes as bX, CdsAiChatCustomElementAttributes as bY, RenderUserDefinedResponse as bZ, RenderUserDefinedState as b_, GenericItem as ba, GenericItemMessageFeedbackCategories as bb, GridItem as bc, HorizontalCellAlignment as bd, IFrameItem as be, ImageItem as bg, InlineErrorItem as bh, ItemStreamingMetadata as bi, MediaItem as bj, MediaItemDimensions as bk, MediaSubtitleTrack as bl, MediaTranscript as bm, MediaFileAccessibility as bn, MessageInput as bo, MessageItemPanelInfo as bq, MessageOutput as br, MessageRequest as bs, MessageResponse as bt, OptionItem as bv, PartialItemChunk as bx, PauseItem as by, StreamChunk as bz, TestId as c1, PersistedState as d, ChatHeaderConfig as e, CustomPanelConfigOptions as f, CustomPanelInstance as g, CustomPanels as h, CustomPanelOpenOptions as i, ChangeFunction as j, ChatInstanceInput as k, ChatInstanceNotifications as l, ChatInstanceServiceDeskActions as m, EventHandlers as n, PublicInputState as o, PublicCustomPanelsState as p, PublicDefaultCustomPanelState as q, PublicChatHumanAgentState as r, PublicChatState as s, WriteableElements as t, BusEvent as v, BusEventHumanAgentAreAnyAgentsOnline as w, BusEventHumanAgentEndChat as x, BusEventHumanAgentPreEndChat as y, BusEventHumanAgentPreReceive as z };