@webex/contact-center 3.12.0-next.16 → 3.12.0-next.161

package/dist/services/wxAppDiagnosticLogging.js

@@ -0,0 +1,159 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.WXAPP_LOG_PREFIX = exports.WXAPP_LOG_FEATURE = void 0;
+exports.callIdSuffix = callIdSuffix;
+exports.deriveWxAppAcceptReason = deriveWxAppAcceptReason;
+exports.logWxAppMercuryMuteSync = logWxAppMercuryMuteSync;
+exports.logWxAppOfferDecision = logWxAppOfferDecision;
+exports.logWxAppOfferParticipantMismatch = logWxAppOfferParticipantMismatch;
+exports.logWxAppSessionReadiness = logWxAppSessionReadiness;
+exports.logWxAppTelephonyAction = logWxAppTelephonyAction;
+exports.logWxAppValidationFailure = logWxAppValidationFailure;
+var _loggerProxy = _interopRequireDefault(require("../logger-proxy"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const WXAPP_LOG_FEATURE = exports.WXAPP_LOG_FEATURE = 'wxApp';
+const WXAPP_LOG_PREFIX = exports.WXAPP_LOG_PREFIX = '[CC wxApp]';
+/** Last 8 chars of callId for correlation without logging full id. */
+function callIdSuffix(callId) {
+  if (!callId) {
+    return undefined;
+  }
+  return callId.length <= 8 ? callId : callId.slice(-8);
+}
+function formatLogSuffix(data, keys) {
+  const entries = keys ? keys.map(key => [key, data[key]]) : Object.entries(data).filter(([key]) => key !== 'feature' && key !== 'event');
+  const parts = entries.filter(([, value]) => value !== undefined && value !== null && value !== '').map(([key, value]) => `${key}=${String(value)}`);
+  return parts.length > 0 ? ` ${parts.join(' ')}` : '';
+}
+function logWxApp(message, method, data, suffixKeys) {
+  const suffix = formatLogSuffix(data, suffixKeys);
+  _loggerProxy.default.log(`${WXAPP_LOG_PREFIX} ${message}${suffix}`, {
+    module: 'wxAppDiagnosticLogging',
+    method,
+    data: {
+      feature: WXAPP_LOG_FEATURE,
+      ...data
+    }
+  });
+}
+function logWxAppWarn(message, method, data, suffixKeys) {
+  const suffix = formatLogSuffix(data, suffixKeys);
+  _loggerProxy.default.warn(`${WXAPP_LOG_PREFIX} ${message}${suffix}`, {
+    module: 'wxAppDiagnosticLogging',
+    method,
+    data: {
+      feature: WXAPP_LOG_FEATURE,
+      ...data
+    }
+  });
+}
+function logWxAppError(message, method, data, suffixKeys) {
+  const suffix = formatLogSuffix(data, suffixKeys);
+  _loggerProxy.default.error(`${WXAPP_LOG_PREFIX} ${message}${suffix}`, {
+    module: 'wxAppDiagnosticLogging',
+    method,
+    data: {
+      feature: WXAPP_LOG_FEATURE,
+      ...data
+    }
+  });
+}
+function logWxAppSessionReadiness(params) {
+  const data = {
+    event: 'session_readiness',
+    enableWxBetterTogether: params.enableWxBetterTogether,
+    loginOption: params.loginOption,
+    wxAppHooksApplied: params.wxAppHooksApplied,
+    usersubPublished: params.usersubPublished,
+    mercurySubscribed: params.mercurySubscribed,
+    telephonyTaskType: params.telephonyTaskType,
+    skipReason: params.skipReason
+  };
+  logWxApp('session readiness', 'logWxAppSessionReadiness', data, ['usersubPublished', 'mercurySubscribed', 'loginOption', 'enableWxBetterTogether', 'telephonyTaskType', 'skipReason']);
+}
+function deriveWxAppAcceptReason(params) {
+  if (params.isWxAppInboundOffer || params.isWxAppOutdialOffer) {
+    if (params.wxAppAcceptInFlight) {
+      return 'wxApp_accept_in_flight';
+    }
+    if (params.wxAppAnswerPending) {
+      return 'wxApp_answer_pending';
+    }
+    return 'wxApp_offer_ready';
+  }
+  if (params.isWebrtc && !params.isOutdial) {
+    return 'browser_webrtc_offer';
+  }
+  if (params.isOutdial) {
+    return 'outdial_auto_answer';
+  }
+  if (params.enableWxBetterTogether && !params.hasDeviceCallId) {
+    return 'extension_non_wxApp_offer';
+  }
+  return 'extension_non_wxApp_offer';
+}
+function logWxAppOfferDecision(params) {
+  const data = {
+    event: 'offer_decision',
+    interactionId: params.interactionId,
+    acceptVisible: params.acceptVisible,
+    acceptEnabled: params.acceptEnabled,
+    acceptReason: params.acceptReason,
+    wxAppParticipantDeviceType: params.wxAppParticipantDeviceType,
+    hasDeviceCallId: params.hasDeviceCallId,
+    hasDeviceId: params.hasDeviceId,
+    usersubPublished: params.usersubPublished
+  };
+  logWxApp('offer decision', 'logWxAppOfferDecision', data, ['acceptReason', 'hasDeviceCallId', 'hasDeviceId', 'usersubPublished', 'interactionId', 'acceptVisible', 'acceptEnabled']);
+}
+function logWxAppOfferParticipantMismatch(params) {
+  const data = {
+    event: 'participant_fields_mismatch',
+    interactionId: params.interactionId,
+    usersubPublished: params.usersubPublished,
+    hasDeviceCallId: params.hasDeviceCallId,
+    hasDeviceId: params.hasDeviceId,
+    participantDeviceType: params.participantDeviceType ?? 'missing',
+    acceptVisible: params.acceptVisible,
+    acceptEnabled: params.acceptEnabled,
+    acceptReason: params.acceptReason
+  };
+  logWxAppWarn('participant fields mismatch', 'logWxAppOfferParticipantMismatch', data, ['usersubPublished', 'hasDeviceCallId', 'hasDeviceId', 'acceptReason', 'interactionId', 'participantDeviceType']);
+}
+function logWxAppTelephonyAction(params) {
+  const payload = {
+    event: 'telephony_action',
+    action: params.action,
+    phase: params.phase,
+    interactionId: params.interactionId,
+    trackingId: params.trackingId,
+    httpStatus: params.httpStatus,
+    failureReason: params.failureReason
+  };
+  if (params.phase === 'failed') {
+    logWxAppError(`telephony ${params.action} ${params.phase}`, 'logWxAppTelephonyAction', payload, ['interactionId', 'trackingId', 'httpStatus', 'failureReason']);
+  } else {
+    logWxApp(`telephony ${params.action} ${params.phase}`, 'logWxAppTelephonyAction', payload, ['interactionId', 'action', 'phase']);
+  }
+}
+function logWxAppValidationFailure(reason, interactionId) {
+  logWxAppError('validation failed', 'logWxAppValidationFailure', {
+    event: 'validation_failed',
+    reason,
+    interactionId
+  }, ['reason', 'interactionId']);
+}
+function logWxAppMercuryMuteSync(params) {
+  logWxApp(`mercury mute sync ${params.phase}`, 'logWxAppMercuryMuteSync', {
+    event: 'mercury_mute_sync',
+    phase: params.phase,
+    muted: params.muted,
+    callIdSuffix: params.callIdSuffix,
+    interactionId: params.interactionId,
+    dropReason: params.dropReason
+  }, ['phase', 'muted', 'callIdSuffix', 'interactionId', 'dropReason']);
+}
+//# sourceMappingURL=wxAppDiagnosticLogging.js.map

package/dist/services/wxAppDiagnosticLogging.js.map

@@ -0,0 +1 @@
+{"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/services/wxAppTelephonyUtils.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isWxAppCallNotFoundError = isWxAppCallNotFoundError;
+/**
+ * Expected Hydra responses when mute backfill races call creation (WXCC-6026).
+ * These must not be logged as errors — see task-spec wxApp mute backfill guard.
+ */
+function isWxAppCallNotFoundError(error) {
+  const err = error;
+  if (err?.status === 400 || err?.status === '400') {
+    return true;
+  }
+  const message = String(err?.message ?? error ?? '');
+  return message.includes('Call not found') || message.includes('101002');
+}
+//# sourceMappingURL=wxAppTelephonyUtils.js.map

package/dist/services/wxAppTelephonyUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isWxAppCallNotFoundError","error","err","status","message","String","includes"],"sources":["wxAppTelephonyUtils.ts"],"sourcesContent":["/**\n * Expected Hydra responses when mute backfill races call creation (WXCC-6026).\n * These must not be logged as errors — see task-spec wxApp mute backfill guard.\n */\nexport function isWxAppCallNotFoundError(error: unknown): boolean {\n  const err = error as {status?: number | string; message?: string};\n  if (err?.status === 400 || err?.status === '400') {\n    return true;\n  }\n\n  const message = String(err?.message ?? error ?? '');\n\n  return message.includes('Call not found') || message.includes('101002');\n}\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACO,SAASA,wBAAwBA,CAACC,KAAc,EAAW;EAChE,MAAMC,GAAG,GAAGD,KAAqD;EACjE,IAAIC,GAAG,EAAEC,MAAM,KAAK,GAAG,IAAID,GAAG,EAAEC,MAAM,KAAK,KAAK,EAAE;IAChD,OAAO,IAAI;EACb;EAEA,MAAMC,OAAO,GAAGC,MAAM,CAACH,GAAG,EAAEE,OAAO,IAAIH,KAAK,IAAI,EAAE,CAAC;EAEnD,OAAOG,OAAO,CAACE,QAAQ,CAAC,gBAAgB,CAAC,IAAIF,OAAO,CAACE,QAAQ,CAAC,QAAQ,CAAC;AACzE","ignoreList":[]}

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.
@@ -97,7 +99,7 @@ import type { EntryPointListResponse, EntryPointSearchParams, ContactServiceQueu
  *
  *     // Login with browser-based calling
  *     await cc.stationLogin({
- *       teamId: profile.teams[0].teamId,
+ *       teamId: profile.teams[0].id,
  *       loginOption: 'BROWSER'
  *     });
  *
@@ -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
@@ -329,12 +399,12 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
      *
      * console.log('Agent ID:', profile.agentId);
      * console.log('Default DN:', profile.defaultDn);
-     * console.log('Teams:', profile.teams.map(t => t.teamId));
+     * console.log('Teams:', profile.teams.map(t => t.id));
      * console.log('WebRTC Enabled:', profile.webRtcEnabled);
      * console.log('Supported Login Options:', profile.loginVoiceOptions);
      *
      * // Now you can proceed with station login, state changes, etc.
-     * await cc.stationLogin({ teamId: profile.teams[0].teamId, loginOption: 'BROWSER' });
+     * await cc.stationLogin({ teamId: profile.teams[0].id, loginOption: 'BROWSER' });
      * ```
      */
     register(): Promise<Profile>;
@@ -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
@@ -831,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,17 +38,50 @@ 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;
+};
+export declare const AI_SUMMARY_ERROR_CODES: {
+    readonly POST_CALL_SUMMARY_DISABLED: "POST_CALL_SUMMARY_DISABLED";
+    readonly MID_CALL_SUMMARY_DISABLED: "MID_CALL_SUMMARY_DISABLED";
+    readonly AI_ASSISTANT_BASE_URL_NOT_AVAILABLE: "AI_ASSISTANT_BASE_URL_NOT_AVAILABLE";
+    readonly POST_CALL_SUMMARY_TIMEOUT: "POST_CALL_SUMMARY_TIMEOUT";
+    readonly MID_CALL_SUMMARY_TIMEOUT: "MID_CALL_SUMMARY_TIMEOUT";
 };
+export declare const AI_SUMMARY_INVALID_RESPONSE_PAYLOAD = "AI_SUMMARY_INVALID_RESPONSE_PAYLOAD";
+export declare const AI_ASSISTANT_CLIENT_TYPE: "WxCC";