@webex/contact-center 3.12.0-llmrefactor.12 → 3.12.0-llmrefactor.14

package/dist/services/wxAppDiagnosticLogging.js.map

@@ -1 +1 @@
-{"version":3,"names":["_loggerProxy","_interopRequireDefault","require","e","__esModule","default","WXAPP_LOG_FEATURE","exports","WXAPP_LOG_PREFIX","callIdSuffix","callId","undefined","length","slice","logWxApp","message","method","data","LoggerProxy","info","module","feature","logWxAppError","error","logWxAppSessionReadiness","params","event","enableWxBetterTogether","loginOption","wxAppHooksApplied","usersubPublished","mercurySubscribed","telephonyTaskType","skipReason","deriveWxAppAcceptReason","isWxAppInboundOffer","isWxAppOutdialOffer","wxAppAcceptInFlight","wxAppAnswerPending","isWebrtc","isOutdial","hasDeviceCallId","logWxAppOfferDecision","interactionId","acceptVisible","acceptEnabled","acceptReason","wxAppParticipantDeviceType","logWxAppTelephonyAction","payload","action","phase","trackingId","httpStatus","failureReason","logWxAppValidationFailure","reason","logWxAppMercuryMuteSync","muted","dropReason"],"sources":["wxAppDiagnosticLogging.ts"],"sourcesContent":["import LoggerProxy from '../logger-proxy';\n\nexport const WXAPP_LOG_FEATURE = 'wxApp';\nexport const WXAPP_LOG_PREFIX = '[CC wxApp]';\n\nexport type WxAppAcceptReason =\n  | 'wxApp_offer_ready'\n  | 'wxApp_answer_pending'\n  | 'wxApp_accept_in_flight'\n  | 'extension_non_wxApp_offer'\n  | 'browser_webrtc_offer'\n  | 'outdial_auto_answer';\n\nexport type WxAppSessionSkipReason =\n  | 'unsupported_browser_login'\n  | 'flag_disabled'\n  | 'mercury_subscribe_failed'\n  | 'publish_failed';\n\nexport type WxAppTelephonyAction = 'accept' | 'decline' | 'mute' | 'dtmf';\nexport type WxAppTelephonyPhase = 'started' | 'success' | 'failed';\n\ntype WxAppLogData = Record<string, string | boolean | number | undefined>;\n\n/** Last 8 chars of callId for correlation without logging full id. */\nexport function callIdSuffix(callId: string | null | undefined): string | undefined {\n  if (!callId) {\n    return undefined;\n  }\n\n  return callId.length <= 8 ? callId : callId.slice(-8);\n}\n\nfunction logWxApp(message: string, method: string, data: WxAppLogData): void {\n  LoggerProxy.info(`${WXAPP_LOG_PREFIX} ${message}`, {\n    module: 'wxAppDiagnosticLogging',\n    method,\n    data: {feature: WXAPP_LOG_FEATURE, ...data},\n  });\n}\n\nfunction logWxAppError(message: string, method: string, data: WxAppLogData): void {\n  LoggerProxy.error(`${WXAPP_LOG_PREFIX} ${message}`, {\n    module: 'wxAppDiagnosticLogging',\n    method,\n    data: {feature: WXAPP_LOG_FEATURE, ...data},\n  });\n}\n\nexport function logWxAppSessionReadiness(params: {\n  enableWxBetterTogether: boolean;\n  loginOption: string | undefined;\n  wxAppHooksApplied: boolean;\n  usersubPublished: boolean;\n  mercurySubscribed: boolean;\n  telephonyTaskType: 'Voice' | 'WebRTC' | 'unknown';\n  skipReason?: WxAppSessionSkipReason;\n}): void {\n  logWxApp('session readiness', 'logWxAppSessionReadiness', {\n    event: 'session_readiness',\n    enableWxBetterTogether: params.enableWxBetterTogether,\n    loginOption: params.loginOption,\n    wxAppHooksApplied: params.wxAppHooksApplied,\n    usersubPublished: params.usersubPublished,\n    mercurySubscribed: params.mercurySubscribed,\n    telephonyTaskType: params.telephonyTaskType,\n    skipReason: params.skipReason,\n  });\n}\n\nexport function deriveWxAppAcceptReason(params: {\n  isWxAppInboundOffer: boolean;\n  isWxAppOutdialOffer: boolean;\n  isWebrtc: boolean;\n  isOutdial: boolean;\n  wxAppAcceptInFlight: boolean;\n  wxAppAnswerPending: boolean;\n  enableWxBetterTogether: boolean;\n  hasDeviceCallId: boolean;\n}): WxAppAcceptReason {\n  if (params.isWxAppInboundOffer || params.isWxAppOutdialOffer) {\n    if (params.wxAppAcceptInFlight) {\n      return 'wxApp_accept_in_flight';\n    }\n    if (params.wxAppAnswerPending) {\n      return 'wxApp_answer_pending';\n    }\n\n    return 'wxApp_offer_ready';\n  }\n\n  if (params.isWebrtc && !params.isOutdial) {\n    return 'browser_webrtc_offer';\n  }\n\n  if (params.isOutdial) {\n    return 'outdial_auto_answer';\n  }\n\n  if (params.enableWxBetterTogether && !params.hasDeviceCallId) {\n    return 'extension_non_wxApp_offer';\n  }\n\n  return 'extension_non_wxApp_offer';\n}\n\nexport function logWxAppOfferDecision(params: {\n  interactionId: string;\n  acceptVisible: boolean;\n  acceptEnabled: boolean;\n  acceptReason: WxAppAcceptReason;\n  wxAppParticipantDeviceType?: string;\n  hasDeviceCallId: boolean;\n}): void {\n  logWxApp('offer decision', 'logWxAppOfferDecision', {\n    event: 'offer_decision',\n    interactionId: params.interactionId,\n    acceptVisible: params.acceptVisible,\n    acceptEnabled: params.acceptEnabled,\n    acceptReason: params.acceptReason,\n    wxAppParticipantDeviceType: params.wxAppParticipantDeviceType,\n    hasDeviceCallId: params.hasDeviceCallId,\n  });\n}\n\nexport function logWxAppTelephonyAction(params: {\n  action: WxAppTelephonyAction;\n  phase: WxAppTelephonyPhase;\n  interactionId?: string;\n  trackingId?: string;\n  httpStatus?: number | string;\n  failureReason?: string;\n}): void {\n  const payload: WxAppLogData = {\n    event: 'telephony_action',\n    action: params.action,\n    phase: params.phase,\n    interactionId: params.interactionId,\n    trackingId: params.trackingId,\n    httpStatus: params.httpStatus,\n    failureReason: params.failureReason,\n  };\n\n  if (params.phase === 'failed') {\n    logWxAppError(`telephony ${params.action} ${params.phase}`, 'logWxAppTelephonyAction', payload);\n  } else {\n    logWxApp(`telephony ${params.action} ${params.phase}`, 'logWxAppTelephonyAction', payload);\n  }\n}\n\nexport function logWxAppValidationFailure(reason: string, interactionId?: string): void {\n  logWxAppError('validation failed', 'logWxAppValidationFailure', {\n    event: 'validation_failed',\n    reason,\n    interactionId,\n  });\n}\n\nexport function logWxAppMercuryMuteSync(params: {\n  phase: 'received' | 'applied' | 'dropped';\n  muted?: boolean;\n  callIdSuffix?: string;\n  interactionId?: string;\n  dropReason?: string;\n}): void {\n  logWxApp(`mercury mute sync ${params.phase}`, 'logWxAppMercuryMuteSync', {\n    event: 'mercury_mute_sync',\n    phase: params.phase,\n    muted: params.muted,\n    callIdSuffix: params.callIdSuffix,\n    interactionId: params.interactionId,\n    dropReason: params.dropReason,\n  });\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_loggerProxy","_interopRequireDefault","require","e","__esModule","default","WXAPP_LOG_FEATURE","exports","WXAPP_LOG_PREFIX","callIdSuffix","callId","undefined","length","slice","formatLogSuffix","data","keys","entries","map","key","Object","filter","parts","value","String","join","logWxApp","message","method","suffixKeys","suffix","LoggerProxy","log","module","feature","logWxAppWarn","warn","logWxAppError","error","logWxAppSessionReadiness","params","event","enableWxBetterTogether","loginOption","wxAppHooksApplied","usersubPublished","mercurySubscribed","telephonyTaskType","skipReason","deriveWxAppAcceptReason","isWxAppInboundOffer","isWxAppOutdialOffer","wxAppAcceptInFlight","wxAppAnswerPending","isWebrtc","isOutdial","hasDeviceCallId","logWxAppOfferDecision","interactionId","acceptVisible","acceptEnabled","acceptReason","wxAppParticipantDeviceType","hasDeviceId","logWxAppOfferParticipantMismatch","participantDeviceType","logWxAppTelephonyAction","payload","action","phase","trackingId","httpStatus","failureReason","logWxAppValidationFailure","reason","logWxAppMercuryMuteSync","muted","dropReason"],"sources":["wxAppDiagnosticLogging.ts"],"sourcesContent":["import LoggerProxy from '../logger-proxy';\n\nexport const WXAPP_LOG_FEATURE = 'wxApp';\nexport const WXAPP_LOG_PREFIX = '[CC wxApp]';\n\nexport type WxAppAcceptReason =\n  | 'wxApp_offer_ready'\n  | 'wxApp_answer_pending'\n  | 'wxApp_accept_in_flight'\n  | 'extension_non_wxApp_offer'\n  | 'browser_webrtc_offer'\n  | 'outdial_auto_answer';\n\nexport type WxAppSessionSkipReason =\n  | 'unsupported_browser_login'\n  | 'flag_disabled'\n  | 'mercury_subscribe_failed'\n  | 'publish_failed';\n\nexport type WxAppTelephonyAction = 'accept' | 'decline' | 'mute' | 'dtmf';\nexport type WxAppTelephonyPhase = 'started' | 'success' | 'failed';\n\ntype WxAppLogData = Record<string, string | boolean | number | undefined>;\n\n/** Last 8 chars of callId for correlation without logging full id. */\nexport function callIdSuffix(callId: string | null | undefined): string | undefined {\n  if (!callId) {\n    return undefined;\n  }\n\n  return callId.length <= 8 ? callId : callId.slice(-8);\n}\n\nfunction formatLogSuffix(data: WxAppLogData, keys?: string[]): string {\n  const entries = keys\n    ? keys.map((key) => [key, data[key]] as const)\n    : Object.entries(data).filter(([key]) => key !== 'feature' && key !== 'event');\n\n  const parts = entries\n    .filter(([, value]) => value !== undefined && value !== null && value !== '')\n    .map(([key, value]) => `${key}=${String(value)}`);\n\n  return parts.length > 0 ? ` ${parts.join(' ')}` : '';\n}\n\nfunction logWxApp(\n  message: string,\n  method: string,\n  data: WxAppLogData,\n  suffixKeys?: string[]\n): void {\n  const suffix = formatLogSuffix(data, suffixKeys);\n  LoggerProxy.log(`${WXAPP_LOG_PREFIX} ${message}${suffix}`, {\n    module: 'wxAppDiagnosticLogging',\n    method,\n    data: {feature: WXAPP_LOG_FEATURE, ...data},\n  });\n}\n\nfunction logWxAppWarn(\n  message: string,\n  method: string,\n  data: WxAppLogData,\n  suffixKeys?: string[]\n): void {\n  const suffix = formatLogSuffix(data, suffixKeys);\n  LoggerProxy.warn(`${WXAPP_LOG_PREFIX} ${message}${suffix}`, {\n    module: 'wxAppDiagnosticLogging',\n    method,\n    data: {feature: WXAPP_LOG_FEATURE, ...data},\n  });\n}\n\nfunction logWxAppError(\n  message: string,\n  method: string,\n  data: WxAppLogData,\n  suffixKeys?: string[]\n): void {\n  const suffix = formatLogSuffix(data, suffixKeys);\n  LoggerProxy.error(`${WXAPP_LOG_PREFIX} ${message}${suffix}`, {\n    module: 'wxAppDiagnosticLogging',\n    method,\n    data: {feature: WXAPP_LOG_FEATURE, ...data},\n  });\n}\n\nexport function logWxAppSessionReadiness(params: {\n  enableWxBetterTogether: boolean;\n  loginOption: string | undefined;\n  wxAppHooksApplied: boolean;\n  usersubPublished: boolean;\n  mercurySubscribed: boolean;\n  telephonyTaskType: 'Voice' | 'WebRTC' | 'unknown';\n  skipReason?: WxAppSessionSkipReason;\n}): void {\n  const data: WxAppLogData = {\n    event: 'session_readiness',\n    enableWxBetterTogether: params.enableWxBetterTogether,\n    loginOption: params.loginOption,\n    wxAppHooksApplied: params.wxAppHooksApplied,\n    usersubPublished: params.usersubPublished,\n    mercurySubscribed: params.mercurySubscribed,\n    telephonyTaskType: params.telephonyTaskType,\n    skipReason: params.skipReason,\n  };\n\n  logWxApp('session readiness', 'logWxAppSessionReadiness', data, [\n    'usersubPublished',\n    'mercurySubscribed',\n    'loginOption',\n    'enableWxBetterTogether',\n    'telephonyTaskType',\n    'skipReason',\n  ]);\n}\n\nexport function deriveWxAppAcceptReason(params: {\n  isWxAppInboundOffer: boolean;\n  isWxAppOutdialOffer: boolean;\n  isWebrtc: boolean;\n  isOutdial: boolean;\n  wxAppAcceptInFlight: boolean;\n  wxAppAnswerPending: boolean;\n  enableWxBetterTogether: boolean;\n  hasDeviceCallId: boolean;\n}): WxAppAcceptReason {\n  if (params.isWxAppInboundOffer || params.isWxAppOutdialOffer) {\n    if (params.wxAppAcceptInFlight) {\n      return 'wxApp_accept_in_flight';\n    }\n    if (params.wxAppAnswerPending) {\n      return 'wxApp_answer_pending';\n    }\n\n    return 'wxApp_offer_ready';\n  }\n\n  if (params.isWebrtc && !params.isOutdial) {\n    return 'browser_webrtc_offer';\n  }\n\n  if (params.isOutdial) {\n    return 'outdial_auto_answer';\n  }\n\n  if (params.enableWxBetterTogether && !params.hasDeviceCallId) {\n    return 'extension_non_wxApp_offer';\n  }\n\n  return 'extension_non_wxApp_offer';\n}\n\nexport function logWxAppOfferDecision(params: {\n  interactionId: string;\n  acceptVisible: boolean;\n  acceptEnabled: boolean;\n  acceptReason: WxAppAcceptReason;\n  wxAppParticipantDeviceType?: string;\n  hasDeviceCallId: boolean;\n  hasDeviceId?: boolean;\n  usersubPublished?: boolean;\n}): void {\n  const data: WxAppLogData = {\n    event: 'offer_decision',\n    interactionId: params.interactionId,\n    acceptVisible: params.acceptVisible,\n    acceptEnabled: params.acceptEnabled,\n    acceptReason: params.acceptReason,\n    wxAppParticipantDeviceType: params.wxAppParticipantDeviceType,\n    hasDeviceCallId: params.hasDeviceCallId,\n    hasDeviceId: params.hasDeviceId,\n    usersubPublished: params.usersubPublished,\n  };\n\n  logWxApp('offer decision', 'logWxAppOfferDecision', data, [\n    'acceptReason',\n    'hasDeviceCallId',\n    'hasDeviceId',\n    'usersubPublished',\n    'interactionId',\n    'acceptVisible',\n    'acceptEnabled',\n  ]);\n}\n\nexport function logWxAppOfferParticipantMismatch(params: {\n  interactionId: string;\n  usersubPublished: boolean;\n  hasDeviceCallId: boolean;\n  hasDeviceId: boolean;\n  participantDeviceType?: string;\n  acceptVisible: boolean;\n  acceptEnabled: boolean;\n  acceptReason: WxAppAcceptReason;\n}): void {\n  const data: WxAppLogData = {\n    event: 'participant_fields_mismatch',\n    interactionId: params.interactionId,\n    usersubPublished: params.usersubPublished,\n    hasDeviceCallId: params.hasDeviceCallId,\n    hasDeviceId: params.hasDeviceId,\n    participantDeviceType: params.participantDeviceType ?? 'missing',\n    acceptVisible: params.acceptVisible,\n    acceptEnabled: params.acceptEnabled,\n    acceptReason: params.acceptReason,\n  };\n\n  logWxAppWarn('participant fields mismatch', 'logWxAppOfferParticipantMismatch', data, [\n    'usersubPublished',\n    'hasDeviceCallId',\n    'hasDeviceId',\n    'acceptReason',\n    'interactionId',\n    'participantDeviceType',\n  ]);\n}\n\nexport function logWxAppTelephonyAction(params: {\n  action: WxAppTelephonyAction;\n  phase: WxAppTelephonyPhase;\n  interactionId?: string;\n  trackingId?: string;\n  httpStatus?: number | string;\n  failureReason?: string;\n}): void {\n  const payload: WxAppLogData = {\n    event: 'telephony_action',\n    action: params.action,\n    phase: params.phase,\n    interactionId: params.interactionId,\n    trackingId: params.trackingId,\n    httpStatus: params.httpStatus,\n    failureReason: params.failureReason,\n  };\n\n  if (params.phase === 'failed') {\n    logWxAppError(\n      `telephony ${params.action} ${params.phase}`,\n      'logWxAppTelephonyAction',\n      payload,\n      ['interactionId', 'trackingId', 'httpStatus', 'failureReason']\n    );\n  } else {\n    logWxApp(`telephony ${params.action} ${params.phase}`, 'logWxAppTelephonyAction', payload, [\n      'interactionId',\n      'action',\n      'phase',\n    ]);\n  }\n}\n\nexport function logWxAppValidationFailure(reason: string, interactionId?: string): void {\n  logWxAppError(\n    'validation failed',\n    'logWxAppValidationFailure',\n    {\n      event: 'validation_failed',\n      reason,\n      interactionId,\n    },\n    ['reason', 'interactionId']\n  );\n}\n\nexport function logWxAppMercuryMuteSync(params: {\n  phase: 'received' | 'applied' | 'dropped';\n  muted?: boolean;\n  callIdSuffix?: string;\n  interactionId?: string;\n  dropReason?: string;\n}): void {\n  logWxApp(\n    `mercury mute sync ${params.phase}`,\n    'logWxAppMercuryMuteSync',\n    {\n      event: 'mercury_mute_sync',\n      phase: params.phase,\n      muted: params.muted,\n      callIdSuffix: params.callIdSuffix,\n      interactionId: params.interactionId,\n      dropReason: params.dropReason,\n    },\n    ['phase', 'muted', 'callIdSuffix', 'interactionId', 'dropReason']\n  );\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/types/cc.d.ts

@@ -9,7 +9,7 @@ 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';
@@ -213,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
@@ -354,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
@@ -577,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,

package/dist/types/constants.d.ts

@@ -7,6 +7,7 @@ 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";
@@ -66,6 +67,9 @@ export declare const METHODS: {
     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;

package/dist/types/index.d.ts

@@ -22,6 +22,8 @@ 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';
 /**
@@ -90,7 +92,15 @@ 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) */

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

@@ -145,6 +145,7 @@ export declare const METRIC_EVENT_NAMES: {
     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";
@@ -174,6 +175,11 @@ export declare const METRIC_EVENT_NAMES: {
     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";

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

@@ -1,5 +1,10 @@
-import { WebexSDK, AIAssistantEventType, AIAssistantEventName, HistoricTranscriptsResponse, RealTimeAssistanceParams, RealTimeAssistanceUserActionParams } 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
@@ -8,8 +13,36 @@ export declare class ApiAIAssistant {
     private webex;
     private metricsManager;
     private aiFeature;
-    constructor(webex: WebexSDK);
+    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.

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

@@ -28,6 +28,8 @@ export declare const AGENT_STATE_AVAILABLE_ID = "0";
  * @ignore
  */
 export declare const AGENT_STATE_AVAILABLE = "Available";
+/** System idle-code name reserved for Agent Wellness Break. */
+export declare const WELLBEING_BREAK_IDLE_CODE = "WellbeingBreak";
 /**
  * Description for the 'Available' agent state.
  * @type {string}
@@ -58,6 +60,7 @@ export declare const METHODS: {
     GET_URL_MAPPING: string;
     GET_DIAL_PLAN_DATA: string;
     GET_AI_FEATURE_FLAGS: string;
+    GET_WELLBEING_BREAK_IDLE_CODE: string;
     GET_QUEUES: string;
     PARSE_AGENT_CONFIGS: string;
     GET_URL_MAPPING_UTIL: string;
@@ -135,6 +138,8 @@ export declare const endPointMap: {
      * @ignore
      */
     listAuxCodes: (orgId: string, page: number, pageSize: number, filter: string[], attributes: string[]) => string;
+    /** Lists system idle codes without applying the agent Desktop Profile filter. */
+    systemIdleCodes: (orgId: string, page: number, pageSize: number) => string;
     /**
      * Gets the endpoint for organization info.
      * @param orgId - Organization ID.

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

@@ -141,8 +141,7 @@ export declare const CC_TASK_EVENTS: {
 /**
  * Events emitted on Contact Center agent operations
  * @enum {string}
- * @private
- * @ignore
+ * @public
  */
 export declare const CC_AGENT_EVENTS: {
     /** Welcome event when agent connects to websocket/backend */
@@ -181,6 +180,8 @@ export declare const CC_AGENT_EVENTS: {
     readonly AGENT_BUDDY_AGENTS_RETRIEVE_FAILED: "BuddyAgentsRetrieveFailed";
     /** Event emitted when contact is reserved for agent */
     readonly AGENT_CONTACT_RESERVED: "AgentContactReserved";
+    /** Agent-level Agent Wellness Break notification */
+    readonly WELLNESS_BREAK: "WellnessBreak";
 };
 /**
  * Combined Contact Center events including both agent and task events
@@ -352,6 +353,8 @@ export declare const CC_EVENTS: {
     readonly AGENT_BUDDY_AGENTS_RETRIEVE_FAILED: "BuddyAgentsRetrieveFailed";
     /** Event emitted when contact is reserved for agent */
     readonly AGENT_CONTACT_RESERVED: "AgentContactReserved";
+    /** Agent-level Agent Wellness Break notification */
+    readonly WELLNESS_BREAK: "WellnessBreak";
 };
 /**
  * Event data received when agent connects to the system
@@ -800,6 +803,8 @@ export type OrgSettings = {
     maskSensitiveData: boolean;
     /** Whether campaign manager features are enabled */
     campaignManagerEnabled: boolean;
+    /** Number of AI Assistant licenses assigned to the organization */
+    aiAssistantQuantity?: number | null;
 };
 /**
  * Contact center site configuration information
@@ -1266,6 +1271,8 @@ export type Profile = {
     maskSensitiveData?: boolean;
     /** Whether agent is currently logged in */
     isAgentLoggedIn?: boolean;
+    /** Active station session after a successful registered relogin. */
+    agentSessionId?: string;
     /** Last auxiliary code ID used for state change */
     lastStateAuxCodeId?: string;
     /** Timestamp of last state change */
@@ -1274,6 +1281,12 @@ export type Profile = {
     lastIdleCodeChangeTimestamp?: number;
     /** AI feature flags resolved from organization config */
     aiFeature?: AIFeatureFlags;
+    /**
+     * Whether Agent Wellness Break is effectively enabled for this profile.
+     * This combines the organization wellbeing configuration with AI Assistant licensing;
+     * Server-side rollout remains enforced by the backend configuration and notification delivery.
+     */
+    isWellnessBreakEnabled?: boolean;
 };
 /**
  * Contact distribution group configuration for routing logic

package/dist/types/services/core/Utils.d.ts

@@ -3,6 +3,8 @@ import { LoginOption, WebexRequestPayload } from '../../types';
 import { Failure, AugmentedError } from './GlobalTypes';
 import { ConsultConferenceData, consultConferencePayloadData, ConsultTransferDestinationType, TaskData, Interaction } from '../task/types';
 import { DialPlan } from '../config/types';
+/** Returns whether a value is a non-null object with string keys. */
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
 /**
  * Strips characters defined in the dial plan entry from the input string.
  *

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

@@ -1846,6 +1846,8 @@ export type VoiceUIControlOptions = {
     enableWxBetterTogether?: boolean;
     consultTransferConfig?: ConsultTransferDestinationConfig;
     answerCallOnWebexService?: import('../AnswerCallOnWebexService').default;
+    /** Read-only observability: whether usersub answer-calls-on-wxcc is active this session. */
+    getUsersubPublished?: () => boolean;
 };
 /**
  * Participant information for UI display

package/dist/types/services/task/voice/Voice.d.ts

@@ -14,7 +14,9 @@ export default class Voice extends Task implements IVoice {
     private wxAppMuteSyncInFlight?;
     private wxAppMuteToggleTail;
     private wxAppDtmfTail;
-    private lastLoggedWxAppAcceptReason?;
+    /** Lazy — `super()` may call `updateUiControls` before field initializers run. */
+    private wxAppOfferObservability;
+    private getUsersubPublished?;
     constructor(contact: ReturnType<typeof routingContact>, data: TaskData, callOptions?: VoiceUIControlOptions, wrapupData?: WrapupData, agentId?: string);
     private getWxAppVoiceDependencies;
     /** @deprecated Use {@link Voice.getWxAppVoiceDependencies} */
@@ -24,8 +26,18 @@ export default class Voice extends Task implements IVoice {
     private setWxAppAnswerPending;
     private setWxAppAcceptInFlight;
     setEnableWxBetterTogether(enabled: boolean): void;
+    private getOrCreateWxAppOfferObservability;
     protected updateUiControls(forceEmit?: boolean): void;
-    private logWxAppOfferDecisionIfNeeded;
+    /**
+     * Re-run OFFERED wxApp diagnostics without emitting UI controls.
+     * Used after usersub publish so a pre-publish offer can schedule mismatch grace.
+     */
+    refreshWxAppOfferObservability(): void;
+    /**
+     * Cancel pending participant-mismatch grace timer. Observability only.
+     */
+    disposeWxAppOfferObservability(): void;
+    private getWxAppOfferObservabilityContext;
     applyWxAppMuteStateFromSync(incomingCallId: string, muted: boolean): void;
     getWxAppMuted(): boolean;
     private static delay;
@@ -40,6 +52,7 @@ export default class Voice extends Task implements IVoice {
     getWebexCallingCallId(): string | null;
     private createWxAppLifecycle;
     private getStateMachineSnapshot;
+    private getWxAppAcceptReasonForMetrics;
     /**
      * Accepts the task. Routes to wxApp telephony answer when `enableWxBetterTogether` and wxApp offer.
      */

package/dist/types/services/task/voice/wxAppOfferObservability.d.ts

@@ -0,0 +1,39 @@
+import MetricsManager from '../../../metrics/MetricsManager';
+import { TaskState } from '../state-machine';
+import { VoiceVariant } from '../types';
+import { WxAppVoiceDependencies } from './wxAppVoiceMethods';
+/** Defer mismatch WARN/metric so transient WS ordering gaps (~200–300 ms) do not false-alarm. */
+export declare const WXAPP_PARTICIPANT_MISMATCH_GRACE_MS = 500;
+export type WxAppOfferObservabilityContext = {
+    getInteractionId: () => string;
+    getTaskState: () => TaskState | undefined;
+    getAcceptControl: () => {
+        isVisible: boolean;
+        isEnabled: boolean;
+    } | undefined;
+    getVoiceVariant: () => VoiceVariant;
+    isOutdial: () => boolean;
+    isWxAppInboundOffer: () => boolean;
+    isWxAppCallingOffer: () => boolean;
+    getWxAppAcceptInFlight: () => boolean;
+    getWxAppAnswerPending: () => boolean;
+    getEnableWxBetterTogether: () => boolean;
+    getUsersubPublished: () => boolean;
+    getWxAppVoiceDependencies: () => WxAppVoiceDependencies;
+    getMetricsManager: () => MetricsManager;
+};
+/**
+ * OFFERED-state wxApp offer diagnostics: acceptReason logging and deferred participant mismatch.
+ * Invoked from Voice.updateUiControls — observability only.
+ */
+export declare class WxAppOfferObservability {
+    private lastLoggedWxAppAcceptReason?;
+    private lastLoggedWxAppParticipantMismatch;
+    private wxAppParticipantMismatchGraceTimer?;
+    private disposed;
+    handleUiControlsUpdate(ctx: WxAppOfferObservabilityContext): void;
+    dispose(): void;
+    private cancelGraceTimer;
+    private scheduleGraceTimer;
+    private emitParticipantMismatchIfStillNeeded;
+}

package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts

@@ -3,6 +3,7 @@ import { TaskData, TaskToggleMuteOptions, TaskTransmitDtmfOptions } from '../typ
 import { TaskState } from '../state-machine';
 import MetricsManager from '../../../metrics/MetricsManager';
 import { WebexCallingDeviceDetails } from '../WebexCallingUtils';
+import { type WxAppAcceptReason } from '../../wxAppDiagnosticLogging';
 export type WxAppVoiceDependencies = {
     enableWxBetterTogether: boolean;
     answerCallOnWebexService?: AnswerCallOnWebexService;
@@ -12,6 +13,14 @@ export type WxAppVoiceDependencies = {
     getTaskState: () => TaskState | undefined;
     getWxAppMuted: () => boolean;
     setWxAppMuted: (muted: boolean) => void;
+    /** Read-only observability: whether usersub answer-calls-on-wxcc is active this session. */
+    getUsersubPublished?: () => boolean;
+};
+export type WxAppParticipantDiagnostics = {
+    participantDeviceType?: string;
+    hasDeviceCallId: boolean;
+    hasDeviceId: boolean;
+    hasValidWxAppParticipant: boolean;
 };
 /** @deprecated Use {@link WxAppVoiceDependencies} */
 export type WxAppVoiceDeps = WxAppVoiceDependencies;
@@ -22,6 +31,7 @@ export type WxAppVoiceLifecycle = {
     syncWxAppMuteFromCallDetails: () => Promise<boolean | undefined>;
     mapWxAppVoiceError: (error: unknown, method: string) => never;
 };
+export declare function getWxAppParticipantDiagnostics(deps: WxAppVoiceDependencies): WxAppParticipantDiagnostics;
 export declare function getCallingDeviceDetails(deps: WxAppVoiceDependencies): WebexCallingDeviceDetails | undefined;
 export declare function isWebexAppCallingOffer(deps: WxAppVoiceDependencies): boolean;
 /** Inbound wxApp offer only — outdial decline uses CC routing, not telephony reject. */
@@ -43,13 +53,16 @@ export declare function transmitDtmfOnWebex(deps: WxAppVoiceDependencies, option
     dtmf: string;
     lineOwnerId?: string;
 }): Promise<void>;
-export declare function runWxAppAccept(deps: WxAppVoiceDependencies, lifecycle: WxAppVoiceLifecycle, options?: {
-    lineOwnerId?: string;
-}): Promise<void>;
-export declare function runWxAppReject(deps: WxAppVoiceDependencies, lifecycle: WxAppVoiceLifecycle, options?: {
+export type WxAppAcceptRejectOptions = {
     lineOwnerId?: string;
-}): Promise<void>;
-export declare function runWxAppOutdialDecline<T>(deps: WxAppVoiceDependencies, executeCancel: () => Promise<T>): Promise<T>;
+    acceptReason?: WxAppAcceptReason;
+};
+export declare function runWxAppAccept(deps: WxAppVoiceDependencies, lifecycle: WxAppVoiceLifecycle, options?: WxAppAcceptRejectOptions): Promise<void>;
+export declare function runWxAppReject(deps: WxAppVoiceDependencies, lifecycle: WxAppVoiceLifecycle, options?: WxAppAcceptRejectOptions): Promise<void>;
+export type WxAppOutdialDeclineOptions = {
+    acceptReason?: WxAppAcceptReason;
+};
+export declare function runWxAppOutdialDecline<T>(deps: WxAppVoiceDependencies, executeCancel: () => Promise<T>, options?: WxAppOutdialDeclineOptions): Promise<T>;
 export declare function runWxAppToggleMute(deps: WxAppVoiceDependencies, lifecycle: WxAppVoiceLifecycle, options?: TaskToggleMuteOptions): Promise<void>;
 export declare function runWxAppTransmitDtmf(deps: WxAppVoiceDependencies, lifecycle: WxAppVoiceLifecycle, options: TaskTransmitDtmfOptions): Promise<void>;
 export declare function mapWxAppVoiceError(error: unknown, method: string, module: string): never;

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

@@ -32,6 +32,18 @@ export declare function logWxAppOfferDecision(params: {
     acceptReason: WxAppAcceptReason;
     wxAppParticipantDeviceType?: string;
     hasDeviceCallId: boolean;
+    hasDeviceId?: boolean;
+    usersubPublished?: boolean;
+}): void;
+export declare function logWxAppOfferParticipantMismatch(params: {
+    interactionId: string;
+    usersubPublished: boolean;
+    hasDeviceCallId: boolean;
+    hasDeviceId: boolean;
+    participantDeviceType?: string;
+    acceptVisible: boolean;
+    acceptEnabled: boolean;
+    acceptReason: WxAppAcceptReason;
 }): void;
 export declare function logWxAppTelephonyAction(params: {
     action: WxAppTelephonyAction;

package/dist/types/types.d.ts

@@ -1,6 +1,6 @@
 import { CallingClientConfig } from '@webex/calling';
 import * as Agent from './services/agent/types';
-import { Profile } from './services/config/types';
+import { Entity, Profile } from './services/config/types';
 import { PaginatedResponse, BaseSearchParams } from './utils/PageCache';
 /**
  * HTTP methods supported by WebexRequest.
@@ -253,6 +253,8 @@ export interface IContactCenter {
      * cc.register().then(profile => { ... });
      */
     register(): Promise<Profile>;
+    /** Returns the system-managed WellbeingBreak idle code for the registered session. */
+    getWellbeingBreakIdleCode(): Promise<Entity>;
 }
 /**
  * Generic HTTP response structure.
@@ -688,6 +690,57 @@ export type RealTimeAssistanceUserActionParams = {
     /** Optional language code. Defaults to 'en'. */
     languageCode?: string;
 };
+/**
+ * Wellness notification actions delivered by the Contact Center notification service.
+ * @public
+ */
+export declare const WELLNESS_BREAK_NOTIFICATION_ACTIONS: {
+    readonly PROVIDE_WELLNESS_BREAK: "PROVIDE_WELLNESS_BREAK";
+    readonly SUGGEST_WELLNESS_BREAK: "SUGGEST_WELLNESS_BREAK";
+    readonly WELLNESS_BREAK_NOT_ALLOWED: "WELLNESS_BREAK_NOT_ALLOWED";
+};
+/** Union of supported wellness notification actions. @public */
+export type WellnessBreakNotificationAction = Enum<typeof WELLNESS_BREAK_NOTIFICATION_ACTIONS>;
+/**
+ * Agent actions accepted by the wellness action API.
+ * @public
+ */
+export declare const WELLNESS_BREAK_USER_ACTIONS: {
+    readonly REQUESTED: "REQUESTED";
+    readonly ACCEPTED: "ACCEPTED";
+    readonly REJECTED: "REJECTED";
+    readonly NO_RESPONSE: "NO_RESPONSE";
+};
+/** Union of supported wellness action API values. @public */
+export type WellnessBreakUserAction = Enum<typeof WELLNESS_BREAK_USER_ACTIONS>;
+/**
+ * Validated, agent-scoped wellness notification emitted by Contact Center.
+ * @public
+ */
+export interface WellnessBreakEvent {
+    /** Agent identifier */
+    agentId: string;
+    /** Organization identifier */
+    orgId: string;
+    /** Session identifier supplied by the notification; it may differ from the consumer's active session */
+    agentSessionId: string;
+    /** Backend wellness action */
+    actionEvent: WellnessBreakNotificationAction;
+    /** Optional untrusted plain-text message supplied by the backend */
+    actionText?: string;
+    /** Optional normalized interaction diagnostic */
+    interactionId?: string;
+    /** Notification diagnostic only; never an action-request correlation identifier */
+    trackingId?: string;
+}
+/**
+ * Parameters for responding to a backend-provided wellness offer.
+ * @public
+ */
+export interface RespondToWellnessBreakParams {
+    /** Agent response; REQUESTED is available only through requestWellnessBreak */
+    action: Exclude<WellnessBreakUserAction, typeof WELLNESS_BREAK_USER_ACTIONS.REQUESTED>;
+}
 /**
  * Supported AI Assistant event categories.
  * @public
@@ -735,6 +788,8 @@ export declare const AIAssistantEventName: {
     readonly SUGGESTED_RESPONSES_DIGITAL: "SUGGESTED_RESPONSES_DIGITAL";
     /** User action on a suggested response adaptive card */
     readonly SUGGESTED_RESPONSES_USER_ACTION: "SUGGESTED_RESPONSES_USER_ACTION";
+    /** Agent Wellness Break request/response action */
+    readonly WELLNESS_BREAK_ACTION: "WellnessBreakAction";
 };
 /**
  * Union type of AI Assistant event names.

package/dist/types.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.RealTimeAssistanceUserActionId = exports.LoginOption = exports.LOGGING_LEVEL = exports.HTTP_METHODS = exports.AIAssistantEventType = exports.AIAssistantEventName = void 0;
+exports.WELLNESS_BREAK_USER_ACTIONS = exports.WELLNESS_BREAK_NOTIFICATION_ACTIONS = exports.RealTimeAssistanceUserActionId = exports.LoginOption = exports.LOGGING_LEVEL = exports.HTTP_METHODS = exports.AIAssistantEventType = exports.AIAssistantEventName = void 0;
 /**
  * Generic type for converting a const enum object into a union type of its values.
  * @template T The enum object type
@@ -372,6 +372,41 @@ const RealTimeAssistanceUserActionId = exports.RealTimeAssistanceUserActionId =
  * };
  */
 
+/**
+ * Wellness notification actions delivered by the Contact Center notification service.
+ * @public
+ */
+const WELLNESS_BREAK_NOTIFICATION_ACTIONS = exports.WELLNESS_BREAK_NOTIFICATION_ACTIONS = {
+  PROVIDE_WELLNESS_BREAK: 'PROVIDE_WELLNESS_BREAK',
+  SUGGEST_WELLNESS_BREAK: 'SUGGEST_WELLNESS_BREAK',
+  WELLNESS_BREAK_NOT_ALLOWED: 'WELLNESS_BREAK_NOT_ALLOWED'
+};
+
+/** Union of supported wellness notification actions. @public */
+
+/**
+ * Agent actions accepted by the wellness action API.
+ * @public
+ */
+const WELLNESS_BREAK_USER_ACTIONS = exports.WELLNESS_BREAK_USER_ACTIONS = {
+  REQUESTED: 'REQUESTED',
+  ACCEPTED: 'ACCEPTED',
+  REJECTED: 'REJECTED',
+  NO_RESPONSE: 'NO_RESPONSE'
+};
+
+/** Union of supported wellness action API values. @public */
+
+/**
+ * Validated, agent-scoped wellness notification emitted by Contact Center.
+ * @public
+ */
+
+/**
+ * Parameters for responding to a backend-provided wellness offer.
+ * @public
+ */
+
 /**
  * Supported AI Assistant event categories.
  * @public
@@ -419,7 +454,9 @@ const AIAssistantEventName = exports.AIAssistantEventName = {
   /** Suggested digital response event */
   SUGGESTED_RESPONSES_DIGITAL: 'SUGGESTED_RESPONSES_DIGITAL',
   /** User action on a suggested response adaptive card */
-  SUGGESTED_RESPONSES_USER_ACTION: 'SUGGESTED_RESPONSES_USER_ACTION'
+  SUGGESTED_RESPONSES_USER_ACTION: 'SUGGESTED_RESPONSES_USER_ACTION',
+  /** Agent Wellness Break request/response action */
+  WELLNESS_BREAK_ACTION: 'WellnessBreakAction'
 };
 
 /**