@webex/contact-center 3.12.0-webex-services-ready.4 → 3.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (250) hide show
  1. package/.sdd/manifest.json +24 -13
  2. package/ai-docs/ARCHITECTURE.md +1 -1
  3. package/ai-docs/CONTRACTS.md +19 -3
  4. package/ai-docs/SECURITY.md +1 -1
  5. package/ai-docs/SERVICE_STATE.md +4 -0
  6. package/ai-docs/contact-center-spec.md +50 -6
  7. package/ai-docs/features/consult-transfer-list-policy/spec/feature-spec.md +362 -0
  8. package/ai-docs/features/contact-owner-change-refactor.md +78 -0
  9. package/dist/cc.js +757 -22
  10. package/dist/cc.js.map +1 -1
  11. package/dist/config.js +7 -0
  12. package/dist/config.js.map +1 -1
  13. package/dist/constants.js +23 -2
  14. package/dist/constants.js.map +1 -1
  15. package/dist/index.js +34 -12
  16. package/dist/index.js.map +1 -1
  17. package/dist/metrics/MetricsManager.js +16 -0
  18. package/dist/metrics/MetricsManager.js.map +1 -1
  19. package/dist/metrics/behavioral-events.js +110 -0
  20. package/dist/metrics/behavioral-events.js.map +1 -1
  21. package/dist/metrics/constants.js +33 -0
  22. package/dist/metrics/constants.js.map +1 -1
  23. package/dist/services/AddressBook.js +18 -15
  24. package/dist/services/AddressBook.js.map +1 -1
  25. package/dist/services/AnswerCallOnWebexService.js +202 -0
  26. package/dist/services/AnswerCallOnWebexService.js.map +1 -0
  27. package/dist/services/ApiAiAssistant.js +221 -11
  28. package/dist/services/ApiAiAssistant.js.map +1 -1
  29. package/dist/services/EntryPoint.js +46 -68
  30. package/dist/services/EntryPoint.js.map +1 -1
  31. package/dist/services/Queue.js +27 -22
  32. package/dist/services/Queue.js.map +1 -1
  33. package/dist/services/WebCallingService.js +10 -2
  34. package/dist/services/WebCallingService.js.map +1 -1
  35. package/dist/services/WebexCrossClientService.js +225 -0
  36. package/dist/services/WebexCrossClientService.js.map +1 -0
  37. package/dist/services/WxAppTelephonyMercurySync.js +111 -0
  38. package/dist/services/WxAppTelephonyMercurySync.js.map +1 -0
  39. package/dist/services/config/Util.js +46 -46
  40. package/dist/services/config/Util.js.map +1 -1
  41. package/dist/services/config/constants.js +34 -77
  42. package/dist/services/config/constants.js.map +1 -1
  43. package/dist/services/config/index.js +100 -226
  44. package/dist/services/config/index.js.map +1 -1
  45. package/dist/services/config/types.js +51 -18
  46. package/dist/services/config/types.js.map +1 -1
  47. package/dist/services/constants.js +11 -1
  48. package/dist/services/constants.js.map +1 -1
  49. package/dist/services/core/Err.js.map +1 -1
  50. package/dist/services/core/Utils.js +25 -1
  51. package/dist/services/core/Utils.js.map +1 -1
  52. package/dist/services/core/WebexRequest.js +6 -2
  53. package/dist/services/core/WebexRequest.js.map +1 -1
  54. package/dist/services/core/aqm-reqs.js +17 -11
  55. package/dist/services/core/aqm-reqs.js.map +1 -1
  56. package/dist/services/core/constants.js +9 -1
  57. package/dist/services/core/constants.js.map +1 -1
  58. package/dist/services/core/types.js.map +1 -1
  59. package/dist/services/core/websocket/WebSocketManager.js +17 -1
  60. package/dist/services/core/websocket/WebSocketManager.js.map +1 -1
  61. package/dist/services/task/Task.js +275 -8
  62. package/dist/services/task/Task.js.map +1 -1
  63. package/dist/services/task/TaskFactory.js +11 -6
  64. package/dist/services/task/TaskFactory.js.map +1 -1
  65. package/dist/services/task/TaskManager.js +590 -42
  66. package/dist/services/task/TaskManager.js.map +1 -1
  67. package/dist/services/task/TaskUtils.js +11 -1
  68. package/dist/services/task/TaskUtils.js.map +1 -1
  69. package/dist/services/task/WebexCallingUtils.js +70 -0
  70. package/dist/services/task/WebexCallingUtils.js.map +1 -0
  71. package/dist/services/task/constants.js +14 -2
  72. package/dist/services/task/constants.js.map +1 -1
  73. package/dist/services/task/contact.js +29 -0
  74. package/dist/services/task/contact.js.map +1 -1
  75. package/dist/services/task/digital/Digital.js +4 -3
  76. package/dist/services/task/digital/Digital.js.map +1 -1
  77. package/dist/services/task/state-machine/TaskStateMachine.js +162 -53
  78. package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -1
  79. package/dist/services/task/state-machine/actions.js +6 -1
  80. package/dist/services/task/state-machine/actions.js.map +1 -1
  81. package/dist/services/task/state-machine/guards.js +7 -10
  82. package/dist/services/task/state-machine/guards.js.map +1 -1
  83. package/dist/services/task/state-machine/types.js.map +1 -1
  84. package/dist/services/task/state-machine/uiControlsComputer.js +118 -18
  85. package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -1
  86. package/dist/services/task/types.js +47 -1
  87. package/dist/services/task/types.js.map +1 -1
  88. package/dist/services/task/voice/Voice.js +477 -17
  89. package/dist/services/task/voice/Voice.js.map +1 -1
  90. package/dist/services/task/voice/WebRTC.js +6 -3
  91. package/dist/services/task/voice/WebRTC.js.map +1 -1
  92. package/dist/services/task/voice/wxAppOfferObservability.js +145 -0
  93. package/dist/services/task/voice/wxAppOfferObservability.js.map +1 -0
  94. package/dist/services/task/voice/wxAppVoiceMethods.js +395 -0
  95. package/dist/services/task/voice/wxAppVoiceMethods.js.map +1 -0
  96. package/dist/services/wxAppDiagnosticLogging.js +159 -0
  97. package/dist/services/wxAppDiagnosticLogging.js.map +1 -0
  98. package/dist/services/wxAppTelephonyUtils.js +19 -0
  99. package/dist/services/wxAppTelephonyUtils.js.map +1 -0
  100. package/dist/types/cc.d.ts +102 -8
  101. package/dist/types/config.d.ts +7 -0
  102. package/dist/types/constants.d.ts +21 -0
  103. package/dist/types/index.d.ts +34 -15
  104. package/dist/types/metrics/MetricsManager.d.ts +6 -0
  105. package/dist/types/metrics/constants.d.ts +31 -0
  106. package/dist/types/services/AddressBook.d.ts +2 -1
  107. package/dist/types/services/AnswerCallOnWebexService.d.ts +38 -0
  108. package/dist/types/services/ApiAiAssistant.d.ts +48 -4
  109. package/dist/types/services/EntryPoint.d.ts +7 -5
  110. package/dist/types/services/Queue.d.ts +5 -3
  111. package/dist/types/services/WebexCrossClientService.d.ts +32 -0
  112. package/dist/types/services/WxAppTelephonyMercurySync.d.ts +28 -0
  113. package/dist/types/services/config/Util.d.ts +4 -8
  114. package/dist/types/services/config/constants.d.ts +28 -76
  115. package/dist/types/services/config/index.d.ts +16 -64
  116. package/dist/types/services/config/types.d.ts +146 -173
  117. package/dist/types/services/constants.d.ts +9 -0
  118. package/dist/types/services/core/Err.d.ts +2 -0
  119. package/dist/types/services/core/Utils.d.ts +10 -0
  120. package/dist/types/services/core/WebexRequest.d.ts +1 -0
  121. package/dist/types/services/core/constants.d.ts +7 -0
  122. package/dist/types/services/core/types.d.ts +2 -0
  123. package/dist/types/services/task/Task.d.ts +34 -5
  124. package/dist/types/services/task/TaskFactory.d.ts +4 -2
  125. package/dist/types/services/task/TaskUtils.d.ts +6 -0
  126. package/dist/types/services/task/WebexCallingUtils.d.ts +11 -0
  127. package/dist/types/services/task/constants.d.ts +12 -0
  128. package/dist/types/services/task/contact.d.ts +4 -0
  129. package/dist/types/services/task/digital/Digital.d.ts +4 -3
  130. package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +304 -56
  131. package/dist/types/services/task/state-machine/guards.d.ts +6 -5
  132. package/dist/types/services/task/state-machine/types.d.ts +9 -1
  133. package/dist/types/services/task/types.d.ts +192 -5
  134. package/dist/types/services/task/voice/Voice.d.ts +68 -11
  135. package/dist/types/services/task/voice/WebRTC.d.ts +5 -4
  136. package/dist/types/services/task/voice/wxAppOfferObservability.d.ts +39 -0
  137. package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts +68 -0
  138. package/dist/types/services/wxAppDiagnosticLogging.d.ts +63 -0
  139. package/dist/types/services/wxAppTelephonyUtils.d.ts +5 -0
  140. package/dist/types/types.d.ts +80 -13
  141. package/dist/types/utils/PageCache.d.ts +20 -3
  142. package/dist/types.js +54 -8
  143. package/dist/types.js.map +1 -1
  144. package/dist/utils/PageCache.js +19 -5
  145. package/dist/utils/PageCache.js.map +1 -1
  146. package/dist/webex.js +9 -1
  147. package/dist/webex.js.map +1 -1
  148. package/package.json +10 -9
  149. package/src/cc.ts +969 -38
  150. package/src/config.ts +7 -0
  151. package/src/constants.ts +24 -0
  152. package/src/index.ts +39 -10
  153. package/src/metrics/MetricsManager.ts +16 -0
  154. package/src/metrics/ai-docs/metrics-spec.md +138 -21
  155. package/src/metrics/behavioral-events.ts +112 -0
  156. package/src/metrics/constants.ts +36 -0
  157. package/src/services/AddressBook.ts +17 -6
  158. package/src/services/AnswerCallOnWebexService.ts +239 -0
  159. package/src/services/ApiAiAssistant.ts +297 -13
  160. package/src/services/EntryPoint.ts +59 -60
  161. package/src/services/Queue.ts +29 -12
  162. package/src/services/WebCallingService.ts +16 -2
  163. package/src/services/WebexCrossClientService.ts +298 -0
  164. package/src/services/WxAppTelephonyMercurySync.ts +142 -0
  165. package/src/services/agent/ai-docs/AGENTS.md +1 -1
  166. package/src/services/agent/ai-docs/agent-spec.md +1 -0
  167. package/src/services/ai-docs/AGENTS.md +10 -10
  168. package/src/services/ai-docs/services-spec.md +25 -5
  169. package/src/services/config/Util.ts +52 -82
  170. package/src/services/config/ai-docs/AGENTS.md +35 -40
  171. package/src/services/config/ai-docs/ARCHITECTURE.md +90 -103
  172. package/src/services/config/ai-docs/config-spec.md +132 -132
  173. package/src/services/config/constants.ts +39 -85
  174. package/src/services/config/index.ts +116 -277
  175. package/src/services/config/types.ts +140 -195
  176. package/src/services/constants.ts +10 -0
  177. package/src/services/core/Err.ts +1 -0
  178. package/src/services/core/Utils.ts +28 -0
  179. package/src/services/core/WebexRequest.ts +3 -1
  180. package/src/services/core/ai-docs/core-spec.md +25 -11
  181. package/src/services/core/aqm-reqs.ts +18 -12
  182. package/src/services/core/constants.ts +8 -0
  183. package/src/services/core/types.ts +33 -1
  184. package/src/services/core/websocket/WebSocketManager.ts +26 -2
  185. package/src/services/task/Task.ts +386 -12
  186. package/src/services/task/TaskFactory.ts +33 -6
  187. package/src/services/task/TaskManager.ts +857 -41
  188. package/src/services/task/TaskUtils.ts +13 -0
  189. package/src/services/task/WebexCallingUtils.ts +136 -0
  190. package/src/services/task/ai-docs/ARCHITECTURE.md +1 -0
  191. package/src/services/task/ai-docs/task-spec.md +190 -8
  192. package/src/services/task/constants.ts +13 -0
  193. package/src/services/task/contact.ts +30 -0
  194. package/src/services/task/digital/Digital.ts +11 -4
  195. package/src/services/task/state-machine/TaskStateMachine.ts +235 -81
  196. package/src/services/task/state-machine/actions.ts +5 -2
  197. package/src/services/task/state-machine/ai-docs/AGENTS.md +6 -4
  198. package/src/services/task/state-machine/ai-docs/ARCHITECTURE.md +35 -16
  199. package/src/services/task/state-machine/ai-docs/task-state-machine-spec.md +103 -33
  200. package/src/services/task/state-machine/guards.ts +7 -10
  201. package/src/services/task/state-machine/types.ts +16 -1
  202. package/src/services/task/state-machine/uiControlsComputer.ts +206 -32
  203. package/src/services/task/types.ts +269 -4
  204. package/src/services/task/voice/Voice.ts +625 -17
  205. package/src/services/task/voice/WebRTC.ts +11 -4
  206. package/src/services/task/voice/wxAppOfferObservability.ts +204 -0
  207. package/src/services/task/voice/wxAppVoiceMethods.ts +575 -0
  208. package/src/services/wxAppDiagnosticLogging.ts +286 -0
  209. package/src/services/wxAppTelephonyUtils.ts +14 -0
  210. package/src/types.ts +108 -13
  211. package/src/utils/AGENTS.md +21 -10
  212. package/src/utils/PageCache.ts +38 -5
  213. package/src/utils/ai-docs/utils-spec.md +21 -11
  214. package/src/webex.js +8 -0
  215. package/test/unit/fixtures/aiSummaryTestUtils.ts +40 -0
  216. package/test/unit/spec/cc.ts +3408 -152
  217. package/test/unit/spec/index.ts +885 -0
  218. package/test/unit/spec/metrics/MetricsManager.ts +25 -0
  219. package/test/unit/spec/metrics/behavioral-events.ts +60 -0
  220. package/test/unit/spec/services/AddressBook.ts +37 -6
  221. package/test/unit/spec/services/AnswerCallOnWebexService.ts +264 -0
  222. package/test/unit/spec/services/ApiAiAssistant.ts +269 -8
  223. package/test/unit/spec/services/EntryPoint.ts +87 -40
  224. package/test/unit/spec/services/Queue.ts +123 -12
  225. package/test/unit/spec/services/WebCallingService.ts +38 -0
  226. package/test/unit/spec/services/WebexCrossClientService.ts +509 -0
  227. package/test/unit/spec/services/WxAppTelephonyMercurySync.ts +136 -0
  228. package/test/unit/spec/services/config/Util.ts +501 -0
  229. package/test/unit/spec/services/config/index.ts +313 -543
  230. package/test/unit/spec/services/core/Utils.ts +22 -0
  231. package/test/unit/spec/services/core/WebexRequest.ts +8 -7
  232. package/test/unit/spec/services/core/aqm-reqs.ts +142 -1
  233. package/test/unit/spec/services/core/websocket/WebSocketManager.ts +64 -14
  234. package/test/unit/spec/services/task/Task.ts +2257 -11
  235. package/test/unit/spec/services/task/TaskFactory.ts +56 -2
  236. package/test/unit/spec/services/task/TaskManager.ts +5559 -1493
  237. package/test/unit/spec/services/task/TaskUtils.ts +72 -0
  238. package/test/unit/spec/services/task/WebexCallingUtils.ts +153 -0
  239. package/test/unit/spec/services/task/contact.ts +33 -0
  240. package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +1501 -92
  241. package/test/unit/spec/services/task/state-machine/guards.ts +210 -8
  242. package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +445 -7
  243. package/test/unit/spec/services/task/voice/Voice.ts +1710 -4
  244. package/test/unit/spec/services/task/voice/wxAppOfferObservability.ts +361 -0
  245. package/test/unit/spec/services/task/voice/wxAppVoiceMethods.ts +719 -0
  246. package/test/unit/spec/services/wxAppDiagnosticLogging.ts +179 -0
  247. package/test/unit/spec/wellnessSampleUtils.ts +288 -0
  248. package/typedoc.md +1 -1
  249. package/umd/contact-center.min.js +2 -2
  250. package/umd/contact-center.min.js.map +1 -1
package/dist/cc.js CHANGED
@@ -19,6 +19,10 @@ var _Utils = require("./services/core/Utils");
19
19
  var _types3 = require("./services/config/types");
20
20
  var _TaskManager = _interopRequireDefault(require("./services/task/TaskManager"));
21
21
  var _WebCallingService = _interopRequireDefault(require("./services/WebCallingService"));
22
+ var _AnswerCallOnWebexService = _interopRequireDefault(require("./services/AnswerCallOnWebexService"));
23
+ var _WebexCrossClientService = _interopRequireDefault(require("./services/WebexCrossClientService"));
24
+ var _WxAppTelephonyMercurySync = _interopRequireDefault(require("./services/WxAppTelephonyMercurySync"));
25
+ var _wxAppDiagnosticLogging = require("./services/wxAppDiagnosticLogging");
22
26
  var _types4 = require("./services/task/types");
23
27
  var _MetricsManager = _interopRequireDefault(require("./metrics/MetricsManager"));
24
28
  var _constants4 = require("./metrics/constants");
@@ -36,6 +40,13 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
36
40
  * with Webex Contact Center features through the WebexSDK.
37
41
  */
38
42
 
43
+ /**
44
+ * Typed allow-list of server-controlled websocket event names this SDK re-emits verbatim.
45
+ * Guards against emitting an arbitrary/unknown `data.type` supplied by the websocket payload.
46
+ * @ignore
47
+ */
48
+ const CC_EVENT_ALLOW_LIST = new Set(Object.values(_types3.CC_EVENTS));
49
+
39
50
  /**
40
51
  * The main Contact Center plugin class that enables integration with Webex Contact Center.
41
52
  *
@@ -119,7 +130,7 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
119
130
  *
120
131
  * // Login with browser-based calling
121
132
  * await cc.stationLogin({
122
- * teamId: profile.teams[0].teamId,
133
+ * teamId: profile.teams[0].id,
123
134
  * loginOption: 'BROWSER'
124
135
  * });
125
136
  *
@@ -185,6 +196,29 @@ class ContactCenter extends _webexCore.WebexPlugin {
185
196
  * @private
186
197
  */
187
198
 
199
+ /**
200
+ * REST telephony for wxApp thick-client answer (WXCC-6026)
201
+ * @private
202
+ */
203
+
204
+ /**
205
+ * usersub cross-client state for Webex App toast suppression
206
+ * @private
207
+ */
208
+
209
+ /**
210
+ * Mercury telephony mute sync for wxApp thick-client answer
211
+ * @private
212
+ */
213
+
214
+ /** True when wxApp mute sync opened Mercury (Extension/DN-only profiles). */
215
+ wxAppMercuryConnectedByCc = false;
216
+
217
+ /** True when wxApp mute sync registered the Webex device. */
218
+ wxAppDeviceRegisteredByCc = false;
219
+ static WXAPP_FALSE_PUBLISH_RETRY_DELAY_MS = 30_000;
220
+ static WXAPP_FALSE_PUBLISH_MAX_RETRIES = 3;
221
+
188
222
  /**
189
223
  * Core service managers for Contact Center operations
190
224
  * Includes agent, connection, and configuration services
@@ -213,6 +247,16 @@ class ContactCenter extends _webexCore.WebexPlugin {
213
247
  * @private
214
248
  */
215
249
 
250
+ /** Current login/relogin session used for agent-scoped wellness validation. */
251
+
252
+ /** Registered-session cache for the system WellbeingBreak idle code. */
253
+
254
+ /** Registration generation that owns the wellness idle-code cache and in-flight lookups. */
255
+ wellnessRegistrationGeneration = 0;
256
+ updateWellnessSession(agentSessionId) {
257
+ this.currentAgentSessionId = agentSessionId;
258
+ }
259
+
216
260
  /**
217
261
  * API instance for managing Webex Contact Center entry points
218
262
  * Provides functionality to fetch entry points with caching support
@@ -345,11 +389,19 @@ class ContactCenter extends _webexCore.WebexPlugin {
345
389
  connectionConfig: this.getConnectionConfig()
346
390
  });
347
391
  this.webCallingService = new _WebCallingService.default(this.$webex);
348
- this.apiAIAssistant = new _ApiAiAssistant.ApiAIAssistant(this.$webex);
392
+ this.answerCallOnWebexService = new _AnswerCallOnWebexService.default(this.$webex);
393
+ this.webexCrossClientService = new _WebexCrossClientService.default(this.$webex);
394
+ this.wxAppTelephonyMercurySync = new _WxAppTelephonyMercurySync.default(this.$webex);
395
+ this.apiAIAssistant = new _ApiAiAssistant.ApiAIAssistant(this.$webex, () => ({
396
+ isWellnessBreakEnabled: this.agentConfig?.isWellnessBreakEnabled === true,
397
+ agentId: this.agentConfig?.agentId,
398
+ agentSessionId: this.currentAgentSessionId
399
+ }));
349
400
  this.metricsManager = _MetricsManager.default.getInstance({
350
401
  webex: this.$webex
351
402
  });
352
403
  this.taskManager = _TaskManager.default.getTaskManager(this.apiAIAssistant, this.services.contact, this.webCallingService, this.services.webSocketManager, this.services.rtdWebSocketManager);
404
+ this.taskManager.setAnswerCallOnWebexService(this.answerCallOnWebexService);
353
405
  this.incomingTaskListener();
354
406
 
355
407
  // Initialize API instances
@@ -411,7 +463,82 @@ class ContactCenter extends _webexCore.WebexPlugin {
411
463
  // @ts-ignore
412
464
  this.trigger(_types4.TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION, task);
413
465
  };
466
+ trackInvalidWellnessEvent(reason) {
467
+ this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_EVENT_INVALID, {
468
+ reason
469
+ }, ['operational']);
470
+ }
471
+ normalizeWellnessBreakEvent(payload) {
472
+ if (this.agentConfig?.isWellnessBreakEnabled !== true) {
473
+ this.trackInvalidWellnessEvent('wellness_disabled');
474
+ return null;
475
+ }
476
+ const notificationData = (0, _Utils.isRecord)(payload.data) ? payload.data : null;
477
+ const notificationDetails = notificationData && (0, _Utils.isRecord)(notificationData.notifDetails) ? notificationData.notifDetails : null;
478
+ const sessionData = notificationData && (0, _Utils.isRecord)(notificationData.data) ? notificationData.data : null;
479
+ const actionEvent = notificationDetails?.actionEvent;
480
+ if (payload.type !== _constants.WELLNESS_BREAK_HANDLER || notificationData?.notifType !== _constants.WELLNESS_BREAK_HANDLER || typeof actionEvent !== 'string') {
481
+ this.trackInvalidWellnessEvent('malformed_wellness_event');
482
+ return null;
483
+ }
484
+ if (!Object.values(_types.WELLNESS_BREAK_NOTIFICATION_ACTIONS).includes(actionEvent)) {
485
+ this.trackInvalidWellnessEvent('unknown_wellness_action');
486
+ return null;
487
+ }
488
+ const agentId = notificationData.agentId;
489
+ const eventOrgId = notificationData.orgId;
490
+ const sessionOrgId = sessionData?.orgId;
491
+ const envelopeOrgId = payload.orgId;
492
+ const agentSessionId = sessionData?.agentSessionId;
493
+ const currentOrgId = this.$webex.credentials.getOrgId();
494
+ if (typeof agentId !== 'string' || typeof eventOrgId !== 'string' || typeof sessionOrgId !== 'string' || typeof envelopeOrgId !== 'string' || typeof agentSessionId !== 'string' || !agentId || !eventOrgId || !sessionOrgId || !envelopeOrgId || !agentSessionId) {
495
+ this.trackInvalidWellnessEvent('missing_wellness_identity');
496
+ return null;
497
+ }
498
+ if (agentId !== this.agentConfig?.agentId || eventOrgId !== currentOrgId || sessionOrgId !== currentOrgId || envelopeOrgId !== currentOrgId) {
499
+ this.trackInvalidWellnessEvent('mismatched_wellness_identity');
500
+ return null;
501
+ }
502
+ const interactionValue = sessionData.interactionId ?? sessionData.InteractionId;
503
+ const actionText = notificationDetails.actionText;
504
+ const trackingId = payload.trackingId;
505
+ return {
506
+ agentId,
507
+ orgId: currentOrgId,
508
+ agentSessionId,
509
+ actionEvent: actionEvent,
510
+ ...(typeof actionText === 'string' ? {
511
+ actionText
512
+ } : {}),
513
+ ...(typeof interactionValue === 'string' ? {
514
+ interactionId: interactionValue
515
+ } : {}),
516
+ ...(typeof trackingId === 'string' ? {
517
+ trackingId
518
+ } : {})
519
+ };
520
+ }
521
+ handleWellnessBreakWebsocketPayload(payload) {
522
+ if (payload.type !== _constants.WELLNESS_BREAK_HANDLER) {
523
+ return false;
524
+ }
525
+ const wellnessEvent = this.normalizeWellnessBreakEvent(payload);
526
+ if (wellnessEvent) {
527
+ // @ts-ignore - WebexPlugin emit is available at runtime but absent from its declaration.
528
+ this.emit(_types3.CC_EVENTS.WELLNESS_BREAK, wellnessEvent);
529
+ }
530
+ return true;
531
+ }
414
532
  handleRTDWebsocketMessage = event => {
533
+ let payload;
534
+ try {
535
+ payload = JSON.parse(event);
536
+ } catch {
537
+ // TaskManager retains its existing malformed RTD message handling.
538
+ }
539
+ if ((0, _Utils.isRecord)(payload) && this.handleWellnessBreakWebsocketPayload(payload)) {
540
+ return;
541
+ }
415
542
  this.taskManager.handleRealtimeWebsocketEvent(event);
416
543
  };
417
544
 
@@ -456,15 +583,17 @@ class ContactCenter extends _webexCore.WebexPlugin {
456
583
  *
457
584
  * console.log('Agent ID:', profile.agentId);
458
585
  * console.log('Default DN:', profile.defaultDn);
459
- * console.log('Teams:', profile.teams.map(t => t.teamId));
586
+ * console.log('Teams:', profile.teams.map(t => t.id));
460
587
  * console.log('WebRTC Enabled:', profile.webRtcEnabled);
461
588
  * console.log('Supported Login Options:', profile.loginVoiceOptions);
462
589
  *
463
590
  * // Now you can proceed with station login, state changes, etc.
464
- * await cc.stationLogin({ teamId: profile.teams[0].teamId, loginOption: 'BROWSER' });
591
+ * await cc.stationLogin({ teamId: profile.teams[0].id, loginOption: 'BROWSER' });
465
592
  * ```
466
593
  */
467
594
  async register() {
595
+ this.wellnessRegistrationGeneration += 1;
596
+ this.wellbeingBreakIdleCode = undefined;
468
597
  _loggerProxy.default.log('Starting CC SDK registration', {
469
598
  module: _constants.CC_FILE,
470
599
  method: _constants.METHODS.REGISTER
@@ -484,7 +613,14 @@ class ContactCenter extends _webexCore.WebexPlugin {
484
613
  module: _constants.CC_FILE,
485
614
  method: _constants.METHODS.REGISTER
486
615
  });
487
- return resp;
616
+
617
+ // Registration can silently restore a station session without emitting a
618
+ // relogin event. Project the active session for consumers that must
619
+ // recover session-scoped state after a page refresh.
620
+ return resp.isAgentLoggedIn && this.currentAgentSessionId ? {
621
+ ...resp,
622
+ agentSessionId: this.currentAgentSessionId
623
+ } : resp;
488
624
  } catch (error) {
489
625
  this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WEBSOCKET_REGISTER_FAILED, {
490
626
  orgId: error.orgId
@@ -531,8 +667,12 @@ class ContactCenter extends _webexCore.WebexPlugin {
531
667
  *
532
668
  */
533
669
  async deregister() {
670
+ this.wellnessRegistrationGeneration += 1;
671
+ this.wellbeingBreakIdleCode = undefined;
672
+ this.updateWellnessSession();
534
673
  try {
535
674
  this.metricsManager.timeEvent([_constants4.METRIC_EVENT_NAMES.WEBSOCKET_DEREGISTER_SUCCESS, _constants4.METRIC_EVENT_NAMES.WEBSOCKET_DEREGISTER_FAIL]);
675
+ this.taskManager.clearAISummaryState();
536
676
  this.taskManager.off(_types4.TASK_EVENTS.TASK_INCOMING, this.handleIncomingTask);
537
677
  this.taskManager.off(_types4.TASK_EVENTS.TASK_HYDRATE, this.handleTaskHydrate);
538
678
  this.taskManager.off(_types4.TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, this.handleTaskMultiLoginHydrate);
@@ -541,6 +681,11 @@ class ContactCenter extends _webexCore.WebexPlugin {
541
681
  this.services.webSocketManager.off('message', this.handleWebsocketMessage);
542
682
  this.services.rtdWebSocketManager.off('message', this.handleRTDWebsocketMessage);
543
683
  this.services.connectionService.off('connectionLost', this.handleConnectionLost);
684
+ const {
685
+ publishError: wxAppPublishError
686
+ } = await this.teardownWxAppLocalState({
687
+ clearInitFlag: true
688
+ });
544
689
  if (this.agentConfig.webRtcEnabled && this.agentConfig.loginVoiceOptions.includes(_types.LoginOption.BROWSER)) {
545
690
  if (this.$webex.internal.mercury.connected) {
546
691
  this.$webex.internal.mercury.off('online');
@@ -565,7 +710,12 @@ class ContactCenter extends _webexCore.WebexPlugin {
565
710
  }
566
711
 
567
712
  // Clear any cached agent configuration
713
+ this.wellbeingBreakIdleCode = undefined;
568
714
  this.agentConfig = null;
715
+ this.updateWellnessSession();
716
+ if (wxAppPublishError) {
717
+ throw wxAppPublishError;
718
+ }
569
719
  _loggerProxy.default.log('Deregistered successfully', {
570
720
  module: _constants.CC_FILE,
571
721
  method: _constants.METHODS.DEREGISTER
@@ -619,6 +769,12 @@ class ContactCenter extends _webexCore.WebexPlugin {
619
769
  * ```
620
770
  */
621
771
  async getBuddyAgents(data) {
772
+ const {
773
+ action,
774
+ state,
775
+ mediaType = 'telephony'
776
+ } = data;
777
+ const buddyAgentState = state ?? (action === 'Transfer' ? _constants2.AGENT_STATE_AVAILABLE : undefined);
622
778
  _loggerProxy.default.info('Fetching buddy agents', {
623
779
  module: _constants.CC_FILE,
624
780
  method: _constants.METHODS.GET_BUDDY_AGENTS
@@ -628,13 +784,16 @@ class ContactCenter extends _webexCore.WebexPlugin {
628
784
  const resp = await this.services.agent.buddyAgents({
629
785
  data: {
630
786
  agentProfileId: this.agentConfig.agentProfileID,
631
- ...data
787
+ mediaType,
788
+ ...(buddyAgentState ? {
789
+ state: buddyAgentState
790
+ } : {})
632
791
  }
633
792
  });
634
793
  this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.FETCH_BUDDY_AGENTS_SUCCESS, {
635
794
  ..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(resp),
636
- mediaType: data.mediaType,
637
- buddyAgentState: data.state,
795
+ mediaType,
796
+ buddyAgentState,
638
797
  buddyAgentCount: resp.data.agentList.length
639
798
  }, ['operational']);
640
799
  _loggerProxy.default.log(`Successfully retrieved ${resp.data.agentList.length} buddy agents`, {
@@ -647,8 +806,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
647
806
  const failureResp = error.details;
648
807
  this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.FETCH_BUDDY_AGENTS_FAILED, {
649
808
  ..._MetricsManager.default.getCommonTrackingFieldForAQMResponseFailed(failureResp),
650
- mediaType: data.mediaType,
651
- buddyAgentState: data.state
809
+ mediaType,
810
+ buddyAgentState
652
811
  }, ['operational']);
653
812
  const {
654
813
  error: detailedError
@@ -685,20 +844,32 @@ class ContactCenter extends _webexCore.WebexPlugin {
685
844
  isEndConsultEnabled: this.agentConfig.isEndConsultEnabled,
686
845
  webRtcEnabled: this.agentConfig.webRtcEnabled,
687
846
  autoWrapup: this.agentConfig.wrapUpData?.wrapUpProps?.autoWrapup ?? false,
688
- aiFeature: this.agentConfig.aiFeature
847
+ aiFeature: this.agentConfig.aiFeature,
848
+ consultTransfer: {
849
+ allowConsultToQueue: this.agentConfig.allowConsultToQueue,
850
+ accessQueue: this.agentConfig.accessQueue,
851
+ accessEntryPoint: this.agentConfig.accessEntryPoint,
852
+ accessBuddyTeam: this.agentConfig.accessBuddyTeam
853
+ },
854
+ enableWxBetterTogether: this.isWxBetterTogetherEnabled(),
855
+ getWxAppUsersubPublished: () => this.webexCrossClientService.isAnswerCallsStateActive()
689
856
  };
690
857
  this.taskManager.setConfigFlags(configFlags);
691
858
  // TODO: Make profile a singleton to make it available throughout app/sdk so we dont need to inject info everywhere
692
859
  this.taskManager.setWrapupData(this.agentConfig.wrapUpData);
693
860
  this.taskManager.setAgentId(this.agentConfig.agentId);
861
+ this.taskManager.setAgentName(this.agentConfig.agentName);
694
862
  this.taskManager.setWebRtcEnabled(this.agentConfig.webRtcEnabled);
695
863
  this.apiAIAssistant.setAIFeatureFlags(this.agentConfig.aiFeature);
864
+ this.wellbeingBreakIdleCode = undefined;
865
+ this.updateWellnessSession();
696
866
 
697
867
  /**
698
868
  * RTD websocket currently supports realtime transcripts and suggested responses.
699
869
  * Extend this condition when additional AI RTD features are introduced.
870
+ * Wellness break notifications also arrive on this websocket.
700
871
  */
701
- if (this.agentConfig.aiFeature?.realtimeTranscripts?.enable || this.agentConfig.aiFeature?.suggestedResponses?.enable) {
872
+ if (this.agentConfig.aiFeature?.realtimeTranscripts?.enable || this.agentConfig.aiFeature?.suggestedResponses?.enable || this.agentConfig.aiFeature?.generatedSummaries?.wrapUpSummariesEnabled === true || this.agentConfig.aiFeature?.generatedSummaries?.consultTransferSummariesEnabled === true || this.agentConfig.isWellnessBreakEnabled) {
702
873
  _loggerProxy.default.info('Connecting to RTD websocket', {
703
874
  module: _constants.CC_FILE,
704
875
  method: _constants.METHODS.CONNECT_WEBSOCKET
@@ -748,6 +919,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
748
919
  }
749
920
  return this.agentConfig;
750
921
  } catch (error) {
922
+ this.updateWellnessSession();
751
923
  _loggerProxy.default.error(`Error during register: ${error}`, {
752
924
  module: _constants.CC_FILE,
753
925
  method: _constants.METHODS.CONNECT_WEBSOCKET
@@ -807,13 +979,15 @@ class ContactCenter extends _webexCore.WebexPlugin {
807
979
  throw error;
808
980
  }
809
981
  }
982
+ const deviceId = this.getDeviceId(data.loginOption, data.dialNumber);
810
983
  const loginResponse = await this.services.agent.stationLogin({
811
984
  data: {
812
- dialNumber: data.loginOption === _types.LoginOption.BROWSER ? this.agentConfig.agentId : data.dialNumber,
985
+ // BROWSER DN must be webrtc-{agentId} so VPOP/RTMS do not treat a bare UUID as PSTN.
986
+ dialNumber: data.loginOption === _types.LoginOption.BROWSER ? deviceId : data.dialNumber,
813
987
  teamId: data.teamId,
814
988
  deviceType: data.loginOption,
815
989
  isExtension: data.loginOption === _types.LoginOption.EXTENSION,
816
- deviceId: this.getDeviceId(data.loginOption, data.dialNumber),
990
+ deviceId,
817
991
  roles: [_constants3.AGENT],
818
992
  teamName: _constants.EMPTY_STRING,
819
993
  siteId: _constants.EMPTY_STRING,
@@ -834,6 +1008,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
834
1008
  channelsMap,
835
1009
  ...loginData
836
1010
  } = resp.data;
1011
+ this.updateWellnessSession(resp.data.agentSessionId);
837
1012
  this.agentConfig.currentTeamId = resp.data.teamId;
838
1013
  const response = {
839
1014
  ...loginData,
@@ -846,6 +1021,13 @@ class ContactCenter extends _webexCore.WebexPlugin {
846
1021
  notifsTrackingId: resp.trackingId
847
1022
  };
848
1023
  this.webCallingService.setLoginOption(data.loginOption);
1024
+ if (this.agentConfig) {
1025
+ this.agentConfig.deviceType = data.loginOption;
1026
+ if (data.loginOption === _types.LoginOption.AGENT_DN || data.loginOption === _types.LoginOption.EXTENSION) {
1027
+ this.agentConfig.defaultDn = data.dialNumber;
1028
+ this.agentConfig.dn = data.dialNumber;
1029
+ }
1030
+ }
849
1031
  this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.STATION_LOGIN_SUCCESS, {
850
1032
  ..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(resp),
851
1033
  loginType: data.loginOption,
@@ -858,6 +1040,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
858
1040
  method: _constants.METHODS.STATION_LOGIN,
859
1041
  trackingId: resp.trackingId
860
1042
  });
1043
+ await this.ensureWxAppPostStationLogin();
861
1044
  return response;
862
1045
  } catch (error) {
863
1046
  const failure = error.details;
@@ -912,6 +1095,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
912
1095
  if (this.webCallingService) {
913
1096
  this.webCallingService.deregisterWebCallingLine();
914
1097
  }
1098
+ await this.teardownWxAppLocalState();
1099
+ this.updateWellnessSession();
915
1100
  _loggerProxy.default.log(`Agent station logout completed successfully`, {
916
1101
  module: _constants.CC_FILE,
917
1102
  method: _constants.METHODS.STATION_LOGOUT,
@@ -1005,7 +1190,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
1005
1190
  this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.AGENT_STATE_CHANGE_SUCCESS, {
1006
1191
  ..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(agentStatusResponse),
1007
1192
  requestedState: data.state,
1008
- teamId: this.agentConfig?.teams[0]?.teamId ?? _constants.EMPTY_STRING,
1193
+ teamId: this.agentConfig?.teams[0]?.id ?? _constants.EMPTY_STRING,
1009
1194
  status: agentStatusResponse.data?.status,
1010
1195
  subStatus: agentStatusResponse.data?.subStatus,
1011
1196
  auxCodeId: data.auxCodeId,
@@ -1032,6 +1217,63 @@ class ContactCenter extends _webexCore.WebexPlugin {
1032
1217
  }
1033
1218
  }
1034
1219
 
1220
+ /**
1221
+ * Returns the system-managed `WellbeingBreak` idle code for the current registration.
1222
+ * The value is fetched outside Desktop Profile filtering and cached until deregistration.
1223
+ * @returns The normalized system idle-code entity
1224
+ * @throws Structured Contact Center error when wellness is disabled or the code is unavailable
1225
+ * @example
1226
+ * const idleCode = await webex.cc.getWellbeingBreakIdleCode();
1227
+ * @public
1228
+ */
1229
+ async getWellbeingBreakIdleCode() {
1230
+ const method = _constants.METHODS.GET_WELLBEING_BREAK_IDLE_CODE;
1231
+ try {
1232
+ if (!this.agentConfig?.isWellnessBreakEnabled) {
1233
+ const validationError = new Error('WELLNESS_BREAK_NOT_ENABLED');
1234
+ validationError.details = {
1235
+ type: 'SDK_VALIDATION_ERROR',
1236
+ orgId: this.$webex.credentials.getOrgId(),
1237
+ trackingId: _constants.EMPTY_STRING,
1238
+ data: {
1239
+ reason: 'WELLNESS_BREAK_NOT_ENABLED'
1240
+ }
1241
+ };
1242
+ throw validationError;
1243
+ }
1244
+ if (this.wellbeingBreakIdleCode) {
1245
+ return this.wellbeingBreakIdleCode;
1246
+ }
1247
+ this.metricsManager.timeEvent([_constants4.METRIC_EVENT_NAMES.WELLBEING_BREAK_IDLE_CODE_FETCH_SUCCESS, _constants4.METRIC_EVENT_NAMES.WELLBEING_BREAK_IDLE_CODE_FETCH_FAILED]);
1248
+ const registrationGeneration = this.wellnessRegistrationGeneration;
1249
+ const orgId = this.$webex.credentials.getOrgId();
1250
+ const idleCode = await this.services.config.getWellbeingBreakIdleCode(orgId);
1251
+ if (registrationGeneration !== this.wellnessRegistrationGeneration || orgId !== this.$webex.credentials.getOrgId() || !this.agentConfig?.isWellnessBreakEnabled) {
1252
+ const staleRegistrationError = new Error('WELLNESS_BREAK_REGISTRATION_CHANGED');
1253
+ staleRegistrationError.details = {
1254
+ type: 'SDK_VALIDATION_ERROR',
1255
+ orgId,
1256
+ trackingId: _constants.EMPTY_STRING,
1257
+ data: {
1258
+ reason: 'WELLNESS_BREAK_REGISTRATION_CHANGED'
1259
+ }
1260
+ };
1261
+ throw staleRegistrationError;
1262
+ }
1263
+ this.wellbeingBreakIdleCode = idleCode;
1264
+ this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WELLBEING_BREAK_IDLE_CODE_FETCH_SUCCESS, {}, ['operational']);
1265
+ return idleCode;
1266
+ } catch (error) {
1267
+ this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WELLBEING_BREAK_IDLE_CODE_FETCH_FAILED, {
1268
+ reason: error instanceof Error ? error.message : _constants.UNKNOWN_ERROR
1269
+ }, ['operational']);
1270
+ const {
1271
+ error: detailedError
1272
+ } = (0, _Utils.getErrorDetails)(error, method, _constants.CC_FILE);
1273
+ throw detailedError;
1274
+ }
1275
+ }
1276
+
1035
1277
  /**
1036
1278
  * Processes incoming websocket messages and emits corresponding events
1037
1279
  * Handles various event types including agent state changes, login events,
@@ -1041,8 +1283,9 @@ class ContactCenter extends _webexCore.WebexPlugin {
1041
1283
  */
1042
1284
  handleWebsocketMessage = event => {
1043
1285
  const eventData = JSON.parse(event);
1044
- // Re-emit all the events related to agent except keep-alives
1045
- if (!eventData.keepalive && eventData.data && eventData.data.type) {
1286
+ // Re-emit all the events related to agent except keep-alives. Only event names present in
1287
+ // the typed CC_EVENTS allow-list are emitted; unknown/server-injected types are ignored.
1288
+ if (!eventData.keepalive && eventData.data && eventData.data.type && CC_EVENT_ALLOW_LIST.has(eventData.data.type)) {
1046
1289
  // @ts-ignore
1047
1290
  this.emit(eventData.data.type, eventData.data);
1048
1291
  }
@@ -1065,8 +1308,14 @@ class ContactCenter extends _webexCore.WebexPlugin {
1065
1308
  };
1066
1309
  this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WEBSOCKET_EVENT_RECEIVED, metricsPayload, ['operational']);
1067
1310
  }
1311
+ if (this.handleWellnessBreakWebsocketPayload(eventData)) {
1312
+ return;
1313
+ }
1068
1314
  switch (eventData.type) {
1069
1315
  case _types3.CC_EVENTS.AGENT_MULTI_LOGIN:
1316
+ if (eventData.data?.type === 'AgentMultiLoginCloseSession' && (!eventData.data.agentSessionId || eventData.data.agentSessionId === this.currentAgentSessionId)) {
1317
+ this.updateWellnessSession();
1318
+ }
1070
1319
  // @ts-ignore
1071
1320
  this.emit(_types2.AGENT_EVENTS.AGENT_MULTI_LOGIN, eventData.data);
1072
1321
  break;
@@ -1087,6 +1336,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
1087
1336
  channelsMap,
1088
1337
  ...loginData
1089
1338
  } = eventData.data;
1339
+ this.updateWellnessSession(loginData.agentSessionId);
1090
1340
  const stationLoginData = {
1091
1341
  ...loginData,
1092
1342
  mmProfile: {
@@ -1108,6 +1358,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
1108
1358
  channelsMap,
1109
1359
  ...loginData
1110
1360
  } = eventData.data;
1361
+ this.updateWellnessSession(loginData.agentSessionId);
1111
1362
  const stationReLoginData = {
1112
1363
  ...loginData,
1113
1364
  mmProfile: {
@@ -1120,8 +1371,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
1120
1371
  };
1121
1372
  // @ts-ignore
1122
1373
  this.emit(_types2.AGENT_EVENTS.AGENT_RELOGIN_SUCCESS, stationReLoginData);
1374
+ break;
1123
1375
  }
1124
- break;
1125
1376
  case _types3.CC_EVENTS.AGENT_STATE_CHANGE_SUCCESS:
1126
1377
  // @ts-ignore
1127
1378
  this.emit(_types2.AGENT_EVENTS.AGENT_STATE_CHANGE_SUCCESS, eventData.data);
@@ -1135,6 +1386,9 @@ class ContactCenter extends _webexCore.WebexPlugin {
1135
1386
  this.emit(_types2.AGENT_EVENTS.AGENT_STATION_LOGIN_FAILED, eventData.data);
1136
1387
  break;
1137
1388
  case _types3.CC_EVENTS.AGENT_LOGOUT_SUCCESS:
1389
+ if (!eventData.data.agentSessionId || eventData.data.agentSessionId === this.currentAgentSessionId) {
1390
+ this.updateWellnessSession();
1391
+ }
1138
1392
  // @ts-ignore
1139
1393
  this.emit(_types2.AGENT_EVENTS.AGENT_LOGOUT_SUCCESS, eventData.data);
1140
1394
  break;
@@ -1170,6 +1424,485 @@ class ContactCenter extends _webexCore.WebexPlugin {
1170
1424
  }
1171
1425
  }
1172
1426
 
1427
+ /**
1428
+ * Whether wxApp thick-client answer is enabled for this SDK instance.
1429
+ * @public
1430
+ */
1431
+ isWxBetterTogetherEnabled() {
1432
+ return this.$config?.enableWxBetterTogether === true;
1433
+ }
1434
+
1435
+ /**
1436
+ * Current station login option (Extension, Dial Number, or Browser/Desktop).
1437
+ * Prefer webCallingService — updated on every stationLogin before wxApp hooks run.
1438
+ * @private
1439
+ */
1440
+ getCurrentStationLoginOption() {
1441
+ return this.webCallingService?.loginOption ?? this.agentConfig?.deviceType;
1442
+ }
1443
+
1444
+ /**
1445
+ * wxApp thick-client answer is supported for Extension and Dial Number station login only —
1446
+ * not Browser/Desktop (WebRTC) login.
1447
+ * @private
1448
+ */
1449
+ assertWxAppStationLoginSupportedForEnable() {
1450
+ const loginOption = this.getCurrentStationLoginOption();
1451
+ if (loginOption !== _types.LoginOption.EXTENSION && loginOption !== _types.LoginOption.AGENT_DN) {
1452
+ throw new Error('setManageWebexCallingInWxcc requires EXTENSION or AGENT_DN station login. Complete station login before enabling.');
1453
+ }
1454
+ }
1455
+
1456
+ /**
1457
+ * Clears runtime wxApp config after logout/deregister so stale flags do not apply on relogin.
1458
+ * @private
1459
+ */
1460
+ resetEnableWxBetterTogetherConfig() {
1461
+ if (this.$config) {
1462
+ this.$config.enableWxBetterTogether = false;
1463
+ }
1464
+ this.taskManager.applyEnableWxBetterTogether(false);
1465
+ }
1466
+
1467
+ /**
1468
+ * Runtime enable/disable for wxApp Better Together (toast suppression + Mercury mute sync).
1469
+ *
1470
+ * **Phase 1 (WXCC-6026 / MMT): NOT part of the public host contract.**
1471
+ * Hosts must set `webexConfig.cc.enableWxBetterTogether` before `webex.init()` / `cc.register()`.
1472
+ * To change the flag after the SDK is initialized, re-init the SDK with the updated config.
1473
+ *
1474
+ * **Supported public read API:** {@link isWxBetterTogetherEnabled}.
1475
+ * **Supported telephony API:** unified `task.accept()`, `task.decline()`, `task.toggleMute()`,
1476
+ * `task.transmitDtmf()` — SDK routes wxApp calls internally when the init flag is active.
1477
+ *
1478
+ * **Production lifecycle does not call this method.** Station login, silent relogin, logout,
1479
+ * and deregister use {@link ensureWxAppPostStationLogin} and {@link teardownWxAppLocalState}
1480
+ * (usersub publish + Mercury subscribe/unsubscribe based on the init flag).
1481
+ *
1482
+ * This setter remains as a **private implementation** for Phase 2 runtime toggle and unit tests.
1483
+ * It updates `$config.enableWxBetterTogether`, TaskManager flags, cross-client usersub
1484
+ * (`answer-calls-on-wxcc`), and Mercury mute sync; rolls back config on publish/connect failure.
1485
+ *
1486
+ * @param enabled - `true` to enable wxApp answer + usersub suppression; `false` to disable and tear down.
1487
+ * @throws When enabling without login, on unsupported BROWSER station login, or when usersub/Mercury init fails.
1488
+ * @internal
1489
+ * @see enableWxBetterTogether (CCPluginConfig init flag)
1490
+ * @see ensureWxAppPostStationLogin
1491
+ * @see teardownWxAppLocalState
1492
+ */
1493
+ async setManageWebexCallingInWxcc(enabled) {
1494
+ if (enabled && !this.$webex.internal.device?.userId) {
1495
+ throw new Error('Cannot publish answer-calls-on-wxcc: user is not logged in');
1496
+ }
1497
+ if (enabled) {
1498
+ this.assertWxAppStationLoginSupportedForEnable();
1499
+ }
1500
+ const previousEnabled = this.isWxBetterTogetherEnabled();
1501
+ if (this.$config) {
1502
+ this.$config.enableWxBetterTogether = enabled;
1503
+ }
1504
+ this.taskManager.applyEnableWxBetterTogether(enabled);
1505
+ let publishedEnable = false;
1506
+ try {
1507
+ if (enabled) {
1508
+ await this.ensureWxAppMercuryAndSubscribe();
1509
+ await this.publishAnswerOnWebexCrossClientState(true);
1510
+ publishedEnable = true;
1511
+ this.taskManager.syncWxAppMuteFromCallDetailsForAllTasks();
1512
+ this.taskManager.refreshWxAppOfferObservabilityForAllTasks();
1513
+ } else {
1514
+ await this.publishAnswerOnWebexCrossClientState(false);
1515
+ this.wxAppTelephonyMercurySync.unsubscribe();
1516
+ await this.releaseWxAppMercuryResources();
1517
+ }
1518
+ } catch (error) {
1519
+ if (publishedEnable) {
1520
+ await this.revertWxAppCrossClientPublish();
1521
+ } else if (enabled) {
1522
+ this.wxAppTelephonyMercurySync.unsubscribe();
1523
+ await this.releaseWxAppMercuryResources();
1524
+ }
1525
+ if (this.$config) {
1526
+ this.$config.enableWxBetterTogether = previousEnabled;
1527
+ }
1528
+ this.taskManager.applyEnableWxBetterTogether(previousEnabled);
1529
+ throw error;
1530
+ }
1531
+ }
1532
+ getWxAppTelephonyTaskType() {
1533
+ const loginOption = this.getCurrentStationLoginOption();
1534
+ if (loginOption === _types.LoginOption.BROWSER) {
1535
+ return 'WebRTC';
1536
+ }
1537
+ if (loginOption === _types.LoginOption.EXTENSION || loginOption === _types.LoginOption.AGENT_DN) {
1538
+ return 'Voice';
1539
+ }
1540
+ return 'unknown';
1541
+ }
1542
+ async ensureWxAppPostStationLogin() {
1543
+ const loginOption = this.getCurrentStationLoginOption();
1544
+ const flagEnabled = this.isWxBetterTogetherEnabled();
1545
+ const telephonyTaskType = this.getWxAppTelephonyTaskType();
1546
+ if (loginOption === _types.LoginOption.BROWSER) {
1547
+ if (flagEnabled) {
1548
+ (0, _wxAppDiagnosticLogging.logWxAppSessionReadiness)({
1549
+ enableWxBetterTogether: true,
1550
+ loginOption,
1551
+ wxAppHooksApplied: false,
1552
+ usersubPublished: false,
1553
+ mercurySubscribed: false,
1554
+ telephonyTaskType,
1555
+ skipReason: 'unsupported_browser_login'
1556
+ });
1557
+ this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_SKIPPED, {
1558
+ loginOption,
1559
+ enableWxBetterTogether: true,
1560
+ skipReason: 'unsupported_browser_login'
1561
+ }, ['operational', 'behavioral']);
1562
+ }
1563
+ return;
1564
+ }
1565
+ let publishedEnable = false;
1566
+ let wxAppInitStage = 'mercury';
1567
+ try {
1568
+ if (flagEnabled) {
1569
+ this.metricsManager.timeEvent([_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_SUCCESS, _constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_FAILED]);
1570
+ await this.ensureWxAppMercuryAndSubscribe();
1571
+ wxAppInitStage = 'publish';
1572
+ await this.publishAnswerOnWebexCrossClientState(true);
1573
+ publishedEnable = true;
1574
+ this.taskManager.syncWxAppMuteFromCallDetailsForAllTasks();
1575
+ this.taskManager.refreshWxAppOfferObservabilityForAllTasks();
1576
+ const mercurySubscribed = this.wxAppTelephonyMercurySync.isSubscribed();
1577
+ const usersubPublished = this.webexCrossClientService.isAnswerCallsStateActive();
1578
+ (0, _wxAppDiagnosticLogging.logWxAppSessionReadiness)({
1579
+ enableWxBetterTogether: true,
1580
+ loginOption,
1581
+ wxAppHooksApplied: true,
1582
+ usersubPublished,
1583
+ mercurySubscribed,
1584
+ telephonyTaskType
1585
+ });
1586
+ const sessionInitReady = mercurySubscribed && usersubPublished;
1587
+ if (sessionInitReady) {
1588
+ this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_SUCCESS, {
1589
+ loginOption,
1590
+ enableWxBetterTogether: true,
1591
+ usersubPublished,
1592
+ mercurySubscribed,
1593
+ telephonyTaskType
1594
+ }, ['operational', 'behavioral']);
1595
+ } else {
1596
+ this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_FAILED, {
1597
+ loginOption,
1598
+ enableWxBetterTogether: true,
1599
+ usersubPublished,
1600
+ mercurySubscribed,
1601
+ telephonyTaskType,
1602
+ skipReason: !usersubPublished ? 'usersub_not_published' : 'mercury_not_subscribed'
1603
+ }, ['operational', 'behavioral']);
1604
+ }
1605
+ } else {
1606
+ await this.ensureWxAppDeviceRegistered();
1607
+ await this.publishAnswerOnWebexCrossClientState(false, {
1608
+ force: true
1609
+ });
1610
+ this.webexCrossClientService.teardown();
1611
+ this.wxAppTelephonyMercurySync.unsubscribe();
1612
+ await this.releaseWxAppMercuryResources();
1613
+ (0, _wxAppDiagnosticLogging.logWxAppSessionReadiness)({
1614
+ enableWxBetterTogether: false,
1615
+ loginOption,
1616
+ wxAppHooksApplied: true,
1617
+ usersubPublished: false,
1618
+ mercurySubscribed: false,
1619
+ telephonyTaskType,
1620
+ skipReason: 'flag_disabled'
1621
+ });
1622
+ this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_SKIPPED, {
1623
+ loginOption,
1624
+ enableWxBetterTogether: false,
1625
+ skipReason: 'flag_disabled'
1626
+ }, ['operational', 'behavioral']);
1627
+ }
1628
+ } catch (error) {
1629
+ _loggerProxy.default.error(`Failed to initialize wxApp post-station-login: ${error}`, {
1630
+ module: _constants.CC_FILE,
1631
+ method: _constants.METHODS.STATION_LOGIN
1632
+ });
1633
+ if (flagEnabled) {
1634
+ const sessionInitFailureReason = wxAppInitStage === 'mercury' ? 'mercury_subscribe_failed' : 'publish_failed';
1635
+ this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_FAILED, {
1636
+ loginOption,
1637
+ enableWxBetterTogether: true,
1638
+ usersubPublished: this.webexCrossClientService.isAnswerCallsStateActive(),
1639
+ mercurySubscribed: this.wxAppTelephonyMercurySync.isSubscribed(),
1640
+ telephonyTaskType,
1641
+ skipReason: sessionInitFailureReason,
1642
+ error: error instanceof Error ? error.toString() : String(error)
1643
+ }, ['operational', 'behavioral']);
1644
+ (0, _wxAppDiagnosticLogging.logWxAppSessionReadiness)({
1645
+ enableWxBetterTogether: true,
1646
+ loginOption,
1647
+ wxAppHooksApplied: false,
1648
+ usersubPublished: this.webexCrossClientService.isAnswerCallsStateActive(),
1649
+ mercurySubscribed: this.wxAppTelephonyMercurySync.isSubscribed(),
1650
+ telephonyTaskType,
1651
+ skipReason: sessionInitFailureReason
1652
+ });
1653
+ if (publishedEnable) {
1654
+ await this.revertWxAppCrossClientPublish();
1655
+ } else {
1656
+ this.wxAppTelephonyMercurySync.unsubscribe();
1657
+ await this.releaseWxAppMercuryResources();
1658
+ }
1659
+ this.resetEnableWxBetterTogetherConfig();
1660
+ } else {
1661
+ this.scheduleForcedFalsePublishRetry();
1662
+ }
1663
+ }
1664
+ }
1665
+ clearWxAppFalsePublishRetryTimer() {
1666
+ if (this.wxAppFalsePublishRetryTimer) {
1667
+ clearTimeout(this.wxAppFalsePublishRetryTimer);
1668
+ this.wxAppFalsePublishRetryTimer = undefined;
1669
+ }
1670
+ }
1671
+ scheduleForcedFalsePublishRetry(retryAttempt = 0) {
1672
+ this.scheduleFalsePublishRetry(retryAttempt, {
1673
+ requireDisabled: true
1674
+ });
1675
+ }
1676
+
1677
+ /**
1678
+ * Retries compensating false publish after rollback failure, regardless of enabled flag.
1679
+ * @private
1680
+ */
1681
+ scheduleCompensatingFalsePublishRetry(retryAttempt = 0) {
1682
+ this.scheduleFalsePublishRetry(retryAttempt);
1683
+ }
1684
+ scheduleFalsePublishRetry(retryAttempt = 0, options = {}) {
1685
+ if (retryAttempt >= ContactCenter.WXAPP_FALSE_PUBLISH_MAX_RETRIES) {
1686
+ return;
1687
+ }
1688
+ if (options?.requireDisabled && this.isWxBetterTogetherEnabled()) {
1689
+ return;
1690
+ }
1691
+ this.clearWxAppFalsePublishRetryTimer();
1692
+ this.wxAppFalsePublishRetryTimer = setTimeout(async () => {
1693
+ this.wxAppFalsePublishRetryTimer = undefined;
1694
+ if (options?.requireDisabled && this.isWxBetterTogetherEnabled()) {
1695
+ return;
1696
+ }
1697
+ if (!options?.requireDisabled && this.isWxBetterTogetherEnabled() && this.webexCrossClientService.isAnswerCallsStateActive()) {
1698
+ return;
1699
+ }
1700
+ try {
1701
+ await this.ensureWxAppDeviceRegistered();
1702
+ await this.publishAnswerOnWebexCrossClientState(false, {
1703
+ force: true
1704
+ });
1705
+ this.webexCrossClientService.teardown();
1706
+ this.wxAppTelephonyMercurySync.unsubscribe();
1707
+ await this.releaseWxAppMercuryResources();
1708
+ } catch (retryError) {
1709
+ _loggerProxy.default.error(`Failed to retry forced answer-calls-on-wxcc false publish: ${retryError}`, {
1710
+ module: _constants.CC_FILE,
1711
+ method: _constants.METHODS.SET_MANAGE_WEBEX_CALLING_IN_WXCC
1712
+ });
1713
+ this.scheduleFalsePublishRetry(retryAttempt + 1, options);
1714
+ }
1715
+ }, ContactCenter.WXAPP_FALSE_PUBLISH_RETRY_DELAY_MS);
1716
+ }
1717
+
1718
+ /**
1719
+ * Best-effort rollback when usersub true was published but wxApp setup did not complete.
1720
+ * @private
1721
+ */
1722
+ async revertWxAppCrossClientPublish() {
1723
+ try {
1724
+ await this.publishAnswerOnWebexCrossClientState(false, {
1725
+ force: true
1726
+ });
1727
+ } catch (error) {
1728
+ _loggerProxy.default.error(`Failed to publish compensating answer-calls-on-wxcc false during wxApp rollback: ${error}`, {
1729
+ module: _constants.CC_FILE,
1730
+ method: _constants.METHODS.SET_MANAGE_WEBEX_CALLING_IN_WXCC
1731
+ });
1732
+ this.scheduleCompensatingFalsePublishRetry();
1733
+ }
1734
+ this.webexCrossClientService.teardown();
1735
+ this.wxAppTelephonyMercurySync.unsubscribe();
1736
+ await this.releaseWxAppMercuryResources();
1737
+ }
1738
+ async ensureWxAppDeviceRegistered() {
1739
+ const device = this.$webex.internal.device;
1740
+ if (device && !device.registered && device.register) {
1741
+ await device.register();
1742
+ this.wxAppDeviceRegisteredByCc = true;
1743
+ _loggerProxy.default.log('WxApp: device registered for cross-client publish', {
1744
+ module: _constants.CC_FILE,
1745
+ method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
1746
+ });
1747
+ }
1748
+ }
1749
+ async ensureWxAppMercuryConnected() {
1750
+ const mercury = this.$webex.internal.mercury;
1751
+ await this.ensureWxAppDeviceRegistered();
1752
+ if (mercury && !mercury.connected) {
1753
+ await mercury.connect();
1754
+ this.wxAppMercuryConnectedByCc = true;
1755
+ _loggerProxy.default.log('WxApp mute sync: mercury connected', {
1756
+ module: _constants.CC_FILE,
1757
+ method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
1758
+ });
1759
+ }
1760
+ }
1761
+
1762
+ /**
1763
+ * Disconnects Mercury and unregisters the device when wxApp mute sync opened them.
1764
+ * @private
1765
+ */
1766
+ async releaseWxAppMercuryResources() {
1767
+ const mercury = this.$webex.internal.mercury;
1768
+ const device = this.$webex.internal.device;
1769
+ if (this.wxAppMercuryConnectedByCc && mercury?.connected) {
1770
+ try {
1771
+ await mercury.disconnect();
1772
+ this.wxAppMercuryConnectedByCc = false;
1773
+ _loggerProxy.default.log('WxApp mute sync: mercury disconnected', {
1774
+ module: _constants.CC_FILE,
1775
+ method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
1776
+ });
1777
+ } catch (error) {
1778
+ _loggerProxy.default.error(`Failed to disconnect wxApp Mercury: ${error}`, {
1779
+ module: _constants.CC_FILE,
1780
+ method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
1781
+ });
1782
+ }
1783
+ }
1784
+ if (this.wxAppDeviceRegisteredByCc && device?.registered && device.unregister) {
1785
+ try {
1786
+ // @ts-ignore
1787
+ await device.unregister();
1788
+ this.wxAppDeviceRegisteredByCc = false;
1789
+ _loggerProxy.default.log('WxApp mute sync: device unregistered', {
1790
+ module: _constants.CC_FILE,
1791
+ method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
1792
+ });
1793
+ } catch (error) {
1794
+ _loggerProxy.default.error(`Failed to unregister wxApp device: ${error}`, {
1795
+ module: _constants.CC_FILE,
1796
+ method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
1797
+ });
1798
+ }
1799
+ } else if (this.wxAppDeviceRegisteredByCc) {
1800
+ this.wxAppDeviceRegisteredByCc = false;
1801
+ }
1802
+ }
1803
+
1804
+ /**
1805
+ * Clears wxApp runtime state and feature-owned resources. Publish failures are logged;
1806
+ * optional rethrow for deregister when callers need to surface usersub errors.
1807
+ * @private
1808
+ */
1809
+ async teardownWxAppLocalState(options) {
1810
+ this.clearWxAppFalsePublishRetryTimer();
1811
+ let publishError;
1812
+ try {
1813
+ const shouldForceFalsePublish = this.isWxBetterTogetherEnabled() || this.webexCrossClientService.isAnswerCallsStateActive();
1814
+ await this.publishAnswerOnWebexCrossClientState(false, {
1815
+ force: shouldForceFalsePublish
1816
+ });
1817
+ } catch (error) {
1818
+ publishError = error;
1819
+ _loggerProxy.default.error(`Failed to publish answer-calls-on-wxcc false during wxApp teardown: ${error}`, {
1820
+ module: _constants.CC_FILE,
1821
+ method: _constants.METHODS.SET_MANAGE_WEBEX_CALLING_IN_WXCC
1822
+ });
1823
+ }
1824
+ this.webexCrossClientService.teardown();
1825
+ this.wxAppTelephonyMercurySync.unsubscribe();
1826
+ await this.releaseWxAppMercuryResources();
1827
+ if (options?.clearInitFlag) {
1828
+ this.resetEnableWxBetterTogetherConfig();
1829
+ }
1830
+ if (publishError) {
1831
+ this.scheduleCompensatingFalsePublishRetry();
1832
+ }
1833
+ if (options?.rethrowPublishError && publishError) {
1834
+ throw publishError;
1835
+ }
1836
+ return {
1837
+ publishError: publishError ?? undefined
1838
+ };
1839
+ }
1840
+ async ensureWxAppMercuryAndSubscribe() {
1841
+ if (!this.isWxBetterTogetherEnabled()) {
1842
+ return;
1843
+ }
1844
+ if (this.getCurrentStationLoginOption() === _types.LoginOption.BROWSER) {
1845
+ return;
1846
+ }
1847
+ const agentId = this.agentConfig?.agentId;
1848
+ if (!agentId) {
1849
+ _loggerProxy.default.error('Cannot subscribe wxApp mute sync: agentId unavailable', {
1850
+ module: _constants.CC_FILE,
1851
+ method: _constants.METHODS.SYNC_WXAPP_MUTE_FROM_MERCURY
1852
+ });
1853
+ this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_MERCURY_SUBSCRIBE_FAILED, {
1854
+ error: 'agentId unavailable',
1855
+ mercurySubscribed: false
1856
+ }, ['operational', 'behavioral']);
1857
+ return;
1858
+ }
1859
+ try {
1860
+ await this.ensureWxAppMercuryConnected();
1861
+ this.wxAppTelephonyMercurySync.subscribe(agentId, (callId, muted) => {
1862
+ this.taskManager.applyWxAppMuteStateFromSync(callId, muted);
1863
+ });
1864
+ } catch (error) {
1865
+ _loggerProxy.default.error(`Failed to ensure wxApp Mercury mute sync: ${error}`, {
1866
+ module: _constants.CC_FILE,
1867
+ method: _constants.METHODS.SYNC_WXAPP_MUTE_FROM_MERCURY
1868
+ });
1869
+ this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_MERCURY_SUBSCRIBE_FAILED, {
1870
+ error: error instanceof Error ? error.toString() : String(error),
1871
+ mercurySubscribed: false
1872
+ }, ['operational', 'behavioral']);
1873
+ this.wxAppTelephonyMercurySync.unsubscribe();
1874
+ await this.releaseWxAppMercuryResources();
1875
+ throw error;
1876
+ }
1877
+ }
1878
+ async publishAnswerOnWebexCrossClientState(enable, options) {
1879
+ if (enable && !this.isWxBetterTogetherEnabled()) {
1880
+ return;
1881
+ }
1882
+ if (!enable && !options?.force && !this.webexCrossClientService.isAnswerCallsStateActive()) {
1883
+ return;
1884
+ }
1885
+ const userId = this.$webex.internal.device?.userId;
1886
+ if (!userId) {
1887
+ if (enable && this.isWxBetterTogetherEnabled()) {
1888
+ this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_USERSUB_PUBLISH_FAILED, {
1889
+ enableWxBetterTogether: true,
1890
+ usersubPublished: this.webexCrossClientService.isAnswerCallsStateActive(),
1891
+ skipReason: 'user_id_unavailable',
1892
+ error: 'User ID is unavailable for cross-client publish'
1893
+ }, ['operational', 'behavioral']);
1894
+ }
1895
+ return;
1896
+ }
1897
+ await this.webexCrossClientService.setManageWebexCallingInWxcc(enable, {
1898
+ userId,
1899
+ trackPublishMetrics: true
1900
+ });
1901
+ if (enable) {
1902
+ this.clearWxAppFalsePublishRetryTimer();
1903
+ }
1904
+ }
1905
+
1173
1906
  /**
1174
1907
  * Initializes event listeners for the Contact Center service
1175
1908
  * Sets up handlers for connection state changes and other core events
@@ -1228,6 +1961,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
1228
1961
  });
1229
1962
  try {
1230
1963
  const reLoginResponse = await this.services.agent.reload();
1964
+ this.updateWellnessSession(reLoginResponse.data.agentSessionId);
1231
1965
  const {
1232
1966
  agentId,
1233
1967
  lastStateChangeReason,
@@ -1268,6 +2002,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
1268
2002
  }
1269
2003
  this.agentConfig.lastStateAuxCodeId = auxCodeId;
1270
2004
  this.agentConfig.isAgentLoggedIn = true;
2005
+ await this.ensureWxAppPostStationLogin();
1271
2006
  _loggerProxy.default.log(`Silent relogin process completed successfully with login Option: ${reLoginResponse.data.deviceType} teamId: ${reLoginResponse.data.teamId}`, {
1272
2007
  module: _constants.CC_FILE,
1273
2008
  method: _constants.METHODS.SILENT_RELOGIN,
@@ -1884,8 +2619,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
1884
2619
  }
1885
2620
 
1886
2621
  /**
1887
- * Returns paginated entry points for the organization.
1888
- * Thin wrapper around internal EntryPoint instance.
2622
+ * Returns paginated entry points using the EntryPoint service defaults.
2623
+ * Existing request parameters can override those defaults.
1889
2624
  * @public
1890
2625
  */
1891
2626
  async getEntryPoints(params = {}) {
@@ -1893,8 +2628,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
1893
2628
  }
1894
2629
 
1895
2630
  /**
1896
- * Returns paginated contact service queues for the organization.
1897
- * Thin wrapper around internal Queue instance.
2631
+ * Returns paginated contact service queues using the Queue service defaults.
2632
+ * Existing request parameters can override those defaults.
1898
2633
  * @public
1899
2634
  */
1900
2635
  async getQueues(params = {}) {