@webex/contact-center 3.12.0-next.17 → 3.12.0-next.170

package/dist/types/index.d.ts

@@ -1,26 +1,28 @@
 import ContactCenter from './cc';
 /**
  * @module ContactCenterModule
- * /
-
-// Core exports
+ */
 /**
  * ContactCenter is the main plugin class for Webex Contact Center integration
  * @category Core
  */
 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 { AI_SUMMARY_ERROR_CODES } from './constants';
+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';
 /**
@@ -38,7 +40,7 @@ export type { TASK_EVENTS as TaskEvents } from './services/task/types';
 export { AGENT_EVENTS } from './services/agent/types';
 export type { AGENT_EVENTS as AgentEvents } from './services/agent/types';
 /**
- * Contact Center Task Events
+ * Contact Center task, realtime, and AI Assistant events
  * @enum {string}
  * @category Enums
  */
@@ -89,15 +91,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, AISummaryAction, AISummaryFeedback, AISummaryState, AISummarySections, AISummary, AISummaryFeatureEnablement, AISummaryResponse, } from './services/task/types';
+/** UI controls utilities */
+export { getDefaultUIControls } from './services/task/state-machine/uiControlsComputer';
 /** Agent related types */
 export type { 
 /** State change interface */
@@ -130,10 +148,14 @@ BuddyAgentsSuccess, } from './services/agent/types';
 export type { 
 /** Profile interface */
 Profile, 
-/** Response type from getUserUsingCI method */
+/** Aggregated organization configuration from getOrgDesktopLoginConfig */
+OrgDesktopLoginResponse, 
+/** Aggregated user configuration from getUserDesktopLoginConfig */
+UserDesktopLoginResponse, 
+/** Agent identity, the `user` section of the user desktop-login aggregate */
 AgentResponse, 
-/** Response from getDesktopProfileById */
-DesktopProfileResponse, 
+/** Desktop Profile settings, the `agentProfile` section of the user desktop-login aggregate */
+AgentProfile, 
 /** Response from getMultimediaProfileById */
 MultimediaProfileResponse, 
 /** Response from getListOfTeams */
@@ -142,14 +164,18 @@ ListTeamsResponse,
 ListAuxCodesResponse, 
 /** Response from getSiteInfo */
 SiteInfo, 
-/** Response from getOrgInfo */
+/** Organization identity, the `organization` section of the org desktop-login aggregate */
 OrgInfo, 
-/** Response from getOrganizationSetting */
+/** Organization settings, the `organizationSetting` section of the org desktop-login aggregate */
 OrgSettings, 
-/** Response from getTenantData */
+/** Tenant configuration, the `tenantConfiguration` section of the org desktop-login aggregate */
 TenantData, 
-/** Response from getURLMapping */
-URLMapping, 
+/** Microsoft Teams integration configuration, from the org desktop-login aggregate */
+MicrosoftConfig, 
+/** Webex integration configuration, from the org desktop-login aggregate */
+WebexConfig, 
+/** External integration URLs, the `urlMappings` section of the org desktop-login aggregate */
+OrgUrlMappings, 
 /** Response from getDialPlanData */
 DialPlanEntity, 
 /** Auxiliary code information */
@@ -167,7 +193,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,37 @@ 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 WXAPP_OFFER_PARTICIPANT_FIELDS_MISSING: "WxApp Offer Participant Fields Missing";
     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";
@@ -147,8 +169,33 @@ export declare const METRIC_EVENT_NAMES: {
     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 AI_SUMMARY_GET_POST_CALL_SUCCESS: "Post Call Summary Get Success";
+    readonly AI_SUMMARY_GET_POST_CALL_FAILED: "Post Call Summary Get Failed";
+    readonly AI_SUMMARY_GET_MID_CALL_SUCCESS: "Mid Call Summary Get Success";
+    readonly AI_SUMMARY_GET_MID_CALL_FAILED: "Mid Call Summary Get Failed";
+    readonly AI_SUMMARY_POST_CALL_RESPONSE_SUCCESS: "Post Call Summary Response Success";
+    readonly AI_SUMMARY_POST_CALL_RESPONSE_FAILED: "Post Call Summary Response Failed";
+    readonly AI_SUMMARY_MID_CALL_RESPONSE_SUCCESS: "Mid Call Summary Response Success";
+    readonly AI_SUMMARY_MID_CALL_RESPONSE_FAILED: "Mid Call Summary Response 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,19 +12,76 @@ import { AIFeatureFlags } from './config/types';
 export declare class ApiAIAssistant {
     private webex;
     private metricsManager;
-    aiFeature: AIFeatureFlags;
-    constructor(webex: WebexSDK);
+    private pendingRtdRequests;
+    private readonly wellnessContextProvider?;
+    private createWellnessError;
+    constructor(webex: WebexSDK, wellnessContextProvider?: WellnessBreakContextProvider);
     setAIFeatureFlags(aiFeature: AIFeatureFlags): void;
+    /**
+     * Validates a caller-supplied identifier (agentId/interactionId) before it is used to
+     * construct a request. Accepts a non-empty alphanumeric identifier that may contain
+     * hyphens or underscores.
+     * @param value - the identifier to validate
+     * @returns {boolean} true when the identifier is a non-empty, well-formed string
+     * @private
+     */
+    private isValidTranscriptIdentifier;
+    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;
+    private static getRtdRequestKey;
+    private removeRtdRequest;
     /**
      * Sends an event to the AI Assistant service.
      * @param agentId - agent identifier
      * @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, publishTimestamp?: number, timeout?: number): 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.

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

@@ -27,7 +27,7 @@ import type { EntryPointListResponse, EntryPointSearchParams } from '../types';
  * });
  *
  * // Search for specific entry points
- * const searchResults = await entryPointAPI.searchEntryPoints({
+ * const searchResults = await entryPointAPI.getEntryPoints({
  *   search: 'support',
  *   filter: 'type=="voice"'
  * });
@@ -37,7 +37,6 @@ export declare class EntryPoint {
     private webexRequest;
     private webex;
     private metricsManager;
-    private pageCache;
     /**
      * Creates an instance of EntryPoint
      * @param {WebexSDK} webex - The Webex SDK instance
@@ -45,14 +44,17 @@ export declare class EntryPoint {
      */
     constructor(webex: WebexSDK);
     /**
-     * Fetches entry points for the organization with pagination support
-     * @param {EntryPointSearchParams} [params] - Search and pagination parameters
+     * Fetches entry-point dial-number mappings for the organization with pagination support. By
+     * default, returns the agent's desktop-profile-filtered mappings in backend entry-point-name order.
+     * Search, filter, attribute, and sort parameters can customize the request while desktop-profile
+     * scoping and required mapping fields remain SDK-owned.
+     * @param {EntryPointSearchParams} [params] - Search, pagination, and compatible override parameters.
      * @returns {Promise<EntryPointListResponse>} Promise resolving to paginated entry points
      * @throws {Error} If the API call fails
      * @public
      * @example
      * ```typescript
-     * // Get first page of entry points
+     * // Get the first page using the default entry-point policy
      * const response = await entryPointAPI.getEntryPoints();
      *
      * // Get specific page with custom page size

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

@@ -48,14 +48,16 @@ export declare class Queue {
      */
     constructor(webex: WebexSDK);
     /**
-     * Fetches contact service queues for the organization
-     * @param {ContactServiceQueueSearchParams} [params] - Search and pagination parameters
+     * Fetches contact service queues for the organization. By default, returns active inbound
+     * telephony queues in backend name-ascending order using the agent's desktop profile views.
+     * Existing filter, sort, and desktop-profile parameters override those defaults.
+     * @param {ContactServiceQueueSearchParams} [params] - Search, pagination, and override parameters
      * @returns {Promise<ContactServiceQueuesResponse>} Promise resolving to contact service queues
      * @throws {Error} If the API call fails
      * @public
      * @example
      * ```typescript
-     * // Get all queues with default pagination
+     * // Get queues using the default list policy and pagination
      * const response = await queueAPI.getQueues();
      *
      * // Get queues with specific pagination

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

@@ -0,0 +1,118 @@
+import { WebexSDK } from '../types';
+import type { UserPreference as UserPreferenceResponse, CreateUserPreferenceRequest, UpdateUserPreferenceRequest, GetUserPreferenceParams } from './config/types';
+/**
+ * UserPreference API class for managing Webex Contact Center user preferences.
+ * Provides functionality to get, create, update, and delete user preferences.
+ *
+ * @class UserPreference
+ * @public
+ * @example
+ * ```typescript
+ * import Webex from 'webex';
+ *
+ * const webex = new Webex({ credentials: 'YOUR_ACCESS_TOKEN' });
+ * const cc = webex.cc;
+ *
+ * // Register and login first
+ * await cc.register();
+ * await cc.stationLogin({ teamId: 'team123', loginOption: 'BROWSER' });
+ *
+ * // Get UserPreference API instance from ContactCenter
+ * const userPreferenceAPI = cc.userPreference;
+ *
+ * // Get user preferences for the current user
+ * const preferences = await userPreferenceAPI.getUserPreference();
+ *
+ * // Create new user preferences
+ * const newPreferences = await userPreferenceAPI.createUserPreference({
+ *   userId: 'user123',
+ *   preferences: { e911Reminder: true }
+ * });
+ *
+ * // Update user preferences
+ * const updatedPreferences = await userPreferenceAPI.updateUserPreference('user123', {
+ *   preferences: { e911Reminder: false }
+ * });
+ *
+ * // Delete user preferences
+ * await userPreferenceAPI.deleteUserPreference('user123');
+ * ```
+ */
+export declare class UserPreference {
+    private webexRequest;
+    private webex;
+    private getUserId;
+    private metricsManager;
+    /**
+     * Creates an instance of UserPreference
+     * @param {WebexSDK} webex - The Webex SDK instance
+     * @param {() => string} getUserId - Function to get the current user's CI user ID
+     * @public
+     */
+    constructor(webex: WebexSDK, getUserId: () => string);
+    /**
+     * Fetches user preferences for a specific user
+     * @param {GetUserPreferenceParams} [params] - Optional parameters for fetching preferences
+     * @param {string} [params.userId] - User ID to fetch preferences for. Defaults to current user's CI user ID.
+     * @param {number} [params.page=0] - Page number (0-indexed). Default: 0
+     * @param {number} [params.pageSize=100] - Number of items per page. Default: 100
+     * @returns {Promise<UserPreferenceResponse>} Promise resolving to user preferences
+     * @throws {Error} If the API call fails
+     * @public
+     * @example
+     * ```typescript
+     * // Get preferences for current user
+     * const preferences = await userPreferenceAPI.getUserPreference();
+     *
+     * // Get preferences for a specific user
+     * const preferences = await userPreferenceAPI.getUserPreference({ userId: 'user123' });
+     *
+     * // Get preferences with pagination
+     * const preferences = await userPreferenceAPI.getUserPreference({ page: 0, pageSize: 50 });
+     * ```
+     */
+    getUserPreference(params?: GetUserPreferenceParams): Promise<UserPreferenceResponse>;
+    /**
+     * Creates new user preferences
+     * @param {CreateUserPreferenceRequest} data - The user preference data to create
+     * @returns {Promise<UserPreference>} Promise resolving to created user preferences
+     * @throws {Error} If the API call fails
+     * @public
+     * @example
+     * ```typescript
+     * const newPreferences = await userPreferenceAPI.createUserPreference({
+     *   userId: 'user123',
+     *   preferences: { e911Reminder: true, notificationSettings: { email: true } }
+     * });
+     * ```
+     */
+    createUserPreference(data: CreateUserPreferenceRequest): Promise<UserPreferenceResponse>;
+    /**
+     * Updates existing user preferences
+     * @param {string} userId - User ID to update preferences for
+     * @param {UpdateUserPreferenceRequest} data - The user preference data to update
+     * @returns {Promise<UserPreference>} Promise resolving to updated user preferences
+     * @throws {Error} If the API call fails
+     * @public
+     * @example
+     * ```typescript
+     * const updatedPreferences = await userPreferenceAPI.updateUserPreference('user123', {
+     *   preferences: { e911Reminder: false }
+     * });
+     * ```
+     */
+    updateUserPreference(userId: string, data: UpdateUserPreferenceRequest): Promise<UserPreferenceResponse>;
+    /**
+     * Deletes user preferences for a specific user
+     * @param {string} userId - User ID to delete preferences for
+     * @returns {Promise<void>} Promise resolving when deletion is complete
+     * @throws {Error} If the API call fails
+     * @public
+     * @example
+     * ```typescript
+     * await userPreferenceAPI.deleteUserPreference('user123');
+     * ```
+     */
+    deleteUserPreference(userId: string): Promise<void>;
+}
+export default UserPreference;

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

@@ -0,0 +1,32 @@
+import { WebexSDK } from '../types';
+/**
+ * Publishes usersub cross-client state so Webex App suppresses native calling toasts (WXCC-6026).
+ */
+export default class WebexCrossClientService {
+    private webex;
+    private refreshTimer?;
+    private refreshRetryTimer?;
+    private answerCallsState;
+    private appName;
+    /** Incremented on teardown/disable to ignore stale refresh timer callbacks. */
+    private refreshGeneration;
+    /** Monotonic id for usersub publish metrics timers; stale publishes cancel only their own timer. */
+    private usersubPublishMetricsId;
+    constructor(webex: WebexSDK);
+    private extractDeviceIdFromUrl;
+    private getDeviceUrl;
+    private clearRefreshTimer;
+    private scheduleRefreshRetry;
+    private startRefreshTimer;
+    private publishCrossClientState;
+    setManageWebexCallingInWxcc(enable: boolean, options?: {
+        userId?: string;
+        ttl?: number;
+        appName?: string;
+        trackPublishMetrics?: boolean;
+    }): Promise<void>;
+    private trackUsersubPreflightFailure;
+    teardown(): void;
+    /** Whether usersub `answer-calls-on-wxcc: true` was successfully published this session. */
+    isAnswerCallsStateActive(): boolean;
+}

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

@@ -0,0 +1,28 @@
+import { WebexSDK } from '../types';
+export declare const TELEPHONY_CALL_MUTED = "event:telephony_calls.muted";
+export declare const TELEPHONY_CALL_UNMUTED = "event:telephony_calls.unmuted";
+export type UpdatedCallMuteStateEvent = {
+    data: {
+        actorId: string;
+        callId: string;
+        muted: boolean;
+    };
+};
+type MuteChangeHandler = (callId: string, muted: boolean) => void;
+/**
+ * Subscribes to Mercury telephony mute/unmute events for wxApp thick-client sync (AD parity).
+ */
+export default class WxAppTelephonyMercurySync {
+    private webex;
+    private subscribedAgentId?;
+    private muteChangeHandler?;
+    private boundMuteHandler?;
+    private boundUnmuteHandler?;
+    constructor(webex: WebexSDK);
+    private decodeBase64;
+    private handleMuteStateEvent;
+    subscribe(agentId: string, onMuteChange: MuteChangeHandler): void;
+    unsubscribe(): void;
+    isSubscribed(): boolean;
+}
+export {};

package/dist/types/services/config/Util.d.ts

@@ -1,20 +1,16 @@
-import { AgentResponse, AuxCode, DesktopProfileResponse, DialPlanEntity, OrgInfo, OrgSettings, Profile, Team, TenantData, URLMapping, AIFeatureFlagsResponse } from './types';
+import { AgentProfile, AgentResponse, AuxCode, DialPlanEntity, OrgDesktopLoginResponse, Profile, TeamList } from './types';
 /**
  * Parse the agent configurations
  * @param {Object} profileData
  * @returns {Profile}
  */
 declare function parseAgentConfigs(profileData: {
+    orgConfig: OrgDesktopLoginResponse;
     userData: AgentResponse;
-    teamData: Team[];
-    tenantData: TenantData;
-    orgInfoData: OrgInfo;
+    agentProfileData: AgentProfile;
+    teamData: TeamList[];
     auxCodes: AuxCode[];
-    orgSettingsData: OrgSettings;
-    agentProfileData: DesktopProfileResponse;
     dialPlanData: DialPlanEntity[];
-    urlMapping: URLMapping[];
     multimediaProfileId: string;
-    aiFeatureFlags: AIFeatureFlagsResponse;
 }): Profile;
 export { parseAgentConfigs };