@carbon/ai-chat 1.3.2 → 1.4.0-rc.0

package/dist/types/{serverEntry-ojFJl1OR.d.ts → serverEntry-BZ90jVeY.d.ts}

@@ -1,57 +1,109 @@
-import { NOTIFICATION_KIND } from '@carbon/web-components/es/components/notification/defs.js';
-import { BUTTON_KIND } from '@carbon/web-components/es/components/button/defs.js';
+import { BUTTON_KIND, BUTTON_SIZE } from '@carbon/web-components/es/components/button/defs.js';
+import { CHAT_BUTTON_KIND, CHAT_BUTTON_SIZE } from '@carbon/ai-chat-components/es/react/chat-button.js';
+import { ChainOfThoughtStep } from '@carbon/ai-chat-components/es/components/chain-of-thought/src/types.js';
 import { ReactNode } from 'react';
 import * as lit_html from 'lit-html';
 import { LitElement, PropertyValues } from 'lit';
 import { Root } from 'react-dom/client';
 
 /**
- * Whether a particular Carbon AI Chat view is visible or not.
+ * An enum of all of our data-testid we use. For some elements (like INPUT) they can appear in multiple "panels"
+ * (e.g. on the home screen and in the main chat window). There are provided testids for "panels" as well so you
+ * can first select a panel and then select the correct child.
  *
- * @category Instance
+ * @category Testing
+ *
+ * @experimental
  */
-interface ViewState {
+declare enum PageObjectId {
     /**
-     * Whether the launcher is visible or not.
+     * Minimize chat button in header.
      */
-    launcher: boolean;
+    CLOSE_CHAT = "close_chat",
     /**
-     * Whether the main window is visible or not.
+     * The launcher button to open the chat. This id is maintained across desktop and mobile launchers.
      */
-    mainWindow: boolean;
-}
-/**
- * A record of a notification to be shown in the UI.
- *
- * @experimental
- * @category Instance
- */
-interface NotificationMessage {
-    kind: NOTIFICATION_KIND;
+    LAUNCHER = "launcher_open_chat",
     /**
-     * The title to show in the message.
+     * Input field.
      */
-    title: string;
+    INPUT = "input_field",
     /**
-     * The message to show.
+     * Input send button.
      */
-    message: string;
+    INPUT_SEND = "input_send",
+    /**
+     * The chat header title element.
+     */
+    HEADER_TITLE = "header_title",
+    /**
+     * The chat header name element.
+     */
+    HEADER_NAME = "header_name",
+    /**
+     * The main chat panel.
+     */
+    MAIN_PANEL = "main_panel",
+    /**
+     * Disclaimer panel.
+     */
+    DISCLAIMER_PANEL = "disclaimer_panel",
+    /**
+     * Disclaimer accept button.
+     */
+    DISCLAIMER_ACCEPT_BUTTON = "disclaimer_accept_button",
+    /**
+     * Homescreen Panel.
+     */
+    HOME_SCREEN_PANEL = "home_screen_panel",
+    /**
+     * Hydration/loading state panel.
+     */
+    HYDRATING_PANEL = "hydrating_panel",
+    /**
+     * Catastrophic error panel.
+     */
+    CATASTROPHIC_PANEL = "catastrophic_panel",
+    /**
+     * Iframe panel.
+     */
+    IFRAME_PANEL = "iframe_panel",
+    /**
+     * Conversational search panel.
+     */
+    CONVERSATIONAL_SEARCH_CITATION_PANEL = "conversational_search_citation_panel",
     /**
-     * An optional action button that a user can click. If there is an action button, we will not auto dismiss.
+     * Custom panel.
      */
-    actionButtonLabel?: string;
+    CUSTOM_PANEL = "custom_panel",
     /**
-     * The group id that associates notifications together. This can be used to remove the notification later.
+     * A panel that opens from a button response.
      */
-    groupID?: string;
+    BUTTON_RESPONSE_PANEL = "button_response_panel"
+}
+/**
+ * Ids used for data-testid.
+ *
+ * @category Testing
+ *
+ * @experimental
+ */
+type TestId = PageObjectId;
+
+/**
+ * Whether a particular Carbon AI Chat view is visible or not.
+ *
+ * @category Instance
+ */
+interface ViewState {
     /**
-     * The callback called when someone clicks on the action button.
+     * Whether the launcher is visible or not.
      */
-    onActionButtonClick?: () => void;
+    launcher: boolean;
     /**
-     * The callback called when someone clicks on the close button.
+     * Whether the main window is visible or not.
      */
-    onCloseButtonClick?: () => void;
+    mainWindow: boolean;
 }
 /**
  * The different views that can be shown by Carbon AI Chat.
@@ -181,6 +233,8 @@ interface CustomPanelConfigOptions {
  *
  * When {@link hideBackButton} is set to true, any {@link title} value defined here will override the title/name in
  * the main chat header.
+ *
+ * @category Instance
  */
 interface DefaultCustomPanelConfigOptions {
     /**
@@ -202,9 +256,25 @@ interface DefaultCustomPanelConfigOptions {
 /**
  * Options accepted by {@link CustomPanelInstance.open}. Legacy consumers may continue to pass
  * {@link CustomPanelConfigOptions} until the next major release.
+ *
+ * @category Instance
  */
 type CustomPanelOpenOptions = CustomPanelConfigOptions | DefaultCustomPanelConfigOptions;
 
+/**
+ * @category Config
+ */
+interface ChatHeaderConfig {
+    /**
+     * The chat header title.
+     */
+    title?: string;
+    /**
+     * The name displayed after the title.
+     */
+    name?: string;
+}
+
 /*
  *  Copyright IBM Corp. 2025
  *
@@ -612,63 +682,7 @@ interface ItemStreamingMetadata {
      */
     stream_stopped?: boolean;
 }
-/**
- * Status of the chain of thought step.
- *
- * @category Messaging
- */
-declare enum ChainOfThoughtStepStatus {
-    PROCESSING = "processing",
-    FAILURE = "failure",
-    SUCCESS = "success"
-}
-/**
- * A chain of thought step is meant to show tool calls and other steps made by your agent
- * to reach its final answer.
- *
- * @category Messaging
- */
-interface ChainOfThoughtStep {
-    /**
-     * The plain text name of the step.
-     */
-    title?: string;
-    /**
-     * An optional human readable description of what the tool does.
-     *
-     * Accepts markdown formatted text.
-     */
-    description?: string;
-    /**
-     * The plain text name of the tool called.
-     */
-    tool_name?: string;
-    /**
-     * Optional request metadata sent to a tool.
-     */
-    request?: {
-        /**
-         * Arguments sent to the tool. If this is properly formed JSON, it will be shown as a code block.
-         */
-        args?: unknown;
-    };
-    /**
-     * Optional response from a tool.
-     */
-    response?: {
-        /**
-         * Content returned by the tool. If this is properly formed JSON, it will be shown as a code block.
-         *
-         * You can also return markdown compatible text here.
-         */
-        content: unknown;
-    };
-    /**
-     * Optionally, share the status of this step. An icon will appear in the view showing the status. If no status is
-     * shared, the UI will assume success.
-     */
-    status?: ChainOfThoughtStepStatus;
-}
+
 /**
  * Options that control additional features available for a message item.
  *
@@ -1394,7 +1408,11 @@ interface ButtonItem<TUserDefinedType = Record<string, unknown>> extends BaseGen
     /**
      * The style of button to display.
      */
-    kind?: BUTTON_KIND | "LINK";
+    kind?: BUTTON_KIND | CHAT_BUTTON_KIND | "LINK";
+    /**
+     * The button size.
+     */
+    size?: BUTTON_SIZE | CHAT_BUTTON_SIZE;
     /**
      * The type of button.
      */
@@ -1520,6 +1538,66 @@ interface Chunk {
         response_id: string;
     };
 }
+/**
+ * If the reasoning step is open, closed, or is controlled by Carbon AI Chat.
+ *
+ * If a user elects to open/close the user action will override what is provided here.
+ *
+ * @category Messaging
+ */
+declare enum ReasoningStepOpenState {
+    OPEN = "open",
+    CLOSE = "close",
+    DEFAULT = "default"
+}
+/**
+ * An individual reasoning step.
+ *
+ * @category Messaging
+ */
+interface ReasoningStep {
+    /**
+     * The title of the reasoning step.
+     */
+    title: string;
+    /**
+     * Marks if this individual step is open. Only use this if you don't want the default behavior.
+     *
+     * If the step has content, by default the reasoning step will automatically open and will close when the
+     * next step(s) have content or the first {@link GenericItem} is returned with something to display.
+     *
+     * No matter what you choose, if the user manually marks something open/closed they retain control.
+     */
+    open_state?: ReasoningStepOpenState;
+    /**
+     * Optional markdown content to explain what the step is doing.
+     */
+    content?: string;
+}
+/**
+ * The interface describing how to pass reasoning steps to the UI.
+ *
+ * @category Messaging
+ */
+interface ReasoningSteps {
+    /**
+     * Marks if the reasoning step interface is open. Only use this if you don't want the default behavior.
+     *
+     * By default the reasoning step interface will automatically open and will then close when the first
+     * {@link GenericItem} is returned with something to display.
+     *
+     * No matter what you choose, if the user manually marks something open/closed they retain control.
+     */
+    open_state?: ReasoningStepOpenState;
+    /**
+     * The array of reasoning steps for this message.
+     */
+    steps?: ReasoningStep[];
+    /**
+     * Optional markdown content to explain what the step is doing.
+     */
+    content?: string;
+}
 /**
  * This interface contains options for a {@link MessageResponse}.
  *
@@ -1530,8 +1608,26 @@ interface MessageResponseOptions {
      * This is the profile for the human or assistant who sent or triggered this message.
      */
     response_user_profile?: ResponseUserProfile;
+    /**
+     * Controls the display of the reasoning steps component.
+     *
+     * Most people should use reasoning steps instead of chain of thought.
+     *
+     * Chain of thought it meant more for technical "called X API and got Y result back".
+     *
+     * Reasoning steps can include that kind of detail depending on your use case, but is meant more for user friendly
+     * content than debugging technical internal content.
+     */
+    reasoning?: ReasoningSteps;
     /**
      * Controls the display of the chain of thought component.
+     *
+     * Most people should use reasoning steps instead of chain of thought.
+     *
+     * Chain of thought it meant more for technical "called X API and got Y result back".
+     *
+     * Reasoning steps can include that kind of detail depending on your use case, but is meant more for user friendly
+     * content than debugging technical internal content.
      */
     chain_of_thought?: ChainOfThoughtStep[];
 }
@@ -2957,6 +3053,26 @@ interface BusEventFeedback extends BusEvent {
      */
     categories?: string[];
 }
+/**
+ * This event is fired whenever the public state returned by ChatInstance.getState() changes.
+ * This includes changes to viewState, showUnreadIndicator, and other persisted state.
+ *
+ * @category Events
+ */
+interface BusEventStateChange extends BusEvent {
+    /**
+     * The type of the event.
+     */
+    type: BusEventType.STATE_CHANGE;
+    /**
+     * The previous state before the change.
+     */
+    previousState: PublicChatState;
+    /**
+     * The new state after the change.
+     */
+    newState: PublicChatState;
+}
 
 /**
  * The types here describe the history structure.
@@ -3056,569 +3172,207 @@ interface CustomSendMessageOptions {
 }
 
 /**
- * The subset of HumanAgentState that is persisted to browser storage.
+ * The types of corners the chat can have.
  *
- * @category Instance
+ * @category Config
  */
-interface PersistedHumanAgentState {
-    /** Indicates that the user is connected to a human agent. */
-    isConnected: boolean;
-    /** Indicates if the human agent conversation is currently suspended. */
-    isSuspended: boolean;
-    /** The profile of the last human agent to join the chat. */
-    responseUserProfile?: ResponseUserProfile;
-    /** Cache of known agent profiles by ID. */
-    responseUserProfiles: Record<string, ResponseUserProfile>;
-    /** Arbitrary state saved by the service desk. */
-    serviceDeskState?: unknown;
+declare enum CornersType {
+    /**
+     * Makes the corners on the chat component rounded.
+     */
+    ROUND = "round",
+    /**
+     * Makes the corners on the chat component square.
+     */
+    SQUARE = "square"
 }
 
 /**
- * The interface represents the API contract with the chat widget and contains all the public methods and properties
- * that can be used with Carbon AI Chat.
+ * A conversation starter button on the home screen. Currently, only label is provided by tooling.
  *
- * @category Instance
+ * @category Config
  */
-interface ChatInstance extends EventHandlers, ChatActions {
+interface HomeScreenStarterButton {
     /**
-     * Returns state information of the Carbon AI Chat that could be useful.
+     * The display label of the button. This is also the value that is sent as the user's utterance to the assistant
+     * when the button is clicked.
      */
-    getState: () => PublicChatState;
+    label: string;
     /**
-     * Manager for accessing and controlling custom panels.
+     * Indicates if the button was previously clicked and should be displayed as selected.
      */
-    customPanels?: CustomPanels;
+    isSelected?: boolean;
 }
 /**
- * This is the state made available by calling {@link ChatInstance.getState}. This is a public method that returns immutable values.
+ * Starter buttons that appear on home screen.
  *
- * @category Instance
+ * @category Config
  */
-interface PublicInputState {
-    /**
-     * @experimental Raw text currently queued in the input before being sent to customSendMessage.
-     */
-    rawValue: string;
+interface HomeScreenStarterButtons {
+    isOn?: boolean;
+    buttons?: HomeScreenStarterButton[];
 }
 /**
- * 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"> & {
+ * Configuration for the optional home screen that appears before the assistant chat window.
+ *
+ * @category Config
+ */
+interface HomeScreenConfig {
     /**
-     * Current human agent state.
+     * If the home page is turned on via config or remote config.
      */
-    humanAgent: PublicChatHumanAgentState;
+    isOn?: boolean;
     /**
-     * Counter that indicates if a message is loading and a loading indicator should be displayed.
-     * If "0" then we do not show loading indicator.
+     * The greeting to show to the user to prompt them to start a conversation.
      */
-    isMessageLoadingCounter: number;
+    greeting?: string;
     /**
-     * Optional string to display next to the loading indicator.
+     * Optional conversation starter utterances that are displayed as buttons.
      */
-    isMessageLoadingText?: string;
+    starters?: HomeScreenStarterButtons;
     /**
-     * Counter that indicates if the chat is hydrating and a full screen loading state should be displayed.
+     * Do not show the greeting or starters.
      */
-    isHydratingCounter: number;
+    customContentOnly?: boolean;
     /**
-     * @experimental State representing the main input surface.
+     * Defaults to false. If enabled, a user can not navigate back to the home screen after they have sent a message to the
+     * assistant. If false, the home screen is navigatable after an initial message is sent.
      */
-    input: PublicInputState;
+    disableReturn?: boolean;
+}
+/**
+ * Current state of home screen (currently, limited to if it is open or closed).
+ *
+ * @category Config
+ */
+interface HomeScreenState {
     /**
-     * @experimental State for any surfaced custom panels.
+     * Indicates if the home screen is currently open.
      */
-    customPanels: PublicCustomPanelsState;
-}>;
-interface ChatInstanceInput {
+    isHomeScreenOpen: boolean;
     /**
-     * @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`);
-     * ```
+     * Indicates if the home screen should display a "return to assistant" button. This button is displayed when the user
+     * has clicked the "back to home" button from the assistant.
      */
-    updateRawValue: (updater: (previous: string) => string) => void;
+    showBackToAssistant: boolean;
 }
+
 /**
- * Current connection state of the human agent experience.
+ * These variables map to CSS custom properties used in styling the AI chat interface.
  *
- * @category Instance
- */
-type PublicChatHumanAgentState = Readonly<PersistedHumanAgentState & {
-    /** Indicates if Carbon AI Chat is attempting to connect to an agent. */
-    isConnecting: boolean;
-}>;
-/**
- * This is a subset of the public interface that is managed by the event bus that is used for registering and
- * unregistering event listeners on the bus.
+ * Keys map to the underlying `--cds-aichat-*` custom properties.
  *
- * @category Instance
+ * You can use any standard CSS as the value.
+ *
+ * @category Config
  */
-interface EventHandlers {
+declare enum LayoutCustomProperties {
     /**
-     * Adds the given event handler as a listener for events of the given type.
+     * Float layout only.
+     *
+     * Minimum height of the chat container.
+     *
+     * Defaults to `calc(100vh - 4rem)`
      *
-     * @param handlers The handler or handlers along with the event type to start listening for events.
-     * @returns The instance for method chaining.
      */
-    on: (handlers: TypeAndHandler | TypeAndHandler[]) => EventHandlers;
+    height = "height",
     /**
-     * Removes an event listener that was previously added via {@link on} or {@link once}.
+     * Float layout only.
      *
-     * @param handlers The handler or handlers along with the event type to stop listening for events.
-     * @returns The instance for method chaining.
+     * Maximum height of the chat container (float layout).
+     *
+     * Defaults to `640px`.
      */
-    off: (handlers: TypeAndHandler | TypeAndHandler[]) => EventHandlers;
+    max_height = "max-height",
     /**
-     * Adds the given event handler as a listener for events of the given type. After the first event is handled, this
-     * handler will automatically be removed.
+     * Float layout only.
      *
-     * @param handlers The handler or handlers along with the event type to start listening for an event.
-     * @returns The instance for method chaining.
+     * Width of the chat panel (float layout).
+     *
+     * Defaults to `380px`.
      */
-    once: (handlers: TypeAndHandler | TypeAndHandler[]) => EventHandlers;
-}
-/**
- * The type of handler for event bus events. This function may return a Promise in which case, the bus will await
- * the result and the loop will block until the Promise is resolved.
- *
- * @category Instance
- */
-type EventBusHandler<T extends BusEvent = BusEvent> = (event: T, instance: ChatInstance) => unknown;
-/**
- * The type of the object that is passed to the event bus functions (e.g. "on") when registering a handler.
- *
- * @category Instance
- */
-interface TypeAndHandler {
+    width = "width",
     /**
-     * The type of event this handler is for.
+     * Float layout only.
+     *
+     * z-index of the chat overlay or container (float layout).
+     *
+     * Defaults to `99999`.
      */
-    type: BusEventType;
+    z_index = "z-index",
     /**
-     * The handler for events of this type.
+     * Custom element layouts only.
+     *
+     * Max width of messages area in fullscreen / larger views if {@link LayoutConfig.hascontentmaxwidth} is not set to
+     * true.
+     *
+     * Defaults to `672px`.
      */
-    handler: EventBusHandler;
+    messages_max_width = "messages-max-width"
 }
+
 /**
- * This is a subset of the public interface that provides methods that can be used by the user to control the widget
- * and have it perform certain actions.
+ * Configuration for the launcher.
  *
- * @category Instance
+ * @category Config
  */
-interface ChatActions {
-    /**
-     * Messaging actions for a chat instance.
-     */
-    messaging: ChatInstanceMessaging;
-    /**
-     * This function can be called when another component wishes this component to gain focus. It is up to the
-     * component to decide where focus belongs. This may return true or false to indicate if a suitable focus location
-     * was found.
-     */
-    requestFocus: () => boolean | void;
-    /**
-     * Sends the given message to the assistant on the remote server. This will result in a "pre:send" and "send" event
-     * being fired on the event bus. The returned promise will resolve once a response has received and processed and
-     * both the "pre:receive" and "receive" events have fired. It will reject when too many errors have occurred and
-     * the system gives up retrying.
-     *
-     * @param message The message to send.
-     * @param options Options for the message sent.
-     */
-    send: (message: MessageRequest | string, options?: SendOptions) => Promise<void>;
-    /**
-     * Fire the view:pre:change and view:change events and change the view of the Carbon AI Chat. If a {@link ViewType} is
-     * provided then that view will become visible and the rest will be hidden. If a {@link ViewState} is provided that
-     * includes all of the views then all of the views will be changed accordingly. If a partial {@link ViewState} is
-     * provided then only the views provided will be changed.
-     */
-    changeView: (newView: ViewType | ViewState) => Promise<void>;
-    /**
-     * Returns the list of writable elements.
-     */
-    writeableElements: Partial<WriteableElements>;
-    /**
-     * @deprecated Configure via {@link InputConfig.isVisible}.
-     */
-    updateInputFieldVisibility: (isVisible: boolean) => void;
-    /**
-     * @deprecated Configure via {@link InputConfig.isDisabled}
-     * or {@link PublicConfig.isReadonly}.
-     */
-    updateInputIsDisabled: (isDisabled: boolean) => void;
+interface LauncherConfig {
     /**
-     * @deprecated Configure via {@link LauncherConfig.showUnreadIndicator}.
+     * If the launcher is visible. Defaults to true.
      */
-    updateAssistantUnreadIndicatorVisibility: (isVisible: boolean) => void;
+    isOn?: boolean;
     /**
-     * Scrolls to the (original) message with the given ID. Since there may be multiple message items in a given
-     * message, this will scroll the first message to the top of the message window.
-     *
-     * @param messageID The (original) message ID to scroll to.
-     * @param animate Whether or not the scroll should be animated. Defaults to true.
+     * Controls whether the unread indicator dot shows even when no human-agent unread count exists.
      */
-    scrollToMessage: (messageID: string, animate?: boolean) => void;
+    showUnreadIndicator?: boolean;
     /**
-     * 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.
-     *
-     * @deprecated Use {@link ChatInstanceMessaging.restartConversation} instead.
+     * Properties specific to the mobile launcher.
      */
-    restartConversation: () => Promise<void>;
+    mobile?: LauncherCallToActionConfig;
     /**
-     * Initiates a doAutoScroll on the currently visible chat panel.
+     * Properties specific to the desktop launcher.
      */
-    doAutoScroll: () => void;
+    desktop?: LauncherCallToActionConfig;
+}
+/**
+ * @category Config
+ */
+interface LauncherCallToActionConfig {
     /**
-     * @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.
+     * If the launcher will have a call to action expanded state. Defaults to false. This feature will be removed in
+     * the next major release of the AI Chat.
      *
-     * 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.
+     * @deprecated
      */
-    updateIsMessageLoadingCounter: (direction: IncreaseOrDecrease, message?: string) => void;
+    isOn?: boolean;
     /**
-     * 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. "reset" will set the value back to 0.
+     * The title that will be used by the expanded state of the launcher. If nothing is set in the config then a default
+     * translated string will be used.
      *
-     * You can access the current value via {@link ChatInstance.getState}.
+     * @deprecated
      */
-    updateIsChatLoadingCounter: (direction: IncreaseOrDecrease) => void;
+    title?: string;
     /**
-     * The state of notifications in the chat.
+     * The amount of time to wait before extending the launcher. If nothing is set then the default time of
+     * 15s will be used.
      *
-     * @experimental
-     */
-    notifications: ChatInstanceNotifications;
-    /**
-     * Actions for mutating the chat input contents.
-     */
-    input: ChatInstanceInput;
-    /**
-     * Actions that are related to a service desk integration.
+     * @deprecated
      */
-    serviceDesk: ChatInstanceServiceDeskActions;
+    timeToExpand?: number;
     /**
-     * Remove any record of the current session from the browser's SessionStorage.
-     *
-     * @param keepOpenState If we are destroying the session to restart the chat this can be used to preserve if the web
-     * chat is open.
+     * An optional override of the icon shown on the launcher.
      */
-    destroySession: (keepOpenState?: boolean) => Promise<void>;
+    avatarUrlOverride?: string;
 }
+
 /**
- * @category Instance
+ * This file contains the definition for the public application configuration operations that are provided by the
+ * host page.
  */
-type IncreaseOrDecrease = "increase" | "decrease" | "reset" | undefined;
 /**
- * This interface represents the options for when a MessageRequest is sent to the server with the send method.
+ * The raw strings used for {@link PublicConfig.strings}. Presented in ICU format.
  *
- * @category Instance
- */
-interface SendOptions {
-    /**
-     * If you want to send a message to the API, but NOT have it show up in the UI, set this to true. The "pre:send"
-     * and "send" events will still be fired but the message will not be added to the local message list displayed in
-     * the UI. Note that the response message will still be added.
-     */
-    silent?: boolean;
-}
-/**
- * An object of elements we expose to developers to write to. Be sure to check the documentation of the React or
- * web component you are using for how to make use of this, as it differs based on implementation.
- *
- * @category Instance
- */
-type WriteableElements = Record<WriteableElementName, HTMLElement>;
-/**
- * @category Instance
- */
-declare enum WriteableElementName {
-    /**
-     * An element that appears in the AI theme only and is shown beneath the title and description in the AI tooltip
-     * content.
-     */
-    AI_TOOLTIP_AFTER_DESCRIPTION_ELEMENT = "aiTooltipAfterDescriptionElement",
-    /**
-     * An element that appears in the main message body directly above the welcome node.
-     */
-    WELCOME_NODE_BEFORE_ELEMENT = "welcomeNodeBeforeElement",
-    /**
-     * An element that appears in the header on a new line. Only visible while talking to the assistant.
-     */
-    HEADER_BOTTOM_ELEMENT = "headerBottomElement",
-    /**
-     * An element that appears after the messages area and before the input area.
-     */
-    BEFORE_INPUT_ELEMENT = "beforeInputElement",
-    /**
-     * An element that appears above the input field on the home screen.
-     */
-    HOME_SCREEN_BEFORE_INPUT_ELEMENT = "homeScreenBeforeInputElement",
-    /**
-     * An element that appears on the home screen after the conversation starters.
-     */
-    HOME_SCREEN_AFTER_STARTERS_ELEMENT = "homeScreenAfterStartersElement",
-    /**
-     * An element that appears on the home screen above the welcome message and conversation starters.
-     */
-    HOME_SCREEN_HEADER_BOTTOM_ELEMENT = "homeScreenHeaderBottomElement",
-    /**
-     * An element to be housed in the custom panel.
-     */
-    CUSTOM_PANEL_ELEMENT = "customPanelElement"
-}
-/**
- * Add notification messages to the chat. This component has some a11y bugs before we can mark it complete.
- *
- * @category Instance
- *
- * @experimental
- */
-interface ChatInstanceNotifications {
-    /**
-     * Add a system level notification to the list of system notifications.
-     */
-    addNotification: (notification: NotificationMessage) => void;
-    /**
-     * Remove a system level notification from the list of system notifications.
-     */
-    removeNotifications: (groupID: string) => void;
-    /**
-     * Remove all system level notifications from the list of system notifications.
-     */
-    removeAllNotifications: () => void;
-}
-/**
- * @category Instance
- */
-type ChangeFunction = (text: string) => void;
-/**
- * Upload options. Currently only applies to conversations with a human agent.
- *
- * @category Instance
- */
-interface FileUploadCapabilities {
-    /**
-     * Indicates that file uploads may be performed by the user.
-     */
-    allowFileUploads: boolean;
-    /**
-     * If file uploads are allowed, this indicates if more than one file may be selected at a time. The default is false.
-     */
-    allowMultipleFileUploads: boolean;
-    /**
-     * If file uploads are allowed, this is the set a file types that are allowed. This is filled into the "accept"
-     * field for the file input element.
-     */
-    allowedFileUploadTypes: string;
-}
-/**
- * Start or end conversations with human agent.
- *
- * @category Instance
- */
-interface ChatInstanceServiceDeskActions {
-    /**
-     * Ends the conversation with a human agent. This does not request confirmation from the user first. If the user
-     * is not connected or connecting to a human agent, this function has no effect. You can determine if the user is
-     * connected or connecting by calling {@link ChatInstance.getState}. Note that this function
-     * returns a Promise that only resolves when the conversation has ended. This includes after the
-     * {@link BusEventType.HUMAN_AGENT_PRE_END_CHAT} and {@link BusEventType.HUMAN_AGENT_END_CHAT} events have been fired and
-     * resolved.
-     */
-    endConversation: () => Promise<void>;
-    /**
-     * Sets the suspended state for an agent conversation. A conversation can be suspended or un-suspended only if the
-     * user is currently connecting or connected to an agent. If a conversation is suspended, then messages from the user
-     * will no longer be routed to the service desk and incoming messages from the service desk will not be displayed. In
-     * addition, the current connection status with an agent will not be shown.
-     */
-    updateIsSuspended: (isSuspended: boolean) => Promise<void>;
-}
-
-/**
- * The types of corners the chat can have.
- *
- * @category Config
- */
-declare enum CornersType {
-    /**
-     * Makes the corners on the chat component rounded.
-     */
-    ROUND = "round",
-    /**
-     * Makes the corners on the chat component square.
-     */
-    SQUARE = "square"
-}
-
-/**
- * A conversation starter button on the home screen. Currently, only label is provided by tooling.
- *
- * @category Config
- */
-interface HomeScreenStarterButton {
-    /**
-     * The display label of the button. This is also the value that is sent as the user's utterance to the assistant
-     * when the button is clicked.
-     */
-    label: string;
-    /**
-     * Indicates if the button was previously clicked and should be displayed as selected.
-     */
-    isSelected?: boolean;
-}
-/**
- * Starter buttons that appear on home screen.
- *
- * @category Config
- */
-interface HomeScreenStarterButtons {
-    isOn?: boolean;
-    buttons?: HomeScreenStarterButton[];
-}
-/**
- * Configuration for the optional home screen that appears before the assistant chat window.
- *
- * @category Config
- */
-interface HomeScreenConfig {
-    /**
-     * If the home page is turned on via config or remote config.
-     */
-    isOn?: boolean;
-    /**
-     * The greeting to show to the user to prompt them to start a conversation.
-     */
-    greeting?: string;
-    /**
-     * Optional conversation starter utterances that are displayed as buttons.
-     */
-    starters?: HomeScreenStarterButtons;
-    /**
-     * Do not show the greeting or starters.
-     */
-    customContentOnly?: boolean;
-    /**
-     * Defaults to false. If enabled, a user can not navigate back to the home screen after they have sent a message to the
-     * assistant. If false, the home screen is navigatable after an initial message is sent.
-     */
-    disableReturn?: boolean;
-}
-/**
- * Current state of home screen (currently, limited to if it is open or closed).
- *
- * @category Config
- */
-interface HomeScreenState {
-    /**
-     * Indicates if the home screen is currently open.
-     */
-    isHomeScreenOpen: boolean;
-    /**
-     * Indicates if the home screen should display a "return to assistant" button. This button is displayed when the user
-     * has clicked the "back to home" button from the assistant.
-     */
-    showBackToAssistant: boolean;
-}
-
-/**
- * Valid public CSS variables that can be controlled when white labeling is disabled.
- * These variables map to CSS custom properties used in styling the AI chat interface.
- *
- * Keys map to the underlying `--cds-aichat-…` custom properties.
- *
- * @category Config
- */
-declare enum LayoutCustomProperties {
-    /** Minimum height of the chat container (float layout). */
-    height = "height",
-    /** Maximum height of the chat container (float layout). */
-    max_height = "max-height",
-    /** Width of the chat panel (float layout). */
-    width = "width",
-    /** z-index of the chat overlay or container (float layout). */
-    z_index = "z-index"
-}
-
-/**
- * Configuration for the launcher.
- *
- * @category Config
- */
-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.
-     */
-    mobile?: LauncherCallToActionConfig;
-    /**
-     * Properties specific to the desktop launcher.
-     */
-    desktop?: LauncherCallToActionConfig;
-}
-/**
- * @category Config
- */
-interface LauncherCallToActionConfig {
-    /**
-     * If the launcher will expand with a call to action.
-     */
-    isOn?: boolean;
-    /**
-     * The title that will be used by the expanded state of the launcher. If nothing is set in the config then a default
-     * translated string will be used.
-     */
-    title?: string;
-    /**
-     * The amount of time to wait before extending the launcher. If nothing is set then the default time of
-     * 15s will be used.
-     */
-    timeToExpand?: number;
-    /**
-     * An optional override of the icon shown on the launcher.
-     */
-    avatarUrlOverride?: string;
-}
-
-/**
- * This file contains the definition for the public application configuration operations that are provided by the
- * host page.
- */
-/**
- * The raw strings used for {@link PublicConfig.strings}. Presented in ICU format.
- *
- * @category Config
+ * @category Config
  */
 declare const enLanguagePack: {
     ai_slug_label: string;
@@ -3669,6 +3423,7 @@ declare const enLanguagePack: {
     messages_searchResultsCollapse: string;
     messages_assistantIsLoading: string;
     messages_agentIsTyping: string;
+    messages_focusHandle: string;
     messages_scrollHandle: string;
     messages_scrollHandleDetailed: string;
     messages_scrollHandleEnd: string;
@@ -3676,7 +3431,6 @@ declare const enLanguagePack: {
     messages_scrollMoreButton: string;
     message_labelAssistant: string;
     message_labelYou: string;
-    notifications_toastClose: string;
     buttons_restart: string;
     buttons_cancel: string;
     buttons_retry: string;
@@ -3768,7 +3522,6 @@ declare const enLanguagePack: {
     conversationalSearch_citationsLabel: string;
     conversationalSearch_toggleCitations: string;
     conversationalSearch_responseStopped: string;
-    launcher_chatNow: string;
     iframe_ariaSourceLoaded: string;
     iframe_ariaImageAltText: string;
     iframe_ariaClosePanel: string;
@@ -3795,6 +3548,14 @@ declare const enLanguagePack: {
     table_itemsPerPage: string;
     table_paginationSupplementalText: string;
     table_paginationStatus: string;
+    codeSnippet_feedback: string;
+    codeSnippet_showLessText: string;
+    codeSnippet_showMoreText: string;
+    codeSnippet_tooltipContent: string;
+    codeSnippet_lineCount: string;
+    codeSnippet_foldCollapse: string;
+    codeSnippet_foldExpand: string;
+    table_downloadButton: string;
     feedback_positiveLabel: string;
     feedback_negativeLabel: string;
     feedback_defaultTitle: string;
@@ -3812,500 +3573,874 @@ declare const enLanguagePack: {
     chainOfThought_statusFailedLabel: string;
     chainOfThought_statusProcessingLabel: string;
     chainOfThought_explainabilityLabel: string;
+    reasoningSteps_mainLabelOpen: string;
+    reasoningSteps_mainLabelClosed: string;
 };
 /**
- * A language pack represents the set of display strings for a particular language.
- * It defines all the text strings that can be customized for different languages.
- *
+ * A language pack represents the set of display strings for a particular language.
+ * It defines all the text strings that can be customized for different languages.
+ *
+ * @category Config
+ */
+type LanguagePack = typeof enLanguagePack;
+/**
+ * Configuration interface for Carbon AI Chat.
+ *
+ * @category Config
+ */
+interface PublicConfig {
+    /**
+     * This is a one-off listener for catastrophic errors. This is used instead of a normal event bus handler because this function can be
+     * defined and called before the event bus has been created.
+     */
+    onError?: (data: OnErrorData) => void;
+    /**
+     * By default, the chat window will be rendered in a "closed" state.
+     */
+    openChatByDefault?: boolean;
+    /**
+     * Disclaimer screen configuration.
+     *
+     * If `disclaimerHTML` changes after the disclaimer has been accepted, we request a user to accept again.
+     */
+    disclaimer?: DisclaimerPublicConfig;
+    /**
+     * This value is only used when a custom element is being used to render the widget. By default, a number of
+     * enhancements to the widget are activated on mobile devices which can interfere with a custom element. This
+     * value can be used to disable those enhancements while using a custom element.
+     */
+    disableCustomElementMobileEnhancements?: boolean;
+    /**
+     * Add a bunch of noisy console.log messages!
+     */
+    debug?: boolean;
+    /**
+     * Which Carbon theme tokens to inject. If unset (falsy), the chat inherits tokens from the host page.
+     * Set to a specific theme to force token injection.
+     */
+    injectCarbonTheme?: CarbonTheme;
+    /**
+     * Enables Carbon AI theme styling. Defaults to true.
+     */
+    aiEnabled?: boolean;
+    /**
+     * This is a factory for producing custom implementations of service desks. If this value is set, then this will
+     * be used to create an instance of a {@link ServiceDesk} when the user attempts to connect to an agent.
+     *
+     * If it is changed in the middle of a conversation (you should obviously avoid this) the conversation with the
+     * human agent will be disconnected.
+     */
+    serviceDeskFactory?: (parameters: ServiceDeskFactoryParameters) => Promise<ServiceDesk>;
+    /**
+     * Any public config to apply to service desks.
+     */
+    serviceDesk?: ServiceDeskPublicConfig;
+    /**
+     * If the Carbon AI Chat should grab focus if the chat is open on page load.
+     */
+    shouldTakeFocusIfOpensAutomatically?: boolean;
+    /**
+     * An optional namespace that can be added to the Carbon AI Chat that must be 30 characters or under. This value is
+     * intended to enable multiple instances of the Carbon AI Chat to be used on the same page. The namespace for this web
+     * chat. This value is used to generate a value to append to anything unique (id, session keys, etc) to allow
+     * multiple Carbon AI Chats on the same page.
+     *
+     * Note: this value is used in the aria region label for the Carbon AI Chat. This means this value will be read out loud
+     * by users using a screen reader.
+     */
+    namespace?: string;
+    /**
+     * Indicates if Carbon AI Chat should sanitize HTML from the assistant.
+     */
+    shouldSanitizeHTML?: boolean;
+    /**
+     * Extra config for controlling the behavior of the header.
+     */
+    header?: HeaderConfig;
+    /**
+     * The config object for changing Carbon AI Chat's layout.
+     */
+    layout?: LayoutConfig;
+    /**
+     * Config options for controlling messaging.
+     */
+    messaging?: PublicConfigMessaging;
+    /**
+     * Sets the chat into a read only mode for displaying old conversations.
+     */
+    isReadonly?: boolean;
+    /**
+     * Sets the name of the assistant. Defaults to "watsonx". Used in screen reader announcements and error messages.
+     */
+    assistantName?: string;
+    /**
+     * The locale to use for the widget. This controls the language pack and regional formatting.
+     * Example values include: 'en', 'en-us', 'fr', 'es'.
+     */
+    locale?: string;
+    /**
+     * Configuration for the homescreen.
+     *
+     * If you change anything but `is_on` after the chat session has started, the chat will handle it gracefully.
+     *
+     * If you turn on the homescreen after the user has already started chatting, it will show up in the header as
+     * an icon, but the user won't be forced to go back to the homescreen (unlike turning on the disclaimer mid-chat).
+     */
+    homescreen?: HomeScreenConfig;
+    /**
+     * Configuration for the launcher.
+     */
+    launcher?: LauncherConfig;
+    /**
+     * Configuration for the main input field on the chat.
+     */
+    input?: InputConfig;
+    /**
+     * Optional partial language pack overrides. Values merge with defaults.
+     */
+    strings?: DeepPartial<LanguagePack>;
+}
+/**
+ * A single menu option.
+ *
+ * @category Config
+ */
+interface CustomMenuOption {
+    /**
+     * The text to display for the menu option.
+     */
+    text: string;
+    /**
+     * The callback handler to call when the option is selected. Provide this of "url".
+     */
+    handler: () => void;
+}
+/**
+ * @category Config
+ */
+declare enum MinimizeButtonIconType {
+    /**
+     * This shows an "X" icon.
+     */
+    CLOSE = "close",
+    /**
+     * This shows a "-" icon.
+     */
+    MINIMIZE = "minimize",
+    /**
+     * This shows an icon that indicates that the Carbon AI Chat can be collapsed into a side panel.
+     */
+    SIDE_PANEL_LEFT = "side-panel-left",
+    /**
+     * This shows an icon that indicates that the Carbon AI Chat can be collapsed into a side panel.
+     */
+    SIDE_PANEL_RIGHT = "side-panel-right"
+}
+/**
+ * Configuration for the input field in the main chat and homescreen.
+ *
+ * @category Config
+ */
+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.
+ *
+ * @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.
+     */
+    minimizeButtonIconType?: MinimizeButtonIconType;
+    /**
+     * Hide the ability to minimize the Carbon AI Chat.
+     */
+    hideMinimizeButton?: boolean;
+    /**
+     * If true, shows the restart conversation button in the header of home screen and main chat.
+     */
+    showRestartButton?: boolean;
+    /**
+     * The chat header title.
+     */
+    title?: string;
+    /**
+     * The name displayed after the title.
+     */
+    name?: string;
+    /**
+     * All the currently configured custom menu options.
+     */
+    menuOptions?: CustomMenuOption[];
+    /**
+     * Controls whether to show the AI label/slug in the header. Defaults to true.
+     *
+     * There is currently no version of this that does not include the AI theme
+     * blue gradients.
+     */
+    showAiLabel?: boolean;
+}
+/**
+ * @category Config
+ */
+interface LayoutConfig {
+    /**
+     * Indicates if the Carbon AI Chat widget should keep its border and box-shadow.
+     */
+    showFrame?: boolean;
+    /**
+     * Indicates if content inside the Carbon AI Chat widget should be constrained to a max-width.
+     *
+     * At larger widths the card, carousel, options and conversational search response types
+     * have pending issues.
+     */
+    hasContentMaxWidth?: boolean;
+    /**
+     * This flag is used to disable Carbon AI Chat's rounded corners.
+     */
+    corners?: CornersType;
+    /**
+     * CSS variable overrides for the chat UI.
+     *
+     * Keys correspond to values from `LayoutCustomProperties` (e.g. `LayoutCustomProperties.height`),
+     * which map to the underlying `--cds-aichat-…` custom properties.
+     * Values are raw CSS values such as `"420px"`, `"9999"`, etc.
+     *
+     * Example:
+     * { height: "560px", width: "420px" }
+     */
+    customProperties?: Partial<Record<LayoutCustomProperties, string>>;
+}
+/**
+ * Config options for controlling messaging.
+ *
+ * @category Config
+ */
+interface PublicConfigMessaging {
+    /**
+     * Indicates if Carbon AI Chat should make a request for the welcome message when a new conversation begins. If this is
+     * true, then Carbon AI Chat will start with an empty conversation.
+     *
+     * **Manual session management required**: Changes to this property after conversation has started have no effect.
+     * To apply new welcome behavior, call `instance.messaging.restartConversation()`.
+     */
+    skipWelcome?: boolean;
+    /**
+     * 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.  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 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;
+    /**
+     * A callback for Carbon AI Chat to use to send messages to your assistant.
+     *
+     * Carbon AI Chat will queue up any additional user messages until the Promise from a previous call to customSendMessage
+     * has resolved. If you do not make customSendMessage async, it will be up to you to manage what happens when a message is
+     * sent when the previous is still processing. If the Promise rejects, an error indicator will be displayed next to the user's message.
+     *
+     * If the request takes longer than PublicConfigMessaging.messageTimeoutSecs than the AbortSignal will be sent.
+     */
+    customSendMessage?: (request: MessageRequest, requestOptions: CustomSendMessageOptions, instance: ChatInstance) => Promise<void> | void;
+    /**
+     * This is a callback function that is used by Carbon AI Chat to retrieve history data for populating the Carbon AI Chat. If
+     * this function is defined, it will be used instead of any other mechanism for fetching history.
+     *
+     * If this function is mutated after it was initially called, the chat does not re-call it.
+     */
+    customLoadHistory?: (instance: ChatInstance) => Promise<HistoryItem[]>;
+}
+/**
  * @category Config
  */
-type LanguagePack = typeof enLanguagePack;
+interface DisclaimerPublicConfig {
+    /**
+     * If the disclaimer is turned on.
+     */
+    isOn: boolean;
+    /**
+     * HTML content to show in disclaimer.
+     */
+    disclaimerHTML: string;
+}
 /**
- * Configuration interface for Carbon AI Chat.
+ * A string identifying what Carbon Theme we should base UI variables off of.
+ * Defaults to "inherit". If you are not hosting the chat on a website that is Carbon styles, you will want to choose
+ * once of the non-inherited values to inject the correct CSS custom property values into the code. See
+ * https://carbondesignsystem.com/guidelines/color/tokens.
  *
  * @category Config
  */
-interface PublicConfig {
+declare enum CarbonTheme {
     /**
-     * This is a one-off listener for catastrophic errors. This is used instead of a normal event bus handler because this function can be
-     * defined and called before the event bus has been created.
+     * Injects Carbon white theme tokens.
      */
-    onError?: (data: OnErrorData) => void;
+    WHITE = "white",
     /**
-     * By default, the chat window will be rendered in a "closed" state.
+     * Injects Carbon Gray 10 theme tokens.
      */
-    openChatByDefault?: boolean;
+    G10 = "g10",
     /**
-     * Disclaimer screen configuration.
-     *
-     * If `disclaimerHTML` changes after the disclaimer has been accepted, we request a user to accept again.
+     * Injects Carbon Gray 90 theme tokens.
      */
-    disclaimer?: DisclaimerPublicConfig;
+    G90 = "g90",
     /**
-     * This value is only used when a custom element is being used to render the widget. By default, a number of
-     * enhancements to the widget are activated on mobile devices which can interfere with a custom element. This
-     * value can be used to disable those enhancements while using a custom element.
+     * Injects Carbon Gray 100 theme tokens.
      */
-    disableCustomElementMobileEnhancements?: boolean;
+    G100 = "g100"
+}
+/**
+ * The different categories of errors that the system can record. These values are published for end user consumption.
+ *
+ * @category Config
+ */
+declare enum OnErrorType {
     /**
-     * Add a bunch of noisy console.log messages!
+     * Indicates an error sending a message to the assistant. This error is only generated after all retries have
+     * failed and the system has given up.
      */
-    debug?: boolean;
+    MESSAGE_COMMUNICATION = "MESSAGE_COMMUNICATION",
     /**
-     * Which Carbon theme tokens to inject. If unset (falsy), the chat inherits tokens from the host page.
-     * Set to a specific theme to force token injection.
+     * This indicates an error in one of the components that occurs as part of rendering the UI.
      */
-    injectCarbonTheme?: CarbonTheme;
+    RENDER = "RENDER",
     /**
-     * Enables Carbon AI theme styling. Defaults to true.
+     * This indicates a known error with the configuration for a service desk. Fired when a connect_to_agent
+     * response type is received, but none is configured.
      */
-    aiEnabled?: boolean;
+    INTEGRATION_ERROR = "INTEGRATION_ERROR",
     /**
-     * This is a factory for producing custom implementations of service desks. If this value is set, then this will
-     * be used to create an instance of a {@link ServiceDesk} when the user attempts to connect to an agent.
-     *
-     * If it is changed in the middle of a conversation (you should obviously avoid this) the conversation with the
-     * human agent will be disconnected.
+     * This indicates that some error occurred while trying to hydrate the chat. This will prevent the chat from
+     * functioning.
      */
-    serviceDeskFactory?: (parameters: ServiceDeskFactoryParameters) => Promise<ServiceDesk>;
+    HYDRATION = "HYDRATION"
+}
+/**
+ * Fired when a serious error in the chat occurs.
+ *
+ * @category Config
+ */
+interface OnErrorData {
     /**
-     * Any public config to apply to service desks.
+     * The type of error that occurred.
      */
-    serviceDesk?: ServiceDeskPublicConfig;
+    errorType: OnErrorType;
     /**
-     * If the Carbon AI Chat should grab focus if the chat is open on page load.
+     * A message associated with the error.
      */
-    shouldTakeFocusIfOpensAutomatically?: boolean;
+    message: string;
     /**
-     * An optional namespace that can be added to the Carbon AI Chat that must be 30 characters or under. This value is
-     * intended to enable multiple instances of the Carbon AI Chat to be used on the same page. The namespace for this web
-     * chat. This value is used to generate a value to append to anything unique (id, session keys, etc) to allow
-     * multiple Carbon AI Chats on the same page.
-     *
-     * Note: this value is used in the aria region label for the Carbon AI Chat. This means this value will be read out loud
-     * by users using a screen reader.
+     * An extra blob of data associated with the error. This may be a stack trace for thrown errors.
      */
-    namespace?: string;
+    otherData?: unknown;
     /**
-     * Indicates if Carbon AI Chat should sanitize HTML from the assistant.
+     * If the error is of the severity that requires a whole restart of Carbon AI Chat.
      */
-    shouldSanitizeHTML?: boolean;
+    catastrophicErrorType?: boolean;
+}
+
+/**
+ * A TypeScript definition file for ObjectMap.
+ */
+/**
+ * This interface represents an object which behaves like a map. The object contains a set of properties representing
+ * keys in the map and the values of those properties are all of the same type (TPropertyType). The type of the keys
+ * defaults to any string but you can specify a type that is a string enum instead if you want a map that contains
+ * only keys for a given enum (or other similar type).
+ *
+ * @category Utilities
+ */
+type ObjectMap<TPropertyType, TKeyType extends string | number = string> = Partial<Record<TKeyType, TPropertyType>>;
+
+/**
+ * The subset of HumanAgentState that is persisted to browser storage.
+ *
+ * @category Instance
+ */
+interface PersistedHumanAgentState {
+    /** Indicates that the user is connected to a human agent. */
+    isConnected: boolean;
+    /** Indicates if the human agent conversation is currently suspended. */
+    isSuspended: boolean;
+    /** The profile of the last human agent to join the chat. */
+    responseUserProfile?: ResponseUserProfile;
+    /** Cache of known agent profiles by ID. */
+    responseUserProfiles: Record<string, ResponseUserProfile>;
+    /** Arbitrary state saved by the service desk. */
+    serviceDeskState?: unknown;
+}
+
+/**
+ * Items stored in sessionStorage.
+ *
+ * @category Instance
+ */
+interface PersistedState {
     /**
-     * Extra config for controlling the behavior of the header.
+     * Indicates if this state was loaded from browser session storage or if was created as part of a new session.
      */
-    header?: HeaderConfig;
+    wasLoadedFromBrowser: boolean;
     /**
-     * The config object for changing Carbon AI Chat's layout.
+     * The version of the Carbon AI Chat that this data is persisted for. If there are any breaking changes to the
+     * application state and a user reloads and gets a new version of the widget, bad things might happen so we'll
+     * just invalidate the persisted storage if we ever attempt to load an old version on Carbon AI Chat startup.
      */
-    layout?: LayoutConfig;
+    version: string;
     /**
-     * Config options for controlling messaging.
+     * Indicates which of the Carbon AI Chat views are visible and which are hidden.
      */
-    messaging?: PublicConfigMessaging;
+    viewState: ViewState;
     /**
-     * Sets the chat into a read only mode for displaying old conversations.
+     * Indicates if we should show an unread indicator on the launcher. This is set by
+     * {@link ChatInstance.updateAssistantUnreadIndicatorVisibility} and will display an empty circle on
+     * the launcher. This setting is overridden if there are any unread human agent messages in which case a circle
+     * with a number is displayed.
      */
-    isReadonly?: boolean;
+    showUnreadIndicator: boolean;
     /**
-     * Sets the name of the assistant. Defaults to "watsonx". Used in screen reader announcements and error messages.
+     * Indicates if the launcher should be in the expanded state.
      */
-    assistantName?: string;
+    launcherIsExpanded: boolean;
     /**
-     * The locale to use for the widget. This controls the language pack and regional formatting.
-     * Example values include: 'en', 'en-us', 'fr', 'es'.
+     * Determines if the launcher should start a timer to show its expanded state.
      */
-    locale?: string;
+    launcherShouldStartCallToActionCounterIfEnabled: boolean;
     /**
-     * Configuration for the homescreen.
-     *
-     * If you change anything but `is_on` after the chat session has started, the chat will handle it gracefully.
-     *
-     * If you turn on the homescreen after the user has already started chatting, it will show up in the header as
-     * an icon, but the user won't be forced to go back to the homescreen (unlike turning on the disclaimer mid-chat).
+     * If the user has received a message beyond the welcome node. We use this to mark if the chat has been interacted
+     * with. This flag is duplicated so the information is available before hydration and before the user is known.
+     * Note that this property reflects only the last user and should only be used when an approximate value is
+     * acceptable.
      */
-    homescreen?: HomeScreenConfig;
+    hasSentNonWelcomeMessage: boolean;
     /**
-     * Configuration for the launcher.
+     * Map of if a disclaimer has been accepted on a given window.hostname value, keyed by hostname via
+     * {@link ObjectMap}.
      */
-    launcher?: LauncherConfig;
+    disclaimersAccepted: ObjectMap<boolean>;
     /**
-     * Configuration for the main input field on the chat.
+     * State of home screen.
      */
-    input?: InputConfig;
+    homeScreenState: HomeScreenState;
     /**
-     * Optional partial language pack overrides. Values merge with defaults.
+     * The persisted subset of the human agent state.
      */
-    strings?: DeepPartial<LanguagePack>;
+    humanAgentState: PersistedHumanAgentState;
 }
+
 /**
- * A single menu option.
+ * The interface represents the API contract with the chat widget and contains all the public methods and properties
+ * that can be used with Carbon AI Chat.
  *
- * @category Config
+ * @category Instance
  */
-interface CustomMenuOption {
+interface ChatInstance extends EventHandlers, ChatActions {
     /**
-     * The text to display for the menu option.
+     * Returns state information of the Carbon AI Chat that could be useful.
      */
-    text: string;
+    getState: () => PublicChatState;
     /**
-     * The callback handler to call when the option is selected. Provide this of "url".
+     * Manager for accessing and controlling custom panels.
      */
-    handler: () => void;
+    customPanels?: CustomPanels;
 }
 /**
- * @category Config
+ * This is the state made available by calling {@link ChatInstance.getState}. This is a public method that returns immutable values.
+ *
+ * @category Instance
  */
-declare enum MinimizeButtonIconType {
-    /**
-     * This shows an "X" icon.
-     */
-    CLOSE = "close",
-    /**
-     * This shows a "-" icon.
-     */
-    MINIMIZE = "minimize",
-    /**
-     * This shows an icon that indicates that the Carbon AI Chat can be collapsed into a side panel.
-     */
-    SIDE_PANEL_LEFT = "side-panel-left",
+interface PublicInputState {
     /**
-     * This shows an icon that indicates that the Carbon AI Chat can be collapsed into a side panel.
+     * @experimental Raw text currently queued in the input before being sent to customSendMessage.
      */
-    SIDE_PANEL_RIGHT = "side-panel-right"
+    rawValue: string;
 }
 /**
- * Configuration for the input field in the main chat and homescreen.
+ * Represents public state for default custom panel.
+ *
+ * @category Instance
+ */
+interface PublicDefaultCustomPanelState {
+    /** Indicates if the default custom panel overlay is currently open. */
+    isOpen: boolean;
+}
+/**
+ * Represents public state for each supported custom panel variant.
  *
- * @category Config
+ * @category Instance
  */
-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;
+interface PublicCustomPanelsState {
+    /** State for the default overlay-style custom panel. */
+    default: PublicDefaultCustomPanelState;
 }
 /**
- * Configuration for the main header of the chat.
+ * Type returned by {@link ChatInstance.getState}.
  *
- * @category Config
+ * @category Instance
  */
-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;
+type PublicChatState = Readonly<Omit<PersistedState, "humanAgentState"> & {
     /**
-     * Indicates the icon to use for the close button in the header.
+     * Current human agent state.
      */
-    minimizeButtonIconType?: MinimizeButtonIconType;
+    humanAgent: PublicChatHumanAgentState;
     /**
-     * Hide the ability to minimize the Carbon AI Chat.
+     * Counter that indicates if a message is loading and a loading indicator should be displayed.
+     * If "0" then we do not show loading indicator.
      */
-    hideMinimizeButton?: boolean;
+    isMessageLoadingCounter: number;
     /**
-     * If true, shows the restart conversation button in the header of home screen and main chat.
+     * Optional string to display next to the loading indicator.
      */
-    showRestartButton?: boolean;
+    isMessageLoadingText?: string;
     /**
-     * The chat header title.
+     * Counter that indicates if the chat is hydrating and a full screen loading state should be displayed.
      */
-    title?: string;
+    isHydratingCounter: number;
     /**
-     * The name displayed after the title.
+     * @experimental State representing the main input surface.
      */
-    name?: string;
+    input: PublicInputState;
     /**
-     * All the currently configured custom menu options.
+     * @experimental State for any surfaced custom panels.
      */
-    menuOptions?: CustomMenuOption[];
+    customPanels: PublicCustomPanelsState;
+}>;
+/**
+ * Methods for controlling the input field.
+ *
+ * @category Instance
+ */
+interface ChatInstanceInput {
     /**
-     * Controls whether to show the AI label/slug in the header. Defaults to true.
+     * @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.
      *
-     * There is currently no version of this that does not include the AI theme
-     * blue gradients.
+     * @example
+     * ```ts
+     * instance.input.updateRawValue((prev) => `${prev} @celeste`);
+     * ```
      */
-    showAiLabel?: boolean;
+    updateRawValue: (updater: (previous: string) => string) => void;
 }
 /**
- * @category Config
+ * Current connection state of the human agent experience.
+ *
+ * @category Instance
  */
-interface LayoutConfig {
-    /**
-     * Indicates if the Carbon AI Chat widget should keep its border and box-shadow.
-     */
-    showFrame?: boolean;
+type PublicChatHumanAgentState = Readonly<PersistedHumanAgentState & {
+    /** Indicates if Carbon AI Chat is attempting to connect to an agent. */
+    isConnecting: boolean;
+}>;
+/**
+ * This is a subset of the public interface that is managed by the event bus that is used for registering and
+ * unregistering event listeners on the bus.
+ *
+ * @category Instance
+ */
+interface EventHandlers {
     /**
-     * Indicates if content inside the Carbon AI Chat widget should be constrained to a max-width.
+     * Adds the given event handler as a listener for events of the given type.
      *
-     * At larger widths the card, carousel, options and conversational search response types
-     * have pending issues.
+     * @param handlers The handler or handlers along with the event type to start listening for events.
+     * @returns The instance for method chaining.
      */
-    hasContentMaxWidth?: boolean;
+    on: (handlers: TypeAndHandler | TypeAndHandler[]) => EventHandlers;
     /**
-     * This flag is used to disable Carbon AI Chat's rounded corners.
+     * Removes an event listener that was previously added via {@link on} or {@link once}.
+     *
+     * @param handlers The handler or handlers along with the event type to stop listening for events.
+     * @returns The instance for method chaining.
      */
-    corners?: CornersType;
+    off: (handlers: TypeAndHandler | TypeAndHandler[]) => EventHandlers;
     /**
-     * CSS variable overrides for the chat UI.
-     *
-     * Keys correspond to values from `LayoutCustomProperties` (e.g. `LayoutCustomProperties.height`),
-     * which map to the underlying `--cds-aichat-…` custom properties.
-     * Values are raw CSS values such as `"420px"`, `"9999"`, etc.
+     * Adds the given event handler as a listener for events of the given type. After the first event is handled, this
+     * handler will automatically be removed.
      *
-     * Example:
-     * { height: "560px", width: "420px" }
+     * @param handlers The handler or handlers along with the event type to start listening for an event.
+     * @returns The instance for method chaining.
      */
-    customProperties?: Partial<Record<LayoutCustomProperties, string>>;
+    once: (handlers: TypeAndHandler | TypeAndHandler[]) => EventHandlers;
 }
 /**
- * Config options for controlling messaging.
+ * The type of handler for event bus events. This function may return a Promise in which case, the bus will await
+ * the result and the loop will block until the Promise is resolved.
  *
- * @category Config
+ * @category Instance
  */
-interface PublicConfigMessaging {
+type EventBusHandler<T extends BusEvent = BusEvent> = (event: T, instance: ChatInstance) => unknown;
+/**
+ * The type of the object that is passed to the event bus functions (e.g. "on") when registering a handler.
+ *
+ * @category Instance
+ */
+interface TypeAndHandler {
     /**
-     * Indicates if Carbon AI Chat should make a request for the welcome message when a new conversation begins. If this is
-     * true, then Carbon AI Chat will start with an empty conversation.
-     *
-     * **Manual session management required**: Changes to this property after conversation has started have no effect.
-     * To apply new welcome behavior, call `instance.messaging.restartConversation()`.
+     * The type of event this handler is for.
      */
-    skipWelcome?: boolean;
+    type: BusEventType;
     /**
-     * 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.  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).
+     * The handler for events of this type.
      */
-    messageTimeoutSecs?: number;
+    handler: EventBusHandler;
+}
+/**
+ * This is a subset of the public interface that provides methods that can be used by the user to control the widget
+ * and have it perform certain actions.
+ *
+ * @category Instance
+ */
+interface ChatActions {
     /**
-     * Controls how long AI chat should wait before showing the loading indicator. If set to 0, the chat will never show
-     * 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.
+     * Messaging actions for a chat instance.
      */
-    messageLoadingIndicatorTimeoutSecs?: number;
+    messaging: ChatInstanceMessaging;
     /**
-     * A callback for Carbon AI Chat to use to send messages to your assistant.
-     *
-     * Carbon AI Chat will queue up any additional user messages until the Promise from a previous call to customSendMessage
-     * has resolved. If you do not make customSendMessage async, it will be up to you to manage what happens when a message is
-     * sent when the previous is still processing. If the Promise rejects, an error indicator will be displayed next to the user's message.
-     *
-     * If the request takes longer than PublicConfigMessaging.messageTimeoutSecs than the AbortSignal will be sent.
+     * This function can be called when another component wishes this component to gain focus. It is up to the
+     * component to decide where focus belongs. This may return true or false to indicate if a suitable focus location
+     * was found.
      */
-    customSendMessage?: (request: MessageRequest, requestOptions: CustomSendMessageOptions, instance: ChatInstance) => Promise<void> | void;
+    requestFocus: () => boolean | void;
     /**
-     * This is a callback function that is used by Carbon AI Chat to retrieve history data for populating the Carbon AI Chat. If
-     * this function is defined, it will be used instead of any other mechanism for fetching history.
+     * Sends the given message to the assistant on the remote server. This will result in a "pre:send" and "send" event
+     * being fired on the event bus. The returned promise will resolve once a response has received and processed and
+     * both the "pre:receive" and "receive" events have fired. It will reject when too many errors have occurred and
+     * the system gives up retrying.
      *
-     * If this function is mutated after it was initially called, the chat does not re-call it.
-     */
-    customLoadHistory?: (instance: ChatInstance) => Promise<HistoryItem[]>;
-}
-/**
- * @category Config
- */
-interface DisclaimerPublicConfig {
-    /**
-     * If the disclaimer is turned on.
+     * @param message The message to send.
+     * @param options Options for the message sent.
      */
-    isOn: boolean;
+    send: (message: MessageRequest | string, options?: SendOptions) => Promise<void>;
     /**
-     * HTML content to show in disclaimer.
+     * Fire the view:pre:change and view:change events and change the view of the Carbon AI Chat. If a {@link ViewType} is
+     * provided then that view will become visible and the rest will be hidden. If a {@link ViewState} is provided that
+     * includes all of the views then all of the views will be changed accordingly. If a partial {@link ViewState} is
+     * provided then only the views provided will be changed.
      */
-    disclaimerHTML: string;
-}
-/**
- * A string identifying what Carbon Theme we should base UI variables off of.
- * Defaults to "inherit". If you are not hosting the chat on a website that is Carbon styles, you will want to choose
- * once of the non-inherited values to inject the correct CSS custom property values into the code. See
- * https://carbondesignsystem.com/guidelines/color/tokens.
- *
- * @category Config
- */
-declare enum CarbonTheme {
+    changeView: (newView: ViewType | ViewState) => Promise<void>;
     /**
-     * Injects Carbon white theme tokens.
+     * Returns the list of writable elements.
      */
-    WHITE = "white",
+    writeableElements: Partial<WriteableElements>;
     /**
-     * Injects Carbon Gray 10 theme tokens.
+     * @deprecated Configure via {@link InputConfig.isVisible}.
      */
-    G10 = "g10",
+    updateInputFieldVisibility: (isVisible: boolean) => void;
     /**
-     * Injects Carbon Gray 90 theme tokens.
+     * @deprecated Configure via {@link InputConfig.isDisabled}
+     * or {@link PublicConfig.isReadonly}.
      */
-    G90 = "g90",
+    updateInputIsDisabled: (isDisabled: boolean) => void;
     /**
-     * Injects Carbon Gray 100 theme tokens.
+     * @deprecated Configure via {@link LauncherConfig.showUnreadIndicator}.
      */
-    G100 = "g100"
-}
-/**
- * The different categories of errors that the system can record. These values are published for end user consumption.
- *
- * @category Config
- */
-declare enum OnErrorType {
+    updateAssistantUnreadIndicatorVisibility: (isVisible: boolean) => void;
     /**
-     * Indicates an error sending a message to the assistant. This error is only generated after all retries have
-     * failed and the system has given up.
+     * Scrolls to the (original) message with the given ID. Since there may be multiple message items in a given
+     * message, this will scroll the first message to the top of the message window.
+     *
+     * @param messageID The (original) message ID to scroll to.
+     * @param animate Whether or not the scroll should be animated. Defaults to true.
      */
-    MESSAGE_COMMUNICATION = "MESSAGE_COMMUNICATION",
+    scrollToMessage: (messageID: string, animate?: boolean) => void;
     /**
-     * This indicates an error in one of the components that occurs as part of rendering the UI.
+     * 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.
+     *
+     * @deprecated Use {@link ChatInstanceMessaging.restartConversation} instead.
      */
-    RENDER = "RENDER",
+    restartConversation: () => Promise<void>;
     /**
-     * This indicates a known error with the configuration for a service desk. Fired when a connect_to_agent
-     * response type is received, but none is configured.
+     * Initiates a doAutoScroll on the currently visible chat panel.
      */
-    INTEGRATION_ERROR = "INTEGRATION_ERROR",
+    doAutoScroll: () => void;
     /**
-     * This indicates that some error occurred while trying to hydrate the chat. This will prevent the chat from
-     * functioning.
+     * @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.
      */
-    HYDRATION = "HYDRATION"
-}
-/**
- * Fired when a serious error in the chat occurs.
- *
- * @category Config
- */
-interface OnErrorData {
+    updateIsMessageLoadingCounter: (direction: IncreaseOrDecrease, message?: string) => void;
     /**
-     * The type of error that occurred.
+     * 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. "reset" will set the value back to 0.
+     *
+     * You can access the current value via {@link ChatInstance.getState}.
      */
-    errorType: OnErrorType;
+    updateIsChatLoadingCounter: (direction: IncreaseOrDecrease) => void;
     /**
-     * A message associated with the error.
+     * Actions for mutating the chat input contents.
      */
-    message: string;
+    input: ChatInstanceInput;
     /**
-     * An extra blob of data associated with the error. This may be a stack trace for thrown errors.
+     * Actions that are related to a service desk integration.
      */
-    otherData?: unknown;
+    serviceDesk: ChatInstanceServiceDeskActions;
     /**
-     * If the error is of the severity that requires a whole restart of Carbon AI Chat.
+     * Remove any record of the current session from the browser's SessionStorage.
+     *
+     * @param keepOpenState If we are destroying the session to restart the chat this can be used to preserve if the web
+     * chat is open.
      */
-    catastrophicErrorType?: boolean;
+    destroySession: (keepOpenState?: boolean) => Promise<void>;
 }
-
 /**
- * A TypeScript definition file for ObjectMap.
+ * @category Instance
  */
+type IncreaseOrDecrease = "increase" | "decrease" | "reset" | undefined;
 /**
- * This interface represents an object which behaves like a map. The object contains a set of properties representing
- * keys in the map and the values of those properties are all of the same type (TPropertyType). The type of the keys
- * defaults to any string but you can specify a type that is a string enum instead if you want a map that contains
- * only keys for a given enum (or other similar type).
+ * This interface represents the options for when a MessageRequest is sent to the server with the send method.
  *
- * @category Utilities
+ * @category Instance
  */
-type ObjectMap<TPropertyType, TKeyType extends string | number = string> = Partial<Record<TKeyType, TPropertyType>>;
-
+interface SendOptions {
+    /**
+     * If you want to send a message to the API, but NOT have it show up in the UI, set this to true. The "pre:send"
+     * and "send" events will still be fired but the message will not be added to the local message list displayed in
+     * the UI. Note that the response message will still be added.
+     */
+    silent?: boolean;
+}
 /**
- * Items stored in sessionStorage.
+ * An object of elements we expose to developers to write to. Be sure to check the documentation of the React or
+ * web component you are using for how to make use of this, as it differs based on implementation.
  *
  * @category Instance
  */
-interface PersistedState {
-    /**
-     * Indicates if this state was loaded from browser session storage or if was created as part of a new session.
-     */
-    wasLoadedFromBrowser: boolean;
-    /**
-     * The version of the Carbon AI Chat that this data is persisted for. If there are any breaking changes to the
-     * application state and a user reloads and gets a new version of the widget, bad things might happen so we'll
-     * just invalidate the persisted storage if we ever attempt to load an old version on Carbon AI Chat startup.
-     */
-    version: string;
-    /**
-     * Indicates which of the Carbon AI Chat views are visible and which are hidden.
-     */
-    viewState: ViewState;
+type WriteableElements = Record<WriteableElementName, HTMLElement>;
+/**
+ * @category Instance
+ */
+declare enum WriteableElementName {
     /**
-     * Indicates if we should show an unread indicator on the launcher. This is set by
-     * {@link ChatInstance.updateAssistantUnreadIndicatorVisibility} and will display an empty circle on
-     * the launcher. This setting is overridden if there are any unread human agent messages in which case a circle
-     * with a number is displayed.
+     * An element that appears in the AI theme only and is shown beneath the title and description in the AI tooltip
+     * content.
      */
-    showUnreadIndicator: boolean;
+    AI_TOOLTIP_AFTER_DESCRIPTION_ELEMENT = "aiTooltipAfterDescriptionElement",
     /**
-     * Indicates if the mobile launcher should be in the extended state.
+     * An element that appears in the main message body directly above the welcome node.
      */
-    mobileLauncherIsExtended: boolean;
+    WELCOME_NODE_BEFORE_ELEMENT = "welcomeNodeBeforeElement",
     /**
-     * Determines if the mobile launcher already played the extended animation and was reduced.
+     * An element that appears in the header on a new line. Only visible while talking to the assistant.
      */
-    mobileLauncherWasReduced: boolean;
+    HEADER_BOTTOM_ELEMENT = "headerBottomElement",
     /**
-     * Determines if the mobile launcher previously played the bounce animation and should no longer be able to.
+     * An element that appears after the messages area and before the input area.
      */
-    mobileLauncherDisableBounce: boolean;
+    BEFORE_INPUT_ELEMENT = "beforeInputElement",
     /**
-     * Indicates the desktop launcher is in its expanded state.
+     * An element that appears above the input field on the home screen.
      */
-    desktopLauncherIsExpanded: boolean;
+    HOME_SCREEN_BEFORE_INPUT_ELEMENT = "homeScreenBeforeInputElement",
     /**
-     * Indicates the desktop launcher has been minimized.
+     * An element that appears on the home screen after the conversation starters.
      */
-    desktopLauncherWasMinimized: boolean;
+    HOME_SCREEN_AFTER_STARTERS_ELEMENT = "homeScreenAfterStartersElement",
     /**
-     * The bounce turn the user is currently on in the sequence of bounces so that user doesn't start over in the
-     * sequence. A turn is a full set of animations that are displayed when a bounce occurs and each turn of a bounce is
-     * when a different bounce occurs at a different point in time. This is used for both the desktop and mobile launcher.
+     * An element that appears on the home screen above the welcome message and conversation starters.
      */
-    bounceTurn: number;
+    HOME_SCREEN_HEADER_BOTTOM_ELEMENT = "homeScreenHeaderBottomElement",
     /**
-     * If the user has received a message beyond the welcome node. We use this to mark if the chat has been interacted
-     * with. This flag is duplicated so the information is available before hydration and before the user is known.
-     * Note that this property reflects only the last user and should only be used when an approximate value is
-     * acceptable.
+     * An element to be housed in the custom panel.
      */
-    hasSentNonWelcomeMessage: boolean;
+    CUSTOM_PANEL_ELEMENT = "customPanelElement"
+}
+/**
+ * @category Instance
+ */
+type ChangeFunction = (text: string) => void;
+/**
+ * Upload options. Currently only applies to conversations with a human agent.
+ *
+ * @category Instance
+ */
+interface FileUploadCapabilities {
     /**
-     * Map of if a disclaimer has been accepted on a given window.hostname value, keyed by hostname via
-     * {@link ObjectMap}.
+     * Indicates that file uploads may be performed by the user.
      */
-    disclaimersAccepted: ObjectMap<boolean>;
+    allowFileUploads: boolean;
     /**
-     * State of home screen.
+     * If file uploads are allowed, this indicates if more than one file may be selected at a time. The default is false.
      */
-    homeScreenState: HomeScreenState;
+    allowMultipleFileUploads: boolean;
     /**
-     * The persisted subset of the human agent state.
+     * If file uploads are allowed, this is the set a file types that are allowed. This is filled into the "accept"
+     * field for the file input element.
      */
-    humanAgentState: PersistedHumanAgentState;
+    allowedFileUploadTypes: string;
 }
-
 /**
- * @category Config
+ * Start or end conversations with human agent.
+ *
+ * @category Instance
  */
-interface ChatHeaderConfig {
+interface ChatInstanceServiceDeskActions {
     /**
-     * The chat header title.
+     * Ends the conversation with a human agent. This does not request confirmation from the user first. If the user
+     * is not connected or connecting to a human agent, this function has no effect. You can determine if the user is
+     * connected or connecting by calling {@link ChatInstance.getState}. Note that this function
+     * returns a Promise that only resolves when the conversation has ended. This includes after the
+     * {@link BusEventType.HUMAN_AGENT_PRE_END_CHAT} and {@link BusEventType.HUMAN_AGENT_END_CHAT} events have been fired and
+     * resolved.
      */
-    title?: string;
+    endConversation: () => Promise<void>;
     /**
-     * The name displayed after the title.
+     * Sets the suspended state for an agent conversation. A conversation can be suspended or un-suspended only if the
+     * user is currently connecting or connected to an agent. If a conversation is suspended, then messages from the user
+     * will no longer be routed to the service desk and incoming messages from the service desk will not be displayed. In
+     * addition, the current connection status with an agent will not be shown.
      */
-    name?: string;
+    updateIsSuspended: (isSuspended: boolean) => Promise<void>;
 }
 
+/**
+ * Eagerly loads every lazily imported dependency across both
+ * `@carbon/ai-chat-components` and `@carbon/ai-chat` so tests can preload
+ * everything they need (Jest, Vitest, server rendering, etc.). Only available
+ * from `@carbon/ai-chat/server`.
+ *
+ * @category Testing
+ */
+declare function loadAllLazyDeps(): Promise<void>;
+
 /**
  * This component is mostly a pass-through. Its takes any properties passed into the ChatContainer
  * custom element and then renders the React Carbon AI Chat application while passing in properties.
@@ -4557,89 +4692,5 @@ interface ChatContainerProps extends PublicConfig {
     renderWriteableElements?: RenderWriteableElementResponse;
 }
 
-/**
- * An enum of all of our data-testid we use. For some elements (like INPUT) they can appear in multiple "panels"
- * (e.g. on the home screen and in the main chat window). There are provided testids for "panels" as well so you
- * can first select a panel and then select the correct child.
- *
- * @category Testing
- *
- * @experimental
- */
-declare enum PageObjectId {
-    /**
-     * Minimize chat button in header.
-     */
-    CLOSE_CHAT = "close_chat",
-    /**
-     * The launcher button to open the chat. This id is maintained across desktop and mobile launchers.
-     */
-    LAUNCHER = "launcher_open_chat",
-    /**
-     * Input field.
-     */
-    INPUT = "input_field",
-    /**
-     * Input send button.
-     */
-    INPUT_SEND = "input_send",
-    /**
-     * The chat header title element.
-     */
-    HEADER_TITLE = "header_title",
-    /**
-     * The chat header name element.
-     */
-    HEADER_NAME = "header_name",
-    /**
-     * The main chat panel.
-     */
-    MAIN_PANEL = "main_panel",
-    /**
-     * Disclaimer panel.
-     */
-    DISCLAIMER_PANEL = "disclaimer_panel",
-    /**
-     * Disclaimer accept button.
-     */
-    DISCLAIMER_ACCEPT_BUTTON = "disclaimer_accept_button",
-    /**
-     * Homescreen Panel.
-     */
-    HOME_SCREEN_PANEL = "home_screen_panel",
-    /**
-     * Hydration/loading state panel.
-     */
-    HYDRATING_PANEL = "hydrating_panel",
-    /**
-     * Catastrophic error panel.
-     */
-    CATASTROPHIC_PANEL = "catastrophic_panel",
-    /**
-     * Iframe panel.
-     */
-    IFRAME_PANEL = "iframe_panel",
-    /**
-     * Conversational search panel.
-     */
-    CONVERSATIONAL_SEARCH_CITATION_PANEL = "conversational_search_citation_panel",
-    /**
-     * Custom panel.
-     */
-    CUSTOM_PANEL = "custom_panel",
-    /**
-     * A panel that opens from a button response.
-     */
-    BUTTON_RESPONSE_PANEL = "button_response_panel"
-}
-/**
- * Ids used for data-testid.
- *
- * @category Testing
- *
- * @experimental
- */
-type TestId = PageObjectId;
-
-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 };
+export { LayoutCustomProperties as L, PageObjectId as P, WriteableElementName as W, ButtonItemType as a$, BusEventType as a7, FeedbackInteractionType as a9, HumanAgentsOnlineStatus as aC, ErrorType as aG, FileStatusValue as aH, ScreenShareState as aJ, ButtonItemKind as a_, MessageSendSource as aa, ViewChangeReason as ab, CancellationReason as ai, CarbonTheme as al, enLanguagePack as ao, MinimizeButtonIconType as at, OnErrorType as av, WidthOptions as bG, HumanAgentMessageType as bK, ReasoningStepOpenState as bN, UserType as bV, MessageErrorState as bX, IFrameItemDisplayOption as bh, MessageInputType as br, MessageResponseTypes as bw, OptionItemPreference as by, ViewType as c, PanelType as g, CornersType as u, loadAllLazyDeps as v };
+export type { BusEventMessageItemCustom as $, BusEventHumanAgentPreReceive as A, BusEventViewPreChange as B, ChatContainerProps as C, DefaultCustomPanelConfigOptions as D, EventBusHandler as E, FileUploadCapabilities as F, BusEventHumanAgentPreSend as G, BusEventHumanAgentPreStartChat as H, IncreaseOrDecrease as I, BusEventHumanAgentReceive as J, BusEventHumanAgentSend as K, BusEventChatReady as M, BusEventChunkUserDefinedResponse as N, BusEventClosePanelButtonClicked as O, BusEventCustomPanelClose as Q, BusEventCustomPanelOpen as R, SendOptions as S, TestId as T, BusEventCustomPanelPreClose as U, ViewState as V, BusEventCustomPanelPreOpen as X, BusEventFeedback as Y, BusEventHistoryBegin as Z, BusEventHistoryEnd as _, ChatInstance as a, BusEventPreReceive as a0, BusEventPreReset as a1, BusEventPreSend as a2, BusEventReceive as a3, BusEventReset as a4, BusEventSend as a5, BusEventStateChange as a6, BusEventUserDefinedResponse as a8, AdditionalDataToAgent as aA, AgentAvailability as aB, ConnectingErrorInfo as aD, DisconnectedErrorInfo as aE, EndChatInfo as aF, FileUpload as aI, ServiceDesk as aK, ServiceDeskCallback as aL, ServiceDeskCapabilities as aM, ServiceDeskErrorInfo as aN, ServiceDeskFactoryParameters as aO, ServiceDeskPublicConfig as aP, StartChatOptions as aQ, UserMessageErrorInfo as aR, BaseGenericItem as aS, MessageResponseOptions as aT, MessageResponseHistory as aU, MessageRequestHistory as aV, ResponseUserProfile as aW, AudioItem as aX, BaseMessageInput as aY, ButtonItem as aZ, PersistedState as ac, PersistedHumanAgentState as ad, HomeScreenConfig as ae, HomeScreenStarterButton as af, HomeScreenStarterButtons as ag, HomeScreenState as ah, ChatInstanceMessaging as aj, CustomSendMessageOptions as ak, CustomMenuOption as am, DisclaimerPublicConfig as an, HeaderConfig as ap, InputConfig as aq, LanguagePack as ar, LayoutConfig as as, OnErrorData as au, PublicConfig as aw, PublicConfigMessaging as ax, DeepPartial as ay, ObjectMap as az, BusEventViewChange as b, CdsAiChatCustomElementAttributes as b$, CardItem as b0, CarouselItem as b1, Chunk as b2, CompleteItemChunk as b3, ConnectToHumanAgentItem as b4, ConnectToHumanAgentItemTransferInfo as b5, ConversationalSearchItem as b6, ConversationalSearchItemCitation as b7, DateItem as b8, EventInput as b9, PauseItem as bA, StreamChunk as bB, TextItem as bC, UserDefinedItem as bD, VerticalCellAlignment as bE, VideoItem as bF, WithBodyAndFooter as bH, WithWidthOptions as bI, SingleOption as bJ, ReasoningSteps as bL, ReasoningStep as bM, GenericItemMessageFeedbackOptions as bO, GenericItemMessageOptions as bP, Message as bQ, PartialOrCompleteItemChunk as bR, PartialResponse as bS, MessageHistoryFeedback as bT, SearchResult as bU, HistoryItem as bW, LauncherCallToActionConfig as bY, LauncherConfig as bZ, CdsAiChatContainerAttributes as b_, EventInputData as ba, FinalResponseChunk as bb, GenericItem as bc, GenericItemMessageFeedbackCategories as bd, GridItem as be, HorizontalCellAlignment as bf, IFrameItem as bg, ImageItem as bi, InlineErrorItem as bj, ItemStreamingMetadata as bk, MediaItem as bl, MediaItemDimensions as bm, MediaSubtitleTrack as bn, MediaTranscript as bo, MediaFileAccessibility as bp, MessageInput as bq, MessageItemPanelInfo as bs, MessageOutput as bt, MessageRequest as bu, MessageResponse as bv, OptionItem as bx, PartialItemChunk as bz, RenderUserDefinedResponse as c0, RenderUserDefinedState as c1, RenderWriteableElementResponse as c2, ChatHeaderConfig as d, CustomPanelConfigOptions as e, CustomPanelInstance as f, CustomPanels as h, CustomPanelOpenOptions as i, ChangeFunction as j, ChatInstanceInput as k, ChatInstanceServiceDeskActions as l, EventHandlers as m, PublicInputState as n, PublicCustomPanelsState as o, PublicDefaultCustomPanelState as p, PublicChatHumanAgentState as q, PublicChatState as r, TypeAndHandler as s, WriteableElements as t, BusEvent as w, BusEventHumanAgentAreAnyAgentsOnline as x, BusEventHumanAgentEndChat as y, BusEventHumanAgentPreEndChat as z };