@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
@@ -12,42 +12,408 @@ var _loggerProxy = _interopRequireDefault(require("../../../logger-proxy"));
12
12
  var _MetricsManager = _interopRequireDefault(require("../../../metrics/MetricsManager"));
13
13
  var _constants2 = require("../../../metrics/constants");
14
14
  var _stateMachine = require("../state-machine");
15
+ var _guards = require("../state-machine/guards");
15
16
  var _TaskUtils = require("../TaskUtils");
17
+ var _wxAppTelephonyUtils = require("../../wxAppTelephonyUtils");
18
+ var _wxAppVoiceMethods = require("./wxAppVoiceMethods");
19
+ var _wxAppDiagnosticLogging = require("../../wxAppDiagnosticLogging");
20
+ var _wxAppOfferObservability = require("./wxAppOfferObservability");
16
21
  function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
22
+ const hasNonemptyPendingWrapUp = taskData => Array.isArray(taskData?.agentsPendingWrapUp) && taskData.agentsPendingWrapUp.length > 0;
23
+
24
+ /**
25
+ * Same consulted-non-owner rule as TaskManager leave stamp. Used only for the
26
+ * HTTP exitConference self-exit fallback (shouldWrapUpForThisAgent stays unchanged).
27
+ */
28
+ const isConsultedNonOwner = (taskData, fallback) => {
29
+ const isConsulted = taskData.isConsulted ?? fallback?.isConsulted;
30
+ if (isConsulted !== true) {
31
+ return false;
32
+ }
33
+ const owner = taskData.interaction?.owner ?? fallback?.interaction?.owner;
34
+ const selfAgentId = taskData.agentId ?? fallback?.agentId;
35
+ return Boolean(selfAgentId && owner && owner !== selfAgentId);
36
+ };
17
37
  class Voice extends _Task.default {
18
- constructor(contact, data, callOptions, wrapupData, agentId) {
38
+ static WXAPP_MUTE_SYNC_RETRY_DELAY_MS = 50;
39
+ static WXAPP_MUTE_SYNC_MAX_RETRIES = 3;
40
+ enableWxBetterTogether = false;
41
+ wxAppMuted = false;
42
+ wxAppAnswerPending = false;
43
+ wxAppAcceptInFlight = false;
44
+ wxAppMuteToggleTail = Promise.resolve();
45
+ wxAppDtmfTail = Promise.resolve();
46
+ /** Lazy — `super()` may call `updateUiControls` before field initializers run. */
47
+ wxAppOfferObservability = null;
48
+ constructor(contact, data, callOptions, wrapupData, agentId, agentName, apiAIAssistant) {
19
49
  const resolvedOptions = {
20
50
  isEndTaskEnabled: callOptions?.isEndTaskEnabled ?? true,
21
51
  isEndConsultEnabled: callOptions?.isEndConsultEnabled ?? true,
22
52
  voiceVariant: callOptions?.voiceVariant ?? _types.VOICE_VARIANT.PSTN,
23
- isRecordingEnabled: callOptions?.isRecordingEnabled ?? true
53
+ isRecordingEnabled: callOptions?.isRecordingEnabled ?? true,
54
+ enableWxBetterTogether: callOptions?.enableWxBetterTogether ?? false
24
55
  };
25
56
  super(contact, data, {
26
- ...resolvedOptions
27
- }, wrapupData, agentId);
57
+ ...resolvedOptions,
58
+ consultTransferConfig: callOptions?.consultTransferConfig
59
+ }, wrapupData, agentId, agentName, apiAIAssistant);
60
+ this.enableWxBetterTogether = resolvedOptions.enableWxBetterTogether;
61
+ this.answerCallOnWebexService = callOptions?.answerCallOnWebexService;
62
+ this.getUsersubPublished = callOptions?.getUsersubPublished;
63
+ }
64
+ getWxAppVoiceDependencies() {
65
+ return {
66
+ enableWxBetterTogether: this.enableWxBetterTogether,
67
+ answerCallOnWebexService: this.answerCallOnWebexService,
68
+ agentId: this.agentId,
69
+ metricsManager: this.metricsManager,
70
+ getTaskData: () => this.data,
71
+ getTaskState: () => this.stateMachineService?.getSnapshot?.()?.value,
72
+ getWxAppMuted: () => this.wxAppMuted,
73
+ setWxAppMuted: muted => {
74
+ this.wxAppMuted = muted;
75
+ },
76
+ getUsersubPublished: this.getUsersubPublished
77
+ };
78
+ }
79
+
80
+ /** @deprecated Use {@link Voice.getWxAppVoiceDependencies} */
81
+ getWxAppVoiceDeps() {
82
+ return this.getWxAppVoiceDependencies();
83
+ }
84
+ isWebexAppCallingOffer() {
85
+ return (0, _wxAppVoiceMethods.isWebexAppCallingOffer)(this.getWxAppVoiceDeps());
86
+ }
87
+ isWebexAppInboundCallingOffer() {
88
+ return (0, _wxAppVoiceMethods.isWebexAppInboundCallingOffer)(this.getWxAppVoiceDeps());
89
+ }
90
+ setWxAppAnswerPending(pending) {
91
+ this.wxAppAnswerPending = pending;
92
+ this.uiControlConfig = {
93
+ ...this.uiControlConfig,
94
+ wxAppAnswerPending: pending
95
+ };
96
+ this.updateUiControls(true);
97
+ }
98
+ setWxAppAcceptInFlight(inFlight) {
99
+ this.wxAppAcceptInFlight = inFlight;
100
+ this.uiControlConfig = {
101
+ ...this.uiControlConfig,
102
+ wxAppAcceptInFlight: inFlight
103
+ };
104
+ this.updateUiControls(true);
105
+ }
106
+ setEnableWxBetterTogether(enabled) {
107
+ this.enableWxBetterTogether = enabled;
108
+ this.uiControlConfig = {
109
+ ...this.uiControlConfig,
110
+ enableWxBetterTogether: enabled
111
+ };
112
+ this.updateUiControls(true);
113
+ }
114
+ getOrCreateWxAppOfferObservability() {
115
+ if (!this.wxAppOfferObservability) {
116
+ this.wxAppOfferObservability = new _wxAppOfferObservability.WxAppOfferObservability();
117
+ }
118
+ return this.wxAppOfferObservability;
119
+ }
120
+ updateUiControls(forceEmit = false) {
121
+ super.updateUiControls(forceEmit);
122
+ this.getOrCreateWxAppOfferObservability().handleUiControlsUpdate(this.getWxAppOfferObservabilityContext());
123
+ }
124
+
125
+ /**
126
+ * Re-run OFFERED wxApp diagnostics without emitting UI controls.
127
+ * Used after usersub publish so a pre-publish offer can schedule mismatch grace.
128
+ */
129
+ refreshWxAppOfferObservability() {
130
+ this.getOrCreateWxAppOfferObservability().handleUiControlsUpdate(this.getWxAppOfferObservabilityContext());
131
+ }
132
+
133
+ /**
134
+ * Cancel pending participant-mismatch grace timer. Observability only.
135
+ */
136
+ disposeWxAppOfferObservability() {
137
+ this.wxAppOfferObservability?.dispose();
138
+ }
139
+ getWxAppOfferObservabilityContext() {
140
+ return {
141
+ getInteractionId: () => this.data.interactionId,
142
+ getTaskState: () => this.stateMachineService?.getSnapshot?.()?.value,
143
+ getAcceptControl: () => this.currentUiControls?.main?.accept,
144
+ getVoiceVariant: () => this.uiControlConfig.voiceVariant ?? _types.VOICE_VARIANT.PSTN,
145
+ isOutdial: () => this.data?.interaction?.outboundType === 'OUTDIAL',
146
+ isWxAppInboundOffer: () => this.isWebexAppInboundCallingOffer(),
147
+ isWxAppCallingOffer: () => this.isWebexAppCallingOffer(),
148
+ getWxAppAcceptInFlight: () => this.wxAppAcceptInFlight,
149
+ getWxAppAnswerPending: () => this.wxAppAnswerPending,
150
+ getEnableWxBetterTogether: () => this.enableWxBetterTogether,
151
+ getUsersubPublished: () => this.getUsersubPublished?.() ?? false,
152
+ getWxAppVoiceDependencies: () => this.getWxAppVoiceDependencies(),
153
+ getMetricsManager: () => this.metricsManager
154
+ };
155
+ }
156
+ applyWxAppMuteStateFromSync(incomingCallId, muted) {
157
+ if (!this.enableWxBetterTogether) {
158
+ return;
159
+ }
160
+ const activeCallId = this.getWebexCallingCallId();
161
+ const incomingSuffix = (0, _wxAppDiagnosticLogging.callIdSuffix)(incomingCallId);
162
+ const activeSuffix = (0, _wxAppDiagnosticLogging.callIdSuffix)(activeCallId);
163
+ if (!activeCallId || !incomingCallId.endsWith(activeCallId)) {
164
+ (0, _wxAppDiagnosticLogging.logWxAppMercuryMuteSync)({
165
+ phase: 'dropped',
166
+ muted,
167
+ callIdSuffix: incomingSuffix,
168
+ interactionId: this.data.interactionId,
169
+ dropReason: !activeCallId ? 'no_active_wxApp_call' : 'call_id_mismatch'
170
+ });
171
+ return;
172
+ }
173
+ if (this.wxAppMuted === muted) {
174
+ (0, _wxAppDiagnosticLogging.logWxAppMercuryMuteSync)({
175
+ phase: 'dropped',
176
+ muted,
177
+ callIdSuffix: incomingSuffix,
178
+ interactionId: this.data.interactionId,
179
+ dropReason: 'mute_state_unchanged'
180
+ });
181
+ return;
182
+ }
183
+ this.wxAppMuted = muted;
184
+ (0, _wxAppDiagnosticLogging.logWxAppMercuryMuteSync)({
185
+ phase: 'applied',
186
+ muted,
187
+ callIdSuffix: activeSuffix,
188
+ interactionId: this.data.interactionId
189
+ });
190
+ this.emit(_types.TASK_EVENTS.TASK_WXAPP_MUTE_STATE_UPDATED, {
191
+ muted
192
+ });
193
+ }
194
+ getWxAppMuted() {
195
+ return this.wxAppMuted;
196
+ }
197
+ static delay(ms) {
198
+ return new Promise(resolve => {
199
+ setTimeout(resolve, ms);
200
+ });
201
+ }
202
+ canRetryWxAppMuteSync() {
203
+ if (!this.enableWxBetterTogether) {
204
+ return false;
205
+ }
206
+ return Boolean((0, _wxAppVoiceMethods.getCallingDeviceDetails)(this.getWxAppVoiceDeps())?.deviceCallId) && !this.getWebexCallingCallId();
207
+ }
208
+ shouldSkipWxAppMuteSync() {
209
+ if (this.data?.interaction?.isTerminated) {
210
+ return true;
211
+ }
212
+ return this.isWebexAppCallingOffer() && !this.uiControlConfig?.wxAppAnswerPending;
213
+ }
214
+ applyWxAppMuteFromBackfill(callId, muted) {
215
+ if (!this.enableWxBetterTogether || this.wxAppMuted === muted) {
216
+ return;
217
+ }
218
+ const activeCallId = this.getWebexCallingCallId();
219
+ if (activeCallId && !callId.endsWith(activeCallId) && !activeCallId.endsWith(callId)) {
220
+ return;
221
+ }
222
+ this.wxAppMuted = muted;
223
+ this.emit(_types.TASK_EVENTS.TASK_WXAPP_MUTE_STATE_UPDATED, {
224
+ muted
225
+ });
226
+ }
227
+ async syncWxAppMuteFromCallDetails(retryAttempt = 0) {
228
+ if (!this.enableWxBetterTogether || !this.answerCallOnWebexService) {
229
+ return undefined;
230
+ }
231
+ if (retryAttempt === 0 && this.shouldSkipWxAppMuteSync()) {
232
+ return undefined;
233
+ }
234
+ if (retryAttempt === 0 && this.wxAppMuteSyncInFlight) {
235
+ return this.wxAppMuteSyncInFlight;
236
+ }
237
+ const syncPromise = this.performWxAppMuteSync(retryAttempt);
238
+ if (retryAttempt === 0) {
239
+ this.wxAppMuteSyncInFlight = syncPromise;
240
+ syncPromise.finally(() => {
241
+ if (this.wxAppMuteSyncInFlight === syncPromise) {
242
+ this.wxAppMuteSyncInFlight = undefined;
243
+ }
244
+ }).catch(() => undefined);
245
+ return syncPromise;
246
+ }
247
+ return syncPromise;
248
+ }
249
+ async performWxAppMuteSync(retryAttempt) {
250
+ if (this.shouldSkipWxAppMuteSync()) {
251
+ return undefined;
252
+ }
253
+ let callId = this.getWebexCallingCallId();
254
+ if (!callId) {
255
+ if (retryAttempt < Voice.WXAPP_MUTE_SYNC_MAX_RETRIES && this.canRetryWxAppMuteSync()) {
256
+ await Voice.delay(Voice.WXAPP_MUTE_SYNC_RETRY_DELAY_MS);
257
+ return this.performWxAppMuteSync(retryAttempt + 1);
258
+ }
259
+ callId = (0, _wxAppVoiceMethods.getCallingDeviceDetails)(this.getWxAppVoiceDeps())?.deviceCallId ?? null;
260
+ if (!callId) {
261
+ return undefined;
262
+ }
263
+ }
264
+ try {
265
+ const lineOwnerId = (0, _wxAppVoiceMethods.resolveWxAppLineOwnerId)(this.getWxAppVoiceDeps());
266
+ const details = await this.answerCallOnWebexService.getCallDetails({
267
+ callId,
268
+ lineOwnerId
269
+ });
270
+ if (details.muted !== undefined) {
271
+ this.applyWxAppMuteStateFromSync(callId, details.muted);
272
+ if (this.wxAppMuted !== details.muted) {
273
+ this.applyWxAppMuteFromBackfill(callId, details.muted);
274
+ }
275
+ return details.muted;
276
+ }
277
+ return this.wxAppMuted;
278
+ } catch (error) {
279
+ if (!(0, _wxAppTelephonyUtils.isWxAppCallNotFoundError)(error)) {
280
+ _loggerProxy.default.error(`Failed to sync wxApp mute from call details: ${error}`, {
281
+ module: _constants.CC_FILE,
282
+ method: _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX,
283
+ interactionId: this.data?.interactionId
284
+ });
285
+ }
286
+ return undefined;
287
+ }
288
+ }
289
+ onTaskAssigned() {
290
+ this.setWxAppAnswerPending(false);
291
+ queueMicrotask(() => {
292
+ this.syncWxAppMuteFromCallDetails().catch(() => undefined);
293
+ });
294
+ }
295
+ onTaskHydrated() {
296
+ const state = this.stateMachineService?.getSnapshot?.()?.value;
297
+ const answerStillPending = state === _stateMachine.TaskState.OFFERED && (this.uiControlConfig?.wxAppAcceptInFlight || this.uiControlConfig?.wxAppAnswerPending);
298
+ if (!answerStillPending) {
299
+ this.setWxAppAnswerPending(false);
300
+ }
301
+ this.syncWxAppMuteFromCallDetails().catch(() => undefined);
302
+ }
303
+ getCallingDeviceDetails() {
304
+ return (0, _wxAppVoiceMethods.getCallingDeviceDetails)(this.getWxAppVoiceDeps());
305
+ }
306
+ getWebexCallingCallId() {
307
+ return (0, _wxAppVoiceMethods.getWebexCallingCallId)(this.getWxAppVoiceDeps());
308
+ }
309
+ createWxAppLifecycle() {
310
+ return {
311
+ setWxAppAcceptInFlight: inFlight => this.setWxAppAcceptInFlight(inFlight),
312
+ setWxAppAnswerPending: pending => this.setWxAppAnswerPending(pending),
313
+ resetWxAppMuted: () => {
314
+ this.wxAppMuted = false;
315
+ },
316
+ syncWxAppMuteFromCallDetails: () => this.syncWxAppMuteFromCallDetails(),
317
+ mapWxAppVoiceError: (error, method) => (0, _wxAppVoiceMethods.mapWxAppVoiceError)(error, method, _constants.CC_FILE)
318
+ };
28
319
  }
29
320
  getStateMachineSnapshot() {
30
321
  return this.stateMachineService?.getSnapshot?.();
31
322
  }
323
+ getWxAppAcceptReasonForMetrics() {
324
+ if (this.wxAppAcceptInFlight) {
325
+ return 'wxApp_accept_in_flight';
326
+ }
327
+ if (this.wxAppAnswerPending) {
328
+ return 'wxApp_answer_pending';
329
+ }
330
+ return 'wxApp_offer_ready';
331
+ }
32
332
 
33
333
  /**
34
- * This method is used to accept the task.
35
- * It is expected to be overridden by child classes.
36
- * @returns Promise<TaskResponse>
37
- * @throws Error
334
+ * Accepts the task. Routes to wxApp telephony answer when `enableWxBetterTogether` and wxApp offer.
38
335
  */
39
336
  async accept() {
40
- super.unsupportedMethodError(_constants.METHODS.ACCEPT);
337
+ if (this.enableWxBetterTogether && this.isWebexAppCallingOffer()) {
338
+ await (0, _wxAppVoiceMethods.runWxAppAccept)(this.getWxAppVoiceDependencies(), this.createWxAppLifecycle(), {
339
+ acceptReason: this.getWxAppAcceptReasonForMetrics()
340
+ });
341
+ return Promise.resolve();
342
+ }
343
+ return super.unsupportedMethodError(_constants.METHODS.ACCEPT);
41
344
  }
42
345
 
43
346
  /**
44
- * This method is used to decline the task.
45
- * It is expected to be overridden by child classes.
46
- * @returns Promise<TaskResponse>
47
- * @throws Error
347
+ * Declines the task. Routes wxApp inbound to telephony reject; wxApp outdial offer to cancelTask.
48
348
  */
49
349
  async decline() {
50
- super.unsupportedMethodError(_constants.METHODS.REJECT);
350
+ if (this.enableWxBetterTogether && this.isWebexAppInboundCallingOffer()) {
351
+ await (0, _wxAppVoiceMethods.runWxAppReject)(this.getWxAppVoiceDependencies(), this.createWxAppLifecycle(), {
352
+ acceptReason: this.getWxAppAcceptReasonForMetrics()
353
+ });
354
+ return Promise.resolve();
355
+ }
356
+ const isOutdial = this.data?.interaction?.outboundType === 'OUTDIAL';
357
+ if (!this.enableWxBetterTogether || !isOutdial || !this.isWebexAppCallingOffer()) {
358
+ return super.unsupportedMethodError(_constants.METHODS.REJECT);
359
+ }
360
+ const interactionId = this.data.interactionId;
361
+ _loggerProxy.default.log(`Declining wxApp outdial task for taskId:${interactionId}`, {
362
+ module: _constants.CC_FILE,
363
+ method: _constants.METHODS.REJECT,
364
+ interactionId
365
+ });
366
+ try {
367
+ this.metricsManager.timeEvent([_constants2.METRIC_EVENT_NAMES.TASK_DECLINE_SUCCESS, _constants2.METRIC_EVENT_NAMES.TASK_DECLINE_FAILED]);
368
+ const declineAcceptReason = this.wxAppAnswerPending ? 'wxApp_answer_pending' : 'wxApp_offer_ready';
369
+ this.setWxAppAnswerPending(false);
370
+ const response = await (0, _wxAppVoiceMethods.runWxAppOutdialDecline)(this.getWxAppVoiceDependencies(), () => this.contact.cancelTask({
371
+ interactionId
372
+ }), {
373
+ acceptReason: declineAcceptReason
374
+ });
375
+ this.metricsManager.trackEvent(_constants2.METRIC_EVENT_NAMES.TASK_DECLINE_SUCCESS, {
376
+ taskId: interactionId,
377
+ ..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(response)
378
+ }, ['operational', 'behavioral']);
379
+ return response;
380
+ } catch (error) {
381
+ this.metricsManager.trackEvent(_constants2.METRIC_EVENT_NAMES.TASK_DECLINE_FAILED, {
382
+ taskId: interactionId,
383
+ error: error.toString(),
384
+ ..._MetricsManager.default.getCommonTrackingFieldForAQMResponseFailed(error.details || {})
385
+ }, ['operational', 'behavioral']);
386
+ const {
387
+ error: detailedError
388
+ } = (0, _Utils.getErrorDetails)(error, _constants.METHODS.REJECT, _constants.CC_FILE);
389
+ throw detailedError;
390
+ }
391
+ }
392
+
393
+ /**
394
+ * Toggles mute for wxApp engaged telephony when `enableWxBetterTogether` is active.
395
+ */
396
+ async toggleMute(options) {
397
+ if (this.enableWxBetterTogether && this.getWebexCallingCallId()) {
398
+ const togglePromise = this.wxAppMuteToggleTail.catch(() => undefined).then(() => (0, _wxAppVoiceMethods.runWxAppToggleMute)(this.getWxAppVoiceDependencies(), this.createWxAppLifecycle(), options));
399
+ this.wxAppMuteToggleTail = togglePromise.catch(() => undefined);
400
+ await togglePromise;
401
+ return;
402
+ }
403
+ super.unsupportedMethodError(_constants.METHODS.TOGGLE_MUTE);
404
+ }
405
+
406
+ /**
407
+ * Sends in-call DTMF for wxApp engaged telephony when `enableWxBetterTogether` is active.
408
+ */
409
+ async transmitDtmf(options) {
410
+ if (this.enableWxBetterTogether && this.getWebexCallingCallId()) {
411
+ const dtmfPromise = this.wxAppDtmfTail.catch(() => undefined).then(() => (0, _wxAppVoiceMethods.runWxAppTransmitDtmf)(this.getWxAppVoiceDependencies(), this.createWxAppLifecycle(), options));
412
+ this.wxAppDtmfTail = dtmfPromise.catch(() => undefined);
413
+ await dtmfPromise;
414
+ return;
415
+ }
416
+ super.unsupportedMethodError(_constants.METHODS.TRANSMIT_DTMF);
51
417
  }
52
418
 
53
419
  /**
@@ -667,6 +1033,74 @@ class Voice extends _Task.default {
667
1033
  }
668
1034
  }
669
1035
 
1036
+ /**
1037
+ * Removes another participant from an active conference.
1038
+ * Completion is correlated with ParticipantLeftConference by the AQM request layer.
1039
+ * @param payload - Participant identifier to remove
1040
+ * @returns Promise<TaskResponse>
1041
+ */
1042
+ async dropConferenceParticipant(payload) {
1043
+ // The TypeScript contract requires payload, but the published SDK is also callable from
1044
+ // untyped JavaScript. Keep an explicit runtime boundary check before direct property access.
1045
+ if (!payload) {
1046
+ throw new Error('participantId must be a non-empty string');
1047
+ }
1048
+ const {
1049
+ participantId
1050
+ } = payload;
1051
+ if (typeof participantId !== 'string' || participantId.trim().length === 0) {
1052
+ throw new Error('participantId must be a non-empty string');
1053
+ }
1054
+ const requestInteractionId = this.data.interaction?.mainInteractionId || this.data.interactionId;
1055
+ // taskId identifies the SDK task instance, which can remain child-interaction keyed after
1056
+ // consult/EP-DN flows. requestInteractionId identifies the main interaction sent to AQM.
1057
+
1058
+ _loggerProxy.default.info('Dropping conference participant', {
1059
+ module: _constants.CC_FILE,
1060
+ method: _constants.METHODS.DROP_CONFERENCE_PARTICIPANT,
1061
+ interactionId: requestInteractionId
1062
+ });
1063
+ try {
1064
+ this.metricsManager.timeEvent([_constants2.METRIC_EVENT_NAMES.TASK_CONFERENCE_PARTICIPANT_DROP_SUCCESS, _constants2.METRIC_EVENT_NAMES.TASK_CONFERENCE_PARTICIPANT_DROP_FAILED]);
1065
+ const response = await this.contact.dropConferenceParticipant({
1066
+ interactionId: requestInteractionId,
1067
+ participantId
1068
+ });
1069
+ this.metricsManager.trackEvent(_constants2.METRIC_EVENT_NAMES.TASK_CONFERENCE_PARTICIPANT_DROP_SUCCESS, {
1070
+ taskId: this.data.interactionId,
1071
+ requestInteractionId,
1072
+ ..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(response),
1073
+ agentId: this.agentId
1074
+ }, ['operational', 'behavioral', 'business']);
1075
+ _loggerProxy.default.log('Successfully dropped conference participant', {
1076
+ module: _constants.CC_FILE,
1077
+ method: _constants.METHODS.DROP_CONFERENCE_PARTICIPANT,
1078
+ trackingId: response?.trackingId,
1079
+ interactionId: requestInteractionId
1080
+ });
1081
+ return response;
1082
+ } catch (error) {
1083
+ const failureTrackingFields = _MetricsManager.default.getCommonTrackingFieldForAQMResponseFailed(error?.details || {});
1084
+ this.metricsManager.trackEvent(_constants2.METRIC_EVENT_NAMES.TASK_CONFERENCE_PARTICIPANT_DROP_FAILED, {
1085
+ taskId: this.data.interactionId,
1086
+ requestInteractionId,
1087
+ agentId: this.agentId,
1088
+ trackingId: failureTrackingFields.trackingId,
1089
+ notifTrackingId: failureTrackingFields.notifTrackingId,
1090
+ orgId: failureTrackingFields.orgId,
1091
+ failureType: failureTrackingFields.failureType,
1092
+ reasonCode: failureTrackingFields.reasonCode
1093
+ }, ['operational', 'behavioral', 'business']);
1094
+ _loggerProxy.default.error('Failed to drop conference participant', {
1095
+ module: _constants.CC_FILE,
1096
+ method: _constants.METHODS.DROP_CONFERENCE_PARTICIPANT,
1097
+ trackingId: failureTrackingFields.trackingId,
1098
+ interactionId: requestInteractionId
1099
+ });
1100
+ throw error;
1101
+ }
1102
+ }
1103
+
670
1104
  /**
671
1105
  * Exit from a conference call.
672
1106
  * Per conference-spec.md:
@@ -721,9 +1155,31 @@ class Voice extends _Task.default {
721
1155
 
722
1156
  // Send success event to transition state
723
1157
  if (this.stateMachineService) {
1158
+ const responseTaskData = response?.data ?? {};
1159
+ const snapshot = this.stateMachineService.getSnapshot();
1160
+ const wrapUpContext = snapshot?.context ?? {
1161
+ uiControlConfig: this.uiControlConfig,
1162
+ taskData: this.data
1163
+ };
1164
+ const mergedTaskData = {
1165
+ ...this.data,
1166
+ ...responseTaskData
1167
+ };
1168
+ // Pending-list precedence is response-only; do not keep a cached snapshot list.
1169
+ if (!Object.prototype.hasOwnProperty.call(responseTaskData, 'agentsPendingWrapUp')) {
1170
+ delete mergedTaskData.agentsPendingWrapUp;
1171
+ }
1172
+ let wrapUpRequired = (0, _guards.shouldWrapUpForThisAgent)(wrapUpContext, mergedTaskData);
1173
+ // Confirmed self-exit: empty/absent response pending matches TaskManager leave stamp.
1174
+ if (!wrapUpRequired && !hasNonemptyPendingWrapUp(responseTaskData)) {
1175
+ wrapUpRequired = !isConsultedNonOwner(mergedTaskData, this.data);
1176
+ }
724
1177
  this.stateMachineService.send({
725
1178
  type: _stateMachine.TaskEvent.EXIT_CONFERENCE_SUCCESS,
726
- taskData: response.data
1179
+ taskData: {
1180
+ ...responseTaskData,
1181
+ wrapUpRequired
1182
+ }
727
1183
  });
728
1184
  }
729
1185
  this.metricsManager.trackEvent(_constants2.METRIC_EVENT_NAMES.TASK_CONFERENCE_EXIT_SUCCESS, {
@@ -1031,8 +1487,12 @@ class Voice extends _Task.default {
1031
1487
  emitTaskOutdialFailed: ({
1032
1488
  event
1033
1489
  }) => {
1034
- if (event && 'taskData' in event && event.taskData) {
1035
- this.updateTaskData(event.taskData);
1490
+ const taskData = event?.taskData;
1491
+ if (taskData) {
1492
+ this.updateTaskData(taskData);
1493
+ }
1494
+ if (taskData?.suppressOutdialFailedPopup) {
1495
+ return;
1036
1496
  }
1037
1497
  const reason = event?.reason || 'Outdial failed';
1038
1498
  this.emit(_types.TASK_EVENTS.TASK_OUTDIAL_FAILED, reason);