@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
@@ -49,12 +49,42 @@ function getTaskStateMachineConfig(uiControlConfig) {
49
49
  * AgentContactHeld -> TaskEvent.HOLD_SUCCESS
50
50
  * AgentContactUnheld -> TaskEvent.UNHOLD_SUCCESS
51
51
  * AgentConsultEnded -> TaskEvent.CONSULT_END
52
+ * ParticipantLeftConference -> TaskEvent.PARTICIPANT_LEAVE
52
53
  * AgentContactEnded -> TaskEvent.CONTACT_ENDED
53
54
  * AgentWrapup -> TaskEvent.TASK_WRAPUP (wrapUpRequired)
54
55
  * AgentWrappedup -> TaskEvent.WRAPUP_COMPLETE
55
56
  *
56
57
  * (See TaskManager.mapEventToTaskStateMachineEvent for the full mapping table.)
57
58
  */
59
+ // XState evaluates these guarded transition arrays in order. Each returned entry is a
60
+ // complete transition with its own target and actions; sharing them keeps lifecycle-event
61
+ // handling consistent across active states where ParticipantLeftConference can arrive.
62
+ const currentAgentParticipantLeaveTransitions = () => [{
63
+ guard: params => _guards.guards.didCurrentAgentLeaveMainInteraction(params) && _guards.guards.shouldWrapUp(params),
64
+ target: _constants.TaskState.WRAPPING_UP,
65
+ actions: ['updateTaskData', 'handleParticipantLeft', 'markEnded', 'clearConsultState', 'emitTaskParticipantLeft']
66
+ }, {
67
+ guard: _guards.guards.didCurrentAgentLeaveMainInteraction,
68
+ target: _constants.TaskState.TERMINATED,
69
+ actions: ['updateTaskData', 'handleParticipantLeft', 'markEnded', 'clearConsultState', 'emitTaskParticipantLeft', 'emitTaskEnd']
70
+ }];
71
+ const exitConferenceSuccessTransitions = () => [{
72
+ guard: _guards.guards.shouldWrapUp,
73
+ target: _constants.TaskState.WRAPPING_UP,
74
+ actions: ['updateTaskData', 'markEnded', 'clearConsultState']
75
+ }, {
76
+ target: _constants.TaskState.TERMINATED,
77
+ actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'emitTaskEnd']
78
+ }];
79
+ const currentAgentConsultEndTransitions = () => [{
80
+ guard: params => _guards.guards.didCurrentAgentLeaveMainInteraction(params) && _guards.guards.shouldWrapUp(params),
81
+ target: _constants.TaskState.WRAPPING_UP,
82
+ actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'emitTaskConsultEnd', 'emitTaskWrapup']
83
+ }, {
84
+ guard: _guards.guards.didCurrentAgentLeaveMainInteraction,
85
+ target: _constants.TaskState.TERMINATED,
86
+ actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'emitTaskConsultEnd', 'emitTaskEnd']
87
+ }];
58
88
  return {
59
89
  id: 'taskStateMachine',
60
90
  initial: _constants.TaskState.IDLE,
@@ -67,7 +97,7 @@ function getTaskStateMachineConfig(uiControlConfig) {
67
97
  actions: ['updateTaskData', 'syncTaskDataFromEvent']
68
98
  },
69
99
  [_constants.TaskEvent.CONTACT_OWNER_CHANGED]: {
70
- actions: ['updateTaskData', 'syncTaskDataFromEvent']
100
+ actions: ['updateTaskData', 'syncTaskDataFromEvent', 'emitTaskHydrate']
71
101
  },
72
102
  // HYDRATE: Update task data from AgentContact event
73
103
  // Note: State restoration with transitions is handled in IDLE state.
@@ -162,10 +192,14 @@ function getTaskStateMachineConfig(uiControlConfig) {
162
192
  target: _constants.TaskState.TERMINATED,
163
193
  actions: ['updateTaskData', 'markEnded', 'emitTaskReject']
164
194
  },
165
- [_constants.TaskEvent.TASK_WRAPUP]: {
195
+ [_constants.TaskEvent.TASK_WRAPUP]: [{
196
+ guard: _guards.guards.shouldWrapUp,
197
+ target: _constants.TaskState.WRAPPING_UP,
198
+ actions: ['updateTaskData', 'markEnded']
199
+ }, {
166
200
  target: _constants.TaskState.TERMINATED,
167
201
  actions: ['updateTaskData', 'markEnded', 'emitTaskEnd']
168
- },
202
+ }],
169
203
  [_constants.TaskEvent.CONTACT_ENDED]: {
170
204
  target: _constants.TaskState.TERMINATED,
171
205
  actions: ['updateTaskData', 'markEnded', 'emitTaskEnd']
@@ -278,7 +312,7 @@ function getTaskStateMachineConfig(uiControlConfig) {
278
312
  actions: ['updateTaskData']
279
313
  },
280
314
  // AgentConsultEnded from Stable Prod while on connected leg (external end consult).
281
- [_constants.TaskEvent.CONSULT_END]: [{
315
+ [_constants.TaskEvent.CONSULT_END]: [...currentAgentConsultEndTransitions(), {
282
316
  guard: ({
283
317
  context,
284
318
  event
@@ -319,14 +353,23 @@ function getTaskStateMachineConfig(uiControlConfig) {
319
353
  }],
320
354
  [_constants.TaskEvent.TASK_WRAPUP]: {
321
355
  target: _constants.TaskState.WRAPPING_UP,
322
- actions: ['updateTaskData', 'markEnded', 'emitTaskWrapup']
356
+ actions: ['updateTaskData', 'markEnded']
323
357
  },
358
+ [_constants.TaskEvent.OUTBOUND_FAILED]: [{
359
+ guard: _guards.guards.shouldWrapUp,
360
+ target: _constants.TaskState.WRAPPING_UP,
361
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskWrapup']
362
+ }, {
363
+ target: _constants.TaskState.TERMINATED,
364
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskEnd']
365
+ }],
324
366
  [_constants.TaskEvent.PAUSE_RECORDING]: {
325
367
  actions: ['updateTaskData', 'setRecordingState', 'emitTaskRecordingPaused']
326
368
  },
327
369
  [_constants.TaskEvent.RESUME_RECORDING]: {
328
370
  actions: ['updateTaskData', 'setRecordingState', 'emitTaskRecordingResumed']
329
- }
371
+ },
372
+ [_constants.TaskEvent.EXIT_CONFERENCE_SUCCESS]: exitConferenceSuccessTransitions()
330
373
  }
331
374
  },
332
375
  [_constants.TaskState.HOLD_INITIATING]: {
@@ -340,6 +383,18 @@ function getTaskStateMachineConfig(uiControlConfig) {
340
383
  [_constants.TaskEvent.HOLD_FAILED]: {
341
384
  target: _constants.TaskState.CONNECTED,
342
385
  actions: ['updateTaskData']
386
+ },
387
+ [_constants.TaskEvent.OUTBOUND_FAILED]: [{
388
+ guard: _guards.guards.shouldWrapUp,
389
+ target: _constants.TaskState.WRAPPING_UP,
390
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskWrapup']
391
+ }, {
392
+ target: _constants.TaskState.TERMINATED,
393
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskEnd']
394
+ }],
395
+ [_constants.TaskEvent.TASK_WRAPUP]: {
396
+ target: _constants.TaskState.WRAPPING_UP,
397
+ actions: ['updateTaskData', 'markEnded']
343
398
  }
344
399
  }
345
400
  },
@@ -406,14 +461,26 @@ function getTaskStateMachineConfig(uiControlConfig) {
406
461
  actions: ['updateTaskData', 'markEnded', 'emitTaskEnd']
407
462
  }],
408
463
  // AgentConsultEnded from Stable Prod while main leg is held (external end consult).
409
- [_constants.TaskEvent.CONSULT_END]: {
464
+ [_constants.TaskEvent.CONSULT_END]: [...currentAgentConsultEndTransitions(), {
410
465
  actions: ['updateTaskData', 'clearConsultState', 'emitTaskConsultEnd']
411
- },
466
+ }],
467
+ [_constants.TaskEvent.PARTICIPANT_LEAVE]: [...currentAgentParticipantLeaveTransitions(), {
468
+ actions: ['updateTaskData', 'handleParticipantLeft', 'emitTaskParticipantLeft']
469
+ }],
412
470
  // TODO: This may not be a valid transition, this needs to be checked as well
413
471
  [_constants.TaskEvent.TASK_WRAPUP]: {
414
472
  target: _constants.TaskState.WRAPPING_UP,
415
- actions: ['updateTaskData', 'markEnded', 'emitTaskWrapup']
416
- }
473
+ actions: ['updateTaskData', 'markEnded']
474
+ },
475
+ [_constants.TaskEvent.OUTBOUND_FAILED]: [{
476
+ guard: _guards.guards.shouldWrapUp,
477
+ target: _constants.TaskState.WRAPPING_UP,
478
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskWrapup']
479
+ }, {
480
+ target: _constants.TaskState.TERMINATED,
481
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskEnd']
482
+ }],
483
+ [_constants.TaskEvent.EXIT_CONFERENCE_SUCCESS]: exitConferenceSuccessTransitions()
417
484
  }
418
485
  },
419
486
  [_constants.TaskState.RESUME_INITIATING]: {
@@ -424,6 +491,21 @@ function getTaskStateMachineConfig(uiControlConfig) {
424
491
  },
425
492
  [_constants.TaskEvent.UNHOLD_FAILED]: {
426
493
  target: _constants.TaskState.HELD
494
+ },
495
+ [_constants.TaskEvent.PARTICIPANT_LEAVE]: [...currentAgentParticipantLeaveTransitions(), {
496
+ actions: ['updateTaskData', 'handleParticipantLeft', 'emitTaskParticipantLeft']
497
+ }],
498
+ [_constants.TaskEvent.OUTBOUND_FAILED]: [{
499
+ guard: _guards.guards.shouldWrapUp,
500
+ target: _constants.TaskState.WRAPPING_UP,
501
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskWrapup']
502
+ }, {
503
+ target: _constants.TaskState.TERMINATED,
504
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskEnd']
505
+ }],
506
+ [_constants.TaskEvent.TASK_WRAPUP]: {
507
+ target: _constants.TaskState.WRAPPING_UP,
508
+ actions: ['updateTaskData', 'markEnded']
427
509
  }
428
510
  }
429
511
  },
@@ -473,14 +555,29 @@ function getTaskStateMachineConfig(uiControlConfig) {
473
555
  actions: ['updateTaskData', 'clearConsultState']
474
556
  }],
475
557
  // AgentConsultEnded from Stable Prod during consult initiation (external end consult).
476
- [_constants.TaskEvent.CONSULT_END]: [{
558
+ [_constants.TaskEvent.CONSULT_END]: [...currentAgentConsultEndTransitions(), {
477
559
  guard: _guards.guards.isPrimaryMediaOnHold,
478
560
  target: _constants.TaskState.HELD,
479
561
  actions: ['updateTaskData', 'clearConsultState', 'emitTaskConsultEnd']
480
562
  }, {
481
563
  target: _constants.TaskState.CONNECTED,
482
564
  actions: ['updateTaskData', 'clearConsultState', 'emitTaskConsultEnd']
483
- }]
565
+ }],
566
+ [_constants.TaskEvent.PARTICIPANT_LEAVE]: [...currentAgentParticipantLeaveTransitions(), {
567
+ actions: ['updateTaskData', 'handleParticipantLeft', 'emitTaskParticipantLeft']
568
+ }],
569
+ [_constants.TaskEvent.OUTBOUND_FAILED]: [{
570
+ guard: _guards.guards.shouldWrapUp,
571
+ target: _constants.TaskState.WRAPPING_UP,
572
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskWrapup']
573
+ }, {
574
+ target: _constants.TaskState.TERMINATED,
575
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskEnd']
576
+ }],
577
+ [_constants.TaskEvent.TASK_WRAPUP]: {
578
+ target: _constants.TaskState.WRAPPING_UP,
579
+ actions: ['updateTaskData', 'markEnded']
580
+ }
484
581
  }
485
582
  },
486
583
  [_constants.TaskState.CONSULTING]: {
@@ -510,7 +607,7 @@ function getTaskStateMachineConfig(uiControlConfig) {
510
607
  actions: ['updateTaskData', 'handleConsultFailed']
511
608
  }],
512
609
  // AgentConsultEnded
513
- [_constants.TaskEvent.CONSULT_END]: [{
610
+ [_constants.TaskEvent.CONSULT_END]: [...currentAgentConsultEndTransitions(), {
514
611
  // Initiator returning to conference only while conference is still active.
515
612
  guard: ({
516
613
  context,
@@ -581,7 +678,7 @@ function getTaskStateMachineConfig(uiControlConfig) {
581
678
  }, {
582
679
  // Consulted agent → TERMINATED
583
680
  target: _constants.TaskState.TERMINATED,
584
- actions: ['updateTaskData']
681
+ actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'emitTaskConsultEnd', 'emitTaskEnd']
585
682
  }],
586
683
  // Switch between consult and main call (UI-driven toggle)
587
684
  [_constants.TaskEvent.SWITCH_TO_MAIN_CALL]: {
@@ -596,16 +693,8 @@ function getTaskStateMachineConfig(uiControlConfig) {
596
693
  [_constants.TaskEvent.UNHOLD_SUCCESS]: {
597
694
  actions: ['updateTaskData', 'setHoldState', 'emitTaskResume']
598
695
  },
599
- [_constants.TaskEvent.PARTICIPANT_LEAVE]: [{
600
- guard: params => _guards.guards.didCurrentAgentLeaveConference(params) && _guards.guards.shouldWrapUp(params),
601
- target: _constants.TaskState.WRAPPING_UP,
602
- actions: ['updateTaskData', 'handleParticipantLeft', 'markEnded', 'clearConsultState', 'emitTaskParticipantLeft', 'emitTaskWrapup']
603
- }, {
604
- guard: _guards.guards.didCurrentAgentLeaveConference,
605
- target: _constants.TaskState.TERMINATED,
606
- actions: ['updateTaskData', 'handleParticipantLeft', 'markEnded', 'clearConsultState', 'emitTaskParticipantLeft', 'emitTaskEnd']
607
- }, {
608
- guard: params => !_guards.guards.didCurrentAgentLeaveConference(params) && _guards.guards.shouldDowngradeConferenceToConnected(params),
696
+ [_constants.TaskEvent.PARTICIPANT_LEAVE]: [...currentAgentParticipantLeaveTransitions(), {
697
+ guard: params => !_guards.guards.didCurrentAgentLeaveMainInteraction(params) && _guards.guards.shouldDowngradeConferenceToConnected(params),
609
698
  target: _constants.TaskState.CONNECTED,
610
699
  actions: ['updateTaskData', 'handleParticipantLeft', 'clearConsultState', 'emitTaskParticipantLeft', 'emitTaskConferenceEnded']
611
700
  }, {
@@ -630,7 +719,7 @@ function getTaskStateMachineConfig(uiControlConfig) {
630
719
  [_constants.TaskEvent.TRANSFER_CONFERENCE_SUCCESS]: [{
631
720
  guard: _guards.guards.shouldWrapUp,
632
721
  target: _constants.TaskState.WRAPPING_UP,
633
- actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'handleTransferConferenceSuccess', 'clearTransferConferenceRequested', 'emitTaskWrapup']
722
+ actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'handleTransferConferenceSuccess', 'clearTransferConferenceRequested']
634
723
  }, {
635
724
  // Non-initiator (e.g. consultee receiving transfer) moves to CONFERENCING
636
725
  guard: params => !_guards.guards.isSelfConferenceTransferInitiator(params),
@@ -655,8 +744,16 @@ function getTaskStateMachineConfig(uiControlConfig) {
655
744
  },
656
745
  [_constants.TaskEvent.TASK_WRAPUP]: {
657
746
  target: _constants.TaskState.WRAPPING_UP,
658
- actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'emitTaskWrapup']
747
+ actions: ['updateTaskData', 'markEnded', 'clearConsultState']
659
748
  },
749
+ [_constants.TaskEvent.OUTBOUND_FAILED]: [{
750
+ guard: _guards.guards.shouldWrapUp,
751
+ target: _constants.TaskState.WRAPPING_UP,
752
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskWrapup']
753
+ }, {
754
+ target: _constants.TaskState.TERMINATED,
755
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskEnd']
756
+ }],
660
757
  [_constants.TaskEvent.MERGE_TO_CONFERENCE]: {
661
758
  target: _constants.TaskState.CONF_INITIATING
662
759
  },
@@ -680,7 +777,7 @@ function getTaskStateMachineConfig(uiControlConfig) {
680
777
  actions: ['handleConferenceFailed', 'emitTaskConferenceFailed']
681
778
  },
682
779
  // AgentConsultEnded while conference is initiating (end call before conference completes)
683
- [_constants.TaskEvent.CONSULT_END]: [{
780
+ [_constants.TaskEvent.CONSULT_END]: [...currentAgentConsultEndTransitions(), {
684
781
  guard: ({
685
782
  event
686
783
  }) => {
@@ -692,7 +789,19 @@ function getTaskStateMachineConfig(uiControlConfig) {
692
789
  }, {
693
790
  target: _constants.TaskState.CONNECTED,
694
791
  actions: ['updateTaskData', 'clearConsultState']
695
- }]
792
+ }],
793
+ [_constants.TaskEvent.OUTBOUND_FAILED]: [{
794
+ guard: _guards.guards.shouldWrapUp,
795
+ target: _constants.TaskState.WRAPPING_UP,
796
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskWrapup']
797
+ }, {
798
+ target: _constants.TaskState.TERMINATED,
799
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskEnd']
800
+ }],
801
+ [_constants.TaskEvent.TASK_WRAPUP]: {
802
+ target: _constants.TaskState.WRAPPING_UP,
803
+ actions: ['updateTaskData', 'markEnded']
804
+ }
696
805
  }
697
806
  },
698
807
  [_constants.TaskState.CONFERENCING]: {
@@ -700,16 +809,9 @@ function getTaskStateMachineConfig(uiControlConfig) {
700
809
  [_constants.TaskEvent.CONFERENCE_START]: {
701
810
  actions: ['updateTaskData', 'syncTaskDataFromEvent', 'clearConsultState', 'emitTaskConferenceStarted']
702
811
  },
703
- [_constants.TaskEvent.EXIT_CONFERENCE_SUCCESS]: [{
704
- guard: _guards.guards.shouldWrapUp,
705
- target: _constants.TaskState.WRAPPING_UP,
706
- actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'emitTaskWrapup']
707
- }, {
708
- target: _constants.TaskState.TERMINATED,
709
- actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'emitTaskEnd']
710
- }],
812
+ [_constants.TaskEvent.EXIT_CONFERENCE_SUCCESS]: exitConferenceSuccessTransitions(),
711
813
  // Needed as all agents in conference get this event, hence we need to clear the consult state
712
- [_constants.TaskEvent.CONSULT_END]: [{
814
+ [_constants.TaskEvent.CONSULT_END]: [...currentAgentConsultEndTransitions(), {
713
815
  guard: ({
714
816
  context,
715
817
  event
@@ -751,19 +853,9 @@ function getTaskStateMachineConfig(uiControlConfig) {
751
853
  actions: ['setConsultInitiator', 'setConsultDestination', 'setConsultFromConference', 'setConsultAgentJoined', 'updateTaskData', 'emitTaskConsultAccepted', 'emitTaskConsulting']
752
854
  },
753
855
  // Participant leaves - handle conference downgrade scenarios
754
- [_constants.TaskEvent.PARTICIPANT_LEAVE]: [{
755
- // Only the leaving agent should wrap up → WRAPPING_UP
756
- guard: params => _guards.guards.didCurrentAgentLeaveConference(params) && _guards.guards.shouldWrapUp(params),
757
- target: _constants.TaskState.WRAPPING_UP,
758
- actions: ['updateTaskData', 'handleParticipantLeft', 'markEnded', 'clearConsultState', 'emitTaskParticipantLeft', 'emitTaskWrapup']
759
- }, {
760
- // Only the leaving agent (no wrapup) → TERMINATED
761
- guard: _guards.guards.didCurrentAgentLeaveConference,
762
- target: _constants.TaskState.TERMINATED,
763
- actions: ['updateTaskData', 'handleParticipantLeft', 'markEnded', 'clearConsultState', 'emitTaskParticipantLeft', 'emitTaskEnd']
764
- }, {
856
+ [_constants.TaskEvent.PARTICIPANT_LEAVE]: [...currentAgentParticipantLeaveTransitions(), {
765
857
  // Conference downgraded, customer present → CONNECTED
766
- guard: params => !_guards.guards.didCurrentAgentLeaveConference(params) && _guards.guards.shouldDowngradeConferenceToConnected(params),
858
+ guard: params => !_guards.guards.didCurrentAgentLeaveMainInteraction(params) && _guards.guards.shouldDowngradeConferenceToConnected(params),
767
859
  target: _constants.TaskState.CONNECTED,
768
860
  actions: ['updateTaskData', 'handleParticipantLeft', 'clearConsultState', 'emitTaskParticipantLeft', 'emitTaskConferenceEnded']
769
861
  }, {
@@ -778,7 +870,7 @@ function getTaskStateMachineConfig(uiControlConfig) {
778
870
  }, {
779
871
  guard: _guards.guards.shouldWrapUp,
780
872
  target: _constants.TaskState.WRAPPING_UP,
781
- actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'handleTransferConferenceSuccess', 'clearTransferConferenceRequested', 'emitTaskWrapup']
873
+ actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'handleTransferConferenceSuccess', 'clearTransferConferenceRequested']
782
874
  }, {
783
875
  guard: params => !_guards.guards.isSelfConferenceTransferInitiator(params),
784
876
  target: _constants.TaskState.CONFERENCING,
@@ -795,7 +887,7 @@ function getTaskStateMachineConfig(uiControlConfig) {
795
887
  // Agent who should wrap up → WRAPPING_UP
796
888
  guard: _guards.guards.shouldWrapUp,
797
889
  target: _constants.TaskState.WRAPPING_UP,
798
- actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'emitTaskWrapup']
890
+ actions: ['updateTaskData', 'markEnded', 'clearConsultState']
799
891
  }, {
800
892
  // Customer still in call → CONNECTED
801
893
  guard: ({
@@ -827,14 +919,31 @@ function getTaskStateMachineConfig(uiControlConfig) {
827
919
  [_constants.TaskEvent.TASK_WRAPUP]: {
828
920
  guard: _guards.guards.shouldWrapUp,
829
921
  target: _constants.TaskState.WRAPPING_UP,
830
- actions: ['updateTaskData', 'markEnded', 'clearConsultState', 'emitTaskWrapup']
831
- }
922
+ actions: ['updateTaskData', 'markEnded', 'clearConsultState']
923
+ },
924
+ [_constants.TaskEvent.OUTBOUND_FAILED]: [{
925
+ guard: _guards.guards.shouldWrapUp,
926
+ target: _constants.TaskState.WRAPPING_UP,
927
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskWrapup']
928
+ }, {
929
+ target: _constants.TaskState.TERMINATED,
930
+ actions: ['updateTaskData', 'markEnded', 'emitTaskOutdialFailed', 'emitTaskEnd']
931
+ }]
832
932
  }
833
933
  },
834
934
  [_constants.TaskState.WRAPPING_UP]: {
835
935
  // Only emit wrapup event on entry - task:end should only be emitted when COMPLETED
836
936
  entry: ['emitTaskWrapup'],
837
937
  on: {
938
+ // Late AgentWrapup after conference exit already entered WRAPPING_UP
939
+ [_constants.TaskEvent.TASK_WRAPUP]: [{
940
+ guard: ({
941
+ context
942
+ }) => context.taskData?.wrapUpRequired === true,
943
+ actions: ['updateTaskData']
944
+ }, {
945
+ actions: ['updateTaskData', 'emitTaskWrapup']
946
+ }],
838
947
  // AgentWrappedup Event
839
948
  [_constants.TaskEvent.WRAPUP_COMPLETE]: {
840
949
  target: _constants.TaskState.COMPLETED,