@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
@@ -14,12 +14,17 @@ var _types3 = require("../../types");
14
14
  var _loggerProxy = _interopRequireDefault(require("../../logger-proxy"));
15
15
  var _TaskUtils = require("./TaskUtils");
16
16
  var _TaskFactory = _interopRequireDefault(require("./TaskFactory"));
17
+ var _WebexCallingUtils = require("./WebexCallingUtils");
17
18
  var _WebRTC = _interopRequireDefault(require("./voice/WebRTC"));
18
19
  var _stateMachine = require("./state-machine");
20
+ var _constants3 = require("./state-machine/constants");
19
21
  var _taskDataNormalizer = require("./taskDataNormalizer");
20
22
  function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
21
23
  const CC_EVENT_SET = new Set(Object.values(_types2.CC_EVENTS));
24
+ const MAIN_INTERACTION_CORRELATED_EVENTS = new Set([_types2.CC_EVENTS.AGENT_CONSULT_ENDED, _types2.CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE]);
22
25
  const isCcEvent = value => CC_EVENT_SET.has(value);
26
+ const WRAP_UP_STAMP_EVENTS = new Set([_types2.CC_EVENTS.AGENT_WRAPUP, _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCE_ENDED, _types2.CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE, _types2.CC_EVENTS.AGENT_CONFERENCE_TRANSFERRED]);
27
+ const PARTICIPANT_LEAVE_WRAP_STATES = new Set([_stateMachine.TaskState.HELD, _stateMachine.TaskState.RESUME_INITIATING, _stateMachine.TaskState.CONSULTING, _stateMachine.TaskState.CONSULT_INITIATING, _stateMachine.TaskState.CONFERENCING]);
23
28
 
24
29
  /** @internal */
25
30
  class TaskManager extends _events.default {
@@ -31,6 +36,11 @@ class TaskManager extends _events.default {
31
36
 
32
37
  // eslint-disable-next-line no-use-before-define
33
38
 
39
+ receivingSummaryBuffer = new Map();
40
+
41
+ // RTD feature frames can arrive before AQM creates the task.
42
+ pendingFeatureEnablement = new Map();
43
+
34
44
  /**
35
45
  * @param contact - Routing Contact layer. Talks to AQMReq layer to convert events to promises
36
46
  * @param webCallingService - Webrtc Service Layer
@@ -51,6 +61,50 @@ class TaskManager extends _events.default {
51
61
  handleRealtimeWebsocketEvent(event) {
52
62
  try {
53
63
  const payload = JSON.parse(event);
64
+ switch (payload?.type) {
65
+ case _types2.CC_TASK_EVENTS.FEATURE_ENABLEMENT:
66
+ {
67
+ const enablement = payload?.data?.data;
68
+ if (!enablement?.interactionId) return;
69
+ const task = this.taskCollection[enablement.interactionId];
70
+ if (task) {
71
+ this.pendingFeatureEnablement.delete(enablement.interactionId);
72
+ task.setFeatureEnablement?.(enablement);
73
+ task.emit(_types.TASK_EVENTS.TASK_FEATURE_ENABLEMENT, enablement);
74
+ } else {
75
+ this.pendingFeatureEnablement.set(enablement.interactionId, enablement);
76
+ }
77
+ return;
78
+ }
79
+ case _types2.CC_TASK_EVENTS.POST_CALL_SUMMARY:
80
+ case _types2.CC_TASK_EVENTS.MID_CALL_SUMMARY:
81
+ {
82
+ if (!payload?.data?.data?.conversationId) return;
83
+ this.apiAIAssistant?.resolveFromRtdEvent(payload.type, payload.data.data.conversationId, payload.data.data);
84
+ return;
85
+ }
86
+ case _types2.CC_TASK_EVENTS.MID_CALL_SUMMARY_RESPONSE_SUBSEQUENT_AGENT:
87
+ {
88
+ if (!payload?.data?.data?.conversationId) return;
89
+ const summary = payload.data.data;
90
+ const {
91
+ conversationId
92
+ } = summary;
93
+ const task = this.taskCollection[conversationId];
94
+ const taskState = task?.state?.value;
95
+
96
+ // Emit only once the task is answered; until then it waits for the answer event.
97
+ if (task && taskState !== _stateMachine.TaskState.IDLE && taskState !== _stateMachine.TaskState.OFFERED) {
98
+ this.receivingSummaryBuffer.delete(conversationId);
99
+ task.emit(_types.TASK_EVENTS.TASK_MID_CALL_SUMMARY_RECEIVED, summary);
100
+ } else {
101
+ this.receivingSummaryBuffer.set(conversationId, summary);
102
+ }
103
+ return;
104
+ }
105
+ default:
106
+ break;
107
+ }
54
108
  const interactionId = payload?.data?.data?.conversationId;
55
109
  if (!interactionId) return;
56
110
  const task = this.taskCollection[interactionId];
@@ -67,6 +121,8 @@ class TaskManager extends _events.default {
67
121
  case _types2.CC_EVENTS.SUGGESTED_RESPONSE:
68
122
  task.emit(payload.type, payload.data);
69
123
  break;
124
+ default:
125
+ break;
70
126
  }
71
127
  } catch (error) {
72
128
  _loggerProxy.default.error('Failed to parse RTD WebSocket message', {
@@ -83,6 +139,12 @@ class TaskManager extends _events.default {
83
139
  setConfigFlags(configFlags) {
84
140
  this.configFlags = configFlags;
85
141
  }
142
+ clearAISummaryState() {
143
+ this.apiAIAssistant?.clearAllRtdRequests();
144
+ Object.values(this.taskCollection).forEach(task => task.clearFeatureEnablement?.());
145
+ this.receivingSummaryBuffer.clear();
146
+ this.pendingFeatureEnablement.clear();
147
+ }
86
148
 
87
149
  /**
88
150
  * Set wrapup configuration data
@@ -97,6 +159,9 @@ class TaskManager extends _events.default {
97
159
  setAgentId(agentId) {
98
160
  this.agentId = agentId;
99
161
  }
162
+ setAgentName(agentName) {
163
+ this.agentName = agentName;
164
+ }
100
165
 
101
166
  /**
102
167
  * Gets the current agent ID
@@ -109,6 +174,9 @@ class TaskManager extends _events.default {
109
174
  setWebRtcEnabled(webRtcEnabled) {
110
175
  this.webRtcEnabled = webRtcEnabled;
111
176
  }
177
+ setAnswerCallOnWebexService(answerCallOnWebexService) {
178
+ this.answerCallOnWebexService = answerCallOnWebexService;
179
+ }
112
180
  handleIncomingWebCall = call => {
113
181
  const currentTask = Object.values(this.taskCollection).find(task => task.data.interaction.mediaType === 'telephony' && !(0, _TaskUtils.isCampaignPreviewReservation)(task));
114
182
  if (currentTask) {
@@ -134,14 +202,147 @@ class TaskManager extends _events.default {
134
202
  this.webCallingService.off(_calling.LINE_EVENTS.INCOMING_CALL, this.handleIncomingWebCall);
135
203
  }
136
204
 
205
+ /**
206
+ * True when this agent left on the current payload.
207
+ * A named other participantId is never self-leave (even if the participants
208
+ * map is partial). Missing-map fallback is EP-DN only: participantId absent
209
+ * and self omitted now, with previous-task evidence when a prior map exists.
210
+ */
211
+ static didSelfLeaveConference(payload, agentId, task) {
212
+ if (!agentId) {
213
+ return false;
214
+ }
215
+ if (payload.participantId === agentId) {
216
+ return true;
217
+ }
218
+ if (payload.participantId && payload.participantId !== agentId) {
219
+ return false;
220
+ }
221
+ const participants = payload.interaction?.participants;
222
+ if (!participants || agentId in participants) {
223
+ return false;
224
+ }
225
+ const previousParticipants = task?.data?.interaction?.participants;
226
+ if (previousParticipants && !(agentId in previousParticipants)) {
227
+ return false;
228
+ }
229
+ return true;
230
+ }
231
+
232
+ /**
233
+ * Consulted non-owner: Voice exitConference / shouldWrapUpForThisAgent stays
234
+ * false unless an explicit wrap-up signal includes this agent.
235
+ */
236
+ static isConsultedNonOwner(payload, agentId, task) {
237
+ const isConsulted = payload.isConsulted ?? task?.data?.isConsulted;
238
+ if (isConsulted !== true) {
239
+ return false;
240
+ }
241
+ const owner = payload.interaction?.owner ?? task?.data?.interaction?.owner;
242
+ return Boolean(agentId && owner && owner !== agentId);
243
+ }
244
+ static hasNonemptyPendingWrapUp(payload) {
245
+ return Array.isArray(payload.agentsPendingWrapUp) && payload.agentsPendingWrapUp.length > 0;
246
+ }
247
+
248
+ /**
249
+ * Transfer initiator fallback: widgets set transferConferenceRequested on the
250
+ * actor; desktop success payloads may include consultingAgentId. Only used
251
+ * when agentsPendingWrapUp is empty or absent.
252
+ */
253
+ static isSelfConferenceTransferInitiator(payload, agentId, task) {
254
+ const snapshotContext = task?.stateMachineService?.getSnapshot?.()?.context;
255
+ if (snapshotContext?.transferConferenceRequested === true) {
256
+ return true;
257
+ }
258
+ return Boolean(agentId && payload.consultingAgentId === agentId);
259
+ }
260
+
261
+ /**
262
+ * Explicit wrap-up signals only (no owner / isConsulted fallback).
263
+ * Used for events that remaining conference agents also receive.
264
+ * nonempty agentsPendingWrapUp is authoritative, then wrapUpRequired / isWrapUp.
265
+ */
266
+ static wrapUpRequiredFromExplicitSignals(payload, agentId) {
267
+ const pending = payload.agentsPendingWrapUp;
268
+ if (Array.isArray(pending) && pending.length > 0) {
269
+ return Boolean(agentId && pending.includes(agentId));
270
+ }
271
+ if (payload.wrapUpRequired === true) {
272
+ return true;
273
+ }
274
+ if (!agentId) {
275
+ return false;
276
+ }
277
+ return payload.interaction?.participants?.[agentId]?.isWrapUp === true;
278
+ }
279
+
280
+ /**
281
+ * Stamp wrapUpRequired once at ingress (prepareEventContext) so updateTaskData
282
+ * and the mapper see the same flag. Remaining agents stay false.
283
+ */
284
+ static stampWrapUpRequiredForEvent(eventType, payload, agentId, task) {
285
+ if (!WRAP_UP_STAMP_EVENTS.has(eventType)) {
286
+ return payload;
287
+ }
288
+ if (eventType === _types2.CC_EVENTS.AGENT_WRAPUP) {
289
+ return {
290
+ ...payload,
291
+ wrapUpRequired: true
292
+ };
293
+ }
294
+ if (eventType === _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCE_ENDED) {
295
+ return {
296
+ ...payload,
297
+ wrapUpRequired: TaskManager.wrapUpRequiredFromExplicitSignals(payload, agentId)
298
+ };
299
+ }
300
+ if (eventType === _types2.CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE) {
301
+ const actorState = task?.stateMachineService?.getSnapshot?.()?.value;
302
+ if (actorState && !PARTICIPANT_LEAVE_WRAP_STATES.has(actorState)) {
303
+ return payload;
304
+ }
305
+ const left = TaskManager.didSelfLeaveConference(payload, agentId, task);
306
+ if (!left) {
307
+ return {
308
+ ...payload,
309
+ wrapUpRequired: TaskManager.wrapUpRequiredFromExplicitSignals(payload, agentId)
310
+ };
311
+ }
312
+ if (TaskManager.hasNonemptyPendingWrapUp(payload)) {
313
+ return {
314
+ ...payload,
315
+ wrapUpRequired: Boolean(agentId && payload.agentsPendingWrapUp?.includes(agentId))
316
+ };
317
+ }
318
+ return {
319
+ ...payload,
320
+ wrapUpRequired: TaskManager.wrapUpRequiredFromExplicitSignals(payload, agentId) || !TaskManager.isConsultedNonOwner(payload, agentId, task)
321
+ };
322
+ }
323
+
324
+ // AGENT_CONFERENCE_TRANSFERRED — pending list wins; initiator only if empty/absent
325
+ if (TaskManager.hasNonemptyPendingWrapUp(payload)) {
326
+ return {
327
+ ...payload,
328
+ wrapUpRequired: TaskManager.wrapUpRequiredFromExplicitSignals(payload, agentId)
329
+ };
330
+ }
331
+ return {
332
+ ...payload,
333
+ wrapUpRequired: TaskManager.wrapUpRequiredFromExplicitSignals(payload, agentId) || TaskManager.isSelfConferenceTransferInitiator(payload, agentId, task)
334
+ };
335
+ }
336
+
137
337
  /**
138
338
  * Map WebSocket CC_EVENTS to state machine TaskEvent
139
339
  * @param ccEvent - The CC_EVENT type from WebSocket
140
340
  * @param payload - The event payload
141
341
  * @param agentId - Optional agent ID for state detection (needed for HYDRATE)
342
+ * @param task - Optional task instance for state-aware CONTACT_ENDED mapping
142
343
  * @returns TaskEventPayload for state machine or null if no mapping
143
344
  */
144
- static mapEventToTaskStateMachineEvent(ccEvent, payload, agentId) {
345
+ static mapEventToTaskStateMachineEvent(ccEvent, payload, agentId, task, enableWxBetterTogether) {
145
346
  const mediaResourceId = payload.mediaResourceId || payload.interaction?.media?.[payload.interactionId]?.mediaResourceId;
146
347
  switch (ccEvent) {
147
348
  // CC -> TaskEvent mappings (see TaskStateMachine comment for quick reference)
@@ -180,6 +381,12 @@ class TaskManager extends _events.default {
180
381
  agentId
181
382
  };
182
383
  case _types2.CC_EVENTS.CONTACT_UPDATED:
384
+ if (task && typeof payload.interaction?.owner === 'string' && payload.interaction.owner.trim().length > 0 && payload.interaction.owner !== task.data?.interaction?.owner) {
385
+ return {
386
+ type: _stateMachine.TaskEvent.CONTACT_OWNER_CHANGED,
387
+ taskData: payload
388
+ };
389
+ }
183
390
  return {
184
391
  type: _stateMachine.TaskEvent.CONTACT_UPDATED,
185
392
  taskData: payload
@@ -284,13 +491,31 @@ class TaskManager extends _events.default {
284
491
  taskData: payload
285
492
  };
286
493
  case _types2.CC_EVENTS.CONTACT_ENDED:
287
- return {
288
- type: _stateMachine.TaskEvent.CONTACT_ENDED,
289
- taskData: {
290
- ...payload,
291
- wrapUpRequired: (0, _TaskUtils.isCampaignPreviewTask)(payload) ? false : payload.agentsPendingWrapUp?.includes(agentId || '') || false
494
+ {
495
+ const wrapUpRequired = (0, _TaskUtils.isCampaignPreviewTask)(payload) ? false : payload.agentsPendingWrapUp?.includes(agentId || '') || false;
496
+
497
+ // Post-accept wxApp outdial agent-end delivers ContactEnded instead of
498
+ // AgentOutboundFailed. Normalize to OUTBOUND_FAILED so state machine
499
+ // enters WRAPPING_UP and emits TASK_OUTDIAL_FAILED (AGENT_ENDS).
500
+ // Pre-accept cancelTask decline stays CONTACT_ENDED → TERMINATED (no wrapup).
501
+ if (TaskManager.isAgentTerminatedOutdialWrapup(payload, wrapUpRequired, task, agentId, enableWxBetterTogether)) {
502
+ return {
503
+ type: _stateMachine.TaskEvent.OUTBOUND_FAILED,
504
+ reason: 'AGENT_ENDS',
505
+ taskData: {
506
+ ...payload,
507
+ wrapUpRequired: true
508
+ }
509
+ };
292
510
  }
293
- };
511
+ return {
512
+ type: _stateMachine.TaskEvent.CONTACT_ENDED,
513
+ taskData: {
514
+ ...payload,
515
+ wrapUpRequired
516
+ }
517
+ };
518
+ }
294
519
  case _types2.CC_EVENTS.AGENT_INVITE_FAILED:
295
520
  return {
296
521
  type: _stateMachine.TaskEvent.INVITE_FAILED,
@@ -308,11 +533,18 @@ class TaskManager extends _events.default {
308
533
  reason: payload.reason
309
534
  };
310
535
  case _types2.CC_EVENTS.AGENT_OUTBOUND_FAILED:
311
- return {
312
- type: _stateMachine.TaskEvent.OUTBOUND_FAILED,
313
- taskData: payload,
314
- reason: payload.reason
315
- };
536
+ {
537
+ const isAgentTerminatedOutdial = payload.interaction?.outboundType === 'OUTDIAL' && (payload.terminatingParty === 'Agent' || payload.reason === 'AGENT_ENDS');
538
+ const suppressOutdialFailedPopup = isAgentTerminatedOutdial && !TaskManager.isWxAppManagedOutdialTask(agentId, payload, task, enableWxBetterTogether);
539
+ return {
540
+ type: _stateMachine.TaskEvent.OUTBOUND_FAILED,
541
+ taskData: suppressOutdialFailedPopup ? {
542
+ ...payload,
543
+ suppressOutdialFailedPopup: true
544
+ } : payload,
545
+ reason: payload.reason
546
+ };
547
+ }
316
548
  case _types2.CC_EVENTS.CAMPAIGN_PREVIEW_ACCEPT_FAILED:
317
549
  return {
318
550
  type: _stateMachine.TaskEvent.CAMPAIGN_PREVIEW_ACCEPT_FAILED,
@@ -385,6 +617,43 @@ class TaskManager extends _events.default {
385
617
  }
386
618
  }
387
619
 
620
+ /**
621
+ * True when the current agent's task is a wxApp-managed outdial (thick-client telephony).
622
+ */
623
+ static isWxAppManagedOutdialTask(agentId, payload, task, enableWxBetterTogether) {
624
+ const wxAppEnabled = task?.uiControlConfig?.enableWxBetterTogether ?? enableWxBetterTogether ?? false;
625
+ if (!wxAppEnabled) {
626
+ return false;
627
+ }
628
+ const effectiveAgentId = agentId ?? task?.data?.agentId;
629
+ const participants = payload.interaction?.participants ?? task?.data?.interaction?.participants;
630
+ const details = (0, _WebexCallingUtils.getWebexCallingDeviceDetailsForAgent)(effectiveAgentId, participants);
631
+ return details?.deviceType === 'wxApp';
632
+ }
633
+
634
+ /**
635
+ * True when ContactEnded represents an agent-terminated wxApp outdial that should
636
+ * enter wrapup with an outdial-failed popup (legacy AgentOutboundFailed parity).
637
+ */
638
+ static isAgentTerminatedOutdialWrapup(payload, wrapUpRequired, task, agentId, enableWxBetterTogether) {
639
+ const isOutdial = payload.interaction?.outboundType === 'OUTDIAL';
640
+ const agentTerminated = payload.terminatingParty === 'Agent';
641
+ if (!isOutdial || !agentTerminated) {
642
+ return false;
643
+ }
644
+ if (!TaskManager.isWxAppManagedOutdialTask(agentId, payload, task, enableWxBetterTogether)) {
645
+ return false;
646
+ }
647
+ const wxAppAnswerPending = task?.uiControlConfig?.wxAppAnswerPending ?? false;
648
+
649
+ // Pre-accept decline: decline() clears wxAppAnswerPending; backend may still send state wrapUp.
650
+ if (!wxAppAnswerPending && !wrapUpRequired) {
651
+ return false;
652
+ }
653
+ const interactionWrapUp = payload.interaction?.state === 'wrapUp';
654
+ return wrapUpRequired || interactionWrapUp || wxAppAnswerPending;
655
+ }
656
+
388
657
  /**
389
658
  * Register WebSocket message listeners for task events
390
659
  *
@@ -430,6 +699,15 @@ class TaskManager extends _events.default {
430
699
  task.sendStateMachineEvent(stateMachineEvent);
431
700
  }
432
701
 
702
+ // A receiving summary held while the task rang is emitted right after the answer
703
+ // event above (AgentContactAssigned / AgentConsulting) has been emitted.
704
+ const bufferedSummary = this.receivingSummaryBuffer.get(task.data.interactionId);
705
+ const taskState = task.state?.value;
706
+ if (bufferedSummary && taskState !== _stateMachine.TaskState.IDLE && taskState !== _stateMachine.TaskState.OFFERED) {
707
+ this.receivingSummaryBuffer.delete(task.data.interactionId);
708
+ task.emit(_types.TASK_EVENTS.TASK_MID_CALL_SUMMARY_RECEIVED, bufferedSummary);
709
+ }
710
+
433
711
  // Emit TASK_POST_CALL_ACTIVITY for ParticipantPostCallActivity events so
434
712
  // consumers (Widgets) can detect the interaction state change to post_call.
435
713
  if (eventContext.eventType === _types2.CC_EVENTS.PARTICIPANT_POST_CALL_ACTIVITY) {
@@ -481,6 +759,7 @@ class TaskManager extends _events.default {
481
759
  const interactionId = message.data.interactionId;
482
760
  const reservationInteractionId = message.data.reservationInteractionId;
483
761
  let task = this.taskCollection[interactionId];
762
+ let ownerChangeResolvedByRelatedInteraction = false;
484
763
 
485
764
  // When a campaign preview contact is accepted, the assigned event may arrive
486
765
  // with a new interactionId while the task is stored under the original
@@ -491,8 +770,43 @@ class TaskManager extends _events.default {
491
770
  // Re-key the task under the new interaction ID and remove the old entry
492
771
  delete this.taskCollection[reservationInteractionId];
493
772
  this.taskCollection[interactionId] = task;
773
+ this.pendingFeatureEnablement.delete(reservationInteractionId);
494
774
  }
495
775
  }
776
+ if (!task && eventType === _types2.CC_EVENTS.CONTACT_OWNER_CHANGED) {
777
+ const incomingShowsCurrentAgentPromotion = Boolean(this.agentId && message.data.interaction?.owner === this.agentId && TaskManager.isParticipantActiveOnMainInteraction(message.data, this.agentId));
778
+ task = this.findUniqueTaskByRelatedInteraction(message.data, candidate => {
779
+ const currentAgentId = this.agentId || candidate.data?.agentId;
780
+ return Boolean(currentAgentId && (TaskManager.isParticipantActiveOnMainInteraction(candidate.data, currentAgentId) || incomingShowsCurrentAgentPromotion));
781
+ }, {
782
+ includeCollectionKeys: true,
783
+ includeMainCallMediaKeys: true
784
+ });
785
+ ownerChangeResolvedByRelatedInteraction = Boolean(task);
786
+ }
787
+ let ownerChangeMainInteractionId;
788
+ if (task && eventType === _types2.CC_EVENTS.CONTACT_OWNER_CHANGED) {
789
+ const taskMainInteractionId = task.data?.interaction?.mainInteractionId;
790
+ const payloadMainInteractionId = message.data.interaction?.mainInteractionId;
791
+ const hasConflictingMainInteractionIds = Boolean(taskMainInteractionId && payloadMainInteractionId && taskMainInteractionId !== payloadMainInteractionId);
792
+ // A promoted child task can retain stale embedded IDs. Prefer the
793
+ // authoritative incoming main-call identity before local snapshot IDs.
794
+ const stableMainInteractionId = payloadMainInteractionId || TaskManager.getMainCallMediaId(message.data.interaction) || TaskManager.getMainCallMediaId(task.data?.interaction) || taskMainInteractionId || message.data.interaction?.interactionId || task.data?.interaction?.interactionId || task.data?.interactionId;
795
+ const taskAtStableKey = stableMainInteractionId ? this.taskCollection[stableMainInteractionId] : undefined;
796
+ if (!stableMainInteractionId || hasConflictingMainInteractionIds || taskAtStableKey && taskAtStableKey !== task) {
797
+ _loggerProxy.default.warn('Unable to safely correlate owner change to the main interaction task', {
798
+ module: _constants.TASK_MANAGER_FILE,
799
+ method: 'prepareEventContext',
800
+ interactionId: payloadMainInteractionId || taskMainInteractionId || message.data.interactionId
801
+ });
802
+ task = undefined;
803
+ } else if (ownerChangeResolvedByRelatedInteraction) {
804
+ ownerChangeMainInteractionId = stableMainInteractionId;
805
+ }
806
+ }
807
+ if (!task && MAIN_INTERACTION_CORRELATED_EVENTS.has(eventType)) {
808
+ task = this.findUniqueTaskByRelatedInteraction(message.data);
809
+ }
496
810
  const wasConsultedTask = Boolean(task?.data?.isConsulted);
497
811
  const computeWrapUpRequired = () => {
498
812
  if (message.data.wrapUpRequired !== undefined) {
@@ -503,11 +817,23 @@ class TaskManager extends _events.default {
503
817
  }
504
818
  return !wasConsultedTask;
505
819
  };
506
- const adjustedPayload = eventType === _types2.CC_EVENTS.AGENT_CONSULT_TRANSFERRED || eventType === _types2.CC_EVENTS.AGENT_BLIND_TRANSFERRED || eventType === _types2.CC_EVENTS.AGENT_VTEAM_TRANSFERRED ? {
820
+ let adjustedPayload = eventType === _types2.CC_EVENTS.AGENT_CONSULT_TRANSFERRED || eventType === _types2.CC_EVENTS.AGENT_BLIND_TRANSFERRED || eventType === _types2.CC_EVENTS.AGENT_VTEAM_TRANSFERRED ? {
507
821
  ...message.data,
508
822
  wrapUpRequired: computeWrapUpRequired()
509
823
  } : message.data;
510
- const stateMachineEvent = TaskManager.mapEventToTaskStateMachineEvent(eventType, adjustedPayload, this.agentId);
824
+ if (task && ownerChangeMainInteractionId) {
825
+ adjustedPayload = {
826
+ ...adjustedPayload,
827
+ interactionId: ownerChangeMainInteractionId
828
+ };
829
+ }
830
+ if (task && eventType === _types2.CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE) {
831
+ adjustedPayload = TaskManager.preserveConfirmedOwner(task, adjustedPayload);
832
+ }
833
+ if (WRAP_UP_STAMP_EVENTS.has(eventType)) {
834
+ adjustedPayload = TaskManager.stampWrapUpRequiredForEvent(eventType, adjustedPayload, this.agentId, task);
835
+ }
836
+ const stateMachineEvent = TaskManager.mapEventToTaskStateMachineEvent(eventType, adjustedPayload, this.agentId, task, this.configFlags?.enableWxBetterTogether);
511
837
  _loggerProxy.default.info(`Handling task event ${eventType}`, {
512
838
  module: _constants.TASK_MANAGER_FILE,
513
839
  method: 'prepareEventContext',
@@ -520,6 +846,83 @@ class TaskManager extends _events.default {
520
846
  stateMachineEvent
521
847
  };
522
848
  }
849
+ static isParticipantActiveOnMainInteraction(taskData, participantId) {
850
+ const interaction = taskData?.interaction;
851
+ const participant = interaction?.participants?.[participantId];
852
+ if (!participant || participant.hasLeft === true) return false;
853
+ return Object.values(interaction?.media ?? {}).some(media => media?.mType === _constants3.MEDIA_TYPE_MAIN_CALL && media.participants?.includes(participantId));
854
+ }
855
+ static getMainCallMediaId(interaction) {
856
+ return Object.entries(interaction?.media ?? {}).find(([, media]) => media?.mType === _constants3.MEDIA_TYPE_MAIN_CALL)?.[0];
857
+ }
858
+ static getStableMainInteractionId(payload) {
859
+ return payload.interaction?.mainInteractionId || TaskManager.getMainCallMediaId(payload.interaction) || payload.interaction?.interactionId || payload.interactionId;
860
+ }
861
+ canRecoverTaskFromContactOwnerChanged(payload) {
862
+ const interaction = payload.interaction;
863
+ const stableInteractionId = TaskManager.getStableMainInteractionId(payload);
864
+ return Boolean(this.agentId && stableInteractionId && interaction?.mediaType === _types.MEDIA_CHANNEL.TELEPHONY && interaction.isTerminated !== true && interaction.owner === this.agentId && TaskManager.isParticipantActiveOnMainInteraction(payload, this.agentId));
865
+ }
866
+
867
+ /**
868
+ * ParticipantLeftConference may arrive after an owner update while still carrying
869
+ * the departed owner. Keep the confirmed owner only when the new roster proves that
870
+ * owner is active on mainCall and identifies the incoming owner as departed.
871
+ */
872
+ static preserveConfirmedOwner(task, payload) {
873
+ const confirmedOwner = task.data?.interaction?.owner;
874
+ const incomingOwner = payload.interaction?.owner;
875
+ if (!confirmedOwner || !incomingOwner || confirmedOwner === incomingOwner) {
876
+ return payload;
877
+ }
878
+ const confirmedOwnerIsActive = TaskManager.isParticipantActiveOnMainInteraction(payload, confirmedOwner);
879
+ const incomingOwnerIsExplicitlyDeparted = payload.participantId === incomingOwner || payload.interaction?.participants?.[incomingOwner]?.hasLeft === true;
880
+ if (!confirmedOwnerIsActive || !incomingOwnerIsExplicitlyDeparted) {
881
+ return payload;
882
+ }
883
+ return {
884
+ ...payload,
885
+ owner: confirmedOwner,
886
+ interaction: {
887
+ ...payload.interaction,
888
+ owner: confirmedOwner
889
+ }
890
+ };
891
+ }
892
+
893
+ /**
894
+ * Resolve lifecycle events that are emitted for the main interaction while the
895
+ * local task can still be indexed by a child consult interaction. Exact task
896
+ * keys are handled before this fallback. Multiple aliases of the same task are
897
+ * treated as one candidate; genuinely ambiguous matches are intentionally ignored.
898
+ */
899
+ findUniqueTaskByRelatedInteraction(payload, candidateFilter = () => true, options = {}) {
900
+ const candidates = this.findRelatedTasks(payload, options).filter(candidateFilter);
901
+ if (candidates.length === 1) {
902
+ return candidates[0];
903
+ }
904
+ if (candidates.length > 1) {
905
+ _loggerProxy.default.warn('Unable to correlate task event to a unique main interaction task', {
906
+ module: _constants.TASK_MANAGER_FILE,
907
+ method: 'findUniqueTaskByRelatedInteraction',
908
+ interactionId: payload.interaction?.mainInteractionId || payload.interaction?.parentInteractionId || payload.interaction?.callProcessingDetails?.parentInteractionId || payload.interactionId
909
+ });
910
+ }
911
+ return undefined;
912
+ }
913
+ findRelatedTasks(payload, options = {}) {
914
+ const {
915
+ includeCollectionKeys = false,
916
+ includeMainCallMediaKeys = false
917
+ } = options;
918
+ const payloadInteractionIds = new Set([payload.interactionId, payload.interaction?.interactionId, payload.interaction?.mainInteractionId, payload.interaction?.parentInteractionId, payload.interaction?.callProcessingDetails?.parentInteractionId, ...(includeMainCallMediaKeys ? [TaskManager.getMainCallMediaId(payload.interaction)] : [])].filter(relatedInteractionId => Boolean(relatedInteractionId)));
919
+ if (payloadInteractionIds.size === 0) return [];
920
+ return [...new Set(Object.entries(this.taskCollection).filter(([taskId, candidate]) => {
921
+ const taskInteraction = candidate?.data?.interaction;
922
+ const candidateInteractionIds = [...(includeCollectionKeys ? [taskId] : []), candidate?.data?.interactionId, taskInteraction?.interactionId, taskInteraction?.mainInteractionId, taskInteraction?.parentInteractionId, taskInteraction?.callProcessingDetails?.parentInteractionId, ...(includeMainCallMediaKeys ? [TaskManager.getMainCallMediaId(taskInteraction)] : [])];
923
+ return candidateInteractionIds.some(relatedInteractionId => Boolean(relatedInteractionId) && payloadInteractionIds.has(relatedInteractionId));
924
+ }).map(([, candidate]) => candidate))];
925
+ }
523
926
 
524
927
  /**
525
928
  * Handle task lifecycle events and determine required actions
@@ -544,6 +947,8 @@ class TaskManager extends _events.default {
544
947
  return this.handleAgentContact(context);
545
948
  case _types2.CC_EVENTS.CONTACT_MERGED:
546
949
  return this.handleContactMergedEvent(context);
950
+ case _types2.CC_EVENTS.CONTACT_OWNER_CHANGED:
951
+ return this.handleContactOwnerChanged(context);
547
952
  case _types2.CC_EVENTS.AGENT_OFFER_CAMPAIGN_RESERVATION:
548
953
  return this.handleCampaignPreviewReservation(context);
549
954
  case _types2.CC_EVENTS.CAMPAIGN_CONTACT_UPDATED:
@@ -554,6 +959,63 @@ class TaskManager extends _events.default {
554
959
  };
555
960
  }
556
961
  }
962
+
963
+ /**
964
+ * Recover the promoted agent's active voice task when local task state was lost.
965
+ * Existing related tasks are never replaced: an unresolved or ambiguous relation
966
+ * is safer to ignore than to create a duplicate task.
967
+ */
968
+ handleContactOwnerChanged(context) {
969
+ if (context.task) {
970
+ return {
971
+ task: context.task
972
+ };
973
+ }
974
+ const {
975
+ payload
976
+ } = context;
977
+ if (this.findRelatedTasks(payload, {
978
+ includeCollectionKeys: true,
979
+ includeMainCallMediaKeys: true
980
+ }).length > 0 || !this.canRecoverTaskFromContactOwnerChanged(payload)) {
981
+ return {};
982
+ }
983
+ const stableInteractionId = TaskManager.getStableMainInteractionId(payload);
984
+ if (!stableInteractionId || this.taskCollection[stableInteractionId]) {
985
+ return {};
986
+ }
987
+ const normalizedPayload = payload.interactionId === stableInteractionId ? payload : {
988
+ ...payload,
989
+ interactionId: stableInteractionId
990
+ };
991
+ const taskData = {
992
+ ...normalizedPayload,
993
+ owner: normalizedPayload.interaction.owner,
994
+ wrapUpRequired: normalizedPayload.interaction.participants?.[this.agentId]?.isWrapUp || false,
995
+ isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(normalizedPayload),
996
+ isConsulted: false,
997
+ isAutoAnswering: false
998
+ };
999
+ const task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId, this.agentName, this.answerCallOnWebexService, this.apiAIAssistant);
1000
+ this.taskCollection[stableInteractionId] = task;
1001
+
1002
+ // Restore the actor before installing listeners so the internal hydrate does
1003
+ // not leak as a second public hydrate or as an incoming-task notification.
1004
+ task.sendStateMachineEvent({
1005
+ type: _stateMachine.TaskEvent.HYDRATE,
1006
+ taskData,
1007
+ agentId: this.agentId
1008
+ });
1009
+ this.setupTaskListeners(task);
1010
+ context.payload = taskData;
1011
+ context.stateMachineEvent = {
1012
+ type: _stateMachine.TaskEvent.CONTACT_OWNER_CHANGED,
1013
+ taskData
1014
+ };
1015
+ return {
1016
+ task
1017
+ };
1018
+ }
557
1019
  handleCampaignContactUpdated(context) {
558
1020
  const {
559
1021
  payload
@@ -638,7 +1100,7 @@ class TaskManager extends _events.default {
638
1100
  wrapUpRequired: false,
639
1101
  isConferenceInProgress: false,
640
1102
  isAutoAnswering: false
641
- }, this.configFlags, this.wrapupData, this.agentId);
1103
+ }, this.configFlags, this.wrapupData, this.agentId, this.agentName, this.answerCallOnWebexService, this.apiAIAssistant);
642
1104
  this.setupTaskListeners(task);
643
1105
  this.taskCollection[payload.interactionId] = task;
644
1106
  } else {
@@ -664,7 +1126,7 @@ class TaskManager extends _events.default {
664
1126
  isConsulted: isConsultedTask,
665
1127
  isAutoAnswering: shouldAutoAnswer
666
1128
  };
667
- const task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId);
1129
+ const task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId, this.agentName, this.answerCallOnWebexService, this.apiAIAssistant);
668
1130
  this.setupTaskListeners(task);
669
1131
  this.taskCollection[payload.interactionId] = task;
670
1132
  return {
@@ -693,7 +1155,7 @@ class TaskManager extends _events.default {
693
1155
  isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(payload),
694
1156
  isAutoAnswering: shouldAutoAnswer
695
1157
  };
696
- task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId);
1158
+ task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId, this.agentName, this.answerCallOnWebexService, this.apiAIAssistant);
697
1159
  this.setupTaskListeners(task);
698
1160
  this.taskCollection[payload.interactionId] = task;
699
1161
  }
@@ -713,7 +1175,19 @@ class TaskManager extends _events.default {
713
1175
  destinationType: taskData.destinationType ?? snapshot?.context?.consultDestinationType ?? null
714
1176
  } : taskData;
715
1177
  task.updateTaskData(updateTaskData);
1178
+
1179
+ // A main-interaction lifecycle event can re-key a child consult task. Remove
1180
+ // any aliases first so consumers never observe duplicate task entries.
1181
+ Object.entries(this.taskCollection).forEach(([taskId, candidate]) => {
1182
+ if (candidate === task && taskId !== taskData.interactionId) {
1183
+ delete this.taskCollection[taskId];
1184
+ }
1185
+ });
716
1186
  this.taskCollection[taskData.interactionId] = task;
1187
+ const enablement = this.pendingFeatureEnablement.get(task.data.interactionId);
1188
+ if (enablement) {
1189
+ task.setFeatureEnablement?.(enablement);
1190
+ }
717
1191
  return task;
718
1192
  }
719
1193
 
@@ -722,28 +1196,31 @@ class TaskManager extends _events.default {
722
1196
  * This replaces the previous callback injection pattern
723
1197
  */
724
1198
  setupTaskListeners(task) {
725
- // Listen for TASK_INCOMING and re-emit so webex.cc can notify consumers
726
- task.on(_types.TASK_EVENTS.TASK_INCOMING, t => {
727
- _loggerProxy.default.log(`Task incoming event received`, {
728
- module: _constants.TASK_MANAGER_FILE,
729
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
730
- interactionId: t.data?.interactionId
731
- });
732
- this.emit(_types.TASK_EVENTS.TASK_INCOMING, t);
733
- });
734
- task.on(_types.TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION, t => {
735
- _loggerProxy.default.log(`Campaign preview reservation event received`, {
736
- module: _constants.TASK_MANAGER_FILE,
737
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
738
- interactionId: t.data?.interactionId
739
- });
740
- this.emit(_types.TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION, t);
741
- });
1199
+ // Apply flags before publication; retain the frame until consumers can attach listeners.
1200
+ const enablement = this.pendingFeatureEnablement.get(task.data.interactionId);
1201
+ if (enablement) {
1202
+ task.setFeatureEnablement?.(enablement);
1203
+ }
1204
+ [_types.TASK_EVENTS.TASK_INCOMING, _types.TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION, _types.TASK_EVENTS.TASK_HYDRATE, _types.TASK_EVENTS.TASK_ASSIGNED].forEach(eventName => {
1205
+ task.on(eventName, t => {
1206
+ if (eventName === _types.TASK_EVENTS.TASK_INCOMING || eventName === _types.TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION) {
1207
+ _loggerProxy.default.log(eventName === _types.TASK_EVENTS.TASK_INCOMING ? 'Task incoming event received' : 'Campaign preview reservation event received', {
1208
+ module: _constants.TASK_MANAGER_FILE,
1209
+ method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
1210
+ interactionId: t.data?.interactionId
1211
+ });
1212
+ }
742
1213
 
743
- // Listen for TASK_HYDRATE on the task and re-emit on TaskManager
744
- task.on(_types.TASK_EVENTS.TASK_HYDRATE, t => {
745
- // Task data is already updated by the task itself before emitting
746
- this.emit(_types.TASK_EVENTS.TASK_HYDRATE, t);
1214
+ // Assignment is already emitted on the task; the other events publish it to consumers.
1215
+ if (eventName !== _types.TASK_EVENTS.TASK_ASSIGNED) {
1216
+ this.emit(eventName, t);
1217
+ }
1218
+ const pendingEnablement = this.pendingFeatureEnablement.get(task.data.interactionId);
1219
+ if (pendingEnablement) {
1220
+ this.pendingFeatureEnablement.delete(task.data.interactionId);
1221
+ task.emit(_types.TASK_EVENTS.TASK_FEATURE_ENABLEMENT, pendingEnablement);
1222
+ }
1223
+ });
747
1224
  });
748
1225
  task.on(_types.TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, t => {
749
1226
  this.emit(_types.TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, t);
@@ -753,19 +1230,29 @@ class TaskManager extends _events.default {
753
1230
  task.on(_types.TASK_EVENTS.TASK_CLEANUP, (t, options) => {
754
1231
  this.handleTaskCleanup(t);
755
1232
  if (options?.removeFromCollection) {
756
- const interactionId = t?.data?.interactionId;
757
- if (interactionId && this.taskCollection[interactionId]) {
1233
+ const taskIsStillCollected = Object.values(this.taskCollection).some(candidate => candidate === t);
1234
+ if (taskIsStillCollected) {
758
1235
  this.removeTaskFromCollection(t);
759
1236
  }
760
1237
  }
761
1238
  });
762
1239
  }
763
1240
  removeTaskFromCollection(task) {
1241
+ task.clearFeatureEnablement?.();
1242
+ task.disposeWxAppOfferObservability?.();
764
1243
  if (typeof task.cancelAutoWrapupTimer === 'function') {
765
1244
  task.cancelAutoWrapupTimer();
766
1245
  }
767
1246
  if (task?.data?.interactionId) {
768
- delete this.taskCollection[task.data.interactionId];
1247
+ this.pendingFeatureEnablement.delete(task.data.interactionId);
1248
+ // An offer that ends unanswered (RONA, declined, consult cancelled) is removed here,
1249
+ // so its held receiving summary is dropped instead of being emitted.
1250
+ this.receivingSummaryBuffer.delete(task.data.interactionId);
1251
+ Object.entries(this.taskCollection).forEach(([taskId, candidate]) => {
1252
+ if (candidate === task) {
1253
+ delete this.taskCollection[taskId];
1254
+ }
1255
+ });
769
1256
  _loggerProxy.default.info(`Task removed from collection`, {
770
1257
  module: _constants.TASK_MANAGER_FILE,
771
1258
  method: _constants2.METHODS.REMOVE_TASK_FROM_COLLECTION,
@@ -810,7 +1297,7 @@ class TaskManager extends _events.default {
810
1297
  isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(payload),
811
1298
  isConsulted: false
812
1299
  };
813
- task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId);
1300
+ task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId, this.agentName, this.answerCallOnWebexService, this.apiAIAssistant);
814
1301
  this.taskCollection[payload.interactionId] = task;
815
1302
 
816
1303
  // Transition the new task out of IDLE immediately so UI controls are
@@ -827,6 +1314,11 @@ class TaskManager extends _events.default {
827
1314
  }
828
1315
  if (task) {
829
1316
  this.emit(_types.TASK_EVENTS.TASK_MERGED, task);
1317
+ const enablement = this.pendingFeatureEnablement.get(task.data.interactionId);
1318
+ if (enablement) {
1319
+ this.pendingFeatureEnablement.delete(task.data.interactionId);
1320
+ task.emit(_types.TASK_EVENTS.TASK_FEATURE_ENABLEMENT, enablement);
1321
+ }
830
1322
  }
831
1323
  return {
832
1324
  task
@@ -884,6 +1376,62 @@ class TaskManager extends _events.default {
884
1376
  ...this.taskCollection
885
1377
  };
886
1378
  }
1379
+
1380
+ /**
1381
+ * Propagate runtime enableWxBetterTogether changes to config flags and active tasks.
1382
+ */
1383
+ applyEnableWxBetterTogether(enabled) {
1384
+ if (this.configFlags) {
1385
+ this.configFlags = {
1386
+ ...this.configFlags,
1387
+ enableWxBetterTogether: enabled
1388
+ };
1389
+ }
1390
+ Object.values(this.taskCollection).forEach(task => {
1391
+ task.setEnableWxBetterTogether(enabled);
1392
+ if (enabled) {
1393
+ TaskManager.syncWxAppMuteFromCallDetailsForTask(task);
1394
+ }
1395
+ });
1396
+ }
1397
+
1398
+ /**
1399
+ * Propagate wxApp mute state from Mercury sync to active voice tasks.
1400
+ */
1401
+ applyWxAppMuteStateFromSync(callId, muted) {
1402
+ Object.values(this.taskCollection).forEach(task => {
1403
+ task.applyWxAppMuteStateFromSync(callId, muted);
1404
+ });
1405
+ }
1406
+
1407
+ /**
1408
+ * Re-seeds wxApp mute state from GET telephony/calls/{callId} for one task.
1409
+ */
1410
+ static syncWxAppMuteFromCallDetailsForTask(task) {
1411
+ const sync = task.syncWxAppMuteFromCallDetails?.bind(task);
1412
+ if (typeof sync === 'function') {
1413
+ sync().catch(() => undefined);
1414
+ }
1415
+ }
1416
+
1417
+ /**
1418
+ * Re-seeds wxApp mute for all engaged voice tasks (reload / runtime enable backfill).
1419
+ */
1420
+ syncWxAppMuteFromCallDetailsForAllTasks() {
1421
+ Object.values(this.taskCollection).forEach(task => {
1422
+ TaskManager.syncWxAppMuteFromCallDetailsForTask(task);
1423
+ });
1424
+ }
1425
+
1426
+ /**
1427
+ * Re-run OFFERED wxApp offer diagnostics for collected voice tasks.
1428
+ * Used after usersub publish so pre-publish offers can schedule mismatch grace.
1429
+ */
1430
+ refreshWxAppOfferObservabilityForAllTasks() {
1431
+ Object.values(this.taskCollection).forEach(task => {
1432
+ task.refreshWxAppOfferObservability?.();
1433
+ });
1434
+ }
887
1435
  static getTaskManager(apiAIAssistant, contact, webCallingService, webSocketManager, rtdWebSocketManager) {
888
1436
  if (!TaskManager.taskManager) {
889
1437
  TaskManager.taskManager = new TaskManager(apiAIAssistant, contact, webCallingService, webSocketManager, rtdWebSocketManager);