@webex/contact-center 3.12.0-next.13 → 3.12.0-next.130

package/dist/types/cc.d.ts

@@ -9,10 +9,12 @@ import { WebexPlugin } from '@webex/webex-core';
 import { SetStateResponse, IContactCenter, AgentLogin, AgentProfileUpdate, StationLoginResponse, StationLogoutResponse, BuddyAgentsResponse, BuddyAgents, UploadLogsResponse, UpdateDeviceTypeResponse } from './types';
 import LoggerProxy from './logger-proxy';
 import { StateChange, Logout } from './services/agent/types';
-import { Profile, OutdialAniEntriesResponse, OutdialAniParams } from './services/config/types';
+import { Profile, OutdialAniEntriesResponse, OutdialAniParams, Entity } from './services/config/types';
 import { TaskResponse, PreviewContactPayload } from './services/task/types';
 import { AddressBook } from './services/AddressBook';
+import { Queue } from './services/Queue';
 import { ApiAIAssistant } from './services/ApiAiAssistant';
+import { UserPreference } from './services/UserPreference';
 import type { EntryPointListResponse, EntryPointSearchParams, ContactServiceQueuesResponse, ContactServiceQueueSearchParams } from './types';
 /**
  * The main Contact Center plugin class that enables integration with Webex Contact Center.
@@ -161,6 +163,28 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
      * @private
      */
     private webCallingService;
+    /**
+     * REST telephony for wxApp thick-client answer (WXCC-6026)
+     * @private
+     */
+    private answerCallOnWebexService;
+    /**
+     * usersub cross-client state for Webex App toast suppression
+     * @private
+     */
+    private webexCrossClientService;
+    /**
+     * Mercury telephony mute sync for wxApp thick-client answer
+     * @private
+     */
+    private wxAppTelephonyMercurySync;
+    /** True when wxApp mute sync opened Mercury (Extension/DN-only profiles). */
+    private wxAppMercuryConnectedByCc;
+    /** True when wxApp mute sync registered the Webex device. */
+    private wxAppDeviceRegisteredByCc;
+    private static readonly WXAPP_FALSE_PUBLISH_RETRY_DELAY_MS;
+    private static readonly WXAPP_FALSE_PUBLISH_MAX_RETRIES;
+    private wxAppFalsePublishRetryTimer?;
     /**
      * Core service managers for Contact Center operations
      * Includes agent, connection, and configuration services
@@ -189,6 +213,13 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
      * @private
      */
     private metricsManager;
+    /** Current login/relogin session used for agent-scoped wellness validation. */
+    private currentAgentSessionId?;
+    /** Registered-session cache for the system WellbeingBreak idle code. */
+    private wellbeingBreakIdleCode?;
+    /** Registration generation that owns the wellness idle-code cache and in-flight lookups. */
+    private wellnessRegistrationGeneration;
+    private updateWellnessSession;
     /**
      * API instance for managing Webex Contact Center entry points
      * Provides functionality to fetch entry points with caching support
@@ -250,7 +281,37 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
      * });
      * ```
      */
-    private queue;
+    queue: Queue;
+    /**
+     * API instance for managing Webex Contact Center user preferences
+     * Provides functionality to get, create, update, and delete user preferences
+     * @type {UserPreference}
+     * @public
+     * @example
+     * ```typescript
+     * const cc = webex.cc;
+     * await cc.register();
+     * await cc.stationLogin({ teamId: 'team123', loginOption: 'BROWSER' });
+     *
+     * // Get user preferences for current user
+     * const preferences = await cc.userPreference.getUserPreference();
+     *
+     * // Create new user preferences
+     * const newPrefs = await cc.userPreference.createUserPreference({
+     *   userId: 'user123',
+     *   preferences: { e911Reminder: true }
+     * });
+     *
+     * // Update user preferences
+     * const updatedPrefs = await cc.userPreference.updateUserPreference('user123', {
+     *   preferences: { e911Reminder: false }
+     * });
+     *
+     * // Delete user preferences
+     * await cc.userPreference.deleteUserPreference('user123');
+     * ```
+     */
+    userPreference: UserPreference;
     /**
      * API instance for AI Assistant operations such as transcript controls.
      * @type {ApiAIAssistant}
@@ -282,6 +343,12 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
      * @param {ITask} task The task object to be hydrated with additional data
      */
     private handleTaskHydrate;
+    /**
+     * Handles multi-login hydrate events for SDK instances without Mobius registration
+     * @private
+     * @param {ITask} task The task object associated with the multi-login hydrate
+     */
+    private handleTaskMultiLoginHydrate;
     /**
      * Handles task merged events when tasks are combined eg: EPDN merge/transfer
      * @private
@@ -294,6 +361,9 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
      * @param {ITask} task The campaign reservation task
      */
     private handleCampaignPreviewReservation;
+    private trackInvalidWellnessEvent;
+    private normalizeWellnessBreakEvent;
+    private handleWellnessBreakWebsocketPayload;
     private handleRTDWebsocketMessage;
     /**
      * Sets up event listeners for incoming tasks and task hydration
@@ -517,6 +587,16 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
      * ```
      */
     setAgentState(data: StateChange): Promise<SetStateResponse>;
+    /**
+     * Returns the system-managed `WellbeingBreak` idle code for the current registration.
+     * The value is fetched outside Desktop Profile filtering and cached until deregistration.
+     * @returns The normalized system idle-code entity
+     * @throws Structured Contact Center error when wellness is disabled or the code is unavailable
+     * @example
+     * const idleCode = await webex.cc.getWellbeingBreakIdleCode();
+     * @public
+     */
+    getWellbeingBreakIdleCode(): Promise<Entity>;
     /**
      * Processes incoming websocket messages and emits corresponding events
      * Handles various event types including agent state changes, login events,
@@ -525,6 +605,69 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
      * @param {string} event The raw websocket event message
      */
     private handleWebsocketMessage;
+    /**
+     * Checks whether Mobius/WebRTC registration should be skipped by config
+     * @returns {boolean} True when browser WebRTC registration is disabled
+     * @private
+     */
+    private isWebRTCRegistrationDisabled;
+    /**
+     * Validates contact-center plugin configuration before service initialization
+     * @private
+     */
+    private validatePluginConfig;
+    /**
+     * Whether wxApp thick-client answer is enabled for this SDK instance.
+     * @public
+     */
+    isWxBetterTogetherEnabled(): boolean;
+    /**
+     * Current station login option (Extension, Dial Number, or Browser/Desktop).
+     * Prefer webCallingService — updated on every stationLogin before wxApp hooks run.
+     * @private
+     */
+    private getCurrentStationLoginOption;
+    /**
+     * wxApp thick-client answer is supported for Extension and Dial Number station login only —
+     * not Browser/Desktop (WebRTC) login.
+     * @private
+     */
+    private assertWxAppStationLoginSupportedForEnable;
+    /**
+     * Clears runtime wxApp config after logout/deregister so stale flags do not apply on relogin.
+     * @private
+     */
+    private resetEnableWxBetterTogetherConfig;
+    private getWxAppTelephonyTaskType;
+    private ensureWxAppPostStationLogin;
+    private clearWxAppFalsePublishRetryTimer;
+    private scheduleForcedFalsePublishRetry;
+    /**
+     * Retries compensating false publish after rollback failure, regardless of enabled flag.
+     * @private
+     */
+    private scheduleCompensatingFalsePublishRetry;
+    private scheduleFalsePublishRetry;
+    /**
+     * Best-effort rollback when usersub true was published but wxApp setup did not complete.
+     * @private
+     */
+    private revertWxAppCrossClientPublish;
+    private ensureWxAppDeviceRegistered;
+    private ensureWxAppMercuryConnected;
+    /**
+     * Disconnects Mercury and unregisters the device when wxApp mute sync opened them.
+     * @private
+     */
+    private releaseWxAppMercuryResources;
+    /**
+     * Clears wxApp runtime state and feature-owned resources. Publish failures are logged;
+     * optional rethrow for deregister when callers need to surface usersub errors.
+     * @private
+     */
+    private teardownWxAppLocalState;
+    private ensureWxAppMercuryAndSubscribe;
+    private publishAnswerOnWebexCrossClientState;
     /**
      * Initializes event listeners for the Contact Center service
      * Sets up handlers for connection state changes and other core events
@@ -689,6 +832,50 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
      * ```
      */
     acceptPreviewContact(payload: PreviewContactPayload): Promise<TaskResponse>;
+    /**
+     * Skips a campaign preview contact, requesting the next contact from the campaign.
+     *
+     * When a campaign manager reserves a contact for an agent, the agent receives an
+     * `AgentOfferCampaignReservation` event. Instead of accepting, the agent can skip the
+     * preview contact to move to the next contact in the campaign.
+     *
+     * @param {PreviewContactPayload} payload - The preview contact payload containing interactionId and campaignId (campaign name, not UUID).
+     * @returns {Promise<TaskResponse>} Promise resolving with agent contact on success.
+     * @throws {Error} If the operation fails (network error, etc.)
+     *
+     * @example
+     * ```typescript
+     * webex.cc.on('task:campaignPreviewReservation', async (task) => {
+     *   const { interactionId } = task.data;
+     *   const campaignId = task.data.interaction.callProcessingDetails.campaignId;
+     *
+     *   const result = await webex.cc.skipPreviewContact({ interactionId, campaignId });
+     * });
+     * ```
+     */
+    skipPreviewContact(payload: PreviewContactPayload): Promise<TaskResponse>;
+    /**
+     * Removes a campaign preview contact from the campaign list entirely.
+     *
+     * When a campaign manager reserves a contact for an agent, the agent receives an
+     * `AgentOfferCampaignReservation` event. Instead of accepting or skipping, the agent can
+     * remove the preview contact to permanently take it out of the campaign contact list.
+     *
+     * @param {PreviewContactPayload} payload - The preview contact payload containing interactionId and campaignId (campaign name, not UUID).
+     * @returns {Promise<TaskResponse>} Promise resolving with agent contact on success.
+     * @throws {Error} If the operation fails (network error, etc.)
+     *
+     * @example
+     * ```typescript
+     * webex.cc.on('task:campaignPreviewReservation', async (task) => {
+     *   const { interactionId } = task.data;
+     *   const campaignId = task.data.interaction.callProcessingDetails.campaignId;
+     *
+     *   const result = await webex.cc.removePreviewContact({ interactionId, campaignId });
+     * });
+     * ```
+     */
+    removePreviewContact(payload: PreviewContactPayload): Promise<TaskResponse>;
     /**
      * Fetches outdial ANI (Automatic Number Identification) entries for an outdial ANI ID.
      *
@@ -787,14 +974,14 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
      */
     updateAgentProfile(data: AgentProfileUpdate): Promise<UpdateDeviceTypeResponse>;
     /**
-     * Returns paginated entry points for the organization.
-     * Thin wrapper around internal EntryPoint instance.
+     * Returns paginated entry points using the EntryPoint service defaults.
+     * Existing request parameters can override those defaults.
      * @public
      */
     getEntryPoints(params?: EntryPointSearchParams): Promise<EntryPointListResponse>;
     /**
-     * Returns paginated contact service queues for the organization.
-     * Thin wrapper around internal Queue instance.
+     * Returns paginated contact service queues using the Queue service defaults.
+     * Existing request parameters can override those defaults.
      * @public
      */
     getQueues(params?: ContactServiceQueueSearchParams): Promise<ContactServiceQueuesResponse>;

package/dist/types/config.d.ts

@@ -25,6 +25,19 @@ declare const _default: {
          * @default true
          */
         allowAutomatedRelogin: boolean;
+        /**
+         * Whether to skip Mobius/WebRTC registration for browser login flows.
+         * @type {boolean}
+         * @default false
+         */
+        disableWebRTCRegistration: boolean;
+        /**
+         * Whether wxApp Better Together is enabled at SDK init.
+         * Must be set before SDK init. Default false (WXCC-6026).
+         * @type {boolean}
+         * @default false
+         */
+        enableWxBetterTogether: boolean;
         /**
          * The type of client making the connection.
          * @type {string}

package/dist/types/constants.d.ts

@@ -7,12 +7,14 @@ export declare const LOG_PREFIX = "PLUGIN_CC";
 export declare const WEB_CALLING_SERVICE_FILE = "WebCallingService";
 export declare const CONFIG_FILE_NAME = "config-index";
 export declare const CC_FILE = "cc";
+export declare const WELLNESS_BREAK_HANDLER = "Wellness_Break_Handler";
 export declare const CONNECTION_SERVICE_FILE = "connection-service";
 export declare const WEB_SOCKET_MANAGER_FILE = "WebSocketManager";
 export declare const AQM_REQS_FILE = "aqm-reqs";
 export declare const WEBEX_REQUEST_FILE = "WebexRequest";
 export declare const TASK_MANAGER_FILE = "TaskManager";
 export declare const TASK_FILE = "Task";
+export declare const INBOUND_DIRECTION = "INBOUND";
 export declare const OUTDIAL_DIRECTION = "OUTBOUND";
 export declare const ATTRIBUTES: {};
 export declare const OUTDIAL_MEDIA_TYPE = "telephony";
@@ -36,15 +38,41 @@ export declare const METHODS: {
     HANDLE_DEVICE_TYPE: string;
     START_OUTDIAL: string;
     GET_QUEUES: string;
-    GET_OUTDIAL_ANI_ENTRIES: string;
     UPLOAD_LOGS: string;
     UPDATE_AGENT_PROFILE: string;
     GET_DEVICE_ID: string;
     HANDLE_INCOMING_TASK: string;
     HANDLE_TASK_HYDRATE: string;
     INCOMING_TASK_LISTENER: string;
+    ACCEPT: string;
+    REJECT: string;
+    HOLD: string;
+    RESUME: string;
+    HOLD_RESUME: string;
+    TRANSFER_CALL: string;
+    CONSULT_TRANSFER: string;
+    CONSULT_CONFERENCE: string;
+    DROP_CONFERENCE_PARTICIPANT: string;
+    EXIT_CONFERENCE: string;
+    TRANSFER_CONFERENCE: string;
+    TOGGLE_MUTE: string;
+    TRANSMIT_DTMF: string;
+    COMPLETE_TRANSFER: string;
+    GET_OUTDIAL_ANI_ENTRIES: string;
     ACCEPT_PREVIEW_CONTACT: string;
+    SKIP_PREVIEW_CONTACT: string;
+    REMOVE_PREVIEW_CONTACT: string;
     GET_BASE_URL: string;
     SEND_EVENT: string;
+    GET_REAL_TIME_ASSISTANCE: string;
+    SEND_REAL_TIME_ASSISTANCE_USER_ACTION: string;
     FETCH_HISTORIC_TRANSCRIPTS: string;
+    REQUEST_WELLNESS_BREAK: string;
+    RESPOND_TO_WELLNESS_BREAK: string;
+    GET_WELLBEING_BREAK_IDLE_CODE: string;
+    SET_MANAGE_WEBEX_CALLING_IN_WXCC: string;
+    IS_WX_BETTER_TOGETHER_ENABLED: string;
+    SYNC_WXAPP_MUTE_FROM_MERCURY: string;
+    GET_CALL_DETAILS_ON_WEBEX: string;
+    ENSURE_WXAPP_MERCURY_CONNECTED: string;
 };

package/dist/types/index.d.ts

@@ -10,17 +10,20 @@ import ContactCenter from './cc';
  */
 export { default as ContactCenter } from './cc';
 /**
- * Task class represents a contact center task that can be managed by an agent
+ * Agent routing service for Contact Center operations
  * @category Services
  */
-export { default as Task } from './services/task';
+export { default as routingAgent } from './services/agent';
 /**
- * Agent routing service for Contact Center operations
+ * Task class represents a contact center task that can be managed by an agent
  * @category Services
  */
-export { default as routingAgent } from './services/agent';
+export { default as Task } from './services/task/Task';
 export { default as AddressBook } from './services/AddressBook';
 export { default as ApiAIAssistant } from './services/ApiAiAssistant';
+export { default as UserPreference } from './services/UserPreference';
+/** Agent Wellness Break notification and action wire values. */
+export { WELLNESS_BREAK_NOTIFICATION_ACTIONS, WELLNESS_BREAK_USER_ACTIONS } from './types';
 /** EntryPoint API types */
 export type { EntryPointRecord, EntryPointListResponse, EntryPointSearchParams, AddressBookEntry, AddressBookEntriesResponse, AddressBookEntrySearchParams, ContactServiceQueuesResponse, ContactServiceQueueSearchParams, ContactServiceQueue, } from './types';
 /**
@@ -89,15 +92,31 @@ UpdateDeviceTypeResponse,
 /** Generic error interface */
 GenericError, 
 /** Set state response */
-SetStateResponse, } from './types';
+SetStateResponse, 
+/** Wellness notification action */
+WellnessBreakNotificationAction, 
+/** Wellness action API value */
+WellnessBreakUserAction, 
+/** Validated agent-scoped wellness notification */
+WellnessBreakEvent, 
+/** Wellness offer-response parameters */
+RespondToWellnessBreakParams, } from './types';
 /** Task related types */
 export type { AgentContact, 
+/** Event emitter contract for task consumers (no @types/node needed) */
+IEventEmitter, 
 /** Task interface */
 ITask, Interaction, TaskData, 
 /** Task response */
-TaskResponse, ConsultPayload, ConsultEndPayload, ConsultTransferPayLoad, 
+TaskResponse, 
+/** Conference participant drop request */
+DropConferenceParticipantPayload, ConsultPayload, ConsultEndPayload, ConsultTransferPayLoad, 
 /** Dialer payload */
-DialerPayload, TransferPayLoad, ResumeRecordingPayload, WrapupPayLoad, } from './services/task/types';
+DialerPayload, TransferPayLoad, ResumeRecordingPayload, WrapupPayLoad, 
+/** UI control types for task buttons */
+InteractionUIControls, TaskUILeg, TaskUIControls, TaskUIControlState, } from './services/task/types';
+/** UI controls utilities */
+export { getDefaultUIControls } from './services/task/state-machine/uiControlsComputer';
 /** Agent related types */
 export type { 
 /** State change interface */
@@ -167,7 +186,15 @@ Entity,
 /** Dial plan configuration */
 DialPlan, 
 /** Auxiliary code type (IDLE_CODE or WRAP_UP_CODE) */
-AuxCodeType, } from './services/config/types';
+AuxCodeType, 
+/** User preference data structure */
+UserPreference as UserPreferenceData, 
+/** Request payload for creating user preferences */
+CreateUserPreferenceRequest, 
+/** Request payload for updating user preferences */
+UpdateUserPreferenceRequest, 
+/** Query parameters for fetching user preferences */
+GetUserPreferenceParams, } from './services/config/types';
 /**
  * Idle code constant
  * @constant {string}

package/dist/types/metrics/MetricsManager.d.ts

@@ -178,6 +178,12 @@ export default class MetricsManager {
      * MetricsManager.getInstance().timeEvent(['AGENT_LOGIN', 'AGENT_LOGOUT']);
      */
     timeEvent(keys: string | string[]): void;
+    /**
+     * Clears a running timed event without emitting a metric.
+     * @param keys - A string or array of strings representing event keys (same as timeEvent).
+     * @public
+     */
+    cancelTimedEvent(keys: string | string[]): void;
     /**
      * Sets the Webex SDK instance and marks the manager as ready when the SDK is ready.
      * @param webex - The Webex SDK instance.

package/dist/types/metrics/constants.d.ts

@@ -122,15 +122,36 @@ export declare const METRIC_EVENT_NAMES: {
     readonly TASK_CONFERENCE_END_FAILED: "Task Conference End Failed";
     readonly TASK_CONFERENCE_TRANSFER_SUCCESS: "Task Conference Transfer Success";
     readonly TASK_CONFERENCE_TRANSFER_FAILED: "Task Conference Transfer Failed";
+    readonly TASK_CONFERENCE_EXIT_SUCCESS: "Task Conference Exit Success";
+    readonly TASK_CONFERENCE_EXIT_FAILED: "Task Conference Exit Failed";
+    readonly TASK_CONFERENCE_PARTICIPANT_DROP_SUCCESS: "Task Conference Participant Drop Success";
+    readonly TASK_CONFERENCE_PARTICIPANT_DROP_FAILED: "Task Conference Participant Drop Failed";
+    readonly TASK_SWITCH_CALL_SUCCESS: "Task Switch Call Success";
+    readonly TASK_SWITCH_CALL_FAILED: "Task Switch Call Failed";
     readonly TASK_OUTDIAL_SUCCESS: "Task Outdial Success";
     readonly TASK_OUTDIAL_FAILED: "Task Outdial Failed";
+    readonly WXAPP_TASK_MUTE_SUCCESS: "WxApp Task Mute Success";
+    readonly WXAPP_TASK_MUTE_FAILED: "WxApp Task Mute Failed";
+    readonly WXAPP_TASK_DTMF_SUCCESS: "WxApp Task Dtmf Success";
+    readonly WXAPP_TASK_DTMF_FAILED: "WxApp Task Dtmf Failed";
+    readonly WXAPP_TASK_ACCEPT_SUCCESS: "WxApp Task Accept Success";
+    readonly WXAPP_TASK_ACCEPT_FAILED: "WxApp Task Accept Failed";
+    readonly WXAPP_TASK_DECLINE_SUCCESS: "WxApp Task Decline Success";
+    readonly WXAPP_TASK_DECLINE_FAILED: "WxApp Task Decline Failed";
+    readonly WXAPP_SESSION_INIT_SUCCESS: "WxApp Session Init Success";
+    readonly WXAPP_SESSION_INIT_FAILED: "WxApp Session Init Failed";
+    readonly WXAPP_SESSION_SKIPPED: "WxApp Session Skipped";
+    readonly WXAPP_USERSUB_PUBLISH_SUCCESS: "WxApp Usersub Publish Success";
+    readonly WXAPP_USERSUB_PUBLISH_FAILED: "WxApp Usersub Publish Failed";
+    readonly WXAPP_MERCURY_SUBSCRIBE_SUCCESS: "WxApp Mercury Subscribe Success";
+    readonly WXAPP_MERCURY_SUBSCRIBE_FAILED: "WxApp Mercury Subscribe Failed";
     readonly UPLOAD_LOGS_SUCCESS: "Upload Logs Success";
     readonly UPLOAD_LOGS_FAILED: "Upload Logs Failed";
     readonly WEBSOCKET_DEREGISTER_SUCCESS: "Websocket Deregister Success";
     readonly WEBSOCKET_DEREGISTER_FAIL: "Websocket Deregister Failed";
-    readonly WEBSOCKET_EVENT_RECEIVED: "Websocket Event Received";
     readonly AGENT_DEVICE_TYPE_UPDATE_SUCCESS: "Agent Device Type Update Success";
     readonly AGENT_DEVICE_TYPE_UPDATE_FAILED: "Agent Device Type Update Failed";
+    readonly WEBSOCKET_EVENT_RECEIVED: "Websocket Event Received";
     readonly ENTRYPOINT_FETCH_SUCCESS: "Entrypoint Fetch Success";
     readonly ENTRYPOINT_FETCH_FAILED: "Entrypoint Fetch Failed";
     readonly ADDRESSBOOK_FETCH_SUCCESS: "AddressBook Fetch Success";
@@ -141,10 +162,31 @@ export declare const METRIC_EVENT_NAMES: {
     readonly OUTDIAL_ANI_EP_FETCH_FAILED: "Outdial ANI Entries Fetch Failed";
     readonly CAMPAIGN_PREVIEW_ACCEPT_SUCCESS: "Campaign Preview Accept Success";
     readonly CAMPAIGN_PREVIEW_ACCEPT_FAILED: "Campaign Preview Accept Failed";
+    readonly CAMPAIGN_PREVIEW_SKIP_SUCCESS: "Campaign Preview Skip Success";
+    readonly CAMPAIGN_PREVIEW_SKIP_FAILED: "Campaign Preview Skip Failed";
+    readonly CAMPAIGN_PREVIEW_REMOVE_SUCCESS: "Campaign Preview Remove Success";
+    readonly CAMPAIGN_PREVIEW_REMOVE_FAILED: "Campaign Preview Remove Failed";
     readonly AI_ASSISTANT_SEND_EVENT_SUCCESS: "AI Assistant Send Event Success";
     readonly AI_ASSISTANT_SEND_EVENT_FAILED: "AI Assistant Send Event Failed";
+    readonly AI_ASSISTANT_GET_REAL_TIME_ASSISTANCE_SUCCESS: "AI Assistant Get Real Time Assistance Success";
+    readonly AI_ASSISTANT_GET_REAL_TIME_ASSISTANCE_FAILED: "AI Assistant Get Real Time Assistance Failed";
+    readonly AI_ASSISTANT_SEND_REAL_TIME_ASSISTANCE_USER_ACTION_SUCCESS: "AI Assistant Send Real Time Assistance User Action Success";
+    readonly AI_ASSISTANT_SEND_REAL_TIME_ASSISTANCE_USER_ACTION_FAILED: "AI Assistant Send Real Time Assistance User Action Failed";
     readonly AI_ASSISTANT_FETCH_HISTORIC_TRANSCRIPTS_SUCCESS: "AI Assistant Fetch Historic Transcripts Success";
     readonly AI_ASSISTANT_FETCH_HISTORIC_TRANSCRIPTS_FAILED: "AI Assistant Fetch Historic Transcripts Failed";
+    readonly AI_ASSISTANT_WELLNESS_ACTION_ACCEPTED: "AI Assistant Wellness Action Accepted";
+    readonly AI_ASSISTANT_WELLNESS_ACTION_FAILED: "AI Assistant Wellness Action Failed";
+    readonly AI_ASSISTANT_WELLNESS_EVENT_INVALID: "AI Assistant Wellness Event Invalid";
+    readonly WELLBEING_BREAK_IDLE_CODE_FETCH_SUCCESS: "Wellbeing Break Idle Code Fetch Success";
+    readonly WELLBEING_BREAK_IDLE_CODE_FETCH_FAILED: "Wellbeing Break Idle Code Fetch Failed";
+    readonly USER_PREFERENCE_GET_SUCCESS: "User Preference Get Success";
+    readonly USER_PREFERENCE_GET_FAILED: "User Preference Get Failed";
+    readonly USER_PREFERENCE_CREATE_SUCCESS: "User Preference Create Success";
+    readonly USER_PREFERENCE_CREATE_FAILED: "User Preference Create Failed";
+    readonly USER_PREFERENCE_UPDATE_SUCCESS: "User Preference Update Success";
+    readonly USER_PREFERENCE_UPDATE_FAILED: "User Preference Update Failed";
+    readonly USER_PREFERENCE_DELETE_SUCCESS: "User Preference Delete Success";
+    readonly USER_PREFERENCE_DELETE_FAILED: "User Preference Delete Failed";
 };
 /**
  * Represents the possible metric event names used within the metrics system.

package/dist/types/services/AddressBook.d.ts

@@ -52,7 +52,8 @@ export declare class AddressBook {
     constructor(webex: WebexSDK, getAddressBookId: () => string);
     /**
      * Fetches address book entries for a specific address book using the entry API
-     * @param {AddressBookEntrySearchParams} [params] - Search and pagination parameters including addressBookId
+     * @param {AddressBookEntrySearchParams} [params] - Search, pagination, and optional sort parameters
+     * including addressBookId. Sorting defaults to name ascending.
      * @returns {Promise<AddressBookEntriesResponse>} Promise resolving to address book entries
      * @throws {Error} If the API call fails
      * @public

package/dist/types/services/AnswerCallOnWebexService.d.ts

@@ -0,0 +1,38 @@
+import { IHttpResponse, WebexSDK } from '../types';
+export type WxAppTelephonyError = Error & {
+    isWxAppTelephonyError: true;
+    trackingId?: string;
+    status?: number | string;
+};
+export type AnswerCallParams = {
+    callId: string;
+    endpointId: string;
+    lineOwnerId?: string;
+};
+export type CallIdParams = {
+    callId: string;
+    lineOwnerId?: string;
+};
+export type TransmitDtmfParams = CallIdParams & {
+    dtmf: string;
+};
+export type CallDetailsResponse = {
+    muted?: boolean;
+};
+/**
+ * REST telephony client for wxApp thick-client answer (WXCC-6026).
+ * Separate from WebCallingService (WebRTC/Mobius).
+ */
+export default class AnswerCallOnWebexService {
+    private webex;
+    constructor(webex: WebexSDK);
+    private getTelephonyBaseUrl;
+    private extractTrackingId;
+    private telephonyRequest;
+    answerCall(params: AnswerCallParams): Promise<IHttpResponse>;
+    rejectCall(params: CallIdParams): Promise<IHttpResponse>;
+    muteCall(params: CallIdParams): Promise<IHttpResponse>;
+    unmuteCall(params: CallIdParams): Promise<IHttpResponse>;
+    transmitDtmf(params: TransmitDtmfParams): Promise<IHttpResponse>;
+    getCallDetails(params: CallIdParams): Promise<CallDetailsResponse>;
+}

package/dist/types/services/ApiAiAssistant.d.ts

@@ -1,5 +1,10 @@
-import { WebexSDK, TranscriptAction, AIAssistantEventType, AIAssistantEventName, HistoricTranscriptsResponse } from '../types';
+import { WebexSDK, AIAssistantEventType, AIAssistantEventName, HistoricTranscriptsResponse, RealTimeAssistanceParams, RealTimeAssistanceUserActionParams, RespondToWellnessBreakParams } from '../types';
 import { AIFeatureFlags } from './config/types';
+type WellnessBreakContextProvider = () => {
+    isWellnessBreakEnabled: boolean;
+    agentId?: string;
+    agentSessionId?: string;
+};
 /**
  * ApiAIAssistant provides AI Assistant APIs for transcript controls.
  * @public
@@ -7,9 +12,37 @@ import { AIFeatureFlags } from './config/types';
 export declare class ApiAIAssistant {
     private webex;
     private metricsManager;
-    aiFeature: AIFeatureFlags;
-    constructor(webex: WebexSDK);
+    private aiFeature;
+    private readonly wellnessContextProvider?;
+    private createWellnessError;
+    constructor(webex: WebexSDK, wellnessContextProvider?: WellnessBreakContextProvider);
     setAIFeatureFlags(aiFeature: AIFeatureFlags): void;
+    private sendWellnessBreakAction;
+    /**
+     * Requests an Agent Wellness Break.
+     * The promise resolves when the HTTP request is accepted with status 202; the later
+     * approval or denial is delivered independently through a wellness notification.
+     * @returns A promise that resolves with no value after HTTP acceptance
+     * @throws Structured Contact Center error when disabled, stale, invalid, or delivery fails
+     * @example
+     * await webex.cc.apiAIAssistant.requestWellnessBreak();
+     * @public
+     */
+    requestWellnessBreak(): Promise<void>;
+    /**
+     * Responds to a backend-provided Agent Wellness Break offer.
+     * The promise resolves when the HTTP request is accepted with status 202 and does not
+     * wait for a WebSocket completion event.
+     * @param params - ACCEPTED, REJECTED, or NO_RESPONSE
+     * @returns A promise that resolves with no value after HTTP acceptance
+     * @throws Structured Contact Center error when disabled, stale, invalid, or delivery fails
+     * @example
+     * await webex.cc.apiAIAssistant.respondToWellnessBreak({
+     *   action: WELLNESS_BREAK_USER_ACTIONS.ACCEPTED,
+     * });
+     * @public
+     */
+    respondToWellnessBreak(params: RespondToWellnessBreakParams): Promise<void>;
     private getBaseUrl;
     /**
      * Sends an event to the AI Assistant service.
@@ -17,9 +50,27 @@ export declare class ApiAIAssistant {
      * @param interactionId - interaction/conversation identifier
      * @param eventType - the type of event (e.g. 'CUSTOM_EVENT')
      * @param eventName - the name of the event (e.g. 'GET_TRANSCRIPTS')
-     * @param action - action within eventDetails (e.g. 'START' or 'STOP')
+     * @param eventMetaData - event-specific fields to include in eventDetails.data
+     * @param languageCode - language code within eventDetails.data
+     * @param trackingId - tracking identifier within eventDetails.data
+     */
+    sendEvent(agentId: string, interactionId: string, eventType: AIAssistantEventType, eventName: AIAssistantEventName, eventMetaData?: Record<string, unknown>, languageCode?: string, trackingId?: string): Promise<Record<string, unknown>>;
+    /**
+     * Requests real-time assistance for an interaction.
+     *
+     * @param params - Real-time assistance request parameters
+     * @returns HTTP response body from the AI Assistant event API
+     * @public
+     */
+    getRealTimeAssistance(params: RealTimeAssistanceParams): Promise<Record<string, unknown>>;
+    /**
+     * Sends user action feedback for a real-time assistance adaptive card.
+     *
+     * @param params - Real-time assistance user action parameters
+     * @returns HTTP response body from the AI Assistant event API
+     * @public
      */
-    sendEvent(agentId: string, interactionId: string, eventType: AIAssistantEventType, eventName: AIAssistantEventName, action: TranscriptAction): Promise<Record<string, unknown>>;
+    sendRealTimeAssistanceUserAction(params: RealTimeAssistanceUserActionParams): Promise<Record<string, unknown>>;
     /**
      * Fetches historic transcripts for an interaction.
      * This API is allowed only when real-time transcription feature is enabled.