@webex/contact-center 3.12.0 → 3.13.0-next.1

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 (337) hide show
  1. package/.sdd/manifest.json +887 -0
  2. package/AGENTS.md +94 -0
  3. package/ai-docs/ARCHITECTURE.md +168 -0
  4. package/ai-docs/CONTRACTS.md +64 -0
  5. package/ai-docs/GETTING_STARTED.md +168 -0
  6. package/ai-docs/GLOSSARY.md +43 -0
  7. package/ai-docs/README.md +138 -0
  8. package/ai-docs/REVIEW_CHECKLIST.md +41 -0
  9. package/ai-docs/RULES.md +444 -0
  10. package/ai-docs/SECURITY.md +52 -0
  11. package/ai-docs/SERVICE_STATE.md +52 -0
  12. package/ai-docs/SPEC_INDEX.md +65 -0
  13. package/ai-docs/adr/0001-spec-source-policy.md +55 -0
  14. package/ai-docs/adr/README.md +8 -0
  15. package/ai-docs/adr/_adr-template.md +31 -0
  16. package/ai-docs/contact-center-spec.md +388 -0
  17. package/ai-docs/features/consult-transfer-list-policy/spec/feature-spec.md +362 -0
  18. package/ai-docs/features/contact-owner-change-refactor.md +78 -0
  19. package/ai-docs/features/generated-spec-conformance-fidelity-remediation/spec/feature-spec.md +117 -0
  20. package/ai-docs/features/residual-warning-coverage-completion/spec/feature-spec.md +203 -0
  21. package/ai-docs/features/validator-code-fidelity-drift-fix/spec/feature-spec.md +315 -0
  22. package/ai-docs/patterns/event-driven-patterns.md +485 -0
  23. package/ai-docs/patterns/testing-patterns.md +480 -0
  24. package/ai-docs/patterns/typescript-patterns.md +365 -0
  25. package/ai-docs/templates/README.md +102 -0
  26. package/ai-docs/templates/documentation/create-agents-md.md +240 -0
  27. package/ai-docs/templates/documentation/create-architecture-md.md +295 -0
  28. package/ai-docs/templates/existing-service/bug-fix.md +254 -0
  29. package/ai-docs/templates/existing-service/feature-enhancement.md +450 -0
  30. package/ai-docs/templates/new-method/00-master.md +80 -0
  31. package/ai-docs/templates/new-method/01-requirements.md +232 -0
  32. package/ai-docs/templates/new-method/02-implementation.md +295 -0
  33. package/ai-docs/templates/new-method/03-tests.md +201 -0
  34. package/ai-docs/templates/new-method/04-validation.md +141 -0
  35. package/ai-docs/templates/new-service/00-master.md +109 -0
  36. package/ai-docs/templates/new-service/01-pre-questions.md +159 -0
  37. package/ai-docs/templates/new-service/02-code-generation.md +346 -0
  38. package/ai-docs/templates/new-service/03-integration.md +178 -0
  39. package/ai-docs/templates/new-service/04-test-generation.md +205 -0
  40. package/ai-docs/templates/new-service/05-validation.md +145 -0
  41. package/dist/cc.js +1102 -47
  42. package/dist/cc.js.map +1 -1
  43. package/dist/config.js +13 -0
  44. package/dist/config.js.map +1 -1
  45. package/dist/constants.js +46 -3
  46. package/dist/constants.js.map +1 -1
  47. package/dist/index.js +86 -17
  48. package/dist/index.js.map +1 -1
  49. package/dist/metrics/MetricsManager.js +16 -0
  50. package/dist/metrics/MetricsManager.js.map +1 -1
  51. package/dist/metrics/behavioral-events.js +211 -0
  52. package/dist/metrics/behavioral-events.js.map +1 -1
  53. package/dist/metrics/constants.js +58 -4
  54. package/dist/metrics/constants.js.map +1 -1
  55. package/dist/services/AddressBook.js +18 -15
  56. package/dist/services/AddressBook.js.map +1 -1
  57. package/dist/services/AnswerCallOnWebexService.js +202 -0
  58. package/dist/services/AnswerCallOnWebexService.js.map +1 -0
  59. package/dist/services/ApiAiAssistant.js +369 -14
  60. package/dist/services/ApiAiAssistant.js.map +1 -1
  61. package/dist/services/EntryPoint.js +46 -68
  62. package/dist/services/EntryPoint.js.map +1 -1
  63. package/dist/services/Queue.js +27 -22
  64. package/dist/services/Queue.js.map +1 -1
  65. package/dist/services/UserPreference.js +427 -0
  66. package/dist/services/UserPreference.js.map +1 -0
  67. package/dist/services/WebCallingService.js +287 -37
  68. package/dist/services/WebCallingService.js.map +1 -1
  69. package/dist/services/WebexCrossClientService.js +225 -0
  70. package/dist/services/WebexCrossClientService.js.map +1 -0
  71. package/dist/services/WxAppTelephonyMercurySync.js +111 -0
  72. package/dist/services/WxAppTelephonyMercurySync.js.map +1 -0
  73. package/dist/services/config/Util.js +48 -48
  74. package/dist/services/config/Util.js.map +1 -1
  75. package/dist/services/config/constants.js +57 -79
  76. package/dist/services/config/constants.js.map +1 -1
  77. package/dist/services/config/index.js +100 -226
  78. package/dist/services/config/index.js.map +1 -1
  79. package/dist/services/config/types.js +100 -40
  80. package/dist/services/config/types.js.map +1 -1
  81. package/dist/services/constants.js +19 -1
  82. package/dist/services/constants.js.map +1 -1
  83. package/dist/services/core/Err.js.map +1 -1
  84. package/dist/services/core/Utils.js +131 -32
  85. package/dist/services/core/Utils.js.map +1 -1
  86. package/dist/services/core/WebexRequest.js +6 -2
  87. package/dist/services/core/WebexRequest.js.map +1 -1
  88. package/dist/services/core/aqm-reqs.js +17 -11
  89. package/dist/services/core/aqm-reqs.js.map +1 -1
  90. package/dist/services/core/constants.js +9 -1
  91. package/dist/services/core/constants.js.map +1 -1
  92. package/dist/services/core/types.js.map +1 -1
  93. package/dist/services/core/websocket/WebSocketManager.js +26 -6
  94. package/dist/services/core/websocket/WebSocketManager.js.map +1 -1
  95. package/dist/services/core/websocket/connection-service.js +3 -1
  96. package/dist/services/core/websocket/connection-service.js.map +1 -1
  97. package/dist/services/core/websocket/types.js.map +1 -1
  98. package/dist/services/index.js +6 -0
  99. package/dist/services/index.js.map +1 -1
  100. package/dist/services/task/Task.js +955 -0
  101. package/dist/services/task/Task.js.map +1 -0
  102. package/dist/services/task/TaskFactory.js +50 -0
  103. package/dist/services/task/TaskFactory.js.map +1 -0
  104. package/dist/services/task/TaskManager.js +1275 -504
  105. package/dist/services/task/TaskManager.js.map +1 -1
  106. package/dist/services/task/TaskUtils.js +221 -27
  107. package/dist/services/task/TaskUtils.js.map +1 -1
  108. package/dist/services/task/WebexCallingUtils.js +70 -0
  109. package/dist/services/task/WebexCallingUtils.js.map +1 -0
  110. package/dist/services/task/constants.js +22 -2
  111. package/dist/services/task/constants.js.map +1 -1
  112. package/dist/services/task/contact.js +29 -0
  113. package/dist/services/task/contact.js.map +1 -1
  114. package/dist/services/task/dialer.js +78 -0
  115. package/dist/services/task/dialer.js.map +1 -1
  116. package/dist/services/task/digital/Digital.js +78 -0
  117. package/dist/services/task/digital/Digital.js.map +1 -0
  118. package/dist/services/task/state-machine/TaskStateMachine.js +982 -0
  119. package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -0
  120. package/dist/services/task/state-machine/actions.js +572 -0
  121. package/dist/services/task/state-machine/actions.js.map +1 -0
  122. package/dist/services/task/state-machine/constants.js +161 -0
  123. package/dist/services/task/state-machine/constants.js.map +1 -0
  124. package/dist/services/task/state-machine/guards.js +379 -0
  125. package/dist/services/task/state-machine/guards.js.map +1 -0
  126. package/dist/services/task/state-machine/index.js +53 -0
  127. package/dist/services/task/state-machine/index.js.map +1 -0
  128. package/dist/services/task/state-machine/types.js +54 -0
  129. package/dist/services/task/state-machine/types.js.map +1 -0
  130. package/dist/services/task/state-machine/uiControlsComputer.js +703 -0
  131. package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -0
  132. package/dist/services/task/taskDataNormalizer.js +99 -0
  133. package/dist/services/task/taskDataNormalizer.js.map +1 -0
  134. package/dist/services/task/types.js +259 -5
  135. package/dist/services/task/types.js.map +1 -1
  136. package/dist/services/task/voice/Voice.js +1504 -0
  137. package/dist/services/task/voice/Voice.js.map +1 -0
  138. package/dist/services/task/voice/WebRTC.js +152 -0
  139. package/dist/services/task/voice/WebRTC.js.map +1 -0
  140. package/dist/services/task/voice/wxAppOfferObservability.js +145 -0
  141. package/dist/services/task/voice/wxAppOfferObservability.js.map +1 -0
  142. package/dist/services/task/voice/wxAppVoiceMethods.js +395 -0
  143. package/dist/services/task/voice/wxAppVoiceMethods.js.map +1 -0
  144. package/dist/services/wxAppDiagnosticLogging.js +159 -0
  145. package/dist/services/wxAppDiagnosticLogging.js.map +1 -0
  146. package/dist/services/wxAppTelephonyUtils.js +19 -0
  147. package/dist/services/wxAppTelephonyUtils.js.map +1 -0
  148. package/dist/types/cc.d.ts +222 -10
  149. package/dist/types/config.d.ts +13 -0
  150. package/dist/types/constants.d.ts +40 -1
  151. package/dist/types/index.d.ts +58 -22
  152. package/dist/types/metrics/MetricsManager.d.ts +6 -0
  153. package/dist/types/metrics/constants.d.ts +52 -1
  154. package/dist/types/services/AddressBook.d.ts +2 -1
  155. package/dist/types/services/AnswerCallOnWebexService.d.ts +38 -0
  156. package/dist/types/services/ApiAiAssistant.d.ts +67 -5
  157. package/dist/types/services/EntryPoint.d.ts +7 -5
  158. package/dist/types/services/Queue.d.ts +5 -3
  159. package/dist/types/services/UserPreference.d.ts +118 -0
  160. package/dist/types/services/WebexCrossClientService.d.ts +32 -0
  161. package/dist/types/services/WxAppTelephonyMercurySync.d.ts +28 -0
  162. package/dist/types/services/config/Util.d.ts +4 -8
  163. package/dist/types/services/config/constants.d.ts +49 -76
  164. package/dist/types/services/config/index.d.ts +16 -64
  165. package/dist/types/services/config/types.d.ts +252 -114
  166. package/dist/types/services/constants.d.ts +16 -0
  167. package/dist/types/services/core/Err.d.ts +6 -0
  168. package/dist/types/services/core/Utils.d.ts +43 -13
  169. package/dist/types/services/core/WebexRequest.d.ts +1 -0
  170. package/dist/types/services/core/constants.d.ts +7 -0
  171. package/dist/types/services/core/types.d.ts +2 -0
  172. package/dist/types/services/core/websocket/WebSocketManager.d.ts +2 -0
  173. package/dist/types/services/core/websocket/types.d.ts +1 -1
  174. package/dist/types/services/index.d.ts +2 -0
  175. package/dist/types/services/task/Task.d.ts +186 -0
  176. package/dist/types/services/task/TaskFactory.d.ts +14 -0
  177. package/dist/types/services/task/TaskUtils.d.ts +54 -2
  178. package/dist/types/services/task/WebexCallingUtils.d.ts +11 -0
  179. package/dist/types/services/task/constants.d.ts +20 -0
  180. package/dist/types/services/task/contact.d.ts +4 -0
  181. package/dist/types/services/task/dialer.d.ts +30 -0
  182. package/dist/types/services/task/digital/Digital.d.ts +23 -0
  183. package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +1442 -0
  184. package/dist/types/services/task/state-machine/actions.d.ts +10 -0
  185. package/dist/types/services/task/state-machine/constants.d.ts +107 -0
  186. package/dist/types/services/task/state-machine/guards.d.ts +103 -0
  187. package/dist/types/services/task/state-machine/index.d.ts +13 -0
  188. package/dist/types/services/task/state-machine/types.d.ts +277 -0
  189. package/dist/types/services/task/state-machine/uiControlsComputer.d.ts +9 -0
  190. package/dist/types/services/task/taskDataNormalizer.d.ts +10 -0
  191. package/dist/types/services/task/types.d.ts +790 -66
  192. package/dist/types/services/task/voice/Voice.d.ts +241 -0
  193. package/dist/types/services/task/voice/WebRTC.d.ts +54 -0
  194. package/dist/types/services/task/voice/wxAppOfferObservability.d.ts +39 -0
  195. package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts +68 -0
  196. package/dist/types/services/wxAppDiagnosticLogging.d.ts +63 -0
  197. package/dist/types/services/wxAppTelephonyUtils.d.ts +5 -0
  198. package/dist/types/types.d.ts +258 -11
  199. package/dist/types/utils/PageCache.d.ts +20 -3
  200. package/dist/types/webex.d.ts +1 -0
  201. package/dist/types.js +204 -6
  202. package/dist/types.js.map +1 -1
  203. package/dist/utils/PageCache.js +19 -5
  204. package/dist/utils/PageCache.js.map +1 -1
  205. package/dist/webex.js +22 -2
  206. package/dist/webex.js.map +1 -1
  207. package/package.json +16 -12
  208. package/src/cc.ts +1439 -105
  209. package/src/config.ts +13 -0
  210. package/src/constants.ts +53 -1
  211. package/src/index.ts +72 -16
  212. package/src/metrics/MetricsManager.ts +16 -0
  213. package/src/metrics/ai-docs/AGENTS.md +350 -0
  214. package/src/metrics/ai-docs/ARCHITECTURE.md +338 -0
  215. package/src/metrics/ai-docs/metrics-spec.md +971 -0
  216. package/src/metrics/behavioral-events.ts +218 -0
  217. package/src/metrics/constants.ts +63 -4
  218. package/src/services/AddressBook.ts +17 -6
  219. package/src/services/AnswerCallOnWebexService.ts +239 -0
  220. package/src/services/ApiAiAssistant.ts +494 -15
  221. package/src/services/EntryPoint.ts +59 -60
  222. package/src/services/Queue.ts +29 -12
  223. package/src/services/UserPreference.ts +509 -0
  224. package/src/services/WebCallingService.ts +362 -40
  225. package/src/services/WebexCrossClientService.ts +298 -0
  226. package/src/services/WxAppTelephonyMercurySync.ts +142 -0
  227. package/src/services/agent/ai-docs/AGENTS.md +240 -0
  228. package/src/services/agent/ai-docs/ARCHITECTURE.md +304 -0
  229. package/src/services/agent/ai-docs/agent-spec.md +505 -0
  230. package/src/services/ai-docs/AGENTS.md +386 -0
  231. package/src/services/ai-docs/services-spec.md +512 -0
  232. package/src/services/config/Util.ts +54 -84
  233. package/src/services/config/ai-docs/AGENTS.md +250 -0
  234. package/src/services/config/ai-docs/ARCHITECTURE.md +413 -0
  235. package/src/services/config/ai-docs/config-spec.md +669 -0
  236. package/src/services/config/constants.ts +64 -86
  237. package/src/services/config/index.ts +116 -277
  238. package/src/services/config/types.ts +238 -125
  239. package/src/services/constants.ts +18 -0
  240. package/src/services/core/Err.ts +3 -0
  241. package/src/services/core/Utils.ts +151 -37
  242. package/src/services/core/WebexRequest.ts +3 -1
  243. package/src/services/core/ai-docs/AGENTS.md +381 -0
  244. package/src/services/core/ai-docs/ARCHITECTURE.md +698 -0
  245. package/src/services/core/ai-docs/core-spec.md +797 -0
  246. package/src/services/core/aqm-reqs.ts +18 -12
  247. package/src/services/core/constants.ts +8 -0
  248. package/src/services/core/types.ts +33 -1
  249. package/src/services/core/websocket/WebSocketManager.ts +37 -8
  250. package/src/services/core/websocket/connection-service.ts +5 -1
  251. package/src/services/core/websocket/types.ts +1 -1
  252. package/src/services/index.ts +4 -0
  253. package/src/services/task/Task.ts +1211 -0
  254. package/src/services/task/TaskFactory.ts +82 -0
  255. package/src/services/task/TaskManager.ts +1551 -584
  256. package/src/services/task/TaskUtils.ts +316 -25
  257. package/src/services/task/WebexCallingUtils.ts +136 -0
  258. package/src/services/task/ai-docs/AGENTS.md +457 -0
  259. package/src/services/task/ai-docs/ARCHITECTURE.md +595 -0
  260. package/src/services/task/ai-docs/task-spec.md +1501 -0
  261. package/src/services/task/constants.ts +21 -0
  262. package/src/services/task/contact.ts +30 -0
  263. package/src/services/task/dialer.ts +80 -0
  264. package/src/services/task/digital/Digital.ts +102 -0
  265. package/src/services/task/state-machine/TaskStateMachine.ts +1320 -0
  266. package/src/services/task/state-machine/actions.ts +741 -0
  267. package/src/services/task/state-machine/ai-docs/AGENTS.md +460 -0
  268. package/src/services/task/state-machine/ai-docs/ARCHITECTURE.md +1156 -0
  269. package/src/services/task/state-machine/ai-docs/task-state-machine-spec.md +2247 -0
  270. package/src/services/task/state-machine/constants.ts +172 -0
  271. package/src/services/task/state-machine/guards.ts +442 -0
  272. package/src/services/task/state-machine/index.ts +28 -0
  273. package/src/services/task/state-machine/types.ts +258 -0
  274. package/src/services/task/state-machine/uiControlsComputer.ts +1135 -0
  275. package/src/services/task/taskDataNormalizer.ts +137 -0
  276. package/src/services/task/types.ts +974 -70
  277. package/src/services/task/voice/Voice.ts +1878 -0
  278. package/src/services/task/voice/WebRTC.ts +194 -0
  279. package/src/services/task/voice/wxAppOfferObservability.ts +204 -0
  280. package/src/services/task/voice/wxAppVoiceMethods.ts +575 -0
  281. package/src/services/wxAppDiagnosticLogging.ts +286 -0
  282. package/src/services/wxAppTelephonyUtils.ts +14 -0
  283. package/src/types.ts +323 -13
  284. package/src/utils/AGENTS.md +289 -0
  285. package/src/utils/PageCache.ts +38 -5
  286. package/src/utils/ai-docs/utils-spec.md +391 -0
  287. package/src/webex.js +10 -0
  288. package/test/unit/fixtures/aiSummaryTestUtils.ts +40 -0
  289. package/test/unit/spec/cc.ts +4046 -181
  290. package/test/unit/spec/index.ts +891 -0
  291. package/test/unit/spec/logger-proxy.ts +70 -0
  292. package/test/unit/spec/metrics/MetricsManager.ts +25 -0
  293. package/test/unit/spec/metrics/behavioral-events.ts +60 -0
  294. package/test/unit/spec/services/AddressBook.ts +37 -6
  295. package/test/unit/spec/services/AnswerCallOnWebexService.ts +264 -0
  296. package/test/unit/spec/services/ApiAiAssistant.ts +442 -23
  297. package/test/unit/spec/services/EntryPoint.ts +87 -40
  298. package/test/unit/spec/services/Queue.ts +123 -12
  299. package/test/unit/spec/services/UserPreference.ts +401 -0
  300. package/test/unit/spec/services/WebCallingService.ts +484 -49
  301. package/test/unit/spec/services/WebexCrossClientService.ts +509 -0
  302. package/test/unit/spec/services/WxAppTelephonyMercurySync.ts +136 -0
  303. package/test/unit/spec/services/config/Util.ts +501 -0
  304. package/test/unit/spec/services/config/index.ts +318 -548
  305. package/test/unit/spec/services/core/Utils.ts +447 -8
  306. package/test/unit/spec/services/core/WebexRequest.ts +8 -7
  307. package/test/unit/spec/services/core/aqm-reqs.ts +142 -1
  308. package/test/unit/spec/services/core/websocket/WebSocketManager.ts +132 -56
  309. package/test/unit/spec/services/core/websocket/connection-service.ts +3 -1
  310. package/test/unit/spec/services/task/AutoWrapup.ts +63 -0
  311. package/test/unit/spec/services/task/Task.ts +2723 -0
  312. package/test/unit/spec/services/task/TaskFactory.ts +116 -0
  313. package/test/unit/spec/services/task/TaskManager.ts +4800 -1586
  314. package/test/unit/spec/services/task/TaskUtils.ts +307 -0
  315. package/test/unit/spec/services/task/WebexCallingUtils.ts +153 -0
  316. package/test/unit/spec/services/task/contact.ts +33 -0
  317. package/test/unit/spec/services/task/dialer.ts +190 -0
  318. package/test/unit/spec/services/task/digital/Digital.ts +105 -0
  319. package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +4060 -0
  320. package/test/unit/spec/services/task/state-machine/guards.ts +839 -0
  321. package/test/unit/spec/services/task/state-machine/types.ts +18 -0
  322. package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +3101 -0
  323. package/test/unit/spec/services/task/taskTestUtils.ts +87 -0
  324. package/test/unit/spec/services/task/voice/Voice.ts +2355 -0
  325. package/test/unit/spec/services/task/voice/WebRTC.ts +235 -0
  326. package/test/unit/spec/services/task/voice/wxAppOfferObservability.ts +361 -0
  327. package/test/unit/spec/services/task/voice/wxAppVoiceMethods.ts +719 -0
  328. package/test/unit/spec/services/wxAppDiagnosticLogging.ts +179 -0
  329. package/test/unit/spec/wellnessSampleUtils.ts +288 -0
  330. package/typedoc.md +1 -1
  331. package/umd/contact-center.min.js +2 -2
  332. package/umd/contact-center.min.js.map +1 -1
  333. package/dist/services/task/index.js +0 -1525
  334. package/dist/services/task/index.js.map +0 -1
  335. package/dist/types/services/task/index.d.ts +0 -650
  336. package/src/services/task/index.ts +0 -1801
  337. package/test/unit/spec/services/task/index.ts +0 -2184
@@ -12,11 +12,20 @@ var _constants2 = require("./constants");
12
12
  var _types2 = require("../config/types");
13
13
  var _types3 = require("../../types");
14
14
  var _loggerProxy = _interopRequireDefault(require("../../logger-proxy"));
15
- var _ = _interopRequireDefault(require("."));
16
- var _MetricsManager = _interopRequireDefault(require("../../metrics/MetricsManager"));
17
- var _constants3 = require("../../metrics/constants");
18
15
  var _TaskUtils = require("./TaskUtils");
16
+ var _TaskFactory = _interopRequireDefault(require("./TaskFactory"));
17
+ var _WebexCallingUtils = require("./WebexCallingUtils");
18
+ var _WebRTC = _interopRequireDefault(require("./voice/WebRTC"));
19
+ var _stateMachine = require("./state-machine");
20
+ var _constants3 = require("./state-machine/constants");
21
+ var _taskDataNormalizer = require("./taskDataNormalizer");
19
22
  function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
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]);
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]);
28
+
20
29
  /** @internal */
21
30
  class TaskManager extends _events.default {
22
31
  /**
@@ -25,28 +34,134 @@ class TaskManager extends _events.default {
25
34
  * @private
26
35
  */
27
36
 
37
+ // eslint-disable-next-line no-use-before-define
38
+
39
+ receivingSummaryBuffer = new Map();
40
+
41
+ // RTD feature frames can arrive before AQM creates the task.
42
+ pendingFeatureEnablement = new Map();
43
+
28
44
  /**
29
45
  * @param contact - Routing Contact layer. Talks to AQMReq layer to convert events to promises
30
46
  * @param webCallingService - Webrtc Service Layer
31
47
  * @param webSocketManager - Websocket Manager to maintain websocket connection and keepalives
32
48
  */
33
- constructor(apiAIAssistant, contact, webCallingService, webSocketManager) {
49
+ constructor(apiAIAssistant, contact, webCallingService, webSocketManager, rtdWebSocketManager) {
34
50
  super();
35
51
  this.apiAIAssistant = apiAIAssistant;
36
52
  this.contact = contact;
37
- this.taskCollection = {};
38
53
  this.webCallingService = webCallingService;
39
54
  this.webSocketManager = webSocketManager;
40
- this.metricsManager = _MetricsManager.default.getInstance();
55
+ this.rtdWebSocketManager = rtdWebSocketManager;
56
+ this.taskCollection = {};
57
+ this.webRtcEnabled = false;
41
58
  this.registerTaskListeners();
42
59
  this.registerIncomingCallEvent();
43
60
  }
61
+ handleRealtimeWebsocketEvent(event) {
62
+ try {
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
+ }
108
+ const interactionId = payload?.data?.data?.conversationId;
109
+ if (!interactionId) return;
110
+ const task = this.taskCollection[interactionId];
111
+ if (!task) {
112
+ _loggerProxy.default.info(`Realtime transcription task not found`, {
113
+ module: _constants.TASK_MANAGER_FILE,
114
+ method: _constants2.METHODS.HANDLE_REAL_TIME_WEBSOCKET_EVENT,
115
+ interactionId
116
+ });
117
+ return;
118
+ }
119
+ switch (payload.type) {
120
+ case _types2.CC_EVENTS.REAL_TIME_TRANSCRIPTION:
121
+ case _types2.CC_EVENTS.SUGGESTED_RESPONSE:
122
+ task.emit(payload.type, payload.data);
123
+ break;
124
+ default:
125
+ break;
126
+ }
127
+ } catch (error) {
128
+ _loggerProxy.default.error('Failed to parse RTD WebSocket message', {
129
+ module: _constants.TASK_MANAGER_FILE,
130
+ method: _constants2.METHODS.HANDLE_REAL_TIME_WEBSOCKET_EVENT,
131
+ error
132
+ });
133
+ }
134
+ }
135
+
136
+ /**
137
+ * Set config flags for task creation
138
+ */
139
+ setConfigFlags(configFlags) {
140
+ this.configFlags = configFlags;
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
+ }
148
+
149
+ /**
150
+ * Set wrapup configuration data
151
+ */
44
152
  setWrapupData(wrapupData) {
45
153
  this.wrapupData = wrapupData;
46
154
  }
155
+
156
+ /**
157
+ * Set agent ID for task operations
158
+ */
47
159
  setAgentId(agentId) {
48
160
  this.agentId = agentId;
49
161
  }
162
+ setAgentName(agentName) {
163
+ this.agentName = agentName;
164
+ }
50
165
 
51
166
  /**
52
167
  * Gets the current agent ID
@@ -59,6 +174,9 @@ class TaskManager extends _events.default {
59
174
  setWebRtcEnabled(webRtcEnabled) {
60
175
  this.webRtcEnabled = webRtcEnabled;
61
176
  }
177
+ setAnswerCallOnWebexService(answerCallOnWebexService) {
178
+ this.answerCallOnWebexService = answerCallOnWebexService;
179
+ }
62
180
  handleIncomingWebCall = call => {
63
181
  const currentTask = Object.values(this.taskCollection).find(task => task.data.interaction.mediaType === 'telephony' && !(0, _TaskUtils.isCampaignPreviewReservation)(task));
64
182
  if (currentTask) {
@@ -68,7 +186,12 @@ class TaskManager extends _events.default {
68
186
  method: _constants2.METHODS.HANDLE_INCOMING_WEB_CALL,
69
187
  interactionId: currentTask.data.interactionId
70
188
  });
71
- this.emit(_types.TASK_EVENTS.TASK_INCOMING, currentTask);
189
+
190
+ // Send TASK_INCOMING to state machine - it will emit on the task object
191
+ const eventPayload = TaskManager.mapEventToTaskStateMachineEvent(_types2.CC_EVENTS.AGENT_CONTACT_RESERVED, currentTask.data);
192
+ if (eventPayload && currentTask) {
193
+ currentTask.sendStateMachineEvent(eventPayload);
194
+ }
72
195
  }
73
196
  this.call = call;
74
197
  };
@@ -78,472 +201,1058 @@ class TaskManager extends _events.default {
78
201
  unregisterIncomingCallEvent() {
79
202
  this.webCallingService.off(_calling.LINE_EVENTS.INCOMING_CALL, this.handleIncomingWebCall);
80
203
  }
81
- registerTaskListeners() {
82
- this.webSocketManager.on('message', event => {
83
- const payload = JSON.parse(event);
84
- // Re-emit the task events to the task object
85
- let task;
86
- if (payload.data?.type || payload.type) {
87
- if (Object.values(_types2.CC_TASK_EVENTS).includes(payload.data.type || payload.type)) {
88
- task = this.taskCollection[payload.data?.interactionId] || this.taskCollection[payload.data?.data?.conversationId];
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
+
337
+ /**
338
+ * Map WebSocket CC_EVENTS to state machine TaskEvent
339
+ * @param ccEvent - The CC_EVENT type from WebSocket
340
+ * @param payload - The event payload
341
+ * @param agentId - Optional agent ID for state detection (needed for HYDRATE)
342
+ * @param task - Optional task instance for state-aware CONTACT_ENDED mapping
343
+ * @returns TaskEventPayload for state machine or null if no mapping
344
+ */
345
+ static mapEventToTaskStateMachineEvent(ccEvent, payload, agentId, task, enableWxBetterTogether) {
346
+ const mediaResourceId = payload.mediaResourceId || payload.interaction?.media?.[payload.interactionId]?.mediaResourceId;
347
+ switch (ccEvent) {
348
+ // CC -> TaskEvent mappings (see TaskStateMachine comment for quick reference)
349
+ case _types2.CC_EVENTS.AGENT_CONTACT_RESERVED:
350
+ // AgentContactReserved -> TASK_INCOMING
351
+ if ((0, _TaskUtils.isCampaignPreviewTask)(payload)) {
352
+ return {
353
+ type: _stateMachine.TaskEvent.TASK_INCOMING,
354
+ taskData: payload,
355
+ isCampaignReservationAccept: true
356
+ };
89
357
  }
90
- _loggerProxy.default.info(`Handling task event ${payload.data?.type}`, {
91
- module: _constants.TASK_MANAGER_FILE,
92
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
93
- interactionId: payload.data?.interactionId
94
- });
95
- switch (payload.data.type) {
96
- case _types2.CC_EVENTS.AGENT_CONTACT:
97
- // Case1 : Task is already present in taskCollection
98
- if (this.taskCollection[payload.data.interactionId]) {
99
- _loggerProxy.default.log(`Got AGENT_CONTACT: Task already exists in collection`, {
100
- module: _constants.TASK_MANAGER_FILE,
101
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
102
- interactionId: payload.data.interactionId
103
- });
104
- break;
105
- } else if (!this.taskCollection[payload.data.interactionId]) {
106
- // Case2 : Task is not present in taskCollection
107
- _loggerProxy.default.log(`Got AGENT_CONTACT : Creating new task in taskManager`, {
108
- module: _constants.TASK_MANAGER_FILE,
109
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
110
- interactionId: payload.data.interactionId
111
- });
112
-
113
- // Check if auto-answer should happen for this task
114
- const shouldAutoAnswer = (0, _TaskUtils.shouldAutoAnswerTask)(payload.data, this.agentId, this.webCallingService.loginOption, this.webRtcEnabled);
115
- task = new _.default(this.contact, this.webCallingService, {
116
- ...payload.data,
117
- wrapUpRequired: payload.data.interaction?.participants?.[this.agentId]?.isWrapUp || false,
118
- isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(payload.data),
119
- isAutoAnswering: shouldAutoAnswer // Set flag before emitting
120
- }, this.wrapupData, this.agentId);
121
- this.taskCollection[payload.data.interactionId] = task;
122
- // Condition 1: The state is=new i.e it is a incoming task
123
- if (payload.data.interaction.state === 'new') {
124
- _loggerProxy.default.log(`Got AGENT_CONTACT for a task with state=new, sending TASK_INCOMING event`, {
125
- module: _constants.TASK_MANAGER_FILE,
126
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
127
- interactionId: payload.data.interactionId
128
- });
129
- this.emit(_types.TASK_EVENTS.TASK_INCOMING, task);
130
- } else {
131
- // Condition 2: The state is anything else i.e the task was connected
132
- _loggerProxy.default.log(`Got AGENT_CONTACT for a task with state=${payload.data.interaction.state}, sending TASK_HYDRATE event`, {
133
- module: _constants.TASK_MANAGER_FILE,
134
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
135
- interactionId: payload.data.interactionId
136
- });
137
- this.emit(_types.TASK_EVENTS.TASK_HYDRATE, task);
138
- }
139
- }
140
- break;
141
- case _types2.CC_EVENTS.AGENT_CONTACT_RESERVED:
142
- {
143
- // Check if auto-answer should happen for this task
144
- const shouldAutoAnswerReserved = (0, _TaskUtils.shouldAutoAnswerTask)(payload.data, this.agentId, this.webCallingService.loginOption, this.webRtcEnabled);
145
- task = new _.default(this.contact, this.webCallingService, {
146
- ...payload.data,
147
- isConsulted: false,
148
- isAutoAnswering: shouldAutoAnswerReserved // Set flag before emitting
149
- }, this.wrapupData, this.agentId);
150
- this.taskCollection[payload.data.interactionId] = task;
151
- if (this.webCallingService.loginOption !== _types3.LoginOption.BROWSER || task.data.interaction.mediaType !== _types.MEDIA_CHANNEL.TELEPHONY // for digital channels
152
- ) {
153
- this.emit(_types.TASK_EVENTS.TASK_INCOMING, task);
154
- } else if (this.call) {
155
- this.emit(_types.TASK_EVENTS.TASK_INCOMING, task);
156
- }
157
- break;
158
- }
159
- case _types2.CC_EVENTS.AGENT_OFFER_CONTACT:
160
- // We don't have to emit any event here since this will be result of promise.
161
- task = this.updateTaskData(task, payload.data);
162
- _loggerProxy.default.log(`Agent offer contact received for task`, {
163
- module: _constants.TASK_MANAGER_FILE,
164
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
165
- interactionId: payload.data?.interactionId
166
- });
167
- this.emit(_types.TASK_EVENTS.TASK_OFFER_CONTACT, task);
168
-
169
- // Handle auto-answer for offer contact
170
- this.handleAutoAnswer(task);
171
- break;
172
- case _types2.CC_EVENTS.AGENT_OUTBOUND_FAILED:
173
- if (task) {
174
- task = this.updateTaskData(task, payload.data);
175
- this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.TASK_OUTDIAL_FAILED, {
176
- ..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(payload.data),
177
- taskId: payload.data.interactionId,
178
- reason: payload.data.reasonCode || payload.data.reason
179
- }, ['behavioral', 'operational']);
180
- _loggerProxy.default.log(`Agent outbound failed for task`, {
181
- module: _constants.TASK_MANAGER_FILE,
182
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
183
- interactionId: payload.data.interactionId
184
- });
185
- task.emit(_types.TASK_EVENTS.TASK_OUTDIAL_FAILED, payload.data.reason ?? 'UNKNOWN_REASON');
186
- }
187
- break;
188
- case _types2.CC_EVENTS.AGENT_CONTACT_ASSIGNED:
189
- // When a campaign preview contact is accepted, the assigned event may arrive
190
- // with a new interactionId while the task is stored under the original
191
- // reservationInteractionId. Fall back to that key so the task is found.
192
- if (!task && payload.data.reservationInteractionId) {
193
- task = this.taskCollection[payload.data.reservationInteractionId];
194
- if (task) {
195
- // Re-key the task under the new interaction ID and remove the old entry
196
- delete this.taskCollection[payload.data.reservationInteractionId];
197
- this.taskCollection[payload.data.interactionId] = task;
198
- }
199
- }
200
- if (task) {
201
- task = this.updateTaskData(task, payload.data);
202
- task.emit(_types.TASK_EVENTS.TASK_ASSIGNED, task);
203
- }
204
- break;
205
- case _types2.CC_EVENTS.AGENT_CONTACT_UNASSIGNED:
206
- task = this.updateTaskData(task, {
207
- ...payload.data,
208
- wrapUpRequired: true
209
- });
210
- task.emit(_types.TASK_EVENTS.TASK_END, task);
211
- break;
212
- case _types2.CC_EVENTS.AGENT_CONTACT_OFFER_RONA:
213
- case _types2.CC_EVENTS.AGENT_CONTACT_ASSIGN_FAILED:
214
- case _types2.CC_EVENTS.AGENT_INVITE_FAILED:
215
- {
216
- _loggerProxy.default.warn(`[DEBUG-CAMPAIGN-CLEAR] Task removal triggered by ${payload.data.type}, interactionId=${payload.data.interactionId}, taskType=${task?.data?.type}`, {
217
- module: _constants.TASK_MANAGER_FILE,
218
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
219
- interactionId: payload.data.interactionId
220
- });
221
- task = this.updateTaskData(task, payload.data);
222
- const eventTypeToMetricMap = {
223
- [_types2.CC_EVENTS.AGENT_CONTACT_ASSIGN_FAILED]: 'AGENT_CONTACT_ASSIGN_FAILED',
224
- [_types2.CC_EVENTS.AGENT_INVITE_FAILED]: 'AGENT_INVITE_FAILED'
225
- };
226
- const metricEventName = eventTypeToMetricMap[payload.data.type] || 'AGENT_RONA';
227
- this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES[metricEventName], {
228
- ..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(payload.data),
229
- taskId: payload.data.interactionId,
230
- reason: payload.data.reason
231
- }, ['behavioral', 'operational']);
232
- this.handleTaskCleanup(task);
233
- task.emit(_types.TASK_EVENTS.TASK_REJECT, payload.data.reason);
234
- break;
235
- }
236
- case _types2.CC_EVENTS.CONTACT_ENDED:
237
- // Update task data
238
- if (task) {
239
- _loggerProxy.default.warn(`[DEBUG-CAMPAIGN-CLEAR] CONTACT_ENDED, interactionId=${payload.data.interactionId}, taskType=${task?.data?.type}, state=${task?.data?.interaction?.state}`, {
240
- module: _constants.TASK_MANAGER_FILE,
241
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
242
- interactionId: payload.data.interactionId
243
- });
244
- task = this.updateTaskData(task, {
245
- ...payload.data,
246
- wrapUpRequired: payload.data.agentsPendingWrapUp?.includes(this.agentId) || false
247
- });
248
-
249
- // Handle cleanup based on whether task should be deleted
250
- this.handleTaskCleanup(task);
251
- task?.emit(_types.TASK_EVENTS.TASK_END, task);
252
- }
253
- break;
254
- case _types2.CC_EVENTS.CAMPAIGN_CONTACT_UPDATED:
255
- // CampaignContactUpdated is a non-terminal event (intermediate update during accept).
256
- // Only update the task data — do NOT remove the task or emit TASK_END.
257
- // Task cleanup is handled by CONTACT_ENDED or other terminal events.
258
- if (task) {
259
- task = this.updateTaskData(task, payload.data);
260
- }
261
- break;
262
- case _types2.CC_EVENTS.CONTACT_MERGED:
263
- task = this.handleContactMerged(task, payload.data);
264
- break;
265
- case _types2.CC_EVENTS.AGENT_CONTACT_HELD:
266
- // As soon as the main interaction is held, we need to emit TASK_HOLD
267
- task = this.updateTaskData(task, payload.data);
268
- task.emit(_types.TASK_EVENTS.TASK_HOLD, task);
269
- break;
270
- case _types2.CC_EVENTS.AGENT_CONTACT_UNHELD:
271
- // As soon as the main interaction is unheld, we need to emit TASK_RESUME
272
- task = this.updateTaskData(task, payload.data);
273
- task.emit(_types.TASK_EVENTS.TASK_RESUME, task);
274
- break;
275
- case _types2.CC_EVENTS.AGENT_VTEAM_TRANSFERRED:
276
- task = this.updateTaskData(task, {
277
- ...payload.data,
278
- wrapUpRequired: true
279
- });
280
- task.emit(_types.TASK_EVENTS.TASK_END, task);
281
- break;
282
- case _types2.CC_EVENTS.AGENT_CTQ_CANCEL_FAILED:
283
- task = this.updateTaskData(task, payload.data);
284
- task.emit(_types.TASK_EVENTS.TASK_CONSULT_QUEUE_FAILED, task);
285
- break;
286
- case _types2.CC_EVENTS.AGENT_CONSULT_CREATED:
287
- // Received when self agent initiates a consult
288
- task = this.updateTaskData(task, {
289
- ...payload.data,
290
- isConsulted: false // This ensures that the task consult status is always reset
291
- });
292
- task.emit(_types.TASK_EVENTS.TASK_CONSULT_CREATED, task);
293
- break;
294
- case _types2.CC_EVENTS.AGENT_OFFER_CONSULT:
295
- // Received when other agent sends us a consult offer
296
- task = this.updateTaskData(task, {
297
- ...payload.data,
298
- isConsulted: true // This ensures that the task is marked as us being requested for a consult
299
- });
300
- task.emit(_types.TASK_EVENTS.TASK_OFFER_CONSULT, task);
301
-
302
- // Handle auto-answer for consult offer
303
- this.handleAutoAnswer(task);
304
- break;
305
- case _types2.CC_EVENTS.AGENT_CONSULTING:
306
- // Received when agent is in an active consult state
307
- // TODO: Check if we can use backend consult state instead of isConsulted
308
- task = this.updateTaskData(task, payload.data);
309
- if (task.data.isConsulted) {
310
- // Fire only if you are the agent who received the consult request
311
- task.emit(_types.TASK_EVENTS.TASK_CONSULT_ACCEPTED, task);
312
- } else {
313
- // Fire only if you are the agent who initiated the consult
314
- task.emit(_types.TASK_EVENTS.TASK_CONSULTING, task);
315
- }
316
- break;
317
- case _types2.CC_EVENTS.AGENT_CONSULT_FAILED:
318
- // This can only be received by the agent who initiated the consult.
319
- // We need not emit any event here since this will be result of promise
320
- task = this.updateTaskData(task, payload.data);
321
- break;
322
- case _types2.CC_EVENTS.AGENT_CONSULT_ENDED:
323
- task = this.updateTaskData(task, payload.data);
324
- if (task.data.isConsulted) {
325
- // This will be the end state of the task as soon as we end the consult in case of
326
- // us being offered a consult
327
- this.removeTaskFromCollection(task);
328
- }
329
- task.emit(_types.TASK_EVENTS.TASK_CONSULT_END, task);
330
- break;
331
- case _types2.CC_EVENTS.AGENT_CTQ_CANCELLED:
332
- // This event is received when the consult using queue is cancelled using API
333
- task = this.updateTaskData(task, payload.data);
334
- task.emit(_types.TASK_EVENTS.TASK_CONSULT_QUEUE_CANCELLED, task);
335
- break;
336
- case _types2.CC_EVENTS.AGENT_WRAPUP:
337
- task = this.updateTaskData(task, {
338
- ...payload.data,
339
- wrapUpRequired: true
340
- });
341
- task.emit(_types.TASK_EVENTS.TASK_END, task);
342
- break;
343
- case _types2.CC_EVENTS.AGENT_WRAPPEDUP:
344
- task.cancelAutoWrapupTimer();
345
- this.removeTaskFromCollection(task);
346
- task.emit(_types.TASK_EVENTS.TASK_WRAPPEDUP, task);
347
- break;
348
- case _types2.CC_EVENTS.CONTACT_RECORDING_PAUSED:
349
- task = this.updateTaskData(task, payload.data);
350
- task.emit(_types.TASK_EVENTS.TASK_RECORDING_PAUSED, task);
351
- break;
352
- case _types2.CC_EVENTS.CONTACT_RECORDING_PAUSE_FAILED:
353
- task = this.updateTaskData(task, payload.data);
354
- task.emit(_types.TASK_EVENTS.TASK_RECORDING_PAUSE_FAILED, task);
355
- break;
356
- case _types2.CC_EVENTS.CONTACT_RECORDING_RESUMED:
357
- task = this.updateTaskData(task, payload.data);
358
- task.emit(_types.TASK_EVENTS.TASK_RECORDING_RESUMED, task);
359
- break;
360
- case _types2.CC_EVENTS.CONTACT_RECORDING_RESUME_FAILED:
361
- task = this.updateTaskData(task, payload.data);
362
- task.emit(_types.TASK_EVENTS.TASK_RECORDING_RESUME_FAILED, task);
363
- break;
364
- case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCING:
365
- // Conference is being established - update task state and emit establishing event
366
- task = this.updateTaskData(task, payload.data);
367
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_ESTABLISHING, task);
368
- break;
369
- case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCED:
370
- // Conference started successfully - update task state and emit event
371
- task = this.updateTaskData(task, payload.data);
372
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_STARTED, task);
373
- break;
374
- case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCE_FAILED:
375
- // Conference failed - update task state and emit failure event
376
- task = this.updateTaskData(task, payload.data);
377
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_FAILED, task);
378
- break;
379
- case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCE_ENDED:
380
- // Conference ended - update task state and emit event
381
- task = this.updateTaskData(task, payload.data);
382
- if (!task || (0, _TaskUtils.isPrimary)(task, this.agentId) || (0, _TaskUtils.isParticipantInMainInteraction)(task, this.agentId)) {
383
- _loggerProxy.default.log('Primary or main interaction participant leaving conference');
384
- } else {
385
- this.removeTaskFromCollection(task);
386
- }
387
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_ENDED, task);
388
- break;
389
- case _types2.CC_EVENTS.PARTICIPANT_JOINED_CONFERENCE:
390
- {
391
- task = this.updateTaskData(task, {
392
- ...payload.data,
393
- isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(payload.data)
394
- });
395
- task.emit(_types.TASK_EVENTS.TASK_PARTICIPANT_JOINED, task);
396
- break;
397
- }
398
- case _types2.CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE:
399
- {
400
- // Conference ended - update task state and emit event
401
-
402
- task = this.updateTaskData(task, {
403
- ...payload.data,
404
- isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(payload.data)
405
- });
406
- if ((0, _TaskUtils.checkParticipantNotInInteraction)(task, this.agentId)) {
407
- if ((0, _TaskUtils.isParticipantInMainInteraction)(task, this.agentId) || (0, _TaskUtils.isPrimary)(task, this.agentId)) {
408
- _loggerProxy.default.log('Primary or main interaction participant leaving conference');
409
- } else {
410
- this.removeTaskFromCollection(task);
411
- }
412
- }
413
- task.emit(_types.TASK_EVENTS.TASK_PARTICIPANT_LEFT, task);
414
- break;
415
- }
416
- case _types2.CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE_FAILED:
417
- // Conference exit failed - update task state and emit failure event
418
- task = this.updateTaskData(task, payload.data);
419
- task.emit(_types.TASK_EVENTS.TASK_PARTICIPANT_LEFT_FAILED, task);
420
- break;
421
- case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCE_END_FAILED:
422
- // Conference end failed - update task state with error details and emit failure event
423
- task = this.updateTaskData(task, payload.data);
424
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_END_FAILED, task);
425
- break;
426
- case _types2.CC_EVENTS.AGENT_CONFERENCE_TRANSFERRED:
427
- // Conference was transferred - update task state and emit transfer success event
428
- // Note: Backend should provide hasLeft and wrapUpRequired status
429
- task = this.updateTaskData(task, payload.data);
430
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_TRANSFERRED, task);
431
- break;
432
- case _types2.CC_EVENTS.AGENT_CONFERENCE_TRANSFER_FAILED:
433
- // Conference transfer failed - update task state with error details and emit failure event
434
- task = this.updateTaskData(task, payload.data);
435
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_TRANSFER_FAILED, task);
436
- break;
437
- case _types2.CC_EVENTS.PARTICIPANT_POST_CALL_ACTIVITY:
438
- // Post-call activity for participant - update task state with activity details
439
- task = this.updateTaskData(task, payload.data);
440
- task.emit(_types.TASK_EVENTS.TASK_POST_CALL_ACTIVITY, task);
441
- break;
442
- case _types2.CC_EVENTS.AGENT_OFFER_CAMPAIGN_RESERVATION:
443
- {
444
- // Campaign preview contact offered to agent
445
- // Create a task in the collection so subsequent events (e.g. AGENT_CONTACT_ASSIGNED
446
- // after acceptPreviewContact) can find and update it.
447
- // Emit TASK_CAMPAIGN_PREVIEW_RESERVATION instead of TASK_INCOMING so the call
448
- // does not ring out to the customer before the agent explicitly accepts the preview contact.
449
- _loggerProxy.default.log('Campaign preview reservation received', {
450
- module: _constants.TASK_MANAGER_FILE,
451
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
452
- interactionId: payload.data.interactionId
453
- });
454
- if (!this.taskCollection[payload.data.interactionId]) {
455
- task = new _.default(this.contact, this.webCallingService, {
456
- ...payload.data,
457
- wrapUpRequired: false,
458
- isConferenceInProgress: false,
459
- isAutoAnswering: false
460
- }, this.wrapupData, this.agentId);
461
- this.taskCollection[payload.data.interactionId] = task;
462
- } else {
463
- task = this.updateTaskData(task, payload.data);
358
+ return {
359
+ type: _stateMachine.TaskEvent.TASK_INCOMING,
360
+ taskData: payload
361
+ };
362
+ case _types2.CC_EVENTS.AGENT_OFFER_CAMPAIGN_RESERVATION:
363
+ // -> TASK_INCOMING (campaign branch via guard)
364
+ return {
365
+ type: _stateMachine.TaskEvent.TASK_INCOMING,
366
+ taskData: payload,
367
+ isCampaignReservationAccept: true
368
+ };
369
+ case _types2.CC_EVENTS.AGENT_OFFER_CONTACT:
370
+ // AgentOfferContact -> TASK_OFFERED
371
+ return {
372
+ type: _stateMachine.TaskEvent.TASK_OFFERED,
373
+ taskData: payload
374
+ };
375
+ case _types2.CC_EVENTS.AGENT_CONTACT:
376
+ // AgentContact -> HYDRATE
377
+ // Include agentId for state detection (e.g., checking isWrapUp in participant data)
378
+ return {
379
+ type: _stateMachine.TaskEvent.HYDRATE,
380
+ taskData: payload,
381
+ agentId
382
+ };
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
+ }
390
+ return {
391
+ type: _stateMachine.TaskEvent.CONTACT_UPDATED,
392
+ taskData: payload
393
+ };
394
+ case _types2.CC_EVENTS.CONTACT_OWNER_CHANGED:
395
+ return {
396
+ type: _stateMachine.TaskEvent.CONTACT_OWNER_CHANGED,
397
+ taskData: payload
398
+ };
399
+ case _types2.CC_EVENTS.AGENT_OFFER_CONSULT:
400
+ // AgentOfferConsult -> OFFER_CONSULT
401
+ return {
402
+ type: _stateMachine.TaskEvent.OFFER_CONSULT,
403
+ taskData: {
404
+ ...payload,
405
+ isConsulted: true
406
+ }
407
+ };
408
+ case _types2.CC_EVENTS.AGENT_CONTACT_ASSIGNED:
409
+ // AgentContactAssigned -> ASSIGN
410
+ return {
411
+ type: _stateMachine.TaskEvent.ASSIGN,
412
+ taskData: payload
413
+ };
414
+ case _types2.CC_EVENTS.AGENT_CONTACT_HELD:
415
+ return {
416
+ type: _stateMachine.TaskEvent.HOLD_SUCCESS,
417
+ mediaResourceId: mediaResourceId || '',
418
+ taskData: payload
419
+ };
420
+ case _types2.CC_EVENTS.AGENT_CONTACT_UNHELD:
421
+ return {
422
+ type: _stateMachine.TaskEvent.UNHOLD_SUCCESS,
423
+ mediaResourceId: mediaResourceId || '',
424
+ taskData: payload
425
+ };
426
+ case _types2.CC_EVENTS.AGENT_CONSULT_CREATED:
427
+ return {
428
+ type: _stateMachine.TaskEvent.CONSULT_CREATED,
429
+ taskData: {
430
+ ...payload,
431
+ isConsulted: false
432
+ }
433
+ };
434
+ case _types2.CC_EVENTS.AGENT_CONSULTING:
435
+ // AgentConsulting -> CONSULTING_ACTIVE
436
+ // use context to figure out if it's the initiator or receiver using consultInitiator from context
437
+ return {
438
+ type: _stateMachine.TaskEvent.CONSULTING_ACTIVE,
439
+ consultDestinationAgentJoined: true,
440
+ taskData: payload
441
+ };
442
+ case _types2.CC_EVENTS.AGENT_CONSULT_ENDED:
443
+ // AgentConsultEnded -> CONSULT_END
444
+ return {
445
+ type: _stateMachine.TaskEvent.CONSULT_END,
446
+ taskData: payload
447
+ };
448
+ case _types2.CC_EVENTS.AGENT_CONSULT_FAILED:
449
+ case _types2.CC_EVENTS.AGENT_CTQ_FAILED:
450
+ return {
451
+ type: _stateMachine.TaskEvent.CONSULT_FAILED,
452
+ reason: payload.reason,
453
+ taskData: payload
454
+ };
455
+ case _types2.CC_EVENTS.AGENT_CTQ_CANCELLED:
456
+ return {
457
+ type: _stateMachine.TaskEvent.CTQ_CANCEL,
458
+ taskData: payload
459
+ };
460
+ case _types2.CC_EVENTS.AGENT_CTQ_CANCEL_FAILED:
461
+ return {
462
+ type: _stateMachine.TaskEvent.CTQ_CANCEL_FAILED,
463
+ taskData: payload
464
+ };
465
+ case _types2.CC_EVENTS.AGENT_BLIND_TRANSFERRED: // AgentBlindTransferred -> TRANSFER_SUCCESS
466
+ case _types2.CC_EVENTS.AGENT_CONSULT_TRANSFERRED: // AgentConsultTransferred -> TRANSFER_SUCCESS
467
+ case _types2.CC_EVENTS.AGENT_VTEAM_TRANSFERRED:
468
+ // AgentVTeamTransferred -> TRANSFER_SUCCESS
469
+ return {
470
+ type: _stateMachine.TaskEvent.TRANSFER_SUCCESS,
471
+ taskData: payload
472
+ };
473
+ case _types2.CC_EVENTS.AGENT_WRAPUP:
474
+ return {
475
+ type: _stateMachine.TaskEvent.TASK_WRAPUP,
476
+ taskData: {
477
+ ...payload,
478
+ wrapUpRequired: true
479
+ }
480
+ };
481
+ case _types2.CC_EVENTS.AGENT_CONTACT_UNASSIGNED:
482
+ return null;
483
+ // Add WRAPUP if needed
484
+
485
+ case _types2.CC_EVENTS.AGENT_BLIND_TRANSFER_FAILED:
486
+ case _types2.CC_EVENTS.AGENT_VTEAM_TRANSFER_FAILED:
487
+ case _types2.CC_EVENTS.AGENT_CONSULT_TRANSFER_FAILED:
488
+ case _types2.CC_EVENTS.AGENT_CONFERENCE_TRANSFER_FAILED:
489
+ return {
490
+ type: _stateMachine.TaskEvent.TRANSFER_FAILED,
491
+ taskData: payload
492
+ };
493
+ case _types2.CC_EVENTS.CONTACT_ENDED:
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
464
508
  }
465
- this.emit(_types.TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION, task);
466
- break;
509
+ };
510
+ }
511
+ return {
512
+ type: _stateMachine.TaskEvent.CONTACT_ENDED,
513
+ taskData: {
514
+ ...payload,
515
+ wrapUpRequired
467
516
  }
468
- default:
469
- break;
470
- }
471
- if (task) {
472
- const eventType = payload.type || payload.data.type;
473
- const eventPayload = payload.data || payload.data.data;
474
- task.emit(eventType, eventPayload);
517
+ };
475
518
  }
476
- const transcriptInteractionId = payload.data?.interactionId || payload.data?.data?.conversationId || task?.data?.interactionId;
477
- if (_constants2.TRANSCRIPT_EVENT_MAP[payload.data.type] && transcriptInteractionId) {
478
- this.requestRealTimeTranscripts(payload.data.type, transcriptInteractionId);
519
+ case _types2.CC_EVENTS.AGENT_INVITE_FAILED:
520
+ return {
521
+ type: _stateMachine.TaskEvent.INVITE_FAILED,
522
+ reason: payload.reason
523
+ };
524
+ case _types2.CC_EVENTS.AGENT_CONTACT_ASSIGN_FAILED:
525
+ return {
526
+ type: _stateMachine.TaskEvent.ASSIGN_FAILED,
527
+ reason: payload.reason
528
+ };
529
+ case _types2.CC_EVENTS.AGENT_CONTACT_OFFER_RONA:
530
+ return {
531
+ type: _stateMachine.TaskEvent.RONA,
532
+ taskData: payload,
533
+ reason: payload.reason
534
+ };
535
+ case _types2.CC_EVENTS.AGENT_OUTBOUND_FAILED:
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
+ };
479
547
  }
480
- }
481
- });
548
+ case _types2.CC_EVENTS.CAMPAIGN_PREVIEW_ACCEPT_FAILED:
549
+ return {
550
+ type: _stateMachine.TaskEvent.CAMPAIGN_PREVIEW_ACCEPT_FAILED,
551
+ taskData: payload
552
+ };
553
+ case _types2.CC_EVENTS.CAMPAIGN_PREVIEW_SKIP_FAILED:
554
+ return {
555
+ type: _stateMachine.TaskEvent.CAMPAIGN_PREVIEW_SKIP_FAILED,
556
+ taskData: payload
557
+ };
558
+ case _types2.CC_EVENTS.CAMPAIGN_PREVIEW_REMOVE_FAILED:
559
+ return {
560
+ type: _stateMachine.TaskEvent.CAMPAIGN_PREVIEW_REMOVE_FAILED,
561
+ taskData: payload
562
+ };
563
+ case _types2.CC_EVENTS.CONTACT_RECORDING_STARTED:
564
+ return {
565
+ type: _stateMachine.TaskEvent.RECORDING_STARTED,
566
+ taskData: payload
567
+ };
568
+ case _types2.CC_EVENTS.CONTACT_RECORDING_PAUSED:
569
+ return {
570
+ type: _stateMachine.TaskEvent.PAUSE_RECORDING,
571
+ taskData: payload
572
+ };
573
+ case _types2.CC_EVENTS.CONTACT_RECORDING_RESUMED:
574
+ return {
575
+ type: _stateMachine.TaskEvent.RESUME_RECORDING,
576
+ taskData: payload
577
+ };
578
+ case _types2.CC_EVENTS.AGENT_WRAPPEDUP:
579
+ return {
580
+ type: _stateMachine.TaskEvent.WRAPUP_COMPLETE,
581
+ taskData: payload
582
+ };
583
+
584
+ // Conference events - these trigger state machine transition to CONFERENCING
585
+ case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCED:
586
+ case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCING:
587
+ case _types2.CC_EVENTS.PARTICIPANT_JOINED_CONFERENCE:
588
+ return {
589
+ type: _stateMachine.TaskEvent.CONFERENCE_START,
590
+ taskData: payload
591
+ };
592
+ case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCE_FAILED:
593
+ return {
594
+ type: _stateMachine.TaskEvent.CONFERENCE_FAILED,
595
+ reason: payload.reason,
596
+ taskData: payload
597
+ };
598
+ case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCE_ENDED:
599
+ return {
600
+ type: _stateMachine.TaskEvent.CONFERENCE_END,
601
+ taskData: payload
602
+ };
603
+ case _types2.CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE:
604
+ return {
605
+ type: _stateMachine.TaskEvent.PARTICIPANT_LEAVE,
606
+ taskData: payload,
607
+ participantId: payload?.participantId
608
+ };
609
+ case _types2.CC_EVENTS.AGENT_CONFERENCE_TRANSFERRED:
610
+ return {
611
+ type: _stateMachine.TaskEvent.TRANSFER_CONFERENCE_SUCCESS,
612
+ taskData: payload
613
+ };
614
+ default:
615
+ // Not all events need state machine mapping
616
+ return null;
617
+ }
482
618
  }
483
- updateTaskData(task, taskData) {
484
- if (!task) {
485
- return undefined;
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;
486
627
  }
487
- if (!taskData?.interactionId) {
488
- _loggerProxy.default.warn('Received task update with missing interactionId', {
489
- module: _constants.TASK_MANAGER_FILE,
490
- method: _constants2.METHODS.UPDATE_TASK_DATA
491
- });
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;
492
652
  }
653
+ const interactionWrapUp = payload.interaction?.state === 'wrapUp';
654
+ return wrapUpRequired || interactionWrapUp || wxAppAnswerPending;
655
+ }
656
+
657
+ /**
658
+ * Register WebSocket message listeners for task events
659
+ *
660
+ * Main entry point that orchestrates event processing through a clear pipeline:
661
+ * 1. Parse and validate incoming WebSocket messages
662
+ * 2. Prepare event context with task and state machine mappings
663
+ * 3. Handle task lifecycle (creation, updates, collection management)
664
+ * 4. Send events to state machine (task-level transitions/emissions)
665
+ * 5. Cleanup is triggered via task events emitted by the state machine
666
+ *
667
+ * This architecture separates concerns:
668
+ * - TaskManager: Manages task collection lifecycle and operational concerns
669
+ * - State Machine: Manages individual task state and event emissions
670
+ */
671
+ registerTaskListeners() {
672
+ this.webSocketManager.on('message', event => {
673
+ // Step 1: Parse and validate the message
674
+ const message = TaskManager.parseWebSocketMessage(event);
675
+ if (!message) return;
676
+
677
+ // Step 2: Prepare event context
678
+ const eventContext = this.prepareEventContext(message);
679
+ if (!eventContext) return;
680
+ const actions = this.handleTaskLifecycleEvent(eventContext);
681
+ const {
682
+ task
683
+ } = actions;
684
+ if (!task) return;
685
+ const {
686
+ payload,
687
+ stateMachineEvent
688
+ } = eventContext;
689
+
690
+ // Always keep task.data updated (even for mapped events) so consumers relying
691
+ // on TaskManager-managed task instances see the latest payload.
692
+ if (payload) {
693
+ this.updateTaskData(task, payload);
694
+ }
695
+
696
+ // Send event to state machine - this will trigger all TASK_EVENTS emissions
697
+ // including TASK_INCOMING which is now handled via the state machine callbacks
698
+ if (stateMachineEvent) {
699
+ task.sendStateMachineEvent(stateMachineEvent);
700
+ }
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
+
711
+ // Emit TASK_POST_CALL_ACTIVITY for ParticipantPostCallActivity events so
712
+ // consumers (Widgets) can detect the interaction state change to post_call.
713
+ if (eventContext.eventType === _types2.CC_EVENTS.PARTICIPANT_POST_CALL_ACTIVITY) {
714
+ task.emit(_types.TASK_EVENTS.TASK_POST_CALL_ACTIVITY, task);
715
+ }
716
+
717
+ // Send transcript start/stop events for relevant CC events
718
+ this.requestRealTimeTranscripts(eventContext.eventType, payload.interactionId);
719
+ });
720
+ }
721
+
722
+ /**
723
+ * Parse and validate WebSocket message
724
+ * @returns Parsed message or null if invalid/keepalive
725
+ */
726
+ static parseWebSocketMessage(event) {
493
727
  try {
494
- const currentTask = task.updateTaskData(taskData);
495
- this.taskCollection[taskData.interactionId] = currentTask;
496
- return currentTask;
728
+ const payload = JSON.parse(event);
729
+
730
+ // Filter out keepalive messages
731
+ if (payload?.keepalive === 'true' || payload?.keepalive === true) {
732
+ return null;
733
+ }
734
+
735
+ // Normalize task data if present
736
+ if (payload?.data?.interaction) {
737
+ payload.data = (0, _taskDataNormalizer.normalizeTaskData)(payload.data);
738
+ }
739
+ return payload;
497
740
  } catch (error) {
498
- _loggerProxy.default.error(`Failed to update task`, {
741
+ _loggerProxy.default.error('Failed to parse WebSocket message', {
499
742
  module: _constants.TASK_MANAGER_FILE,
500
- method: _constants2.METHODS.UPDATE_TASK_DATA,
501
- interactionId: taskData.interactionId
743
+ method: 'parseWebSocketMessage',
744
+ error
502
745
  });
503
- return task;
746
+ return null;
504
747
  }
505
748
  }
506
749
 
507
750
  /**
508
- * Handles CONTACT_MERGED event logic
509
- * @param task - The task to process
510
- * @param taskData - The task data from the event payload
511
- * @returns Updated or newly created task
512
- * @private
751
+ * Prepare context for event processing
752
+ * @returns Event context or null if event type is invalid
513
753
  */
514
- handleContactMerged(task, taskData) {
515
- if (taskData.childInteractionId) {
516
- // remove the child task from collection
517
- this.removeTaskFromCollection(this.taskCollection[taskData.childInteractionId]);
754
+ prepareEventContext(message) {
755
+ const eventType = message.data?.type || message.type;
756
+ if (!eventType || !isCcEvent(eventType)) {
757
+ return null;
518
758
  }
519
- if (this.taskCollection[taskData.interactionId]) {
520
- _loggerProxy.default.log(`Got CONTACT_MERGED: Task already exists in collection`, {
759
+ const interactionId = message.data.interactionId;
760
+ const reservationInteractionId = message.data.reservationInteractionId;
761
+ let task = this.taskCollection[interactionId];
762
+ let ownerChangeResolvedByRelatedInteraction = false;
763
+
764
+ // When a campaign preview contact is accepted, the assigned event may arrive
765
+ // with a new interactionId while the task is stored under the original
766
+ // reservationInteractionId. Fall back to that key so the task is found.
767
+ if (!task && reservationInteractionId) {
768
+ task = this.taskCollection[reservationInteractionId];
769
+ if (task) {
770
+ // Re-key the task under the new interaction ID and remove the old entry
771
+ delete this.taskCollection[reservationInteractionId];
772
+ this.taskCollection[interactionId] = task;
773
+ this.pendingFeatureEnablement.delete(reservationInteractionId);
774
+ }
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
+ }
810
+ const wasConsultedTask = Boolean(task?.data?.isConsulted);
811
+ const computeWrapUpRequired = () => {
812
+ if (message.data.wrapUpRequired !== undefined) {
813
+ return message.data.wrapUpRequired;
814
+ }
815
+ if (message.data.isConsulted !== undefined) {
816
+ return !message.data.isConsulted;
817
+ }
818
+ return !wasConsultedTask;
819
+ };
820
+ let adjustedPayload = eventType === _types2.CC_EVENTS.AGENT_CONSULT_TRANSFERRED || eventType === _types2.CC_EVENTS.AGENT_BLIND_TRANSFERRED || eventType === _types2.CC_EVENTS.AGENT_VTEAM_TRANSFERRED ? {
821
+ ...message.data,
822
+ wrapUpRequired: computeWrapUpRequired()
823
+ } : message.data;
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);
837
+ _loggerProxy.default.info(`Handling task event ${eventType}`, {
838
+ module: _constants.TASK_MANAGER_FILE,
839
+ method: 'prepareEventContext',
840
+ interactionId
841
+ });
842
+ return {
843
+ eventType,
844
+ payload: adjustedPayload,
845
+ task,
846
+ stateMachineEvent
847
+ };
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', {
521
906
  module: _constants.TASK_MANAGER_FILE,
522
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
523
- interactionId: taskData.interactionId
907
+ method: 'findUniqueTaskByRelatedInteraction',
908
+ interactionId: payload.interaction?.mainInteractionId || payload.interaction?.parentInteractionId || payload.interaction?.callProcessingDetails?.parentInteractionId || payload.interactionId
524
909
  });
525
- // update the task data
526
- task = this.updateTaskData(task, taskData);
527
- } else {
528
- // Case2 : Task is not present in taskCollection
529
- _loggerProxy.default.log(`Got CONTACT_MERGED : Creating new task in taskManager`, {
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
+ }
926
+
927
+ /**
928
+ * Handle task lifecycle events and determine required actions
929
+ *
930
+ * Delegates to specific event handlers based on event type. Each handler
931
+ * is responsible for TaskManager-level concerns:
932
+ * - Task creation and collection management
933
+ * - Metrics tracking
934
+ * - Resource cleanup decisions
935
+ *
936
+ * Note: Task-level state transitions and event emissions are handled by
937
+ * the task state machine via sendStateMachineEvent()
938
+ */
939
+ handleTaskLifecycleEvent(context) {
940
+ const {
941
+ eventType
942
+ } = context;
943
+ switch (eventType) {
944
+ case _types2.CC_EVENTS.AGENT_CONTACT_RESERVED:
945
+ return this.handleContactReserved(context);
946
+ case _types2.CC_EVENTS.AGENT_CONTACT:
947
+ return this.handleAgentContact(context);
948
+ case _types2.CC_EVENTS.CONTACT_MERGED:
949
+ return this.handleContactMergedEvent(context);
950
+ case _types2.CC_EVENTS.CONTACT_OWNER_CHANGED:
951
+ return this.handleContactOwnerChanged(context);
952
+ case _types2.CC_EVENTS.AGENT_OFFER_CAMPAIGN_RESERVATION:
953
+ return this.handleCampaignPreviewReservation(context);
954
+ case _types2.CC_EVENTS.CAMPAIGN_CONTACT_UPDATED:
955
+ return this.handleCampaignContactUpdated(context);
956
+ default:
957
+ return {
958
+ task: context.task
959
+ };
960
+ }
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
+ }
1019
+ handleCampaignContactUpdated(context) {
1020
+ const {
1021
+ payload
1022
+ } = context;
1023
+ let {
1024
+ task
1025
+ } = context;
1026
+ // CampaignContactUpdated is a non-terminal event (e.g., next contact after skip/remove).
1027
+ // Update the task data and emit an event so consumers can react to the updated contact.
1028
+ // Do NOT remove the task or emit TASK_END — cleanup is handled by CONTACT_ENDED.
1029
+ if (task) {
1030
+ // Carry forward campaign preview fields from existing task data since the updated
1031
+ // contact payload may not include them, and reconcileData would delete them.
1032
+ const existingCpd = task.data?.interaction?.callProcessingDetails;
1033
+ const updatedData = {
1034
+ ...payload
1035
+ };
1036
+ if (existingCpd) {
1037
+ const campaignFields = {
1038
+ ...(existingCpd.campaignPreviewAutoAction && {
1039
+ campaignPreviewAutoAction: existingCpd.campaignPreviewAutoAction
1040
+ }),
1041
+ ...(existingCpd.campaignPreviewOfferTimeout && {
1042
+ campaignPreviewOfferTimeout: existingCpd.campaignPreviewOfferTimeout
1043
+ }),
1044
+ ...(existingCpd.campaignPreviewSkipDisabled && {
1045
+ campaignPreviewSkipDisabled: existingCpd.campaignPreviewSkipDisabled
1046
+ }),
1047
+ ...(existingCpd.campaignPreviewRemoveDisabled && {
1048
+ campaignPreviewRemoveDisabled: existingCpd.campaignPreviewRemoveDisabled
1049
+ })
1050
+ };
1051
+ if (!updatedData.interaction) {
1052
+ updatedData.interaction = {};
1053
+ }
1054
+ updatedData.interaction = {
1055
+ ...updatedData.interaction,
1056
+ callProcessingDetails: {
1057
+ ...campaignFields,
1058
+ ...(updatedData.interaction.callProcessingDetails || {})
1059
+ }
1060
+ };
1061
+ }
1062
+ _loggerProxy.default.log('Campaign contact updated - carrying forward preview fields', {
530
1063
  module: _constants.TASK_MANAGER_FILE,
531
1064
  method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
532
- interactionId: taskData.interactionId
1065
+ interactionId: payload.interactionId,
1066
+ data: {
1067
+ hasCpd: !!updatedData.interaction?.callProcessingDetails,
1068
+ autoAction: updatedData.interaction?.callProcessingDetails?.campaignPreviewAutoAction,
1069
+ skipDisabled: updatedData.interaction?.callProcessingDetails?.campaignPreviewSkipDisabled,
1070
+ removeDisabled: updatedData.interaction?.callProcessingDetails?.campaignPreviewRemoveDisabled
1071
+ }
533
1072
  });
534
- task = new _.default(this.contact, this.webCallingService, {
535
- ...taskData,
536
- wrapUpRequired: taskData.interaction?.participants?.[this.agentId]?.isWrapUp || false,
537
- isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(taskData)
538
- }, this.wrapupData, this.agentId);
539
- this.taskCollection[taskData.interactionId] = task;
540
- }
541
- this.emit(_types.TASK_EVENTS.TASK_MERGED, task);
1073
+ task = this.updateTaskData(task, updatedData);
1074
+ task.emit(_types.TASK_EVENTS.TASK_CAMPAIGN_CONTACT_UPDATED, task);
1075
+ }
1076
+ return {
1077
+ task
1078
+ };
1079
+ }
1080
+
1081
+ /**
1082
+ * Creates or updates a task for campaign preview reservation.
1083
+ * TASK_CAMPAIGN_PREVIEW_RESERVATION is emitted by the state machine (campaign TASK_INCOMING branch).
1084
+ */
1085
+ handleCampaignPreviewReservation(context) {
1086
+ const {
1087
+ payload
1088
+ } = context;
1089
+ let {
1090
+ task
1091
+ } = context;
1092
+ _loggerProxy.default.log('Campaign preview reservation received', {
1093
+ module: _constants.TASK_MANAGER_FILE,
1094
+ method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
1095
+ interactionId: payload.interactionId
1096
+ });
1097
+ if (!task) {
1098
+ task = _TaskFactory.default.createTask(this.contact, this.webCallingService, {
1099
+ ...payload,
1100
+ wrapUpRequired: false,
1101
+ isConferenceInProgress: false,
1102
+ isAutoAnswering: false
1103
+ }, this.configFlags, this.wrapupData, this.agentId, this.agentName, this.answerCallOnWebexService, this.apiAIAssistant);
1104
+ this.setupTaskListeners(task);
1105
+ this.taskCollection[payload.interactionId] = task;
1106
+ } else {
1107
+ task = this.updateTaskData(task, payload);
1108
+ }
1109
+ return {
1110
+ task
1111
+ };
1112
+ }
1113
+
1114
+ /**
1115
+ * Handle AGENT_CONTACT_RESERVED event
1116
+ * Creates a new task; state machine event is sent during processing
1117
+ */
1118
+ handleContactReserved(context) {
1119
+ const {
1120
+ payload
1121
+ } = context;
1122
+ const isConsultedTask = payload.isConsulted === true || (0, _TaskUtils.isSecondaryEpDnAgent)(payload.interaction);
1123
+ const shouldAutoAnswer = (0, _TaskUtils.shouldAutoAnswerTask)(payload, this.agentId, this.webCallingService.loginOption, this.webRtcEnabled);
1124
+ const taskData = {
1125
+ ...payload,
1126
+ isConsulted: isConsultedTask,
1127
+ isAutoAnswering: shouldAutoAnswer
1128
+ };
1129
+ const task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId, this.agentName, this.answerCallOnWebexService, this.apiAIAssistant);
1130
+ this.setupTaskListeners(task);
1131
+ this.taskCollection[payload.interactionId] = task;
1132
+ return {
1133
+ task
1134
+ };
1135
+ }
1136
+
1137
+ /**
1138
+ * Handle AGENT_CONTACT event
1139
+ * Re-creates task if missing (multi-session scenario)
1140
+ */
1141
+ handleAgentContact(context) {
1142
+ let {
1143
+ task
1144
+ } = context;
1145
+ const {
1146
+ payload
1147
+ } = context;
1148
+ if (!task) {
1149
+ const isConsultedTask = payload.isConsulted === true || (0, _TaskUtils.isSecondaryEpDnAgent)(payload.interaction);
1150
+ const shouldAutoAnswer = (0, _TaskUtils.shouldAutoAnswerTask)(payload, this.agentId, this.webCallingService.loginOption, this.webRtcEnabled);
1151
+ const taskData = {
1152
+ ...payload,
1153
+ isConsulted: isConsultedTask,
1154
+ wrapUpRequired: payload.interaction?.participants?.[this.agentId]?.isWrapUp || false,
1155
+ isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(payload),
1156
+ isAutoAnswering: shouldAutoAnswer
1157
+ };
1158
+ task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId, this.agentName, this.answerCallOnWebexService, this.apiAIAssistant);
1159
+ this.setupTaskListeners(task);
1160
+ this.taskCollection[payload.interactionId] = task;
1161
+ }
1162
+ return {
1163
+ task
1164
+ };
1165
+ }
1166
+ updateTaskData(task, taskData) {
1167
+ if (!task) {
1168
+ throw new Error('Task not found for update');
1169
+ }
1170
+ const snapshot = task.stateMachineService?.getSnapshot?.();
1171
+ const isConsultingFlow = snapshot?.value === 'CONSULTING' || taskData.interaction?.state === 'consulting';
1172
+ const updateTaskData = isConsultingFlow ? {
1173
+ ...taskData,
1174
+ destAgentId: taskData.destAgentId ?? snapshot?.context?.consultDestinationAgentId ?? null,
1175
+ destinationType: taskData.destinationType ?? snapshot?.context?.consultDestinationType ?? null
1176
+ } : taskData;
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
+ });
1186
+ this.taskCollection[taskData.interactionId] = task;
1187
+ const enablement = this.pendingFeatureEnablement.get(task.data.interactionId);
1188
+ if (enablement) {
1189
+ task.setFeatureEnablement?.(enablement);
1190
+ }
542
1191
  return task;
543
1192
  }
1193
+
1194
+ /**
1195
+ * Setup listeners for task events that need to be bubbled up to TaskManager
1196
+ * This replaces the previous callback injection pattern
1197
+ */
1198
+ setupTaskListeners(task) {
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
+ }
1213
+
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
+ });
1224
+ });
1225
+ task.on(_types.TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, t => {
1226
+ this.emit(_types.TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, t);
1227
+ });
1228
+
1229
+ // Listen for internal cleanup signal emitted by the state machine
1230
+ task.on(_types.TASK_EVENTS.TASK_CLEANUP, (t, options) => {
1231
+ this.handleTaskCleanup(t);
1232
+ if (options?.removeFromCollection) {
1233
+ const taskIsStillCollected = Object.values(this.taskCollection).some(candidate => candidate === t);
1234
+ if (taskIsStillCollected) {
1235
+ this.removeTaskFromCollection(t);
1236
+ }
1237
+ }
1238
+ });
1239
+ }
544
1240
  removeTaskFromCollection(task) {
1241
+ task.clearFeatureEnablement?.();
1242
+ task.disposeWxAppOfferObservability?.();
1243
+ if (typeof task.cancelAutoWrapupTimer === 'function') {
1244
+ task.cancelAutoWrapupTimer();
1245
+ }
545
1246
  if (task?.data?.interactionId) {
546
- 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
+ });
547
1256
  _loggerProxy.default.info(`Task removed from collection`, {
548
1257
  module: _constants.TASK_MANAGER_FILE,
549
1258
  method: _constants2.METHODS.REMOVE_TASK_FROM_COLLECTION,
@@ -553,62 +1262,67 @@ class TaskManager extends _events.default {
553
1262
  }
554
1263
 
555
1264
  /**
556
- * Handles auto-answer logic for incoming tasks
557
- * Automatically accepts tasks when isAutoAnswering flag is set
558
- * The flag is set during task creation based on:
559
- * 1. WebRTC calls with auto-answer enabled in agent profile
560
- * 2. Agent-initiated WebRTC outdial calls
561
- * 3. Agent-initiated digital outbound (Email/SMS) without previous transfers
562
- *
563
- * @param task - The task to auto-answer
1265
+ * Handles CONTACT_MERGED event logic
1266
+ * @param task - The task to process
1267
+ * @param taskData - The task data from the event payload
1268
+ * @returns Updated or newly created task
564
1269
  * @private
565
1270
  */
566
- async handleAutoAnswer(task) {
567
- if (!task || !task.data || !task.data.isAutoAnswering) {
568
- return;
1271
+ handleContactMergedEvent(context) {
1272
+ const {
1273
+ payload
1274
+ } = context;
1275
+ let task = context.task;
1276
+ if (payload.childInteractionId && this.taskCollection[payload.childInteractionId]) {
1277
+ this.removeTaskFromCollection(this.taskCollection[payload.childInteractionId]);
569
1278
  }
570
- _loggerProxy.default.info(`Auto-answering task`, {
571
- module: _constants.TASK_MANAGER_FILE,
572
- method: 'handleAutoAnswer',
573
- interactionId: task.data.interactionId
574
- });
575
- try {
576
- await task.accept();
577
- _loggerProxy.default.info(`Task auto-answered successfully`, {
1279
+ if (task) {
1280
+ _loggerProxy.default.log(`Got CONTACT_MERGED: Task already exists in collection`, {
578
1281
  module: _constants.TASK_MANAGER_FILE,
579
- method: 'handleAutoAnswer',
580
- interactionId: task.data.interactionId
581
- });
582
-
583
- // Track successful auto-answer
584
- this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.TASK_AUTO_ANSWER_SUCCESS, {
585
- taskId: task.data.interactionId,
586
- mediaType: task.data.interaction.mediaType,
587
- isAutoAnswered: true
588
- }, ['behavioral', 'operational']);
589
- // Emit task:autoAnswered event for widgets/UI to react
590
- task.emit(_types.TASK_EVENTS.TASK_AUTO_ANSWERED, task);
591
- } catch (error) {
592
- // Reset isAutoAnswering flag on failure
593
- task.updateTaskData({
594
- ...task.data,
595
- isAutoAnswering: false
1282
+ method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
1283
+ interactionId: payload.interactionId
596
1284
  });
597
- _loggerProxy.default.error(`Failed to auto-answer task`, {
1285
+ // update the task data
1286
+ this.updateTaskData(task, payload);
1287
+ } else {
1288
+ // Case2 : Task is not present in taskCollection
1289
+ _loggerProxy.default.log(`Got CONTACT_MERGED : Creating new task in taskManager`, {
598
1290
  module: _constants.TASK_MANAGER_FILE,
599
- method: 'handleAutoAnswer',
600
- interactionId: task.data.interactionId,
601
- error
1291
+ method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
1292
+ interactionId: payload.interactionId
602
1293
  });
1294
+ const taskData = {
1295
+ ...payload,
1296
+ wrapUpRequired: payload.interaction?.participants?.[this.agentId]?.isWrapUp || false,
1297
+ isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(payload),
1298
+ isConsulted: false
1299
+ };
1300
+ task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId, this.agentName, this.answerCallOnWebexService, this.apiAIAssistant);
1301
+ this.taskCollection[payload.interactionId] = task;
603
1302
 
604
- // Track auto-answer failure
605
- this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.TASK_AUTO_ANSWER_FAILED, {
606
- taskId: task.data.interactionId,
607
- mediaType: task.data.interaction.mediaType,
608
- error: error?.message || 'Unknown error',
609
- isAutoAnswered: false
610
- }, ['behavioral', 'operational']);
1303
+ // Transition the new task out of IDLE immediately so UI controls are
1304
+ // computed before TASK_MERGED is emitted. This handles the race where
1305
+ // AgentContactAssigned arrives before ContactMerged and gets dropped.
1306
+ // Send HYDRATE before setupTaskListeners so the emitTaskHydrate action
1307
+ // doesn't bubble up to the Widget (avoids duplicate listener registration).
1308
+ task.sendStateMachineEvent({
1309
+ type: _stateMachine.TaskEvent.HYDRATE,
1310
+ taskData,
1311
+ agentId: this.agentId
1312
+ });
1313
+ this.setupTaskListeners(task);
611
1314
  }
1315
+ if (task) {
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
+ }
1322
+ }
1323
+ return {
1324
+ task
1325
+ };
612
1326
  }
613
1327
 
614
1328
  /**
@@ -618,7 +1332,7 @@ class TaskManager extends _events.default {
618
1332
  */
619
1333
  handleTaskCleanup(task) {
620
1334
  // Clean up Desktop/WebRTC calling resources for browser-based telephony tasks
621
- if (this.webCallingService.loginOption === _types3.LoginOption.BROWSER && task.data.interaction.mediaType === 'telephony') {
1335
+ if (this.webCallingService.loginOption === _types3.LoginOption.BROWSER && task.data.interaction.mediaType === _types.MEDIA_CHANNEL.TELEPHONY && task instanceof _WebRTC.default) {
622
1336
  task.unregisterWebCallListeners();
623
1337
  this.webCallingService.cleanUpCall();
624
1338
  }
@@ -641,11 +1355,14 @@ class TaskManager extends _events.default {
641
1355
  */
642
1356
  requestRealTimeTranscripts(eventType, interactionId) {
643
1357
  const action = _constants2.TRANSCRIPT_EVENT_MAP[eventType];
644
- if (!action || !this.apiAIAssistant || this.apiAIAssistant.aiFeature?.realtimeTranscripts?.enable === false) return;
645
- this.apiAIAssistant.sendEvent(this.agentId, interactionId, _types3.AIAssistantEventType.CUSTOM_EVENT, _types3.AIAssistantEventName.GET_TRANSCRIPTS, action).catch(error => {
1358
+ if (!action || !this.apiAIAssistant) return;
1359
+ if (this.configFlags?.aiFeature?.realtimeTranscripts?.enable !== true) return;
1360
+ this.apiAIAssistant.sendEvent(this.agentId, interactionId, _types3.AIAssistantEventType.CUSTOM_EVENT, _types3.AIAssistantEventName.GET_TRANSCRIPTS, {
1361
+ action
1362
+ }).catch(error => {
646
1363
  _loggerProxy.default.error(`Failed to send transcript ${action} event`, {
647
1364
  module: _constants.TASK_MANAGER_FILE,
648
- method: 'requestRealTimeTranscripts',
1365
+ method: _constants2.METHODS.REQUEST_REAL_TIME_TRANSCRIPTS,
649
1366
  interactionId,
650
1367
  error
651
1368
  });
@@ -654,18 +1371,72 @@ class TaskManager extends _events.default {
654
1371
  getTask(taskId) {
655
1372
  return this.taskCollection[taskId];
656
1373
  }
1374
+ getAllTasks() {
1375
+ return {
1376
+ ...this.taskCollection
1377
+ };
1378
+ }
657
1379
 
658
1380
  /**
659
- * @param taskId - Unique identifier for each task
1381
+ * Propagate runtime enableWxBetterTogether changes to config flags and active tasks.
660
1382
  */
661
- getAllTasks = () => {
662
- return this.taskCollection;
663
- };
664
- static getTaskManager(apiAIAssistant, contact, webCallingService, webSocketManager) {
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
+ }
1435
+ static getTaskManager(apiAIAssistant, contact, webCallingService, webSocketManager, rtdWebSocketManager) {
665
1436
  if (!TaskManager.taskManager) {
666
- TaskManager.taskManager = new TaskManager(apiAIAssistant, contact, webCallingService, webSocketManager);
1437
+ TaskManager.taskManager = new TaskManager(apiAIAssistant, contact, webCallingService, webSocketManager, rtdWebSocketManager);
667
1438
  }
668
- return this.taskManager;
1439
+ return TaskManager.taskManager;
669
1440
  }
670
1441
  }
671
1442
  exports.default = TaskManager;